@whittlelabs/sifter 0.9.0 → 0.10.0

package/bin.js

@@ -15450,10 +15450,11 @@ var require_client = __commonJS({
         if (options?.sort)
           params.set("sort", options.sort);
         const qs = params.toString();
-        const { jobs, total } = await this.request("GET", `/api/my/jobs${qs ? `?${qs}` : ""}`);
+        const { jobs, total, directives } = await this.request("GET", `/api/my/jobs${qs ? `?${qs}` : ""}`);
         return {
           data: jobs,
-          pagination: { total, limit: options?.limit ?? 25, offset: options?.offset ?? 0 }
+          pagination: { total, limit: options?.limit ?? 25, offset: options?.offset ?? 0 },
+          directives: directives ?? null
         };
       }
       // ── HTTP plumbing ────────────────────────────────────────────────
@@ -15547,11 +15548,22 @@ var require_subscribe = __commonJS({
           return;
         }
         try {
-          const { data } = await opts.jobsClient.listDispatchableJobs({
+          const { data, directives } = await opts.jobsClient.listDispatchableJobs({
             pools: resolvedPoolIds,
             limit: maxConcurrency - inflight,
             sort: "priority:desc,queued_at:asc"
           });
+          if (directives && Object.keys(directives).length > 0 && opts.onDirectives) {
+            try {
+              await opts.onDirectives(directives);
+            } catch (err) {
+              logger.error("onDirectives handler failed", {
+                error: err instanceof Error ? err.message : String(err)
+              });
+            }
+          }
+          if (stopped)
+            return;
           for (const job of data) {
             if (inflight >= maxConcurrency)
               break;
@@ -15644,6 +15656,78 @@ var require_dist2 = __commonJS({
   }
 });
 
+// ../../packages/shuttle/dist/lifecycle/self-update.js
+var require_self_update = __commonJS({
+  "../../packages/shuttle/dist/lifecycle/self-update.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.readUpgradeDirective = readUpgradeDirective;
+    exports2.performSelfUpdate = performSelfUpdate;
+    var child_process_1 = require("child_process");
+    var version_check_1 = require_version_check();
+    function readUpgradeDirective(directives, currentVersion, attemptedVersions) {
+      const raw = directives.upgrade;
+      if (!raw || typeof raw !== "object")
+        return null;
+      const requested = raw.requested_version;
+      if (typeof requested !== "string" || requested.length === 0)
+        return null;
+      if (attemptedVersions.has(requested))
+        return null;
+      if ((0, version_check_1.compareSemver)(currentVersion, requested) >= 0)
+        return null;
+      return {
+        requested_version: requested,
+        requested_at: raw.requested_at
+      };
+    }
+    async function performSelfUpdate(opts) {
+      const { packageName, directive, logger, hooks } = opts;
+      const spec = `${packageName}@${directive.requested_version}`;
+      const install = hooks.install ?? defaultInstall;
+      const respawn = hooks.respawn ?? defaultRespawn;
+      logger.info("upgrade directive received; draining claim loop", {
+        requestedVersion: directive.requested_version
+      });
+      await hooks.stopLoop();
+      try {
+        await install(spec);
+      } catch (err) {
+        logger.error("self-update install failed; resuming on the current version", {
+          packageSpec: spec,
+          error: err instanceof Error ? err.message : String(err)
+        });
+        await hooks.restartLoop();
+        return false;
+      }
+      logger.info("self-update installed; restarting", { packageSpec: spec });
+      respawn();
+      return true;
+    }
+    function defaultInstall(packageSpec) {
+      return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)("npm", ["install", "-g", packageSpec], {
+          stdio: ["ignore", "pipe", "pipe"]
+        });
+        let output = "";
+        child.stdout.on("data", (chunk) => output += chunk.toString());
+        child.stderr.on("data", (chunk) => output += chunk.toString());
+        child.on("error", reject);
+        child.on("exit", (code) => {
+          if (code === 0)
+            resolve();
+          else
+            reject(new Error(`npm install -g exited ${code}: ${output.trim().slice(-500)}`));
+        });
+      });
+    }
+    function defaultRespawn() {
+      const child = (0, child_process_1.spawn)(process.execPath, process.argv.slice(1), { stdio: "inherit" });
+      child.on("exit", (code) => process.exit(code ?? 0));
+    }
+  }
+});
+
 // ../../packages/loom/dist/runtime/prompt-execution.js
 var require_prompt_execution = __commonJS({
   "../../packages/loom/dist/runtime/prompt-execution.js"(exports2) {
@@ -20551,7 +20635,9 @@ var require_shuttle = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.Shuttle = void 0;
+    var os_1 = require("os");
     var jobs_1 = require_dist2();
+    var self_update_1 = require_self_update();
     var loom_1 = require_dist3();
     var chain_1 = require_chain();
     var keep_1 = require_dist4();
@@ -20691,6 +20777,13 @@ var require_shuttle = __commonJS({
           return { status: "completed", outputs };
         };
         const pools = this.config.pools.map((p) => p.id ? { id: p.id } : { name: p.name });
+        const subscribeLogger = {
+          debug: (msg, meta) => logger.debug(msg, meta),
+          info: (msg, meta) => logger.info(msg, meta),
+          warn: (msg, meta) => logger.warn(msg, meta),
+          error: (msg, meta) => logger.error(msg, meta)
+        };
+        const attemptedUpgrades = /* @__PURE__ */ new Set();
         this.subscription = (0, jobs_1.subscribe)({
           jobsClient,
           pools,
@@ -20699,15 +20792,32 @@ var require_shuttle = __commonJS({
             identityId: this.config.agent.identityId,
             intelligence: "digital",
             displayName: this.config.agent.displayName,
-            metadata: this.config.agent.metadata
+            // Self-reported build facts, refreshed on every registration.
+            // Products read these off the pool-member row (Sift's settings
+            // page shows the version and offers the upgrade action).
+            metadata: {
+              ...this.config.agent.metadata,
+              client_version: this.brand.product.version,
+              hostname: (0, os_1.hostname)()
+            }
           },
           onJob,
-          logger: {
-            debug: (msg, meta) => logger.debug(msg, meta),
-            info: (msg, meta) => logger.info(msg, meta),
-            warn: (msg, meta) => logger.warn(msg, meta),
-            error: (msg, meta) => logger.error(msg, meta)
+          onDirectives: async (directives) => {
+            const directive = (0, self_update_1.readUpgradeDirective)(directives, this.brand.product.version, attemptedUpgrades);
+            if (!directive)
+              return;
+            attemptedUpgrades.add(directive.requested_version);
+            await (0, self_update_1.performSelfUpdate)({
+              packageName: this.brand.product.packageName,
+              directive,
+              logger: subscribeLogger,
+              hooks: {
+                stopLoop: () => this.subscription?.stop() ?? Promise.resolve(),
+                restartLoop: () => this.subscription?.start() ?? Promise.resolve()
+              }
+            });
           },
+          logger: subscribeLogger,
           pollIntervalMs: this.config.polling.intervalMs,
           maxConcurrency: this.config.concurrency.maxJobs
         });
@@ -21304,7 +21414,7 @@ var import_shuttle = __toESM(require_dist5());
 // package.json
 var package_default = {
   name: "@whittlelabs/sifter",
-  version: "0.9.0",
+  version: "0.10.0",
   description: "Whittle Sifter: paired AI reviewer for Whittle Sift job pools.",
   bin: {
     "whittle-sifter": "./dist/bin.js"