@northflare/runner 0.0.26 → 0.0.27

package/dist/utils/update-coordinator.js

@@ -0,0 +1,159 @@
+/**
+ * Coordinates runner auto-updates.
+ *
+ * When the server sends an expectedRunnerVersion that is newer than the current
+ * version, the coordinator notes the pending update and waits for the runner to
+ * become idle (no active conversations) before executing the update.
+ *
+ * The update is performed by spawning a new process with npx, which ensures
+ * the latest version is fetched and executed with the same arguments/env.
+ */
+import { spawn } from "child_process";
+import { logger } from "./logger.js";
+import { RUNNER_VERSION, isNewerVersion } from "./version.js";
+export class UpdateCoordinator {
+    state = "idle";
+    pendingVersion = null;
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    get currentState() {
+        return this.state;
+    }
+    get hasPendingUpdate() {
+        return this.state === "pending";
+    }
+    get pendingVersionNumber() {
+        return this.pendingVersion;
+    }
+    /**
+     * Called when a message is received with an expectedRunnerVersion.
+     * If the version is newer, marks an update as pending.
+     * If the runner is already idle, triggers the update immediately.
+     *
+     * @returns true if an update was triggered or marked as pending
+     */
+    async checkVersion(serverVersion) {
+        if (this.options.autoUpdateDisabled) {
+            logger.debug("Auto-update disabled via NORTHFLARE_DISABLE_AUTO_UPDATE");
+            return false;
+        }
+        // Already handling an update
+        if (this.state !== "idle" && this.state !== "pending") {
+            logger.debug("Update already in progress", { state: this.state });
+            return false;
+        }
+        // Check if server version is newer
+        if (!isNewerVersion(serverVersion, RUNNER_VERSION)) {
+            return false;
+        }
+        // Already have this version pending
+        if (this.pendingVersion === serverVersion) {
+            return false;
+        }
+        // Mark update as pending
+        this.pendingVersion = serverVersion;
+        this.state = "pending";
+        logger.info(`Update available: ${serverVersion} (current: ${RUNNER_VERSION}). ` +
+            `Will update when idle.`);
+        // If already idle, update now
+        if (this.options.getActiveConversationCount() === 0) {
+            await this.executeUpdate();
+            return true;
+        }
+        logger.info(`${this.options.getActiveConversationCount()} active conversation(s). ` +
+            `Update will proceed when all complete.`);
+        return true;
+    }
+    /**
+     * Called when a conversation ends. If there's a pending update and the
+     * runner is now idle, triggers the update.
+     */
+    async onConversationEnd() {
+        if (this.state !== "pending" || !this.pendingVersion) {
+            return;
+        }
+        const activeCount = this.options.getActiveConversationCount();
+        if (activeCount > 0) {
+            logger.debug(`Conversation ended, but ${activeCount} still active. ` +
+                `Waiting for idle before update.`);
+            return;
+        }
+        logger.info("Runner now idle, proceeding with pending update");
+        await this.executeUpdate();
+    }
+    /**
+     * Executes the update by spawning a new runner process and exiting.
+     */
+    async executeUpdate() {
+        if (!this.pendingVersion) {
+            logger.error("executeUpdate called but no pending version");
+            return;
+        }
+        this.state = "updating";
+        logger.info(`Installing @northflare/runner@${this.pendingVersion}...`);
+        try {
+            // Save state before restart so we don't lose lastProcessedAt, etc.
+            await this.options.saveState();
+            logger.debug("State saved before update");
+        }
+        catch (error) {
+            logger.error("Failed to save state before update:", error);
+            // Continue anyway - better to update than to stay on old version
+        }
+        // Build the npx command
+        // Using -y to auto-confirm and specifying the exact version
+        const npxCommand = "npx";
+        const npxArgs = [
+            "-y",
+            `@northflare/runner@${this.pendingVersion}`,
+            ...this.buildRestartArgs(),
+        ];
+        logger.info(`Restarting with: ${npxCommand} ${npxArgs.join(" ")}`);
+        this.state = "restarting";
+        // Spawn new process detached so it survives our exit
+        const child = spawn(npxCommand, npxArgs, {
+            detached: true,
+            stdio: "inherit",
+            env: process.env,
+            shell: true,
+        });
+        // Prevent parent from waiting for child
+        child.unref();
+        // Handle spawn errors
+        child.on("error", (error) => {
+            logger.error("Failed to spawn update process:", error);
+            // Reset state so we can try again
+            this.state = "pending";
+        });
+        // Give the new process a moment to start before we exit
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // Exit current process
+        logger.info("Exiting for update...");
+        process.exit(0);
+    }
+    /**
+     * Builds the command-line arguments for the restarted runner.
+     * Most config is passed via environment variables which are inherited.
+     */
+    buildRestartArgs() {
+        const args = [];
+        // Add start command explicitly
+        args.push("start");
+        // Config path if provided
+        const configPath = this.options.getConfigPath();
+        if (configPath) {
+            args.push("--config", configPath);
+        }
+        // Other options are passed via inherited env vars:
+        // - NORTHFLARE_RUNNER_TOKEN
+        // - NORTHFLARE_WORKSPACE_PATH
+        // - NORTHFLARE_DATA_DIR
+        // - NORTHFLARE_RUNNER_DEBUG
+        // - NORTHFLARE_RUNNER_INACTIVITY_TIMEOUT
+        // - NORTHFLARE_ORCHESTRATOR_URL
+        return args;
+    }
+}
+//# sourceMappingURL=update-coordinator.js.map

package/dist/utils/update-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-coordinator.js","sourceRoot":"","sources":["../../src/utils/update-coordinator.ts"],"names":[],"mappings":"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"}

package/dist/utils/version.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Version utilities for runner auto-update
+ */
+export declare const RUNNER_VERSION: string;
+/**
+ * Compare two semver versions.
+ * Returns true if serverVersion is newer than currentVersion.
+ */
+export declare function isNewerVersion(serverVersion: string, currentVersion: string): boolean;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,eAAO,MAAM,cAAc,EAAE,MAAoB,CAAC;AAElD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAoBrF"}

package/dist/utils/version.js

@@ -0,0 +1,33 @@
+/**
+ * Version utilities for runner auto-update
+ */
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+const pkg = require("../../package.json");
+export const RUNNER_VERSION = pkg.version;
+/**
+ * Compare two semver versions.
+ * Returns true if serverVersion is newer than currentVersion.
+ */
+export function isNewerVersion(serverVersion, currentVersion) {
+    const parse = (v) => {
+        // Handle versions like "0.0.26" or "1.2.3-beta.1"
+        const match = v.match(/^(\d+)\.(\d+)\.(\d+)/);
+        if (!match) {
+            return [0, 0, 0];
+        }
+        return [
+            parseInt(match[1], 10),
+            parseInt(match[2], 10),
+            parseInt(match[3], 10),
+        ];
+    };
+    const [sMajor, sMinor, sPatch] = parse(serverVersion);
+    const [cMajor, cMinor, cPatch] = parse(currentVersion);
+    if (sMajor !== cMajor)
+        return sMajor > cMajor;
+    if (sMinor !== cMinor)
+        return sMinor > cMinor;
+    return sPatch > cPatch;
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAW,GAAG,CAAC,OAAO,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,aAAqB,EAAE,cAAsB;IAC1E,MAAM,KAAK,GAAG,CAAC,CAAS,EAA4B,EAAE;QACpD,kDAAkD;QAClD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,OAAO;YACL,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;YACvB,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;YACvB,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;SACxB,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IAEvD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,GAAG,MAAM,CAAC;IAC9C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,GAAG,MAAM,CAAC;IAC9C,OAAO,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@northflare/runner",
-  "version": "0.0.26",
+  "version": "0.0.27",
   "description": "Distributed conversation runner for Northflare",
   "license": "MIT",
   "type": "module",
@@ -12,7 +12,7 @@
     "@anthropic-ai/claude-agent-sdk": "0.1.51",
     "@botanicastudios/claude-code-sdk-ts": "0.2.22-fork",
     "@botanicastudios/mcp-host-rpc": "^0.4.0",
-    "@openai/codex-sdk": "^0.71.0",
+    "@openai/codex-sdk": "^0.77.0",
     "@openrouter/ai-sdk-provider": "^1.2.8",
     "@tanstack/react-query": "^5.x.x",
     "@types/jsonwebtoken": "^9.0.10",
@@ -27,8 +27,8 @@
     "simple-git": "^3.x.x",
     "winston": "^3.x.x",
     "zod": "^3.25.8",
-    "@northflare/codex-sdk": "0.1.0",
-    "@northflare/agent": "0.1.3"
+    "@northflare/agent": "0.1.3",
+    "@northflare/codex-sdk": "0.1.0"
   },
   "devDependencies": {
     "@types/eventsource": "^1.1.15",