artemys 0.2.0 → 0.2.1

package/dist/transport/client.d.ts

@@ -0,0 +1,32 @@
+import { type ProtocolMessage, type TransportAck, type TransportErrorResponse } from "../protocol/index.js";
+export type TransportResult = {
+    ok: true;
+    ack: TransportAck;
+} | {
+    ok: false;
+    error: TransportErrorResponse;
+    status: number;
+} | {
+    ok: false;
+    error: {
+        error_code: "network_error";
+        message: string;
+    };
+};
+export interface TransportClientOptions {
+    agentId: string;
+    getSharedSecret: (targetAgentId: string) => Promise<string>;
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    resolveTargetAgentId?: (endpoint: string, message: ProtocolMessage) => string;
+}
+export interface TransportSendOptions {
+    targetAgentId?: string;
+}
+export declare class ProtocolTransportClient {
+    private readonly options;
+    constructor(options: TransportClientOptions);
+    send(endpoint: string, message: ProtocolMessage, options?: TransportSendOptions): Promise<TransportResult>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/transport/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/transport/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAA;AAO7B,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,UAAU,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAE1E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,MAAM,CAAA;CAC9E;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AA8DD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CACqC;gBAEjD,OAAO,EAAE,sBAAsB;IAcrC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC;CA2FrH"}

package/dist/transport/client.js

@@ -0,0 +1,155 @@
+import { TransportAckSchema, TransportErrorResponseSchema, parseProtocolMessageSafe, } from "../protocol/index.js";
+import { signPayload } from "./hmac.js";
+const DEFAULT_MAX_RETRIES = 5;
+const DEFAULT_INITIAL_DELAY_MS = 5000;
+const DEFAULT_MAX_DELAY_MS = 60000;
+function sanitizeTransportError(status, data) {
+    const parsed = TransportErrorResponseSchema.safeParse(data);
+    if (parsed.success) {
+        return parsed.data;
+    }
+    if (status === 401) {
+        return { error_code: "unauthorized", message: "Unauthorized" };
+    }
+    if (status === 409) {
+        return { error_code: "conflict", message: "Duplicate message" };
+    }
+    if (status === 429) {
+        return { error_code: "rate_limited", message: "Rate limited" };
+    }
+    return {
+        error_code: status >= 500 ? "internal_error" : "bad_request",
+        message: status >= 500 ? "Transport server error" : "Transport request failed",
+    };
+}
+async function parseJson(response) {
+    const text = await response.text();
+    if (!text) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+function parseRetryAfterMs(response) {
+    const header = response.headers.get("retry-after");
+    if (!header) {
+        return null;
+    }
+    const asSeconds = Number.parseInt(header, 10);
+    if (Number.isFinite(asSeconds)) {
+        return Math.max(0, asSeconds * 1000);
+    }
+    const asDate = Date.parse(header);
+    if (Number.isNaN(asDate)) {
+        return null;
+    }
+    return Math.max(0, asDate - Date.now());
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+export class ProtocolTransportClient {
+    options;
+    constructor(options) {
+        this.options = {
+            ...options,
+            maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES,
+            initialDelayMs: options.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS,
+            maxDelayMs: options.maxDelayMs ?? DEFAULT_MAX_DELAY_MS,
+            resolveTargetAgentId: options.resolveTargetAgentId ??
+                ((endpoint) => {
+                    return endpoint;
+                }),
+        };
+    }
+    async send(endpoint, message, options = {}) {
+        const parsed = parseProtocolMessageSafe(message);
+        if (!parsed.ok) {
+            return {
+                ok: false,
+                status: 400,
+                error: {
+                    error_code: "bad_request",
+                    message: parsed.error.message,
+                },
+            };
+        }
+        if (parsed.message.sender_agent_id !== this.options.agentId) {
+            return {
+                ok: false,
+                status: 400,
+                error: {
+                    error_code: "bad_request",
+                    message: "message.sender_agent_id must match client agentId",
+                },
+            };
+        }
+        const body = JSON.stringify(parsed.message);
+        const timestamp = new Date().toISOString();
+        const targetAgentId = options.targetAgentId ?? this.options.resolveTargetAgentId(endpoint, parsed.message);
+        const sharedSecret = await this.options.getSharedSecret(targetAgentId);
+        const signature = await signPayload(this.options.agentId, timestamp, body, sharedSecret);
+        let retries = 0;
+        let delayMs = this.options.initialDelayMs;
+        while (true) {
+            try {
+                const response = await fetch(endpoint, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        "x-artemys-message-id": parsed.message.message_id,
+                        "x-artemys-timestamp": timestamp,
+                        "x-artemys-sender-agent-id": this.options.agentId,
+                        "x-artemys-signature": signature,
+                    },
+                    body,
+                });
+                if (response.status === 202) {
+                    const json = await parseJson(response);
+                    const ack = TransportAckSchema.parse(json);
+                    return { ok: true, ack };
+                }
+                if (response.status === 429 && retries < this.options.maxRetries) {
+                    const retryAfterMs = parseRetryAfterMs(response);
+                    await sleep(retryAfterMs ?? delayMs);
+                    retries += 1;
+                    delayMs = Math.min(this.options.maxDelayMs, delayMs * 2);
+                    continue;
+                }
+                if (response.status >= 500 && retries < this.options.maxRetries) {
+                    await sleep(delayMs);
+                    retries += 1;
+                    delayMs = Math.min(this.options.maxDelayMs, delayMs * 2);
+                    continue;
+                }
+                const errorJson = await parseJson(response);
+                return {
+                    ok: false,
+                    status: response.status,
+                    error: sanitizeTransportError(response.status, errorJson),
+                };
+            }
+            catch (error) {
+                if (retries >= this.options.maxRetries) {
+                    return {
+                        ok: false,
+                        error: {
+                            error_code: "network_error",
+                            message: error instanceof Error ? error.message : "Unknown network error",
+                        },
+                    };
+                }
+                await sleep(delayMs);
+                retries += 1;
+                delayMs = Math.min(this.options.maxDelayMs, delayMs * 2);
+            }
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/transport/client.js.map

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

package/dist/transport/dedup.d.ts

@@ -0,0 +1,9 @@
+export declare class MessageDeduplicationCache {
+    private readonly ttlMs;
+    private readonly entries;
+    constructor(ttlMs?: number);
+    has(senderAgentId: string, messageId: string): boolean;
+    add(senderAgentId: string, messageId: string): void;
+    private evictExpired;
+}
+//# sourceMappingURL=dedup.d.ts.map

package/dist/transport/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/transport/dedup.ts"],"names":[],"mappings":"AAMA,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,KAAK,SAAiB;IAIlC,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAetD,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnD,OAAO,CAAC,YAAY;CAQrB"}

package/dist/transport/dedup.js

@@ -0,0 +1,36 @@
+const DEFAULT_TTL_MS = 15 * 60 * 1000;
+function makeKey(senderAgentId, messageId) {
+    return `${senderAgentId}:${messageId}`;
+}
+export class MessageDeduplicationCache {
+    ttlMs;
+    entries = new Map();
+    constructor(ttlMs = DEFAULT_TTL_MS) {
+        this.ttlMs = ttlMs;
+    }
+    has(senderAgentId, messageId) {
+        const key = makeKey(senderAgentId, messageId);
+        const expiresAt = this.entries.get(key);
+        if (!expiresAt) {
+            return false;
+        }
+        if (expiresAt <= Date.now()) {
+            this.entries.delete(key);
+            return false;
+        }
+        return true;
+    }
+    add(senderAgentId, messageId) {
+        this.evictExpired();
+        this.entries.set(makeKey(senderAgentId, messageId), Date.now() + this.ttlMs);
+    }
+    evictExpired() {
+        const now = Date.now();
+        for (const [key, expiresAt] of this.entries.entries()) {
+            if (expiresAt <= now) {
+                this.entries.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=dedup.js.map

package/dist/transport/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../src/transport/dedup.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAErC,SAAS,OAAO,CAAC,aAAqB,EAAE,SAAiB;IACvD,OAAO,GAAG,aAAa,IAAI,SAAS,EAAE,CAAA;AACxC,CAAC;AAED,MAAM,OAAO,yBAAyB;IACnB,KAAK,CAAQ;IACb,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEpD,YAAY,KAAK,GAAG,cAAc;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,GAAG,CAAC,aAAqB,EAAE,SAAiB;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,KAAK,CAAA;QACd,CAAC;QAED,IAAI,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACxB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAC,aAAqB,EAAE,SAAiB;QAC1C,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;IAC9E,CAAC;IAEO,YAAY;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACtD,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/transport/handler.d.ts

@@ -0,0 +1,9 @@
+import { type ProtocolMessage } from "../protocol/index.js";
+export interface ProtocolHandlerOptions {
+    getSharedSecret: (senderAgentId: string) => Promise<string | null>;
+    onMessage: (message: ProtocolMessage, senderAgentId: string) => Promise<void>;
+    maxBodySize?: number;
+    replayWindowMs?: number;
+}
+export declare function createProtocolHandler(options: ProtocolHandlerOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/transport/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/transport/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,sBAAsB,CAAA;AAO7B,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAClE,SAAS,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAwCD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAmF9G"}

package/dist/transport/handler.js

@@ -0,0 +1,105 @@
+import { TransportAckSchema, parseProtocolMessageSafe, } from "../protocol/index.js";
+import { MessageDeduplicationCache } from "./dedup.js";
+import { verifyPayload } from "./hmac.js";
+const DEFAULT_MAX_BODY_SIZE = 256 * 1024;
+const DEFAULT_REPLAY_WINDOW_MS = 5 * 60 * 1000;
+function jsonResponse(status, payload) {
+    return new Response(JSON.stringify(payload), {
+        status,
+        headers: { "content-type": "application/json" },
+    });
+}
+function errorResponse(status, errorCode, message, details) {
+    return jsonResponse(status, {
+        error_code: errorCode,
+        message,
+        ...(details ? { details } : {}),
+    });
+}
+function requireHeader(request, name) {
+    const value = request.headers.get(name);
+    if (!value) {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function isTimestampFresh(timestamp, replayWindowMs) {
+    const parsed = Date.parse(timestamp);
+    if (Number.isNaN(parsed)) {
+        return false;
+    }
+    return Math.abs(Date.now() - parsed) <= replayWindowMs;
+}
+export function createProtocolHandler(options) {
+    const maxBodySize = options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE;
+    const replayWindowMs = options.replayWindowMs ?? DEFAULT_REPLAY_WINDOW_MS;
+    const dedupCache = new MessageDeduplicationCache();
+    return async function protocolHandler(request) {
+        if (request.method !== "POST") {
+            return new Response("Method Not Allowed", { status: 405 });
+        }
+        try {
+            const contentLengthHeader = request.headers.get("content-length");
+            if (contentLengthHeader) {
+                const contentLength = Number.parseInt(contentLengthHeader, 10);
+                if (Number.isFinite(contentLength) && contentLength > maxBodySize) {
+                    return errorResponse(400, "bad_request", "Request body exceeds maximum allowed size");
+                }
+            }
+            const body = await request.text();
+            if (new TextEncoder().encode(body).byteLength > maxBodySize) {
+                return errorResponse(400, "bad_request", "Request body exceeds maximum allowed size");
+            }
+            const senderAgentId = requireHeader(request, "X-Artemys-Sender-Agent-Id");
+            const timestamp = requireHeader(request, "X-Artemys-Timestamp");
+            const signature = requireHeader(request, "X-Artemys-Signature");
+            const headerMessageId = requireHeader(request, "X-Artemys-Message-Id");
+            if (!senderAgentId || !timestamp || !signature || !headerMessageId) {
+                return errorResponse(401, "unauthorized", "Missing required authentication headers");
+            }
+            if (!isTimestampFresh(timestamp, replayWindowMs)) {
+                return errorResponse(401, "unauthorized", "Request timestamp is outside replay window");
+            }
+            const sharedSecret = await options.getSharedSecret(senderAgentId);
+            if (!sharedSecret) {
+                return errorResponse(401, "unauthorized", "Unknown sender");
+            }
+            const isValid = await verifyPayload(senderAgentId, timestamp, body, signature, sharedSecret);
+            if (!isValid) {
+                return errorResponse(401, "unauthorized", "Invalid signature");
+            }
+            if (dedupCache.has(senderAgentId, headerMessageId)) {
+                return errorResponse(409, "conflict", "Duplicate message_id for sender");
+            }
+            let rawMessage;
+            try {
+                rawMessage = JSON.parse(body);
+            }
+            catch {
+                return errorResponse(400, "bad_request", "Body is not valid JSON");
+            }
+            const parsed = parseProtocolMessageSafe(rawMessage);
+            if (!parsed.ok) {
+                return errorResponse(400, "bad_request", parsed.error.message);
+            }
+            if (parsed.message.sender_agent_id !== senderAgentId) {
+                return errorResponse(401, "unauthorized", "sender_agent_id does not match header");
+            }
+            if (parsed.message.message_id !== headerMessageId) {
+                return errorResponse(400, "bad_request", "message_id does not match header");
+            }
+            await options.onMessage(parsed.message, senderAgentId);
+            dedupCache.add(senderAgentId, parsed.message.message_id);
+            const ack = TransportAckSchema.parse({
+                received: true,
+                message_id: parsed.message.message_id,
+            });
+            return jsonResponse(202, ack);
+        }
+        catch {
+            return errorResponse(500, "internal_error", "Internal server error");
+        }
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/transport/handler.js.map

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

package/dist/transport/hmac.d.ts

@@ -0,0 +1,3 @@
+export declare function signPayload(senderAgentId: string, timestamp: string, body: string, secret: string): Promise<string>;
+export declare function verifyPayload(senderAgentId: string, timestamp: string, body: string, signature: string, secret: string): Promise<boolean>;
+//# sourceMappingURL=hmac.d.ts.map

package/dist/transport/hmac.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmac.d.ts","sourceRoot":"","sources":["../../src/transport/hmac.ts"],"names":[],"mappings":"AAuCA,wBAAsB,WAAW,CAC/B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/transport/hmac.js

@@ -0,0 +1,43 @@
+const encoder = new TextEncoder();
+function getSubtleCrypto() {
+    if (!globalThis.crypto?.subtle) {
+        throw new Error("Web Crypto API is not available in this runtime");
+    }
+    return globalThis.crypto.subtle;
+}
+function toHex(buffer) {
+    return Array.from(new Uint8Array(buffer), (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function fromHex(hex) {
+    if (hex.length % 2 !== 0) {
+        throw new Error("Invalid hex string");
+    }
+    const bytes = new Uint8Array(new ArrayBuffer(hex.length / 2));
+    for (let i = 0; i < hex.length; i += 2) {
+        bytes[i / 2] = Number.parseInt(hex.slice(i, i + 2), 16);
+    }
+    return bytes;
+}
+async function importHmacKey(secret, usage) {
+    return await getSubtleCrypto().importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, [usage]);
+}
+function buildPayload(senderAgentId, timestamp, body) {
+    return `${senderAgentId}.${timestamp}.${body}`;
+}
+export async function signPayload(senderAgentId, timestamp, body, secret) {
+    const key = await importHmacKey(secret, "sign");
+    const payload = buildPayload(senderAgentId, timestamp, body);
+    const signature = await getSubtleCrypto().sign("HMAC", key, encoder.encode(payload));
+    return toHex(signature);
+}
+export async function verifyPayload(senderAgentId, timestamp, body, signature, secret) {
+    try {
+        const key = await importHmacKey(secret, "verify");
+        const payload = buildPayload(senderAgentId, timestamp, body);
+        return await getSubtleCrypto().verify("HMAC", key, fromHex(signature), encoder.encode(payload));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=hmac.js.map

package/dist/transport/hmac.js.map

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

package/dist/transport/index.d.ts

@@ -0,0 +1,6 @@
+export { signPayload, verifyPayload } from "./hmac.js";
+export { ProtocolTransportClient, type TransportClientOptions, type TransportResult, type TransportSendOptions, } from "./client.js";
+export { createProtocolHandler, type ProtocolHandlerOptions } from "./handler.js";
+export { MessageDeduplicationCache } from "./dedup.js";
+export { runReferenceConversation, type ReferenceRunnerOptions, type ReferenceRunnerResult, type ReferenceRunnerScenario, } from "./reference-runner.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEtD,OAAO,EACL,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAEjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtD,OAAO,EACL,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAA"}

package/dist/transport/index.js

@@ -0,0 +1,6 @@
+export { signPayload, verifyPayload } from "./hmac.js";
+export { ProtocolTransportClient, } from "./client.js";
+export { createProtocolHandler } from "./handler.js";
+export { MessageDeduplicationCache } from "./dedup.js";
+export { runReferenceConversation, } from "./reference-runner.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEtD,OAAO,EACL,uBAAuB,GAIxB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,qBAAqB,EAA+B,MAAM,cAAc,CAAA;AAEjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtD,OAAO,EACL,wBAAwB,GAIzB,MAAM,uBAAuB,CAAA"}

package/dist/transport/reference-runner.d.ts

@@ -0,0 +1,37 @@
+import { ConversationTracker } from "../mcp-server/state.js";
+import { type ProtocolMessage } from "../protocol/index.js";
+import { type SessionBootstrap } from "../discovery/index.js";
+export type ReferenceRunnerScenario = "happy_path" | "timeout_deferred";
+export interface ReferenceRunnerOptions {
+    scenario?: ReferenceRunnerScenario;
+    responseTimeoutMs?: number;
+}
+export interface ReferenceRunnerResult {
+    scenario: ReferenceRunnerScenario;
+    discovery: {
+        requester_agent_id: string;
+        discovered_target_agent_id: string;
+    };
+    intro: {
+        intro_id: string;
+        bootstrap: SessionBootstrap;
+    };
+    transport_receipts: Array<{
+        message_id: string;
+        sender_agent_id: string;
+        receiver_endpoint: string;
+        status: 202;
+    }>;
+    semantic_replies: Array<{
+        trigger_message_id: string;
+        reply_message_id: string;
+    }>;
+    transcript: ProtocolMessage[];
+    final_state: ReturnType<ConversationTracker["getState"]>;
+    timeout_policy: {
+        response_timeout_ms: number;
+        deferred_emitted: boolean;
+    };
+}
+export declare function runReferenceConversation(options?: ReferenceRunnerOptions): Promise<ReferenceRunnerResult>;
+//# sourceMappingURL=reference-runner.d.ts.map

package/dist/transport/reference-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-runner.d.ts","sourceRoot":"","sources":["../../src/transport/reference-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACnG,OAAO,EAA0C,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAIrG,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,kBAAkB,CAAA;AAEvE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,uBAAuB,CAAA;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,uBAAuB,CAAA;IACjC,SAAS,EAAE;QACT,kBAAkB,EAAE,MAAM,CAAA;QAC1B,0BAA0B,EAAE,MAAM,CAAA;KACnC,CAAA;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,gBAAgB,CAAA;KAC5B,CAAA;IACD,kBAAkB,EAAE,KAAK,CAAC;QACxB,UAAU,EAAE,MAAM,CAAA;QAClB,eAAe,EAAE,MAAM,CAAA;QACvB,iBAAiB,EAAE,MAAM,CAAA;QACzB,MAAM,EAAE,GAAG,CAAA;KACZ,CAAC,CAAA;IACF,gBAAgB,EAAE,KAAK,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAC,CAAA;IACF,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,WAAW,EAAE,UAAU,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAA;IACxD,cAAc,EAAE;QACd,mBAAmB,EAAE,MAAM,CAAA;QAC3B,gBAAgB,EAAE,OAAO,CAAA;KAC1B,CAAA;CACF;AA6MD,wBAAsB,wBAAwB,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA0NnH"}