@iicp/client 0.5.7 → 0.7.0

package/dist/otel_tracer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OpenTelemetry span helpers for IICP SDK nodes — ADR-014 TRACE-01/TRACE-02.
+ *
+ * Node-side spans:
+ *   iicp.task.validate  (TRACE-01) — request parsing, nonce check, auth
+ *   iicp.task.execute   (TRACE-02) — handler dispatch and response
+ *
+ * Behaviour:
+ *   - When @opentelemetry/api is installed AND OTEL_EXPORTER_OTLP_ENDPOINT is set:
+ *     exports spans to the configured collector via OTLP/HTTP.
+ *   - Otherwise: uses a no-op tracer — call sites need no conditionals.
+ *
+ * W3C traceparent propagation is handled in node.ts at the HTTP layer; this
+ * module manages the span lifecycle within the node process.
+ */
+interface SpanLike {
+    setAttribute(key: string, value: string | number | boolean): void;
+    recordException(err: Error): void;
+    end(): void;
+}
+/** TRACE-01: iicp.task.validate — wraps request parsing and auth check. */
+export declare function withTaskValidateSpan<T>(taskId: string, fn: (span: SpanLike) => T): Promise<T>;
+/** TRACE-02: iicp.task.execute — wraps handler dispatch and response. */
+export declare function withTaskExecuteSpan<T>(taskId: string, intent: string, fn: (span: SpanLike) => Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=otel_tracer.d.ts.map

package/dist/otel_tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel_tracer.d.ts","sourceRoot":"","sources":["../src/otel_tracer.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;GAcG;AAEH,UAAU,QAAQ;IAChB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAClE,eAAe,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAClC,GAAG,IAAI,IAAI,CAAC;CACb;AAqDD,2EAA2E;AAC3E,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CASnG;AAED,yEAAyE;AACzE,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAa3H"}

package/dist/otel_tracer.js

@@ -0,0 +1,96 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * OpenTelemetry span helpers for IICP SDK nodes — ADR-014 TRACE-01/TRACE-02.
+ *
+ * Node-side spans:
+ *   iicp.task.validate  (TRACE-01) — request parsing, nonce check, auth
+ *   iicp.task.execute   (TRACE-02) — handler dispatch and response
+ *
+ * Behaviour:
+ *   - When @opentelemetry/api is installed AND OTEL_EXPORTER_OTLP_ENDPOINT is set:
+ *     exports spans to the configured collector via OTLP/HTTP.
+ *   - Otherwise: uses a no-op tracer — call sites need no conditionals.
+ *
+ * W3C traceparent propagation is handled in node.ts at the HTTP layer; this
+ * module manages the span lifecycle within the node process.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTaskValidateSpan = withTaskValidateSpan;
+exports.withTaskExecuteSpan = withTaskExecuteSpan;
+class NoopSpan {
+    setAttribute(_key, _value) { }
+    recordException(_err) { }
+    end() { }
+}
+class NoopTracer {
+    startSpan(_name) { return new NoopSpan(); }
+}
+let _tracer = null;
+let _initialised = false;
+async function _init() {
+    if (_tracer)
+        return _tracer;
+    if (_initialised)
+        return new NoopTracer();
+    _initialised = true;
+    const endpoint = process.env["OTEL_EXPORTER_OTLP_ENDPOINT"] ?? "";
+    try {
+        const api = await import("@opentelemetry/api").catch(() => null);
+        if (!api) {
+            _tracer = new NoopTracer();
+            return _tracer;
+        }
+        if (endpoint) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const sdk = await import("@opentelemetry/sdk-trace-node").catch(() => null);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const exp = await import("@opentelemetry/exporter-trace-otlp-http").catch(() => null);
+            if (sdk && exp) {
+                const provider = new sdk.NodeTracerProvider();
+                const exporter = new exp.OTLPTraceExporter({ url: endpoint });
+                provider.addSpanProcessor(new sdk.BatchSpanProcessor(exporter));
+                provider.register();
+                _tracer = api.trace.getTracer("iicp.client");
+                return _tracer;
+            }
+        }
+        _tracer = api.trace.getTracer("iicp.client");
+        return _tracer;
+    }
+    catch {
+        _tracer = new NoopTracer();
+        return _tracer;
+    }
+}
+/** TRACE-01: iicp.task.validate — wraps request parsing and auth check. */
+async function withTaskValidateSpan(taskId, fn) {
+    const tracer = await _init();
+    const span = tracer.startSpan("iicp.task.validate");
+    span.setAttribute("iicp.task_id", taskId);
+    try {
+        return fn(span);
+    }
+    finally {
+        span.end();
+    }
+}
+/** TRACE-02: iicp.task.execute — wraps handler dispatch and response. */
+async function withTaskExecuteSpan(taskId, intent, fn) {
+    const tracer = await _init();
+    const span = tracer.startSpan("iicp.task.execute");
+    span.setAttribute("iicp.task_id", taskId);
+    span.setAttribute("iicp.intent", intent);
+    try {
+        return await fn(span);
+    }
+    catch (err) {
+        if (err instanceof Error)
+            span.recordException(err);
+        throw err;
+    }
+    finally {
+        span.end();
+    }
+}
+//# sourceMappingURL=otel_tracer.js.map

package/dist/otel_tracer.js.map

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

package/dist/peer_manager.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Phase 2 mesh layer — peer discovery, gossip, and relay support (parity Block F, #340).
+ *
+ * Port of iicp-adapter `network/peer_manager.py` + `handlers/{peers,relay}.py` (ADR-009,
+ * ADR-022). Bootstraps an initial peer set from the directory, gossips a random known peer
+ * every 30s with an HMAC-SHA256-signed exchange (reusing the pricing HMAC key), prunes
+ * peers idle for 90s, and resolves relay targets for POST /v1/relay forwarding.
+ */
+export interface PeerInfo {
+    node_id: string;
+    endpoint: string;
+    region: string;
+    last_seen: string;
+    last_contact: number;
+    /** R3: relay election fields — advertised in gossip exchange */
+    relay_capable?: boolean;
+    relay_accept_port?: number;
+    relay_load?: number;
+}
+export declare class PeerManager {
+    private readonly directoryUrl;
+    private readonly nodeToken;
+    private peers;
+    private ownId;
+    private ownEndpoint;
+    private readonly ownRelayCapable;
+    private readonly ownRelayAcceptPort;
+    private timer;
+    constructor(directoryUrl: string, nodeToken?: string, opts?: {
+        relayCapable?: boolean;
+        relayAcceptPort?: number;
+    });
+    getPeers(): PeerInfo[];
+    relayTarget(nodeId: string): PeerInfo | undefined;
+    /** Merge incoming peer entries. Returns the count of newly added peers. */
+    mergePeers(incoming: Array<Partial<PeerInfo>>): number;
+    /** R3: return relay-capable peers, for relay election. */
+    getRelayCandidates(): PeerInfo[];
+    /** R3: deterministic relay election — rank by load, tiebreak by SHA-256 hash. */
+    electRelay(workerId: string): Promise<(PeerInfo & {
+        _relayHost: string;
+        _relayPort: number;
+    }) | null>;
+    /** Drop peers not contacted within the expiry window. Returns count pruned. */
+    prune(): number;
+    /** Verify an inbound /v1/peers HMAC signature. No token configured → accept. */
+    verifyExchange(body: string, signature: string | undefined | null): boolean;
+    start(nodeId: string, ownEndpoint?: string): Promise<void>;
+    stop(): void;
+    gossipRound(): Promise<void>;
+    private bootstrap;
+    private exchange;
+}
+//# sourceMappingURL=peer_manager.d.ts.map

package/dist/peer_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer_manager.d.ts","sourceRoot":"","sources":["../src/peer_manager.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAQH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,KAAK,CAA6C;gBAGxD,YAAY,EAAE,MAAM,EACpB,SAAS,SAAK,EACd,IAAI,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAO;IAQjE,QAAQ,IAAI,QAAQ,EAAE;IAItB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIjD,2EAA2E;IAC3E,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM;IAqBtD,0DAA0D;IAC1D,kBAAkB,IAAI,QAAQ,EAAE;IAIhC,iFAAiF;IAC3E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,QAAQ,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAsB3G,+EAA+E;IAC/E,KAAK,IAAI,MAAM;IAYf,gFAAgF;IAChF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO;IAMrE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D,IAAI,IAAI,IAAI;IAIN,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;YAWpB,SAAS;YAaT,QAAQ;CAkCvB"}

package/dist/peer_manager.js

@@ -0,0 +1,184 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Phase 2 mesh layer — peer discovery, gossip, and relay support (parity Block F, #340).
+ *
+ * Port of iicp-adapter `network/peer_manager.py` + `handlers/{peers,relay}.py` (ADR-009,
+ * ADR-022). Bootstraps an initial peer set from the directory, gossips a random known peer
+ * every 30s with an HMAC-SHA256-signed exchange (reusing the pricing HMAC key), prunes
+ * peers idle for 90s, and resolves relay targets for POST /v1/relay forwarding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeerManager = void 0;
+const pricing_js_1 = require("./pricing.js");
+const GOSSIP_INTERVAL_MS = 30_000;
+const PEER_EXPIRY_MS = 90_000;
+const BOOTSTRAP_LIMIT = 5;
+class PeerManager {
+    directoryUrl;
+    nodeToken;
+    peers = new Map();
+    ownId = "";
+    ownEndpoint = "";
+    ownRelayCapable;
+    ownRelayAcceptPort;
+    timer;
+    constructor(directoryUrl, nodeToken = "", opts = {}) {
+        this.directoryUrl = directoryUrl.replace(/\/$/, "");
+        this.nodeToken = nodeToken;
+        this.ownRelayCapable = opts.relayCapable ?? false;
+        this.ownRelayAcceptPort = opts.relayAcceptPort ?? 9485;
+    }
+    getPeers() {
+        return [...this.peers.values()];
+    }
+    relayTarget(nodeId) {
+        return this.peers.get(nodeId);
+    }
+    /** Merge incoming peer entries. Returns the count of newly added peers. */
+    mergePeers(incoming) {
+        const now = Date.now();
+        let added = 0;
+        for (const p of incoming) {
+            const nid = p.node_id;
+            if (!nid || nid === this.ownId)
+                continue;
+            if (!this.peers.has(nid))
+                added++;
+            this.peers.set(nid, {
+                node_id: nid,
+                endpoint: p.endpoint ?? "",
+                region: p.region ?? "",
+                last_seen: p.last_seen ?? "",
+                last_contact: now,
+                relay_capable: p.relay_capable ?? false,
+                relay_accept_port: p.relay_accept_port ?? 9485,
+                relay_load: p.relay_load ?? 0,
+            });
+        }
+        return added;
+    }
+    /** R3: return relay-capable peers, for relay election. */
+    getRelayCandidates() {
+        return [...this.peers.values()].filter((p) => p.relay_capable && p.endpoint);
+    }
+    /** R3: deterministic relay election — rank by load, tiebreak by SHA-256 hash. */
+    async electRelay(workerId) {
+        const { createHash } = await import("node:crypto");
+        const candidates = this.getRelayCandidates();
+        if (candidates.length === 0)
+            return null;
+        const scored = candidates.map((p) => {
+            const load = p.relay_load ?? 0;
+            const hash = createHash("sha256").update(`${workerId}:${p.node_id}`).digest("hex");
+            return { p, score: [load, hash] };
+        });
+        scored.sort((a, b) => {
+            if (a.score[0] !== b.score[0])
+                return a.score[0] - b.score[0];
+            return a.score[1] < b.score[1] ? -1 : 1;
+        });
+        const elected = scored[0].p;
+        const url = new URL(elected.endpoint.startsWith("http") ? elected.endpoint : `http://${elected.endpoint}`);
+        return {
+            ...elected,
+            _relayHost: url.hostname,
+            _relayPort: elected.relay_accept_port ?? 9485,
+        };
+    }
+    /** Drop peers not contacted within the expiry window. Returns count pruned. */
+    prune() {
+        const cutoff = Date.now() - PEER_EXPIRY_MS;
+        let pruned = 0;
+        for (const [nid, p] of this.peers) {
+            if (p.last_contact < cutoff) {
+                this.peers.delete(nid);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    /** Verify an inbound /v1/peers HMAC signature. No token configured → accept. */
+    verifyExchange(body, signature) {
+        if (!this.nodeToken)
+            return true;
+        if (!signature)
+            return false;
+        return (0, pricing_js_1.signBody)(body, this.nodeToken) === signature;
+    }
+    async start(nodeId, ownEndpoint = "") {
+        this.ownId = nodeId;
+        this.ownEndpoint = ownEndpoint;
+        await this.bootstrap();
+        this.timer = setInterval(() => {
+            void this.gossipRound();
+        }, GOSSIP_INTERVAL_MS);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+    }
+    async gossipRound() {
+        const peers = this.getPeers();
+        if (peers.length === 0) {
+            await this.bootstrap();
+            return;
+        }
+        const target = peers[Math.floor(Math.random() * peers.length)];
+        await this.exchange(target);
+        this.prune();
+    }
+    async bootstrap() {
+        try {
+            const url = `${this.directoryUrl}/v1/bootstrap?limit=${BOOTSTRAP_LIMIT}`;
+            const resp = await fetch(url, { signal: AbortSignal.timeout(5000) });
+            if (resp.ok) {
+                const body = (await resp.json());
+                this.mergePeers(body.peers ?? []);
+            }
+        }
+        catch {
+            /* directory unreachable — keep persisted/known peers */
+        }
+    }
+    async exchange(target) {
+        // R3: send full peer objects + own relay entry so recipients can elect us as a relay.
+        const peers = [...this.peers.values()];
+        const knownPeers = [...peers];
+        if (this.ownId) {
+            knownPeers.push({
+                node_id: this.ownId,
+                endpoint: this.ownEndpoint,
+                relay_capable: this.ownRelayCapable,
+                relay_accept_port: this.ownRelayAcceptPort,
+                relay_load: 0,
+            });
+        }
+        const body = JSON.stringify({ known_peers: knownPeers });
+        const headers = { "Content-Type": "application/json" };
+        if (this.nodeToken)
+            headers["X-IICP-Signature"] = (0, pricing_js_1.signBody)(body, this.nodeToken);
+        try {
+            const resp = await fetch(`${target.endpoint.replace(/\/$/, "")}/v1/peers`, {
+                method: "POST",
+                headers,
+                body,
+                signal: AbortSignal.timeout(5000),
+            });
+            if (resp.ok) {
+                const data = (await resp.json());
+                this.mergePeers(data.peers ?? []);
+                const t = this.peers.get(target.node_id);
+                if (t)
+                    t.last_contact = Date.now();
+            }
+        }
+        catch {
+            const t = this.peers.get(target.node_id);
+            if (t)
+                t.last_contact = 0;
+        }
+    }
+}
+exports.PeerManager = PeerManager;
+//# sourceMappingURL=peer_manager.js.map

package/dist/peer_manager.js.map

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

package/dist/relay_session.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Relay-as-last-resort — ADR-041 tier-3, Part 3 R1 (#341).
+ *
+ * TypeScript port of iicp-client-python/relay_session.py.
+ * Workers behind CGNAT hold an outbound IICP-TCP connection here.
+ * The relay pushes CALL frames down when /v1/relay is invoked and routes
+ * RESPONSE frames back to the waiting HTTP handler.
+ */
+import * as net from "node:net";
+export declare class RelayWorkerSession {
+    readonly workerId: string;
+    private readonly _socket;
+    private readonly _pending;
+    private _writeLocked;
+    constructor(workerId: string, socket: net.Socket);
+    /** Push a task CALL to the worker and await the RESPONSE (via Promise). */
+    forwardTask(task: unknown, timeoutMs?: number): Promise<Record<string, unknown>>;
+    /** Called by relay accept server when a RESPONSE arrives from the worker. */
+    onResponse(callId: string, result: Record<string, unknown>): void;
+}
+export declare class RelaySessionRegistry {
+    private readonly _sessions;
+    bind(workerId: string, session: RelayWorkerSession): void;
+    unbind(workerId: string): void;
+    get(workerId: string): RelayWorkerSession | undefined;
+    isBound(workerId: string): boolean;
+    boundWorkerIds(): string[];
+}
+export declare class RelayAcceptServer {
+    private readonly _registry;
+    private readonly _host;
+    private readonly _port;
+    private _server?;
+    constructor(registry: RelaySessionRegistry, opts?: {
+        host?: string;
+        port?: number;
+    });
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private _handleConnection;
+}
+//# sourceMappingURL=relay_session.d.ts.map

package/dist/relay_session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay_session.d.ts","sourceRoot":"","sources":["../src/relay_session.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AA0ChC,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgE;IACzF,OAAO,CAAC,YAAY,CAAS;gBAEjB,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM;IAKhD,2EAA2E;IACrE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,SAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAyBvF,6EAA6E;IAC7E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAOlE;AAID,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IAEnE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIzD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIrD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlC,cAAc,IAAI,MAAM,EAAE;CAG3B;AAID,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAa;gBAEjB,QAAQ,EAAE,oBAAoB,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO;IAMvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAUP,iBAAiB;CAkGhC"}