@mirasoth/soothe-client 0.5.5 → 0.5.8

package/dist/index.cjs

@@ -321,8 +321,7 @@ function newRequestID() {
 function newLoopInputMessage(loopID, content) {
   return notificationEnvelope("loop_input", {
     loop_id: loopID,
-    content,
-    autonomous: false
+    content
   });
 }
 function newLoopNewMessage(opts) {
@@ -361,51 +360,6 @@ var init_protocol = __esm({
   }
 });
 
-// src/intent_hints.ts
-function validateLoopInputIntentHint(hint) {
-  const key = hint.trim().toLowerCase();
-  if (key in REMOVED_INTENT_HINT_MESSAGES) {
-    return REMOVED_INTENT_HINT_MESSAGES[key];
-  }
-  return null;
-}
-var INTENT_HINT_TEXT_COMPLETION, INTENT_HINT_IMAGE_TO_TEXT, INTENT_HINT_OCR, INTENT_HINT_EMBED, REMOVED_INTENT_HINTS, REMOVED_INTENT_HINT_MESSAGES, LOOP_ASSISTANT_OUTPUT_PHASES, DEFAULT_DELIVERABLE_PHASES;
-var init_intent_hints = __esm({
-  "src/intent_hints.ts"() {
-    "use strict";
-    INTENT_HINT_TEXT_COMPLETION = "text_completion";
-    INTENT_HINT_IMAGE_TO_TEXT = "image_to_text";
-    INTENT_HINT_OCR = "ocr";
-    INTENT_HINT_EMBED = "embed";
-    REMOVED_INTENT_HINTS = ["direct_llm", "quiz", "direct_model"];
-    REMOVED_INTENT_HINT_MESSAGES = {
-      direct_llm: "intent_hint direct_llm is removed; use text_completion (text-only) or image_to_text (with attachments)",
-      quiz: "intent_hint quiz is removed; omit intent_hint and let intake classify the turn",
-      direct_model: "intent_hint direct_model is removed; use text_completion, image_to_text, ocr, or embed"
-    };
-    LOOP_ASSISTANT_OUTPUT_PHASES = [
-      "goal_completion",
-      "quiz",
-      "autonomous_goal",
-      "chitchat",
-      "text_completion",
-      "image_to_text",
-      "ocr",
-      "embed",
-      "plan_direct"
-    ];
-    DEFAULT_DELIVERABLE_PHASES = /* @__PURE__ */ new Set([
-      "quiz",
-      "goal_completion",
-      "chitchat",
-      "text_completion",
-      "image_to_text",
-      "ocr",
-      "embed"
-    ]);
-  }
-});
-
 // src/events.ts
 function parseNamespace(ns) {
   const parts = splitNamespace(ns);
@@ -887,7 +841,6 @@ var init_client = __esm({
     init_config();
     init_errors();
     init_multiplexer();
-    init_intent_hints();
     init_stream_terminal();
     init_inbound_priority();
     init_protocol();
@@ -1581,19 +1534,14 @@ var init_client = __esm({
         }
         const params = {
           loop_id: loopId,
-          content: text,
-          autonomous: options?.autonomous ?? false
+          content: text
         };
-        if (options?.maxIterations !== void 0) params.max_iterations = options.maxIterations;
         if (options?.subagent) params.preferred_subagent = options.subagent;
+        if (options?.intakeScope) params.intake_scope = options.intakeScope;
         if (options?.model) params.model = options.model;
         if (options?.modelParams) params.model_params = options.modelParams;
         if (options?.attachments) params.attachments = options.attachments;
         if (options?.intentHint) {
-          const hintError = validateLoopInputIntentHint(options.intentHint);
-          if (hintError) {
-            return Promise.reject(new Error(hintError));
-          }
           params.intent_hint = options.intentHint;
         }
         if (options?.responseSchema) params.response_schema = options.responseSchema;
@@ -1914,6 +1862,16 @@ var init_client = __esm({
           timeout ?? 15e3
         );
       }
+      /** Jobs → goals → loops snapshot for CLI top. */
+      autopilotTop(timeoutOrOptions) {
+        const options = typeof timeoutOrOptions === "number" ? { timeout: timeoutOrOptions } : timeoutOrOptions;
+        return this.requestResponse(
+          "autopilot_top",
+          { include_terminal: options?.includeTerminal ?? false },
+          "autopilot_top",
+          options?.timeout ?? 15e3
+        );
+      }
       /** Subscribes to autopilot worker events. */
       autopilotSubscribe(timeout) {
         return this.subscribe("autopilot_events", {}, timeout ?? 15e3);
@@ -2049,7 +2007,6 @@ __export(index_exports, {
   PROTO_VERSION: () => PROTO_VERSION,
   PooledConn: () => PooledConn,
   QueryGate: () => QueryGate,
-  REMOVED_INTENT_HINTS: () => REMOVED_INTENT_HINTS,
   ReconnectError: () => ReconnectError,
   SSEBroadcaster: () => SSEBroadcaster,
   STREAM_END: () => STREAM_END,
@@ -2087,15 +2044,20 @@ __export(index_exports, {
   fetchLoopHistory: () => fetchLoopHistory,
   fetchLoopMessages: () => fetchLoopMessages,
   fetchSkillsCatalog: () => fetchSkillsCatalog,
+  formatTurnId: () => formatTurnId,
+  frameSeq: () => frameSeq,
+  frameTurnId: () => frameTurnId,
   idleTimeoutForTurn: () => idleTimeoutForTurn,
   inboundNeedsDeliveryAck: () => inboundNeedsDeliveryAck,
   inputMessageForLoop: () => inputMessageForLoop,
   isCompletionEvent: () => isCompletionEvent,
   isDaemonLive: () => isDaemonLive,
   isDaemonTurnEndEvent: () => isDaemonTurnEndEvent,
+  isIdleTerminalAllowed: () => isIdleTerminalAllowed,
   isSubagentProgressEvent: () => isSubagentProgressEvent,
   isTurnEndCustomData: () => isTurnEndCustomData,
   isTurnProgressChunk: () => isTurnProgressChunk,
+  isTurnTerminalAllowed: () => isTurnTerminalAllowed,
   isValidVerbosityLevel: () => isValidVerbosityLevel,
   loadConfigFromEnv: () => loadConfigFromEnv,
   newLoopInputMessage: () => newLoopInputMessage,
@@ -2105,6 +2067,7 @@ __export(index_exports, {
   notificationEnvelope: () => notificationEnvelope,
   parseCardCustomPayload: () => parseCardCustomPayload,
   parseNamespace: () => parseNamespace,
+  parseTurnGeneration: () => parseTurnGeneration,
   pingEnvelope: () => pingEnvelope,
   pongEnvelope: () => pongEnvelope,
   protocol1Rpc: () => protocol1Rpc,
@@ -2115,8 +2078,8 @@ __export(index_exports, {
   shouldShow: () => shouldShow,
   splitWirePayload: () => splitWirePayload,
   subscribeEnvelope: () => subscribeEnvelope,
+  turnIdsMatch: () => turnIdsMatch,
   unsubscribeEnvelope: () => unsubscribeEnvelope,
-  validateLoopInputIntentHint: () => validateLoopInputIntentHint,
   waitDaemonReady: () => waitDaemonReady,
   waitLoopStatusWithID: () => waitLoopStatusWithID,
   waitSubscriptionConfirmed: () => waitSubscriptionConfirmed
@@ -2126,7 +2089,34 @@ init_errors();
 init_verbosity();
 init_config();
 init_protocol();
-init_intent_hints();
+
+// src/intent_hints.ts
+var INTENT_HINT_TEXT_COMPLETION = "text_completion";
+var INTENT_HINT_IMAGE_TO_TEXT = "image_to_text";
+var INTENT_HINT_OCR = "ocr";
+var INTENT_HINT_EMBED = "embed";
+var LOOP_ASSISTANT_OUTPUT_PHASES = [
+  "goal_completion",
+  "quiz",
+  "autonomous_goal",
+  "chitchat",
+  "text_completion",
+  "image_to_text",
+  "ocr",
+  "embed",
+  "plan_direct"
+];
+var DEFAULT_DELIVERABLE_PHASES = /* @__PURE__ */ new Set([
+  "quiz",
+  "goal_completion",
+  "chitchat",
+  "text_completion",
+  "image_to_text",
+  "ocr",
+  "embed"
+]);
+
+// src/index.ts
 init_events();
 init_client();
 
@@ -2321,6 +2311,10 @@ var CommandClient = class {
   async autopilotGetJob(jobId) {
     return this.request("autopilot_get_job", { job_id: jobId });
   }
+  /** Jobs → goals → loops snapshot for CLI top. */
+  async autopilotTop(includeTerminal = false) {
+    return this.request("autopilot_top", { include_terminal: includeTerminal });
+  }
   async cronAdd(text, priority = 0) {
     const params = { text };
     if (priority > 0) params.priority = priority;
@@ -2483,6 +2477,59 @@ async function protocol1Rpc(wsUrl, method, params = null, opts = {}) {
 // src/index.ts
 init_stream_terminal();
 
+// src/turn_boundary.ts
+function formatTurnId(loopId, generation) {
+  const lid = String(loopId || "").trim();
+  const gen = Number(generation);
+  if (!lid || !Number.isFinite(gen) || gen <= 0) return "";
+  return `${lid}:${Math.trunc(gen)}`;
+}
+function parseTurnGeneration(turnId) {
+  const raw = String(turnId || "").trim();
+  if (!raw || !raw.includes(":")) return null;
+  const suffix = raw.split(":").pop() ?? "";
+  const gen = Number.parseInt(suffix, 10);
+  return Number.isFinite(gen) && gen > 0 ? gen : null;
+}
+function frameTurnId(frame) {
+  if (!frame || typeof frame !== "object") return null;
+  const tid = frame.turn_id;
+  if (typeof tid === "string" && tid.trim()) return tid.trim();
+  const data = frame.data;
+  if (data && typeof data === "object") {
+    const inner = data.turn_id;
+    if (typeof inner === "string" && inner.trim()) return inner.trim();
+  }
+  return null;
+}
+function frameSeq(frame) {
+  if (!frame || typeof frame !== "object") return null;
+  const raw = frame.seq;
+  if (typeof raw === "boolean") return null;
+  if (typeof raw === "number" && Number.isFinite(raw) && raw >= 0 && Number.isInteger(raw)) {
+    return raw;
+  }
+  return null;
+}
+function turnIdsMatch(expected, candidate) {
+  const exp = String(expected || "").trim();
+  const cand = String(candidate || "").trim();
+  return Boolean(exp) && Boolean(cand) && exp === cand;
+}
+function isTurnTerminalAllowed(opts) {
+  if (!opts.queryStarted || !opts.turnProgressSeen) return false;
+  return turnIdsMatch(opts.expectedTurnId, opts.frameTurnId);
+}
+function isIdleTerminalAllowed(opts) {
+  if (!opts.queryStarted || !String(opts.expectedTurnId || "").trim()) return false;
+  const cand = String(opts.frameTurnId || "").trim();
+  if (cand) {
+    if (!turnIdsMatch(opts.expectedTurnId, cand)) return false;
+    return Boolean(opts.turnProgressSeen || opts.cancellationSeen);
+  }
+  return Boolean(opts.cancellationSeen);
+}
+
 // src/appkit/broadcaster.ts
 var SUBSCRIBER_QUEUE_CAP = 100;
 var SSEBroadcaster = class {
@@ -3443,9 +3490,6 @@ async function compactAttachments(atts, opts) {
   return out;
 }
 
-// src/appkit/turn_runner.ts
-init_intent_hints();
-
 // src/appkit/turn_boundary.ts
 init_stream_terminal();
 var TURN_END_STREAM_END = STREAM_END;
@@ -3453,8 +3497,9 @@ var TURN_END_IDLE = "status.idle";
 var TURN_END_STOPPED = "status.stopped";
 var TurnLifecycleGate = class {
   sawRunning = false;
-  sawStreamPayload = false;
   sawTurnProgress = false;
+  expectedTurnId = null;
+  cancellationSeen = false;
   observe(msg) {
     const frame = normalizeFrame(msg);
     if (!frame) return;
@@ -3462,22 +3507,43 @@ var TurnLifecycleGate = class {
     if (typ === "status") {
       if (String(frame.state ?? "").trim().toLowerCase() === "running") {
         this.sawRunning = true;
+        const statusTurn = frameTurnId(frame);
+        if (statusTurn) {
+          const newGen = parseTurnGeneration(statusTurn);
+          const oldGen = parseTurnGeneration(this.expectedTurnId);
+          if (this.expectedTurnId === null || newGen !== null && (oldGen === null || newGen >= oldGen)) {
+            if (this.expectedTurnId && statusTurn !== this.expectedTurnId) {
+              this.sawTurnProgress = false;
+            }
+            this.expectedTurnId = statusTurn;
+          }
+        }
       }
       return;
     }
     if (typ === "event") {
-      this.sawStreamPayload = true;
       const mode = String(frame.mode ?? "");
       if (isTurnProgressChunk(mode, frame.data)) {
         this.sawTurnProgress = true;
       }
     }
   }
-  allowStreamEnd() {
-    return this.sawRunning && this.sawTurnProgress;
+  allowStreamEnd(frameTurn) {
+    return isTurnTerminalAllowed({
+      expectedTurnId: this.expectedTurnId,
+      frameTurnId: frameTurn,
+      queryStarted: this.sawRunning,
+      turnProgressSeen: this.sawTurnProgress
+    });
   }
-  allowIdleComplete() {
-    return this.sawRunning && this.sawStreamPayload;
+  allowIdleComplete(frameTurn) {
+    return isIdleTerminalAllowed({
+      expectedTurnId: this.expectedTurnId,
+      frameTurnId: frameTurn,
+      queryStarted: this.sawRunning,
+      turnProgressSeen: this.sawTurnProgress,
+      cancellationSeen: this.cancellationSeen
+    });
   }
 };
 var TurnBoundary = class {
@@ -3492,17 +3558,23 @@ var TurnBoundary = class {
     const typ = String(frame.type ?? "");
     if (typ === "status") {
       const state = String(frame.state ?? "").trim().toLowerCase();
+      const frameTurn = frameTurnId(frame);
       if (state === "stopped" && this.gate.sawRunning) {
+        if (this.gate.expectedTurnId && !turnIdsMatch(this.gate.expectedTurnId, frameTurn)) {
+          return [false, ""];
+        }
         return this.mark(TURN_END_STOPPED);
       }
-      if (state === "idle" && this.gate.allowIdleComplete()) {
+      if (state === "idle" && this.gate.allowIdleComplete(frameTurn)) {
         return this.mark(TURN_END_IDLE);
       }
       return [false, ""];
     }
     if (typ === "event") {
       const mode = String(frame.mode ?? "");
-      if (mode === "custom" && isTurnEndCustomData(frame.data) && this.gate.allowStreamEnd()) {
+      const data = frame.data;
+      const dataTurn = frameTurnId(data) || frameTurnId(frame);
+      if (mode === "custom" && isTurnEndCustomData(data) && this.gate.allowStreamEnd(dataTurn)) {
         return this.mark(TURN_END_STREAM_END);
       }
     }
@@ -3528,20 +3600,26 @@ function normalizeFrame(msg) {
       return inner;
     }
     if (inner && typeof inner === "object" && inner.mode) {
-      return {
+      const out = {
         type: "event",
         mode: inner.mode,
         data: inner.data,
         namespace: inner.namespace ?? payload.namespace
       };
+      const tid = inner.turn_id ?? payload.turn_id ?? m.turn_id;
+      if (tid) out.turn_id = tid;
+      return out;
     }
     if (payload.mode) {
-      return {
+      const out = {
         type: "event",
         mode: payload.mode,
         data: payload.data,
         namespace: payload.namespace
       };
+      const tid = payload.turn_id ?? m.turn_id;
+      if (tid) out.turn_id = tid;
+      return out;
     }
     return null;
   }
@@ -3574,13 +3652,10 @@ function inputMessageForLoop(text, loopID, attachments, opts) {
   if (attachments && attachments.length > 0) msg.attachments = attachments;
   if (opts) {
     if (opts.intentHint?.trim()) {
-      const hintError = validateLoopInputIntentHint(opts.intentHint);
-      if (hintError) {
-        throw new Error(hintError);
-      }
       msg.intent_hint = opts.intentHint.trim();
     }
     if (opts.preferredSubagent?.trim()) msg.preferred_subagent = opts.preferredSubagent.trim();
+    if (opts.intakeScope?.trim()) msg.intake_scope = opts.intakeScope.trim();
     if (opts.responseSchema && Object.keys(opts.responseSchema).length > 0) {
       msg.response_schema = opts.responseSchema;
     }
@@ -4109,8 +4184,6 @@ var DaemonSession = class {
     if (!this.loopId) throw new Error("No active loop session");
     await this.client.sendInput(text, {
       loopID: this.loopId,
-      autonomous: options?.autonomous,
-      maxIterations: options?.maxIterations,
       subagent: options?.preferredSubagent,
       model: options?.model,
       modelParams: options?.modelParams,
@@ -4236,7 +4309,7 @@ var DaemonSession = class {
     this.lastTurnErrorMessage = null;
     let queryStarted = false;
     let expectedLoopId = this.loopId;
-    let streamPayloadSeen = false;
+    let expectedTurnId = null;
     let turnProgressSeen = false;
     this.streaming = true;
     const absoluteDeadline = opts.maxWaitMs !== void 0 && opts.maxWaitMs > 0 ? Date.now() + opts.maxWaitMs : null;
@@ -4270,6 +4343,17 @@ var DaemonSession = class {
         if (expectedLoopId && typeof eventLoopId === "string" && eventLoopId && eventLoopId !== expectedLoopId) {
           continue;
         }
+        const evTurnId = frameTurnId(frame);
+        const statusState = eventType === "status" ? String(frame.state ?? "") : "";
+        const isRunningStatus = statusState === "running";
+        const isTerminalStatus = statusState === "idle" || statusState === "stopped";
+        if (expectedTurnId && (eventType === "event" || eventType === "status") && !isRunningStatus) {
+          if (isTerminalStatus) {
+            if (evTurnId && !turnIdsMatch(expectedTurnId, evTurnId)) continue;
+          } else if (!turnIdsMatch(expectedTurnId, evTurnId)) {
+            continue;
+          }
+        }
         if (eventType === "error") {
           const errObj = frame.error ?? {};
           throw new Error(String(errObj.message || frame.message || "daemon error"));
@@ -4280,16 +4364,37 @@ var DaemonSession = class {
             this.loopId = loopEv;
             expectedLoopId = loopEv;
           }
-          const state = String(frame.state ?? "");
-          if (state === "running") {
+          if (statusState === "running") {
             queryStarted = true;
-          } else if (queryStarted && state === "stopped") {
-            this.lastTurnEndState = state;
+            const statusTurn = frameTurnId(frame);
+            if (statusTurn) {
+              const newGen = parseTurnGeneration(statusTurn);
+              const oldGen = parseTurnGeneration(expectedTurnId);
+              if (expectedTurnId === null || newGen !== null && (oldGen === null || newGen >= oldGen)) {
+                if (expectedTurnId && statusTurn !== expectedTurnId) {
+                  turnProgressSeen = false;
+                }
+                expectedTurnId = statusTurn;
+              }
+            }
+          } else if (queryStarted && statusState === "stopped") {
+            const stopTurn = frameTurnId(frame);
+            if (expectedTurnId && !turnIdsMatch(expectedTurnId, stopTurn)) continue;
+            this.lastTurnEndState = statusState;
             yield* this.drainStreamEventsAfterIdle(expectedLoopId);
             break;
-          } else if (queryStarted && state === "idle") {
-            if (!streamPayloadSeen && !this.lastTurnCancellationSeen) continue;
-            this.lastTurnEndState = state;
+          } else if (queryStarted && statusState === "idle") {
+            const idleTurn = frameTurnId(frame);
+            if (!isIdleTerminalAllowed({
+              expectedTurnId,
+              frameTurnId: idleTurn,
+              queryStarted,
+              turnProgressSeen,
+              cancellationSeen: this.lastTurnCancellationSeen
+            })) {
+              continue;
+            }
+            this.lastTurnEndState = statusState;
             yield* this.drainStreamEventsAfterIdle(expectedLoopId);
             break;
           }
@@ -4311,9 +4416,16 @@ var DaemonSession = class {
           continue;
         }
         if (mode === "custom" && isTurnEndCustomData(data)) {
-          if (!queryStarted || !turnProgressSeen) continue;
+          const dataTurn = frameTurnId(data) || evTurnId;
+          if (!isTurnTerminalAllowed({
+            expectedTurnId,
+            frameTurnId: dataTurn,
+            queryStarted,
+            turnProgressSeen
+          })) {
+            continue;
+          }
         }
-        streamPayloadSeen = true;
         if (isTurnProgressChunk(mode, data)) turnProgressSeen = true;
         yield [namespace, mode, data];
         if (mode === "custom" && isTurnEndCustomData(data)) {
@@ -4476,7 +4588,6 @@ var CardProjection = class {
   PROTO_VERSION,
   PooledConn,
   QueryGate,
-  REMOVED_INTENT_HINTS,
   ReconnectError,
   SSEBroadcaster,
   STREAM_END,
@@ -4514,15 +4625,20 @@ var CardProjection = class {
   fetchLoopHistory,
   fetchLoopMessages,
   fetchSkillsCatalog,
+  formatTurnId,
+  frameSeq,
+  frameTurnId,
   idleTimeoutForTurn,
   inboundNeedsDeliveryAck,
   inputMessageForLoop,
   isCompletionEvent,
   isDaemonLive,
   isDaemonTurnEndEvent,
+  isIdleTerminalAllowed,
   isSubagentProgressEvent,
   isTurnEndCustomData,
   isTurnProgressChunk,
+  isTurnTerminalAllowed,
   isValidVerbosityLevel,
   loadConfigFromEnv,
   newLoopInputMessage,
@@ -4532,6 +4648,7 @@ var CardProjection = class {
   notificationEnvelope,
   parseCardCustomPayload,
   parseNamespace,
+  parseTurnGeneration,
   pingEnvelope,
   pongEnvelope,
   protocol1Rpc,
@@ -4542,8 +4659,8 @@ var CardProjection = class {
   shouldShow,
   splitWirePayload,
   subscribeEnvelope,
+  turnIdsMatch,
   unsubscribeEnvelope,
-  validateLoopInputIntentHint,
   waitDaemonReady,
   waitLoopStatusWithID,
   waitSubscriptionConfirmed