@mirasoth/soothe-client 0.4.0 → 0.4.1

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.4.1";
   }
 });
 
@@ -895,7 +895,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 +903,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 +1025,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 +1060,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 +1095,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 +1136,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 +1185,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 +1380,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 +1406,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 +1566,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 +1605,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 +1700,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 +1795,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 +1830,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 +1932,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) {
@@ -2180,6 +2272,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;