@zerox1/sdk 0.1.24 → 0.1.26

package/dist/index.d.ts

@@ -85,6 +85,9 @@ export declare class Zerox1Agent {
      * Safe to await — resolves once the agent is live on the mesh.
      */
     start(): Promise<void>;
+    /** Fetch /version from the aggregator and warn if this SDK is outdated. */
+    private _checkVersion;
+    private _isNewer;
     /**
      * Disconnect from the mesh and stop the node process.
      */

package/dist/index.js

@@ -199,9 +199,37 @@ class Zerox1Agent {
         });
         // Wait until the HTTP server is accepting connections.
         await waitForReady(this.port);
+        // Fire-and-forget version check: warn if a newer SDK is available.
+        this._checkVersion().catch(() => { });
         // Open the inbox WebSocket.
         this._connectInbox();
     }
+    /** Fetch /version from the aggregator and warn if this SDK is outdated. */
+    async _checkVersion() {
+        const AGGREGATOR = 'https://aggregator.0x01.world';
+        const CURRENT = '0.1.23'; // updated by the release workflow
+        try {
+            const res = await fetch(`${AGGREGATOR}/version`, { signal: AbortSignal.timeout(4000) });
+            if (!res.ok)
+                return;
+            const { sdk } = await res.json();
+            if (sdk && sdk !== CURRENT && this._isNewer(sdk, CURRENT)) {
+                process.stderr.write(`\n⚠️  [zerox1] SDK update available: ${CURRENT} → ${sdk}\n` +
+                    `   Run: npm install @zerox1/sdk@latest\n\n`);
+            }
+        }
+        catch { /* network unavailable — silently skip */ }
+    }
+    _isNewer(latest, current) {
+        const parse = (v) => v.split('.').map(Number);
+        const [lM, lm, lp] = parse(latest);
+        const [cM, cm, cp] = parse(current);
+        if (lM !== cM)
+            return lM > cM;
+        if (lm !== cm)
+            return lm > cm;
+        return lp > cp;
+    }
     /**
      * Disconnect from the mesh and stop the node process.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "0x01 mesh agent SDK — zero-config, binary bundled, works on every platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,10 +12,10 @@
     "ws": "^8.18.0"
   },
   "optionalDependencies": {
-    "@zerox1/sdk-darwin-arm64": "0.1.24",
-    "@zerox1/sdk-darwin-x64": "0.1.24",
-    "@zerox1/sdk-linux-x64": "0.1.24",
-    "@zerox1/sdk-win32-x64": "0.1.24"
+    "@zerox1/sdk-darwin-arm64": "0.1.26",
+    "@zerox1/sdk-darwin-x64": "0.1.26",
+    "@zerox1/sdk-linux-x64": "0.1.26",
+    "@zerox1/sdk-win32-x64": "0.1.26"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/packages/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk-darwin-arm64",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "zerox1-node binary for macOS ARM64 (Apple Silicon)",
   "os": [
     "darwin"

package/packages/darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk-darwin-x64",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "zerox1-node binary for macOS x64 (Intel)",
   "os": [
     "darwin"

package/packages/linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk-linux-x64",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "zerox1-node binary for Linux x64",
   "os": [
     "linux"

package/packages/win32-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerox1/sdk-win32-x64",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "zerox1-node binary for Windows x64",
   "os": [
     "win32"

package/src/index.ts

@@ -275,10 +275,38 @@ export class Zerox1Agent {
     // Wait until the HTTP server is accepting connections.
     await waitForReady(this.port)
 
+    // Fire-and-forget version check: warn if a newer SDK is available.
+    this._checkVersion().catch(() => { /* never block the agent */ })
+
     // Open the inbox WebSocket.
     this._connectInbox()
   }
 
+  /** Fetch /version from the aggregator and warn if this SDK is outdated. */
+  private async _checkVersion(): Promise<void> {
+    const AGGREGATOR = 'https://aggregator.0x01.world'
+    const CURRENT = '0.1.23' // updated by the release workflow
+    try {
+      const res = await fetch(`${AGGREGATOR}/version`, { signal: AbortSignal.timeout(4_000) })
+      if (!res.ok) return
+      const { sdk } = await res.json() as { sdk: string }
+      if (sdk && sdk !== CURRENT && this._isNewer(sdk, CURRENT)) {
+        process.stderr.write(
+          `\n⚠️  [zerox1] SDK update available: ${CURRENT} → ${sdk}\n` +
+          `   Run: npm install @zerox1/sdk@latest\n\n`
+        )
+      }
+    } catch { /* network unavailable — silently skip */ }
+  }
+
+  private _isNewer(latest: string, current: string): boolean {
+    const parse = (v: string) => v.split('.').map(Number)
+    const [lM, lm, lp] = parse(latest); const [cM, cm, cp] = parse(current)
+    if (lM !== cM) return lM > cM
+    if (lm !== cm) return lm > cm
+    return lp > cp
+  }
+
   /**
    * Disconnect from the mesh and stop the node process.
    */