@adcp/sdk 6.8.0 → 6.10.0

package/dist/lib/server/operational-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational-platform.d.ts","sourceRoot":"","sources":["../../../src/lib/server/operational-platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,kBAAkB,GAAG,kBAAkB;IACvF;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3G;;;;;;;OAOG;IACH,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE3F;;;;;;;;;;;;;;;OAeG;IACH,mBAAmB,CACjB,GAAG,EAAE,IAAI,EACT,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,oBAAoB,CAAC,CACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAExC;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,CACV,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,SAAS,kBAAkB,GAAG,kBAAkB,EAC5F,GAAG,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAC7B,mBAAmB,CAAC,IAAI,CAAC,CAE3B"}

package/dist/lib/server/operational-platform.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * `OperationalPlatform` — in-process operational contract.
+ *
+ * `DecisioningPlatform` covers buyer-facing MCP request dispatch:
+ * `platform.sales.updateMediaBuy(req, ctx)` etc., where `ctx` is a
+ * `RequestContext` built by the framework from `authInfo` via
+ * `AccountStore.resolve`, threading `state`, `resolve`, `ctxMetadata`,
+ * and `handoffToTask`.
+ *
+ * In-process consumers are different. The price-optimization poller,
+ * audience-sync task poller, scheduled jobs, and the storefront
+ * fan-out path do NOT have an MCP request to derive auth from. They
+ * have a stored task with an access token (or, for fan-out, no token
+ * — the storefront synthesizes one per upstream target). They cannot
+ * honestly satisfy `RequestContext`. Every adopter doing operational
+ * work would otherwise reinvent this seam.
+ *
+ * `OperationalPlatform` is the named contract for that seam. Five
+ * methods covering the real operational surface:
+ *
+ * 1. `extractContext` — synthesize a per-call platform context from
+ *    a stored token (and optional request args, for fan-out callers).
+ *    The single CTX-METADATA-SAFETY boundary outside
+ *    `AccountStore.resolve`: anything touching credentials in an
+ *    in-process consumer flows through here.
+ * 2. `updateMediaBuy` — required. Fan-out callers dispatch one of
+ *    these per upstream target.
+ * 3. `getMediaBuyDelivery` — required. Pollers read delivery metrics
+ *    here.
+ * 4. `pollAudienceStatuses` — optional. Audience-sync pollers only.
+ * 5. `getProducts` — optional. Storefront bundle composition only;
+ *    server-side internal call, not buyer-facing dispatch.
+ *
+ * Naming the contract honestly — "operational" rather than "adapter"
+ * — separates it from any v5 `PlatformAdapter` baggage and from
+ * `DecisioningPlatform`'s MCP-request flow. Tests mock
+ * `OperationalPlatform`, not the broader v6 interface.
+ *
+ * Errors: methods throw `AdcpError` for structured rejection, matching
+ * `DecisioningPlatform`'s convention. Generic thrown `Error` /
+ * `TypeError` propagate; callers catch and log per their needs.
+ *
+ * Status: 6.10. See adcontextprotocol/adcp-client#1530.
+ *
+ * @see DecisioningPlatform — buyer-facing MCP dispatch
+ * @see docs/guides/CTX-METADATA-SAFETY.md — credential discipline
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineOperationalPlatform = defineOperationalPlatform;
+/**
+ * Type-level identity for an `OperationalPlatform` object literal.
+ * Forces the contextual type so handler bodies get typed `ctx` and
+ * `request` parameters in TypeScript without an explicit annotation.
+ *
+ * Mirrors the `definePlatform` family for `DecisioningPlatform`
+ * sub-interfaces — see `decisioning/platform-helpers.ts`.
+ *
+ * @example
+ * ```ts
+ * import { defineOperationalPlatform } from '@adcp/sdk/server';
+ * import { AdcpError } from '@adcp/sdk/server';
+ *
+ * interface SnapOpCtx extends OperationalContext {
+ *   advertiserId: string;
+ * }
+ *
+ * export const snapOperational = defineOperationalPlatform<SnapOpCtx>({
+ *   platformId: 'snap',
+ *   extractContext: async (args, sessionToken, requireAuth = true) => {
+ *     const token = sessionToken ?? String(args.snap_access_token ?? '');
+ *     if (!token && requireAuth) {
+ *       throw new AdcpError('AUTH_REQUIRED', { message: 'No Snap token available' });
+ *     }
+ *     return {
+ *       accessToken: token || undefined,
+ *       advertiserId: String(args.advertiser_id ?? ''),
+ *     };
+ *   },
+ *   updateMediaBuy: async (ctx, request) => {
+ *     // ctx.advertiserId typed ✓; request: UpdateMediaBuyRequest ✓
+ *     return upstream.update(ctx, request);
+ *   },
+ *   getMediaBuyDelivery: async (ctx, id, start, end) => {
+ *     return upstream.delivery(ctx, id, start, end);
+ *   },
+ * });
+ * ```
+ */
+function defineOperationalPlatform(ops) {
+    return ops;
+}
+//# sourceMappingURL=operational-platform.js.map

package/dist/lib/server/operational-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational-platform.js","sourceRoot":"","sources":["../../../src/lib/server/operational-platform.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;;AA2NH,8DAIC;AA3CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,SAAgB,yBAAyB,CACvC,GAA8B;IAE9B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/server/socket-mode/conformance-client.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Adopter-facing Socket Mode client.
+ *
+ * Opens an outbound WebSocket from your dev/staging environment to a
+ * remote AdCP runner (typically Addie at agenticadvertising.org) and
+ * exposes your existing MCP `Server` over it. The remote runner can
+ * then drive `tools/list`, `tools/call`, etc. against your server
+ * exactly as if it had reached you over HTTP — no public DNS, no
+ * inbound exposure.
+ *
+ * Three-line integration:
+ *
+ * ```ts
+ * import { ConformanceClient } from '@adcp/sdk/server';
+ * import { mcpServer } from './my-mcp-server';
+ *
+ * const client = new ConformanceClient({
+ *   url: 'wss://addie.agenticadvertising.org/conformance/connect',
+ *   token: process.env.ADCP_CONFORMANCE_TOKEN!,
+ *   server: mcpServer,
+ * });
+ * await client.start();
+ * ```
+ *
+ * Reconnect: exponential backoff capped at 30s. Stop via `close()` to
+ * opt out of further reconnect attempts.
+ *
+ * Dev/staging only by design — production deployments must not expose
+ * `comply_test_controller` on any surface, including this channel.
+ * See [adcontextprotocol/adcp#3986](https://github.com/adcontextprotocol/adcp/issues/3986).
+ */
+import type { Server as MCPServer } from '@modelcontextprotocol/sdk/server/index.js';
+export type ConformanceStatus = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'error';
+export interface ConformanceClientOptions {
+    /**
+     * The remote runner's WebSocket URL. For Addie this is
+     * `wss://addie.agenticadvertising.org/conformance/connect` in
+     * production, `ws://localhost:3000/conformance/connect` in dev.
+     */
+    url: string;
+    /**
+     * Adopter-account-bound token issued by the runner. For Addie, ask in
+     * chat ("give me a fresh conformance token") or POST /api/conformance/token.
+     * Tokens are short-lived (typically 1h); on expiry, re-request and
+     * pass the new token via a fresh `ConformanceClient`.
+     */
+    token: string;
+    /**
+     * Your existing MCP server. The same instance you'd connect to
+     * `StreamableHTTPServerTransport` for normal traffic — this client
+     * exposes it bidirectionally over the outbound WebSocket.
+     */
+    server: MCPServer;
+    /**
+     * If true (default), reconnect on disconnect with exponential backoff
+     * up to 30s. Set false for one-shot connections.
+     */
+    reconnect?: boolean;
+    /**
+     * Status callback. Fires on every state transition. Useful for
+     * surfacing connection state in dev tooling or CI logs.
+     */
+    onStatus?: (status: ConformanceStatus, detail?: {
+        error?: Error;
+        attempt?: number;
+    }) => void;
+}
+export declare class ConformanceClient {
+    private status;
+    private socket?;
+    private transport?;
+    private stopped;
+    private reconnectAttempt;
+    private readonly opts;
+    constructor(opts: ConformanceClientOptions);
+    start(): Promise<void>;
+    close(): Promise<void>;
+    getStatus(): ConformanceStatus;
+    private connect;
+    private scheduleReconnect;
+    private setStatus;
+}
+//# sourceMappingURL=conformance-client.d.ts.map

package/dist/lib/server/socket-mode/conformance-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance-client.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/socket-mode/conformance-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAGrF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;AAE/F,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9F;AAKD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmF;gBAE5F,IAAI,EAAE,wBAAwB;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,SAAS,IAAI,iBAAiB;YAIhB,OAAO;YA8BP,iBAAiB;IAa/B,OAAO,CAAC,SAAS;CAIlB"}

package/dist/lib/server/socket-mode/conformance-client.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Adopter-facing Socket Mode client.
+ *
+ * Opens an outbound WebSocket from your dev/staging environment to a
+ * remote AdCP runner (typically Addie at agenticadvertising.org) and
+ * exposes your existing MCP `Server` over it. The remote runner can
+ * then drive `tools/list`, `tools/call`, etc. against your server
+ * exactly as if it had reached you over HTTP — no public DNS, no
+ * inbound exposure.
+ *
+ * Three-line integration:
+ *
+ * ```ts
+ * import { ConformanceClient } from '@adcp/sdk/server';
+ * import { mcpServer } from './my-mcp-server';
+ *
+ * const client = new ConformanceClient({
+ *   url: 'wss://addie.agenticadvertising.org/conformance/connect',
+ *   token: process.env.ADCP_CONFORMANCE_TOKEN!,
+ *   server: mcpServer,
+ * });
+ * await client.start();
+ * ```
+ *
+ * Reconnect: exponential backoff capped at 30s. Stop via `close()` to
+ * opt out of further reconnect attempts.
+ *
+ * Dev/staging only by design — production deployments must not expose
+ * `comply_test_controller` on any surface, including this channel.
+ * See [adcontextprotocol/adcp#3986](https://github.com/adcontextprotocol/adcp/issues/3986).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConformanceClient = void 0;
+const ws_1 = __importDefault(require("ws"));
+const ws_transport_1 = require("./ws-transport");
+const RECONNECT_INITIAL_MS = 1000;
+const RECONNECT_MAX_MS = 30_000;
+class ConformanceClient {
+    status = 'idle';
+    socket;
+    transport;
+    stopped = false;
+    reconnectAttempt = 0;
+    opts;
+    constructor(opts) {
+        this.opts = { reconnect: true, ...opts };
+    }
+    async start() {
+        this.stopped = false;
+        await this.connect();
+    }
+    async close() {
+        this.stopped = true;
+        if (this.transport) {
+            await this.transport.close();
+        }
+        else if (this.socket) {
+            this.socket.close(1000, 'adopter close');
+        }
+        this.setStatus('idle');
+    }
+    getStatus() {
+        return this.status;
+    }
+    async connect() {
+        this.setStatus('connecting');
+        const url = new URL(this.opts.url);
+        url.searchParams.set('token', this.opts.token);
+        const socket = new ws_1.default(url.toString());
+        this.socket = socket;
+        const transport = new ws_transport_1.WebSocketTransport(socket);
+        this.transport = transport;
+        socket.once('close', () => {
+            this.setStatus('disconnected');
+            if (!this.stopped && this.opts.reconnect) {
+                void this.scheduleReconnect();
+            }
+        });
+        try {
+            await this.opts.server.connect(transport);
+            this.reconnectAttempt = 0;
+            this.setStatus('connected');
+        }
+        catch (err) {
+            this.setStatus('error', { error: err });
+            socket.close(1011, 'connect failed');
+            if (!this.stopped && this.opts.reconnect) {
+                void this.scheduleReconnect();
+            }
+            throw err;
+        }
+    }
+    async scheduleReconnect() {
+        this.reconnectAttempt += 1;
+        const delay = Math.min(RECONNECT_INITIAL_MS * 2 ** (this.reconnectAttempt - 1), RECONNECT_MAX_MS);
+        this.setStatus('connecting', { attempt: this.reconnectAttempt });
+        await new Promise(r => setTimeout(r, delay));
+        if (this.stopped)
+            return;
+        try {
+            await this.connect();
+        }
+        catch {
+            // setStatus already invoked; loop continues via the close handler
+        }
+    }
+    setStatus(status, detail) {
+        this.status = status;
+        this.opts.onStatus?.(status, detail);
+    }
+}
+exports.ConformanceClient = ConformanceClient;
+//# sourceMappingURL=conformance-client.js.map

package/dist/lib/server/socket-mode/conformance-client.js.map

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

package/dist/lib/server/socket-mode/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Socket Mode — outbound-WebSocket bridge so an adopter's MCP server
+ * can be reached by a remote runner without a public DNS / firewall
+ * hole. Slack Socket Mode pattern.
+ *
+ * Today the canonical consumer is Addie at agenticadvertising.org for
+ * conformance assistance during agent development. The transport is
+ * neutral — any third-party orchestrator that speaks the same handshake
+ * could terminate the other end.
+ *
+ * Dev/staging only — see `ConformanceClient` JSDoc for the policy.
+ */
+export { ConformanceClient, type ConformanceClientOptions, type ConformanceStatus } from './conformance-client';
+export { WebSocketTransport } from './ws-transport';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/server/socket-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/socket-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/server/socket-mode/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Socket Mode — outbound-WebSocket bridge so an adopter's MCP server
+ * can be reached by a remote runner without a public DNS / firewall
+ * hole. Slack Socket Mode pattern.
+ *
+ * Today the canonical consumer is Addie at agenticadvertising.org for
+ * conformance assistance during agent development. The transport is
+ * neutral — any third-party orchestrator that speaks the same handshake
+ * could terminate the other end.
+ *
+ * Dev/staging only — see `ConformanceClient` JSDoc for the policy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketTransport = exports.ConformanceClient = void 0;
+var conformance_client_1 = require("./conformance-client");
+Object.defineProperty(exports, "ConformanceClient", { enumerable: true, get: function () { return conformance_client_1.ConformanceClient; } });
+var ws_transport_1 = require("./ws-transport");
+Object.defineProperty(exports, "WebSocketTransport", { enumerable: true, get: function () { return ws_transport_1.WebSocketTransport; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/server/socket-mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/server/socket-mode/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,2DAAgH;AAAvG,uHAAA,iBAAiB,OAAA;AAC1B,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA"}

package/dist/lib/server/socket-mode/ws-transport.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Adopter-side MCP `Transport` over an outbound WebSocket.
+ *
+ * Wraps a `ws` Node WebSocket as the MCP SDK's `Transport` interface
+ * so an existing `Server` instance can be exposed bidirectionally over
+ * a single outbound connection.
+ *
+ * This is the building block for "Socket Mode" — see `ConformanceClient`
+ * for the high-level adopter-facing class.
+ */
+import WebSocket from 'ws';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { type JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+export declare class WebSocketTransport implements Transport {
+    private readonly socket;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: JSONRPCMessage) => void;
+    sessionId?: string;
+    private closed;
+    constructor(socket: WebSocket);
+    start(): Promise<void>;
+    send(message: JSONRPCMessage): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ws-transport.d.ts.map

package/dist/lib/server/socket-mode/ws-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/socket-mode/ws-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAE/F,qBAAa,kBAAmB,YAAW,SAAS;IAQtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,MAAM,CAAS;gBAEM,MAAM,EAAE,SAAS;IAExC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCtB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}

package/dist/lib/server/socket-mode/ws-transport.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Adopter-side MCP `Transport` over an outbound WebSocket.
+ *
+ * Wraps a `ws` Node WebSocket as the MCP SDK's `Transport` interface
+ * so an existing `Server` instance can be exposed bidirectionally over
+ * a single outbound connection.
+ *
+ * This is the building block for "Socket Mode" — see `ConformanceClient`
+ * for the high-level adopter-facing class.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketTransport = void 0;
+const ws_1 = __importDefault(require("ws"));
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+class WebSocketTransport {
+    socket;
+    onclose;
+    onerror;
+    onmessage;
+    sessionId;
+    closed = false;
+    constructor(socket) {
+        this.socket = socket;
+    }
+    async start() {
+        this.socket.on('message', (data, isBinary) => {
+            if (isBinary) {
+                this.onerror?.(new Error('binary frames are not supported'));
+                return;
+            }
+            const text = data.toString('utf-8');
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch (err) {
+                this.onerror?.(new Error(`malformed JSON frame: ${err.message}`));
+                return;
+            }
+            const result = types_js_1.JSONRPCMessageSchema.safeParse(parsed);
+            if (!result.success) {
+                this.onerror?.(new Error(`malformed JSON-RPC message: ${result.error.message}`));
+                return;
+            }
+            this.onmessage?.(result.data);
+        });
+        this.socket.on('close', () => {
+            if (this.closed)
+                return;
+            this.closed = true;
+            this.onclose?.();
+        });
+        this.socket.on('error', err => {
+            this.onerror?.(err);
+        });
+        if (this.socket.readyState === ws_1.default.CONNECTING) {
+            await new Promise((resolve, reject) => {
+                this.socket.once('open', () => resolve());
+                this.socket.once('error', reject);
+            });
+        }
+    }
+    async send(message) {
+        if (this.closed)
+            throw new Error('transport closed');
+        return new Promise((resolve, reject) => {
+            this.socket.send(JSON.stringify(message), err => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        try {
+            this.socket.close(1000, 'transport closed');
+        }
+        catch {
+            // ignore
+        }
+        this.onclose?.();
+    }
+}
+exports.WebSocketTransport = WebSocketTransport;
+//# sourceMappingURL=ws-transport.js.map

package/dist/lib/server/socket-mode/ws-transport.js.map

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