@xopcai/xopc 0.0.87 → 0.0.88

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

@@ -6,12 +6,14 @@
  */
 import { AUDIT_REPO_SCRIPT } from './audit-repo.js';
 import { DEBUG_INCIDENT_SCRIPT } from './debug-incident.js';
+import { IMPLEMENTATION_PLAN_SCRIPT } from './implementation-plan.js';
 import { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from './multi-perspective-review.js';
 import { PR_REVIEW_SCRIPT } from './pr-review.js';
+import { RELEASE_CHECK_SCRIPT } from './release-check.js';
 import { RESEARCH_SCRIPT } from './research.js';
 export interface BuiltinWorkflow {
     name: string;
     script: string;
 }
 export declare const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[];
-export { AUDIT_REPO_SCRIPT, DEBUG_INCIDENT_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, PR_REVIEW_SCRIPT, RESEARCH_SCRIPT, };
+export { AUDIT_REPO_SCRIPT, DEBUG_INCIDENT_SCRIPT, IMPLEMENTATION_PLAN_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, PR_REVIEW_SCRIPT, RELEASE_CHECK_SCRIPT, RESEARCH_SCRIPT, };

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

@@ -1,7 +1,9 @@
 import { AUDIT_REPO_SCRIPT } from "./audit-repo.js";
 import { DEBUG_INCIDENT_SCRIPT } from "./debug-incident.js";
+import { IMPLEMENTATION_PLAN_SCRIPT } from "./implementation-plan.js";
 import { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from "./multi-perspective-review.js";
 import { PR_REVIEW_SCRIPT } from "./pr-review.js";
+import { RELEASE_CHECK_SCRIPT } from "./release-check.js";
 import { RESEARCH_SCRIPT } from "./research.js";
 //#region src/agent/workflow/builtins/index.ts
 /**
@@ -19,6 +21,10 @@ const BUILTIN_WORKFLOWS = Object.freeze([
 		name: "debug_incident",
 		script: DEBUG_INCIDENT_SCRIPT
 	},
+	{
+		name: "implementation_plan",
+		script: IMPLEMENTATION_PLAN_SCRIPT
+	},
 	{
 		name: "multi_perspective_review",
 		script: MULTI_PERSPECTIVE_REVIEW_SCRIPT
@@ -27,12 +33,16 @@ const BUILTIN_WORKFLOWS = Object.freeze([
 		name: "pr_review",
 		script: PR_REVIEW_SCRIPT
 	},
+	{
+		name: "release_check",
+		script: RELEASE_CHECK_SCRIPT
+	},
 	{
 		name: "research",
 		script: RESEARCH_SCRIPT
 	}
 ]);
 //#endregion
-export { AUDIT_REPO_SCRIPT, BUILTIN_WORKFLOWS, DEBUG_INCIDENT_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, PR_REVIEW_SCRIPT, RESEARCH_SCRIPT };
+export { AUDIT_REPO_SCRIPT, BUILTIN_WORKFLOWS, DEBUG_INCIDENT_SCRIPT, IMPLEMENTATION_PLAN_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, PR_REVIEW_SCRIPT, RELEASE_CHECK_SCRIPT, RESEARCH_SCRIPT };
 
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/index.ts"],"sourcesContent":["/**\n * Bundled workflow templates. These are shipped with xopc and discoverable\n * via the catalog alongside user workflows in `~/.xopc/workflows/`. A user\n * workflow with the same `name` always wins — built-ins are starting points,\n * not authority.\n */\n\nimport { AUDIT_REPO_SCRIPT } from './audit-repo.js';\nimport { DEBUG_INCIDENT_SCRIPT } from './debug-incident.js';\nimport { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from './multi-perspective-review.js';\nimport { PR_REVIEW_SCRIPT } from './pr-review.js';\nimport { RESEARCH_SCRIPT } from './research.js';\n\nexport interface BuiltinWorkflow {\n  name: string;\n  script: string;\n}\n\nexport const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[] = Object.freeze([\n  { name: 'audit_repo', script: AUDIT_REPO_SCRIPT },\n  { name: 'debug_incident', script: DEBUG_INCIDENT_SCRIPT },\n  { name: 'multi_perspective_review', script: MULTI_PERSPECTIVE_REVIEW_SCRIPT },\n  { name: 'pr_review', script: PR_REVIEW_SCRIPT },\n  { name: 'research', script: RESEARCH_SCRIPT },\n]);\n\nexport {\n  AUDIT_REPO_SCRIPT,\n  DEBUG_INCIDENT_SCRIPT,\n  MULTI_PERSPECTIVE_REVIEW_SCRIPT,\n  PR_REVIEW_SCRIPT,\n  RESEARCH_SCRIPT,\n};\n"],"mappings":";;;;;;;;;;;;AAkBA,MAAa,oBAAgD,OAAO,OAAO;CACzE;EAAE,MAAM;EAAc,QAAQ;EAAmB;CACjD;EAAE,MAAM;EAAkB,QAAQ;EAAuB;CACzD;EAAE,MAAM;EAA4B,QAAQ;EAAiC;CAC7E;EAAE,MAAM;EAAa,QAAQ;EAAkB;CAC/C;EAAE,MAAM;EAAY,QAAQ;EAAiB;CAC9C,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/index.ts"],"sourcesContent":["/**\n * Bundled workflow templates. These are shipped with xopc and discoverable\n * via the catalog alongside user workflows in `~/.xopc/workflows/`. A user\n * workflow with the same `name` always wins — built-ins are starting points,\n * not authority.\n */\n\nimport { AUDIT_REPO_SCRIPT } from './audit-repo.js';\nimport { DEBUG_INCIDENT_SCRIPT } from './debug-incident.js';\nimport { IMPLEMENTATION_PLAN_SCRIPT } from './implementation-plan.js';\nimport { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from './multi-perspective-review.js';\nimport { PR_REVIEW_SCRIPT } from './pr-review.js';\nimport { RELEASE_CHECK_SCRIPT } from './release-check.js';\nimport { RESEARCH_SCRIPT } from './research.js';\n\nexport interface BuiltinWorkflow {\n  name: string;\n  script: string;\n}\n\nexport const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[] = Object.freeze([\n  { name: 'audit_repo', script: AUDIT_REPO_SCRIPT },\n  { name: 'debug_incident', script: DEBUG_INCIDENT_SCRIPT },\n  { name: 'implementation_plan', script: IMPLEMENTATION_PLAN_SCRIPT },\n  { name: 'multi_perspective_review', script: MULTI_PERSPECTIVE_REVIEW_SCRIPT },\n  { name: 'pr_review', script: PR_REVIEW_SCRIPT },\n  { name: 'release_check', script: RELEASE_CHECK_SCRIPT },\n  { name: 'research', script: RESEARCH_SCRIPT },\n]);\n\nexport {\n  AUDIT_REPO_SCRIPT,\n  DEBUG_INCIDENT_SCRIPT,\n  IMPLEMENTATION_PLAN_SCRIPT,\n  MULTI_PERSPECTIVE_REVIEW_SCRIPT,\n  PR_REVIEW_SCRIPT,\n  RELEASE_CHECK_SCRIPT,\n  RESEARCH_SCRIPT,\n};\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAa,oBAAgD,OAAO,OAAO;CACzE;EAAE,MAAM;EAAc,QAAQ;EAAmB;CACjD;EAAE,MAAM;EAAkB,QAAQ;EAAuB;CACzD;EAAE,MAAM;EAAuB,QAAQ;EAA4B;CACnE;EAAE,MAAM;EAA4B,QAAQ;EAAiC;CAC7E;EAAE,MAAM;EAAa,QAAQ;EAAkB;CAC/C;EAAE,MAAM;EAAiB,QAAQ;EAAsB;CACvD;EAAE,MAAM;EAAY,QAAQ;EAAiB;CAC9C,CAAC"}

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

@@ -11,4 +11,4 @@
  *   - lenses: optional array of { name, angle } to override default lenses
  *   - skipAdversarial: when true, skip the adversarial judge phase
  */
-export declare const MULTI_PERSPECTIVE_REVIEW_SCRIPT = "export const meta = {\n  name: 'multi_perspective_review',\n  description: 'Review a target from N independent perspectives, then adversarially judge what would actually break.',\n  whenToUse: 'User wants a stress-test of a design, plan, PR, or proposal before committing to it.',\n  tags: ['review', 'planning', 'decision'],\n  estimatedAgents: { min: 5, max: 6 },\n  phases: [\n    { title: 'Lenses' },\n    { title: 'Adversarial' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst target = args && typeof args === 'object' && args.target\n  ? String(args.target)\n  : 'No explicit target was provided. Treat the currently focused file or recent context as the target.'\n\nconst skipAdversarial = Boolean(args && typeof args === 'object' && args.skipAdversarial)\n\nconst DEFAULT_LENSES = [\n  { name: 'User', angle: 'How a real user experiences this. Friction, confusion, surprise paths, accessibility.' },\n  { name: 'Operator', angle: 'How an on-call engineer experiences this in production. Failure modes, observability, rollback.' },\n  { name: 'Skeptic', angle: 'Hidden assumptions. What is being implied but not stated. What would break under load or weird input.' },\n  { name: 'Maintainer', angle: 'Six-month-later view. Clarity, naming, layering, ease of changing nearby code.' },\n]\n\nlet lenses = DEFAULT_LENSES\nif (args && typeof args === 'object' && Array.isArray(args.lenses) && args.lenses.length) {\n  lenses = args.lenses\n    .filter((l) => l && typeof l === 'object' && l.name && l.angle)\n    .map((l) => ({ name: String(l.name), angle: String(l.angle) }))\n  if (!lenses.length) lenses = DEFAULT_LENSES\n}\n\nphase('Lenses')\nconst lensViews = await parallel(\n  lenses.map((l) => () =>\n    agent(\n      'Review the following target through the ' + l.name + ' lens.\\n' +\n        'Lens focus: ' + l.angle + '\\n\\n' +\n        'TARGET:\\n' + target + '\\n\\n' +\n        'Return 3\u20137 concrete observations. Each entry: title (5\u201310 words), why-it-matters (1 sentence), risk (low/med/high).',\n      {\n        label: l.name + ' lens',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            observations: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  why: { type: 'string' },\n                  risk: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['title', 'why', 'risk'],\n              },\n            },\n          },\n          required: ['observations'],\n        },\n      },\n    ),\n  ),\n)\n\nconst valid = lensViews.filter(Boolean)\nconst allObs = valid.flatMap((v, i) =>\n  (v?.observations ?? []).map((o) => ({ lens: lenses[i].name, ...o })),\n)\n\nlet verdict = null\nif (!skipAdversarial) {\n  phase('Adversarial')\n  verdict = await agent(\n    'You are an adversarial judge. Given these multi-lens observations of a target, decide which would actually cause real harm if shipped as-is. ' +\n      'Default to realRisk=false unless an observation has clear, mechanism-level evidence. ' +\n      'Rate evidenceStrength as weak | moderate | strong.\\n\\n' +\n      JSON.stringify(allObs, null, 2),\n    {\n      label: 'adversarial verdict',\n      schema: {\n        type: 'object',\n        properties: {\n          verdicts: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                title: { type: 'string' },\n                lens: { type: 'string' },\n                realRisk: { type: 'boolean' },\n                evidenceStrength: { type: 'string', enum: ['weak', 'moderate', 'strong'] },\n                reason: { type: 'string' },\n              },\n              required: ['title', 'lens', 'realRisk', 'evidenceStrength', 'reason'],\n            },\n          },\n        },\n        required: ['verdicts'],\n      },\n    },\n  )\n}\n\nphase('Synthesize')\nconst confirmed = (verdict?.verdicts ?? []).filter((v) => v.realRisk)\nconst goNoGo = skipAdversarial\n  ? (allObs.some((o) => o.risk === 'high') ? 'fix_first' : 'ship')\n  : confirmed.some((v) => v.evidenceStrength === 'strong')\n    ? 'fix_first'\n    : confirmed.length\n      ? 'fix_first'\n      : 'ship'\n\nreturn {\n  ok: true,\n  target,\n  lenses: lenses.map((l) => l.name),\n  skipAdversarial,\n  observationCount: allObs.length,\n  confirmedRiskCount: confirmed.length,\n  goNoGo,\n  topRisks: confirmed.slice(0, 10),\n  allVerdicts: verdict?.verdicts ?? [],\n}\n";
+export declare const MULTI_PERSPECTIVE_REVIEW_SCRIPT = "export const meta = {\n  name: 'multi_perspective_review',\n  description: 'Review a target from N independent perspectives, then adversarially judge what would actually break.',\n  whenToUse: 'User wants a stress-test of a design, plan, PR, or proposal before committing to it.',\n  examplePrompts: [\n    { field: 'target', text: 'Stress-test this API redesign before we ship' },\n    { field: 'target', text: 'Review the migration plan from multiple angles' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u4ECE\u591A\u4E2A\u72EC\u7ACB\u89C6\u89D2\u8BC4\u5BA1\u76EE\u6807\uFF0C\u5E76\u7531\u5BF9\u6297\u6027\u8BC4\u5BA1\u5224\u65AD\u5B9E\u9645\u4F1A\u51FA\u4EC0\u4E48\u95EE\u9898\u3002',\n      whenToUse: '\u7528\u6237\u60F3\u5728\u843D\u5730\u524D\u5BF9\u8BBE\u8BA1\u3001\u65B9\u6848\u3001PR \u6216\u63D0\u6848\u505A\u538B\u529B\u6D4B\u8BD5\u65F6\u3002',\n      examplePrompts: [\n        { field: 'target', text: '\u4E0A\u7EBF\u524D\u4ECE\u591A\u89D2\u5EA6\u538B\u529B\u6D4B\u8BD5\u8FD9\u4E2A API redesign' },\n        { field: 'target', text: '\u4ECE\u591A\u4E2A\u89C6\u89D2\u8BC4\u5BA1\u8FD9\u4EFD\u8FC1\u79FB\u65B9\u6848' },\n      ],\n    },\n  },\n  tags: ['review', 'planning', 'decision'],\n  estimatedAgents: { min: 5, max: 6 },\n  phases: [\n    { title: 'Lenses' },\n    { title: 'Adversarial' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst target = args && typeof args === 'object' && args.target\n  ? String(args.target)\n  : 'No explicit target was provided. Treat the currently focused file or recent context as the target.'\n\nconst skipAdversarial = Boolean(args && typeof args === 'object' && args.skipAdversarial)\n\nconst DEFAULT_LENSES = [\n  { name: 'User', angle: 'How a real user experiences this. Friction, confusion, surprise paths, accessibility.' },\n  { name: 'Operator', angle: 'How an on-call engineer experiences this in production. Failure modes, observability, rollback.' },\n  { name: 'Skeptic', angle: 'Hidden assumptions. What is being implied but not stated. What would break under load or weird input.' },\n  { name: 'Maintainer', angle: 'Six-month-later view. Clarity, naming, layering, ease of changing nearby code.' },\n]\n\nlet lenses = DEFAULT_LENSES\nif (args && typeof args === 'object' && Array.isArray(args.lenses) && args.lenses.length) {\n  lenses = args.lenses\n    .filter((l) => l && typeof l === 'object' && l.name && l.angle)\n    .map((l) => ({ name: String(l.name), angle: String(l.angle) }))\n  if (!lenses.length) lenses = DEFAULT_LENSES\n}\n\nphase('Lenses')\nconst lensViews = await parallel(\n  lenses.map((l) => () =>\n    agent(\n      'Review the following target through the ' + l.name + ' lens.\\n' +\n        'Lens focus: ' + l.angle + '\\n\\n' +\n        'TARGET:\\n' + target + '\\n\\n' +\n        'Return 3\u20137 concrete observations. Each entry: title (5\u201310 words), why-it-matters (1 sentence), risk (low/med/high).',\n      {\n        label: l.name + ' lens',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            observations: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  why: { type: 'string' },\n                  risk: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['title', 'why', 'risk'],\n              },\n            },\n          },\n          required: ['observations'],\n        },\n      },\n    ),\n  ),\n)\n\nconst valid = lensViews.filter(Boolean)\nconst allObs = valid.flatMap((v, i) =>\n  (v?.observations ?? []).map((o) => ({ lens: lenses[i].name, ...o })),\n)\n\nlet verdict = null\nif (!skipAdversarial) {\n  phase('Adversarial')\n  verdict = await agent(\n    'You are an adversarial judge. Given these multi-lens observations of a target, decide which would actually cause real harm if shipped as-is. ' +\n      'Default to realRisk=false unless an observation has clear, mechanism-level evidence. ' +\n      'Rate evidenceStrength as weak | moderate | strong.\\n\\n' +\n      JSON.stringify(allObs, null, 2),\n    {\n      label: 'adversarial verdict',\n      schema: {\n        type: 'object',\n        properties: {\n          verdicts: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                title: { type: 'string' },\n                lens: { type: 'string' },\n                realRisk: { type: 'boolean' },\n                evidenceStrength: { type: 'string', enum: ['weak', 'moderate', 'strong'] },\n                reason: { type: 'string' },\n              },\n              required: ['title', 'lens', 'realRisk', 'evidenceStrength', 'reason'],\n            },\n          },\n        },\n        required: ['verdicts'],\n      },\n    },\n  )\n}\n\nphase('Synthesize')\nconst confirmed = (verdict?.verdicts ?? []).filter((v) => v.realRisk)\nconst goNoGo = skipAdversarial\n  ? (allObs.some((o) => o.risk === 'high') ? 'fix_first' : 'ship')\n  : confirmed.some((v) => v.evidenceStrength === 'strong')\n    ? 'fix_first'\n    : confirmed.length\n      ? 'fix_first'\n      : 'ship'\n\nreturn {\n  ok: true,\n  target,\n  lenses: lenses.map((l) => l.name),\n  skipAdversarial,\n  observationCount: allObs.length,\n  confirmedRiskCount: confirmed.length,\n  goNoGo,\n  topRisks: confirmed.slice(0, 10),\n  allVerdicts: verdict?.verdicts ?? [],\n}\n";

package/dist/src/agent/workflow/builtins/multi-perspective-review.js

@@ -16,6 +16,20 @@ const MULTI_PERSPECTIVE_REVIEW_SCRIPT = `export const meta = {
   name: 'multi_perspective_review',
   description: 'Review a target from N independent perspectives, then adversarially judge what would actually break.',
   whenToUse: 'User wants a stress-test of a design, plan, PR, or proposal before committing to it.',
+  examplePrompts: [
+    { field: 'target', text: 'Stress-test this API redesign before we ship' },
+    { field: 'target', text: 'Review the migration plan from multiple angles' },
+  ],
+  i18n: {
+    zh: {
+      description: '从多个独立视角评审目标，并由对抗性评审判断实际会出什么问题。',
+      whenToUse: '用户想在落地前对设计、方案、PR 或提案做压力测试时。',
+      examplePrompts: [
+        { field: 'target', text: '上线前从多角度压力测试这个 API redesign' },
+        { field: 'target', text: '从多个视角评审这份迁移方案' },
+      ],
+    },
+  },
   tags: ['review', 'planning', 'decision'],
   estimatedAgents: { min: 5, max: 6 },
   phases: [

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

@@ -1 +1 @@
-{"version":3,"file":"multi-perspective-review.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/multi-perspective-review.ts"],"sourcesContent":["/**\n * Built-in workflow: `multi_perspective_review`\n *\n * Reviews a target (file, PR, design doc, plan — passed via args.target) from\n * several independent perspectives, then asks an adversarial judge to decide\n * what would actually break in practice. Useful for sanity-checking decisions\n * before they ship.\n *\n * Args:\n *   - target: what to review\n *   - lenses: optional array of { name, angle } to override default lenses\n *   - skipAdversarial: when true, skip the adversarial judge phase\n */\n\nexport const MULTI_PERSPECTIVE_REVIEW_SCRIPT = `export const meta = {\n  name: 'multi_perspective_review',\n  description: 'Review a target from N independent perspectives, then adversarially judge what would actually break.',\n  whenToUse: 'User wants a stress-test of a design, plan, PR, or proposal before committing to it.',\n  tags: ['review', 'planning', 'decision'],\n  estimatedAgents: { min: 5, max: 6 },\n  phases: [\n    { title: 'Lenses' },\n    { title: 'Adversarial' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst target = args && typeof args === 'object' && args.target\n  ? String(args.target)\n  : 'No explicit target was provided. Treat the currently focused file or recent context as the target.'\n\nconst skipAdversarial = Boolean(args && typeof args === 'object' && args.skipAdversarial)\n\nconst DEFAULT_LENSES = [\n  { name: 'User', angle: 'How a real user experiences this. Friction, confusion, surprise paths, accessibility.' },\n  { name: 'Operator', angle: 'How an on-call engineer experiences this in production. Failure modes, observability, rollback.' },\n  { name: 'Skeptic', angle: 'Hidden assumptions. What is being implied but not stated. What would break under load or weird input.' },\n  { name: 'Maintainer', angle: 'Six-month-later view. Clarity, naming, layering, ease of changing nearby code.' },\n]\n\nlet lenses = DEFAULT_LENSES\nif (args && typeof args === 'object' && Array.isArray(args.lenses) && args.lenses.length) {\n  lenses = args.lenses\n    .filter((l) => l && typeof l === 'object' && l.name && l.angle)\n    .map((l) => ({ name: String(l.name), angle: String(l.angle) }))\n  if (!lenses.length) lenses = DEFAULT_LENSES\n}\n\nphase('Lenses')\nconst lensViews = await parallel(\n  lenses.map((l) => () =>\n    agent(\n      'Review the following target through the ' + l.name + ' lens.\\\\n' +\n        'Lens focus: ' + l.angle + '\\\\n\\\\n' +\n        'TARGET:\\\\n' + target + '\\\\n\\\\n' +\n        'Return 3–7 concrete observations. Each entry: title (5–10 words), why-it-matters (1 sentence), risk (low/med/high).',\n      {\n        label: l.name + ' lens',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            observations: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  why: { type: 'string' },\n                  risk: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['title', 'why', 'risk'],\n              },\n            },\n          },\n          required: ['observations'],\n        },\n      },\n    ),\n  ),\n)\n\nconst valid = lensViews.filter(Boolean)\nconst allObs = valid.flatMap((v, i) =>\n  (v?.observations ?? []).map((o) => ({ lens: lenses[i].name, ...o })),\n)\n\nlet verdict = null\nif (!skipAdversarial) {\n  phase('Adversarial')\n  verdict = await agent(\n    'You are an adversarial judge. Given these multi-lens observations of a target, decide which would actually cause real harm if shipped as-is. ' +\n      'Default to realRisk=false unless an observation has clear, mechanism-level evidence. ' +\n      'Rate evidenceStrength as weak | moderate | strong.\\\\n\\\\n' +\n      JSON.stringify(allObs, null, 2),\n    {\n      label: 'adversarial verdict',\n      schema: {\n        type: 'object',\n        properties: {\n          verdicts: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                title: { type: 'string' },\n                lens: { type: 'string' },\n                realRisk: { type: 'boolean' },\n                evidenceStrength: { type: 'string', enum: ['weak', 'moderate', 'strong'] },\n                reason: { type: 'string' },\n              },\n              required: ['title', 'lens', 'realRisk', 'evidenceStrength', 'reason'],\n            },\n          },\n        },\n        required: ['verdicts'],\n      },\n    },\n  )\n}\n\nphase('Synthesize')\nconst confirmed = (verdict?.verdicts ?? []).filter((v) => v.realRisk)\nconst goNoGo = skipAdversarial\n  ? (allObs.some((o) => o.risk === 'high') ? 'fix_first' : 'ship')\n  : confirmed.some((v) => v.evidenceStrength === 'strong')\n    ? 'fix_first'\n    : confirmed.length\n      ? 'fix_first'\n      : 'ship'\n\nreturn {\n  ok: true,\n  target,\n  lenses: lenses.map((l) => l.name),\n  skipAdversarial,\n  observationCount: allObs.length,\n  confirmedRiskCount: confirmed.length,\n  goNoGo,\n  topRisks: confirmed.slice(0, 10),\n  allVerdicts: verdict?.verdicts ?? [],\n}\n`\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,kCAAkC"}
+{"version":3,"file":"multi-perspective-review.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/multi-perspective-review.ts"],"sourcesContent":["/**\n * Built-in workflow: `multi_perspective_review`\n *\n * Reviews a target (file, PR, design doc, plan — passed via args.target) from\n * several independent perspectives, then asks an adversarial judge to decide\n * what would actually break in practice. Useful for sanity-checking decisions\n * before they ship.\n *\n * Args:\n *   - target: what to review\n *   - lenses: optional array of { name, angle } to override default lenses\n *   - skipAdversarial: when true, skip the adversarial judge phase\n */\n\nexport const MULTI_PERSPECTIVE_REVIEW_SCRIPT = `export const meta = {\n  name: 'multi_perspective_review',\n  description: 'Review a target from N independent perspectives, then adversarially judge what would actually break.',\n  whenToUse: 'User wants a stress-test of a design, plan, PR, or proposal before committing to it.',\n  examplePrompts: [\n    { field: 'target', text: 'Stress-test this API redesign before we ship' },\n    { field: 'target', text: 'Review the migration plan from multiple angles' },\n  ],\n  i18n: {\n    zh: {\n      description: '从多个独立视角评审目标，并由对抗性评审判断实际会出什么问题。',\n      whenToUse: '用户想在落地前对设计、方案、PR 或提案做压力测试时。',\n      examplePrompts: [\n        { field: 'target', text: '上线前从多角度压力测试这个 API redesign' },\n        { field: 'target', text: '从多个视角评审这份迁移方案' },\n      ],\n    },\n  },\n  tags: ['review', 'planning', 'decision'],\n  estimatedAgents: { min: 5, max: 6 },\n  phases: [\n    { title: 'Lenses' },\n    { title: 'Adversarial' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst target = args && typeof args === 'object' && args.target\n  ? String(args.target)\n  : 'No explicit target was provided. Treat the currently focused file or recent context as the target.'\n\nconst skipAdversarial = Boolean(args && typeof args === 'object' && args.skipAdversarial)\n\nconst DEFAULT_LENSES = [\n  { name: 'User', angle: 'How a real user experiences this. Friction, confusion, surprise paths, accessibility.' },\n  { name: 'Operator', angle: 'How an on-call engineer experiences this in production. Failure modes, observability, rollback.' },\n  { name: 'Skeptic', angle: 'Hidden assumptions. What is being implied but not stated. What would break under load or weird input.' },\n  { name: 'Maintainer', angle: 'Six-month-later view. Clarity, naming, layering, ease of changing nearby code.' },\n]\n\nlet lenses = DEFAULT_LENSES\nif (args && typeof args === 'object' && Array.isArray(args.lenses) && args.lenses.length) {\n  lenses = args.lenses\n    .filter((l) => l && typeof l === 'object' && l.name && l.angle)\n    .map((l) => ({ name: String(l.name), angle: String(l.angle) }))\n  if (!lenses.length) lenses = DEFAULT_LENSES\n}\n\nphase('Lenses')\nconst lensViews = await parallel(\n  lenses.map((l) => () =>\n    agent(\n      'Review the following target through the ' + l.name + ' lens.\\\\n' +\n        'Lens focus: ' + l.angle + '\\\\n\\\\n' +\n        'TARGET:\\\\n' + target + '\\\\n\\\\n' +\n        'Return 3–7 concrete observations. Each entry: title (5–10 words), why-it-matters (1 sentence), risk (low/med/high).',\n      {\n        label: l.name + ' lens',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            observations: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  why: { type: 'string' },\n                  risk: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['title', 'why', 'risk'],\n              },\n            },\n          },\n          required: ['observations'],\n        },\n      },\n    ),\n  ),\n)\n\nconst valid = lensViews.filter(Boolean)\nconst allObs = valid.flatMap((v, i) =>\n  (v?.observations ?? []).map((o) => ({ lens: lenses[i].name, ...o })),\n)\n\nlet verdict = null\nif (!skipAdversarial) {\n  phase('Adversarial')\n  verdict = await agent(\n    'You are an adversarial judge. Given these multi-lens observations of a target, decide which would actually cause real harm if shipped as-is. ' +\n      'Default to realRisk=false unless an observation has clear, mechanism-level evidence. ' +\n      'Rate evidenceStrength as weak | moderate | strong.\\\\n\\\\n' +\n      JSON.stringify(allObs, null, 2),\n    {\n      label: 'adversarial verdict',\n      schema: {\n        type: 'object',\n        properties: {\n          verdicts: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                title: { type: 'string' },\n                lens: { type: 'string' },\n                realRisk: { type: 'boolean' },\n                evidenceStrength: { type: 'string', enum: ['weak', 'moderate', 'strong'] },\n                reason: { type: 'string' },\n              },\n              required: ['title', 'lens', 'realRisk', 'evidenceStrength', 'reason'],\n            },\n          },\n        },\n        required: ['verdicts'],\n      },\n    },\n  )\n}\n\nphase('Synthesize')\nconst confirmed = (verdict?.verdicts ?? []).filter((v) => v.realRisk)\nconst goNoGo = skipAdversarial\n  ? (allObs.some((o) => o.risk === 'high') ? 'fix_first' : 'ship')\n  : confirmed.some((v) => v.evidenceStrength === 'strong')\n    ? 'fix_first'\n    : confirmed.length\n      ? 'fix_first'\n      : 'ship'\n\nreturn {\n  ok: true,\n  target,\n  lenses: lenses.map((l) => l.name),\n  skipAdversarial,\n  observationCount: allObs.length,\n  confirmedRiskCount: confirmed.length,\n  goNoGo,\n  topRisks: confirmed.slice(0, 10),\n  allVerdicts: verdict?.verdicts ?? [],\n}\n`\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,kCAAkC"}

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

@@ -9,4 +9,4 @@
  *   - target: PR description, diff, commit range, or file list
  *   - diff: alias for target
  */
-export declare const PR_REVIEW_SCRIPT = "export const meta = {\n  name: 'pr_review',\n  description: 'Review a PR/diff/commit range with parallel focused reviewers and a ship/block verdict.',\n  whenToUse: 'User asks to review a PR, diff, specific changes, or commit range (not the whole repo).',\n  tags: ['code-review', 'pr'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Scope' },\n    { title: 'Review' },\n    { title: 'Verdict' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst target = args && typeof args === 'object'\n  ? String(args.target ?? args.diff ?? '')\n  : ''\nconst reviewTarget = target.trim()\n  ? target\n  : 'Recent changes in the working tree or the diff/context from the current conversation.'\n\nconst REVIEWERS = [\n  { key: 'correctness', focus: 'Logic bugs, edge cases, error handling, null safety, race conditions in changed code.' },\n  { key: 'security', focus: 'Auth/authz regressions, input validation, secret exposure, injection, unsafe deserialization in the diff.' },\n  { key: 'tests', focus: 'Missing tests for changed behavior, brittle assertions, untested edge cases introduced by this change.' },\n  { key: 'api_compat', focus: 'Breaking public API changes, schema migrations, backward compatibility, deprecation handling.' },\n  { key: 'perf', focus: 'Regressions in hot paths, accidental N+1, sync I/O, unbounded loops or allocations in changed code.' },\n]\n\nphase('Scope')\nconst scope = await agent(\n  'Identify what changed for this review target. List changed files, blast radius (what depends on them), and the apparent intent of the change. Be concise.\\n\\nTARGET:\\n' +\n    reviewTarget,\n  {\n    label: 'change scope',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        changedFiles: { type: 'array', items: { type: 'string' } },\n        intent: { type: 'string' },\n        blastRadius: { type: 'string' },\n      },\n      required: ['changedFiles', 'intent'],\n    },\n  },\n)\n\nphase('Review')\nconst reviews = await parallel(\n  REVIEWERS.map((r) => () =>\n    agent(\n      'Review these changes through the ' + r.key + ' lens.\\n' +\n        'Focus: ' + r.focus + '\\n\\n' +\n        'TARGET:\\n' + reviewTarget + '\\n\\n' +\n        'SCOPE:\\n' + JSON.stringify(scope, null, 2) + '\\n\\n' +\n        'Return findings: file, severity (low/med/high/blocker), title, fix suggestion. Blocker = must fix before merge.',\n      {\n        label: r.key,\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  severity: { type: 'string', enum: ['low', 'med', 'high', 'blocker'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Verdict')\nconst live = reviews.filter(Boolean)\nconst byReviewer = {}\nfor (let i = 0; i < REVIEWERS.length; i++) {\n  byReviewer[REVIEWERS[i].key] = live[i]?.findings ?? []\n}\n\nconst verdict = await agent(\n  'Synthesize a PR review verdict. Separate blockers from suggestions. Deduplicate. Recommend ship | fix_first | block.\\n\\n' +\n    JSON.stringify(byReviewer, null, 2),\n  {\n    label: 'verdict',\n    schema: {\n      type: 'object',\n      properties: {\n        recommendation: { type: 'string', enum: ['ship', 'fix_first', 'block'] },\n        summary: { type: 'string' },\n        blockers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['file', 'title'],\n          },\n        },\n        suggestions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n            },\n            required: ['file', 'title'],\n          },\n        },\n      },\n      required: ['recommendation', 'summary', 'blockers'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  target: reviewTarget,\n  scope,\n  ...(verdict ?? { recommendation: 'fix_first', summary: 'verdict failed', blockers: [], suggestions: [] }),\n  byReviewer,\n}\n";
+export declare const PR_REVIEW_SCRIPT = "export const meta = {\n  name: 'pr_review',\n  description: 'Review a PR/diff/commit range with parallel focused reviewers and a ship/block verdict.',\n  whenToUse: 'User asks to review a PR, diff, specific changes, or commit range (not the whole repo).',\n  examplePrompts: [\n    { field: 'target', text: 'Review the changes on this branch' },\n    { field: 'target', text: 'Review PR #42 for ship/block verdict' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u5E76\u884C\u805A\u7126\u5BA1\u67E5 PR\u3001diff \u6216\u63D0\u4EA4\u8303\u56F4\uFF0C\u5E76\u7ED9\u51FA\u53EF\u5408\u5E76/\u5E94\u62E6\u622A\u7684\u7ED3\u8BBA\u3002',\n      whenToUse: '\u7528\u6237\u8981\u5BA1\u67E5 PR\u3001diff\u3001\u7279\u5B9A\u6539\u52A8\u6216\u63D0\u4EA4\u8303\u56F4\uFF08\u800C\u975E\u6574\u5E93\uFF09\u65F6\u3002',\n      examplePrompts: [\n        { field: 'target', text: '\u5BA1\u67E5\u5F53\u524D\u5206\u652F\u4E0A\u7684\u6539\u52A8' },\n        { field: 'target', text: '\u5BA1\u67E5 PR #42\uFF0C\u7ED9\u51FA\u662F\u5426\u53EF\u5408\u5E76\u7684\u7ED3\u8BBA' },\n      ],\n    },\n  },\n  tags: ['code-review', 'pr'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Scope' },\n    { title: 'Review' },\n    { title: 'Verdict' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst target = args && typeof args === 'object'\n  ? String(args.target ?? args.diff ?? '')\n  : ''\nconst reviewTarget = target.trim()\n  ? target\n  : 'Recent changes in the working tree or the diff/context from the current conversation.'\n\nconst REVIEWERS = [\n  { key: 'correctness', focus: 'Logic bugs, edge cases, error handling, null safety, race conditions in changed code.' },\n  { key: 'security', focus: 'Auth/authz regressions, input validation, secret exposure, injection, unsafe deserialization in the diff.' },\n  { key: 'tests', focus: 'Missing tests for changed behavior, brittle assertions, untested edge cases introduced by this change.' },\n  { key: 'api_compat', focus: 'Breaking public API changes, schema migrations, backward compatibility, deprecation handling.' },\n  { key: 'perf', focus: 'Regressions in hot paths, accidental N+1, sync I/O, unbounded loops or allocations in changed code.' },\n]\n\nphase('Scope')\nconst scope = await agent(\n  'Identify what changed for this review target. List changed files, blast radius (what depends on them), and the apparent intent of the change. Be concise.\\n\\nTARGET:\\n' +\n    reviewTarget,\n  {\n    label: 'change scope',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        changedFiles: { type: 'array', items: { type: 'string' } },\n        intent: { type: 'string' },\n        blastRadius: { type: 'string' },\n      },\n      required: ['changedFiles', 'intent'],\n    },\n  },\n)\n\nphase('Review')\nconst reviews = await parallel(\n  REVIEWERS.map((r) => () =>\n    agent(\n      'Review these changes through the ' + r.key + ' lens.\\n' +\n        'Focus: ' + r.focus + '\\n\\n' +\n        'TARGET:\\n' + reviewTarget + '\\n\\n' +\n        'SCOPE:\\n' + JSON.stringify(scope, null, 2) + '\\n\\n' +\n        'Return findings: file, severity (low/med/high/blocker), title, fix suggestion. Blocker = must fix before merge.',\n      {\n        label: r.key,\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  severity: { type: 'string', enum: ['low', 'med', 'high', 'blocker'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Verdict')\nconst live = reviews.filter(Boolean)\nconst byReviewer = {}\nfor (let i = 0; i < REVIEWERS.length; i++) {\n  byReviewer[REVIEWERS[i].key] = live[i]?.findings ?? []\n}\n\nconst verdict = await agent(\n  'Synthesize a PR review verdict. Separate blockers from suggestions. Deduplicate. Recommend ship | fix_first | block.\\n\\n' +\n    JSON.stringify(byReviewer, null, 2),\n  {\n    label: 'verdict',\n    schema: {\n      type: 'object',\n      properties: {\n        recommendation: { type: 'string', enum: ['ship', 'fix_first', 'block'] },\n        summary: { type: 'string' },\n        blockers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['file', 'title'],\n          },\n        },\n        suggestions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n            },\n            required: ['file', 'title'],\n          },\n        },\n      },\n      required: ['recommendation', 'summary', 'blockers'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  target: reviewTarget,\n  scope,\n  ...(verdict ?? { recommendation: 'fix_first', summary: 'verdict failed', blockers: [], suggestions: [] }),\n  byReviewer,\n}\n";

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

@@ -14,6 +14,20 @@ const PR_REVIEW_SCRIPT = `export const meta = {
   name: 'pr_review',
   description: 'Review a PR/diff/commit range with parallel focused reviewers and a ship/block verdict.',
   whenToUse: 'User asks to review a PR, diff, specific changes, or commit range (not the whole repo).',
+  examplePrompts: [
+    { field: 'target', text: 'Review the changes on this branch' },
+    { field: 'target', text: 'Review PR #42 for ship/block verdict' },
+  ],
+  i18n: {
+    zh: {
+      description: '并行聚焦审查 PR、diff 或提交范围，并给出可合并/应拦截的结论。',
+      whenToUse: '用户要审查 PR、diff、特定改动或提交范围（而非整库）时。',
+      examplePrompts: [
+        { field: 'target', text: '审查当前分支上的改动' },
+        { field: 'target', text: '审查 PR #42，给出是否可合并的结论' },
+      ],
+    },
+  },
   tags: ['code-review', 'pr'],
   estimatedAgents: { min: 7, max: 7 },
   phases: [

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

@@ -1 +1 @@
-{"version":3,"file":"pr-review.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/pr-review.ts"],"sourcesContent":["/**\n * Built-in workflow: `pr_review`\n *\n * Focused review of a PR, diff, or commit range — lighter than full repo audit.\n * Parallel reviewers cover correctness, security, tests, API compat, and perf;\n * final phase produces a ship/block verdict with blockers vs suggestions.\n *\n * Args:\n *   - target: PR description, diff, commit range, or file list\n *   - diff: alias for target\n */\n\nexport const PR_REVIEW_SCRIPT = `export const meta = {\n  name: 'pr_review',\n  description: 'Review a PR/diff/commit range with parallel focused reviewers and a ship/block verdict.',\n  whenToUse: 'User asks to review a PR, diff, specific changes, or commit range (not the whole repo).',\n  tags: ['code-review', 'pr'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Scope' },\n    { title: 'Review' },\n    { title: 'Verdict' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst target = args && typeof args === 'object'\n  ? String(args.target ?? args.diff ?? '')\n  : ''\nconst reviewTarget = target.trim()\n  ? target\n  : 'Recent changes in the working tree or the diff/context from the current conversation.'\n\nconst REVIEWERS = [\n  { key: 'correctness', focus: 'Logic bugs, edge cases, error handling, null safety, race conditions in changed code.' },\n  { key: 'security', focus: 'Auth/authz regressions, input validation, secret exposure, injection, unsafe deserialization in the diff.' },\n  { key: 'tests', focus: 'Missing tests for changed behavior, brittle assertions, untested edge cases introduced by this change.' },\n  { key: 'api_compat', focus: 'Breaking public API changes, schema migrations, backward compatibility, deprecation handling.' },\n  { key: 'perf', focus: 'Regressions in hot paths, accidental N+1, sync I/O, unbounded loops or allocations in changed code.' },\n]\n\nphase('Scope')\nconst scope = await agent(\n  'Identify what changed for this review target. List changed files, blast radius (what depends on them), and the apparent intent of the change. Be concise.\\\\n\\\\nTARGET:\\\\n' +\n    reviewTarget,\n  {\n    label: 'change scope',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        changedFiles: { type: 'array', items: { type: 'string' } },\n        intent: { type: 'string' },\n        blastRadius: { type: 'string' },\n      },\n      required: ['changedFiles', 'intent'],\n    },\n  },\n)\n\nphase('Review')\nconst reviews = await parallel(\n  REVIEWERS.map((r) => () =>\n    agent(\n      'Review these changes through the ' + r.key + ' lens.\\\\n' +\n        'Focus: ' + r.focus + '\\\\n\\\\n' +\n        'TARGET:\\\\n' + reviewTarget + '\\\\n\\\\n' +\n        'SCOPE:\\\\n' + JSON.stringify(scope, null, 2) + '\\\\n\\\\n' +\n        'Return findings: file, severity (low/med/high/blocker), title, fix suggestion. Blocker = must fix before merge.',\n      {\n        label: r.key,\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  severity: { type: 'string', enum: ['low', 'med', 'high', 'blocker'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Verdict')\nconst live = reviews.filter(Boolean)\nconst byReviewer = {}\nfor (let i = 0; i < REVIEWERS.length; i++) {\n  byReviewer[REVIEWERS[i].key] = live[i]?.findings ?? []\n}\n\nconst verdict = await agent(\n  'Synthesize a PR review verdict. Separate blockers from suggestions. Deduplicate. Recommend ship | fix_first | block.\\\\n\\\\n' +\n    JSON.stringify(byReviewer, null, 2),\n  {\n    label: 'verdict',\n    schema: {\n      type: 'object',\n      properties: {\n        recommendation: { type: 'string', enum: ['ship', 'fix_first', 'block'] },\n        summary: { type: 'string' },\n        blockers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['file', 'title'],\n          },\n        },\n        suggestions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n            },\n            required: ['file', 'title'],\n          },\n        },\n      },\n      required: ['recommendation', 'summary', 'blockers'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  target: reviewTarget,\n  scope,\n  ...(verdict ?? { recommendation: 'fix_first', summary: 'verdict failed', blockers: [], suggestions: [] }),\n  byReviewer,\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,mBAAmB"}
+{"version":3,"file":"pr-review.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/pr-review.ts"],"sourcesContent":["/**\n * Built-in workflow: `pr_review`\n *\n * Focused review of a PR, diff, or commit range — lighter than full repo audit.\n * Parallel reviewers cover correctness, security, tests, API compat, and perf;\n * final phase produces a ship/block verdict with blockers vs suggestions.\n *\n * Args:\n *   - target: PR description, diff, commit range, or file list\n *   - diff: alias for target\n */\n\nexport const PR_REVIEW_SCRIPT = `export const meta = {\n  name: 'pr_review',\n  description: 'Review a PR/diff/commit range with parallel focused reviewers and a ship/block verdict.',\n  whenToUse: 'User asks to review a PR, diff, specific changes, or commit range (not the whole repo).',\n  examplePrompts: [\n    { field: 'target', text: 'Review the changes on this branch' },\n    { field: 'target', text: 'Review PR #42 for ship/block verdict' },\n  ],\n  i18n: {\n    zh: {\n      description: '并行聚焦审查 PR、diff 或提交范围，并给出可合并/应拦截的结论。',\n      whenToUse: '用户要审查 PR、diff、特定改动或提交范围（而非整库）时。',\n      examplePrompts: [\n        { field: 'target', text: '审查当前分支上的改动' },\n        { field: 'target', text: '审查 PR #42，给出是否可合并的结论' },\n      ],\n    },\n  },\n  tags: ['code-review', 'pr'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Scope' },\n    { title: 'Review' },\n    { title: 'Verdict' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst target = args && typeof args === 'object'\n  ? String(args.target ?? args.diff ?? '')\n  : ''\nconst reviewTarget = target.trim()\n  ? target\n  : 'Recent changes in the working tree or the diff/context from the current conversation.'\n\nconst REVIEWERS = [\n  { key: 'correctness', focus: 'Logic bugs, edge cases, error handling, null safety, race conditions in changed code.' },\n  { key: 'security', focus: 'Auth/authz regressions, input validation, secret exposure, injection, unsafe deserialization in the diff.' },\n  { key: 'tests', focus: 'Missing tests for changed behavior, brittle assertions, untested edge cases introduced by this change.' },\n  { key: 'api_compat', focus: 'Breaking public API changes, schema migrations, backward compatibility, deprecation handling.' },\n  { key: 'perf', focus: 'Regressions in hot paths, accidental N+1, sync I/O, unbounded loops or allocations in changed code.' },\n]\n\nphase('Scope')\nconst scope = await agent(\n  'Identify what changed for this review target. List changed files, blast radius (what depends on them), and the apparent intent of the change. Be concise.\\\\n\\\\nTARGET:\\\\n' +\n    reviewTarget,\n  {\n    label: 'change scope',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        changedFiles: { type: 'array', items: { type: 'string' } },\n        intent: { type: 'string' },\n        blastRadius: { type: 'string' },\n      },\n      required: ['changedFiles', 'intent'],\n    },\n  },\n)\n\nphase('Review')\nconst reviews = await parallel(\n  REVIEWERS.map((r) => () =>\n    agent(\n      'Review these changes through the ' + r.key + ' lens.\\\\n' +\n        'Focus: ' + r.focus + '\\\\n\\\\n' +\n        'TARGET:\\\\n' + reviewTarget + '\\\\n\\\\n' +\n        'SCOPE:\\\\n' + JSON.stringify(scope, null, 2) + '\\\\n\\\\n' +\n        'Return findings: file, severity (low/med/high/blocker), title, fix suggestion. Blocker = must fix before merge.',\n      {\n        label: r.key,\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  severity: { type: 'string', enum: ['low', 'med', 'high', 'blocker'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Verdict')\nconst live = reviews.filter(Boolean)\nconst byReviewer = {}\nfor (let i = 0; i < REVIEWERS.length; i++) {\n  byReviewer[REVIEWERS[i].key] = live[i]?.findings ?? []\n}\n\nconst verdict = await agent(\n  'Synthesize a PR review verdict. Separate blockers from suggestions. Deduplicate. Recommend ship | fix_first | block.\\\\n\\\\n' +\n    JSON.stringify(byReviewer, null, 2),\n  {\n    label: 'verdict',\n    schema: {\n      type: 'object',\n      properties: {\n        recommendation: { type: 'string', enum: ['ship', 'fix_first', 'block'] },\n        summary: { type: 'string' },\n        blockers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['file', 'title'],\n          },\n        },\n        suggestions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n            },\n            required: ['file', 'title'],\n          },\n        },\n      },\n      required: ['recommendation', 'summary', 'blockers'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  target: reviewTarget,\n  scope,\n  ...(verdict ?? { recommendation: 'fix_first', summary: 'verdict failed', blockers: [], suggestions: [] }),\n  byReviewer,\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,mBAAmB"}

package/dist/src/agent/workflow/builtins/release-check.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Built-in workflow: `release_check`
+ *
+ * Runs a release-readiness review for a finished change. It inspects the diff,
+ * validates risk areas in parallel, and produces a go/no-go checklist.
+ *
+ * Args:
+ *   - target: release candidate, branch, commit range, or feature summary
+ *   - checks: optional subset of check keys
+ */
+export declare 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: '\u5E76\u884C\u68C0\u67E5\u53D1\u5E03\u98CE\u9669\uFF0C\u5224\u65AD\u53D8\u66F4\u662F\u5426\u8FBE\u5230\u53EF\u53D1\u5E03\u6807\u51C6\u3002',\n      whenToUse: '\u7528\u6237\u63A5\u8FD1\u5F00\u53D1\u5C3E\u58F0\uFF0C\u60F3\u5728\u53D1\u5E03\u524D\u505A\u53D1\u5E03\u8D28\u91CF/\u5C31\u7EEA\u68C0\u67E5\u65F6\u3002',\n      examplePrompts: [\n        { field: 'target', text: '\u8FD9\u4E2A\u4ED3\u5E93\u662F\u5426\u51C6\u5907\u597D\u53D1\u5E03 v1.2\uFF1F' },\n        { field: 'target', text: '\u5BF9\u5F53\u524D\u5206\u652F\u505A\u53D1\u5E03\u524D\u5C31\u7EEA\u68C0\u67E5' },\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";

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

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

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

@@ -0,0 +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"}

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  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  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";

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

@@ -15,6 +15,20 @@ const RESEARCH_SCRIPT = `export const meta = {
   name: 'research',
   description: 'Multi-angle research on a question with parallel exploration and a cited synthesis.',
   whenToUse: 'User asks a non-trivial research question that benefits from multiple search angles or source reads.',
+  examplePrompts: [
+    { field: 'question', text: 'Compare Bun vs Node startup performance' },
+    { field: 'question', text: 'What are the trade-offs of SQLite vs Postgres for this app?' },
+  ],
+  i18n: {
+    zh: {
+      description: '多角度并行调研一个问题，并产出带引用的综合报告。',
+      whenToUse: '用户提出需要多角度检索、阅读来源的非平凡调研问题时。',
+      examplePrompts: [
+        { field: 'question', text: '比较 Bun 与 Node 的启动性能' },
+        { field: 'question', text: '这个应用用 SQLite 还是 Postgres 各有什么权衡？' },
+      ],
+    },
+  },
   tags: ['research', 'investigation'],
   estimatedAgents: { min: 4, max: 8 },
   phases: [

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  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  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"}

package/dist/src/agent/workflow/catalog.js

@@ -1,8 +1,8 @@
 import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
 import { BUILTIN_WORKFLOWS } from "./builtins/index.js";
 import { parseWorkflowScript } from "./parser.js";
-import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 //#region src/agent/workflow/catalog.ts
 /**
 * Catalog for named workflows.

package/dist/src/agent/workflow/index.d.ts

@@ -1,3 +1,4 @@
+export { applySubagentProgress } from './agent-progress.js';
 export { BUILTIN_WORKFLOWS, type BuiltinWorkflow } from './builtins/index.js';
 export { createWorkflowCatalog, defaultUserDir, type CatalogEntry, type LoadedWorkflow, type WorkflowCatalog, type WorkflowSource, } from './catalog.js';
 export { getLastWorkflowMemory, _resetLastWorkflowMemoryForTests, type LastWorkflowEntry, type LastWorkflowMemory, } from './last-run-memory.js';
@@ -8,4 +9,4 @@ export { emptySnapshotFor, runWorkflow, type RunWorkflowDeps, } from './runtime.
 export { createWorkflowSnapshot, previewValue, recomputeCounts, renderWorkflowText, type RenderOptions, } from './snapshot.js';
 export { createStructuredOutputTool, STRUCTURED_OUTPUT_TOOL_NAME, type CreateStructuredOutputToolOptions, type StructuredOutputCapture, } from './structured-output-tool.js';
 export { DelegateSubagentRunner, type DelegateSubagentRunnerDeps, } from './subagent-runner.js';
-export type { AgentScriptOptions, JsonSchema, SubagentRunner, SubagentRunOptions, WorkflowAgentSnapshot, WorkflowAgentStatus, WorkflowMeta, WorkflowMetaEstimatedAgents, WorkflowMetaPhase, WorkflowRunOptions, WorkflowRunResult, WorkflowSnapshot, } from './types.js';
+export type { AgentScriptOptions, JsonSchema, SubagentRunner, SubagentRunOptions, SubagentProgressEvent, WorkflowAgentSnapshot, WorkflowAgentStatus, WorkflowAgentStep, WorkflowMeta, WorkflowMetaEstimatedAgents, WorkflowMetaPhase, WorkflowRunOptions, WorkflowRunResult, WorkflowSnapshot, } from './types.js';

package/dist/src/agent/workflow/index.js

@@ -1,10 +1,11 @@
+import { applySubagentProgress } from "./agent-progress.js";
 import { BUILTIN_WORKFLOWS } from "./builtins/index.js";
 import { parseWorkflowScript } from "./parser.js";
 import { createWorkflowCatalog, defaultUserDir } from "./catalog.js";
 import { _resetLastWorkflowMemoryForTests, getLastWorkflowMemory } from "./last-run-memory.js";
+import { emptySnapshotFor, runWorkflow } from "./runtime.js";
 import { createWorkflowSnapshot, previewValue, recomputeCounts, renderWorkflowText } from "./snapshot.js";
 import { WorkflowProgressBroker, _resetWorkflowProgressBrokerForTests, getWorkflowProgressBroker } from "./progress-broker.js";
-import { emptySnapshotFor, runWorkflow } from "./runtime.js";
 import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 import { DelegateSubagentRunner } from "./subagent-runner.js";
-export { BUILTIN_WORKFLOWS, DelegateSubagentRunner, STRUCTURED_OUTPUT_TOOL_NAME, WorkflowProgressBroker, _resetLastWorkflowMemoryForTests, _resetWorkflowProgressBrokerForTests, createStructuredOutputTool, createWorkflowCatalog, createWorkflowSnapshot, defaultUserDir, emptySnapshotFor, getLastWorkflowMemory, getWorkflowProgressBroker, parseWorkflowScript, previewValue, recomputeCounts, renderWorkflowText, runWorkflow };
+export { BUILTIN_WORKFLOWS, DelegateSubagentRunner, STRUCTURED_OUTPUT_TOOL_NAME, WorkflowProgressBroker, _resetLastWorkflowMemoryForTests, _resetWorkflowProgressBrokerForTests, applySubagentProgress, createStructuredOutputTool, createWorkflowCatalog, createWorkflowSnapshot, defaultUserDir, emptySnapshotFor, getLastWorkflowMemory, getWorkflowProgressBroker, parseWorkflowScript, previewValue, recomputeCounts, renderWorkflowText, runWorkflow };

package/dist/src/agent/workflow/meta-locale.d.ts

@@ -0,0 +1,12 @@
+import type { WorkflowMeta, WorkflowMetaExamplePrompt, WorkflowMetaLocale } from './types.js';
+export type WorkflowLocaleCode = 'en' | 'zh';
+export declare function normalizeWorkflowLocale(language: string | undefined): WorkflowLocaleCode;
+export interface WorkflowLocalizedCopy {
+    description: string;
+    whenToUse?: string;
+    examplePrompts: WorkflowMetaExamplePrompt[];
+}
+export declare function resolveWorkflowLocalizedCopy(meta: Pick<WorkflowMeta, 'description' | 'whenToUse' | 'examplePrompts' | 'i18n'>, locale: WorkflowLocaleCode): WorkflowLocalizedCopy;
+export declare function validateExamplePrompts(value: unknown, path: string): WorkflowMetaExamplePrompt[] | undefined;
+export declare function validateMetaLocale(value: unknown, path: string): WorkflowMetaLocale;
+export declare function validateMetaI18n(value: unknown): Record<string, WorkflowMetaLocale> | undefined;