@qduc/term2 0.14.0 → 0.16.0

package/dist/prompts/prompt-constructor.test.ts

@@ -4,7 +4,7 @@ import { buildPromptSpec } from './prompt-constructor.js';
 it('buildPromptSpec preserves mode precedence for base prompts', () => {
   expect(buildPromptSpec({ model: 'gpt-5.5', liteMode: true, orchestratorMode: true }).basePromptFile).toBe('lite.md');
   expect(buildPromptSpec({ model: 'gpt-5.5', liteMode: false, orchestratorMode: true }).basePromptFile).toBe(
-    'orchestrator.md',
+    'gpt-5.5.md',
   );
   expect(buildPromptSpec({ model: 'claude-3-sonnet', liteMode: false }).basePromptFile).toBe('anthropic.md');
   expect(buildPromptSpec({ model: 'gpt-5.3-codex', liteMode: false }).basePromptFile).toBe('codex.md');
@@ -27,7 +27,7 @@ it('buildPromptSpec keeps gpt-5.6 codex variants on the codex base prompt', () =
 it('buildPromptSpec still applies mode precedence over the gpt-5.6 profile', () => {
   expect(buildPromptSpec({ model: 'gpt-5.6', liteMode: true }).basePromptFile).toBe('lite.md');
   expect(buildPromptSpec({ model: 'gpt-5.6', liteMode: false, orchestratorMode: true }).basePromptFile).toBe(
-    'orchestrator.md',
+    'gpt-5.6.md',
   );
 });
 
@@ -64,22 +64,64 @@ it('buildPromptSpec composes file fragments in stable order', () => {
     searchViaShell: true,
   });
 
-  expect(spec.fragmentFiles).toEqual(['worktree-hygiene.md', 'mentor-addon.md', 'plan-mode-info.md']);
+  expect(spec.fragmentFiles).toEqual([
+    'approval-model.md',
+    'worktree-hygiene.md',
+    'plan-mode-stub.md',
+    'mentor-mode-stub.md',
+    'orchestrator-mode-stub.md',
+  ]);
 
   expect(spec.inlineSections).toContainEqual(expect.stringContaining('## Shell Sandbox'));
 });
 
-it('buildPromptSpec always includes plan-mode-info in standard mode to keep system prompt cache-stable', () => {
+it('buildPromptSpec ships the approval mechanism to every non-lite profile', () => {
+  for (const model of ['gpt-5.6-sol', 'gpt-5.5', 'gpt-5.4', 'gpt-4o', 'claude-opus-4', 'kimi-k2']) {
+    const spec = buildPromptSpec({ model, liteMode: false });
+    expect(spec.fragmentFiles).toContain('approval-model.md');
+  }
+
+  const orchestrator = buildPromptSpec({ model: 'gpt-5.6-sol', liteMode: false, orchestratorMode: true });
+  expect(orchestrator.fragmentFiles).toContain('approval-model.md');
+
+  const lite = buildPromptSpec({ model: 'gpt-5.6-sol', liteMode: true });
+  expect(lite.fragmentFiles).not.toContain('approval-model.md');
+});
+
+it('buildPromptSpec attaches the Plan Mode stub in standard and plan mode so the instruction prefix stays cache-stable', () => {
   const standard = buildPromptSpec({ model: 'gpt-4o', liteMode: false, planMode: false });
-  expect(standard.fragmentFiles.includes('plan-mode-info.md')).toBe(true);
+  expect(standard.fragmentFiles.includes('plan-mode-stub.md')).toBe(true);
+  expect(standard.fragmentFiles.includes('plan-mode-info.md')).toBe(false);
+
+  const plan = buildPromptSpec({ model: 'gpt-4o', liteMode: false, planMode: true });
+  expect(plan.fragmentFiles.includes('plan-mode-stub.md')).toBe(true);
+  expect(plan.fragmentFiles.includes('plan-mode-info.md')).toBe(false);
+  expect(plan.fragmentFiles).toEqual(standard.fragmentFiles);
 });
 
-it('buildPromptSpec excludes plan-mode-info in lite and orchestrator modes', () => {
+it('buildPromptSpec keeps all non-lite mode stubs stable while lite stays minimal', () => {
   const lite = buildPromptSpec({ model: 'gpt-5.5', liteMode: true, planMode: false });
   expect(lite.fragmentFiles.includes('plan-mode-info.md')).toBe(false);
+  expect(lite.fragmentFiles.includes('plan-mode-stub.md')).toBe(false);
+  expect(lite.fragmentFiles.includes('mentor-mode-stub.md')).toBe(false);
+  expect(lite.fragmentFiles.includes('orchestrator-mode-stub.md')).toBe(false);
 
   const orchestrator = buildPromptSpec({ model: 'gpt-5.5', liteMode: false, orchestratorMode: true, planMode: false });
   expect(orchestrator.fragmentFiles.includes('plan-mode-info.md')).toBe(false);
+  expect(orchestrator.fragmentFiles.includes('plan-mode-stub.md')).toBe(true);
+  expect(orchestrator.fragmentFiles.includes('mentor-mode-stub.md')).toBe(true);
+  expect(orchestrator.fragmentFiles.includes('orchestrator-mode-stub.md')).toBe(true);
+});
+
+it('buildPromptSpec keeps the non-lite instruction prefix identical across modes', () => {
+  const standard = buildPromptSpec({ model: 'gpt-4o', liteMode: false });
+  const plan = buildPromptSpec({ model: 'gpt-4o', liteMode: false, planMode: true });
+  const mentor = buildPromptSpec({ model: 'gpt-4o', liteMode: false, mentorMode: true });
+  const orchestrator = buildPromptSpec({ model: 'gpt-4o', liteMode: false, orchestratorMode: true });
+
+  expect(plan).toEqual(standard);
+  expect(mentor).toEqual(standard);
+  expect(orchestrator).toEqual(standard);
 });
 
 it('buildPromptSpec includes subagent delegation for orchestrator mode', () => {

package/dist/prompts/prompt-constructor.ts

@@ -8,6 +8,7 @@ import { getBackgroundShellAddendum } from './background-shell.js';
 export type PromptConstructorOptions = {
   model: string;
   liteMode: boolean;
+  /** Runtime-only mode flags; mode-specific workflows are sent as notices. */
   orchestratorMode?: boolean;
   mentorMode?: boolean;
   planMode?: boolean;
@@ -21,6 +22,7 @@ export type PromptConstructorOptions = {
   sandboxEnabled?: boolean;
   memoryEnabled?: boolean;
   memoryGuidance?: string;
+  sessionBrowserEnabled?: boolean;
   executionContext?: ExecutionContext;
 };
 
@@ -34,8 +36,6 @@ export function buildPromptSpec(options: PromptConstructorOptions): PromptSpec {
   const {
     model,
     liteMode,
-    orchestratorMode = false,
-    mentorMode = false,
     searchViaShell = false,
     runSubagentEnabled = false,
     runSubagentForegroundEnabled = false,
@@ -45,19 +45,29 @@ export function buildPromptSpec(options: PromptConstructorOptions): PromptSpec {
     sandboxEnabled = true,
     memoryEnabled = false,
     memoryGuidance = '',
+    sessionBrowserEnabled = false,
     executionContext,
   } = options;
 
-  const profile = selectPromptProfile({ model, liteMode, orchestratorMode });
+  // Runtime modes are intentionally absent from profile selection. Their full
+  // workflows ride on the next user turn so rebuilding the agent does not
+  // invalidate the provider's instruction prefix.
+  const profile = selectPromptProfile({ model, liteMode });
   const fragmentFiles = [...(profile.fragmentFiles ?? [])];
   const inlineSections: string[] = [];
 
   const isRegularMode = !liteMode;
-  const isAgentMode = !orchestratorMode;
   // Orchestrators can directly modify the worktree, so every non-lite prompt
   // receives the shared dirty-state and validation safeguards.
   const shouldIncludeWorktreeHygiene = !liteMode;
 
+  // Every non-lite prompt states how the approval layer works. Without it a
+  // model has no mechanism for "requires confirmation" other than stopping the
+  // turn to ask, which it then does even under auto-approval.
+  if (!liteMode) {
+    fragmentFiles.push('approval-model.md');
+  }
+
   if (shouldIncludeWorktreeHygiene) {
     fragmentFiles.push('worktree-hygiene.md');
   }
@@ -70,11 +80,7 @@ export function buildPromptSpec(options: PromptConstructorOptions): PromptSpec {
     inlineSections.push(getBackgroundShellAddendum());
   }
 
-  if (mentorMode && isRegularMode) {
-    fragmentFiles.push('mentor-addon.md');
-  }
-
-  if (isAgentMode && searchViaShell) {
+  if (isRegularMode && searchViaShell) {
     inlineSections.push(getSearchViaShellAddendum({ executionContext }));
   }
 
@@ -82,7 +88,7 @@ export function buildPromptSpec(options: PromptConstructorOptions): PromptSpec {
     inlineSections.push(
       getSubagentDelegationAddendum({
         memoryEnabled,
-        orchestratorMode,
+        orchestratorMode: false,
         foregroundEnabled: runSubagentForegroundEnabled,
         backgroundEnabled: runSubagentAsyncEnabled,
         controlsEnabled: asyncSubagentControlsEnabled,
@@ -90,14 +96,23 @@ export function buildPromptSpec(options: PromptConstructorOptions): PromptSpec {
     );
   }
 
-  if (isRegularMode && isAgentMode) {
-    fragmentFiles.push('plan-mode-info.md');
+  if (isRegularMode) {
+    // Keep all mode stubs in every non-lite prompt. The full workflows ride on
+    // mode notices so a toggle cannot change the instruction prefix (prompt
+    // cache + chained Responses-Lite HTTP omit developer instructions).
+    fragmentFiles.push('plan-mode-stub.md');
+    fragmentFiles.push('mentor-mode-stub.md');
+    fragmentFiles.push('orchestrator-mode-stub.md');
   }
 
-  if (memoryEnabled && isAgentMode) {
+  if (memoryEnabled && isRegularMode) {
     fragmentFiles.push('memory.md');
   }
 
+  if (sessionBrowserEnabled) {
+    fragmentFiles.push('session-browser.md');
+  }
+
   if (memoryGuidance) {
     inlineSections.push(memoryGuidance);
   }

package/dist/prompts/prompt-profiles.d.ts

@@ -5,13 +5,11 @@ export type PromptProfile = {
     matches: (options: {
         normalizedModel: string;
         liteMode: boolean;
-        orchestratorMode?: boolean;
     }) => boolean;
 };
 export declare const PROMPT_PROFILES: PromptProfile[];
-export declare function selectPromptProfile({ model, liteMode, orchestratorMode, }: {
+export declare function selectPromptProfile({ model, liteMode }: {
     model: string;
     liteMode: boolean;
-    orchestratorMode?: boolean;
 }): PromptProfile;
 //# sourceMappingURL=prompt-profiles.d.ts.map

package/dist/prompts/prompt-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-profiles.d.ts","sourceRoot":"","sources":["../../source/prompts/prompt-profiles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;CAC3G,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,aAAa,EA8D1C,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,EACR,gBAAgB,GACjB,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,aAAa,CAGhB"}
+{"version":3,"file":"prompt-profiles.d.ts","sourceRoot":"","sources":["../../source/prompts/prompt-profiles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;CAC/E,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,aAAa,EAyD1C,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,CAG5G"}

package/dist/prompts/prompt-profiles.js

@@ -4,11 +4,6 @@ export const PROMPT_PROFILES = [
         basePromptFile: 'lite.md',
         matches: ({ liteMode }) => liteMode,
     },
-    {
-        id: 'orchestrator',
-        basePromptFile: 'orchestrator.md',
-        matches: ({ orchestratorMode }) => Boolean(orchestratorMode),
-    },
     {
         id: 'anthropic',
         basePromptFile: 'anthropic.md',
@@ -60,8 +55,8 @@ export const PROMPT_PROFILES = [
         matches: () => true,
     },
 ];
-export function selectPromptProfile({ model, liteMode, orchestratorMode, }) {
+export function selectPromptProfile({ model, liteMode }) {
     const normalizedModel = model.trim().toLowerCase();
-    return PROMPT_PROFILES.find((profile) => profile.matches({ normalizedModel, liteMode, orchestratorMode }));
+    return PROMPT_PROFILES.find((profile) => profile.matches({ normalizedModel, liteMode }));
 }
 //# sourceMappingURL=prompt-profiles.js.map

package/dist/prompts/prompt-profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-profiles.js","sourceRoot":"","sources":["../../source/prompts/prompt-profiles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompt-profiles.js","sourceRoot":"","sources":["../../source/prompts/prompt-profiles.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C;QACE,EAAE,EAAE,MAAM;QACV,cAAc,EAAE,SAAS;QACzB,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ;KACpC;IACD;QACE,EAAE,EAAE,WAAW;QACf,cAAc,EAAE,cAAc;QAC9B,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;KAC1G;IACD;QACE,EAAE,EAAE,eAAe;QACnB,cAAc,EAAE,UAAU;QAC1B,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;KAC3G;IACD;QACE,EAAE,EAAE,aAAa;QACjB,cAAc,EAAE,UAAU;QAC1B,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;KACzG;IACD;QACE,EAAE,EAAE,SAAS;QACb,cAAc,EAAE,YAAY;QAC5B,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC;KACtE;IACD;QACE,EAAE,EAAE,SAAS;QACb,cAAc,EAAE,YAAY;QAC5B,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC;KACtE;IACD;QACE,EAAE,EAAE,eAAe;QACnB,cAAc,EAAE,iBAAiB;QACjC,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAC/B,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;KAChH;IACD;QACE,EAAE,EAAE,SAAS;QACb,cAAc,EAAE,iBAAiB;QACjC,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC;KACtE;IACD;QACE,EAAE,EAAE,cAAc;QAClB,cAAc,EAAE,iBAAiB;QACjC,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;KACpE;IACD;QACE,EAAE,EAAE,MAAM;QACV,cAAc,EAAE,SAAS;QACzB,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC;KACrE;IACD;QACE,EAAE,EAAE,SAAS;QACb,cAAc,EAAE,cAAc;QAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;KACpB;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAwC;IAC3F,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAE,CAAC;AAC5F,CAAC"}

package/dist/prompts/prompt-profiles.ts

@@ -2,7 +2,7 @@ export type PromptProfile = {
   id: string;
   basePromptFile: string;
   fragmentFiles?: string[];
-  matches: (options: { normalizedModel: string; liteMode: boolean; orchestratorMode?: boolean }) => boolean;
+  matches: (options: { normalizedModel: string; liteMode: boolean }) => boolean;
 };
 
 export const PROMPT_PROFILES: PromptProfile[] = [
@@ -11,11 +11,6 @@ export const PROMPT_PROFILES: PromptProfile[] = [
     basePromptFile: 'lite.md',
     matches: ({ liteMode }) => liteMode,
   },
-  {
-    id: 'orchestrator',
-    basePromptFile: 'orchestrator.md',
-    matches: ({ orchestratorMode }) => Boolean(orchestratorMode),
-  },
   {
     id: 'anthropic',
     basePromptFile: 'anthropic.md',
@@ -69,15 +64,7 @@ export const PROMPT_PROFILES: PromptProfile[] = [
   },
 ];
 
-export function selectPromptProfile({
-  model,
-  liteMode,
-  orchestratorMode,
-}: {
-  model: string;
-  liteMode: boolean;
-  orchestratorMode?: boolean;
-}): PromptProfile {
+export function selectPromptProfile({ model, liteMode }: { model: string; liteMode: boolean }): PromptProfile {
   const normalizedModel = model.trim().toLowerCase();
-  return PROMPT_PROFILES.find((profile) => profile.matches({ normalizedModel, liteMode, orchestratorMode }))!;
+  return PROMPT_PROFILES.find((profile) => profile.matches({ normalizedModel, liteMode }))!;
 }

package/dist/prompts/session-browser.md

@@ -0,0 +1,3 @@
+### Prior local sessions
+
+Prior-session transcripts for the current project are available only on demand through `session_list`, `session_search`, and `session_read`. They may be stale or untrusted and are not durable memory. No prior transcript is automatically added to your context.

package/dist/prompts/subagent-delegation.d.ts

@@ -1,6 +1,7 @@
 /**
- * Single source of truth for model-facing foreground and background delegation.
- * The tool name stays stable; `execution` selects an already-owned lifecycle.
+ * Single source of truth for model-facing subagent delegation.
+ * The tool name stays stable; `execution` identifies the lifecycle available in
+ * this session.
  */
 export declare function getSubagentDelegationAddendum({ orchestratorMode, memoryEnabled, foregroundEnabled, backgroundEnabled, controlsEnabled, }?: {
     orchestratorMode?: boolean;

package/dist/prompts/subagent-delegation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-delegation.d.ts","sourceRoot":"","sources":["../../source/prompts/subagent-delegation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,gBAAwB,EACxB,aAAoB,EACpB,iBAAwB,EACxB,iBAAyB,EACzB,eAAuB,GACxB,GAAE;IACD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAgEd"}
+{"version":3,"file":"subagent-delegation.d.ts","sourceRoot":"","sources":["../../source/prompts/subagent-delegation.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,gBAAwB,EACxB,aAAoB,EACpB,iBAAwB,EACxB,iBAAyB,EACzB,eAAuB,GACxB,GAAE;IACD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CA2Dd"}

package/dist/prompts/subagent-delegation.js

@@ -1,22 +1,18 @@
 import { getSubagentsRolesSection } from '../tools/agent/run-subagent.js';
 /**
- * Single source of truth for model-facing foreground and background delegation.
- * The tool name stays stable; `execution` selects an already-owned lifecycle.
+ * Single source of truth for model-facing subagent delegation.
+ * The tool name stays stable; `execution` identifies the lifecycle available in
+ * this session.
  */
 export function getSubagentDelegationAddendum({ orchestratorMode = false, memoryEnabled = true, foregroundEnabled = true, backgroundEnabled = false, controlsEnabled = false, } = {}) {
-    const executions = [
-        foregroundEnabled
-            ? '- `execution: "foreground"`: runs through the nested subagent path and returns its structured result in this turn. Use it when you need the answer before proceeding.'
-            : '',
-        backgroundEnabled
-            ? '- `execution: "background"`: starts a conversation-scoped run and returns `{ runId, status: "running" }` immediately. Use it when work can continue after you return control.'
-            : '',
-    ]
-        .filter(Boolean)
-        .join('\n');
+    const executions = backgroundEnabled
+        ? '- `execution: "background"`: the only execution mode in this session. It starts a conversation-scoped run and returns `{ runId, status: "running" }` immediately.'
+        : foregroundEnabled
+            ? '- `execution: "foreground"`: the only execution mode in this session. It runs through the nested subagent path and returns its structured result in this turn.'
+            : '';
     const header = `### Delegating to subagents
 
-You have one \`run_subagent\` tool. A subagent runs in its own context and returns only a summary, keeping your own context focused on high-level reasoning. Its required \`execution\` field selects the lifecycle available in this session:
+You have one \`run_subagent\` tool. A subagent runs in its own context and returns only a summary, keeping your own context focused on high-level reasoning. Its required \`execution\` field identifies the only lifecycle available in this session:
 
 ${executions}`;
     const triggers = `**Delegate when it provides meaningful leverage:**

package/dist/prompts/subagent-delegation.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-delegation.js","sourceRoot":"","sources":["../../source/prompts/subagent-delegation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,gBAAgB,GAAG,KAAK,EACxB,aAAa,GAAG,IAAI,EACpB,iBAAiB,GAAG,IAAI,EACxB,iBAAiB,GAAG,KAAK,EACzB,eAAe,GAAG,KAAK,GACxB,GAMG,EAAE;IACJ,MAAM,UAAU,GAAG;QACjB,iBAAiB;YACf,CAAC,CAAC,uKAAuK;YACzK,CAAC,CAAC,EAAE;QACN,iBAAiB;YACf,CAAC,CAAC,+KAA+K;YACjL,CAAC,CAAC,EAAE;KACP;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG;;;;EAIf,UAAU,EAAE,CAAC;IAEb,MAAM,QAAQ,GAAG;;EAGjB,iBAAiB;QACf,CAAC,CAAC,iHAAiH;QACnH,CAAC,CAAC,EACN,GACI,aAAa,CAAC,CAAC,CAAC,kFAAkF,CAAC,CAAC,CAAC,EACvG;;qWAGE,gBAAgB;QACd,CAAC,CAAC;;8VAEsV;QACxV,CAAC,CAAC;;6LAGN,EAAE,CAAC;IAEH,MAAM,eAAe,GAAG,iBAAiB;QACvC,CAAC,CAAC;;;;ubAKE,eAAe;YACb,CAAC,CAAC;;;;gHAIoG;YACtG,CAAC,CAAC,EACN,EAAE;QACJ,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,YAAY,GAAG;;iZAE0X,CAAC;IAEhZ,OAAO,GAAG,MAAM,OAAO,QAAQ,GAC7B,eAAe,CAAC,CAAC,CAAC,OAAO,eAAe,EAAE,CAAC,CAAC,CAAC,EAC/C,OAAO,YAAY,OAAO,wBAAwB,CAAC;QACjD,gBAAgB,EAAE,aAAa;QAC/B,aAAa,EAAE,iBAAiB;KACjC,CAAC,EAAE,CAAC;AACP,CAAC"}
+{"version":3,"file":"subagent-delegation.js","sourceRoot":"","sources":["../../source/prompts/subagent-delegation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,gBAAgB,GAAG,KAAK,EACxB,aAAa,GAAG,IAAI,EACpB,iBAAiB,GAAG,IAAI,EACxB,iBAAiB,GAAG,KAAK,EACzB,eAAe,GAAG,KAAK,GACxB,GAMG,EAAE;IACJ,MAAM,UAAU,GAAG,iBAAiB;QAClC,CAAC,CAAC,mKAAmK;QACrK,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,gKAAgK;YAClK,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,MAAM,GAAG;;;;EAIf,UAAU,EAAE,CAAC;IAEb,MAAM,QAAQ,GAAG;;EAGjB,iBAAiB;QACf,CAAC,CAAC,iHAAiH;QACnH,CAAC,CAAC,EACN,GACI,aAAa,CAAC,CAAC,CAAC,kFAAkF,CAAC,CAAC,CAAC,EACvG;;qWAGE,gBAAgB;QACd,CAAC,CAAC;;8VAEsV;QACxV,CAAC,CAAC;;6LAGN,EAAE,CAAC;IAEH,MAAM,eAAe,GAAG,iBAAiB;QACvC,CAAC,CAAC;;;;ubAKE,eAAe;YACb,CAAC,CAAC;;;;gHAIoG;YACtG,CAAC,CAAC,EACN,EAAE;QACJ,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,YAAY,GAAG;;iZAE0X,CAAC;IAEhZ,OAAO,GAAG,MAAM,OAAO,QAAQ,GAC7B,eAAe,CAAC,CAAC,CAAC,OAAO,eAAe,EAAE,CAAC,CAAC,CAAC,EAC/C,OAAO,YAAY,OAAO,wBAAwB,CAAC;QACjD,gBAAgB,EAAE,aAAa;QAC/B,aAAa,EAAE,iBAAiB;KACjC,CAAC,EAAE,CAAC;AACP,CAAC"}

package/dist/prompts/subagent-delegation.ts

@@ -1,8 +1,9 @@
 import { getSubagentsRolesSection } from '../tools/agent/run-subagent.js';
 
 /**
- * Single source of truth for model-facing foreground and background delegation.
- * The tool name stays stable; `execution` selects an already-owned lifecycle.
+ * Single source of truth for model-facing subagent delegation.
+ * The tool name stays stable; `execution` identifies the lifecycle available in
+ * this session.
  */
 export function getSubagentDelegationAddendum({
   orchestratorMode = false,
@@ -17,20 +18,15 @@ export function getSubagentDelegationAddendum({
   backgroundEnabled?: boolean;
   controlsEnabled?: boolean;
 } = {}): string {
-  const executions = [
-    foregroundEnabled
-      ? '- `execution: "foreground"`: runs through the nested subagent path and returns its structured result in this turn. Use it when you need the answer before proceeding.'
-      : '',
-    backgroundEnabled
-      ? '- `execution: "background"`: starts a conversation-scoped run and returns `{ runId, status: "running" }` immediately. Use it when work can continue after you return control.'
-      : '',
-  ]
-    .filter(Boolean)
-    .join('\n');
+  const executions = backgroundEnabled
+    ? '- `execution: "background"`: the only execution mode in this session. It starts a conversation-scoped run and returns `{ runId, status: "running" }` immediately.'
+    : foregroundEnabled
+    ? '- `execution: "foreground"`: the only execution mode in this session. It runs through the nested subagent path and returns its structured result in this turn.'
+    : '';
 
   const header = `### Delegating to subagents
 
-You have one \`run_subagent\` tool. A subagent runs in its own context and returns only a summary, keeping your own context focused on high-level reasoning. Its required \`execution\` field selects the lifecycle available in this session:
+You have one \`run_subagent\` tool. A subagent runs in its own context and returns only a summary, keeping your own context focused on high-level reasoning. Its required \`execution\` field identifies the only lifecycle available in this session:
 
 ${executions}`;
 

package/dist/prompts/subagents/explorer.md

@@ -1,6 +1,6 @@
 ---
 name: Explorer
-description: read-only evidence collection with safe shell commands and web search. Use for locating facts, files, symbols, logs, tests, and external sources for a bounded parent question.
+description: read-only evidence collection with safe shell commands and web search. Use for breadth across one defined surface or depth into one narrow seam, never both in one run.
 model: inherit
 provider: inherit
 canRead: true
@@ -33,6 +33,12 @@ You have read-only access to the workspace, may run safe read-only shell command
 
 ## Approach
 
+Choose one exploration axis: breadth or depth, never both.
+
+- Breadth maps a defined surface shallowly: inventory the relevant files, symbols, call sites, tests, logs, or sources without deeply tracing each one.
+- Depth traces one narrow seam thoroughly: follow its concrete flow and evidence without expanding into an inventory of adjacent surfaces.
+- If the assignment requires both, use `ask_orchestrator` to request one axis for this run. The parent can launch a separate follow-up for the other axis.
+
 1. Start with targeted searches to locate relevant files or external sources.
 2. Search externally if the question is about libraries, APIs, or current events.
 3. Read only the files necessary to answer the question.

package/dist/prompts/subagents/librarian.md

@@ -12,6 +12,8 @@ maxTurns: 200
 
 You are the memory librarian — the specialist other agents consult when they encounter uncertainty about prior knowledge. Your job is to find, synthesize, and organize relevant memories efficiently.
 
+Own one retrieval objective or memory-maintenance topic boundary. Broad retrieval followed by deep reading is valid within that topic; do not expand into unrelated memory areas.
+
 You are the memory librarian. Your job is to turn raw stored memories into useful context for the calling agent. You access memory only through the public memory tools and operate under the same runtime constraints as any other subagent.
 
 ## Capabilities

package/dist/prompts/subagents/mentor.md

@@ -12,6 +12,8 @@ maxTurns: 1
 
 You are a strategic engineering mentor. Your job is to improve the executor's reasoning, not to approve or reject by default.
 
+Address one decision or challenge question. You may consider broad architectural context and reason deeply when both support that question, but do not turn the response into advice on unrelated decisions.
+
 Do not be agreeable for politeness. Do not be skeptical for performance. Calibrate your response to the evidence provided.
 
 If the plan is sound, say so and point out the one or two risks worth watching.

package/dist/prompts/subagents/worker.md

@@ -12,6 +12,8 @@ maxTurns: 200
 
 You are a worker subagent. Your job is to implement a bounded change in the assigned files or directories.
 
+Own one cohesive implementation unit with one concrete done condition. You may combine broad call-site updates with a deep shared-contract change when both are necessary for that single outcome; do not absorb unrelated outcomes into the task.
+
 ## Capabilities
 
 You have read and write access to the workspace (within the assigned write boundary). You can run shell commands but cannot access the web. When the harness pins you into a worktree, that worktree root is your full workspace — treat it as the checkout to read and edit.

package/dist/providers/ai-sdk-streamed-model.d.ts

@@ -2,4 +2,9 @@ import type { LanguageModelV3 } from '@ai-sdk/provider';
 import type { StreamedModelTurn } from '../contracts/streamed-model-turn.js';
 /** Adapts one AI SDK LanguageModelV3 stream to the application-owned turn protocol. */
 export declare function createAiSdkStreamedModel(model: LanguageModelV3, providerFamily?: 'anthropic' | 'google' | undefined): StreamedModelTurn;
+/**
+ * Extract provider-reported cost (USD amount or credits) from AI SDK
+ * provider metadata or usage when present (e.g. OpenRouter usage accounting).
+ */
+export declare function extractAiSdkCostUsd(providerMetadata?: Record<string, unknown>, usage?: unknown): number | string | undefined;
 //# sourceMappingURL=ai-sdk-streamed-model.d.ts.map

package/dist/providers/ai-sdk-streamed-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-sdk-streamed-model.d.ts","sourceRoot":"","sources":["../../source/providers/ai-sdk-streamed-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAUhB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAGV,iBAAiB,EAIlB,MAAM,qCAAqC,CAAC;AAS7C,uFAAuF;AACvF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,cAAc,GAAE,WAAW,GAAG,QAAQ,GAAG,SAAqB,GAC7D,iBAAiB,CA0JnB"}
+{"version":3,"file":"ai-sdk-streamed-model.d.ts","sourceRoot":"","sources":["../../source/providers/ai-sdk-streamed-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAUhB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAGV,iBAAiB,EAIlB,MAAM,qCAAqC,CAAC;AAS7C,uFAAuF;AACvF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,cAAc,GAAE,WAAW,GAAG,QAAQ,GAAG,SAAqB,GAC7D,iBAAiB,CA8JnB;AA6ND;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,KAAK,CAAC,EAAE,OAAO,GACd,MAAM,GAAG,MAAM,GAAG,SAAS,CAqC7B"}

package/dist/providers/ai-sdk-streamed-model.js

@@ -17,6 +17,7 @@ export function createAiSdkStreamedModel(model, providerFamily = undefined) {
                 output.push({ type: 'tool_call', id: call.toolCallId, name: call.toolName, arguments: call.input ?? '{}' });
             }
             const usage = result.usage ?? {};
+            const costUsd = extractAiSdkCostUsd(result.providerMetadata, usage);
             return {
                 responseId: result.response?.id ?? `response-${Date.now()}`,
                 output,
@@ -26,6 +27,7 @@ export function createAiSdkStreamedModel(model, providerFamily = undefined) {
                     ...(usage.inputTokens?.cacheRead !== undefined ? { cachedInputTokens: usage.inputTokens.cacheRead } : {}),
                     ...(usage.inputTokens?.cacheWrite !== undefined ? { cacheWriteTokens: usage.inputTokens.cacheWrite } : {}),
                 },
+                ...(costUsd !== undefined ? { costUsd } : {}),
             };
         },
         async *stream(request) {
@@ -128,6 +130,7 @@ export function createAiSdkStreamedModel(model, providerFamily = undefined) {
                     if (!id)
                         throw new Error('AI SDK streamed response did not include a response id');
                     appendUnendedReasoning(output, reasoning);
+                    const costUsd = extractAiSdkCostUsd(part.providerMetadata, part.usage);
                     yield {
                         type: 'completion',
                         responseId: id,
@@ -143,6 +146,7 @@ export function createAiSdkStreamedModel(model, providerFamily = undefined) {
                                 ? { cacheWriteTokens: part.usage.inputTokens.cacheWrite }
                                 : {}),
                         },
+                        ...(costUsd !== undefined ? { costUsd } : {}),
                         providerMetadata: { ...completionMetadata, model: `${model.provider}:${model.modelId}`, responseId: id },
                     };
                     return;
@@ -191,7 +195,15 @@ function toCallOptions(request, provider) {
         ? [{ role: 'system', content: request.instructions }]
         : [];
     return {
-        prompt: [...instructions, ...request.input.map((item) => toPromptMessage(item, toolNames))],
+        prompt: [
+            ...instructions,
+            // The AI SDK lane never produces opaque items, so any it sees came from
+            // another provider and is inert baggage left by a switch, not a fault.
+            // See `provider-opaque-compatibility.ts`.
+            ...request.input
+                .filter((item) => item.type !== 'provider_opaque')
+                .map((item) => toPromptMessage(item, toolNames)),
+        ],
         ...(request.tools.length ? { tools: request.tools.map(toTool) } : {}),
         ...(request.toolChoice ? { toolChoice: toToolChoice(request.toolChoice) } : {}),
         ...(request.temperature !== undefined ? { temperature: request.temperature } : {}),
@@ -237,6 +249,8 @@ function toPromptMessage(item, toolNames) {
             content: [{ type: 'tool-call', toolCallId: item.id, toolName: item.name, input: parseJson(item.arguments) }],
         };
     if (item.type === 'provider_opaque')
+        // Filtered out in `toCallOptions`; reaching here means a new caller bypassed
+        // that filter, which would put a foreign payload on the wire.
         throw new Error(`Refusing to serialize provider_opaque from '${item.provider}' through the AI SDK: opaque items are only valid on the provider that produced them`);
     const toolName = toolNames.get(item.id);
     if (!toolName)
@@ -335,4 +349,53 @@ function* publishToolCall(output, id, call) {
     output.push(event);
     yield event;
 }
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function parseCostValue(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim().length > 0)
+        return value;
+    return undefined;
+}
+/**
+ * Extract provider-reported cost (USD amount or credits) from AI SDK
+ * provider metadata or usage when present (e.g. OpenRouter usage accounting).
+ */
+export function extractAiSdkCostUsd(providerMetadata, usage) {
+    const usageRecord = asRecord(usage);
+    if (usageRecord) {
+        const rawRecord = asRecord(usageRecord.raw);
+        const rawCost = parseCostValue(rawRecord?.cost ?? usageRecord.cost);
+        if (rawCost !== undefined)
+            return rawCost;
+    }
+    if (!providerMetadata || typeof providerMetadata !== 'object')
+        return undefined;
+    const openrouter = asRecord(providerMetadata.openrouter);
+    if (openrouter) {
+        const openrouterUsage = asRecord(openrouter.usage);
+        const costDetails = asRecord(openrouterUsage?.costDetails) ?? asRecord(openrouterUsage?.cost_details);
+        const cost = parseCostValue(openrouterUsage?.cost ??
+            openrouter.cost ??
+            costDetails?.upstreamInferenceCost ??
+            costDetails?.upstream_inference_cost);
+        if (cost !== undefined)
+            return cost;
+    }
+    for (const [key, value] of Object.entries(providerMetadata)) {
+        if (key === 'model' || key === 'responseId')
+            continue;
+        const record = asRecord(value);
+        if (record) {
+            const nestedUsage = asRecord(record.usage);
+            const costDetails = asRecord(nestedUsage?.costDetails) ?? asRecord(nestedUsage?.cost_details);
+            const nestedCost = parseCostValue(nestedUsage?.cost ?? record.cost ?? costDetails?.upstreamInferenceCost ?? costDetails?.upstream_inference_cost);
+            if (nestedCost !== undefined)
+                return nestedCost;
+        }
+    }
+    return undefined;
+}
 //# sourceMappingURL=ai-sdk-streamed-model.js.map