@livx.cc/agentx 0.99.48 → 0.99.49

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-import { a as AgentOptions, H as Hooks, i as RunResult, A as Agent } from './Agent-BeoEFl2T.js';
-export { C as ChatFragment, b as CompactResult, D as DEFAULT_MUTATING, c as Decision, P as PermissionOptions, d as PermissionPolicy, e as PermissionRule, f as PreToolUseDecision, R as ReasoningEffort, g as RecordingHooks, h as RecordingLifecycle, T as ToolUse, j as ToolUseMeta, k as composeHooks, l as estimateTokens, p as planMode, r as reasoningToChatFragment } from './Agent-BeoEFl2T.js';
+import { a as AgentOptions, H as Hooks, i as RunResult, A as Agent } from './Agent-CXkPfYX2.js';
+export { C as ChatFragment, b as CompactResult, D as DEFAULT_MUTATING, c as Decision, P as PermissionOptions, d as PermissionPolicy, e as PermissionRule, f as PreToolUseDecision, R as ReasoningEffort, g as RecordingHooks, h as RecordingLifecycle, T as ToolUse, j as ToolUseMeta, k as composeHooks, l as estimateTokens, p as planMode, r as reasoningToChatFragment } from './Agent-CXkPfYX2.js';
 export { MODEL_ALIASES, ModelSwitch, ResolveModelSwitchOpts, modelShortLabel, resolveModelAlias, resolveModelSwitch } from './models.js';
 import { IFilesystem, FileMetadata } from '@livx.cc/wcli/core';
 export { CommandExecutor, FileMetadata, IFilesystem, IndexedDbFilesystem, MemFilesystem, registerHeadlessCommands } from '@livx.cc/wcli/core';
 import { BodDB } from '@bod.ee/db';
-import { A as AgentTool, C as ChatLike, a as ChatOptions, b as ChatResponse, r as ToolCall, H as HostBridge, U as UserQuestion, o as MessageContent } from './tools-MNdqlJIa.js';
-export { c as ContentPart, d as HostEvent, I as IMAGE_ELIDE_STUB, e as IMAGE_REF_SCHEME, f as ImageRef, J as JobCtx, g as JobHandle, h as JobInfo, i as JobKind, j as JobNotice, k as JobRegistry, l as JobRegistryOptions, n as JobTrackOptions, M as Message, m as RegistryJobStatus, R as Role, S as SandboxJobRegistry, p as StreamChunk, T as TodoItem, q as Tool, s as ToolContext, t as bashTool, u as clearImageRefs, v as contentBytes, w as contentText, x as defaultTools, y as editTool, z as elideImages, B as elideInlineImages, D as elideStaleImages, E as exitSessionTool, F as expandImagesForSend, G as formatJobNotice, K as imagePart, L as imageRefPart, N as imageRefResult, O as makeContext, P as makeJobTools, Q as messageHasImage, V as messageHasImageRef, W as messageHasInlineImage, X as mintImageRef, Y as parseImageRef, Z as readTool, _ as remintImageRefs, $ as sendBytes, a0 as sendBytesPer, a1 as toWireTools, a2 as todoWriteTool, a3 as toolImageRef, a4 as toolRegistry, a5 as toolsByName } from './tools-MNdqlJIa.js';
+import { A as AgentTool, C as ChatLike, a as ChatOptions, b as ChatResponse, r as ToolCall, H as HostBridge, U as UserQuestion, o as MessageContent } from './tools-HsbxgqjF.js';
+export { c as ContentPart, d as HostEvent, I as IMAGE_ELIDE_STUB, e as IMAGE_REF_SCHEME, f as ImageRef, J as JobCtx, g as JobHandle, h as JobInfo, i as JobKind, j as JobNotice, k as JobRegistry, l as JobRegistryOptions, n as JobTrackOptions, M as Message, m as RegistryJobStatus, R as Role, S as SandboxJobRegistry, p as StreamChunk, T as TodoItem, q as Tool, s as ToolContext, t as bashTool, u as clearImageRefs, v as contentBytes, w as contentText, x as defaultTools, y as editTool, z as elideImages, B as elideInlineImages, D as elideStaleImages, E as exitSessionTool, F as expandImagesForSend, G as formatJobNotice, K as imagePart, L as imageRefPart, N as imageRefResult, O as makeContext, P as makeJobTools, Q as messageHasImage, V as messageHasImageRef, W as messageHasInlineImage, X as mintImageRef, Y as parseImageRef, Z as readTool, _ as remintImageRefs, $ as sendBytes, a0 as sendBytesPer, a1 as toWireTools, a2 as todoWriteTool, a3 as toolImageRef, a4 as toolRegistry, a5 as toolsByName } from './tools-HsbxgqjF.js';
 import { ShellJobRegistry } from './tools.shell.js';
 import { SpokenSplitter } from '@bod.ee/voice';
 export { AudioSink, AudioSource, AuthProvider, CartesiaTTS, CartesiaTTSOptions, STT_SAMPLE_RATE, SonioxSTT, SonioxSTTOptions, SttLike, TTS_SAMPLE_RATE, TtsLike, VoiceEngine, VoiceEngineOptions, VoiceState, resolveAuth } from '@bod.ee/voice';
-export { M as McpCall, a as McpImage, b as McpRoute, c as McpRouteResolver, d as McpToolResult, e as McpToolSearchOptions, f as McpToolSpec, g as MountedMcpLike, h as buildMcpCatalog, m as makeLazyMcpToolSearch, i as makeMcpToolSearch, j as makeMcpToolSearchFromMounted, k as mcpToolToAgentTool, l as mcpToolsToAgentTools } from './mcp-DjYZzGGW.js';
+export { M as McpCall, a as McpImage, b as McpRoute, c as McpRouteResolver, d as McpToolResult, e as McpToolSearchOptions, f as McpToolSpec, g as MountedMcpLike, h as buildMcpCatalog, m as makeLazyMcpToolSearch, i as makeMcpToolSearch, j as makeMcpToolSearchFromMounted, k as mcpToolToAgentTool, l as mcpToolsToAgentTools } from './mcp-CSLRyvEp.js';
 import * as libx_js_src_modules_log from 'libx.js/src/modules/log';
 export { log } from 'libx.js/src/modules/log';
 

package/dist/index.js

@@ -1579,7 +1579,12 @@ var init_tools_jobs = __esm({
       maxBuffer = 256 * 1024;
       /** Idle window per kind: no output/progress/CPU for this long ⇒ stuck. Kinds without an activity channel
        *  (host, native) are absent on purpose — silence is all they can ever show, so it proves nothing; their
-       *  bound is the hard cap. Explicit `background:true` shell jobs opt out per job (a quiet server is healthy). */
+       *  bound is the hard cap. Explicit `background:true` shell jobs opt out per job (a quiet server is healthy).
+       *  NOTE the asymmetry that default hides: for a HOST job silence really is uninformative (the caller holds
+       *  the pending dispatch promise — independent proof it is alive), but a NATIVE job has no such proof AND it
+       *  suppresses the stall watchdog, i.e. it turns the provider's own silence into permission to keep ignoring
+       *  that provider's silence. So Agent passes an explicit per-job `idleMs` (nativeHoldMs) for `native`: the
+       *  provider must keep re-proving liveness with `running` events or forfeit the hold. See Agent.nativeHoldMs. */
       idleMs = { shell: 10 * 6e4, mcp: 10 * 6e4 };
       /** Absolute ceiling per kind (0/absent = none). */
       hardCapMs = { mcp: 30 * 6e4 };
@@ -4171,6 +4176,15 @@ var AgentOptions = class {
    *  arrives for this long. The between-steps `timeoutMs` can't preempt an in-flight `chat()`, so a
    *  provider that goes silent mid-stream would otherwise park the loop forever. 0 = off. */
   stallMs = 6e4;
+  /** IDLE bound on a NATIVE delegated tool's hold over the stall watchdog (cursor's own shell/mcp/task:
+   *  `running` → silence → `completed`). Such a hold is the provider's own unverified CLAIM that it is
+   *  busy, and it SUSPENDS the very stall detection that would catch that provider going silent — so its
+   *  only backstop was `hardCapMs = toolHoldMs`, the TRANSPORT deadline (≥30m, sized for host-tool
+   *  round-trips a native call never makes). A wedged native call therefore bought 30m of total silence,
+   *  ×2 attempts = the 61-minute zero-output run (blank 2026-09-18). Idle, not absolute: every further
+   *  `running` event `touch()`es the job, so a native tool that keeps reporting progress holds
+   *  indefinitely — what expires is silence, not work. 0 = off (hard cap only). */
+  nativeHoldMs = 3e5;
   /** Stop if the identical tool-call batch (name+args) repeats this many times in a row. 0 = off. */
   maxRepeats = 3;
   /** Cumulative cap on tool calls dispatched across the run. 0 = unbounded. */
@@ -4362,11 +4376,14 @@ var Agent = class _Agent {
    *  toolExecutor) and NATIVE tools (cursor's own shell/mcp/task, `running` → `completed`) are tracked as
    *  `holds` jobs: while one runs the provider is not silent — it is waiting on a tool — so the idle-stall
    *  watchdog must not fire. Each is bounded by the transport tool deadline (`hardCapMs = toolHoldMs`), so a
-   *  tool that never settles (or a lost `completed` event) is reaped and cannot disable stall protection. */
+   *  tool that never settles (or a lost `completed` event) is reaped and cannot disable stall protection.
+   *  A NATIVE job carries a second, much tighter bound (`idleMs = nativeHoldMs`): the transport deadline is
+   *  sized for a host-tool round-trip it never makes, and silence is the only thing it can actually prove. */
   jobs;
   /** Native delegated tool activity id → its job (per step attempt). */
   nativeJobs = /* @__PURE__ */ new Map();
   toolHoldMs = 0;
+  nativeHoldMs = 0;
   /** A tool (host or native) already executed in the current step attempt: a stall retry replays the step
    *  from the pre-step transcript, which would re-run it — so such a stall is not retried. */
   toolRanThisAttempt = false;
@@ -4708,6 +4725,7 @@ var Agent = class _Agent {
       const derivedToolTimeoutMs = Math.max(TRANSPORT_TOOL_TIMEOUT_FLOOR_MS, ...this.activeTools.map(transportHeadroomMs));
       const effectiveToolTimeoutMs = typeof hostToolTimeoutMs === "number" ? Math.max(hostToolTimeoutMs, derivedToolTimeoutMs) : derivedToolTimeoutMs;
       this.toolHoldMs = effectiveToolTimeoutMs;
+      this.nativeHoldMs = o.nativeHoldMs;
       if (isCursorWithTools) {
         if (typeof hostToolTimeoutMs === "number" && effectiveToolTimeoutMs !== hostToolTimeoutMs) {
           log7.warn(`providerOptions.toolTimeoutMs=${hostToolTimeoutMs}ms is below what the registered tools need \u2014 RAISED to ${effectiveToolTimeoutMs}ms. ${toolTimeoutViolations(this.activeTools, hostToolTimeoutMs).length} tool(s) could outlive it, and the transport would have destroyed their results. To lower it, lower the tools' own maxDurationMs (e.g. the Shell tool's maxTimeoutMs) instead.`);
@@ -4961,7 +4979,13 @@ var Agent = class _Agent {
       if (!stallMs) return;
       if (timer) clearTimeout(timer);
       timer = setTimeout(() => {
-        if (this.toolHoldActive()) return poke();
+        if (this.toolHoldActive()) {
+          const now3 = Date.now();
+          const who = this.jobs.holding().map((j) => `${j.kind} "${j.label}" (${Math.round((now3 - j.startedAt) / 1e3)}s, quiet ${Math.round((now3 - j.lastActivityAt) / 1e3)}s)`).join(", ");
+          log7.warn(`stall watchdog: no stream output for ${stallMs}ms \u2014 held by ${who}`);
+          this.options.host?.notify?.({ kind: "tool_hold", message: `waiting on ${who}` });
+          return poke();
+        }
         const inFlight = this.jobs.list().filter((j) => j.status === "running");
         log7.warn(`stall watchdog: no stream output for ${stallMs}ms and no tool holding the stream \u2014 aborting the request` + (inFlight.length ? ` (${inFlight.length} detached job(s) running, not awaited by the stream: ${inFlight.map((j) => `${j.id}/${j.kind}`).join(", ")})` : ""));
         fired = true;
@@ -5030,7 +5054,7 @@ var Agent = class _Agent {
         const nj = a.id ? this.nativeJobs.get(a.id) : void 0;
         if (a.status === "running") {
           if (nj) nj.touch();
-          else if (a.id) this.nativeJobs.set(a.id, this.jobs.track({ kind: "native", label: a.name, holds: true, hardCapMs: this.toolHoldMs }));
+          else if (a.id) this.nativeJobs.set(a.id, this.jobs.track({ kind: "native", label: a.name, holds: true, idleMs: this.nativeHoldMs, hardCapMs: this.toolHoldMs }));
         } else {
           if (nj) {
             if (typeof a.output === "string") nj.chunk(a.output.slice(-4e3));