restore_workflow

Take a workflow out of the archive, keyed by id, along with every agent archived inside it.

WorkflowwritesidempotentMCP tool

The agents come back as dormant rows, so call resume_agent on the ones whose conversations you want in a pane. Returns not_found if the workflow is not archived. It is refused whole rather than in part, either because its agents would not fit under the number the panel is configured to hold, or because live agents have taken their names, which the error lists for you to rename.

Calling it#

curl -X POST http://127.0.0.1:8787/workflow.v1.WorkflowService/RestoreWorkflow \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "<id>"
}'

komrad rpc restore-workflow \
  --id <string>

{
  "name": "restore_workflow",
  "arguments": {
    "id": "<id>"
  }
}

Offered by the komrad MCP server to orchestrator agents.

Request#

RestoreWorkflowRequest#

Field Type Description

Field	Type	Description
`id`	string	Which archived workflow to bring back, along with the agents archived inside it. required

id

string

Which archived workflow to bring back, along with the agents archived inside it.

required

Response#

RestoreWorkflowResponse#

Field	Type	Description
`workflow`	Workflow	The workflow as restored, its agents dormant until each is resumed.

Types#

Workflow#

Field	Type	Description
`id`	string	The handle every other call names this workflow by.
`name`	string	What the panel groups its agents under.
`context`	string	Text appended to the system prompt of every agent launched into it, taken as a snapshot at launch rather than read again.
`cwd`	string	The directory its agents start in, and the checkout new worktrees are cut from.
`flags`	string	Command-line flags prefilled for each new agent.
`harness`	string	Which CLI its agents run, blank for komrad's default.
`archivedAt`	string	When it was hidden from the panel, unset while it is live.
`worktree`	WorktreeConfig	Whether its agents each get a worktree of their own, and how those are built.
`hooks`	list of WorkflowHook	Scripts hung on moments in its agents' lives, one per moment.
`contextTruncated`	bool	Whether context holds only its opening, which a summary listing returns.

WorktreeConfig#

Field	Type	Description
`enabled`	bool	Whether komrad cuts a worktree for each agent, or leaves it in the directory it was given.
`baseBranch`	string	The branch worktrees are cut from and every agent's work is measured against, filled in from the clone when left blank on create and never blank once stored. at most 255 characters
`copyPaths`	list of string	Files copied into each new worktree, for the untracked ones a build needs.
`symlinkPaths`	list of string	Files linked into each new worktree rather than copied, for the large shared ones.
`diffExclude`	list of string	Paths or globs the panel leaves out of the diff it draws, such as generated output.
`dir`	string	Where new worktrees are made, blank for the parent every workflow shares. at most 4096 characters

WorkflowHook#

Field Type Description

Field	Type	Description
`event`	string	Which moment fires it, such as pre-launch or post-resume. required, at most 40 characters
`script`	string	The file in the hooks directory to run, blank to fire nothing at that moment. required, at most 255 characters

event

string

Which moment fires it, such as pre-launch or post-resume.

required, at most 40 characters

script

string

The file in the hooks directory to run, blank to fire nothing at that moment.

required, at most 255 characters