locadex 0.1.1 → 0.1.3

package/dist/types/claude-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-sdk.d.ts","sourceRoot":"/","sources":["types/claude-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAExB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAGD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,GAGD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAGD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,GAGD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;CACL,CAAC"}
+{"version":3,"file":"claude-sdk.d.ts","sourceRoot":"/","sources":["types/claude-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAExB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAGD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,GAGD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB,GAGD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,iBAAiB,GAAG,wBAAwB,CAAC;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB,GAGD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,SAAS,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,CAAC;CAC1E,CAAC"}

package/dist/types/claude-sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-sdk.js","sourceRoot":"/","sources":["types/claude-sdk.ts"],"names":[],"mappings":"","sourcesContent":["import { type Message, type MessageParam } from '@anthropic-ai/sdk/resources';\n\nexport type ClaudeSDKMessage =\n  // An assistant message\n  | {\n      type: 'assistant';\n      message: Message; // from Anthropic SDK\n      session_id: string;\n    }\n\n  // A user message\n  | {\n      type: 'user';\n      message: MessageParam; // from Anthropic SDK\n      session_id: string;\n    }\n\n  // Emitted as the last message\n  | {\n      type: 'result';\n      subtype: 'success';\n      cost_usd: Number;\n      duration_ms: Number;\n      duration_api_ms: Number;\n      is_error: boolean;\n      num_turns: Number;\n      result: string;\n      session_id: string;\n    }\n\n  // Emitted as the last message, when we've reached the maximum number of turns\n  | {\n      type: 'result';\n      subtype: 'error_max_turns';\n      cost_usd: Number;\n      duration_ms: Number;\n      duration_api_ms: Number;\n      is_error: boolean;\n      num_turns: Number;\n      session_id: string;\n    }\n\n  // Emitted as the first message at the start of a conversation\n  | {\n      type: 'system';\n      subtype: 'init';\n      session_id: string;\n      tools: string[];\n      mcp_servers: {\n        name: string;\n        status: string;\n      }[];\n    };\n"]}
+{"version":3,"file":"claude-sdk.js","sourceRoot":"/","sources":["types/claude-sdk.ts"],"names":[],"mappings":"","sourcesContent":["import { type Message, type MessageParam } from '@anthropic-ai/sdk/resources';\nexport type ClaudeSDKMessage =\n  // An assistant message\n  | {\n      type: 'assistant';\n      message: Message; // from Anthropic SDK\n      session_id: string;\n    }\n\n  // A user message\n  | {\n      type: 'user';\n      message: MessageParam; // from Anthropic SDK\n      session_id: string;\n    }\n\n  // Emitted as the last message\n  | {\n      type: 'result';\n      subtype: 'success';\n      duration_ms: number;\n      duration_api_ms: number;\n      is_error: boolean;\n      num_turns: number;\n      result: string;\n      session_id: string;\n      total_cost_usd: number;\n    }\n\n  // Emitted as the last message, when we've reached the maximum number of turns\n  | {\n      type: 'result';\n      subtype: 'error_max_turns' | 'error_during_execution';\n      duration_ms: number;\n      duration_api_ms: number;\n      is_error: boolean;\n      num_turns: number;\n      session_id: string;\n      total_cost_usd: number;\n    }\n\n  // Emitted as the first message at the start of a conversation\n  | {\n      type: 'system';\n      subtype: 'init';\n      apiKeySource: string;\n      cwd: string;\n      session_id: string;\n      tools: string[];\n      mcp_servers: {\n        name: string;\n        status: string;\n      }[];\n      model: string;\n      permissionMode: 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan';\n    };\n"]}

package/dist/utils/claudeCode.d.ts

@@ -1,9 +1,14 @@
 import { LocadexManager } from './locadexManager.js';
-export interface ClaudeCodeOptions {
+export type ClaudeRunOptions = {
     additionalSystemPrompt?: string;
     additionalAllowedTools?: string[];
     maxTurns?: number;
-}
+    timeoutSec: number;
+    maxRetries: number;
+};
+export type ClaudeRunnerOptions = {
+    softTurnLimit?: number;
+};
 export interface ClaudeCodeObservation {
 }
 export declare class ClaudeCodeRunner {
@@ -14,17 +19,29 @@ export declare class ClaudeCodeRunner {
     private manager;
     private changes;
     private controller;
-    private maxTurns;
+    private softTurnLimit;
     private turns;
+    private stats;
     constructor(manager: LocadexManager, controller: AbortController, options: {
         id: string;
         apiKey: string;
         mcpConfig: string;
-        maxTurns: number;
+        softTurnLimit: number;
     });
     getSessionId(): string | undefined;
     reset(): void;
-    run(prompt: string, options: ClaudeCodeOptions, obs: ClaudeCodeObservation, timeoutSec?: number, maxRetries?: number): Promise<string>;
+    resetStats(): void;
+    aggregateStats(): void;
+    /**
+     * Wraps a promise with a timeout mechanism that can abort the underlying operation
+     */
+    private withTimeout;
+    /**
+     * Retries an async operation with exponential backoff
+     * Retries on TimeoutError but not on UserAbortError
+     */
+    private withRetry;
+    run(prompt: string, options: ClaudeRunOptions, _obs: ClaudeCodeObservation): Promise<string>;
     private handleSDKOutput;
     generateReport(): string;
 }

package/dist/utils/claudeCode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claudeCode.d.ts","sourceRoot":"/","sources":["utils/claudeCode.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD,MAAM,WAAW,iBAAiB;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;CAAG;AA+DzC,qBAAa,gBAAgB;IAazB,OAAO,CAAC,OAAO;IAZjB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAa;gBAGxB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,eAAe,EACnB,OAAO,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAgBH,YAAY,IAAI,MAAM,GAAG,SAAS;IAGlC,KAAK;IAKC,GAAG,CACP,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,qBAAqB,EAC1B,UAAU,GAAE,MAAY,EACxB,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,MAAM,CAAC;IAkJlB,OAAO,CAAC,eAAe;IAoEvB,cAAc,IAAI,MAAM;CAGzB"}
+{"version":3,"file":"claudeCode.d.ts","sourceRoot":"/","sources":["utils/claudeCode.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAUrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,qBAAqB;CAAG;AAazC,qBAAa,gBAAgB;IAwBzB,OAAO,CAAC,OAAO;IAvBjB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAa;IAE1B,OAAO,CAAC,KAAK,CASX;gBAGA,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,eAAe,EACnB,OAAO,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB;IA2BH,YAAY,IAAI,MAAM,GAAG,SAAS;IAGlC,KAAK;IAKL,UAAU;IAYV,cAAc;IAad;;OAEG;YACW,WAAW;IA2BzB;;;OAGG;YACW,SAAS;IAiDjB,GAAG,CACP,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC;IAiPlB,OAAO,CAAC,eAAe;IAuEvB,cAAc,IAAI,MAAM;CAGzB"}

package/dist/utils/claudeCode.js

@@ -4,6 +4,7 @@ import { logger } from '../logging/logger.js';
 import { posthog } from '../telemetry.js';
 import { getSessionId } from './session.js';
 import * as Sentry from '@sentry/node';
+import { TimeoutError, UserAbortError, AgentProcessError, AgentSpawnError, } from './errors.js';
 const DEFAULT_ALLOWED_TOOLS = [
     'mcp__locadex__fetch-docs',
     'mcp__locadex__list-docs',
@@ -13,38 +14,6 @@ const DEFAULT_ALLOWED_TOOLS = [
     'Write',
 ].concat(guides.map((guide) => `mcp__locadex__${guide.id}`));
 const DISALLOWED_TOOLS = ['NotebookEdit', 'WebFetch', 'WebSearch'];
-/**
- * Wraps a promise with a timeout mechanism
- */
-async function withTimeout(promise, timeoutSec, timeoutMessage) {
-    const timeoutPromise = new Promise((_, reject) => {
-        global.setTimeout(() => {
-            reject(new Error(timeoutMessage || `Operation timed out after ${timeoutSec}s`));
-        }, timeoutSec * 1000);
-    });
-    return Promise.race([promise, timeoutPromise]);
-}
-/**
- * Retries an async operation with exponential backoff
- */
-async function withRetry(operation, maxRetries = 1, baseDelayMs = 1000) {
-    let lastError;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-        try {
-            return await operation();
-        }
-        catch (error) {
-            lastError = error;
-            if (attempt === maxRetries) {
-                throw lastError;
-            }
-            const delay = baseDelayMs * Math.pow(2, attempt);
-            logger.debugMessage(`Agent operation failed (attempt ${attempt + 1}/${maxRetries + 1}), retrying in ${delay}ms: ${error}`);
-            await new Promise((resolve) => global.setTimeout(resolve, delay));
-        }
-    }
-    throw lastError;
-}
 export class ClaudeCodeRunner {
     options;
     id;
@@ -53,15 +22,26 @@ export class ClaudeCodeRunner {
     manager;
     changes = [];
     controller;
-    maxTurns;
+    softTurnLimit;
     turns = 0;
+    stats;
     constructor(manager, controller, options) {
         this.options = options;
         this.manager = manager;
         this.id = options.id;
         this.mcpConfig = options.mcpConfig;
         this.controller = controller;
-        this.maxTurns = options.maxTurns;
+        this.softTurnLimit = options.softTurnLimit;
+        this.stats = {
+            cost: 0,
+            wallDuration: 0,
+            apiDuration: 0,
+            turns: 0,
+            mcpToolCalls: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            cachedInputTokens: 0,
+        };
         // Ensure API key is set
         if (!process.env.ANTHROPIC_API_KEY && !this.options.apiKey) {
             throw new Error('ANTHROPIC_API_KEY environment variable or apiKey option is required');
@@ -73,24 +53,110 @@ export class ClaudeCodeRunner {
     reset() {
         this.sessionId = undefined;
         this.turns = 0;
+        this.resetStats();
+    }
+    resetStats() {
+        this.stats = {
+            cost: 0,
+            wallDuration: 0,
+            apiDuration: 0,
+            turns: 0,
+            mcpToolCalls: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            cachedInputTokens: 0,
+        };
+    }
+    aggregateStats() {
+        this.manager.stats.updateStats({
+            newCost: this.stats.cost,
+            newWallDuration: this.stats.wallDuration,
+            newApiDuration: this.stats.apiDuration,
+            newTurns: this.stats.turns,
+            newToolCalls: this.stats.mcpToolCalls,
+            newInputTokens: this.stats.inputTokens,
+            newOutputTokens: this.stats.outputTokens,
+            newCachedInputTokens: this.stats.cachedInputTokens,
+        });
+    }
+    /**
+     * Wraps a promise with a timeout mechanism that can abort the underlying operation
+     */
+    async withTimeout(promiseFactory, timeoutSec, timeoutMessage) {
+        const timeoutController = new AbortController();
+        let timeoutId;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = global.setTimeout(() => {
+                timeoutController.abort();
+                reject(new TimeoutError(timeoutMessage || `Operation timed out after ${timeoutSec}s`, timeoutSec));
+            }, timeoutSec * 1000);
+        });
+        const promise = promiseFactory(timeoutController);
+        return Promise.race([promise, timeoutPromise]).finally(() => {
+            // Clear the timeout regardless of how the promise resolves
+            global.clearTimeout(timeoutId);
+        });
+    }
+    /**
+     * Retries an async operation with exponential backoff
+     * Retries on TimeoutError but not on UserAbortError
+     */
+    async withRetry(operation, maxRetries = 1, baseDelayMs = 1000) {
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on user aborts - these are intentional
+                if (lastError instanceof UserAbortError ||
+                    lastError.name === 'AbortError') {
+                    logger.debugMessage(`Claude Code operation aborted by user`);
+                    throw lastError;
+                }
+                // Don't retry on the last attempt
+                if (attempt === maxRetries) {
+                    throw lastError;
+                }
+                const delay = baseDelayMs * Math.pow(2, attempt);
+                // Log different messages for different error types
+                if (lastError instanceof TimeoutError) {
+                    logger.debugMessage(`Claude Code operation timed out (attempt ${attempt + 1}/${maxRetries + 1}), retrying in ${delay}ms: ${lastError.message}`);
+                    // reset the session id
+                    this.reset();
+                }
+                else {
+                    logger.debugMessage(`Claude Code operation failed (attempt ${attempt + 1}/${maxRetries + 1}), retrying in ${delay}ms: ${lastError.message}`);
+                }
+                await new Promise((resolve) => global.setTimeout(resolve, delay));
+            }
+        }
+        throw lastError;
     }
-    async run(prompt, options, obs, timeoutSec = 300, maxRetries = 1) {
+    async run(prompt, options, _obs) {
         this.changes = [];
-        return withRetry(() => Sentry.startSpan({
+        return this.withRetry(() => Sentry.startSpan({
             name: 'claude-code-exec',
             op: 'claude-code.exec',
             attributes: {
                 'process.command': 'claude',
             },
-        }, () => withTimeout(new Promise((resolve, reject) => {
+        }, () => this.withTimeout((timeoutController) => new Promise((resolve, reject) => {
             const args = ['-p', prompt];
             if (options.additionalSystemPrompt) {
                 args.push('--append-system-prompt', options.additionalSystemPrompt);
             }
             args.push('--output-format', 'stream-json');
             args.push('--verbose');
-            if (this.sessionId && this.turns < this.maxTurns) {
-                args.push('--resume', this.sessionId);
+            if (this.sessionId) {
+                if (this.turns < this.softTurnLimit) {
+                    args.push('--resume', this.sessionId);
+                }
+                else {
+                    logger.debugMessage(`[${this.id}] Resetting session id because of soft turn limit reached: ${this.turns} >= ${this.softTurnLimit}`);
+                    this.reset();
+                }
             }
             if (this.mcpConfig) {
                 args.push('--mcp-config', this.mcpConfig);
@@ -107,18 +173,29 @@ export class ClaudeCodeRunner {
             env.ANTHROPIC_API_KEY = this.options.apiKey;
             logger.debugMessage(`[${this.id}] Spawning Claude Code with additional args: ${JSON.stringify({
                 maxTurns: options.maxTurns,
+                softTurnLimit: this.softTurnLimit,
+                timeoutSec: options.timeoutSec,
+                maxRetries: options.maxRetries,
                 sessionId: this.sessionId,
                 mcpConfig: this.mcpConfig,
                 additionalAllowedTools: options.additionalAllowedTools,
             }, null, 2)}. API key is ${this.options.apiKey ? 'set' : 'not set'}`);
+            // Create a combined abort controller that triggers on either user abort or timeout
+            const combinedController = new AbortController();
+            const abortHandler = () => {
+                combinedController.abort();
+            };
+            this.controller.signal.addEventListener('abort', abortHandler);
+            timeoutController.signal.addEventListener('abort', abortHandler);
             const claude = spawn('claude', args, {
                 stdio: ['ignore', 'pipe', 'pipe'],
                 env,
-                signal: this.controller.signal,
+                signal: combinedController.signal,
             });
             logger.debugMessage(`[${this.id}] Spawned claude code process`);
-            const output = '';
-            const errorOutput = '';
+            const output = {
+                error: '',
+            };
             let buffer = '';
             claude.stdout?.on('data', (data) => {
                 buffer += data.toString();
@@ -130,7 +207,10 @@ export class ClaudeCodeRunner {
                         try {
                             logger.debugMessage(`[${this.id}] ${line}`);
                             const outputData = JSON.parse(line);
-                            this.handleSDKOutput(outputData, obs);
+                            const result = this.handleSDKOutput(outputData, _obs);
+                            if (!result.success) {
+                                output.error = result.error ?? '';
+                            }
                         }
                         catch (error) {
                             logger.debugMessage(`[${this.id}] Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);
@@ -141,29 +221,55 @@ export class ClaudeCodeRunner {
             claude.stderr?.on('data', (data) => {
                 logger.debugMessage(`[${this.id}] ${data.toString().trim()}`);
             });
-            claude.on('close', (code) => {
-                if (code === 0) {
-                    resolve(output.trim());
+            claude.on('close', (code, signal) => {
+                // Clean up event listeners
+                this.controller.signal.removeEventListener('abort', abortHandler);
+                timeoutController.signal.removeEventListener('abort', abortHandler);
+                if (signal === 'SIGTERM' || signal === 'SIGKILL') {
+                    // Process was terminated due to abort
+                    if (this.controller.signal.aborted) {
+                        reject(new UserAbortError('Claude Code process was aborted by user'));
+                    }
+                    else if (timeoutController.signal.aborted) {
+                        reject(new TimeoutError(`Claude Code process timed out after ${options.timeoutSec}s`, options.timeoutSec));
+                    }
+                    else {
+                        reject(new AgentProcessError(`[${this.id}] Claude Code process was terminated with signal ${signal}`, code ?? undefined));
+                    }
+                }
+                else if (code === 0) {
+                    logger.debugMessage(`[${this.id}] Claude Code exited with code ${code}`);
+                    resolve('');
                 }
                 else {
-                    logger.debugMessage(`[${this.id}] Claude Code exited with code ${code}: ${errorOutput}`);
-                    reject(new Error(`[${this.id}] Claude Code exited with code ${code}: ${errorOutput}`));
+                    logger.debugMessage(`[${this.id}] Claude Code exited with code ${code}: ${output.error}`);
+                    reject(new AgentProcessError(`[${this.id}] Claude Code exited with code ${code}: ${output.error}`, code ?? undefined));
                 }
             });
             claude.on('error', (error) => {
-                // Check if this is an AbortError
+                // Clean up event listeners
+                this.controller.signal.removeEventListener('abort', abortHandler);
+                timeoutController.signal.removeEventListener('abort', abortHandler);
                 if (error.name === 'AbortError') {
-                    logger.debugMessage(`[${this.id}] Claude Code process was aborted`);
-                    reject(new Error(`[${this.id}] Claude Code process was aborted`));
+                    // Determine if this was a user abort or timeout abort
+                    if (this.controller.signal.aborted) {
+                        reject(new UserAbortError('Claude Code process was aborted by user'));
+                    }
+                    else if (timeoutController.signal.aborted) {
+                        reject(new TimeoutError(`Claude Code process timed out after ${options.timeoutSec}s`, options.timeoutSec));
+                    }
+                    else {
+                        reject(new UserAbortError('Claude Code process was aborted'));
+                    }
                 }
                 else {
                     logger.debugMessage(`[${this.id}] failed to run Claude Code: ${error.message}`);
-                    reject(new Error(`[${this.id}] failed to run Claude Code: ${error.message}`));
+                    reject(new AgentSpawnError(`[${this.id}] failed to run Claude Code: ${error.message}`, error));
                 }
             });
-        }), timeoutSec, `Claude Code operation timed out after ${timeoutSec}s`)), maxRetries);
+        }), options.timeoutSec, `Claude Code operation timed out after ${options.timeoutSec}s`)), options.maxRetries);
     }
-    handleSDKOutput(outputData, obs) {
+    handleSDKOutput(outputData, _obs) {
         if (outputData.type === 'assistant') {
             const text = [];
             const toolUses = [];
@@ -190,36 +296,40 @@ export class ClaudeCodeRunner {
             if (toolUses.length > 0) {
                 logger.debugMessage(`[${this.id}] used tools: ${toolUses.join(', ')}`);
             }
-            this.manager.stats.updateStats({
-                newToolCalls: toolUses.length,
-                newInputTokens: outputData.message.usage.input_tokens,
-                newOutputTokens: outputData.message.usage.output_tokens,
-                newCachedInputTokens: outputData.message.usage.cache_read_input_tokens ?? 0,
-            });
+            this.stats.mcpToolCalls += toolUses.length;
+            this.stats.inputTokens += outputData.message.usage.input_tokens;
+            this.stats.outputTokens += outputData.message.usage.output_tokens;
+            this.stats.cachedInputTokens +=
+                outputData.message.usage.cache_read_input_tokens ?? 0;
         }
         else if (outputData.type === 'result') {
+            this.stats.cost = outputData.total_cost_usd;
+            this.stats.wallDuration = outputData.duration_ms;
+            this.stats.apiDuration = outputData.duration_api_ms;
+            this.stats.turns = outputData.num_turns;
+            this.turns = outputData.num_turns;
             if (!outputData.is_error) {
-                logger.verboseMessage(`[${this.id}] finished task.\nCost: $${Number(outputData.cost_usd).toFixed(2)}\nDuration: ${Number(outputData.duration_ms) / 1000}s`);
+                logger.verboseMessage(`[${this.id}] finished task.\nCost: $${outputData.total_cost_usd.toFixed(2)}\nDuration: ${outputData.duration_ms / 1000}s`);
             }
             else {
-                logger.verboseMessage(`[${this.id}] finished task with error: ${outputData.subtype}\nCost: $${outputData.cost_usd}\nDuration: ${Number(outputData.duration_ms) / 1000}s`);
+                logger.verboseMessage(`[${this.id}] finished task with error: ${outputData.subtype}\nCost: $${outputData.total_cost_usd}\nDuration: ${outputData.duration_ms / 1000}s`);
+                return {
+                    success: false,
+                    error: outputData.subtype,
+                };
             }
             if (outputData.subtype === 'success') {
                 this.changes.push(outputData.result);
             }
-            this.manager.stats.updateStats({
-                newCost: Number(outputData.cost_usd),
-                newWallDuration: Number(outputData.duration_ms),
-                newApiDuration: Number(outputData.duration_api_ms),
-                newTurns: Number(outputData.num_turns),
-            });
-            this.turns = Number(outputData.num_turns);
         }
         else if (outputData.type === 'system') {
             if (outputData.subtype === 'init') {
                 this.sessionId = outputData.session_id;
             }
         }
+        return {
+            success: true,
+        };
     }
     generateReport() {
         return this.changes.join('\n');

package/dist/utils/claudeCode.js.map

@@ -1 +1 @@
-{"version":3,"file":"claudeCode.js","sourceRoot":"/","sources":["utils/claudeCode.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'node:child_process';\nimport { ClaudeSDKMessage } from '../types/claude-sdk.js';\nimport { guides } from '../mcp/tools/guides.js';\nimport { logger } from '../logging/logger.js';\nimport { posthog } from '../telemetry.js';\nimport { LocadexManager } from './locadexManager.js';\nimport { getSessionId } from './session.js';\nimport * as Sentry from '@sentry/node';\n\nexport interface ClaudeCodeOptions {\n  additionalSystemPrompt?: string;\n  additionalAllowedTools?: string[];\n  maxTurns?: number;\n}\n\nexport interface ClaudeCodeObservation {}\n\nconst DEFAULT_ALLOWED_TOOLS = [\n  'mcp__locadex__fetch-docs',\n  'mcp__locadex__list-docs',\n  'Bash',\n  'Edit',\n  'MultiEdit',\n  'Write',\n].concat(guides.map((guide) => `mcp__locadex__${guide.id}`));\n\nconst DISALLOWED_TOOLS = ['NotebookEdit', 'WebFetch', 'WebSearch'];\n\n/**\n * Wraps a promise with a timeout mechanism\n */\nasync function withTimeout<T>(\n  promise: Promise<T>,\n  timeoutSec: number,\n  timeoutMessage?: string\n): Promise<T> {\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    global.setTimeout(() => {\n      reject(\n        new Error(timeoutMessage || `Operation timed out after ${timeoutSec}s`)\n      );\n    }, timeoutSec * 1000);\n  });\n\n  return Promise.race([promise, timeoutPromise]);\n}\n\n/**\n * Retries an async operation with exponential backoff\n */\nasync function withRetry<T>(\n  operation: () => Promise<T>,\n  maxRetries: number = 1,\n  baseDelayMs: number = 1000\n): Promise<T> {\n  let lastError: Error;\n\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    try {\n      return await operation();\n    } catch (error) {\n      lastError = error as Error;\n\n      if (attempt === maxRetries) {\n        throw lastError;\n      }\n\n      const delay = baseDelayMs * Math.pow(2, attempt);\n      logger.debugMessage(\n        `Agent operation failed (attempt ${attempt + 1}/${maxRetries + 1}), retrying in ${delay}ms: ${error}`\n      );\n      await new Promise((resolve) => global.setTimeout(resolve, delay));\n    }\n  }\n\n  throw lastError!;\n}\n\nexport class ClaudeCodeRunner {\n  private id: string;\n  private sessionId: string | undefined;\n  private mcpConfig: string | undefined;\n  private manager: LocadexManager;\n  private changes: string[] = [];\n  private controller: AbortController;\n  private maxTurns: number;\n  private turns: number = 0;\n\n  constructor(\n    manager: LocadexManager,\n    controller: AbortController,\n    private options: {\n      id: string;\n      apiKey: string;\n      mcpConfig: string;\n      maxTurns: number;\n    }\n  ) {\n    this.manager = manager;\n    this.id = options.id;\n    this.mcpConfig = options.mcpConfig;\n    this.controller = controller;\n    this.maxTurns = options.maxTurns;\n\n    // Ensure API key is set\n    if (!process.env.ANTHROPIC_API_KEY && !this.options.apiKey) {\n      throw new Error(\n        'ANTHROPIC_API_KEY environment variable or apiKey option is required'\n      );\n    }\n  }\n\n  getSessionId(): string | undefined {\n    return this.sessionId;\n  }\n  reset() {\n    this.sessionId = undefined;\n    this.turns = 0;\n  }\n\n  async run(\n    prompt: string,\n    options: ClaudeCodeOptions,\n    obs: ClaudeCodeObservation,\n    timeoutSec: number = 300,\n    maxRetries: number = 1\n  ): Promise<string> {\n    this.changes = [];\n    return withRetry(\n      () =>\n        Sentry.startSpan(\n          {\n            name: 'claude-code-exec',\n            op: 'claude-code.exec',\n            attributes: {\n              'process.command': 'claude',\n            },\n          },\n          () =>\n            withTimeout(\n              new Promise((resolve, reject) => {\n                const args = ['-p', prompt];\n\n                if (options.additionalSystemPrompt) {\n                  args.push(\n                    '--append-system-prompt',\n                    options.additionalSystemPrompt\n                  );\n                }\n\n                args.push('--output-format', 'stream-json');\n                args.push('--verbose');\n\n                if (this.sessionId && this.turns < this.maxTurns) {\n                  args.push('--resume', this.sessionId);\n                }\n\n                if (this.mcpConfig) {\n                  args.push('--mcp-config', this.mcpConfig);\n                }\n\n                args.push(\n                  '--allowedTools',\n                  [\n                    ...DEFAULT_ALLOWED_TOOLS,\n                    ...(options?.additionalAllowedTools || []),\n                  ].join(',')\n                );\n\n                args.push('--disallowedTools', DISALLOWED_TOOLS.join(','));\n\n                if (options.maxTurns) {\n                  args.push('--max-turns', options.maxTurns.toString());\n                }\n\n                const env = { ...process.env };\n                env.ANTHROPIC_API_KEY = this.options.apiKey;\n                logger.debugMessage(\n                  `[${this.id}] Spawning Claude Code with additional args: ${JSON.stringify(\n                    {\n                      maxTurns: options.maxTurns,\n                      sessionId: this.sessionId,\n                      mcpConfig: this.mcpConfig,\n                      additionalAllowedTools: options.additionalAllowedTools,\n                    },\n                    null,\n                    2\n                  )}. API key is ${this.options.apiKey ? 'set' : 'not set'}`\n                );\n\n                const claude = spawn('claude', args, {\n                  stdio: ['ignore', 'pipe', 'pipe'],\n                  env,\n                  signal: this.controller.signal,\n                });\n\n                logger.debugMessage(`[${this.id}] Spawned claude code process`);\n\n                const output = '';\n                const errorOutput = '';\n\n                let buffer = '';\n                claude.stdout?.on('data', (data) => {\n                  buffer += data.toString();\n                  const lines = buffer.split('\\n');\n\n                  // Keep the last incomplete line in buffer\n                  buffer = lines.pop() || '';\n\n                  for (const line of lines) {\n                    if (line.trim()) {\n                      try {\n                        logger.debugMessage(`[${this.id}] ${line}`);\n                        const outputData: ClaudeSDKMessage = JSON.parse(line);\n                        this.handleSDKOutput(outputData, obs);\n                      } catch (error) {\n                        logger.debugMessage(\n                          `[${this.id}] Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`\n                        );\n                      }\n                    }\n                  }\n                });\n\n                claude.stderr?.on('data', (data) => {\n                  logger.debugMessage(`[${this.id}] ${data.toString().trim()}`);\n                });\n\n                claude.on('close', (code) => {\n                  if (code === 0) {\n                    resolve(output.trim());\n                  } else {\n                    logger.debugMessage(\n                      `[${this.id}] Claude Code exited with code ${code}: ${errorOutput}`\n                    );\n                    reject(\n                      new Error(\n                        `[${this.id}] Claude Code exited with code ${code}: ${errorOutput}`\n                      )\n                    );\n                  }\n                });\n\n                claude.on('error', (error) => {\n                  // Check if this is an AbortError\n                  if (error.name === 'AbortError') {\n                    logger.debugMessage(\n                      `[${this.id}] Claude Code process was aborted`\n                    );\n                    reject(\n                      new Error(`[${this.id}] Claude Code process was aborted`)\n                    );\n                  } else {\n                    logger.debugMessage(\n                      `[${this.id}] failed to run Claude Code: ${error.message}`\n                    );\n                    reject(\n                      new Error(\n                        `[${this.id}] failed to run Claude Code: ${error.message}`\n                      )\n                    );\n                  }\n                });\n              }),\n              timeoutSec,\n              `Claude Code operation timed out after ${timeoutSec}s`\n            )\n        ),\n      maxRetries\n    );\n  }\n\n  private handleSDKOutput(\n    outputData: ClaudeSDKMessage,\n    obs: ClaudeCodeObservation\n  ) {\n    if (outputData.type === 'assistant') {\n      const text: string[] = [];\n      const toolUses: string[] = [];\n      outputData.message.content.forEach((c) => {\n        if (c.type === 'text') {\n          text.push(c.text);\n        }\n        if (c.type === 'tool_use') {\n          toolUses.push(c.name);\n          if (c.name.startsWith('mcp__locadex__')) {\n            posthog.capture({\n              distinctId: getSessionId(),\n              event: 'tool_used',\n              properties: {\n                tool: c.name,\n              },\n            });\n          }\n        }\n      });\n      if (text.length > 0) {\n        logger.verboseMessage(`[${this.id}] ${text.join('').trim()}`);\n      }\n      if (toolUses.length > 0) {\n        logger.debugMessage(`[${this.id}] used tools: ${toolUses.join(', ')}`);\n      }\n      this.manager.stats.updateStats({\n        newToolCalls: toolUses.length,\n        newInputTokens: outputData.message.usage.input_tokens,\n        newOutputTokens: outputData.message.usage.output_tokens,\n        newCachedInputTokens:\n          outputData.message.usage.cache_read_input_tokens ?? 0,\n      });\n    } else if (outputData.type === 'result') {\n      if (!outputData.is_error) {\n        logger.verboseMessage(\n          `[${this.id}] finished task.\\nCost: $${Number(outputData.cost_usd).toFixed(2)}\\nDuration: ${\n            Number(outputData.duration_ms) / 1000\n          }s`\n        );\n      } else {\n        logger.verboseMessage(\n          `[${this.id}] finished task with error: ${outputData.subtype}\\nCost: $${outputData.cost_usd}\\nDuration: ${\n            Number(outputData.duration_ms) / 1000\n          }s`\n        );\n      }\n      if (outputData.subtype === 'success') {\n        this.changes.push(outputData.result);\n      }\n      this.manager.stats.updateStats({\n        newCost: Number(outputData.cost_usd),\n        newWallDuration: Number(outputData.duration_ms),\n        newApiDuration: Number(outputData.duration_api_ms),\n        newTurns: Number(outputData.num_turns),\n      });\n      this.turns = Number(outputData.num_turns);\n    } else if (outputData.type === 'system') {\n      if (outputData.subtype === 'init') {\n        this.sessionId = outputData.session_id;\n      }\n    }\n  }\n\n  generateReport(): string {\n    return this.changes.join('\\n');\n  }\n}\n"]}
+{"version":3,"file":"claudeCode.js","sourceRoot":"/","sources":["utils/claudeCode.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'node:child_process';\nimport { ClaudeSDKMessage } from '../types/claude-sdk.js';\nimport { guides } from '../mcp/tools/guides.js';\nimport { logger } from '../logging/logger.js';\nimport { posthog } from '../telemetry.js';\nimport { LocadexManager } from './locadexManager.js';\nimport { getSessionId } from './session.js';\nimport * as Sentry from '@sentry/node';\nimport {\n  TimeoutError,\n  UserAbortError,\n  AgentProcessError,\n  AgentSpawnError,\n} from './errors.js';\n\nexport type ClaudeRunOptions = {\n  additionalSystemPrompt?: string;\n  additionalAllowedTools?: string[];\n  maxTurns?: number; // Hard limit on the number of turns per Claude Code call\n\n  // required\n  timeoutSec: number; // Timeout per .run() call\n  maxRetries: number; // Max number of retries per .run() call\n};\n\nexport type ClaudeRunnerOptions = {\n  softTurnLimit?: number; // Soft limit on the number of turns per Claude runner\n};\n\nexport interface ClaudeCodeObservation {}\n\nconst DEFAULT_ALLOWED_TOOLS = [\n  'mcp__locadex__fetch-docs',\n  'mcp__locadex__list-docs',\n  'Bash',\n  'Edit',\n  'MultiEdit',\n  'Write',\n].concat(guides.map((guide) => `mcp__locadex__${guide.id}`));\n\nconst DISALLOWED_TOOLS = ['NotebookEdit', 'WebFetch', 'WebSearch'];\n\nexport class ClaudeCodeRunner {\n  private id: string;\n  private sessionId: string | undefined;\n  private mcpConfig: string | undefined;\n  private manager: LocadexManager;\n  private changes: string[] = [];\n  private controller: AbortController;\n  private softTurnLimit: number;\n  private turns: number = 0;\n\n  private stats: {\n    cost: number;\n    wallDuration: number;\n    apiDuration: number;\n    turns: number;\n    mcpToolCalls: number;\n    inputTokens: number;\n    outputTokens: number;\n    cachedInputTokens: number;\n  };\n\n  constructor(\n    manager: LocadexManager,\n    controller: AbortController,\n    private options: {\n      id: string;\n      apiKey: string;\n      mcpConfig: string;\n      softTurnLimit: number;\n    }\n  ) {\n    this.manager = manager;\n    this.id = options.id;\n    this.mcpConfig = options.mcpConfig;\n    this.controller = controller;\n    this.softTurnLimit = options.softTurnLimit;\n\n    this.stats = {\n      cost: 0,\n      wallDuration: 0,\n      apiDuration: 0,\n      turns: 0,\n      mcpToolCalls: 0,\n      inputTokens: 0,\n      outputTokens: 0,\n      cachedInputTokens: 0,\n    };\n\n    // Ensure API key is set\n    if (!process.env.ANTHROPIC_API_KEY && !this.options.apiKey) {\n      throw new Error(\n        'ANTHROPIC_API_KEY environment variable or apiKey option is required'\n      );\n    }\n  }\n\n  getSessionId(): string | undefined {\n    return this.sessionId;\n  }\n  reset() {\n    this.sessionId = undefined;\n    this.turns = 0;\n    this.resetStats();\n  }\n  resetStats() {\n    this.stats = {\n      cost: 0,\n      wallDuration: 0,\n      apiDuration: 0,\n      turns: 0,\n      mcpToolCalls: 0,\n      inputTokens: 0,\n      outputTokens: 0,\n      cachedInputTokens: 0,\n    };\n  }\n  aggregateStats() {\n    this.manager.stats.updateStats({\n      newCost: this.stats.cost,\n      newWallDuration: this.stats.wallDuration,\n      newApiDuration: this.stats.apiDuration,\n      newTurns: this.stats.turns,\n      newToolCalls: this.stats.mcpToolCalls,\n      newInputTokens: this.stats.inputTokens,\n      newOutputTokens: this.stats.outputTokens,\n      newCachedInputTokens: this.stats.cachedInputTokens,\n    });\n  }\n\n  /**\n   * Wraps a promise with a timeout mechanism that can abort the underlying operation\n   */\n  private async withTimeout<T>(\n    promiseFactory: (abortController: AbortController) => Promise<T>,\n    timeoutSec: number,\n    timeoutMessage?: string\n  ): Promise<T> {\n    const timeoutController = new AbortController();\n    let timeoutId: ReturnType<typeof global.setTimeout>;\n\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      timeoutId = global.setTimeout(() => {\n        timeoutController.abort();\n        reject(\n          new TimeoutError(\n            timeoutMessage || `Operation timed out after ${timeoutSec}s`,\n            timeoutSec\n          )\n        );\n      }, timeoutSec * 1000);\n    });\n\n    const promise = promiseFactory(timeoutController);\n    return Promise.race([promise, timeoutPromise]).finally(() => {\n      // Clear the timeout regardless of how the promise resolves\n      global.clearTimeout(timeoutId);\n    });\n  }\n\n  /**\n   * Retries an async operation with exponential backoff\n   * Retries on TimeoutError but not on UserAbortError\n   */\n  private async withRetry<T>(\n    operation: () => Promise<T>,\n    maxRetries: number = 1,\n    baseDelayMs: number = 1000\n  ): Promise<T> {\n    let lastError: Error;\n\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error as Error;\n\n        // Don't retry on user aborts - these are intentional\n        if (\n          lastError instanceof UserAbortError ||\n          lastError.name === 'AbortError'\n        ) {\n          logger.debugMessage(`Claude Code operation aborted by user`);\n          throw lastError;\n        }\n\n        // Don't retry on the last attempt\n        if (attempt === maxRetries) {\n          throw lastError;\n        }\n\n        const delay = baseDelayMs * Math.pow(2, attempt);\n\n        // Log different messages for different error types\n        if (lastError instanceof TimeoutError) {\n          logger.debugMessage(\n            `Claude Code operation timed out (attempt ${attempt + 1}/${maxRetries + 1}), retrying in ${delay}ms: ${lastError.message}`\n          );\n          // reset the session id\n          this.reset();\n        } else {\n          logger.debugMessage(\n            `Claude Code operation failed (attempt ${attempt + 1}/${maxRetries + 1}), retrying in ${delay}ms: ${lastError.message}`\n          );\n        }\n\n        await new Promise((resolve) => global.setTimeout(resolve, delay));\n      }\n    }\n\n    throw lastError!;\n  }\n\n  async run(\n    prompt: string,\n    options: ClaudeRunOptions,\n    _obs: ClaudeCodeObservation\n  ): Promise<string> {\n    this.changes = [];\n    return this.withRetry(\n      () =>\n        Sentry.startSpan(\n          {\n            name: 'claude-code-exec',\n            op: 'claude-code.exec',\n            attributes: {\n              'process.command': 'claude',\n            },\n          },\n          () =>\n            this.withTimeout(\n              (timeoutController: AbortController) =>\n                new Promise<string>((resolve, reject) => {\n                  const args = ['-p', prompt];\n\n                  if (options.additionalSystemPrompt) {\n                    args.push(\n                      '--append-system-prompt',\n                      options.additionalSystemPrompt\n                    );\n                  }\n\n                  args.push('--output-format', 'stream-json');\n                  args.push('--verbose');\n\n                  if (this.sessionId) {\n                    if (this.turns < this.softTurnLimit) {\n                      args.push('--resume', this.sessionId);\n                    } else {\n                      logger.debugMessage(\n                        `[${this.id}] Resetting session id because of soft turn limit reached: ${this.turns} >= ${this.softTurnLimit}`\n                      );\n                      this.reset();\n                    }\n                  }\n\n                  if (this.mcpConfig) {\n                    args.push('--mcp-config', this.mcpConfig);\n                  }\n\n                  args.push(\n                    '--allowedTools',\n                    [\n                      ...DEFAULT_ALLOWED_TOOLS,\n                      ...(options?.additionalAllowedTools || []),\n                    ].join(',')\n                  );\n\n                  args.push('--disallowedTools', DISALLOWED_TOOLS.join(','));\n\n                  if (options.maxTurns) {\n                    args.push('--max-turns', options.maxTurns.toString());\n                  }\n\n                  const env = { ...process.env };\n                  env.ANTHROPIC_API_KEY = this.options.apiKey;\n                  logger.debugMessage(\n                    `[${this.id}] Spawning Claude Code with additional args: ${JSON.stringify(\n                      {\n                        maxTurns: options.maxTurns,\n                        softTurnLimit: this.softTurnLimit,\n                        timeoutSec: options.timeoutSec,\n                        maxRetries: options.maxRetries,\n                        sessionId: this.sessionId,\n                        mcpConfig: this.mcpConfig,\n                        additionalAllowedTools: options.additionalAllowedTools,\n                      },\n                      null,\n                      2\n                    )}. API key is ${this.options.apiKey ? 'set' : 'not set'}`\n                  );\n\n                  // Create a combined abort controller that triggers on either user abort or timeout\n                  const combinedController = new AbortController();\n\n                  const abortHandler = () => {\n                    combinedController.abort();\n                  };\n\n                  this.controller.signal.addEventListener(\n                    'abort',\n                    abortHandler\n                  );\n                  timeoutController.signal.addEventListener(\n                    'abort',\n                    abortHandler\n                  );\n\n                  const claude = spawn('claude', args, {\n                    stdio: ['ignore', 'pipe', 'pipe'],\n                    env,\n                    signal: combinedController.signal,\n                  });\n\n                  logger.debugMessage(\n                    `[${this.id}] Spawned claude code process`\n                  );\n\n                  const output = {\n                    error: '',\n                  };\n\n                  let buffer = '';\n                  claude.stdout?.on('data', (data) => {\n                    buffer += data.toString();\n                    const lines = buffer.split('\\n');\n\n                    // Keep the last incomplete line in buffer\n                    buffer = lines.pop() || '';\n\n                    for (const line of lines) {\n                      if (line.trim()) {\n                        try {\n                          logger.debugMessage(`[${this.id}] ${line}`);\n                          const outputData: ClaudeSDKMessage = JSON.parse(line);\n                          const result = this.handleSDKOutput(outputData, _obs);\n                          if (!result.success) {\n                            output.error = result.error ?? '';\n                          }\n                        } catch (error) {\n                          logger.debugMessage(\n                            `[${this.id}] Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`\n                          );\n                        }\n                      }\n                    }\n                  });\n\n                  claude.stderr?.on('data', (data) => {\n                    logger.debugMessage(\n                      `[${this.id}] ${data.toString().trim()}`\n                    );\n                  });\n\n                  claude.on('close', (code, signal) => {\n                    // Clean up event listeners\n                    this.controller.signal.removeEventListener(\n                      'abort',\n                      abortHandler\n                    );\n                    timeoutController.signal.removeEventListener(\n                      'abort',\n                      abortHandler\n                    );\n\n                    if (signal === 'SIGTERM' || signal === 'SIGKILL') {\n                      // Process was terminated due to abort\n                      if (this.controller.signal.aborted) {\n                        reject(\n                          new UserAbortError(\n                            'Claude Code process was aborted by user'\n                          )\n                        );\n                      } else if (timeoutController.signal.aborted) {\n                        reject(\n                          new TimeoutError(\n                            `Claude Code process timed out after ${options.timeoutSec}s`,\n                            options.timeoutSec\n                          )\n                        );\n                      } else {\n                        reject(\n                          new AgentProcessError(\n                            `[${this.id}] Claude Code process was terminated with signal ${signal}`,\n                            code ?? undefined\n                          )\n                        );\n                      }\n                    } else if (code === 0) {\n                      logger.debugMessage(\n                        `[${this.id}] Claude Code exited with code ${code}`\n                      );\n                      resolve('');\n                    } else {\n                      logger.debugMessage(\n                        `[${this.id}] Claude Code exited with code ${code}: ${output.error}`\n                      );\n                      reject(\n                        new AgentProcessError(\n                          `[${this.id}] Claude Code exited with code ${code}: ${output.error}`,\n                          code ?? undefined\n                        )\n                      );\n                    }\n                  });\n\n                  claude.on('error', (error) => {\n                    // Clean up event listeners\n                    this.controller.signal.removeEventListener(\n                      'abort',\n                      abortHandler\n                    );\n                    timeoutController.signal.removeEventListener(\n                      'abort',\n                      abortHandler\n                    );\n\n                    if (error.name === 'AbortError') {\n                      // Determine if this was a user abort or timeout abort\n                      if (this.controller.signal.aborted) {\n                        reject(\n                          new UserAbortError(\n                            'Claude Code process was aborted by user'\n                          )\n                        );\n                      } else if (timeoutController.signal.aborted) {\n                        reject(\n                          new TimeoutError(\n                            `Claude Code process timed out after ${options.timeoutSec}s`,\n                            options.timeoutSec\n                          )\n                        );\n                      } else {\n                        reject(\n                          new UserAbortError('Claude Code process was aborted')\n                        );\n                      }\n                    } else {\n                      logger.debugMessage(\n                        `[${this.id}] failed to run Claude Code: ${error.message}`\n                      );\n                      reject(\n                        new AgentSpawnError(\n                          `[${this.id}] failed to run Claude Code: ${error.message}`,\n                          error\n                        )\n                      );\n                    }\n                  });\n                }),\n              options.timeoutSec,\n              `Claude Code operation timed out after ${options.timeoutSec}s`\n            )\n        ),\n      options.maxRetries\n    );\n  }\n\n  private handleSDKOutput(\n    outputData: ClaudeSDKMessage,\n    _obs: ClaudeCodeObservation\n  ): { success: boolean; error?: string } {\n    if (outputData.type === 'assistant') {\n      const text: string[] = [];\n      const toolUses: string[] = [];\n      outputData.message.content.forEach((c) => {\n        if (c.type === 'text') {\n          text.push(c.text);\n        }\n        if (c.type === 'tool_use') {\n          toolUses.push(c.name);\n          if (c.name.startsWith('mcp__locadex__')) {\n            posthog.capture({\n              distinctId: getSessionId(),\n              event: 'tool_used',\n              properties: {\n                tool: c.name,\n              },\n            });\n          }\n        }\n      });\n      if (text.length > 0) {\n        logger.verboseMessage(`[${this.id}] ${text.join('').trim()}`);\n      }\n      if (toolUses.length > 0) {\n        logger.debugMessage(`[${this.id}] used tools: ${toolUses.join(', ')}`);\n      }\n      this.stats.mcpToolCalls += toolUses.length;\n      this.stats.inputTokens += outputData.message.usage.input_tokens;\n      this.stats.outputTokens += outputData.message.usage.output_tokens;\n      this.stats.cachedInputTokens +=\n        outputData.message.usage.cache_read_input_tokens ?? 0;\n    } else if (outputData.type === 'result') {\n      this.stats.cost = outputData.total_cost_usd;\n      this.stats.wallDuration = outputData.duration_ms;\n      this.stats.apiDuration = outputData.duration_api_ms;\n      this.stats.turns = outputData.num_turns;\n      this.turns = outputData.num_turns;\n      if (!outputData.is_error) {\n        logger.verboseMessage(\n          `[${this.id}] finished task.\\nCost: $${outputData.total_cost_usd.toFixed(2)}\\nDuration: ${\n            outputData.duration_ms / 1000\n          }s`\n        );\n      } else {\n        logger.verboseMessage(\n          `[${this.id}] finished task with error: ${outputData.subtype}\\nCost: $${outputData.total_cost_usd}\\nDuration: ${\n            outputData.duration_ms / 1000\n          }s`\n        );\n        return {\n          success: false,\n          error: outputData.subtype,\n        };\n      }\n      if (outputData.subtype === 'success') {\n        this.changes.push(outputData.result);\n      }\n    } else if (outputData.type === 'system') {\n      if (outputData.subtype === 'init') {\n        this.sessionId = outputData.session_id;\n      }\n    }\n    return {\n      success: true,\n    };\n  }\n\n  generateReport(): string {\n    return this.changes.join('\\n');\n  }\n}\n"]}

package/dist/utils/errors.d.ts

@@ -0,0 +1,20 @@
+export declare class AgentError extends Error {
+    readonly code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+export declare class TimeoutError extends AgentError {
+    readonly timeoutSec: number;
+    constructor(message: string, timeoutSec: number);
+}
+export declare class UserAbortError extends AgentError {
+    constructor(message?: string);
+}
+export declare class AgentProcessError extends AgentError {
+    readonly exitCode?: number | undefined;
+    constructor(message: string, exitCode?: number | undefined);
+}
+export declare class AgentSpawnError extends AgentError {
+    readonly originalError: Error;
+    constructor(message: string, originalError: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"/","sources":["utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED,qBAAa,YAAa,SAAQ,UAAU;aAGxB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC;AAED,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,GAAE,MAAwC;CAI9D;AAED,qBAAa,iBAAkB,SAAQ,UAAU;aAG7B,QAAQ,CAAC,EAAE,MAAM;gBADjC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED,qBAAa,eAAgB,SAAQ,UAAU;aAG3B,aAAa,EAAE,KAAK;gBADpC,OAAO,EAAE,MAAM,EACC,aAAa,EAAE,KAAK;CAKvC"}

package/dist/utils/errors.js

@@ -0,0 +1,39 @@
+export class AgentError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'AgentError';
+    }
+}
+export class TimeoutError extends AgentError {
+    timeoutSec;
+    constructor(message, timeoutSec) {
+        super(message, 'TIMEOUT');
+        this.timeoutSec = timeoutSec;
+        this.name = 'TimeoutError';
+    }
+}
+export class UserAbortError extends AgentError {
+    constructor(message = 'Operation was aborted by user') {
+        super(message, 'USER_ABORT');
+        this.name = 'UserAbortError';
+    }
+}
+export class AgentProcessError extends AgentError {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message, 'PROCESS_ERROR');
+        this.exitCode = exitCode;
+        this.name = 'AgentProcessError';
+    }
+}
+export class AgentSpawnError extends AgentError {
+    originalError;
+    constructor(message, originalError) {
+        super(message, 'SPAWN_ERROR');
+        this.originalError = originalError;
+        this.name = 'AgentSpawnError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"/","sources":["utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IAFlB,YACE,OAAe,EACC,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,UAAU;IAGxB;IAFlB,YACE,OAAe,EACC,UAAkB;QAElC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAFV,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,UAAkB,+BAA+B;QAC3D,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAG7B;IAFlB,YACE,OAAe,EACC,QAAiB;QAEjC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAFhB,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAG3B;IAFlB,YACE,OAAe,EACC,aAAoB;QAEpC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAFd,kBAAa,GAAb,aAAa,CAAO;QAGpC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF","sourcesContent":["export class AgentError extends Error {\n  constructor(\n    message: string,\n    public readonly code?: string\n  ) {\n    super(message);\n    this.name = 'AgentError';\n  }\n}\n\nexport class TimeoutError extends AgentError {\n  constructor(\n    message: string,\n    public readonly timeoutSec: number\n  ) {\n    super(message, 'TIMEOUT');\n    this.name = 'TimeoutError';\n  }\n}\n\nexport class UserAbortError extends AgentError {\n  constructor(message: string = 'Operation was aborted by user') {\n    super(message, 'USER_ABORT');\n    this.name = 'UserAbortError';\n  }\n}\n\nexport class AgentProcessError extends AgentError {\n  constructor(\n    message: string,\n    public readonly exitCode?: number\n  ) {\n    super(message, 'PROCESS_ERROR');\n    this.name = 'AgentProcessError';\n  }\n}\n\nexport class AgentSpawnError extends AgentError {\n  constructor(\n    message: string,\n    public readonly originalError: Error\n  ) {\n    super(message, 'SPAWN_ERROR');\n    this.name = 'AgentSpawnError';\n  }\n}\n"]}