@iicp/client 0.7.64 → 0.7.65

package/README.md

@@ -18,11 +18,16 @@ urn:iicp:intent:llm:chat:v1  →  discover  →  select  →  submit
 ## Install
 
 ```bash
-npm install @iicp/client
-# yarn add @iicp/client
-# pnpm add @iicp/client
+npm install @iicp/client@latest
+# yarn add @iicp/client@latest
+# pnpm add @iicp/client@latest
 ```
 
+> **Upgrade note (0.7.65)** — upgrade clients and nodes so discovery prefers the canonical
+> IICP-CX `cx_public_key` field while still accepting the temporary `public_key` alias.
+> This prevents keyed live nodes from being treated as plaintext-only during the migration
+> and prepares your install for the later removal of the ambiguous alias.
+
 > **Upgrade note (0.5.3)** — if you operate a node and use the native IICP
 > TCP transport on port 9484, upgrade to `^0.5.3`. Releases 0.5.0–0.5.2
 > emitted a non-standard CBOR dialect that does not interoperate with the

package/dist/backend_stability.d.ts

@@ -0,0 +1,40 @@
+/** Provider-local backend stability observer and drain guard (#553).
+ *
+ * Conservative by design: read-only probes only, coarse public output, no
+ * automatic model load/unload orchestration and no host-safety guarantee.
+ */
+export type BackendState = "ok" | "degraded" | "draining";
+export type BackendReason = "ok" | "backend_cold" | "backend_loading" | "backend_unstable" | "observer_error";
+export interface BackendStabilityObservationInit {
+    backendState?: BackendState;
+    reasonClass?: BackendReason;
+    drainUntilMs?: number | null;
+    observedAtMs?: number;
+    diagnostics?: Record<string, unknown>;
+}
+export declare class BackendStabilityObservation {
+    backendState: BackendState;
+    reasonClass: BackendReason;
+    drainUntilMs: number | null;
+    observedAtMs: number;
+    diagnostics: Record<string, unknown>;
+    constructor(init?: BackendStabilityObservationInit);
+    retryAfterS(nowMs?: number): number | null;
+    isDraining(nowMs?: number): boolean;
+    publicDict(nowMs?: number): Record<string, unknown>;
+}
+export declare function parseOllamaPs(data: unknown, expectedModel?: string): BackendStabilityObservation;
+export declare function parseLmStudioModels(data: unknown, expectedModel?: string, opts?: {
+    nowMs?: number;
+    loadingRetryS?: number;
+    unstableRetryS?: number;
+}): BackendStabilityObservation;
+export declare function observeBackendStability(opts: {
+    backendUrl: string;
+    backend?: string;
+    expectedModel?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}): Promise<BackendStabilityObservation>;
+//# sourceMappingURL=backend_stability.d.ts.map

package/dist/backend_stability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend_stability.d.ts","sourceRoot":"","sources":["../src/backend_stability.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,UAAU,GAAG,UAAU,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;AAE9G,MAAM,WAAW,+BAA+B;IAC9C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,qBAAa,2BAA2B;IACtC,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,aAAa,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEzB,IAAI,GAAE,+BAAoC;IAQtD,WAAW,CAAC,KAAK,SAAa,GAAG,MAAM,GAAG,IAAI;IAO9C,UAAU,CAAC,KAAK,SAAa,GAAG,OAAO;IAIvC,UAAU,CAAC,KAAK,SAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYxD;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,2BAA2B,CAmBhG;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,aAAa,CAAC,EAAE,MAAM,EACtB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7E,2BAA2B,CAyD7B;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAuBvC"}

package/dist/backend_stability.js

@@ -0,0 +1,174 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/** Provider-local backend stability observer and drain guard (#553).
+ *
+ * Conservative by design: read-only probes only, coarse public output, no
+ * automatic model load/unload orchestration and no host-safety guarantee.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendStabilityObservation = void 0;
+exports.parseOllamaPs = parseOllamaPs;
+exports.parseLmStudioModels = parseLmStudioModels;
+exports.observeBackendStability = observeBackendStability;
+class BackendStabilityObservation {
+    backendState;
+    reasonClass;
+    drainUntilMs;
+    observedAtMs;
+    diagnostics;
+    constructor(init = {}) {
+        this.backendState = init.backendState ?? "ok";
+        this.reasonClass = init.reasonClass ?? "ok";
+        this.drainUntilMs = init.drainUntilMs ?? null;
+        this.observedAtMs = init.observedAtMs ?? Date.now();
+        this.diagnostics = init.diagnostics ?? {};
+    }
+    retryAfterS(nowMs = Date.now()) {
+        if (this.drainUntilMs === null)
+            return null;
+        const remaining = this.drainUntilMs - nowMs;
+        if (remaining <= 0)
+            return null;
+        return Math.max(1, Math.round(remaining / 1000));
+    }
+    isDraining(nowMs = Date.now()) {
+        return this.backendState === "draining" && this.retryAfterS(nowMs) !== null;
+    }
+    publicDict(nowMs = Date.now()) {
+        const body = {
+            backend_state: this.backendState,
+            reason_class: this.reasonClass,
+        };
+        const retry = this.retryAfterS(nowMs);
+        if (retry !== null) {
+            body.retry_after_s = retry;
+            body.drain_until = Math.floor((this.drainUntilMs ?? 0) / 1000);
+        }
+        return body;
+    }
+}
+exports.BackendStabilityObservation = BackendStabilityObservation;
+function norm(value) {
+    return String(value ?? "").trim().toLowerCase().replace(/-/g, "_");
+}
+function modelMatches(candidate, expectedModel) {
+    if (!expectedModel)
+        return true;
+    return candidate === expectedModel || candidate.split(":", 1)[0] === expectedModel.split(":", 1)[0];
+}
+function parseOllamaPs(data, expectedModel) {
+    const models = typeof data === "object" && data !== null && Array.isArray(data.models)
+        ? data.models
+        : null;
+    if (!models)
+        return new BackendStabilityObservation({ backendState: "degraded", reasonClass: "observer_error" });
+    const names = models.flatMap((m) => {
+        if (typeof m !== "object" || m === null)
+            return [];
+        const name = m.name;
+        return typeof name === "string" ? [name] : [];
+    });
+    const loadedExpected = names.some((name) => modelMatches(name, expectedModel));
+    if (expectedModel && !loadedExpected) {
+        return new BackendStabilityObservation({
+            backendState: "degraded",
+            reasonClass: "backend_cold",
+            diagnostics: { loaded_model_count: names.length, expected_model_loaded: false },
+        });
+    }
+    return new BackendStabilityObservation({ diagnostics: { loaded_model_count: names.length } });
+}
+function parseLmStudioModels(data, expectedModel, opts = {}) {
+    const nowMs = opts.nowMs ?? Date.now();
+    const obj = typeof data === "object" && data !== null ? data : {};
+    const rawModels = Array.isArray(obj.data) ? obj.data : Array.isArray(obj.models) ? obj.models : null;
+    if (!rawModels) {
+        return new BackendStabilityObservation({ backendState: "degraded", reasonClass: "observer_error", observedAtMs: nowMs });
+    }
+    let sawExpected = !expectedModel;
+    let sawLoadedExpected = false;
+    let sawLoading = false;
+    let sawUnstable = false;
+    let loadedCount = 0;
+    for (const item of rawModels) {
+        if (typeof item !== "object" || item === null)
+            continue;
+        const rec = item;
+        const modelId = String(rec.id ?? rec.model_key ?? rec.path ?? "");
+        const expected = modelMatches(modelId, expectedModel);
+        sawExpected = sawExpected || expected;
+        const instancesRaw = Array.isArray(rec.loaded_instances)
+            ? rec.loaded_instances
+            : Array.isArray(rec.loadedInstances) ? rec.loadedInstances : [];
+        for (const inst of instancesRaw) {
+            if (typeof inst !== "object" || inst === null)
+                continue;
+            loadedCount += 1;
+            if (expected)
+                sawLoadedExpected = true;
+            const state = norm(inst.state ?? inst.status ?? inst.load_status);
+            if (["loading", "initializing", "starting", "warming", "warming_up"].includes(state))
+                sawLoading = true;
+            if (["error", "failed", "crashed", "unhealthy", "oom", "out_of_memory"].includes(state))
+                sawUnstable = true;
+        }
+    }
+    if (sawUnstable) {
+        return new BackendStabilityObservation({
+            backendState: "draining",
+            reasonClass: "backend_unstable",
+            drainUntilMs: nowMs + (opts.unstableRetryS ?? 60) * 1000,
+            observedAtMs: nowMs,
+            diagnostics: { loaded_instance_count: loadedCount },
+        });
+    }
+    if (sawLoading) {
+        return new BackendStabilityObservation({
+            backendState: "draining",
+            reasonClass: "backend_loading",
+            drainUntilMs: nowMs + (opts.loadingRetryS ?? 30) * 1000,
+            observedAtMs: nowMs,
+            diagnostics: { loaded_instance_count: loadedCount },
+        });
+    }
+    if (expectedModel && (!sawExpected || !sawLoadedExpected)) {
+        return new BackendStabilityObservation({
+            backendState: "degraded",
+            reasonClass: "backend_cold",
+            observedAtMs: nowMs,
+            diagnostics: { loaded_instance_count: loadedCount, expected_model_loaded: false },
+        });
+    }
+    return new BackendStabilityObservation({ observedAtMs: nowMs, diagnostics: { loaded_instance_count: loadedCount } });
+}
+async function observeBackendStability(opts) {
+    const base = opts.backendUrl.replace(/\/$/, "");
+    if (!base)
+        return new BackendStabilityObservation({ backendState: "degraded", reasonClass: "observer_error" });
+    const root = base.endsWith("/v1") ? base.slice(0, -3) : base;
+    const flavor = norm(opts.backend);
+    const headers = opts.apiKey ? { Authorization: `Bearer ${opts.apiKey}` } : {};
+    const f = opts.fetchImpl ?? fetch;
+    const signal = () => AbortSignal.timeout(opts.timeoutMs ?? 2000);
+    try {
+        if (flavor === "ollama" || flavor === "") {
+            const r = await f(`${root}/api/ps`, { headers, signal: signal() });
+            if (r.ok)
+                return parseOllamaPs(await r.json(), opts.expectedModel);
+            if (flavor === "ollama")
+                return new BackendStabilityObservation({ backendState: "degraded", reasonClass: "observer_error" });
+        }
+        if (["lmstudio", "lm_studio", "lm_studio_server", ""].includes(flavor)) {
+            const r = await f(`${root}/api/v1/models`, { headers, signal: signal() });
+            if (r.ok)
+                return parseLmStudioModels(await r.json(), opts.expectedModel);
+            if (flavor)
+                return new BackendStabilityObservation({ backendState: "degraded", reasonClass: "observer_error" });
+        }
+    }
+    catch {
+        return new BackendStabilityObservation({ backendState: "degraded", reasonClass: "observer_error" });
+    }
+    return new BackendStabilityObservation();
+}
+//# sourceMappingURL=backend_stability.js.map

package/dist/backend_stability.js.map

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

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAyCA,OAAO,EAeL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qGAAqG;IACrG,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA4VD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,OAAO,GACrB,KAAK,CAAC,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC,CAGtC;AAiFD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,CAsB9E;AAyvBD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA+D5D;AA8dD,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA2CA,OAAO,EAeL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qGAAqG;IACrG,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA6VD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,OAAO,GACrB,KAAK,CAAC,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC,CAGtC;AAiFD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,CAsB9E;AAyvBD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA+D5D;AA8dD,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlF"}

package/dist/cli.js

@@ -28,6 +28,8 @@ const node_crypto_1 = require("node:crypto");
 const SDK_VERSION = require("../package.json").version;
 const net = require("node:net");
 const http = require("node:http");
+const fs = require("node:fs");
+const path = require("node:path");
 const node_child_process_1 = require("node:child_process");
 const readline = require("node:readline/promises");
 const node_process_1 = require("node:process");
@@ -67,6 +69,7 @@ function printHelp() {
         `  credits                    Show this node's earned / spent / balance credits\n` +
         `  proxy                      Run the local OpenAI/Ollama/Anthropic-compat gateway (loopback; no registration)\n` +
         `  mcp-gateway                Bridge a local MCP server as an IICP provider node (registers + serves)\n` +
+        `  service                    Generate/install OS supervisor units for unattended node serving\n` +
         `  operator rename <name>     Change your public display_name (signed by your operator key)\n` +
         `  operator encrypt           Password-encrypt the operator secret at rest ($IICP_OPERATOR_PASSPHRASE)\n` +
         `  operator decrypt           Remove at-rest encryption of the operator secret\n\n` +
@@ -1921,6 +1924,63 @@ async function runUpdate() {
     process.stdout.write(`@iicp/client ${v.current} — up to date (latest: ${v.latest}).\n`);
     return 0;
 }
+async function runService(argv) {
+    const subcmd = argv[0];
+    if (!subcmd || subcmd === "--help" || subcmd === "-h" || subcmd === "help") {
+        process.stdout.write(`usage: iicp-node service <install|status|restart|uninstall> --node NAME [options]\n\n` +
+            `Generate user-level launchd/systemd supervisor units. The service runs foreground:\n` +
+            `  iicp-node serve --node <NAME>\n\n` +
+            `Options:\n` +
+            `  --node NAME        Saved node name to serve (required)\n` +
+            `  --name NAME        Override service label/unit name\n` +
+            `  --platform KIND    auto | launchd | systemd (default auto)\n` +
+            `  --dry-run          For install: print the generated unit without writing files\n`);
+        return subcmd ? 0 : 2;
+    }
+    if (!["install", "status", "restart", "uninstall"].includes(subcmd)) {
+        throw new CliError(`unknown service subcommand '${subcmd}'`);
+    }
+    const { values } = safeParseArgs({
+        args: argv.slice(1),
+        options: {
+            node: { type: "string" },
+            name: { type: "string" },
+            platform: { type: "string" },
+            "dry-run": { type: "boolean" },
+            help: { type: "boolean", short: "h" },
+        },
+        allowPositionals: false,
+    });
+    if (values.help)
+        return runService(["help"]);
+    const node = values.node;
+    if (!node)
+        throw new CliError("service requires --node NAME");
+    const { renderServiceUnit } = await import("./service.js");
+    const unit = renderServiceUnit(node, values.name, values.platform ?? "auto");
+    if (subcmd === "install") {
+        if (values["dry-run"]) {
+            process.stdout.write(`# ${unit.platform} service: ${unit.name}\n# path: ${unit.path}\n${unit.content}`);
+        }
+        else {
+            fs.mkdirSync(path.dirname(unit.path), { recursive: true });
+            fs.writeFileSync(unit.path, unit.content);
+            process.stdout.write(`Installed ${unit.platform} service unit: ${unit.path}\n`);
+        }
+        process.stdout.write(`status:   ${unit.statusHint}\n`);
+        process.stdout.write(`restart:  ${unit.restartHint}\n`);
+        process.stdout.write(`logs:     ${unit.logHint}\n`);
+        process.stdout.write("Note: no classic --daemon fork is used; the OS supervisor runs foreground `iicp-node serve`.\n");
+        return 0;
+    }
+    if (subcmd === "status")
+        process.stdout.write(`${unit.statusHint}\n`);
+    if (subcmd === "restart")
+        process.stdout.write(`${unit.restartHint}\n`);
+    if (subcmd === "uninstall")
+        process.stdout.write(`${unit.uninstallHint}\n`);
+    return 0;
+}
 async function dispatch(argv) {
     const cmd = argv[0];
     if (cmd === "init")
@@ -1939,6 +1999,8 @@ async function dispatch(argv) {
         return runMcpGateway(argv.slice(1));
     if (cmd === "update")
         return runUpdate();
+    if (cmd === "service")
+        return runService(argv.slice(1));
     if (cmd !== "serve") {
         process.stderr.write(`unknown command: ${cmd}\n`);
         printHelp();