@livx.cc/agentx 0.99.39 → 0.99.41

package/dist/index.d.ts

@@ -1,14 +1,15 @@
-import { a as AgentOptions, H as Hooks, i as RunResult, A as Agent } from './Agent-DJwg1g8V.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-DJwg1g8V.js';
+import { a as AgentOptions, H as Hooks, i as RunResult, A as Agent } from './Agent-DydgLoT-.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-DydgLoT-.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, j as ToolCall, H as HostBridge, U as UserQuestion, g as MessageContent } from './tools-Byyh_bae.js';
-export { c as ContentPart, d as HostEvent, I as IMAGE_ELIDE_STUB, e as IMAGE_REF_SCHEME, f as ImageRef, M as Message, R as Role, S as SandboxJobRegistry, h as StreamChunk, T as TodoItem, i as Tool, k as ToolContext, l as bashTool, m as clearImageRefs, n as contentBytes, o as contentText, p as defaultTools, q as editTool, r as elideImages, s as elideInlineImages, t as elideStaleImages, u as exitSessionTool, v as expandImagesForSend, w as imagePart, x as imageRefPart, y as imageRefResult, z as makeContext, B as makeJobTools, D as messageHasImage, E as messageHasImageRef, F as messageHasInlineImage, G as mintImageRef, J as parseImageRef, K as readTool, L as remintImageRefs, N as sendBytes, O as sendBytesPer, P as toWireTools, Q as todoWriteTool, V as toolImageRef, W as toolRegistry, X as toolsByName } from './tools-Byyh_bae.js';
+import { A as AgentTool, C as ChatLike, a as ChatOptions, b as ChatResponse, j as ToolCall, H as HostBridge, U as UserQuestion, g as MessageContent } from './tools-S-ArIR3o.js';
+export { c as ContentPart, d as HostEvent, I as IMAGE_ELIDE_STUB, e as IMAGE_REF_SCHEME, f as ImageRef, M as Message, R as Role, S as SandboxJobRegistry, h as StreamChunk, T as TodoItem, i as Tool, k as ToolContext, l as bashTool, m as clearImageRefs, n as contentBytes, o as contentText, p as defaultTools, q as editTool, r as elideImages, s as elideInlineImages, t as elideStaleImages, u as exitSessionTool, v as expandImagesForSend, w as imagePart, x as imageRefPart, y as imageRefResult, z as makeContext, B as makeJobTools, D as messageHasImage, E as messageHasImageRef, F as messageHasInlineImage, G as mintImageRef, J as parseImageRef, K as readTool, L as remintImageRefs, N as sendBytes, O as sendBytesPer, P as toWireTools, Q as todoWriteTool, V as toolImageRef, W as toolRegistry, X as toolsByName } from './tools-S-ArIR3o.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-Bd19NiCL.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-D5eN0JyQ.js';
 import * as libx_js_src_modules_log from 'libx.js/src/modules/log';
 export { log } from 'libx.js/src/modules/log';
 
@@ -438,6 +439,26 @@ declare function diskAgentOptions(opts?: Partial<AgentOptions>): Partial<AgentOp
  *  edge-safe to import. `cwd` defaults to `process.cwd()`; secret env is scrubbed from spawned children. */
 declare function fullAgentOptions(opts?: Partial<AgentOptions> & {
     cwd?: string;
+    /**
+     * Push a finished background job back to the MODEL (Claude-Code parity). Without it `background:true`
+     * is write-only: the job finishes and nothing ever tells the model — so the Shell tool's description
+     * drops its cross-turn promise too, rather than lying to the model about this host.
+     *
+     * Wire it to the agent you are about to build — the closure runs long after construction:
+     *   const agent = new Agent(await fullAgentOptions({ ai, onJobExit: (n) => agent.inject(n) }));
+     */
+    onJobExit?: (notice: string) => void;
+    /**
+     * Bring your OWN registry instead of letting the preset build one. This is the handle a preset host
+     * otherwise never gets (the preset returns `AgentOptions`, not the registry), which is what left
+     * `ShellJobRegistry.setOnExit()` unreachable from this path — a host can now wire (or rewire) the
+     * completion callback after the Agent exists:
+     *   const jobs = new ShellJobRegistry({ cwd, killOnExit: true });
+     *   const agent = new Agent(await fullAgentOptions({ ai, jobs }));
+     *   jobs.setOnExit((n) => agent.inject(formatJobExit(n)));
+     * `onJobExit` still works and, when both are given, is applied to the registry you passed.
+     */
+    jobs?: ShellJobRegistry;
 }): Promise<Partial<AgentOptions>>;
 
 /**
@@ -1258,6 +1279,25 @@ interface TaskToolOptions {
     maxParallel?: number;
     /** Parent hooks — `onSubagentStop` fires with each child's summary when it finishes. */
     hooks?: Hooks;
+    /**
+     * Wall-clock ceiling for ONE child run, in ms (default `SUBAGENT_MAX_DURATION_MS`). `maxSteps` alone is
+     * not a bound: 25 steps x a 600s Shell is ~250 minutes, far past any transport deadline wrapping the
+     * parent — and an undeclared tool cannot be named by `toolTimeoutViolations`. This deadline is ENFORCED
+     * (the child's signal is aborted) and therefore honestly declarable as the tool's `maxDurationMs`.
+     */
+    maxDurationMs?: number;
+    /** The parent's toolbelt — the child INHERITS it by default (otherwise it falls back to the jailed
+     *  `defaultTools()` and loses everything the host injected: a real shell, Write/Grep, MCP tools).
+     *  An agentType def's `tools` allowlist still narrows it (and can name one of these by name). */
+    tools?: AgentTool[];
+    /** The parent's system prompt — inherited by a plain (untyped) child so it keeps the host's persona
+     *  instead of reverting to agentx's generic built-in one. An agentType def's body overrides it. */
+    systemPrompt?: string;
+    /** Provider-specific options for the CHILD's model, recomputed per child (IoC — same seam duplex uses
+     *  for its workers). The child's model may differ from the parent's (explicit `model` / agentType def),
+     *  and provider options are NOT portable across providers (cursor `cwd`/`cursorSession` on anthropic
+     *  is a hard 400), so they are derived, never blindly inherited. */
+    providerOptionsFor?: (model: string) => Record<string, unknown> | undefined;
     /** Origin-anchored real-disk dir for child transcript traces (see `AgentOptions.traceDir`). Passed
      *  down UNCHANGED to nested children so every level writes to the same origin `.agent`. */
     traceDir?: string;