@livx.cc/agentx 0.99.20 → 0.99.22

package/dist/index.d.ts

@@ -1,14 +1,14 @@
-import { a as AgentOptions, H as Hooks, h as RunResult, A as Agent } from './Agent-Cn9BxS8h.js';
-export { C as ChatFragment, D as DEFAULT_MUTATING, b as Decision, P as PermissionOptions, c as PermissionPolicy, d as PermissionRule, e as PreToolUseDecision, R as ReasoningEffort, f as RecordingHooks, g as RecordingLifecycle, T as ToolUse, i as ToolUseMeta, j as composeHooks, p as planMode, r as reasoningToChatFragment } from './Agent-Cn9BxS8h.js';
+import { a as AgentOptions, H as Hooks, h as RunResult, A as Agent } from './Agent-CM7HL95r.js';
+export { C as ChatFragment, D as DEFAULT_MUTATING, b as Decision, P as PermissionOptions, c as PermissionPolicy, d as PermissionRule, e as PreToolUseDecision, R as ReasoningEffort, f as RecordingHooks, g as RecordingLifecycle, T as ToolUse, i as ToolUseMeta, j as composeHooks, p as planMode, r as reasoningToChatFragment } from './Agent-CM7HL95r.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, h as ToolCall, H as HostBridge, U as UserQuestion, e as MessageContent } from './tools-DKf3hN4M.js';
-export { c as ContentPart, d as HostEvent, M as Message, R as Role, S as SandboxJobRegistry, f as StreamChunk, T as TodoItem, g as Tool, i as ToolContext, j as bashTool, k as contentText, l as defaultTools, m as editTool, n as exitSessionTool, o as imagePart, p as makeContext, q as makeJobTools, r as readTool, t as toWireTools, s as todoWriteTool, u as toolRegistry, v as toolsByName } from './tools-DKf3hN4M.js';
+import { A as AgentTool, C as ChatLike, a as ChatOptions, b as ChatResponse, h as ToolCall, H as HostBridge, U as UserQuestion, e as MessageContent } from './tools-ClgFZjUr.js';
+export { c as ContentPart, d as HostEvent, M as Message, R as Role, S as SandboxJobRegistry, f as StreamChunk, T as TodoItem, g as Tool, i as ToolContext, j as bashTool, k as contentText, l as defaultTools, m as editTool, n as exitSessionTool, o as imagePart, p as makeContext, q as makeJobTools, r as readTool, t as toWireTools, s as todoWriteTool, u as toolRegistry, v as toolsByName } from './tools-ClgFZjUr.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-DopVRDLx.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-2wyAAfPQ.js';
 import * as libx_js_src_modules_log from 'libx.js/src/modules/log';
 export { log } from 'libx.js/src/modules/log';
 
@@ -596,8 +596,13 @@ declare function makeAskTool(o: AskOptions): AgentTool;
 
 /**
  * `AskUserQuestion` tool — lets the model pose a structured choice to a human.
- * Delegates to `ctx.host.ask`. Registered only when a HostBridge is provided
- * (autonomous runs don't see it), so it never dead-ends a headless agent.
+ * Delegates to `ctx.host.ask` when a human is reachable.
+ *
+ * When NO human is reachable (`host.ask` absent — headless `-p`, a piped/redirected run, an edge
+ * host), the question is NOT dropped and NOT guessed at: it parks on `ctx.needsInput`, and the
+ * Agent ends the run with `finishReason:'needs_input'` carrying the question up to the CALLER.
+ * The caller answers and resumes. Guessing silently is the failure mode this exists to prevent —
+ * a delegated agent that picks for you on a decision that was never its to make.
  */
 declare const askUserQuestionTool: AgentTool;
 /** Deterministic HostBridge for tests/dev: scripts answers + records what was asked. */

package/dist/index.js

@@ -1911,7 +1911,7 @@ ${out.replace(/\n+$/, "") || "(no output yet)"}`;
 // src/host.ts
 var askUserQuestionTool = {
   name: "AskUserQuestion",
-  description: "Ask the user a multiple-choice question when a decision is genuinely theirs to make (ambiguous requirement, a fork you cannot resolve from context). Returns their selection.",
+  description: 'Ask the user a multiple-choice question when a decision is genuinely theirs to make: an ambiguous or under-specified requirement, a fork you cannot resolve from context, a premise of the task that the evidence contradicts, or a risky/irreversible next step. Prefer this over guessing, "proceeding with best judgment", or quietly widening scope to make an unclear brief fit \u2014 a wrong silent decision is far more costly than a question. Returns their selection if a human is reachable; otherwise the run pauses and the question is handed to whoever delegated the task (you do not need to know which \u2014 just ask).',
   parameters: {
     type: "object",
     required: ["question", "options"],
@@ -1927,8 +1927,8 @@ var askUserQuestionTool = {
   },
   async run(args, ctx) {
     if (!ctx.host?.ask) {
-      const fallback = args.options?.[0]?.label ?? "";
-      return `No interactive user is available \u2014 proceed using your best judgment.${fallback ? ` (Closest default: "${fallback}")` : ""}`;
+      ctx.needsInput = args;
+      return "PAUSED \u2014 no interactive user is reachable from this run, so your question has been raised to the caller that delegated this task. The run stops here; do not guess and do not continue. Their answer will arrive as the next user message when the run resumes.";
     }
     const answer = ctx.host.ask(args);
     return ctx.parkHuman ? ctx.parkHuman(answer) : answer;
@@ -3579,6 +3579,7 @@ var Agent = class _Agent {
     let usageEstimated = false;
     const start = Date.now();
     this.parkedMs = 0;
+    this.ctx.needsInput = void 0;
     let toolCallsTotal = 0;
     let lastFp = "";
     let repeats = 0;
@@ -3712,6 +3713,17 @@ var Agent = class _Agent {
         }
         this.transcript.push({ role: "tool", tool_call_id: tc.id, name: tc.function.name, content });
       }
+      if (this.ctx.needsInput) {
+        const question = this.ctx.needsInput;
+        this.ctx.needsInput = void 0;
+        log4.warn(`needs_input: ${question.question} (steps=${steps})`);
+        await this.ctx.jobs?.drain();
+        const text = [
+          `OPEN QUESTION (run paused \u2014 no human was reachable): ${question.question}`,
+          ...question.options.map((o2) => `  \u2022 ${o2.label}${o2.description ? ` \u2014 ${o2.description}` : ""}`)
+        ].join("\n");
+        return { text, steps, finishReason: "needs_input", messages: this.transcript, usage, usageEstimated, question };
+      }
       this.drainInjections();
     }
   }