@xopcai/xopc 0.0.115 → 0.0.117

package/dist/src/agent/workflow/builtins/release-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"release-check.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/release-check.ts"],"sourcesContent":["/**\n * Built-in workflow: `release_check`\n *\n * Runs a release-readiness review for a finished change. It inspects the diff,\n * validates risk areas in parallel, and produces a go/no-go checklist.\n *\n * Args:\n *   - target: release candidate, branch, commit range, or feature summary\n *   - checks: optional subset of check keys\n */\n\nexport const RELEASE_CHECK_SCRIPT = `export const meta = {\n  name: 'release_check',\n  description: 'Assess whether a change is ready to release with parallel risk checks and a go/no-go verdict.',\n  whenToUse: 'User is near the end of implementation and wants a release-quality readiness check before shipping.',\n  examplePrompts: [\n    { field: 'target', text: 'Is this repo ready to release v1.2?' },\n    { field: 'target', text: 'Pre-release readiness check for the current branch' },\n  ],\n  i18n: {\n    zh: {\n      description: '并行检查发布风险，判断变更是否达到可发布标准。',\n      whenToUse: '用户接近开发尾声，想在发布前做发布质量/就绪检查时。',\n      examplePrompts: [\n        { field: 'target', text: '这个仓库是否准备好发布 v1.2？' },\n        { field: 'target', text: '对当前分支做发布前就绪检查' },\n      ],\n    },\n  },\n  tags: ['release', 'quality', 'validation'],\n  estimatedAgents: { min: 6, max: 7 },\n  phases: [\n    { title: 'Scope' },\n    { title: 'Checks' },\n    { title: 'Verdict' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst target = args && typeof args === 'object' && args.target\n  ? String(args.target)\n  : 'Current working tree or release candidate from the conversation context.'\n\nconst ALL_CHECKS = [\n  { key: 'regression', focus: 'Behavior changes, compatibility breaks, edge cases, and accidental scope creep.' },\n  { key: 'tests', focus: 'Relevant automated tests, missing regression cases, flaky or weak assertions, and manual coverage gaps.' },\n  { key: 'build', focus: 'Typecheck, lint, build, packaging, lazy imports, generated assets, and dependency correctness.' },\n  { key: 'security', focus: 'Secrets, auth/authz, input validation, unsafe shell/file/network access, and data exposure.' },\n  { key: 'ops', focus: 'Logging, observability, migrations, persistence, rollback, failure modes, and supportability.' },\n]\n\nlet checks = ALL_CHECKS\nif (args && typeof args === 'object' && Array.isArray(args.checks) && args.checks.length) {\n  const selected = new Set(args.checks.map((check) => String(check)))\n  checks = ALL_CHECKS.filter((check) => selected.has(check.key))\n  if (!checks.length) checks = ALL_CHECKS\n}\n\nphase('Scope')\nconst scope = await agent(\n  'Identify the release candidate scope. Inspect the working tree or target if useful. Return changed areas, user-visible behavior, and likely blast radius.\\\\n\\\\n' +\n    'TARGET:\\\\n' + target,\n  {\n    label: 'release scope',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        changedAreas: { type: 'array', items: { type: 'string' } },\n        userVisibleChanges: { type: 'array', items: { type: 'string' } },\n        blastRadius: { type: 'string' },\n      },\n      required: ['changedAreas', 'blastRadius'],\n    },\n  },\n)\n\nphase('Checks')\nconst reports = await parallel(\n  checks.map((check) => () =>\n    agent(\n      'Run a release-readiness check through the ' + check.key + ' lens.\\\\n' +\n        'Focus: ' + check.focus + '\\\\n\\\\n' +\n        'TARGET:\\\\n' + target + '\\\\n\\\\n' +\n        'SCOPE:\\\\n' + JSON.stringify(scope, null, 2) + '\\\\n\\\\n' +\n        'Return blockers, warnings, evidence, and concrete fixes. Prefer specific files/commands over generic statements.',\n      {\n        label: check.key + ' check',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            blockers: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  evidence: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['title', 'evidence', 'fix'],\n              },\n            },\n            warnings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  evidence: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['title', 'evidence'],\n              },\n            },\n            recommendedCommands: { type: 'array', items: { type: 'string' } },\n          },\n          required: ['blockers', 'warnings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Verdict')\nconst byCheck = {}\nfor (let i = 0; i < checks.length; i++) {\n  byCheck[checks[i].key] = reports[i] ?? { blockers: [], warnings: [], recommendedCommands: [] }\n}\n\nconst verdict = await agent(\n  'Synthesize a release go/no-go verdict. Block if any credible blocker remains. If not blocked, distinguish ship_now from ship_after_checks. ' +\n    'Deduplicate issues and produce the shortest checklist that would make this release safe.\\\\n\\\\n' +\n    JSON.stringify({ target, scope, byCheck }, null, 2),\n  {\n    label: 'release verdict',\n    schema: {\n      type: 'object',\n      properties: {\n        recommendation: { type: 'string', enum: ['ship_now', 'ship_after_checks', 'block'] },\n        summary: { type: 'string' },\n        blockers: { type: 'array', items: { type: 'string' } },\n        finalChecklist: { type: 'array', items: { type: 'string' } },\n        commandsToRun: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['recommendation', 'summary', 'blockers', 'finalChecklist'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  target,\n  checks: checks.map((check) => check.key),\n  scope,\n  ...(verdict ?? { recommendation: 'ship_after_checks', summary: 'verdict failed', blockers: [], finalChecklist: [] }),\n  byCheck,\n}\n`\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,uBAAuB"}
+{"version":3,"file":"release-check.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/release-check.ts"],"sourcesContent":["/**\n * Built-in workflow: `release_check`\n *\n * Runs a release-readiness review for a finished change. It inspects the diff,\n * validates risk areas in parallel, and produces a go/no-go checklist.\n *\n * Args:\n *   - target: release candidate, branch, commit range, or feature summary\n *   - checks: optional subset of check keys\n */\n\nexport const RELEASE_CHECK_SCRIPT = `export const meta = {\n  name: 'release_check',\n  description: 'Assess whether a change is ready to release with parallel risk checks and a go/no-go verdict.',\n  whenToUse: 'User is near the end of implementation and wants a release-quality readiness check before shipping.',\n  examplePrompts: [\n    { field: 'target', text: 'Is this repo ready to release v1.2?' },\n    { field: 'target', text: 'Pre-release readiness check for the current branch' },\n  ],\n  i18n: {\n    zh: {\n      description: '并行检查发布风险，判断变更是否达到可发布标准。',\n      whenToUse: '用户接近开发尾声，想在发布前做发布质量/就绪检查时。',\n      examplePrompts: [\n        { field: 'target', text: '这个仓库是否准备好发布 v1.2？' },\n        { field: 'target', text: '对当前分支做发布前就绪检查' },\n      ],\n    },\n  },\n  tags: ['release', 'quality', 'validation'],\n  estimatedAgents: { min: 6, max: 7 },\n  phases: [\n    { title: 'Scope' },\n    { title: 'Checks' },\n    { title: 'Verdict' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst target = args && typeof args === 'object' && args.target\n  ? String(args.target)\n  : 'Current working tree or release candidate from the conversation context.'\n\nconst ALL_CHECKS = [\n  { key: 'regression', focus: 'Behavior changes, compatibility breaks, edge cases, and accidental scope creep.' },\n  { key: 'tests', focus: 'Relevant automated tests, missing regression cases, flaky or weak assertions, and manual coverage gaps.' },\n  { key: 'build', focus: 'Typecheck, lint, build, packaging, lazy imports, generated assets, and dependency correctness.' },\n  { key: 'security', focus: 'Secrets, auth/authz, input validation, unsafe shell/file/network access, and data exposure.' },\n  { key: 'ops', focus: 'Logging, observability, migrations, persistence, rollback, failure modes, and supportability.' },\n]\n\nlet checks = ALL_CHECKS\nif (args && typeof args === 'object' && Array.isArray(args.checks) && args.checks.length) {\n  const selected = new Set(args.checks.map((check) => String(check)))\n  checks = ALL_CHECKS.filter((check) => selected.has(check.key))\n  if (!checks.length) checks = ALL_CHECKS\n}\n\nphase('Scope')\nconst scope = await agent(\n  'Identify the release candidate scope. Inspect the working tree or target if useful. Return changed areas, user-visible behavior, and likely blast radius.\\\\n\\\\n' +\n    'TARGET:\\\\n' + target,\n  {\n    label: 'release scope',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        changedAreas: { type: 'array', items: { type: 'string' } },\n        userVisibleChanges: { type: 'array', items: { type: 'string' } },\n        blastRadius: { type: 'string' },\n      },\n      required: ['changedAreas', 'blastRadius'],\n    },\n  },\n)\n\nphase('Checks')\nconst reports = await parallel(\n  checks.map((check) => () =>\n    agent(\n      'Run a release-readiness check through the ' + check.key + ' lens.\\\\n' +\n        'Focus: ' + check.focus + '\\\\n\\\\n' +\n        'TARGET:\\\\n' + target + '\\\\n\\\\n' +\n        'SCOPE:\\\\n' + JSON.stringify(scope, null, 2) + '\\\\n\\\\n' +\n        'Return blockers, warnings, evidence, and concrete fixes. Prefer specific files/commands over generic statements.',\n      {\n        label: check.key + ' check',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            blockers: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  evidence: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['title', 'evidence', 'fix'],\n              },\n            },\n            warnings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  evidence: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['title', 'evidence'],\n              },\n            },\n            recommendedCommands: { type: 'array', items: { type: 'string' } },\n          },\n          required: ['blockers', 'warnings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Verdict')\nconst byCheck = {}\nfor (let i = 0; i < checks.length; i++) {\n  byCheck[checks[i].key] = reports[i] ?? { blockers: [], warnings: [], recommendedCommands: [] }\n}\n\nconst verdict = await agent(\n  'Synthesize a release go/no-go verdict. Block if any credible blocker remains. If not blocked, distinguish ship_now from ship_after_checks. ' +\n    'Deduplicate issues and produce the shortest checklist that would make this release safe.\\\\n\\\\n' +\n    JSON.stringify({ target, scope, byCheck }, null, 2),\n  {\n    label: 'release verdict',\n    schema: {\n      type: 'object',\n      properties: {\n        recommendation: { type: 'string', enum: ['ship_now', 'ship_after_checks', 'block'] },\n        summary: { type: 'string' },\n        blockers: { type: 'array', items: { type: 'string' } },\n        finalChecklist: { type: 'array', items: { type: 'string' } },\n        commandsToRun: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['recommendation', 'summary', 'blockers', 'finalChecklist'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  target,\n  checks: checks.map((check) => check.key),\n  scope,\n  ...(verdict ?? { recommendation: 'ship_after_checks', summary: 'verdict failed', blockers: [], finalChecklist: [] }),\n  byCheck,\n}\nreturn {\n  summary: output.summary,\n  sections: [\n    { kind: 'risks', title: 'Blockers', items: output.blockers.map((title) => ({ title, severity: 'high' })) },\n    { kind: 'questions', title: 'Final checklist', items: output.finalChecklist },\n    { kind: 'questions', title: 'Commands to run', items: output.commandsToRun ?? [] },\n  ],\n  structuredOutput: output,\n}\n`\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,uBAAuB"}

package/dist/src/agent/workflow/builtins/research.d.ts

@@ -10,4 +10,4 @@
  *   - question: research question
  *   - depth: 'quick' (2 angles) | 'standard' (4) | 'deep' (6)
  */
-export declare const RESEARCH_SCRIPT = "export const meta = {\n  name: 'research',\n  description: 'Multi-angle research on a question with parallel exploration and a cited synthesis.',\n  whenToUse: 'User asks a non-trivial research question that benefits from multiple search angles or source reads.',\n  examplePrompts: [\n    { field: 'question', text: 'Compare Bun vs Node startup performance' },\n    { field: 'question', text: 'What are the trade-offs of SQLite vs Postgres for this app?' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u591A\u89D2\u5EA6\u5E76\u884C\u8C03\u7814\u4E00\u4E2A\u95EE\u9898\uFF0C\u5E76\u4EA7\u51FA\u5E26\u5F15\u7528\u7684\u7EFC\u5408\u62A5\u544A\u3002',\n      whenToUse: '\u7528\u6237\u63D0\u51FA\u9700\u8981\u591A\u89D2\u5EA6\u68C0\u7D22\u3001\u9605\u8BFB\u6765\u6E90\u7684\u975E\u5E73\u51E1\u8C03\u7814\u95EE\u9898\u65F6\u3002',\n      examplePrompts: [\n        { field: 'question', text: '\u6BD4\u8F83 Bun \u4E0E Node \u7684\u542F\u52A8\u6027\u80FD' },\n        { field: 'question', text: '\u8FD9\u4E2A\u5E94\u7528\u7528 SQLite \u8FD8\u662F Postgres \u5404\u6709\u4EC0\u4E48\u6743\u8861\uFF1F' },\n      ],\n    },\n  },\n  tags: ['research', 'investigation'],\n  estimatedAgents: { min: 4, max: 8 },\n  phases: [\n    { title: 'Frame' },\n    { title: 'Sweep' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst RESEARCH_TOOLS = ['web_search', 'web_fetch', 'read_file', 'grep', 'find', 'list_dir']\n\nconst question = args && typeof args === 'object' && args.question\n  ? String(args.question)\n  : 'No explicit question supplied; infer from the most recent user turn.'\n\nconst depth = args && typeof args === 'object' && args.depth\n  ? String(args.depth)\n  : 'standard'\nconst maxAngles = depth === 'quick' ? 2 : depth === 'deep' ? 6 : 4\n\nphase('Frame')\nconst frame = await agent(\n  'Frame this research question. Return exactly ' + maxAngles + ' distinct angles worth investigating, ' +\n    'each with the single most decisive sub-question. Be concrete.\\n\\nQUESTION:\\n' +\n    question,\n  {\n    label: 'framing',\n    schema: {\n      type: 'object',\n      properties: {\n        angles: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              title: { type: 'string' },\n              key_question: { type: 'string' },\n            },\n            required: ['title', 'key_question'],\n          },\n        },\n      },\n      required: ['angles'],\n    },\n  },\n)\n\nif (!frame || !frame.angles?.length) {\n  return { ok: false, reason: 'framing failed', question, depth }\n}\n\nconst angles = frame.angles.slice(0, maxAngles)\n\nphase('Sweep')\nconst angleReports = await parallel(\n  angles.map((a) => () =>\n    agent(\n      'Investigate this angle. Use search and source-read tools liberally. Distinguish what you can confirm from what is conjecture.\\n\\n' +\n        'ANGLE: ' + a.title + '\\n' +\n        'KEY QUESTION: ' + a.key_question + '\\n\\n' +\n        'Return: 3\u20136 grounded findings (each with a 1-line claim and a source URL or file path), plus the strongest counter-evidence.',\n      {\n        label: a.title,\n        toolset: RESEARCH_TOOLS,\n        maxIterations: depth === 'deep' ? 40 : 30,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  claim: { type: 'string' },\n                  source: { type: 'string' },\n                  confidence: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['claim', 'source', 'confidence'],\n              },\n            },\n            counterEvidence: { type: 'string' },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = angleReports.filter(Boolean)\nconst synthesis = await agent(\n  'Synthesize a cited research report from these angle-level findings. Drop unsupported or duplicate claims. Use the highest-confidence source per claim. ' +\n    'Explicitly list contradictions where angles disagree. Return: an executive summary (max 5 sentences), top findings with inline source URLs, open questions, and contradictions.\\n\\n' +\n    'QUESTION:\\n' + question + '\\n\\n' +\n    JSON.stringify({ angles, reports: live }, null, 2),\n  {\n    label: 'synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        executiveSummary: { type: 'string' },\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              claim: { type: 'string' },\n              source: { type: 'string' },\n            },\n            required: ['claim', 'source'],\n          },\n        },\n        openQuestions: { type: 'array', items: { type: 'string' } },\n        contradictions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              topic: { type: 'string' },\n              sides: { type: 'array', items: { type: 'string' } },\n            },\n            required: ['topic', 'sides'],\n          },\n        },\n      },\n      required: ['executiveSummary', 'topFindings'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  question,\n  depth,\n  angleCount: angles.length,\n  ...(synthesis ?? { executiveSummary: 'synthesis failed', topFindings: [], contradictions: [] }),\n}\n";
+export declare const RESEARCH_SCRIPT = "export const meta = {\n  name: 'research',\n  description: 'Multi-angle research on a question with parallel exploration and a cited synthesis.',\n  whenToUse: 'User asks a non-trivial research question that benefits from multiple search angles or source reads.',\n  examplePrompts: [\n    { field: 'question', text: 'Compare Bun vs Node startup performance' },\n    { field: 'question', text: 'What are the trade-offs of SQLite vs Postgres for this app?' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u591A\u89D2\u5EA6\u5E76\u884C\u8C03\u7814\u4E00\u4E2A\u95EE\u9898\uFF0C\u5E76\u4EA7\u51FA\u5E26\u5F15\u7528\u7684\u7EFC\u5408\u62A5\u544A\u3002',\n      whenToUse: '\u7528\u6237\u63D0\u51FA\u9700\u8981\u591A\u89D2\u5EA6\u68C0\u7D22\u3001\u9605\u8BFB\u6765\u6E90\u7684\u975E\u5E73\u51E1\u8C03\u7814\u95EE\u9898\u65F6\u3002',\n      examplePrompts: [\n        { field: 'question', text: '\u6BD4\u8F83 Bun \u4E0E Node \u7684\u542F\u52A8\u6027\u80FD' },\n        { field: 'question', text: '\u8FD9\u4E2A\u5E94\u7528\u7528 SQLite \u8FD8\u662F Postgres \u5404\u6709\u4EC0\u4E48\u6743\u8861\uFF1F' },\n      ],\n    },\n  },\n  tags: ['research', 'investigation'],\n  estimatedAgents: { min: 4, max: 8 },\n  phases: [\n    { title: 'Frame' },\n    { title: 'Sweep' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst RESEARCH_TOOLS = ['web_search', 'web_fetch', 'read_file', 'grep', 'find', 'list_dir']\n\nconst question = args && typeof args === 'object' && args.question\n  ? String(args.question)\n  : 'No explicit question supplied; infer from the most recent user turn.'\n\nconst depth = args && typeof args === 'object' && args.depth\n  ? String(args.depth)\n  : 'standard'\nconst maxAngles = depth === 'quick' ? 2 : depth === 'deep' ? 6 : 4\n\nphase('Frame')\nconst frame = await agent(\n  'Frame this research question. Return exactly ' + maxAngles + ' distinct angles worth investigating, ' +\n    'each with the single most decisive sub-question. Be concrete.\\n\\nQUESTION:\\n' +\n    question,\n  {\n    label: 'framing',\n    schema: {\n      type: 'object',\n      properties: {\n        angles: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              title: { type: 'string' },\n              key_question: { type: 'string' },\n            },\n            required: ['title', 'key_question'],\n          },\n        },\n      },\n      required: ['angles'],\n    },\n  },\n)\n\nif (!frame || !frame.angles?.length) {\n  const output = { ok: false, reason: 'framing failed', question, depth }\n  return {\n    summary: output.reason,\n    sections: [{ kind: 'json', title: 'Research framing', value: output }],\n    structuredOutput: output,\n  }\n}\n\nconst angles = frame.angles.slice(0, maxAngles)\n\nphase('Sweep')\nconst angleReports = await parallel(\n  angles.map((a) => () =>\n    agent(\n      'Investigate this angle. Use search and source-read tools liberally. Distinguish what you can confirm from what is conjecture.\\n\\n' +\n        'ANGLE: ' + a.title + '\\n' +\n        'KEY QUESTION: ' + a.key_question + '\\n\\n' +\n        'Return: 3\u20136 grounded findings (each with a 1-line claim and a source URL or file path), plus the strongest counter-evidence.',\n      {\n        label: a.title,\n        toolset: RESEARCH_TOOLS,\n        maxIterations: depth === 'deep' ? 40 : 30,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  claim: { type: 'string' },\n                  source: { type: 'string' },\n                  confidence: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['claim', 'source', 'confidence'],\n              },\n            },\n            counterEvidence: { type: 'string' },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = angleReports.filter(Boolean)\nconst synthesis = await agent(\n  'Synthesize a cited research report from these angle-level findings. Drop unsupported or duplicate claims. Use the highest-confidence source per claim. ' +\n    'Explicitly list contradictions where angles disagree. Return: an executive summary (max 5 sentences), top findings with inline source URLs, open questions, and contradictions.\\n\\n' +\n    'QUESTION:\\n' + question + '\\n\\n' +\n    JSON.stringify({ angles, reports: live }, null, 2),\n  {\n    label: 'synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        executiveSummary: { type: 'string' },\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              claim: { type: 'string' },\n              source: { type: 'string' },\n            },\n            required: ['claim', 'source'],\n          },\n        },\n        openQuestions: { type: 'array', items: { type: 'string' } },\n        contradictions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              topic: { type: 'string' },\n              sides: { type: 'array', items: { type: 'string' } },\n            },\n            required: ['topic', 'sides'],\n          },\n        },\n      },\n      required: ['executiveSummary', 'topFindings'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  question,\n  depth,\n  angleCount: angles.length,\n  ...(synthesis ?? { executiveSummary: 'synthesis failed', topFindings: [], contradictions: [] }),\n}\nreturn {\n  summary: output.executiveSummary,\n  sections: [\n    { kind: 'findings', title: 'Top findings', items: output.topFindings.map((item) => ({ title: item.claim, detail: item.source })) },\n    { kind: 'questions', title: 'Open questions', items: output.openQuestions ?? [] },\n    { kind: 'json', title: 'Contradictions', value: output.contradictions ?? [] },\n  ],\n  structuredOutput: output,\n}\n";

package/dist/src/agent/workflow/builtins/research.js

@@ -77,7 +77,12 @@ const frame = await agent(
 )
 
 if (!frame || !frame.angles?.length) {
-  return { ok: false, reason: 'framing failed', question, depth }
+  const output = { ok: false, reason: 'framing failed', question, depth }
+  return {
+    summary: output.reason,
+    sections: [{ kind: 'json', title: 'Research framing', value: output }],
+    structuredOutput: output,
+  }
 }
 
 const angles = frame.angles.slice(0, maxAngles)
@@ -160,13 +165,22 @@ const synthesis = await agent(
   },
 )
 
-return {
+const output = {
   ok: true,
   question,
   depth,
   angleCount: angles.length,
   ...(synthesis ?? { executiveSummary: 'synthesis failed', topFindings: [], contradictions: [] }),
 }
+return {
+  summary: output.executiveSummary,
+  sections: [
+    { kind: 'findings', title: 'Top findings', items: output.topFindings.map((item) => ({ title: item.claim, detail: item.source })) },
+    { kind: 'questions', title: 'Open questions', items: output.openQuestions ?? [] },
+    { kind: 'json', title: 'Contradictions', value: output.contradictions ?? [] },
+  ],
+  structuredOutput: output,
+}
 `;
 //#endregion
 export { RESEARCH_SCRIPT };

package/dist/src/agent/workflow/builtins/research.js.map

@@ -1 +1 @@
-{"version":3,"file":"research.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/research.ts"],"sourcesContent":["/**\n * Built-in workflow: `research`\n *\n * Multi-modal research sweep on a question (args.question). Fans out search /\n * exploration / source-reading angles in parallel, then synthesises a cited\n * report. Each angle is its own subagent so source reading does not pollute the\n * parent context.\n *\n * Args:\n *   - question: research question\n *   - depth: 'quick' (2 angles) | 'standard' (4) | 'deep' (6)\n */\n\nexport const RESEARCH_SCRIPT = `export const meta = {\n  name: 'research',\n  description: 'Multi-angle research on a question with parallel exploration and a cited synthesis.',\n  whenToUse: 'User asks a non-trivial research question that benefits from multiple search angles or source reads.',\n  examplePrompts: [\n    { field: 'question', text: 'Compare Bun vs Node startup performance' },\n    { field: 'question', text: 'What are the trade-offs of SQLite vs Postgres for this app?' },\n  ],\n  i18n: {\n    zh: {\n      description: '多角度并行调研一个问题，并产出带引用的综合报告。',\n      whenToUse: '用户提出需要多角度检索、阅读来源的非平凡调研问题时。',\n      examplePrompts: [\n        { field: 'question', text: '比较 Bun 与 Node 的启动性能' },\n        { field: 'question', text: '这个应用用 SQLite 还是 Postgres 各有什么权衡？' },\n      ],\n    },\n  },\n  tags: ['research', 'investigation'],\n  estimatedAgents: { min: 4, max: 8 },\n  phases: [\n    { title: 'Frame' },\n    { title: 'Sweep' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst RESEARCH_TOOLS = ['web_search', 'web_fetch', 'read_file', 'grep', 'find', 'list_dir']\n\nconst question = args && typeof args === 'object' && args.question\n  ? String(args.question)\n  : 'No explicit question supplied; infer from the most recent user turn.'\n\nconst depth = args && typeof args === 'object' && args.depth\n  ? String(args.depth)\n  : 'standard'\nconst maxAngles = depth === 'quick' ? 2 : depth === 'deep' ? 6 : 4\n\nphase('Frame')\nconst frame = await agent(\n  'Frame this research question. Return exactly ' + maxAngles + ' distinct angles worth investigating, ' +\n    'each with the single most decisive sub-question. Be concrete.\\\\n\\\\nQUESTION:\\\\n' +\n    question,\n  {\n    label: 'framing',\n    schema: {\n      type: 'object',\n      properties: {\n        angles: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              title: { type: 'string' },\n              key_question: { type: 'string' },\n            },\n            required: ['title', 'key_question'],\n          },\n        },\n      },\n      required: ['angles'],\n    },\n  },\n)\n\nif (!frame || !frame.angles?.length) {\n  return { ok: false, reason: 'framing failed', question, depth }\n}\n\nconst angles = frame.angles.slice(0, maxAngles)\n\nphase('Sweep')\nconst angleReports = await parallel(\n  angles.map((a) => () =>\n    agent(\n      'Investigate this angle. Use search and source-read tools liberally. Distinguish what you can confirm from what is conjecture.\\\\n\\\\n' +\n        'ANGLE: ' + a.title + '\\\\n' +\n        'KEY QUESTION: ' + a.key_question + '\\\\n\\\\n' +\n        'Return: 3–6 grounded findings (each with a 1-line claim and a source URL or file path), plus the strongest counter-evidence.',\n      {\n        label: a.title,\n        toolset: RESEARCH_TOOLS,\n        maxIterations: depth === 'deep' ? 40 : 30,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  claim: { type: 'string' },\n                  source: { type: 'string' },\n                  confidence: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['claim', 'source', 'confidence'],\n              },\n            },\n            counterEvidence: { type: 'string' },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = angleReports.filter(Boolean)\nconst synthesis = await agent(\n  'Synthesize a cited research report from these angle-level findings. Drop unsupported or duplicate claims. Use the highest-confidence source per claim. ' +\n    'Explicitly list contradictions where angles disagree. Return: an executive summary (max 5 sentences), top findings with inline source URLs, open questions, and contradictions.\\\\n\\\\n' +\n    'QUESTION:\\\\n' + question + '\\\\n\\\\n' +\n    JSON.stringify({ angles, reports: live }, null, 2),\n  {\n    label: 'synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        executiveSummary: { type: 'string' },\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              claim: { type: 'string' },\n              source: { type: 'string' },\n            },\n            required: ['claim', 'source'],\n          },\n        },\n        openQuestions: { type: 'array', items: { type: 'string' } },\n        contradictions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              topic: { type: 'string' },\n              sides: { type: 'array', items: { type: 'string' } },\n            },\n            required: ['topic', 'sides'],\n          },\n        },\n      },\n      required: ['executiveSummary', 'topFindings'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  question,\n  depth,\n  angleCount: angles.length,\n  ...(synthesis ?? { executiveSummary: 'synthesis failed', topFindings: [], contradictions: [] }),\n}\n`\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,kBAAkB"}
+{"version":3,"file":"research.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/research.ts"],"sourcesContent":["/**\n * Built-in workflow: `research`\n *\n * Multi-modal research sweep on a question (args.question). Fans out search /\n * exploration / source-reading angles in parallel, then synthesises a cited\n * report. Each angle is its own subagent so source reading does not pollute the\n * parent context.\n *\n * Args:\n *   - question: research question\n *   - depth: 'quick' (2 angles) | 'standard' (4) | 'deep' (6)\n */\n\nexport const RESEARCH_SCRIPT = `export const meta = {\n  name: 'research',\n  description: 'Multi-angle research on a question with parallel exploration and a cited synthesis.',\n  whenToUse: 'User asks a non-trivial research question that benefits from multiple search angles or source reads.',\n  examplePrompts: [\n    { field: 'question', text: 'Compare Bun vs Node startup performance' },\n    { field: 'question', text: 'What are the trade-offs of SQLite vs Postgres for this app?' },\n  ],\n  i18n: {\n    zh: {\n      description: '多角度并行调研一个问题，并产出带引用的综合报告。',\n      whenToUse: '用户提出需要多角度检索、阅读来源的非平凡调研问题时。',\n      examplePrompts: [\n        { field: 'question', text: '比较 Bun 与 Node 的启动性能' },\n        { field: 'question', text: '这个应用用 SQLite 还是 Postgres 各有什么权衡？' },\n      ],\n    },\n  },\n  tags: ['research', 'investigation'],\n  estimatedAgents: { min: 4, max: 8 },\n  phases: [\n    { title: 'Frame' },\n    { title: 'Sweep' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst RESEARCH_TOOLS = ['web_search', 'web_fetch', 'read_file', 'grep', 'find', 'list_dir']\n\nconst question = args && typeof args === 'object' && args.question\n  ? String(args.question)\n  : 'No explicit question supplied; infer from the most recent user turn.'\n\nconst depth = args && typeof args === 'object' && args.depth\n  ? String(args.depth)\n  : 'standard'\nconst maxAngles = depth === 'quick' ? 2 : depth === 'deep' ? 6 : 4\n\nphase('Frame')\nconst frame = await agent(\n  'Frame this research question. Return exactly ' + maxAngles + ' distinct angles worth investigating, ' +\n    'each with the single most decisive sub-question. Be concrete.\\\\n\\\\nQUESTION:\\\\n' +\n    question,\n  {\n    label: 'framing',\n    schema: {\n      type: 'object',\n      properties: {\n        angles: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              title: { type: 'string' },\n              key_question: { type: 'string' },\n            },\n            required: ['title', 'key_question'],\n          },\n        },\n      },\n      required: ['angles'],\n    },\n  },\n)\n\nif (!frame || !frame.angles?.length) {\n  const output = { ok: false, reason: 'framing failed', question, depth }\n  return {\n    summary: output.reason,\n    sections: [{ kind: 'json', title: 'Research framing', value: output }],\n    structuredOutput: output,\n  }\n}\n\nconst angles = frame.angles.slice(0, maxAngles)\n\nphase('Sweep')\nconst angleReports = await parallel(\n  angles.map((a) => () =>\n    agent(\n      'Investigate this angle. Use search and source-read tools liberally. Distinguish what you can confirm from what is conjecture.\\\\n\\\\n' +\n        'ANGLE: ' + a.title + '\\\\n' +\n        'KEY QUESTION: ' + a.key_question + '\\\\n\\\\n' +\n        'Return: 3–6 grounded findings (each with a 1-line claim and a source URL or file path), plus the strongest counter-evidence.',\n      {\n        label: a.title,\n        toolset: RESEARCH_TOOLS,\n        maxIterations: depth === 'deep' ? 40 : 30,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  claim: { type: 'string' },\n                  source: { type: 'string' },\n                  confidence: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['claim', 'source', 'confidence'],\n              },\n            },\n            counterEvidence: { type: 'string' },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = angleReports.filter(Boolean)\nconst synthesis = await agent(\n  'Synthesize a cited research report from these angle-level findings. Drop unsupported or duplicate claims. Use the highest-confidence source per claim. ' +\n    'Explicitly list contradictions where angles disagree. Return: an executive summary (max 5 sentences), top findings with inline source URLs, open questions, and contradictions.\\\\n\\\\n' +\n    'QUESTION:\\\\n' + question + '\\\\n\\\\n' +\n    JSON.stringify({ angles, reports: live }, null, 2),\n  {\n    label: 'synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        executiveSummary: { type: 'string' },\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              claim: { type: 'string' },\n              source: { type: 'string' },\n            },\n            required: ['claim', 'source'],\n          },\n        },\n        openQuestions: { type: 'array', items: { type: 'string' } },\n        contradictions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              topic: { type: 'string' },\n              sides: { type: 'array', items: { type: 'string' } },\n            },\n            required: ['topic', 'sides'],\n          },\n        },\n      },\n      required: ['executiveSummary', 'topFindings'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  question,\n  depth,\n  angleCount: angles.length,\n  ...(synthesis ?? { executiveSummary: 'synthesis failed', topFindings: [], contradictions: [] }),\n}\nreturn {\n  summary: output.executiveSummary,\n  sections: [\n    { kind: 'findings', title: 'Top findings', items: output.topFindings.map((item) => ({ title: item.claim, detail: item.source })) },\n    { kind: 'questions', title: 'Open questions', items: output.openQuestions ?? [] },\n    { kind: 'json', title: 'Contradictions', value: output.contradictions ?? [] },\n  ],\n  structuredOutput: output,\n}\n`\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,kBAAkB"}

package/dist/src/agent/workflow/builtins/weekly-review.d.ts

@@ -9,4 +9,4 @@
  *   - blockers: what stalled or frustrated progress
  *   - carryover: unfinished items (optional)
  */
-export declare const WEEKLY_REVIEW_SCRIPT = "export const meta = {\n  name: 'weekly_review',\n  description: 'Review the week and produce 3\u20135 prioritized actions for next week.',\n  whenToUse: 'Solo founder or super-individual doing a weekly retrospective and planning session.',\n  examplePrompts: [\n    { field: 'wins', text: 'Shipped landing page, got 2 demo calls, published one newsletter' },\n    { field: 'blockers', text: 'Pricing still unclear, one client ghosted, distracted by side tasks' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u590D\u76D8\u672C\u5468\u5E76\u4EA7\u51FA\u4E0B\u5468 3\u20135 \u9879\u4F18\u5148\u884C\u52A8\u3002',\n      whenToUse: '\u4E00\u4EBA\u516C\u53F8\u6216\u8D85\u7EA7\u4E2A\u4F53\u505A\u5468\u590D\u76D8\u4E0E\u4E0B\u5468\u89C4\u5212\u65F6\u3002',\n      examplePrompts: [\n        { field: 'wins', text: '\u4E0A\u7EBF\u4E86\u843D\u5730\u9875\u3001\u62FF\u5230 2 \u4E2A demo\u3001\u53D1\u4E86\u4E00\u671F newsletter' },\n        { field: 'blockers', text: '\u5B9A\u4EF7\u8FD8\u4E0D\u6E05\u6670\u3001\u4E00\u4E2A\u5BA2\u6237\u5931\u8054\u3001\u88AB\u6742\u4E8B\u5206\u5FC3' },\n      ],\n    },\n  },\n  tags: ['productivity', 'brainstorm'],\n  estimatedAgents: { min: 3, max: 4 },\n  phases: [\n    { title: 'Collect' },\n    { title: 'Analyze' },\n    { title: 'Plan' },\n  ],\n}\n\nconst wins = args && typeof args === 'object' && args.wins\n  ? String(args.wins)\n  : 'Infer wins from the most recent user turn.'\n\nconst blockers = args && typeof args === 'object' && args.blockers\n  ? String(args.blockers)\n  : 'None specified \u2014 infer from context if possible.'\n\nconst carryover = args && typeof args === 'object' && args.carryover\n  ? String(args.carryover)\n  : ''\n\nphase('Collect')\nconst collected = await agent(\n  'Normalize this weekly input into structured facts: wins, blockers, carryover, energy level signals, and revenue/impact signals if mentioned. Be concise.\\n\\n' +\n    'WINS:\\n' + wins + '\\nBLOCKERS:\\n' + blockers + '\\nCARRYOVER:\\n' + (carryover || '(none)'),\n  {\n    label: 'collect',\n    schema: {\n      type: 'object',\n      properties: {\n        wins: { type: 'array', items: { type: 'string' } },\n        blockers: { type: 'array', items: { type: 'string' } },\n        carryover: { type: 'array', items: { type: 'string' } },\n        themes: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['wins', 'blockers'],\n    },\n  },\n)\n\nphase('Analyze')\nconst analysis = await agent(\n  'Analyze this week for a solo operator. Identify patterns, root causes of blockers, what to stop doing, what to double down on, and one honest lesson.\\n\\n' +\n    JSON.stringify(collected, null, 2),\n  {\n    label: 'analyze',\n    schema: {\n      type: 'object',\n      properties: {\n        patterns: { type: 'array', items: { type: 'string' } },\n        rootCauses: { type: 'array', items: { type: 'string' } },\n        stopDoing: { type: 'array', items: { type: 'string' } },\n        doubleDown: { type: 'array', items: { type: 'string' } },\n        lesson: { type: 'string' },\n      },\n      required: ['patterns', 'lesson'],\n    },\n  },\n)\n\nphase('Plan')\nconst plan = await agent(\n  'Produce next week plan for a solo founder: exactly 3\u20135 prioritized actions (each with why, estimated effort, and success signal), plus one optional stretch goal. Be realistic for ~20\u201330 focused hours.\\n\\n' +\n    JSON.stringify({ collected, analysis }, null, 2),\n  {\n    label: 'plan',\n    schema: {\n      type: 'object',\n      properties: {\n        priorities: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              action: { type: 'string' },\n              why: { type: 'string' },\n              effort: { type: 'string', enum: ['low', 'med', 'high'] },\n              successSignal: { type: 'string' },\n            },\n            required: ['action', 'why', 'successSignal'],\n          },\n        },\n        stretchGoal: { type: 'string' },\n        weeklyTheme: { type: 'string' },\n      },\n      required: ['priorities', 'weeklyTheme'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  collected,\n  analysis,\n  ...(plan ?? { priorities: [], weeklyTheme: 'planning failed' }),\n}\n";
+export declare const WEEKLY_REVIEW_SCRIPT = "export const meta = {\n  name: 'weekly_review',\n  description: 'Review the week and produce 3\u20135 prioritized actions for next week.',\n  whenToUse: 'Solo founder or super-individual doing a weekly retrospective and planning session.',\n  examplePrompts: [\n    { field: 'wins', text: 'Shipped landing page, got 2 demo calls, published one newsletter' },\n    { field: 'blockers', text: 'Pricing still unclear, one client ghosted, distracted by side tasks' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u590D\u76D8\u672C\u5468\u5E76\u4EA7\u51FA\u4E0B\u5468 3\u20135 \u9879\u4F18\u5148\u884C\u52A8\u3002',\n      whenToUse: '\u4E00\u4EBA\u516C\u53F8\u6216\u8D85\u7EA7\u4E2A\u4F53\u505A\u5468\u590D\u76D8\u4E0E\u4E0B\u5468\u89C4\u5212\u65F6\u3002',\n      examplePrompts: [\n        { field: 'wins', text: '\u4E0A\u7EBF\u4E86\u843D\u5730\u9875\u3001\u62FF\u5230 2 \u4E2A demo\u3001\u53D1\u4E86\u4E00\u671F newsletter' },\n        { field: 'blockers', text: '\u5B9A\u4EF7\u8FD8\u4E0D\u6E05\u6670\u3001\u4E00\u4E2A\u5BA2\u6237\u5931\u8054\u3001\u88AB\u6742\u4E8B\u5206\u5FC3' },\n      ],\n    },\n  },\n  tags: ['productivity', 'brainstorm'],\n  estimatedAgents: { min: 3, max: 4 },\n  phases: [\n    { title: 'Collect' },\n    { title: 'Analyze' },\n    { title: 'Plan' },\n  ],\n}\n\nconst wins = args && typeof args === 'object' && args.wins\n  ? String(args.wins)\n  : 'Infer wins from the most recent user turn.'\n\nconst blockers = args && typeof args === 'object' && args.blockers\n  ? String(args.blockers)\n  : 'None specified \u2014 infer from context if possible.'\n\nconst carryover = args && typeof args === 'object' && args.carryover\n  ? String(args.carryover)\n  : ''\n\nphase('Collect')\nconst collected = await agent(\n  'Normalize this weekly input into structured facts: wins, blockers, carryover, energy level signals, and revenue/impact signals if mentioned. Be concise.\\n\\n' +\n    'WINS:\\n' + wins + '\\nBLOCKERS:\\n' + blockers + '\\nCARRYOVER:\\n' + (carryover || '(none)'),\n  {\n    label: 'collect',\n    schema: {\n      type: 'object',\n      properties: {\n        wins: { type: 'array', items: { type: 'string' } },\n        blockers: { type: 'array', items: { type: 'string' } },\n        carryover: { type: 'array', items: { type: 'string' } },\n        themes: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['wins', 'blockers'],\n    },\n  },\n)\n\nphase('Analyze')\nconst analysis = await agent(\n  'Analyze this week for a solo operator. Identify patterns, root causes of blockers, what to stop doing, what to double down on, and one honest lesson.\\n\\n' +\n    JSON.stringify(collected, null, 2),\n  {\n    label: 'analyze',\n    schema: {\n      type: 'object',\n      properties: {\n        patterns: { type: 'array', items: { type: 'string' } },\n        rootCauses: { type: 'array', items: { type: 'string' } },\n        stopDoing: { type: 'array', items: { type: 'string' } },\n        doubleDown: { type: 'array', items: { type: 'string' } },\n        lesson: { type: 'string' },\n      },\n      required: ['patterns', 'lesson'],\n    },\n  },\n)\n\nphase('Plan')\nconst plan = await agent(\n  'Produce next week plan for a solo founder: exactly 3\u20135 prioritized actions (each with why, estimated effort, and success signal), plus one optional stretch goal. Be realistic for ~20\u201330 focused hours.\\n\\n' +\n    JSON.stringify({ collected, analysis }, null, 2),\n  {\n    label: 'plan',\n    schema: {\n      type: 'object',\n      properties: {\n        priorities: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              action: { type: 'string' },\n              why: { type: 'string' },\n              effort: { type: 'string', enum: ['low', 'med', 'high'] },\n              successSignal: { type: 'string' },\n            },\n            required: ['action', 'why', 'successSignal'],\n          },\n        },\n        stretchGoal: { type: 'string' },\n        weeklyTheme: { type: 'string' },\n      },\n      required: ['priorities', 'weeklyTheme'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  collected,\n  analysis,\n  ...(plan ?? { priorities: [], weeklyTheme: 'planning failed' }),\n}\nreturn {\n  summary: output.weeklyTheme,\n  sections: [\n    { kind: 'json', title: 'Priorities', value: output.priorities },\n    { kind: 'json', title: 'Analysis', value: output.analysis },\n  ],\n  structuredOutput: output,\n}\n";

package/dist/src/agent/workflow/builtins/weekly-review.js

@@ -118,12 +118,20 @@ const plan = await agent(
   },
 )
 
-return {
+const output = {
   ok: true,
   collected,
   analysis,
   ...(plan ?? { priorities: [], weeklyTheme: 'planning failed' }),
 }
+return {
+  summary: output.weeklyTheme,
+  sections: [
+    { kind: 'json', title: 'Priorities', value: output.priorities },
+    { kind: 'json', title: 'Analysis', value: output.analysis },
+  ],
+  structuredOutput: output,
+}
 `;
 //#endregion
 export { WEEKLY_REVIEW_SCRIPT };

package/dist/src/agent/workflow/builtins/weekly-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"weekly-review.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/weekly-review.ts"],"sourcesContent":["/**\n * Built-in workflow: `weekly_review`\n *\n * Weekly retrospective for solopreneurs — collect wins, blockers, and carryover,\n * then synthesize next-week priorities.\n *\n * Args:\n *   - wins: what went well this week\n *   - blockers: what stalled or frustrated progress\n *   - carryover: unfinished items (optional)\n */\n\nexport const WEEKLY_REVIEW_SCRIPT = `export const meta = {\n  name: 'weekly_review',\n  description: 'Review the week and produce 3–5 prioritized actions for next week.',\n  whenToUse: 'Solo founder or super-individual doing a weekly retrospective and planning session.',\n  examplePrompts: [\n    { field: 'wins', text: 'Shipped landing page, got 2 demo calls, published one newsletter' },\n    { field: 'blockers', text: 'Pricing still unclear, one client ghosted, distracted by side tasks' },\n  ],\n  i18n: {\n    zh: {\n      description: '复盘本周并产出下周 3–5 项优先行动。',\n      whenToUse: '一人公司或超级个体做周复盘与下周规划时。',\n      examplePrompts: [\n        { field: 'wins', text: '上线了落地页、拿到 2 个 demo、发了一期 newsletter' },\n        { field: 'blockers', text: '定价还不清晰、一个客户失联、被杂事分心' },\n      ],\n    },\n  },\n  tags: ['productivity', 'brainstorm'],\n  estimatedAgents: { min: 3, max: 4 },\n  phases: [\n    { title: 'Collect' },\n    { title: 'Analyze' },\n    { title: 'Plan' },\n  ],\n}\n\nconst wins = args && typeof args === 'object' && args.wins\n  ? String(args.wins)\n  : 'Infer wins from the most recent user turn.'\n\nconst blockers = args && typeof args === 'object' && args.blockers\n  ? String(args.blockers)\n  : 'None specified — infer from context if possible.'\n\nconst carryover = args && typeof args === 'object' && args.carryover\n  ? String(args.carryover)\n  : ''\n\nphase('Collect')\nconst collected = await agent(\n  'Normalize this weekly input into structured facts: wins, blockers, carryover, energy level signals, and revenue/impact signals if mentioned. Be concise.\\\\n\\\\n' +\n    'WINS:\\\\n' + wins + '\\\\nBLOCKERS:\\\\n' + blockers + '\\\\nCARRYOVER:\\\\n' + (carryover || '(none)'),\n  {\n    label: 'collect',\n    schema: {\n      type: 'object',\n      properties: {\n        wins: { type: 'array', items: { type: 'string' } },\n        blockers: { type: 'array', items: { type: 'string' } },\n        carryover: { type: 'array', items: { type: 'string' } },\n        themes: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['wins', 'blockers'],\n    },\n  },\n)\n\nphase('Analyze')\nconst analysis = await agent(\n  'Analyze this week for a solo operator. Identify patterns, root causes of blockers, what to stop doing, what to double down on, and one honest lesson.\\\\n\\\\n' +\n    JSON.stringify(collected, null, 2),\n  {\n    label: 'analyze',\n    schema: {\n      type: 'object',\n      properties: {\n        patterns: { type: 'array', items: { type: 'string' } },\n        rootCauses: { type: 'array', items: { type: 'string' } },\n        stopDoing: { type: 'array', items: { type: 'string' } },\n        doubleDown: { type: 'array', items: { type: 'string' } },\n        lesson: { type: 'string' },\n      },\n      required: ['patterns', 'lesson'],\n    },\n  },\n)\n\nphase('Plan')\nconst plan = await agent(\n  'Produce next week plan for a solo founder: exactly 3–5 prioritized actions (each with why, estimated effort, and success signal), plus one optional stretch goal. Be realistic for ~20–30 focused hours.\\\\n\\\\n' +\n    JSON.stringify({ collected, analysis }, null, 2),\n  {\n    label: 'plan',\n    schema: {\n      type: 'object',\n      properties: {\n        priorities: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              action: { type: 'string' },\n              why: { type: 'string' },\n              effort: { type: 'string', enum: ['low', 'med', 'high'] },\n              successSignal: { type: 'string' },\n            },\n            required: ['action', 'why', 'successSignal'],\n          },\n        },\n        stretchGoal: { type: 'string' },\n        weeklyTheme: { type: 'string' },\n      },\n      required: ['priorities', 'weeklyTheme'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  collected,\n  analysis,\n  ...(plan ?? { priorities: [], weeklyTheme: 'planning failed' }),\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,uBAAuB"}
+{"version":3,"file":"weekly-review.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/weekly-review.ts"],"sourcesContent":["/**\n * Built-in workflow: `weekly_review`\n *\n * Weekly retrospective for solopreneurs — collect wins, blockers, and carryover,\n * then synthesize next-week priorities.\n *\n * Args:\n *   - wins: what went well this week\n *   - blockers: what stalled or frustrated progress\n *   - carryover: unfinished items (optional)\n */\n\nexport const WEEKLY_REVIEW_SCRIPT = `export const meta = {\n  name: 'weekly_review',\n  description: 'Review the week and produce 3–5 prioritized actions for next week.',\n  whenToUse: 'Solo founder or super-individual doing a weekly retrospective and planning session.',\n  examplePrompts: [\n    { field: 'wins', text: 'Shipped landing page, got 2 demo calls, published one newsletter' },\n    { field: 'blockers', text: 'Pricing still unclear, one client ghosted, distracted by side tasks' },\n  ],\n  i18n: {\n    zh: {\n      description: '复盘本周并产出下周 3–5 项优先行动。',\n      whenToUse: '一人公司或超级个体做周复盘与下周规划时。',\n      examplePrompts: [\n        { field: 'wins', text: '上线了落地页、拿到 2 个 demo、发了一期 newsletter' },\n        { field: 'blockers', text: '定价还不清晰、一个客户失联、被杂事分心' },\n      ],\n    },\n  },\n  tags: ['productivity', 'brainstorm'],\n  estimatedAgents: { min: 3, max: 4 },\n  phases: [\n    { title: 'Collect' },\n    { title: 'Analyze' },\n    { title: 'Plan' },\n  ],\n}\n\nconst wins = args && typeof args === 'object' && args.wins\n  ? String(args.wins)\n  : 'Infer wins from the most recent user turn.'\n\nconst blockers = args && typeof args === 'object' && args.blockers\n  ? String(args.blockers)\n  : 'None specified — infer from context if possible.'\n\nconst carryover = args && typeof args === 'object' && args.carryover\n  ? String(args.carryover)\n  : ''\n\nphase('Collect')\nconst collected = await agent(\n  'Normalize this weekly input into structured facts: wins, blockers, carryover, energy level signals, and revenue/impact signals if mentioned. Be concise.\\\\n\\\\n' +\n    'WINS:\\\\n' + wins + '\\\\nBLOCKERS:\\\\n' + blockers + '\\\\nCARRYOVER:\\\\n' + (carryover || '(none)'),\n  {\n    label: 'collect',\n    schema: {\n      type: 'object',\n      properties: {\n        wins: { type: 'array', items: { type: 'string' } },\n        blockers: { type: 'array', items: { type: 'string' } },\n        carryover: { type: 'array', items: { type: 'string' } },\n        themes: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['wins', 'blockers'],\n    },\n  },\n)\n\nphase('Analyze')\nconst analysis = await agent(\n  'Analyze this week for a solo operator. Identify patterns, root causes of blockers, what to stop doing, what to double down on, and one honest lesson.\\\\n\\\\n' +\n    JSON.stringify(collected, null, 2),\n  {\n    label: 'analyze',\n    schema: {\n      type: 'object',\n      properties: {\n        patterns: { type: 'array', items: { type: 'string' } },\n        rootCauses: { type: 'array', items: { type: 'string' } },\n        stopDoing: { type: 'array', items: { type: 'string' } },\n        doubleDown: { type: 'array', items: { type: 'string' } },\n        lesson: { type: 'string' },\n      },\n      required: ['patterns', 'lesson'],\n    },\n  },\n)\n\nphase('Plan')\nconst plan = await agent(\n  'Produce next week plan for a solo founder: exactly 3–5 prioritized actions (each with why, estimated effort, and success signal), plus one optional stretch goal. Be realistic for ~20–30 focused hours.\\\\n\\\\n' +\n    JSON.stringify({ collected, analysis }, null, 2),\n  {\n    label: 'plan',\n    schema: {\n      type: 'object',\n      properties: {\n        priorities: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              action: { type: 'string' },\n              why: { type: 'string' },\n              effort: { type: 'string', enum: ['low', 'med', 'high'] },\n              successSignal: { type: 'string' },\n            },\n            required: ['action', 'why', 'successSignal'],\n          },\n        },\n        stretchGoal: { type: 'string' },\n        weeklyTheme: { type: 'string' },\n      },\n      required: ['priorities', 'weeklyTheme'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  collected,\n  analysis,\n  ...(plan ?? { priorities: [], weeklyTheme: 'planning failed' }),\n}\nreturn {\n  summary: output.weeklyTheme,\n  sections: [\n    { kind: 'json', title: 'Priorities', value: output.priorities },\n    { kind: 'json', title: 'Analysis', value: output.analysis },\n  ],\n  structuredOutput: output,\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,uBAAuB"}

package/dist/src/agent/workflow/subagent-runner.js

@@ -168,9 +168,7 @@ function safeResolveDefaultModel(get) {
 		return null;
 	}
 }
-function resolveSubagentStreamMode(getConfig) {
-	const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;
-	if (mode === "off" || mode === "steps" || mode === "full") return mode;
+function resolveSubagentStreamMode(_getConfig) {
 	return "steps";
 }
 function mapChildProgressEvent(event) {

package/dist/src/agent/workflow/subagent-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/**\n * Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n *\n * Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n *\n * Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n *   tool set and unwrap the captured value on success. If the subagent finishes\n *   without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n *   matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n *   `buildChildTools` injection point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { emitSessionTranscriptUpdate } from '../../session/transcript-events.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  type BuildChildToolsOptions,\n  createDelegateChildHandle,\n  type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n  DEFAULT_DELEGATE_TOOLS,\n  DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n  createStructuredOutputTool,\n  STRUCTURED_OUTPUT_TOOL_NAME,\n  type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner, SubagentProgressEvent } from './types.js';\n\nconst log = createLogger('Agent:WorkflowSubagent');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n  workspace: string;\n  bus: MessageBus;\n  /** Resolves the default subagent model (typically the parent agent's primary model). */\n  getDefaultModel: () => Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  sessionStore?: SessionStore;\n  /**\n   * Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n   * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n   * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n   * dependency contract).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n  constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n  async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null> {\n    if (opts.signal?.aborted) return null;\n\n    const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n    const wantStructured = Boolean(opts.schema);\n\n    const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n    const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n    if (!model) {\n      log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n      return null;\n    }\n\n    const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n    const streamMode = resolveSubagentStreamMode(this.deps.getConfig);\n\n    let transcriptPersistQueue: Promise<void> = Promise.resolve();\n    const persistTranscriptSnapshot = opts.sessionKey && this.deps.sessionStore\n      ? (messages: Parameters<SessionStore['saveMessages']>[1]) => {\n          const store = this.deps.sessionStore;\n          const key = opts.sessionKey;\n          if (!store || !key) return;\n          const snapshot = cloneAgentMessages(messages);\n          transcriptPersistQueue = transcriptPersistQueue\n            .then(async () => {\n              await store.saveMessages(key, snapshot);\n              emitSessionTranscriptUpdate({ sessionKey: key });\n            })\n            .catch((err) => {\n              const msg = err instanceof Error ? err.message : String(err);\n              log.warn(\n                { err, sessionKey: key, errorMessage: msg },\n                `Failed to persist workflow subagent transcript snapshot: ${msg}`,\n              );\n            });\n        }\n      : undefined;\n\n    const childOptions: DelegateChildHandleOptions = {\n      workspace: this.deps.workspace,\n      goal: fullPrompt,\n      allowedToolNames: allowed,\n      maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n      model,\n      bus: this.deps.bus,\n      getConfig: this.deps.getConfig,\n      toolExecutorConfig: this.deps.toolExecutorConfig,\n      buildChildTools: (childOpts) => {\n        const base = this.deps.buildChildTools(childOpts);\n        if (!wantStructured || !opts.schema) return base;\n        // Replace any existing tool with the same name so the per-run capture wins.\n        const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n        return [\n          ...filtered,\n          createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n        ];\n      },\n      progressHooks:\n        opts.onProgress && streamMode !== 'off'\n          ? {\n              mode: streamMode === 'full' ? 'full' : 'steps',\n              onProgress: (event) => {\n                opts.onProgress?.(mapChildProgressEvent(event));\n              },\n            }\n          : undefined,\n      onTranscriptSnapshot: persistTranscriptSnapshot,\n    };\n\n    if (opts.sessionKey && opts.sessionMetadata && this.deps.sessionStore) {\n      await this.preparePersistentSubagentSession(opts.sessionKey, opts.sessionMetadata);\n    }\n\n    const handle = createDelegateChildHandle(childOptions);\n    const onAbort = () => handle.abort();\n    opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n    try {\n      const { summary, messages } = await handle.run();\n      await transcriptPersistQueue;\n      if (opts.sessionKey && this.deps.sessionStore) {\n        await this.deps.sessionStore.saveMessages(opts.sessionKey, messages);\n        emitSessionTranscriptUpdate({ sessionKey: opts.sessionKey });\n      }\n      if (opts.signal?.aborted) return null;\n\n      if (wantStructured) {\n        if (!capture.called) {\n          log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n          return null;\n        }\n        return capture.value as T;\n      }\n      return summary as unknown as T;\n    } catch (e) {\n      if (opts.rethrow) throw e;\n      const msg = e instanceof Error ? e.message : String(e);\n      log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n      return null;\n    } finally {\n      opts.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n\n  private async preparePersistentSubagentSession(\n    sessionKey: string,\n    metadata: NonNullable<SubagentRunOptions['sessionMetadata']>,\n  ): Promise<void> {\n    const store = this.deps.sessionStore;\n    if (!store) return;\n    await store.resolveTranscriptPath(sessionKey, {\n      metadata: {\n        sessionType: 'workflow-subagent',\n        hiddenFromSessionList: true,\n        parentSessionKey: metadata.parentSessionKey,\n        workflowRunId: metadata.workflowRunId,\n        workflowDefinitionId: metadata.workflowDefinitionId,\n        workflowAgentId: metadata.workflowAgentId,\n        workflowAgentLabel: metadata.workflowAgentLabel,\n        sourceChannel: 'workflow',\n        sourceChatId: metadata.workflowRunId,\n        routing: {\n          agentId: metadata.workflowAgentId || 'main',\n          source: 'workflow',\n          accountId: 'default',\n          peerKind: 'subagent',\n          peerId: metadata.workflowRunId,\n        },\n      },\n    });\n    await store.updateMetadata(sessionKey, {\n      sessionType: 'workflow-subagent',\n      hiddenFromSessionList: true,\n      parentSessionKey: metadata.parentSessionKey,\n      workflowRunId: metadata.workflowRunId,\n      workflowDefinitionId: metadata.workflowDefinitionId,\n      workflowAgentId: metadata.workflowAgentId,\n      workflowAgentLabel: metadata.workflowAgentLabel,\n      name: metadata.workflowAgentLabel,\n      tags: ['workflow-subagent', metadata.workflowDefinitionId],\n    });\n  }\n}\n\nfunction cloneAgentMessages(messages: Parameters<SessionStore['saveMessages']>[1]): Parameters<SessionStore['saveMessages']>[1] {\n  return messages.map((message) => structuredClone(message));\n}\n\nfunction resolveAllowedToolNames(\n  requested: string[] | undefined,\n  wantStructured: boolean,\n): string[] {\n  const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n  const filtered = base\n    .map((s) => String(s).trim())\n    .filter((s) => s.length > 0)\n    .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n  if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n    filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n  }\n  return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n  const parts: string[] = [];\n  if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n  if (opts.label) parts.push(`Task label: ${opts.label}`);\n  if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n  parts.push(prompt);\n  if (structured) {\n    parts.push(\n      [\n        'Final output contract:',\n        '- Your final action MUST be a structured_output tool call.',\n        '- The structured_output arguments are the return value of this subagent.',\n        '- Do not emit a prose final answer instead of structured_output.',\n        '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n      ].join('\\n'),\n    );\n  }\n  return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> | null {\n  try {\n    return get();\n  } catch (e) {\n    log.warn({ err: e }, 'failed to resolve default subagent model');\n    return null;\n  }\n}\n\nfunction resolveSubagentStreamMode(\n  getConfig: () => Config | undefined,\n): 'off' | 'steps' | 'full' {\n  const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;\n  if (mode === 'off' || mode === 'steps' || mode === 'full') return mode;\n  return 'steps';\n}\n\nfunction mapChildProgressEvent(event: {\n  type: 'tool_start' | 'tool_end' | 'iteration' | 'text_delta' | 'thinking_delta';\n  toolCallId?: string;\n  toolName?: string;\n  args?: Record<string, unknown>;\n  isError?: boolean;\n  resultPreview?: string;\n  error?: string;\n  count?: number;\n  max?: number;\n  delta?: string;\n}): SubagentProgressEvent {\n  switch (event.type) {\n    case 'tool_start':\n      return {\n        type: 'tool_start',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        args: event.args ?? {},\n      };\n    case 'tool_end':\n      return {\n        type: 'tool_end',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        isError: Boolean(event.isError),\n        resultPreview: event.resultPreview,\n        error: event.error,\n      };\n    case 'iteration':\n      return {\n        type: 'iteration',\n        count: event.count ?? 0,\n        max: event.max ?? 0,\n      };\n    case 'text_delta':\n      return { type: 'text_delta', delta: event.delta ?? '' };\n    case 'thinking_delta':\n      return { type: 'thinking_delta', delta: event.delta ?? '' };\n    default:\n      return { type: 'text_delta', delta: '' };\n  }\n}\n"],"mappings":";;;;;;;aAuBqD;AAoBrD,MAAM,MAAM,aAAa,yBAAyB;AAElD,MAAM,yBAAyB;AAmB/B,IAAa,yBAAb,MAA8D;CAC5D,YAAY,MAAmD;AAAlC,OAAA,OAAA;;CAE7B,MAAM,IAAgB,QAAgB,MAAgD;AACpF,MAAI,KAAK,QAAQ,QAAS,QAAO;EAEjC,MAAM,UAAsC;GAAE,QAAQ;GAAO,OAAO,KAAA;GAAW;EAC/E,MAAM,iBAAiB,QAAQ,KAAK,OAAO;EAE3C,MAAM,UAAU,wBAAwB,KAAK,kBAAkB,eAAe;EAC9E,MAAM,QAAQ,KAAK,SAAS,wBAAwB,KAAK,KAAK,gBAAgB;AAC9E,MAAI,CAAC,OAAO;AACV,OAAI,KAAK,EAAE,OAAO,KAAK,OAAO,EAAE,kDAAkD;AAClF,UAAO;;EAGT,MAAM,aAAa,YAAY,QAAQ,MAAM,eAAe;EAC5D,MAAM,aAAa,0BAA0B,KAAK,KAAK,UAAU;EAEjE,IAAI,yBAAwC,QAAQ,SAAS;EAC7D,MAAM,4BAA4B,KAAK,cAAc,KAAK,KAAK,gBAC1D,aAA0D;GACzD,MAAM,QAAQ,KAAK,KAAK;GACxB,MAAM,MAAM,KAAK;AACjB,OAAI,CAAC,SAAS,CAAC,IAAK;GACpB,MAAM,WAAW,mBAAmB,SAAS;AAC7C,4BAAyB,uBACtB,KAAK,YAAY;AAChB,UAAM,MAAM,aAAa,KAAK,SAAS;AACvC,gCAA4B,EAAE,YAAY,KAAK,CAAC;KAChD,CACD,OAAO,QAAQ;IACd,MAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC5D,QAAI,KACF;KAAE;KAAK,YAAY;KAAK,cAAc;KAAK,EAC3C,4DAA4D,MAC7D;KACD;MAEN,KAAA;EAEJ,MAAM,eAA2C;GAC/C,WAAW,KAAK,KAAK;GACrB,MAAM;GACN,kBAAkB;GAClB,eAAe,KAAK,iBAAiB;GACrC;GACA,KAAK,KAAK,KAAK;GACf,WAAW,KAAK,KAAK;GACrB,oBAAoB,KAAK,KAAK;GAC9B,kBAAkB,cAAc;IAC9B,MAAM,OAAO,KAAK,KAAK,gBAAgB,UAAU;AACjD,QAAI,CAAC,kBAAkB,CAAC,KAAK,OAAQ,QAAO;AAG5C,WAAO,CACL,GAFe,KAAK,QAAQ,MAAM,EAAE,SAAS,4BAElC,EACX,2BAA2B;KAAE,QAAQ,KAAK;KAAQ;KAAS,CAAC,CAC7D;;GAEH,eACE,KAAK,cAAc,eAAe,QAC9B;IACE,MAAM,eAAe,SAAS,SAAS;IACvC,aAAa,UAAU;AACrB,UAAK,aAAa,sBAAsB,MAAM,CAAC;;IAElD,GACD,KAAA;GACN,sBAAsB;GACvB;AAED,MAAI,KAAK,cAAc,KAAK,mBAAmB,KAAK,KAAK,aACvD,OAAM,KAAK,iCAAiC,KAAK,YAAY,KAAK,gBAAgB;EAGpF,MAAM,SAAS,0BAA0B,aAAa;EACtD,MAAM,gBAAgB,OAAO,OAAO;AACpC,OAAK,QAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;AAE/D,MAAI;GACF,MAAM,EAAE,SAAS,aAAa,MAAM,OAAO,KAAK;AAChD,SAAM;AACN,OAAI,KAAK,cAAc,KAAK,KAAK,cAAc;AAC7C,UAAM,KAAK,KAAK,aAAa,aAAa,KAAK,YAAY,SAAS;AACpE,gCAA4B,EAAE,YAAY,KAAK,YAAY,CAAC;;AAE9D,OAAI,KAAK,QAAQ,QAAS,QAAO;AAEjC,OAAI,gBAAgB;AAClB,QAAI,CAAC,QAAQ,QAAQ;AACnB,SAAI,KAAK,EAAE,OAAO,KAAK,OAAO,EAAE,sDAAsD;AACtF,YAAO;;AAET,WAAO,QAAQ;;AAEjB,UAAO;WACA,GAAG;AACV,OAAI,KAAK,QAAS,OAAM;GACxB,MAAM,MAAM,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;AACtD,OAAI,KAAK;IAAE,KAAK;IAAG,OAAO,KAAK;IAAO,cAAc;IAAK,EAAE,wBAAwB,MAAM;AACzF,UAAO;YACC;AACR,QAAK,QAAQ,oBAAoB,SAAS,QAAQ;;;CAItD,MAAc,iCACZ,YACA,UACe;EACf,MAAM,QAAQ,KAAK,KAAK;AACxB,MAAI,CAAC,MAAO;AACZ,QAAM,MAAM,sBAAsB,YAAY,EAC5C,UAAU;GACR,aAAa;GACb,uBAAuB;GACvB,kBAAkB,SAAS;GAC3B,eAAe,SAAS;GACxB,sBAAsB,SAAS;GAC/B,iBAAiB,SAAS;GAC1B,oBAAoB,SAAS;GAC7B,eAAe;GACf,cAAc,SAAS;GACvB,SAAS;IACP,SAAS,SAAS,mBAAmB;IACrC,QAAQ;IACR,WAAW;IACX,UAAU;IACV,QAAQ,SAAS;IAClB;GACF,EACF,CAAC;AACF,QAAM,MAAM,eAAe,YAAY;GACrC,aAAa;GACb,uBAAuB;GACvB,kBAAkB,SAAS;GAC3B,eAAe,SAAS;GACxB,sBAAsB,SAAS;GAC/B,iBAAiB,SAAS;GAC1B,oBAAoB,SAAS;GAC7B,MAAM,SAAS;GACf,MAAM,CAAC,qBAAqB,SAAS,qBAAqB;GAC3D,CAAC;;;AAIN,SAAS,mBAAmB,UAAoG;AAC9H,QAAO,SAAS,KAAK,YAAY,gBAAgB,QAAQ,CAAC;;AAG5D,SAAS,wBACP,WACA,gBACU;CAEV,MAAM,YADO,aAAa,UAAU,SAAS,IAAI,YAAY,CAAC,GAAG,uBAAuB,EAErF,KAAK,MAAM,OAAO,EAAE,CAAC,MAAM,CAAC,CAC5B,QAAQ,MAAM,EAAE,SAAS,EAAE,CAC3B,QAAQ,MAAM,CAAC,uBAAuB,IAAI,EAAE,CAAC;AAChD,KAAI,kBAAkB,CAAC,SAAS,SAAA,oBAAqC,CACnE,UAAS,KAAK,4BAA4B;AAE5C,QAAO,CAAC,GAAG,IAAI,IAAI,SAAS,CAAC;;AAG/B,SAAS,YAAY,QAAgB,MAAmC,YAA6B;CACnG,MAAM,QAAkB,EAAE;AAC1B,KAAI,KAAK,cAAc,MAAM,CAAE,OAAM,KAAK,KAAK,aAAa,MAAM,CAAC;AACnE,KAAI,KAAK,MAAO,OAAM,KAAK,eAAe,KAAK,QAAQ;AACvD,KAAI,KAAK,MAAO,OAAM,KAAK,mBAAmB,KAAK,QAAQ;AAC3D,OAAM,KAAK,OAAO;AAClB,KAAI,WACF,OAAM,KACJ;EACE;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK,CACb;AAEH,QAAO,MAAM,KAAK,OAAO;;AAG3B,SAAS,wBAAwB,KAA0C;AACzE,KAAI;AACF,SAAO,KAAK;UACL,GAAG;AACV,MAAI,KAAK,EAAE,KAAK,GAAG,EAAE,2CAA2C;AAChE,SAAO;;;AAIX,SAAS,0BACP,WAC0B;CAC1B,MAAM,OAAO,WAAW,EAAE,QAAQ,UAAU,UAAU;AACtD,KAAI,SAAS,SAAS,SAAS,WAAW,SAAS,OAAQ,QAAO;AAClE,QAAO;;AAGT,SAAS,sBAAsB,OAWL;AACxB,SAAQ,MAAM,MAAd;EACE,KAAK,aACH,QAAO;GACL,MAAM;GACN,YAAY,MAAM,cAAc;GAChC,UAAU,MAAM,YAAY;GAC5B,MAAM,MAAM,QAAQ,EAAE;GACvB;EACH,KAAK,WACH,QAAO;GACL,MAAM;GACN,YAAY,MAAM,cAAc;GAChC,UAAU,MAAM,YAAY;GAC5B,SAAS,QAAQ,MAAM,QAAQ;GAC/B,eAAe,MAAM;GACrB,OAAO,MAAM;GACd;EACH,KAAK,YACH,QAAO;GACL,MAAM;GACN,OAAO,MAAM,SAAS;GACtB,KAAK,MAAM,OAAO;GACnB;EACH,KAAK,aACH,QAAO;GAAE,MAAM;GAAc,OAAO,MAAM,SAAS;GAAI;EACzD,KAAK,iBACH,QAAO;GAAE,MAAM;GAAkB,OAAO,MAAM,SAAS;GAAI;EAC7D,QACE,QAAO;GAAE,MAAM;GAAc,OAAO;GAAI"}
+{"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/**\n * Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n *\n * Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n *\n * Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n *   tool set and unwrap the captured value on success. If the subagent finishes\n *   without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n *   matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n *   `buildChildTools` injection point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { emitSessionTranscriptUpdate } from '../../session/transcript-events.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  type BuildChildToolsOptions,\n  createDelegateChildHandle,\n  type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n  DEFAULT_DELEGATE_TOOLS,\n  DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n  createStructuredOutputTool,\n  STRUCTURED_OUTPUT_TOOL_NAME,\n  type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner, SubagentProgressEvent } from './types.js';\n\nconst log = createLogger('Agent:WorkflowSubagent');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n  workspace: string;\n  bus: MessageBus;\n  /** Resolves the default subagent model (typically the parent agent's primary model). */\n  getDefaultModel: () => Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  sessionStore?: SessionStore;\n  /**\n   * Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n   * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n   * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n   * dependency contract).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n  constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n  async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null> {\n    if (opts.signal?.aborted) return null;\n\n    const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n    const wantStructured = Boolean(opts.schema);\n\n    const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n    const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n    if (!model) {\n      log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n      return null;\n    }\n\n    const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n    const streamMode = resolveSubagentStreamMode(this.deps.getConfig);\n\n    let transcriptPersistQueue: Promise<void> = Promise.resolve();\n    const persistTranscriptSnapshot = opts.sessionKey && this.deps.sessionStore\n      ? (messages: Parameters<SessionStore['saveMessages']>[1]) => {\n          const store = this.deps.sessionStore;\n          const key = opts.sessionKey;\n          if (!store || !key) return;\n          const snapshot = cloneAgentMessages(messages);\n          transcriptPersistQueue = transcriptPersistQueue\n            .then(async () => {\n              await store.saveMessages(key, snapshot);\n              emitSessionTranscriptUpdate({ sessionKey: key });\n            })\n            .catch((err) => {\n              const msg = err instanceof Error ? err.message : String(err);\n              log.warn(\n                { err, sessionKey: key, errorMessage: msg },\n                `Failed to persist workflow subagent transcript snapshot: ${msg}`,\n              );\n            });\n        }\n      : undefined;\n\n    const childOptions: DelegateChildHandleOptions = {\n      workspace: this.deps.workspace,\n      goal: fullPrompt,\n      allowedToolNames: allowed,\n      maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n      model,\n      bus: this.deps.bus,\n      getConfig: this.deps.getConfig,\n      toolExecutorConfig: this.deps.toolExecutorConfig,\n      buildChildTools: (childOpts) => {\n        const base = this.deps.buildChildTools(childOpts);\n        if (!wantStructured || !opts.schema) return base;\n        // Replace any existing tool with the same name so the per-run capture wins.\n        const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n        return [\n          ...filtered,\n          createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n        ];\n      },\n      progressHooks:\n        opts.onProgress && streamMode !== 'off'\n          ? {\n              mode: streamMode === 'full' ? 'full' : 'steps',\n              onProgress: (event) => {\n                opts.onProgress?.(mapChildProgressEvent(event));\n              },\n            }\n          : undefined,\n      onTranscriptSnapshot: persistTranscriptSnapshot,\n    };\n\n    if (opts.sessionKey && opts.sessionMetadata && this.deps.sessionStore) {\n      await this.preparePersistentSubagentSession(opts.sessionKey, opts.sessionMetadata);\n    }\n\n    const handle = createDelegateChildHandle(childOptions);\n    const onAbort = () => handle.abort();\n    opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n    try {\n      const { summary, messages } = await handle.run();\n      await transcriptPersistQueue;\n      if (opts.sessionKey && this.deps.sessionStore) {\n        await this.deps.sessionStore.saveMessages(opts.sessionKey, messages);\n        emitSessionTranscriptUpdate({ sessionKey: opts.sessionKey });\n      }\n      if (opts.signal?.aborted) return null;\n\n      if (wantStructured) {\n        if (!capture.called) {\n          log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n          return null;\n        }\n        return capture.value as T;\n      }\n      return summary as unknown as T;\n    } catch (e) {\n      if (opts.rethrow) throw e;\n      const msg = e instanceof Error ? e.message : String(e);\n      log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n      return null;\n    } finally {\n      opts.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n\n  private async preparePersistentSubagentSession(\n    sessionKey: string,\n    metadata: NonNullable<SubagentRunOptions['sessionMetadata']>,\n  ): Promise<void> {\n    const store = this.deps.sessionStore;\n    if (!store) return;\n    await store.resolveTranscriptPath(sessionKey, {\n      metadata: {\n        sessionType: 'workflow-subagent',\n        hiddenFromSessionList: true,\n        parentSessionKey: metadata.parentSessionKey,\n        workflowRunId: metadata.workflowRunId,\n        workflowDefinitionId: metadata.workflowDefinitionId,\n        workflowAgentId: metadata.workflowAgentId,\n        workflowAgentLabel: metadata.workflowAgentLabel,\n        sourceChannel: 'workflow',\n        sourceChatId: metadata.workflowRunId,\n        routing: {\n          agentId: metadata.workflowAgentId || 'main',\n          source: 'workflow',\n          accountId: 'default',\n          peerKind: 'subagent',\n          peerId: metadata.workflowRunId,\n        },\n      },\n    });\n    await store.updateMetadata(sessionKey, {\n      sessionType: 'workflow-subagent',\n      hiddenFromSessionList: true,\n      parentSessionKey: metadata.parentSessionKey,\n      workflowRunId: metadata.workflowRunId,\n      workflowDefinitionId: metadata.workflowDefinitionId,\n      workflowAgentId: metadata.workflowAgentId,\n      workflowAgentLabel: metadata.workflowAgentLabel,\n      name: metadata.workflowAgentLabel,\n      tags: ['workflow-subagent', metadata.workflowDefinitionId],\n    });\n  }\n}\n\nfunction cloneAgentMessages(messages: Parameters<SessionStore['saveMessages']>[1]): Parameters<SessionStore['saveMessages']>[1] {\n  return messages.map((message) => structuredClone(message));\n}\n\nfunction resolveAllowedToolNames(\n  requested: string[] | undefined,\n  wantStructured: boolean,\n): string[] {\n  const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n  const filtered = base\n    .map((s) => String(s).trim())\n    .filter((s) => s.length > 0)\n    .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n  if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n    filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n  }\n  return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n  const parts: string[] = [];\n  if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n  if (opts.label) parts.push(`Task label: ${opts.label}`);\n  if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n  parts.push(prompt);\n  if (structured) {\n    parts.push(\n      [\n        'Final output contract:',\n        '- Your final action MUST be a structured_output tool call.',\n        '- The structured_output arguments are the return value of this subagent.',\n        '- Do not emit a prose final answer instead of structured_output.',\n        '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n      ].join('\\n'),\n    );\n  }\n  return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> | null {\n  try {\n    return get();\n  } catch (e) {\n    log.warn({ err: e }, 'failed to resolve default subagent model');\n    return null;\n  }\n}\n\nfunction resolveSubagentStreamMode(\n  _getConfig: () => Config | undefined,\n): 'off' | 'steps' | 'full' {\n  return 'steps';\n}\n\nfunction mapChildProgressEvent(event: {\n  type: 'tool_start' | 'tool_end' | 'iteration' | 'text_delta' | 'thinking_delta';\n  toolCallId?: string;\n  toolName?: string;\n  args?: Record<string, unknown>;\n  isError?: boolean;\n  resultPreview?: string;\n  error?: string;\n  count?: number;\n  max?: number;\n  delta?: string;\n}): SubagentProgressEvent {\n  switch (event.type) {\n    case 'tool_start':\n      return {\n        type: 'tool_start',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        args: event.args ?? {},\n      };\n    case 'tool_end':\n      return {\n        type: 'tool_end',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        isError: Boolean(event.isError),\n        resultPreview: event.resultPreview,\n        error: event.error,\n      };\n    case 'iteration':\n      return {\n        type: 'iteration',\n        count: event.count ?? 0,\n        max: event.max ?? 0,\n      };\n    case 'text_delta':\n      return { type: 'text_delta', delta: event.delta ?? '' };\n    case 'thinking_delta':\n      return { type: 'thinking_delta', delta: event.delta ?? '' };\n    default:\n      return { type: 'text_delta', delta: '' };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent-manifest/index.d.ts

@@ -0,0 +1,4 @@
+export * from './schema.js';
+export * from './resolver.js';
+export * from './validator.js';
+export * from './prompt.js';

package/dist/src/agent-manifest/index.js

@@ -0,0 +1,10 @@
+import { AgentIdentitySchema, AgentManifestSchema, AgentResponsibilitiesSchema, BoundaryPolicySchema, CapabilityPresetSchema, DreamingDeepPolicySchema, DreamingLightPolicySchema, DreamingPhasePolicySchema, DreamingPolicySchema, DreamingRemPolicySchema, ManifestModelRoleSchema, MemoryPolicySchema, ModelPolicyPatchSchema, ModelPolicySchema, PromptPolicySchema, RuntimePolicySchema, SkillPolicySchema, ToolModeSchema, ToolPolicySchema, ToolPolicySetSchema, ToolScopeSchema, WorkflowPolicySchema, WorkspacePolicySchema, init_schema } from "./schema.js";
+import { getManifestSource, resolveEffectiveAgentManifest } from "./resolver.js";
+import { validateAgentManifest } from "./validator.js";
+import { buildAgentManifestPromptSection } from "./prompt.js";
+//#region src/agent-manifest/index.ts
+init_schema();
+//#endregion
+export { AgentIdentitySchema, AgentManifestSchema, AgentResponsibilitiesSchema, BoundaryPolicySchema, CapabilityPresetSchema, DreamingDeepPolicySchema, DreamingLightPolicySchema, DreamingPhasePolicySchema, DreamingPolicySchema, DreamingRemPolicySchema, ManifestModelRoleSchema, MemoryPolicySchema, ModelPolicyPatchSchema, ModelPolicySchema, PromptPolicySchema, RuntimePolicySchema, SkillPolicySchema, ToolModeSchema, ToolPolicySchema, ToolPolicySetSchema, ToolScopeSchema, WorkflowPolicySchema, WorkspacePolicySchema, buildAgentManifestPromptSection, getManifestSource, resolveEffectiveAgentManifest, validateAgentManifest };
+
+//# sourceMappingURL=index.js.map

package/dist/src/agent-manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/agent-manifest/index.ts"],"sourcesContent":["export * from './schema.js';\nexport * from './resolver.js';\nexport * from './validator.js';\nexport * from './prompt.js';\n"],"mappings":""}

package/dist/src/agent-manifest/prompt.d.ts

@@ -0,0 +1,2 @@
+import type { EffectiveAgentManifest } from './schema.js';
+export declare function buildAgentManifestPromptSection(manifest: EffectiveAgentManifest): string;

package/dist/src/agent-manifest/prompt.js

@@ -0,0 +1,57 @@
+//#region src/agent-manifest/prompt.ts
+function listBlock(items) {
+	return (items ?? []).map((item) => `- ${item}`).join("\n");
+}
+function toolPolicySummary(manifest) {
+	const rows = Object.entries(manifest.tools.builtin).toSorted(([a], [b]) => a.localeCompare(b)).map(([name, policy]) => {
+		const scope = policy.scope ? `, scope=${policy.scope}` : "";
+		return `- ${name}: ${policy.mode}${scope}`;
+	});
+	return rows.length > 0 ? rows.join("\n") : "- No built-in tools declared";
+}
+function memorySummary(manifest) {
+	return [`Mode: ${manifest.memory.mode}`, `Sources: ${manifest.memory.sources.join(", ") || "none"}`].join("\n");
+}
+function buildAgentManifestPromptSection(manifest) {
+	const sections = [
+		`<agent_identity>
+Name: ${manifest.identity.name}
+Role: ${manifest.identity.role}
+Language: ${manifest.identity.language}
+Tone: ${manifest.identity.tone}
+</agent_identity>`,
+		`<responsibilities>
+Primary:
+${listBlock(manifest.responsibilities.primary)}
+${manifest.responsibilities.secondary?.length ? `Secondary:\n${listBlock(manifest.responsibilities.secondary)}` : ""}
+${manifest.responsibilities.outOfScope?.length ? `Out of scope:\n${listBlock(manifest.responsibilities.outOfScope)}` : ""}
+</responsibilities>`,
+		`<boundaries>
+Requires confirmation:
+${listBlock(manifest.boundaries.requiresConfirmation)}
+Forbidden:
+${listBlock(manifest.boundaries.forbidden)}
+Escalation:
+${listBlock(manifest.boundaries.escalation)}
+</boundaries>`,
+		`<tool_policy>
+${toolPolicySummary(manifest)}
+</tool_policy>`,
+		`<memory_policy>
+${memorySummary(manifest)}
+</memory_policy>`
+	];
+	if (manifest.workflows.default || manifest.workflows.allowed?.length) sections.push(`<workflow_policy>
+Default: ${manifest.workflows.default ?? "none"}
+Allowed:
+${listBlock(manifest.workflows.allowed)}
+</workflow_policy>`);
+	if (manifest.prompt?.customInstructions?.trim()) sections.push(`<custom_instructions>
+${manifest.prompt.customInstructions.trim()}
+</custom_instructions>`);
+	return sections.join("\n\n");
+}
+//#endregion
+export { buildAgentManifestPromptSection };
+
+//# sourceMappingURL=prompt.js.map

package/dist/src/agent-manifest/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","names":[],"sources":["../../../src/agent-manifest/prompt.ts"],"sourcesContent":["import type { EffectiveAgentManifest } from './schema.js';\n\nfunction listBlock(items: readonly string[] | undefined): string {\n  return (items ?? []).map((item) => `- ${item}`).join('\\n');\n}\n\nfunction toolPolicySummary(manifest: EffectiveAgentManifest): string {\n  const rows = Object.entries(manifest.tools.builtin)\n    .toSorted(([a], [b]) => a.localeCompare(b))\n    .map(([name, policy]) => {\n      const scope = policy.scope ? `, scope=${policy.scope}` : '';\n      return `- ${name}: ${policy.mode}${scope}`;\n    });\n  return rows.length > 0 ? rows.join('\\n') : '- No built-in tools declared';\n}\n\nfunction memorySummary(manifest: EffectiveAgentManifest): string {\n  return [\n    `Mode: ${manifest.memory.mode}`,\n    `Sources: ${manifest.memory.sources.join(', ') || 'none'}`,\n  ].join('\\n');\n}\n\nexport function buildAgentManifestPromptSection(manifest: EffectiveAgentManifest): string {\n  const sections = [\n    `<agent_identity>\nName: ${manifest.identity.name}\nRole: ${manifest.identity.role}\nLanguage: ${manifest.identity.language}\nTone: ${manifest.identity.tone}\n</agent_identity>`,\n    `<responsibilities>\nPrimary:\n${listBlock(manifest.responsibilities.primary)}\n${manifest.responsibilities.secondary?.length ? `Secondary:\\n${listBlock(manifest.responsibilities.secondary)}` : ''}\n${manifest.responsibilities.outOfScope?.length ? `Out of scope:\\n${listBlock(manifest.responsibilities.outOfScope)}` : ''}\n</responsibilities>`,\n    `<boundaries>\nRequires confirmation:\n${listBlock(manifest.boundaries.requiresConfirmation)}\nForbidden:\n${listBlock(manifest.boundaries.forbidden)}\nEscalation:\n${listBlock(manifest.boundaries.escalation)}\n</boundaries>`,\n    `<tool_policy>\n${toolPolicySummary(manifest)}\n</tool_policy>`,\n    `<memory_policy>\n${memorySummary(manifest)}\n</memory_policy>`,\n  ];\n\n  if (manifest.workflows.default || manifest.workflows.allowed?.length) {\n    sections.push(`<workflow_policy>\nDefault: ${manifest.workflows.default ?? 'none'}\nAllowed:\n${listBlock(manifest.workflows.allowed)}\n</workflow_policy>`);\n  }\n\n  if (manifest.prompt?.customInstructions?.trim()) {\n    sections.push(`<custom_instructions>\n${manifest.prompt.customInstructions.trim()}\n</custom_instructions>`);\n  }\n\n  return sections.join('\\n\\n');\n}\n"],"mappings":";AAEA,SAAS,UAAU,OAA8C;AAC/D,SAAQ,SAAS,EAAE,EAAE,KAAK,SAAS,KAAK,OAAO,CAAC,KAAK,KAAK;;AAG5D,SAAS,kBAAkB,UAA0C;CACnE,MAAM,OAAO,OAAO,QAAQ,SAAS,MAAM,QAAQ,CAChD,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CAC1C,KAAK,CAAC,MAAM,YAAY;EACvB,MAAM,QAAQ,OAAO,QAAQ,WAAW,OAAO,UAAU;AACzD,SAAO,KAAK,KAAK,IAAI,OAAO,OAAO;GACnC;AACJ,QAAO,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,GAAG;;AAG7C,SAAS,cAAc,UAA0C;AAC/D,QAAO,CACL,SAAS,SAAS,OAAO,QACzB,YAAY,SAAS,OAAO,QAAQ,KAAK,KAAK,IAAI,SACnD,CAAC,KAAK,KAAK;;AAGd,SAAgB,gCAAgC,UAA0C;CACxF,MAAM,WAAW;EACf;QACI,SAAS,SAAS,KAAK;QACvB,SAAS,SAAS,KAAK;YACnB,SAAS,SAAS,SAAS;QAC/B,SAAS,SAAS,KAAK;;EAE3B;;EAEF,UAAU,SAAS,iBAAiB,QAAQ,CAAC;EAC7C,SAAS,iBAAiB,WAAW,SAAS,eAAe,UAAU,SAAS,iBAAiB,UAAU,KAAK,GAAG;EACnH,SAAS,iBAAiB,YAAY,SAAS,kBAAkB,UAAU,SAAS,iBAAiB,WAAW,KAAK,GAAG;;EAEtH;;EAEF,UAAU,SAAS,WAAW,qBAAqB,CAAC;;EAEpD,UAAU,SAAS,WAAW,UAAU,CAAC;;EAEzC,UAAU,SAAS,WAAW,WAAW,CAAC;;EAExC;EACF,kBAAkB,SAAS,CAAC;;EAE1B;EACF,cAAc,SAAS,CAAC;;EAEvB;AAED,KAAI,SAAS,UAAU,WAAW,SAAS,UAAU,SAAS,OAC5D,UAAS,KAAK;WACP,SAAS,UAAU,WAAW,OAAO;;EAE9C,UAAU,SAAS,UAAU,QAAQ,CAAC;oBACpB;AAGlB,KAAI,SAAS,QAAQ,oBAAoB,MAAM,CAC7C,UAAS,KAAK;EAChB,SAAS,OAAO,mBAAmB,MAAM,CAAC;wBACpB;AAGtB,QAAO,SAAS,KAAK,OAAO"}

package/dist/src/agent-manifest/resolver.d.ts

@@ -0,0 +1,11 @@
+import { type AgentManifest, type CapabilityPreset, type EffectiveAgentManifest } from './schema.js';
+export interface ResolveManifestResult {
+    manifest: EffectiveAgentManifest;
+    sources: Record<string, string>;
+}
+export interface ResolveManifestParams {
+    agent: AgentManifest;
+    presets?: Record<string, CapabilityPreset>;
+}
+export declare function resolveEffectiveAgentManifest(params: ResolveManifestParams): ResolveManifestResult;
+export declare function getManifestSource(result: ResolveManifestResult, path: string): string | undefined;

package/dist/src/agent-manifest/resolver.js

@@ -0,0 +1,93 @@
+import { AgentManifestSchema, CapabilityPresetSchema, init_schema } from "./schema.js";
+//#region src/agent-manifest/resolver.ts
+init_schema();
+function isObject(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function clone(value) {
+	return value === void 0 ? value : structuredClone(value);
+}
+function pathJoin(base, key) {
+	return base ? `${base}.${key}` : key;
+}
+function collectLeafSources(value, source, path, out) {
+	if (Array.isArray(value)) {
+		out[path] = source;
+		return;
+	}
+	if (isObject(value)) {
+		for (const [key, child] of Object.entries(value)) collectLeafSources(child, source, pathJoin(path, key), out);
+		return;
+	}
+	if (path) out[path] = source;
+}
+function mergeInto(target, patch, params) {
+	for (const [key, patchValue] of Object.entries(patch)) {
+		const path = pathJoin(params.basePath ?? "", key);
+		if (params.locks.has(path) || [...params.locks].some((lock) => path.startsWith(`${lock}.`))) continue;
+		if (isObject(patchValue) && isObject(target[key])) {
+			mergeInto(target[key], patchValue, {
+				...params,
+				basePath: path
+			});
+			continue;
+		}
+		target[key] = clone(patchValue);
+		collectLeafSources(patchValue, params.source, path, params.sources);
+		for (const lock of params.patchLocks ?? []) {
+			const lockPath = pathJoin(path, lock);
+			params.locks.add(lockPath);
+		}
+	}
+}
+function resolvePresetChain(presetId, presets, stack, out) {
+	if (stack.includes(presetId)) throw new Error(`Capability preset cycle detected: ${[...stack, presetId].join(" -> ")}`);
+	const preset = presets[presetId];
+	if (!preset) throw new Error(`Capability preset "${presetId}" was not found`);
+	for (const parent of preset.extends ?? []) resolvePresetChain(parent, presets, [...stack, presetId], out);
+	out.push(preset);
+}
+function presetPatch(preset) {
+	const { id: _id, name: _name, description: _description, version: _version, extends: _extends, locks: _locks, ...patch } = preset;
+	return patch;
+}
+function resolveEffectiveAgentManifest(params) {
+	const agent = AgentManifestSchema.parse(params.agent);
+	const presets = Object.fromEntries(Object.entries(params.presets ?? {}).map(([id, preset]) => [id, CapabilityPresetSchema.parse(preset)]));
+	const chain = [];
+	for (const presetId of agent.extends ?? []) resolvePresetChain(presetId, presets, [], chain);
+	const merged = {};
+	const sources = {};
+	const locks = /* @__PURE__ */ new Set();
+	for (const preset of chain) {
+		mergeInto(merged, presetPatch(preset), {
+			source: `preset:${preset.id}@${preset.version}`,
+			sources,
+			locks,
+			patchLocks: preset.locks
+		});
+		for (const lock of preset.locks ?? []) locks.add(lock);
+	}
+	const { extends: _extends, ...agentPatch } = agent;
+	mergeInto(merged, agentPatch, {
+		source: `agent:${agent.id}`,
+		sources,
+		locks
+	});
+	return {
+		manifest: AgentManifestSchema.parse({
+			...merged,
+			id: agent.id,
+			enabled: agent.enabled,
+			extends: agent.extends
+		}),
+		sources
+	};
+}
+function getManifestSource(result, path) {
+	return result.sources[path];
+}
+//#endregion
+export { getManifestSource, resolveEffectiveAgentManifest };
+
+//# sourceMappingURL=resolver.js.map

package/dist/src/agent-manifest/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","names":[],"sources":["../../../src/agent-manifest/resolver.ts"],"sourcesContent":["import {\n  AgentManifestSchema,\n  CapabilityPresetSchema,\n  type AgentManifest,\n  type CapabilityPreset,\n  type EffectiveAgentManifest,\n} from './schema.js';\n\nexport interface ResolveManifestResult {\n  manifest: EffectiveAgentManifest;\n  sources: Record<string, string>;\n}\n\nexport interface ResolveManifestParams {\n  agent: AgentManifest;\n  presets?: Record<string, CapabilityPreset>;\n}\n\ntype JsonObject = Record<string, unknown>;\n\nfunction isObject(value: unknown): value is JsonObject {\n  return Boolean(value && typeof value === 'object' && !Array.isArray(value));\n}\n\nfunction clone<T>(value: T): T {\n  return value === undefined ? value : structuredClone(value);\n}\n\nfunction pathJoin(base: string, key: string): string {\n  return base ? `${base}.${key}` : key;\n}\n\nfunction collectLeafSources(value: unknown, source: string, path: string, out: Record<string, string>): void {\n  if (Array.isArray(value)) {\n    out[path] = source;\n    return;\n  }\n  if (isObject(value)) {\n    for (const [key, child] of Object.entries(value)) {\n      collectLeafSources(child, source, pathJoin(path, key), out);\n    }\n    return;\n  }\n  if (path) {\n    out[path] = source;\n  }\n}\n\nfunction mergeInto(\n  target: JsonObject,\n  patch: JsonObject,\n  params: {\n    source: string;\n    sources: Record<string, string>;\n    locks: Set<string>;\n    patchLocks?: readonly string[];\n    basePath?: string;\n  },\n): void {\n  for (const [key, patchValue] of Object.entries(patch)) {\n    const path = pathJoin(params.basePath ?? '', key);\n    if (params.locks.has(path) || [...params.locks].some((lock) => path.startsWith(`${lock}.`))) {\n      continue;\n    }\n    if (isObject(patchValue) && isObject(target[key])) {\n      mergeInto(target[key] as JsonObject, patchValue, { ...params, basePath: path });\n      continue;\n    }\n    target[key] = clone(patchValue);\n    collectLeafSources(patchValue, params.source, path, params.sources);\n    for (const lock of params.patchLocks ?? []) {\n      const lockPath = pathJoin(path, lock);\n      params.locks.add(lockPath);\n    }\n  }\n}\n\nfunction resolvePresetChain(\n  presetId: string,\n  presets: Record<string, CapabilityPreset>,\n  stack: string[],\n  out: CapabilityPreset[],\n): void {\n  if (stack.includes(presetId)) {\n    throw new Error(`Capability preset cycle detected: ${[...stack, presetId].join(' -> ')}`);\n  }\n  const preset = presets[presetId];\n  if (!preset) {\n    throw new Error(`Capability preset \"${presetId}\" was not found`);\n  }\n  for (const parent of preset.extends ?? []) {\n    resolvePresetChain(parent, presets, [...stack, presetId], out);\n  }\n  out.push(preset);\n}\n\nfunction presetPatch(preset: CapabilityPreset): JsonObject {\n  const {\n    id: _id,\n    name: _name,\n    description: _description,\n    version: _version,\n    extends: _extends,\n    locks: _locks,\n    ...patch\n  } = preset;\n  return patch as JsonObject;\n}\n\nexport function resolveEffectiveAgentManifest(params: ResolveManifestParams): ResolveManifestResult {\n  const agent = AgentManifestSchema.parse(params.agent);\n  const presets = Object.fromEntries(\n    Object.entries(params.presets ?? {}).map(([id, preset]) => [id, CapabilityPresetSchema.parse(preset)]),\n  );\n  const chain: CapabilityPreset[] = [];\n  for (const presetId of agent.extends ?? []) {\n    resolvePresetChain(presetId, presets, [], chain);\n  }\n\n  const merged: JsonObject = {};\n  const sources: Record<string, string> = {};\n  const locks = new Set<string>();\n  for (const preset of chain) {\n    mergeInto(merged, presetPatch(preset), {\n      source: `preset:${preset.id}@${preset.version}`,\n      sources,\n      locks,\n      patchLocks: preset.locks,\n    });\n    for (const lock of preset.locks ?? []) {\n      locks.add(lock);\n    }\n  }\n\n  const { extends: _extends, ...agentPatch } = agent;\n  mergeInto(merged, agentPatch as JsonObject, {\n    source: `agent:${agent.id}`,\n    sources,\n    locks,\n  });\n\n  return {\n    manifest: AgentManifestSchema.parse({ ...merged, id: agent.id, enabled: agent.enabled, extends: agent.extends }),\n    sources,\n  };\n}\n\nexport function getManifestSource(result: ResolveManifestResult, path: string): string | undefined {\n  return result.sources[path];\n}\n"],"mappings":"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"}