managed-deepagents 0.9.0-dev.1 → 0.9.0-dev.3

package/dist/types.d.ts

@@ -3,28 +3,55 @@ import type { ClientTool, ServerTool } from "@langchain/core/tools";
 import type { InteropZodObject } from "@langchain/core/utils/types";
 import type { AnyStateSchema } from "@langchain/langgraph";
 import type { AgentMiddleware, ResponseFormatUndefined } from "langchain";
+import type { McpServersDefinition } from "./connectors/mcp/types.js";
+import type { SandboxDefinition } from "./sandbox.js";
+import type { MemoryDefinition } from "./memory/index.js";
 /**
- * Properties the managed runtime owns. Agent authors never set these — MDA
- * wires the backend, store, checkpointer, memory, skills, and system prompt at
- * deploy time.
+ * Native Deep Agents properties whose values MDA supplies. Authors select
+ * managed resources through MDA's separate composition fields.
  */
 export type ManagedDeepAgentKey = "backend" | "store" | "checkpointer" | "systemPrompt" | "memory" | "skills";
+/** A run-local skill mounted beside selected authored skill directories. */
+export interface GeneratedSkill {
+    name: string;
+    description: string;
+    markdown: string;
+    files?: Readonly<Record<string, string>>;
+}
+/** Authored skill-directory paths and/or run-local generated skills. */
+export type SkillSelection = readonly (string | GeneratedSkill)[];
+/** MCP definitions selected for this run. */
+export type McpSelection = readonly McpServersDefinition[];
+/** MDA composition fields resolved when a factory returns its definition. */
+export interface ManagedCompositionFields {
+    /** Replaces `instructions.md`; `null` clears the authored prompt. */
+    instructions?: string | null;
+    /** Selects MCP definitions; `null` disables discovered MCP servers. */
+    mcp?: McpSelection | null;
+    /** Replaces the discovered sandbox; `null` disables it for this run. */
+    sandbox?: SandboxDefinition | null;
+    /** Selects authored or generated skills; `null` disables discovered skills. */
+    skills?: SkillSelection | null;
+    /** Selects durable-memory layers; `null` disables memory. */
+    memory?: MemoryDefinition | null;
+}
 /**
  * Configuration accepted by {@link defineDeepAgent}.
  *
- * This is the full `createDeepAgent` parameter surface minus the managed keys.
- * Setting a managed key is a compile-time error, pointing authors at the
- * managed `sandbox/`, store, checkpointer, and `instructions.md` wiring instead.
+ * This is the full `createDeepAgent` parameter surface minus native fields MDA
+ * owns, plus MDA's resource-selection fields for factory entrypoints. Static
+ * exported definitions cannot set those fields. Backend, store, checkpointer,
+ * memory, and native system prompt remain unavailable to authors.
  *
  * Type args are widened past `CreateDeepAgentParams` defaults so callers can
  * still pass `stateSchema` / `middleware` / `tools` (those default type params
  * otherwise collapse to `undefined` / empty tuples).
  */
-export type DefineDeepAgentConfig = Omit<CreateDeepAgentParams<SupportedResponseFormat, InteropZodObject, readonly AgentMiddleware[], readonly AnySubAgent[], readonly (ClientTool | ServerTool)[], readonly [], AnyStateSchema | InteropZodObject | undefined>, ManagedDeepAgentKey> & {
+export type DefineDeepAgentConfig = Omit<CreateDeepAgentParams<SupportedResponseFormat, InteropZodObject, readonly AgentMiddleware[], readonly AnySubAgent[], readonly (ClientTool | ServerTool)[], readonly [], AnyStateSchema | InteropZodObject | undefined>, ManagedDeepAgentKey> & ManagedCompositionFields & {
     /**
-     * Required agent name. Used as the LangGraph graph / assistant id and as the
-     * default LangSmith deployment name (unless `mda deploy -n` overrides it).
-     * Must be a static string matching `[a-zA-Z][a-zA-Z0-9_-]*`.
+     * Required agent name. MDA uses it as the LangGraph graph id and default
+     * deployment name. Factory entrypoints must set it with an inline string
+     * literal so `mda build` can read it without running the resolver.
      */
     name: string;
     /** Managed: the runtime owns the backend. Configure it under `sandbox/`. */
@@ -33,13 +60,9 @@ export type DefineDeepAgentConfig = Omit<CreateDeepAgentParams<SupportedResponse
     store?: never;
     /** Managed: the runtime owns the checkpointer. */
     checkpointer?: never;
-    /** Managed: durable memory is configured in `memory.ts`. */
-    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.
+     * Managed: use `instructions` in a factory entrypoint or the deployed
+     * `instructions.md` in a static entrypoint. MDA retains its platform prompt.
      */
     systemPrompt?: never;
     /**

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA6KA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "managed-deepagents",
-  "version": "0.9.0-dev.1",
+  "version": "0.9.0-dev.3",
   "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",
@@ -52,10 +52,10 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@langchain/core": "^1.2.10",
+    "@langchain/core": "^1.2.17",
     "@langchain/langgraph": "^1.4.18",
-    "@langchain/langgraph-sdk": "^1.12.0",
-    "@langchain/mcp-adapters": "^1.1.4",
+    "@langchain/langgraph-sdk": "^1.12.2",
+    "@langchain/mcp-adapters": "^2.0.1",
     "@standard-schema/spec": "^1.1.0",
     "deepagents": "^1.13.4",
     "hono": "^4.13.7",
@@ -66,12 +66,12 @@
     "zod": "^4.6.2"
   },
   "optionalDependencies": {
-    "@langchain/managed-deepagents-darwin-arm64": "0.9.0-dev.1",
-    "@langchain/managed-deepagents-darwin-x64": "0.9.0-dev.1",
-    "@langchain/managed-deepagents-linux-arm64": "0.9.0-dev.1",
-    "@langchain/managed-deepagents-linux-x64": "0.9.0-dev.1",
-    "@langchain/managed-deepagents-win32-arm64": "0.9.0-dev.1",
-    "@langchain/managed-deepagents-win32-x64": "0.9.0-dev.1"
+    "@langchain/managed-deepagents-darwin-arm64": "0.9.0-dev.3",
+    "@langchain/managed-deepagents-darwin-x64": "0.9.0-dev.3",
+    "@langchain/managed-deepagents-linux-arm64": "0.9.0-dev.3",
+    "@langchain/managed-deepagents-linux-x64": "0.9.0-dev.3",
+    "@langchain/managed-deepagents-win32-arm64": "0.9.0-dev.3",
+    "@langchain/managed-deepagents-win32-x64": "0.9.0-dev.3"
   },
   "devDependencies": {
     "@types/node": "^26.5.1",