@nexus-cortex/core 4.26.0

package/dist/orchestrator/SubAgentProcessManager.js.map

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

package/dist/orchestrator/SubAgentTypes.d.ts

@@ -0,0 +1,428 @@
+/**
+ * Sub-Agent Type Definitions
+ *
+ * Core types for the Task Agent sub-agent spawning system.
+ * These types define the contracts between parent orchestrator,
+ * child orchestrators, and the event/result systems.
+ *
+ * @module orchestrator/SubAgentTypes
+ * @version 1.0.0
+ */
+/**
+ * Approval mode type (matches CortexOrchestrator's internal type)
+ */
+export type ApprovalMode = 'inherit' | 'auto' | 'manual';
+/**
+ * Agent permission mode - determines how tool approvals are handled
+ *
+ * - 'interactive': Prompt user for approval (default, safest)
+ * - 'auto-approve': Auto-approve allowed tools (for trusted agents)
+ * - 'deny-all': Block all tools requiring approval
+ */
+export type AgentPermissionMode = 'interactive' | 'auto-approve' | 'deny-all';
+/**
+ * Tool permission level for agent-specific permissions
+ *
+ * - 'whitelist': Tool is always allowed without approval
+ * - 'graylist': Tool requires user approval or auto-approval setting
+ * - 'blacklist': Tool is blocked and requires explicit override
+ */
+export type ToolPermissionLevel = 'whitelist' | 'graylist' | 'blacklist';
+/**
+ * Agent permission configuration
+ *
+ * Defines how an agent handles tool permissions independently of parent session.
+ * IMPORTANT: Agent permissions do NOT inherit from parent session permissions.
+ */
+export interface AgentPermissions {
+    /**
+     * Default permission mode for tools not explicitly configured
+     * @default 'interactive'
+     */
+    defaultMode: AgentPermissionMode;
+    /**
+     * Tool-specific permission levels
+     * Key is tool name (case-insensitive), value is permission level
+     */
+    toolLevels?: Record<string, ToolPermissionLevel>;
+    /**
+     * Whitelisted tools (always allowed without approval)
+     * Shorthand for setting toolLevels[tool] = 'whitelist'
+     */
+    whitelist?: string[];
+    /**
+     * Graylisted tools (require approval based on defaultMode)
+     * Shorthand for setting toolLevels[tool] = 'graylist'
+     */
+    graylist?: string[];
+    /**
+     * Blacklisted tools (blocked, require explicit override)
+     * Shorthand for setting toolLevels[tool] = 'blacklist'
+     */
+    blacklist?: string[];
+    /**
+     * Whether to allow execution tools (Bash, etc.) at all
+     * If false, execution tools are implicitly blacklisted
+     * @default true
+     */
+    allowExecutionTools?: boolean;
+}
+/**
+ * Agent definition loaded from .cortex/agents/*.md files
+ */
+export interface AgentDefinition {
+    /** Agent identifier (alphanumeric + hyphens, max 64 chars) */
+    name: string;
+    /** Description of when to use this agent */
+    description: string;
+    /** Agent's system prompt (content after frontmatter) */
+    systemPrompt: string;
+    /** Allowed tools - list of tool names or 'all' */
+    tools: string[] | 'all';
+    /** Model preference - 'inherit', alias, or full model ID */
+    model: string;
+    /** Where the agent was loaded from ('builtin' = shipped with the install) */
+    location: 'project' | 'personal' | 'builtin';
+    /** Full path to the agent's .md file */
+    filePath: string;
+    /**
+     * Agent-specific permission configuration
+     *
+     * IMPORTANT: This does NOT inherit from parent session.
+     * If not specified, defaults to 'interactive' mode (prompts user).
+     * Execution tools (Bash, etc.) default to graylist (require approval).
+     */
+    permissions?: AgentPermissions;
+}
+/**
+ * Configuration for creating a sub-agent
+ */
+export interface SubAgentConfig {
+    /** Unique identifier for this sub-agent instance */
+    agentId: string;
+    /** Agent definition from TaskToolExecutor */
+    agentDefinition: AgentDefinition;
+    /** Task prompt from user */
+    taskPrompt: string;
+    /** Resolved model ID (after alias resolution) */
+    modelId: string;
+    /** Timeout in milliseconds (default: 300000 = 5 minutes) */
+    timeoutMs?: number;
+    /** Maximum turns before forced completion */
+    maxTurns?: number;
+}
+/**
+ * Context passed from parent to child orchestrator
+ */
+export interface SubAgentContext {
+    /** Parent's session ID for correlation */
+    parentSessionId: string;
+    /** Parent's turn number when sub-agent was spawned */
+    parentTurnNumber: number;
+    /** Event emitter for streaming to parent */
+    eventEmitter: ISubAgentEventEmitter;
+    /** Abort controller for interruption */
+    abortController: AbortController;
+    /** Pause controller for suspension */
+    pauseController: IPauseController;
+    /** Parent's approval mode */
+    approvalMode: ApprovalMode;
+}
+/**
+ * Pause controller interface
+ */
+export interface IPauseController {
+    pause(): void;
+    resume(): void;
+    isPaused(): boolean;
+    waitIfPaused(): Promise<void>;
+}
+/**
+ * Sub-agent event emitter interface
+ */
+export interface ISubAgentEventEmitter {
+    emit<K extends keyof SubAgentEvents>(event: K, data: SubAgentEvents[K]): boolean;
+    on<K extends keyof SubAgentEvents>(event: K, listener: (data: SubAgentEvents[K]) => void): this;
+    once<K extends keyof SubAgentEvents>(event: K, listener: (data: SubAgentEvents[K]) => void): this;
+    off<K extends keyof SubAgentEvents>(event: K, listener: (data: SubAgentEvents[K]) => void): this;
+}
+/**
+ * Tool usage statistics
+ */
+export interface ToolUsageSummary {
+    /** Tool name */
+    name: string;
+    /** Number of times tool was called */
+    callCount: number;
+    /** Total execution time in milliseconds */
+    totalDuration: number;
+    /** Number of errors */
+    errors: number;
+}
+/**
+ * Cost metrics for sub-agent execution
+ */
+export interface SubAgentCostMetrics {
+    /** Input tokens used */
+    inputTokens: number;
+    /** Output tokens generated */
+    outputTokens: number;
+    /** Estimated cost in USD */
+    estimatedCost: number;
+    /** Number of cache hits */
+    cacheHits: number;
+}
+/**
+ * Error details for failed sub-agents
+ */
+export interface SubAgentErrorDetails {
+    /** Error message */
+    message: string;
+    /** Error type/name */
+    type: string;
+    /** Stack trace (if available) */
+    stack?: string;
+}
+/**
+ * Artifact produced by sub-agent
+ */
+export interface SubAgentArtifact {
+    /** Artifact type */
+    type: 'code' | 'report' | 'data' | 'visualization' | 'file';
+    /** File path (if saved to disk) */
+    path?: string;
+    /** Inline content (if not saved) */
+    content?: string;
+    /** MIME type */
+    mimeType?: string;
+}
+/**
+ * Result returned by completed sub-agent
+ */
+export interface SubAgentResult {
+    /** Unique identifier for this sub-agent instance */
+    agentId: string;
+    /** Agent name from definition */
+    agentName: string;
+    /** Model used for execution */
+    model: string;
+    /** When execution started */
+    startTime: Date;
+    /** When execution ended */
+    endTime: Date;
+    /** Total duration in milliseconds */
+    durationMs: number;
+    /** Number of conversation turns */
+    turnCount: number;
+    /** Final status */
+    status: 'completed' | 'interrupted' | 'error' | 'timeout';
+    /** Brief summary for parent LLM */
+    summary: string;
+    /** Complete response text */
+    fullResponse: string;
+    /** Parsed structured data (if applicable) */
+    structuredData?: Record<string, unknown>;
+    /** Statistics per tool */
+    toolsUsed: ToolUsageSummary[];
+    /** Files read during execution */
+    filesRead: string[];
+    /** Files modified during execution */
+    filesModified: string[];
+    /** Token usage and cost metrics */
+    cost: SubAgentCostMetrics;
+    /** Error details for failed executions */
+    error?: SubAgentErrorDetails;
+    /** Artifacts produced by the agent */
+    artifacts?: SubAgentArtifact[];
+}
+/**
+ * Events emitted by sub-agents
+ *
+ * These events allow parent orchestrators and CLI components
+ * to monitor sub-agent progress in real-time.
+ */
+export interface SubAgentEvents {
+    /**
+     * Emitted when a sub-agent starts execution
+     */
+    'agent:started': {
+        agentId: string;
+        agentName: string;
+        model: string;
+        task: string;
+        parentSessionId: string;
+    };
+    /**
+     * Emitted periodically to report progress
+     */
+    'agent:progress': {
+        agentId: string;
+        turnNumber: number;
+        totalTokens: number;
+        elapsedMs: number;
+    };
+    /**
+     * Emitted when a tool is called
+     */
+    'agent:tool_call': {
+        agentId: string;
+        toolName: string;
+        toolInput: Record<string, unknown>;
+        toolId: string;
+    };
+    /**
+     * Emitted when a tool returns a result
+     */
+    'agent:tool_result': {
+        agentId: string;
+        toolName: string;
+        toolId: string;
+        success: boolean;
+        summary: string;
+        durationMs: number;
+    };
+    /**
+     * Emitted when thinking/reasoning is generated
+     */
+    'agent:thinking': {
+        agentId: string;
+        thinkingText: string;
+    };
+    /**
+     * Emitted when text is generated
+     */
+    'agent:text': {
+        agentId: string;
+        text: string;
+        isFinal: boolean;
+    };
+    /**
+     * Emitted when a tool requires user approval
+     */
+    'agent:approval_required': {
+        agentId: string;
+        agentName: string;
+        toolName: string;
+        toolInput: Record<string, unknown>;
+        reason: string;
+    };
+    /**
+     * Emitted when sub-agent completes successfully
+     */
+    'agent:completed': {
+        agentId: string;
+        result: SubAgentResult;
+    };
+    /**
+     * Emitted when sub-agent encounters an error
+     */
+    'agent:error': {
+        agentId: string;
+        agentName: string;
+        error: Error;
+    };
+    /**
+     * Emitted when sub-agent is interrupted by user
+     */
+    'agent:interrupted': {
+        agentId: string;
+        reason: string;
+    };
+    /**
+     * Emitted when sub-agent is paused
+     */
+    'agent:paused': {
+        agentId: string;
+    };
+    /**
+     * Emitted when sub-agent is resumed
+     */
+    'agent:resumed': {
+        agentId: string;
+    };
+    /**
+     * Emitted when sub-agent times out
+     */
+    'agent:timeout': {
+        agentId: string;
+        timeoutMs: number;
+        elapsedMs: number;
+    };
+}
+/**
+ * Options for spawning a sub-agent
+ */
+export interface SpawnAgentOptions {
+    /** Timeout in milliseconds (default: 300000 = 5 minutes) */
+    timeoutMs?: number;
+    /** Maximum turns before forced completion */
+    maxTurns?: number;
+    /** Override model (ignores agent definition) */
+    modelOverride?: string;
+    /** Additional context to inject */
+    additionalContext?: string;
+    /**
+     * Environment variable overrides applied when forking the child process.
+     *
+     * Used to give a subagent capabilities its parent doesn't expose. The
+     * canonical use case is the Browse subagent: parent runs with
+     * `MCP_AUTO_INJECT=false` (so 43 nexus-browser tools don't bloat its
+     * context), but the spawned browse subagent needs them — it overrides
+     * `MCP_AUTO_INJECT=true` for its own forked process only.
+     *
+     * Override semantics: shallow merge over `process.env`. Pass `''` (empty
+     * string) to unset rather than `undefined`.
+     */
+    envOverrides?: Record<string, string>;
+    /**
+     * The tool_use_id from the parent's dispatching tool call (Task, Browse, etc.).
+     *
+     * When provided, the process manager writes the completed SubAgentResult to
+     * a durable store keyed by this ID. If the parent turn is interrupted (ESC),
+     * the orphan recovery in validateAndRepairMessages can inject the real result
+     * instead of a generic "was interrupted" error.
+     */
+    toolUseId?: string;
+}
+/**
+ * Sub-agent manager interface
+ */
+export interface ISubAgentManager {
+    /**
+     * Spawn a new sub-agent to execute a task
+     */
+    spawnAgent(agentDefinition: AgentDefinition, taskPrompt: string, options?: SpawnAgentOptions): Promise<SubAgentResult>;
+    /**
+     * Pause a running agent
+     * @returns true if agent was found and paused
+     */
+    pauseAgent(agentId: string): boolean;
+    /**
+     * Resume a paused agent
+     * @returns true if agent was found and resumed
+     */
+    resumeAgent(agentId: string): boolean;
+    /**
+     * Interrupt (abort) a running agent
+     * @returns true if agent was found and interrupted
+     */
+    interruptAgent(agentId: string, reason: string): boolean;
+    /**
+     * Send guidance message to running agent
+     * @returns true if agent was found and message was injected
+     */
+    guideAgent(agentId: string, message: string): Promise<boolean>;
+    /**
+     * Get event emitter for subscribing to agent events
+     */
+    getEventEmitter(): ISubAgentEventEmitter;
+    /**
+     * Get list of active agent IDs
+     */
+    getActiveAgentIds(): string[];
+    /**
+     * Check if an agent is currently active
+     */
+    isAgentActive(agentId: string): boolean;
+}
+//# sourceMappingURL=SubAgentTypes.d.ts.map

package/dist/orchestrator/SubAgentTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubAgentTypes.d.ts","sourceRoot":"","sources":["../../src/orchestrator/SubAgentTypes.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/SubAgentTypes.js

@@ -0,0 +1,12 @@
+/**
+ * Sub-Agent Type Definitions
+ *
+ * Core types for the Task Agent sub-agent spawning system.
+ * These types define the contracts between parent orchestrator,
+ * child orchestrators, and the event/result systems.
+ *
+ * @module orchestrator/SubAgentTypes
+ * @version 1.0.0
+ */
+export {};
+//# sourceMappingURL=SubAgentTypes.js.map

package/dist/orchestrator/SubAgentTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubAgentTypes.js","sourceRoot":"","sources":["../../src/orchestrator/SubAgentTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/orchestrator/apiErrorClassifier.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Classify API errors so the orchestrator's tool-loop knows when to abort
+ * (unrecoverable) vs continue (model-recoverable).
+ *
+ * Two fatal categories:
+ *   - **Capacity**: token / context / rate-limit errors. Retrying with the
+ *     same payload makes no sense; the caller should compact or back off.
+ *   - **Structural**: 400 `invalid_request_error` shapes — signature-less
+ *     thinking blocks, orphaned tool_result, etc. Retrying with the SAME
+ *     messages[] produces the same 400 forever. Surfaced by round-12's
+ *     drift-audit benchmark, which caught the non-streaming loop burning
+ *     50 iterations of the same `thinking.signature: Field required`.
+ */
+export type ApiErrorCategory = 'capacity' | 'structural' | 'recoverable';
+export declare function classifyApiError(errorMessage: string): ApiErrorCategory;
+export declare function isFatalApiError(errorMessage: string): boolean;
+//# sourceMappingURL=apiErrorClassifier.d.ts.map

package/dist/orchestrator/apiErrorClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiErrorClassifier.d.ts","sourceRoot":"","sources":["../../src/orchestrator/apiErrorClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzE,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAwBvE;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAG7D"}

package/dist/orchestrator/apiErrorClassifier.js

@@ -0,0 +1,38 @@
+/**
+ * Classify API errors so the orchestrator's tool-loop knows when to abort
+ * (unrecoverable) vs continue (model-recoverable).
+ *
+ * Two fatal categories:
+ *   - **Capacity**: token / context / rate-limit errors. Retrying with the
+ *     same payload makes no sense; the caller should compact or back off.
+ *   - **Structural**: 400 `invalid_request_error` shapes — signature-less
+ *     thinking blocks, orphaned tool_result, etc. Retrying with the SAME
+ *     messages[] produces the same 400 forever. Surfaced by round-12's
+ *     drift-audit benchmark, which caught the non-streaming loop burning
+ *     50 iterations of the same `thinking.signature: Field required`.
+ */
+export function classifyApiError(errorMessage) {
+    const msg = errorMessage || '';
+    const isCapacity = msg.includes('Request too large') ||
+        msg.includes('Rate limit') ||
+        msg.includes('429') ||
+        msg.includes('context length exceeded') ||
+        msg.includes('maximum context') ||
+        msg.includes('token limit');
+    if (isCapacity)
+        return 'capacity';
+    const isStructural = msg.startsWith('400 ') &&
+        (msg.includes('invalid_request_error') ||
+            msg.includes('Field required') ||
+            msg.includes('messages.') ||
+            msg.includes('must be a response to') ||
+            msg.includes('must be a preceding'));
+    if (isStructural)
+        return 'structural';
+    return 'recoverable';
+}
+export function isFatalApiError(errorMessage) {
+    const c = classifyApiError(errorMessage);
+    return c === 'capacity' || c === 'structural';
+}
+//# sourceMappingURL=apiErrorClassifier.js.map

package/dist/orchestrator/apiErrorClassifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiErrorClassifier.js","sourceRoot":"","sources":["../../src/orchestrator/apiErrorClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,UAAU,gBAAgB,CAAC,YAAoB;IACnD,MAAM,GAAG,GAAG,YAAY,IAAI,EAAE,CAAC;IAE/B,MAAM,UAAU,GACd,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACjC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACvC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC9B,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,MAAM,YAAY,GAChB,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;QACtB,CACE,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACrC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC9B,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;YACzB,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACrC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CACpC,CAAC;IACJ,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,MAAM,CAAC,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,YAAY,CAAC;AAChD,CAAC"}

package/dist/orchestrator/assistantTextPresence.d.ts

@@ -0,0 +1,32 @@
+/**
+ * R29a: does an assistant turn contain at least one non-empty text block?
+ *
+ * Used to decide whether a synthesis turn must be forced. The tool loop can
+ * exit for many reasons (no more tools, MAX_CONSECUTIVE_ERRORS, loop
+ * detection, max iterations); if it exits with the final assistant turn being
+ * a bare tool_use or thinking-only, there is no deliverable for the user.
+ * R18b's inline check covered only the "no tool_use" path; this predicate is
+ * shared so the post-loop net catches every exit reason.
+ */
+export declare function hasVisibleAssistantText(content: unknown): boolean;
+/**
+ * Does the assistant turn contain an unexecuted tool_use block?
+ *
+ * At the POST-LOOP synthesis point, a trailing tool_use only occurs on an
+ * abnormal exit (loop detection / hard cap / max iterations / consecutive
+ * errors) — a normal completion returns NO tool_use. So it is a reliable
+ * "the model was interrupted mid-action and never delivered an answer" signal,
+ * even when a short preamble ("Let me check X...") is also present.
+ */
+export declare function hasUnexecutedToolUse(content: unknown): boolean;
+/**
+ * Should the post-loop R29a synthesis net fire?
+ *
+ * True when synthesis hasn't already been attempted AND the final turn either
+ * has no visible text (bare tool_use / thinking-only) OR ends with an
+ * unexecuted tool_use (short-preamble + interrupted mid-action). The second
+ * arm fixes the edge case where a preamble counts as "visible text" and the
+ * user would otherwise receive the preamble instead of a real answer.
+ */
+export declare function shouldForceSynthesis(content: unknown, alreadyAttempted: boolean): boolean;
+//# sourceMappingURL=assistantTextPresence.d.ts.map

package/dist/orchestrator/assistantTextPresence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantTextPresence.d.ts","sourceRoot":"","sources":["../../src/orchestrator/assistantTextPresence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CASjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAGT"}

package/dist/orchestrator/assistantTextPresence.js

@@ -0,0 +1,47 @@
+/**
+ * R29a: does an assistant turn contain at least one non-empty text block?
+ *
+ * Used to decide whether a synthesis turn must be forced. The tool loop can
+ * exit for many reasons (no more tools, MAX_CONSECUTIVE_ERRORS, loop
+ * detection, max iterations); if it exits with the final assistant turn being
+ * a bare tool_use or thinking-only, there is no deliverable for the user.
+ * R18b's inline check covered only the "no tool_use" path; this predicate is
+ * shared so the post-loop net catches every exit reason.
+ */
+export function hasVisibleAssistantText(content) {
+    if (!Array.isArray(content))
+        return false;
+    return content.some((b) => b &&
+        b.type === 'text' &&
+        typeof b.text === 'string' &&
+        b.text.trim().length > 0);
+}
+/**
+ * Does the assistant turn contain an unexecuted tool_use block?
+ *
+ * At the POST-LOOP synthesis point, a trailing tool_use only occurs on an
+ * abnormal exit (loop detection / hard cap / max iterations / consecutive
+ * errors) — a normal completion returns NO tool_use. So it is a reliable
+ * "the model was interrupted mid-action and never delivered an answer" signal,
+ * even when a short preamble ("Let me check X...") is also present.
+ */
+export function hasUnexecutedToolUse(content) {
+    if (!Array.isArray(content))
+        return false;
+    return content.some((b) => b && b.type === 'tool_use');
+}
+/**
+ * Should the post-loop R29a synthesis net fire?
+ *
+ * True when synthesis hasn't already been attempted AND the final turn either
+ * has no visible text (bare tool_use / thinking-only) OR ends with an
+ * unexecuted tool_use (short-preamble + interrupted mid-action). The second
+ * arm fixes the edge case where a preamble counts as "visible text" and the
+ * user would otherwise receive the preamble instead of a real answer.
+ */
+export function shouldForceSynthesis(content, alreadyAttempted) {
+    if (alreadyAttempted)
+        return false;
+    return !hasVisibleAssistantText(content) || hasUnexecutedToolUse(content);
+}
+//# sourceMappingURL=assistantTextPresence.js.map

package/dist/orchestrator/assistantTextPresence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantTextPresence.js","sourceRoot":"","sources":["../../src/orchestrator/assistantTextPresence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,CAAM,EAAE,EAAE,CACT,CAAC;QACD,CAAC,CAAC,IAAI,KAAK,MAAM;QACjB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,gBAAyB;IAEzB,IAAI,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC5E,CAAC"}