@x-code-cli/core 0.1.10 → 0.2.0

package/dist/agent/sub-agents/loader.js

@@ -0,0 +1,117 @@
+// @x-code-cli/core — Custom sub-agent loader
+//
+// Scans ~/.x-code/agents/*.md and <repo-root>/.x-code/agents/*.md for
+// user-defined sub-agents with YAML frontmatter. Bad files are skipped
+// with a warning to stderr — one broken agent file must never crash the CLI.
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { GLOBAL_XCODE_DIR, XCODE_DIR } from '../../utils.js';
+const frontmatterSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().min(1),
+    tools: z.array(z.string()).optional(),
+    disallowedTools: z.array(z.string()).optional(),
+    model: z.string().optional(),
+    maxTurns: z.number().int().positive().optional(),
+    shellRestrictions: z.array(z.string()).optional(),
+});
+/** Minimal YAML frontmatter parser. Handles the subset we need:
+ *  string scalars, number scalars, and inline/flow arrays.
+ *  No dependency on gray-matter — keeps the install lean. */
+function parseFrontmatter(raw) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return null;
+    const yamlBlock = match[1];
+    const body = match[2];
+    const data = {};
+    for (const line of yamlBlock.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIdx = trimmed.indexOf(':');
+        if (colonIdx < 1)
+            continue;
+        const key = trimmed.slice(0, colonIdx).trim();
+        let value = trimmed.slice(colonIdx + 1).trim();
+        // Inline array: [a, b, c]
+        if (value.startsWith('[') && value.endsWith(']')) {
+            const inner = value.slice(1, -1);
+            data[key] = inner
+                .split(',')
+                .map((s) => s.trim().replace(/^['"]|['"]$/g, ''))
+                .filter(Boolean);
+            continue;
+        }
+        // Strip quotes
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        // Number
+        if (/^\d+$/.test(value)) {
+            data[key] = parseInt(value, 10);
+            continue;
+        }
+        data[key] = value;
+    }
+    return { data, body };
+}
+async function loadAgentsFromDir(dir, source) {
+    const agents = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch {
+        return agents;
+    }
+    for (const entry of entries) {
+        if (!entry.endsWith('.md'))
+            continue;
+        const filePath = path.join(dir, entry);
+        try {
+            const raw = await fs.readFile(filePath, 'utf-8');
+            const parsed = parseFrontmatter(raw);
+            if (!parsed) {
+                console.error(`[sub-agents] Skipping ${filePath}: no valid YAML frontmatter`);
+                continue;
+            }
+            const result = frontmatterSchema.safeParse(parsed.data);
+            if (!result.success) {
+                console.error(`[sub-agents] Skipping ${filePath}: invalid frontmatter — ${result.error.issues.map((i) => i.message).join(', ')}`);
+                continue;
+            }
+            const fm = result.data;
+            agents.push({
+                name: fm.name,
+                description: fm.description,
+                prompt: parsed.body.trim(),
+                tools: fm.tools,
+                disallowedTools: fm.disallowedTools,
+                model: fm.model,
+                maxTurns: fm.maxTurns ?? 30,
+                shellRestrictions: fm.shellRestrictions,
+                source,
+            });
+        }
+        catch (err) {
+            console.error(`[sub-agents] Skipping ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return agents;
+}
+/** Load custom sub-agents from global + project directories.
+ *  Environment variable `XC_AGENTS_DIR` overrides paths (testing only). */
+export async function loadCustomAgents() {
+    const override = process.env.XC_AGENTS_DIR;
+    if (override) {
+        return loadAgentsFromDir(override, 'project');
+    }
+    const globalDir = path.join(GLOBAL_XCODE_DIR, 'agents');
+    const projectDir = path.join(process.cwd(), XCODE_DIR, 'agents');
+    const globalAgents = await loadAgentsFromDir(globalDir, 'global');
+    const projectAgents = await loadAgentsFromDir(projectDir, 'project');
+    return [...globalAgents, ...projectAgents];
+}
+//# sourceMappingURL=loader.js.map

package/dist/agent/sub-agents/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/agent/sub-agents/loader.ts"],"names":[],"mappings":"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"}

package/dist/agent/sub-agents/registry.d.ts

@@ -0,0 +1,14 @@
+import type { SubAgentDefinition } from './types.js';
+export declare class SubAgentRegistry {
+    private agents;
+    constructor(agents: SubAgentDefinition[]);
+    get(name: string): SubAgentDefinition | undefined;
+    list(): SubAgentDefinition[];
+    names(): string[];
+}
+/** Build the registry: built-in first, then custom (later entries override). */
+export declare function createSubAgentRegistry(): Promise<SubAgentRegistry>;
+/** Synchronous registry with only built-in agents (for testing or when
+ *  disk scan should be skipped). */
+export declare function createBuiltInRegistry(): SubAgentRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/agent/sub-agents/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/sub-agents/registry.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,EAAE,kBAAkB,EAAE;IAOxC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,IAAI,IAAI,kBAAkB,EAAE;IAI5B,KAAK,IAAI,MAAM,EAAE;CAGlB;AAED,gFAAgF;AAChF,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAIxE;AAED;oCACoC;AACpC,wBAAgB,qBAAqB,IAAI,gBAAgB,CAExD"}

package/dist/agent/sub-agents/registry.js

@@ -0,0 +1,37 @@
+// @x-code-cli/core — Sub-agent registry
+//
+// Constructed once at startup, immutable for the session lifetime.
+// Built-in agents load synchronously; custom agents from disk are async.
+// Same-name custom agents override built-ins (project > global > built-in).
+import { builtInAgents } from './built-in.js';
+import { loadCustomAgents } from './loader.js';
+export class SubAgentRegistry {
+    agents;
+    constructor(agents) {
+        this.agents = new Map();
+        for (const a of agents) {
+            this.agents.set(a.name, a);
+        }
+    }
+    get(name) {
+        return this.agents.get(name);
+    }
+    list() {
+        return [...this.agents.values()];
+    }
+    names() {
+        return [...this.agents.keys()];
+    }
+}
+/** Build the registry: built-in first, then custom (later entries override). */
+export async function createSubAgentRegistry() {
+    const custom = await loadCustomAgents();
+    // Load order: built-in → custom. Map insertion overwrites, so custom wins.
+    return new SubAgentRegistry([...builtInAgents, ...custom]);
+}
+/** Synchronous registry with only built-in agents (for testing or when
+ *  disk scan should be skipped). */
+export function createBuiltInRegistry() {
+    return new SubAgentRegistry(builtInAgents);
+}
+//# sourceMappingURL=registry.js.map

package/dist/agent/sub-agents/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/agent/sub-agents/registry.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,mEAAmE;AACnE,yEAAyE;AACzE,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAiC;IAE/C,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAA;QACvB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IAClC,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAChC,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAA;IACvC,2EAA2E;IAC3E,OAAO,IAAI,gBAAgB,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,MAAM,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED;oCACoC;AACpC,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAAA;AAC5C,CAAC"}

package/dist/agent/sub-agents/runner.d.ts

@@ -0,0 +1,26 @@
+import type { LanguageModel } from 'ai';
+import type { AgentCallbacks, AgentOptions, TokenUsage } from '../../types/index.js';
+import type { LoopState } from '../loop-state.js';
+export interface RunSubAgentArgs {
+    parentState: LoopState;
+    parentOptions: AgentOptions;
+    callbacks: AgentCallbacks;
+    toolCallId: string;
+    agentName: string;
+    description: string;
+    prompt: string;
+    knowledgeContext: string;
+    isGitRepo: boolean;
+}
+export interface RunSubAgentResult {
+    resultText: string;
+    tokenUsage: TokenUsage;
+    turnCount: number;
+    toolCallCount: number;
+    durationMs: number;
+    aborted: boolean;
+}
+/** Resolve the model to use for the sub-agent. Need the actual LanguageModel
+ *  instance from the parent since we pass it to agentLoop. */
+export declare function runSubAgent(args: RunSubAgentArgs, parentModel: LanguageModel): Promise<RunSubAgentResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/agent/sub-agents/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/agent/sub-agents/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAIpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAKjD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,SAAS,CAAA;IACtB,aAAa,EAAE,YAAY,CAAA;IAC3B,SAAS,EAAE,cAAc,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB;AAqDD;8DAC8D;AAC9D,wBAAsB,WAAW,CAC/B,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAwN5B"}

package/dist/agent/sub-agents/runner.js

@@ -0,0 +1,287 @@
+import { resolveModelId } from '../../config/index.js';
+import { debugLog } from '../../utils.js';
+import { agentLoop } from '../loop.js';
+import { createLoopState } from '../loop-state.js';
+import { buildSubAgentSystemPrompt } from '../system-prompt.js';
+/** Extract the last assistant text from a message array (skipping tool-call parts). */
+function extractFinalText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (!msg || msg.role !== 'assistant')
+            continue;
+        const content = msg.content;
+        if (typeof content === 'string')
+            return content.trim();
+        if (Array.isArray(content)) {
+            const textParts = content
+                .filter((p) => p?.type === 'text' && typeof p.text === 'string')
+                .map((p) => p.text);
+            const joined = textParts.join('').trim();
+            if (joined)
+                return joined;
+        }
+    }
+    return '';
+}
+function resolveSubModel(agentDef, parentOptions, parentModel) {
+    if (!agentDef.model)
+        return parentModel;
+    if (!parentOptions.modelRegistry)
+        return parentModel;
+    const resolvedId = resolveModelId(agentDef.model);
+    if (!resolvedId)
+        return parentModel;
+    try {
+        return parentOptions.modelRegistry.languageModel(resolvedId);
+    }
+    catch {
+        debugLog('sub-agent.model', `Failed to resolve model "${agentDef.model}", falling back to parent model`);
+        return parentModel;
+    }
+}
+function buildToolFilter(agentDef, parentPermissionMode) {
+    const deny = [...(agentDef.disallowedTools ?? []), 'task'];
+    // In plan mode, deny write tools for general-purpose agent
+    if (parentPermissionMode === 'plan' && agentDef.name === 'general-purpose') {
+        deny.push('writeFile', 'edit');
+    }
+    return {
+        allow: agentDef.tools,
+        deny,
+    };
+}
+/** Resolve the model to use for the sub-agent. Need the actual LanguageModel
+ *  instance from the parent since we pass it to agentLoop. */
+export async function runSubAgent(args, parentModel) {
+    const { parentState, parentOptions, callbacks, toolCallId, agentName, description, prompt, knowledgeContext, isGitRepo } = args;
+    const startTime = Date.now();
+    const registry = parentOptions.subAgentRegistry;
+    if (!registry) {
+        return {
+            resultText: '[Sub-agent system not initialized]',
+            tokenUsage: zeroUsage(),
+            turnCount: 0,
+            toolCallCount: 0,
+            durationMs: 0,
+            aborted: false,
+        };
+    }
+    const agentDef = registry.get(agentName);
+    if (!agentDef) {
+        const available = registry.names().join(', ');
+        return {
+            resultText: `[Sub-agent '${agentName}' not found. Available: ${available}]`,
+            tokenUsage: zeroUsage(),
+            turnCount: 0,
+            toolCallCount: 0,
+            durationMs: 0,
+            aborted: false,
+        };
+    }
+    // Notify UI
+    callbacks.onSubAgentEvent?.({
+        kind: 'start',
+        toolCallId,
+        agentName,
+        description,
+        prompt,
+    });
+    const subModel = resolveSubModel(agentDef, parentOptions, parentModel);
+    const subModelId = agentDef.model ? (resolveModelId(agentDef.model) ?? parentOptions.modelId) : parentOptions.modelId;
+    const subSystemPrompt = buildSubAgentSystemPrompt({
+        agentPrompt: agentDef.prompt,
+        knowledgeContext,
+        isGitRepo,
+    });
+    const subState = createLoopState('default');
+    subState.systemPromptCache = subSystemPrompt;
+    const toolFilter = buildToolFilter(agentDef, parentState.permissionMode);
+    const subOptions = {
+        ...parentOptions,
+        modelId: subModelId,
+        maxTurns: agentDef.maxTurns,
+        toolFilter,
+        abortSignal: parentOptions.abortSignal,
+        permissionMode: 'default',
+        printMode: false,
+        // Sub-agents don't get their own sub-agent registry — recursion is forbidden
+        subAgentRegistry: undefined,
+    };
+    // Build sub-agent callbacks: forward events to the parent UI via onSubAgentEvent,
+    // but don't mix child state into parent state directly.
+    const subCallbacks = {
+        onTextDelta: (delta) => {
+            callbacks.onSubAgentEvent?.({ kind: 'text-delta', toolCallId, delta });
+        },
+        onToolCall: (subToolCallId, subToolName, subInput) => {
+            callbacks.onSubAgentEvent?.({
+                kind: 'tool-call',
+                toolCallId,
+                subToolName,
+                subInput,
+            });
+            // Also forward to parent's onToolProgress so the live indicator updates
+            callbacks.onToolProgress(toolCallId, `${subToolName}: ${previewInput(subToolName, subInput)}`);
+        },
+        onToolProgress: (_subToolCallId, message) => {
+            callbacks.onToolProgress(toolCallId, message);
+        },
+        onToolResult: (subToolCallId, result, isError) => {
+            const preview = result.length > 200 ? result.slice(0, 197) + '...' : result;
+            callbacks.onSubAgentEvent?.({
+                kind: 'tool-result',
+                toolCallId,
+                subToolName: subToolCallId,
+                resultPreview: preview,
+                durationMs: 0,
+                isError: isError ?? false,
+            });
+        },
+        onFileEdit: callbacks.onFileEdit,
+        onAskPermission: callbacks.onAskPermission,
+        onAskUser: callbacks.onAskUser,
+        onPlanApprovalRequest: callbacks.onPlanApprovalRequest,
+        onPlanModeChange: () => { },
+        onTodosUpdate: () => { },
+        onShellOutput: callbacks.onShellOutput,
+        onUsageUpdate: () => { },
+        onContextCompressed: () => { },
+        onError: (error) => {
+            debugLog('sub-agent.error', `${agentName}: ${error.message}`);
+        },
+    };
+    let aborted = false;
+    try {
+        const finalSubState = await agentLoop(prompt, subModel, subOptions, subCallbacks, subState);
+        const finalText = extractFinalText(finalSubState.messages);
+        const turnCount = finalSubState.turnCount;
+        const toolUseCount = countToolCalls(finalSubState.messages);
+        // Accumulate sub-agent token usage into parent
+        parentState.tokenUsage.inputTokens += finalSubState.tokenUsage.inputTokens;
+        parentState.tokenUsage.outputTokens += finalSubState.tokenUsage.outputTokens;
+        parentState.tokenUsage.totalTokens = parentState.tokenUsage.inputTokens + parentState.tokenUsage.outputTokens;
+        parentState.tokenUsage.cacheReadTokens += finalSubState.tokenUsage.cacheReadTokens;
+        parentState.tokenUsage.cacheCreationTokens += finalSubState.tokenUsage.cacheCreationTokens;
+        callbacks.onUsageUpdate(parentState.tokenUsage);
+        const durationMs = Date.now() - startTime;
+        const resultText = finalText || '[Sub-agent completed without producing a final response]';
+        callbacks.onSubAgentEvent?.({
+            kind: 'end',
+            toolCallId,
+            finalText: resultText,
+            tokenUsage: finalSubState.tokenUsage,
+            turnCount,
+            durationMs,
+            aborted: false,
+        });
+        if (turnCount >= agentDef.maxTurns && !finalText) {
+            return {
+                resultText: `[Sub-agent reached max turns (${agentDef.maxTurns}) without finishing. Partial output: ${extractFinalText(finalSubState.messages) || 'none'}]`,
+                tokenUsage: finalSubState.tokenUsage,
+                turnCount,
+                toolCallCount: toolUseCount,
+                durationMs,
+                aborted: false,
+            };
+        }
+        return {
+            resultText: `<task_result>\n${resultText}\n</task_result>`,
+            tokenUsage: finalSubState.tokenUsage,
+            turnCount,
+            toolCallCount: toolUseCount,
+            durationMs,
+            aborted: false,
+        };
+    }
+    catch (err) {
+        const durationMs = Date.now() - startTime;
+        if (isAbortError(err, parentOptions.abortSignal)) {
+            aborted = true;
+            const partial = extractFinalText(subState.messages);
+            const text = partial
+                ? `[Sub-agent interrupted by user]\n\nPartial output:\n${partial}`
+                : '[Sub-agent interrupted by user]';
+            const toolUseCount = countToolCalls(subState.messages);
+            callbacks.onSubAgentEvent?.({
+                kind: 'end',
+                toolCallId,
+                finalText: text,
+                tokenUsage: subState.tokenUsage,
+                turnCount: subState.turnCount,
+                durationMs,
+                aborted: true,
+            });
+            return {
+                resultText: text,
+                tokenUsage: subState.tokenUsage,
+                turnCount: subState.turnCount,
+                toolCallCount: toolUseCount,
+                durationMs,
+                aborted: true,
+            };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        debugLog('sub-agent.crash', `${agentName}: ${message}`);
+        const toolUseCount = countToolCalls(subState.messages);
+        callbacks.onSubAgentEvent?.({
+            kind: 'end',
+            toolCallId,
+            finalText: `[Sub-agent failed: ${message}]`,
+            tokenUsage: subState.tokenUsage,
+            turnCount: subState.turnCount,
+            durationMs,
+            aborted: false,
+        });
+        return {
+            resultText: `[Sub-agent failed: ${message}]`,
+            tokenUsage: subState.tokenUsage,
+            turnCount: subState.turnCount,
+            toolCallCount: toolUseCount,
+            durationMs,
+            aborted: false,
+        };
+    }
+}
+function isAbortError(err, signal) {
+    if (signal?.aborted)
+        return true;
+    if (err instanceof Error) {
+        if (err.name === 'AbortError')
+            return true;
+        if (/aborted|AbortError/i.test(err.message))
+            return true;
+    }
+    return false;
+}
+function zeroUsage() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        cacheReadTokens: 0,
+        cacheCreationTokens: 0,
+        currentContextTokens: 0,
+    };
+}
+function countToolCalls(messages) {
+    let count = 0;
+    for (const msg of messages) {
+        if (msg.role !== 'assistant' || !Array.isArray(msg.content))
+            continue;
+        for (const part of msg.content) {
+            if (part?.type === 'tool-call')
+                count++;
+        }
+    }
+    return count;
+}
+function previewInput(toolName, input) {
+    const val = input.filePath ??
+        input.command ??
+        input.pattern ??
+        input.query ??
+        input.dirPath ??
+        '';
+    return val.length > 80 ? val.slice(0, 77) + '...' : val;
+}
+//# sourceMappingURL=runner.js.map

package/dist/agent/sub-agents/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/agent/sub-agents/runner.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAyB/D,uFAAuF;AACvF,SAAS,gBAAgB,CAAC,QAA+B;IACvD,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;YAAE,SAAQ;QAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;QAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;QACtD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAI,OAAmD;iBACnE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAC/D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAA;YAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YACxC,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAA;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,SAAS,eAAe,CACtB,QAA4B,EAC5B,aAA2B,EAC3B,WAA0B;IAE1B,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,OAAO,WAAW,CAAA;IACvC,IAAI,CAAC,aAAa,CAAC,aAAa;QAAE,OAAO,WAAW,CAAA;IAEpD,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjD,IAAI,CAAC,UAAU;QAAE,OAAO,WAAW,CAAA;IAEnC,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,aAAa,CAAC,aAAa,CAAC,UAAmC,CAAC,CAAA;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,CAAC,iBAAiB,EAAE,4BAA4B,QAAQ,CAAC,KAAK,iCAAiC,CAAC,CAAA;QACxG,OAAO,WAAW,CAAA;IACpB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,QAA4B,EAAE,oBAA4B;IACjF,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;IAE1D,2DAA2D;IAC3D,IAAI,oBAAoB,KAAK,MAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAChC,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,IAAI;KACL,CAAA;AACH,CAAC;AAED;8DAC8D;AAC9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAqB,EACrB,WAA0B;IAE1B,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IAC/H,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAE5B,MAAM,QAAQ,GAAG,aAAa,CAAC,gBAAgD,CAAA;IAC/E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,UAAU,EAAE,oCAAoC;YAChD,UAAU,EAAE,SAAS,EAAE;YACvB,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,KAAK;SACf,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7C,OAAO;YACL,UAAU,EAAE,eAAe,SAAS,2BAA2B,SAAS,GAAG;YAC3E,UAAU,EAAE,SAAS,EAAE;YACvB,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,KAAK;SACf,CAAA;IACH,CAAC;IAED,YAAY;IACZ,SAAS,CAAC,eAAe,EAAE,CAAC;QAC1B,IAAI,EAAE,OAAO;QACb,UAAU;QACV,SAAS;QACT,WAAW;QACX,MAAM;KACP,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC,CAAA;IACtE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAA;IAErH,MAAM,eAAe,GAAG,yBAAyB,CAAC;QAChD,WAAW,EAAE,QAAQ,CAAC,MAAM;QAC5B,gBAAgB;QAChB,SAAS;KACV,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;IAC3C,QAAQ,CAAC,iBAAiB,GAAG,eAAe,CAAA;IAE5C,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;IAExE,MAAM,UAAU,GAAiB;QAC/B,GAAG,aAAa;QAChB,OAAO,EAAE,UAAU;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU;QACV,WAAW,EAAE,aAAa,CAAC,WAAW;QACtC,cAAc,EAAE,SAAS;QACzB,SAAS,EAAE,KAAK;QAChB,6EAA6E;QAC7E,gBAAgB,EAAE,SAAS;KAC5B,CAAA;IAED,kFAAkF;IAClF,wDAAwD;IACxD,MAAM,YAAY,GAAmB;QACnC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;YACrB,SAAS,CAAC,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;QACxE,CAAC;QACD,UAAU,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;YACnD,SAAS,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,EAAE,WAAW;gBACjB,UAAU;gBACV,WAAW;gBACX,QAAQ;aACT,CAAC,CAAA;YACF,wEAAwE;YACxE,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,WAAW,KAAK,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAA;QAChG,CAAC;QACD,cAAc,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE;YAC1C,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QAC/C,CAAC;QACD,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;YAC3E,SAAS,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,EAAE,aAAa;gBACnB,UAAU;gBACV,WAAW,EAAE,aAAa;gBAC1B,aAAa,EAAE,OAAO;gBACtB,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,OAAO,IAAI,KAAK;aAC1B,CAAC,CAAA;QACJ,CAAC;QACD,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,eAAe,EAAE,SAAS,CAAC,eAAe;QAC1C,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,qBAAqB,EAAE,SAAS,CAAC,qBAAqB;QACtD,gBAAgB,EAAE,GAAG,EAAE,GAAE,CAAC;QAC1B,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;QACvB,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;QACvB,mBAAmB,EAAE,GAAG,EAAE,GAAE,CAAC;QAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,QAAQ,CAAC,iBAAiB,EAAE,GAAG,SAAS,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAC/D,CAAC;KACF,CAAA;IAED,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,SAAS,CACnC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,QAAQ,CACT,CAAA;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC1D,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAA;QACzC,MAAM,YAAY,GAAG,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QAE3D,+CAA+C;QAC/C,WAAW,CAAC,UAAU,CAAC,WAAW,IAAI,aAAa,CAAC,UAAU,CAAC,WAAW,CAAA;QAC1E,WAAW,CAAC,UAAU,CAAC,YAAY,IAAI,aAAa,CAAC,UAAU,CAAC,YAAY,CAAA;QAC5E,WAAW,CAAC,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAA;QAC7G,WAAW,CAAC,UAAU,CAAC,eAAe,IAAI,aAAa,CAAC,UAAU,CAAC,eAAe,CAAA;QAClF,WAAW,CAAC,UAAU,CAAC,mBAAmB,IAAI,aAAa,CAAC,UAAU,CAAC,mBAAmB,CAAA;QAC1F,SAAS,CAAC,aAAa,CAAC,WAAW,CAAC,UAAU,CAAC,CAAA;QAE/C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QACzC,MAAM,UAAU,GAAG,SAAS,IAAI,0DAA0D,CAAA;QAE1F,SAAS,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,EAAE,KAAK;YACX,UAAU;YACV,SAAS,EAAE,UAAU;YACrB,UAAU,EAAE,aAAa,CAAC,UAAU;YACpC,SAAS;YACT,UAAU;YACV,OAAO,EAAE,KAAK;SACf,CAAC,CAAA;QAEF,IAAI,SAAS,IAAI,QAAQ,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;YACjD,OAAO;gBACL,UAAU,EAAE,iCAAiC,QAAQ,CAAC,QAAQ,wCAAwC,gBAAgB,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,MAAM,GAAG;gBAC3J,UAAU,EAAE,aAAa,CAAC,UAAU;gBACpC,SAAS;gBACT,aAAa,EAAE,YAAY;gBAC3B,UAAU;gBACV,OAAO,EAAE,KAAK;aACf,CAAA;QACH,CAAC;QAED,OAAO;YACL,UAAU,EAAE,kBAAkB,UAAU,kBAAkB;YAC1D,UAAU,EAAE,aAAa,CAAC,UAAU;YACpC,SAAS;YACT,aAAa,EAAE,YAAY;YAC3B,UAAU;YACV,OAAO,EAAE,KAAK;SACf,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QAEzC,IAAI,YAAY,CAAC,GAAG,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YACjD,OAAO,GAAG,IAAI,CAAA;YACd,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YACnD,MAAM,IAAI,GAAG,OAAO;gBAClB,CAAC,CAAC,uDAAuD,OAAO,EAAE;gBAClE,CAAC,CAAC,iCAAiC,CAAA;YACrC,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAEtD,SAAS,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,EAAE,KAAK;gBACX,UAAU;gBACV,SAAS,EAAE,IAAI;gBACf,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,UAAU;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAA;YAEF,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,aAAa,EAAE,YAAY;gBAC3B,UAAU;gBACV,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,QAAQ,CAAC,iBAAiB,EAAE,GAAG,SAAS,KAAK,OAAO,EAAE,CAAC,CAAA;QACvD,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAEtD,SAAS,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,EAAE,KAAK;YACX,UAAU;YACV,SAAS,EAAE,sBAAsB,OAAO,GAAG;YAC3C,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,UAAU;YACV,OAAO,EAAE,KAAK;SACf,CAAC,CAAA;QAEF,OAAO;YACL,UAAU,EAAE,sBAAsB,OAAO,GAAG;YAC5C,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,aAAa,EAAE,YAAY;YAC3B,UAAU;YACV,OAAO,EAAE,KAAK;SACf,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAY,EAAE,MAA+B;IACjE,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,IAAI,CAAA;IAChC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,IAAI,CAAA;QAC1C,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAA;IAC1D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,SAAS;IAChB,OAAO;QACL,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,eAAe,EAAE,CAAC;QAClB,mBAAmB,EAAE,CAAC;QACtB,oBAAoB,EAAE,CAAC;KACxB,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,QAA+B;IACrD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAQ;QACrE,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAmC,EAAE,CAAC;YAC3D,IAAI,IAAI,EAAE,IAAI,KAAK,WAAW;gBAAE,KAAK,EAAE,CAAA;QACzC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,KAA8B;IACpE,MAAM,GAAG,GACN,KAAK,CAAC,QAAmB;QACzB,KAAK,CAAC,OAAkB;QACxB,KAAK,CAAC,OAAkB;QACxB,KAAK,CAAC,KAAgB;QACtB,KAAK,CAAC,OAAkB;QACzB,EAAE,CAAA;IACJ,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAA;AACzD,CAAC"}

package/dist/agent/sub-agents/types.d.ts

@@ -0,0 +1,63 @@
+import type { TokenUsage } from '../../types/index.js';
+export interface SubAgentDefinition {
+    name: string;
+    description: string;
+    /** Markdown body = system prompt for the sub-agent */
+    prompt: string;
+    /** Allowed tools. Omit = default read-only set */
+    tools?: string[];
+    /** Tools to explicitly deny (applied after `tools`) */
+    disallowedTools?: string[];
+    /** Model override (e.g. "anthropic:claude-sonnet-4-6"). Omit = inherit parent */
+    model?: string;
+    /** Max agentic turns before forced stop */
+    maxTurns: number;
+    /** Shell commands to deny (keyword matching). Only relevant when shell is in tools */
+    shellRestrictions?: string[];
+    /** Where this definition came from */
+    source: 'built-in' | 'global' | 'project';
+}
+export interface SubAgentTrace {
+    toolCalls: Array<{
+        toolName: string;
+        input: unknown;
+        result: string;
+        durationMs: number;
+        isError: boolean;
+    }>;
+    finalText: string;
+    tokenUsage: TokenUsage;
+    turnCount: number;
+}
+export type SubAgentEvent = {
+    kind: 'start';
+    toolCallId: string;
+    agentName: string;
+    description: string;
+    prompt: string;
+} | {
+    kind: 'tool-call';
+    toolCallId: string;
+    subToolName: string;
+    subInput: unknown;
+} | {
+    kind: 'tool-result';
+    toolCallId: string;
+    subToolName: string;
+    resultPreview: string;
+    durationMs: number;
+    isError: boolean;
+} | {
+    kind: 'text-delta';
+    toolCallId: string;
+    delta: string;
+} | {
+    kind: 'end';
+    toolCallId: string;
+    finalText: string;
+    tokenUsage: TokenUsage;
+    turnCount: number;
+    durationMs: number;
+    aborted: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/sub-agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/sub-agents/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,sCAAsC;IACtC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,OAAO,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,OAAO,CAAA;KACjB,CAAC,CAAA;IACF,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACjF;IACE,IAAI,EAAE,aAAa,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB,GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,KAAK,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA"}

package/dist/agent/sub-agents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/sub-agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/sub-agents/types.ts"],"names":[],"mappings":""}

package/dist/agent/system-prompt.d.ts

@@ -1,7 +1,22 @@
+/** Build a focused system prompt for a sub-agent invocation.
+ *  Shorter than the parent prompt — no plan-mode overlay, no auto-memory
+ *  guidelines, no response-format rules. Just role + environment + contract. */
+export declare function buildSubAgentSystemPrompt(options: {
+    agentPrompt: string;
+    knowledgeContext: string;
+    isGitRepo: boolean;
+}): string;
 /** Build the full system prompt with dynamic values and optional knowledge context */
 export declare function buildSystemPrompt(options?: {
     knowledgeContext?: string;
     modelId?: string;
     isGitRepo?: boolean;
+    /** When true, append the plan-mode overlay (read-only constraints +
+     *  exitPlanMode handoff). Pair with `planFilePath` so the model knows
+     *  which path is allowed for writes. */
+    planMode?: boolean;
+    /** Absolute path to the session's plan file. Required when
+     *  `planMode === true`; ignored otherwise. */
+    planFilePath?: string;
 }): string;
 //# sourceMappingURL=system-prompt.d.ts.map

package/dist/agent/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/agent/system-prompt.ts"],"names":[],"mappings":"AA4FA,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,MAAM,CAcT"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/agent/system-prompt.ts"],"names":[],"mappings":"AAgOA;;gFAEgF;AAChF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;CACnB,GAAG,MAAM,CAuBT;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;4CAEwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;kDAC8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,MAAM,CAkBT"}