managed-deepagents 0.9.6-dev.19 → 0.9.6-dev.20

package/dist/runtime/parent-run.d.ts

@@ -0,0 +1,33 @@
+import { RunTree } from "langsmith";
+import type { ManagedRunConfig } from "./types.js";
+/** The lead thread a run's caller owns, with the metadata its thread record lives in. */
+export interface LeadThread {
+    id: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * The thread of the agent that launched this run, if deepagents sent it.
+ *
+ * Read from deepagents' parent reference, or else from the task thread's
+ * `parent_thread_id` metadata, which the Agent Server copies into every run on
+ * the thread, including runs deepagents didn't start (such as a resume).
+ */
+export declare function leadThreadId(config: ManagedRunConfig | undefined): string | undefined;
+/**
+ * The lead's thread when this run's caller owns it, else `undefined`.
+ *
+ * Reads the thread through the SDK's default client, which the Agent Server and
+ * `mda dev` point at their own API (as the run's caller), then requires its `owner` to be the
+ * caller's owner key, MDA's rule for changing a thread. Being able to read it isn't
+ * enough: Studio callers can read every thread. A thread without an owner (no
+ * managed identity) only needs to be readable.
+ */
+export declare function verifiedLeadThread(config: ManagedRunConfig | undefined): Promise<LeadThread | undefined>;
+/** The thread a run's record is read from: its lead's, when given. */
+export declare function threadSource(config: ManagedRunConfig | undefined, leadThread: LeadThread | undefined): {
+    configurable: Record<string, unknown> | undefined;
+    metadata: unknown;
+};
+/** Rebuild the span that launched this run from the trace headers the Agent Server kept. */
+export declare function launchingParent(config: ManagedRunConfig | undefined): RunTree | undefined;
+//# sourceMappingURL=parent-run.d.ts.map

package/dist/runtime/parent-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-run.d.ts","sourceRoot":"","sources":["../../src/runtime/parent-run.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAanD,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAqBjC;AAYD,sEAAsE;AACtE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC;IAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAO1E;AAgBD,4FAA4F;AAC5F,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,OAAO,GAAG,SAAS,CAmBrB"}

package/dist/runtime/parent-run.js

@@ -0,0 +1,114 @@
+/**
+ * Runs that deepagents launched from another agent's run (async subagents):
+ * verify the lead's thread, so the run can share its sandbox and thread
+ * record, and nest the run under the lead's trace.
+ */
+import { Client } from "@langchain/langgraph-sdk";
+import { RunTree } from "langsmith";
+import { threadOwnerKey } from "./auth.js";
+import { resolveRuntimeConfigurable } from "./identity-runtime.js";
+import { logger } from "./log.js";
+import { isRecord } from "./managed-thread.js";
+/** `configurable` key where deepagents puts an async subagent run's parent reference. */
+const PARENT_REFERENCE_KEY = "deepagents_parent";
+/** Run metadata key (copied from the task thread) naming an async subagent's lead thread. */
+const PARENT_THREAD_METADATA_KEY = "parent_thread_id";
+/** Baggage key deepagents sets to mark trace headers as a parent. */
+const NEST_UNDER_PARENT = "ls_nest_under_parent";
+const UUID = "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}";
+const SEGMENT = `\\d{8}T\\d{6,}Z${UUID}`;
+/** A `langsmith-trace` dotted order: `<timestamp>Z<run id>` segments joined by dots. */
+const DOTTED_ORDER = new RegExp(`^${SEGMENT}(\\.${SEGMENT})*$`, "i");
+/**
+ * The thread of the agent that launched this run, if deepagents sent it.
+ *
+ * Read from deepagents' parent reference, or else from the task thread's
+ * `parent_thread_id` metadata, which the Agent Server copies into every run on
+ * the thread, including runs deepagents didn't start (such as a resume).
+ */
+export function leadThreadId(config) {
+    const reference = config?.configurable?.[PARENT_REFERENCE_KEY];
+    const metadata = config?.metadata;
+    const id = (isRecord(reference) ? reference.thread_id : undefined) ??
+        (isRecord(metadata) ? metadata[PARENT_THREAD_METADATA_KEY] : undefined);
+    // A run on the lead's own thread is the lead's, not a subagent's.
+    return typeof id === "string" && id && id !== config?.configurable?.thread_id
+        ? id
+        : undefined;
+}
+/**
+ * The lead's thread when this run's caller owns it, else `undefined`.
+ *
+ * Reads the thread through the SDK's default client, which the Agent Server and
+ * `mda dev` point at their own API (as the run's caller), then requires its `owner` to be the
+ * caller's owner key, MDA's rule for changing a thread. Being able to read it isn't
+ * enough: Studio callers can read every thread. A thread without an owner (no
+ * managed identity) only needs to be readable.
+ */
+export async function verifiedLeadThread(config) {
+    const id = leadThreadId(config);
+    if (!id)
+        return undefined;
+    let metadata;
+    try {
+        const thread = await new Client().threads.get(id);
+        metadata = isRecord(thread.metadata) ? thread.metadata : {};
+    }
+    catch {
+        logger.warn("lead thread not accessible to this run; using its own sandbox");
+        return undefined;
+    }
+    const owner = metadata.owner;
+    if (owner !== undefined && owner !== callerOwnerKey(config)) {
+        logger.warn("lead thread belongs to another caller; using this run's own sandbox");
+        return undefined;
+    }
+    return { id, metadata };
+}
+/** The thread owner key MDA stamps for this run's caller, if it's authenticated. */
+function callerOwnerKey(config) {
+    const user = resolveRuntimeConfigurable(config)?.langgraph_auth_user;
+    return user ? threadOwnerKey(user) : undefined;
+}
+/** The thread a run's record is read from: its lead's, when given. */
+export function threadSource(config, leadThread) {
+    return leadThread
+        ? {
+            configurable: { ...config?.configurable, thread_id: leadThread.id },
+            metadata: leadThread.metadata,
+        }
+        : { configurable: config?.configurable, metadata: config?.metadata };
+}
+/** The `langsmith-trace` header, when deepagents marked it as a parent to nest under. */
+function nestingTrace(configurable) {
+    const trace = configurable["langsmith-trace"];
+    const metadata = configurable["langsmith-metadata"];
+    return typeof trace === "string" &&
+        trace &&
+        isRecord(metadata) &&
+        metadata[NEST_UNDER_PARENT] === true
+        ? trace
+        : undefined;
+}
+/** Rebuild the span that launched this run from the trace headers the Agent Server kept. */
+export function launchingParent(config) {
+    const configurable = config?.configurable ?? {};
+    const trace = nestingTrace(configurable);
+    if (!trace)
+        return undefined;
+    const project = configurable["langsmith-project"];
+    const baggage = typeof project === "string"
+        ? `langsmith-project=${encodeURIComponent(project)}`
+        : "";
+    try {
+        // `fromHeaders` accepts any string and invents a run id.
+        if (!DOTTED_ORDER.test(trace))
+            throw new Error("malformed");
+        return RunTree.fromHeaders({ "langsmith-trace": trace, baggage });
+    }
+    catch {
+        logger.warn("ignoring a malformed langsmith-trace; the run keeps its own trace");
+        return undefined;
+    }
+}
+//# sourceMappingURL=parent-run.js.map

package/dist/runtime/parent-run.js.map

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

package/dist/runtime/run-input.d.ts

@@ -1,3 +1,4 @@
+import { type LeadThread } from "./parent-run.js";
 import type { ManagedRunConfig } from "./types.js";
 import type { createDeepAgent } from "deepagents";
 export declare function isRunExecution(config?: ManagedRunConfig): config is ManagedRunConfig;
@@ -43,6 +44,18 @@ export declare function executionContext(config?: ManagedRunConfig): {
     channelRun: boolean;
 };
 type Agent = ReturnType<typeof createDeepAgent>;
-export declare function adaptChannelExecution(agent: Agent): Agent;
+/** The run's own thread id. */
+export declare function threadIdOf(config?: ManagedRunConfig): string | undefined;
+/**
+ * The Agent Server run a config belongs to. The JS bridge passes it as the
+ * top-level `runId`; other hosts stamp `metadata.run_id` or
+ * `configurable.run_id`.
+ */
+export declare function resolveRunId(config?: {
+    runId?: unknown;
+    metadata?: Record<string, unknown>;
+    configurable?: Record<string, unknown>;
+}): string | undefined;
+export declare function adaptChannelExecution(agent: Agent, leadThread?: LeadThread): Agent;
 export {};
 //# sourceMappingURL=run-input.d.ts.map

package/dist/runtime/run-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-input.d.ts","sourceRoot":"","sources":["../../src/runtime/run-input.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,gBAAgB,GACxB,MAAM,IAAI,gBAAgB,CAE5B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAYrE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAOvE;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB;;aAMxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDpE;AAED,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AA0EhD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAQzD"}
+{"version":3,"file":"run-input.d.ts","sourceRoot":"","sources":["../../src/runtime/run-input.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAazB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,gBAAgB,GACxB,MAAM,IAAI,gBAAgB,CAE5B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAYrE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAOvE;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB;;aAMxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuDpE;AAED,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAiHhD,+BAA+B;AAC/B,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,GAAG,MAAM,GAAG,SAAS,CASrB;AA8CD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,UAAU,CAAC,EAAE,UAAU,GACtB,KAAK,CASP"}

package/dist/runtime/run-input.js

@@ -1,7 +1,11 @@
 import { isDeepStrictEqual } from "node:util";
-import { CompiledStateGraph, getConfig } from "@langchain/langgraph";
+import { CompiledStateGraph, getConfig, isGraphBubbleUp, } from "@langchain/langgraph";
+import { withRunTree } from "langsmith/traceable";
 import { currentChannelBinding, resolveChannelBinding, } from "../channels/binding.js";
 import { isManagedKey } from "../run-context.js";
+import { resolveRunThread } from "./managed-thread.js";
+import { launchingParent, leadThreadId, threadSource, } from "./parent-run.js";
+import { deliverRunFailure, deliverRunResult, } from "../channels/delivery.js";
 import { createLogContext, currentLogContext, runInLogContext, traceIdFromMetadata, } from "../telemetry/otel/index.js";
 export function isRunExecution(config) {
     return !!config && Object.hasOwn(config, "context");
@@ -71,8 +75,11 @@ export function executionContext(config) {
         channelRun,
     };
 }
+/** Graph property holding the lead thread a verified async subagent run shares. */
+const LEAD_THREAD = Symbol("mda.leadThread");
 /** Keep the adapter on native graph copies without binding an old instance. */
 class ManagedCompiledGraph extends CompiledStateGraph {
+    [LEAD_THREAD];
     async *_streamIterator(input, options) {
         const ambient = getConfig();
         const config = {
@@ -85,7 +92,19 @@ class ManagedCompiledGraph extends CompiledStateGraph {
                 ...options?.configurable,
             },
         };
-        const scope = executionContext(config);
+        const routed = executionContext(config);
+        // A channel caller's async subagent run never answers, and reads its lead's
+        // thread record once its caller is verified to own it.
+        const subagent = routed.channelRun && !!leadThreadId(config);
+        const scope = {
+            ...routed,
+            thread: resolveRunThread({
+                ...threadSource(config, routed.channelRun ? this[LEAD_THREAD] : undefined),
+                binding: routed.binding,
+            }),
+        };
+        // Nest this run under the async subagent call that launched it.
+        const parent = launchingParent(config);
         const managed = scope.routing !== undefined;
         const execution = managed && this.config?.context !== undefined
             ? this.withConfig({})
@@ -100,12 +119,38 @@ class ManagedCompiledGraph extends CompiledStateGraph {
         if (!parentLog) {
             setRunLogAttributes(log, config);
         }
-        const within = (fn) => currentChannelBinding.run(scope, () => runInLogContext(log, fn));
+        // Each step runs bound to its channel, in the run's log context, and nested
+        // under the async subagent call that launched it, if any.
+        const within = (fn) => {
+            const step = () => currentChannelBinding.run(scope, () => runInLogContext(log, fn));
+            return parent ? withRunTree(parent, step) : step();
+        };
+        const topLevel = isTopLevelRun(config, this);
+        const delivered = {
+            runId: resolveRunId(config),
+            assistantId: assistantIdOf(config),
+            configurable: config.configurable,
+            metadata: config.metadata,
+            routing: scope.routing,
+            runThreadId: threadIdOf(config),
+            subagent,
+        };
         try {
             while (true) {
-                const item = await within(() => iterator.next());
-                if (item.done)
+                let item;
+                try {
+                    item = await within(() => iterator.next());
+                }
+                catch (error) {
+                    if (topLevel && !isGraphBubbleUp(error) && !isCancellation(error))
+                        await within(() => deliverRunFailure(scope.thread, delivered, error));
+                    throw error;
+                }
+                if (item.done) {
+                    if (topLevel)
+                        await within(() => deliverRunResult(this, scope.thread, delivered));
                     return;
+                }
                 yield item.value;
             }
         }
@@ -122,6 +167,53 @@ class ManagedCompiledGraph extends CompiledStateGraph {
             : super._validateContext(context);
     }
 }
+/** The run's own thread id. */
+export function threadIdOf(config) {
+    const value = config?.configurable?.thread_id;
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+/**
+ * The Agent Server run a config belongs to. The JS bridge passes it as the
+ * top-level `runId`; other hosts stamp `metadata.run_id` or
+ * `configurable.run_id`.
+ */
+export function resolveRunId(config) {
+    for (const value of [
+        config?.runId,
+        config?.metadata?.run_id,
+        config?.configurable?.run_id,
+    ]) {
+        if (typeof value === "string" && value.trim())
+            return value.trim();
+    }
+    return undefined;
+}
+function assistantIdOf(config) {
+    for (const id of [
+        config.configurable?.assistant_id,
+        config.metadata?.assistant_id,
+    ]) {
+        if (typeof id === "string" && id.trim())
+            return id.trim();
+    }
+    return undefined;
+}
+/**
+ * Whether a run ended because it was cancelled, which is no failure to report.
+ * Python never sees one: its cancellation is not an `Exception`. The check
+ * mirrors LangGraph's own in `pregel/retry.js`.
+ */
+function isCancellation(error) {
+    if (!(error instanceof Error))
+        return false;
+    return (error.name === "AbortError" ||
+        error.message.startsWith("Cancel") ||
+        error.message.startsWith("AbortError"));
+}
+/** The run's own graph with state to read, not a graph a node calls. */
+function isTopLevelRun(config, graph) {
+    return !config.configurable?.checkpoint_ns && !!graph.checkpointer;
+}
 function setRunLogAttributes(log, config) {
     for (const [key, value] of [
         ["run_id", config.metadata?.run_id],
@@ -131,13 +223,14 @@ function setRunLogAttributes(log, config) {
             log.attributes[key] = value;
     }
 }
-export function adaptChannelExecution(agent) {
+export function adaptChannelExecution(agent, leadThread) {
     if (!(agent.graph instanceof CompiledStateGraph))
         return agent;
     Object.setPrototypeOf(agent.graph, ManagedCompiledGraph.prototype);
+    agent.graph[LEAD_THREAD] = leadThread;
     const configure = agent.withConfig;
     agent.withConfig = function (config) {
-        return adaptChannelExecution(configure.call(this, config));
+        return adaptChannelExecution(configure.call(this, config), leadThread);
     };
     return agent;
 }

package/dist/runtime/run-input.js.map

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

package/dist/runtime/sandbox-manager.d.ts

@@ -17,6 +17,8 @@ export declare const SANDBOX_API_ENDPOINT_ENV = "MDA_SANDBOX_API_ENDPOINT";
  * resolves `snapshotName` in the wrong workspace and 404s on the recipe.
  */
 export declare const WORKSPACE_ID_ENV = "LANGSMITH_WORKSPACE_ID";
+/** Run `fn` with sandbox scope keys resolving to `leadThread`'s sandbox, if set. */
+export declare function withLeadSandbox<T>(leadThread: string | undefined, fn: () => T): T;
 /** Optional runtime inputs that drive connector sandbox provisioning. */
 export interface ResolveManagedSandboxOptions {
     connectors?: Connector[];
@@ -34,9 +36,20 @@ export interface ResolveManagedSandboxOptions {
  * messages in an already-synced thread (mode `"credentials"`).
  */
 export declare function resolveManagedSandbox(sandbox: SandboxDefinition, config: ManagedRunConfig | undefined, options?: ResolveManagedSandboxOptions): Promise<SandboxBackendProtocolV2>;
+/**
+ * The thread's sandbox if this process has opened it, by any caller; never
+ * opens one. A sandbox being recreated reads as unopened until its
+ * replacement is ready. Like resolving, it needs `configurable.thread_id`.
+ */
+export declare function openedManagedSandbox(config: ManagedRunConfig | undefined, selectionFingerprint?: string): SandboxBackendProtocolV2 | undefined;
 export declare function isSandboxNotFoundError(error: unknown): boolean;
 export declare function recoverManagedSandbox(sandbox: SandboxDefinition, config: ManagedRunConfig | undefined, failedBackend: SandboxBackendProtocolV2, options?: ResolveManagedSandboxOptions): Promise<SandboxBackendProtocolV2>;
-/** Derive the process-level reuse key for a thread and optional selection. */
+/**
+ * Derive the process-level reuse key for a thread and optional selection.
+ *
+ * An async subagent sharing its lead's sandbox uses the lead's thread, so both
+ * resolve, sync, and name the same sandbox.
+ */
 export declare function sandboxScopeKey(config: ManagedRunConfig | undefined, selectionFingerprint?: string): string;
 /**
  * Stable, non-plaintext identity for an explicit dynamic sandbox selection.
@@ -91,7 +104,7 @@ export declare function isTransientSandboxError(error: unknown): boolean;
  * is the platform's own value and is preferred when present. Undefined under
  * local `mda dev`, where sandboxes stay unnamed and LangSmith generates a name.
  */
-export declare function managedDeploymentName(): string | undefined;
+export declare function managedDeploymentName(env?: NodeJS.ProcessEnv): string | undefined;
 /**
  * Deterministic sandbox name for a deployment and thread.
  *

package/dist/runtime/sandbox-manager.d.ts.map

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

package/dist/runtime/sandbox-manager.js

@@ -1,3 +1,4 @@
+import { AsyncLocalStorage } from "node:async_hooks";
 import { createHash, randomBytes } from "node:crypto";
 import { LangSmithSandbox } from "deepagents";
 import { Sandbox, SandboxClient, LangSmithResourceNotFoundError, LangSmithResourceAlreadyExistsError, LangSmithResourceNameConflictError, LangSmithSandboxConnectionError, } from "langsmith/sandbox";
@@ -61,6 +62,12 @@ const SANDBOX_DEPLOYMENT_DIGEST_LENGTH = 8;
 const ADOPTABLE_STATUS = new Set(["ready", "running"]);
 /** Sandbox status for one that is stopped but restartable. */
 const STOPPED_STATUS = "stopped";
+/** Lead thread whose sandbox this run shares; set only by the verified backend, never from config. */
+const sharedLeadThread = new AsyncLocalStorage();
+/** Run `fn` with sandbox scope keys resolving to `leadThread`'s sandbox, if set. */
+export function withLeadSandbox(leadThread, fn) {
+    return leadThread ? sharedLeadThread.run(leadThread, fn) : fn();
+}
 /**
  * Resolve (and cache) the per-thread LangSmith sandbox backend for this run.
  * When deploy baked a recipe, new sandboxes clone it; otherwise Host supplies
@@ -73,6 +80,8 @@ const STOPPED_STATUS = "stopped";
 export function resolveManagedSandbox(sandbox, config, options) {
     const key = sandboxScopeKey(config, options?.selectionFingerprint);
     const hasSandbox = hasSandboxConnectors(options?.connectors);
+    // A subagent on its lead's sandbox only refreshes credentials.
+    const sharesLeadSandbox = sharedLeadThread.getStore() !== undefined;
     let entry = managedSandboxes.get(key);
     if (!entry) {
         const created = {
@@ -80,12 +89,13 @@ export function resolveManagedSandbox(sandbox, config, options) {
             syncChain: Promise.resolve(),
             freshlyCreated: true,
             ready: Promise.resolve().then(async () => {
-                const { backend, hostName, sandboxId } = await createLangSmithSandbox(sandbox, config, options, "create", key);
+                const { backend, hostName, sandboxId } = await createLangSmithSandbox(sandbox, config, options, "create", key, { adoptedMode: sharesLeadSandbox ? "credentials" : "reuse" });
                 created.hostName = hostName;
                 created.sandboxId = sandboxId;
                 const id = backend.id;
                 created.backendId =
                     typeof id === "string" && id.trim() ? id.trim() : undefined;
+                created.backend = backend;
                 if (hostName) {
                     backendHostNames.set(backend, hostName);
                 }
@@ -113,8 +123,8 @@ export function resolveManagedSandbox(sandbox, config, options) {
                 cached.freshlyCreated = false;
                 return;
             }
-            if (cached.syncedThreads.has(key)) {
-                // Same thread: refresh credentials / CLI wiring without re-cloning.
+            if (cached.syncedThreads.has(key) || sharesLeadSandbox) {
+                // Same thread, or a lead's subagent: refresh credentials / CLI wiring without re-cloning.
                 // Otherwise redeploys that fix auth (e.g. gh wrapper) never apply mid-thread.
                 await runConnectorSandboxHooks(options?.connectors, {
                     backend,
@@ -137,6 +147,15 @@ export function resolveManagedSandbox(sandbox, config, options) {
         return backend;
     });
 }
+/**
+ * The thread's sandbox if this process has opened it, by any caller; never
+ * opens one. A sandbox being recreated reads as unopened until its
+ * replacement is ready. Like resolving, it needs `configurable.thread_id`.
+ */
+export function openedManagedSandbox(config, selectionFingerprint) {
+    return managedSandboxes.get(sandboxScopeKey(config, selectionFingerprint))
+        ?.backend;
+}
 export function isSandboxNotFoundError(error) {
     return (error instanceof LangSmithResourceNotFoundError ||
         (error instanceof LangSmithSandboxConnectionError &&
@@ -170,9 +189,10 @@ export async function recoverManagedSandbox(sandbox, config, failedBackend, opti
         freshlyCreated: false,
         hostName: entry.hostName,
         ready: Promise.resolve().then(async () => {
-            const { backend, hostName, sandboxId } = await createLangSmithSandbox(sandbox, config, options, "create", key, entry.hostName, existing);
+            const { backend, hostName, sandboxId } = await createLangSmithSandbox(sandbox, config, options, "create", key, { recoveryName: entry.hostName, existingSandbox: existing });
             replacement.sandboxId = sandboxId;
             replacement.backendId = backend.id;
+            replacement.backend = backend;
             if (hostName)
                 backendHostNames.set(backend, hostName);
             return backend;
@@ -186,9 +206,14 @@ export async function recoverManagedSandbox(sandbox, config, failedBackend, opti
     managedSandboxes.set(key, replacement);
     return await replacement.ready;
 }
-/** Derive the process-level reuse key for a thread and optional selection. */
+/**
+ * Derive the process-level reuse key for a thread and optional selection.
+ *
+ * An async subagent sharing its lead's sandbox uses the lead's thread, so both
+ * resolve, sync, and name the same sandbox.
+ */
 export function sandboxScopeKey(config, selectionFingerprint) {
-    const threadKey = `thread:${threadIdFromConfig(config)}`;
+    const threadKey = `thread:${sharedLeadThread.getStore() ?? threadIdFromConfig(config)}`;
     return selectionFingerprint
         ? `${threadKey}:sandbox:${selectionFingerprint}`
         : threadKey;
@@ -410,9 +435,9 @@ export function isTransientSandboxError(error) {
  * is the platform's own value and is preferred when present. Undefined under
  * local `mda dev`, where sandboxes stay unnamed and LangSmith generates a name.
  */
-export function managedDeploymentName() {
-    return (stringOption(process.env.LANGSMITH_DEPLOYMENT_NAME) ??
-        stringOption(process.env.MDA_DEPLOYMENT_NAME));
+export function managedDeploymentName(env = process.env) {
+    return (stringOption(env.LANGSMITH_DEPLOYMENT_NAME) ??
+        stringOption(env.MDA_DEPLOYMENT_NAME));
 }
 /**
  * Deterministic sandbox name for a deployment and thread.
@@ -479,7 +504,7 @@ function legacyProvisioningFingerprint(createOptions) {
  * `snapshotName`, and managed keys are dropped.
  */
 function legacySandboxCreateOptions(sandbox) {
-    const { scope: _scope, apiKey: _apiKey, defaultTimeout: _defaultTimeout, templateName, snapshotId, ...resolvedCreateOptions } = (sandbox.options ?? {});
+    const { apiKey: _apiKey, defaultTimeout: _defaultTimeout, templateName, snapshotId, ...resolvedCreateOptions } = (sandbox.options ?? {});
     const createSandboxOptions = {
         ...resolvedCreateOptions,
     };
@@ -512,13 +537,13 @@ function managedSandboxLookupNames(deployment, sandbox, config, selectionFingerp
     names.push(legacyManagedSandboxName(deployment, scopeKey, legacySandboxCreateOptions(sandbox)));
     return [...new Set(names)];
 }
-async function createLangSmithSandbox(sandbox, config, options, mode, scopeKey, recoveryName, existingSandbox) {
+async function createLangSmithSandbox(sandbox, config, options, mode, scopeKey, { recoveryName, existingSandbox, adoptedMode = "reuse", } = {}) {
     const { backend, adopted, hostName, sandboxId } = await createLangSmithSandboxBackend(sandbox, config, scopeKey, options?.selectionFingerprint, recoveryName, existingSandbox);
     await runConnectorSandboxHooks(options?.connectors, {
         backend,
         // An adopted sandbox already ran create-time provisioning in an earlier
         // process, so treat it as a reuse for connector purposes.
-        mode: adopted ? "reuse" : mode,
+        mode: adopted ? adoptedMode : mode,
         config,
         identity: options?.identity,
     });