@xopcai/xopc 0.0.89 → 0.0.91

package/dist/src/agent/workflow/builtins/meeting-prep.js

@@ -0,0 +1,144 @@
+//#region src/agent/workflow/builtins/meeting-prep.ts
+/**
+* Built-in workflow: `meeting_prep`
+*
+* Prepares for a meeting by building context, an agenda, and talking points.
+* Useful for 1:1s, client calls, interviews, or team syncs — no code required.
+*
+* Args:
+*   - meeting_topic: what the meeting is about
+*   - attendees: who is involved (optional)
+*   - goal: desired outcome (optional)
+*/
+const MEETING_PREP_SCRIPT = `export const meta = {
+  name: 'meeting_prep',
+  description: 'Build meeting context, a tight agenda, and prioritized talking points.',
+  whenToUse: 'User has an upcoming meeting and wants prep — agenda, questions, and key messages.',
+  examplePrompts: [
+    { field: 'meeting_topic', text: 'Prep for a quarterly business review with leadership' },
+    { field: 'meeting_topic', text: 'Prepare talking points for a vendor negotiation call' },
+  ],
+  i18n: {
+    zh: {
+      description: '整理会议背景、紧凑议程与优先发言要点。',
+      whenToUse: '用户即将参加会议，需要议程、提问与关键信息准备时。',
+      examplePrompts: [
+        { field: 'meeting_topic', text: '准备与领导层的季度业务复盘会' },
+        { field: 'meeting_topic', text: '准备供应商谈判电话的发言要点' },
+      ],
+    },
+  },
+  tags: ['meeting', 'productivity'],
+  estimatedAgents: { min: 3, max: 5 },
+  phases: [
+    { title: 'Context' },
+    { title: 'Agenda' },
+    { title: 'Talking points' },
+  ],
+}
+
+const meetingTopic = args && typeof args === 'object' && args.meeting_topic
+  ? String(args.meeting_topic)
+  : 'Infer the meeting topic from the most recent user turn.'
+
+const attendees = args && typeof args === 'object' && args.attendees
+  ? String(args.attendees)
+  : 'not specified'
+
+const goal = args && typeof args === 'object' && args.goal
+  ? String(args.goal)
+  : 'achieve a clear outcome and aligned next steps'
+
+phase('Context')
+const context = await agent(
+  'Summarize meeting context. Identify stakeholder interests, likely tensions, information gaps, and success criteria.\\n\\n' +
+    'MEETING:\\n' + meetingTopic + '\\nATTENDEES:\\n' + attendees + '\\nGOAL:\\n' + goal,
+  {
+    label: 'context',
+    schema: {
+      type: 'object',
+      properties: {
+        summary: { type: 'string' },
+        stakeholderInterests: { type: 'array', items: { type: 'string' } },
+        tensions: { type: 'array', items: { type: 'string' } },
+        informationGaps: { type: 'array', items: { type: 'string' } },
+        successCriteria: { type: 'array', items: { type: 'string' } },
+      },
+      required: ['summary', 'successCriteria'],
+    },
+  },
+)
+
+phase('Agenda')
+const agenda = await agent(
+  'Draft a time-boxed agenda (30–60 min unless context suggests otherwise). Each item needs an owner hint and desired output. Prioritize decisions over status updates.\\n\\n' +
+    JSON.stringify({ meetingTopic, attendees, goal, context }, null, 2),
+  {
+    label: 'agenda',
+    schema: {
+      type: 'object',
+      properties: {
+        durationMin: { type: 'number' },
+        items: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              title: { type: 'string' },
+              minutes: { type: 'number' },
+              owner: { type: 'string' },
+              output: { type: 'string' },
+            },
+            required: ['title', 'minutes', 'output'],
+          },
+        },
+      },
+      required: ['items'],
+    },
+  },
+)
+
+phase('Talking points')
+const talkingPoints = await agent(
+  'Produce prioritized talking points: opening line, 3–5 key messages, smart questions to ask, objections to anticipate with responses, and a crisp closing ask.\\n\\n' +
+    JSON.stringify({ meetingTopic, context, agenda }, null, 2),
+  {
+    label: 'talking points',
+    schema: {
+      type: 'object',
+      properties: {
+        openingLine: { type: 'string' },
+        keyMessages: { type: 'array', items: { type: 'string' } },
+        questionsToAsk: { type: 'array', items: { type: 'string' } },
+        objections: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              objection: { type: 'string' },
+              response: { type: 'string' },
+            },
+            required: ['objection', 'response'],
+          },
+        },
+        closingAsk: { type: 'string' },
+      },
+      required: ['keyMessages', 'closingAsk'],
+    },
+  },
+)
+
+return {
+  ok: true,
+  meetingTopic,
+  attendees,
+  goal,
+  context,
+  agenda,
+  talkingPoints,
+}
+`;
+//#endregion
+export { MEETING_PREP_SCRIPT };
+
+//# sourceMappingURL=meeting-prep.js.map

package/dist/src/agent/workflow/builtins/meeting-prep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meeting-prep.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/meeting-prep.ts"],"sourcesContent":["/**\n * Built-in workflow: `meeting_prep`\n *\n * Prepares for a meeting by building context, an agenda, and talking points.\n * Useful for 1:1s, client calls, interviews, or team syncs — no code required.\n *\n * Args:\n *   - meeting_topic: what the meeting is about\n *   - attendees: who is involved (optional)\n *   - goal: desired outcome (optional)\n */\n\nexport const MEETING_PREP_SCRIPT = `export const meta = {\n  name: 'meeting_prep',\n  description: 'Build meeting context, a tight agenda, and prioritized talking points.',\n  whenToUse: 'User has an upcoming meeting and wants prep — agenda, questions, and key messages.',\n  examplePrompts: [\n    { field: 'meeting_topic', text: 'Prep for a quarterly business review with leadership' },\n    { field: 'meeting_topic', text: 'Prepare talking points for a vendor negotiation call' },\n  ],\n  i18n: {\n    zh: {\n      description: '整理会议背景、紧凑议程与优先发言要点。',\n      whenToUse: '用户即将参加会议，需要议程、提问与关键信息准备时。',\n      examplePrompts: [\n        { field: 'meeting_topic', text: '准备与领导层的季度业务复盘会' },\n        { field: 'meeting_topic', text: '准备供应商谈判电话的发言要点' },\n      ],\n    },\n  },\n  tags: ['meeting', 'productivity'],\n  estimatedAgents: { min: 3, max: 5 },\n  phases: [\n    { title: 'Context' },\n    { title: 'Agenda' },\n    { title: 'Talking points' },\n  ],\n}\n\nconst meetingTopic = args && typeof args === 'object' && args.meeting_topic\n  ? String(args.meeting_topic)\n  : 'Infer the meeting topic from the most recent user turn.'\n\nconst attendees = args && typeof args === 'object' && args.attendees\n  ? String(args.attendees)\n  : 'not specified'\n\nconst goal = args && typeof args === 'object' && args.goal\n  ? String(args.goal)\n  : 'achieve a clear outcome and aligned next steps'\n\nphase('Context')\nconst context = await agent(\n  'Summarize meeting context. Identify stakeholder interests, likely tensions, information gaps, and success criteria.\\\\n\\\\n' +\n    'MEETING:\\\\n' + meetingTopic + '\\\\nATTENDEES:\\\\n' + attendees + '\\\\nGOAL:\\\\n' + goal,\n  {\n    label: 'context',\n    schema: {\n      type: 'object',\n      properties: {\n        summary: { type: 'string' },\n        stakeholderInterests: { type: 'array', items: { type: 'string' } },\n        tensions: { type: 'array', items: { type: 'string' } },\n        informationGaps: { type: 'array', items: { type: 'string' } },\n        successCriteria: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['summary', 'successCriteria'],\n    },\n  },\n)\n\nphase('Agenda')\nconst agenda = await agent(\n  'Draft a time-boxed agenda (30–60 min unless context suggests otherwise). Each item needs an owner hint and desired output. Prioritize decisions over status updates.\\\\n\\\\n' +\n    JSON.stringify({ meetingTopic, attendees, goal, context }, null, 2),\n  {\n    label: 'agenda',\n    schema: {\n      type: 'object',\n      properties: {\n        durationMin: { type: 'number' },\n        items: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              title: { type: 'string' },\n              minutes: { type: 'number' },\n              owner: { type: 'string' },\n              output: { type: 'string' },\n            },\n            required: ['title', 'minutes', 'output'],\n          },\n        },\n      },\n      required: ['items'],\n    },\n  },\n)\n\nphase('Talking points')\nconst talkingPoints = await agent(\n  'Produce prioritized talking points: opening line, 3–5 key messages, smart questions to ask, objections to anticipate with responses, and a crisp closing ask.\\\\n\\\\n' +\n    JSON.stringify({ meetingTopic, context, agenda }, null, 2),\n  {\n    label: 'talking points',\n    schema: {\n      type: 'object',\n      properties: {\n        openingLine: { type: 'string' },\n        keyMessages: { type: 'array', items: { type: 'string' } },\n        questionsToAsk: { type: 'array', items: { type: 'string' } },\n        objections: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              objection: { type: 'string' },\n              response: { type: 'string' },\n            },\n            required: ['objection', 'response'],\n          },\n        },\n        closingAsk: { type: 'string' },\n      },\n      required: ['keyMessages', 'closingAsk'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  meetingTopic,\n  attendees,\n  goal,\n  context,\n  agenda,\n  talkingPoints,\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,sBAAsB"}

package/dist/src/agent/workflow/builtins/offer-design.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Built-in workflow: `offer_design`
+ *
+ * Package skills and time into sellable offers — tiers, pricing, delivery
+ * boundaries, and positioning for solopreneurs.
+ *
+ * Args:
+ *   - skills: what you can do
+ *   - audience: target customers
+ *   - constraints: time or revenue goals (optional)
+ */
+export declare const OFFER_DESIGN_SCRIPT = "export const meta = {\n  name: 'offer_design',\n  description: 'Package your skills into sellable offers with tiers, pricing, boundaries, and positioning.',\n  whenToUse: 'Solo operator turning expertise into productized services or subscription offers.',\n  examplePrompts: [\n    { field: 'skills', text: 'Notion systems, light automations, async consulting for creators' },\n    { field: 'audience', text: 'Solo creators doing $3k\u201315k/month' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u5C06\u4E2A\u4EBA\u80FD\u529B\u6253\u5305\u4E3A\u53EF\u552E\u5356\u7684\u4EA7\u54C1/\u670D\u52A1\uFF1A\u5C42\u7EA7\u3001\u5B9A\u4EF7\u3001\u4EA4\u4ED8\u8FB9\u754C\u4E0E\u5B9A\u4F4D\u3002',\n      whenToUse: '\u8D85\u7EA7\u4E2A\u4F53\u60F3\u628A\u4E13\u957F\u4EA7\u54C1\u5316\u3001\u8BBE\u8BA1\u62A5\u4EF7\u4E0E\u5957\u9910\u65F6\u3002',\n      examplePrompts: [\n        { field: 'skills', text: 'Notion \u7CFB\u7EDF\u642D\u5EFA\u3001\u8F7B\u91CF\u81EA\u52A8\u5316\u3001\u9762\u5411\u521B\u4F5C\u8005\u7684\u5F02\u6B65\u54A8\u8BE2' },\n        { field: 'audience', text: '\u6708\u5165 2\u201310 \u4E07\u7684\u72EC\u7ACB\u521B\u4F5C\u8005' },\n      ],\n    },\n  },\n  tags: ['planning', 'architecture'],\n  estimatedAgents: { min: 4, max: 5 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Package' },\n    { title: 'Price' },\n    { title: 'Position' },\n  ],\n}\n\nconst skills = args && typeof args === 'object' && args.skills\n  ? String(args.skills)\n  : 'Infer your skills from the most recent user turn.'\n\nconst audience = args && typeof args === 'object' && args.audience\n  ? String(args.audience)\n  : 'Infer target audience from context.'\n\nconst constraints = args && typeof args === 'object' && args.constraints\n  ? String(args.constraints)\n  : ''\n\nphase('Inventory')\nconst inventory = await agent(\n  'Inventory sellable capabilities for a solo operator. Separate high-leverage repeatable work from custom work. Note time sinks to avoid.\\n\\n' +\n    'SKILLS:\\n' + skills + '\\nAUDIENCE:\\n' + audience +\n    (constraints ? '\\nCONSTRAINTS:\\n' + constraints : ''),\n  {\n    label: 'inventory',\n    schema: {\n      type: 'object',\n      properties: {\n        coreCapabilities: { type: 'array', items: { type: 'string' } },\n        repeatable: { type: 'array', items: { type: 'string' } },\n        customOnly: { type: 'array', items: { type: 'string' } },\n        avoid: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['coreCapabilities', 'repeatable'],\n    },\n  },\n)\n\nphase('Package')\nconst packages = await agent(\n  'Design 2\u20133 offer tiers (e.g. starter / core / premium) with clear deliverables, boundaries, and who each tier is for. Fit solo capacity \u2014 no fake scale.\\n\\n' +\n    JSON.stringify({ skills, audience, constraints, inventory }, null, 2),\n  {\n    label: 'package',\n    schema: {\n      type: 'object',\n      properties: {\n        tiers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: { type: 'string' },\n              forWho: { type: 'string' },\n              deliverables: { type: 'array', items: { type: 'string' } },\n              boundaries: { type: 'array', items: { type: 'string' } },\n              timeCommitment: { type: 'string' },\n            },\n            required: ['name', 'deliverables', 'boundaries'],\n          },\n        },\n      },\n      required: ['tiers'],\n    },\n  },\n)\n\nphase('Price')\nconst pricing = await agent(\n  'Recommend pricing for each tier: price range, pricing model (fixed / retainer / subscription), rationale, and upsell path. Be realistic for solo operators.\\n\\n' +\n    JSON.stringify({ audience, constraints, packages }, null, 2),\n  {\n    label: 'price',\n    schema: {\n      type: 'object',\n      properties: {\n        tiers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: { type: 'string' },\n              priceRange: { type: 'string' },\n              model: { type: 'string' },\n              rationale: { type: 'string' },\n            },\n            required: ['name', 'priceRange', 'model'],\n          },\n        },\n        upsellPath: { type: 'string' },\n      },\n      required: ['tiers'],\n    },\n  },\n)\n\nphase('Position')\nconst positioning = await agent(\n  'Write positioning: one-line value prop, differentiation vs DIY and vs agencies, ideal customer profile, and launch checklist (first 3 steps).\\n\\n' +\n    JSON.stringify({ inventory, packages, pricing }, null, 2),\n  {\n    label: 'position',\n    schema: {\n      type: 'object',\n      properties: {\n        valueProp: { type: 'string' },\n        differentiation: { type: 'array', items: { type: 'string' } },\n        idealCustomer: { type: 'string' },\n        launchChecklist: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['valueProp', 'idealCustomer', 'launchChecklist'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  inventory,\n  packages,\n  pricing,\n  ...(positioning ?? { valueProp: 'positioning failed', launchChecklist: [] }),\n}\n";

package/dist/src/agent/workflow/builtins/offer-design.js

@@ -0,0 +1,161 @@
+//#region src/agent/workflow/builtins/offer-design.ts
+/**
+* Built-in workflow: `offer_design`
+*
+* Package skills and time into sellable offers — tiers, pricing, delivery
+* boundaries, and positioning for solopreneurs.
+*
+* Args:
+*   - skills: what you can do
+*   - audience: target customers
+*   - constraints: time or revenue goals (optional)
+*/
+const OFFER_DESIGN_SCRIPT = `export const meta = {
+  name: 'offer_design',
+  description: 'Package your skills into sellable offers with tiers, pricing, boundaries, and positioning.',
+  whenToUse: 'Solo operator turning expertise into productized services or subscription offers.',
+  examplePrompts: [
+    { field: 'skills', text: 'Notion systems, light automations, async consulting for creators' },
+    { field: 'audience', text: 'Solo creators doing $3k–15k/month' },
+  ],
+  i18n: {
+    zh: {
+      description: '将个人能力打包为可售卖的产品/服务：层级、定价、交付边界与定位。',
+      whenToUse: '超级个体想把专长产品化、设计报价与套餐时。',
+      examplePrompts: [
+        { field: 'skills', text: 'Notion 系统搭建、轻量自动化、面向创作者的异步咨询' },
+        { field: 'audience', text: '月入 2–10 万的独立创作者' },
+      ],
+    },
+  },
+  tags: ['planning', 'architecture'],
+  estimatedAgents: { min: 4, max: 5 },
+  phases: [
+    { title: 'Inventory' },
+    { title: 'Package' },
+    { title: 'Price' },
+    { title: 'Position' },
+  ],
+}
+
+const skills = args && typeof args === 'object' && args.skills
+  ? String(args.skills)
+  : 'Infer your skills from the most recent user turn.'
+
+const audience = args && typeof args === 'object' && args.audience
+  ? String(args.audience)
+  : 'Infer target audience from context.'
+
+const constraints = args && typeof args === 'object' && args.constraints
+  ? String(args.constraints)
+  : ''
+
+phase('Inventory')
+const inventory = await agent(
+  'Inventory sellable capabilities for a solo operator. Separate high-leverage repeatable work from custom work. Note time sinks to avoid.\\n\\n' +
+    'SKILLS:\\n' + skills + '\\nAUDIENCE:\\n' + audience +
+    (constraints ? '\\nCONSTRAINTS:\\n' + constraints : ''),
+  {
+    label: 'inventory',
+    schema: {
+      type: 'object',
+      properties: {
+        coreCapabilities: { type: 'array', items: { type: 'string' } },
+        repeatable: { type: 'array', items: { type: 'string' } },
+        customOnly: { type: 'array', items: { type: 'string' } },
+        avoid: { type: 'array', items: { type: 'string' } },
+      },
+      required: ['coreCapabilities', 'repeatable'],
+    },
+  },
+)
+
+phase('Package')
+const packages = await agent(
+  'Design 2–3 offer tiers (e.g. starter / core / premium) with clear deliverables, boundaries, and who each tier is for. Fit solo capacity — no fake scale.\\n\\n' +
+    JSON.stringify({ skills, audience, constraints, inventory }, null, 2),
+  {
+    label: 'package',
+    schema: {
+      type: 'object',
+      properties: {
+        tiers: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              name: { type: 'string' },
+              forWho: { type: 'string' },
+              deliverables: { type: 'array', items: { type: 'string' } },
+              boundaries: { type: 'array', items: { type: 'string' } },
+              timeCommitment: { type: 'string' },
+            },
+            required: ['name', 'deliverables', 'boundaries'],
+          },
+        },
+      },
+      required: ['tiers'],
+    },
+  },
+)
+
+phase('Price')
+const pricing = await agent(
+  'Recommend pricing for each tier: price range, pricing model (fixed / retainer / subscription), rationale, and upsell path. Be realistic for solo operators.\\n\\n' +
+    JSON.stringify({ audience, constraints, packages }, null, 2),
+  {
+    label: 'price',
+    schema: {
+      type: 'object',
+      properties: {
+        tiers: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              name: { type: 'string' },
+              priceRange: { type: 'string' },
+              model: { type: 'string' },
+              rationale: { type: 'string' },
+            },
+            required: ['name', 'priceRange', 'model'],
+          },
+        },
+        upsellPath: { type: 'string' },
+      },
+      required: ['tiers'],
+    },
+  },
+)
+
+phase('Position')
+const positioning = await agent(
+  'Write positioning: one-line value prop, differentiation vs DIY and vs agencies, ideal customer profile, and launch checklist (first 3 steps).\\n\\n' +
+    JSON.stringify({ inventory, packages, pricing }, null, 2),
+  {
+    label: 'position',
+    schema: {
+      type: 'object',
+      properties: {
+        valueProp: { type: 'string' },
+        differentiation: { type: 'array', items: { type: 'string' } },
+        idealCustomer: { type: 'string' },
+        launchChecklist: { type: 'array', items: { type: 'string' } },
+      },
+      required: ['valueProp', 'idealCustomer', 'launchChecklist'],
+    },
+  },
+)
+
+return {
+  ok: true,
+  inventory,
+  packages,
+  pricing,
+  ...(positioning ?? { valueProp: 'positioning failed', launchChecklist: [] }),
+}
+`;
+//#endregion
+export { OFFER_DESIGN_SCRIPT };
+
+//# sourceMappingURL=offer-design.js.map

package/dist/src/agent/workflow/builtins/offer-design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offer-design.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/offer-design.ts"],"sourcesContent":["/**\n * Built-in workflow: `offer_design`\n *\n * Package skills and time into sellable offers — tiers, pricing, delivery\n * boundaries, and positioning for solopreneurs.\n *\n * Args:\n *   - skills: what you can do\n *   - audience: target customers\n *   - constraints: time or revenue goals (optional)\n */\n\nexport const OFFER_DESIGN_SCRIPT = `export const meta = {\n  name: 'offer_design',\n  description: 'Package your skills into sellable offers with tiers, pricing, boundaries, and positioning.',\n  whenToUse: 'Solo operator turning expertise into productized services or subscription offers.',\n  examplePrompts: [\n    { field: 'skills', text: 'Notion systems, light automations, async consulting for creators' },\n    { field: 'audience', text: 'Solo creators doing $3k–15k/month' },\n  ],\n  i18n: {\n    zh: {\n      description: '将个人能力打包为可售卖的产品/服务：层级、定价、交付边界与定位。',\n      whenToUse: '超级个体想把专长产品化、设计报价与套餐时。',\n      examplePrompts: [\n        { field: 'skills', text: 'Notion 系统搭建、轻量自动化、面向创作者的异步咨询' },\n        { field: 'audience', text: '月入 2–10 万的独立创作者' },\n      ],\n    },\n  },\n  tags: ['planning', 'architecture'],\n  estimatedAgents: { min: 4, max: 5 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Package' },\n    { title: 'Price' },\n    { title: 'Position' },\n  ],\n}\n\nconst skills = args && typeof args === 'object' && args.skills\n  ? String(args.skills)\n  : 'Infer your skills from the most recent user turn.'\n\nconst audience = args && typeof args === 'object' && args.audience\n  ? String(args.audience)\n  : 'Infer target audience from context.'\n\nconst constraints = args && typeof args === 'object' && args.constraints\n  ? String(args.constraints)\n  : ''\n\nphase('Inventory')\nconst inventory = await agent(\n  'Inventory sellable capabilities for a solo operator. Separate high-leverage repeatable work from custom work. Note time sinks to avoid.\\\\n\\\\n' +\n    'SKILLS:\\\\n' + skills + '\\\\nAUDIENCE:\\\\n' + audience +\n    (constraints ? '\\\\nCONSTRAINTS:\\\\n' + constraints : ''),\n  {\n    label: 'inventory',\n    schema: {\n      type: 'object',\n      properties: {\n        coreCapabilities: { type: 'array', items: { type: 'string' } },\n        repeatable: { type: 'array', items: { type: 'string' } },\n        customOnly: { type: 'array', items: { type: 'string' } },\n        avoid: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['coreCapabilities', 'repeatable'],\n    },\n  },\n)\n\nphase('Package')\nconst packages = await agent(\n  'Design 2–3 offer tiers (e.g. starter / core / premium) with clear deliverables, boundaries, and who each tier is for. Fit solo capacity — no fake scale.\\\\n\\\\n' +\n    JSON.stringify({ skills, audience, constraints, inventory }, null, 2),\n  {\n    label: 'package',\n    schema: {\n      type: 'object',\n      properties: {\n        tiers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: { type: 'string' },\n              forWho: { type: 'string' },\n              deliverables: { type: 'array', items: { type: 'string' } },\n              boundaries: { type: 'array', items: { type: 'string' } },\n              timeCommitment: { type: 'string' },\n            },\n            required: ['name', 'deliverables', 'boundaries'],\n          },\n        },\n      },\n      required: ['tiers'],\n    },\n  },\n)\n\nphase('Price')\nconst pricing = await agent(\n  'Recommend pricing for each tier: price range, pricing model (fixed / retainer / subscription), rationale, and upsell path. Be realistic for solo operators.\\\\n\\\\n' +\n    JSON.stringify({ audience, constraints, packages }, null, 2),\n  {\n    label: 'price',\n    schema: {\n      type: 'object',\n      properties: {\n        tiers: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: { type: 'string' },\n              priceRange: { type: 'string' },\n              model: { type: 'string' },\n              rationale: { type: 'string' },\n            },\n            required: ['name', 'priceRange', 'model'],\n          },\n        },\n        upsellPath: { type: 'string' },\n      },\n      required: ['tiers'],\n    },\n  },\n)\n\nphase('Position')\nconst positioning = await agent(\n  'Write positioning: one-line value prop, differentiation vs DIY and vs agencies, ideal customer profile, and launch checklist (first 3 steps).\\\\n\\\\n' +\n    JSON.stringify({ inventory, packages, pricing }, null, 2),\n  {\n    label: 'position',\n    schema: {\n      type: 'object',\n      properties: {\n        valueProp: { type: 'string' },\n        differentiation: { type: 'array', items: { type: 'string' } },\n        idealCustomer: { type: 'string' },\n        launchChecklist: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['valueProp', 'idealCustomer', 'launchChecklist'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  inventory,\n  packages,\n  pricing,\n  ...(positioning ?? { valueProp: 'positioning failed', launchChecklist: [] }),\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,sBAAsB"}

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

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

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

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

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

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

package/dist/src/agent/workflow/step-labels.js

@@ -13,9 +13,9 @@ function workflowStepLabel(toolName, args) {
 	else if (n === "edit_file") label = "Edit file";
 	else if (n === "web_fetch") label = "Fetch URL";
 	else if (n === "open_url") label = "Open URL";
+	else if (n === "grep" || n === "rg" || n === "file_grep") label = "Search files";
 	else if (n === "web_search" || n === "brave_search" || n.includes("search")) label = "Search web";
 	else if (n === "read_file" || n.includes("read_file") || n.includes("file_read")) label = "Read file";
-	else if (n === "grep" || n === "rg") label = "Search files";
 	else if (n === "delegate_task" || n === "workflow") label = toolName;
 	const detail = extractStepDetail(n, args);
 	return detail ? {
@@ -35,7 +35,7 @@ function extractStepDetail(toolKey, args) {
 		if (typeof v === "string" && v.trim()) return truncate(v.trim());
 	}
 	if (toolKey === "shell" && typeof args.command === "string" && args.command.trim()) return truncate(args.command.trim());
-	if ((toolKey.includes("search") || toolKey === "grep" || toolKey === "rg") && typeof args.query === "string" && args.query.trim()) return truncate(args.query.trim());
+	if ((toolKey.includes("search") || toolKey === "grep" || toolKey === "rg" || toolKey === "file_grep") && typeof args.query === "string" && args.query.trim()) return truncate(args.query.trim());
 	if (typeof args.url === "string" && args.url.trim()) return truncate(args.url.trim());
 }
 function truncate(text) {

package/dist/src/agent/workflow/step-labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-labels.js","names":[],"sources":["../../../../src/agent/workflow/step-labels.ts"],"sourcesContent":["/**\n * Human-readable labels for workflow subagent tool steps (server-side snapshot).\n * Mirrors the web `tool-friendly-title` rules so IM/TUI and gateway stay aligned.\n */\n\nconst MAX_DETAIL_LEN = 120;\n\nexport function workflowStepLabel(\n  toolName: string,\n  args: Record<string, unknown>,\n): { label: string; detail?: string } {\n  const n = toolName.toLowerCase().replace(/-/g, '_').trim();\n  let label = toolName.trim() || 'tool';\n  if (n === 'shell') label = 'Run command';\n  else if (n === 'list_dir' || n === 'ls') label = 'List directory';\n  else if (n === 'write_file') label = 'Write file';\n  else if (n === 'edit_file') label = 'Edit file';\n  else if (n === 'web_fetch') label = 'Fetch URL';\n  else if (n === 'open_url') label = 'Open URL';\n  else if (n === 'web_search' || n === 'brave_search' || n.includes('search')) label = 'Search web';\n  else if (n === 'read_file' || n.includes('read_file') || n.includes('file_read')) label = 'Read file';\n  else if (n === 'grep' || n === 'rg') label = 'Search files';\n  else if (n === 'delegate_task' || n === 'workflow') label = toolName;\n\n  const detail = extractStepDetail(n, args);\n  return detail ? { label, detail } : { label };\n}\n\nfunction extractStepDetail(toolKey: string, args: Record<string, unknown>): string | undefined {\n  const pathKeys = ['path', 'file_path', 'filePath', 'target_file', 'targetFile'];\n  for (const key of pathKeys) {\n    const v = args[key];\n    if (typeof v === 'string' && v.trim()) return truncate(v.trim());\n  }\n  if (toolKey === 'shell' && typeof args.command === 'string' && args.command.trim()) {\n    return truncate(args.command.trim());\n  }\n  if (\n    (toolKey.includes('search') || toolKey === 'grep' || toolKey === 'rg') &&\n    typeof args.query === 'string' &&\n    args.query.trim()\n  ) {\n    return truncate(args.query.trim());\n  }\n  if (typeof args.url === 'string' && args.url.trim()) return truncate(args.url.trim());\n  return undefined;\n}\n\nfunction truncate(text: string): string {\n  if (text.length <= MAX_DETAIL_LEN) return text;\n  return `${text.slice(0, MAX_DETAIL_LEN - 1)}…`;\n}\n"],"mappings":";;;;;AAKA,MAAM,iBAAiB;AAEvB,SAAgB,kBACd,UACA,MACoC;CACpC,MAAM,IAAI,SAAS,aAAa,CAAC,QAAQ,MAAM,IAAI,CAAC,MAAM;CAC1D,IAAI,QAAQ,SAAS,MAAM,IAAI;AAC/B,KAAI,MAAM,QAAS,SAAQ;UAClB,MAAM,cAAc,MAAM,KAAM,SAAQ;UACxC,MAAM,aAAc,SAAQ;UAC5B,MAAM,YAAa,SAAQ;UAC3B,MAAM,YAAa,SAAQ;UAC3B,MAAM,WAAY,SAAQ;UAC1B,MAAM,gBAAgB,MAAM,kBAAkB,EAAE,SAAS,SAAS,CAAE,SAAQ;UAC5E,MAAM,eAAe,EAAE,SAAS,YAAY,IAAI,EAAE,SAAS,YAAY,CAAE,SAAQ;UACjF,MAAM,UAAU,MAAM,KAAM,SAAQ;UACpC,MAAM,mBAAmB,MAAM,WAAY,SAAQ;CAE5D,MAAM,SAAS,kBAAkB,GAAG,KAAK;AACzC,QAAO,SAAS;EAAE;EAAO;EAAQ,GAAG,EAAE,OAAO;;AAG/C,SAAS,kBAAkB,SAAiB,MAAmD;AAE7F,MAAK,MAAM,OAAO;EADA;EAAQ;EAAa;EAAY;EAAe;EACxC,EAAE;EAC1B,MAAM,IAAI,KAAK;AACf,MAAI,OAAO,MAAM,YAAY,EAAE,MAAM,CAAE,QAAO,SAAS,EAAE,MAAM,CAAC;;AAElE,KAAI,YAAY,WAAW,OAAO,KAAK,YAAY,YAAY,KAAK,QAAQ,MAAM,CAChF,QAAO,SAAS,KAAK,QAAQ,MAAM,CAAC;AAEtC,MACG,QAAQ,SAAS,SAAS,IAAI,YAAY,UAAU,YAAY,SACjE,OAAO,KAAK,UAAU,YACtB,KAAK,MAAM,MAAM,CAEjB,QAAO,SAAS,KAAK,MAAM,MAAM,CAAC;AAEpC,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,SAAS,KAAK,IAAI,MAAM,CAAC;;AAIvF,SAAS,SAAS,MAAsB;AACtC,KAAI,KAAK,UAAU,eAAgB,QAAO;AAC1C,QAAO,GAAG,KAAK,MAAM,GAAG,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"step-labels.js","names":[],"sources":["../../../../src/agent/workflow/step-labels.ts"],"sourcesContent":["/**\n * Human-readable labels for workflow subagent tool steps (server-side snapshot).\n * Mirrors the web `tool-friendly-title` rules so IM/TUI and gateway stay aligned.\n */\n\nconst MAX_DETAIL_LEN = 120;\n\nexport function workflowStepLabel(\n  toolName: string,\n  args: Record<string, unknown>,\n): { label: string; detail?: string } {\n  const n = toolName.toLowerCase().replace(/-/g, '_').trim();\n  let label = toolName.trim() || 'tool';\n  if (n === 'shell') label = 'Run command';\n  else if (n === 'list_dir' || n === 'ls') label = 'List directory';\n  else if (n === 'write_file') label = 'Write file';\n  else if (n === 'edit_file') label = 'Edit file';\n  else if (n === 'web_fetch') label = 'Fetch URL';\n  else if (n === 'open_url') label = 'Open URL';\n  else if (n === 'grep' || n === 'rg' || n === 'file_grep') label = 'Search files';\n  else if (n === 'web_search' || n === 'brave_search' || n.includes('search')) label = 'Search web';\n  else if (n === 'read_file' || n.includes('read_file') || n.includes('file_read')) label = 'Read file';\n  else if (n === 'delegate_task' || n === 'workflow') label = toolName;\n\n  const detail = extractStepDetail(n, args);\n  return detail ? { label, detail } : { label };\n}\n\nfunction extractStepDetail(toolKey: string, args: Record<string, unknown>): string | undefined {\n  const pathKeys = ['path', 'file_path', 'filePath', 'target_file', 'targetFile'];\n  for (const key of pathKeys) {\n    const v = args[key];\n    if (typeof v === 'string' && v.trim()) return truncate(v.trim());\n  }\n  if (toolKey === 'shell' && typeof args.command === 'string' && args.command.trim()) {\n    return truncate(args.command.trim());\n  }\n  if (\n    (toolKey.includes('search') || toolKey === 'grep' || toolKey === 'rg' || toolKey === 'file_grep') &&\n    typeof args.query === 'string' &&\n    args.query.trim()\n  ) {\n    return truncate(args.query.trim());\n  }\n  if (typeof args.url === 'string' && args.url.trim()) return truncate(args.url.trim());\n  return undefined;\n}\n\nfunction truncate(text: string): string {\n  if (text.length <= MAX_DETAIL_LEN) return text;\n  return `${text.slice(0, MAX_DETAIL_LEN - 1)}…`;\n}\n"],"mappings":";;;;;AAKA,MAAM,iBAAiB;AAEvB,SAAgB,kBACd,UACA,MACoC;CACpC,MAAM,IAAI,SAAS,aAAa,CAAC,QAAQ,MAAM,IAAI,CAAC,MAAM;CAC1D,IAAI,QAAQ,SAAS,MAAM,IAAI;AAC/B,KAAI,MAAM,QAAS,SAAQ;UAClB,MAAM,cAAc,MAAM,KAAM,SAAQ;UACxC,MAAM,aAAc,SAAQ;UAC5B,MAAM,YAAa,SAAQ;UAC3B,MAAM,YAAa,SAAQ;UAC3B,MAAM,WAAY,SAAQ;UAC1B,MAAM,UAAU,MAAM,QAAQ,MAAM,YAAa,SAAQ;UACzD,MAAM,gBAAgB,MAAM,kBAAkB,EAAE,SAAS,SAAS,CAAE,SAAQ;UAC5E,MAAM,eAAe,EAAE,SAAS,YAAY,IAAI,EAAE,SAAS,YAAY,CAAE,SAAQ;UACjF,MAAM,mBAAmB,MAAM,WAAY,SAAQ;CAE5D,MAAM,SAAS,kBAAkB,GAAG,KAAK;AACzC,QAAO,SAAS;EAAE;EAAO;EAAQ,GAAG,EAAE,OAAO;;AAG/C,SAAS,kBAAkB,SAAiB,MAAmD;AAE7F,MAAK,MAAM,OAAO;EADA;EAAQ;EAAa;EAAY;EAAe;EACxC,EAAE;EAC1B,MAAM,IAAI,KAAK;AACf,MAAI,OAAO,MAAM,YAAY,EAAE,MAAM,CAAE,QAAO,SAAS,EAAE,MAAM,CAAC;;AAElE,KAAI,YAAY,WAAW,OAAO,KAAK,YAAY,YAAY,KAAK,QAAQ,MAAM,CAChF,QAAO,SAAS,KAAK,QAAQ,MAAM,CAAC;AAEtC,MACG,QAAQ,SAAS,SAAS,IAAI,YAAY,UAAU,YAAY,QAAQ,YAAY,gBACrF,OAAO,KAAK,UAAU,YACtB,KAAK,MAAM,MAAM,CAEjB,QAAO,SAAS,KAAK,MAAM,MAAM,CAAC;AAEpC,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,SAAS,KAAK,IAAI,MAAM,CAAC;;AAIvF,SAAS,SAAS,MAAsB;AACtC,KAAI,KAAK,UAAU,eAAgB,QAAO;AAC1C,QAAO,GAAG,KAAK,MAAM,GAAG,iBAAiB,EAAE,CAAC"}

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

@@ -122,7 +122,9 @@ function mapChildProgressEvent(event) {
 			type: "tool_end",
 			toolCallId: event.toolCallId ?? "",
 			toolName: event.toolName ?? "tool",
-			isError: Boolean(event.isError)
+			isError: Boolean(event.isError),
+			resultPreview: event.resultPreview,
+			error: event.error
 		};
 		case "iteration": return {
 			type: "iteration",

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

@@ -1 +1 @@
-{"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/**\n * Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n *\n * Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n *\n * Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n *   tool set and unwrap the captured value on success. If the subagent finishes\n *   without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n *   matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n *   `buildChildTools` injection point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  type BuildChildToolsOptions,\n  createDelegateChildHandle,\n  type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n  DEFAULT_DELEGATE_TOOLS,\n  DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n  createStructuredOutputTool,\n  STRUCTURED_OUTPUT_TOOL_NAME,\n  type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner, SubagentProgressEvent } from './types.js';\n\nconst log = createLogger('workflow-subagent-runner');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n  workspace: string;\n  bus: MessageBus;\n  /** Resolves the default subagent model (typically the parent agent's primary model). */\n  getDefaultModel: () => Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /**\n   * Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n   * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n   * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n   * dependency contract).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n  constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n  async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null> {\n    if (opts.signal?.aborted) return null;\n\n    const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n    const wantStructured = Boolean(opts.schema);\n\n    const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n    const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n    if (!model) {\n      log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n      return null;\n    }\n\n    const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n    const streamMode = resolveSubagentStreamMode(this.deps.getConfig);\n\n    const childOptions: DelegateChildHandleOptions = {\n      workspace: this.deps.workspace,\n      goal: fullPrompt,\n      allowedToolNames: allowed,\n      maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n      model,\n      bus: this.deps.bus,\n      getConfig: this.deps.getConfig,\n      toolExecutorConfig: this.deps.toolExecutorConfig,\n      buildChildTools: (childOpts) => {\n        const base = this.deps.buildChildTools(childOpts);\n        if (!wantStructured || !opts.schema) return base;\n        // Replace any existing tool with the same name so the per-run capture wins.\n        const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n        return [\n          ...filtered,\n          createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n        ];\n      },\n      progressHooks:\n        opts.onProgress && streamMode !== 'off'\n          ? {\n              mode: streamMode === 'full' ? 'full' : 'steps',\n              onProgress: (event) => {\n                opts.onProgress?.(mapChildProgressEvent(event));\n              },\n            }\n          : undefined,\n    };\n\n    const handle = createDelegateChildHandle(childOptions);\n    const onAbort = () => handle.abort();\n    opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n    try {\n      const { summary } = await handle.run();\n      if (opts.signal?.aborted) return null;\n\n      if (wantStructured) {\n        if (!capture.called) {\n          log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n          return null;\n        }\n        return capture.value as T;\n      }\n      return summary as unknown as T;\n    } catch (e) {\n      if (opts.rethrow) throw e;\n      const msg = e instanceof Error ? e.message : String(e);\n      log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n      return null;\n    } finally {\n      opts.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n}\n\nfunction resolveAllowedToolNames(\n  requested: string[] | undefined,\n  wantStructured: boolean,\n): string[] {\n  const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n  const filtered = base\n    .map((s) => String(s).trim())\n    .filter((s) => s.length > 0)\n    .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n  if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n    filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n  }\n  return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n  const parts: string[] = [];\n  if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n  if (opts.label) parts.push(`Task label: ${opts.label}`);\n  if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n  parts.push(prompt);\n  if (structured) {\n    parts.push(\n      [\n        'Final output contract:',\n        '- Your final action MUST be a structured_output tool call.',\n        '- The structured_output arguments are the return value of this subagent.',\n        '- Do not emit a prose final answer instead of structured_output.',\n        '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n      ].join('\\n'),\n    );\n  }\n  return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> | null {\n  try {\n    return get();\n  } catch (e) {\n    log.warn({ err: e }, 'failed to resolve default subagent model');\n    return null;\n  }\n}\n\nfunction resolveSubagentStreamMode(\n  getConfig: () => Config | undefined,\n): 'off' | 'steps' | 'full' {\n  const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;\n  if (mode === 'off' || mode === 'steps' || mode === 'full') return mode;\n  return 'steps';\n}\n\nfunction mapChildProgressEvent(event: {\n  type: 'tool_start' | 'tool_end' | 'iteration' | 'text_delta' | 'thinking_delta';\n  toolCallId?: string;\n  toolName?: string;\n  args?: Record<string, unknown>;\n  isError?: boolean;\n  count?: number;\n  max?: number;\n  delta?: string;\n}): SubagentProgressEvent {\n  switch (event.type) {\n    case 'tool_start':\n      return {\n        type: 'tool_start',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        args: event.args ?? {},\n      };\n    case 'tool_end':\n      return {\n        type: 'tool_end',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        isError: Boolean(event.isError),\n      };\n    case 'iteration':\n      return {\n        type: 'iteration',\n        count: event.count ?? 0,\n        max: event.max ?? 0,\n      };\n    case 'text_delta':\n      return { type: 'text_delta', delta: event.delta ?? '' };\n    case 'thinking_delta':\n      return { type: 'thinking_delta', delta: event.delta ?? '' };\n    default:\n      return { type: 'text_delta', delta: '' };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/**\n * Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n *\n * Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n *\n * Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n *   tool set and unwrap the captured value on success. If the subagent finishes\n *   without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n *   matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n *   `buildChildTools` injection point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  type BuildChildToolsOptions,\n  createDelegateChildHandle,\n  type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n  DEFAULT_DELEGATE_TOOLS,\n  DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n  createStructuredOutputTool,\n  STRUCTURED_OUTPUT_TOOL_NAME,\n  type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner, SubagentProgressEvent } from './types.js';\n\nconst log = createLogger('workflow-subagent-runner');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n  workspace: string;\n  bus: MessageBus;\n  /** Resolves the default subagent model (typically the parent agent's primary model). */\n  getDefaultModel: () => Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /**\n   * Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n   * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n   * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n   * dependency contract).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n  constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n  async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null> {\n    if (opts.signal?.aborted) return null;\n\n    const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n    const wantStructured = Boolean(opts.schema);\n\n    const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n    const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n    if (!model) {\n      log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n      return null;\n    }\n\n    const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n    const streamMode = resolveSubagentStreamMode(this.deps.getConfig);\n\n    const childOptions: DelegateChildHandleOptions = {\n      workspace: this.deps.workspace,\n      goal: fullPrompt,\n      allowedToolNames: allowed,\n      maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n      model,\n      bus: this.deps.bus,\n      getConfig: this.deps.getConfig,\n      toolExecutorConfig: this.deps.toolExecutorConfig,\n      buildChildTools: (childOpts) => {\n        const base = this.deps.buildChildTools(childOpts);\n        if (!wantStructured || !opts.schema) return base;\n        // Replace any existing tool with the same name so the per-run capture wins.\n        const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n        return [\n          ...filtered,\n          createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n        ];\n      },\n      progressHooks:\n        opts.onProgress && streamMode !== 'off'\n          ? {\n              mode: streamMode === 'full' ? 'full' : 'steps',\n              onProgress: (event) => {\n                opts.onProgress?.(mapChildProgressEvent(event));\n              },\n            }\n          : undefined,\n    };\n\n    const handle = createDelegateChildHandle(childOptions);\n    const onAbort = () => handle.abort();\n    opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n    try {\n      const { summary } = await handle.run();\n      if (opts.signal?.aborted) return null;\n\n      if (wantStructured) {\n        if (!capture.called) {\n          log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n          return null;\n        }\n        return capture.value as T;\n      }\n      return summary as unknown as T;\n    } catch (e) {\n      if (opts.rethrow) throw e;\n      const msg = e instanceof Error ? e.message : String(e);\n      log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n      return null;\n    } finally {\n      opts.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n}\n\nfunction resolveAllowedToolNames(\n  requested: string[] | undefined,\n  wantStructured: boolean,\n): string[] {\n  const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n  const filtered = base\n    .map((s) => String(s).trim())\n    .filter((s) => s.length > 0)\n    .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n  if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n    filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n  }\n  return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n  const parts: string[] = [];\n  if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n  if (opts.label) parts.push(`Task label: ${opts.label}`);\n  if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n  parts.push(prompt);\n  if (structured) {\n    parts.push(\n      [\n        'Final output contract:',\n        '- Your final action MUST be a structured_output tool call.',\n        '- The structured_output arguments are the return value of this subagent.',\n        '- Do not emit a prose final answer instead of structured_output.',\n        '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n      ].join('\\n'),\n    );\n  }\n  return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> | null {\n  try {\n    return get();\n  } catch (e) {\n    log.warn({ err: e }, 'failed to resolve default subagent model');\n    return null;\n  }\n}\n\nfunction resolveSubagentStreamMode(\n  getConfig: () => Config | undefined,\n): 'off' | 'steps' | 'full' {\n  const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;\n  if (mode === 'off' || mode === 'steps' || mode === 'full') return mode;\n  return 'steps';\n}\n\nfunction mapChildProgressEvent(event: {\n  type: 'tool_start' | 'tool_end' | 'iteration' | 'text_delta' | 'thinking_delta';\n  toolCallId?: string;\n  toolName?: string;\n  args?: Record<string, unknown>;\n  isError?: boolean;\n  resultPreview?: string;\n  error?: string;\n  count?: number;\n  max?: number;\n  delta?: string;\n}): SubagentProgressEvent {\n  switch (event.type) {\n    case 'tool_start':\n      return {\n        type: 'tool_start',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        args: event.args ?? {},\n      };\n    case 'tool_end':\n      return {\n        type: 'tool_end',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        isError: Boolean(event.isError),\n        resultPreview: event.resultPreview,\n        error: event.error,\n      };\n    case 'iteration':\n      return {\n        type: 'iteration',\n        count: event.count ?? 0,\n        max: event.max ?? 0,\n      };\n    case 'text_delta':\n      return { type: 'text_delta', delta: event.delta ?? '' };\n    case 'thinking_delta':\n      return { type: 'thinking_delta', delta: event.delta ?? '' };\n    default:\n      return { type: 'text_delta', delta: '' };\n  }\n}\n"],"mappings":"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"}