@qduc/term2 0.29.1 → 0.31.0

package/dist/lib/subagent-bridge.d.ts

@@ -4,13 +4,17 @@ import type { ILoggingService, ISettingsService, ISessionContextService } from '
 import type { ExecutionContext } from '../services/execution-context.js';
 import type { NestedSubagentResult, SubagentCancelAcknowledgement, SubagentResult, SubagentRunStatus, SubagentSteerAcknowledgement } from '../services/subagents/types.js';
 import type { AgentRuntime } from '../services/agent-runtime/agent-runtime.js';
+import type { AgentSpec } from '../services/agent-runtime/types.js';
+import type { AgentSpecBoundaryResult } from '../services/agent-runtime/permission-boundary.js';
+import type { ResolvedAgentDefinition } from '../services/agent-runtime/resolved-agent.js';
 import type { SkillsService } from '../services/skills/skills-service.js';
 import type { SubagentRunHandle } from '../services/subagents/types.js';
 import type { ToolOwnershipRegistry } from '../services/approval/tool-ownership-registry.js';
-import type { BackgroundSubagentApprovalPauseSink } from '../services/subagents/foreground-subagent-lease.js';
+import type { BackgroundSubagentApprovalPauseSink, ForegroundSubagentApprovalCallback } from '../services/subagents/foreground-subagent-lease.js';
 import type { ForegroundSubagentCandidate } from '../services/subagents/nested-runner.js';
 import type { NestedToolCompatibilityState } from '../services/session/nested-tool-compatibility-state.js';
 import type { SessionBrowser } from '../services/conversation/session-browser.js';
+import type { SubagentDefinition } from '../services/subagents/types.js';
 export interface SubagentBridgeDeps {
     logger: ILoggingService;
     settings: ISettingsService;
@@ -38,6 +42,28 @@ export interface SubagentBridgeDeps {
     /** Root session transcript browser, lent to the librarian subagent. */
     sessionBrowser?: SessionBrowser;
 }
+/**
+ * Host-owned launch input for a resolved generic agent.
+ *
+ * This is intentionally separate from the raw `runSubagent` entry point. A
+ * caller must resolve and attenuate the AgentSpec before it can reach this
+ * seam; no VM-facing tool accepts this shape.
+ */
+export interface ResolvedSubagentLaunch {
+    /** A successful host boundary result, a new runtime definition, or a legacy
+     * manager-ready definition retained by compatibility callers. */
+    resolvedDefinition: AgentSpecBoundaryResult | ResolvedAgentDefinition | SubagentDefinition;
+    /** Boundary results carry their task in `spec.goal`; other definitions need
+     * an explicit task. */
+    task?: string;
+    /** A boundary result's validated worktree is used when this is omitted. */
+    worktree?: string;
+    authorizedWorktreePath?: string;
+    name?: string;
+    continue_run_id?: string;
+    /** Host-only approval owner for pauses in this awaited foreground child. */
+    foregroundChildApproval?: ForegroundSubagentApprovalCallback;
+}
 export declare class SubagentBridge {
     #private;
     constructor(deps: SubagentBridgeDeps);
@@ -93,14 +119,30 @@ export declare class SubagentBridge {
      */
     cancelBackgroundRuns(): void;
     createMentor: (question: string) => Promise<string>;
+    /**
+     * Run a host-resolved generic agent through the normal foreground tool
+     * lifecycle. The definition is deliberately handed to SubagentManager as
+     * `resolvedDefinition`; the manager therefore skips raw AgentSpec
+     * resolution while retaining nested approvals, the turn signal, worktree
+     * pinning, and traffic scoping.
+     */
+    runResolvedSubagent: (params: ResolvedSubagentLaunch, _context?: unknown, details?: unknown) => Promise<NestedSubagentResult>;
+    /**
+     * Start a host-resolved generic agent in the conversation-scoped async
+     * registry. Unlike the foreground method, this uses `backgroundSignal`, so
+     * an ordinary turn abort cannot cancel the retained run.
+     */
+    runResolvedSubagentAsync: (params: ResolvedSubagentLaunch) => Promise<SubagentRunHandle>;
     runSubagent: (params: {
-        role: string;
-        task: string;
+        role?: string;
+        task?: string;
+        agent_spec?: AgentSpec;
         worktree?: string;
     }, _context?: unknown, details?: unknown) => Promise<NestedSubagentResult>;
     runSubagentAsync: (params: {
-        role: string;
-        task: string;
+        role?: string;
+        task?: string;
+        agent_spec?: AgentSpec;
         name?: string;
         continue_run_id?: string;
         worktree?: string;

package/dist/lib/subagent-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-bridge.d.ts","sourceRoot":"","sources":["../../source/lib/subagent-bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subagent-bridge.d.ts","sourceRoot":"","sources":["../../source/lib/subagent-bridge.ts"],"names":[],"mappings":"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"}

package/dist/lib/subagent-bridge.js

@@ -1,6 +1,56 @@
 import { randomUUID } from 'node:crypto';
 import { SubagentManager } from '../services/subagents/subagent-manager.js';
+import { adaptLegacyDefinition } from '../services/agent-runtime/legacy-adapter.js';
+import { createRootBudget } from '../services/agent-runtime/execution-budget.js';
 import { createAbortError } from '../services/subagents/utils.js';
+function isBoundaryResult(value) {
+    return typeof value === 'object' && value !== null && 'ok' in value;
+}
+function toManagerDefinition(value) {
+    // A legacy definition is already the manager's immutable launch contract.
+    // Preserve its identity so host callers can verify that no second
+    // resolution or widening occurred in the bridge.
+    if (isLegacyDefinition(value))
+        return value;
+    const budget = createRootBudget({
+        maxChildren: value.limits.maxChildren,
+        maxDepth: value.limits.maxDepth,
+        maxConcurrency: value.limits.maxConcurrency,
+        maxTokens: value.limits.maxTokens,
+    });
+    return {
+        ...adaptLegacyDefinition(value, budget),
+        isRootExecution: true,
+    };
+}
+function isLegacyDefinition(value) {
+    return typeof value.model === 'string';
+}
+function normalizeResolvedLaunch(params) {
+    let definitionInput = params.resolvedDefinition;
+    let task = params.task;
+    let worktree = params.worktree;
+    let authorizedWorktreePath = params.authorizedWorktreePath;
+    if (isBoundaryResult(definitionInput)) {
+        if (!definitionInput.ok) {
+            throw new Error(`Agent specification rejected: ${definitionInput.errors.map((error) => error.message).join('; ')}`);
+        }
+        const successfulResult = definitionInput;
+        definitionInput = successfulResult.definition;
+        task ??= successfulResult.spec.goal;
+        worktree ??= successfulResult.worktree;
+        authorizedWorktreePath ??= successfulResult.authorizedWorktreePath;
+    }
+    if (!task) {
+        throw new Error('Resolved subagent launches require a non-empty task.');
+    }
+    return {
+        definition: toManagerDefinition(definitionInput),
+        task,
+        ...(worktree ? { worktree } : {}),
+        ...(authorizedWorktreePath ? { authorizedWorktreePath } : {}),
+    };
+}
 export class SubagentBridge {
     #subagentManager;
     #isDisposed = false;
@@ -251,14 +301,71 @@ export class SubagentBridge {
             endRun();
         }
     };
+    /**
+     * Run a host-resolved generic agent through the normal foreground tool
+     * lifecycle. The definition is deliberately handed to SubagentManager as
+     * `resolvedDefinition`; the manager therefore skips raw AgentSpec
+     * resolution while retaining nested approvals, the turn signal, worktree
+     * pinning, and traffic scoping.
+     */
+    runResolvedSubagent = async (params, _context, details) => {
+        if (!this.#subagentManager) {
+            throw new Error('Transient agent clients cannot spawn subagents.');
+        }
+        const launch = normalizeResolvedLaunch(params);
+        const detailsRecord = details;
+        const request = {
+            role: 'agent',
+            task: launch.task,
+            resolvedDefinition: launch.definition,
+            ...(launch.worktree ? { worktree: launch.worktree } : {}),
+            ...(launch.authorizedWorktreePath ? { authorizedWorktreePath: launch.authorizedWorktreePath } : {}),
+            parentTool: 'run_subagent',
+            ...(detailsRecord?.resumeState ? { resumeState: detailsRecord.resumeState } : {}),
+            signal: this.signal,
+        };
+        const endRun = this.#beginSubagentRun();
+        try {
+            return await this.#withSubagentTrafficContext(detailsRecord?.toolCall?.callId, () => this.#subagentManager.runAsTool(request, _context, params.foregroundChildApproval
+                ? { ...detailsRecord, foregroundChildApproval: params.foregroundChildApproval }
+                : details));
+        }
+        finally {
+            endRun();
+        }
+    };
+    /**
+     * Start a host-resolved generic agent in the conversation-scoped async
+     * registry. Unlike the foreground method, this uses `backgroundSignal`, so
+     * an ordinary turn abort cannot cancel the retained run.
+     */
+    runResolvedSubagentAsync = async (params) => {
+        if (!this.#subagentManager) {
+            throw new Error('Transient agent clients cannot spawn subagents.');
+        }
+        const launch = normalizeResolvedLaunch(params);
+        const request = {
+            role: 'agent',
+            task: launch.task,
+            resolvedDefinition: launch.definition,
+            ...(params.name ? { name: params.name } : {}),
+            ...(params.continue_run_id ? { continueRunId: params.continue_run_id } : {}),
+            ...(launch.worktree ? { worktree: launch.worktree } : {}),
+            ...(launch.authorizedWorktreePath ? { authorizedWorktreePath: launch.authorizedWorktreePath } : {}),
+            parentTool: 'run_subagent',
+            signal: this.backgroundSignal,
+        };
+        return this.#subagentManager.startRunAsync(request);
+    };
     runSubagent = async (params, _context, details) => {
         if (!this.#subagentManager) {
             throw new Error('Transient agent clients cannot spawn subagents.');
         }
         const detailsRecord = details;
         const request = {
-            role: params.role,
-            task: params.task,
+            role: params.agent_spec ? 'agent' : params.role,
+            task: params.agent_spec?.goal ?? params.task,
+            ...(params.agent_spec ? { agentSpec: params.agent_spec } : {}),
             ...(params.worktree ? { worktree: params.worktree } : {}),
             parentTool: 'run_subagent',
             ...(detailsRecord?.resumeState ? { resumeState: detailsRecord.resumeState } : {}),
@@ -277,8 +384,9 @@ export class SubagentBridge {
             throw new Error('Transient agent clients cannot spawn subagents.');
         }
         const request = {
-            role: params.role,
-            task: params.task,
+            role: params.agent_spec ? 'agent' : params.role,
+            task: params.agent_spec?.goal ?? params.task,
+            ...(params.agent_spec ? { agentSpec: params.agent_spec } : {}),
             ...(params.name ? { name: params.name } : {}),
             ...(params.continue_run_id ? { continueRunId: params.continue_run_id } : {}),
             ...(params.worktree ? { worktree: params.worktree } : {}),

package/dist/lib/subagent-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-bridge.js","sourceRoot":"","sources":["../../source/lib/subagent-bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subagent-bridge.js","sourceRoot":"","sources":["../../source/lib/subagent-bridge.ts"],"names":[],"mappings":"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"}

package/dist/node_modules/@qduc/agent-wire/index.d.ts

@@ -0,0 +1,73 @@
+export declare const AGENT_EVENT_TYPES: readonly ['session_created', 'user_message_accepted', 'user_message_rejected', 'assistant_started', 'text_delta', 'reasoning_delta', 'tool_started', 'command_message', 'approval_required', 'interaction_updated', 'interaction_resolved', 'interaction_recovered', 'usage_update', 'retry', 'retry_exhausted', 'subagent_started', 'subagent_tool_started', 'subagent_text_turn', 'subagent_command_message', 'subagent_approval_required', 'subagent_completed', 'subagent_interrupted', 'subagent_question', 'context_compaction_started', 'context_compaction_completed', 'context_compaction_failed', 'turn_completed', 'turn_failed', 'turn_aborted'];
+export type AgentEventType = (typeof AGENT_EVENT_TYPES)[number];
+export declare const FROZEN_AGENT_EVENT_TYPES: readonly ["session_created", "user_message_accepted", "user_message_rejected", "assistant_started", "text_delta", "reasoning_delta", "tool_started", "command_message", "approval_required", "interaction_updated", "interaction_resolved", "interaction_recovered", "usage_update", "retry", "retry_exhausted", "subagent_started", "subagent_tool_started", "subagent_text_turn", "subagent_command_message", "subagent_approval_required", "subagent_completed", "subagent_interrupted", "subagent_question", "context_compaction_started", "context_compaction_completed", "context_compaction_failed", "turn_completed", "turn_failed", "turn_aborted"];
+export type AgentEventEnvelope = {
+    readonly schemaVersion: 1;
+    readonly id: number;
+    readonly sessionId: string;
+    readonly type: AgentEventType;
+    readonly occurredAt: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+};
+export declare class AgentWireError extends Error {
+    constructor(message?: string);
+}
+export declare function parseAgentEventEnvelope(value: unknown, expectedSessionId?: string): AgentEventEnvelope;
+export declare const parseEventEnvelope: typeof parseAgentEventEnvelope;
+export declare const InteractionProtocolError: typeof AgentWireError;
+export type InteractionKind = 'tool_approval' | 'ask_user' | 'check_in';
+export type InteractionVariant = 'ordinary_tool' | 'folder_read' | 'outside_workspace_edit' | 'denied_read' | 'docker_host_control' | 'sandbox_network_access' | 'post_execute' | 'max_turns' | 'run_budget' | 'ask_user';
+export type SafeChoice = {
+    id: string;
+    label: string;
+    description?: string;
+    destructive?: boolean;
+};
+export type AskUserQuestionDto = {
+    index: number;
+    question: string;
+    options: Array<{
+        label: string;
+        description?: string;
+    }>;
+    multiSelect: boolean;
+};
+export type PendingInteractionDto = {
+    version: 1;
+    interactionId: string;
+    kind: InteractionKind;
+    variant: InteractionVariant;
+    descriptor: {
+        agentName: string;
+        toolName: string;
+        callId?: string;
+        argumentsText: string;
+        display?: {
+            command?: string;
+            target?: string;
+            scope?: string;
+            warning?: string;
+        };
+        llmAdvisory?: {
+            reasoning: string;
+            approved: boolean;
+            model: string;
+            riskLevel?: string;
+        };
+        checkIn?: 'max_turns' | 'run_budget';
+        deniedRead?: {
+            displayPath: string;
+            displayParent: string;
+            sensitive: boolean;
+        };
+        runBudgetEvidence?: Record<string, number>;
+    };
+    choices: SafeChoice[];
+    askUser?: {
+        questions: AskUserQuestionDto[];
+        answers: Array<string | string[]>;
+        currentQuestionIndex: number;
+    };
+    revision: number;
+};
+export declare function validatePendingInteractionDto(value: unknown): PendingInteractionDto;

package/dist/node_modules/@qduc/agent-wire/index.js

@@ -0,0 +1,212 @@
+export const AGENT_EVENT_TYPES = [
+    'session_created',
+    'user_message_accepted',
+    'user_message_rejected',
+    'assistant_started',
+    'text_delta',
+    'reasoning_delta',
+    'tool_started',
+    'command_message',
+    'approval_required',
+    'interaction_updated',
+    'interaction_resolved',
+    'interaction_recovered',
+    'usage_update',
+    'retry',
+    'retry_exhausted',
+    'subagent_started',
+    'subagent_tool_started',
+    'subagent_text_turn',
+    'subagent_command_message',
+    'subagent_approval_required',
+    'subagent_completed',
+    'subagent_interrupted',
+    'subagent_question',
+    'context_compaction_started',
+    'context_compaction_completed',
+    'context_compaction_failed',
+    'turn_completed',
+    'turn_failed',
+    'turn_aborted',
+];
+export const FROZEN_AGENT_EVENT_TYPES = AGENT_EVENT_TYPES;
+export class AgentWireError extends Error {
+    constructor(message = 'invalid agent wire value') {
+        super(message);
+        this.name = 'AgentWireError';
+    }
+}
+const EVENT_SET = new Set(AGENT_EVENT_TYPES);
+const ID = /^[A-Za-z0-9_-]{1,256}$/;
+function object(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new AgentWireError();
+    return value;
+}
+function text(value, max) {
+    if (typeof value !== 'string' || value.length > max || /[\u0000-\u001f\u007f]/.test(value))
+        throw new AgentWireError();
+    return value;
+}
+function keys(value, allowed, required = allowed) {
+    const present = new Set(Object.keys(value));
+    if (Object.keys(value).some((key) => !allowed.includes(key)) || required.some((key) => !present.has(key)))
+        throw new AgentWireError();
+}
+export function parseAgentEventEnvelope(value, expectedSessionId) {
+    const input = object(value);
+    keys(input, ['schemaVersion', 'id', 'sessionId', 'type', 'occurredAt', 'payload']);
+    if (input.schemaVersion !== 1 ||
+        typeof input.id !== 'number' ||
+        !Number.isSafeInteger(input.id) ||
+        input.id < 1 ||
+        typeof input.type !== 'string' ||
+        !EVENT_SET.has(input.type))
+        throw new AgentWireError('unsupported agent event');
+    const sessionId = text(input.sessionId, 256);
+    if (!ID.test(sessionId) || (expectedSessionId && sessionId !== expectedSessionId))
+        throw new AgentWireError('event identity mismatch');
+    return {
+        schemaVersion: 1,
+        id: input.id,
+        sessionId,
+        type: input.type,
+        occurredAt: text(input.occurredAt, 128),
+        payload: object(input.payload),
+    };
+}
+export const parseEventEnvelope = parseAgentEventEnvelope;
+export const InteractionProtocolError = AgentWireError;
+const VARIANTS = [
+    'ordinary_tool',
+    'folder_read',
+    'outside_workspace_edit',
+    'denied_read',
+    'docker_host_control',
+    'sandbox_network_access',
+    'post_execute',
+    'max_turns',
+    'run_budget',
+    'ask_user',
+];
+export function validatePendingInteractionDto(value) {
+    const dto = object(value);
+    keys(dto, ['version', 'interactionId', 'kind', 'variant', 'descriptor', 'choices', 'askUser', 'revision'], ['version', 'interactionId', 'kind', 'variant', 'descriptor', 'choices', 'revision']);
+    if (dto.version !== 1 ||
+        typeof dto.interactionId !== 'string' ||
+        !ID.test(dto.interactionId) ||
+        typeof dto.kind !== 'string' ||
+        !['tool_approval', 'ask_user', 'check_in'].includes(dto.kind) ||
+        typeof dto.variant !== 'string' ||
+        !VARIANTS.includes(dto.variant) ||
+        typeof dto.revision !== 'number' ||
+        !Number.isSafeInteger(dto.revision) ||
+        dto.revision < 1)
+        throw new AgentWireError();
+    if ((dto.kind === 'ask_user' && dto.variant !== 'ask_user') ||
+        (dto.kind === 'check_in' && !['max_turns', 'run_budget'].includes(dto.variant)) ||
+        (dto.kind === 'tool_approval' && ['ask_user', 'max_turns', 'run_budget'].includes(dto.variant)))
+        throw new AgentWireError();
+    const descriptor = object(dto.descriptor);
+    keys(descriptor, [
+        'agentName',
+        'toolName',
+        'callId',
+        'argumentsText',
+        'display',
+        'llmAdvisory',
+        'checkIn',
+        'deniedRead',
+        'runBudgetEvidence',
+    ], ['agentName', 'toolName', 'argumentsText']);
+    text(descriptor.agentName, 256);
+    text(descriptor.toolName, 256);
+    text(descriptor.argumentsText, 8192);
+    if (descriptor.callId !== undefined && (typeof descriptor.callId !== 'string' || !ID.test(descriptor.callId)))
+        throw new AgentWireError();
+    if (descriptor.display !== undefined) {
+        const display = object(descriptor.display);
+        keys(display, ['command', 'target', 'scope', 'warning'], []);
+        for (const v of Object.values(display))
+            text(v, 2048);
+    }
+    if (descriptor.llmAdvisory !== undefined) {
+        const a = object(descriptor.llmAdvisory);
+        keys(a, ['reasoning', 'approved', 'model', 'riskLevel'], ['reasoning', 'approved', 'model']);
+        text(a.reasoning, 2048);
+        text(a.model, 256);
+        if (typeof a.approved !== 'boolean' || (a.riskLevel !== undefined && typeof a.riskLevel !== 'string'))
+            throw new AgentWireError();
+    }
+    if (descriptor.deniedRead !== undefined) {
+        const d = object(descriptor.deniedRead);
+        keys(d, ['displayPath', 'displayParent', 'sensitive']);
+        text(d.displayPath, 256);
+        text(d.displayParent, 256);
+        if (typeof d.sensitive !== 'boolean')
+            throw new AgentWireError();
+    }
+    if (descriptor.runBudgetEvidence !== undefined) {
+        const e = object(descriptor.runBudgetEvidence);
+        for (const v of Object.values(e))
+            if (typeof v !== 'number' || !Number.isFinite(v) || v < 0)
+                throw new AgentWireError();
+    }
+    if (!Array.isArray(dto.choices) || dto.choices.length === 0 || dto.choices.length > 32)
+        throw new AgentWireError();
+    for (const raw of dto.choices) {
+        const c = object(raw);
+        keys(c, ['id', 'label', 'description', 'destructive'], ['id', 'label']);
+        if (typeof c.id !== 'string' || !/^[A-Za-z0-9:_-]{1,128}$/.test(c.id))
+            throw new AgentWireError();
+        text(c.label, 2048);
+        if (c.description !== undefined)
+            text(c.description, 2048);
+        if (c.destructive !== undefined && typeof c.destructive !== 'boolean')
+            throw new AgentWireError();
+    }
+    if (dto.askUser !== undefined) {
+        if (dto.kind !== 'ask_user')
+            throw new AgentWireError();
+        const ask = object(dto.askUser);
+        keys(ask, ['questions', 'answers', 'currentQuestionIndex']);
+        if (!Array.isArray(ask.questions) ||
+            !Array.isArray(ask.answers) ||
+            ask.questions.length === 0 ||
+            ask.questions.length > 32)
+            throw new AgentWireError();
+        ask.questions.forEach((raw, index) => {
+            const q = object(raw);
+            keys(q, ['index', 'question', 'options', 'multiSelect']);
+            if (q.index !== index ||
+                typeof q.question !== 'string' ||
+                !Array.isArray(q.options) ||
+                typeof q.multiSelect !== 'boolean')
+                throw new AgentWireError();
+            text(q.question, 4096);
+            if (q.options.length > 32)
+                throw new AgentWireError();
+            q.options.forEach((rawOption) => {
+                const option = object(rawOption);
+                keys(option, ['label', 'description'], ['label']);
+                text(option.label, 512);
+                if (option.description !== undefined)
+                    text(option.description, 2048);
+            });
+        });
+        ask.answers.forEach((answer) => {
+            if (typeof answer === 'string')
+                text(answer, 16384);
+            else if (Array.isArray(answer))
+                answer.forEach((item) => text(item, 512));
+            else
+                throw new AgentWireError();
+        });
+        if (typeof ask.currentQuestionIndex !== 'number' ||
+            !Number.isSafeInteger(ask.currentQuestionIndex) ||
+            ask.currentQuestionIndex < 0 ||
+            ask.currentQuestionIndex >= ask.questions.length)
+            throw new AgentWireError();
+    }
+    return dto;
+}

package/dist/node_modules/@qduc/agent-wire/package.json

@@ -0,0 +1 @@
+{"name":"@qduc/agent-wire","type":"module","exports":"./index.js"}

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

@@ -14,6 +14,15 @@ it('orchestrator prompt does not encourage continued or direct work while delega
   expect(orchestratorPrompt).not.toContain('Directly inspect, edit, run commands, and test small or clear work');
 });
 
+it('orchestrator prompt prefers the generic agent spec for diverse tasks and states its limits', () => {
+  expect(orchestratorPrompt).toContain('generic agent_spec interface');
+  expect(orchestratorPrompt).toContain('safe read-only workspace defaults');
+  expect(orchestratorPrompt).toContain('not yet supported by plan-mode interception');
+  expect(orchestratorPrompt).toContain('writable generic runs cannot be continued');
+  expect(orchestratorPrompt).toContain('agent.run({ spec, worktree? })');
+  expect(orchestratorPrompt).toContain('without one, interrupted children reject');
+});
+
 it('orchestrator prompt gives the orchestrator standing to overrule a subagent recommendation', () => {
   const lower = orchestratorPrompt.toLowerCase();
 

package/dist/prompts/orchestrator.md

@@ -6,6 +6,8 @@ Choose investigation, planning, delegation, implementation, review, and validati
 
 Get the work done with the least delegation that fully and safely covers it. Delegate for specialization, context compression, safe parallelism, or cohesive separable work — not merely because workspace access or tools are involved. Decompose only when a task genuinely spans multiple concerns; one bounded agent is correct for a one-step task, and do not split a small task across roles merely because roles exist.
 
+For diverse tasks, prefer the generic agent_spec interface: make the goal, context, constraints, completion condition, and required tool allowlist explicit. When `run_code` advertises its script-only `agent` capability, compose bounded agent executions with `agent.run({ spec, worktree? })` or start a background run with `agent.start({ spec, name? })`; status, result, and cancellation use `agent.status/result/cancel`. Omitted tools use safe read-only workspace defaults. A bound session approval owner presents child tool approval pauses through the same user surface; without one, interrupted children reject. Use named role presets when their specialized behavior or continuation contract is a better fit; generic invocations are not yet supported by plan-mode interception. A generic agent may have write access and use a worktree, but writable generic runs cannot be continued, and the script capability rejects `continue_run_id`.
+
 Preserve orchestrator attention for investigation, decisions, review, and integration judgement by delegating bounded mechanical follow-through when it forms a clean execution unit. Routine formatting and validation, focused commits, merges, diff collection, and branch or worktree cleanup are appropriate worker tasks when they can proceed with explicit acceptance criteria. Do not delegate merely to avoid one trivial command when coordination costs more than direct execution, and take over a blocked mechanical operation rather than stalling the outcome.
 
 Delegation transfers execution, never outcome ownership. Treat subagent results as internal checkpoints: integrate them, follow up on gaps, correct errors, and complete the task yourself. Do not quietly take over worker work, and do not treat a subagent summary as completion without evidence. Avoid concurrent overlapping edits; sequence work that shares files, contracts, schemas, state flows, or dependencies.

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;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,gBAAwB,EACxB,aAAoB,EACpB,eAAuB,EACvB,iBAAwB,EACxB,iBAAyB,EACzB,eAAuB,GACxB,GAAE;IACD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAkEd"}
+{"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,eAAuB,EACvB,iBAAwB,EACxB,iBAAyB,EACzB,eAAuB,GACxB,GAAE;IACD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAsEd"}