@livx.cc/agentx 0.99.91 → 0.99.93

package/dist/index.d.ts

@@ -978,6 +978,8 @@ interface TaskRecord {
     budgetSpent?: boolean;
     /** The budget offer spoken in place of the cut rest — folded into the transcript after the written result. */
     capOffer?: string;
+    /** The live worker — Act `refines` injects a user refinement into it (DuplexAgent.amendTask). */
+    worker?: Agent;
 }
 type WorkerTier = 'act' | 'think';
 declare class DuplexAgentOptions {
@@ -1007,6 +1009,10 @@ declare class DuplexAgentOptions {
     host?: HostBridge;
     /** How many recent transcript messages are rendered into a worker's brief. */
     excerptTurns: number;
+    /** A Hold turn whose user says nothing more for this long is answered after all (a re-voice turn told they stopped):
+     *  without it a wrong Hold left the turn as a lone "mm-hm" forever. 0 = off. Only for a host that reports the user's
+     *  live speech via userActive() — else a slow talker's next words would be spoken over. */
+    holdResumeMs: number;
     /** Voice register: 'neutral' = clean spoken style; 'conversational' = human-like — fillers,
      *  backchannels, impulsive first reactions before content (mimics real duplex conversation). */
     voiceStyle: 'neutral' | 'conversational';
@@ -1047,6 +1053,9 @@ 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>>;
+    /** Extra roots QuickLook ls/file try for a relative path not found under the cwd (the CLI passes ~ and ~/Documents:
+     *  a spoken "Projects/X" means ~/Documents/Projects/X far more often than <cwd>/Projects/X). */
+    lookRoots: 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[];
@@ -1104,11 +1113,15 @@ declare class DuplexAgent {
     private spokeThisTurn;
     private externalSpeech;
     private heldThisTurn;
+    private holdTimer;
+    private holdResumed;
     private nudging;
     private reflexBuf;
     private reflexForwarded;
     private fabricationCut;
     private leakCuts;
+    private midPhraseBounced;
+    private repeatCuts;
     private leakStep;
     private leakHit;
     private stepMarks;
@@ -1191,10 +1204,11 @@ declare class DuplexAgent {
      *  not dead air, and a nudge would run on the same aborted signal (live: the "[reminder]" landed in the
      *  transcript as a user turn with no reply, session 20260923-101910 msg 27). */
     private endTurn;
-    /** Remove complete stage-direction parentheticals from the UNFORWARDED reflex text (STAGE_DIRECTION_RE).
-     *  Only the unforwarded region is touched — already-spoken audio can't be unsent, and splicing before
-     *  reflexForwarded would corrupt the forward offset. */
-    private scrubStageDirections;
+    /** Rewrite the UNFORWARDED reflex text: drop complete stage-direction parentheticals (STAGE_DIRECTION_RE) and spoken
+     *  junk (scrubSpokenJunk). Only the unforwarded region is touched — already-spoken audio can't be unsent, and
+     *  splicing before reflexForwarded would corrupt the forward offset. Rewritten per step segment so the stepMarks
+     *  after it move with the text (a mark is a reflexBuf offset); a segment that ends at a step mark is complete. */
+    private scrubUnforwarded;
     /** Clear the per-turn guards. Called at the head of every voice turn (user send + re-voice flush). */
     private resetTurn;
     /** preToolUse guard on the reflex: once it has dispatched this turn, a dispatch is "said my piece,
@@ -1207,6 +1221,11 @@ declare class DuplexAgent {
      *  inline turn whose reply came back empty it is NOT — "One sec." followed by permanent silence is
      *  still dead air, so silentTurn ignores external speech unless work was dispatched. */
     noteExternalSpeech(): void;
+    /** The user is speaking (a live partial, a barge): a pending Hold expiry waits for them again. */
+    userActive(): void;
+    private clearHoldResume;
+    private armHoldResume;
+    static readonly HOLD_EXPIRED = "[the user stopped there and did not go on \u2014 respond to what they said now; if it is unclear, ask one short question. Do not Hold.]";
     /** True when the just-finished turn voiced NOTHING — dead air to repair. Two ways this happens:
      *  (a) a dispatch with no spoken ack, and (b) an INLINE turn whose `final` channel came back empty —
      *  gpt-oss harmony sometimes puts the whole reply in `analysis` (→ thinking_delta, suppressed in
@@ -1266,6 +1285,10 @@ declare class DuplexAgent {
      *  Called on divergence (send), a stale partial (VoiceEngine.onSpeculateAbort), a side-effect tool
      *  attempt (dispatchGuard), or host paths that will never dispatch a final (commands, voice-off). */
     abortSpeculation(): void;
+    /** Fold a refinement into a RUNNING task's worker (Agent.inject — picked up at its next step) instead of cancel +
+     *  respawn: live 20261013-085238 one request spoken over three fragments became t5 → cancel → t6 → cancel → t7, each
+     *  worker restarting from zero. Returns the id when amended, undefined when the task is not running (→ dispatch new). */
+    amendTask(id: string, brief: string): string | undefined;
     /** Cancel a running background task — shared by the CancelTask tool and the CLI /tasks picker. */
     cancelTask(id: string): string;
     /** Barge-in (or a dispatch-driven supersede): suppress running tasks' remaining SPOKEN delivery so a
@@ -1401,6 +1424,12 @@ declare class DuplexAgent {
      *  fs-only (no shell; the engine is VFS-abstracted): time, git branch (.git/HEAD read), ls, file
      *  head. Output is hard-capped so a lookup can never bloat the skinny voice context. */
     private quickLookTool;
+    /** Where QuickLook tries a path: as given (cwd-relative or absolute), then — relative only — under each lookRoot. */
+    private lookCandidates;
+    /** A QuickLook path not found anywhere: say where it looked and, at the deepest folder that DID exist, the few closest
+     *  names (a mis-heard segment — "Lead Sheets" for "Livshitz" — is usually one of them). Never the whole cwd listing:
+     *  live 20261013-085238 dumped it three times for three spellings of the same path. */
+    private lookMiss;
     private answerTaskTool;
     private holdTool;
     private cancelTaskTool;