@agimon-ai/doompi-team 0.0.1-alpha.0

package/dist/extensions/statusViews.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusViews.mjs","names":[],"sources":["../../src/extensions/statusViews.ts"],"sourcesContent":["/**\n * Plain-text renderings of `action: 'status'`'s optional `view` modes, for the\n * MODEL rather than for a terminal.\n *\n * WHY THIS IS NOT `tui/fleet.ts` OR `renderFleetTranscript`:\n * Those exist, they are correct, and they are wired to the `/fleet` slash\n * command - but every one of them takes a `Theme` and emits ANSI escapes,\n * because their reader is a human looking at a TUI overlay. A tool result is\n * read by a model, where escape sequences are noise it pays tokens for and\n * cannot act on. So this module reuses the transcript READER\n * (`readFleetTranscript`, which is pure parsing) and does its own formatting,\n * rather than reusing a renderer whose whole job is the part that does not\n * transfer.\n *\n * WHY THESE VIEWS ARE WIRED AT ALL RATHER THAN DELETED FROM THE DESCRIPTION:\n * `view: 'fleet'` and `view: 'transcript'` were already documented on the\n * `subagent` tool, and neither worked - `status` read `id` first and threw\n * before ever looking at `view`, so the documented `{action:'status',\n * view:'fleet'}` call could not succeed at all. Between deleting the promise\n * and honouring it, honouring it is worth more: reading a running child's\n * output is the one coordinator capability the sibling implementation has\n * (`task_output`) that this package otherwise lacks, and the pieces to build\n * it were already here.\n *\n * DELIBERATELY NOT SUPPORTED: `index`.\n * A chain or fan-out child is its own run with its own id, not an index into\n * this run's transcript, and nothing in this package maps \"child N of run X\"\n * to a run id (see `asyncExecution.ts`'s CHILD INDEX section - the index is\n * an input the caller already knows, never something resolved back). Accepting\n * `index` here and ignoring it would be the same false affordance this whole\n * pass exists to remove, so `status` does not document it; `steer` and\n * `append-step`, which really do use it, still do.\n */\n\nimport type { TrackedAsyncJob } from '../runs/background/asyncJobTracker.ts';\nimport type { AsyncRunStatus } from '../runs/background/asyncExecution.ts';\nimport { isSuspendedRunResumable, type SuspendedRun } from '../runs/registry/suspendedRuns.ts';\nimport { readFleetTranscript, type FleetTranscriptEvent } from '../tui/fleetTranscript.ts';\nimport { formatDuration } from '../shared/formatters.ts';\n\n/** Default transcript tail length. Matches the value the tool description has always advertised. */\nexport const DEFAULT_TRANSCRIPT_LINES = 80;\n\nfunction age(job: TrackedAsyncJob, now: number): string {\n  return job.startedAt ? formatDuration(Math.max(0, now - job.startedAt)) : 'unknown';\n}\n\n/**\n * The active-fleet overview: every run this session is tracking, one per line.\n *\n * Takes `now` rather than calling `Date.now()` so a test asserting rendered\n * ages does not have to freeze global time.\n */\nexport function formatFleetView(\n  jobs: TrackedAsyncJob[],\n  now: number = Date.now(),\n  suspended: SuspendedRun[] = [],\n): string {\n  if (jobs.length === 0 && suspended.length === 0) {\n    return 'No runs tracked in this session. A run appears here once it has been launched from this session.';\n  }\n\n  const lines = [`${jobs.length} active run${jobs.length === 1 ? '' : 's'}:`];\n  for (const job of jobs) {\n    const parts = [`- ${job.runId}`, job.status ?? 'starting', age(job, now)];\n    if (job.activityState) parts.push(job.activityState);\n    if (job.attentionReason) parts.push(job.attentionReason);\n    if (job.error) parts.push(`error: ${job.error}`);\n    lines.push(parts.join(' · '));\n  }\n  if (suspended.length > 0) {\n    lines.push('', `${suspended.length} suspended run${suspended.length === 1 ? '' : 's'}:`);\n    for (const run of suspended) {\n      const recovery = isSuspendedRunResumable(run)\n        ? `restore with { action: \"restore\", id: \"${run.runId}\" }`\n        : 'not resumable; submit a new explicit run';\n      lines.push(`- ${run.runId} (${run.agent}, ${run.runtime}): ${recovery}`);\n    }\n  }\n  if (jobs.length > 0) {\n    lines.push('');\n    lines.push(`Inspect one with { action: \"status\", id: \"<run id>\", transcriptLines: ${DEFAULT_TRANSCRIPT_LINES} }.`);\n  }\n  return lines.join('\\n');\n}\n\n/** Tool output shown to the model, bounded so one long result cannot crowd out the rest of the tail. */\nconst TOOL_RESULT_PREVIEW_LINES = 5;\n\nfunction formatEvent(event: FleetTranscriptEvent): string {\n  if (event.kind === 'tool') {\n    const status = event.status === 'running' ? '…' : event.status === 'error' ? 'error' : 'ok';\n    const args = event.args ? JSON.stringify(event.args) : event.text;\n    const header = `[tool ${status}] ${event.name ?? 'tool'}${args ? ` ${args}` : ''}`;\n    const result = event.result?.trimEnd();\n    if (!result) return header;\n    // The result is the half the model most needs: it is what the call\n    // actually learned, and it used to be dropped entirely.\n    const body = result.split('\\n');\n    const shown = body.slice(0, TOOL_RESULT_PREVIEW_LINES);\n    const hidden = body.length - shown.length;\n    return [header, ...shown.map((line) => `  ${line}`), hidden > 0 ? `  … +${hidden} lines` : undefined]\n      .filter((line): line is string => line !== undefined)\n      .join('\\n');\n  }\n  return `[${event.kind}] ${event.text}`;\n}\n\n/**\n * A run's transcript tail.\n *\n * Bounded from the END, not the start: a caller asking for 80 lines of a\n * long-running child wants the most recent 80, not the first 80 of its\n * startup. When the window drops anything, the fact that it did is stated,\n * so a reader never mistakes a tail for the whole run.\n */\nexport function formatRunTranscript(status: AsyncRunStatus | undefined, maxLines: number): string {\n  const transcriptPath = status?.transcriptPath;\n  if (!transcriptPath) {\n    return status\n      ? 'This run has no transcript. Artifacts were disabled for it (artifacts: false), so nothing was recorded.'\n      : 'No status found for this run, so there is no transcript to read.';\n  }\n\n  const transcript = readFleetTranscript(transcriptPath);\n  if (transcript.warning) {\n    return `Transcript at '${transcriptPath}' could not be read: ${transcript.warning}`;\n  }\n  if (transcript.events.length === 0) {\n    return `Transcript at '${transcriptPath}' is empty. The run has not written anything yet.`;\n  }\n\n  const rendered = transcript.events.flatMap((event) => formatEvent(event).split('\\n'));\n  const kept = rendered.slice(-maxLines);\n  const dropped = rendered.length - kept.length;\n  const header =\n    dropped > 0\n      ? `Last ${kept.length} of ${rendered.length} transcript lines (${dropped} earlier line(s) not shown):`\n      : `Transcript (${kept.length} line(s)):`;\n  return [header, '', ...kept].join('\\n');\n}\n"],"mappings":"4UA2CA,SAAS,EAAI,EAAsB,EAAqB,CACtD,OAAO,EAAI,UAAY,EAAe,KAAK,IAAI,EAAG,EAAM,EAAI,UAAU,CAAC,CAAG,UAS5E,SAAgB,EACd,EACA,EAAc,KAAK,KAAK,CACxB,EAA4B,EAAE,CACtB,CACR,GAAI,EAAK,SAAW,GAAK,EAAU,SAAW,EAC5C,MAAO,mGAGT,IAAM,EAAQ,CAAC,GAAG,EAAK,OAAO,aAAa,EAAK,SAAW,EAAI,GAAK,IAAI,GAAG,CAC3E,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAQ,CAAC,KAAK,EAAI,QAAS,EAAI,QAAU,WAAY,EAAI,EAAK,EAAI,CAAC,CACrE,EAAI,eAAe,EAAM,KAAK,EAAI,cAAc,CAChD,EAAI,iBAAiB,EAAM,KAAK,EAAI,gBAAgB,CACpD,EAAI,OAAO,EAAM,KAAK,UAAU,EAAI,QAAQ,CAChD,EAAM,KAAK,EAAM,KAAK,MAAM,CAAC,CAE/B,GAAI,EAAU,OAAS,EAAG,CACxB,EAAM,KAAK,GAAI,GAAG,EAAU,OAAO,gBAAgB,EAAU,SAAW,EAAI,GAAK,IAAI,GAAG,CACxF,IAAK,IAAM,KAAO,EAAW,CAC3B,IAAM,EAAW,EAAwB,EAAI,CACzC,0CAA0C,EAAI,MAAM,KACpD,2CACJ,EAAM,KAAK,KAAK,EAAI,MAAM,IAAI,EAAI,MAAM,IAAI,EAAI,QAAQ,KAAK,IAAW,EAO5E,OAJI,EAAK,OAAS,IAChB,EAAM,KAAK,GAAG,CACd,EAAM,KAAK,8EAAuG,EAE7G,EAAM,KAAK;EAAK,CAMzB,SAAS,EAAY,EAAqC,CACxD,GAAI,EAAM,OAAS,OAAQ,CACzB,IAAM,EAAS,EAAM,SAAW,UAAY,IAAM,EAAM,SAAW,QAAU,QAAU,KACjF,EAAO,EAAM,KAAO,KAAK,UAAU,EAAM,KAAK,CAAG,EAAM,KACvD,EAAS,SAAS,EAAO,IAAI,EAAM,MAAQ,SAAS,EAAO,IAAI,IAAS,KACxE,EAAS,EAAM,QAAQ,SAAS,CACtC,GAAI,CAAC,EAAQ,OAAO,EAGpB,IAAM,EAAO,EAAO,MAAM;EAAK,CACzB,EAAQ,EAAK,MAAM,EAAG,EAA0B,CAChD,EAAS,EAAK,OAAS,EAAM,OACnC,MAAO,CAAC,EAAQ,GAAG,EAAM,IAAK,GAAS,KAAK,IAAO,CAAE,EAAS,EAAI,QAAQ,EAAO,QAAU,IAAA,GAAU,CAClG,OAAQ,GAAyB,IAAS,IAAA,GAAU,CACpD,KAAK;EAAK,CAEf,MAAO,IAAI,EAAM,KAAK,IAAI,EAAM,OAWlC,SAAgB,EAAoB,EAAoC,EAA0B,CAChG,IAAM,EAAiB,GAAQ,eAC/B,GAAI,CAAC,EACH,OAAO,EACH,0GACA,mEAGN,IAAM,EAAa,EAAoB,EAAe,CACtD,GAAI,EAAW,QACb,MAAO,kBAAkB,EAAe,uBAAuB,EAAW,UAE5E,GAAI,EAAW,OAAO,SAAW,EAC/B,MAAO,kBAAkB,EAAe,mDAG1C,IAAM,EAAW,EAAW,OAAO,QAAS,GAAU,EAAY,EAAM,CAAC,MAAM;EAAK,CAAC,CAC/E,EAAO,EAAS,MAAM,CAAC,EAAS,CAChC,EAAU,EAAS,OAAS,EAAK,OAKvC,MAAO,CAHL,EAAU,EACN,QAAQ,EAAK,OAAO,MAAM,EAAS,OAAO,qBAAqB,EAAQ,8BACvE,eAAe,EAAK,OAAO,YACjB,GAAI,GAAG,EAAK,CAAC,KAAK;EAAK,oBAvGsD,IACJ,IAClC,CAiDnD,EAA4B"}

package/dist/extensions/subagentPromptRuntime.cjs

@@ -0,0 +1,18 @@
+const e=require(`../_virtual/_rolldown/runtime.cjs`),t=require(`../shared/configDir.cjs`),n=require(`../env.cjs`),r=require(`../container/types.cjs`),i=require(`../intercom/supervisorControlChannel.cjs`),a=require(`../shared/paths.cjs`),o=require(`../intercom/nativeTeamChannel.cjs`),s=require(`../runs/shared/toolBudget.cjs`),c=require(`../container/index.cjs`),l=require(`../shared/childTranscript.cjs`),u=require(`../runs/shared/structuredOutput.cjs`),d=require(`../runs/shared/toolAvailability.cjs`);let f=require(`node:fs`);f=e.__toESM(f,1);let p=require(`node:path`);p=e.__toESM(p,1);function m(){return{steerNudgeFailures:0,watchErrors:0,watchCloseFailures:0}}const h=[`This subagent step has a strict structured output contract.`,"Your final action must be to call the `structured_output` tool with JSON matching the provided schema.","Do not rely on prose-only completion; if you do not call `structured_output`, the parent will fail this step."].join(`
+`),g=[`You are a child subagent, not the parent orchestrator.`,`The parent session owns delegation, orchestration, review fanout, and follow-up worker launches.`,`Ignore prior parent-only orchestration instructions in inherited conversation history.`,`Do not propose or run subagents. Complete only your assigned role-specific task with the tools available to you.`,`If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.`].join(`
+`),_=[`You are a child subagent with explicit fanout responsibility for this assigned task.`,`The parent session owns final orchestration, acceptance, and follow-up implementation launches.`,"You may use the `subagent` tool only for the fanout work explicitly requested in this task.",`Do not broaden yourself into general parent orchestration. Do not launch follow-up workers unless the task explicitly asks for that.`,`The maxSubagentDepth cap still applies and may block further fanout.`,`If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.`].join(`
+`);function v(e,t,n){e.on.call(e,t,n)}function y(e){return typeof e==`object`&&!!e&&e.type===`text`&&typeof e.text==`string`}function b(e){for(let t=e.length-1;t>=0;--t){let n=e[t];if(n?.role!==`assistant`||!Array.isArray(n.content))continue;let r=n.content.filter(y).map(e=>e.text).join(`
+`).trim();if(r)return r}return``}function x(e,t=c.createPromptRuntimeContainer()){let i=process.env[n.SUBAGENT_RUN_ID_ENV]?.trim();if(!i)return;let a=t.get(r.DOOM_TEAM_TYPES.PollScheduler),s=t.get(r.DOOM_TEAM_TYPES.RunnerBootstrap),u=t.get(r.DOOM_TEAM_TYPES.RunnerExecution),d=t.get(r.DOOM_TEAM_TYPES.RunnerReporting),f,p,m=0,h=new WeakSet;v(e,`session_start`,(t,n)=>{if(f)return;a.start();let r=n.sessionManager.getSessionFile(),c=r?d.recordSessionFile(r):void 0,l=s.bootstrap(i,c);l.teamContext&&Object.assign(process.env,o.nativeTeamMemberEnvironment(l.teamContext)),u.start(i,{onSteer:t=>{let n=e.sendUserMessage;if(!n){H(t,`failed`,`Child Pi session does not support sendUserMessage steering.`);return}try{n(V(t),{deliverAs:`steer`}),H(t,`delivered`,`Pi accepted the correlated steering input.`)}catch(e){throw H(t,`failed`,e instanceof Error?e.message:String(e)),e}}}),f={teamContext:l.teamContext},u.setActivity(`working`)}),v(e,`agent_start`,()=>{f&&u.setActivity(`working`)}),v(e,`message_end`,e=>{if(!f||!e.message||typeof e.message!=`object`||h.has(e.message))return;h.add(e.message);let t=l.getMessageUsageTokens(e.message);t!==void 0&&(p=(p??0)+t,u.setProgress({tokens:p}))}),v(e,`tool_execution_start`,e=>{if(!f)return;let t=e.toolName??e.tool?.name;m+=1,u.setProgress({toolCount:m,...typeof t==`string`&&t.length>0?{currentTool:t}:{}}),u.setActivity(t===`intercom`&&e.args?.action===`ask`?`waiting_for_reply`:`tool`)}),v(e,`tool_execution_end`,()=>{f&&u.setActivity(`working`)}),v(e,`agent_end`,e=>{if(!f)return;u.setActivity(`finalizing`);let t=b(e.messages);u.complete(!0,t)})}const S=new Set([`subagent-orchestration-instructions`,`subagent-slash-result`,`subagent-slash-text-result`,`subagent-notify`,`subagent_control_notice`,`subagent-control`,`subagent-control-notice`]),C=/<name>\s*pi-subagents\s*<\/name>/,w=`
+
+The following skills provide specialized instructions for specific tasks.`,T=`
+Current date:`;function E(e){let t=process.env[e];if(t!==void 0)return t!==`0`}function D(){let e=process.env[n.REQUIRED_CHILD_TOOLS_ENV]?.trim();if(!e)return;let t=JSON.parse(e);if(!Array.isArray(t)||t.some(e=>typeof e!=`string`||!e))throw Error(`Invalid ${n.REQUIRED_CHILD_TOOLS_ENV} payload.`);return t}function O(){let e=process.env[n.MCP_DIRECT_CHILD_TOOLS_ENV]?.trim();if(e)try{let t=JSON.parse(e);return!Array.isArray(t)||t.some(e=>typeof e!=`string`||!e)?void 0:t}catch{return}}function k(e){let t=process.env[n.CHILD_TOOL_DIAGNOSTIC_PATH_ENV]?.trim(),r=D();if(!(!t||!r))return d.writeChildToolDiagnostic(t,r,e.getAllTools().map(e=>e.name),process.env[n.SUBAGENT_CHILD_AGENT_ENV]?.trim(),O())}function A(e,t,n){let r=e.length;for(let i of n){let n=e.indexOf(i,t);n!==-1&&n<r&&(r=n)}return r}function j(e){let t=e.indexOf(`
+
+# Project Context
+
+Project-specific instructions and guidelines:
+
+`);if(t===-1)return e;let n=A(e,t+68,[w,T]);return`${e.slice(0,t)}${e.slice(n)}`}function M(e){let t=e.indexOf(w);if(t===-1)return e;let n=A(e,t+75,[T]);return`${e.slice(0,t)}${e.slice(n)}`}function N(e){return e.replace(/\n{0,2}<skill\s+name=["']pi-subagents["'][^>]*>[\s\S]*?<\/skill>\n{0,2}/g,`
+
+`).replace(/[ \t]*<skill>\s*[\s\S]*?<\/skill>\s*/g,e=>C.test(e)?``:e)}function P(e){let t=e;for(let e of[g,_])t=t.split(e).join(``);return t.replace(/^(?:[ \t]*\r?\n)+/,``)}function F(e,t){let n=e;return t.inheritProjectContext||(n=j(n)),t.inheritSkills||(n=M(n)),n=N(n),n=P(n),`${t.fanoutChild?_:g}${process.env.PI_SUBAGENT_STRUCTURED_OUTPUT_CAPTURE?`\n\n${h}`:``}\n\n${n}`}function I(e){let t=e;return t?.role!==`custom`||typeof t.customType!=`string`?!1:S.has(t.customType)}function L(e){let t=e;return t?.role===`toolResult`&&t.toolName===`subagent`}function R(e){let t=e;return t?.type===`toolCall`&&t.name===`subagent`}function z(e){let t=e;if(t?.role!==`assistant`||!Array.isArray(t.content))return e;let n=t.content.filter(e=>!R(e));if(n.length===t.content.length)return e;if(n.length!==0)return{...t,content:n}}function B(e){let t=process.env[n.SUBAGENT_FANOUT_CHILD_ENV]===`1`,r=!1,i=[];for(let n of e){if(I(n)||!t&&L(n)){r=!0;continue}let e=t?n:z(n);if(e===void 0){r=!0;continue}e!==n&&(r=!0),i.push(e)}return r?i:e}function V(e){return[`Mid-run steering from the parent orchestrator:`,``,e.message,``,`Incorporate this guidance at the next safe point. Do not restart the task unless the guidance explicitly asks you to.`].join(`
+`)}function H(e,t,r){let a=process.env[n.SUBAGENT_STEER_ACK_DIR_ENV]?.trim(),o=Number(process.env[n.SUBAGENT_CHILD_INDEX_ENV]);!a||!Number.isInteger(o)||o<0||i.writeSteerAckAt(i.steerAckPathFromDir(a,e.id),{requestId:e.id,index:o,ts:Date.now(),state:t,message:r})}function U(e,t,n){if(!t)return;let r=0,i=!1,a=e.sendUserMessage;v(e,`tool_call`,e=>{let o=typeof e.toolName==`string`?e.toolName:`tool`;if(r++,t.soft!==void 0&&r>=t.soft&&!i){i=!0;try{a?.(s.toolBudgetSoftNudge(t,r),{deliverAs:`steer`})}catch(e){n.steerNudgeFailures+=1,n.lastError=e}}if(s.shouldBlockToolForBudget(t,o,r))return{block:!0,reason:s.toolBudgetBlockedMessage(t,o,r)}})}function W(e,r={}){let a=r.diagnostics??m(),o=process.env[n.SUBAGENT_STEER_INBOX_ENV]?.trim();if(!o)return;let s=process.env[n.SUBAGENT_STEER_CAPABILITY_ENV]?.trim(),c=process.env[n.SUBAGENT_STEER_ACK_DIR_ENV]?.trim(),l=e.sendUserMessage,u=Number(process.env[n.SUBAGENT_CHILD_INDEX_ENV]),d=new Map,p=!1,h=!1,g=!1,_=typeof l==`function`,y,b,x=(e,t,n)=>{!c||!Number.isInteger(u)||u<0||i.writeSteerAckAt(i.steerAckPathFromDir(c,e.id),{requestId:e.id,index:u,ts:Date.now(),state:t,message:n})},S=()=>{!s||!Number.isInteger(u)||u<0||i.writeSteerCapabilityAt(s,{index:u,pid:process.pid,readyAt:Date.now(),supported:_})},C=()=>{if(!(p||h)){h=!0;try{for(let e of i.claimSteerRequestsFromDir(o)){if(!_||typeof l!=`function`){x(e.request,`failed`,`Child Pi session does not support sendUserMessage steering.`),e.commit();continue}let t=V(e.request),n=d.get(t)??[];n.push(e.request.id),d.set(t,n);try{l(t,{deliverAs:`steer`}),e.commit()}catch(r){n.pop(),n.length===0&&d.delete(t),e.release(),x(e.request,`failed`,r instanceof Error?r.message:String(r))}}}finally{h=!1}}},w=e=>{if(p||!e||typeof e!=`object`)return;let t=e;if(t.source!==`extension`||t.streamingBehavior!==`steer`)return;let n=typeof t.text==`string`?t.text:typeof t.content==`string`?t.content:void 0;if(!n)return;let r=d.get(n),i=r?.shift();i&&(r?.length===0&&d.delete(n),x({type:`steer`,id:i,ts:Date.now(),message:n},`delivered`,`Pi accepted the correlated steering input.`))},T=()=>{if(!(g||p)){try{f.mkdirSync(o,{recursive:!0}),S()}catch{return}g=!0;try{y=(r.watch??f.watch)(t.resolveWatchPath(o,r.nativeRealpath),()=>C()),y.on(`error`,e=>{a.watchErrors+=1,a.lastError=e})}catch{y=void 0}b=setInterval(C,250),b.unref?.()}},E=()=>{T(),C()};v(e,`input`,w),v(e,`session_start`,()=>T());for(let t of[`message_start`,`message_update`,`message_end`,`tool_execution_start`,`tool_execution_end`,`turn_end`])v(e,t,E);v(e,`session_shutdown`,()=>{p=!0;try{y?.close()}catch(e){a.watchCloseFailures+=1,a.lastError=e}b&&clearInterval(b)})}function G(e,t=m()){a.adoptSessionScopeFromEnv(),W(e,{diagnostics:t}),U(e,s.decodeToolBudgetEnv(process.env[n.TOOL_BUDGET_ENV],{allowZero:process.env[n.TOOL_BUDGET_ZERO_AUTH_ENV]===`1`}),t);let i=c.createPromptRuntimeContainer();x(e,i);let o=i.get(r.DOOM_TEAM_TYPES.NativeTeamChannelService);v(e,`session_start`,()=>{o.createRuntime(e).bindChildFromEnvironment()}),v(e,`agent_start`,()=>{k(e)});let l=process.env[n.STRUCTURED_OUTPUT_CAPTURE_ENV],d=process.env[n.STRUCTURED_OUTPUT_SCHEMA_ENV];if(l&&d){let t=JSON.parse(f.readFileSync(d,`utf-8`)),n=u.createStructuredOutputToolParameters(t),r=new u.StructuredOutputValidator;e.registerTool.bind(e)({name:`structured_output`,label:`Structured Output`,description:`Submit the required final structured output for this subagent step. This terminates the step.`,parameters:n,async execute(e,n){let i=await r.validateValue(t,n.value);if(i.status===`invalid`)throw Error(`Structured output validation failed: ${i.message}`);return f.mkdirSync(p.dirname(l),{recursive:!0}),f.writeFileSync(l,JSON.stringify(n.value),{mode:384}),{content:[{type:`text`,text:`Structured output captured.`}],details:{path:l},terminate:!0}}})}v(e,`context`,e=>{let t=B(e.messages);if(t!==e.messages)return{messages:t}}),v(e,`before_agent_start`,async t=>{let r=process.env[n.SUBAGENT_INTERCOM_SESSION_NAME_ENV]?.trim();r&&typeof e.setSessionName==`function`&&e.setSessionName(r);let i=E(n.INHERIT_PROJECT_CONTEXT_ENV),a=E(n.INHERIT_SKILLS_ENV),o=E(n.SUBAGENT_FANOUT_CHILD_ENV),s=t.systemPrompt;if((i!==void 0||a!==void 0||o!==void 0)&&(s=F(t.systemPrompt,{inheritProjectContext:i??!0,inheritSkills:a??!0,fanoutChild:o===!0})),s!==t.systemPrompt)return{systemPrompt:s}})}exports.registerSubagentPromptRuntime=G;
+//# sourceMappingURL=subagentPromptRuntime.cjs.map

package/dist/extensions/subagentPromptRuntime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentPromptRuntime.cjs","names":["createPromptRuntimeContainer","SUBAGENT_RUN_ID_ENV","DOOM_TEAM_TYPES","nativeTeamMemberEnvironment","getMessageUsageTokens","REQUIRED_CHILD_TOOLS_ENV","MCP_DIRECT_CHILD_TOOLS_ENV","CHILD_TOOL_DIAGNOSTIC_PATH_ENV","writeChildToolDiagnostic","SUBAGENT_CHILD_AGENT_ENV","SUBAGENT_FANOUT_CHILD_ENV","SUBAGENT_STEER_ACK_DIR_ENV","SUBAGENT_CHILD_INDEX_ENV","steerAckPathFromDir","toolBudgetSoftNudge","shouldBlockToolForBudget","toolBudgetBlockedMessage","SUBAGENT_STEER_INBOX_ENV","SUBAGENT_STEER_CAPABILITY_ENV","claimSteerRequestsFromDir","fs","resolveWatchPath","decodeToolBudgetEnv","TOOL_BUDGET_ENV","TOOL_BUDGET_ZERO_AUTH_ENV","STRUCTURED_OUTPUT_CAPTURE_ENV","STRUCTURED_OUTPUT_SCHEMA_ENV","createStructuredOutputToolParameters","StructuredOutputValidator","path","SUBAGENT_INTERCOM_SESSION_NAME_ENV","INHERIT_PROJECT_CONTEXT_ENV","INHERIT_SKILLS_ENV"],"sources":["../../src/extensions/subagentPromptRuntime.ts"],"sourcesContent":["/**\n * The extension loaded INSIDE every spawned child: prompt rewriting,\n * mid-run steering delivery, the tool-call budget, native supervisor/team\n * messaging, and the `structured_output` tool.\n *\n * WHY THIS RUNS IN A DIFFERENT WORLD THAN EVERYTHING ELSE PORTED SO FAR:\n * Every other module in this package runs in the parent or the runner\n * process. This one is loaded BY the child's own Pi process\n * (`piArgs.ts`'s `resolveRuntimeExtensionPath` resolves it onto the\n * child's `--extension` args). The child's stdout IS its captured\n * transcript - a stray console write here does not go to a developer's\n * terminal, it becomes part of the child's output. Nothing in this file\n * writes to the console, ever; a failure that would have been\n * logged elsewhere is swallowed with a comment when there is no safe channel\n * to report it.\n *\n * FIX (claim-by-rename for the per-child steer inbox):\n * The predecessor's `registerSteeringInbox` called\n * `consumeSteerRequestsFromDir`, which deletes every queued request before\n * attempting delivery, then manually re-queued whatever it had not yet\n * attempted (`requests.slice(index + 1)`) if `sendUserMessage` threw\n * partway through a batch - but the request that was actually attempted\n * when the throw happened was already gone, lost the same way FIX 1 in\n * `control-channel.ts` was written to close for the runner-side steer\n * queue. This module's `flush()` uses `claimSteerRequestsFromDir` (already\n * exported from `control-channel.ts`, directory-agnostic) instead: each\n * request is claimed individually, and a failed `sendUserMessage` call\n * calls `release()` on that one claim so it is retried on the next flush,\n * while every OTHER claim in the same batch is still committed or released\n * independently. That is also a behavioural improvement over the\n * predecessor's `break`-on-first-failure, which abandoned the rest of a\n * batch rather than giving each message its own outcome - the same\n * per-item independence `ControlChannelWatcher.check()` already applies on\n * the runner side.\n *\n * Child runtimes keep the native team transport for lifecycle and result\n * delivery, but model-visible coordination tools are filtered by the selected\n * layer policy. They never register the root orchestration tool or a separate\n * wait alias.\n *\n * AVOID:\n * - Writing to the console. See the header above\n * - Reintroducing the predecessor's \"delete the whole batch, dispatch,\n *   re-queue what failed\" shape for the steer inbox. See the FIX above\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { Container } from 'inversify';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\n\nimport { createPromptRuntimeContainer, DOOM_TEAM_TYPES } from '../container/index.ts';\nimport {\n  CHILD_TOOL_DIAGNOSTIC_PATH_ENV,\n  INHERIT_PROJECT_CONTEXT_ENV,\n  INHERIT_SKILLS_ENV,\n  MCP_DIRECT_CHILD_TOOLS_ENV,\n  REQUIRED_CHILD_TOOLS_ENV,\n  STRUCTURED_OUTPUT_CAPTURE_ENV,\n  STRUCTURED_OUTPUT_SCHEMA_ENV,\n  SUBAGENT_CHILD_AGENT_ENV,\n  SUBAGENT_CHILD_INDEX_ENV,\n  SUBAGENT_FANOUT_CHILD_ENV,\n  SUBAGENT_INTERCOM_SESSION_NAME_ENV,\n  SUBAGENT_RUN_ID_ENV,\n  SUBAGENT_STEER_ACK_DIR_ENV,\n  SUBAGENT_STEER_CAPABILITY_ENV,\n  SUBAGENT_STEER_INBOX_ENV,\n  TOOL_BUDGET_ENV,\n  TOOL_BUDGET_ZERO_AUTH_ENV,\n} from '../env.ts';\nimport {\n  type INativeTeamChannelService,\n  NATIVE_TEAM_TOOL_NAME,\n  nativeTeamMemberEnvironment,\n  type TeamMemberContext,\n} from '../intercom/nativeTeamChannel.ts';\nimport { resolveWatchPath } from '../shared/configDir.ts';\nimport { getMessageUsageTokens, type ChildTranscriptMessage } from '../shared/childTranscript.ts';\nimport { adoptSessionScopeFromEnv } from '../shared/paths.ts';\nimport type { JsonSchemaObject } from '../types.ts';\nimport {\n  claimSteerRequestsFromDir,\n  steerAckPathFromDir,\n  writeSteerAckAt,\n  writeSteerCapabilityAt,\n  type SteerRequest,\n} from '../intercom/supervisorControlChannel.ts';\nimport type { IPollScheduler } from '../shared/pollScheduler.ts';\nimport type { IRunnerBootstrap } from '../runs/background/runnerBootstrap.ts';\nimport type { IRunnerExecution } from '../runs/background/runnerExecution.ts';\nimport type { IRunnerReporting } from '../runs/background/runnerReporting.ts';\nimport { createStructuredOutputToolParameters, StructuredOutputValidator } from '../runs/shared/structuredOutput.ts';\nimport { writeChildToolDiagnostic, type ChildToolDiagnostic } from '../runs/shared/toolAvailability.ts';\nimport {\n  decodeToolBudgetEnv,\n  shouldBlockToolForBudget,\n  toolBudgetBlockedMessage,\n  toolBudgetSoftNudge,\n} from '../runs/shared/toolBudget.ts';\nimport type { ResolvedToolBudget } from '../runs/shared/toolBudget.ts';\n\nconst STEER_FLUSH_POLL_INTERVAL_MS = 250;\n\n/**\n * Failures this runtime absorbed rather than propagated.\n *\n * WHY RECORD RATHER THAN LOG:\n * This module runs inside the spawned child, where stdout IS the child's\n * captured transcript. Writing a diagnostic there would corrupt the very\n * output the run exists to produce, so nothing here may reach stdio. But a\n * discarded error is indistinguishable from one that never happened, and a\n * watcher that fails on every event looks exactly like a quiet inbox. These\n * counters are the compromise: cheap, bounded, and queryable by a caller that\n * wants to know whether the child's steering path was actually healthy.\n *\n * WHY THIS IS CALLER-OWNED, NOT MODULE STATE:\n * A module-level singleton here would be exactly the bug this package's \"no\n * module-level mutable state\" rule exists to prevent - see\n * `nativeTeamChannel.ts`'s header: \"a second session in the same process\n * cannot inherit the first one's [state]\". `registerSubagentPromptRuntime`\n * runs once per real child process, so a singleton would rarely matter in\n * production, but every test in this file registers multiple independent\n * runtimes in one process, and a shared singleton would leak counts between\n * them silently. `createPromptRuntimeDiagnostics()` hands each registration\n * its own object instead; the caller keeps the reference to read later, and\n * a fresh registration is what \"reset\" means - there is no shared state left\n * to reset.\n *\n * AVOID:\n * - Adding a `console.*` here, on any path, for any reason\n * - Treating a non-zero count as fatal; every one of these is a degraded-mode\n *   path with a working fallback, which is why it was absorbed in the first place\n * - Reintroducing a module-level instance of this. See the header above\n */\nexport interface PromptRuntimeDiagnostics {\n  /** Advisory tool-budget nudges that could not be delivered to the child. */\n  steerNudgeFailures: number;\n  /** Errors emitted by the steer-inbox watcher. The interval poll covers these. */\n  watchErrors: number;\n  /** Failures closing the watcher during shutdown. */\n  watchCloseFailures: number;\n  /** The most recent absorbed failure, whichever kind it was. */\n  lastError?: unknown;\n}\n\n/** A fresh, zeroed diagnostics object for one registration. See the interface doc for why this is not a singleton. */\nexport function createPromptRuntimeDiagnostics(): PromptRuntimeDiagnostics {\n  return { steerNudgeFailures: 0, watchErrors: 0, watchCloseFailures: 0 };\n}\n\nconst STRUCTURED_OUTPUT_INSTRUCTIONS = [\n  'This subagent step has a strict structured output contract.',\n  'Your final action must be to call the `structured_output` tool with JSON matching the provided schema.',\n  'Do not rely on prose-only completion; if you do not call `structured_output`, the parent will fail this step.',\n].join('\\n');\n\nexport const CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS = [\n  'You are a child subagent, not the parent orchestrator.',\n  'The parent session owns delegation, orchestration, review fanout, and follow-up worker launches.',\n  'Ignore prior parent-only orchestration instructions in inherited conversation history.',\n  'Do not propose or run subagents. Complete only your assigned role-specific task with the tools available to you.',\n  'If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.',\n].join('\\n');\n\nexport const CHILD_FANOUT_BOUNDARY_INSTRUCTIONS = [\n  'You are a child subagent with explicit fanout responsibility for this assigned task.',\n  'The parent session owns final orchestration, acceptance, and follow-up implementation launches.',\n  'You may use the `subagent` tool only for the fanout work explicitly requested in this task.',\n  'Do not broaden yourself into general parent orchestration. Do not launch follow-up workers unless the task explicitly asks for that.',\n  'The maxSubagentDepth cap still applies and may block further fanout.',\n  'If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.',\n].join('\\n');\n\n/**\n * `pi.on` typed loosely: the extension API's event payloads are not typed\n * per event name, so every call site narrows its own handler's parameter.\n * `.call(pi, ...)` binds `this` explicitly rather than extracting `pi.on` as\n * a bare reference, which is what an unbound method call would otherwise risk.\n *\n * The handler is given `ctx: ExtensionContext` as a second parameter,\n * matching the real `pi.on` signature (`ExtensionHandler<E, R> = (event: E,\n * ctx: ExtensionContext) => ...`) even though most registrations here never\n * read it - existing single-parameter handlers stay valid without change\n * (JS ignores a callback's unused trailing parameters), and the one call\n * site that DOES need it (`session_start`, for `ctx.sessionManager` - see\n * `registerDeliverableGuardCheck`'s doc) no longer has to reach past this\n * wrapper to get it.\n */\nfunction onEvent<E = unknown>(\n  pi: ExtensionAPI,\n  event: string,\n  handler: (event: E, ctx: ExtensionContext) => unknown,\n): void {\n  (pi.on as unknown as (event: string, handler: (event: E, ctx: ExtensionContext) => unknown) => void).call(\n    pi,\n    event,\n    handler,\n  );\n}\n\n/** A text block from an assistant message's content array. Narrowed structurally, not imported from `@earendil-works/pi-ai`, matching this file's habit of ad-hoc event-payload types (see `onEvent`'s own doc). */\ninterface AssistantTextBlock {\n  type: 'text';\n  text: string;\n}\n\n/** The subset of `AgentEndEvent`/message shape this file actually reads. */\ninterface DeliverableCheckMessage {\n  role?: string;\n  content?: unknown;\n}\n\nfunction isAssistantTextBlock(block: unknown): block is AssistantTextBlock {\n  return (\n    typeof block === 'object' &&\n    block !== null &&\n    (block as { type?: unknown }).type === 'text' &&\n    typeof (block as { text?: unknown }).text === 'string'\n  );\n}\n\n/**\n * The last non-empty assistant text found in `messages`, or `''`.\n *\n * `DeliverableGuardInput.summary` is checked for the `'summary'`-kind\n * expectation, and nothing in this package tracks a run's summary text\n * per-turn - `RunnerReporting` only computes one at the terminal\n * `mutateTerminalStatus` callback, which has not happened yet when a\n * mid-run deliverable check needs to run. The assistant's own most recent\n * text output is the best available proxy for \"what would this run's\n * summary be if it stopped now\" without a dedicated tracking mechanism this\n * package does not have yet. Best-effort by construction: an unparseable or\n * missing message reads as an empty summary, which is the SAFE failure\n * direction for this guard (nudging once more than strictly necessary,\n * never fewer times than necessary).\n */\nexport function extractAssistantSummaryText(messages: readonly DeliverableCheckMessage[]): string {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    const message = messages[index];\n    if (message?.role !== 'assistant' || !Array.isArray(message.content)) continue;\n    const text = message.content\n      .filter(isAssistantTextBlock)\n      .map((block) => block.text)\n      .join('\\n')\n      .trim();\n    if (text) return text;\n  }\n  return '';\n}\n\n/**\n * Wires `DeliverableGuard`'s write side into this process. See the module\n * doc's overall framing: everything else in the missing-deliverable chain\n * (detection, the single nudge, escalation, the fold into `status.json`,\n * `AsyncJobTracker`'s read and folded wait action already exist;\n * nothing called it. This is that call.\n *\n * WHY THIS RESOLVES ITS OWN CONTAINER, HERE:\n * `RunnerBootstrap`/`RunnerExecution`/`DeliverableGuard` are DI-bound\n * services (`container/modules/runs.ts`), and this file is the one place\n * `container/index.ts` documents as the in-child composition root\n * (`createPromptRuntimeContainer()`) - filed under `src/extensions/**`, the\n * boundary reserved for composition roots (see `vibe-lint.config.yaml`'s\n * `extensions` boundary), not under `src/runs/**` where it used to live. It\n * was moved here specifically so it could stop being the one exception\n * carved into the `runs` boundary's allowlist for `src/container/index.ts` -\n * a domain that can build its own container can bypass every composition\n * decision above it, and that hole is now closed rather than merely\n * documented. `container` is an optional parameter, defaulting to the real\n * container, purely so a test can supply one pre-loaded with fakes via\n * `container.rebind(...)` instead of standing up the real filesystem-backed\n * services.\n *\n * WHY `session_start` BOOTSTRAPS, AND WHY IT ONLY EVER RUNS ONCE:\n * `RunnerBootstrap.bootstrap()` is genuinely the FIRST real caller this\n * package has ever had for it - it opens `status.json`, wires\n * `TerminalPersistenceService`'s finalize callback, and writes the startup\n * handshake `SpawnHandshake.waitForHandshake()` on the parent side blocks\n * on. `RunnerExecution.start()` then begins watching the control inbox.\n * `ControlChannelWatcher` depends on `PollScheduler`\n * (`control-channel.ts:809`), which nothing in this package's runner\n * services ever calls `.start()` on by itself (see `pollScheduler.ts`'s own\n * AVOID note: \"a registered-but-unstarted PollScheduler never ticks\") - so\n * this starts it explicitly, once, alongside bootstrap. The `resolved` guard\n * makes a stray second `session_start` (nothing in this file's other\n * registrations assumes it fires only once) a no-op rather than a second\n * bootstrap of the same run.\n *\n * WHY `execution.start()` IS GIVEN AN `onSteer` HANDLER:\n * `DeliverableGuard.deliverNudge()` drops a nudge into this run's OWN\n * steer-requests queue via `requestAsyncSteer` (see that method's doc) and\n * calls it delivered once the write succeeds. But the write alone does not\n * reach the child: `ControlChannelWatcher`, wired up by `execution.start()`,\n * claims and commits (deletes) every request it finds in that queue whether\n * or not a handler is registered for it - found by testing this file\n * against the REAL `ControlChannelWatcher` rather than a fake with no side\n * effects, which is exactly the failure mode this task kept turning up\n * elsewhere (`createRunsModule()` never loaded into any root;\n * `PollScheduler.start()` never called). `onSteer` is the missing delivery\n * half: it reuses `formatSteerMessage`/`sendUserMessage`, the same\n * mechanism `registerSteeringInbox` already uses for its own, separate\n * steer queue, so a nudge actually lands in the child's conversation instead\n * of being silently claimed and discarded.\n *\n * WHY `agent_end`, NOT `turn_end`:\n * `agent_end`'s own event (`AgentEndEvent.messages`) carries the full\n * message history for this agent loop, which `extractAssistantSummaryText`\n * reads from - `turn_end` only carries the one message that ended that turn,\n * not the memory of what preceded it, and `DeliverableGuard`'s own doc\n * frames this check as \"end-of-turn or idle\", not \"every turn.\"\n *\n * `unansweredAsks` AND `memberId`:\n * Both come from this run's own bound `TeamMemberContext`, which\n * `RunnerBootstrap.bootstrap()` already holds (from registering as a team\n * member) and now returns on its result. `memberId` is `teamContext.memberId`\n * directly. `unansweredAsks` calls `pendingAsksAddressedTo(teamContext,\n * teamContext.memberId, now)` - see `deliverable-guard.ts`'s own AVOID\n * section for why `DeliverableGuard` cannot call that itself, and that\n * function's own doc for why it deliberately returns id/sender/time only,\n * never the question's text (this maps its result into a factual, non-\n * fabricated placeholder message rather than guessing at content it was\n * never given). A standalone run with no team root forwarded has no\n * `teamContext` at all, in which case both are simply omitted - narrower\n * than the real behaviour, never wider, matching every other gap in this\n * file when there is genuinely nothing to report rather than something\n * unknown to guess at.\n *\n * `session_start` ALSO RECORDS THIS RUN'S OWN SESSION FILE:\n * `ctx.sessionManager.getSessionFile()` is the only place in this process\n * that ever answers \"what is my own transcript path\" - see\n * `runnerReporting.ts`'s header for why the value has to come from here\n * (the child) rather than be derived by the parent. `RunnerReporting`\n * validates and retains it while `RunnerBootstrap` writes it before the\n * ready handshake. `getSessionFile()` can return `undefined` (no persisted\n * transcript for this run); that case is simply not recorded, the same\n * \"omit rather than guess\" shape as `unansweredAsks`/`teamContext` above.\n */\nexport function registerRunnerLifecycle(pi: ExtensionAPI, container: Container = createPromptRuntimeContainer()): void {\n  const runId = process.env[SUBAGENT_RUN_ID_ENV]?.trim();\n  if (!runId) return;\n\n  const pollScheduler = container.get<IPollScheduler>(DOOM_TEAM_TYPES.PollScheduler);\n  const bootstrap = container.get<IRunnerBootstrap>(DOOM_TEAM_TYPES.RunnerBootstrap);\n  const execution = container.get<IRunnerExecution>(DOOM_TEAM_TYPES.RunnerExecution);\n  const reporting = container.get<IRunnerReporting>(DOOM_TEAM_TYPES.RunnerReporting);\n\n  let resolved: { teamContext: TeamMemberContext | undefined } | undefined;\n  let cumulativeTokens: number | undefined;\n  let toolCount = 0;\n  const countedMessages = new WeakSet<object>();\n\n  onEvent(pi, 'session_start', (_event, ctx) => {\n    if (resolved) return;\n    pollScheduler.start();\n    const sessionFile = ctx.sessionManager.getSessionFile();\n    const recordedSessionFile = sessionFile ? reporting.recordSessionFile(sessionFile) : undefined;\n    const bootstrapped = bootstrap.bootstrap(runId, recordedSessionFile);\n    if (bootstrapped.teamContext) Object.assign(process.env, nativeTeamMemberEnvironment(bootstrapped.teamContext));\n    // `onSteer` is the delivery half of `DeliverableGuard.deliverNudge`'s\n    // write side (see `RunnerExecutionHandlers.onSteer`'s own doc, which\n    // cross-references it): `deliverNudge` drops a request into this run's\n    // OWN steer-requests queue via `requestAsyncSteer`, and\n    // `ControlChannelWatcher` (wired up by `execution.start()` below) claims\n    // it and calls this handler. Without it, `execution.start()` still\n    // claims and commits the nudge - `deliverNudge` reports\n    // `nudgeDelivered: true`, `status.json` still shows `needs_attention` -\n    // but the request is silently discarded before it ever reaches the\n    // child's own conversation. `formatSteerMessage`/`sendUserMessage` are\n    // the exact same delivery this file already uses for\n    // `registerSteeringInbox`'s separate queue.\n    execution.start(runId, {\n      onSteer: (request) => {\n        const sendUserMessage = (\n          pi as { sendUserMessage?: (content: string, options: { deliverAs: 'steer' }) => unknown }\n        ).sendUserMessage;\n        if (!sendUserMessage) {\n          acknowledgeRunnerSteer(request, 'failed', 'Child Pi session does not support sendUserMessage steering.');\n          return;\n        }\n        try {\n          sendUserMessage(formatSteerMessage(request), { deliverAs: 'steer' });\n          acknowledgeRunnerSteer(request, 'delivered', 'Pi accepted the correlated steering input.');\n        } catch (error) {\n          acknowledgeRunnerSteer(request, 'failed', error instanceof Error ? error.message : String(error));\n          throw error;\n        }\n      },\n    });\n    resolved = { teamContext: bootstrapped.teamContext };\n    execution.setActivity('working');\n  });\n\n  onEvent(pi, 'agent_start', () => {\n    if (resolved) execution.setActivity('working');\n  });\n  onEvent<{ message?: ChildTranscriptMessage }>(pi, 'message_end', (event) => {\n    if (!resolved || !event.message || typeof event.message !== 'object') return;\n    if (countedMessages.has(event.message)) return;\n    countedMessages.add(event.message);\n    const messageTokens = getMessageUsageTokens(event.message);\n    if (messageTokens === undefined) return;\n    cumulativeTokens = (cumulativeTokens ?? 0) + messageTokens;\n    execution.setProgress({ tokens: cumulativeTokens });\n  });\n  onEvent<{ toolName?: string; tool?: { name?: string }; args?: { action?: string } }>(\n    pi,\n    'tool_execution_start',\n    (event) => {\n      if (!resolved) return;\n      const toolName = event.toolName ?? event.tool?.name;\n      toolCount += 1;\n      execution.setProgress({\n        toolCount,\n        ...(typeof toolName === 'string' && toolName.length > 0 ? { currentTool: toolName } : {}),\n      });\n      execution.setActivity(\n        toolName === NATIVE_TEAM_TOOL_NAME && event.args?.action === 'ask' ? 'waiting_for_reply' : 'tool',\n      );\n    },\n  );\n  onEvent(pi, 'tool_execution_end', () => {\n    if (resolved) execution.setActivity('working');\n  });\n  onEvent<{ messages: DeliverableCheckMessage[] }>(pi, 'agent_end', (event) => {\n    if (!resolved) return; // session_start has not bootstrapped yet; nothing to report against.\n    execution.setActivity('finalizing');\n    const summary = extractAssistantSummaryText(event.messages);\n    execution.complete(true, summary);\n  });\n}\n\nconst PARENT_ONLY_CUSTOM_MESSAGE_TYPES = new Set([\n  'subagent-orchestration-instructions',\n  'subagent-slash-result',\n  'subagent-slash-text-result',\n  'subagent-notify',\n  'subagent_control_notice',\n  'subagent-control',\n  'subagent-control-notice',\n]);\nconst SUBAGENT_ORCHESTRATION_SKILL_NAME_PATTERN = /<name>\\s*pi-subagents\\s*<\\/name>/;\nconst PROJECT_CONTEXT_HEADER = '\\n\\n# Project Context\\n\\nProject-specific instructions and guidelines:\\n\\n';\nconst SKILLS_HEADER = '\\n\\nThe following skills provide specialized instructions for specific tasks.';\nconst DATE_HEADER = '\\nCurrent date:';\n\nfunction readBooleanEnv(name: string): boolean | undefined {\n  const value = process.env[name];\n  if (value === undefined) return undefined;\n  return value !== '0';\n}\n\nfunction readRequiredChildTools(): string[] | undefined {\n  const encoded = process.env[REQUIRED_CHILD_TOOLS_ENV]?.trim();\n  if (!encoded) return undefined;\n  const required = JSON.parse(encoded) as unknown;\n  if (!Array.isArray(required) || required.some((name) => typeof name !== 'string' || !name)) {\n    throw new Error(`Invalid ${REQUIRED_CHILD_TOOLS_ENV} payload.`);\n  }\n  return required;\n}\n\nfunction readMcpDirectChildTools(): string[] | undefined {\n  const encoded = process.env[MCP_DIRECT_CHILD_TOOLS_ENV]?.trim();\n  if (!encoded) return undefined;\n  try {\n    const tools = JSON.parse(encoded) as unknown;\n    if (!Array.isArray(tools) || tools.some((name) => typeof name !== 'string' || !name)) return undefined;\n    return tools;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction refreshChildToolDiagnostic(pi: ExtensionAPI): ChildToolDiagnostic | undefined {\n  const filePath = process.env[CHILD_TOOL_DIAGNOSTIC_PATH_ENV]?.trim();\n  const required = readRequiredChildTools();\n  if (!filePath || !required) return undefined;\n  const available = pi.getAllTools().map((tool) => tool.name);\n  return writeChildToolDiagnostic(\n    filePath,\n    required,\n    available,\n    process.env[SUBAGENT_CHILD_AGENT_ENV]?.trim(),\n    readMcpDirectChildTools(),\n  );\n}\n\nfunction findSectionEnd(prompt: string, startIndex: number, nextHeaders: string[]): number {\n  let endIndex = prompt.length;\n  for (const header of nextHeaders) {\n    const index = prompt.indexOf(header, startIndex);\n    if (index !== -1 && index < endIndex) {\n      endIndex = index;\n    }\n  }\n  return endIndex;\n}\n\nexport function stripProjectContext(prompt: string): string {\n  const startIndex = prompt.indexOf(PROJECT_CONTEXT_HEADER);\n  if (startIndex === -1) return prompt;\n  const endIndex = findSectionEnd(prompt, startIndex + PROJECT_CONTEXT_HEADER.length, [SKILLS_HEADER, DATE_HEADER]);\n  return `${prompt.slice(0, startIndex)}${prompt.slice(endIndex)}`;\n}\n\nexport function stripInheritedSkills(prompt: string): string {\n  const startIndex = prompt.indexOf(SKILLS_HEADER);\n  if (startIndex === -1) return prompt;\n  const endIndex = findSectionEnd(prompt, startIndex + SKILLS_HEADER.length, [DATE_HEADER]);\n  return `${prompt.slice(0, startIndex)}${prompt.slice(endIndex)}`;\n}\n\nexport function stripSubagentOrchestrationSkill(prompt: string): string {\n  return prompt\n    .replace(/\\n{0,2}<skill\\s+name=[\"']pi-subagents[\"'][^>]*>[\\s\\S]*?<\\/skill>\\n{0,2}/g, '\\n\\n')\n    .replace(/[ \\t]*<skill>\\s*[\\s\\S]*?<\\/skill>\\s*/g, (block) =>\n      SUBAGENT_ORCHESTRATION_SKILL_NAME_PATTERN.test(block) ? '' : block,\n    );\n}\n\nfunction stripChildBoundaryInstructions(prompt: string): string {\n  let rewritten = prompt;\n  for (const boundary of [CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS, CHILD_FANOUT_BOUNDARY_INSTRUCTIONS]) {\n    rewritten = rewritten.split(boundary).join('');\n  }\n  return rewritten.replace(/^(?:[ \\t]*\\r?\\n)+/, '');\n}\n\nexport function rewriteSubagentPrompt(\n  prompt: string,\n  options: { inheritProjectContext: boolean; inheritSkills: boolean; fanoutChild?: boolean },\n): string {\n  let rewritten = prompt;\n  if (!options.inheritProjectContext) {\n    rewritten = stripProjectContext(rewritten);\n  }\n  if (!options.inheritSkills) {\n    rewritten = stripInheritedSkills(rewritten);\n  }\n  rewritten = stripSubagentOrchestrationSkill(rewritten);\n  rewritten = stripChildBoundaryInstructions(rewritten);\n  const boundary = options.fanoutChild ? CHILD_FANOUT_BOUNDARY_INSTRUCTIONS : CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS;\n  const structured = process.env[STRUCTURED_OUTPUT_CAPTURE_ENV] ? `\\n\\n${STRUCTURED_OUTPUT_INSTRUCTIONS}` : '';\n  return `${boundary}${structured}\\n\\n${rewritten}`;\n}\n\nfunction isParentOnlySubagentMessage(message: unknown): boolean {\n  const m = message as { role?: string; customType?: string };\n  if (m?.role !== 'custom' || typeof m.customType !== 'string') return false;\n  return PARENT_ONLY_CUSTOM_MESSAGE_TYPES.has(m.customType);\n}\n\nfunction isSubagentToolResultMessage(message: unknown): boolean {\n  const m = message as { role?: string; toolName?: string };\n  return m?.role === 'toolResult' && m.toolName === 'subagent';\n}\n\nfunction isSubagentToolCallBlock(block: unknown): boolean {\n  const b = block as { type?: string; name?: string };\n  return b?.type === 'toolCall' && b.name === 'subagent';\n}\n\nfunction stripAssistantSubagentToolCallBlocks(message: unknown): unknown {\n  const m = message as { role?: string; content?: unknown };\n  if (m?.role !== 'assistant' || !Array.isArray(m.content)) return message;\n  const filteredContent = m.content.filter((block) => !isSubagentToolCallBlock(block));\n  if (filteredContent.length === m.content.length) return message;\n  if (filteredContent.length === 0) return undefined;\n  return { ...m, content: filteredContent };\n}\n\nexport function stripParentOnlySubagentMessages(messages: unknown[]): unknown[] {\n  const preserveCurrentFanoutToolHistory = process.env[SUBAGENT_FANOUT_CHILD_ENV] === '1';\n  let changed = false;\n  const filtered: unknown[] = [];\n  for (const message of messages) {\n    if (\n      isParentOnlySubagentMessage(message) ||\n      (!preserveCurrentFanoutToolHistory && isSubagentToolResultMessage(message))\n    ) {\n      changed = true;\n      continue;\n    }\n    const stripped = preserveCurrentFanoutToolHistory ? message : stripAssistantSubagentToolCallBlocks(message);\n    if (stripped === undefined) {\n      changed = true;\n      continue;\n    }\n    if (stripped !== message) changed = true;\n    filtered.push(stripped);\n  }\n  return changed ? filtered : messages;\n}\n\nexport function formatSteerMessage(request: SteerRequest): string {\n  return [\n    'Mid-run steering from the parent orchestrator:',\n    '',\n    request.message,\n    '',\n    'Incorporate this guidance at the next safe point. Do not restart the task unless the guidance explicitly asks you to.',\n  ].join('\\n');\n}\n\nfunction acknowledgeRunnerSteer(request: SteerRequest, state: 'delivered' | 'failed', message: string): void {\n  const ackDir = process.env[SUBAGENT_STEER_ACK_DIR_ENV]?.trim();\n  const childIndex = Number(process.env[SUBAGENT_CHILD_INDEX_ENV]);\n  if (!ackDir || !Number.isInteger(childIndex) || childIndex < 0) return;\n  writeSteerAckAt(steerAckPathFromDir(ackDir, request.id), {\n    requestId: request.id,\n    index: childIndex,\n    ts: Date.now(),\n    state,\n    message,\n  });\n}\n\nfunction registerToolBudget(\n  pi: ExtensionAPI,\n  budget: ResolvedToolBudget | undefined,\n  diagnostics: PromptRuntimeDiagnostics,\n): void {\n  if (!budget) return;\n  let toolCount = 0;\n  let softNudged = false;\n  const sendUserMessage = (pi as { sendUserMessage?: (content: string, options: { deliverAs: 'steer' }) => unknown })\n    .sendUserMessage;\n  onEvent<{ toolName?: string }>(pi, 'tool_call', (event) => {\n    const toolName = typeof event.toolName === 'string' ? event.toolName : 'tool';\n    toolCount++;\n    if (budget.soft !== undefined && toolCount >= budget.soft && !softNudged) {\n      softNudged = true;\n      try {\n        sendUserMessage?.(toolBudgetSoftNudge(budget, toolCount), { deliverAs: 'steer' });\n      } catch (error) {\n        // Advisory nudge only; the child's own output is what matters. Recorded\n        // rather than discarded so a host that never accepts steering is\n        // discoverable instead of silently dropping every nudge.\n        diagnostics.steerNudgeFailures += 1;\n        diagnostics.lastError = error;\n      }\n    }\n    if (!shouldBlockToolForBudget(budget, toolName, toolCount)) return undefined;\n    return { block: true, reason: toolBudgetBlockedMessage(budget, toolName, toolCount) };\n  });\n}\n\n/**\n * Deliver mid-run steer requests queued for THIS child (by fan-out index)\n * into its own session via `sendUserMessage`. See the module doc's FIX for\n * why this claims each request individually rather than batch-deleting.\n */\nexport function registerSteeringInbox(\n  pi: ExtensionAPI,\n  deps: {\n    watch?: typeof fs.watch;\n    nativeRealpath?: (filePath: string) => string;\n    diagnostics?: PromptRuntimeDiagnostics;\n  } = {},\n): void {\n  const diagnostics = deps.diagnostics ?? createPromptRuntimeDiagnostics();\n  const steerInbox = process.env[SUBAGENT_STEER_INBOX_ENV]?.trim();\n  if (!steerInbox) return;\n  const capabilityPath = process.env[SUBAGENT_STEER_CAPABILITY_ENV]?.trim();\n  const ackDir = process.env[SUBAGENT_STEER_ACK_DIR_ENV]?.trim();\n  const sendUserMessage = (pi as { sendUserMessage?: (content: string, options: { deliverAs: 'steer' }) => unknown })\n    .sendUserMessage;\n  const childIndex = Number(process.env[SUBAGENT_CHILD_INDEX_ENV]);\n  const pending = new Map<string, string[]>();\n  let disposed = false;\n  let flushing = false;\n  let started = false;\n  const canSteer = typeof sendUserMessage === 'function';\n  let watcher: fs.FSWatcher | undefined;\n  let interval: NodeJS.Timeout | undefined;\n\n  const acknowledge = (request: SteerRequest, state: 'delivered' | 'failed', message: string): void => {\n    if (!ackDir || !Number.isInteger(childIndex) || childIndex < 0) return;\n    writeSteerAckAt(steerAckPathFromDir(ackDir, request.id), {\n      requestId: request.id,\n      index: childIndex,\n      ts: Date.now(),\n      state,\n      message,\n    });\n  };\n  const publishCapability = (): void => {\n    if (!capabilityPath || !Number.isInteger(childIndex) || childIndex < 0) return;\n    writeSteerCapabilityAt(capabilityPath, {\n      index: childIndex,\n      pid: process.pid,\n      readyAt: Date.now(),\n      supported: canSteer,\n    });\n  };\n\n  const flush = (): void => {\n    if (disposed || flushing) return;\n    flushing = true;\n    try {\n      for (const claim of claimSteerRequestsFromDir(steerInbox)) {\n        if (!canSteer || typeof sendUserMessage !== 'function') {\n          acknowledge(claim.request, 'failed', 'Child Pi session does not support sendUserMessage steering.');\n          claim.commit();\n          continue;\n        }\n        const formatted = formatSteerMessage(claim.request);\n        const ids = pending.get(formatted) ?? [];\n        ids.push(claim.request.id);\n        pending.set(formatted, ids);\n        try {\n          sendUserMessage(formatted, { deliverAs: 'steer' });\n          claim.commit();\n        } catch (error) {\n          ids.pop();\n          if (ids.length === 0) pending.delete(formatted);\n          // Recoverable: this claim goes back to the queue for the next\n          // flush to retry, instead of being lost. See the module doc's FIX.\n          claim.release();\n          acknowledge(claim.request, 'failed', error instanceof Error ? error.message : String(error));\n        }\n      }\n    } finally {\n      flushing = false;\n    }\n  };\n  const onInput = (event: unknown): undefined => {\n    if (disposed || !event || typeof event !== 'object') return undefined;\n    const input = event as { source?: unknown; streamingBehavior?: unknown; text?: unknown; content?: unknown };\n    if (input.source !== 'extension' || input.streamingBehavior !== 'steer') return undefined;\n    const text =\n      typeof input.text === 'string' ? input.text : typeof input.content === 'string' ? input.content : undefined;\n    if (!text) return undefined;\n    const ids = pending.get(text);\n    const requestId = ids?.shift();\n    if (!requestId) return undefined;\n    if (ids?.length === 0) pending.delete(text);\n    acknowledge(\n      { type: 'steer', id: requestId, ts: Date.now(), message: text },\n      'delivered',\n      'Pi accepted the correlated steering input.',\n    );\n    return undefined;\n  };\n  const start = (): void => {\n    if (started || disposed) return;\n    try {\n      fs.mkdirSync(steerInbox, { recursive: true });\n      publishCapability();\n    } catch {\n      // No channel to report a startup failure on from inside the child;\n      // the parent observes a missing capability file and treats it as\n      // \"steering unsupported for this child\" on its own.\n      return;\n    }\n    started = true;\n    try {\n      watcher = (deps.watch ?? fs.watch)(resolveWatchPath(steerInbox, deps.nativeRealpath), () => flush());\n      watcher.on('error', (error) => {\n        // fs.watch emits on transient FS errors and the interval poll below\n        // keeps delivery live regardless, so this is not fatal. Recorded so a\n        // watch that fails on every event is distinguishable from a quiet inbox.\n        diagnostics.watchErrors += 1;\n        diagnostics.lastError = error;\n      });\n    } catch {\n      watcher = undefined;\n    }\n    interval = setInterval(flush, STEER_FLUSH_POLL_INTERVAL_MS);\n    interval.unref?.();\n  };\n  const activate = (): undefined => {\n    start();\n    flush();\n    return undefined;\n  };\n\n  // Register input before the watcher so an accepted extension input cannot race request dispatch.\n  onEvent(pi, 'input', onInput);\n  onEvent(pi, 'session_start', () => start());\n  for (const eventName of [\n    'message_start',\n    'message_update',\n    'message_end',\n    'tool_execution_start',\n    'tool_execution_end',\n    'turn_end',\n  ] as const) {\n    onEvent(pi, eventName, activate);\n  }\n  onEvent(pi, 'session_shutdown', () => {\n    disposed = true;\n    try {\n      watcher?.close();\n    } catch (error) {\n      // Best effort; the process is shutting down regardless. Still recorded,\n      // because a close that always fails is a leaked descriptor per run.\n      diagnostics.watchCloseFailures += 1;\n      diagnostics.lastError = error;\n    }\n    if (interval) clearInterval(interval);\n  });\n}\n\n/**\n * `diagnostics` is optional and defaults to a fresh object: the `.cts` entry\n * point calls this with a single argument (`pi`), matching the host contract\n * `resolveRuntimeExtensionPath` resolves onto every child's `--extension`\n * args, so that call keeps working unchanged. A caller that wants to observe\n * what this runtime absorbed - see `PromptRuntimeDiagnostics` - passes its\n * own object and keeps the reference; this function only ever mutates it, it\n * never owns or resets it.\n */\nexport function registerSubagentPromptRuntime(\n  pi: ExtensionAPI,\n  diagnostics: PromptRuntimeDiagnostics = createPromptRuntimeDiagnostics(),\n): void {\n  // First, before any scoped path is touched. Pi loads extensions through jiti\n  // with `moduleCache: false`, so this extension gets its OWN instance of\n  // `shared/paths.ts` - the scope the surrounding runner process adopted is not\n  // visible here, and has to be read from the environment again.\n  adoptSessionScopeFromEnv();\n  registerSteeringInbox(pi, { diagnostics });\n  registerToolBudget(\n    pi,\n    decodeToolBudgetEnv(process.env[TOOL_BUDGET_ENV], { allowZero: process.env[TOOL_BUDGET_ZERO_AUTH_ENV] === '1' }),\n    diagnostics,\n  );\n  // One container for this whole registration, not one built inside each\n  // resolver's own default parameter: this process has exactly one\n  // composition root (see container/index.ts and this function's own doc),\n  // and a second independent createPromptRuntimeContainer() call anywhere\n  // else in this function would silently mean two sets of \"singletons\" in\n  // one process, defeating the point of a shared container.\n  const container = createPromptRuntimeContainer();\n  registerRunnerLifecycle(pi, container);\n\n  const teamChannels = container.get<INativeTeamChannelService>(DOOM_TEAM_TYPES.NativeTeamChannelService);\n\n  onEvent(pi, 'session_start', () => {\n    const teamRuntime = teamChannels.createRuntime(pi);\n    teamRuntime.bindChildFromEnvironment();\n  });\n  onEvent(pi, 'agent_start', () => {\n    refreshChildToolDiagnostic(pi);\n  });\n  // `agent_end` intentionally does not drain outstanding work here. See the\n  // module doc's \"WHAT IS DELIBERATELY NOT WIRED YET\" for why.\n\n  const structuredOutputPath = process.env[STRUCTURED_OUTPUT_CAPTURE_ENV];\n  const structuredSchemaPath = process.env[STRUCTURED_OUTPUT_SCHEMA_ENV];\n  if (structuredOutputPath && structuredSchemaPath) {\n    const schema = JSON.parse(fs.readFileSync(structuredSchemaPath, 'utf-8')) as JsonSchemaObject;\n    const parameters = createStructuredOutputToolParameters(schema);\n    const validator = new StructuredOutputValidator();\n    const registerTool = (\n      pi.registerTool as unknown as (tool: {\n        name: string;\n        label: string;\n        description: string;\n        parameters: unknown;\n        execute: (_id: string, params: { value: unknown }) => Promise<unknown>;\n      }) => void\n    ).bind(pi);\n    registerTool({\n      name: 'structured_output',\n      label: 'Structured Output',\n      description: 'Submit the required final structured output for this subagent step. This terminates the step.',\n      parameters: parameters as never,\n      async execute(_id: string, params: { value: unknown }) {\n        const validation = await validator.validateValue(schema, params.value);\n        if (validation.status === 'invalid') {\n          throw new Error(`Structured output validation failed: ${validation.message}`);\n        }\n        fs.mkdirSync(path.dirname(structuredOutputPath), { recursive: true });\n        fs.writeFileSync(structuredOutputPath, JSON.stringify(params.value), { mode: 0o600 });\n        return {\n          content: [{ type: 'text', text: 'Structured output captured.' }],\n          details: { path: structuredOutputPath },\n          terminate: true,\n        };\n      },\n    });\n  }\n\n  onEvent<{ messages: unknown[] }>(pi, 'context', (event) => {\n    const messages = stripParentOnlySubagentMessages(event.messages);\n    if (messages === event.messages) return undefined;\n    return { messages };\n  });\n\n  onEvent<{ systemPrompt: string }>(pi, 'before_agent_start', async (event) => {\n    const intercomSessionName = process.env[SUBAGENT_INTERCOM_SESSION_NAME_ENV]?.trim();\n    if (intercomSessionName && typeof pi.setSessionName === 'function') {\n      pi.setSessionName(intercomSessionName);\n    }\n\n    const inheritProjectContext = readBooleanEnv(INHERIT_PROJECT_CONTEXT_ENV);\n    const inheritSkills = readBooleanEnv(INHERIT_SKILLS_ENV);\n    const fanoutChild = readBooleanEnv(SUBAGENT_FANOUT_CHILD_ENV);\n    let rewritten = event.systemPrompt;\n    if (inheritProjectContext !== undefined || inheritSkills !== undefined || fanoutChild !== undefined) {\n      rewritten = rewriteSubagentPrompt(event.systemPrompt, {\n        inheritProjectContext: inheritProjectContext ?? true,\n        inheritSkills: inheritSkills ?? true,\n        fanoutChild: fanoutChild === true,\n      });\n    }\n    if (rewritten === event.systemPrompt) return;\n    return { systemPrompt: rewritten };\n  });\n}\n"],"mappings":"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"}

package/dist/extensions/subagentPromptRuntime.d.cts

@@ -0,0 +1,58 @@
+import { Container } from "inversify";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+//#region src/extensions/subagentPromptRuntime.d.ts
+/**
+ * Failures this runtime absorbed rather than propagated.
+ *
+ * WHY RECORD RATHER THAN LOG:
+ * This module runs inside the spawned child, where stdout IS the child's
+ * captured transcript. Writing a diagnostic there would corrupt the very
+ * output the run exists to produce, so nothing here may reach stdio. But a
+ * discarded error is indistinguishable from one that never happened, and a
+ * watcher that fails on every event looks exactly like a quiet inbox. These
+ * counters are the compromise: cheap, bounded, and queryable by a caller that
+ * wants to know whether the child's steering path was actually healthy.
+ *
+ * WHY THIS IS CALLER-OWNED, NOT MODULE STATE:
+ * A module-level singleton here would be exactly the bug this package's "no
+ * module-level mutable state" rule exists to prevent - see
+ * `nativeTeamChannel.ts`'s header: "a second session in the same process
+ * cannot inherit the first one's [state]". `registerSubagentPromptRuntime`
+ * runs once per real child process, so a singleton would rarely matter in
+ * production, but every test in this file registers multiple independent
+ * runtimes in one process, and a shared singleton would leak counts between
+ * them silently. `createPromptRuntimeDiagnostics()` hands each registration
+ * its own object instead; the caller keeps the reference to read later, and
+ * a fresh registration is what "reset" means - there is no shared state left
+ * to reset.
+ *
+ * AVOID:
+ * - Adding a `console.*` here, on any path, for any reason
+ * - Treating a non-zero count as fatal; every one of these is a degraded-mode
+ *   path with a working fallback, which is why it was absorbed in the first place
+ * - Reintroducing a module-level instance of this. See the header above
+ */
+interface PromptRuntimeDiagnostics {
+  /** Advisory tool-budget nudges that could not be delivered to the child. */
+  steerNudgeFailures: number;
+  /** Errors emitted by the steer-inbox watcher. The interval poll covers these. */
+  watchErrors: number;
+  /** Failures closing the watcher during shutdown. */
+  watchCloseFailures: number;
+  /** The most recent absorbed failure, whichever kind it was. */
+  lastError?: unknown;
+}
+/**
+ * `diagnostics` is optional and defaults to a fresh object: the `.cts` entry
+ * point calls this with a single argument (`pi`), matching the host contract
+ * `resolveRuntimeExtensionPath` resolves onto every child's `--extension`
+ * args, so that call keeps working unchanged. A caller that wants to observe
+ * what this runtime absorbed - see `PromptRuntimeDiagnostics` - passes its
+ * own object and keeps the reference; this function only ever mutates it, it
+ * never owns or resets it.
+ */
+declare function registerSubagentPromptRuntime(pi: ExtensionAPI, diagnostics?: PromptRuntimeDiagnostics): void;
+//#endregion
+export { registerSubagentPromptRuntime };
+//# sourceMappingURL=subagentPromptRuntime.d.cts.map

package/dist/extensions/subagentPromptRuntime.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentPromptRuntime.d.cts","names":[],"sources":["../../src/extensions/subagentPromptRuntime.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAuIiB,wBAAA;;EAEf,kBAAA;;EAEA,WAAA;;EAEA,kBAAA;;EAEA,SAAA;AAAA;;;;;;;;;;iBA+pBc,6BAAA,CACd,EAAA,EAAI,YAAA,EACJ,WAAA,GAAa,wBAAA"}

package/dist/extensions/subagentPromptRuntime.d.mts

@@ -0,0 +1,58 @@
+import { Container } from "inversify";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+//#region src/extensions/subagentPromptRuntime.d.ts
+/**
+ * Failures this runtime absorbed rather than propagated.
+ *
+ * WHY RECORD RATHER THAN LOG:
+ * This module runs inside the spawned child, where stdout IS the child's
+ * captured transcript. Writing a diagnostic there would corrupt the very
+ * output the run exists to produce, so nothing here may reach stdio. But a
+ * discarded error is indistinguishable from one that never happened, and a
+ * watcher that fails on every event looks exactly like a quiet inbox. These
+ * counters are the compromise: cheap, bounded, and queryable by a caller that
+ * wants to know whether the child's steering path was actually healthy.
+ *
+ * WHY THIS IS CALLER-OWNED, NOT MODULE STATE:
+ * A module-level singleton here would be exactly the bug this package's "no
+ * module-level mutable state" rule exists to prevent - see
+ * `nativeTeamChannel.ts`'s header: "a second session in the same process
+ * cannot inherit the first one's [state]". `registerSubagentPromptRuntime`
+ * runs once per real child process, so a singleton would rarely matter in
+ * production, but every test in this file registers multiple independent
+ * runtimes in one process, and a shared singleton would leak counts between
+ * them silently. `createPromptRuntimeDiagnostics()` hands each registration
+ * its own object instead; the caller keeps the reference to read later, and
+ * a fresh registration is what "reset" means - there is no shared state left
+ * to reset.
+ *
+ * AVOID:
+ * - Adding a `console.*` here, on any path, for any reason
+ * - Treating a non-zero count as fatal; every one of these is a degraded-mode
+ *   path with a working fallback, which is why it was absorbed in the first place
+ * - Reintroducing a module-level instance of this. See the header above
+ */
+interface PromptRuntimeDiagnostics {
+  /** Advisory tool-budget nudges that could not be delivered to the child. */
+  steerNudgeFailures: number;
+  /** Errors emitted by the steer-inbox watcher. The interval poll covers these. */
+  watchErrors: number;
+  /** Failures closing the watcher during shutdown. */
+  watchCloseFailures: number;
+  /** The most recent absorbed failure, whichever kind it was. */
+  lastError?: unknown;
+}
+/**
+ * `diagnostics` is optional and defaults to a fresh object: the `.cts` entry
+ * point calls this with a single argument (`pi`), matching the host contract
+ * `resolveRuntimeExtensionPath` resolves onto every child's `--extension`
+ * args, so that call keeps working unchanged. A caller that wants to observe
+ * what this runtime absorbed - see `PromptRuntimeDiagnostics` - passes its
+ * own object and keeps the reference; this function only ever mutates it, it
+ * never owns or resets it.
+ */
+declare function registerSubagentPromptRuntime(pi: ExtensionAPI, diagnostics?: PromptRuntimeDiagnostics): void;
+//#endregion
+export { registerSubagentPromptRuntime };
+//# sourceMappingURL=subagentPromptRuntime.d.mts.map

package/dist/extensions/subagentPromptRuntime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentPromptRuntime.d.mts","names":[],"sources":["../../src/extensions/subagentPromptRuntime.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAuIiB,wBAAA;;EAEf,kBAAA;;EAEA,WAAA;;EAEA,kBAAA;;EAEA,SAAA;AAAA;;;;;;;;;;iBA+pBc,6BAAA,CACd,EAAA,EAAI,YAAA,EACJ,WAAA,GAAa,wBAAA"}

package/dist/extensions/subagentPromptRuntime.mjs

@@ -0,0 +1,18 @@
+import{__esmMin as e}from"../_virtual/_rolldown/runtime.mjs";import{init_configDir as t,resolveWatchPath as n}from"../shared/configDir.mjs";import{CHILD_TOOL_DIAGNOSTIC_PATH_ENV as r,INHERIT_PROJECT_CONTEXT_ENV as i,INHERIT_SKILLS_ENV as a,MCP_DIRECT_CHILD_TOOLS_ENV as o,REQUIRED_CHILD_TOOLS_ENV as s,STRUCTURED_OUTPUT_CAPTURE_ENV as c,STRUCTURED_OUTPUT_SCHEMA_ENV as l,SUBAGENT_CHILD_AGENT_ENV as u,SUBAGENT_CHILD_INDEX_ENV as d,SUBAGENT_FANOUT_CHILD_ENV as f,SUBAGENT_INTERCOM_SESSION_NAME_ENV as p,SUBAGENT_RUN_ID_ENV as m,SUBAGENT_STEER_ACK_DIR_ENV as h,SUBAGENT_STEER_CAPABILITY_ENV as g,SUBAGENT_STEER_INBOX_ENV as ee,TOOL_BUDGET_ENV as _,TOOL_BUDGET_ZERO_AUTH_ENV as v,init_env as y}from"../env.mjs";import{DOOM_TEAM_TYPES as b}from"../container/types.mjs";import{claimSteerRequestsFromDir as x,init_supervisorControlChannel as S,steerAckPathFromDir as C,writeSteerAckAt as w,writeSteerCapabilityAt as te}from"../intercom/supervisorControlChannel.mjs";import{adoptSessionScopeFromEnv as T,init_paths as E}from"../shared/paths.mjs";import{init_nativeTeamChannel as D,nativeTeamMemberEnvironment as O}from"../intercom/nativeTeamChannel.mjs";import{decodeToolBudgetEnv as ne,init_toolBudget as re,shouldBlockToolForBudget as ie,toolBudgetBlockedMessage as k,toolBudgetSoftNudge as ae}from"../runs/shared/toolBudget.mjs";import{createPromptRuntimeContainer as A,init_container as oe}from"../container/index.mjs";import{getMessageUsageTokens as se,init_childTranscript as ce}from"../shared/childTranscript.mjs";import{StructuredOutputValidator as le,createStructuredOutputToolParameters as ue,init_structuredOutput as de}from"../runs/shared/structuredOutput.mjs";import{init_toolAvailability as fe,writeChildToolDiagnostic as pe}from"../runs/shared/toolAvailability.mjs";import*as j from"node:fs";import*as M from"node:path";function N(){return{steerNudgeFailures:0,watchErrors:0,watchCloseFailures:0}}function P(e,t,n){e.on.call(e,t,n)}function F(e){return typeof e==`object`&&!!e&&e.type===`text`&&typeof e.text==`string`}function I(e){for(let t=e.length-1;t>=0;--t){let n=e[t];if(n?.role!==`assistant`||!Array.isArray(n.content))continue;let r=n.content.filter(F).map(e=>e.text).join(`
+`).trim();if(r)return r}return``}function L(e,t=A()){let n=process.env[m]?.trim();if(!n)return;let r=t.get(b.PollScheduler),i=t.get(b.RunnerBootstrap),a=t.get(b.RunnerExecution),o=t.get(b.RunnerReporting),s,c,l=0,u=new WeakSet;P(e,`session_start`,(t,c)=>{if(s)return;r.start();let l=c.sessionManager.getSessionFile(),u=l?o.recordSessionFile(l):void 0,d=i.bootstrap(n,u);d.teamContext&&Object.assign(process.env,O(d.teamContext)),a.start(n,{onSteer:t=>{let n=e.sendUserMessage;if(!n){U(t,`failed`,`Child Pi session does not support sendUserMessage steering.`);return}try{n(H(t),{deliverAs:`steer`}),U(t,`delivered`,`Pi accepted the correlated steering input.`)}catch(e){throw U(t,`failed`,e instanceof Error?e.message:String(e)),e}}}),s={teamContext:d.teamContext},a.setActivity(`working`)}),P(e,`agent_start`,()=>{s&&a.setActivity(`working`)}),P(e,`message_end`,e=>{if(!s||!e.message||typeof e.message!=`object`||u.has(e.message))return;u.add(e.message);let t=se(e.message);t!==void 0&&(c=(c??0)+t,a.setProgress({tokens:c}))}),P(e,`tool_execution_start`,e=>{if(!s)return;let t=e.toolName??e.tool?.name;l+=1,a.setProgress({toolCount:l,...typeof t==`string`&&t.length>0?{currentTool:t}:{}}),a.setActivity(t===`intercom`&&e.args?.action===`ask`?`waiting_for_reply`:`tool`)}),P(e,`tool_execution_end`,()=>{s&&a.setActivity(`working`)}),P(e,`agent_end`,e=>{if(!s)return;a.setActivity(`finalizing`);let t=I(e.messages);a.complete(!0,t)})}function R(e){let t=process.env[e];if(t!==void 0)return t!==`0`}function z(){let e=process.env[s]?.trim();if(!e)return;let t=JSON.parse(e);if(!Array.isArray(t)||t.some(e=>typeof e!=`string`||!e))throw Error(`Invalid ${s} payload.`);return t}function B(){let e=process.env[o]?.trim();if(e)try{let t=JSON.parse(e);return!Array.isArray(t)||t.some(e=>typeof e!=`string`||!e)?void 0:t}catch{return}}function me(e){let t=process.env[r]?.trim(),n=z();if(!(!t||!n))return pe(t,n,e.getAllTools().map(e=>e.name),process.env[u]?.trim(),B())}function V(e,t,n){let r=e.length;for(let i of n){let n=e.indexOf(i,t);n!==-1&&n<r&&(r=n)}return r}function he(e){let t=e.indexOf(X);if(t===-1)return e;let n=V(e,t+68,[Z,Q]);return`${e.slice(0,t)}${e.slice(n)}`}function ge(e){let t=e.indexOf(Z);if(t===-1)return e;let n=V(e,t+75,[Q]);return`${e.slice(0,t)}${e.slice(n)}`}function _e(e){return e.replace(/\n{0,2}<skill\s+name=["']pi-subagents["'][^>]*>[\s\S]*?<\/skill>\n{0,2}/g,`
+
+`).replace(/[ \t]*<skill>\s*[\s\S]*?<\/skill>\s*/g,e=>Y.test(e)?``:e)}function ve(e){let t=e;for(let e of[K,q])t=t.split(e).join(``);return t.replace(/^(?:[ \t]*\r?\n)+/,``)}function ye(e,t){let n=e;return t.inheritProjectContext||(n=he(n)),t.inheritSkills||(n=ge(n)),n=_e(n),n=ve(n),`${t.fanoutChild?q:K}${process.env.PI_SUBAGENT_STRUCTURED_OUTPUT_CAPTURE?`\n\n${G}`:``}\n\n${n}`}function be(e){let t=e;return t?.role!==`custom`||typeof t.customType!=`string`?!1:J.has(t.customType)}function xe(e){let t=e;return t?.role===`toolResult`&&t.toolName===`subagent`}function Se(e){let t=e;return t?.type===`toolCall`&&t.name===`subagent`}function Ce(e){let t=e;if(t?.role!==`assistant`||!Array.isArray(t.content))return e;let n=t.content.filter(e=>!Se(e));if(n.length===t.content.length)return e;if(n.length!==0)return{...t,content:n}}function we(e){let t=process.env[f]===`1`,n=!1,r=[];for(let i of e){if(be(i)||!t&&xe(i)){n=!0;continue}let e=t?i:Ce(i);if(e===void 0){n=!0;continue}e!==i&&(n=!0),r.push(e)}return n?r:e}function H(e){return[`Mid-run steering from the parent orchestrator:`,``,e.message,``,`Incorporate this guidance at the next safe point. Do not restart the task unless the guidance explicitly asks you to.`].join(`
+`)}function U(e,t,n){let r=process.env[h]?.trim(),i=Number(process.env[d]);!r||!Number.isInteger(i)||i<0||w(C(r,e.id),{requestId:e.id,index:i,ts:Date.now(),state:t,message:n})}function Te(e,t,n){if(!t)return;let r=0,i=!1,a=e.sendUserMessage;P(e,`tool_call`,e=>{let o=typeof e.toolName==`string`?e.toolName:`tool`;if(r++,t.soft!==void 0&&r>=t.soft&&!i){i=!0;try{a?.(ae(t,r),{deliverAs:`steer`})}catch(e){n.steerNudgeFailures+=1,n.lastError=e}}if(ie(t,o,r))return{block:!0,reason:k(t,o,r)}})}function Ee(e,t={}){let r=t.diagnostics??N(),i=process.env[ee]?.trim();if(!i)return;let a=process.env[g]?.trim(),o=process.env[h]?.trim(),s=e.sendUserMessage,c=Number(process.env[d]),l=new Map,u=!1,f=!1,p=!1,m=typeof s==`function`,_,v,y=(e,t,n)=>{!o||!Number.isInteger(c)||c<0||w(C(o,e.id),{requestId:e.id,index:c,ts:Date.now(),state:t,message:n})},b=()=>{!a||!Number.isInteger(c)||c<0||te(a,{index:c,pid:process.pid,readyAt:Date.now(),supported:m})},S=()=>{if(!(u||f)){f=!0;try{for(let e of x(i)){if(!m||typeof s!=`function`){y(e.request,`failed`,`Child Pi session does not support sendUserMessage steering.`),e.commit();continue}let t=H(e.request),n=l.get(t)??[];n.push(e.request.id),l.set(t,n);try{s(t,{deliverAs:`steer`}),e.commit()}catch(r){n.pop(),n.length===0&&l.delete(t),e.release(),y(e.request,`failed`,r instanceof Error?r.message:String(r))}}}finally{f=!1}}},T=e=>{if(u||!e||typeof e!=`object`)return;let t=e;if(t.source!==`extension`||t.streamingBehavior!==`steer`)return;let n=typeof t.text==`string`?t.text:typeof t.content==`string`?t.content:void 0;if(!n)return;let r=l.get(n),i=r?.shift();i&&(r?.length===0&&l.delete(n),y({type:`steer`,id:i,ts:Date.now(),message:n},`delivered`,`Pi accepted the correlated steering input.`))},E=()=>{if(!(p||u)){try{j.mkdirSync(i,{recursive:!0}),b()}catch{return}p=!0;try{_=(t.watch??j.watch)(n(i,t.nativeRealpath),()=>S()),_.on(`error`,e=>{r.watchErrors+=1,r.lastError=e})}catch{_=void 0}v=setInterval(S,W),v.unref?.()}},D=()=>{E(),S()};P(e,`input`,T),P(e,`session_start`,()=>E());for(let t of[`message_start`,`message_update`,`message_end`,`tool_execution_start`,`tool_execution_end`,`turn_end`])P(e,t,D);P(e,`session_shutdown`,()=>{u=!0;try{_?.close()}catch(e){r.watchCloseFailures+=1,r.lastError=e}v&&clearInterval(v)})}function De(e,t=N()){T(),Ee(e,{diagnostics:t}),Te(e,ne(process.env[_],{allowZero:process.env[v]===`1`}),t);let n=A();L(e,n);let r=n.get(b.NativeTeamChannelService);P(e,`session_start`,()=>{r.createRuntime(e).bindChildFromEnvironment()}),P(e,`agent_start`,()=>{me(e)});let o=process.env[c],s=process.env[l];if(o&&s){let t=JSON.parse(j.readFileSync(s,`utf-8`)),n=ue(t),r=new le;e.registerTool.bind(e)({name:`structured_output`,label:`Structured Output`,description:`Submit the required final structured output for this subagent step. This terminates the step.`,parameters:n,async execute(e,n){let i=await r.validateValue(t,n.value);if(i.status===`invalid`)throw Error(`Structured output validation failed: ${i.message}`);return j.mkdirSync(M.dirname(o),{recursive:!0}),j.writeFileSync(o,JSON.stringify(n.value),{mode:384}),{content:[{type:`text`,text:`Structured output captured.`}],details:{path:o},terminate:!0}}})}P(e,`context`,e=>{let t=we(e.messages);if(t!==e.messages)return{messages:t}}),P(e,`before_agent_start`,async t=>{let n=process.env[p]?.trim();n&&typeof e.setSessionName==`function`&&e.setSessionName(n);let r=R(i),o=R(a),s=R(f),c=t.systemPrompt;if((r!==void 0||o!==void 0||s!==void 0)&&(c=ye(t.systemPrompt,{inheritProjectContext:r??!0,inheritSkills:o??!0,fanoutChild:s===!0})),c!==t.systemPrompt)return{systemPrompt:c}})}var W,G,K,q,J,Y,X,Z,Q,$=e((()=>{oe(),y(),D(),t(),ce(),E(),S(),de(),fe(),re(),W=250,G=[`This subagent step has a strict structured output contract.`,"Your final action must be to call the `structured_output` tool with JSON matching the provided schema.","Do not rely on prose-only completion; if you do not call `structured_output`, the parent will fail this step."].join(`
+`),K=[`You are a child subagent, not the parent orchestrator.`,`The parent session owns delegation, orchestration, review fanout, and follow-up worker launches.`,`Ignore prior parent-only orchestration instructions in inherited conversation history.`,`Do not propose or run subagents. Complete only your assigned role-specific task with the tools available to you.`,`If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.`].join(`
+`),q=[`You are a child subagent with explicit fanout responsibility for this assigned task.`,`The parent session owns final orchestration, acceptance, and follow-up implementation launches.`,"You may use the `subagent` tool only for the fanout work explicitly requested in this task.",`Do not broaden yourself into general parent orchestration. Do not launch follow-up workers unless the task explicitly asks for that.`,`The maxSubagentDepth cap still applies and may block further fanout.`,`If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.`].join(`
+`),J=new Set([`subagent-orchestration-instructions`,`subagent-slash-result`,`subagent-slash-text-result`,`subagent-notify`,`subagent_control_notice`,`subagent-control`,`subagent-control-notice`]),Y=/<name>\s*pi-subagents\s*<\/name>/,X=`
+
+# Project Context
+
+Project-specific instructions and guidelines:
+
+`,Z=`
+
+The following skills provide specialized instructions for specific tasks.`,Q=`
+Current date:`}));$();export{$ as init_subagentPromptRuntime,De as registerSubagentPromptRuntime};
+//# sourceMappingURL=subagentPromptRuntime.mjs.map

package/dist/extensions/subagentPromptRuntime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentPromptRuntime.mjs","names":[],"sources":["../../src/extensions/subagentPromptRuntime.ts"],"sourcesContent":["/**\n * The extension loaded INSIDE every spawned child: prompt rewriting,\n * mid-run steering delivery, the tool-call budget, native supervisor/team\n * messaging, and the `structured_output` tool.\n *\n * WHY THIS RUNS IN A DIFFERENT WORLD THAN EVERYTHING ELSE PORTED SO FAR:\n * Every other module in this package runs in the parent or the runner\n * process. This one is loaded BY the child's own Pi process\n * (`piArgs.ts`'s `resolveRuntimeExtensionPath` resolves it onto the\n * child's `--extension` args). The child's stdout IS its captured\n * transcript - a stray console write here does not go to a developer's\n * terminal, it becomes part of the child's output. Nothing in this file\n * writes to the console, ever; a failure that would have been\n * logged elsewhere is swallowed with a comment when there is no safe channel\n * to report it.\n *\n * FIX (claim-by-rename for the per-child steer inbox):\n * The predecessor's `registerSteeringInbox` called\n * `consumeSteerRequestsFromDir`, which deletes every queued request before\n * attempting delivery, then manually re-queued whatever it had not yet\n * attempted (`requests.slice(index + 1)`) if `sendUserMessage` threw\n * partway through a batch - but the request that was actually attempted\n * when the throw happened was already gone, lost the same way FIX 1 in\n * `control-channel.ts` was written to close for the runner-side steer\n * queue. This module's `flush()` uses `claimSteerRequestsFromDir` (already\n * exported from `control-channel.ts`, directory-agnostic) instead: each\n * request is claimed individually, and a failed `sendUserMessage` call\n * calls `release()` on that one claim so it is retried on the next flush,\n * while every OTHER claim in the same batch is still committed or released\n * independently. That is also a behavioural improvement over the\n * predecessor's `break`-on-first-failure, which abandoned the rest of a\n * batch rather than giving each message its own outcome - the same\n * per-item independence `ControlChannelWatcher.check()` already applies on\n * the runner side.\n *\n * Child runtimes keep the native team transport for lifecycle and result\n * delivery, but model-visible coordination tools are filtered by the selected\n * layer policy. They never register the root orchestration tool or a separate\n * wait alias.\n *\n * AVOID:\n * - Writing to the console. See the header above\n * - Reintroducing the predecessor's \"delete the whole batch, dispatch,\n *   re-queue what failed\" shape for the steer inbox. See the FIX above\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { Container } from 'inversify';\nimport type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\n\nimport { createPromptRuntimeContainer, DOOM_TEAM_TYPES } from '../container/index.ts';\nimport {\n  CHILD_TOOL_DIAGNOSTIC_PATH_ENV,\n  INHERIT_PROJECT_CONTEXT_ENV,\n  INHERIT_SKILLS_ENV,\n  MCP_DIRECT_CHILD_TOOLS_ENV,\n  REQUIRED_CHILD_TOOLS_ENV,\n  STRUCTURED_OUTPUT_CAPTURE_ENV,\n  STRUCTURED_OUTPUT_SCHEMA_ENV,\n  SUBAGENT_CHILD_AGENT_ENV,\n  SUBAGENT_CHILD_INDEX_ENV,\n  SUBAGENT_FANOUT_CHILD_ENV,\n  SUBAGENT_INTERCOM_SESSION_NAME_ENV,\n  SUBAGENT_RUN_ID_ENV,\n  SUBAGENT_STEER_ACK_DIR_ENV,\n  SUBAGENT_STEER_CAPABILITY_ENV,\n  SUBAGENT_STEER_INBOX_ENV,\n  TOOL_BUDGET_ENV,\n  TOOL_BUDGET_ZERO_AUTH_ENV,\n} from '../env.ts';\nimport {\n  type INativeTeamChannelService,\n  NATIVE_TEAM_TOOL_NAME,\n  nativeTeamMemberEnvironment,\n  type TeamMemberContext,\n} from '../intercom/nativeTeamChannel.ts';\nimport { resolveWatchPath } from '../shared/configDir.ts';\nimport { getMessageUsageTokens, type ChildTranscriptMessage } from '../shared/childTranscript.ts';\nimport { adoptSessionScopeFromEnv } from '../shared/paths.ts';\nimport type { JsonSchemaObject } from '../types.ts';\nimport {\n  claimSteerRequestsFromDir,\n  steerAckPathFromDir,\n  writeSteerAckAt,\n  writeSteerCapabilityAt,\n  type SteerRequest,\n} from '../intercom/supervisorControlChannel.ts';\nimport type { IPollScheduler } from '../shared/pollScheduler.ts';\nimport type { IRunnerBootstrap } from '../runs/background/runnerBootstrap.ts';\nimport type { IRunnerExecution } from '../runs/background/runnerExecution.ts';\nimport type { IRunnerReporting } from '../runs/background/runnerReporting.ts';\nimport { createStructuredOutputToolParameters, StructuredOutputValidator } from '../runs/shared/structuredOutput.ts';\nimport { writeChildToolDiagnostic, type ChildToolDiagnostic } from '../runs/shared/toolAvailability.ts';\nimport {\n  decodeToolBudgetEnv,\n  shouldBlockToolForBudget,\n  toolBudgetBlockedMessage,\n  toolBudgetSoftNudge,\n} from '../runs/shared/toolBudget.ts';\nimport type { ResolvedToolBudget } from '../runs/shared/toolBudget.ts';\n\nconst STEER_FLUSH_POLL_INTERVAL_MS = 250;\n\n/**\n * Failures this runtime absorbed rather than propagated.\n *\n * WHY RECORD RATHER THAN LOG:\n * This module runs inside the spawned child, where stdout IS the child's\n * captured transcript. Writing a diagnostic there would corrupt the very\n * output the run exists to produce, so nothing here may reach stdio. But a\n * discarded error is indistinguishable from one that never happened, and a\n * watcher that fails on every event looks exactly like a quiet inbox. These\n * counters are the compromise: cheap, bounded, and queryable by a caller that\n * wants to know whether the child's steering path was actually healthy.\n *\n * WHY THIS IS CALLER-OWNED, NOT MODULE STATE:\n * A module-level singleton here would be exactly the bug this package's \"no\n * module-level mutable state\" rule exists to prevent - see\n * `nativeTeamChannel.ts`'s header: \"a second session in the same process\n * cannot inherit the first one's [state]\". `registerSubagentPromptRuntime`\n * runs once per real child process, so a singleton would rarely matter in\n * production, but every test in this file registers multiple independent\n * runtimes in one process, and a shared singleton would leak counts between\n * them silently. `createPromptRuntimeDiagnostics()` hands each registration\n * its own object instead; the caller keeps the reference to read later, and\n * a fresh registration is what \"reset\" means - there is no shared state left\n * to reset.\n *\n * AVOID:\n * - Adding a `console.*` here, on any path, for any reason\n * - Treating a non-zero count as fatal; every one of these is a degraded-mode\n *   path with a working fallback, which is why it was absorbed in the first place\n * - Reintroducing a module-level instance of this. See the header above\n */\nexport interface PromptRuntimeDiagnostics {\n  /** Advisory tool-budget nudges that could not be delivered to the child. */\n  steerNudgeFailures: number;\n  /** Errors emitted by the steer-inbox watcher. The interval poll covers these. */\n  watchErrors: number;\n  /** Failures closing the watcher during shutdown. */\n  watchCloseFailures: number;\n  /** The most recent absorbed failure, whichever kind it was. */\n  lastError?: unknown;\n}\n\n/** A fresh, zeroed diagnostics object for one registration. See the interface doc for why this is not a singleton. */\nexport function createPromptRuntimeDiagnostics(): PromptRuntimeDiagnostics {\n  return { steerNudgeFailures: 0, watchErrors: 0, watchCloseFailures: 0 };\n}\n\nconst STRUCTURED_OUTPUT_INSTRUCTIONS = [\n  'This subagent step has a strict structured output contract.',\n  'Your final action must be to call the `structured_output` tool with JSON matching the provided schema.',\n  'Do not rely on prose-only completion; if you do not call `structured_output`, the parent will fail this step.',\n].join('\\n');\n\nexport const CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS = [\n  'You are a child subagent, not the parent orchestrator.',\n  'The parent session owns delegation, orchestration, review fanout, and follow-up worker launches.',\n  'Ignore prior parent-only orchestration instructions in inherited conversation history.',\n  'Do not propose or run subagents. Complete only your assigned role-specific task with the tools available to you.',\n  'If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.',\n].join('\\n');\n\nexport const CHILD_FANOUT_BOUNDARY_INSTRUCTIONS = [\n  'You are a child subagent with explicit fanout responsibility for this assigned task.',\n  'The parent session owns final orchestration, acceptance, and follow-up implementation launches.',\n  'You may use the `subagent` tool only for the fanout work explicitly requested in this task.',\n  'Do not broaden yourself into general parent orchestration. Do not launch follow-up workers unless the task explicitly asks for that.',\n  'The maxSubagentDepth cap still applies and may block further fanout.',\n  'If you need to edit files, use the available editing tools. Do not print tool-call syntax, patches, or pseudo-tool calls as text.',\n].join('\\n');\n\n/**\n * `pi.on` typed loosely: the extension API's event payloads are not typed\n * per event name, so every call site narrows its own handler's parameter.\n * `.call(pi, ...)` binds `this` explicitly rather than extracting `pi.on` as\n * a bare reference, which is what an unbound method call would otherwise risk.\n *\n * The handler is given `ctx: ExtensionContext` as a second parameter,\n * matching the real `pi.on` signature (`ExtensionHandler<E, R> = (event: E,\n * ctx: ExtensionContext) => ...`) even though most registrations here never\n * read it - existing single-parameter handlers stay valid without change\n * (JS ignores a callback's unused trailing parameters), and the one call\n * site that DOES need it (`session_start`, for `ctx.sessionManager` - see\n * `registerDeliverableGuardCheck`'s doc) no longer has to reach past this\n * wrapper to get it.\n */\nfunction onEvent<E = unknown>(\n  pi: ExtensionAPI,\n  event: string,\n  handler: (event: E, ctx: ExtensionContext) => unknown,\n): void {\n  (pi.on as unknown as (event: string, handler: (event: E, ctx: ExtensionContext) => unknown) => void).call(\n    pi,\n    event,\n    handler,\n  );\n}\n\n/** A text block from an assistant message's content array. Narrowed structurally, not imported from `@earendil-works/pi-ai`, matching this file's habit of ad-hoc event-payload types (see `onEvent`'s own doc). */\ninterface AssistantTextBlock {\n  type: 'text';\n  text: string;\n}\n\n/** The subset of `AgentEndEvent`/message shape this file actually reads. */\ninterface DeliverableCheckMessage {\n  role?: string;\n  content?: unknown;\n}\n\nfunction isAssistantTextBlock(block: unknown): block is AssistantTextBlock {\n  return (\n    typeof block === 'object' &&\n    block !== null &&\n    (block as { type?: unknown }).type === 'text' &&\n    typeof (block as { text?: unknown }).text === 'string'\n  );\n}\n\n/**\n * The last non-empty assistant text found in `messages`, or `''`.\n *\n * `DeliverableGuardInput.summary` is checked for the `'summary'`-kind\n * expectation, and nothing in this package tracks a run's summary text\n * per-turn - `RunnerReporting` only computes one at the terminal\n * `mutateTerminalStatus` callback, which has not happened yet when a\n * mid-run deliverable check needs to run. The assistant's own most recent\n * text output is the best available proxy for \"what would this run's\n * summary be if it stopped now\" without a dedicated tracking mechanism this\n * package does not have yet. Best-effort by construction: an unparseable or\n * missing message reads as an empty summary, which is the SAFE failure\n * direction for this guard (nudging once more than strictly necessary,\n * never fewer times than necessary).\n */\nexport function extractAssistantSummaryText(messages: readonly DeliverableCheckMessage[]): string {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    const message = messages[index];\n    if (message?.role !== 'assistant' || !Array.isArray(message.content)) continue;\n    const text = message.content\n      .filter(isAssistantTextBlock)\n      .map((block) => block.text)\n      .join('\\n')\n      .trim();\n    if (text) return text;\n  }\n  return '';\n}\n\n/**\n * Wires `DeliverableGuard`'s write side into this process. See the module\n * doc's overall framing: everything else in the missing-deliverable chain\n * (detection, the single nudge, escalation, the fold into `status.json`,\n * `AsyncJobTracker`'s read and folded wait action already exist;\n * nothing called it. This is that call.\n *\n * WHY THIS RESOLVES ITS OWN CONTAINER, HERE:\n * `RunnerBootstrap`/`RunnerExecution`/`DeliverableGuard` are DI-bound\n * services (`container/modules/runs.ts`), and this file is the one place\n * `container/index.ts` documents as the in-child composition root\n * (`createPromptRuntimeContainer()`) - filed under `src/extensions/**`, the\n * boundary reserved for composition roots (see `vibe-lint.config.yaml`'s\n * `extensions` boundary), not under `src/runs/**` where it used to live. It\n * was moved here specifically so it could stop being the one exception\n * carved into the `runs` boundary's allowlist for `src/container/index.ts` -\n * a domain that can build its own container can bypass every composition\n * decision above it, and that hole is now closed rather than merely\n * documented. `container` is an optional parameter, defaulting to the real\n * container, purely so a test can supply one pre-loaded with fakes via\n * `container.rebind(...)` instead of standing up the real filesystem-backed\n * services.\n *\n * WHY `session_start` BOOTSTRAPS, AND WHY IT ONLY EVER RUNS ONCE:\n * `RunnerBootstrap.bootstrap()` is genuinely the FIRST real caller this\n * package has ever had for it - it opens `status.json`, wires\n * `TerminalPersistenceService`'s finalize callback, and writes the startup\n * handshake `SpawnHandshake.waitForHandshake()` on the parent side blocks\n * on. `RunnerExecution.start()` then begins watching the control inbox.\n * `ControlChannelWatcher` depends on `PollScheduler`\n * (`control-channel.ts:809`), which nothing in this package's runner\n * services ever calls `.start()` on by itself (see `pollScheduler.ts`'s own\n * AVOID note: \"a registered-but-unstarted PollScheduler never ticks\") - so\n * this starts it explicitly, once, alongside bootstrap. The `resolved` guard\n * makes a stray second `session_start` (nothing in this file's other\n * registrations assumes it fires only once) a no-op rather than a second\n * bootstrap of the same run.\n *\n * WHY `execution.start()` IS GIVEN AN `onSteer` HANDLER:\n * `DeliverableGuard.deliverNudge()` drops a nudge into this run's OWN\n * steer-requests queue via `requestAsyncSteer` (see that method's doc) and\n * calls it delivered once the write succeeds. But the write alone does not\n * reach the child: `ControlChannelWatcher`, wired up by `execution.start()`,\n * claims and commits (deletes) every request it finds in that queue whether\n * or not a handler is registered for it - found by testing this file\n * against the REAL `ControlChannelWatcher` rather than a fake with no side\n * effects, which is exactly the failure mode this task kept turning up\n * elsewhere (`createRunsModule()` never loaded into any root;\n * `PollScheduler.start()` never called). `onSteer` is the missing delivery\n * half: it reuses `formatSteerMessage`/`sendUserMessage`, the same\n * mechanism `registerSteeringInbox` already uses for its own, separate\n * steer queue, so a nudge actually lands in the child's conversation instead\n * of being silently claimed and discarded.\n *\n * WHY `agent_end`, NOT `turn_end`:\n * `agent_end`'s own event (`AgentEndEvent.messages`) carries the full\n * message history for this agent loop, which `extractAssistantSummaryText`\n * reads from - `turn_end` only carries the one message that ended that turn,\n * not the memory of what preceded it, and `DeliverableGuard`'s own doc\n * frames this check as \"end-of-turn or idle\", not \"every turn.\"\n *\n * `unansweredAsks` AND `memberId`:\n * Both come from this run's own bound `TeamMemberContext`, which\n * `RunnerBootstrap.bootstrap()` already holds (from registering as a team\n * member) and now returns on its result. `memberId` is `teamContext.memberId`\n * directly. `unansweredAsks` calls `pendingAsksAddressedTo(teamContext,\n * teamContext.memberId, now)` - see `deliverable-guard.ts`'s own AVOID\n * section for why `DeliverableGuard` cannot call that itself, and that\n * function's own doc for why it deliberately returns id/sender/time only,\n * never the question's text (this maps its result into a factual, non-\n * fabricated placeholder message rather than guessing at content it was\n * never given). A standalone run with no team root forwarded has no\n * `teamContext` at all, in which case both are simply omitted - narrower\n * than the real behaviour, never wider, matching every other gap in this\n * file when there is genuinely nothing to report rather than something\n * unknown to guess at.\n *\n * `session_start` ALSO RECORDS THIS RUN'S OWN SESSION FILE:\n * `ctx.sessionManager.getSessionFile()` is the only place in this process\n * that ever answers \"what is my own transcript path\" - see\n * `runnerReporting.ts`'s header for why the value has to come from here\n * (the child) rather than be derived by the parent. `RunnerReporting`\n * validates and retains it while `RunnerBootstrap` writes it before the\n * ready handshake. `getSessionFile()` can return `undefined` (no persisted\n * transcript for this run); that case is simply not recorded, the same\n * \"omit rather than guess\" shape as `unansweredAsks`/`teamContext` above.\n */\nexport function registerRunnerLifecycle(pi: ExtensionAPI, container: Container = createPromptRuntimeContainer()): void {\n  const runId = process.env[SUBAGENT_RUN_ID_ENV]?.trim();\n  if (!runId) return;\n\n  const pollScheduler = container.get<IPollScheduler>(DOOM_TEAM_TYPES.PollScheduler);\n  const bootstrap = container.get<IRunnerBootstrap>(DOOM_TEAM_TYPES.RunnerBootstrap);\n  const execution = container.get<IRunnerExecution>(DOOM_TEAM_TYPES.RunnerExecution);\n  const reporting = container.get<IRunnerReporting>(DOOM_TEAM_TYPES.RunnerReporting);\n\n  let resolved: { teamContext: TeamMemberContext | undefined } | undefined;\n  let cumulativeTokens: number | undefined;\n  let toolCount = 0;\n  const countedMessages = new WeakSet<object>();\n\n  onEvent(pi, 'session_start', (_event, ctx) => {\n    if (resolved) return;\n    pollScheduler.start();\n    const sessionFile = ctx.sessionManager.getSessionFile();\n    const recordedSessionFile = sessionFile ? reporting.recordSessionFile(sessionFile) : undefined;\n    const bootstrapped = bootstrap.bootstrap(runId, recordedSessionFile);\n    if (bootstrapped.teamContext) Object.assign(process.env, nativeTeamMemberEnvironment(bootstrapped.teamContext));\n    // `onSteer` is the delivery half of `DeliverableGuard.deliverNudge`'s\n    // write side (see `RunnerExecutionHandlers.onSteer`'s own doc, which\n    // cross-references it): `deliverNudge` drops a request into this run's\n    // OWN steer-requests queue via `requestAsyncSteer`, and\n    // `ControlChannelWatcher` (wired up by `execution.start()` below) claims\n    // it and calls this handler. Without it, `execution.start()` still\n    // claims and commits the nudge - `deliverNudge` reports\n    // `nudgeDelivered: true`, `status.json` still shows `needs_attention` -\n    // but the request is silently discarded before it ever reaches the\n    // child's own conversation. `formatSteerMessage`/`sendUserMessage` are\n    // the exact same delivery this file already uses for\n    // `registerSteeringInbox`'s separate queue.\n    execution.start(runId, {\n      onSteer: (request) => {\n        const sendUserMessage = (\n          pi as { sendUserMessage?: (content: string, options: { deliverAs: 'steer' }) => unknown }\n        ).sendUserMessage;\n        if (!sendUserMessage) {\n          acknowledgeRunnerSteer(request, 'failed', 'Child Pi session does not support sendUserMessage steering.');\n          return;\n        }\n        try {\n          sendUserMessage(formatSteerMessage(request), { deliverAs: 'steer' });\n          acknowledgeRunnerSteer(request, 'delivered', 'Pi accepted the correlated steering input.');\n        } catch (error) {\n          acknowledgeRunnerSteer(request, 'failed', error instanceof Error ? error.message : String(error));\n          throw error;\n        }\n      },\n    });\n    resolved = { teamContext: bootstrapped.teamContext };\n    execution.setActivity('working');\n  });\n\n  onEvent(pi, 'agent_start', () => {\n    if (resolved) execution.setActivity('working');\n  });\n  onEvent<{ message?: ChildTranscriptMessage }>(pi, 'message_end', (event) => {\n    if (!resolved || !event.message || typeof event.message !== 'object') return;\n    if (countedMessages.has(event.message)) return;\n    countedMessages.add(event.message);\n    const messageTokens = getMessageUsageTokens(event.message);\n    if (messageTokens === undefined) return;\n    cumulativeTokens = (cumulativeTokens ?? 0) + messageTokens;\n    execution.setProgress({ tokens: cumulativeTokens });\n  });\n  onEvent<{ toolName?: string; tool?: { name?: string }; args?: { action?: string } }>(\n    pi,\n    'tool_execution_start',\n    (event) => {\n      if (!resolved) return;\n      const toolName = event.toolName ?? event.tool?.name;\n      toolCount += 1;\n      execution.setProgress({\n        toolCount,\n        ...(typeof toolName === 'string' && toolName.length > 0 ? { currentTool: toolName } : {}),\n      });\n      execution.setActivity(\n        toolName === NATIVE_TEAM_TOOL_NAME && event.args?.action === 'ask' ? 'waiting_for_reply' : 'tool',\n      );\n    },\n  );\n  onEvent(pi, 'tool_execution_end', () => {\n    if (resolved) execution.setActivity('working');\n  });\n  onEvent<{ messages: DeliverableCheckMessage[] }>(pi, 'agent_end', (event) => {\n    if (!resolved) return; // session_start has not bootstrapped yet; nothing to report against.\n    execution.setActivity('finalizing');\n    const summary = extractAssistantSummaryText(event.messages);\n    execution.complete(true, summary);\n  });\n}\n\nconst PARENT_ONLY_CUSTOM_MESSAGE_TYPES = new Set([\n  'subagent-orchestration-instructions',\n  'subagent-slash-result',\n  'subagent-slash-text-result',\n  'subagent-notify',\n  'subagent_control_notice',\n  'subagent-control',\n  'subagent-control-notice',\n]);\nconst SUBAGENT_ORCHESTRATION_SKILL_NAME_PATTERN = /<name>\\s*pi-subagents\\s*<\\/name>/;\nconst PROJECT_CONTEXT_HEADER = '\\n\\n# Project Context\\n\\nProject-specific instructions and guidelines:\\n\\n';\nconst SKILLS_HEADER = '\\n\\nThe following skills provide specialized instructions for specific tasks.';\nconst DATE_HEADER = '\\nCurrent date:';\n\nfunction readBooleanEnv(name: string): boolean | undefined {\n  const value = process.env[name];\n  if (value === undefined) return undefined;\n  return value !== '0';\n}\n\nfunction readRequiredChildTools(): string[] | undefined {\n  const encoded = process.env[REQUIRED_CHILD_TOOLS_ENV]?.trim();\n  if (!encoded) return undefined;\n  const required = JSON.parse(encoded) as unknown;\n  if (!Array.isArray(required) || required.some((name) => typeof name !== 'string' || !name)) {\n    throw new Error(`Invalid ${REQUIRED_CHILD_TOOLS_ENV} payload.`);\n  }\n  return required;\n}\n\nfunction readMcpDirectChildTools(): string[] | undefined {\n  const encoded = process.env[MCP_DIRECT_CHILD_TOOLS_ENV]?.trim();\n  if (!encoded) return undefined;\n  try {\n    const tools = JSON.parse(encoded) as unknown;\n    if (!Array.isArray(tools) || tools.some((name) => typeof name !== 'string' || !name)) return undefined;\n    return tools;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction refreshChildToolDiagnostic(pi: ExtensionAPI): ChildToolDiagnostic | undefined {\n  const filePath = process.env[CHILD_TOOL_DIAGNOSTIC_PATH_ENV]?.trim();\n  const required = readRequiredChildTools();\n  if (!filePath || !required) return undefined;\n  const available = pi.getAllTools().map((tool) => tool.name);\n  return writeChildToolDiagnostic(\n    filePath,\n    required,\n    available,\n    process.env[SUBAGENT_CHILD_AGENT_ENV]?.trim(),\n    readMcpDirectChildTools(),\n  );\n}\n\nfunction findSectionEnd(prompt: string, startIndex: number, nextHeaders: string[]): number {\n  let endIndex = prompt.length;\n  for (const header of nextHeaders) {\n    const index = prompt.indexOf(header, startIndex);\n    if (index !== -1 && index < endIndex) {\n      endIndex = index;\n    }\n  }\n  return endIndex;\n}\n\nexport function stripProjectContext(prompt: string): string {\n  const startIndex = prompt.indexOf(PROJECT_CONTEXT_HEADER);\n  if (startIndex === -1) return prompt;\n  const endIndex = findSectionEnd(prompt, startIndex + PROJECT_CONTEXT_HEADER.length, [SKILLS_HEADER, DATE_HEADER]);\n  return `${prompt.slice(0, startIndex)}${prompt.slice(endIndex)}`;\n}\n\nexport function stripInheritedSkills(prompt: string): string {\n  const startIndex = prompt.indexOf(SKILLS_HEADER);\n  if (startIndex === -1) return prompt;\n  const endIndex = findSectionEnd(prompt, startIndex + SKILLS_HEADER.length, [DATE_HEADER]);\n  return `${prompt.slice(0, startIndex)}${prompt.slice(endIndex)}`;\n}\n\nexport function stripSubagentOrchestrationSkill(prompt: string): string {\n  return prompt\n    .replace(/\\n{0,2}<skill\\s+name=[\"']pi-subagents[\"'][^>]*>[\\s\\S]*?<\\/skill>\\n{0,2}/g, '\\n\\n')\n    .replace(/[ \\t]*<skill>\\s*[\\s\\S]*?<\\/skill>\\s*/g, (block) =>\n      SUBAGENT_ORCHESTRATION_SKILL_NAME_PATTERN.test(block) ? '' : block,\n    );\n}\n\nfunction stripChildBoundaryInstructions(prompt: string): string {\n  let rewritten = prompt;\n  for (const boundary of [CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS, CHILD_FANOUT_BOUNDARY_INSTRUCTIONS]) {\n    rewritten = rewritten.split(boundary).join('');\n  }\n  return rewritten.replace(/^(?:[ \\t]*\\r?\\n)+/, '');\n}\n\nexport function rewriteSubagentPrompt(\n  prompt: string,\n  options: { inheritProjectContext: boolean; inheritSkills: boolean; fanoutChild?: boolean },\n): string {\n  let rewritten = prompt;\n  if (!options.inheritProjectContext) {\n    rewritten = stripProjectContext(rewritten);\n  }\n  if (!options.inheritSkills) {\n    rewritten = stripInheritedSkills(rewritten);\n  }\n  rewritten = stripSubagentOrchestrationSkill(rewritten);\n  rewritten = stripChildBoundaryInstructions(rewritten);\n  const boundary = options.fanoutChild ? CHILD_FANOUT_BOUNDARY_INSTRUCTIONS : CHILD_SUBAGENT_BOUNDARY_INSTRUCTIONS;\n  const structured = process.env[STRUCTURED_OUTPUT_CAPTURE_ENV] ? `\\n\\n${STRUCTURED_OUTPUT_INSTRUCTIONS}` : '';\n  return `${boundary}${structured}\\n\\n${rewritten}`;\n}\n\nfunction isParentOnlySubagentMessage(message: unknown): boolean {\n  const m = message as { role?: string; customType?: string };\n  if (m?.role !== 'custom' || typeof m.customType !== 'string') return false;\n  return PARENT_ONLY_CUSTOM_MESSAGE_TYPES.has(m.customType);\n}\n\nfunction isSubagentToolResultMessage(message: unknown): boolean {\n  const m = message as { role?: string; toolName?: string };\n  return m?.role === 'toolResult' && m.toolName === 'subagent';\n}\n\nfunction isSubagentToolCallBlock(block: unknown): boolean {\n  const b = block as { type?: string; name?: string };\n  return b?.type === 'toolCall' && b.name === 'subagent';\n}\n\nfunction stripAssistantSubagentToolCallBlocks(message: unknown): unknown {\n  const m = message as { role?: string; content?: unknown };\n  if (m?.role !== 'assistant' || !Array.isArray(m.content)) return message;\n  const filteredContent = m.content.filter((block) => !isSubagentToolCallBlock(block));\n  if (filteredContent.length === m.content.length) return message;\n  if (filteredContent.length === 0) return undefined;\n  return { ...m, content: filteredContent };\n}\n\nexport function stripParentOnlySubagentMessages(messages: unknown[]): unknown[] {\n  const preserveCurrentFanoutToolHistory = process.env[SUBAGENT_FANOUT_CHILD_ENV] === '1';\n  let changed = false;\n  const filtered: unknown[] = [];\n  for (const message of messages) {\n    if (\n      isParentOnlySubagentMessage(message) ||\n      (!preserveCurrentFanoutToolHistory && isSubagentToolResultMessage(message))\n    ) {\n      changed = true;\n      continue;\n    }\n    const stripped = preserveCurrentFanoutToolHistory ? message : stripAssistantSubagentToolCallBlocks(message);\n    if (stripped === undefined) {\n      changed = true;\n      continue;\n    }\n    if (stripped !== message) changed = true;\n    filtered.push(stripped);\n  }\n  return changed ? filtered : messages;\n}\n\nexport function formatSteerMessage(request: SteerRequest): string {\n  return [\n    'Mid-run steering from the parent orchestrator:',\n    '',\n    request.message,\n    '',\n    'Incorporate this guidance at the next safe point. Do not restart the task unless the guidance explicitly asks you to.',\n  ].join('\\n');\n}\n\nfunction acknowledgeRunnerSteer(request: SteerRequest, state: 'delivered' | 'failed', message: string): void {\n  const ackDir = process.env[SUBAGENT_STEER_ACK_DIR_ENV]?.trim();\n  const childIndex = Number(process.env[SUBAGENT_CHILD_INDEX_ENV]);\n  if (!ackDir || !Number.isInteger(childIndex) || childIndex < 0) return;\n  writeSteerAckAt(steerAckPathFromDir(ackDir, request.id), {\n    requestId: request.id,\n    index: childIndex,\n    ts: Date.now(),\n    state,\n    message,\n  });\n}\n\nfunction registerToolBudget(\n  pi: ExtensionAPI,\n  budget: ResolvedToolBudget | undefined,\n  diagnostics: PromptRuntimeDiagnostics,\n): void {\n  if (!budget) return;\n  let toolCount = 0;\n  let softNudged = false;\n  const sendUserMessage = (pi as { sendUserMessage?: (content: string, options: { deliverAs: 'steer' }) => unknown })\n    .sendUserMessage;\n  onEvent<{ toolName?: string }>(pi, 'tool_call', (event) => {\n    const toolName = typeof event.toolName === 'string' ? event.toolName : 'tool';\n    toolCount++;\n    if (budget.soft !== undefined && toolCount >= budget.soft && !softNudged) {\n      softNudged = true;\n      try {\n        sendUserMessage?.(toolBudgetSoftNudge(budget, toolCount), { deliverAs: 'steer' });\n      } catch (error) {\n        // Advisory nudge only; the child's own output is what matters. Recorded\n        // rather than discarded so a host that never accepts steering is\n        // discoverable instead of silently dropping every nudge.\n        diagnostics.steerNudgeFailures += 1;\n        diagnostics.lastError = error;\n      }\n    }\n    if (!shouldBlockToolForBudget(budget, toolName, toolCount)) return undefined;\n    return { block: true, reason: toolBudgetBlockedMessage(budget, toolName, toolCount) };\n  });\n}\n\n/**\n * Deliver mid-run steer requests queued for THIS child (by fan-out index)\n * into its own session via `sendUserMessage`. See the module doc's FIX for\n * why this claims each request individually rather than batch-deleting.\n */\nexport function registerSteeringInbox(\n  pi: ExtensionAPI,\n  deps: {\n    watch?: typeof fs.watch;\n    nativeRealpath?: (filePath: string) => string;\n    diagnostics?: PromptRuntimeDiagnostics;\n  } = {},\n): void {\n  const diagnostics = deps.diagnostics ?? createPromptRuntimeDiagnostics();\n  const steerInbox = process.env[SUBAGENT_STEER_INBOX_ENV]?.trim();\n  if (!steerInbox) return;\n  const capabilityPath = process.env[SUBAGENT_STEER_CAPABILITY_ENV]?.trim();\n  const ackDir = process.env[SUBAGENT_STEER_ACK_DIR_ENV]?.trim();\n  const sendUserMessage = (pi as { sendUserMessage?: (content: string, options: { deliverAs: 'steer' }) => unknown })\n    .sendUserMessage;\n  const childIndex = Number(process.env[SUBAGENT_CHILD_INDEX_ENV]);\n  const pending = new Map<string, string[]>();\n  let disposed = false;\n  let flushing = false;\n  let started = false;\n  const canSteer = typeof sendUserMessage === 'function';\n  let watcher: fs.FSWatcher | undefined;\n  let interval: NodeJS.Timeout | undefined;\n\n  const acknowledge = (request: SteerRequest, state: 'delivered' | 'failed', message: string): void => {\n    if (!ackDir || !Number.isInteger(childIndex) || childIndex < 0) return;\n    writeSteerAckAt(steerAckPathFromDir(ackDir, request.id), {\n      requestId: request.id,\n      index: childIndex,\n      ts: Date.now(),\n      state,\n      message,\n    });\n  };\n  const publishCapability = (): void => {\n    if (!capabilityPath || !Number.isInteger(childIndex) || childIndex < 0) return;\n    writeSteerCapabilityAt(capabilityPath, {\n      index: childIndex,\n      pid: process.pid,\n      readyAt: Date.now(),\n      supported: canSteer,\n    });\n  };\n\n  const flush = (): void => {\n    if (disposed || flushing) return;\n    flushing = true;\n    try {\n      for (const claim of claimSteerRequestsFromDir(steerInbox)) {\n        if (!canSteer || typeof sendUserMessage !== 'function') {\n          acknowledge(claim.request, 'failed', 'Child Pi session does not support sendUserMessage steering.');\n          claim.commit();\n          continue;\n        }\n        const formatted = formatSteerMessage(claim.request);\n        const ids = pending.get(formatted) ?? [];\n        ids.push(claim.request.id);\n        pending.set(formatted, ids);\n        try {\n          sendUserMessage(formatted, { deliverAs: 'steer' });\n          claim.commit();\n        } catch (error) {\n          ids.pop();\n          if (ids.length === 0) pending.delete(formatted);\n          // Recoverable: this claim goes back to the queue for the next\n          // flush to retry, instead of being lost. See the module doc's FIX.\n          claim.release();\n          acknowledge(claim.request, 'failed', error instanceof Error ? error.message : String(error));\n        }\n      }\n    } finally {\n      flushing = false;\n    }\n  };\n  const onInput = (event: unknown): undefined => {\n    if (disposed || !event || typeof event !== 'object') return undefined;\n    const input = event as { source?: unknown; streamingBehavior?: unknown; text?: unknown; content?: unknown };\n    if (input.source !== 'extension' || input.streamingBehavior !== 'steer') return undefined;\n    const text =\n      typeof input.text === 'string' ? input.text : typeof input.content === 'string' ? input.content : undefined;\n    if (!text) return undefined;\n    const ids = pending.get(text);\n    const requestId = ids?.shift();\n    if (!requestId) return undefined;\n    if (ids?.length === 0) pending.delete(text);\n    acknowledge(\n      { type: 'steer', id: requestId, ts: Date.now(), message: text },\n      'delivered',\n      'Pi accepted the correlated steering input.',\n    );\n    return undefined;\n  };\n  const start = (): void => {\n    if (started || disposed) return;\n    try {\n      fs.mkdirSync(steerInbox, { recursive: true });\n      publishCapability();\n    } catch {\n      // No channel to report a startup failure on from inside the child;\n      // the parent observes a missing capability file and treats it as\n      // \"steering unsupported for this child\" on its own.\n      return;\n    }\n    started = true;\n    try {\n      watcher = (deps.watch ?? fs.watch)(resolveWatchPath(steerInbox, deps.nativeRealpath), () => flush());\n      watcher.on('error', (error) => {\n        // fs.watch emits on transient FS errors and the interval poll below\n        // keeps delivery live regardless, so this is not fatal. Recorded so a\n        // watch that fails on every event is distinguishable from a quiet inbox.\n        diagnostics.watchErrors += 1;\n        diagnostics.lastError = error;\n      });\n    } catch {\n      watcher = undefined;\n    }\n    interval = setInterval(flush, STEER_FLUSH_POLL_INTERVAL_MS);\n    interval.unref?.();\n  };\n  const activate = (): undefined => {\n    start();\n    flush();\n    return undefined;\n  };\n\n  // Register input before the watcher so an accepted extension input cannot race request dispatch.\n  onEvent(pi, 'input', onInput);\n  onEvent(pi, 'session_start', () => start());\n  for (const eventName of [\n    'message_start',\n    'message_update',\n    'message_end',\n    'tool_execution_start',\n    'tool_execution_end',\n    'turn_end',\n  ] as const) {\n    onEvent(pi, eventName, activate);\n  }\n  onEvent(pi, 'session_shutdown', () => {\n    disposed = true;\n    try {\n      watcher?.close();\n    } catch (error) {\n      // Best effort; the process is shutting down regardless. Still recorded,\n      // because a close that always fails is a leaked descriptor per run.\n      diagnostics.watchCloseFailures += 1;\n      diagnostics.lastError = error;\n    }\n    if (interval) clearInterval(interval);\n  });\n}\n\n/**\n * `diagnostics` is optional and defaults to a fresh object: the `.cts` entry\n * point calls this with a single argument (`pi`), matching the host contract\n * `resolveRuntimeExtensionPath` resolves onto every child's `--extension`\n * args, so that call keeps working unchanged. A caller that wants to observe\n * what this runtime absorbed - see `PromptRuntimeDiagnostics` - passes its\n * own object and keeps the reference; this function only ever mutates it, it\n * never owns or resets it.\n */\nexport function registerSubagentPromptRuntime(\n  pi: ExtensionAPI,\n  diagnostics: PromptRuntimeDiagnostics = createPromptRuntimeDiagnostics(),\n): void {\n  // First, before any scoped path is touched. Pi loads extensions through jiti\n  // with `moduleCache: false`, so this extension gets its OWN instance of\n  // `shared/paths.ts` - the scope the surrounding runner process adopted is not\n  // visible here, and has to be read from the environment again.\n  adoptSessionScopeFromEnv();\n  registerSteeringInbox(pi, { diagnostics });\n  registerToolBudget(\n    pi,\n    decodeToolBudgetEnv(process.env[TOOL_BUDGET_ENV], { allowZero: process.env[TOOL_BUDGET_ZERO_AUTH_ENV] === '1' }),\n    diagnostics,\n  );\n  // One container for this whole registration, not one built inside each\n  // resolver's own default parameter: this process has exactly one\n  // composition root (see container/index.ts and this function's own doc),\n  // and a second independent createPromptRuntimeContainer() call anywhere\n  // else in this function would silently mean two sets of \"singletons\" in\n  // one process, defeating the point of a shared container.\n  const container = createPromptRuntimeContainer();\n  registerRunnerLifecycle(pi, container);\n\n  const teamChannels = container.get<INativeTeamChannelService>(DOOM_TEAM_TYPES.NativeTeamChannelService);\n\n  onEvent(pi, 'session_start', () => {\n    const teamRuntime = teamChannels.createRuntime(pi);\n    teamRuntime.bindChildFromEnvironment();\n  });\n  onEvent(pi, 'agent_start', () => {\n    refreshChildToolDiagnostic(pi);\n  });\n  // `agent_end` intentionally does not drain outstanding work here. See the\n  // module doc's \"WHAT IS DELIBERATELY NOT WIRED YET\" for why.\n\n  const structuredOutputPath = process.env[STRUCTURED_OUTPUT_CAPTURE_ENV];\n  const structuredSchemaPath = process.env[STRUCTURED_OUTPUT_SCHEMA_ENV];\n  if (structuredOutputPath && structuredSchemaPath) {\n    const schema = JSON.parse(fs.readFileSync(structuredSchemaPath, 'utf-8')) as JsonSchemaObject;\n    const parameters = createStructuredOutputToolParameters(schema);\n    const validator = new StructuredOutputValidator();\n    const registerTool = (\n      pi.registerTool as unknown as (tool: {\n        name: string;\n        label: string;\n        description: string;\n        parameters: unknown;\n        execute: (_id: string, params: { value: unknown }) => Promise<unknown>;\n      }) => void\n    ).bind(pi);\n    registerTool({\n      name: 'structured_output',\n      label: 'Structured Output',\n      description: 'Submit the required final structured output for this subagent step. This terminates the step.',\n      parameters: parameters as never,\n      async execute(_id: string, params: { value: unknown }) {\n        const validation = await validator.validateValue(schema, params.value);\n        if (validation.status === 'invalid') {\n          throw new Error(`Structured output validation failed: ${validation.message}`);\n        }\n        fs.mkdirSync(path.dirname(structuredOutputPath), { recursive: true });\n        fs.writeFileSync(structuredOutputPath, JSON.stringify(params.value), { mode: 0o600 });\n        return {\n          content: [{ type: 'text', text: 'Structured output captured.' }],\n          details: { path: structuredOutputPath },\n          terminate: true,\n        };\n      },\n    });\n  }\n\n  onEvent<{ messages: unknown[] }>(pi, 'context', (event) => {\n    const messages = stripParentOnlySubagentMessages(event.messages);\n    if (messages === event.messages) return undefined;\n    return { messages };\n  });\n\n  onEvent<{ systemPrompt: string }>(pi, 'before_agent_start', async (event) => {\n    const intercomSessionName = process.env[SUBAGENT_INTERCOM_SESSION_NAME_ENV]?.trim();\n    if (intercomSessionName && typeof pi.setSessionName === 'function') {\n      pi.setSessionName(intercomSessionName);\n    }\n\n    const inheritProjectContext = readBooleanEnv(INHERIT_PROJECT_CONTEXT_ENV);\n    const inheritSkills = readBooleanEnv(INHERIT_SKILLS_ENV);\n    const fanoutChild = readBooleanEnv(SUBAGENT_FANOUT_CHILD_ENV);\n    let rewritten = event.systemPrompt;\n    if (inheritProjectContext !== undefined || inheritSkills !== undefined || fanoutChild !== undefined) {\n      rewritten = rewriteSubagentPrompt(event.systemPrompt, {\n        inheritProjectContext: inheritProjectContext ?? true,\n        inheritSkills: inheritSkills ?? true,\n        fanoutChild: fanoutChild === true,\n      });\n    }\n    if (rewritten === event.systemPrompt) return;\n    return { systemPrompt: rewritten };\n  });\n}\n"],"mappings":"oyDAmJA,SAAgB,GAA2D,CACzE,MAAO,CAAE,mBAAoB,EAAG,YAAa,EAAG,mBAAoB,EAAG,CAyCzE,SAAS,EACP,EACA,EACA,EACM,CACL,EAAG,GAAiG,KACnG,EACA,EACA,EACD,CAeH,SAAS,EAAqB,EAA6C,CACzE,OACE,OAAO,GAAU,YACjB,GACC,EAA6B,OAAS,QACvC,OAAQ,EAA6B,MAAS,SAmBlD,SAAgB,EAA4B,EAAsD,CAChG,IAAK,IAAI,EAAQ,EAAS,OAAS,EAAG,GAAS,EAAG,IAAY,CAC5D,IAAM,EAAU,EAAS,GACzB,GAAI,GAAS,OAAS,aAAe,CAAC,MAAM,QAAQ,EAAQ,QAAQ,CAAE,SACtE,IAAM,EAAO,EAAQ,QAClB,OAAO,EAAqB,CAC5B,IAAK,GAAU,EAAM,KAAK,CAC1B,KAAK;EAAK,CACV,MAAM,CACT,GAAI,EAAM,OAAO,EAEnB,MAAO,GA0FT,SAAgB,EAAwB,EAAkB,EAAuB,GAA8B,CAAQ,CACrH,IAAM,EAAQ,QAAQ,IAAI,IAAsB,MAAM,CACtD,GAAI,CAAC,EAAO,OAEZ,IAAM,EAAgB,EAAU,IAAoB,EAAgB,cAAc,CAC5E,EAAY,EAAU,IAAsB,EAAgB,gBAAgB,CAC5E,EAAY,EAAU,IAAsB,EAAgB,gBAAgB,CAC5E,EAAY,EAAU,IAAsB,EAAgB,gBAAgB,CAE9E,EACA,EACA,EAAY,EACV,EAAkB,IAAI,QAE5B,EAAQ,EAAI,iBAAkB,EAAQ,IAAQ,CAC5C,GAAI,EAAU,OACd,EAAc,OAAO,CACrB,IAAM,EAAc,EAAI,eAAe,gBAAgB,CACjD,EAAsB,EAAc,EAAU,kBAAkB,EAAY,CAAG,IAAA,GAC/E,EAAe,EAAU,UAAU,EAAO,EAAoB,CAChE,EAAa,aAAa,OAAO,OAAO,QAAQ,IAAK,EAA4B,EAAa,YAAY,CAAC,CAa/G,EAAU,MAAM,EAAO,CACrB,QAAU,GAAY,CACpB,IAAM,EACJ,EACA,gBACF,GAAI,CAAC,EAAiB,CACpB,EAAuB,EAAS,SAAU,8DAA8D,CACxG,OAEF,GAAI,CACF,EAAgB,EAAmB,EAAQ,CAAE,CAAE,UAAW,QAAS,CAAC,CACpE,EAAuB,EAAS,YAAa,6CAA6C,OACnF,EAAO,CAEd,MADA,EAAuB,EAAS,SAAU,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,CAAC,CAC3F,IAGX,CAAC,CACF,EAAW,CAAE,YAAa,EAAa,YAAa,CACpD,EAAU,YAAY,UAAU,EAChC,CAEF,EAAQ,EAAI,kBAAqB,CAC3B,GAAU,EAAU,YAAY,UAAU,EAC9C,CACF,EAA8C,EAAI,cAAgB,GAAU,CAE1E,GADI,CAAC,GAAY,CAAC,EAAM,SAAW,OAAO,EAAM,SAAY,UACxD,EAAgB,IAAI,EAAM,QAAQ,CAAE,OACxC,EAAgB,IAAI,EAAM,QAAQ,CAClC,IAAM,EAAgB,GAAsB,EAAM,QAAQ,CACtD,IAAkB,IAAA,KACtB,GAAoB,GAAoB,GAAK,EAC7C,EAAU,YAAY,CAAE,OAAQ,EAAkB,CAAC,GACnD,CACF,EACE,EACA,uBACC,GAAU,CACT,GAAI,CAAC,EAAU,OACf,IAAM,EAAW,EAAM,UAAY,EAAM,MAAM,KAC/C,GAAa,EACb,EAAU,YAAY,CACpB,YACA,GAAI,OAAO,GAAa,UAAY,EAAS,OAAS,EAAI,CAAE,YAAa,EAAU,CAAG,EAAE,CACzF,CAAC,CACF,EAAU,YACR,IAAA,YAAsC,EAAM,MAAM,SAAW,MAAQ,oBAAsB,OAC5F,EAEJ,CACD,EAAQ,EAAI,yBAA4B,CAClC,GAAU,EAAU,YAAY,UAAU,EAC9C,CACF,EAAiD,EAAI,YAAc,GAAU,CAC3E,GAAI,CAAC,EAAU,OACf,EAAU,YAAY,aAAa,CACnC,IAAM,EAAU,EAA4B,EAAM,SAAS,CAC3D,EAAU,SAAS,GAAM,EAAQ,EACjC,CAiBJ,SAAS,EAAe,EAAmC,CACzD,IAAM,EAAQ,QAAQ,IAAI,GACtB,OAAU,IAAA,GACd,OAAO,IAAU,IAGnB,SAAS,GAA+C,CACtD,IAAM,EAAU,QAAQ,IAAI,IAA2B,MAAM,CAC7D,GAAI,CAAC,EAAS,OACd,IAAM,EAAW,KAAK,MAAM,EAAQ,CACpC,GAAI,CAAC,MAAM,QAAQ,EAAS,EAAI,EAAS,KAAM,GAAS,OAAO,GAAS,UAAY,CAAC,EAAK,CACxF,MAAU,MAAM,WAAW,EAAyB,WAAW,CAEjE,OAAO,EAGT,SAAS,GAAgD,CACvD,IAAM,EAAU,QAAQ,IAAI,IAA6B,MAAM,CAC1D,KACL,GAAI,CACF,IAAM,EAAQ,KAAK,MAAM,EAAQ,CAEjC,MADI,CAAC,MAAM,QAAQ,EAAM,EAAI,EAAM,KAAM,GAAS,OAAO,GAAS,UAAY,CAAC,EAAK,CAAE,OAC/E,OACD,CACN,QAIJ,SAAS,GAA2B,EAAmD,CACrF,IAAM,EAAW,QAAQ,IAAI,IAAiC,MAAM,CAC9D,EAAW,GAAwB,CACrC,MAAC,GAAY,CAAC,GAElB,OAAO,GACL,EACA,EAHgB,EAAG,aAAa,CAAC,IAAK,GAAS,EAAK,KAI3C,CACT,QAAQ,IAAI,IAA2B,MAAM,CAC7C,GAAyB,CAC1B,CAGH,SAAS,EAAe,EAAgB,EAAoB,EAA+B,CACzF,IAAI,EAAW,EAAO,OACtB,IAAK,IAAM,KAAU,EAAa,CAChC,IAAM,EAAQ,EAAO,QAAQ,EAAQ,EAAW,CAC5C,IAAU,IAAM,EAAQ,IAC1B,EAAW,GAGf,OAAO,EAGT,SAAgB,GAAoB,EAAwB,CAC1D,IAAM,EAAa,EAAO,QAAQ,EAAuB,CACzD,GAAI,IAAe,GAAI,OAAO,EAC9B,IAAM,EAAW,EAAe,EAAQ,EAAa,GAA+B,CAAC,EAAe,EAAY,CAAC,CACjH,MAAO,GAAG,EAAO,MAAM,EAAG,EAAW,GAAG,EAAO,MAAM,EAAS,GAGhE,SAAgB,GAAqB,EAAwB,CAC3D,IAAM,EAAa,EAAO,QAAQ,EAAc,CAChD,GAAI,IAAe,GAAI,OAAO,EAC9B,IAAM,EAAW,EAAe,EAAQ,EAAa,GAAsB,CAAC,EAAY,CAAC,CACzF,MAAO,GAAG,EAAO,MAAM,EAAG,EAAW,GAAG,EAAO,MAAM,EAAS,GAGhE,SAAgB,GAAgC,EAAwB,CACtE,OAAO,EACJ,QAAQ,2EAA4E;;EAAO,CAC3F,QAAQ,wCAA0C,GACjD,EAA0C,KAAK,EAAM,CAAG,GAAK,EAC9D,CAGL,SAAS,GAA+B,EAAwB,CAC9D,IAAI,EAAY,EAChB,IAAK,IAAM,IAAY,CAAC,EAAsC,EAAmC,CAC/F,EAAY,EAAU,MAAM,EAAS,CAAC,KAAK,GAAG,CAEhD,OAAO,EAAU,QAAQ,oBAAqB,GAAG,CAGnD,SAAgB,GACd,EACA,EACQ,CACR,IAAI,EAAY,EAWhB,OAVK,EAAQ,wBACX,EAAY,GAAoB,EAAU,EAEvC,EAAQ,gBACX,EAAY,GAAqB,EAAU,EAE7C,EAAY,GAAgC,EAAU,CACtD,EAAY,GAA+B,EAAU,CAG9C,GAFU,EAAQ,YAAc,EAAqC,IACzD,QAAQ,IAAA,sCAAqC,OAAO,IAAmC,GAC1E,MAAM,IAGxC,SAAS,GAA4B,EAA2B,CAC9D,IAAM,EAAI,EAEV,OADI,GAAG,OAAS,UAAY,OAAO,EAAE,YAAe,SAAiB,GAC9D,EAAiC,IAAI,EAAE,WAAW,CAG3D,SAAS,GAA4B,EAA2B,CAC9D,IAAM,EAAI,EACV,OAAO,GAAG,OAAS,cAAgB,EAAE,WAAa,WAGpD,SAAS,GAAwB,EAAyB,CACxD,IAAM,EAAI,EACV,OAAO,GAAG,OAAS,YAAc,EAAE,OAAS,WAG9C,SAAS,GAAqC,EAA2B,CACvE,IAAM,EAAI,EACV,GAAI,GAAG,OAAS,aAAe,CAAC,MAAM,QAAQ,EAAE,QAAQ,CAAE,OAAO,EACjE,IAAM,EAAkB,EAAE,QAAQ,OAAQ,GAAU,CAAC,GAAwB,EAAM,CAAC,CACpF,GAAI,EAAgB,SAAW,EAAE,QAAQ,OAAQ,OAAO,EACpD,KAAgB,SAAW,EAC/B,MAAO,CAAE,GAAG,EAAG,QAAS,EAAiB,CAG3C,SAAgB,GAAgC,EAAgC,CAC9E,IAAM,EAAmC,QAAQ,IAAI,KAA+B,IAChF,EAAU,GACR,EAAsB,EAAE,CAC9B,IAAK,IAAM,KAAW,EAAU,CAC9B,GACE,GAA4B,EAAQ,EACnC,CAAC,GAAoC,GAA4B,EAAQ,CAC1E,CACA,EAAU,GACV,SAEF,IAAM,EAAW,EAAmC,EAAU,GAAqC,EAAQ,CAC3G,GAAI,IAAa,IAAA,GAAW,CAC1B,EAAU,GACV,SAEE,IAAa,IAAS,EAAU,IACpC,EAAS,KAAK,EAAS,CAEzB,OAAO,EAAU,EAAW,EAG9B,SAAgB,EAAmB,EAA+B,CAChE,MAAO,CACL,iDACA,GACA,EAAQ,QACR,GACA,wHACD,CAAC,KAAK;EAAK,CAGd,SAAS,EAAuB,EAAuB,EAA+B,EAAuB,CAC3G,IAAM,EAAS,QAAQ,IAAI,IAA6B,MAAM,CACxD,EAAa,OAAO,QAAQ,IAAI,GAA0B,CAC5D,CAAC,GAAU,CAAC,OAAO,UAAU,EAAW,EAAI,EAAa,GAC7D,EAAgB,EAAoB,EAAQ,EAAQ,GAAG,CAAE,CACvD,UAAW,EAAQ,GACnB,MAAO,EACP,GAAI,KAAK,KAAK,CACd,QACA,UACD,CAAC,CAGJ,SAAS,GACP,EACA,EACA,EACM,CACN,GAAI,CAAC,EAAQ,OACb,IAAI,EAAY,EACZ,EAAa,GACX,EAAmB,EACtB,gBACH,EAA+B,EAAI,YAAc,GAAU,CACzD,IAAM,EAAW,OAAO,EAAM,UAAa,SAAW,EAAM,SAAW,OAEvE,GADA,IACI,EAAO,OAAS,IAAA,IAAa,GAAa,EAAO,MAAQ,CAAC,EAAY,CACxE,EAAa,GACb,GAAI,CACF,IAAkB,GAAoB,EAAQ,EAAU,CAAE,CAAE,UAAW,QAAS,CAAC,OAC1E,EAAO,CAId,EAAY,oBAAsB,EAClC,EAAY,UAAY,GAGvB,MAAyB,EAAQ,EAAU,EAAU,CAC1D,MAAO,CAAE,MAAO,GAAM,OAAQ,EAAyB,EAAQ,EAAU,EAAU,CAAE,EACrF,CAQJ,SAAgB,GACd,EACA,EAII,EAAE,CACA,CACN,IAAM,EAAc,EAAK,aAAe,GAAgC,CAClE,EAAa,QAAQ,IAAI,KAA2B,MAAM,CAChE,GAAI,CAAC,EAAY,OACjB,IAAM,EAAiB,QAAQ,IAAI,IAAgC,MAAM,CACnE,EAAS,QAAQ,IAAI,IAA6B,MAAM,CACxD,EAAmB,EACtB,gBACG,EAAa,OAAO,QAAQ,IAAI,GAA0B,CAC1D,EAAU,IAAI,IAChB,EAAW,GACX,EAAW,GACX,EAAU,GACR,EAAW,OAAO,GAAoB,WACxC,EACA,EAEE,GAAe,EAAuB,EAA+B,IAA0B,CAC/F,CAAC,GAAU,CAAC,OAAO,UAAU,EAAW,EAAI,EAAa,GAC7D,EAAgB,EAAoB,EAAQ,EAAQ,GAAG,CAAE,CACvD,UAAW,EAAQ,GACnB,MAAO,EACP,GAAI,KAAK,KAAK,CACd,QACA,UACD,CAAC,EAEE,MAAgC,CAChC,CAAC,GAAkB,CAAC,OAAO,UAAU,EAAW,EAAI,EAAa,GACrE,GAAuB,EAAgB,CACrC,MAAO,EACP,IAAK,QAAQ,IACb,QAAS,KAAK,KAAK,CACnB,UAAW,EACZ,CAAC,EAGE,MAAoB,CACpB,QAAY,GAChB,GAAW,GACX,GAAI,CACF,IAAK,IAAM,KAAS,EAA0B,EAAW,CAAE,CACzD,GAAI,CAAC,GAAY,OAAO,GAAoB,WAAY,CACtD,EAAY,EAAM,QAAS,SAAU,8DAA8D,CACnG,EAAM,QAAQ,CACd,SAEF,IAAM,EAAY,EAAmB,EAAM,QAAQ,CAC7C,EAAM,EAAQ,IAAI,EAAU,EAAI,EAAE,CACxC,EAAI,KAAK,EAAM,QAAQ,GAAG,CAC1B,EAAQ,IAAI,EAAW,EAAI,CAC3B,GAAI,CACF,EAAgB,EAAW,CAAE,UAAW,QAAS,CAAC,CAClD,EAAM,QAAQ,OACP,EAAO,CACd,EAAI,KAAK,CACL,EAAI,SAAW,GAAG,EAAQ,OAAO,EAAU,CAG/C,EAAM,SAAS,CACf,EAAY,EAAM,QAAS,SAAU,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,CAAC,UAGxF,CACR,EAAW,MAGT,EAAW,GAA8B,CAC7C,GAAI,GAAY,CAAC,GAAS,OAAO,GAAU,SAAU,OACrD,IAAM,EAAQ,EACd,GAAI,EAAM,SAAW,aAAe,EAAM,oBAAsB,QAAS,OACzE,IAAM,EACJ,OAAO,EAAM,MAAS,SAAW,EAAM,KAAO,OAAO,EAAM,SAAY,SAAW,EAAM,QAAU,IAAA,GACpG,GAAI,CAAC,EAAM,OACX,IAAM,EAAM,EAAQ,IAAI,EAAK,CACvB,EAAY,GAAK,OAAO,CACzB,IACD,GAAK,SAAW,GAAG,EAAQ,OAAO,EAAK,CAC3C,EACE,CAAE,KAAM,QAAS,GAAI,EAAW,GAAI,KAAK,KAAK,CAAE,QAAS,EAAM,CAC/D,YACA,6CACD,GAGG,MAAoB,CACpB,QAAW,GACf,IAAI,CACF,EAAG,UAAU,EAAY,CAAE,UAAW,GAAM,CAAC,CAC7C,GAAmB,MACb,CAIN,OAEF,EAAU,GACV,GAAI,CACF,GAAW,EAAK,OAAS,EAAG,OAAO,EAAiB,EAAY,EAAK,eAAe,KAAQ,GAAO,CAAC,CACpG,EAAQ,GAAG,QAAU,GAAU,CAI7B,EAAY,aAAe,EAC3B,EAAY,UAAY,GACxB,MACI,CACN,EAAU,IAAA,GAEZ,EAAW,YAAY,EAAO,EAA6B,CAC3D,EAAS,SAAS,GAEd,MAA4B,CAChC,GAAO,CACP,GAAO,EAKT,EAAQ,EAAI,QAAS,EAAQ,CAC7B,EAAQ,EAAI,oBAAuB,GAAO,CAAC,CAC3C,IAAK,IAAM,IAAa,CACtB,gBACA,iBACA,cACA,uBACA,qBACA,WACD,CACC,EAAQ,EAAI,EAAW,EAAS,CAElC,EAAQ,EAAI,uBAA0B,CACpC,EAAW,GACX,GAAI,CACF,GAAS,OAAO,OACT,EAAO,CAGd,EAAY,oBAAsB,EAClC,EAAY,UAAY,EAEtB,GAAU,cAAc,EAAS,EACrC,CAYJ,SAAgB,GACd,EACA,EAAwC,GAAgC,CAClE,CAKN,GAA0B,CAC1B,GAAsB,EAAI,CAAE,cAAa,CAAC,CAC1C,GACE,EACA,GAAoB,QAAQ,IAAI,GAAkB,CAAE,UAAW,QAAQ,IAAI,KAA+B,IAAK,CAAC,CAChH,EACD,CAOD,IAAM,EAAY,GAA8B,CAChD,EAAwB,EAAI,EAAU,CAEtC,IAAM,EAAe,EAAU,IAA+B,EAAgB,yBAAyB,CAEvG,EAAQ,EAAI,oBAAuB,CACb,EAAa,cAAc,EACpC,CAAC,0BAA0B,EACtC,CACF,EAAQ,EAAI,kBAAqB,CAC/B,GAA2B,EAAG,EAC9B,CAIF,IAAM,EAAuB,QAAQ,IAAI,GACnC,EAAuB,QAAQ,IAAI,GACzC,GAAI,GAAwB,EAAsB,CAChD,IAAM,EAAS,KAAK,MAAM,EAAG,aAAa,EAAsB,QAAQ,CAAC,CACnE,EAAa,GAAqC,EAAO,CACzD,EAAY,IAAI,GAEpB,EAAG,aAOH,KAAK,EACK,CAAC,CACX,KAAM,oBACN,MAAO,oBACP,YAAa,gGACD,aACZ,MAAM,QAAQ,EAAa,EAA4B,CACrD,IAAM,EAAa,MAAM,EAAU,cAAc,EAAQ,EAAO,MAAM,CACtE,GAAI,EAAW,SAAW,UACxB,MAAU,MAAM,wCAAwC,EAAW,UAAU,CAI/E,OAFA,EAAG,UAAU,EAAK,QAAQ,EAAqB,CAAE,CAAE,UAAW,GAAM,CAAC,CACrE,EAAG,cAAc,EAAsB,KAAK,UAAU,EAAO,MAAM,CAAE,CAAE,KAAM,IAAO,CAAC,CAC9E,CACL,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAM,8BAA+B,CAAC,CAChE,QAAS,CAAE,KAAM,EAAsB,CACvC,UAAW,GACZ,EAEJ,CAAC,CAGJ,EAAiC,EAAI,UAAY,GAAU,CACzD,IAAM,EAAW,GAAgC,EAAM,SAAS,CAC5D,OAAa,EAAM,SACvB,MAAO,CAAE,WAAU,EACnB,CAEF,EAAkC,EAAI,qBAAsB,KAAO,IAAU,CAC3E,IAAM,EAAsB,QAAQ,IAAI,IAAqC,MAAM,CAC/E,GAAuB,OAAO,EAAG,gBAAmB,YACtD,EAAG,eAAe,EAAoB,CAGxC,IAAM,EAAwB,EAAe,EAA4B,CACnE,EAAgB,EAAe,EAAmB,CAClD,EAAc,EAAe,EAA0B,CACzD,EAAY,EAAM,aACtB,IAAI,IAA0B,IAAA,IAAa,IAAkB,IAAA,IAAa,IAAgB,IAAA,MACxF,EAAY,GAAsB,EAAM,aAAc,CACpD,sBAAuB,GAAyB,GAChD,cAAe,GAAiB,GAChC,YAAa,IAAgB,GAC9B,CAAC,EAEA,IAAc,EAAM,aACxB,MAAO,CAAE,aAAc,EAAW,EAClC,qCA51BkF,IAmBnE,IAMuB,IACgB,KACwC,IACpC,IAQb,KAKoE,KACb,KAMlE,CAGhC,EAA+B,IAiD/B,EAAiC,CACrC,8DACA,yGACA,gHACD,CAAC,KAAK;EAAK,CAEC,EAAuC,CAClD,yDACA,mGACA,yFACA,mHACA,oIACD,CAAC,KAAK;EAAK,CAEC,EAAqC,CAChD,uFACA,kGACA,8FACA,uIACA,uEACA,oIACD,CAAC,KAAK;EAAK,CAoQN,EAAmC,IAAI,IAAI,CAC/C,sCACA,wBACA,6BACA,kBACA,0BACA,mBACA,0BACD,CAAC,CACI,EAA4C,mCAC5C,EAAyB;;;;;;EACzB,EAAgB;;2EAChB,EAAc"}

package/dist/extensions/subagentPromptRuntimeEntry.cjs

@@ -0,0 +1,2 @@
+const e=require(`./subagentPromptRuntime.cjs`);module.exports=e.registerSubagentPromptRuntime;
+//# sourceMappingURL=subagentPromptRuntimeEntry.cjs.map

package/dist/extensions/subagentPromptRuntimeEntry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentPromptRuntimeEntry.cjs","names":["registerSubagentPromptRuntime"],"sources":["../../src/extensions/subagentPromptRuntimeEntry.cts"],"sourcesContent":["import { registerSubagentPromptRuntime } from './subagentPromptRuntime.ts';\n\n// Pi's jiti loader imports extension factories through the CommonJS default interop path.\nexport = registerSubagentPromptRuntime;\n"],"mappings":"8DAGSA,EAAAA"}

package/dist/extensions/subagentPromptRuntimeEntry.d.cts

@@ -0,0 +1,2 @@
+import { registerSubagentPromptRuntime } from "./subagentPromptRuntime.cjs";
+export = registerSubagentPromptRuntime;

package/dist/extensions/subagentPromptRuntimeEntry.d.mts

@@ -0,0 +1,2 @@
+import { registerSubagentPromptRuntime } from "./subagentPromptRuntime.mjs";
+export { registerSubagentPromptRuntime as default };

package/dist/extensions/subagentPromptRuntimeEntry.mjs

@@ -0,0 +1,2 @@
+import{__commonJSMin as e}from"../_virtual/_rolldown/runtime.mjs";import{init_subagentPromptRuntime as t,registerSubagentPromptRuntime as n}from"./subagentPromptRuntime.mjs";var r=e(((e,r)=>{t(),r.exports=n}));export default r();export{};
+//# sourceMappingURL=subagentPromptRuntimeEntry.mjs.map

package/dist/extensions/subagentPromptRuntimeEntry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentPromptRuntimeEntry.mjs","names":[],"sources":["../../src/extensions/subagentPromptRuntimeEntry.cts"],"sourcesContent":["import { registerSubagentPromptRuntime } from './subagentPromptRuntime.ts';\n\n// Pi's jiti loader imports extension factories through the CommonJS default interop path.\nexport = registerSubagentPromptRuntime;\n"],"mappings":"kMAA2E,WAGlE"}

package/dist/extensions/subagentTool.cjs

@@ -0,0 +1,7 @@
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../agents/memory.cjs`),t=require(`../_virtual/_@oxc-project_runtime@0.127.0/helpers/decorate.cjs`),n=require(`../container/types.cjs`),r=require(`../_virtual/_@oxc-project_runtime@0.127.0/helpers/decorateMetadata.cjs`),i=require(`../_virtual/_@oxc-project_runtime@0.127.0/helpers/decorateParam.cjs`),a=require(`../shared/paths.cjs`),o=require(`../shared/errors.cjs`),s=require(`../runs/shared/runtimeRegistry.cjs`),c=require(`../shared/modelResolution.cjs`),l=require(`../runs/shared/modelFallback.cjs`),u=require(`./spawnPlan.cjs`),d=require(`../runs/background/asyncJobTracker.cjs`),f=require(`../runs/registry/suspendedRuns.cjs`),p=require(`./config.cjs`),m=require(`./operationJournal.cjs`);require(`./schemas.cjs`);const h=require(`./statusViews.cjs`),g=require(`./toolDescription.cjs`);let _=require(`inversify`),v=require(`node:crypto`),y=require(`@agimon-ai/doompi-extension-contracts/subagent-tool`);const b=`subagent`,x=new Set(Object.values(y.SUBAGENT_ACTIONS));function S(e,t){return{content:[{type:`text`,text:e}],details:t}}function C(e,t){return S(e,{action:t,partial:!0})}function w(e){switch(e.action){case y.SUBAGENT_ACTIONS.run:return`Starting ${e.requests.length} subagent${e.requests.length===1?``:`s`}...`;case y.SUBAGENT_ACTIONS.wait:return`Waiting for subagent activity...`;case y.SUBAGENT_ACTIONS.steer:return`Steering subagent ${e.id}...`;case y.SUBAGENT_ACTIONS.stop:return`Requesting stop for subagent ${e.id}...`;case y.SUBAGENT_ACTIONS.restore:return`Restoring subagent ${e.id}...`;default:return}}function T(e){return e===`timeout`?[`The wait timed out; the runs may still be active.`,`Inspect subagent status, wait again with a deliberate timeout, or ask the user before stopping work.`]:e===`attention`?[`Inspect the affected run status or transcript, then steer it or ask the user for the required decision.`]:e===`no-active-runs`?[`Inspect fleet status and verify the run ids instead of polling the same empty wait again.`]:e===`aborted`?[`The wait was cancelled; inspect current run status before deciding what to do next.`]:[]}function E(e,t){try{return e.getAllTools().some(e=>e.name===t)}catch{return!1}}function D(e){return e??`both`}function O(e){return[`Executable agents:`,...e.length?e.toSorted((e,t)=>e.name.localeCompare(t.name)).map(e=>`- ${e.name} (${e.source}): ${e.description}`):[`- (none)`]].join(`
+`)}function k(t){let n=[...t.tools??[],...(t.mcpDirectTools??[]).map(e=>`mcp:${e}`)];return{name:t.name,source:t.source,description:t.description,runtime:t.runtime??`pi`,writeCapable:e.agentHasWriteTools(t),...t.model?{model:t.model}:{},...t.fallbackModels?.length?{fallbackModels:t.fallbackModels}:{},...n.length?{tools:n}:{}}}function A(e){return{...e,resumable:f.isSuspendedRunResumable(e)}}function j(e){let t=k(e);return[`Agent: ${e.name} (${e.source})`,`Description: ${e.description}`,`Runtime: ${String(t.runtime)}`,`Write capable: ${t.writeCapable?`yes`:`no`}`,...e.model?[`Model: ${e.model}`]:[],...Array.isArray(t.tools)?[`Tools: ${t.tools.join(`, `)}`]:[]].join(`
+`)}function M(e,t,n){if(typeof e[t]!=`string`||!e[t].trim())throw o.invalidRequest(`action='${n}' requires nonblank '${t}'.`,`Correct the request and retry.`)}function N(e){if(!e||typeof e!=`object`||Array.isArray(e))return e;let t=e;if(typeof t.action!=`string`||!x.has(t.action)||t.action===y.SUBAGENT_ACTIONS.run||typeof t.model!=`string`)return e;let{model:n,...r}=t;return r}function P(e){let t=N(e);if(!t||typeof t!=`object`||Array.isArray(t))throw o.invalidRequest(`subagent parameters must be an object.`,`Call subagent with one documented action shape.`);let n=t,r=n.action;if(typeof r!=`string`||!x.has(r))throw o.invalidRequest(`Unsupported or missing subagent action ${JSON.stringify(r)}.`,`Use one of: ${[...x].join(`, `)}.`);let i=y.SUBAGENT_ACTION_FIELDS[r],a=Object.keys(n).filter(e=>!i.includes(e));if(a.length)throw o.invalidRequest(`action='${r}' does not accept: ${a.join(`, `)}.`,`Remove unknown fields and retry.`);if(r===`run`&&(!Array.isArray(n.requests)||n.requests.length===0))throw o.invalidRequest(`action='run' requires a nonempty 'requests' array.`,`Add at least one agent and task.`);return r===`steer`&&(M(n,`id`,r),M(n,`message`,r)),(r===`stop`||r===`restore`)&&M(n,`id`,r),t}let F=class{registeredHosts=new WeakSet;constructor(e,t,n,r,i){this.planner=e,this.management=t,this.tracker=n,this.discovery=r,this.waiter=i}registerTool(e){if(!this.registeredHosts.has(e)){if(E(e,`subagent`))throw new o.DoomTeamExpectedError(`tool_conflict`,`A foreign '${b}' tool is already registered.`,!1,`Disable the competing extension, then reload Doom Team.`);e.registerTool(this.buildTool()),this.registeredHosts.add(e)}}trackOutcomes(e,t){let n=this.tracker.forSession(t.sessionManager.getSessionId());for(let t of e.outcomes)t.runId&&n.track(t.runId);return e}buildSpawnRequest(e,t,n,r){let i=t.requests.map(e=>{if(!e.agent.trim()||!e.task.trim())throw o.invalidRequest(`Every run request requires nonblank agent and task values.`,`Correct the request and retry.`);return{agent:e.agent.trim(),...e.inlineAgent?{inlineAgent:e.inlineAgent}:{},task:e.task.trim(),...e.cwd?{cwd:e.cwd}:{},...e.model?{model:e.model}:{},...e.runtime?{runtime:e.runtime}:{}}}),a=u.captureSessionForkSource(n.sessionManager,`tool`),s=l.normalizeParentModel(n.model);return{tasks:i,cwd:n.cwd,agentScope:D(t.scope),parentSessionId:n.sessionManager.getSessionId(),...a?{parentSessionFile:a.sessionFile,parentLeafId:a.leafId}:{},...t.concurrency===void 0?{}:{concurrency:t.concurrency},...t.artifacts===void 0?{}:{artifacts:t.artifacts},availableModels:c.authenticatedModelInfos(n.modelRegistry),...s?{parentModel:s}:{},operationId:e,preallocatedRunIds:r}}async executeRun(e,t,n){let r=m.startOperation(e,t,t.requests.map(()=>(0,v.randomUUID)()));if(r.kind===`replay`){if(r.record.state===`completed`&&r.record.result)return r.record.result;throw new o.DoomTeamExpectedError(`delivery_unconfirmed`,`Operation '${e}' is already pending for runs: ${r.record.runIds.join(`, `)}.`,!0,`Call subagent({"action":"status"}) and do not submit the run again.`)}let i=this.trackOutcomes(await this.planner.spawn(this.buildSpawnRequest(e,t,n,r.record.runIds),p.loadConfig().config),n),a=i.outcomes.filter(e=>e.runId),s=i.outcomes.filter(e=>!e.runId),c=i.outcomes.map(e=>`- ${e.agent}: ${e.runId?`started as ${e.runId}`:`failed: ${e.error??`unknown error`}`}${e.warning?`\n  Warning: ${e.warning}`:``}`);if(a.length===0&&s.length>0)throw new o.DoomTeamExpectedError(`runtime_unavailable`,`No requested subagent started.\n${c.join(`
+`)}`,!0,`Call subagent({"action":"agents"}) to verify exact agent names, correct only the failed requests, or ask the user if a different delegation approach is needed.`);let l=S([`Run request: started ${a.length}/${i.outcomes.length} background agents; failed ${s.length}.`,...c,...a.length>0?[``,`They run independently of this turn and will send completion notifications. Continue non-overlapping work, or end the turn and wait.`]:[],...s.length>0?[``,`Do not retry the whole request because some runs already started. Inspect the failed entries and submit only corrected replacements for those items.`]:[]].join(`
+`),{spawn:i,started:a.length,failed:s.length});return m.completeOperation(e,r.record,l),l}executeAgents(e,t){let n=e.cwd??t.cwd,r=D(e.scope);if(!e.name){let e=this.discovery.discover(n,r);return S(O(e.agents),{agents:e.agents.map(k)})}let i=this.discovery.find(n,r,e.name);if(!i){let t=this.discovery.discover(n,r).agents.map(e=>e.name).toSorted();throw new o.DoomTeamExpectedError(`agent_not_found`,`No executable agent matches '${e.name}'.${t.length?` Available: ${t.join(`, `)}.`:``}`,!1,`Call subagent({"action":"agents"}) and retry with an exact name.`)}return S(j(i),{agent:k(i)})}async executeManagement(e,t,n,r,i){let l=this.tracker.forSession(t.sessionManager.getSessionId());switch(e.action){case y.SUBAGENT_ACTIONS.status:{let t=f.listSuspendedRuns(a.requireCurrentSessionScope());if(!(`id`in e)){if(`transcriptLines`in e&&e.transcriptLines!==void 0)throw o.invalidRequest(`transcriptLines requires a run id.`,`Add id or omit transcriptLines for fleet status.`);let n=l.list();return S(h.formatFleetView(n,Date.now(),t),{fleet:n,suspended:t.map(A)})}let n=e.id;if(!n)throw o.invalidRequest(`transcriptLines requires a run id.`,`Add id or omit transcriptLines for fleet status.`);let r=t.find(e=>e.runId===n);if(r&&e.transcriptLines===void 0){let e=f.isSuspendedRunResumable(r)?`Restore it with { action: "restore", id: "${r.runId}" }.`:`It is not resumable; submit a new explicit run.`;return S(`Run '${r.runId}' is suspended. ${e}`,{suspended:A(r)})}let i=this.management.status(n);if(!i.runDir&&!i.resultPath&&!r)throw new o.DoomTeamExpectedError(`run_not_found`,`No run matches '${n}'.`,!1,`Call subagent({"action":"status"}) and retry with an exact id.`);return e.transcriptLines===void 0?S(i.status?`Run '${i.runId}': ${i.status.state}`:`Run '${i.runId}' has no status yet.`,{status:i}):S(h.formatRunTranscript(i.status,e.transcriptLines??80),{transcript:{runId:i.runId}})}case y.SUBAGENT_ACTIONS.wait:{let r=e.ids?.map(e=>d.resolveTrackedRunId(l,e)),i=await this.waiter.wait({target:r?{ids:r}:{all:!0},sessionId:t.sessionManager.getSessionId(),waitFor:e.until,timeoutMs:e.timeoutMs,signal:n});return S([`Subagent wait: ${i.reason}.`,...T(i.reason)].join(`
+`),{outcome:i})}case y.SUBAGENT_ACTIONS.stop:{let t=d.resolveTrackedRunId(l,e.id),n=this.management.stop(t,e.reason);return S(`Stop requested for '${t}'.`,{control:n})}case y.SUBAGENT_ACTIONS.steer:{let t=d.resolveTrackedRunId(l,e.id),r=this.tracker.get(t)?.runtime;if(r&&!s.isPiRuntime(r))throw new o.DoomTeamExpectedError(`unsupported_operation`,`Run '${t}' uses '${r}', which does not support steering.`,!1,`Use subagent({"action":"stop","id":"${t}"}) to terminate it.`);let i=await this.management.steer(t,e.message,void 0,n);return S(`Steer request '${i.requestId}' for '${t}' is ${i.state}: ${i.message}`,{steer:i})}case y.SUBAGENT_ACTIONS.suspended:{let e=f.listSuspendedRuns(a.requireCurrentSessionScope());return S(e.length?f.formatSuspendedRuns(e):`No suspended subagents in this session.`,{suspended:e.map(A)})}case y.SUBAGENT_ACTIONS.restore:{let n=a.requireCurrentSessionScope(),s=f.listSuspendedRuns(n).find(t=>t.runId===e.id);if(!s)throw new o.DoomTeamExpectedError(`run_not_found`,`No suspended run matches '${e.id}'.`,!1,`Call subagent({"action":"suspended"}) and retry with an exact id.`);if(!f.isSuspendedRunResumable(s))throw new o.DoomTeamExpectedError(`not_resumable`,`Suspended run '${e.id}' does not have complete, readable Pi recovery state.`,!1,`Submit a new explicit run request instead of restoring this record.`);let l=this.trackOutcomes(await this.planner.spawn({single:{agent:s.agent,...s.inlineAgent?{inlineAgent:s.inlineAgent}:{},task:s.task,cwd:s.cwd,...s.model?{model:s.model}:{},sessionFile:s.sessionFile},cwd:s.cwd,agentScope:`both`,runtime:`pi`,availableModels:c.authenticatedModelInfos(t.modelRegistry),...i?{operationId:i}:{},...r?{preallocatedRunIds:r}:{}},p.loadConfig().config),t).outcomes[0];if(!l?.runId)throw new o.DoomTeamExpectedError(`not_resumable`,`Could not restore '${e.id}': ${l?.error??`the spawn produced no run.`}`,!0,`Inspect suspended state, then submit a new explicit run if recovery is not possible.`);return f.clearSuspendedRun(n,e.id),S(`Restored '${e.id}' as '${l.runId}', continuing its transcript.`,{restore:{...l,restoredFrom:e.id}})}}}buildTool(){return{name:b,label:`Subagent`,description:g.SUBAGENT_TOOL_DESCRIPTION,parameters:y.SubagentParams,prepareArguments:P,execute:async(e,t,n,r,i)=>{let a=P(t),s=w(a);if(s&&r?.(C(s,a.action)),a.action===y.SUBAGENT_ACTIONS.run)return this.executeRun(e,a,i);if(a.action===y.SUBAGENT_ACTIONS.agents)return this.executeAgents(a,i);if(!(a.action===y.SUBAGENT_ACTIONS.steer||a.action===y.SUBAGENT_ACTIONS.stop||a.action===y.SUBAGENT_ACTIONS.restore))return this.executeManagement(a,i,n);let c=m.startOperation(e,a,a.action===y.SUBAGENT_ACTIONS.restore?[(0,v.randomUUID)()]:[]);if(c.kind===`replay`){if(c.record.state===`completed`&&c.record.result)return c.record.result;throw new o.DoomTeamExpectedError(`delivery_unconfirmed`,`Operation '${e}' is already pending.`,!0,`Inspect run status before retrying this control operation.`)}let l=await this.executeManagement(a,i,n,c.record.runIds,e);return m.completeOperation(e,c.record,l),l}}}};F=t.__decorate([(0,_.injectable)(),i.__decorateParam(0,(0,_.inject)(n.DOOM_TEAM_TYPES.SpawnPlanner)),i.__decorateParam(1,(0,_.inject)(n.DOOM_TEAM_TYPES.ManagementActions)),i.__decorateParam(2,(0,_.inject)(n.DOOM_TEAM_TYPES.AsyncJobTracker)),i.__decorateParam(3,(0,_.inject)(n.DOOM_TEAM_TYPES.AgentDiscoveryService)),i.__decorateParam(4,(0,_.inject)(n.DOOM_TEAM_TYPES.SubagentWaiter)),r.__decorateMetadata(`design:paramtypes`,[Object,Object,Object,Object,Object])],F),Object.defineProperty(exports,`SubagentToolService`,{enumerable:!0,get:function(){return F}});
+//# sourceMappingURL=subagentTool.cjs.map