@iicp/client 0.5.7 → 0.6.0

package/dist/availability.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Time-based availability windows — operator capacity shaping by time-of-day.
+ *
+ * Port of iicp-adapter `scheduling/availability.py` (parity Block D, #340). Lets an
+ * operator dedicate different fractions of `maxConcurrent` at different times.
+ *
+ *   - start/end: "HH:MM" in local time.
+ *   - share: fraction of maxConcurrent (0.0 = closed, 1.0 = full).
+ *   - Outside all windows: 0.5 (available but not primary).
+ *   - No windows: always 1.0.
+ *
+ * The directory learns live load via heartbeats and scores accordingly (ADR-001) — it
+ * doesn't push scheduling to nodes.
+ */
+export interface Window {
+    start: string;
+    end: string;
+    share: number;
+}
+export declare class AvailabilityEvaluator {
+    private readonly windows;
+    constructor(windows?: Window[] | null);
+    /** Capacity share [0,1] for the current local time-of-day. */
+    currentShare(now?: Date): number;
+    /** Scale base maxConcurrent by the current share (floor 1 when share > 0).
+     * A base of 0 (operator explicitly disabled) stays 0. */
+    effectiveMaxConcurrent(baseMax: number, now?: Date): number;
+    isWithinWindow(now?: Date): boolean;
+}
+//# sourceMappingURL=availability.d.ts.map

package/dist/availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../src/availability.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;gBAEvB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAIrC,8DAA8D;IAC9D,YAAY,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM;IAc5C;6DACyD;IACzD,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM;IAOvE,cAAc,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO;CAIhD"}

package/dist/availability.js

@@ -0,0 +1,64 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Time-based availability windows — operator capacity shaping by time-of-day.
+ *
+ * Port of iicp-adapter `scheduling/availability.py` (parity Block D, #340). Lets an
+ * operator dedicate different fractions of `maxConcurrent` at different times.
+ *
+ *   - start/end: "HH:MM" in local time.
+ *   - share: fraction of maxConcurrent (0.0 = closed, 1.0 = full).
+ *   - Outside all windows: 0.5 (available but not primary).
+ *   - No windows: always 1.0.
+ *
+ * The directory learns live load via heartbeats and scores accordingly (ADR-001) — it
+ * doesn't push scheduling to nodes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AvailabilityEvaluator = void 0;
+function hhmm(d) {
+    const h = String(d.getHours()).padStart(2, "0");
+    const m = String(d.getMinutes()).padStart(2, "0");
+    return `${h}:${m}`;
+}
+class AvailabilityEvaluator {
+    windows;
+    constructor(windows) {
+        this.windows = windows ?? [];
+    }
+    /** Capacity share [0,1] for the current local time-of-day. */
+    currentShare(now = new Date()) {
+        if (this.windows.length === 0)
+            return 1.0;
+        const current = hhmm(now);
+        for (const w of this.windows) {
+            if (w.start <= w.end) {
+                if (w.start <= current && current <= w.end)
+                    return w.share;
+            }
+            else {
+                // Midnight-spanning window (e.g. 22:00–06:00)
+                if (current >= w.start || current <= w.end)
+                    return w.share;
+            }
+        }
+        return 0.5; // outside all windows
+    }
+    /** Scale base maxConcurrent by the current share (floor 1 when share > 0).
+     * A base of 0 (operator explicitly disabled) stays 0. */
+    effectiveMaxConcurrent(baseMax, now = new Date()) {
+        if (baseMax <= 0)
+            return 0;
+        const share = this.currentShare(now);
+        if (share <= 0.0)
+            return 0;
+        return Math.max(1, Math.floor(baseMax * share));
+    }
+    isWithinWindow(now = new Date()) {
+        if (this.windows.length === 0)
+            return true;
+        return this.currentShare(now) > 0.0;
+    }
+}
+exports.AvailabilityEvaluator = AvailabilityEvaluator;
+//# sourceMappingURL=availability.js.map

package/dist/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../src/availability.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;;;;;;;;GAaG;;;AAQH,SAAS,IAAI,CAAC,CAAO;IACnB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACrB,CAAC;AAED,MAAa,qBAAqB;IACf,OAAO,CAAW;IAEnC,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,8DAA8D;IAC9D,YAAY,CAAC,MAAY,IAAI,IAAI,EAAE;QACjC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG;oBAAE,OAAO,CAAC,CAAC,KAAK,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,8CAA8C;gBAC9C,IAAI,OAAO,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG;oBAAE,OAAO,CAAC,CAAC,KAAK,CAAC;YAC7D,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC,CAAC,sBAAsB;IACpC,CAAC;IAED;6DACyD;IACzD,sBAAsB,CAAC,OAAe,EAAE,MAAY,IAAI,IAAI,EAAE;QAC5D,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,KAAK,IAAI,GAAG;YAAE,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,MAAY,IAAI,IAAI,EAAE;QACnC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACtC,CAAC;CACF;AAnCD,sDAmCC"}

package/dist/backends/base.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared core for OpenAI-dialect backend handlers.
+ *
+ * vLLM, llama.cpp, LM Studio and Ollama all speak the OpenAI `/v1/*` HTTP dialect, so
+ * the request/response plumbing is identical — only the default port and the engine
+ * label in error messages differ. This module hosts that shared plumbing so the
+ * per-engine modules (openai_compat, vllm, llamacpp) stay thin.
+ *
+ * Port of iicp-adapter backends/{base,vllm,llamacpp,openai_compat} into the SDK's
+ * handler-factory style (tracker iicp.network#340; parity Block B).
+ */
+export declare const INTENT_TO_PATH: Record<string, string>;
+export interface BackendOptions {
+    /** Provider HTTP root (no trailing slash needed). */
+    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 type BackendHandler = (task: TaskHandlerInput) => Promise<TaskHandlerOutput>;
+/**
+ * Build a TaskHandler that proxies CALLs to an OpenAI-dialect server. `engine` is the
+ * label used in error messages (e.g. "vllm"); all engines share this body.
+ */
+export declare function buildOpenAiDialectHandler(engine: string, baseUrlRaw: string, model: string | undefined, apiKey: string, timeoutMs: number): BackendHandler;
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/backends/base.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIjD,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,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,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,cAAc,CA+EhB"}

package/dist/backends/base.js

@@ -0,0 +1,97 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Shared core for OpenAI-dialect backend handlers.
+ *
+ * vLLM, llama.cpp, LM Studio and Ollama all speak the OpenAI `/v1/*` HTTP dialect, so
+ * the request/response plumbing is identical — only the default port and the engine
+ * label in error messages differ. This module hosts that shared plumbing so the
+ * per-engine modules (openai_compat, vllm, llamacpp) stay thin.
+ *
+ * Port of iicp-adapter backends/{base,vllm,llamacpp,openai_compat} into the SDK's
+ * handler-factory style (tracker iicp.network#340; parity Block B).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INTENT_TO_PATH = void 0;
+exports.buildOpenAiDialectHandler = buildOpenAiDialectHandler;
+exports.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",
+};
+/**
+ * Build a TaskHandler that proxies CALLs to an OpenAI-dialect server. `engine` is the
+ * label used in error messages (e.g. "vllm"); all engines share this body.
+ */
+function buildOpenAiDialectHandler(engine, baseUrlRaw, model, apiKey, timeoutMs) {
+    const baseUrl = baseUrlRaw.replace(/\/$/, "");
+    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: `${engine}: task.payload must be a dict, got ${typeof payload}`,
+            };
+        }
+        const path = exports.INTENT_TO_PATH[intent];
+        if (!path) {
+            return {
+                error_code: 400,
+                error_message: `${engine}: unsupported intent ${JSON.stringify(intent)}; supported: ${JSON.stringify(Object.keys(exports.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: `${engine}: no model — either pass \`model\` to the backend factory ` +
+                    "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: `${engine}: backend timed out` };
+            }
+            return { error_code: 502, error_message: `${engine}: HTTP transport error: ${msg}` };
+        }
+        clearTimeout(t);
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => "");
+            return {
+                error_code: resp.status,
+                error_message: `${engine}: 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: `${engine}: upstream returned non-JSON: ${msg}` };
+        }
+        return { result: data };
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/backends/base.js.map

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

package/dist/backends/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Backend handler registry + selector.
+ *
+ * Each helper returns a TaskHandler suitable for IicpNode.serve() or IicpTcpServer.
+ * Use `getBackendHandler(type, opts)` to select one by name (e.g. from a CLI
+ * `--backend-type` flag).
+ */
+import { type BackendHandler, type BackendOptions } from "./base.js";
+export declare const BACKEND_TYPES: readonly ["openai_compat", "vllm", "llamacpp"];
+export type BackendType = (typeof BACKEND_TYPES)[number];
+/** Return a backend handler by name. Throws on an unknown type. */
+export declare function getBackendHandler(backendType: string, opts?: BackendOptions): BackendHandler;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAKrE,eAAO,MAAM,aAAa,gDAAiD,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAQzD,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,cAAc,CAQhG"}

package/dist/backends/index.js

@@ -0,0 +1,30 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Backend handler registry + selector.
+ *
+ * Each helper returns a TaskHandler suitable for IicpNode.serve() or IicpTcpServer.
+ * Use `getBackendHandler(type, opts)` to select one by name (e.g. from a CLI
+ * `--backend-type` flag).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKEND_TYPES = void 0;
+exports.getBackendHandler = getBackendHandler;
+const openai_compat_js_1 = require("./openai_compat.js");
+const vllm_js_1 = require("./vllm.js");
+const llamacpp_js_1 = require("./llamacpp.js");
+exports.BACKEND_TYPES = ["openai_compat", "vllm", "llamacpp"];
+const FACTORIES = {
+    openai_compat: openai_compat_js_1.openaiCompatHandler,
+    vllm: vllm_js_1.vllmHandler,
+    llamacpp: llamacpp_js_1.llamacppHandler,
+};
+/** Return a backend handler by name. Throws on an unknown type. */
+function getBackendHandler(backendType, opts = {}) {
+    const factory = FACTORIES[backendType];
+    if (!factory) {
+        throw new Error(`unknown backend_type ${JSON.stringify(backendType)}; choose one of ${JSON.stringify(exports.BACKEND_TYPES)}`);
+    }
+    return factory(opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;GAMG;;;AAiBH,8CAQC;AAtBD,yDAAyD;AACzD,uCAAwC;AACxC,+CAAgD;AAEnC,QAAA,aAAa,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAG5E,MAAM,SAAS,GAAkE;IAC/E,aAAa,EAAE,sCAAmB;IAClC,IAAI,EAAE,qBAAW;IACjB,QAAQ,EAAE,6BAAe;CAC1B,CAAC;AAEF,mEAAmE;AACnE,SAAgB,iBAAiB,CAAC,WAAmB,EAAE,OAAuB,EAAE;IAC9E,MAAM,OAAO,GAAG,SAAS,CAAC,WAA0B,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,qBAAa,CAAC,EAAE,CACtG,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/dist/backends/llamacpp.d.ts

@@ -0,0 +1,18 @@
+/**
+ * llama.cpp backend handler.
+ *
+ * The `llama-server` binary exposes an OpenAI-compatible `/v1/*` API, so this is a thin
+ * factory over the shared core with llama.cpp's default port (8080). Kept as a dedicated
+ * module so operators can select `backendType=llamacpp` explicitly. Port of iicp-adapter
+ * backends/llamacpp.py (parity Block B).
+ */
+import { type BackendHandler } from "./base.js";
+export interface LlamaCppOptions {
+    /** Provider HTTP root. Default: llama.cpp `http://localhost:8080/v1`. */
+    baseUrl?: string;
+    model?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+}
+export declare function llamacppHandler(opts?: LlamaCppOptions): BackendHandler;
+//# sourceMappingURL=llamacpp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llamacpp.d.ts","sourceRoot":"","sources":["../../src/backends/llamacpp.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,eAAoB,GAAG,cAAc,CAQ1E"}

package/dist/backends/llamacpp.js

@@ -0,0 +1,17 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * llama.cpp backend handler.
+ *
+ * The `llama-server` binary exposes an OpenAI-compatible `/v1/*` API, so this is a thin
+ * factory over the shared core with llama.cpp's default port (8080). Kept as a dedicated
+ * module so operators can select `backendType=llamacpp` explicitly. Port of iicp-adapter
+ * backends/llamacpp.py (parity Block B).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.llamacppHandler = llamacppHandler;
+const base_js_1 = require("./base.js");
+function llamacppHandler(opts = {}) {
+    return (0, base_js_1.buildOpenAiDialectHandler)("llamacpp", opts.baseUrl ?? "http://localhost:8080/v1", opts.model, opts.apiKey ?? "", opts.timeoutMs ?? 30000);
+}
+//# sourceMappingURL=llamacpp.js.map

package/dist/backends/llamacpp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llamacpp.js","sourceRoot":"","sources":["../../src/backends/llamacpp.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;;GAOG;;AAYH,0CAQC;AAlBD,uCAA2E;AAU3E,SAAgB,eAAe,CAAC,OAAwB,EAAE;IACxD,OAAO,IAAA,mCAAyB,EAC9B,UAAU,EACV,IAAI,CAAC,OAAO,IAAI,0BAA0B,EAC1C,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,MAAM,IAAI,EAAE,EACjB,IAAI,CAAC,SAAS,IAAI,KAAK,CACxB,CAAC;AACJ,CAAC"}

package/dist/backends/openai_compat.d.ts

@@ -1,8 +1,8 @@
 /**
- * OpenAI-compatible backend helper (Ollama / vLLM / LM Studio / OpenAI / ...).
+ * OpenAI-compatible backend helper (Ollama / 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.
+ * Thin factory over the shared `buildOpenAiDialectHandler` core. Returns a TaskHandler
+ * suitable for IicpNode.serve() AND IicpTcpServer.
  *
  *   import { openaiCompatHandler } from "@iicp/client";
  *
@@ -18,6 +18,7 @@
  *   urn:iicp:intent:llm:completion:v1  → /completions
  *   urn:iicp:intent:llm:embedding:v1   → /embeddings
  */
+import { type BackendHandler, type TaskHandlerInput, type TaskHandlerOutput } from "./base.js";
 export interface OpenAiCompatOptions {
     /** Provider HTTP root (no trailing slash needed). Default: Ollama `http://localhost:11434/v1`. */
     baseUrl?: string;
@@ -28,11 +29,6 @@ export interface OpenAiCompatOptions {
     /** 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>;
+export type { TaskHandlerInput, TaskHandlerOutput };
+export declare function openaiCompatHandler(opts?: OpenAiCompatOptions): BackendHandler;
 //# sourceMappingURL=openai_compat.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"openai_compat.d.ts","sourceRoot":"","sources":["../../src/backends/openai_compat.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAEnB,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,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,mBAAwB,GAAG,cAAc,CAQlF"}

package/dist/backends/openai_compat.js

@@ -1,10 +1,10 @@
 "use strict";
 // SPDX-License-Identifier: Apache-2.0
 /**
- * OpenAI-compatible backend helper (Ollama / vLLM / LM Studio / OpenAI / ...).
+ * OpenAI-compatible backend helper (Ollama / 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.
+ * Thin factory over the shared `buildOpenAiDialectHandler` core. Returns a TaskHandler
+ * suitable for IicpNode.serve() AND IicpTcpServer.
  *
  *   import { openaiCompatHandler } from "@iicp/client";
  *
@@ -22,81 +22,8 @@
  */
 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",
-};
+const base_js_1 = require("./base.js");
 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 };
-    };
+    return (0, base_js_1.buildOpenAiDialectHandler)("openai_compat", opts.baseUrl ?? "http://localhost:11434/v1", opts.model, opts.apiKey ?? "", opts.timeoutMs ?? 30000);
 }
 //# sourceMappingURL=openai_compat.js.map

package/dist/backends/openai_compat.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai_compat.js","sourceRoot":"","sources":["../../src/backends/openai_compat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openai_compat.js","sourceRoot":"","sources":["../../src/backends/openai_compat.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;;;;;;;;;;;;;;GAmBG;;AAsBH,kDAQC;AA5BD,uCAKmB;AAenB,SAAgB,mBAAmB,CAAC,OAA4B,EAAE;IAChE,OAAO,IAAA,mCAAyB,EAC9B,eAAe,EACf,IAAI,CAAC,OAAO,IAAI,2BAA2B,EAC3C,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,MAAM,IAAI,EAAE,EACjB,IAAI,CAAC,SAAS,IAAI,KAAK,CACxB,CAAC;AACJ,CAAC"}

package/dist/backends/vllm.d.ts

@@ -0,0 +1,19 @@
+/**
+ * vLLM backend handler.
+ *
+ * vLLM's OpenAI server (`python -m vllm.entrypoints.openai.api_server`) speaks the
+ * standard `/v1/*` dialect, so this is a thin factory over the shared core with vLLM's
+ * default port (8000). Kept as a dedicated module so operators can select
+ * `backendType=vllm` explicitly. Port of iicp-adapter backends/vllm.py (parity Block B).
+ */
+import { type BackendHandler } from "./base.js";
+export interface VllmOptions {
+    /** Provider HTTP root. Default: vLLM `http://localhost:8000/v1`. */
+    baseUrl?: string;
+    model?: string;
+    /** Optional — set only when vLLM was started with `--api-key`. */
+    apiKey?: string;
+    timeoutMs?: number;
+}
+export declare function vllmHandler(opts?: VllmOptions): BackendHandler;
+//# sourceMappingURL=vllm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vllm.d.ts","sourceRoot":"","sources":["../../src/backends/vllm.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,IAAI,GAAE,WAAgB,GAAG,cAAc,CAQlE"}

package/dist/backends/vllm.js

@@ -0,0 +1,17 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * vLLM backend handler.
+ *
+ * vLLM's OpenAI server (`python -m vllm.entrypoints.openai.api_server`) speaks the
+ * standard `/v1/*` dialect, so this is a thin factory over the shared core with vLLM's
+ * default port (8000). Kept as a dedicated module so operators can select
+ * `backendType=vllm` explicitly. Port of iicp-adapter backends/vllm.py (parity Block B).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vllmHandler = vllmHandler;
+const base_js_1 = require("./base.js");
+function vllmHandler(opts = {}) {
+    return (0, base_js_1.buildOpenAiDialectHandler)("vllm", opts.baseUrl ?? "http://localhost:8000/v1", opts.model, opts.apiKey ?? "", opts.timeoutMs ?? 30000);
+}
+//# sourceMappingURL=vllm.js.map

package/dist/backends/vllm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vllm.js","sourceRoot":"","sources":["../../src/backends/vllm.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;;GAOG;;AAaH,kCAQC;AAnBD,uCAA2E;AAW3E,SAAgB,WAAW,CAAC,OAAoB,EAAE;IAChD,OAAO,IAAA,mCAAyB,EAC9B,MAAM,EACN,IAAI,CAAC,OAAO,IAAI,0BAA0B,EAC1C,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,MAAM,IAAI,EAAE,EACjB,IAAI,CAAC,SAAS,IAAI,KAAK,CACxB,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -26,7 +26,7 @@ const readline = require("node:readline/promises");
 const node_process_1 = require("node:process");
 const node_js_1 = require("./node.js");
 const cip_policy_js_1 = require("./cip_policy.js");
-const openai_compat_js_1 = require("./backends/openai_compat.js");
+const index_js_1 = require("./backends/index.js");
 const identity_js_1 = require("./identity.js");
 function envOr(name, fallback) {
     const v = process.env[name];
@@ -57,6 +57,7 @@ function printHelp() {
         `  --model NAME               IICP_BACKEND_MODEL — model name (e.g. qwen2.5:0.5b)\n` +
         `  (or --node NAME            load both from ~/.iicp/nodes/<NAME>.json after \`iicp-node init\`)\n\n` +
         `serve optional:\n` +
+        `  --backend-type TYPE        IICP_BACKEND_TYPE — openai_compat | vllm | llamacpp (default openai_compat)\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` +
@@ -283,6 +284,10 @@ async function runServe(opts) {
         process.stderr.write("ERROR: --backend-url and --model are required (or IICP_BACKEND_URL / IICP_BACKEND_MODEL, or --node NAME).\n");
         return 2;
     }
+    if (!index_js_1.BACKEND_TYPES.includes(opts.backendType)) {
+        process.stderr.write(`ERROR: --backend-type must be one of ${JSON.stringify(index_js_1.BACKEND_TYPES)}.\n`);
+        return 2;
+    }
     const nodeId = opts.nodeId ||
         `sdk-${opts.model.replace(/:/g, "-")}-${(0, node_crypto_1.randomBytes)(4).toString("hex")}`;
     let publicEndpoint = opts.publicEndpoint || `http://localhost:${opts.port}`;
@@ -355,7 +360,7 @@ async function runServe(opts) {
             console.warn(`[iicp-node] NAT auto-detect failed: ${msg} — continuing with configured endpoint`);
         }
     }
-    const handler = (0, openai_compat_js_1.openaiCompatHandler)({
+    const handler = (0, index_js_1.getBackendHandler)(opts.backendType, {
         baseUrl: opts.backendUrl,
         model: opts.model,
     });
@@ -428,6 +433,7 @@ async function main(argv = process.argv.slice(2)) {
         options: {
             node: { type: "string" },
             "backend-url": { type: "string" },
+            "backend-type": { type: "string" },
             model: { type: "string" },
             "public-endpoint": { type: "string" },
             "directory-url": { type: "string" },
@@ -451,6 +457,8 @@ async function main(argv = process.argv.slice(2)) {
     const opts = {
         node: values.node ?? envOr("IICP_NODE_NAME") ?? "",
         backendUrl: values["backend-url"] ?? envOr("IICP_BACKEND_URL") ?? "",
+        backendType: values["backend-type"] ??
+            envOr("IICP_BACKEND_TYPE", "openai_compat"),
         model: values.model ?? envOr("IICP_BACKEND_MODEL") ?? "",
         publicEndpoint: values["public-endpoint"] ?? envOr("IICP_PUBLIC_ENDPOINT") ?? "",
         directoryUrl: values["directory-url"] ??