dreampiler/kandev
1
0
Fork 0
Code Issues 43 Pull Requests Actions 6 Packages Projects Releases Wiki Activity

feat(canvas): show live workflow history and simplify sharing (#3877)

Browse Source
This commit is contained in:
Carlos Florêncio
2026-09-23 10:57:06 +01:00
committed by GitHub
parent a2d4ee8c18
commit 41eeaf0c70
75 changed files with 4910 additions and 590 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/backend/internal/mcp/canvasskill/files/references/browser-api.md
+16
View File
@@ -59,10 +59,12 @@ workspace.
| --- | --- | --- | --- |
| GET | `./_kandev/v1/data/tasks` | `api_read:tasks` | List tasks |
| GET | `./_kandev/v1/data/tasks/{task_id}` | `api_read:tasks` | Read one task |
| GET | `./_kandev/v1/data/tasks/{task_id}/step-transitions` | `api_read:tasks` | Read recorded task moves |
| PATCH | `./_kandev/v1/data/tasks/{task_id}` | `api_write:tasks` | Update a task |
| POST | `./_kandev/v1/data/tasks/{task_id}/messages` | `api_write:messages` | Send a task message |
| GET | `./_kandev/v1/data/workflows` | `api_read:workflows` | List workflows |
| GET | `./_kandev/v1/data/workflows/{workflow_id}/steps` | `api_read:workflows` | Read workflow steps |
| GET | `./_kandev/v1/data/workflows/{workflow_id}/transition-groups` | `api_read:tasks` and `api_read:workflows`; workspace canvas only | Read recorded workflow route counts |
The task-list query accepts `cursor`, `limit`, `include_archived`,
`workflow_id`, `state`, and `parent_id`. `workflow_id` and `state` can be
@@ -120,6 +122,20 @@ A workflow object contains `id`, `workspace_id`, `name`, `description`,
`is_start_step`, `wip_limit`, `agent_profile_id`, and
`on_enter_action_types`.
The task transition route returns rows newest first, with `id` as a decimal
string, nullable `from_workflow_id`, `from_workflow_step_id`,
`to_workflow_id`, and `to_workflow_step_id`, `trigger`, and RFC3339
`occurred_at`. It omits actor and session identity. The opaque `cursor`
continues by ledger ID; it is bound to the requested task. Empty history
means no retained move was recorded, not that the task never moved.
The workflow transition-group route returns `kind` (`within`, `entry`, or
`exit`), nullable `from_step_id` and `to_step_id`, and `count`. It includes
archived tasks and removed step IDs, but not deleted tasks. Its opaque cursor
orders groups by kind and step IDs. Both routes use the collection envelope
and the 1..200 `limit` rule above. A task canvas cannot request workflow-wide
groups; promotion to workspace scope is a user action, not a fallback.
## Writes and workflow movement
`PATCH ./_kandev/v1/data/tasks/{task_id}` accepts one or more of these JSON