@iicp/client 0.2.0 → 0.5.4

package/README.md

@@ -23,6 +23,12 @@ npm install iicp-client
 # pnpm add iicp-client
 ```
 
+> **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
+> Python or Rust SDK on the binary transport. The HTTP `/v1/task` path is
+> unaffected. See [`CHANGELOG.md`](./CHANGELOG.md) for details.
+
 ---
 
 ## Quickstart

package/dist/backends/openai_compat.d.ts

@@ -0,0 +1,38 @@
+/**
+ * OpenAI-compatible backend helper (Ollama / vLLM / LM Studio / OpenAI / ...).
+ *
+ * TypeScript port of iicp-client-python's backends/openai_compat.py (iter-1423).
+ * Returns a TaskHandler suitable for IicpNode.serve() AND IicpTcpServer.
+ *
+ *   import { openaiCompatHandler } from "@iicp/client";
+ *
+ *   const handler = openaiCompatHandler({
+ *     baseUrl: "http://localhost:11434/v1",  // Ollama
+ *     model: "qwen2.5:0.5b",
+ *   });
+ *   await node.serve(handler, { port: 8080, nodeToken });
+ *
+ * Intent routing matches the Python module + adapter reference:
+ *
+ *   urn:iicp:intent:llm:chat:v1        → /chat/completions
+ *   urn:iicp:intent:llm:completion:v1  → /completions
+ *   urn:iicp:intent:llm:embedding:v1   → /embeddings
+ */
+export interface OpenAiCompatOptions {
+    /** Provider HTTP root (no trailing slash needed). Default: Ollama `http://localhost:11434/v1`. */
+    baseUrl?: string;
+    /** Default model name. If unset, the task payload MUST include `model`. */
+    model?: string;
+    /** Bearer token for the provider. Empty for local Ollama/vLLM. */
+    apiKey?: string;
+    /** Per-request HTTP timeout in milliseconds. Default 30000. */
+    timeoutMs?: number;
+}
+export type TaskHandlerInput = {
+    task_id?: string;
+    intent?: string;
+    payload?: Record<string, unknown>;
+};
+export type TaskHandlerOutput = Record<string, unknown>;
+export declare function openaiCompatHandler(opts?: OpenAiCompatOptions): (task: TaskHandlerInput) => Promise<TaskHandlerOutput>;
+//# sourceMappingURL=openai_compat.d.ts.map

package/dist/backends/openai_compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai_compat.d.ts","sourceRoot":"","sources":["../../src/backends/openai_compat.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,MAAM,WAAW,mBAAmB;IAClC,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,mBAAwB,GAC7B,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CA8ExD"}

package/dist/backends/openai_compat.js

@@ -0,0 +1,102 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * OpenAI-compatible backend helper (Ollama / vLLM / LM Studio / OpenAI / ...).
+ *
+ * TypeScript port of iicp-client-python's backends/openai_compat.py (iter-1423).
+ * Returns a TaskHandler suitable for IicpNode.serve() AND IicpTcpServer.
+ *
+ *   import { openaiCompatHandler } from "@iicp/client";
+ *
+ *   const handler = openaiCompatHandler({
+ *     baseUrl: "http://localhost:11434/v1",  // Ollama
+ *     model: "qwen2.5:0.5b",
+ *   });
+ *   await node.serve(handler, { port: 8080, nodeToken });
+ *
+ * Intent routing matches the Python module + adapter reference:
+ *
+ *   urn:iicp:intent:llm:chat:v1        → /chat/completions
+ *   urn:iicp:intent:llm:completion:v1  → /completions
+ *   urn:iicp:intent:llm:embedding:v1   → /embeddings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openaiCompatHandler = openaiCompatHandler;
+const INTENT_TO_PATH = {
+    "urn:iicp:intent:llm:chat:v1": "/chat/completions",
+    "urn:iicp:intent:llm:completion:v1": "/completions",
+    "urn:iicp:intent:llm:embedding:v1": "/embeddings",
+};
+function openaiCompatHandler(opts = {}) {
+    const baseUrl = (opts.baseUrl ?? "http://localhost:11434/v1").replace(/\/$/, "");
+    const model = opts.model;
+    const apiKey = opts.apiKey ?? "";
+    const timeoutMs = opts.timeoutMs ?? 30000;
+    return async function handler(task) {
+        const intent = String(task.intent ?? "");
+        const payload = task.payload;
+        if (payload !== undefined && payload !== null && (typeof payload !== "object" || Array.isArray(payload))) {
+            return {
+                error_code: 400,
+                error_message: `openai_compat: task.payload must be a dict, got ${typeof payload}`,
+            };
+        }
+        const path = INTENT_TO_PATH[intent];
+        if (!path) {
+            return {
+                error_code: 400,
+                error_message: `openai_compat: unsupported intent ${JSON.stringify(intent)}; supported: ${JSON.stringify(Object.keys(INTENT_TO_PATH).sort())}`,
+            };
+        }
+        const body = { ...(payload ?? {}) };
+        if (body.model === undefined && model !== undefined)
+            body.model = model;
+        if (!body.model) {
+            return {
+                error_code: 400,
+                error_message: "openai_compat: no model — either pass `model` to openaiCompatHandler(...) " +
+                    "or include `model` in the task payload",
+            };
+        }
+        const headers = { "Content-Type": "application/json" };
+        if (apiKey)
+            headers["Authorization"] = `Bearer ${apiKey}`;
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), timeoutMs);
+        let resp;
+        try {
+            resp = await fetch(`${baseUrl}${path}`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: ctrl.signal,
+            });
+        }
+        catch (exc) {
+            clearTimeout(t);
+            const msg = exc instanceof Error ? exc.message : String(exc);
+            if (ctrl.signal.aborted) {
+                return { error_code: 408, error_message: "openai_compat: backend timed out" };
+            }
+            return { error_code: 502, error_message: `openai_compat: HTTP transport error: ${msg}` };
+        }
+        clearTimeout(t);
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => "");
+            return {
+                error_code: resp.status,
+                error_message: `openai_compat: upstream ${resp.status}: ${text.slice(0, 512)}`,
+            };
+        }
+        let data;
+        try {
+            data = await resp.json();
+        }
+        catch (exc) {
+            const msg = exc instanceof Error ? exc.message : String(exc);
+            return { error_code: 502, error_message: `openai_compat: upstream returned non-JSON: ${msg}` };
+        }
+        return { result: data };
+    };
+}
+//# sourceMappingURL=openai_compat.js.map

package/dist/backends/openai_compat.js.map

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

package/dist/cip_policy.d.ts

@@ -0,0 +1,54 @@
+/**
+ * CIP-W01/CIP-W02 provider-side policy gate — S.12, ADR-012.
+ *
+ * TypeScript port of iicp-client-python's cip_policy.py (iter-1429).
+ *
+ * The Cooperative Inference Profile gives a node three operator-controlled
+ * roles (consumer / coordinator / worker). Safe Phase-4 defaults: all three
+ * are OFF until the operator opts in. The capacity gate enforces S.12 §2.2:
+ * worker tasks at capacity MUST return IICP-E021 rather than silently queue.
+ */
+export interface CooperativeInferencePolicyOptions {
+    enabled?: boolean;
+    allowCoordinator?: boolean;
+    allowWorker?: boolean;
+    maxReplicas?: number;
+    /** Bounded to [1, 60000]ms. */
+    maxWorkerTimeoutMs?: number;
+    maxConcurrentRemote?: number;
+}
+/** Safe-by-default CIP policy with the S.12 §2.2 capacity gate built-in. */
+export declare class CooperativeInferencePolicy {
+    readonly enabled: boolean;
+    readonly allowCoordinator: boolean;
+    readonly allowWorker: boolean;
+    readonly maxReplicas: number;
+    readonly maxWorkerTimeoutMs: number;
+    readonly maxConcurrentRemote: number;
+    private _inFlight;
+    constructor(opts?: CooperativeInferencePolicyOptions);
+    /** CIP-W01: returns true if this node may act as a CIP coordinator. */
+    checkCoordinator(): boolean;
+    /** CIP-W02: returns true if this node may accept CIP worker tasks. */
+    checkWorker(): boolean;
+    /**
+     * CIP-A1-GATE-06: try to acquire a worker concurrency slot. Returns true
+     * on success — caller MUST call releaseCipSlot() when done. Returns false
+     * when at capacity, in which case the caller MUST respond with IICP-E021
+     * rather than queue or delay (S.12 §2.2 explicit non-silent-queue rule).
+     */
+    tryAcquireCipSlot(): boolean;
+    /** Release a slot acquired via tryAcquireCipSlot(). */
+    releaseCipSlot(): void;
+    /**
+     * Build the `policy` sub-object the directory expects in /v1/register.
+     * Only emits keys when CIP is enabled — disabled-by-default operators
+     * shouldn't clutter the payload with `allow_*: false`.
+     */
+    asRegisterPolicyBlock(): Record<string, unknown>;
+}
+/** Return the active CIP policy (safe defaults until configureCipPolicy is called). */
+export declare function getCipPolicy(): CooperativeInferencePolicy;
+/** Replace the module-level CIP policy. Returns the new policy for chaining. */
+export declare function configureCipPolicy(opts?: CooperativeInferencePolicyOptions): CooperativeInferencePolicy;
+//# sourceMappingURL=cip_policy.d.ts.map

package/dist/cip_policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cip_policy.d.ts","sourceRoot":"","sources":["../src/cip_policy.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,MAAM,WAAW,iCAAiC;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,4EAA4E;AAC5E,qBAAa,0BAA0B;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,OAAO,CAAC,SAAS,CAAK;gBAEV,IAAI,GAAE,iCAAsC;IASxD,uEAAuE;IACvE,gBAAgB,IAAI,OAAO;IAI3B,sEAAsE;IACtE,WAAW,IAAI,OAAO;IAItB;;;;;OAKG;IACH,iBAAiB,IAAI,OAAO;IAM5B,uDAAuD;IACvD,cAAc,IAAI,IAAI;IAItB;;;;OAIG;IACH,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMjD;AAMD,uFAAuF;AACvF,wBAAgB,YAAY,IAAI,0BAA0B,CAEzD;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,iCAAsC,GAC3C,0BAA0B,CAG5B"}

package/dist/cip_policy.js

@@ -0,0 +1,84 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * CIP-W01/CIP-W02 provider-side policy gate — S.12, ADR-012.
+ *
+ * TypeScript port of iicp-client-python's cip_policy.py (iter-1429).
+ *
+ * The Cooperative Inference Profile gives a node three operator-controlled
+ * roles (consumer / coordinator / worker). Safe Phase-4 defaults: all three
+ * are OFF until the operator opts in. The capacity gate enforces S.12 §2.2:
+ * worker tasks at capacity MUST return IICP-E021 rather than silently queue.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CooperativeInferencePolicy = void 0;
+exports.getCipPolicy = getCipPolicy;
+exports.configureCipPolicy = configureCipPolicy;
+/** Safe-by-default CIP policy with the S.12 §2.2 capacity gate built-in. */
+class CooperativeInferencePolicy {
+    enabled;
+    allowCoordinator;
+    allowWorker;
+    maxReplicas;
+    maxWorkerTimeoutMs;
+    maxConcurrentRemote;
+    _inFlight = 0;
+    constructor(opts = {}) {
+        this.enabled = opts.enabled ?? false;
+        this.allowCoordinator = opts.allowCoordinator ?? false;
+        this.allowWorker = opts.allowWorker ?? false;
+        this.maxReplicas = Math.max(1, opts.maxReplicas ?? 3);
+        this.maxWorkerTimeoutMs = Math.max(1, Math.min(60_000, opts.maxWorkerTimeoutMs ?? 30_000));
+        this.maxConcurrentRemote = Math.max(1, opts.maxConcurrentRemote ?? 2);
+    }
+    /** CIP-W01: returns true if this node may act as a CIP coordinator. */
+    checkCoordinator() {
+        return this.enabled && this.allowCoordinator;
+    }
+    /** CIP-W02: returns true if this node may accept CIP worker tasks. */
+    checkWorker() {
+        return this.enabled && this.allowWorker;
+    }
+    /**
+     * CIP-A1-GATE-06: try to acquire a worker concurrency slot. Returns true
+     * on success — caller MUST call releaseCipSlot() when done. Returns false
+     * when at capacity, in which case the caller MUST respond with IICP-E021
+     * rather than queue or delay (S.12 §2.2 explicit non-silent-queue rule).
+     */
+    tryAcquireCipSlot() {
+        if (this._inFlight >= this.maxConcurrentRemote)
+            return false;
+        this._inFlight += 1;
+        return true;
+    }
+    /** Release a slot acquired via tryAcquireCipSlot(). */
+    releaseCipSlot() {
+        if (this._inFlight > 0)
+            this._inFlight -= 1;
+    }
+    /**
+     * Build the `policy` sub-object the directory expects in /v1/register.
+     * Only emits keys when CIP is enabled — disabled-by-default operators
+     * shouldn't clutter the payload with `allow_*: false`.
+     */
+    asRegisterPolicyBlock() {
+        if (!this.enabled)
+            return {};
+        return {
+            allow_remote_inference: this.allowWorker,
+        };
+    }
+}
+exports.CooperativeInferencePolicy = CooperativeInferencePolicy;
+// ── Module-level default policy ──────────────────────────────────────────
+let _policy = new CooperativeInferencePolicy();
+/** Return the active CIP policy (safe defaults until configureCipPolicy is called). */
+function getCipPolicy() {
+    return _policy;
+}
+/** Replace the module-level CIP policy. Returns the new policy for chaining. */
+function configureCipPolicy(opts = {}) {
+    _policy = new CooperativeInferencePolicy(opts);
+    return _policy;
+}
+//# sourceMappingURL=cip_policy.js.map

package/dist/cip_policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cip_policy.js","sourceRoot":"","sources":["../src/cip_policy.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;;;;GASG;;;AA4EH,oCAEC;AAGD,gDAKC;AA1ED,4EAA4E;AAC5E,MAAa,0BAA0B;IAC5B,OAAO,CAAU;IACjB,gBAAgB,CAAU;IAC1B,WAAW,CAAU;IACrB,WAAW,CAAS;IACpB,kBAAkB,CAAS;IAC3B,mBAAmB,CAAS;IAC7B,SAAS,GAAG,CAAC,CAAC;IAEtB,YAAY,OAA0C,EAAE;QACtD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;QACrC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,KAAK,CAAC;QACvD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,mBAAmB,IAAI,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,uEAAuE;IACvE,gBAAgB;QACd,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC;IAC/C,CAAC;IAED,sEAAsE;IACtE,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,iBAAiB;QACf,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,mBAAmB;YAAE,OAAO,KAAK,CAAC;QAC7D,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uDAAuD;IACvD,cAAc;QACZ,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC;YAAE,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,qBAAqB;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,sBAAsB,EAAE,IAAI,CAAC,WAAW;SACzC,CAAC;IACJ,CAAC;CACF;AAxDD,gEAwDC;AAED,4EAA4E;AAE5E,IAAI,OAAO,GAA+B,IAAI,0BAA0B,EAAE,CAAC;AAE3E,uFAAuF;AACvF,SAAgB,YAAY;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,SAAgB,kBAAkB,CAChC,OAA0C,EAAE;IAE5C,OAAO,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA8HA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDlF"}

package/dist/cli.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * iicp-node — turn @iicp/client into a runnable provider node.
+ *
+ * Usage:
+ *   iicp-node serve --model qwen2.5:0.5b --backend-url http://localhost:11434
+ *
+ * All flags also read from env (IICP_BACKEND_URL, IICP_BACKEND_MODEL,
+ * IICP_PUBLIC_ENDPOINT, IICP_DIRECTORY_URL, IICP_REGION,
+ * IICP_MAX_CONCURRENT, IICP_NODE_ID, IICP_INTENT, IICP_PORT, IICP_HOST).
+ *
+ * Mirrors iicp_client.cli (Python) so operators choosing TypeScript get the
+ * same one-liner setup path.
+ */
+const node_util_1 = require("node:util");
+const node_crypto_1 = require("node:crypto");
+const node_js_1 = require("./node.js");
+const openai_compat_js_1 = require("./backends/openai_compat.js");
+function envOr(name, fallback) {
+    const v = process.env[name];
+    return v ?? fallback;
+}
+function envInt(name, fallback) {
+    const v = process.env[name];
+    if (!v)
+        return fallback;
+    const n = parseInt(v, 10);
+    return Number.isFinite(n) ? n : fallback;
+}
+function printHelp() {
+    process.stdout.write(`usage: iicp-node serve [options]\n\n` +
+        `Run an IICP provider node backed by an OpenAI-compatible server.\n\n` +
+        `Required (flag or env):\n` +
+        `  --backend-url URL         IICP_BACKEND_URL — Ollama / vLLM / LM Studio endpoint\n` +
+        `  --model NAME              IICP_BACKEND_MODEL — model name (e.g. qwen2.5:0.5b)\n\n` +
+        `Optional:\n` +
+        `  --public-endpoint URL     IICP_PUBLIC_ENDPOINT — externally reachable URL of this node\n` +
+        `  --directory-url URL       IICP_DIRECTORY_URL (default https://iicp.network/api)\n` +
+        `  --region REGION           IICP_REGION (default eu-central)\n` +
+        `  --intent URN              IICP_INTENT (default urn:iicp:intent:llm:chat:v1)\n` +
+        `  --max-concurrent N        IICP_MAX_CONCURRENT (default 4)\n` +
+        `  --node-id ID              IICP_NODE_ID (auto-generated if absent)\n` +
+        `  --port N                  IICP_PORT (default 8020)\n` +
+        `  --host HOST               IICP_HOST (default 0.0.0.0)\n` +
+        `  --skip-registration       IICP_SKIP_REGISTRATION — register-free dev mode\n`);
+}
+async function runServe(opts) {
+    if (!opts.backendUrl || !opts.model) {
+        process.stderr.write("ERROR: --backend-url and --model are required (or IICP_BACKEND_URL / IICP_BACKEND_MODEL).\n");
+        return 2;
+    }
+    const nodeId = opts.nodeId ||
+        `sdk-${opts.model.replace(/:/g, "-")}-${(0, node_crypto_1.randomBytes)(4).toString("hex")}`;
+    const publicEndpoint = opts.publicEndpoint || `http://localhost:${opts.port}`;
+    const node = new node_js_1.IicpNode({
+        nodeId,
+        endpoint: publicEndpoint,
+        intent: opts.intent,
+        model: opts.model,
+        region: opts.region,
+        directoryUrl: opts.directoryUrl,
+        maxConcurrent: opts.maxConcurrent,
+    });
+    const handler = (0, openai_compat_js_1.openaiCompatHandler)({
+        baseUrl: opts.backendUrl,
+        model: opts.model,
+    });
+    let token;
+    if (!opts.skipRegistration) {
+        try {
+            token = await node.register();
+            // eslint-disable-next-line no-console
+            console.log(`[iicp-node] registered as ${nodeId} (token=${(token ?? "").slice(0, 8)}…)`);
+        }
+        catch (exc) {
+            const msg = exc instanceof Error ? exc.message : String(exc);
+            // eslint-disable-next-line no-console
+            console.warn(`[iicp-node] registration failed: ${msg} — continuing without heartbeat`);
+        }
+    }
+    // eslint-disable-next-line no-console
+    console.log(`[iicp-node] serving ${opts.intent} on ${opts.host}:${opts.port} — ` +
+        `backend ${opts.backendUrl} (model=${opts.model}, max_concurrent=${opts.maxConcurrent})`);
+    // serve() returns a stop() handle but never resolves on its own; we wait for
+    // SIGINT/SIGTERM to terminate.
+    const stop = node.serve(handler, { host: opts.host, port: opts.port, nodeToken: token });
+    await new Promise((resolve) => {
+        const shutdown = (sig) => {
+            // eslint-disable-next-line no-console
+            console.log(`[iicp-node] ${sig} received — shutting down`);
+            stop();
+            resolve();
+        };
+        process.once("SIGINT", () => shutdown("SIGINT"));
+        process.once("SIGTERM", () => shutdown("SIGTERM"));
+    });
+    return 0;
+}
+async function main(argv = process.argv.slice(2)) {
+    if (argv.length === 0 || argv[0] === "--help" || argv[0] === "-h") {
+        printHelp();
+        return argv.length === 0 ? 2 : 0;
+    }
+    if (argv[0] !== "serve") {
+        process.stderr.write(`unknown command: ${argv[0]}\n`);
+        printHelp();
+        return 2;
+    }
+    const { values } = (0, node_util_1.parseArgs)({
+        args: argv.slice(1),
+        options: {
+            "backend-url": { type: "string" },
+            model: { type: "string" },
+            "public-endpoint": { type: "string" },
+            "directory-url": { type: "string" },
+            region: { type: "string" },
+            intent: { type: "string" },
+            "max-concurrent": { type: "string" },
+            "node-id": { type: "string" },
+            port: { type: "string" },
+            host: { type: "string" },
+            "skip-registration": { type: "boolean" },
+            help: { type: "boolean", short: "h" },
+        },
+        allowPositionals: false,
+    });
+    if (values.help) {
+        printHelp();
+        return 0;
+    }
+    const opts = {
+        backendUrl: values["backend-url"] ?? envOr("IICP_BACKEND_URL") ?? "",
+        model: values.model ?? envOr("IICP_BACKEND_MODEL") ?? "",
+        publicEndpoint: values["public-endpoint"] ?? envOr("IICP_PUBLIC_ENDPOINT") ?? "",
+        directoryUrl: values["directory-url"] ??
+            envOr("IICP_DIRECTORY_URL", "https://iicp.network/api"),
+        region: values.region ?? envOr("IICP_REGION", "eu-central"),
+        intent: values.intent ?? envOr("IICP_INTENT", "urn:iicp:intent:llm:chat:v1"),
+        maxConcurrent: values["max-concurrent"] !== undefined
+            ? parseInt(values["max-concurrent"], 10)
+            : envInt("IICP_MAX_CONCURRENT", 4),
+        nodeId: values["node-id"] ?? envOr("IICP_NODE_ID") ?? "",
+        port: values.port !== undefined
+            ? parseInt(values.port, 10)
+            : envInt("IICP_PORT", 8020),
+        host: values.host ?? envOr("IICP_HOST", "0.0.0.0"),
+        skipRegistration: Boolean(values["skip-registration"]) ||
+            (envOr("IICP_SKIP_REGISTRATION", "false") ?? "").toLowerCase() === "true",
+    };
+    return runServe(opts);
+}
+// Direct invocation (node dist/cli.js or via the bin shim)
+if (require.main === module) {
+    main()
+        .then((code) => process.exit(code))
+        .catch((err) => {
+        // eslint-disable-next-line no-console
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/concurrency.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Unified concurrency gate for the hybrid client.
+ *
+ * TypeScript port of iicp-client-python's concurrency.py (iter-1438).
+ * Tier 2 Item 5 of #340. Caps simultaneous inference tasks at
+ * `max_concurrent` from the node's registration envelope; when full the
+ * SDK responds with IICP-E021 (429) on whichever transport carries the
+ * CALL — HTTP /v1/task OR native IICP TCP RESPONSE frame.
+ *
+ * Non-blocking acquire — CapacityExceededError raises immediately rather
+ * than queueing. The proxy MUST learn back-pressure right away so it
+ * can route elsewhere (ADR-008). Queueing would mask overload.
+ */
+/** Raised by [`ConcurrencyGate.acquire`] when the gate is at capacity. */
+export declare class CapacityExceededError extends Error {
+    readonly maxConcurrent: number;
+    constructor(maxConcurrent: number);
+}
+/**
+ * Cap simultaneous inference tasks. Single shared primitive across HTTP
+ * and native IICP transports so the directory's NodeScorer sees the same
+ * back-pressure regardless of which transport carried the CALL.
+ *
+ * Usage::
+ *
+ *   const gate = new ConcurrencyGate(4);
+ *   try {
+ *     await gate.acquire();
+ *     try {
+ *       await runTask();
+ *     } finally {
+ *       gate.release();
+ *     }
+ *   } catch (e) {
+ *     if (e instanceof CapacityExceededError) return { error_code: 429, ... };
+ *     throw e;
+ *   }
+ *
+ * Or via the `run()` helper that auto-releases:
+ *
+ *   const result = await gate.run(async () => runTask());
+ */
+export declare class ConcurrencyGate {
+    readonly maxConcurrent: number;
+    private _active;
+    constructor(maxConcurrent: number);
+    /** Non-blocking acquire. Throws CapacityExceededError when full. */
+    acquire(): void;
+    /** Release a slot acquired via [`acquire`]. */
+    release(): void;
+    /** Convenience: run `fn` while holding a slot, releasing on success or error. */
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    get activeJobs(): number;
+    /** Load fraction in [0, 1]. Reported in heartbeats so the NodeScorer can
+     * down-rank busy nodes (ADR-008). */
+    get load(): number;
+}
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../src/concurrency.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;GAYG;AAEH,0EAA0E;AAC1E,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBACnB,aAAa,EAAE,MAAM;CAKlC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,OAAO,CAAK;gBAER,aAAa,EAAE,MAAM;IAOjC,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAOf,+CAA+C;IAC/C,OAAO,IAAI,IAAI;IAIf,iFAAiF;IAC3E,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS9C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;yCACqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAGjB;CACF"}

package/dist/concurrency.js

@@ -0,0 +1,95 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Unified concurrency gate for the hybrid client.
+ *
+ * TypeScript port of iicp-client-python's concurrency.py (iter-1438).
+ * Tier 2 Item 5 of #340. Caps simultaneous inference tasks at
+ * `max_concurrent` from the node's registration envelope; when full the
+ * SDK responds with IICP-E021 (429) on whichever transport carries the
+ * CALL — HTTP /v1/task OR native IICP TCP RESPONSE frame.
+ *
+ * Non-blocking acquire — CapacityExceededError raises immediately rather
+ * than queueing. The proxy MUST learn back-pressure right away so it
+ * can route elsewhere (ADR-008). Queueing would mask overload.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConcurrencyGate = exports.CapacityExceededError = void 0;
+/** Raised by [`ConcurrencyGate.acquire`] when the gate is at capacity. */
+class CapacityExceededError extends Error {
+    maxConcurrent;
+    constructor(maxConcurrent) {
+        super(`max_concurrent (${maxConcurrent}) reached`);
+        this.name = "CapacityExceededError";
+        this.maxConcurrent = maxConcurrent;
+    }
+}
+exports.CapacityExceededError = CapacityExceededError;
+/**
+ * Cap simultaneous inference tasks. Single shared primitive across HTTP
+ * and native IICP transports so the directory's NodeScorer sees the same
+ * back-pressure regardless of which transport carried the CALL.
+ *
+ * Usage::
+ *
+ *   const gate = new ConcurrencyGate(4);
+ *   try {
+ *     await gate.acquire();
+ *     try {
+ *       await runTask();
+ *     } finally {
+ *       gate.release();
+ *     }
+ *   } catch (e) {
+ *     if (e instanceof CapacityExceededError) return { error_code: 429, ... };
+ *     throw e;
+ *   }
+ *
+ * Or via the `run()` helper that auto-releases:
+ *
+ *   const result = await gate.run(async () => runTask());
+ */
+class ConcurrencyGate {
+    maxConcurrent;
+    _active = 0;
+    constructor(maxConcurrent) {
+        if (maxConcurrent < 1) {
+            throw new Error(`max_concurrent must be >= 1, got ${maxConcurrent}`);
+        }
+        this.maxConcurrent = maxConcurrent;
+    }
+    /** Non-blocking acquire. Throws CapacityExceededError when full. */
+    acquire() {
+        if (this._active >= this.maxConcurrent) {
+            throw new CapacityExceededError(this.maxConcurrent);
+        }
+        this._active += 1;
+    }
+    /** Release a slot acquired via [`acquire`]. */
+    release() {
+        if (this._active > 0)
+            this._active -= 1;
+    }
+    /** Convenience: run `fn` while holding a slot, releasing on success or error. */
+    async run(fn) {
+        this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    get activeJobs() {
+        return this._active;
+    }
+    /** Load fraction in [0, 1]. Reported in heartbeats so the NodeScorer can
+     * down-rank busy nodes (ADR-008). */
+    get load() {
+        if (this.maxConcurrent === 0)
+            return 1.0;
+        return this._active / this.maxConcurrent;
+    }
+}
+exports.ConcurrencyGate = ConcurrencyGate;
+//# sourceMappingURL=concurrency.js.map