@mongodb-js/agent-engine-sdk-langgraph 0.11.3

package/dist/llm_adapter.js.map

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

package/dist/messages.d.ts

@@ -0,0 +1,56 @@
+/**
+ * LangChain message conversion layer.
+ *
+ * Converts between LangChain message types (AIMessage, HumanMessage, etc.)
+ * and the framework-neutral Message model from agent-engine-sdk.
+ *
+ * Port of `agent_engine_sdk_langgraph/messages.py`.
+ */
+import { AIMessage, AIMessageChunk, type BaseMessage, type MessageContent } from "@langchain/core/messages";
+import { ChatGenerationChunk, type ChatResult } from "@langchain/core/outputs";
+import { type LLMResponse, type LLMStreamChunk, type Message } from "@mongodb-js/agent-engine-sdk";
+export declare const FRAMEWORK_LANGCHAIN: "langchain";
+/** Return the messages inside a LangGraph Overwrite or ordinary message value. */
+export declare function unwrapMessageValues(value: unknown): unknown[];
+/** Normalize graph-input messages and assign IDs where the caller requires them. */
+export declare function assignMissingGraphInputMessageIds(graphInput: unknown, missingId: (index: number) => string): unknown;
+/** Normalize a platform tool result for LangChain's ToolMessage content field. */
+export declare function toToolMessageContent(content: unknown): MessageContent;
+/** Convert a LangChain message to a platform Message. */
+export declare function lcToPlatformMessage(lcMessage: BaseMessage): Message;
+/**
+ * Convert a platform Message to a LangChain message.
+ *
+ * Returns `null` if the message cannot be converted (e.g. a tool message with
+ * missing tool_call_id).
+ */
+export declare function platformToLcMessage(message: Message): BaseMessage | null;
+/** Convert a list of LangChain messages to platform Messages. */
+export declare function lcMessagesToPlatform(messages: readonly BaseMessage[]): Message[];
+/**
+ * Convert a list of platform Messages to LangChain messages.
+ *
+ * Invalid messages (e.g. tool messages with missing tool_call_id) are
+ * skipped with a warning logged.
+ */
+export declare function platformMessagesToLc(messages: readonly Message[]): BaseMessage[];
+/**
+ * Serialize a LangChain message to the platform wire format.
+ *
+ * Stamps every dict with `framework: "langchain"` so downstream consumers can
+ * identify which framework produced the message.
+ */
+export declare function messageToDict(message: BaseMessage): Record<string, unknown>;
+/** Deserialize a platform wire-format dict to a LangChain AIMessage. */
+export declare function dictToAiMessage(data: unknown): AIMessage;
+/**
+ * Deserialize a platform wire-format dict to a LangChain AIMessageChunk.
+ *
+ * Used for streaming replay where ChatGenerationChunk expects a chunk type.
+ */
+export declare function dictToAiMessageChunk(data: unknown): AIMessageChunk;
+/** Convert sdk-core LLMResponse to LangChain ChatResult. */
+export declare function llmResponseToChatResult(response: LLMResponse): ChatResult;
+/** Convert sdk-core LLMStreamChunk to LangChain ChatGenerationChunk. */
+export declare function llmStreamChunkToGenerationChunk(chunk: LLMStreamChunk): ChatGenerationChunk;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,cAAc,EACd,KAAK,WAAW,EAGhB,KAAK,cAAc,EAGpB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EACL,mBAAmB,EAEnB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,cAAc,EAGnB,KAAK,OAAO,EAGb,MAAM,8BAA8B,CAAC;AA4CtC,eAAO,MAAM,mBAAmB,EAAG,WAAoB,CAAC;AAgBxD,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAM7D;AASD,oFAAoF;AACpF,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACnC,OAAO,CAiCT;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAmBrE;AAgID,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAgEnE;AAgDD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CA0FxE;AAMD,iEAAiE;AACjE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,OAAO,EAAE,CAEX;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,WAAW,EAAE,CAOf;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuB3E;AAaD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAWlE;AAiCD,4DAA4D;AAC5D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,GAAG,UAAU,CA2CzE;AAED,wEAAwE;AACxE,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAoCrB"}

package/dist/messages.js

@@ -0,0 +1,592 @@
+/**
+ * LangChain message conversion layer.
+ *
+ * Converts between LangChain message types (AIMessage, HumanMessage, etc.)
+ * and the framework-neutral Message model from agent-engine-sdk.
+ *
+ * Port of `agent_engine_sdk_langgraph/messages.py`.
+ */
+import { AIMessage, AIMessageChunk, coerceMessageLikeToMessage, HumanMessage, SystemMessage, ToolMessage, } from "@langchain/core/messages";
+import { Overwrite } from "@langchain/langgraph";
+import { ChatGenerationChunk, } from "@langchain/core/outputs";
+import { LLMTokenUsage, LLMToolCall, } from "@mongodb-js/agent-engine-sdk";
+import { getLogger } from "@mongodb-js/agent-engine-runner-shared";
+/** Drop keys whose value is `undefined` — local helper (not in agent-engine-sdk). */
+function stripUndefined(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined)
+            result[key] = value;
+    }
+    return result;
+}
+/**
+ * Build an `LLMTokenUsage` from a raw dict. His agent-engine-sdk class has only a
+ * data-constructor (no static `fromDict`); this helper centralises the cast.
+ */
+function newLLMTokenUsageFromDict(data) {
+    return new LLMTokenUsage(data);
+}
+/** `LLMTokenUsage` no longer exposes `.toDict()`; round-trip via JSON-stripping. */
+function llmTokenUsageToDict(usage) {
+    return stripUndefined({
+        input_tokens: usage.inputTokens,
+        output_tokens: usage.outputTokens,
+        prompt_tokens: usage.promptTokens,
+        completion_tokens: usage.completionTokens,
+        total_tokens: usage.totalTokens,
+        model: usage.model,
+    });
+}
+const logger = getLogger("agent_engine_sdk_langgraph.messages");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const FRAMEWORK_LANGCHAIN = "langchain";
+// Keep in sync with Python's langchain_core.tools.base.TOOL_MESSAGE_BLOCK_TYPES,
+// consumed by langgraph.prebuilt.tool_node.msg_content_output. Unsupported
+// block lists are intentionally JSON-stringified on the durable path.
+const TOOL_MESSAGE_BLOCK_TYPES = new Set([
+    "text",
+    "image_url",
+    "image",
+    "json",
+    "search_result",
+    "custom_tool_call_output",
+    "document",
+    "file",
+]);
+/** Return the messages inside a LangGraph Overwrite or ordinary message value. */
+export function unwrapMessageValues(value) {
+    if (Overwrite.isInstance(value) && "__overwrite__" in value) {
+        const overwritten = value.__overwrite__;
+        return Array.isArray(overwritten) ? [...overwritten] : [overwritten];
+    }
+    return Array.isArray(value) ? [...value] : [value];
+}
+function copyMessageWithId(message, id) {
+    const MessageType = message.constructor;
+    return new MessageType({ ...message, id });
+}
+/** Normalize graph-input messages and assign IDs where the caller requires them. */
+export function assignMissingGraphInputMessageIds(graphInput, missingId) {
+    if (graphInput === null ||
+        typeof graphInput !== "object" ||
+        Array.isArray(graphInput)) {
+        return graphInput;
+    }
+    const input = graphInput;
+    const rawMessages = input["messages"];
+    if (rawMessages === undefined || rawMessages === null)
+        return graphInput;
+    const overwritten = Overwrite.isInstance(rawMessages) && "__overwrite__" in rawMessages;
+    const messages = unwrapMessageValues(rawMessages).map((value, index) => {
+        const message = coerceMessageLikeToMessage(value);
+        return message.id !== undefined && message.id !== null
+            ? message
+            : copyMessageWithId(message, missingId(index));
+    });
+    return {
+        ...input,
+        messages: overwritten
+            ? rawMessages instanceof Overwrite
+                ? new Overwrite(messages)
+                : {
+                    ...rawMessages,
+                    __overwrite__: messages,
+                }
+            : messages,
+    };
+}
+/** Normalize a platform tool result for LangChain's ToolMessage content field. */
+export function toToolMessageContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content) &&
+        content.every((item) => {
+            if (typeof item !== "object" || item === null)
+                return false;
+            const blockType = item["type"];
+            return (typeof blockType === "string" && TOOL_MESSAGE_BLOCK_TYPES.has(blockType));
+        })) {
+        return content;
+    }
+    try {
+        return JSON.stringify(content) ?? String(content);
+    }
+    catch {
+        return String(content);
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers — content conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert LangChain message content to platform format.
+ *
+ * LangChain messages can have multimodal content as a list of content blocks.
+ * This function preserves the structure for multimodal content while keeping
+ * simple string content as-is.
+ */
+function convertLcContentToPlatform(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return String(content);
+    const blocks = [];
+    for (const block of content) {
+        if (block !== null && typeof block === "object") {
+            const b = block;
+            const blockType = typeof b["type"] === "string" ? b["type"] : "text";
+            if (blockType === "text") {
+                const text = typeof b["text"] === "string" ? b["text"] : "";
+                blocks.push({ type: "text", text });
+            }
+            else if (blockType === "image" || blockType === "image_url") {
+                const url = extractImageUrl(b);
+                if (url) {
+                    const imageBlock = typeof b["mime_type"] === "string"
+                        ? { type: "image", url, mime_type: b["mime_type"] }
+                        : { type: "image", url };
+                    blocks.push(imageBlock);
+                }
+                else {
+                    logger.warn("Image block missing url; skipping");
+                }
+            }
+            else if (blockType === "file" || blockType === "document") {
+                const url = typeof b["url"] === "string" ? b["url"] : undefined;
+                if (url) {
+                    const mimeType = typeof b["mime_type"] === "string" ? b["mime_type"] : undefined;
+                    const filename = typeof b["filename"] === "string" ? b["filename"] : undefined;
+                    const doc = {
+                        type: "document",
+                        url,
+                        ...(mimeType !== undefined && { mime_type: mimeType }),
+                        ...(filename !== undefined && { filename }),
+                    };
+                    blocks.push(doc);
+                }
+                else {
+                    logger.warn("Document block missing url; skipping");
+                }
+            }
+            else {
+                logger.warn(`Unknown content block type=${blockType}; serializing to TextBlock`);
+                blocks.push({
+                    type: "text",
+                    text: JSON.stringify(b),
+                });
+            }
+        }
+        else {
+            blocks.push({ type: "text", text: String(block) });
+        }
+    }
+    if (blocks.length === 1 && blocks[0]?.type === "text")
+        return blocks[0].text;
+    return blocks.length > 0 ? blocks : "";
+}
+/** Extract the URL from LangChain's image_url shape (either string or `{url, ...}`). */
+function extractImageUrl(block) {
+    const imageData = block["image_url"];
+    if (imageData !== undefined) {
+        if (typeof imageData === "string")
+            return imageData;
+        if (imageData !== null && typeof imageData === "object") {
+            const url = imageData["url"];
+            return typeof url === "string" ? url : undefined;
+        }
+        return undefined;
+    }
+    const url = block["url"];
+    return typeof url === "string" ? url : undefined;
+}
+/**
+ * Serialize LangChain tool calls.
+ *
+ * LangChain's ToolCall is a TypedDict — at runtime, tool_calls on an
+ * AIMessage are always plain objects with `name`, `args`, `id`, and
+ * `type` keys (enforced by LangChain's model validator).
+ */
+function serializeToolCalls(toolCalls) {
+    const requiredKeys = ["name", "args", "id"];
+    const result = [];
+    for (const tc of toolCalls) {
+        if (tc === null || typeof tc !== "object") {
+            throw new TypeError(`Expected object tool call, got ${typeof tc}`);
+        }
+        const tcObj = tc;
+        const missing = requiredKeys.filter((k) => !(k in tcObj));
+        if (missing.length > 0) {
+            logger.warn(`Tool call missing keys ${missing.join(", ")}: ${JSON.stringify(tc)}`);
+        }
+        result.push(new LLMToolCall(tcObj));
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Public API — single message conversion
+// ---------------------------------------------------------------------------
+const ROLE_MAP = {
+    human: "user",
+    ai: "assistant",
+    system: "system",
+    tool: "tool",
+};
+/** Convert a LangChain message to a platform Message. */
+export function lcToPlatformMessage(lcMessage) {
+    const role = ROLE_MAP[lcMessage.type] ?? "user";
+    const content = convertLcContentToPlatform(lcMessage.content);
+    let toolCalls;
+    // LangChain JS's `AIMessageChunk` is NOT a subclass of `AIMessage` (unlike
+    // Python), so `instanceof AIMessage` misses chunks aggregated by
+    // `BaseChatModel.invoke` from `_streamResponseChunks`. Accept both, and also
+    // fall through on `type === "ai"` for already-deserialized messages from
+    // the LangGraph checkpointer.
+    if ((lcMessage instanceof AIMessage ||
+        lcMessage instanceof AIMessageChunk ||
+        lcMessage.type === "ai") &&
+        Array.isArray(lcMessage.tool_calls) &&
+        lcMessage.tool_calls.length > 0) {
+        const rawCalls = lcMessage
+            .tool_calls;
+        toolCalls = serializeToolCalls(rawCalls);
+    }
+    let toolCallId;
+    let isError;
+    if (lcMessage instanceof ToolMessage) {
+        toolCallId = lcMessage.tool_call_id;
+        isError = lcMessage.status === "error";
+    }
+    const rawAdditionalKwargs = nonEmptyDict(lcMessage.additional_kwargs);
+    let additionalKwargs = rawAdditionalKwargs;
+    if (toolCalls !== undefined &&
+        rawAdditionalKwargs?.["tool_calls"] !== undefined) {
+        // LangChain JS assembles provider stream fragments under
+        // additional_kwargs.tool_calls. The completed semantic tool_calls above
+        // are the portable source of truth and are what durable replay rebuilds.
+        const { tool_calls: _providerFragments, ...portableAdditionalKwargs } = rawAdditionalKwargs;
+        additionalKwargs = nonEmptyDict(portableAdditionalKwargs);
+    }
+    const responseMetadata = nonEmptyDict(lcMessage.response_metadata);
+    return {
+        role,
+        content,
+        ...(toolCalls !== undefined && { toolCalls }),
+        ...(toolCallId !== undefined && { toolCallId }),
+        ...(isError !== undefined && { isError }),
+        ...(lcMessage.name !== undefined &&
+            lcMessage.name !== null && { name: lcMessage.name }),
+        ...(lcMessage.id !== undefined &&
+            lcMessage.id !== null && { id: lcMessage.id }),
+        ...(additionalKwargs !== undefined && {
+            additionalKwargs,
+        }),
+        ...(responseMetadata !== undefined && {
+            responseMetadata,
+        }),
+    };
+}
+function nonEmptyDict(data) {
+    if (data === undefined || Object.keys(data).length === 0)
+        return undefined;
+    // LangChain typings allow `unknown` values but in practice they are JsonValue-compatible.
+    // The cast is documented here rather than narrowing every field at every call site.
+    return data;
+}
+/**
+ * Convert platform content to LangChain's `MessageContent` type.
+ *
+ * LangChain 1.x's `ContentBlock` interface is more strict than our internal
+ * shape (it expects provider-specific image/document variants). We emit the
+ * historical LangChain dict form (`{type, url, mime_type, ...}`) that all
+ * upstream chat models still accept at runtime, and cast to `MessageContent`
+ * at this single boundary.
+ */
+function convertPlatformContentToLc(content) {
+    if (typeof content === "string")
+        return content;
+    const lcBlocks = [];
+    for (const block of content) {
+        if (block.type === "text") {
+            lcBlocks.push({ type: "text", text: block.text });
+        }
+        else if (block.type === "image") {
+            lcBlocks.push({
+                type: "image",
+                url: block.url,
+                ...(block.mime_type !== undefined && { mime_type: block.mime_type }),
+            });
+        }
+        else if (block.type === "document") {
+            lcBlocks.push({
+                type: "document",
+                url: block.url,
+                ...(block.mime_type !== undefined && { mime_type: block.mime_type }),
+                ...(block.filename !== undefined && { filename: block.filename }),
+            });
+        }
+    }
+    if (lcBlocks.length === 0)
+        return "";
+    return lcBlocks;
+}
+/**
+ * Convert a platform Message to a LangChain message.
+ *
+ * Returns `null` if the message cannot be converted (e.g. a tool message with
+ * missing tool_call_id).
+ */
+export function platformToLcMessage(message) {
+    const role = message.role;
+    const lcContent = convertPlatformContentToLc(message.content);
+    // Messages may arrive as camelCase (Message interface) or snake_case (MessageSchema
+    // wire output from Zod). Check both so the Tool Pod /invoke_llm path works correctly.
+    const msgAny = message;
+    const resolvedToolCallId = message.toolCallId ?? msgAny["tool_call_id"];
+    const resolvedToolCalls = message.toolCalls ?? msgAny["tool_calls"];
+    const resolvedIsError = message.isError ?? msgAny["is_error"] ?? false;
+    const resolvedAdditionalKwargs = message.additionalKwargs ??
+        msgAny["additional_kwargs"];
+    const resolvedResponseMetadata = message.responseMetadata ??
+        msgAny["response_metadata"];
+    // LangChain's `additional_kwargs` / `response_metadata` are typed `Record<string, unknown>`;
+    // ours are `Record<string, JsonValue>`. `JsonValue` is a strict subset of `unknown`, so the
+    // bridge is safe and documented once via this helper rather than every call site.
+    const additionalKwargs = {
+        ...resolvedAdditionalKwargs,
+    };
+    const responseMetadata = {
+        ...resolvedResponseMetadata,
+    };
+    const baseFields = {
+        additional_kwargs: additionalKwargs,
+        response_metadata: responseMetadata,
+        ...(message.name !== undefined && { name: message.name }),
+        ...(message.id !== undefined && { id: message.id }),
+    };
+    if (role === "tool") {
+        if (resolvedToolCallId === undefined || resolvedToolCallId === "") {
+            const preview = typeof message.content === "string"
+                ? message.content.slice(0, 50)
+                : "...";
+            logger.warn(`Skipping tool message: missing tool_call_id (content=${JSON.stringify(preview)})`);
+            return null;
+        }
+        const strContent = typeof lcContent === "string" ? lcContent : JSON.stringify(lcContent);
+        return new ToolMessage({
+            ...baseFields,
+            content: strContent,
+            tool_call_id: resolvedToolCallId,
+            status: resolvedIsError ? "error" : "success",
+        });
+    }
+    if (role === "assistant") {
+        // The wire JSON roundtrip strips `LLMToolCall` class identity, so tool
+        // calls arrive here as plain objects after Zod parse. Handle both shapes.
+        const mappedToolCalls = (resolvedToolCalls ?? []).map((tc) => {
+            if (typeof tc
+                .toLangchainDict === "function") {
+                return tc.toLangchainDict();
+            }
+            const obj = tc;
+            return {
+                id: obj["id"],
+                name: obj["name"],
+                args: (obj["args"] ?? obj["arguments"] ?? {}),
+                type: obj["type"] ?? "tool_call",
+            };
+        });
+        return new AIMessage({
+            ...baseFields,
+            content: lcContent,
+            tool_calls: mappedToolCalls,
+        });
+    }
+    if (role === "system") {
+        return new SystemMessage({ ...baseFields, content: lcContent });
+    }
+    return new HumanMessage({ ...baseFields, content: lcContent });
+}
+// ---------------------------------------------------------------------------
+// Public API — bulk conversion
+// ---------------------------------------------------------------------------
+/** Convert a list of LangChain messages to platform Messages. */
+export function lcMessagesToPlatform(messages) {
+    return messages.map(lcToPlatformMessage);
+}
+/**
+ * Convert a list of platform Messages to LangChain messages.
+ *
+ * Invalid messages (e.g. tool messages with missing tool_call_id) are
+ * skipped with a warning logged.
+ */
+export function platformMessagesToLc(messages) {
+    const result = [];
+    for (const msg of messages) {
+        const lc = platformToLcMessage(msg);
+        if (lc !== null)
+            result.push(lc);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// OE message serialization (LangChain ↔ dict)
+// ---------------------------------------------------------------------------
+/**
+ * Serialize a LangChain message to the platform wire format.
+ *
+ * Stamps every dict with `framework: "langchain"` so downstream consumers can
+ * identify which framework produced the message.
+ */
+export function messageToDict(message) {
+    // Emit a FLAT dict matching Python's `message_to_dict`
+    // (`model_dump(exclude_none=True)`) — NOT LangChain JS's nested `toDict()`
+    // envelope (`{type, data:{…}}`), which is also lossy (drops id /
+    // response_metadata / usage_metadata). Building the flat shape explicitly
+    // keeps this the exact inverse of `dictToAiMessage` (`new AIMessage(flat)`)
+    // so the pair round-trips, mirroring Python's model_dump/model_validate.
+    const m = message;
+    const flat = stripUndefined({
+        type: message.type,
+        content: message.content,
+        additional_kwargs: m["additional_kwargs"],
+        response_metadata: m["response_metadata"],
+        name: m["name"],
+        id: m["id"],
+        tool_calls: m["tool_calls"],
+        invalid_tool_calls: m["invalid_tool_calls"],
+        usage_metadata: m["usage_metadata"],
+        tool_call_id: m["tool_call_id"],
+        artifact: m["artifact"],
+        status: m["status"],
+    });
+    return { ...flat, framework: FRAMEWORK_LANGCHAIN };
+}
+/** Throw if the wire-format dict came from an unsupported framework. */
+function checkFramework(data) {
+    const fw = data["framework"];
+    // Match Python's `fw is not None` — skip the check if framework is missing or null.
+    if (fw != null && fw !== FRAMEWORK_LANGCHAIN) {
+        throw new Error(`Cannot deserialize message from framework ${JSON.stringify(fw)} with the LangChain deserializer`);
+    }
+}
+/** Deserialize a platform wire-format dict to a LangChain AIMessage. */
+export function dictToAiMessage(data) {
+    if (data instanceof AIMessage)
+        return data;
+    if (data !== null && typeof data === "object") {
+        const obj = data;
+        checkFramework(obj);
+        return new AIMessage(obj);
+    }
+    return new AIMessage({ content: String(data) });
+}
+/**
+ * Deserialize a platform wire-format dict to a LangChain AIMessageChunk.
+ *
+ * Used for streaming replay where ChatGenerationChunk expects a chunk type.
+ */
+export function dictToAiMessageChunk(data) {
+    if (data instanceof AIMessageChunk)
+        return data;
+    if (data !== null && typeof data === "object") {
+        const obj = data;
+        checkFramework(obj);
+        return new AIMessageChunk({
+            ...obj,
+            type: "AIMessageChunk",
+        });
+    }
+    return new AIMessageChunk({ content: String(data) });
+}
+// ---------------------------------------------------------------------------
+// LLM Response conversion (sdk-core ↔ LangChain)
+// ---------------------------------------------------------------------------
+const TOKEN_KEYS = new Set([
+    "input_tokens",
+    "output_tokens",
+    "prompt_tokens",
+    "completion_tokens",
+    "total_tokens",
+    "model",
+]);
+function usageFromResponse(response) {
+    if (response.usage !== undefined)
+        return response.usage;
+    const metadata = { ...response.metadata };
+    const nestedUsage = metadata["usage"];
+    if (nestedUsage !== null &&
+        typeof nestedUsage === "object" &&
+        !Array.isArray(nestedUsage)) {
+        return newLLMTokenUsageFromDict(nestedUsage);
+    }
+    const hasTokenKey = Object.keys(metadata).some((k) => TOKEN_KEYS.has(k));
+    if (hasTokenKey)
+        return newLLMTokenUsageFromDict(metadata);
+    return undefined;
+}
+/** Convert sdk-core LLMResponse to LangChain ChatResult. */
+export function llmResponseToChatResult(response) {
+    const responseMetadata = { ...response.metadata };
+    const rawMetadata = responseMetadata["_raw_response_metadata"];
+    delete responseMetadata["_raw_response_metadata"];
+    const rawResponseMetadata = rawMetadata !== null &&
+        typeof rawMetadata === "object" &&
+        !Array.isArray(rawMetadata)
+        ? rawMetadata
+        : {};
+    delete responseMetadata["usage"];
+    const explicitResponseMetadata = response.responseMetadata ?? {};
+    const usage = usageFromResponse(response);
+    const usageMetadata = usage !== undefined ? llmTokenUsageToDict(usage) : {};
+    const mergedMetadata = {
+        ...responseMetadata,
+        ...usageMetadata,
+        ...rawResponseMetadata,
+        ...explicitResponseMetadata,
+    };
+    const aiMessage = new AIMessage({
+        content: response.content,
+        tool_calls: (response.toolCalls ?? []).map((tc) => tc.toLangchainDict()),
+        ...(response.id !== undefined ? { id: response.id } : {}),
+        ...(response.name !== undefined ? { name: response.name } : {}),
+        additional_kwargs: (response.additionalKwargs ?? {}),
+        response_metadata: mergedMetadata,
+    });
+    // ChatGeneration is an interface in LangChain 1.x — construct via object literal.
+    const generation = {
+        message: aiMessage,
+        text: response.content,
+    };
+    return { generations: [generation] };
+}
+/** Convert sdk-core LLMStreamChunk to LangChain ChatGenerationChunk. */
+export function llmStreamChunkToGenerationChunk(chunk) {
+    const toolCallChunks = (chunk.toolCalls ?? []).map((tc) => ({
+        type: "tool_call_chunk",
+        ...(tc.id !== undefined ? { id: tc.id } : {}),
+        ...(tc.name !== undefined ? { name: tc.name } : {}),
+        ...(tc.args !== undefined ? { args: tc.args } : {}),
+        ...(tc.index !== undefined ? { index: tc.index } : {}),
+    }));
+    const usageMetadata = chunk.usage?.toLangchainUsageMetadata();
+    // LangChain 1.x's AIMessageChunkFields generic uses inferred response_metadata /
+    // usage_metadata shapes that don't unify with our plain Record types. The cast
+    // is the single bridging point — runtime shape matches AIMessageChunkFields.
+    const aiChunk = new AIMessageChunk({
+        content: chunk.content ?? "",
+        tool_call_chunks: toolCallChunks,
+        ...(chunk.id !== undefined ? { id: chunk.id } : {}),
+        ...(chunk.name !== undefined ? { name: chunk.name } : {}),
+        additional_kwargs: (chunk.additionalKwargs ?? {}),
+        response_metadata: (chunk.responseMetadata ?? {}),
+        ...(usageMetadata !== undefined ? { usage_metadata: usageMetadata } : {}),
+    });
+    return new ChatGenerationChunk({
+        message: aiChunk,
+        text: chunk.content ?? "",
+    });
+}
+//# sourceMappingURL=messages.js.map