@aragon-agent/core 0.2.27 → 0.2.29

package/dist/llm/context-window.d.ts

@@ -1,6 +1,12 @@
 import type { ModelInfo } from './types.js';
 export type ContextWindowInfo = Pick<ModelInfo, 'contextWindow'> & {
-    contextWindowSource: 'api' | 'catalog' | 'fallback';
+    /**
+     * `user` is produced ONLY by a host layer (the CLI's model-windows.json); no
+     * Core code path ever returns it. It is in the union because `ModelInfo`
+     * carries whatever the host resolved, and a source Core cannot even name is
+     * a host value silently laundered into `catalog`.
+     */
+    contextWindowSource: 'api' | 'catalog' | 'fallback' | 'user';
 };
 /** Never interpret output-token limits as an input/context limit. */
 export declare function reportedContextWindow(model: Record<string, unknown>): ContextWindowInfo;

package/dist/llm/types.d.ts

@@ -160,8 +160,12 @@ export interface ModelInfo {
     name: string;
     provider: string;
     contextWindow: number;
-    /** Provenance of the context limit; omitted by legacy/custom providers. */
-    contextWindowSource?: 'api' | 'catalog' | 'fallback';
+    /**
+     * Provenance of the context limit; omitted by legacy/custom providers.
+     * `user` is set only by a host layer from user configuration (the CLI's
+     * model-windows.json); Core itself never produces it.
+     */
+    contextWindowSource?: 'api' | 'catalog' | 'fallback' | 'user';
     maxOutputTokens: number;
     supportsThinking: boolean;
     supportsTools: boolean;

package/dist/tools/executor.d.ts

@@ -15,7 +15,13 @@ import type { ToolExecutionResult, ToolProgressUpdate } from './types.js';
 export interface ToolExecutorOptions {
     /** Default per-tool execution timeout in milliseconds. Defaults to 120_000 (2 minutes). */
     defaultTimeout?: number;
-    /** Per-tool timeout overrides, keyed by tool name. */
+    /**
+     * Per-tool timeout overrides, keyed by tool name. An override of `0` means
+     * NO ceiling for that tool: no timer is armed, and only an external abort
+     * can end it. (`setTimeout(fn, 0)` fires immediately, so before this
+     * semantics existed a `0` override aborted the tool at once - a value no
+     * working caller could ever have wanted.)
+     */
     timeoutOverrides?: Record<string, number>;
     /** Maximum size (in bytes) of combined text output before truncation. Defaults to 100_000 (100 KB). */
     maxOutputSize?: number;

package/dist/tools/executor.js

@@ -83,16 +83,23 @@ export class ToolExecutor {
             return this.buildResult(toolCallId, toolName, errorResult(`Parameter validation error: ${err instanceof Error ? err.message : String(err)}`), startTime);
         }
         // 4. Set up timeout and merged abort signal.
+        //
+        // AN OVERRIDE OF `0` ARMS NO TIMER: the tool runs until it settles or an
+        // external abort arrives. The CLI's `task` fan-out is the caller this
+        // exists for - a dispatch must be able to outlast every generic
+        // `defaultTimeout` a session may carry, and a huge sentinel number would
+        // merely move the cliff.
         const timeoutMs = this.timeoutOverrides[toolName] ?? this.defaultTimeout;
         const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(TIMEOUT_REASON), timeoutMs);
+        const timeoutId = timeoutMs > 0 ? setTimeout(() => controller.abort(TIMEOUT_REASON), timeoutMs) : null;
         // Propagate external signal to our controller.
         const externalAbortHandler = () => {
             controller.abort(signal?.reason ?? new Error('aborted'));
         };
         if (signal) {
             if (signal.aborted) {
-                clearTimeout(timeoutId);
+                if (timeoutId)
+                    clearTimeout(timeoutId);
                 return this.buildResult(toolCallId, toolName, errorResult('Execution aborted before start'), startTime);
             }
             signal.addEventListener('abort', externalAbortHandler, { once: true });
@@ -172,7 +179,8 @@ export class ToolExecutor {
             }
         }
         finally {
-            clearTimeout(timeoutId);
+            if (timeoutId)
+                clearTimeout(timeoutId);
             if (graceTimer)
                 clearTimeout(graceTimer);
             if (onAbandonAbort) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aragon-agent/core",
-  "version": "0.2.27",
+  "version": "0.2.29",
   "description": "AragonAgent core engine — LLM provider adapters, streaming, tool registry/execution, steering, idle watchdog, and an optional isolated-vm sandbox.",
   "license": "MIT",
   "author": "AragonAgent contributors",