@exochain/llm-proxy 0.2.1-beta

package/dist/mcp.js

@@ -0,0 +1,107 @@
+/*
+ * Copyright 2026 Exochain Foundation
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { buildLlmUsageReceiptIntent, hashProviderPayload, LynkConfigurationError, LynkValidationError, maybeStoreExternalPayloads, } from "./evidence.js";
+import { releaseWithReceipt } from "./delivery.js";
+import { emitUsageReceipt, resolveFetch } from "./receipt.js";
+export function createReceiptedMcpProxy(config, mcp) {
+    if (!mcp.serverUrl || mcp.serverUrl.trim() === "") {
+        throw new LynkConfigurationError("MCP LYNK proxy requires serverUrl");
+    }
+    return {
+        callTool: (call, options) => callMcpTool(config, mcp.serverUrl, call, options),
+    };
+}
+async function callMcpTool(config, serverUrl, call, options) {
+    if (!call.name || call.name.trim() === "") {
+        throw new LynkValidationError("MCP tools/call requires a tool name");
+    }
+    const requestPayload = {
+        jsonrpc: "2.0",
+        id: options.idempotencyKey,
+        method: "tools/call",
+        params: {
+            name: call.name,
+            arguments: call.arguments ?? {},
+        },
+    };
+    const response = await resolveFetch(config.fetch)(serverUrl, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+        },
+        body: JSON.stringify(requestPayload),
+    });
+    const responsePayload = (await response.json());
+    if (!response.ok || (isRecord(responsePayload) && responsePayload.error !== undefined)) {
+        return emitMcpFailureReceipt(config, call, requestPayload, response.status, options);
+    }
+    if (!isValidMcpToolResult(responsePayload)) {
+        throw new LynkValidationError("MCP tools/call response was malformed or untrusted");
+    }
+    const encryptedPayloadRefs = await maybeStoreExternalPayloads(config, [
+        { payloadKind: "mcp_tool_call", payload: requestPayload },
+        { payloadKind: "mcp_tool_result", payload: responsePayload },
+    ]);
+    const context = mcpUsageContext(call, requestPayload, responsePayload, zeroUsage(true), options, encryptedPayloadRefs);
+    const receiptIntent = await buildLlmUsageReceiptIntent(config, context);
+    return releaseWithReceipt(config, receiptIntent, responsePayload);
+}
+async function emitMcpFailureReceipt(config, call, requestPayload, providerStatus, options) {
+    const context = mcpUsageContext(call, requestPayload, { provider_status: providerStatus }, zeroUsage(false), options, []);
+    const receiptIntent = await buildLlmUsageReceiptIntent(config, context);
+    const receipt = await emitUsageReceipt(config, receiptIntent).catch(() => undefined);
+    return {
+        status: "provider_error",
+        providerStatus,
+        receipt,
+        receiptIntent,
+    };
+}
+function mcpUsageContext(call, requestPayload, responsePayload, usage, options, encryptedPayloadRefs) {
+    return {
+        provider: "mcp",
+        providerEndpoint: "tools/call",
+        modelId: call.name,
+        requestPayload,
+        responsePayload,
+        toolCallPayload: requestPayload,
+        toolResultPayload: responsePayload,
+        idempotencyKey: options.idempotencyKey,
+        actionId: options.actionId ?? hashProviderPayload(["mcp", call.name, options.idempotencyKey]),
+        usage,
+        createdAt: options.createdAt,
+        issuedAt: options.issuedAt ?? options.createdAt,
+        encryptedPayloadRefs,
+    };
+}
+function isValidMcpToolResult(payload) {
+    if (!isRecord(payload)) {
+        return false;
+    }
+    if (payload.jsonrpc !== undefined && payload.jsonrpc !== "2.0") {
+        return false;
+    }
+    const result = payload.result;
+    return isRecord(result) && (Array.isArray(result.content) || result.structuredContent !== undefined);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function zeroUsage(usageComplete) {
+    return {
+        input_tokens: 0,
+        output_tokens: 0,
+        total_tokens: 0,
+        usage_complete: usageComplete,
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/openai.d.ts

@@ -0,0 +1,19 @@
+import type { LlmProxyConfig, OpenAIProxyOptions, PerCallReceiptOptions, ProviderUsageMetrics, ReceiptedResult } from "./types.js";
+type JsonRecord = Record<string, unknown>;
+export interface ReceiptedOpenAIClient {
+    responses: {
+        create(body: JsonRecord, options: PerCallReceiptOptions): Promise<ReceiptedResult<unknown>>;
+    };
+    chat: {
+        completions: {
+            create(body: JsonRecord, options: PerCallReceiptOptions): Promise<ReceiptedResult<unknown>>;
+        };
+    };
+}
+export declare function createReceiptedOpenAIClient(config: LlmProxyConfig, openAI: OpenAIProxyOptions): ReceiptedOpenAIClient;
+export declare function createReceiptedOpenAIProxy(config: LlmProxyConfig, openAI: OpenAIProxyOptions): ReceiptedOpenAIClient;
+export declare function parseSseStream(text: string): JsonRecord;
+export declare function usageFromResponses(payload: unknown): ProviderUsageMetrics;
+export declare function usageFromChatCompletions(payload: unknown): ProviderUsageMetrics;
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../src/openai.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EAErB,oBAAoB,EACpB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAGpB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE;QACT,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;KAC7F,CAAC;IACF,IAAI,EAAE;QACJ,WAAW,EAAE;YACX,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;SAC7F,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,GACzB,qBAAqB,CAqBvB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,GACzB,qBAAqB,CAEvB;AAqED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAwBvD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAqBzE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAwB/E"}

package/dist/openai.js

@@ -0,0 +1,208 @@
+/*
+ * Copyright 2026 Exochain Foundation
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { buildLlmUsageReceiptIntent, maybeStoreExternalPayloads } from "./evidence.js";
+import { releaseWithReceipt } from "./delivery.js";
+import { emitUsageReceipt } from "./receipt.js";
+import { hashProviderPayload, LynkValidationError } from "./evidence.js";
+import { resolveFetch } from "./receipt.js";
+export function createReceiptedOpenAIClient(config, openAI) {
+    assertProductionDevelopmentFlag(config);
+    return {
+        responses: {
+            create: (body, options) => callOpenAIEndpoint(config, openAI, "responses", "/v1/responses", body, options),
+        },
+        chat: {
+            completions: {
+                create: (body, options) => callOpenAIEndpoint(config, openAI, "chat_completions", "/v1/chat/completions", body, options),
+            },
+        },
+    };
+}
+export function createReceiptedOpenAIProxy(config, openAI) {
+    return createReceiptedOpenAIClient(config, openAI);
+}
+async function callOpenAIEndpoint(config, openAI, endpointName, path, body, options) {
+    const fetchImpl = resolveFetch(config.fetch);
+    const response = await fetchImpl(`${openAI.openAIBaseUrl.replace(/\/+$/, "")}${path}`, {
+        method: "POST",
+        headers: openAI.apiKey
+            ? {
+                "content-type": "application/json",
+                authorization: `Bearer ${openAI.apiKey}`,
+            }
+            : {
+                "content-type": "application/json",
+            },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        return emitProviderFailureReceipt(config, endpointName, body, response.status, options);
+    }
+    const responsePayload = await parseOpenAIResponse(response, body);
+    const usage = endpointName === "responses"
+        ? usageFromResponses(responsePayload)
+        : usageFromChatCompletions(responsePayload);
+    if (config.requireCompleteUsage === true && usage.usage_complete !== true) {
+        throw new LynkValidationError("OpenAI endpoint policy requires complete usage fields");
+    }
+    const encryptedPayloadRefs = await maybeStoreExternalPayloads(config, [
+        { payloadKind: "openai_request", payload: body },
+        { payloadKind: "openai_response", payload: responsePayload },
+    ]);
+    const context = usageContext(endpointName, body, responsePayload, usage, options, encryptedPayloadRefs);
+    const receiptIntent = await buildLlmUsageReceiptIntent(config, context);
+    return releaseWithReceipt(config, receiptIntent, responsePayload);
+}
+async function emitProviderFailureReceipt(config, endpointName, body, providerStatus, options) {
+    const context = usageContext(endpointName, body, { provider_status: providerStatus }, zeroUsage(false), options, []);
+    const receiptIntent = await buildLlmUsageReceiptIntent(config, context);
+    const receipt = await emitUsageReceipt(config, receiptIntent).catch(() => undefined);
+    return {
+        status: "provider_error",
+        providerStatus,
+        receipt,
+        receiptIntent,
+    };
+}
+async function parseOpenAIResponse(response, requestBody) {
+    if (requestBody.stream === true) {
+        const text = await response.text();
+        return parseSseStream(text);
+    }
+    return response.json();
+}
+export function parseSseStream(text) {
+    const events = [];
+    let finalUsage;
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line.startsWith("data:")) {
+            continue;
+        }
+        const data = line.slice("data:".length).trim();
+        if (data === "[DONE]") {
+            continue;
+        }
+        const parsed = JSON.parse(data);
+        events.push(parsed);
+        if (isRecord(parsed.usage)) {
+            finalUsage = parsed.usage;
+        }
+    }
+    return {
+        object: "openai_stream",
+        events,
+        usage: finalUsage,
+        usage_complete: finalUsage !== undefined,
+    };
+}
+export function usageFromResponses(payload) {
+    if (!isRecord(payload)) {
+        return zeroUsage(false);
+    }
+    if (payload.object === "openai_stream") {
+        return usageFromResponses(payload.usage);
+    }
+    const usage = isRecord(payload.usage) ? payload.usage : payload;
+    const inputTokens = integerField(usage, "input_tokens", 0);
+    const outputTokens = integerField(usage, "output_tokens", 0);
+    const totalTokens = integerField(usage, "total_tokens", inputTokens + outputTokens);
+    const inputDetails = isRecord(usage.input_tokens_details) ? usage.input_tokens_details : {};
+    const outputDetails = isRecord(usage.output_tokens_details) ? usage.output_tokens_details : {};
+    return {
+        input_tokens: inputTokens,
+        output_tokens: outputTokens,
+        total_tokens: totalTokens,
+        cached_input_tokens: optionalIntegerField(inputDetails, "cached_tokens"),
+        reasoning_tokens: optionalIntegerField(outputDetails, "reasoning_tokens"),
+        usage_complete: inputTokens + outputTokens > 0 || totalTokens > 0,
+    };
+}
+export function usageFromChatCompletions(payload) {
+    if (!isRecord(payload)) {
+        return zeroUsage(false);
+    }
+    if (payload.object === "openai_stream") {
+        if (payload.usage_complete !== true) {
+            return zeroUsage(false);
+        }
+        return usageFromChatCompletions(payload.usage);
+    }
+    const usage = isRecord(payload.usage) ? payload.usage : payload;
+    const inputTokens = integerField(usage, "prompt_tokens", 0);
+    const outputTokens = integerField(usage, "completion_tokens", 0);
+    const totalTokens = integerField(usage, "total_tokens", inputTokens + outputTokens);
+    const inputDetails = isRecord(usage.prompt_tokens_details) ? usage.prompt_tokens_details : {};
+    const outputDetails = isRecord(usage.completion_tokens_details) ? usage.completion_tokens_details : {};
+    return {
+        input_tokens: inputTokens,
+        output_tokens: outputTokens,
+        total_tokens: totalTokens,
+        cached_input_tokens: optionalIntegerField(inputDetails, "cached_tokens"),
+        reasoning_tokens: optionalIntegerField(outputDetails, "reasoning_tokens"),
+        usage_complete: inputTokens + outputTokens > 0 || totalTokens > 0,
+    };
+}
+function usageContext(endpointName, requestPayload, responsePayload, usage, options, encryptedPayloadRefs) {
+    return {
+        provider: "openai",
+        providerEndpoint: endpointName,
+        modelId: typeof requestPayload.model === "string" ? requestPayload.model : "unknown",
+        requestPayload,
+        responsePayload,
+        providerRequestId: isRecord(responsePayload) && typeof responsePayload.id === "string" ? responsePayload.id : undefined,
+        sessionId: options.sessionId,
+        idempotencyKey: options.idempotencyKey,
+        actionId: options.actionId ?? hashProviderPayload(["openai", endpointName, options.idempotencyKey]),
+        usage,
+        createdAt: options.createdAt,
+        issuedAt: options.issuedAt ?? options.createdAt,
+        encryptedPayloadRefs,
+    };
+}
+function zeroUsage(usageComplete) {
+    return {
+        input_tokens: 0,
+        output_tokens: 0,
+        total_tokens: 0,
+        usage_complete: usageComplete,
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function integerField(record, name, fallback) {
+    const value = record[name];
+    if (value === undefined) {
+        return fallback;
+    }
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+        throw new LynkValidationError(`OpenAI usage field ${name} must be a non-negative integer`);
+    }
+    return value;
+}
+function optionalIntegerField(record, name) {
+    const value = record[name];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+        throw new LynkValidationError(`OpenAI usage field ${name} must be a non-negative integer`);
+    }
+    return value;
+}
+function assertProductionDevelopmentFlag(config) {
+    if (config.mode === "production" && config.allowUnreceiptedOutputForDevelopment === true) {
+        throw new LynkValidationError("allowUnreceiptedOutputForDevelopment is forbidden in production");
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/openai.js.map

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

package/dist/receipt.d.ts

@@ -0,0 +1,12 @@
+import type { FetchLike, LlmProxyConfig, ReceiptEmissionResult, ReceiptIntent, ReceiptPending } from "./types.js";
+export declare class ReceiptEmissionError extends Error {
+    readonly statusCode?: number;
+    readonly idempotencyKeyHash: string;
+    readonly receiptIntent: ReceiptIntent;
+    constructor(message: string, idempotencyKeyHash: string, receiptIntent: ReceiptIntent, statusCode?: number);
+}
+export declare function receiptPendingFromError(error: ReceiptEmissionError): ReceiptPending;
+export declare function emitUsageReceipt(config: LlmProxyConfig, receiptIntent: ReceiptIntent): Promise<ReceiptEmissionResult>;
+export declare function resolveReceiptPending(config: LlmProxyConfig, pending: ReceiptPending): Promise<ReceiptEmissionResult>;
+export declare function resolveFetch(fetchImpl?: FetchLike): FetchLike;
+//# sourceMappingURL=receipt.d.ts.map

package/dist/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../src/receipt.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,MAAM;CAO3G;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc,CAMnF;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,qBAAqB,CAAC,CAoBhC;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAQ7D"}

package/dist/receipt.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2026 Exochain Foundation
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { assertNoForbiddenReceiptMaterial, LynkConfigurationError } from "./evidence.js";
+export class ReceiptEmissionError extends Error {
+    statusCode;
+    idempotencyKeyHash;
+    receiptIntent;
+    constructor(message, idempotencyKeyHash, receiptIntent, statusCode) {
+        super(message);
+        this.name = "ReceiptEmissionError";
+        this.statusCode = statusCode;
+        this.idempotencyKeyHash = idempotencyKeyHash;
+        this.receiptIntent = receiptIntent;
+    }
+}
+export function receiptPendingFromError(error) {
+    return {
+        status: "receipt_pending",
+        idempotencyKeyHash: error.idempotencyKeyHash,
+        receiptIntent: error.receiptIntent,
+    };
+}
+export async function emitUsageReceipt(config, receiptIntent) {
+    assertNoForbiddenReceiptMaterial(receiptIntent);
+    const fetchImpl = resolveFetch(config.fetch);
+    const endpoint = `${config.gatewayUrl.replace(/\/+$/, "")}/api/v1/avc/llm-usage/receipts/emit`;
+    const response = await fetchImpl(endpoint, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+        },
+        body: JSON.stringify(receiptIntent),
+    });
+    if (!response.ok) {
+        throw new ReceiptEmissionError("EXOCHAIN LYNK receipt emission failed", receiptIntent.llm_usage_evidence.evidence.idempotency_key_hash, receiptIntent, response.status);
+    }
+    return (await response.json());
+}
+export async function resolveReceiptPending(config, pending) {
+    return emitUsageReceipt(config, pending.receiptIntent);
+}
+export function resolveFetch(fetchImpl) {
+    if (fetchImpl) {
+        return fetchImpl;
+    }
+    if (globalThis.fetch) {
+        return globalThis.fetch.bind(globalThis);
+    }
+    throw new LynkConfigurationError("LYNK proxy requires fetch");
+}
+//# sourceMappingURL=receipt.js.map

package/dist/receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../src/receipt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gCAAgC,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AASzF,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,UAAU,CAAU;IACpB,kBAAkB,CAAS;IAC3B,aAAa,CAAgB;IAEtC,YAAY,OAAe,EAAE,kBAA0B,EAAE,aAA4B,EAAE,UAAmB;QACxG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,KAA2B;IACjE,OAAO;QACL,MAAM,EAAE,iBAAiB;QACzB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAsB,EACtB,aAA4B;IAE5B,gCAAgC,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,qCAAqC,CAAC;IAC/F,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;QACzC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,oBAAoB,CAC5B,uCAAuC,EACvC,aAAa,CAAC,kBAAkB,CAAC,QAAQ,CAAC,oBAAoB,EAC9D,aAAa,EACb,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAsB,EACtB,OAAuB;IAEvB,OAAO,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAqB;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAc,CAAC;IACxD,CAAC;IACD,MAAM,IAAI,sBAAsB,CAAC,2BAA2B,CAAC,CAAC;AAChE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,169 @@
+export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export interface HlcTimestamp {
+    physical_ms: number;
+    logical: number;
+}
+export type StorageMode = "receipt_minimized" | "external_payload_ref" | "dagdb_custody";
+export interface ProviderUsageMetrics {
+    input_tokens: number;
+    output_tokens: number;
+    total_tokens: number;
+    cached_input_tokens?: number;
+    reasoning_tokens?: number;
+    cost_minor_units?: number;
+    cost_currency?: string;
+    usage_complete: boolean;
+}
+export interface EncryptedPayloadRef {
+    ref_id_hash: string;
+    ciphertext_hash: string;
+    storage_policy_hash: string;
+    key_policy_hash: string;
+    payload_kind: string;
+    byte_length: number;
+}
+export interface LlmUsageEvidence {
+    schema_version: number;
+    tenant_id: string;
+    namespace: string;
+    actor_did: string;
+    provider: string;
+    provider_endpoint: string;
+    model_id: string;
+    provider_request_id_hash?: string;
+    session_id_hash?: string;
+    idempotency_key_hash: string;
+    action_id: string;
+    prompt_hash: string;
+    completion_hash?: string;
+    tool_call_hash?: string;
+    tool_result_hash?: string;
+    usage: ProviderUsageMetrics;
+    custody_mode: StorageMode;
+    encrypted_payload_refs: EncryptedPayloadRef[];
+    custody_policy_hash: string;
+    created_at: HlcTimestamp;
+}
+export interface LlmUsageEvidenceEnvelope {
+    schema_version: number;
+    adapter_did: string;
+    issued_at: HlcTimestamp;
+    evidence: LlmUsageEvidence;
+}
+export interface ReceiptIntent {
+    validation: unknown;
+    subject_signature: string;
+    subject_public_key?: string;
+    llm_usage_evidence: LlmUsageEvidenceEnvelope;
+    adapter_signature: string;
+    adapter_public_key?: string;
+}
+export interface ReceiptEmissionResult {
+    receipt_hash?: string;
+    receipt?: unknown;
+    validation?: unknown;
+    exochain_finality_hash?: string;
+    exochain_finality_height?: number;
+    exochain_finality_receipt_hash?: string;
+}
+export interface ReceiptPending {
+    status: "receipt_pending";
+    idempotencyKeyHash: string;
+    receiptIntent: ReceiptIntent;
+}
+export interface ReceiptedSuccess<T> {
+    status: "receipted";
+    output: T;
+    receipt: ReceiptEmissionResult;
+    receiptIntent: ReceiptIntent;
+}
+export interface ProviderFailure {
+    status: "provider_error";
+    providerStatus: number;
+    receipt?: ReceiptEmissionResult;
+    receiptIntent: ReceiptIntent;
+}
+export interface ReceiptedDevelopmentBypass<T> {
+    status: "development_unreceipted";
+    output: T;
+    receiptPending: ReceiptPending;
+}
+export type ReceiptedResult<T> = ReceiptedSuccess<T> | ReceiptPending | ProviderFailure | ReceiptedDevelopmentBypass<T>;
+export interface KmsEncryptRequest {
+    payload: Uint8Array;
+    payloadKind: string;
+}
+export interface KmsEncryptResult {
+    ciphertext: Uint8Array | string;
+    keyPolicyId: string;
+}
+export interface KmsLike {
+    encrypt(request: KmsEncryptRequest): Promise<KmsEncryptResult>;
+}
+export interface ObjectStorePutRequest {
+    payloadKind: string;
+    ciphertext: Uint8Array;
+}
+export interface ObjectStorePutResult {
+    refId: string;
+    storagePolicyId: string;
+}
+export interface ObjectStoreLike {
+    put(request: ObjectStorePutRequest): Promise<ObjectStorePutResult>;
+}
+export interface LlmProxyConfig {
+    mode: "production" | "development";
+    allowUnreceiptedOutputForDevelopment?: boolean;
+    gatewayUrl: string;
+    tenantId: string;
+    namespace: string;
+    actorDid: string;
+    adapterDid: string;
+    adapterPublicKey?: string;
+    subjectPublicKey?: string;
+    custodyPolicyHash: string;
+    storageMode: StorageMode;
+    requireCompleteUsage?: boolean;
+    validation: unknown;
+    subjectSignature: string;
+    adapterSignature: string | ((envelope: LlmUsageEvidenceEnvelope) => Promise<string> | string);
+    fetch?: FetchLike;
+    objectStore?: ObjectStoreLike;
+    kms?: KmsLike;
+}
+export interface UsageContext {
+    provider: string;
+    providerEndpoint: string;
+    modelId: string;
+    requestPayload: unknown;
+    responsePayload?: unknown;
+    toolCallPayload?: unknown;
+    toolResultPayload?: unknown;
+    providerRequestId?: string;
+    sessionId?: string;
+    idempotencyKey: string;
+    actionId?: string;
+    usage: ProviderUsageMetrics;
+    createdAt: HlcTimestamp;
+    issuedAt: HlcTimestamp;
+    encryptedPayloadRefs?: EncryptedPayloadRef[];
+}
+export interface OpenAIProxyOptions {
+    openAIBaseUrl: string;
+    apiKey?: string;
+}
+export interface PerCallReceiptOptions {
+    idempotencyKey: string;
+    actionId?: string;
+    createdAt: HlcTimestamp;
+    issuedAt?: HlcTimestamp;
+    sessionId?: string;
+}
+export interface McpProxyOptions {
+    serverUrl?: string;
+}
+export interface McpToolCall {
+    name: string;
+    arguments?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright 2026 Exochain Foundation
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}