agent.libx.js 0.92.8 → 0.93.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as AgentOptions, H as Hooks, h as RunResult, A as Agent } from './Agent-QwBA0wu6.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-QwBA0wu6.js';
+import { a as AgentOptions, H as Hooks, h as RunResult, A as Agent } from './Agent-B_xvSHlG.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-B_xvSHlG.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';
@@ -473,6 +473,10 @@ declare function loadCommands(fs: IFilesystem, dir: string | string[], opts?: {
     tool?: AgentTool;
 }>;
 
+/** Behavioral guidance injected alongside the memory index — adapted from CC's battle-tuned prose, for our tool-based workflow. */
+declare const MEMORY_PROMPT: string;
+/** Voice-specific memory guidance — shorter, spoken-interaction tuned. */
+declare const VOICE_MEMORY_PROMPT: string;
 /**
  * Load memory for injection at run start (the recall step), with progressive disclosure:
  *  - `index`: the compact `<dir>/MEMORY.md` index, injected into the system prompt — cheap,
@@ -485,10 +489,18 @@ declare function loadCommands(fs: IFilesystem, dir: string | string[], opts?: {
  * IndexedDbFilesystem → browser, (planned) BodDbFilesystem → database. The same
  * memory mechanism therefore works in node, a browser tab, or on edge.
  */
-declare function loadMemory(fs: IFilesystem, dir: string, opts?: {
+interface LoadMemoryOpts {
     relevanceHint?: string;
     max?: number;
-}): Promise<{
+    /** Max Remember calls per session (default 25). Prevents runaway memory writes. */
+    maxWritesPerSession?: number;
+    /** Called after each successful memory write (auditing, UI indicators). */
+    onMemorySaved?: (slug: string, type?: string) => void;
+    /** User-scope dir for global memories (type=user/feedback). If set, Remember routes by type:
+     *  user/feedback → userDir (global, survives across projects), project/reference → writeDir. */
+    userDir?: string;
+}
+declare function loadMemory(fs: IFilesystem, dir: string | string[], opts?: LoadMemoryOpts): Promise<{
     index: string;
     tools: AgentTool[];
 }>;
@@ -499,7 +511,10 @@ declare function slugify(s: string, fallback?: string): string;
  * `<dir>/MEMORY.md` (created if missing). Idempotent on the index (won't duplicate a pointer).
  * This is the shared write path behind the `Remember` tool and automatic lesson capture.
  */
-declare function writeFact(fs: IFilesystem, dir: string, slug: string, body: string): Promise<void>;
+declare function writeFact(fs: IFilesystem, dir: string, slug: string, body: string, opts?: {
+    type?: string;
+    description?: string;
+}): Promise<void>;
 
 /**
  * Automatic mistake → lesson → steer loop. Closes the within-run learning gap: the agent
@@ -611,6 +626,11 @@ declare class DuplexAgentOptions {
     /** Host overrides for QuickLook lookups (keyed by `what`). The engine's defaults go through the
      *  (possibly jailed) fs — e.g. `.git/**` is deny-listed, so the CLI supplies 'branch' itself. */
     quickLook?: Record<string, (path?: string) => string | Promise<string>>;
+    /** Memory directory/directories on the WORKER fs. If set, the voice agent gets Remember + Recall
+     *  tools directly (no delegation needed) and implicit capture guidance. */
+    memoryDir?: string | string[];
+    /** User-scope memory dir for global facts (type=user/feedback). Forwarded to Remember's routing. */
+    memoryUserDir?: string;
 }
 declare const VOICE_SYSTEM_PROMPT: string;
 /**
@@ -632,7 +652,11 @@ declare class DuplexAgent {
         question: string;
         resolve: (answer: string) => void;
     }>;
+    /** Lazily resolved memory tools (async loadMemory runs in initMemory). */
+    private memoryReady;
     constructor(options?: Partial<DuplexAgentOptions>);
+    /** Resolve memory tools + inject index into voice system prompt (once). */
+    private initMemory;
     /** One user turn: the voice agent streams the reply (and may Delegate). Serialized with re-voice turns. */
     send(content: MessageContent): Promise<RunResult>;
     /** Resolve when all queued voice turns AND all in-flight worker tasks have settled (tests, graceful shutdown). */
@@ -817,18 +841,15 @@ declare class VoiceEngineOptions {
     /** heuristic (non-AEC) energy barge-in tuning */
     bargeRmsMult: number;
     bargeRmsFloor: number;
-    /** Overlap turn-taking (AEC tier, needs player.pause/resume) — human phone-call model:
-     *  onset → PAUSE (exact-sample hold, nothing lost); sustained overlap → cede (interrupt; the LLM
-     *  re-enters). Brief overlaps that die out (backchannels — "mm-hm", decided by DURATION, not
-     *  vocabulary) resume from the precise sample and are dropped. false disables. */
+    /** Overlap turn-taking (AEC tier, needs player.pause/resume) — human phone-call model, driven by
+     *  the STT ITSELF (a trained speech classifier) instead of energy thresholds (energy could not
+     *  separate residue bursts from speech in every room — hiccup whack-a-mole): partial text while
+     *  speaking → PAUSE (exact-sample hold); partial grows into dominant-novel ≥2 words → cede
+     *  (interrupt; the LLM re-enters); partial stalls/endpoints without ceding (backchannel by
+     *  DURATION, not vocabulary) → resume + drop. false disables. */
     overlapPause: boolean;
-    /** sustained overlap ≥ this → cede the turn */
-    overlapSustainMs: number;
-    /** quiet for this long while paused → resume, drop the interjection */
+    /** no new partial activity for this long while paused → resume, drop the interjection */
     overlapResumeMs: number;
-    /** energy floor for "overlap candidate" — must sit ABOVE typical room ambient (~110 rms measured;
-     *  ungated ambient re-arming the resume timer forever was a live wedge). User speech ≫ 300. */
-    overlapRms: number;
 }
 declare class VoiceEngine {
     options: VoiceEngineOptions;
@@ -853,8 +874,7 @@ declare class VoiceEngine {
     private pendingTimer;
     private lastInterrupted;
     private pausedAt;
-    private overlapLoud;
-    private overlapLastLoudAt;
+    private lastOverlapPartial;
     private resumeTimer;
     constructor(options?: Partial<VoiceEngineOptions>);
     start(): Promise<void>;
@@ -892,13 +912,10 @@ declare class VoiceEngine {
     private handleUtterance;
     private flushUtterance;
     private get overlapCapable();
-    /** Overlap turn-taking (AEC tier): onset → pause (exact-sample hold); sustained → cede; died out
-     *  → resume. No vocabulary anywhere — duration and persistence decide (backchannels are short
-     *  and stop). Nothing is lost across a pause, so a false positive costs only a brief hold. */
-    private handleOverlap;
     private armResume;
     private resetOverlap;
     /** energy two-stage barge-in (heuristic tier only): spike over echo baseline → pause + confirm via STT */
+    private gatePassTimes;
     private handleLevel;
 }
 
@@ -907,6 +924,9 @@ declare class SonioxSTTOptions {
     source: AudioSource;
     model: string;
     languageHints: string[];
+    /** Client-side endpoint: finalized text + no new tokens for this long = utterance (don't wait for
+     *  Soniox's semantic <end>, which adds 0.5-1.5s — the difference between ping-pong and lag). */
+    silenceEndpointMs: number;
 }
 declare class SonioxSTT {
     options: SonioxSTTOptions;
@@ -919,6 +939,9 @@ declare class SonioxSTT {
     onLevel: (rms: number) => void;
     private finalText;
     private partialText;
+    private lastChangeAt;
+    private lastCombined;
+    private endpointTimer;
     constructor(options?: Partial<SonioxSTTOptions>);
     get usingAec(): boolean;
     private connectWs;
@@ -953,4 +976,4 @@ declare class CartesiaTTS {
     close(): void;
 }
 
-export { Agent, type AgentDef, AgentOptions, AgentTool, 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, MessageContent, type Mount, MountFilesystem, NodeDiskFilesystem, OverlayFilesystem, type ReflectOptions, RunResult, STT_SAMPLE_RATE, ScriptedHostBridge, type SkillInfo, SonioxSTT, SonioxSTTOptions, type SttLike, TTS_SAMPLE_RATE, type TaskRecord, type TaskToolOptions, ToolCall, type ToolSpec, type TtsLike, UserQuestion, VOICE_SYSTEM_PROMPT, VoiceEngine, VoiceEngineOptions, type VoiceState, type WebFetchOptions, type WebSearchOptions, applyEditsTool, askUserQuestionTool, checkpointTool, checkpointTools, compileSynthesizedTool, diskAgentOptions, expandCommand, expandTemplate, forComponent, fullAgentOptions, globTool, grepTool, htmlToText, idfWeights, lessonCapture, loadAgents, loadCommands, loadInstructions, loadMemory, loadSkills, makeTaskBatchTool, makeTaskTool, makeWebFetchTool, makeWebSearchTool, mkdirp, multiEditTool, raceAttempts, reflectOnRun, relevanceScore, repoIndex, repoMapTool, resolveAuth, rollbackTool, sandboxAgentOptions, slugify, tokenize, toolCall, topByRelevance, validateToolCode, webFetchTool, webSearchTool, writeFact, writeTool };
+export { Agent, type AgentDef, AgentOptions, AgentTool, 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, STT_SAMPLE_RATE, ScriptedHostBridge, type SkillInfo, SonioxSTT, SonioxSTTOptions, type SttLike, TTS_SAMPLE_RATE, type TaskRecord, type TaskToolOptions, ToolCall, type ToolSpec, type TtsLike, UserQuestion, VOICE_MEMORY_PROMPT, VOICE_SYSTEM_PROMPT, VoiceEngine, VoiceEngineOptions, type VoiceState, type WebFetchOptions, type WebSearchOptions, applyEditsTool, askUserQuestionTool, checkpointTool, checkpointTools, compileSynthesizedTool, diskAgentOptions, expandCommand, expandTemplate, forComponent, fullAgentOptions, globTool, grepTool, htmlToText, idfWeights, lessonCapture, loadAgents, loadCommands, loadInstructions, loadMemory, loadSkills, makeTaskBatchTool, makeTaskTool, makeWebFetchTool, makeWebSearchTool, mkdirp, multiEditTool, raceAttempts, reflectOnRun, relevanceScore, repoIndex, repoMapTool, resolveAuth, rollbackTool, sandboxAgentOptions, slugify, tokenize, toolCall, topByRelevance, validateToolCode, webFetchTool, webSearchTool, writeFact, writeTool };