@livx.cc/agentx 0.98.1 → 0.99.1

package/dist/index.d.ts

@@ -467,14 +467,27 @@ interface WebFetchOptions {
 declare function makeWebFetchTool(options?: WebFetchOptions): AgentTool;
 interface WebSearchOptions {
     fetch?: typeof globalThis.fetch;
-    /** Provider: 'auto' (default) uses Tavily if an API key is present, else keyless DuckDuckGo. */
-    provider?: 'auto' | 'tavily' | 'duckduckgo';
+    /** Provider: 'auto' (default) prefers Firecrawl, then Tavily (by key presence), else keyless DuckDuckGo.
+     *  'anthropic' delegates to a cheap model with Anthropic's native server-side web_search. */
+    provider?: 'auto' | 'tavily' | 'duckduckgo' | 'anthropic' | 'firecrawl';
     /** API key for Tavily (default: process.env.TAVILY_API_KEY). */
     apiKey?: string;
     /** Tavily endpoint override. */
     endpoint?: string;
+    /** API key for Firecrawl (default: process.env.FIRECRAWL_API_KEY). */
+    firecrawlApiKey?: string;
+    /** Firecrawl search endpoint override. */
+    firecrawlEndpoint?: string;
     maxResults?: number;
     timeoutMs?: number;
+    /** Tool name (default 'WebSearch'). Set to register a provider-pinned variant, e.g. 'WebSearchAnthropic'. */
+    name?: string;
+    /** Tool description override (default: the generic ranked-results blurb). */
+    description?: string;
+    /** Anthropic key for provider 'anthropic' (default: process.env.ANTHROPIC_API_KEY). */
+    anthropicApiKey?: string;
+    /** Model for provider 'anthropic' (default 'claude-haiku-4-5'). */
+    model?: string;
 }
 interface SearchHit {
     title: string;
@@ -486,13 +499,24 @@ declare function decodeDdgUrl(href: string): string;
 /** Parse DuckDuckGo's HTML results page into hits (title/url/snippet) — dependency-free, zips anchors to snippets in order. */
 declare function parseDdgHtml(html: string, max: number): SearchHit[];
 /**
- * Build a WebSearch tool. Keyless by default (DuckDuckGo HTML) so it works in any deployment with
- * no setup; auto-upgrades to Tavily (better, agent-oriented results) when TAVILY_API_KEY is present.
+ * Build a WebSearch tool. Keyless by default (DuckDuckGo HTML) so it works in any deployment with no
+ * setup; on provider 'auto' it upgrades to an agent-oriented API by key presence — Firecrawl
+ * (FIRECRAWL_API_KEY) preferred, then Tavily (TAVILY_API_KEY). Provider 'anthropic' is a separate path
+ * (native search via a cheap model) exposed as the WebSearchAnthropic tool.
  */
 declare function makeWebSearchTool(options?: WebSearchOptions): AgentTool;
 /** Default instances (registered in the tool registry; opt-in by name). */
 declare const webFetchTool: AgentTool;
 declare const webSearchTool: AgentTool;
+/** Anthropic-native search as a provider-pinned WebSearch variant. The credential is API-key billing
+ *  (x-api-key); pass `anthropicApiKey` to inject a resolved key, else it falls back to ANTHROPIC_API_KEY. */
+declare function makeWebSearchAnthropicTool(opts?: {
+    anthropicApiKey?: string;
+    model?: string;
+}): AgentTool;
+/** Env-keyed singleton: registered in the tool registry so 'WebSearchAnthropic' resolves by name. The
+ *  CLI default-on path builds its own instance with a config-resolved key (see cli/core.ts). */
+declare const webSearchAnthropicTool: AgentTool;
 
 /**
  * Scratch — keep large tool/subagent outputs OUT of the main context, but queryable AS FILES.
@@ -952,6 +976,7 @@ declare class DuplexAgent {
     private turnDispatched;
     private turnBriefs;
     private spokeThisTurn;
+    private heldThisTurn;
     private nudging;
     private reflexBuf;
     private reflexForwarded;
@@ -1498,4 +1523,4 @@ declare function exitWorktree(): {
     reason?: string;
 } | null;
 
-export { Agent, type AgentDef, AgentOptions, AgentTool, type AskOptions, type Attempt, type AudioSink, type AudioSource, type AuthProvider, BodDbFilesystem, CartesiaTTS, CartesiaTTSOptions, ChatLike, ChatOptions, ChatResponse, type CommandInfo, ConsoleHostBridge, DEFAULT_DENY, DuplexAgent, DuplexAgentOptions, type DuplexTaskStatus, FakeAIClient, Hooks, HostBridge, JailOptions, JailedFilesystem, type LessonOptions, LessonOptionsDefaults, type LoadMemoryOpts, MEMORY_PROMPT, MessageContent, type Mount, MountFilesystem, NodeDiskFilesystem, OverlayFilesystem, type ReflectOptions, RunResult, SCRATCH_DIR, STT_SAMPLE_RATE, type ScheduledJob, type ScheduledJobSnapshot, Scheduler, type SchedulerOptions, Scratch, type ScratchOptions, ScriptedHostBridge, type SiblingResolver, type SkillInfo, SonioxSTT, SonioxSTTOptions, type SttLike, TTS_SAMPLE_RATE, type TaskRecord, type TaskToolOptions, ToolCall, type ToolSpec, type Trigger, type TriggerCron, type TriggerInterval, type TriggerOneOff, type TtsLike, UserQuestion, VOICE_MEMORY_PROMPT, VOICE_SYSTEM_PROMPT, VoiceEngine, VoiceEngineOptions, type VoiceState, type WebFetchOptions, type WebSearchOptions, type WorkerTier, type WorktreeInfo, type WorktreeSession, applyEditsTool, askUserQuestionTool, checkpointTool, checkpointTools, cleanupWorktree, compileSynthesizedTool, cronMatches, decodeDdgUrl, diskAgentOptions, enterWorktree, exitWorktree, expandCommand, expandEntry, expandTemplate, findGitRoot, forComponent, fullAgentOptions, getOrCreateWorktree, getWorktreeSession, globTool, grepTool, htmlToText, idfWeights, lessonCapture, loadAgents, loadCommands, loadInstructions, loadMemory, loadSkills, makeAskTool, makeScheduleTools, makeTaskBatchTool, makeTaskTool, makeWebFetchTool, makeWebSearchTool, mkdirp, multiEditTool, nextCronAfter, parseCron, parseDdgHtml, raceAttempts, reflectOnRun, relevanceScore, repoIndex, repoMapTool, resolveAuth, rollbackTool, sandboxAgentOptions, scanCommands, scanSkills, slugify, tokenize, toolCall, topByRelevance, validateToolCode, validateWorktreeSlug, webFetchTool, webSearchTool, worktreeBranchName, writeFact, writeTool };
+export { Agent, type AgentDef, AgentOptions, AgentTool, type AskOptions, type Attempt, type AudioSink, type AudioSource, type AuthProvider, BodDbFilesystem, CartesiaTTS, CartesiaTTSOptions, ChatLike, ChatOptions, ChatResponse, type CommandInfo, ConsoleHostBridge, DEFAULT_DENY, DuplexAgent, DuplexAgentOptions, type DuplexTaskStatus, FakeAIClient, Hooks, HostBridge, JailOptions, JailedFilesystem, type LessonOptions, LessonOptionsDefaults, type LoadMemoryOpts, MEMORY_PROMPT, MessageContent, type Mount, MountFilesystem, NodeDiskFilesystem, OverlayFilesystem, type ReflectOptions, RunResult, SCRATCH_DIR, STT_SAMPLE_RATE, type ScheduledJob, type ScheduledJobSnapshot, Scheduler, type SchedulerOptions, Scratch, type ScratchOptions, ScriptedHostBridge, type SiblingResolver, type SkillInfo, SonioxSTT, SonioxSTTOptions, type SttLike, TTS_SAMPLE_RATE, type TaskRecord, type TaskToolOptions, ToolCall, type ToolSpec, type Trigger, type TriggerCron, type TriggerInterval, type TriggerOneOff, type TtsLike, UserQuestion, VOICE_MEMORY_PROMPT, VOICE_SYSTEM_PROMPT, VoiceEngine, VoiceEngineOptions, type VoiceState, type WebFetchOptions, type WebSearchOptions, type WorkerTier, type WorktreeInfo, type WorktreeSession, applyEditsTool, askUserQuestionTool, checkpointTool, checkpointTools, cleanupWorktree, compileSynthesizedTool, cronMatches, decodeDdgUrl, diskAgentOptions, enterWorktree, exitWorktree, expandCommand, expandEntry, expandTemplate, findGitRoot, forComponent, fullAgentOptions, getOrCreateWorktree, getWorktreeSession, globTool, grepTool, htmlToText, idfWeights, lessonCapture, loadAgents, loadCommands, loadInstructions, loadMemory, loadSkills, makeAskTool, makeScheduleTools, makeTaskBatchTool, makeTaskTool, makeWebFetchTool, makeWebSearchAnthropicTool, makeWebSearchTool, mkdirp, multiEditTool, nextCronAfter, parseCron, parseDdgHtml, raceAttempts, reflectOnRun, relevanceScore, repoIndex, repoMapTool, resolveAuth, rollbackTool, sandboxAgentOptions, scanCommands, scanSkills, slugify, tokenize, toolCall, topByRelevance, validateToolCode, validateWorktreeSlug, webFetchTool, webSearchAnthropicTool, webSearchTool, worktreeBranchName, writeFact, writeTool };

package/dist/index.js

@@ -644,13 +644,48 @@ function formatHits(hits) {
    ${r.url}
    ${r.snippet.replace(/\s+/g, " ").slice(0, 240)}`).join("\n\n");
 }
+async function firecrawlSearch(q, opts) {
+  const res = await opts.fetch(opts.endpoint, {
+    method: "POST",
+    signal: opts.signal,
+    headers: { authorization: `Bearer ${opts.key}`, "content-type": "application/json" },
+    body: JSON.stringify({ query: q, limit: opts.maxResults })
+  });
+  if (!res.ok) return `Error: Firecrawl search returned ${res.status} ${res.statusText}`;
+  const data = await res.json();
+  const results = Array.isArray(data?.data) ? data.data.slice(0, opts.maxResults) : [];
+  return formatHits(results.map((r) => ({ title: r.title ?? "(untitled)", url: r.url ?? "", snippet: String(r.description ?? r.markdown ?? "") })));
+}
+async function anthropicSearch(q, opts) {
+  const res = await opts.fetch("https://api.anthropic.com/v1/messages", {
+    method: "POST",
+    signal: opts.signal,
+    headers: { "x-api-key": opts.key, "anthropic-version": "2023-06-01", "content-type": "application/json" },
+    body: JSON.stringify({
+      model: opts.model,
+      max_tokens: 1024,
+      // Basic variant: Haiku-tier doesn't support the _20260209 dynamic-filtering variant (Opus 4.6+/Sonnet 4.6 only).
+      tools: [{ type: "web_search_20250305", name: "web_search", max_uses: 5 }],
+      messages: [{ role: "user", content: `Search the web for: ${q}
+
+Return only the relevant findings as concise bullet points, each with its source URL in parentheses. Do not add a preamble, conclusion, opinion, or commentary. If sources conflict, list each claim with its source rather than resolving it.` }]
+    })
+  });
+  if (!res.ok) return `Error: Anthropic search returned ${res.status} ${res.statusText}`;
+  const data = await res.json();
+  if (data?.stop_reason === "refusal") return "Error: Anthropic search refused the query";
+  let text = "";
+  for (const block of data?.content ?? []) if (block?.type === "text") text += block.text;
+  return text.trim() || "(no results)";
+}
 function makeWebSearchTool(options = {}) {
   const tavilyEndpoint = options.endpoint ?? "https://api.tavily.com/search";
+  const firecrawlEndpoint = options.firecrawlEndpoint ?? "https://api.firecrawl.dev/v1/search";
   const maxResults = options.maxResults ?? 5;
   const timeoutMs = options.timeoutMs ?? 15e3;
   return {
-    name: "WebSearch",
-    description: "Search the web by query; returns ranked results (title, URL, snippet). Use to look things up, find pages, or research a topic \u2014 then WebFetch a result URL to read it in full.",
+    name: options.name ?? "WebSearch",
+    description: options.description ?? "Search the web by query; returns ranked results (title, URL, snippet). Use to look things up, find pages, or research a topic \u2014 then WebFetch a result URL to read it in full.",
     parameters: { type: "object", required: ["query"], properties: { query: { type: "string" } } },
     async run({ query }) {
       const doFetch = options.fetch ?? globalThis.fetch;
@@ -658,11 +693,22 @@ function makeWebSearchTool(options = {}) {
       const q = String(query ?? "").trim();
       if (!q) return "Error: empty query";
       const key = options.apiKey ?? process.env.TAVILY_API_KEY;
+      const fcKey = options.firecrawlApiKey ?? process.env.FIRECRAWL_API_KEY;
       const provider = options.provider ?? "auto";
-      const useTavily = provider === "tavily" || provider === "auto" && !!key;
+      const useFirecrawl = provider === "firecrawl" || provider === "auto" && !!fcKey;
+      const useTavily = provider === "tavily" || provider === "auto" && !useFirecrawl && !!key;
       const ctl = new AbortController();
       const timer = setTimeout(() => ctl.abort(), timeoutMs);
       try {
+        if (provider === "anthropic") {
+          const akey = options.anthropicApiKey ?? process.env.ANTHROPIC_API_KEY;
+          if (!akey) return "Error: WebSearchAnthropic requires ANTHROPIC_API_KEY (set in env)";
+          return await anthropicSearch(q, { key: akey, model: options.model ?? "claude-haiku-4-5", fetch: doFetch, signal: ctl.signal });
+        }
+        if (useFirecrawl) {
+          if (!fcKey) return "Error: Firecrawl provider selected but FIRECRAWL_API_KEY is not set";
+          return await firecrawlSearch(q, { key: fcKey, endpoint: firecrawlEndpoint, maxResults, fetch: doFetch, signal: ctl.signal });
+        }
         if (useTavily) {
           if (!key) return "Error: Tavily provider selected but TAVILY_API_KEY is not set";
           const res2 = await doFetch(tavilyEndpoint, {
@@ -691,7 +737,10 @@ function makeWebSearchTool(options = {}) {
     }
   };
 }
-var log2, _dnsLookup, webFetchTool, webSearchTool;
+function makeWebSearchAnthropicTool(opts = {}) {
+  return makeWebSearchTool({ provider: "anthropic", name: "WebSearchAnthropic", description: ANTHROPIC_SEARCH_DESC, anthropicApiKey: opts.anthropicApiKey, model: opts.model });
+}
+var log2, _dnsLookup, webFetchTool, webSearchTool, ANTHROPIC_SEARCH_DESC, webSearchAnthropicTool;
 var init_tools_web = __esm({
   "src/tools.web.ts"() {
     "use strict";
@@ -699,6 +748,8 @@ var init_tools_web = __esm({
     log2 = forComponent("web");
     webFetchTool = makeWebFetchTool();
     webSearchTool = makeWebSearchTool();
+    ANTHROPIC_SEARCH_DESC = "High-quality web search via Anthropic's native search index. Returns concise, sourced findings \u2014 one claim per line, each with its source URL. Prefer this over WebSearch when accuracy and citations matter; it is slower (~3\u20138s) and bills the Anthropic API account per call (one cheap-model turn + search fee).";
+    webSearchAnthropicTool = makeWebSearchAnthropicTool();
   }
 });
 
@@ -924,7 +975,7 @@ function defaultTools() {
   return [bashTool, readTool, editTool];
 }
 function toolRegistry() {
-  const all = [bashTool, readTool, editTool, grepTool, globTool, writeTool, multiEditTool, applyEditsTool, repoMapTool, reviewTool(), todoWriteTool, webFetchTool, webSearchTool];
+  const all = [bashTool, readTool, editTool, grepTool, globTool, writeTool, multiEditTool, applyEditsTool, repoMapTool, reviewTool(), todoWriteTool, webFetchTool, webSearchTool, webSearchAnthropicTool];
   return Object.fromEntries(all.map((t) => [t.name, t]));
 }
 function toolsByName(names) {
@@ -4983,6 +5034,8 @@ var DuplexAgent = class _DuplexAgent {
   // briefs dispatched this turn (detect identical re-dispatch)
   spokeThisTurn = false;
   // any non-empty text_delta streamed this turn
+  heldThisTurn = false;
+  // Hold called this turn → turn is INTENTIONALLY silent (suppress reflex text + no dead-air ack)
   nudging = false;
   // re-ack pass in flight: block ALL tools, prevent recursion
   reflexBuf = "";
@@ -5045,6 +5098,7 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
       confirm: host.confirm ? (p, m) => host.confirm(p, m) : void 0,
       notify: (ev) => {
         if (ev?.kind === "text_delta" && typeof ev.message === "string") {
+          if (this.heldThisTurn) return;
           if (this.fabricationCut) return;
           const msg = ev.message;
           this.reflexBuf += msg;
@@ -5114,6 +5168,7 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
     this.turnDispatched = false;
     this.turnBriefs.clear();
     this.spokeThisTurn = false;
+    this.heldThisTurn = false;
     this.reflexBuf = "";
     this.reflexForwarded = 0;
     this.fabricationCut = false;
@@ -5142,7 +5197,7 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
    *  voice) and emits an empty `final`, so no text_delta ever streams. Both ship silence; both repair.
    *  Requires a host: without one there's no stream to detect speech on (and no one to speak to). */
   get silentTurn() {
-    return !!this.options.host && !this.spokeThisTurn;
+    return !!this.options.host && !this.spokeThisTurn && !this.heldThisTurn;
   }
   /** A turn that voiced nothing is dead air. Re-prompt the reflex ONCE so the LLM itself voices a short
    *  line (no template). If it STILL says nothing, fall back to a minimal line so silence never ships.
@@ -5703,6 +5758,7 @@ Another agent just implemented the above. Independently check the CURRENT state
         }
       },
       run: async ({ filler }) => {
+        this.heldThisTurn = true;
         if (filler) this.notify("hold_filler", String(filler));
         return "Holding \u2014 listening for the rest of the user's thought. Do not respond further this turn.";
       }
@@ -6812,6 +6868,7 @@ export {
   makeTaskBatchTool,
   makeTaskTool,
   makeWebFetchTool,
+  makeWebSearchAnthropicTool,
   makeWebSearchTool,
   mcpToolToAgentTool,
   mcpToolsToAgentTools,
@@ -6845,6 +6902,7 @@ export {
   validateToolCode,
   validateWorktreeSlug,
   webFetchTool,
+  webSearchAnthropicTool,
   webSearchTool,
   worktreeBranchName,
   writeFact,