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

package/dist/checkpoint_branch.js

@@ -0,0 +1,239 @@
+/** Copy a LangGraph checkpoint branch point into a new thread. */
+import { BaseMessage } from "@langchain/core/messages";
+import { isDeepStrictEqual } from "node:util";
+export function branchPointFromMetadata(metadata) {
+    const value = metadata?.["langgraph_branch_point"];
+    if (value === undefined)
+        return undefined;
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("LangGraph branch point must be an object");
+    }
+    const threadId = value["thread_id"];
+    const checkpointId = value["checkpoint_id"];
+    if (typeof threadId !== "string" ||
+        threadId.length === 0 ||
+        typeof checkpointId !== "string" ||
+        checkpointId.length === 0) {
+        throw new Error("LangGraph branch point is incomplete");
+    }
+    return { threadId, checkpointId };
+}
+export function checkpointMetadata(checkpoint) {
+    if (checkpoint === undefined)
+        return undefined;
+    return {
+        langgraph_checkpoint: {
+            thread_id: checkpoint.threadId,
+            checkpoint_id: checkpoint.checkpointId,
+        },
+    };
+}
+/** Root-graph config for one checkpoint coordinate. */
+function checkpointConfig(source) {
+    return {
+        configurable: {
+            thread_id: source.threadId,
+            checkpoint_ns: "",
+            checkpoint_id: source.checkpointId,
+        },
+    };
+}
+/** Root-graph coordinate, or fail closed on a subgraph namespace. */
+function rootGraphCheckpoint(config) {
+    const configurable = config.configurable ?? {};
+    if ((configurable["checkpoint_ns"] ?? "") !== "") {
+        throw new Error("LangGraph checkpoint branching supports root graphs only");
+    }
+    const threadId = configurable["thread_id"];
+    const checkpointId = configurable["checkpoint_id"];
+    if (typeof threadId !== "string" || typeof checkpointId !== "string") {
+        throw new Error("LangGraph checkpoint coordinate is incomplete");
+    }
+    return {
+        threadId,
+        checkpointId,
+    };
+}
+function stateUpdates(snapshot, pendingWrites) {
+    return snapshot.tasks.flatMap((task) => {
+        if (task.error !== undefined && task.error !== null) {
+            throw new Error("LangGraph checkpoint branching does not support failed history");
+        }
+        if (task.state !== undefined && task.state !== null) {
+            throw new Error("LangGraph checkpoint branching does not support persistent subgraph history");
+        }
+        if (task.interrupts.length > 0 &&
+            (task.result === undefined || task.result === null)) {
+            const values = {};
+            for (const [taskId, channel, value] of pendingWrites) {
+                if (taskId !== task.id ||
+                    channel.startsWith("__") ||
+                    channel.startsWith("branch:")) {
+                    continue;
+                }
+                if (channel in values) {
+                    throw new Error(`Interrupted LangGraph checkpoint task wrote channel ${channel} more than once`);
+                }
+                values[channel] = value;
+            }
+            return Object.keys(values).length === 0
+                ? []
+                : [{ values, asNode: task.name }];
+        }
+        return [{ values: task.result, asNode: task.name }];
+    });
+}
+/**
+ * Graph values comparable after a branch copy. `bulkUpdateState` rebuilds
+ * messages with new LangChain ids; those must not fail a content match.
+ */
+function stateWithoutMessageIds(value) {
+    if (value instanceof BaseMessage) {
+        const serialized = value.toDict();
+        const data = { ...serialized.data };
+        delete data.id;
+        return stateWithoutMessageIds({ ...serialized, data });
+    }
+    if (Array.isArray(value))
+        return value.map(stateWithoutMessageIds);
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, nested]) => [
+            key,
+            stateWithoutMessageIds(nested),
+        ]));
+    }
+    return value;
+}
+/**
+ * Load a completed root checkpoint, or fail closed.
+ *
+ * Fork validates this before CreateBranch so a missing or incomplete history
+ * point does not create a branch session (Python
+ * `completed_root_checkpoint` parity).
+ */
+export async function completedRootCheckpoint(graph, args) {
+    const configurable = {
+        thread_id: args.threadId,
+        checkpoint_ns: "",
+    };
+    if (args.historyId)
+        configurable["checkpoint_id"] = args.historyId;
+    const snapshot = await graph.getState({ configurable });
+    const found = snapshot.config.configurable ?? {};
+    const checkpointId = found["checkpoint_id"];
+    if (typeof checkpointId !== "string" || checkpointId === "") {
+        throw new Error("session has no completed history to fork from");
+    }
+    if (found["checkpoint_ns"]) {
+        throw new Error("LangGraph checkpoint branching supports root graphs only");
+    }
+    if (args.historyId && checkpointId !== args.historyId) {
+        throw new Error("LangGraph branch point was not found");
+    }
+    if (snapshot.next.length > 0 || snapshot.tasks.length > 0) {
+        throw new Error("history point is not a completed root checkpoint");
+    }
+    return { threadId: args.threadId, checkpointId };
+}
+/**
+ * Build the copyable superstep plan, or raise before any destination write.
+ *
+ * Port of Python's `checkpoint_replay_plan`; fork builds this before
+ * CreateBranch so the copied snapshot is the one that was validated.
+ */
+export async function checkpointReplayPlan(graph, source) {
+    const checkpointer = graph.checkpointer;
+    if (checkpointer === undefined || typeof checkpointer === "boolean") {
+        throw new Error("LangGraph checkpoint branching requires a checkpointer");
+    }
+    const sourceConfig = checkpointConfig(source);
+    const selected = await graph.getState(sourceConfig);
+    if (!isDeepStrictEqual(rootGraphCheckpoint(selected.config), source)) {
+        throw new Error("LangGraph branch point was not found");
+    }
+    if (selected.next.length > 0 || selected.tasks.length > 0) {
+        throw new Error("LangGraph branch point must be a completed root checkpoint");
+    }
+    const history = [];
+    let historyConfig = sourceConfig;
+    while (historyConfig !== undefined) {
+        const snapshot = await graph.getState(historyConfig);
+        rootGraphCheckpoint(snapshot.config);
+        history.push(snapshot);
+        historyConfig = snapshot.parentConfig;
+    }
+    const supersteps = [];
+    for (const snapshot of history.reverse()) {
+        const tuple = await checkpointer.getTuple(snapshot.config);
+        const updates = stateUpdates(snapshot, tuple?.pendingWrites ?? []);
+        if (updates.length > 0)
+            supersteps.push({ updates });
+    }
+    if (supersteps.length === 0) {
+        throw new Error("LangGraph branch point has no checkpoint history");
+    }
+    return supersteps;
+}
+/**
+ * Rebuild `source` in the empty thread named by `targetConfig`.
+ *
+ * `plan` is the pre-dispatch validated plan from `checkpointReplayPlan`;
+ * callers that validated before a side effect pass it so the copy can only
+ * materialize that snapshot.
+ */
+export async function copyCheckpoint(graph, targetConfig, source, plan) {
+    const checkpointer = graph.checkpointer;
+    if (checkpointer === undefined || typeof checkpointer === "boolean") {
+        throw new Error("LangGraph checkpoint branching requires a checkpointer");
+    }
+    const targetThreadId = targetConfig.configurable?.["thread_id"];
+    if (typeof targetThreadId !== "string") {
+        throw new Error("LangGraph branch destination thread is missing");
+    }
+    for await (const _ of checkpointer.list({ configurable: { thread_id: targetThreadId } }, { limit: 1 })) {
+        throw new Error("LangGraph branch destination thread is not empty");
+    }
+    const supersteps = plan ?? (await checkpointReplayPlan(graph, source));
+    const sourceConfig = checkpointConfig(source);
+    const selected = await graph.getState(sourceConfig);
+    const configurable = {
+        ...targetConfig.configurable,
+        checkpoint_ns: "",
+    };
+    delete configurable["checkpoint_id"];
+    const copiedConfig = await graph.bulkUpdateState({ ...targetConfig, configurable }, supersteps);
+    const copied = await graph.getState(copiedConfig);
+    if (copied.next.length > 0 ||
+        copied.tasks.length > 0 ||
+        !isDeepStrictEqual(stateWithoutMessageIds(copied.values), stateWithoutMessageIds(selected.values))) {
+        throw new Error("Copied LangGraph branch point does not match its source");
+    }
+}
+/** True when `config`'s thread has no checkpoints yet. */
+export async function destinationThreadIsEmpty(graph, config) {
+    const checkpointer = graph.checkpointer;
+    if (checkpointer === undefined || typeof checkpointer === "boolean") {
+        throw new Error("LangGraph checkpoint branching requires a checkpointer");
+    }
+    const targetThreadId = config.configurable?.["thread_id"];
+    if (typeof targetThreadId !== "string") {
+        throw new Error("LangGraph branch destination thread is missing");
+    }
+    for await (const _ of checkpointer.list({ configurable: { thread_id: targetThreadId } }, { limit: 1 })) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Copy `source` onto an empty dest thread.
+ *
+ * In-app fork already materializes dest; OE still dispatches later dest
+ * invokes with the source branch point. If dest already has checkpoints,
+ * leave it alone (Python `initialize_checkpoint_branch` parity).
+ */
+export async function initializeCheckpointBranch(graph, config, source) {
+    if (!(await destinationThreadIsEmpty(graph, config)))
+        return;
+    await copyCheckpoint(graph, config, source);
+}
+//# sourceMappingURL=checkpoint_branch.js.map

package/dist/checkpoint_branch.js.map

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

package/dist/checkpointer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Checkpointer hardening for the MongoDB saver.
+ *
+ * `@langchain/langgraph-checkpoint-mongodb`'s `putWrites` builds a bulk-write
+ * from the pending writes and calls `collection.bulkWrite(operations)`
+ * unconditionally. When a graph step produces no writes — which deep-agent
+ * steps routinely do — `operations` is empty and MongoDB rejects it with
+ * `MongoInvalidArgumentError: Invalid BulkOperation, Batch cannot be empty`,
+ * surfacing as an AER 500. Persisting zero writes is a no-op, so we short-circuit
+ * it. This affects any TypeScript agent using the Mongo checkpointer.
+ */
+import type { BaseCheckpointSaver } from "@langchain/langgraph-checkpoint";
+/**
+ * Wrap a checkpoint saver so `putWrites` skips empty write batches.
+ *
+ * Patches the instance in place and returns it. Idempotent and safe on any
+ * `BaseCheckpointSaver`; only the empty-batch path is altered, every non-empty
+ * call is forwarded unchanged.
+ */
+export declare function withEmptyBatchGuard<S extends BaseCheckpointSaver>(saver: S): S;
+//# sourceMappingURL=checkpointer.d.ts.map

package/dist/checkpointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointer.d.ts","sourceRoot":"","sources":["../src/checkpointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,EAC/D,KAAK,EAAE,CAAC,GACP,CAAC,CAUH"}

package/dist/checkpointer.js

@@ -0,0 +1,31 @@
+/**
+ * Checkpointer hardening for the MongoDB saver.
+ *
+ * `@langchain/langgraph-checkpoint-mongodb`'s `putWrites` builds a bulk-write
+ * from the pending writes and calls `collection.bulkWrite(operations)`
+ * unconditionally. When a graph step produces no writes — which deep-agent
+ * steps routinely do — `operations` is empty and MongoDB rejects it with
+ * `MongoInvalidArgumentError: Invalid BulkOperation, Batch cannot be empty`,
+ * surfacing as an AER 500. Persisting zero writes is a no-op, so we short-circuit
+ * it. This affects any TypeScript agent using the Mongo checkpointer.
+ */
+/**
+ * Wrap a checkpoint saver so `putWrites` skips empty write batches.
+ *
+ * Patches the instance in place and returns it. Idempotent and safe on any
+ * `BaseCheckpointSaver`; only the empty-batch path is altered, every non-empty
+ * call is forwarded unchanged.
+ */
+export function withEmptyBatchGuard(saver) {
+    const originalPutWrites = saver.putWrites.bind(saver);
+    saver.putWrites = async (config, writes, taskId) => {
+        // Only short-circuit the known empty-batch case. Anything else — including a
+        // non-array, should the upstream contract change — is forwarded so a real
+        // contract violation surfaces instead of silently dropping writes.
+        if (Array.isArray(writes) && writes.length === 0)
+            return;
+        return originalPutWrites(config, writes, taskId);
+    };
+    return saver;
+}
+//# sourceMappingURL=checkpointer.js.map

package/dist/checkpointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointer.js","sourceRoot":"","sources":["../src/checkpointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAQ;IAER,MAAM,iBAAiB,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,KAAK,CAAC,SAAS,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QACjD,6EAA6E;QAC7E,0EAA0E;QAC1E,mEAAmE;QACnE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACzD,OAAO,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/deep_agent.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Deep-agent factory for Atlas Agent Engine AER integration.
+ *
+ * `createAgentEngineDeepAgent` resolves relative skill paths and validates
+ * subagent specs before delegating to deepagents (mirroring Python's
+ * `deep_agent.py`):
+ *
+ * - {@link validateSubagentTree} rejects subagent specs with string models,
+ *   which would bypass OE routing (deepagents instantiates a raw, unwrapped LLM
+ *   from a string spec).
+ *
+ */
+import { createDeepAgent } from "deepagents";
+import type { AnyBackendProtocol, AnySubAgent, CreateDeepAgentParams } from "deepagents";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { StructuredTool } from "@langchain/core/tools";
+import type { BaseCheckpointSaver } from "@langchain/langgraph";
+export interface CreateAgentEngineDeepAgentOptions {
+    /** Additional tools for the deep agent. */
+    tools?: StructuredTool[];
+    /**
+     * SubAgent specs. Plain specs with a `model` field must use a model instance,
+     * not a string — string models bypass OE routing.
+     */
+    subagents?: readonly AnySubAgent[];
+    /** Custom system instructions. */
+    systemPrompt?: string;
+    /** Additional middleware, appended after the default durable middleware. */
+    middleware?: CreateDeepAgentParams["middleware"];
+    /** LangGraph checkpointer for state persistence, HITL, and multi-turn. */
+    checkpointer?: BaseCheckpointSaver | boolean;
+    /** LangGraph store for skills and shared data. */
+    store?: CreateDeepAgentParams["store"];
+    /** Parent directories for deepagents' one-level skill discovery. */
+    skills?: string[];
+    /** Base directory for relative skill paths (set by `App.deepAgent()`). */
+    skillsBaseDir?: string;
+}
+/**
+ * Create a deep-agent graph pre-configured for Atlas Agent Engine AER. Resolves relative
+ * skill paths, validates the subagent tree, then delegates to deepagents'
+ * `createDeepAgent`.
+ *
+ * @param secureLlm A `SecureWrappedLLM` instance — every LLM call is OE-audited.
+ * @param backend Backend for filesystem/shell ops; resolved by `App.deepAgent()`.
+ * @throws {Error} A subagent spec uses a string model, or nesting exceeds the cap.
+ */
+export declare function createAgentEngineDeepAgent(secureLlm: BaseChatModel, backend: AnyBackendProtocol | undefined, options?: CreateAgentEngineDeepAgentOptions): ReturnType<typeof createDeepAgent>;
+//# sourceMappingURL=deep_agent.d.ts.map

package/dist/deep_agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep_agent.d.ts","sourceRoot":"","sources":["../src/deep_agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAsBhE,MAAM,WAAW,iCAAiC;IAChD,2CAA2C;IAC3C,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACnC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACjD,0EAA0E;IAC1E,YAAY,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAC7C,kDAAkD;IAClD,KAAK,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACvC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,OAAO,GAAE,iCAAsC,GAC9C,UAAU,CAAC,OAAO,eAAe,CAAC,CAyDpC"}

package/dist/deep_agent.js

@@ -0,0 +1,110 @@
+/**
+ * Deep-agent factory for Atlas Agent Engine AER integration.
+ *
+ * `createAgentEngineDeepAgent` resolves relative skill paths and validates
+ * subagent specs before delegating to deepagents (mirroring Python's
+ * `deep_agent.py`):
+ *
+ * - {@link validateSubagentTree} rejects subagent specs with string models,
+ *   which would bypass OE routing (deepagents instantiates a raw, unwrapped LLM
+ *   from a string spec).
+ *
+ */
+import * as path from "node:path";
+import { createDeepAgent } from "deepagents";
+import { validateSubagentTree } from "./subagents.js";
+import { checkpointerForDeepAgent } from "./deep_agent_checkpointer.js";
+import { createDurableDeepAgentMiddleware } from "./durable_deep_agent.js";
+/** Names of compiled subagent specs whose runnable carries its own checkpointer. */
+function compiledSubagentCheckpointerNames(subagents) {
+    const names = new Set();
+    for (const spec of subagents ?? []) {
+        if ("runnable" in spec &&
+            spec.runnable
+                ?.checkpointer != null) {
+            names.add(spec.name);
+        }
+    }
+    return names;
+}
+function loadSkillPaths(paths, baseDir) {
+    if (baseDir === undefined)
+        return [...paths];
+    return paths.map((skillPath) => path.isAbsolute(skillPath) ? skillPath : path.join(baseDir, skillPath));
+}
+/**
+ * Resolve relative per-subagent skill paths against the same base directory as
+ * the top-level `skills` list. Compiled (`runnable`) and remote (`graphId`)
+ * specs, and specs without a `skills` field, pass through unchanged.
+ */
+function loadSubagentSkillPaths(subagents, baseDir) {
+    return subagents.map((spec) => {
+        if ("runnable" in spec || "graphId" in spec || !("skills" in spec)) {
+            return spec;
+        }
+        const skills = spec.skills;
+        if (skills === undefined)
+            return spec;
+        return { ...spec, skills: loadSkillPaths(skills, baseDir) };
+    });
+}
+/**
+ * Create a deep-agent graph pre-configured for Atlas Agent Engine AER. Resolves relative
+ * skill paths, validates the subagent tree, then delegates to deepagents'
+ * `createDeepAgent`.
+ *
+ * @param secureLlm A `SecureWrappedLLM` instance — every LLM call is OE-audited.
+ * @param backend Backend for filesystem/shell ops; resolved by `App.deepAgent()`.
+ * @throws {Error} A subagent spec uses a string model, or nesting exceeds the cap.
+ */
+export function createAgentEngineDeepAgent(secureLlm, backend, options = {}) {
+    validateSubagentTree(options.subagents);
+    const forwardedSkills = options.skills !== undefined
+        ? loadSkillPaths(options.skills, options.skillsBaseDir)
+        : undefined;
+    const forwardedSubagents = options.subagents !== undefined
+        ? loadSubagentSkillPaths(options.subagents, options.skillsBaseDir)
+        : undefined;
+    const durableCheckpointer = options.checkpointer !== undefined
+        ? checkpointerForDeepAgent(options.checkpointer)
+        : undefined;
+    // Passed straight through as skills= (not built into a middleware
+    // instance here, unlike the Python port): createDeepAgent constructs
+    // createSkillsMiddleware itself in three places -- the main agent, the
+    // auto-injected general-purpose subagent, and any subagent with its own
+    // skills= -- and deepagents-js exports that factory as a frozen ESM
+    // binding, so there is no way to substitute a traced wrapper for the
+    // other two call sites without dropping skills from them entirely.
+    // Python can patch the class in place instead (see skills_tracing.py);
+    // no equivalent exists here, so this hook stays untraced in TS.
+    // Build via conditional spreads so absent options are omitted rather than
+    // set to `undefined` — the package is compiled with
+    // `exactOptionalPropertyTypes`, which rejects `undefined` on optional props.
+    // `backend` is likewise omitted when undefined so deepagents applies its own
+    // default (an in-memory StateBackend).
+    return createDeepAgent({
+        model: secureLlm,
+        ...(options.tools !== undefined && { tools: options.tools }),
+        ...(forwardedSubagents !== undefined && { subagents: forwardedSubagents }),
+        ...(options.systemPrompt !== undefined && {
+            systemPrompt: options.systemPrompt,
+        }),
+        // Prepended so every agent gets durable local-subagent attribution by
+        // default. A per-call-stopped tool batch goes to the model as ordinary
+        // interrupted ToolMessages — continuation is the model's call, matching
+        // the Python twin.
+        middleware: [
+            createDurableDeepAgentMiddleware({
+                unsupportedSubagentNames: compiledSubagentCheckpointerNames(options.subagents),
+            }),
+            ...(options.middleware ?? []),
+        ],
+        ...(durableCheckpointer !== undefined && {
+            checkpointer: durableCheckpointer,
+        }),
+        ...(options.store !== undefined && { store: options.store }),
+        ...(forwardedSkills !== undefined && { skills: forwardedSkills }),
+        ...(backend !== undefined && { backend }),
+    });
+}
+//# sourceMappingURL=deep_agent.js.map

package/dist/deep_agent.js.map

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

package/dist/deep_agent_checkpointer.d.ts

@@ -0,0 +1,11 @@
+/** Checkpointer policy for graphs created by Deep Agent. */
+import type { BaseCheckpointSaver } from "@langchain/langgraph";
+/**
+ * Return the internal-routing view for a platform checkpointer, so a Deep
+ * Agent graph participates in durable execution without rejecting its own
+ * adapter routing (LangChain's agent factory routes pending ToolCalls through
+ * LangGraph Send packets). The view shares the same platform scratch and
+ * native savers. Other checkpointers pass through unchanged.
+ */
+export declare function checkpointerForDeepAgent<C extends BaseCheckpointSaver<string | number> | boolean | undefined>(checkpointer: C): C;
+//# sourceMappingURL=deep_agent_checkpointer.d.ts.map

package/dist/deep_agent_checkpointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep_agent_checkpointer.d.ts","sourceRoot":"","sources":["../src/deep_agent_checkpointer.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,SAAS,mBAAmB,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,GAAG,SAAS,EACpE,YAAY,EAAE,CAAC,GAAG,CAAC,CAQpB"}

package/dist/deep_agent_checkpointer.js

@@ -0,0 +1,19 @@
+/** Checkpointer policy for graphs created by Deep Agent. */
+import { PlatformCheckpointer } from "./platform_checkpointer.js";
+/**
+ * Return the internal-routing view for a platform checkpointer, so a Deep
+ * Agent graph participates in durable execution without rejecting its own
+ * adapter routing (LangChain's agent factory routes pending ToolCalls through
+ * LangGraph Send packets). The view shares the same platform scratch and
+ * native savers. Other checkpointers pass through unchanged.
+ */
+export function checkpointerForDeepAgent(checkpointer) {
+    if (checkpointer instanceof PlatformCheckpointer) {
+        // The view shares the same platform state, so platform-owned lifecycle
+        // (scratch release, completion) observes exactly what the deep-agent
+        // graph writes.
+        return checkpointer.deepAgentView();
+    }
+    return checkpointer;
+}
+//# sourceMappingURL=deep_agent_checkpointer.js.map

package/dist/deep_agent_checkpointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep_agent_checkpointer.js","sourceRoot":"","sources":["../src/deep_agent_checkpointer.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAI5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAEtC,YAAe;IACf,IAAI,YAAY,YAAY,oBAAoB,EAAE,CAAC;QACjD,uEAAuE;QACvE,qEAAqE;QACrE,gBAAgB;QAChB,OAAO,YAAY,CAAC,aAAa,EAAkB,CAAC;IACtD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/deep_agent_task.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parse Deep Agent `task` tool calls for adapter-owned behavior.
+ *
+ * Port of `deep_agent_task.py`.
+ */
+export declare const DISPATCH_TOOL_NAME = "task";
+export interface DeepAgentTaskCall {
+    /** Normalized identity and stream metadata for one `task` call. */
+    readonly toolCallId: string;
+    readonly subagentName: string;
+    readonly description: string;
+}
+/**
+ * Normalize one Deep Agent task call, retaining malformed identity as empty.
+ * Returns null for tool calls that are not `task` dispatches.
+ */
+export declare function parseTaskCall(toolCall: unknown): DeepAgentTaskCall | null;
+/**
+ * Yield task calls with IDs from LangChain messages or chunks.
+ *
+ * Stream attribution historically ignores incomplete tool-call chunks until
+ * their stable ID is assembled. Durable dispatch performs its stricter name
+ * and ID validation directly through {@link parseTaskCall}.
+ */
+export declare function iterTaskCalls(messagesOrChunks: Iterable<unknown>): IterableIterator<DeepAgentTaskCall>;
+//# sourceMappingURL=deep_agent_task.d.ts.map

package/dist/deep_agent_task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep_agent_task.d.ts","sourceRoot":"","sources":["../src/deep_agent_task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAOzC,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAczE;AAED;;;;;;GAMG;AACH,wBAAiB,aAAa,CAC5B,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAClC,gBAAgB,CAAC,iBAAiB,CAAC,CASrC"}

package/dist/deep_agent_task.js

@@ -0,0 +1,49 @@
+/**
+ * Parse Deep Agent `task` tool calls for adapter-owned behavior.
+ *
+ * Port of `deep_agent_task.py`.
+ */
+export const DISPATCH_TOOL_NAME = "task";
+function toolCallValue(toolCall, key) {
+    if (toolCall === null || typeof toolCall !== "object")
+        return undefined;
+    return toolCall[key];
+}
+/**
+ * Normalize one Deep Agent task call, retaining malformed identity as empty.
+ * Returns null for tool calls that are not `task` dispatches.
+ */
+export function parseTaskCall(toolCall) {
+    if (toolCallValue(toolCall, "name") !== DISPATCH_TOOL_NAME)
+        return null;
+    const rawId = toolCallValue(toolCall, "id");
+    const args = toolCallValue(toolCall, "args");
+    const argsDict = args !== null && typeof args === "object" && !Array.isArray(args)
+        ? args
+        : {};
+    return {
+        toolCallId: typeof rawId === "string" ? rawId : "",
+        subagentName: String(argsDict["subagent_type"] ?? "") || "",
+        description: String(argsDict["description"] ?? "") || "",
+    };
+}
+/**
+ * Yield task calls with IDs from LangChain messages or chunks.
+ *
+ * Stream attribution historically ignores incomplete tool-call chunks until
+ * their stable ID is assembled. Durable dispatch performs its stricter name
+ * and ID validation directly through {@link parseTaskCall}.
+ */
+export function* iterTaskCalls(messagesOrChunks) {
+    for (const message of messagesOrChunks) {
+        const toolCalls = message.tool_calls;
+        if (!Array.isArray(toolCalls))
+            continue;
+        for (const toolCall of toolCalls) {
+            const parsed = parseTaskCall(toolCall);
+            if (parsed !== null && parsed.toolCallId !== "")
+                yield parsed;
+        }
+    }
+}
+//# sourceMappingURL=deep_agent_task.js.map

package/dist/deep_agent_task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep_agent_task.js","sourceRoot":"","sources":["../src/deep_agent_task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,SAAS,aAAa,CAAC,QAAiB,EAAE,GAAW;IACnD,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxE,OAAQ,QAAoC,CAAC,GAAG,CAAC,CAAC;AACpD,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAiB;IAC7C,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAExE,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,QAAQ,GACZ,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/D,CAAC,CAAE,IAAgC;QACnC,CAAC,CAAC,EAAE,CAAC;IACT,OAAO;QACL,UAAU,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAClD,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;QAC3D,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;KACzD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,SAAS,CAAC,CAAC,aAAa,CAC5B,gBAAmC;IAEnC,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,MAAM,SAAS,GAAI,OAAoC,CAAC,UAAU,CAAC;QACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,SAAS;QACxC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,KAAK,EAAE;gBAAE,MAAM,MAAM,CAAC;QAChE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/durable_deep_agent.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Durable operation-path boundaries for Deep Agent task delegation.
+ *
+ * Deep Agent exposes subagent dispatch through the public `task` tool and
+ * middleware hooks, rather than as a compiled child graph:
+ * https://docs.langchain.com/oss/javascript/deepagents/subagents
+ *
+ * Same-step `task` siblings stamp ToolCall-id ordinals after FinalizeStep.
+ * Stamping in `afterModel` would key those ordinals to the model step, which
+ * FinalizeStep then leaves behind.
+ *
+ * Port of `durable_deep_agent.py`.
+ */
+import { type BaseMessage } from "@langchain/core/messages";
+/**
+ * Replace Deep Agent's generated message ids before LangGraph persists them.
+ * No-op outside a task scope, so native sessions keep provider ids.
+ */
+export declare function stampDeepAgentMessageIds(messages: BaseMessage[]): void;
+export declare function createDurableDeepAgentMiddleware(options: {
+    unsupportedSubagentNames?: ReadonlySet<string>;
+}): import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[]>;
+//# sourceMappingURL=durable_deep_agent.d.ts.map

package/dist/durable_deep_agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable_deep_agent.d.ts","sourceRoot":"","sources":["../src/durable_deep_agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EACL,KAAK,WAAW,EAIjB,MAAM,0BAA0B,CAAC;AAoClC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAmBtE;AAuBD,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACxD,wBAAwB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChD,4KAsHA"}