{
  "id": "page:docs-adapters-babysitter-integrations-process-authoring",
  "_kind": "Page",
  "_file": "wiki/docs/adapters-babysitter-integrations/process-authoring.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/adapters-babysitter-integrations/process-authoring.md",
    "sourceKind": "repo-docs",
    "title": "Process Authoring Updates",
    "displayName": "Process Authoring Updates",
    "slug": "docs/adapters-babysitter-integrations/process-authoring",
    "articlePath": "wiki/docs/adapters-babysitter-integrations/process-authoring.md",
    "article": "\n# Process Authoring Updates\n\n## Summary\n\nUpdate process creation prompts, templates, and validation to expose external agent capabilities when adapters is detected. The LLM authoring the process should know what agents are available and how to use them.\n\n## Prompt Context Injection\n\n### Where: `packages/genty/platform/src/harness/internal/createRun/planProcess/phase.ts`\n\nWhen `discoverExternalAgents()` returns agents, inject into the plan process prompt:\n\n```typescript\n// After line 93 (workspaceAssessment):\nconst externalAgents = await discoverExternalAgents({ timeout: 5000 });\n\n// Build agent availability section for prompt:\nif (externalAgents.available && externalAgents.agents.some(a => a.installed)) {\n  const agentList = externalAgents.agents\n    .filter(a => a.installed)\n    .map(a => `- ${a.name} (${a.authenticated ? 'authenticated' : 'not authenticated'})`)\n    .join('\\n');\n\n  promptContext.externalAgentsSection = [\n    '',\n    'Available external agents (via adapters):',\n    agentList,\n    '',\n    'You may delegate specialist work to these agents using external agent tasks:',\n    '  defineTask(\"task-id\", (args) => ({',\n    '    kind: \"agent\",',\n    '    agent: {',\n    '      name: \"Task Name\",',\n    '      prompt: \"Instructions for the external agent...\",',\n    '      responderType: \"agent\",',\n    '      adapter: \"claude-code\",  // or codex, gemini-cli, etc.',\n    '    },',\n    '  }))',\n    '',\n    'Use external agents when:',\n    '- The task requires file editing, bash execution, or browser access (agent-core cannot do these)',\n    '- A specific agent has better capabilities for the task (e.g., codex for code generation)',\n    '- The task benefits from a separate workspace or conversation context',\n    '',\n    'Use internal agent tasks when:',\n    '- The task is purely text generation (summarization, analysis, planning)',\n    '- Low latency is important (internal is faster than spawning external agents)',\n  ].join('\\n');\n}\n```\n\n### Raw Text Session Template (genty path)\n\nIn the `isRawTextSession` branch, append external agent info to the system prompt when available:\n\n```typescript\nif (externalAgents.available && externalAgents.agents.some(a => a.installed)) {\n  processDefinitionSystemPrompt += '\\n\\n' + promptContext.externalAgentsSection;\n}\n```\n\n## Validation Updates\n\n### `packages/genty/platform/src/harness/internal/createRun/planProcess/validationSource.ts`\n\nCurrent validation checks for `kind: \"agent\"` with `agent: { ... }` shape. Extend it to accept `agent.responderType: \"agent\"` routing metadata:\n\n```typescript\n// In getDefineTaskKindShapeMismatches():\n// Accept agent tasks with responderType routing metadata\nif (kind === \"agent\" && properties.has(\"agent\")) {\n  // Valid — both internal and external agent tasks have agent property\n  continue;\n}\n```\n\n### `packages/genty/platform/src/harness/internal/createRun/planProcess/validation.ts`\n\nIn `validateProcessExport()`, don't reject processes that reference external agents even if adapters is not installed at validation time (it may be available at execution time):\n\n```typescript\n// After existing validation:\n// Warn (don't error) about external agent tasks when adapters not detected\nif (hasExternalAgentTasks(source) && !externalAgentsAvailable) {\n  console.warn('[babysitter] process uses external agent tasks but adapters is not detected');\n}\n```\n\n## Conformance Repair Prompt\n\nUpdate `packages/genty/platform/src/harness/internal/createRun/planProcess/phase.ts` conformance repair prompt to include external agent task format:\n\n```\n- External agent tasks must use kind: \"agent\" with agent: { responderType: \"agent\", adapter: \"...\" }\n- The adapter field must be a valid adapters adapter name\n```\n\n## Files to Modify\n\n| File | Change |\n|------|--------|\n| `packages/genty/platform/src/harness/internal/createRun/planProcess/phase.ts` | Inject external agents into prompt context |\n| `packages/genty/platform/src/harness/internal/createRun/planProcess/prompts.ts` | Add externalAgentsSection to prompt builder |\n| `packages/genty/platform/src/harness/internal/createRun/planProcess/validation.ts` | Accept external agent tasks |\n| `packages/genty/platform/src/harness/internal/createRun/planProcess/validationSource.ts` | Update kind shape matching |\n| `packages/babysitter-sdk/src/harness/externalAgentDiscovery.ts` | New — discovery API |\n\n## Documentation Updates\n\n| File | Change |\n|------|--------|\n| `docs/agent-reference/process-authoring.md` | Add external agent task section |\n| `docs/agent-reference/command-surfaces.md` | Document external agent dispatch |\n| `docs/plugins.md` | Note adapters integration |\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-adapters-babysitter-integrations",
      "to": "page:docs-adapters-babysitter-integrations-process-authoring",
      "kind": "contains_page"
    }
  ]
}