@iicp/client 0.2.0 → 0.5.3

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":";AAAA,sCAAsC;AACtC;;;;;;;;;;;;;;;;;;;GAmBG;;AA2BH,kDAgFC;AAzGD,MAAM,cAAc,GAA2B;IAC7C,6BAA6B,EAAE,mBAAmB;IAClD,mCAAmC,EAAE,cAAc;IACnD,kCAAkC,EAAE,aAAa;CAClD,CAAC;AAqBF,SAAgB,mBAAmB,CACjC,OAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,2BAA2B,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAE1C,OAAO,KAAK,UAAU,OAAO,CAAC,IAAsB;QAClD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACzG,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,aAAa,EAAE,mDAAmD,OAAO,OAAO,EAAE;aACnF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,aAAa,EAAE,qCAAqC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,SAAS,CACtG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CACnC,EAAE;aACJ,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAA4B,EAAE,GAAG,CAAE,OAAmC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC1F,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,aAAa,EACX,4EAA4E;oBAC5E,wCAAwC;aAC3C,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QAC/E,IAAI,MAAM;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,MAAM,EAAE,CAAC;QAE1D,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,IAAc,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE;gBACtC,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,kCAAkC,EAAE,CAAC;YAChF,CAAC;YACD,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,wCAAwC,GAAG,EAAE,EAAE,CAAC;QAC3F,CAAC;QACD,YAAY,CAAC,CAAC,CAAC,CAAC;QAEhB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/C,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,aAAa,EAAE,2BAA2B,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;aAC/E,CAAC;QACJ,CAAC;QAED,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,8CAA8C,GAAG,EAAE,EAAE,CAAC;QACjG,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC,CAAC;AACJ,CAAC"}

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/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

package/dist/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../src/concurrency.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;;;;;;;GAYG;;;AAEH,0EAA0E;AAC1E,MAAa,qBAAsB,SAAQ,KAAK;IACrC,aAAa,CAAS;IAC/B,YAAY,aAAqB;QAC/B,KAAK,CAAC,mBAAmB,aAAa,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAPD,sDAOC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,eAAe;IACjB,aAAa,CAAS;IACvB,OAAO,GAAG,CAAC,CAAC;IAEpB,YAAY,aAAqB;QAC/B,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,oCAAoC,aAAa,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,oEAAoE;IACpE,OAAO;QACL,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,+CAA+C;IAC/C,OAAO;QACL,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,GAAG,CAAI,EAAoB;QAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;yCACqC;IACrC,IAAI,IAAI;QACN,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC;IAC3C,CAAC;CACF;AA5CD,0CA4CC"}

package/dist/conformance.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Self-conformance probes — operator-side health verification.
+ *
+ * TypeScript port of iicp-client-python's conformance.py (iter-1435).
+ * Tier 2 Item 4 of the iicp-adapter → iicp-client migration (#340).
+ *
+ * Operators run these periodically (or in their /health endpoint) to confirm
+ * their hybrid node is fully conformant without depending on the external
+ * REACH daemon. Four probes mirror the adapter set:
+ *
+ *   CONF-REG-01    — node_id + node_token set
+ *   CONF-HEALTH-01 — local /iicp/health returns 200 with required schema
+ *   CONF-REACH-01  — directory /v1/probe confirms internet reachability
+ *   CONF-DISC-01   — own node_id appears in /v1/discover NODELIST
+ */
+export interface ProbeResult {
+    testId: string;
+    passed: boolean;
+    message: string;
+    latencyMs: number | null;
+}
+export interface ConformanceReport {
+    passCount: number;
+    failCount: number;
+    lastRunAt: string;
+    tests: ProbeResult[];
+}
+/**
+ * Run the four conformance probes concurrently and return a report.
+ * Pass `nodeToken` to make CONF-REG-01 verify the token in addition to node_id.
+ */
+export declare function runConformanceChecks(node: any, localPort?: number, opts?: {
+    nodeToken?: string;
+}): Promise<ConformanceReport>;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAqND;;;GAGG;AACH,wBAAsB,oBAAoB,CAExC,IAAI,EAAE,GAAG,EACT,SAAS,GAAE,MAAa,EACxB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAgB5B"}