@mirasoth/soothe-client 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -51,7 +51,7 @@ var init_errors = __esm({
       }
     };
     DaemonError = class extends Error {
-      /** Numeric error code from the RFC-450 §7.3 registry. */
+      /** Numeric error code from the daemon error registry. */
       code;
       /** The daemon's error message text. */
       daemonMessage;
@@ -357,7 +357,7 @@ var init_protocol = __esm({
     import_node_crypto = require("crypto");
     PROTO_VERSION = "1";
     DEFAULT_CLIENT_CAPABILITIES = ["streaming", "batch", "heartbeat", "receipts"];
-    CLIENT_VERSION = "0.4.0";
+    CLIENT_VERSION = "0.5.0";
   }
 });
 
@@ -484,19 +484,22 @@ function isSubagentProgressEvent(eventType) {
   }
   return parsed.action === "started" || parsed.action === "completed";
 }
-var EventPlanCreated, EventExploreStarted, EventExploreMilestone, EventExploreStepCompleted, EventExploreCompleted, EventTacitusStarted, EventTacitusGatherSummary, EventTacitusCompleted, EventReplayComplete, EventLoopReattachedWire, EventCardReplayBegin, EventCardCreated, EventCardReplayEnd, EventToolStarted, EventToolCompleted, EventToolError, EventStreamToolCallUpdate, EventToolCallUpdatesBatch, EventStrangeLoopStarted, EventStrangeLoopCompleted, EventStrangeLoopPlanDecision, EventStrangeLoopReasoned, EventStrangeLoopStepStarted, EventStrangeLoopStepQueued, EventStrangeLoopStepCompleted, EventStrangeLoopContextCompacted, EventMessageReceived, EventMessageSent, EventFinalReport, EventAutopilotGoalStatus, EventAutopilotGoalProgress, EventAutopilotGoalCreated, EventAutopilotGoalCompleted, EventAutopilotWorkerAssigned, EventAutopilotWorkerUnassigned, EventGeneralFailed;
+var EventPlanCreated, EventExplorerStarted, EventExplorerMilestone, EventExplorerStepCompleted, EventExplorerCompleted, EventDeepResearchStarted, EventDeepResearchProgress, EventDeepResearchStepCompleted, EventDeepResearchGatherSummary, EventDeepResearchCrawlSummary, EventDeepResearchCompleted, EventReplayComplete, EventLoopReattachedWire, EventCardReplayBegin, EventCardCreated, EventCardReplayEnd, EventToolStarted, EventToolCompleted, EventToolError, EventStreamToolCallUpdate, EventToolCallUpdatesBatch, EventStrangeLoopStarted, EventStrangeLoopCompleted, EventStrangeLoopPlanDecision, EventStrangeLoopReasoned, EventStrangeLoopStepStarted, EventStrangeLoopStepQueued, EventStrangeLoopStepCompleted, EventStrangeLoopContextCompacted, EventMessageReceived, EventMessageSent, EventFinalReport, EventAutopilotGoalStatus, EventAutopilotGoalProgress, EventAutopilotGoalCreated, EventAutopilotGoalCompleted, EventAutopilotWorkerAssigned, EventAutopilotWorkerUnassigned, EventGeneralFailed;
 var init_events = __esm({
   "src/events.ts"() {
     "use strict";
     init_verbosity();
     EventPlanCreated = "soothe.cognition.plan.created";
-    EventExploreStarted = "soothe.subagent.explore.started";
-    EventExploreMilestone = "soothe.subagent.explore.milestone";
-    EventExploreStepCompleted = "soothe.subagent.explore.step.completed";
-    EventExploreCompleted = "soothe.subagent.explore.completed";
-    EventTacitusStarted = "soothe.subagent.tacitus.started";
-    EventTacitusGatherSummary = "soothe.subagent.tacitus.gather.summary";
-    EventTacitusCompleted = "soothe.subagent.tacitus.completed";
+    EventExplorerStarted = "soothe.subagent.explorer.started";
+    EventExplorerMilestone = "soothe.subagent.explorer.milestone";
+    EventExplorerStepCompleted = "soothe.subagent.explorer.step.completed";
+    EventExplorerCompleted = "soothe.subagent.explorer.completed";
+    EventDeepResearchStarted = "soothe.subagent.deep_research.started";
+    EventDeepResearchProgress = "soothe.subagent.deep_research.progress";
+    EventDeepResearchStepCompleted = "soothe.subagent.deep_research.step.completed";
+    EventDeepResearchGatherSummary = "soothe.subagent.deep_research.gather.summary";
+    EventDeepResearchCrawlSummary = "soothe.subagent.deep_research.crawl.summary";
+    EventDeepResearchCompleted = "soothe.subagent.deep_research.completed";
     EventReplayComplete = "replay_complete";
     EventLoopReattachedWire = "loop_reattached";
     EventCardReplayBegin = "card.replay_begin";
@@ -895,7 +898,7 @@ var init_client = __esm({
       inboundDroppedCount = 0;
       onStreamDegraded = null;
       resolvers = [];
-      // Protocol-1 handshake state (RFC-450 §8.2)
+      // Protocol-1 handshake state
       handshakeComplete = false;
       negotiatedCapabilities = /* @__PURE__ */ new Set();
       protocolVersion = null;
@@ -903,12 +906,12 @@ var init_client = __esm({
       heartbeatIntervalMs = 0;
       heartbeatTimer = null;
       lastPongMonotonic = 0;
-      // Mid-session drop signal (RFC-450 §8.3). The 'disconnected' event is
+      // Mid-session drop signal. The 'disconnected' event is
       // emitted exactly once when the connection drops, carrying a DisconnectCause
       // that distinguishes clean (peer `disconnect`) from unclean (read/write
       // error or missed pong). `disconnFired` guards the once-only delivery.
       disconnFired = false;
-      // Pending-request/subscription multiplexer (RFC-629 constraint #1). Routes
+      // Pending-request/subscription multiplexer. Routes
       // inbound frames by (type, id) instead of discarding non-matching events.
       mux = new Multiplexer();
       deliveryRecvSeq = /* @__PURE__ */ new Map();
@@ -1025,7 +1028,7 @@ var init_client = __esm({
         return this.ws !== null && this.ws.readyState === import_ws.default.OPEN && this.handshakeComplete;
       }
       // ---------------------------------------------------------------------------
-      // Mid-session drop signal + reconnect/reattach (RFC-450 §8.3, RFC-629 L0)
+      // Mid-session drop signal + reconnect/reattach
       // ---------------------------------------------------------------------------
       /**
        * Returns whether the connection has dropped (the `'disconnected'` event has
@@ -1060,8 +1063,8 @@ var init_client = __esm({
         }
       }
       /**
-       * Re-dials the daemon and re-handshakes after a connection drop (RFC-450
-       * §8.3). Does not re-establish loop subscriptions; follow with
+       * Re-dials the daemon and re-handshakes after a connection drop.
+       * Does not re-establish loop subscriptions; follow with
        * `reattachAndProbe()` to resume a loop session. The caller should invoke
        * this after the `'disconnected'` event fires. Reuses the same Client,
        * resetting the drop signal and multiplexer.
@@ -1095,7 +1098,7 @@ var init_client = __esm({
        * Returns a `StaleLoopError` when the probe fails; callers should fall back
        * to a fresh `loop_new` bootstrap.
        *
-       * Per RFC-629: connection-level readiness is the handshake's readiness_state
+       * Note: connection-level readiness is the handshake's readiness_state
        * (+ daemon_status); loop_get is a loop-scoped probe only, not a readiness
        * probe.
        */
@@ -1136,7 +1139,7 @@ var init_client = __esm({
         }
       }
       // ---------------------------------------------------------------------------
-      // Protocol-1 handshake (RFC-450 §8.2)
+      // Protocol-1 handshake
       // ---------------------------------------------------------------------------
       /** Send connection_init and wait for connection_ack with readiness "ready". */
       async _performHandshake() {
@@ -1185,7 +1188,7 @@ var init_client = __esm({
         throw new Error(`timeout after ${this.config.daemonReadyTimeout}ms waiting for connection_ack`);
       }
       // ---------------------------------------------------------------------------
-      // Heartbeat (RFC-450 §8.3)
+      // Heartbeat
       // ---------------------------------------------------------------------------
       _startHeartbeat() {
         if (!this.negotiatedCapabilities.has("heartbeat")) return;
@@ -1380,7 +1383,7 @@ var init_client = __esm({
         }
       }
       // ---------------------------------------------------------------------------
-      // Protocol-1 RPC primitives (RFC-450 §5/§9)
+      // Protocol-1 RPC primitives
       // ---------------------------------------------------------------------------
       /**
        * Reads the next frame directly from the live socket (via a resolver),
@@ -1406,16 +1409,16 @@ var init_client = __esm({
         });
       }
       /**
-       * Sends a `request` envelope and waits for the matching `response` (or
-       * `error`) correlated by `id` (RFC-450 §5/§9). Returns the `result` object.
-       *
-       * Multiplexer-aware (RFC-629 constraint #1): registers a pending RPC wait
-       * keyed by the request id so that, even when a `receiveMessages()` reader
-       * is concurrently active, the matching `response`/`error` is routed to
-       * this caller instead of being discarded or buffered behind a stream.
-       * Non-matching frames are routed to their own waiters by the multiplexer
-       * or flow on to the resolver queue for stream readers.
-       */
+        * Sends a `request` envelope and waits for the matching `response` (or
+      * `error`) correlated by `id`. Returns the `result` object.
+        *
+      * Multiplexer-aware: registers a pending RPC wait
+        * keyed by the request id so that, even when a `receiveMessages()` reader
+        * is concurrently active, the matching `response`/`error` is routed to
+        * this caller instead of being discarded or buffered behind a stream.
+        * Non-matching frames are routed to their own waiters by the multiplexer
+        * or flow on to the resolver queue for stream readers.
+        */
       async requestResponse(method, params, responseType, timeout = 15e3) {
         const req = requestEnvelope(method, params);
         const rid = req.id;
@@ -1566,7 +1569,7 @@ var init_client = __esm({
         return ev;
       }
       // ---------------------------------------------------------------------------
-      // High-level API methods (Loop-first, RFC-503)
+      // High-level API methods
       // ---------------------------------------------------------------------------
       /** Sends user input to the daemon (loop_input notification; requires loopID). */
       sendInput(text, options) {
@@ -1605,7 +1608,7 @@ var init_client = __esm({
         return this.notify("slash_command", { cmd });
       }
       // ---------------------------------------------------------------------------
-      // Loop lifecycle methods (RFC-503)
+      // Loop lifecycle methods
       // ---------------------------------------------------------------------------
       /** Requests the daemon to create a new StrangeLoop and waits for the response. */
       sendLoopNew(opts) {
@@ -1700,7 +1703,7 @@ var init_client = __esm({
       sendLoopCardsFetch(loopID) {
         return this.sendMessage(requestEnvelope("loop_cards_fetch", { loop_id: loopID }));
       }
-      /** Requests the full loop history (RFC-631). */
+      /** Requests the full loop history. */
       sendLoopHistoryFetch(loopID) {
         return this.sendMessage(requestEnvelope("loop_history_fetch", { loop_id: loopID }));
       }
@@ -1795,7 +1798,7 @@ var init_client = __esm({
         );
       }
       // ---------------------------------------------------------------------------
-      // RFC-228 Job IPC methods
+      // Job IPC methods
       // ---------------------------------------------------------------------------
       /** Creates an autopilot job and waits for the response. */
       createJob(goal, verificationRules, workspace, timeout) {
@@ -1830,6 +1833,98 @@ var init_client = __esm({
         if (goalId) params.goal_id = goalId;
         return this.requestResponse("job_guidance", params, "job_guidance", timeout ?? 3e4);
       }
+      // ---------------------------------------------------------------------------
+      // Autopilot goal RPCs (protocol-1 request methods)
+      // ---------------------------------------------------------------------------
+      /** Return autopilot scheduler status (running / dreaming / pool). */
+      autopilotStatus(timeout) {
+        return this.requestResponse("autopilot_status", {}, "autopilot_status", timeout ?? 15e3);
+      }
+      /** Submit a new autopilot goal (returns goal_id). */
+      autopilotSubmit(description, opts) {
+        const params = {
+          description,
+          priority: opts?.priority ?? 50
+        };
+        if (opts?.workspace) params.workspace = opts.workspace;
+        return this.requestResponse(
+          "autopilot_submit",
+          params,
+          "autopilot_submit",
+          opts?.timeout ?? 15e3
+        );
+      }
+      /** List all goals (including non-root children). */
+      autopilotListGoals(timeout) {
+        return this.requestResponse(
+          "autopilot_list_goals",
+          {},
+          "autopilot_list_goals",
+          timeout ?? 15e3
+        );
+      }
+      /** Fetch one goal by id. */
+      autopilotGetGoal(goalId, timeout) {
+        return this.requestResponse(
+          "autopilot_get_goal",
+          { goal_id: goalId },
+          "autopilot_get_goal",
+          timeout ?? 15e3
+        );
+      }
+      /** Cancel a goal and its non-terminal descendants. */
+      autopilotCancelGoal(goalId, timeout) {
+        return this.requestResponse(
+          "autopilot_cancel_goal",
+          { goal_id: goalId },
+          "autopilot_cancel_goal",
+          timeout ?? 15e3
+        );
+      }
+      /** Cancel every open (non-terminal) goal. */
+      autopilotCancelAll(timeout) {
+        return this.requestResponse(
+          "autopilot_cancel_all",
+          {},
+          "autopilot_cancel_all",
+          timeout ?? 15e3
+        );
+      }
+      /** Exit dreaming mode and resume scheduling. */
+      autopilotWake(timeout) {
+        return this.requestResponse("autopilot_wake", {}, "autopilot_wake", timeout ?? 15e3);
+      }
+      /** Force dreaming mode. */
+      autopilotDream(timeout) {
+        return this.requestResponse("autopilot_dream", {}, "autopilot_dream", timeout ?? 15e3);
+      }
+      /** Resume a suspended or blocked goal. */
+      autopilotResume(goalId, timeout) {
+        return this.requestResponse(
+          "autopilot_resume",
+          { goal_id: goalId },
+          "autopilot_resume",
+          timeout ?? 15e3
+        );
+      }
+      /** List root goals only (jobs). Prefer createJob / getJobStatus for job control. */
+      autopilotListJobs(timeout) {
+        return this.requestResponse(
+          "autopilot_list_jobs",
+          {},
+          "autopilot_list_jobs",
+          timeout ?? 15e3
+        );
+      }
+      /** Get a root job with DAG snapshot. Prefer getJobStatus / getJobDag. */
+      autopilotGetJob(jobId, timeout) {
+        return this.requestResponse(
+          "autopilot_get_job",
+          { job_id: jobId },
+          "autopilot_get_job",
+          timeout ?? 15e3
+        );
+      }
       /** Subscribes to autopilot worker events. */
       autopilotSubscribe(timeout) {
         return this.subscribe("autopilot_events", {}, timeout ?? 15e3);
@@ -1840,7 +1935,7 @@ var init_client = __esm({
         return this._requestResponseForEnvelope(req, "autopilot_unsubscribe", timeout ?? 15e3);
       }
       // ---------------------------------------------------------------------------
-      // RFC-229 Cron IPC methods
+      // Cron IPC methods
       // ---------------------------------------------------------------------------
       /** Creates a scheduled job from natural language. */
       cronAdd(text, priority, timeout) {
@@ -1928,10 +2023,16 @@ __export(index_exports, {
   EventCardReplayBegin: () => EventCardReplayBegin,
   EventCardReplayEnd: () => EventCardReplayEnd,
   EventClassifier: () => EventClassifier,
-  EventExploreCompleted: () => EventExploreCompleted,
-  EventExploreMilestone: () => EventExploreMilestone,
-  EventExploreStarted: () => EventExploreStarted,
-  EventExploreStepCompleted: () => EventExploreStepCompleted,
+  EventDeepResearchCompleted: () => EventDeepResearchCompleted,
+  EventDeepResearchCrawlSummary: () => EventDeepResearchCrawlSummary,
+  EventDeepResearchGatherSummary: () => EventDeepResearchGatherSummary,
+  EventDeepResearchProgress: () => EventDeepResearchProgress,
+  EventDeepResearchStarted: () => EventDeepResearchStarted,
+  EventDeepResearchStepCompleted: () => EventDeepResearchStepCompleted,
+  EventExplorerCompleted: () => EventExplorerCompleted,
+  EventExplorerMilestone: () => EventExplorerMilestone,
+  EventExplorerStarted: () => EventExplorerStarted,
+  EventExplorerStepCompleted: () => EventExplorerStepCompleted,
   EventFinalReport: () => EventFinalReport,
   EventGeneralFailed: () => EventGeneralFailed,
   EventLoopReattachedWire: () => EventLoopReattachedWire,
@@ -1948,9 +2049,6 @@ __export(index_exports, {
   EventStrangeLoopStepQueued: () => EventStrangeLoopStepQueued,
   EventStrangeLoopStepStarted: () => EventStrangeLoopStepStarted,
   EventStreamToolCallUpdate: () => EventStreamToolCallUpdate,
-  EventTacitusCompleted: () => EventTacitusCompleted,
-  EventTacitusGatherSummary: () => EventTacitusGatherSummary,
-  EventTacitusStarted: () => EventTacitusStarted,
   EventToolCallUpdatesBatch: () => EventToolCallUpdatesBatch,
   EventToolCompleted: () => EventToolCompleted,
   EventToolError: () => EventToolError,
@@ -2180,6 +2278,55 @@ var CommandClient = class {
   async jobCancel(jobId) {
     return this.request("job_cancel", { job_id: jobId });
   }
+  /** Return autopilot scheduler status (running / dreaming / pool). */
+  async autopilotStatus() {
+    return this.request("autopilot_status");
+  }
+  /** Submit a new autopilot goal (returns goal_id). */
+  async autopilotSubmit(description, opts) {
+    const params = {
+      description,
+      priority: opts?.priority ?? 50
+    };
+    if (opts?.workspace) params.workspace = opts.workspace;
+    return this.request("autopilot_submit", params);
+  }
+  /** List all goals (including non-root children). */
+  async autopilotListGoals() {
+    return this.request("autopilot_list_goals");
+  }
+  /** Fetch one goal by id. */
+  async autopilotGetGoal(goalId) {
+    return this.request("autopilot_get_goal", { goal_id: goalId });
+  }
+  /** Cancel a goal and its non-terminal descendants. */
+  async autopilotCancelGoal(goalId) {
+    return this.request("autopilot_cancel_goal", { goal_id: goalId });
+  }
+  /** Cancel every open (non-terminal) goal. */
+  async autopilotCancelAll() {
+    return this.request("autopilot_cancel_all");
+  }
+  /** Exit dreaming mode and resume scheduling. */
+  async autopilotWake() {
+    return this.request("autopilot_wake");
+  }
+  /** Force dreaming mode. */
+  async autopilotDream() {
+    return this.request("autopilot_dream");
+  }
+  /** Resume a suspended or blocked goal. */
+  async autopilotResume(goalId) {
+    return this.request("autopilot_resume", { goal_id: goalId });
+  }
+  /** List root goals only (jobs). Prefer job* for job control. */
+  async autopilotListJobs() {
+    return this.request("autopilot_list_jobs");
+  }
+  /** Get a root job with DAG snapshot. Prefer jobStatus / getJobDag. */
+  async autopilotGetJob(jobId) {
+    return this.request("autopilot_get_job", { job_id: jobId });
+  }
   async cronAdd(text, priority = 0) {
     const params = { text };
     if (priority > 0) params.priority = priority;
@@ -4116,10 +4263,16 @@ var DaemonSession = class {
   EventCardReplayBegin,
   EventCardReplayEnd,
   EventClassifier,
-  EventExploreCompleted,
-  EventExploreMilestone,
-  EventExploreStarted,
-  EventExploreStepCompleted,
+  EventDeepResearchCompleted,
+  EventDeepResearchCrawlSummary,
+  EventDeepResearchGatherSummary,
+  EventDeepResearchProgress,
+  EventDeepResearchStarted,
+  EventDeepResearchStepCompleted,
+  EventExplorerCompleted,
+  EventExplorerMilestone,
+  EventExplorerStarted,
+  EventExplorerStepCompleted,
   EventFinalReport,
   EventGeneralFailed,
   EventLoopReattachedWire,
@@ -4136,9 +4289,6 @@ var DaemonSession = class {
   EventStrangeLoopStepQueued,
   EventStrangeLoopStepStarted,
   EventStreamToolCallUpdate,
-  EventTacitusCompleted,
-  EventTacitusGatherSummary,
-  EventTacitusStarted,
   EventToolCallUpdatesBatch,
   EventToolCompleted,
   EventToolError,