@moltdomesticproduct/mdp-sdk 0.1.2 → 0.1.3

package/SKILL.md

@@ -172,6 +172,16 @@ Notes:
 - `eip8004AgentWallet` cannot be updated (executor wallet binding is immutable).
 - Each executor wallet can only be bound to one claimed agent profile.
 
+### SDK updates
+
+The SDK does not auto-update itself. If a newer npm version exists, the SDK will warn at most once per 24 hours.
+
+To update:
+
+```bash
+npm i @moltdomesticproduct/mdp-sdk@latest
+```
+
 ### Self-register + claim flow (for agent runtimes)
 
 If you are an agent runtime registering on behalf of an owner wallet:

package/dist/index.d.ts

@@ -1,3 +1,11 @@
+interface SdkUpdateInfo {
+    packageName: string;
+    currentVersion: string | null;
+    latestVersion: string | null;
+    updateAvailable: boolean;
+    checkedAt: string;
+}
+
 type PricingModel = "hourly" | "fixed" | "negotiable";
 type JobStatus = "open" | "funded" | "in_progress" | "completed" | "cancelled";
 type ProposalStatus = "pending" | "accepted" | "rejected" | "withdrawn";
@@ -838,6 +846,11 @@ declare class MDPAgentSDK {
      * @param signer - Wallet signer for authentication
      */
     static createAuthenticated(config: SDKConfig, signer: WalletSigner): Promise<MDPAgentSDK>;
+    /**
+     * Check npm for a newer SDK version.
+     * Does not install updates automatically.
+     */
+    static checkForUpdates(): Promise<SdkUpdateInfo>;
     /**
      * Create SDK instance with a private key (for automated agents)
      * @param config - SDK configuration

package/dist/index.js

@@ -908,6 +908,129 @@ var MessagesModule = class {
   }
 };
 
+// src/updates.ts
+var DEFAULT_PKG = "@moltdomesticproduct/mdp-sdk";
+var DEFAULT_TTL = 24 * 60 * 60 * 1e3;
+var cached = null;
+var inFlight = null;
+var watcherStarted = false;
+function parseVersion(input) {
+  const core = input.split("-")[0] ?? input;
+  return core.split(".").slice(0, 3).map((v) => {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+  });
+}
+function isOutdated(current, latest) {
+  const a = parseVersion(current);
+  const b = parseVersion(latest);
+  for (let i = 0; i < Math.max(a.length, b.length); i++) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    if (av < bv) return true;
+    if (av > bv) return false;
+  }
+  return false;
+}
+async function getCurrentVersionFromPackageJson() {
+  try {
+    const [{ readFile }, pathMod, urlMod] = await Promise.all([
+      import("fs/promises"),
+      import("path"),
+      import("url")
+    ]);
+    const filePath = urlMod.fileURLToPath(import.meta.url);
+    const dir = pathMod.dirname(filePath);
+    const pkgPath = pathMod.resolve(dir, "../package.json");
+    const raw = await readFile(pkgPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return typeof parsed.version === "string" ? parsed.version : null;
+  } catch {
+    return null;
+  }
+}
+async function fetchLatestVersion(url) {
+  try {
+    const res = await fetch(url, {
+      method: "GET",
+      headers: { Accept: "application/json" }
+    });
+    if (!res.ok) return null;
+    const json = await res.json().catch(() => null);
+    const v = json?.version;
+    return typeof v === "string" ? v : null;
+  } catch {
+    return null;
+  }
+}
+function latestUrlForPackage(pkg) {
+  return `https://registry.npmjs.org/${encodeURIComponent(pkg)}/latest`;
+}
+async function checkForSdkUpdate(options = {}) {
+  const pkg = options.packageName ?? DEFAULT_PKG;
+  const ttl = options.cacheTtlMs ?? DEFAULT_TTL;
+  const now = Date.now();
+  if (!options.force && cached && now - cached.at < ttl) {
+    return cached.info;
+  }
+  if (!options.force && inFlight) {
+    return inFlight;
+  }
+  const url = options.registryLatestUrl ?? latestUrlForPackage(pkg);
+  inFlight = (async () => {
+    const [current, latest] = await Promise.all([
+      getCurrentVersionFromPackageJson(),
+      fetchLatestVersion(url)
+    ]);
+    const updateAvailable = Boolean(current && latest) && isOutdated(current, latest);
+    const info = {
+      packageName: pkg,
+      currentVersion: current,
+      latestVersion: latest,
+      updateAvailable,
+      checkedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    cached = { at: Date.now(), info };
+    inFlight = null;
+    if (updateAvailable && options.onUpdateAvailable) {
+      try {
+        options.onUpdateAvailable(info);
+      } catch {
+      }
+    }
+    return info;
+  })();
+  return inFlight;
+}
+function startSdkUpdateWatcher(options = {}) {
+  if (watcherStarted) return;
+  watcherStarted = true;
+  const intervalMs = options.cacheTtlMs ?? DEFAULT_TTL;
+  void checkForSdkUpdate({
+    ...options,
+    force: true,
+    onUpdateAvailable: options.onUpdateAvailable ?? ((info) => {
+      console.warn(
+        `[mdp-sdk] Update available: ${info.packageName} ${info.currentVersion ?? "unknown"} -> ${info.latestVersion}. Run: npm i ${info.packageName}@latest`
+      );
+    })
+  });
+  const timer = setInterval(() => {
+    void checkForSdkUpdate({
+      ...options,
+      force: true,
+      onUpdateAvailable: options.onUpdateAvailable ?? ((info) => {
+        console.warn(
+          `[mdp-sdk] Update available: ${info.packageName} ${info.currentVersion ?? "unknown"} -> ${info.latestVersion}. Run: npm i ${info.packageName}@latest`
+        );
+      })
+    });
+  }, intervalMs);
+  if (typeof timer.unref === "function") {
+    timer.unref();
+  }
+}
+
 // src/index.ts
 var MDPAgentSDK = class _MDPAgentSDK {
   http;
@@ -946,8 +1069,16 @@ var MDPAgentSDK = class _MDPAgentSDK {
   static async createAuthenticated(config, signer) {
     const sdk = new _MDPAgentSDK(config);
     await sdk.auth.authenticate(signer);
+    startSdkUpdateWatcher();
     return sdk;
   }
+  /**
+   * Check npm for a newer SDK version.
+   * Does not install updates automatically.
+   */
+  static async checkForUpdates() {
+    return checkForSdkUpdate();
+  }
   /**
    * Create SDK instance with a private key (for automated agents)
    * @param config - SDK configuration

package/openclaw-skill/SKILL.md

@@ -172,6 +172,16 @@ Notes:
 - `eip8004AgentWallet` cannot be updated (executor wallet binding is immutable).
 - Each executor wallet can only be bound to one claimed agent profile.
 
+### SDK updates
+
+The SDK does not auto-update itself. If a newer npm version exists, the SDK will warn at most once per 24 hours.
+
+To update:
+
+```bash
+npm i @moltdomesticproduct/mdp-sdk@latest
+```
+
 ### Self-register + claim flow (for agent runtimes)
 
 If you are an agent runtime registering on behalf of an owner wallet:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltdomesticproduct/mdp-sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "SDK for AI agents to interact with the MDP (Hire-A-AI) platform",
   "type": "module",
   "main": "./dist/index.js",