@iicp/client 0.7.100 → 0.7.102

package/dist/mcp_negotiation.js

@@ -0,0 +1,94 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/** MCP protocol-era negotiation and stateless request helpers. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpNegotiationError = exports.SUPPORTED_MCP_REVISIONS = exports.MODERN_MCP_REVISION = exports.LEGACY_MCP_REVISION = void 0;
+exports.evaluateMcpEra = evaluateMcpEra;
+exports.buildModernMcpRequest = buildModernMcpRequest;
+exports.validateModernMcpResponse = validateModernMcpResponse;
+exports.LEGACY_MCP_REVISION = "2025-11-25";
+exports.MODERN_MCP_REVISION = "2026-07-28";
+exports.SUPPORTED_MCP_REVISIONS = [exports.LEGACY_MCP_REVISION, exports.MODERN_MCP_REVISION];
+const SUPPORTED_EXTENSIONS = new Set(["tasks", "skills", "apps"]);
+class McpNegotiationError extends Error {
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+    }
+}
+exports.McpNegotiationError = McpNegotiationError;
+function evaluateMcpEra(input) {
+    const authorizationFailures = [
+        ["oauth_issuer_matches", "oauth_issuer_mismatch"],
+        ["oauth_audience_matches", "oauth_audience_mismatch"],
+        ["resource_indicator_present", "missing_resource_indicator"],
+        ["protected_resource_metadata_valid", "invalid_protected_resource_metadata"],
+        ["pkce_valid", "pkce_required"],
+        ["consent_granted", "consent_required"],
+        ["audit_output_redacted", "audit_redaction_required"],
+    ];
+    for (const [field, reason] of authorizationFailures) {
+        if (input[field] === false)
+            return { accepted: false, reason };
+    }
+    if (input["downstream_credential_source"] === "caller")
+        return { accepted: false, reason: "credential_passthrough_prohibited" };
+    if (input["server_identity_matches_selected_endpoint"] === false)
+        return { accepted: false, reason: "server_identity_mismatch" };
+    if (input["modern_request_failed"] && !input["legacy_authentication_available"])
+        return { accepted: false, reason: "unauthenticated_downgrade" };
+    const extension = input["extension"];
+    if (typeof extension === "string" && !SUPPORTED_EXTENSIONS.has(extension))
+        return { accepted: false, reason: "unsupported_extension" };
+    const offered = input["offered_revision"];
+    if (offered === exports.MODERN_MCP_REVISION) {
+        if (input["protocol_header_present"] === false)
+            return { accepted: false, reason: "missing_protocol_version" };
+        if (input["method_header_matches"] === false || input["name_header_matches"] === false)
+            return { accepted: false, reason: "header_body_mismatch" };
+        if (input["reserved_meta_valid"] === false)
+            return { accepted: false, reason: "malformed_reserved_metadata" };
+        const peer = Array.isArray(input["peer_supported_revisions"]) ? input["peer_supported_revisions"] : [];
+        if (peer.length === 0 || peer.includes(exports.MODERN_MCP_REVISION)) {
+            return input["request_state_explicit"]
+                ? { accepted: true, state_source: "request" }
+                : { accepted: true, era: "modern", session_mode: "stateless" };
+        }
+        if (peer.includes(exports.LEGACY_MCP_REVISION) && input["legacy_revision_explicitly_offered"] && input["security_requirements_preserved"])
+            return { accepted: true, era: "legacy", reason: "explicit_mutual_downgrade" };
+        return { accepted: false, reason: "unsupported_revision" };
+    }
+    if (offered === exports.LEGACY_MCP_REVISION) {
+        const peer = Array.isArray(input["peer_supported_revisions"]) ? input["peer_supported_revisions"] : [];
+        if (peer.length === 0 || peer.includes(exports.LEGACY_MCP_REVISION))
+            return { accepted: true, era: "legacy", session_mode: "negotiated" };
+    }
+    return { accepted: false, reason: "unsupported_revision" };
+}
+function buildModernMcpRequest(input) {
+    const extensions = input.extensions ?? [];
+    if (extensions.some((extension) => !SUPPORTED_EXTENSIONS.has(extension)))
+        throw new McpNegotiationError("unsupported_extension");
+    const meta = {
+        protocolVersion: exports.MODERN_MCP_REVISION,
+        client: { name: input.clientName ?? "iicp-gateway" },
+    };
+    if (extensions.length)
+        meta["extensions"] = extensions;
+    if (input.requestState)
+        meta["requestState"] = input.requestState;
+    return {
+        headers: { "MCP-Protocol-Version": exports.MODERN_MCP_REVISION, "Mcp-Method": input.method, "Mcp-Name": input.name },
+        body: { jsonrpc: "2.0", id: input.requestId, method: input.method, params: { ...input.params, _meta: meta } },
+    };
+}
+function validateModernMcpResponse(data, expectedServerName) {
+    const meta = data["_meta"];
+    if (!meta || meta["protocolVersion"] !== exports.MODERN_MCP_REVISION)
+        throw new McpNegotiationError("malformed_reserved_metadata");
+    const server = meta["server"];
+    if (!server || server["name"] !== expectedServerName)
+        throw new McpNegotiationError("server_identity_mismatch");
+}
+//# sourceMappingURL=mcp_negotiation.js.map

package/dist/mcp_negotiation.js.map

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

package/dist/native_call_identity.d.ts

@@ -0,0 +1,12 @@
+/** Fail-closed identity validation for negotiated native lifecycle CALLs. */
+export declare const LIFECYCLE_PROFILE = "urn:iicp:profile:service-lifecycle:v1";
+export declare class NativeCallIdentityError extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+export declare class NativeCallIdentityRegistry {
+    private readonly tasks;
+    private readonly calls;
+    accept(call: Record<string, unknown>): void;
+}
+//# sourceMappingURL=native_call_identity.d.ts.map

package/dist/native_call_identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_call_identity.d.ts","sourceRoot":"","sources":["../src/native_call_identity.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,eAAO,MAAM,iBAAiB,0CAA0C,CAAC;AAEzE,qBAAa,uBAAwB,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIlC;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAE3C,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAsB5C"}

package/dist/native_call_identity.js

@@ -0,0 +1,44 @@
+"use strict";
+/** Fail-closed identity validation for negotiated native lifecycle CALLs. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeCallIdentityRegistry = exports.NativeCallIdentityError = exports.LIFECYCLE_PROFILE = void 0;
+exports.LIFECYCLE_PROFILE = "urn:iicp:profile:service-lifecycle:v1";
+class NativeCallIdentityError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "NativeCallIdentityError";
+    }
+}
+exports.NativeCallIdentityError = NativeCallIdentityError;
+class NativeCallIdentityRegistry {
+    tasks = new Map();
+    calls = new Set();
+    accept(call) {
+        if (call.profile !== exports.LIFECYCLE_PROFILE)
+            return;
+        const taskId = call.task_id;
+        const callId = call.call_id;
+        const idempotencyKey = call.idempotency_key;
+        if (typeof taskId !== "string" || taskId.length === 0) {
+            throw new NativeCallIdentityError("missing_task_id");
+        }
+        if (typeof callId !== "string" || callId.length === 0) {
+            throw new NativeCallIdentityError("missing_call_id");
+        }
+        if (typeof idempotencyKey !== "string" || idempotencyKey.length === 0) {
+            throw new NativeCallIdentityError("missing_idempotency_key");
+        }
+        if (this.calls.has(callId))
+            throw new NativeCallIdentityError("call_id_reuse");
+        const knownKey = this.tasks.get(taskId);
+        if (knownKey !== undefined && knownKey !== idempotencyKey) {
+            throw new NativeCallIdentityError("task_identity_conflict");
+        }
+        this.tasks.set(taskId, idempotencyKey);
+        this.calls.add(callId);
+    }
+}
+exports.NativeCallIdentityRegistry = NativeCallIdentityRegistry;
+//# sourceMappingURL=native_call_identity.js.map

package/dist/native_call_identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_call_identity.js","sourceRoot":"","sources":["../src/native_call_identity.ts"],"names":[],"mappings":";AAAA,6EAA6E;;;AAEhE,QAAA,iBAAiB,GAAG,uCAAuC,CAAC;AAEzE,MAAa,uBAAwB,SAAQ,KAAK;IAC3B;IAArB,YAAqB,IAAY;QAC/B,KAAK,CAAC,IAAI,CAAC,CAAC;QADO,SAAI,GAAJ,IAAI,CAAQ;QAE/B,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC;AAED,MAAa,0BAA0B;IACpB,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClC,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,MAAM,CAAC,IAA6B;QAClC,IAAI,IAAI,CAAC,OAAO,KAAK,yBAAiB;YAAE,OAAO;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC;QAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,uBAAuB,CAAC,yBAAyB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,uBAAuB,CAAC,eAAe,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAC1D,MAAM,IAAI,uBAAuB,CAAC,wBAAwB,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;CACF;AA1BD,gEA0BC"}

package/dist/native_response_sequence.d.ts

@@ -0,0 +1,32 @@
+/** Transport-independent validation for negotiated native RESPONSE sequences. */
+export type NativeLifecycleEnvelope = {
+    task_id: string;
+    sequence: number;
+    event: string;
+    is_final: boolean;
+};
+export type NativeResponseFrame = {
+    session_id: string;
+    call_id: string;
+    status: string;
+    is_final: boolean;
+    lifecycle: NativeLifecycleEnvelope;
+    result?: unknown;
+    error?: unknown;
+    tokens_used?: number;
+};
+export declare class NativeResponseSequenceError extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+export declare class NativeResponseSequence {
+    private readonly sessionId;
+    private readonly callId;
+    private readonly taskId;
+    private nextSequence;
+    private terminalSeen;
+    constructor(sessionId: string, callId: string, taskId: string);
+    accept(frame: NativeResponseFrame): void;
+    finish(): void;
+}
+//# sourceMappingURL=native_response_sequence.d.ts.map

package/dist/native_response_sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_response_sequence.d.ts","sourceRoot":"","sources":["../src/native_response_sequence.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,qBAAa,2BAA4B,SAAQ,KAAK;aACxB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAGzC;AAED,qBAAa,sBAAsB;IAK/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAS;gBAGV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;IAGjC,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAyBxC,MAAM,IAAI,IAAI;CAGf"}

package/dist/native_response_sequence.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeResponseSequence = exports.NativeResponseSequenceError = void 0;
+class NativeResponseSequenceError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+    }
+}
+exports.NativeResponseSequenceError = NativeResponseSequenceError;
+class NativeResponseSequence {
+    sessionId;
+    callId;
+    taskId;
+    nextSequence = 0;
+    terminalSeen = false;
+    constructor(sessionId, callId, taskId) {
+        this.sessionId = sessionId;
+        this.callId = callId;
+        this.taskId = taskId;
+    }
+    accept(frame) {
+        if (this.terminalSeen)
+            throw new NativeResponseSequenceError("response_after_terminal");
+        if (!frame.lifecycle)
+            throw new NativeResponseSequenceError("missing_lifecycle");
+        if (frame.session_id !== this.sessionId)
+            throw new NativeResponseSequenceError("session_id_drift");
+        if (frame.call_id !== this.callId)
+            throw new NativeResponseSequenceError("call_id_drift");
+        if (frame.lifecycle.task_id !== this.taskId)
+            throw new NativeResponseSequenceError("task_id_drift");
+        if (frame.lifecycle.sequence !== this.nextSequence)
+            throw new NativeResponseSequenceError("sequence_drift");
+        if (frame.is_final !== frame.lifecycle.is_final)
+            throw new NativeResponseSequenceError("finality_disagreement");
+        const expectedEvents = {
+            partial: new Set(["partial"]),
+            success: new Set(["completed"]),
+            error: new Set(["failed", "cancelled"]),
+            timeout: new Set(["timed_out", "expired"]),
+        };
+        if (!expectedEvents[frame.status]?.has(frame.lifecycle.event)) {
+            throw new NativeResponseSequenceError("status_event_disagreement");
+        }
+        if ((frame.status === "partial" && frame.is_final) || (frame.status !== "partial" && !frame.is_final)) {
+            throw new NativeResponseSequenceError("terminal_flag_mismatch");
+        }
+        this.nextSequence += 1;
+        this.terminalSeen = frame.is_final;
+    }
+    finish() {
+        if (!this.terminalSeen)
+            throw new NativeResponseSequenceError("missing_terminal_response");
+    }
+}
+exports.NativeResponseSequence = NativeResponseSequence;
+//# sourceMappingURL=native_response_sequence.js.map

package/dist/native_response_sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_response_sequence.js","sourceRoot":"","sources":["../src/native_response_sequence.ts"],"names":[],"mappings":";;;AAmBA,MAAa,2BAA4B,SAAQ,KAAK;IACxB;IAA5B,YAA4B,IAAY;QACtC,KAAK,CAAC,IAAI,CAAC,CAAC;QADc,SAAI,GAAJ,IAAI,CAAQ;IAExC,CAAC;CACF;AAJD,kEAIC;AAED,MAAa,sBAAsB;IAKd;IACA;IACA;IANX,YAAY,GAAG,CAAC,CAAC;IACjB,YAAY,GAAG,KAAK,CAAC;IAE7B,YACmB,SAAiB,EACjB,MAAc,EACd,MAAc;QAFd,cAAS,GAAT,SAAS,CAAQ;QACjB,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,MAAM,CAAC,KAA0B;QAC/B,IAAI,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,2BAA2B,CAAC,yBAAyB,CAAC,CAAC;QACxF,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,MAAM,IAAI,2BAA2B,CAAC,mBAAmB,CAAC,CAAC;QACjF,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;QACnG,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,2BAA2B,CAAC,eAAe,CAAC,CAAC;QAC1F,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,2BAA2B,CAAC,eAAe,CAAC,CAAC;QACpG,IAAI,KAAK,CAAC,SAAS,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,2BAA2B,CAAC,gBAAgB,CAAC,CAAC;QAC5G,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,SAAS,CAAC,QAAQ;YAAE,MAAM,IAAI,2BAA2B,CAAC,uBAAuB,CAAC,CAAC;QAEhH,MAAM,cAAc,GAAgC;YAClD,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;YAC7B,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;YAC/B,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACvC,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;SAC3C,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,2BAA2B,CAAC,2BAA2B,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtG,MAAM,IAAI,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC;IACrC,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,2BAA2B,CAAC,2BAA2B,CAAC,CAAC;IAC7F,CAAC;CACF;AAtCD,wDAsCC"}

package/dist/node.d.ts

@@ -54,11 +54,12 @@ export declare function deriveNativeEndpoint(endpoint: string): string | null;
  * per-(intent,modality) model from discover. Back-compatible: a single text chat
  * model yields the same single ["text"] capability. First-seen group leads.
  */
-export declare function buildCapabilities(models: string[], defaultIntent: string, maxTokens: number): Array<{
+export declare function buildCapabilities(models: string[], defaultIntent: string, maxTokens: number, supportedProfiles?: string[]): Array<{
     intent: string;
     models: string[];
     max_tokens: number;
     input_modalities: string[];
+    supported_profiles?: string[];
 }>;
 export interface NodeConfig {
     nodeId: string;
@@ -71,6 +72,8 @@ export interface NodeConfig {
     excludedModels?: string[];
     /** Pre-normative receipt profiles explicitly enabled by the operator. */
     supportedReceiptProfiles?: string[];
+    /** Explicit opt-in capability profiles. Empty means no profile claim. */
+    supportedProfiles?: string[];
     region?: string;
     capabilities?: string[];
     directoryUrl?: string;
@@ -191,6 +194,7 @@ export declare class IicpNode {
     private _tokensCounter;
     private _backendStability;
     private _savedNodeName;
+    private readonly _runtimeHealth;
     private _promLoaded;
     private readonly _cxPublicKey;
     private readonly _cxPrivateKeyBytes;

package/dist/node.d.ts.map

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

package/dist/node.js

@@ -31,6 +31,7 @@ const relay_ticket_js_1 = require("./relay_ticket.js");
 const backend_stability_js_1 = require("./backend_stability.js");
 const updater_js_1 = require("./updater.js");
 const identity_js_1 = require("./identity.js");
+const runtime_health_js_1 = require("./runtime_health.js");
 const recovery_js_1 = require("./recovery.js");
 const DEFAULT_DIRECTORY = "https://iicp.network/api";
 const HEARTBEAT_INTERVAL_MS = 30_000;
@@ -143,9 +144,16 @@ function deriveNativeEndpoint(endpoint) {
  * per-(intent,modality) model from discover. Back-compatible: a single text chat
  * model yields the same single ["text"] capability. First-seen group leads.
  */
-function buildCapabilities(models, defaultIntent, maxTokens) {
+function buildCapabilities(models, defaultIntent, maxTokens, supportedProfiles = []) {
+    const profiles = [...new Set(supportedProfiles)];
     if (models.length === 0) {
-        return [{ intent: defaultIntent, models: [], max_tokens: maxTokens, input_modalities: ["text"] }];
+        return [{
+                intent: defaultIntent,
+                models: [],
+                max_tokens: maxTokens,
+                input_modalities: ["text"],
+                ...(profiles.length > 0 ? { supported_profiles: profiles } : {}),
+            }];
     }
     const order = [];
     const groups = new Map();
@@ -163,7 +171,13 @@ function buildCapabilities(models, defaultIntent, maxTokens) {
     }
     return order.map((key) => {
         const g = groups.get(key);
-        return { intent: g.intent, models: g.models, max_tokens: maxTokens, input_modalities: g.input_modalities };
+        return {
+            intent: g.intent,
+            models: g.models,
+            max_tokens: maxTokens,
+            input_modalities: g.input_modalities,
+            ...(profiles.length > 0 ? { supported_profiles: [...profiles] } : {}),
+        };
     });
 }
 // ── IicpNode ──────────────────────────────────────────────────────────────────
@@ -210,6 +224,7 @@ class IicpNode {
     _tokensCounter = null;
     _backendStability = new backend_stability_js_1.BackendStabilityObservation();
     _savedNodeName;
+    _runtimeHealth = new runtime_health_js_1.RuntimeHealth();
     _promLoaded = false;
     _cxPublicKey;
     _cxPrivateKeyBytes;
@@ -220,6 +235,7 @@ class IicpNode {
             backend: config.backend,
             excludedModels: config.excludedModels ?? [],
             supportedReceiptProfiles: config.supportedReceiptProfiles ?? [],
+            supportedProfiles: config.supportedProfiles ?? [],
             endpoint: config.endpoint,
             intent: config.intent,
             model: config.model,
@@ -436,7 +452,7 @@ class IicpNode {
             region: this._cfg.region ?? "eu-central",
             // #409 — one capability object per intent the backend can serve (e.g.
             // chat + embedding), classified from the detected model set.
-            capabilities: buildCapabilities(models, this._cfg.intent, this._cfg.maxTokens),
+            capabilities: buildCapabilities(models, this._cfg.intent, this._cfg.maxTokens, this._cfg.supportedProfiles),
             limits: {
                 max_concurrent: this._cfg.maxConcurrent,
                 tokens_per_min: this._cfg.tokensPerMin,
@@ -696,8 +712,11 @@ class IicpNode {
      * is unit-testable (the interval loop itself isn't).
      */
     async _heartbeatTick(token) {
+        this._runtimeHealth.advanceSupervisor();
         try {
             await this.heartbeat(token);
+            this._runtimeHealth.setExternal("directory", "healthy");
+            this._runtimeHealth.advanceSupervisor();
             // #494 — detect model list drift and re-register with the updated list.
             let nextToken = await this._maybeReregisterOnModelDrift(token);
             this._recoveryHeartbeatSeq += 1;
@@ -753,6 +772,8 @@ class IicpNode {
             return nextToken;
         }
         catch (err) {
+            this._runtimeHealth.setExternal("directory", "unavailable");
+            this._runtimeHealth.advanceSupervisor();
             const status = err?.status;
             if (status === 401 || status === 404 || status === 410) {
                 try {
@@ -926,11 +947,27 @@ class IicpNode {
             });
             socket.on("error", () => undefined);
         });
-        mux.listen(port, host);
+        mux.listen(port, host, () => this._runtimeHealth.markRunning());
         let hbTimer;
+        let healthTimer;
+        if (this._savedNodeName) {
+            const healthPath = (0, runtime_health_js_1.runtimeHealthPath)(this._savedNodeName);
+            const publish = () => {
+                this._runtimeHealth.advanceRuntime();
+                try {
+                    (0, runtime_health_js_1.writeRuntimeHealthSnapshot)(healthPath, this._runtimeHealth.snapshot());
+                }
+                catch (error) {
+                    console.warn(`[iicp-node] runtime-health snapshot write failed: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            };
+            publish();
+            healthTimer = setInterval(publish, 5_000);
+        }
         // #404 — start the heartbeat loop when a token is present OR empty (register
         // failed → loop self-heals via re-register on 401). undefined = --skip-registration.
         if (nodeToken !== undefined) {
+            this._runtimeHealth.setSupervisorRequired(true);
             let currentToken = nodeToken;
             hbTimer = setInterval(() => {
                 void this._heartbeatTick(currentToken).then((t) => {
@@ -1054,8 +1091,17 @@ class IicpNode {
             }).catch(() => undefined);
         }
         return () => {
+            this._runtimeHealth.markStopping();
+            if (this._savedNodeName) {
+                try {
+                    (0, runtime_health_js_1.writeRuntimeHealthSnapshot)((0, runtime_health_js_1.runtimeHealthPath)(this._savedNodeName), this._runtimeHealth.snapshot());
+                }
+                catch { /* best effort */ }
+            }
             if (hbTimer)
                 clearInterval(hbTimer);
+            if (healthTimer)
+                clearInterval(healthTimer);
             this._peerManager.stop();
             if (stopRelayWorker)
                 stopRelayWorker();
@@ -1290,11 +1336,17 @@ class IicpNode {
             }
             const callId = payload.call_id ?? "";
             const result = payload.result;
-            if (!callId || typeof result !== "object" || result === null) {
+            const event = payload.event;
+            if (!callId || ((typeof result !== "object" || result === null) && (typeof event !== "object" || event === null))) {
                 this._relayJson(res, 422, { error: { code: "IICP-E001", message: "call_id and result are required" } });
                 return;
             }
-            session.onResponse(callId, result);
+            if (typeof event === "object" && event !== null) {
+                session.onStreamResponse(callId, event);
+            }
+            else {
+                session.onResponse(callId, result);
+            }
             res.writeHead(204, { ...RELAY_CORS_HEADERS });
             res.end();
         });