wave-agent-sdk 0.17.1 → 0.17.3

package/dist/services/aiService.js

@@ -1,11 +1,13 @@
 import { OpenAIClient } from "../utils/openaiClient.js";
 import { logger } from "../utils/globalLogger.js";
 import { addOnceAbortListener } from "../utils/abortUtils.js";
+import { ConfigurationError, CONFIG_ERRORS } from "../types/index.js";
 import { transformMessagesForClaudeCache, addCacheControlToLastTool, supportsPromptCaching, extendUsageWithCacheMetrics, } from "../utils/cacheControlUtils.js";
 import * as os from "os";
 import * as fs from "fs";
 import * as path from "path";
 import { COMPACT_MESSAGES_SYSTEM_PROMPT, WEB_CONTENT_SYSTEM_PROMPT, BTW_SYSTEM_PROMPT, } from "../prompts/index.js";
+import { GOAL_EVALUATION_SYSTEM_PROMPT } from "../constants/goalPrompts.js";
 // Global rate limiter state for 1 QPS
 let nextAllowedTime = 0;
 const MIN_INTERVAL = 1000; // 1 second for 1 QPS
@@ -63,8 +65,24 @@ function getModelConfig(modelName, baseConfig = {}) {
     }
     return config;
 }
+function validateModelConfig(modelConfig) {
+    if (!modelConfig.model) {
+        throw new ConfigurationError(CONFIG_ERRORS.MISSING_MODEL, "model", {
+            constructor: undefined,
+            environment: process.env.WAVE_MODEL,
+        });
+    }
+    if (!modelConfig.fastModel) {
+        throw new ConfigurationError(CONFIG_ERRORS.MISSING_FAST_MODEL, "fastModel", {
+            constructor: undefined,
+            environment: process.env.WAVE_FAST_MODEL,
+        });
+    }
+}
 export async function callAgent(options) {
     const { gatewayConfig, modelConfig, messages, abortSignal, workdir, tools, model, systemPrompt, onContentUpdate, onToolUpdate, onReasoningUpdate, } = options;
+    // Validate model config at call time
+    validateModelConfig(modelConfig);
     // Apply global 1 QPS rate limit
     if (process.env.NODE_ENV !== "test" ||
         modelConfig.model === "rate-limit-test") {
@@ -127,6 +145,10 @@ export async function callAgent(options) {
         if (processedTools && processedTools.length > 0) {
             createParams.tools = processedTools;
         }
+        // Add tool_choice if specified
+        if (options.toolChoice) {
+            createParams.tool_choice = options.toolChoice;
+        }
         if (isStreaming) {
             // Handle streaming response
             const { data: stream, response } = await openai.chat.completions
@@ -139,7 +161,7 @@ export async function callAgent(options) {
             response.headers.forEach((value, key) => {
                 responseHeaders[key] = value;
             });
-            return await processStreamingResponse(stream, onContentUpdate, onToolUpdate, onReasoningUpdate, abortSignal, responseHeaders, currentModel);
+            return await processStreamingResponse(stream, onContentUpdate, onToolUpdate, onReasoningUpdate, abortSignal, responseHeaders);
         }
         else {
             // Handle non-streaming response
@@ -162,8 +184,8 @@ export async function callAgent(options) {
                     total_tokens: response.usage.total_tokens,
                 }
                 : undefined;
-            // Extend usage with cache metrics for Claude models
-            if (totalUsage && supportsPromptCaching(currentModel) && response.usage) {
+            // Extend usage with cache metrics (Claude top-level + OpenAI prompt_tokens_details)
+            if (totalUsage && response.usage) {
                 totalUsage = extendUsageWithCacheMetrics(totalUsage, response.usage);
             }
             const result = {};
@@ -288,10 +310,9 @@ export async function callAgent(options) {
  * @param onToolUpdate Callback for tool updates
  * @param abortSignal Optional abort signal
  * @param responseHeaders Response headers from the initial request
- * @param modelName Model name for cache control processing
  * @returns Final result with accumulated content and tool calls
  */
-async function processStreamingResponse(stream, onContentUpdate, onToolUpdate, onReasoningUpdate, abortSignal, responseHeaders, modelName) {
+async function processStreamingResponse(stream, onContentUpdate, onToolUpdate, onReasoningUpdate, abortSignal, responseHeaders) {
     let accumulatedContent = "";
     let accumulatedReasoningContent = "";
     let hasReasoningContent = false;
@@ -312,10 +333,8 @@ async function processStreamingResponse(stream, onContentUpdate, onToolUpdate, o
                     completion_tokens: chunk.usage.completion_tokens,
                     total_tokens: chunk.usage.total_tokens,
                 };
-                // Extend usage with cache metrics for Claude models
-                if (modelName && supportsPromptCaching(modelName)) {
-                    chunkUsage = extendUsageWithCacheMetrics(chunkUsage, chunk.usage);
-                }
+                // Extend usage with cache metrics (Claude top-level + OpenAI prompt_tokens_details)
+                chunkUsage = extendUsageWithCacheMetrics(chunkUsage, chunk.usage);
                 usage = chunkUsage;
             }
             // Check for finish_reason in the choice
@@ -454,6 +473,8 @@ async function processStreamingResponse(stream, onContentUpdate, onToolUpdate, o
 }
 export async function compactMessages(options) {
     const { gatewayConfig, modelConfig, messages, abortSignal } = options;
+    // Validate model config at call time
+    validateModelConfig(modelConfig);
     // Apply global 1 QPS rate limit
     if (process.env.NODE_ENV !== "test" ||
         modelConfig.model === "rate-limit-test") {
@@ -534,6 +555,8 @@ export async function compactMessages(options) {
 }
 export async function processWebContent(options) {
     const { gatewayConfig, modelConfig, content, prompt, abortSignal } = options;
+    // Validate model config at call time
+    validateModelConfig(modelConfig);
     // Apply global 1 QPS rate limit
     if (process.env.NODE_ENV !== "test" ||
         modelConfig.model === "rate-limit-test") {
@@ -601,6 +624,8 @@ export async function processWebContent(options) {
 }
 export async function btw(options) {
     const { gatewayConfig, modelConfig, messages, question, abortSignal } = options;
+    // Validate model config at call time
+    validateModelConfig(modelConfig);
     // Apply global 1 QPS rate limit
     if (process.env.NODE_ENV !== "test" ||
         modelConfig.model === "rate-limit-test") {
@@ -667,3 +692,71 @@ export async function btw(options) {
         throw error;
     }
 }
+export async function evaluateGoal(options) {
+    const { gatewayConfig, modelConfig, model, goalCondition, messages, abortSignal, } = options;
+    // Create OpenAI client with injected configuration (no rate limiter — bypasses 1 QPS)
+    const openai = new OpenAIClient({
+        apiKey: gatewayConfig.apiKey,
+        baseURL: gatewayConfig.baseURL,
+        defaultHeaders: gatewayConfig.defaultHeaders,
+        fetchOptions: gatewayConfig.fetchOptions,
+        fetch: gatewayConfig.fetch,
+    });
+    const { model: _model, fastModel: _fastModel, maxTokens: _maxTokens, permissionMode: _permissionMode, ...extraParams } = modelConfig;
+    void _model;
+    void _fastModel;
+    void _maxTokens;
+    void _permissionMode;
+    const openaiModelConfig = getModelConfig(model, {
+        temperature: 0,
+        max_tokens: 200,
+        ...extraParams,
+    });
+    // Strip images from messages to reduce token usage (same as compact)
+    const cleanedMessages = messages.map((msg) => {
+        if (Array.isArray(msg.content)) {
+            const textParts = msg.content.filter((part) => part.type === "text");
+            const text = textParts.map((p) => p.text).join("\n");
+            return { ...msg, content: text || "(empty message)" };
+        }
+        return msg;
+    });
+    try {
+        const response = await openai.chat.completions.create({
+            ...openaiModelConfig,
+            messages: [
+                {
+                    role: "system",
+                    content: GOAL_EVALUATION_SYSTEM_PROMPT,
+                },
+                ...cleanedMessages,
+                {
+                    role: "user",
+                    content: `Goal condition: ${goalCondition}\n\nHas this goal been achieved based on the conversation above?`,
+                },
+            ],
+        }, {
+            signal: abortSignal,
+        });
+        const result = response.choices[0]?.message?.content?.trim();
+        if (!result) {
+            throw new Error("Goal evaluation returned empty response");
+        }
+        const usage = response.usage
+            ? {
+                prompt_tokens: response.usage.prompt_tokens,
+                completion_tokens: response.usage.completion_tokens,
+                total_tokens: response.usage.total_tokens,
+            }
+            : undefined;
+        return { content: result, usage };
+    }
+    catch (error) {
+        if (error.name === "AbortError") {
+            logger.info("Goal evaluation was aborted");
+            throw new Error("Goal evaluation was aborted");
+        }
+        logger.error("Goal evaluation failed:", error);
+        throw error;
+    }
+}

package/dist/services/configurationService.d.ts

@@ -52,7 +52,7 @@ export declare class ConfigurationService {
      * @param fetchOptions - Fetch options override (optional)
      * @param fetch - Custom fetch implementation override (optional)
      * @returns Resolved gateway configuration
-     * @throws ConfigurationError if required configuration is missing after fallbacks
+     * @returns Resolved model configuration (model/fastModel may be undefined if not yet configured)
      */
     resolveGatewayConfig(apiKey?: string, baseURL?: string, defaultHeaders?: Record<string, string>, fetchOptions?: ClientOptions["fetchOptions"], fetch?: ClientOptions["fetch"]): GatewayConfig;
     /**

package/dist/services/configurationService.d.ts.map

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

package/dist/services/configurationService.js

@@ -11,7 +11,6 @@ import { isValidHookEvent } from "../types/hooks.js";
 import { logger } from "../utils/globalLogger.js";
 import { getAllConfigPaths, getExistingConfigPaths, getUserConfigPaths, getProjectConfigPaths, } from "../utils/configPaths.js";
 import { isValidEnvironmentVars, } from "../types/environment.js";
-import { ConfigurationError, CONFIG_ERRORS, } from "../types/index.js";
 import { DEFAULT_WAVE_MAX_INPUT_TOKENS, DEFAULT_WAVE_MAX_OUTPUT_TOKENS, } from "../utils/constants.js";
 import { parseCustomHeaders } from "../utils/stringUtils.js";
 import { getRemoteSettingsSync, mergeRemoteSettings, } from "./remoteSettingsService.js";
@@ -320,7 +319,7 @@ export class ConfigurationService {
      * @param fetchOptions - Fetch options override (optional)
      * @param fetch - Custom fetch implementation override (optional)
      * @returns Resolved gateway configuration
-     * @throws ConfigurationError if required configuration is missing after fallbacks
+     * @returns Resolved model configuration (model/fastModel may be undefined if not yet configured)
      */
     resolveGatewayConfig(apiKey, baseURL, defaultHeaders, fetchOptions, fetch) {
         // Check for SSO token first - if present and server URL is available, use SSO mode
@@ -411,19 +410,6 @@ export class ConfigurationService {
             process.env.WAVE_MODEL;
         // Resolve fast model: override > options > process.env (includes settings.json env)
         const resolvedFastModel = fastModel || this.options.fastModel || process.env.WAVE_FAST_MODEL;
-        // Validate required fields
-        if (!resolvedAgentModel) {
-            throw new ConfigurationError(CONFIG_ERRORS.MISSING_MODEL, "model", {
-                constructor: model,
-                environment: process.env.WAVE_MODEL,
-            });
-        }
-        if (!resolvedFastModel) {
-            throw new ConfigurationError(CONFIG_ERRORS.MISSING_FAST_MODEL, "fastModel", {
-                constructor: fastModel,
-                environment: process.env.WAVE_FAST_MODEL,
-            });
-        }
         // Resolve max output tokens
         const resolvedMaxTokens = this.resolveMaxOutputTokens(maxTokens);
         const baseConfig = {
@@ -433,7 +419,8 @@ export class ConfigurationService {
             permissionMode: permissionMode ?? this.options.permissionMode,
         };
         // Merge model-specific settings from configuration
-        const modelSpecificConfig = this.currentConfiguration?.models?.[resolvedAgentModel];
+        const modelSpecificConfig = resolvedAgentModel &&
+            this.currentConfiguration?.models?.[resolvedAgentModel];
         if (modelSpecificConfig) {
             return {
                 ...baseConfig,

package/dist/services/hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/services/hook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EAElC,MAAM,mBAAmB,CAAC;AA2F3B;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,GAAG,4BAA4B,EAC5D,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA6I9B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,oBAAoB,GAAG,4BAA4B,EAC5D,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAchC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAMhC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAsBtD"}
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/services/hook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EAElC,MAAM,mBAAmB,CAAC;AAgG3B;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,GAAG,4BAA4B,EAC5D,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA6I9B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,oBAAoB,GAAG,4BAA4B,EAC5D,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAchC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAMhC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAsBtD"}

package/dist/services/hook.js

@@ -48,6 +48,10 @@ async function buildHookJsonInput(context) {
         context.userPrompt !== undefined) {
         jsonInput.user_prompt = context.userPrompt;
     }
+    // Add plan_file_path if present
+    if (context.planFilePath !== undefined) {
+        jsonInput.plan_file_path = context.planFilePath;
+    }
     // Add subagent_type if present
     if (context.subagentType !== undefined) {
         jsonInput.subagent_type = context.subagentType;

package/dist/services/session.d.ts

@@ -33,13 +33,15 @@ export interface SessionMetadata {
     sessionType: "main" | "subagent";
     subagentType?: string;
     workdir: string;
+    createdAt: Date;
     lastActiveAt: Date;
     latestTotalTokens: number;
     firstMessage?: string;
 }
 export interface SessionIndex {
-    sessions: Record<string, Omit<SessionMetadata, "id" | "lastActiveAt"> & {
+    sessions: Record<string, Omit<SessionMetadata, "id" | "lastActiveAt" | "createdAt"> & {
         lastActiveAt: string;
+        createdAt: string;
     }>;
     lastUpdated: string;
 }
@@ -49,6 +51,12 @@ export interface SessionIndex {
  * @returns Timestamp-prefixed session ID string
  */
 export declare function generateSessionId(): string;
+/**
+ * Parse the timestamp prefix from a session ID back into a Date
+ * Format: {YYYYMMDDHHmmss}-{8hex} (e.g. 20260527143025-a1b2c3d4)
+ * @returns Date from the session ID timestamp prefix
+ */
+export declare function parseSessionIdTimestamp(sessionId: string): Date;
 /**
  * Generate filename for subagent sessions
  * @param sessionId - UUID session identifier

package/dist/services/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAOjD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CACd,MAAM,EACN,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,cAAc,GAAG,WAAW,CAAC,GAAG;QAC3D,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CACF,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAY1C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAc/D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE;AAGD,eAAO,MAAM,WAAW,QAAuC,CAAC;AAqChE;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,GAAG,UAAmB,GACxC,OAAO,CAAC,MAAM,CAAC,CASjB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,GAAG,UAAmB,GACxC,OAAO,CAAC,MAAM,CAAC,CASjB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,GAAG,UAAmB,GACxC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EAAE,EACtB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,GAAG,UAAmB,EACzC,aAAa,CAAC,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CA4Ef;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,GAAG,UAAmB,GACxC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAmF7B;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAU7B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CAqJ5B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAwDlE;AAED;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA0FjB;AAED;;GAEG;AACH,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,IAAI,CAAC,CA+BpE;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAChC,OAAO,CAAC,OAAO,CAAC,CAsClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsCxB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,GAAG,UAAmB,GACxC,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAY,GACtB,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,CAAC,EAAE,MAAM,EACzB,mBAAmB,CAAC,EAAE,OAAO,EAC7B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA+ClC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiCxD"}

package/dist/services/session.js

@@ -41,6 +41,19 @@ export function generateSessionId() {
     const shortId = randomUUID().slice(0, 8);
     return `${ts}-${shortId}`;
 }
+/**
+ * Parse the timestamp prefix from a session ID back into a Date
+ * Format: {YYYYMMDDHHmmss}-{8hex} (e.g. 20260527143025-a1b2c3d4)
+ * @returns Date from the session ID timestamp prefix
+ */
+export function parseSessionIdTimestamp(sessionId) {
+    const match = sessionId.match(/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/);
+    if (!match) {
+        return new Date(); // Fallback to now for legacy UUID-format session IDs
+    }
+    const [, year, month, day, hour, minute, second] = match;
+    return new Date(Number(year), Number(month) - 1, Number(day), Number(hour), Number(minute), Number(second));
+}
 /**
  * Generate filename for subagent sessions
  * @param sessionId - UUID session identifier
@@ -72,6 +85,7 @@ async function updateSessionIndex(projectDirPath, metadata) {
     const { id, ...rest } = metadata;
     index.sessions[id] = {
         ...rest,
+        createdAt: metadata.createdAt.toISOString(),
         lastActiveAt: metadata.lastActiveAt.toISOString(),
         firstMessage: metadata.firstMessage || index.sessions[id]?.firstMessage,
         parentSessionId: metadata.parentSessionId,
@@ -165,8 +179,9 @@ export async function appendMessages(sessionId, newMessages, workdir, sessionTyp
     const encoder = new PathEncoder();
     const projectDir = await encoder.getProjectDirectory(workdir, SESSION_DIR);
     const lastMessage = newMessages[newMessages.length - 1];
-    // Get first message content if it's a new session or we don't have it
+    // Get first message content and createdAt from existing index
     let firstMessage;
+    let createdAt;
     try {
         const indexPath = join(projectDir.encodedPath, SESSION_INDEX_FILENAME);
         const content = await fs.readFile(indexPath, "utf8");
@@ -175,18 +190,26 @@ export async function appendMessages(sessionId, newMessages, workdir, sessionTyp
             firstMessage =
                 (await getFirstMessageContent(sessionId, workdir)) || undefined;
         }
+        if (index.sessions[sessionId]?.createdAt) {
+            createdAt = new Date(index.sessions[sessionId].createdAt);
+        }
     }
     catch {
         // If index doesn't exist, this might be the first message
         firstMessage =
             (await getFirstMessageContent(sessionId, workdir)) || undefined;
     }
+    // Derive createdAt from session ID timestamp if not in index
+    if (!createdAt) {
+        createdAt = new Date(parseSessionIdTimestamp(sessionId));
+    }
     await updateSessionIndex(projectDir.encodedPath, {
         id: sessionId,
         rootSessionId,
         parentSessionId,
         sessionType,
         workdir,
+        createdAt,
         lastActiveAt: new Date(lastMessage.timestamp),
         latestTotalTokens: lastMessage.usage
             ? extractLatestTotalTokens([lastMessage])
@@ -327,6 +350,7 @@ export async function listSessionsFromJsonl(workdir) {
                 .map(([id, meta]) => ({
                 id,
                 ...meta,
+                createdAt: new Date(meta.createdAt),
                 lastActiveAt: new Date(meta.lastActiveAt),
             }));
             return sessions.sort((a, b) => b.lastActiveAt.getTime() - a.lastActiveAt.getTime());
@@ -386,6 +410,7 @@ export async function listSessionsFromJsonl(workdir) {
                     sessionType: "main",
                     subagentType: undefined, // No longer stored in metadata
                     workdir: projectDir.originalPath,
+                    createdAt: new Date(parseSessionIdTimestamp(sessionId)),
                     lastActiveAt,
                     latestTotalTokens: lastMessage?.usage
                         ? extractLatestTotalTokens([lastMessage])
@@ -420,6 +445,7 @@ export async function listSessionsFromJsonl(workdir) {
                 const { id, ...rest } = session;
                 index.sessions[id] = {
                     ...rest,
+                    createdAt: session.createdAt.toISOString(),
                     lastActiveAt: session.lastActiveAt.toISOString(),
                 };
             }
@@ -473,6 +499,7 @@ export async function listAllSessions() {
                             allSessions.push({
                                 id,
                                 ...meta,
+                                createdAt: new Date(meta.createdAt),
                                 lastActiveAt,
                             });
                         }

package/dist/tools/bashTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bashTool.d.ts","sourceRoot":"","sources":["../../src/tools/bashTool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAYtE;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,UAyetB,CAAC"}
+{"version":3,"file":"bashTool.d.ts","sourceRoot":"","sources":["../../src/tools/bashTool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAuBtE;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,UAqhBtB,CAAC"}

package/dist/tools/bashTool.js

@@ -8,6 +8,16 @@ import { processToolResult } from "../utils/toolResultStorage.js";
 import { BASH_MAX_OUTPUT_CHARS } from "../constants/toolLimits.js";
 import { BASH_TOOL_NAME, GLOB_TOOL_NAME, GREP_TOOL_NAME, READ_TOOL_NAME, EDIT_TOOL_NAME, WRITE_TOOL_NAME, } from "../constants/tools.js";
 const BASH_DEFAULT_TIMEOUT_MS = 120000;
+// Commands that should not be auto-backgrounded on timeout (e.g. sleep should just be killed)
+const DISALLOWED_AUTO_BACKGROUND_COMMANDS = ["sleep"];
+function isAutobackgroundingAllowed(command) {
+    const trimmed = command.trim();
+    // Get the first word of the command
+    const baseCommand = trimmed.split(/\s+/)[0];
+    if (!baseCommand)
+        return true;
+    return !DISALLOWED_AUTO_BACKGROUND_COMMANDS.includes(baseCommand);
+}
 /**
  * Bash command execution tool - supports both foreground and background execution
  */
@@ -111,8 +121,12 @@ The working directory persists between commands. Try to maintain your current wo
         const runInBackground = args.run_in_background;
         const description = args.description;
         // Set default timeout: BASH_DEFAULT_TIMEOUT_MS for foreground, no timeout for background
-        const timeout = args.timeout ??
-            (runInBackground ? undefined : BASH_DEFAULT_TIMEOUT_MS);
+        // When run_in_background is explicitly set, cancel any timeout — the intent is to
+        // let the process run to completion (matching Claude Code behavior where background()
+        // clears the timeout via cleanupListeners).
+        const timeout = runInBackground
+            ? undefined
+            : (args.timeout ?? BASH_DEFAULT_TIMEOUT_MS);
         if (!command || typeof command !== "string") {
             return {
                 success: false,
@@ -166,7 +180,7 @@ The working directory persists between commands. Try to maintain your current wo
                     error: "Background task manager not available",
                 };
             }
-            const { id: taskId } = backgroundTaskManager.startShell(command, timeout);
+            const { id: taskId } = backgroundTaskManager.startShell(command);
             const task = backgroundTaskManager.getTask(taskId);
             const outputPath = task?.outputPath;
             const backgroundMsg = [
@@ -249,12 +263,36 @@ The working directory persists between commands. Try to maintain your current wo
                     },
                 });
             }
-            // Set up timeout
+            // Set up timeout — auto-background if allowed, otherwise kill
             let timeoutHandle;
+            const shouldAutoBackground = !!context.backgroundTaskManager && isAutobackgroundingAllowed(command);
             if (timeout && timeout > 0) {
                 timeoutHandle = setTimeout(() => {
-                    if (!isAborted) {
-                        handleAbort("Command timed out");
+                    if (!isAborted && !isBackgrounded) {
+                        if (shouldAutoBackground) {
+                            // Auto-background: move the process to background task manager instead of killing it
+                            isBackgrounded = true;
+                            if (timeoutHandle) {
+                                clearTimeout(timeoutHandle);
+                            }
+                            // Unregister foreground task since it's now backgrounded
+                            if (context.foregroundTaskManager) {
+                                context.foregroundTaskManager.unregisterForegroundTask(foregroundTaskId);
+                            }
+                            const backgroundTaskManager = context.backgroundTaskManager;
+                            const taskId = backgroundTaskManager.adoptProcess(child, command, outputBuffer, errorBuffer);
+                            const task = backgroundTaskManager.getTask(taskId);
+                            const outputPath = task?.outputPath;
+                            logger.info(`[Bash] Command timed out after ${timeout}ms, auto-backgrounded as ${taskId}`);
+                            resolve({
+                                success: true,
+                                content: `Command timed out after ${timeout / 1000} seconds and was moved to background with ID: ${taskId}.${outputPath ? ` Real-time output: ${outputPath}` : ""}`,
+                                shortResult: `Process ${taskId} auto-backgrounded (timeout)`,
+                            });
+                        }
+                        else {
+                            handleAbort("Command timed out");
+                        }
                     }
                 }, timeout);
             }
@@ -277,7 +315,11 @@ The working directory persists between commands. Try to maintain your current wo
                                         process.kill(-child.pid, "SIGKILL");
                                     }
                                     catch (killError) {
-                                        logger.error("Failed to force kill process:", killError);
+                                        // ESRCH means the process already exited — not an error
+                                        if (!(killError instanceof Error) ||
+                                            killError.code !== "ESRCH") {
+                                            logger.error("Failed to force kill process:", killError);
+                                        }
                                     }
                                 }
                             }, 1000);

package/dist/tools/readTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readTool.d.ts","sourceRoot":"","sources":["../../src/tools/readTool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAkItE;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,UA6RtB,CAAC"}
+{"version":3,"file":"readTool.d.ts","sourceRoot":"","sources":["../../src/tools/readTool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAkItE;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,UA4RtB,CAAC"}

package/dist/tools/readTool.js

@@ -250,7 +250,7 @@ Usage:
                 logger.warn(`File ${filePath} exists but has empty contents`);
                 return {
                     success: true,
-                    content: "⚠️ System reminder: This file exists but has empty contents.",
+                    content: "System reminder: This file exists but has empty contents.",
                     shortResult: "Empty file",
                     metadata: {
                         type: "text",

package/dist/tools/taskManagementTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"taskManagementTools.d.ts","sourceRoot":"","sources":["../../src/tools/taskManagementTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AASjE,eAAO,MAAM,cAAc,EAAE,UAoI5B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAyDzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,UAgW5B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,UAkE1B,CAAC"}
+{"version":3,"file":"taskManagementTools.d.ts","sourceRoot":"","sources":["../../src/tools/taskManagementTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AA6CjE,eAAO,MAAM,cAAc,EAAE,UAgG5B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAwEzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,UAyR5B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,UAyE1B,CAAC"}