@synap-core/workspace-templates 0.11.0 → 0.23.0

package/capabilities/canva.capability.json

@@ -0,0 +1,274 @@
+{
+  "apiVersion": "synap/v1",
+  "kind": "capability",
+  "meta": {
+    "slug": "canva",
+    "name": "Canva — Design & Brand",
+    "description": "Canva design operations through one Nango OAuth connection (Connect REST API): list/get designs, brand templates and folders, and export designs. List verbs default their limit. Connect your Canva account to use it.",
+    "tags": [
+      "capability"
+    ],
+    "isPublic": true,
+    "syncByDefault": true
+  },
+  "spec": {
+    "key": "canva",
+    "name": "Canva — Design & Brand",
+    "description": "Canva design operations through ONE Nango OAuth connection (Connect REST API). List verbs default their limit (10–100). Read your designs, folders, and brand templates; inspect what a brand template accepts for autofill; and export designs. PRECONDITION: the 'canva' integration must be declared + configured on the pod's Nango (Connect API scopes: design:read, design:write, design:meta:read, asset:read, folder:read, profile:read) and the acting user must connect their Canva account via Connectors; the dispatcher resolves the most-recent canva connection automatically. Paths are RELATIVE to the Nango canva integration's base URL (api.canva.com) — no baseUrlOverride, so no provider-proxy-host allowlist entry is needed. Reads (list/get) return data inline and auto-run. Writes (export) are side-effecting and route through the capability-execution gate. NOTE: response-field shaping is best-effort and confirmed against the live API at first run.",
+    "params": [],
+    "vault": [],
+    "tools": [
+      {
+        "name": "canva",
+        "kind": "provider",
+        "description": "Canva Connect REST access through Nango. credentialRef nango://canva resolves the user's Canva connection (Connection-Id + Provider-Config-Key) and proxies to the integration's base URL (api.canva.com).",
+        "credentialRef": "nango://canva",
+        "executor": "is-agent",
+        "config": {
+          "providerConfigKey": "canva"
+        }
+      }
+    ],
+    "skills": [
+      {
+        "name": "canva_list_designs",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists the user's Canva designs (most relevant first). Args: { limit?: number (default 10, max 50) }.",
+        "requires": [
+          "canva"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "limit": "number?"
+        },
+        "providerSpec": {
+          "tool": "canva",
+          "method": "GET",
+          "pathTemplate": "/rest/v1/designs",
+          "query": {
+            "limit": "{{limit}}"
+          },
+          "paramMapping": {
+            "limit": {
+              "default": 10,
+              "clampMin": 1,
+              "clampMax": 50
+            }
+          },
+          "responseShape": {
+            "collectionPath": "items",
+            "collectionAs": "designs",
+            "item": {
+              "id": "id",
+              "title": "title",
+              "thumbnail": "thumbnail.url",
+              "updatedAt": "updated_at"
+            },
+            "scalar": {
+              "count": "@count"
+            }
+          }
+        }
+      },
+      {
+        "name": "canva_get_design",
+        "intent": "fetch_record",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Gets one Canva design's metadata by id. Args: { designId: string }.",
+        "requires": [
+          "canva"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "designId": "string"
+        },
+        "providerSpec": {
+          "tool": "canva",
+          "method": "GET",
+          "pathTemplate": "/rest/v1/designs/{{designId}}",
+          "paramMapping": {
+            "designId": {
+              "required": true,
+              "encode": "uri"
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "id": "id",
+              "title": "title",
+              "thumbnail": "thumbnail.url",
+              "url": "urls.edit"
+            }
+          }
+        }
+      },
+      {
+        "name": "canva_list_brand_templates",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists the user's Canva brand templates — this is the branding the AI can see. Args: { limit?: number (default 20, max 100) }.",
+        "requires": [
+          "canva"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "limit": "number?"
+        },
+        "providerSpec": {
+          "tool": "canva",
+          "method": "GET",
+          "pathTemplate": "/rest/v1/brand-templates",
+          "query": {
+            "limit": "{{limit}}"
+          },
+          "paramMapping": {
+            "limit": {
+              "default": 20,
+              "clampMin": 1,
+              "clampMax": 100
+            }
+          },
+          "responseShape": {
+            "collectionPath": "items",
+            "collectionAs": "brand_templates",
+            "item": {
+              "id": "id",
+              "title": "title",
+              "thumbnail": "thumbnail.url"
+            },
+            "scalar": {
+              "count": "@count"
+            }
+          }
+        }
+      },
+      {
+        "name": "canva_get_brand_template_dataset",
+        "intent": "fetch_record",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Gets the dataset schema for a brand template — what fields it accepts for autofill (text/image/data slots). Args: { brandTemplateId: string }.",
+        "requires": [
+          "canva"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "brandTemplateId": "string"
+        },
+        "providerSpec": {
+          "tool": "canva",
+          "method": "GET",
+          "pathTemplate": "/rest/v1/brand-templates/{{brandTemplateId}}/dataset",
+          "paramMapping": {
+            "brandTemplateId": {
+              "required": true,
+              "encode": "uri"
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "brandTemplateId": "{{brandTemplateId}}",
+              "dataset": "dataset"
+            }
+          }
+        }
+      },
+      {
+        "name": "canva_list_folders",
+        "intent": "list_records",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Lists the user's Canva folders. Args: { limit?: number (default 20, max 100) }.",
+        "requires": [
+          "canva"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "limit": "number?"
+        },
+        "providerSpec": {
+          "tool": "canva",
+          "method": "GET",
+          "pathTemplate": "/rest/v1/folders",
+          "query": {
+            "limit": "{{limit}}"
+          },
+          "paramMapping": {
+            "limit": {
+              "default": 20,
+              "clampMin": 1,
+              "clampMax": 100
+            }
+          },
+          "responseShape": {
+            "collectionPath": "items",
+            "collectionAs": "folders",
+            "item": {
+              "id": "id",
+              "name": "name"
+            },
+            "scalar": {
+              "count": "@count"
+            }
+          }
+        }
+      },
+      {
+        "name": "canva_export_design",
+        "intent": "manage_file",
+        "kind": "declarative",
+        "scope": "pod",
+        "description": "Exports a Canva design to a file (PNG, JPG, PDF, PPTX, MP4…). Side-effecting write — routes through the capability-execution gate. Args: { designId: string, format?: string (default 'png') }.",
+        "requires": [
+          "canva"
+        ],
+        "executionMode": "async",
+        "timeoutSeconds": 120,
+        "parameters": {
+          "designId": "string",
+          "format": "string?"
+        },
+        "providerSpec": {
+          "tool": "canva",
+          "method": "POST",
+          "pathTemplate": "/rest/v1/exports",
+          "body": {
+            "design_id": "{{designId}}",
+            "format": {
+              "type": "{{format}}"
+            }
+          },
+          "paramMapping": {
+            "designId": {
+              "required": true
+            },
+            "format": {
+              "default": "png"
+            }
+          },
+          "responseShape": {
+            "scalar": {
+              "jobId": "job.id",
+              "status": "job.status"
+            }
+          }
+        }
+      }
+    ],
+    "provides": [
+      "fetch_record",
+      "list_records",
+      "manage_file"
+    ]
+  },
+  "dependencies": []
+}

package/capabilities/claude-code-routines.capability.json

@@ -0,0 +1,172 @@
+{
+  "apiVersion": "synap/v1",
+  "kind": "capability",
+  "meta": {
+    "slug": "claude-code-routines",
+    "name": "Claude Code Routines",
+    "description": "Hand a Synap session's work to a Claude Code routine you set up on claude.ai/code. It runs in the cloud on your Claude plan, works in your connected GitHub repos, and reports back in the session room. Good for dev tasks and research.",
+    "tags": [
+      "capability",
+      "agents",
+      "anthropic",
+      "claude-code",
+      "opt-in"
+    ],
+    "isPublic": true,
+    "syncByDefault": false
+  },
+  "spec": {
+    "key": "claude-code-routines",
+    "name": "Claude Code Routines",
+    "description": "Hands Synap work to a Claude Code routine you created on claude.ai/code, so it runs as a cloud Claude Code session on YOUR Claude plan (Pro, Max, Team or Enterprise) — Anthropic's documented routine fire API, never a subscription login token. Installs ONE external-agent tool (claude_code_routines, kind external, executor external-agent) whose config.agentBinding names two verbs, both intent delegate_agent_task: <key>_dispatch (start: POST /v1/claude_code/routines/{trig_...}/fire with the fenced task as text; returns the claude.ai/code session URL) and <key>_send (the fire API cannot message a running session, so an answer starts a NEW run that continues from the Synap room). No status, no cancel: the fire token reads nothing, so the agent reports through the Synap MCP connector attached to the routine and closes the run with complete_session. ONE-TIME SETUP: (1) on claude.ai/code/routines create a routine: attach the repositories, attach the Synap MCP connector, and give it a short prompt ('You are a Synap worker. Do the task given in this run's context and follow its report-back rules.'). (2) Add trigger -> API -> Generate token; copy the fire URL and the token (shown once). (3) Install this capability with both. (4) Bind: agentUsers.setBinding({agentUserId, toolId: the claude_code_routines tool}) (a person only) and grant that agent auto-run on dispatch/send, otherwise every hand-off is a proposal. LIMITS (Anthropic's): 30 runs per hour per routine, 100 per hour per account, shared with Run now; every call is a new session (no idempotency); the API is experimental. Best for dev tasks and research, not for per-capture work.",
+    "params": [
+      {
+        "name": "routineFireUrl",
+        "label": "Routine fire URL",
+        "type": "text",
+        "required": true,
+        "description": "The URL shown when you add an API trigger to the routine: https://api.anthropic.com/v1/claude_code/routines/trig_.../fire. Not a secret."
+      },
+      {
+        "name": "routineToken",
+        "label": "Routine API token",
+        "type": "password",
+        "required": true,
+        "description": "The sk-ant-oat01-... token generated for that trigger (shown once). It can only start this routine. Stored server-encrypted in the vault; never persisted in the template."
+      }
+    ],
+    "vault": [
+      {
+        "ref": "routineTokenSecret",
+        "name": "{{name}} routine token",
+        "value": "{{routineToken}}",
+        "type": "api_key",
+        "service": "anthropic",
+        "description": "Per-routine bearer token for the claude_code_routines binding tool (sent as Authorization: Bearer). Starts one routine; reads nothing."
+      }
+    ],
+    "tools": [
+      {
+        "name": "claude_code_routines",
+        "kind": "external",
+        "executor": "external-agent",
+        "description": "The dispatch binding to a Claude Code routine on claude.ai/code. Synap never runs the agent: its verbs only fire the routine over https://api.anthropic.com. The vaulted routine token is injected as Authorization: Bearer; the credentialRef is remapped to vault://<id> at apply time.",
+        "credentialRef": "routineTokenSecret",
+        "config": {
+          "baseUrl": "https://api.anthropic.com",
+          "auth": {
+            "in": "header",
+            "name": "Authorization",
+            "prefix": "Bearer "
+          },
+          "agentBinding": {
+            "protocol": "vendor:anthropic-claude-code-routines",
+            "provider": "claude-code-routines",
+            "supports": {
+              "push": false,
+              "inputRequired": true,
+              "cancel": false
+            },
+            "verbs": {
+              "start": "{{key}}_dispatch",
+              "send": "{{key}}_send"
+            }
+          }
+        }
+      }
+    ],
+    "skills": [
+      {
+        "name": "{{key}}_dispatch",
+        "intent": "delegate_agent_task",
+        "kind": "code",
+        "scope": "pod",
+        "description": "Starts a run of the Claude Code routine for a Synap task (the binding's start verb): fires the routine with the fenced task, the session and room ids and the report-back rules as its run context. Returns { externalId (session_...), url (claude.ai/code) }.",
+        "requires": [
+          "claude_code_routines"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "task": "object",
+          "sessionId": "string",
+          "pod": "object",
+          "agent": "object",
+          "repos": "array?",
+          "branch": "string?",
+          "workBranch": "string?",
+          "runId": "string?",
+          "channelId": "string?"
+        },
+        "code": "// Claude Code Routines binding verb. Statement body: the executor wraps it as\n// (async function(args, context){ <code> }). The ONE call is Anthropic's\n// documented routine fire endpoint (experimental):\n//   POST /v1/claude_code/routines/{trig_...}/fire  body {text}  → {claude_code_session_id, claude_code_session_url}\n// callProvider('claude_code_routines', ...) resolves the binding tool by NAME,\n// injects the vaulted per-routine token as `Authorization: Bearer` (tool\n// config.auth) and pins the host to https://api.anthropic.com (tool config.baseUrl).\n// The token can ONLY start this one routine: it reads nothing. The session runs on\n// claude.ai/code and bills the owner's Claude Code subscription.\nconst CFG = { fireUrl: '{{routineFireUrl}}' };\nconst TEXT_MAX = 65536;\nfunction routinePath() {\n  const m = /^https:\\/\\/api\\.anthropic\\.com(\\/v1\\/claude_code\\/routines\\/(trig_[A-Za-z0-9_-]+)\\/fire)\\/?$/.exec(String(CFG.fireUrl || '').trim());\n  if (!m) {\n    throw new Error(\n      'claude-code-routines: routineFireUrl is not a routine fire URL ' +\n      '(https://api.anthropic.com/v1/claude_code/routines/trig_.../fire). Copy it from the routine\\'s API trigger and re-apply the capability.'\n    );\n  }\n  return m[1];\n}\nasync function fire(text) {\n  if (text.length > TEXT_MAX) {\n    throw new Error('claude-code-routines: the kickoff is ' + text.length + ' characters; a routine accepts at most ' + TEXT_MAX + '. Shorten the task.');\n  }\n  // No idempotency key exists on this endpoint: every successful call starts a\n  // NEW session, so this verb is never retried here.\n  const res = await callProvider('claude_code_routines', 'POST', routinePath(), { text }, {\n    headers: { 'anthropic-version': '2023-06-01' },\n  });\n  if (res && res.proposed) {\n    throw new Error(\n      'claude-code-routines: starting the routine was queued for review (proposal ' + res.proposalId + ') instead of running. ' +\n      'Approve that proposal, or grant this agent auto-run on the dispatch/send verbs, then run again.'\n    );\n  }\n  const body = res && res.body !== undefined ? res.body : res;\n  if (!body || typeof body.claude_code_session_id !== 'string') {\n    throw new Error('claude-code-routines: the routine fire returned no session id');\n  }\n  return { externalId: body.claude_code_session_id, url: typeof body.claude_code_session_url === 'string' ? body.claude_code_session_url : null };\n}\n// A person's words / names sit OUTSIDE the fenced task: one line each, capped,\n// so they cannot open a new instruction line or forge a fence marker.\nfunction oneLine(v, max) {\n  return String(v == null ? '' : v).replace(/[\\r\\n\\u2028\\u2029]+/g, ' ').replace(/-{3,}/g, '-').trim().slice(0, max);\n}\nfunction reportBack(args, mcpUrl) {\n  const session = oneLine(args.sessionId, 80);\n  return [\n    'Report back through the Synap MCP connector attached to this routine (' + (mcpUrl || 'the Synap pod') + '):',\n    args.channelId\n      ? '- post progress, questions and results in the Synap session room with post_message, channelId ' + oneLine(args.channelId, 80) + ';'\n      : '- post progress, questions and results in Synap session ' + session + ';',\n    '- pass sessionId ' + session + ' on every Synap write (create, update, capture, proposal), so the work is filed under this session;',\n    '- if you need a person (a question, a choice), ask it there with post_message kind \"question\", then STOP. The session waits on them; their answer starts a NEW run of this routine that continues the work;',\n    '- when the task is complete, post the result there (PR link, branch, findings), then call complete_session for session ' + session + ' with a one-line summary.',\n    'Synap reviews every write you make through it. Never push to a repository\\'s default branch.',\n  ];\n}\n\n// ── start: fire the routine with the task as its run context ────────────────\nconst task = args.task && typeof args.task === 'object' ? args.task : null;\nif (!task || typeof task.goal !== 'string' || !task.goal.trim()) {\n  throw new Error('claude-code-routines: task.goal is required');\n}\nconst pod = args.pod && typeof args.pod === 'object' ? args.pod : {};\nconst mcpUrl = typeof pod.mcpUrl === 'string' ? pod.mcpUrl.trim() : '';\n\nfunction repoOf(raw) {\n  const s = String(raw || '').trim().replace(/\\.git$/, '').replace(/\\/+$/, '');\n  const m = /^https:\\/\\/github\\.com\\/([\\w.-]+)\\/([\\w.-]+)$/.exec(s) || /^([\\w.-]+)\\/([\\w.-]+)$/.exec(s);\n  if (!m) throw new Error('claude-code-routines: \"' + s + '\" is not a GitHub repository (owner/repo or https://github.com/owner/repo)');\n  return m[1] + '/' + m[2];\n}\nfunction branchName(v) {\n  if (typeof v !== 'string' || !v.trim()) return null;\n  const b = v.trim();\n  if (!/^[\\w./-]{1,255}$/.test(b)) throw new Error('claude-code-routines: \"' + b + '\" is not a branch name');\n  return b;\n}\nconst repos = (Array.isArray(args.repos) ? args.repos : []).map(repoOf);\nconst branch = branchName(args.branch);\nconst workBranch = branch ? null : branchName(args.workBranch);\n\nconst lines = [\n  'Synap handed you this task. Synap session ' + oneLine(args.sessionId, 80) + (args.runId ? ', run ' + oneLine(args.runId, 80) : '') + '.',\n  '',\n].concat(reportBack(args, mcpUrl), ['']);\nif (task.currentStage) lines.push('Current stage: ' + oneLine(task.currentStage, 120));\nif (task.subject && task.subject.id) {\n  lines.push('Subject: ' + oneLine(task.subject.name || task.subject.id, 200) + (task.subject.profile ? ' (' + oneLine(task.subject.profile, 80) + ')' : '') + ', Synap id ' + oneLine(task.subject.id, 80));\n}\nif (repos.length) {\n  // The routine's own repositories are what is cloned. A run naming others can\n  // only be worked on if the routine has them; say so instead of pretending.\n  lines.push('Repositories for this task: ' + repos.join(', ') + (branch ? ' on branch ' + branch : '') + '. If one is not attached to this routine, say so in the room and stop.');\n}\nif (workBranch) {\n  lines.push('Work branch: create ' + workBranch + ' from the default branch, push your work to it, and open the pull request from it.');\n}\nlines.push('', 'The task:', task.goal);\nif (typeof task.feedback === 'string' && task.feedback.trim()) lines.push('', 'Reviewer feedback on an earlier attempt:', task.feedback);\n\nconst started = await fire(lines.join('\\n'));\nreturn { externalId: started.externalId, url: started.url, repos: repos };\n"
+      },
+      {
+        "name": "{{key}}_send",
+        "intent": "delegate_agent_task",
+        "kind": "code",
+        "scope": "pod",
+        "description": "Passes a person's answer or decision on (the binding's send verb). A routine session cannot be messaged, so this starts a NEW run of the routine that continues from the Synap room. Returns { externalId (the new session_...), url, continuedFrom }.",
+        "requires": [
+          "claude_code_routines"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "sessionId": "string",
+          "externalId": "string",
+          "message": "object",
+          "channelId": "string?"
+        },
+        "code": "// Claude Code Routines binding verb. Statement body: the executor wraps it as\n// (async function(args, context){ <code> }). The ONE call is Anthropic's\n// documented routine fire endpoint (experimental):\n//   POST /v1/claude_code/routines/{trig_...}/fire  body {text}  → {claude_code_session_id, claude_code_session_url}\n// callProvider('claude_code_routines', ...) resolves the binding tool by NAME,\n// injects the vaulted per-routine token as `Authorization: Bearer` (tool\n// config.auth) and pins the host to https://api.anthropic.com (tool config.baseUrl).\n// The token can ONLY start this one routine: it reads nothing. The session runs on\n// claude.ai/code and bills the owner's Claude Code subscription.\nconst CFG = { fireUrl: '{{routineFireUrl}}' };\nconst TEXT_MAX = 65536;\nfunction routinePath() {\n  const m = /^https:\\/\\/api\\.anthropic\\.com(\\/v1\\/claude_code\\/routines\\/(trig_[A-Za-z0-9_-]+)\\/fire)\\/?$/.exec(String(CFG.fireUrl || '').trim());\n  if (!m) {\n    throw new Error(\n      'claude-code-routines: routineFireUrl is not a routine fire URL ' +\n      '(https://api.anthropic.com/v1/claude_code/routines/trig_.../fire). Copy it from the routine\\'s API trigger and re-apply the capability.'\n    );\n  }\n  return m[1];\n}\nasync function fire(text) {\n  if (text.length > TEXT_MAX) {\n    throw new Error('claude-code-routines: the kickoff is ' + text.length + ' characters; a routine accepts at most ' + TEXT_MAX + '. Shorten the task.');\n  }\n  // No idempotency key exists on this endpoint: every successful call starts a\n  // NEW session, so this verb is never retried here.\n  const res = await callProvider('claude_code_routines', 'POST', routinePath(), { text }, {\n    headers: { 'anthropic-version': '2023-06-01' },\n  });\n  if (res && res.proposed) {\n    throw new Error(\n      'claude-code-routines: starting the routine was queued for review (proposal ' + res.proposalId + ') instead of running. ' +\n      'Approve that proposal, or grant this agent auto-run on the dispatch/send verbs, then run again.'\n    );\n  }\n  const body = res && res.body !== undefined ? res.body : res;\n  if (!body || typeof body.claude_code_session_id !== 'string') {\n    throw new Error('claude-code-routines: the routine fire returned no session id');\n  }\n  return { externalId: body.claude_code_session_id, url: typeof body.claude_code_session_url === 'string' ? body.claude_code_session_url : null };\n}\n// A person's words / names sit OUTSIDE the fenced task: one line each, capped,\n// so they cannot open a new instruction line or forge a fence marker.\nfunction oneLine(v, max) {\n  return String(v == null ? '' : v).replace(/[\\r\\n\\u2028\\u2029]+/g, ' ').replace(/-{3,}/g, '-').trim().slice(0, max);\n}\nfunction reportBack(args, mcpUrl) {\n  const session = oneLine(args.sessionId, 80);\n  return [\n    'Report back through the Synap MCP connector attached to this routine (' + (mcpUrl || 'the Synap pod') + '):',\n    args.channelId\n      ? '- post progress, questions and results in the Synap session room with post_message, channelId ' + oneLine(args.channelId, 80) + ';'\n      : '- post progress, questions and results in Synap session ' + session + ';',\n    '- pass sessionId ' + session + ' on every Synap write (create, update, capture, proposal), so the work is filed under this session;',\n    '- if you need a person (a question, a choice), ask it there with post_message kind \"question\", then STOP. The session waits on them; their answer starts a NEW run of this routine that continues the work;',\n    '- when the task is complete, post the result there (PR link, branch, findings), then call complete_session for session ' + session + ' with a one-line summary.',\n    'Synap reviews every write you make through it. Never push to a repository\\'s default branch.',\n  ];\n}\n\n// ── send: a routine session cannot be messaged — continue in a NEW run ──────\n// The fire endpoint has no follow-up, read or cancel. So a person's answer\n// starts a new run of the same routine, which picks the thread up from the\n// Synap session room (through the Synap MCP connector) and from the previous\n// Claude Code session named below.\nconst message = args.message && typeof args.message === 'object' ? args.message : null;\nif (!message || (message.kind !== 'answer' && message.kind !== 'decision')) {\n  throw new Error('claude-code-routines: message.kind must be \"answer\" or \"decision\"');\n}\nif (message.confirmationId != null) {\n  throw new Error('claude-code-routines: a routine session has no pending tool approval to settle; it asks in the Synap room instead');\n}\nconst fenced = typeof message.text === 'string' ? message.text : '';\nconst previous = oneLine(args.externalId, 120);\nconst head = message.kind === 'decision'\n  ? 'A decision from Synap' + (message.proposalId ? ' on proposal ' + oneLine(message.proposalId, 200) : '') + ': ' + oneLine(message.decision || 'noted', 50) + '.'\n  : 'A person answered in the Synap session' + (message.slotKey ? ' (about: ' + oneLine(message.slotKey, 200) + ')' : '') + '.';\nconst lines = [\n  'You are CONTINUING Synap session ' + oneLine(args.sessionId, 80) + '. The previous Claude Code session was ' + (previous || 'not recorded') + '.',\n  'Read the Synap session room first (get_session, then the room thread) to pick up where it stopped.',\n  '',\n].concat(reportBack(args, ''), ['', head, fenced]);\nconst started = await fire(lines.join('\\n'));\nreturn { externalId: started.externalId, url: started.url, continuedFrom: previous || null, sent: ['routine_fire'] };\n"
+      }
+    ],
+    "provides": [
+      "delegate_agent_task"
+    ],
+    "playbooks": [
+      {
+        "name": "Hand off to Claude Code",
+        "description": "Give a dev task or a research question to your Claude Code routine. It runs in the cloud on your Claude plan, works in the routine's GitHub repos, reports progress and questions in this session's room, and closes the session with its result (PR, branch or findings).",
+        "goalTemplate": "{task}",
+        "params": [
+          {
+            "name": "task",
+            "label": "What should Claude Code do?",
+            "type": "text",
+            "required": true,
+            "description": "The task in your own words: a bug to fix, a feature to build, a question to research. Be specific about what done looks like."
+          },
+          {
+            "name": "repo",
+            "label": "Repository (owner/repo)",
+            "type": "text",
+            "required": false,
+            "description": "Optional. Must be one of the repositories attached to your routine. Leave empty for research."
+          }
+        ],
+        "executor": "external-agent",
+        "status": "active",
+        "stages": [
+          {
+            "key": "working",
+            "name": "Working",
+            "category": "started",
+            "goal": "Claude Code is working; progress and questions appear in the room."
+          },
+          {
+            "key": "review",
+            "name": "Review",
+            "category": "started",
+            "goal": "Review the result Claude Code posted (PR, branch or findings)."
+          },
+          {
+            "key": "done",
+            "name": "Done",
+            "category": "completed"
+          }
+        ]
+      }
+    ]
+  },
+  "dependencies": []
+}