managed-deepagents 0.0.3-dev.16 → 0.0.3-dev.18

package/dist/connectors.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The managed `connectors/` declaration primitive.
+ *
+ * For the first connector iteration, a connector means exactly one thing: MCP
+ * servers. A Managed Deep Agent declares the remote MCP servers whose tools it
+ * wants in `connectors/mcp.ts` by exporting a named `mcp` from
+ * {@link defineMcpServers}. MDA discovers that declaration, creates the
+ * `@langchain/mcp-adapters` client, loads the tools, and adds them to the Deep
+ * Agent at runtime — the author never imports the MCP client or calls
+ * `getTools()`.
+ *
+ * Only remote MCP servers over HTTP/SSE are supported. Stdio MCP servers are
+ * intentionally out of scope: they introduce process management, packaging, and
+ * sandboxing concerns beyond this POC.
+ *
+ * @example
+ * ```ts
+ * // connectors/mcp.ts
+ * import { defineMcpServers } from "managed-deepagents";
+ *
+ * export const mcp = defineMcpServers({
+ *   useStandardContentBlocks: true,
+ *   prefixToolNameWithServerName: true,
+ *   throwOnLoadError: true,
+ *   mcpServers: {
+ *     docs: {
+ *       transport: "http",
+ *       url: "https://docs.example.com/mcp",
+ *     },
+ *   },
+ * });
+ * ```
+ */
+/** Streamable HTTP MCP server connection. */
+export interface HttpMcpServerConfig {
+    /** Remote transport. `"http"` selects Streamable HTTP. */
+    transport: "http";
+    /** URL of the remote MCP server endpoint. */
+    url: string;
+    /**
+     * Whether the client may fall back to SSE if the server does not support
+     * Streamable HTTP. Defaults to the behavior of `@langchain/mcp-adapters`.
+     */
+    automaticSSEFallback?: boolean;
+    /** Optional static headers sent when connecting to the MCP server. */
+    headers?: Record<string, string>;
+    /** Default timeout, in milliseconds, for tools loaded from this server. */
+    defaultToolTimeout?: number;
+}
+/** Legacy SSE MCP server connection. */
+export interface SseMcpServerConfig {
+    /** Remote transport. `"sse"` selects legacy SSE. */
+    transport: "sse";
+    /** URL of the remote SSE MCP server endpoint. */
+    url: string;
+    /** Optional static headers sent when connecting to the MCP server. */
+    headers?: Record<string, string>;
+    /** Reconnection behavior for SSE MCP servers. */
+    reconnect?: {
+        enabled: boolean;
+        maxAttempts?: number;
+        delayMs?: number;
+    };
+    /** Default timeout, in milliseconds, for tools loaded from this server. */
+    defaultToolTimeout?: number;
+}
+/** A remote MCP server connection. Stdio servers are intentionally excluded. */
+export type RemoteMcpServerConfig = HttpMcpServerConfig | SseMcpServerConfig;
+/** Configuration accepted by {@link defineMcpServers}. */
+export interface McpServersConfig {
+    /**
+     * MCP servers to connect to. Each key is the logical server name MDA uses
+     * for validation, tracing metadata, and tool-name prefixing.
+     */
+    mcpServers: Record<string, RemoteMcpServerConfig>;
+    /**
+     * Whether tool names should be prefixed with the MCP server name (e.g.
+     * `docs__search`). Defaults to `true`, which avoids collisions between
+     * authored tools and common MCP tool names like `search` or `read`.
+     */
+    prefixToolNameWithServerName?: boolean;
+    /**
+     * Whether tool loading should fail if a tool cannot be loaded. Defaults to
+     * `true` — a managed deployment should fail rather than start with a
+     * partially loaded tool surface.
+     */
+    throwOnLoadError?: boolean;
+    /**
+     * Whether MCP tool outputs should be converted to LangChain standard content
+     * blocks. Defaults to `true` for new managed agents.
+     */
+    useStandardContentBlocks?: boolean;
+    /**
+     * Behavior when an MCP server cannot be connected. Only `"throw"` is
+     * supported for the POC — a failed connection fails the deployment.
+     */
+    onConnectionError?: "throw";
+}
+/** The object exported from `connectors/mcp.ts`. */
+export interface McpServersDefinition extends McpServersConfig {
+    /** Internal discriminator used by the MDA loader. */
+    readonly kind: "mcp_servers";
+}
+/**
+ * Declare the MCP servers whose tools should be loaded and added to the managed
+ * Deep Agent at runtime.
+ *
+ * Validates the config eagerly so misconfiguration surfaces at module load
+ * (build/dev startup) rather than mid-run: at least one server must be
+ * declared, and every server must use a remote transport (`"http"` or
+ * `"sse"`). Stdio servers are rejected with a clear error.
+ */
+export declare function defineMcpServers(config: McpServersConfig): McpServersDefinition;
+//# sourceMappingURL=connectors.d.ts.map

package/dist/connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../src/connectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,SAAS,EAAE,KAAK,CAAC;IACjB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE7E,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAClD;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,oBAAoB,CAuB/E"}

package/dist/connectors.js

@@ -0,0 +1,86 @@
+/**
+ * The managed `connectors/` declaration primitive.
+ *
+ * For the first connector iteration, a connector means exactly one thing: MCP
+ * servers. A Managed Deep Agent declares the remote MCP servers whose tools it
+ * wants in `connectors/mcp.ts` by exporting a named `mcp` from
+ * {@link defineMcpServers}. MDA discovers that declaration, creates the
+ * `@langchain/mcp-adapters` client, loads the tools, and adds them to the Deep
+ * Agent at runtime — the author never imports the MCP client or calls
+ * `getTools()`.
+ *
+ * Only remote MCP servers over HTTP/SSE are supported. Stdio MCP servers are
+ * intentionally out of scope: they introduce process management, packaging, and
+ * sandboxing concerns beyond this POC.
+ *
+ * @example
+ * ```ts
+ * // connectors/mcp.ts
+ * import { defineMcpServers } from "managed-deepagents";
+ *
+ * export const mcp = defineMcpServers({
+ *   useStandardContentBlocks: true,
+ *   prefixToolNameWithServerName: true,
+ *   throwOnLoadError: true,
+ *   mcpServers: {
+ *     docs: {
+ *       transport: "http",
+ *       url: "https://docs.example.com/mcp",
+ *     },
+ *   },
+ * });
+ * ```
+ */
+/**
+ * Declare the MCP servers whose tools should be loaded and added to the managed
+ * Deep Agent at runtime.
+ *
+ * Validates the config eagerly so misconfiguration surfaces at module load
+ * (build/dev startup) rather than mid-run: at least one server must be
+ * declared, and every server must use a remote transport (`"http"` or
+ * `"sse"`). Stdio servers are rejected with a clear error.
+ */
+export function defineMcpServers(config) {
+    const provided = config;
+    const servers = provided.mcpServers;
+    if (servers === null || typeof servers !== "object" || Array.isArray(servers)) {
+        throw new Error("defineMcpServers(...) requires an `mcpServers` object mapping server " +
+            "names to remote MCP server configs.");
+    }
+    const entries = Object.entries(servers);
+    if (entries.length === 0) {
+        throw new Error("defineMcpServers(...) requires at least one entry in `mcpServers`.");
+    }
+    for (const [name, server] of entries) {
+        validateRemoteServer(name, server);
+    }
+    return { kind: "mcp_servers", ...config };
+}
+/** Allowed remote transports. Stdio is intentionally unsupported in v0. */
+const REMOTE_TRANSPORTS = new Set(["http", "sse"]);
+/**
+ * Validate a single MCP server config, rejecting stdio servers and anything
+ * that is not a remote HTTP/SSE connection with a `url`.
+ */
+function validateRemoteServer(name, server) {
+    if (server === null || typeof server !== "object") {
+        throw new Error(`MCP server "${name}" must be a configuration object.`);
+    }
+    const config = server;
+    // A stdio server is identified by transport or by a `command` field. Reject
+    // it with guidance toward the supported remote transports.
+    if (config.transport === "stdio" || "command" in config) {
+        throw new Error(`MCP server "${name}" uses a stdio transport, which is not supported. ` +
+            "Managed Deep Agents support remote MCP servers over HTTP/SSE only; " +
+            "expose the server over HTTP or write a normal authored tool instead.");
+    }
+    const transport = config.transport;
+    if (typeof transport !== "string" || !REMOTE_TRANSPORTS.has(transport)) {
+        throw new Error(`MCP server "${name}" must declare a remote transport ` +
+            `("http" or "sse"); got ${JSON.stringify(transport)}.`);
+    }
+    if (typeof config.url !== "string" || config.url.trim().length === 0) {
+        throw new Error(`MCP server "${name}" must declare a non-empty \`url\`.`);
+    }
+}
+//# sourceMappingURL=connectors.js.map

package/dist/connectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.js","sourceRoot":"","sources":["../src/connectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AA6EH;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,QAAQ,GAAG,MAA4C,CAAC;IAC9D,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC;IAEpC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,qCAAqC,CACxC,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACrC,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED,2EAA2E;AAC3E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAEnD;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAAY,EAAE,MAAe;IACzD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,mCAAmC,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,MAAM,GAAG,MAAiC,CAAC;IAEjD,4EAA4E;IAC5E,2DAA2D;IAC3D,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,oDAAoD;YACrE,qEAAqE;YACrE,sEAAsE,CACzE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,oCAAoC;YACrD,0BAA0B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CACzD,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,qCAAqC,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/define-deep-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-deep-agent.d.ts","sourceRoot":"","sources":["../src/define-deep-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,mBAAmB,CAKlF"}
+{"version":3,"file":"define-deep-agent.d.ts","sourceRoot":"","sources":["../src/define-deep-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,mBAAmB,CAgClF"}

package/dist/define-deep-agent.js

@@ -24,9 +24,26 @@
  * ```
  */
 export function defineDeepAgent(config) {
+    // Runtime enforcement of the managed-key contract. The types forbid these keys
+    // at compile time, but JS callers and untyped config can bypass that — so
+    // mirror the Python `define_deep_agent` checks here.
+    const provided = config;
+    if ("systemPrompt" in provided) {
+        throw new Error("systemPrompt is managed by MDA and cannot be set in defineDeepAgent(...). " +
+            "Write your agent's system prompt in instructions.md next to agent.ts; " +
+            "the CLI embeds it at deploy time.");
+    }
+    const managed = ["backend", "store", "checkpointer", "memory", "skills"].filter((key) => key in provided);
+    if (managed.length > 0) {
+        throw new Error(`${managed.join(", ")} ${managed.length === 1 ? "is" : "are"} owned by the ` +
+            "managed runtime and cannot be set in defineDeepAgent(...). Configure the " +
+            "sandbox under sandbox/; the store and checkpointer are wired automatically.");
+    }
+    const { disableMemory = false, ...agentConfig } = config;
     return {
         kind: "deep-agent",
-        config: config,
+        config: agentConfig,
+        disableMemory,
     };
 }
 //# sourceMappingURL=define-deep-agent.js.map

package/dist/define-deep-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-deep-agent.js","sourceRoot":"","sources":["../src/define-deep-agent.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC3D,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,MAAuC;KAChD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"define-deep-agent.js","sourceRoot":"","sources":["../src/define-deep-agent.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC3D,+EAA+E;IAC/E,0EAA0E;IAC1E,qDAAqD;IACrD,MAAM,QAAQ,GAAG,MAAiC,CAAC;IAEnD,IAAI,cAAc,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,4EAA4E;YAC1E,wEAAwE;YACxE,mCAAmC,CACtC,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAI,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAW,CAAC,MAAM,CACxF,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,QAAQ,CACzB,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,gBAAgB;YAC1E,2EAA2E;YAC3E,6EAA6E,CAChF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,aAAa,GAAG,KAAK,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC;IAEzD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,WAA4C;QACpD,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { defineDeepAgent } from "./define-deep-agent.js";
+export { defineMcpServers } from "./connectors.js";
 export { defineSandbox } from "./sandbox.js";
+export type { HttpMcpServerConfig, McpServersConfig, McpServersDefinition, RemoteMcpServerConfig, SseMcpServerConfig, } from "./connectors.js";
 export type { ChannelAttachment, ChannelDestination, ChannelEvent, ChannelMessage, ChannelPostOptions, DeepAgentDefinition, DefineDeepAgentConfig, ManagedDeepAgentKey, PostedChannelMessage, Runtime, RuntimeChannel, } from "./types.js";
 export type { DefineSandboxOptions, ManagedSandboxOptionKey, SandboxDefinition, SandboxProviderClass, SandboxProviderOptions, SandboxScope, } from "./sandbox.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,EACP,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,EACP,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { defineDeepAgent } from "./define-deep-agent.js";
+export { defineMcpServers } from "./connectors.js";
 export { defineSandbox } from "./sandbox.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { McpServersDefinition } from "../connectors.js";
+/**
+ * Load (and cache) the MCP tools declared in `connectors/mcp.ts`.
+ *
+ * A failed load is never cached, so a transient connection error on the first
+ * run can be retried on the next, but a misconfigured deployment surfaces the
+ * error rather than silently starting with no tools.
+ */
+export declare function loadManagedMcpTools(connectors: McpServersDefinition): Promise<unknown[]>;
+/** Clear the process-level MCP tool cache. Test-only. */
+export declare function clearManagedMcpToolsCacheForTests(): void;
+//# sourceMappingURL=connectors-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connectors-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/connectors-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAa7D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAQxF;AAED,yDAAyD;AACzD,wBAAgB,iCAAiC,IAAI,IAAI,CAExD"}

package/dist/runtime/connectors-manager.js

@@ -0,0 +1,77 @@
+import { MultiServerMCPClient } from "@langchain/mcp-adapters";
+/**
+ * MCP tools loaded for this runtime process, cached for its lifetime.
+ *
+ * The compiled entry's graph factory runs `compileManagedAgent` on every
+ * invocation, but the MCP connection and tool surface are stable for the life
+ * of the deployment — so the client is created and its tools loaded exactly
+ * once, and every subsequent run reuses them. Storing the in-flight promise
+ * also dedupes concurrent first runs.
+ */
+let cachedTools;
+/**
+ * Load (and cache) the MCP tools declared in `connectors/mcp.ts`.
+ *
+ * A failed load is never cached, so a transient connection error on the first
+ * run can be retried on the next, but a misconfigured deployment surfaces the
+ * error rather than silently starting with no tools.
+ */
+export function loadManagedMcpTools(connectors) {
+    if (!cachedTools) {
+        cachedTools = createClientAndLoadTools(connectors).catch((error) => {
+            cachedTools = undefined;
+            throw error;
+        });
+    }
+    return cachedTools;
+}
+/** Clear the process-level MCP tool cache. Test-only. */
+export function clearManagedMcpToolsCacheForTests() {
+    cachedTools = undefined;
+}
+/**
+ * Create the `@langchain/mcp-adapters` client from the declaration and load its
+ * tools, applying the managed defaults the spec recommends.
+ *
+ * `@langchain/mcp-adapters` is a direct dependency of `managed-deepagents`, so
+ * the client is imported statically at the top of the module.
+ */
+async function createClientAndLoadTools(connectors) {
+    const prefixToolNameWithServerName = connectors.prefixToolNameWithServerName ?? true;
+    const client = new MultiServerMCPClient({
+        mcpServers: connectors.mcpServers,
+        prefixToolNameWithServerName,
+        throwOnLoadError: connectors.throwOnLoadError ?? true,
+        useStandardContentBlocks: connectors.useStandardContentBlocks ?? true,
+        onConnectionError: connectors.onConnectionError ?? "throw",
+    });
+    const tools = await client.getTools();
+    // When prefixing is disabled, names can collide with authored tools or across
+    // servers. The spec only allows opting out if MDA validates no collisions.
+    if (!prefixToolNameWithServerName) {
+        assertNoToolNameCollisions(tools);
+    }
+    return tools;
+}
+/**
+ * Reject duplicate tool names among the loaded MCP tools. Only reached when the
+ * author opted out of server-name prefixing.
+ */
+function assertNoToolNameCollisions(tools) {
+    const seen = new Set();
+    const collisions = new Set();
+    for (const tool of tools) {
+        const name = tool.name;
+        if (typeof name !== "string")
+            continue;
+        if (seen.has(name))
+            collisions.add(name);
+        seen.add(name);
+    }
+    if (collisions.size > 0) {
+        throw new Error(`MCP tool name collision: ${[...collisions].sort().join(", ")}. ` +
+            "Set `prefixToolNameWithServerName: true` (the default) so each tool is " +
+            "namespaced by its server, or rename the conflicting tools.");
+    }
+}
+//# sourceMappingURL=connectors-manager.js.map

package/dist/runtime/connectors-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors-manager.js","sourceRoot":"","sources":["../../src/runtime/connectors-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAI/D;;;;;;;;GAQG;AACH,IAAI,WAA2C,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAgC;IAClE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACjE,WAAW,GAAG,SAAS,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,iCAAiC;IAC/C,WAAW,GAAG,SAAS,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,wBAAwB,CAAC,UAAgC;IACtE,MAAM,4BAA4B,GAAG,UAAU,CAAC,4BAA4B,IAAI,IAAI,CAAC;IAErF,MAAM,MAAM,GAAG,IAAI,oBAAoB,CAAC;QACtC,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,4BAA4B;QAC5B,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,IAAI,IAAI;QACrD,wBAAwB,EAAE,UAAU,CAAC,wBAAwB,IAAI,IAAI;QACrE,iBAAiB,EAAE,UAAU,CAAC,iBAAiB,IAAI,OAAO;KAC3D,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEtC,8EAA8E;IAC9E,2EAA2E;IAC3E,IAAI,CAAC,4BAA4B,EAAE,CAAC;QAClC,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,0BAA0B,CAAC,KAAgB;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAI,IAA2B,CAAC,IAAI,CAAC;QAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,4BAA4B,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC/D,yEAAyE;YACzE,4DAA4D,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/runtime/index.d.ts

@@ -5,10 +5,172 @@ export { announceSandboxPlan } from "./sandbox-manager.js";
 /**
  * Compile a {@link DeepAgentDefinition} into a runnable Deep Agent.
  *
- * This is the seam where MDA injects the platform-owned backend (the configured
- * sandbox), the system prompt embedded from `instructions.md`, and — in a later
- * milestone — the managed store and checkpointer. It is consumed only by the
- * entry module that `mda deploy` generates; agent authors never call it.
+ * This is the seam where MDA injects platform-owned runtime configuration:
+ * Context Hub-backed deployed context, the configured sandbox, StateBackend
+ * scratch fallback, and managed memory/skills. It is consumed only by the
+ * generated entry module; agent authors never call it.
  */
-export declare function compileManagedAgent(definition: DeepAgentDefinition, config?: ManagedRunConfig, options?: ManagedAgentOptions): Promise<unknown>;
+export declare function compileManagedAgent(definition: DeepAgentDefinition, config?: ManagedRunConfig, options?: ManagedAgentOptions): Promise<import("deepagents").DeepAgent<import("deepagents").DeepAgentTypeConfig<import("langchain").ResponseFormatUndefined, undefined, import("@langchain/core/utils/types").InteropZodObject, readonly [import("langchain").AgentMiddleware<import("zod/v3").ZodObject<{
+    todos: import("zod/v3").ZodDefault<import("zod/v3").ZodArray<import("zod/v3").ZodObject<{
+        content: import("zod/v3").ZodString;
+        status: import("zod/v3").ZodEnum<["pending", "in_progress", "completed"]>;
+    }, "strip", import("zod/v3").ZodTypeAny, {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }, {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }>, "many">>;
+}, "strip", import("zod/v3").ZodTypeAny, {
+    todos: {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }[];
+}, {
+    todos?: {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }[] | undefined;
+}>, undefined, unknown, readonly [import("langchain").DynamicStructuredTool<import("zod/v3").ZodObject<{
+    todos: import("zod/v3").ZodArray<import("zod/v3").ZodObject<{
+        content: import("zod/v3").ZodString;
+        status: import("zod/v3").ZodEnum<["pending", "in_progress", "completed"]>;
+    }, "strip", import("zod/v3").ZodTypeAny, {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }, {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }>, "many">;
+}, "strip", import("zod/v3").ZodTypeAny, {
+    todos: {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }[];
+}, {
+    todos: {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }[];
+}>, {
+    todos: {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }[];
+}, {
+    todos: {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }[];
+}, import("@langchain/langgraph").Command<unknown, {
+    todos: {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+    }[];
+    messages: import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>[];
+}, string>, unknown, "write_todos">], readonly []>, import("langchain").AgentMiddleware<import("@langchain/langgraph").StateSchema<{
+    files: import("@langchain/langgraph").ReducedValue<{
+        [x: string]: import("deepagents").FileData;
+    } | undefined, {
+        [x: string]: import("deepagents").FileData | null;
+    } | undefined>;
+}>, undefined, unknown, (import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
+    path: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
+}, import("zod/v4/core").$strip>, {
+    path: string;
+}, {
+    path?: string | undefined;
+}, string, unknown, "ls"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
+    file_path: import("zod").ZodString;
+    offset: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodCoercedNumber<unknown>>>;
+    limit: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodCoercedNumber<unknown>>>;
+}, import("zod/v4/core").$strip>, {
+    file_path: string;
+    offset: number;
+    limit: number;
+}, {
+    file_path: string;
+    offset?: unknown;
+    limit?: unknown;
+}, {
+    type: string;
+    text: string;
+}[] | {
+    type: string;
+    mimeType: string;
+    data: string;
+}[], unknown, "read_file"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
+    file_path: import("zod").ZodString;
+    content: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, {
+    file_path: string;
+    content: string;
+}, {
+    file_path: string;
+    content?: string | undefined;
+}, string | import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>> | import("@langchain/langgraph").Command<unknown, {
+    files: Record<string, import("deepagents").FileData>;
+    messages: import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>[];
+}, string>, unknown, "write_file"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
+    file_path: import("zod").ZodString;
+    old_string: import("zod").ZodString;
+    new_string: import("zod").ZodString;
+    replace_all: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+}, import("zod/v4/core").$strip>, {
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all: boolean;
+}, {
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}, string | import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>> | import("@langchain/langgraph").Command<unknown, {
+    files: Record<string, import("deepagents").FileData>;
+    messages: import("langchain").ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>[];
+}, string>, unknown, "edit_file"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
+    pattern: import("zod").ZodString;
+    path: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
+}, import("zod/v4/core").$strip>, {
+    pattern: string;
+    path: string;
+}, {
+    pattern: string;
+    path?: string | undefined;
+}, string, unknown, "glob"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
+    pattern: import("zod").ZodString;
+    path: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodString>>;
+    glob: import("zod").ZodDefault<import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>>;
+}, import("zod/v4/core").$strip>, {
+    pattern: string;
+    path: string;
+    glob: string | null;
+}, {
+    pattern: string;
+    path?: string | undefined;
+    glob?: string | null | undefined;
+}, string, unknown, "grep"> | import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
+    command: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, {
+    command: string;
+}, {
+    command: string;
+}, string, unknown, "execute">)[], readonly []>, import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly [import("langchain").DynamicStructuredTool<import("zod").ZodObject<{
+    description: import("zod").ZodString;
+    subagent_type: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, {
+    description: string;
+    subagent_type: string;
+}, {
+    description: string;
+    subagent_type: string;
+}, string | import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>, unknown, "task">], readonly []>, import("langchain").AgentMiddleware<import("zod").ZodObject<{
+    _summarizationSessionId: import("zod").ZodOptional<import("zod").ZodString>;
+    _summarizationEvent: import("zod").ZodOptional<import("zod").ZodObject<{
+        cutoffIndex: import("zod").ZodNumber;
+        summaryMessage: import("zod").ZodCustom<import("langchain").HumanMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>, import("langchain").HumanMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>>;
+        filePath: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, undefined, unknown, readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[], readonly []>, import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[], readonly []>], readonly [], readonly [], readonly []>>>;
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAExE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,mBAAmB,EAC/B,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,mBAAmB,oBAgB9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAExE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,mBAAmB,EAC/B,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2YAmD9B"}

package/dist/runtime/index.js

@@ -1,25 +1,244 @@
-import { createDeepAgent } from "deepagents";
+import { CompositeBackend, ContextHubBackend, StateBackend, createDeepAgent } from "deepagents";
+import { loadManagedMcpTools } from "./connectors-manager.js";
 import { resolveManagedSandbox } from "./sandbox-manager.js";
 export { announceSandboxPlan } from "./sandbox-manager.js";
 /**
  * Compile a {@link DeepAgentDefinition} into a runnable Deep Agent.
  *
- * This is the seam where MDA injects the platform-owned backend (the configured
- * sandbox), the system prompt embedded from `instructions.md`, and — in a later
- * milestone — the managed store and checkpointer. It is consumed only by the
- * entry module that `mda deploy` generates; agent authors never call it.
+ * This is the seam where MDA injects platform-owned runtime configuration:
+ * Context Hub-backed deployed context, the configured sandbox, StateBackend
+ * scratch fallback, and managed memory/skills. It is consumed only by the
+ * generated entry module; agent authors never call it.
  */
 export async function compileManagedAgent(definition, config, options) {
-    const { systemPrompt, sandbox, setupScript } = options ?? {};
+    const { systemPrompt, contextRepo, hasSkills = false, sandbox, setupScript, connectors } = options ?? {};
     const params = {
         ...definition.config,
-        ...(systemPrompt !== undefined ? { systemPrompt } : {}),
     };
-    // TODO(mda): inject the managed { store, checkpointer } here, scoped by
-    // `config.configurable.identity` / `thread_id`.
-    if (sandbox) {
-        params.backend = await resolveManagedSandbox(sandbox, setupScript, config);
+    /**
+     * Loading MCP connector tools is an independent network round-trip, so kick
+     * it off up front and let it run concurrently with backend resolution below.
+     *
+     * Connectors: MCP tools declared in `connectors/mcp.ts` are appended to the
+     * authored tools. The author never imports the MCP client or calls
+     * `getTools()` — MDA owns the client lifecycle.
+     */
+    const mcpToolsPromise = connectors ? loadManagedMcpTools(connectors) : undefined;
+    const sandboxBackend = sandbox ? managedSandboxBackend(sandbox, setupScript, config) : undefined;
+    if (contextRepo) {
+        const contextBackend = new ContextHubBackend(contextRepo);
+        const hubPrompt = await readInstructions(contextBackend);
+        if (hubPrompt !== undefined) {
+            params.systemPrompt = hubPrompt;
+        }
+        params.backend = managedContextBackend(contextBackend, sandboxBackend);
+        params.permissions = managedContextPermissions(params.permissions);
+        if (hasSkills) {
+            params.skills = ["/skills/"];
+        }
+        if (!definition.disableMemory) {
+            params.memory = ["/memories/AGENTS.md"];
+        }
+    }
+    else {
+        if (systemPrompt !== undefined) {
+            params.systemPrompt = systemPrompt;
+        }
+        if (sandboxBackend) {
+            params.backend = sandboxBackend;
+        }
+    }
+    const mcpTools = await mcpToolsPromise;
+    if (mcpTools) {
+        const authoredTools = Array.isArray(params.tools) ? params.tools : [];
+        params.tools = [...authoredTools, ...mcpTools];
     }
     return createDeepAgent(params);
 }
+async function readInstructions(backend) {
+    const result = await backend.read("/instructions.md");
+    if (result.error || result.content === undefined) {
+        return undefined;
+    }
+    if (typeof result.content === "string") {
+        return result.content;
+    }
+    return new TextDecoder().decode(result.content);
+}
+function managedSandboxBackend(sandbox, setupScript, graphConfig) {
+    return (runtime) => resolveManagedSandbox(sandbox, setupScript, managedConfigFromRuntime(runtime) ?? graphConfig);
+}
+function managedContextBackend(contextBackend, sandboxBackend) {
+    // `ContextHubPathBackend` duck-types the backend protocol with intentionally
+    // looser return types, so cast at this boundary to the real backend types.
+    const routes = managedContextRoutes(contextBackend);
+    if (sandboxBackend) {
+        return async (runtime) => new CompositeBackend((await resolveBackendFactory(sandboxBackend, runtime)), routes);
+    }
+    return () => new CompositeBackend(new StateBackend(), routes);
+}
+function managedContextRoutes(contextBackend) {
+    return {
+        "/instructions.md": ContextHubPathBackend.file(contextBackend, "instructions.md", "/instructions.md"),
+        "/skills/": ContextHubPathBackend.directory(contextBackend, "skills", "/skills"),
+        "/memories/": ContextHubPathBackend.directory(contextBackend, "memories", "/memories"),
+    };
+}
+class ContextHubPathBackend {
+    backend;
+    target;
+    constructor(backend, target) {
+        this.backend = backend;
+        this.target = target;
+    }
+    static directory(backend, repoPrefix, visiblePrefix) {
+        return new ContextHubPathBackend(backend, {
+            repoPrefix: trimSlashes(repoPrefix),
+            visiblePrefix: stripTrailingSlash(ensureAbsolute(visiblePrefix)),
+        });
+    }
+    static file(backend, repoFile, visibleFile) {
+        return new ContextHubPathBackend(backend, {
+            repoFile: trimSlashes(repoFile),
+            visibleFile: ensureAbsolute(visibleFile),
+        });
+    }
+    async ls(path = "/") {
+        const result = await this.required("ls")(this.toRepoPath(path));
+        return this.remapPathCollections(result);
+    }
+    async read(filePath, offset, limit) {
+        return this.backend.read(this.toRepoPath(filePath), offset, limit);
+    }
+    async readRaw(filePath) {
+        return this.required("readRaw")(this.toRepoPath(filePath));
+    }
+    async grep(pattern, path, glob) {
+        const result = await this.required("grep")(pattern, path === undefined || path === null ? path : this.toRepoPath(path), glob ? this.toRepoGlob(glob) : glob);
+        return this.remapPathCollections(result);
+    }
+    async glob(pattern, path = "/") {
+        const result = await this.required("glob")(this.toRepoGlob(pattern), this.toRepoPath(path));
+        return this.remapPathCollections(result);
+    }
+    async write(filePath, content) {
+        const result = await this.required("write")(this.toRepoPath(filePath), content);
+        return this.withVisiblePath(result, filePath);
+    }
+    async edit(filePath, oldString, newString, replaceAll = false) {
+        const result = await this.required("edit")(this.toRepoPath(filePath), oldString, newString, replaceAll);
+        return this.withVisiblePath(result, filePath);
+    }
+    async uploadFiles(files) {
+        const result = await this.required("uploadFiles")(files.map(([path, content]) => [this.toRepoPath(path), content]));
+        return result.map((entry, index) => this.withVisiblePath(entry, files[index]?.[0] ?? "/"));
+    }
+    async downloadFiles(paths) {
+        const result = await this.required("downloadFiles")(paths.map((path) => this.toRepoPath(path)));
+        return result.map((entry, index) => this.withVisiblePath(entry, paths[index] ?? "/"));
+    }
+    required(method) {
+        const fn = this.backend[method];
+        if (typeof fn !== "function") {
+            throw new Error(`Context Hub backend does not support ${String(method)}`);
+        }
+        return fn.bind(this.backend);
+    }
+    toRepoPath(path) {
+        if ("repoFile" in this.target) {
+            return ensureAbsolute(this.target.repoFile);
+        }
+        const suffix = trimSlashes(path);
+        const joined = suffix ? `${this.target.repoPrefix}/${suffix}` : this.target.repoPrefix;
+        return ensureAbsolute(joined);
+    }
+    toRepoGlob(pattern) {
+        if ("repoFile" in this.target) {
+            return pattern;
+        }
+        const suffix = trimSlashes(pattern);
+        return suffix ? `${this.target.repoPrefix}/${suffix}` : this.target.repoPrefix;
+    }
+    remapPathCollections(result) {
+        const copy = { ...result };
+        remapPathArray(copy, "files", (path) => this.fromRepoPath(path));
+        remapPathArray(copy, "entries", (path) => this.fromRepoPath(path));
+        remapPathArray(copy, "matches", (path) => this.fromRepoPath(path));
+        return copy;
+    }
+    withVisiblePath(result, backendPath) {
+        if (!("path" in result)) {
+            return result;
+        }
+        return { ...result, path: this.toVisiblePath(backendPath) };
+    }
+    fromRepoPath(path) {
+        const normalized = ensureAbsolute(path);
+        if ("repoFile" in this.target) {
+            return normalized === ensureAbsolute(this.target.repoFile) ? "/" : normalized;
+        }
+        const prefix = ensureAbsolute(this.target.repoPrefix);
+        if (normalized === prefix) {
+            return "/";
+        }
+        if (normalized.startsWith(`${prefix}/`)) {
+            return ensureAbsolute(normalized.slice(prefix.length));
+        }
+        return normalized;
+    }
+    toVisiblePath(path) {
+        if ("visibleFile" in this.target) {
+            return this.target.visibleFile;
+        }
+        const suffix = trimSlashes(path);
+        return suffix
+            ? `${this.target.visiblePrefix}/${suffix}`
+            : this.target.visiblePrefix;
+    }
+}
+async function resolveBackendFactory(backend, runtime) {
+    return typeof backend === "function" ? await backend(runtime) : backend;
+}
+function managedContextPermissions(existing) {
+    const managed = [
+        {
+            operations: ["write"],
+            paths: ["/instructions.md", "/skills/**"],
+            mode: "deny",
+        },
+    ];
+    return Array.isArray(existing) ? [...managed, ...existing] : managed;
+}
+function managedConfigFromRuntime(runtime) {
+    const rt = runtime;
+    if (rt.config) {
+        return rt.config;
+    }
+    if (rt.configurable) {
+        return { configurable: rt.configurable };
+    }
+    return undefined;
+}
+function remapPathArray(result, key, remap) {
+    const value = result[key];
+    if (!Array.isArray(value)) {
+        return;
+    }
+    result[key] = value.map((entry) => {
+        if (!entry || typeof entry !== "object") {
+            return entry;
+        }
+        const item = entry;
+        return typeof item.path === "string" ? { ...item, path: remap(item.path) } : item;
+    });
+}
+function ensureAbsolute(path) {
+    return `/${trimSlashes(path)}`;
+}
+function trimSlashes(path) {
+    return path.replace(/^\/+|\/+$/g, "");
+}
+function stripTrailingSlash(path) {
+    return path.length > 1 ? path.replace(/\/+$/g, "") : path;
+}
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAA+B,EAC/B,MAAyB,EACzB,OAA6B;IAE7B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAE7D,MAAM,MAAM,GAA4B;QACtC,GAAG,UAAU,CAAC,MAAM;QACpB,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAC;IAEF,wEAAwE;IACxE,gDAAgD;IAChD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,OAAO,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,12 @@
 import type { SandboxDefinition } from "../sandbox.js";
 import type { ManagedRunConfig, ManagedSandboxBackend } from "./types.js";
+type LangSmithSandboxClientLoader = () => Promise<{
+    SandboxClient: new (options?: {
+        apiKey?: string;
+    }) => {
+        createSandbox(options?: Record<string, unknown>): Promise<unknown>;
+    };
+}>;
 /**
  * Resolve (and cache) the scoped sandbox backend for this run, provisioning it
  * with `setup.sh` the first time it is created.
@@ -12,6 +19,8 @@ export declare function resolveManagedSandbox(sandbox: SandboxDefinition, setupS
 export declare function sandboxScopeKey(sandbox: SandboxDefinition, config: ManagedRunConfig | undefined): string;
 /** Clear the process-level sandbox cache. Test-only. */
 export declare function clearManagedSandboxCacheForTests(): void;
+/** Override the LangSmith SDK loader. Test-only. */
+export declare function setLangSmithSandboxClientLoaderForTests(loader?: LangSmithSandboxClientLoader): void;
 /**
  * Eagerly resolve the `mda dev` sandbox at startup so the developer sees the
  * definitive decision — local vs. the configured provider, and the temp dir
@@ -27,4 +36,5 @@ export declare function clearManagedSandboxCacheForTests(): void;
  * No-op outside `mda dev`, so the generated entry can always call it.
  */
 export declare function announceSandboxPlan(sandbox: SandboxDefinition, setupScript?: string): Promise<void>;
+export {};
 //# sourceMappingURL=sandbox-manager.d.ts.map

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":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAoB1E;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAYhC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,MAAM,CAcR;AAED,wDAAwD;AACxD,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"sandbox-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/sandbox-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAoB1E,KAAK,4BAA4B,GAAG,MAAM,OAAO,CAAC;IAChD,aAAa,EAAE,KAAK,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QACpD,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACpE,CAAC;CACH,CAAC,CAAC;AAaH;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAYhC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,MAAM,CAcR;AAED,wDAAwD;AACxD,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAED,oDAAoD;AACpD,wBAAgB,uCAAuC,CACrD,MAAM,CAAC,EAAE,4BAA4B,GACpC,IAAI,CAEN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/runtime/sandbox-manager.js

@@ -1,4 +1,4 @@
-import { isDevMode, providerCredentialStatus } from "./credentials.js";
+import { isDevMode, providerCredentialStatus, providerKey } from "./credentials.js";
 import { logDevSandboxNoticeOnce } from "./dev-notice.js";
 import { createLocalDevSandbox } from "./local-dev-sandbox.js";
 import { runSetupScript, runSetupScriptInline } from "./setup-script.js";
@@ -18,6 +18,11 @@ const managedSandboxes = new Map();
  * reuse it instead of provisioning a second one.
  */
 const DEV_SANDBOX_SCOPE_KEY = "__mda_dev__";
+const defaultLangSmithSandboxClientLoader = async () => {
+    const dynamicImport = new Function("specifier", "return import(specifier)");
+    return (await dynamicImport("langsmith/sandbox"));
+};
+let langSmithSandboxClientLoader = defaultLangSmithSandboxClientLoader;
 /**
  * Resolve (and cache) the scoped sandbox backend for this run, provisioning it
  * with `setup.sh` the first time it is created.
@@ -56,6 +61,10 @@ export function sandboxScopeKey(sandbox, config) {
 export function clearManagedSandboxCacheForTests() {
     managedSandboxes.clear();
 }
+/** Override the LangSmith SDK loader. Test-only. */
+export function setLangSmithSandboxClientLoaderForTests(loader) {
+    langSmithSandboxClientLoader = loader ?? defaultLangSmithSandboxClientLoader;
+}
 /**
  * Eagerly resolve the `mda dev` sandbox at startup so the developer sees the
  * definitive decision — local vs. the configured provider, and the temp dir
@@ -82,14 +91,14 @@ function createManagedSandbox(sandbox, setupScript) {
     // silently downgraded to local shell execution.
     return isDevMode()
         ? createDevSandbox(sandbox, setupScript)
-        : createProviderSandbox(sandbox, setupScript);
+        : createProviderSandbox(sandbox, setupScript, { useDefaultLangSmithRuntime: true });
 }
 /**
  * Production path: construct the configured provider's sandbox and provision it.
  * Any failure propagates — a misconfigured deployment must surface, not degrade.
  */
-async function createProviderSandbox(sandbox, setupScript) {
-    const backend = await createProviderBackend(sandbox);
+async function createProviderSandbox(sandbox, setupScript, options) {
+    const backend = await createProviderBackend(sandbox, options);
     if (setupScript && setupScript.trim().length > 0) {
         await runSetupScript(backend, setupScript);
     }
@@ -107,7 +116,9 @@ async function createDevSandbox(sandbox, setupScript) {
     const cred = providerCredentialStatus(sandbox.provider);
     if (cred.status !== "missing") {
         try {
-            const backend = await createProviderSandbox(sandbox, setupScript);
+            const backend = await createProviderSandbox(sandbox, setupScript, {
+                useDefaultLangSmithRuntime: false,
+            });
             logDevSandboxNoticeOnce(cred.status === "available"
                 ? `[mda dev] using the configured ${cred.provider} sandbox.`
                 : `[mda dev] using the configured sandbox provider (${cred.provider}).`);
@@ -131,12 +142,37 @@ async function createLocalSandbox(setupScript, reason) {
     return backend;
 }
 /** Construct the configured provider's backend, stripping MDA-managed knobs. */
-async function createProviderBackend(sandbox) {
+async function createProviderBackend(sandbox, options) {
+    if (options.useDefaultLangSmithRuntime && providerKey(sandbox.provider) === "LangSmithSandbox") {
+        return createLangSmithSandboxBackend(sandbox);
+    }
     const { scope: _scope, idleTtlSeconds: _idleTtlSeconds, ...providerOptions } = sandbox.options ?? {};
     void _scope;
     void _idleTtlSeconds;
     return (await sandbox.provider.create(providerOptions));
 }
+async function createLangSmithSandboxBackend(sandbox) {
+    const { scope: _scope, apiKey = process.env.LANGSMITH_API_KEY, defaultTimeout, templateName, snapshotId, ...createSandboxOptions } = sandbox.options ?? {};
+    void _scope;
+    if (snapshotId && templateName) {
+        throw new Error("snapshotId and templateName are mutually exclusive. Pass only one creation source.");
+    }
+    if (templateName) {
+        createSandboxOptions.snapshotName = templateName;
+    }
+    const { SandboxClient } = await langSmithSandboxClientLoader();
+    if (snapshotId) {
+        createSandboxOptions.snapshotId = snapshotId;
+    }
+    const sdkOptions = stringOption(apiKey);
+    const client = new SandboxClient(sdkOptions ? { apiKey: sdkOptions } : undefined);
+    const langSmithSandbox = await client.createSandbox(createSandboxOptions);
+    const Backend = sandbox.provider;
+    return new Backend({ sandbox: langSmithSandbox, defaultTimeout });
+}
+function stringOption(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/dist/runtime/sandbox-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox-manager.js","sourceRoot":"","sources":["../../src/runtime/sandbox-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzE;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA0C,CAAC;AAE3E;;;;;;;;GAQG;AACH,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA0B,EAC1B,WAA+B,EAC/B,MAAoC;IAEpC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnF,IAAI,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACnE,sEAAsE;YACtE,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA0B,EAC1B,MAAoC;IAEpC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,YAAY,IAAI,EAAE,CAG/C,CAAC;IACF,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,QAAQ,CAAC;IAEjD,IAAI,GAAuB,CAAC;IAC5B,IAAI,KAAK,KAAK,QAAQ;QAAE,GAAG,GAAG,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;SAC9C,IAAI,KAAK,KAAK,OAAO;QAAE,GAAG,GAAG,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC;;QACjD,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC;IAElC,OAAO,GAAG,IAAI,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,YAAY,CAAC,SAAS,IAAI,SAAS,CAAC;AACnG,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,gCAAgC;IAC9C,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA0B,EAC1B,WAAoB;IAEpB,IAAI,CAAC,SAAS,EAAE;QAAE,OAAO;IACzB,MAAM,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,oBAAoB,CAC3B,OAA0B,EAC1B,WAA+B;IAE/B,2EAA2E;IAC3E,8EAA8E;IAC9E,2EAA2E;IAC3E,gDAAgD;IAChD,OAAO,SAAS,EAAE;QAChB,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC;QACxC,CAAC,CAAC,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAClC,OAA0B,EAC1B,WAA+B;IAE/B,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,gBAAgB,CAC7B,OAA0B,EAC1B,WAA+B;IAE/B,MAAM,IAAI,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAExD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAClE,uBAAuB,CACrB,IAAI,CAAC,MAAM,KAAK,WAAW;gBACzB,CAAC,CAAC,kCAAkC,IAAI,CAAC,QAAQ,WAAW;gBAC5D,CAAC,CAAC,oDAAoD,IAAI,CAAC,QAAQ,IAAI,CAC1E,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,kBAAkB,CACvB,WAAW,EACX,kBAAkB,IAAI,CAAC,QAAQ,gCAAgC;gBAC7D,IAAI,YAAY,CAAC,KAAK,CAAC,8CAA8C,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC;IACtE,OAAO,kBAAkB,CACvB,WAAW,EACX,6DAA6D,IAAI,CAAC,QAAQ,KAAK;QAC7E,mDAAmD,OAAO,YAAY,CACzE,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,KAAK,UAAU,kBAAkB,CAC/B,WAA+B,EAC/B,MAAc;IAEd,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,KAAK,UAAU,qBAAqB,CAAC,OAA0B;IAC7D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACrG,KAAK,MAAM,CAAC;IACZ,KAAK,eAAe,CAAC;IACrB,OAAO,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,CAA0B,CAAC;AACnF,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"sandbox-manager.js","sourceRoot":"","sources":["../../src/runtime/sandbox-manager.ts"],"names":[],"mappings":"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"}

package/dist/runtime/types.d.ts

@@ -1,3 +1,4 @@
+import type { McpServersDefinition } from "../connectors.js";
 import type { SandboxDefinition } from "../sandbox.js";
 /**
  * The LangGraph runnable config passed to a graph factory at invocation time.
@@ -12,12 +13,18 @@ export interface ManagedRunConfig {
 /**
  * Managed values the CLI injects into the generated entry module.
  *
- * The system prompt is embedded from `instructions.md` at deploy time, and the
- * sandbox definition + `setup.sh` come from the project's `sandbox/` folder, so
- * they live here rather than in the authored {@link DeepAgentDefinition}.
+ * Local build/dev entries may embed the system prompt directly. Deploy entries
+ * pass Context Hub metadata so the runtime can read deployed instructions,
+ * skills, and memories from the Hub repo.
  */
 export interface ManagedAgentOptions {
     systemPrompt?: string;
+    /** Context Hub repo handle for deployed runtime context. */
+    contextRepo?: string;
+    /** Latest synced Context Hub commit hash, used as deploy metadata. */
+    contextCommit?: string;
+    /** Whether the synced Context Hub repo contains deploy-owned skills. */
+    hasSkills?: boolean;
     /** The `sandbox/index.ts` declaration, if the project configures a sandbox. */
     sandbox?: SandboxDefinition;
     /**
@@ -25,6 +32,11 @@ export interface ManagedAgentOptions {
      * the first time a sandbox is provisioned for a given scope.
      */
     setupScript?: string;
+    /**
+     * The `connectors/mcp.ts` declaration, if the project declares MCP servers.
+     * The runtime loads their tools and appends them to the agent's tools.
+     */
+    connectors?: McpServersDefinition;
 }
 /**
  * The subset of a created sandbox backend the managed runtime relies on to run

package/dist/runtime/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAChE,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAChE,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE"}

package/dist/types.d.ts

@@ -1,10 +1,10 @@
 import type { CreateDeepAgentParams } from "deepagents";
 /**
  * Properties the managed runtime owns. Agent authors never set these — MDA
- * wires the backend, store, and checkpointer at deploy time, and embeds the
- * system prompt from `instructions.md`.
+ * wires the backend, store, checkpointer, memory, skills, and system prompt at
+ * deploy time.
  */
-export type ManagedDeepAgentKey = "backend" | "store" | "checkpointer" | "systemPrompt";
+export type ManagedDeepAgentKey = "backend" | "store" | "checkpointer" | "systemPrompt" | "memory" | "skills";
 /**
  * Configuration accepted by {@link defineDeepAgent}.
  *
@@ -19,11 +19,20 @@ export type DefineDeepAgentConfig = Omit<CreateDeepAgentParams, ManagedDeepAgent
     store?: never;
     /** Managed: the runtime owns the checkpointer. */
     checkpointer?: never;
+    /** Managed: agent memory is stored under Context Hub `memories/`. */
+    memory?: never;
+    /** Managed: skills are loaded from Context Hub `skills/`. */
+    skills?: never;
     /**
      * Managed: the system prompt is embedded from `instructions.md` next to the
      * agent file at deploy time. Write your prompt there instead.
      */
     systemPrompt?: never;
+    /**
+     * Disable managed agent memory only. Scratch state, checkpointers, skills,
+     * instructions, and sandbox files still work.
+     */
+    disableMemory?: boolean;
 };
 /**
  * The pre-runtime spec returned by {@link defineDeepAgent}.
@@ -35,6 +44,7 @@ export type DefineDeepAgentConfig = Omit<CreateDeepAgentParams, ManagedDeepAgent
 export interface DeepAgentDefinition {
     readonly kind: "deep-agent";
     readonly config: Omit<CreateDeepAgentParams, ManagedDeepAgentKey>;
+    readonly disableMemory: boolean;
 }
 /**
  * Metadata about the inbound channel event that created or resumed a run.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,GAAG,cAAc,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,qBAAqB,EAAE,mBAAmB,CAAC,GAAG;IACrF,4EAA4E;IAC5E,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1E,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC5F;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,cAAc,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,OAAO,GACP,cAAc,GACd,cAAc,GACd,QAAQ,GACR,QAAQ,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,qBAAqB,EAAE,mBAAmB,CAAC,GAAG;IACrF,4EAA4E;IAC5E,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,kDAAkD;IAClD,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;IAClE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1E,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC5F;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,cAAc,CAAC;CACzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "managed-deepagents",
-  "version": "0.0.3-dev.16",
+  "version": "0.0.3-dev.18",
   "description": "Managed Deep Agents — the `defineDeepAgent` authoring interface plus the CLI that compiles and deploys a code-first Deep Agent repository to a managed LangGraph runtime.",
   "keywords": [
     "langchain",
@@ -45,21 +45,17 @@
   "engines": {
     "node": ">=18"
   },
-  "peerDependencies": {
-    "deepagents": ">=1.10.4"
-  },
-  "peerDependenciesMeta": {
-    "deepagents": {
-      "optional": true
-    }
+  "dependencies": {
+    "@langchain/mcp-adapters": "^1.1.3",
+    "deepagents": "^1.10.4"
   },
   "optionalDependencies": {
-    "@langchain/managed-deepagents-darwin-arm64": "0.0.3-dev.16",
-    "@langchain/managed-deepagents-darwin-x64": "0.0.3-dev.16",
-    "@langchain/managed-deepagents-linux-arm64": "0.0.3-dev.16",
-    "@langchain/managed-deepagents-linux-x64": "0.0.3-dev.16",
-    "@langchain/managed-deepagents-win32-x64": "0.0.3-dev.16",
-    "@langchain/managed-deepagents-win32-arm64": "0.0.3-dev.16"
+    "@langchain/managed-deepagents-darwin-arm64": "0.0.3-dev.18",
+    "@langchain/managed-deepagents-darwin-x64": "0.0.3-dev.18",
+    "@langchain/managed-deepagents-linux-arm64": "0.0.3-dev.18",
+    "@langchain/managed-deepagents-linux-x64": "0.0.3-dev.18",
+    "@langchain/managed-deepagents-win32-x64": "0.0.3-dev.18",
+    "@langchain/managed-deepagents-win32-arm64": "0.0.3-dev.18"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",