@superdurable/dex-agents 0.0.0-stage → 0.2.0

package/dist/src/ui-stream/agent-ui-stream-cursor.d.ts

@@ -0,0 +1,64 @@
+import { type AgentToolCallRecord } from "../agent-session-values.js";
+/**
+ * What the browser already shows of one tool call in the current model call.
+ *
+ * - `input`: the tool part exists; no approval was requested.
+ * - `approval_requested`: the part waits for `resolve_interrupt`.
+ * - `approval_resolved`: the session accepted the approval or rejection.
+ * - `finished`: the part shows the call's result.
+ */
+export type ToolCallUIState = "input" | "approval_requested" | "approval_resolved" | "finished";
+/** The `RunModel` Step execution whose parts the browser shows last. */
+export interface ModelStepPosition {
+    readonly stepExecutionId: string;
+    attempt: number;
+    openedPartCount: number;
+    isUsageRecorded: boolean;
+}
+/** A text or reasoning part that the browser keeps open for further deltas. */
+export interface OpenUIPart {
+    readonly kind: "text" | "reasoning";
+    readonly id: string;
+}
+/**
+ * Everything a stateless server needs to continue a UI message stream exactly where a browser left it:
+ * the Dex resume token plus the parts the browser has open.
+ */
+export interface AgentUIStreamCursor {
+    /** Dex resume token of the last event whose parts the browser holds, or `""` for the retained head. */
+    eventResumeToken: string;
+    /** Parts of the event after `eventResumeToken` that the browser already holds. */
+    skippedChunkCount: number;
+    turnId: string | null;
+    /** While `turnId` is `null`, only a turn with a higher number is followed. */
+    afterTurnNumber: number | null;
+    /** Dex resume token just before the followed turn's first event, when known. */
+    turnStartResumeToken: string | null;
+    isMessageStarted: boolean;
+    isTurnFinished: boolean;
+    modelStep: ModelStepPosition | null;
+    openPart: OpenUIPart | null;
+    readonly toolCalls: Map<string, ToolCallUIState>;
+}
+/** Maximum length of a UI stream resume token; it must fit an HTTP header. */
+export declare const maximumAgentUIStreamResumeTokenLength: number;
+/** Creates a cursor at one Stream position with nothing shown yet. */
+export declare function createAgentUIStreamCursor(eventResumeToken: string, turnId: string | null, isMessageStarted: boolean): AgentUIStreamCursor;
+/** Returns an independent copy of a cursor. */
+export declare function cloneAgentUIStreamCursor(cursor: AgentUIStreamCursor): AgentUIStreamCursor;
+/** Returns what a browser that rendered these tool call records shows for them. */
+export declare function toolCallUIStateOfRecord(toolCall: AgentToolCallRecord): ToolCallUIState;
+/**
+ * Encodes a cursor as the opaque, URL-safe UI stream resume token.
+ *
+ * Finished tool calls are dropped when the token would exceed the limit; a repeated event for one then
+ * repeats an idempotent tool part update.
+ * @throws {RangeError} When the token exceeds {@link maximumAgentUIStreamResumeTokenLength} anyway.
+ */
+export declare function encodeAgentUIStreamCursor(cursor: AgentUIStreamCursor): string;
+/**
+ * Decodes a UI stream resume token from a browser.
+ *
+ * @throws {TypeError} When the token was not produced by {@link encodeAgentUIStreamCursor}.
+ */
+export declare function decodeAgentUIStreamCursor(resumeToken: string): AgentUIStreamCursor;

package/dist/src/ui-stream/agent-ui-stream-cursor.js

@@ -0,0 +1,186 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { isFinalToolCallStatus } from "../agent-session-values.js";
+/** Maximum length of a UI stream resume token; it must fit an HTTP header. */
+export const maximumAgentUIStreamResumeTokenLength = 64 * 1024;
+const cursorVersion = 2;
+const toolCallUIStates = [
+    "input",
+    "approval_requested",
+    "approval_resolved",
+    "finished",
+];
+/** Creates a cursor at one Stream position with nothing shown yet. */
+export function createAgentUIStreamCursor(eventResumeToken, turnId, isMessageStarted) {
+    return {
+        eventResumeToken,
+        skippedChunkCount: 0,
+        turnId,
+        afterTurnNumber: null,
+        turnStartResumeToken: null,
+        isMessageStarted,
+        isTurnFinished: false,
+        modelStep: null,
+        openPart: null,
+        toolCalls: new Map(),
+    };
+}
+/** Returns an independent copy of a cursor. */
+export function cloneAgentUIStreamCursor(cursor) {
+    return {
+        ...cursor,
+        modelStep: cursor.modelStep === null ? null : { ...cursor.modelStep },
+        toolCalls: new Map(cursor.toolCalls),
+    };
+}
+/** Returns what a browser that rendered these tool call records shows for them. */
+export function toolCallUIStateOfRecord(toolCall) {
+    if (isFinalToolCallStatus(toolCall.status)) {
+        return "finished";
+    }
+    if (toolCall.status === "awaiting_approval") {
+        return "approval_requested";
+    }
+    return toolCall.requiresApproval ? "approval_resolved" : "input";
+}
+/**
+ * Encodes a cursor as the opaque, URL-safe UI stream resume token.
+ *
+ * Finished tool calls are dropped when the token would exceed the limit; a repeated event for one then
+ * repeats an idempotent tool part update.
+ * @throws {RangeError} When the token exceeds {@link maximumAgentUIStreamResumeTokenLength} anyway.
+ */
+export function encodeAgentUIStreamCursor(cursor) {
+    const resumeToken = encodeWireCursor(cursor, [...cursor.toolCalls.entries()]);
+    if (resumeToken.length <= maximumAgentUIStreamResumeTokenLength) {
+        return resumeToken;
+    }
+    const openToolCalls = [...cursor.toolCalls.entries()].filter(([, state]) => state !== "finished");
+    const compactResumeToken = encodeWireCursor(cursor, openToolCalls);
+    if (compactResumeToken.length > maximumAgentUIStreamResumeTokenLength) {
+        throw new RangeError(`the agent UI stream resume token exceeds ${maximumAgentUIStreamResumeTokenLength} characters`);
+    }
+    return compactResumeToken;
+}
+/**
+ * Decodes a UI stream resume token from a browser.
+ *
+ * @throws {TypeError} When the token was not produced by {@link encodeAgentUIStreamCursor}.
+ */
+export function decodeAgentUIStreamCursor(resumeToken) {
+    if (resumeToken.length === 0 || resumeToken.length > maximumAgentUIStreamResumeTokenLength) {
+        throw invalidResumeToken();
+    }
+    let wireCursor;
+    try {
+        wireCursor = JSON.parse(Buffer.from(resumeToken, "base64url").toString("utf8"));
+    }
+    catch {
+        throw invalidResumeToken();
+    }
+    if (!isRecord(wireCursor) || wireCursor["v"] !== cursorVersion) {
+        throw invalidResumeToken();
+    }
+    const { e: eventResumeToken, k: skippedChunkCount, t: turnId, a: afterTurnNumber, b: turnStartResumeToken, s: isMessageStarted, f: isTurnFinished, } = wireCursor;
+    if (typeof eventResumeToken !== "string" ||
+        !isNonNegativeInteger(skippedChunkCount) ||
+        (turnId !== null && typeof turnId !== "string") ||
+        (afterTurnNumber !== null && !isNonNegativeInteger(afterTurnNumber)) ||
+        (turnStartResumeToken !== null && typeof turnStartResumeToken !== "string") ||
+        typeof isMessageStarted !== "boolean" ||
+        typeof isTurnFinished !== "boolean") {
+        throw invalidResumeToken();
+    }
+    return {
+        eventResumeToken,
+        skippedChunkCount,
+        turnId,
+        afterTurnNumber,
+        turnStartResumeToken,
+        isMessageStarted,
+        isTurnFinished,
+        modelStep: decodeModelStep(wireCursor["m"]),
+        openPart: decodeOpenPart(wireCursor["o"]),
+        toolCalls: decodeToolCalls(wireCursor["c"]),
+    };
+}
+function encodeWireCursor(cursor, toolCalls) {
+    const modelStep = cursor.modelStep;
+    const wireCursor = {
+        v: cursorVersion,
+        e: cursor.eventResumeToken,
+        k: cursor.skippedChunkCount,
+        t: cursor.turnId,
+        a: cursor.afterTurnNumber,
+        b: cursor.turnStartResumeToken,
+        s: cursor.isMessageStarted,
+        f: cursor.isTurnFinished,
+        m: modelStep === null
+            ? null
+            : [modelStep.stepExecutionId, modelStep.attempt, modelStep.openedPartCount, modelStep.isUsageRecorded],
+        o: cursor.openPart === null ? null : [cursor.openPart.kind, cursor.openPart.id],
+        c: toolCalls,
+    };
+    return Buffer.from(JSON.stringify(wireCursor), "utf8").toString("base64url");
+}
+function decodeModelStep(value) {
+    if (value === null) {
+        return null;
+    }
+    if (!Array.isArray(value) || value.length !== 4) {
+        throw invalidResumeToken();
+    }
+    const [stepExecutionId, attempt, openedPartCount, isUsageRecorded] = value;
+    if (typeof stepExecutionId !== "string" ||
+        !isNonNegativeInteger(attempt) ||
+        !isNonNegativeInteger(openedPartCount) ||
+        typeof isUsageRecorded !== "boolean") {
+        throw invalidResumeToken();
+    }
+    return { stepExecutionId, attempt, openedPartCount, isUsageRecorded };
+}
+function decodeOpenPart(value) {
+    if (value === null) {
+        return null;
+    }
+    if (!Array.isArray(value) || value.length !== 2) {
+        throw invalidResumeToken();
+    }
+    const [kind, id] = value;
+    if ((kind !== "text" && kind !== "reasoning") || typeof id !== "string") {
+        throw invalidResumeToken();
+    }
+    return { kind, id };
+}
+function decodeToolCalls(value) {
+    if (!Array.isArray(value)) {
+        throw invalidResumeToken();
+    }
+    const toolCalls = new Map();
+    for (const entry of value) {
+        if (!Array.isArray(entry) || entry.length !== 2) {
+            throw invalidResumeToken();
+        }
+        const [toolCallId, state] = entry;
+        if (typeof toolCallId !== "string" || !toolCallUIStates.includes(state)) {
+            throw invalidResumeToken();
+        }
+        toolCalls.set(toolCallId, state);
+    }
+    return toolCalls;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function invalidResumeToken() {
+    return new TypeError("the agent UI stream resume token is invalid");
+}
+//# sourceMappingURL=agent-ui-stream-cursor.js.map

package/dist/src/ui-stream/agent-ui-stream-cursor.js.map

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

package/dist/src/ui-stream/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * UI stream adapters for agent sessions: an AI SDK UI message stream, a plain Server-Sent Events stream,
+ * and session snapshots, all read from the session's `AgentEvents` Stream and resumable after a reconnect.
+ *
+ * @packageDocumentation
+ */
+export { convertAgentEventToJson, convertAgentSnapshotToJson } from "./agent-event-json.js";
+export { agentEventStreamHeaders, convertAgentEventStreamSnapshotToJson, createAgentEventSseResponse, formatAgentEventSseFrame, readAgentEventStreamSnapshot, streamAgentEventSseFrames, type AgentEventSseOptions, type AgentEventStreamSnapshot, type AgentEventStreamSnapshotJson, } from "./agent-event-sse.js";
+export { defaultAgentEventPollTimeoutMs } from "./agent-event-stream-positions.js";
+export { streamAgentUIMessageChunks, type AgentUIMessageStreamOptions, } from "./agent-ui-message-stream.js";
+export { agentResumeTokenHeaderName, createAgentUIMessageStreamResponse, readAgentToolApprovalResponses, resolveAgentToolApproval, resolveAgentToolApprovalsWithUIMessageStream, sendAgentUserMessageWithUIMessageStream, type AgentToolApprovalOptions, type AgentToolApprovalResponse, type AgentToolApprovalsUIStreamOptions, type AgentUIMessageStreamResponseOptions, type AgentUserMessageUIStreamOptions, } from "./agent-ui-message-stream-responses.js";
+export { agentAssistantUIMessageId, agentEventDataPartType, agentResumeTokenDataPartType, agentUIMessageStreamHeaders, agentUserUIMessageId, type AgentDynamicToolUIPart, type AgentEventJson, type AgentUIMessage, type AgentUIMessageChunk, type AgentUIMessageFinishReason, type AgentUIMessagePart, } from "./agent-ui-message-types.js";
+export { convertAgentSnapshotToUIMessages, readAgentSessionUIMessages, type AgentSessionUIMessages, } from "./agent-ui-messages.js";
+export { maximumAgentUIStreamResumeTokenLength } from "./agent-ui-stream-cursor.js";

package/dist/src/ui-stream/index.js

@@ -0,0 +1,22 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+/**
+ * UI stream adapters for agent sessions: an AI SDK UI message stream, a plain Server-Sent Events stream,
+ * and session snapshots, all read from the session's `AgentEvents` Stream and resumable after a reconnect.
+ *
+ * @packageDocumentation
+ */
+export { convertAgentEventToJson, convertAgentSnapshotToJson } from "./agent-event-json.js";
+export { agentEventStreamHeaders, convertAgentEventStreamSnapshotToJson, createAgentEventSseResponse, formatAgentEventSseFrame, readAgentEventStreamSnapshot, streamAgentEventSseFrames, } from "./agent-event-sse.js";
+export { defaultAgentEventPollTimeoutMs } from "./agent-event-stream-positions.js";
+export { streamAgentUIMessageChunks, } from "./agent-ui-message-stream.js";
+export { agentResumeTokenHeaderName, createAgentUIMessageStreamResponse, readAgentToolApprovalResponses, resolveAgentToolApproval, resolveAgentToolApprovalsWithUIMessageStream, sendAgentUserMessageWithUIMessageStream, } from "./agent-ui-message-stream-responses.js";
+export { agentAssistantUIMessageId, agentEventDataPartType, agentResumeTokenDataPartType, agentUIMessageStreamHeaders, agentUserUIMessageId, } from "./agent-ui-message-types.js";
+export { convertAgentSnapshotToUIMessages, readAgentSessionUIMessages, } from "./agent-ui-messages.js";
+export { maximumAgentUIStreamResumeTokenLength } from "./agent-ui-stream-cursor.js";
+//# sourceMappingURL=index.js.map

package/dist/src/ui-stream/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui-stream/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EACL,uBAAuB,EACvB,qCAAqC,EACrC,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,GAI1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EACL,0BAA0B,GAE3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,0BAA0B,EAC1B,kCAAkC,EAClC,8BAA8B,EAC9B,wBAAwB,EACxB,4CAA4C,EAC5C,uCAAuC,GAMxC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,GAOrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAE3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qCAAqC,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/src/ui-stream/server-sent-event-responses.d.ts

@@ -0,0 +1,6 @@
+/** SSE comment sent after an empty long poll; it keeps proxies from closing an idle response. */
+export declare const serverSentEventKeepAliveFrame = ": keep-alive\n\n";
+/** Returns a streaming Response that writes each frame as it is produced and stops the frames on cancel. */
+export declare function createServerSentEventResponse(frames: AsyncGenerator<string, void, undefined>, baseHeaders: Readonly<Record<string, string>>, extraHeaders: Readonly<Record<string, string>> | undefined): Response;
+/** Returns the base headers overridden by the application's headers. */
+export declare function mergeHeaders(baseHeaders: Readonly<Record<string, string>>, extraHeaders: Readonly<Record<string, string>> | undefined): Headers;

package/dist/src/ui-stream/server-sent-event-responses.js

@@ -0,0 +1,34 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+/** SSE comment sent after an empty long poll; it keeps proxies from closing an idle response. */
+export const serverSentEventKeepAliveFrame = ": keep-alive\n\n";
+/** Returns a streaming Response that writes each frame as it is produced and stops the frames on cancel. */
+export function createServerSentEventResponse(frames, baseHeaders, extraHeaders) {
+    const encoder = new TextEncoder();
+    const body = new ReadableStream({
+        async pull(controller) {
+            const frame = await frames.next();
+            if (frame.done === true) {
+                controller.close();
+                return;
+            }
+            controller.enqueue(encoder.encode(frame.value));
+        },
+        async cancel() {
+            await frames.return(undefined);
+        },
+    });
+    return new Response(body, { status: 200, headers: mergeHeaders(baseHeaders, extraHeaders) });
+}
+/** Returns the base headers overridden by the application's headers. */
+export function mergeHeaders(baseHeaders, extraHeaders) {
+    const headers = new Headers(baseHeaders);
+    new Headers(extraHeaders).forEach((value, name) => headers.set(name, value));
+    return headers;
+}
+//# sourceMappingURL=server-sent-event-responses.js.map

package/dist/src/ui-stream/server-sent-event-responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-sent-event-responses.js","sourceRoot":"","sources":["../../../src/ui-stream/server-sent-event-responses.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,iGAAiG;AACjG,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC;AAEhE,4GAA4G;AAC5G,MAAM,UAAU,6BAA6B,CAC3C,MAA+C,EAC/C,WAA6C,EAC7C,YAA0D;IAE1D,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,cAAc,CAAa;QAC1C,KAAK,CAAC,IAAI,CAAC,UAAU;YACnB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACxB,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,MAAM;YACV,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;KACF,CAAC,CAAC;IACH,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAC1B,WAA6C,EAC7C,YAA0D;IAE1D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,88 @@
 {
   "name": "@superdurable/dex-agents",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Durable agent sessions for Dex, shared by the Dex TypeScript agent framework adapters",
+  "license": "LicenseRef-Sustainable-Use-1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/superdurable/dex.git",
+    "directory": "agents/typescript/core"
+  },
+  "homepage": "https://github.com/superdurable/dex/tree/main/agents/typescript/core#readme",
+  "bugs": {
+    "url": "https://github.com/superdurable/dex/issues"
+  },
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "engines": {
+    "node": "^22.0.0 || ^24.0.0"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./testing": {
+      "types": "./dist/src/testing/index.d.ts",
+      "import": "./dist/src/testing/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/src/mcp/index.d.ts",
+      "import": "./dist/src/mcp/index.js"
+    },
+    "./ui-stream": {
+      "types": "./dist/src/ui-stream/index.d.ts",
+      "import": "./dist/src/ui-stream/index.js"
+    },
+    "./stepwise": {
+      "types": "./dist/src/stepwise/index.d.ts",
+      "import": "./dist/src/stepwise/index.js"
+    },
+    "./ai-sdk": {
+      "types": "./dist/src/ai-sdk/index.d.ts",
+      "import": "./dist/src/ai-sdk/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test:integration": "npm run build && node --test --test-concurrency=1 --test-timeout=240000 'dist/test/integ/*.integration.test.js'",
+    "test:long": "npm run build && node --test --test-concurrency=1 --test-timeout=1800000 'dist/test/long/*.integration.test.js'"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "@opentelemetry/api": "^1.3.0",
+    "@superdurable/dex": "1.35.0",
+    "ai": "^7.0.159"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "1.32.2",
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/sdk-trace-base": "2.12.0",
+    "@superdurable/dex": "1.35.0",
+    "@types/node": "22.20.5",
+    "ai": "7.0.159",
+    "typescript": "5.9.3",
+    "zod": "4.6.7"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}