mstro-app 0.4.2 → 0.4.4

package/dist/server/cli/headless/native-timeout-detector.js

@@ -0,0 +1,99 @@
+// Copyright (c) 2025-present Mstro, Inc. All rights reserved.
+// Licensed under the MIT License. See LICENSE file for details.
+/** Regex matching Claude Code's internal tool timeout messages */
+export const NATIVE_TIMEOUT_PATTERN = /^(\w+) timed out — (continuing|retrying) with (\d+) results? preserved$/;
+/** Quick prefix check: does incomplete text look like it might be a timeout?
+ *  Matches any capitalized tool name followed by " timed" — no hardcoded set
+ *  needed because the full NATIVE_TIMEOUT_PATTERN validates on the next chunk. */
+export const TIMEOUT_PREFIX_PATTERN = /^[A-Z]\w* timed/;
+/**
+ * Detects Claude Code's internal tool timeout messages in the text stream.
+ *
+ * Buffers text at newline boundaries to detect complete timeout lines.
+ * Non-matching text is forwarded immediately to minimize streaming latency.
+ */
+export class NativeTimeoutDetector {
+    lineBuffer = '';
+    detectedTimeouts = [];
+    /** Text buffered after native timeouts — held back from streaming until context is assessed */
+    postTimeoutBuffer = '';
+    /**
+     * Process a text_delta chunk.
+     * Returns passthrough text (for outputCallback) and any detected timeouts.
+     *
+     * After the first native timeout is detected, subsequent passthrough text
+     * is held in postTimeoutBuffer instead of returned as passthrough. This
+     * prevents confused "What were you working on?" responses from streaming
+     * to the user before context loss can be assessed.
+     */
+    processChunk(text) {
+        const timeouts = [];
+        let passthrough = '';
+        this.lineBuffer += text;
+        const lines = this.lineBuffer.split('\n');
+        const incomplete = lines.pop() ?? '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            const match = trimmed.match(NATIVE_TIMEOUT_PATTERN);
+            if (match) {
+                const event = {
+                    toolName: match[1],
+                    action: match[2],
+                    preservedCount: parseInt(match[3], 10),
+                };
+                timeouts.push(event);
+                this.detectedTimeouts.push(event);
+            }
+            else {
+                passthrough += `${line}\n`;
+            }
+        }
+        // Handle incomplete trailing text
+        if (incomplete) {
+            if (TIMEOUT_PREFIX_PATTERN.test(incomplete)) {
+                this.lineBuffer = incomplete;
+            }
+            else {
+                passthrough += incomplete;
+                this.lineBuffer = '';
+            }
+        }
+        else {
+            this.lineBuffer = '';
+        }
+        // After native timeouts, buffer passthrough text instead of returning it.
+        if (this.detectedTimeouts.length > 0 && passthrough) {
+            this.postTimeoutBuffer += passthrough;
+            passthrough = '';
+        }
+        return { passthrough, timeouts };
+    }
+    /** Flush any held buffer (call on stream end).
+     *  Also checks remaining buffer for timeout patterns so the last
+     *  timeout message (without trailing newline) is always counted.
+     */
+    flush() {
+        const remaining = this.lineBuffer;
+        this.lineBuffer = '';
+        if (remaining) {
+            const trimmed = remaining.trim();
+            const match = trimmed.match(NATIVE_TIMEOUT_PATTERN);
+            if (match) {
+                this.detectedTimeouts.push({
+                    toolName: match[1],
+                    action: match[2],
+                    preservedCount: parseInt(match[3], 10),
+                });
+                return '';
+            }
+        }
+        return remaining;
+    }
+    get timeoutCount() {
+        return this.detectedTimeouts.length;
+    }
+    get bufferedPostTimeoutOutput() {
+        return this.postTimeoutBuffer;
+    }
+}
+//# sourceMappingURL=native-timeout-detector.js.map

package/dist/server/cli/headless/native-timeout-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-timeout-detector.js","sourceRoot":"","sources":["../../../../server/cli/headless/native-timeout-detector.ts"],"names":[],"mappings":"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"}

package/dist/server/cli/headless/stall-assessor.d.ts

@@ -1,129 +1,21 @@
+export type { ApprovalVerdict, BestResultContext, BestResultVerdict, ContextLossContext, ContextLossVerdict, ErrorClassification, PrematureCompletionContext, PrematureCompletionVerdict } from './haiku-assessments.js';
+export { assessApproval, assessBestResult, assessContextLoss, assessPrematureCompletion, classifyError } from './haiku-assessments.js';
 export interface StallContext {
-    /** The original user prompt being executed */
     originalPrompt: string;
-    /** How long the process has been silent (ms) */
     silenceMs: number;
-    /** Name of the last tool that started executing */
     lastToolName?: string;
-    /** Summarized input of the last tool call */
     lastToolInputSummary?: string;
-    /** Number of tool calls started but not yet returned */
     pendingToolCount: number;
-    /** Names of all currently pending tools (toolId -> toolName) */
     pendingToolNames?: Set<string>;
-    /** Total tool calls made so far this session */
     totalToolCalls: number;
-    /** Total wall-clock time since process started (ms) */
     elapsedTotalMs: number;
-    /** Time since the last token usage event (ms). Undefined if no token events yet. */
     tokenSilenceMs?: number;
 }
 export interface StallVerdict {
-    /** Whether to extend the deadline or proceed with kill */
     action: 'extend' | 'kill';
-    /** Additional time to grant (ms), only meaningful when action is 'extend' */
     extensionMs: number;
-    /** Human-readable reason for the verdict */
     reason: string;
 }
-/**
- * Main assessment entry point. Tries the fast heuristic first,
- * falls back to a Haiku model call for ambiguous cases.
- */
 export declare function assessStall(ctx: StallContext, claudeCommand: string, verbose: boolean, toolWatchdogActive?: boolean): Promise<StallVerdict>;
-/**
- * Assess a specific tool timeout using Haiku.
- * Used by ToolWatchdog as a tiebreaker before killing a tool.
- */
 export declare function assessToolTimeout(toolName: string, toolInput: Record<string, unknown>, elapsedMs: number, claudeCommand: string, verbose: boolean, tokenSilenceMs?: number): Promise<StallVerdict>;
-export interface ContextLossVerdict {
-    /** Whether the agent lost context and needs recovery */
-    contextLost: boolean;
-    /** Human-readable reason for the verdict */
-    reason: string;
-}
-/** Enriched context for Haiku-based context loss assessment */
-export interface ContextLossContext {
-    assistantResponse: string;
-    effectiveTimeouts: number;
-    nativeTimeoutCount: number;
-    successfulToolCalls: number;
-    thinkingOutputLength: number;
-    hasSuccessfulWrite: boolean;
-}
-/**
- * Assess whether a Claude Code session lost context after tool timeouts.
- * Uses Haiku with enriched context signals — replaces brittle hardcoded
- * thresholds (200 chars thinking, 2x ratio, 500 chars response) with
- * a single LLM call that sees the full picture.
- *
- * Only call this when effectiveTimeouts > 0.
- */
-export declare function assessContextLoss(ctx: ContextLossContext, claudeCommand: string, verbose: boolean): Promise<ContextLossVerdict>;
-export interface ApprovalVerdict {
-    isApproval: boolean;
-    reason: string;
-}
-/**
- * Assess whether a user message is an approval/continuation or a new task.
- * Uses Haiku to classify intent — handles natural language variations that
- * regex patterns miss ("sounds good", "yep do it", "option 2", etc.).
- */
-export declare function assessApproval(userMessage: string, claudeCommand: string, verbose: boolean): Promise<ApprovalVerdict>;
-export interface PrematureCompletionContext {
-    /** The trailing portion of the assistant response (last ~800 chars) */
-    responseTail: string;
-    /** Total number of successful tool calls in this execution */
-    successfulToolCalls: number;
-    /** Whether extended thinking output was produced */
-    hasThinking: boolean;
-    /** Total response length */
-    responseLength: number;
-}
-export interface PrematureCompletionVerdict {
-    /** True if the task appears incomplete and should be auto-continued */
-    isIncomplete: boolean;
-    reason: string;
-}
-/**
- * Assess whether a completed Claude execution ended prematurely.
- * Called when stop_reason is 'end_turn' but the task may not be finished.
- * Haiku determines if the trailing response text indicates planned-but-unexecuted work.
- */
-export declare function assessPrematureCompletion(ctx: PrematureCompletionContext, claudeCommand: string, verbose: boolean): Promise<PrematureCompletionVerdict>;
-export interface BestResultContext {
-    originalPrompt: string;
-    resultA: {
-        successfulToolCalls: number;
-        responseLength: number;
-        hasThinking: boolean;
-        responseTail: string;
-    };
-    resultB: {
-        successfulToolCalls: number;
-        responseLength: number;
-        hasThinking: boolean;
-        responseTail: string;
-    };
-}
-export interface BestResultVerdict {
-    winner: 'A' | 'B';
-    reason: string;
-}
-/**
- * Compare two retry results and determine which made more meaningful progress.
- * Uses Haiku to evaluate quality — replaces arbitrary numeric scoring
- * (tool count * 10 + response length / 50 + thinking bonus).
- */
-export declare function assessBestResult(ctx: BestResultContext, claudeCommand: string, verbose: boolean): Promise<BestResultVerdict>;
-export interface ErrorClassification {
-    errorCode: string;
-    message: string;
-}
-/**
- * Classify an unrecognized error from stderr using Haiku.
- * Called as a fallback when regex patterns in output-utils.ts don't match.
- * Returns null if the stderr content isn't a real error (just warnings/debug info).
- */
-export declare function classifyError(stderrContent: string, claudeCommand: string, verbose: boolean): Promise<ErrorClassification | null>;
 //# sourceMappingURL=stall-assessor.d.ts.map

package/dist/server/cli/headless/stall-assessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stall-assessor.d.ts","sourceRoot":"","sources":["../../../../server/cli/headless/stall-assessor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stall-assessor.d.ts","sourceRoot":"","sources":["../../../../server/cli/headless/stall-assessor.ts"],"names":[],"mappings":"AAgBA,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzN,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvI,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAmJD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,YAAY,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,EAChB,kBAAkB,UAAQ,GACzB,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,YAAY,CAAC,CA8CvB"}