deepagents 1.4.1 → 1.5.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as langchain9 from "langchain";
-import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, InferMiddlewareStates, InterruptOnConfig, ReactAgent, ResponseFormat, StructuredTool, SystemMessage, ToolMessage } from "langchain";
+import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, InferMiddlewareStates, InterruptOnConfig, ReactAgent, ResponseFormat, ResponseFormatUndefined, StructuredTool, SystemMessage, ToolMessage } from "langchain";
 import * as _Command from "@langchain/langgraph";
 import { AnnotationRoot, Command } from "@langchain/langgraph";
 import { z } from "zod/v4";
@@ -7,6 +7,7 @@ import * as zod_v30 from "zod/v3";
 import { z as z$1 } from "zod/v3";
 import * as _messages from "@langchain/core/messages";
 import * as zod0 from "zod";
+import { z as z$2 } from "zod";
 import * as zod_v4_core0 from "zod/v4/core";
 import { BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
 import * as _langchain_core_language_models_base0 from "@langchain/core/language_models/base";
@@ -163,17 +164,10 @@ interface BackendProtocol {
    *
    * @param filePath - Absolute file path
    * @param offset - Line offset to start reading from (0-indexed), default 0
-   * @param limit - Maximum number of lines to read, default 2000
+   * @param limit - Maximum number of lines to read, default 500
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): MaybePromise<string>;
-  /**
-   * Read file content as raw FileData.
-   *
-   * @param filePath - Absolute file path
-   * @returns Raw file content as FileData
-   */
-  readRaw(filePath: string): MaybePromise<FileData>;
   /**
    * Structured search results or error string for invalid input.
    *
@@ -387,14 +381,17 @@ declare function createFilesystemMiddleware(options?: FilesystemMiddlewareOption
 //#region src/middleware/subagents.d.ts
 /**
  * Type definitions for pre-compiled agents.
+ *
+ * @typeParam TRunnable - The type of the runnable (ReactAgent or Runnable).
+ *   When using `createAgent`, this preserves the middleware types for type inference.
  */
-interface CompiledSubAgent {
+interface CompiledSubAgent<TRunnable extends ReactAgent | Runnable = ReactAgent | Runnable> {
   /** The name of the agent */
   name: string;
   /** The description of the agent */
   description: string;
   /** The agent instance */
-  runnable: ReactAgent | Runnable;
+  runnable: TRunnable;
 }
 /**
  * Type definitions for subagents
@@ -515,13 +512,6 @@ declare class StateBackend implements BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): string;
-  /**
-   * Read file content as raw FileData.
-   *
-   * @param filePath - Absolute file path
-   * @returns Raw file content as FileData
-   */
-  readRaw(filePath: string): FileData;
   /**
    * Create a new file with content.
    * Returns WriteResult with filesUpdate to update LangGraph state.
@@ -561,6 +551,123 @@ declare class StateBackend implements BackendProtocol {
   downloadFiles(paths: string[]): FileDownloadResponse[];
 }
 //#endregion
+//#region src/middleware/memory.d.ts
+/**
+ * Options for the memory middleware.
+ */
+interface MemoryMiddlewareOptions {
+  /**
+   * Backend instance or factory function for file operations.
+   * Use a factory for StateBackend since it requires runtime state.
+   */
+  backend: BackendProtocol | BackendFactory | ((config: {
+    state: unknown;
+    store?: BaseStore;
+  }) => StateBackend);
+  /**
+   * List of memory file paths to load (e.g., ["~/.deepagents/AGENTS.md", "./.deepagents/AGENTS.md"]).
+   * Display names are automatically derived from the paths.
+   * Sources are loaded in order.
+   */
+  sources: string[];
+}
+/**
+ * Create middleware for loading agent memory from AGENTS.md files.
+ *
+ * Loads memory content from configured sources and injects into the system prompt.
+ * Supports multiple sources that are combined together.
+ *
+ * @param options - Configuration options
+ * @returns AgentMiddleware for memory loading and injection
+ *
+ * @example
+ * ```typescript
+ * const middleware = createMemoryMiddleware({
+ *   backend: new FilesystemBackend({ rootDir: "/" }),
+ *   sources: [
+ *     "~/.deepagents/AGENTS.md",
+ *     "./.deepagents/AGENTS.md",
+ *   ],
+ * });
+ * ```
+ */
+declare function createMemoryMiddleware(options: MemoryMiddlewareOptions): AgentMiddleware<z$2.ZodObject<{
+  memoryContents: z$2.ZodOptional<z$2.ZodRecord<z$2.ZodString, z$2.ZodString>>;
+}, z$2.core.$strip>, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
+//#endregion
+//#region src/middleware/skills.d.ts
+declare const MAX_SKILL_FILE_SIZE: number;
+declare const MAX_SKILL_NAME_LENGTH = 64;
+declare const MAX_SKILL_DESCRIPTION_LENGTH = 1024;
+/**
+ * Metadata for a skill per Agent Skills specification.
+ */
+interface SkillMetadata$1 {
+  /** Skill identifier (max 64 chars, lowercase alphanumeric and hyphens) */
+  name: string;
+  /** What the skill does (max 1024 chars) */
+  description: string;
+  /** Path to the SKILL.md file in the backend */
+  path: string;
+  /** License name or reference to bundled license file */
+  license?: string | null;
+  /** Environment requirements (max 500 chars) */
+  compatibility?: string | null;
+  /** Arbitrary key-value mapping for additional metadata */
+  metadata?: Record<string, string>;
+  /** List of pre-approved tools (experimental) */
+  allowedTools?: string[];
+}
+/**
+ * Options for the skills middleware.
+ */
+interface SkillsMiddlewareOptions {
+  /**
+   * Backend instance or factory function for file operations.
+   * Use a factory for StateBackend since it requires runtime state.
+   */
+  backend: BackendProtocol | BackendFactory | ((config: {
+    state: unknown;
+    store?: BaseStore;
+  }) => StateBackend);
+  /**
+   * List of skill source paths to load (e.g., ["/skills/user/", "/skills/project/"]).
+   * Paths must use POSIX conventions (forward slashes).
+   * Later sources override earlier ones for skills with the same name (last one wins).
+   */
+  sources: string[];
+}
+/**
+ * Create backend-agnostic middleware for loading and exposing agent skills.
+ *
+ * This middleware loads skills from configurable backend sources and injects
+ * skill metadata into the system prompt. It implements the progressive disclosure
+ * pattern: skill names and descriptions are shown in the prompt, but the agent
+ * reads full SKILL.md content only when needed.
+ *
+ * @param options - Configuration options
+ * @returns AgentMiddleware for skills loading and injection
+ *
+ * @example
+ * ```typescript
+ * const middleware = createSkillsMiddleware({
+ *   backend: new FilesystemBackend({ rootDir: "/" }),
+ *   sources: ["/skills/user/", "/skills/project/"],
+ * });
+ * ```
+ */
+declare function createSkillsMiddleware(options: SkillsMiddlewareOptions): AgentMiddleware<z$2.ZodObject<{
+  skillsMetadata: z$2.ZodOptional<z$2.ZodArray<z$2.ZodObject<{
+    name: z$2.ZodString;
+    description: z$2.ZodString;
+    path: z$2.ZodString;
+    license: z$2.ZodOptional<z$2.ZodNullable<z$2.ZodString>>;
+    compatibility: z$2.ZodOptional<z$2.ZodNullable<z$2.ZodString>>;
+    metadata: z$2.ZodOptional<z$2.ZodRecord<z$2.ZodString, z$2.ZodString>>;
+    allowedTools: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
+  }, z$2.core.$strip>>>;
+}, z$2.core.$strip>, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
+//#endregion
 //#region src/backends/store.d.ts
 /**
  * Backend that stores files in LangGraph's BaseStore (persistent).
@@ -629,13 +736,6 @@ declare class StoreBackend implements BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): Promise<string>;
-  /**
-   * Read file content as raw FileData.
-   *
-   * @param filePath - Absolute file path
-   * @returns Raw file content as FileData
-   */
-  readRaw(filePath: string): Promise<FileData>;
   /**
    * Create a new file with content.
    * Returns WriteResult. External storage sets filesUpdate=null.
@@ -717,13 +817,6 @@ declare class FilesystemBackend implements BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): Promise<string>;
-  /**
-   * Read file content as raw FileData.
-   *
-   * @param filePath - Absolute file path
-   * @returns Raw file content as FileData
-   */
-  readRaw(filePath: string): Promise<FileData>;
   /**
    * Create a new file with content.
    * Returns WriteResult. External storage sets filesUpdate=null.
@@ -807,13 +900,6 @@ declare class CompositeBackend implements BackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): Promise<string>;
-  /**
-   * Read file content as raw FileData.
-   *
-   * @param filePath - Absolute file path
-   * @returns Raw file content as FileData
-   */
-  readRaw(filePath: string): Promise<FileData>;
   /**
    * Structured search results or error string for invalid input.
    */
@@ -909,13 +995,6 @@ declare abstract class BaseSandbox implements SandboxBackendProtocol {
    * @returns Formatted file content with line numbers, or error message
    */
   read(filePath: string, offset?: number, limit?: number): Promise<string>;
-  /**
-   * Read file content as raw FileData.
-   *
-   * @param filePath - Absolute file path
-   * @returns Raw file content as FileData
-   */
-  readRaw(filePath: string): Promise<FileData>;
   /**
    * Structured search results or error string for invalid input.
    */
@@ -935,6 +1014,7 @@ declare abstract class BaseSandbox implements SandboxBackendProtocol {
 }
 //#endregion
 //#region src/types.d.ts
+type AnyAnnotationRoot = AnnotationRoot<any>;
 /**
  * Helper type to extract middleware from a SubAgent definition
  * Handles both mutable and readonly middleware arrays
@@ -954,6 +1034,138 @@ type InferSubAgentMiddlewareStates<T extends readonly (SubAgent | CompiledSubAge
  * Combined state type including custom middleware and subagent middleware states
  */
 type MergedDeepAgentState<TMiddleware extends readonly AgentMiddleware[], TSubagents extends readonly (SubAgent | CompiledSubAgent)[]> = InferMiddlewareStates<TMiddleware> & InferSubAgentMiddlewareStates<TSubagents>;
+/**
+ * Type bag that extends AgentTypeConfig with subagent type information.
+ *
+ * This interface bundles all the generic type parameters used throughout the deep agent system
+ * including subagent types for type-safe streaming and delegation.
+ *
+ * @typeParam TResponse - The structured response type when using `responseFormat`.
+ * @typeParam TState - The custom state schema type.
+ * @typeParam TContext - The context schema type.
+ * @typeParam TMiddleware - The middleware array type.
+ * @typeParam TTools - The combined tools type.
+ * @typeParam TSubagents - The subagents array type for type-safe streaming.
+ *
+ * @example
+ * ```typescript
+ * const agent = createDeepAgent({
+ *   middleware: [ResearchMiddleware],
+ *   subagents: [
+ *     { name: "researcher", description: "...", middleware: [CounterMiddleware] }
+ *   ] as const,
+ * });
+ *
+ * // Type inference for streaming
+ * type Types = InferDeepAgentType<typeof agent, "Subagents">;
+ * ```
+ */
+interface DeepAgentTypeConfig<TResponse extends Record<string, any> | ResponseFormatUndefined = Record<string, any> | ResponseFormatUndefined, TState extends AnyAnnotationRoot | InteropZodObject | undefined = AnyAnnotationRoot | InteropZodObject | undefined, TContext extends AnyAnnotationRoot | InteropZodObject = AnyAnnotationRoot | InteropZodObject, TMiddleware extends readonly AgentMiddleware[] = readonly AgentMiddleware[], TTools extends readonly (ClientTool | ServerTool)[] = readonly (ClientTool | ServerTool)[], TSubagents extends readonly (SubAgent | CompiledSubAgent)[] = readonly (SubAgent | CompiledSubAgent)[]> extends AgentTypeConfig<TResponse, TState, TContext, TMiddleware, TTools> {
+  /** The subagents array type for type-safe streaming */
+  Subagents: TSubagents;
+}
+/**
+ * Default type configuration for deep agents.
+ * Used when no explicit type parameters are provided.
+ */
+interface DefaultDeepAgentTypeConfig extends DeepAgentTypeConfig {
+  Response: Record<string, any>;
+  State: undefined;
+  Context: AnyAnnotationRoot;
+  Middleware: readonly AgentMiddleware[];
+  Tools: readonly (ClientTool | ServerTool)[];
+  Subagents: readonly (SubAgent | CompiledSubAgent)[];
+}
+/**
+ * DeepAgent extends ReactAgent with additional subagent type information.
+ *
+ * This type wraps ReactAgent but includes the DeepAgentTypeConfig which
+ * contains subagent types for type-safe streaming and delegation.
+ *
+ * @typeParam TTypes - The DeepAgentTypeConfig containing all type parameters
+ *
+ * @example
+ * ```typescript
+ * const agent: DeepAgent<DeepAgentTypeConfig<...>> = createDeepAgent({ ... });
+ *
+ * // Access subagent types for streaming
+ * type Subagents = InferDeepAgentSubagents<typeof agent>;
+ * ```
+ */
+type DeepAgent<TTypes extends DeepAgentTypeConfig = DeepAgentTypeConfig> = ReactAgent<TTypes> & {
+  /** Type brand for DeepAgent type inference */
+  readonly "~deepAgentTypes": TTypes;
+};
+/**
+ * Helper type to resolve a DeepAgentTypeConfig from either:
+ * - A DeepAgentTypeConfig directly
+ * - A DeepAgent instance (using `typeof agent`)
+ *
+ * @example
+ * ```typescript
+ * const agent = createDeepAgent({ ... });
+ * type Types = ResolveDeepAgentTypeConfig<typeof agent>;
+ * ```
+ */
+type ResolveDeepAgentTypeConfig<T> = T extends {
+  "~deepAgentTypes": infer Types;
+} ? Types extends DeepAgentTypeConfig ? Types : never : T extends DeepAgentTypeConfig ? T : never;
+/**
+ * Helper type to extract any property from a DeepAgentTypeConfig or DeepAgent.
+ *
+ * @typeParam T - The DeepAgentTypeConfig or DeepAgent to extract from
+ * @typeParam K - The property key to extract
+ *
+ * @example
+ * ```typescript
+ * const agent = createDeepAgent({ subagents: [...] });
+ * type Subagents = InferDeepAgentType<typeof agent, "Subagents">;
+ * ```
+ */
+type InferDeepAgentType<T, K extends keyof DeepAgentTypeConfig> = ResolveDeepAgentTypeConfig<T>[K];
+/**
+ * Shorthand helper to extract the Subagents type from a DeepAgentTypeConfig or DeepAgent.
+ *
+ * @example
+ * ```typescript
+ * const agent = createDeepAgent({ subagents: [subagent1, subagent2] });
+ * type Subagents = InferDeepAgentSubagents<typeof agent>;
+ * ```
+ */
+type InferDeepAgentSubagents<T> = InferDeepAgentType<T, "Subagents">;
+/**
+ * Helper type to extract a subagent by name from a DeepAgent.
+ *
+ * @typeParam T - The DeepAgent to extract from
+ * @typeParam TName - The name of the subagent to extract
+ *
+ * @example
+ * ```typescript
+ * const agent = createDeepAgent({
+ *   subagents: [
+ *     { name: "researcher", description: "...", middleware: [ResearchMiddleware] }
+ *   ] as const,
+ * });
+ *
+ * type ResearcherAgent = InferSubagentByName<typeof agent, "researcher">;
+ * ```
+ */
+type InferSubagentByName<T, TName extends string> = InferDeepAgentSubagents<T> extends readonly (infer SA)[] ? SA extends {
+  name: TName;
+} ? SA : never : never;
+/**
+ * Helper type to extract the ReactAgent type from a subagent definition.
+ * This is useful for type-safe streaming of subagent events.
+ *
+ * @typeParam TSubagent - The subagent definition
+ *
+ * @example
+ * ```typescript
+ * type SubagentMiddleware = ExtractSubAgentMiddleware<typeof subagent>;
+ * type SubagentState = InferMiddlewareStates<SubagentMiddleware>;
+ * ```
+ */
+type InferSubagentReactAgentType<TSubagent extends SubAgent | CompiledSubAgent> = TSubagent extends CompiledSubAgent ? TSubagent["runnable"] : TSubagent extends SubAgent ? ReactAgent<AgentTypeConfig<ResponseFormatUndefined, undefined, AnyAnnotationRoot, ExtractSubAgentMiddleware<TSubagent>, readonly []>> : never;
 /**
  * Configuration parameters for creating a Deep Agent
  * Matches Python's create_deep_agent parameters
@@ -996,6 +1208,44 @@ interface CreateDeepAgentParams<TResponse extends ResponseFormat = ResponseForma
   interruptOn?: Record<string, boolean | InterruptOnConfig>;
   /** The name of the agent */
   name?: string;
+  /**
+   * Optional list of memory file paths (AGENTS.md files) to load
+   * (e.g., ["~/.deepagents/AGENTS.md", "./.deepagents/AGENTS.md"]).
+   * Display names are automatically derived from paths.
+   * Memory is loaded at agent startup and added into the system prompt.
+   */
+  memory?: string[];
+  /**
+   * Optional list of skill source paths (e.g., `["/skills/user/", "/skills/project/"]`).
+   *
+   * Paths use POSIX conventions (forward slashes) and are relative to the backend's root.
+   * Later sources override earlier ones for skills with the same name (last one wins).
+   *
+   * @example
+   * ```typescript
+   * // With FilesystemBackend - skills loaded from disk
+   * const agent = await createDeepAgent({
+   *   backend: new FilesystemBackend({ rootDir: "/home/user/.deepagents" }),
+   *   skills: ["/skills/"],
+   * });
+   *
+   * // With StateBackend - skills provided in state
+   * const agent = await createDeepAgent({
+   *   skills: ["/skills/"],
+   * });
+   * const result = await agent.invoke({
+   *   messages: [...],
+   *   files: {
+   *     "/skills/my-skill/SKILL.md": {
+   *       content: ["---", "name: my-skill", "description: ...", "---", "# My Skill"],
+   *       created_at: new Date().toISOString(),
+   *       modified_at: new Date().toISOString(),
+   *     },
+   *   },
+   * });
+   * ```
+   */
+  skills?: string[];
 }
 //#endregion
 //#region src/agent.d.ts
@@ -1030,7 +1280,7 @@ interface CreateDeepAgentParams<TResponse extends ResponseFormat = ResponseForma
  * // result.research is properly typed as string
  * ```
  */
-declare function createDeepAgent<TResponse extends ResponseFormat = ResponseFormat, ContextSchema extends InteropZodObject = InteropZodObject, const TMiddleware extends readonly AgentMiddleware[] = readonly [], const TSubagents extends readonly (SubAgent | CompiledSubAgent)[] = readonly [], const TTools extends readonly (ClientTool | ServerTool)[] = readonly []>(params?: CreateDeepAgentParams<TResponse, ContextSchema, TMiddleware, TSubagents, TTools>): ReactAgent<AgentTypeConfig<TResponse, undefined, ContextSchema, readonly [AgentMiddleware<zod_v30.ZodObject<{
+declare function createDeepAgent<TResponse extends ResponseFormat = ResponseFormat, ContextSchema extends InteropZodObject = InteropZodObject, const TMiddleware extends readonly AgentMiddleware[] = readonly [], const TSubagents extends readonly (SubAgent | CompiledSubAgent)[] = readonly [], const TTools extends readonly (ClientTool | ServerTool)[] = readonly []>(params?: CreateDeepAgentParams<TResponse, ContextSchema, TMiddleware, TSubagents, TTools>): DeepAgent<DeepAgentTypeConfig<TResponse, undefined, ContextSchema, readonly [AgentMiddleware<zod_v30.ZodObject<{
   todos: zod_v30.ZodDefault<zod_v30.ZodArray<zod_v30.ZodObject<{
     content: zod_v30.ZodString;
     status: zod_v30.ZodEnum<["pending", "in_progress", "completed"]>;
@@ -1088,7 +1338,17 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
     status: "completed" | "in_progress" | "pending";
   }[];
   messages: _messages.ToolMessage<_messages.MessageStructure<_messages.MessageToolSet>>[];
-}, string>, "write_todos">]>, AgentMiddleware<zod0.ZodObject<{
+}, string>, "write_todos">]>, ...(AgentMiddleware<zod0.ZodObject<{
+  skillsMetadata: zod0.ZodOptional<zod0.ZodArray<zod0.ZodObject<{
+    name: zod0.ZodString;
+    description: zod0.ZodString;
+    path: zod0.ZodString;
+    license: zod0.ZodOptional<zod0.ZodNullable<zod0.ZodString>>;
+    compatibility: zod0.ZodOptional<zod0.ZodNullable<zod0.ZodString>>;
+    metadata: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodString>>;
+    allowedTools: zod0.ZodOptional<zod0.ZodArray<zod0.ZodString>>;
+  }, zod_v4_core0.$strip>>>;
+}, zod_v4_core0.$strip>, undefined, unknown, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<zod0.ZodObject<{
   files: zod0.ZodDefault<zod0.ZodRecord<zod0.ZodString, zod0.ZodObject<{
     content: zod0.ZodArray<zod0.ZodString>;
     created_at: zod0.ZodString;
@@ -1169,22 +1429,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   command: string;
 }, {
   command: string;
-}, string, "execute">)[]>, AgentMiddleware<undefined, undefined, unknown, readonly [langchain9.DynamicStructuredTool<zod_v30.ZodObject<{
-  description: zod_v30.ZodString;
-  subagent_type: zod_v30.ZodString;
-}, "strip", zod_v30.ZodTypeAny, {
-  description: string;
-  subagent_type: string;
-}, {
-  description: string;
-  subagent_type: string;
-}>, {
-  description: string;
-  subagent_type: string;
-}, {
-  description: string;
-  subagent_type: string;
-}, string | _Command.Command<unknown, Record<string, unknown>, string>, "task">]>, AgentMiddleware<undefined, zod_v30.ZodObject<{
+}, string, "execute">)[]> | AgentMiddleware<undefined, zod_v30.ZodObject<{
   trigger: zod_v30.ZodOptional<zod_v30.ZodUnion<[zod_v30.ZodEffects<zod_v30.ZodObject<{
     fraction: zod_v30.ZodOptional<zod_v30.ZodNumber>;
     tokens: zod_v30.ZodOptional<zod_v30.ZodNumber>;
@@ -1321,7 +1566,7 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   maxTokensBeforeSummary?: number | undefined;
   messagesToKeep?: number | undefined;
   model?: _langchain_core_language_models_base0.BaseLanguageModel<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
-}, readonly (ClientTool | ServerTool)[]>, AgentMiddleware<undefined, zod_v30.ZodObject<{
+}, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, zod_v30.ZodObject<{
   enableCaching: zod_v30.ZodOptional<zod_v30.ZodBoolean>;
   ttl: zod_v30.ZodOptional<zod_v30.ZodEnum<["5m", "1h"]>>;
   minMessagesToCache: zod_v30.ZodOptional<zod_v30.ZodNumber>;
@@ -1341,7 +1586,24 @@ declare function createDeepAgent<TResponse extends ResponseFormat = ResponseForm
   ttl?: "1h" | "5m" | undefined;
   minMessagesToCache?: number | undefined;
   unsupportedModelBehavior?: "ignore" | "raise" | "warn" | undefined;
-}, readonly (ClientTool | ServerTool)[]>, AgentMiddleware<undefined, undefined, unknown, readonly (ClientTool | ServerTool)[]>, ...TMiddleware, ...FlattenSubAgentMiddleware<TSubagents>], TTools>>;
+}, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, undefined, unknown, readonly (ClientTool | ServerTool)[]> | AgentMiddleware<undefined, undefined, unknown, readonly [langchain9.DynamicStructuredTool<zod_v30.ZodObject<{
+  description: zod_v30.ZodString;
+  subagent_type: zod_v30.ZodString;
+}, "strip", zod_v30.ZodTypeAny, {
+  description: string;
+  subagent_type: string;
+}, {
+  description: string;
+  subagent_type: string;
+}>, {
+  description: string;
+  subagent_type: string;
+}, {
+  description: string;
+  subagent_type: string;
+}, string | _Command.Command<unknown, Record<string, unknown>, string>, "task">]> | AgentMiddleware<zod0.ZodObject<{
+  memoryContents: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodString>>;
+}, zod_v4_core0.$strip>, undefined, unknown, readonly (ClientTool | ServerTool)[]>)[], ...TMiddleware, ...FlattenSubAgentMiddleware<TSubagents>], TTools, TSubagents>>;
 //#endregion
 //#region src/config.d.ts
 /**
@@ -1444,36 +1706,6 @@ declare function findProjectRoot(startPath?: string): string | null;
  */
 declare function createSettings(options?: SettingsOptions): Settings;
 //#endregion
-//#region src/middleware/skills.d.ts
-/**
- * Options for the skills middleware.
- */
-interface SkillsMiddlewareOptions {
-  /** Path to the user-level skills directory (per-agent) */
-  skillsDir: string;
-  /** The agent identifier for path references in prompts */
-  assistantId: string;
-  /** Optional path to project-level skills directory */
-  projectSkillsDir?: string;
-}
-/**
- * Create middleware for loading and exposing agent skills.
- *
- * This middleware implements Anthropic's agent skills pattern:
- * - Loads skills metadata (name, description) from YAML frontmatter at session start
- * - Injects skills list into system prompt for discoverability
- * - Agent reads full SKILL.md content when a skill is relevant (progressive disclosure)
- *
- * Supports both user-level and project-level skills:
- * - User skills: ~/.deepagents/{AGENT_NAME}/skills/
- * - Project skills: {PROJECT_ROOT}/.deepagents/skills/
- * - Project skills override user skills with the same name
- *
- * @param options - Configuration options
- * @returns AgentMiddleware for skills loading and injection
- */
-declare function createSkillsMiddleware(options: SkillsMiddlewareOptions): AgentMiddleware<any, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
-//#endregion
 //#region src/middleware/agent-memory.d.ts
 /**
  * Options for the agent memory middleware.
@@ -1499,36 +1731,6 @@ interface AgentMemoryMiddlewareOptions {
 declare function createAgentMemoryMiddleware(options: AgentMemoryMiddlewareOptions): AgentMiddleware<any, undefined, unknown, readonly (_langchain_core_tools3.ClientTool | _langchain_core_tools3.ServerTool)[]>;
 //#endregion
 //#region src/skills/loader.d.ts
-/**
- * Skill loader for parsing and loading agent skills from SKILL.md files.
- *
- * This module implements Anthropic's agent skills pattern with YAML frontmatter parsing.
- * Each skill is a directory containing a SKILL.md file with:
- * - YAML frontmatter (name, description required)
- * - Markdown instructions for the agent
- * - Optional supporting files (scripts, configs, etc.)
- *
- * @example
- * ```markdown
- * ---
- * name: web-research
- * description: Structured approach to conducting thorough web research
- * ---
- *
- * # Web Research Skill
- *
- * ## When to Use
- * - User asks you to research a topic
- * ...
- * ```
- *
- * @see https://agentskills.io/specification
- */
-/** Maximum size for SKILL.md files (10MB) */
-declare const MAX_SKILL_FILE_SIZE: number;
-/** Agent Skills spec constraints */
-declare const MAX_SKILL_NAME_LENGTH = 64;
-declare const MAX_SKILL_DESCRIPTION_LENGTH = 1024;
 /**
  * Metadata for a skill per Agent Skills spec.
  * @see https://agentskills.io/specification
@@ -1580,5 +1782,5 @@ declare function parseSkillMetadata(skillMdPath: string, source: "user" | "proje
  */
 declare function listSkills(options: ListSkillsOptions): SkillMetadata[];
 //#endregion
-export { type AgentMemoryMiddlewareOptions, type BackendFactory, type BackendProtocol, BaseSandbox, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, type EditResult, type ExecuteResponse, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type GrepMatch, type ListSkillsOptions, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MergedDeepAgentState, type SandboxBackendProtocol, type Settings, type SettingsOptions, type SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
+export { type AgentMemoryMiddlewareOptions, type BackendFactory, type BackendProtocol, BaseSandbox, type CompiledSubAgent, CompositeBackend, type CreateDeepAgentParams, type DeepAgent, type DeepAgentTypeConfig, type DefaultDeepAgentTypeConfig, type EditResult, type ExecuteResponse, type ExtractSubAgentMiddleware, type FileData, type FileDownloadResponse, type FileInfo, type FileOperationError, type FileUploadResponse, FilesystemBackend, type FilesystemMiddlewareOptions, type FlattenSubAgentMiddleware, type GrepMatch, type InferDeepAgentSubagents, type InferDeepAgentType, type InferSubAgentMiddlewareStates, type InferSubagentByName, type InferSubagentReactAgentType, type ListSkillsOptions, type SkillMetadata as LoaderSkillMetadata, MAX_SKILL_DESCRIPTION_LENGTH, MAX_SKILL_FILE_SIZE, MAX_SKILL_NAME_LENGTH, type MaybePromise, type MemoryMiddlewareOptions, type MergedDeepAgentState, type ResolveDeepAgentTypeConfig, type SandboxBackendProtocol, type Settings, type SettingsOptions, type SkillMetadata$1 as SkillMetadata, type SkillsMiddlewareOptions, StateBackend, StoreBackend, type SubAgent, type SubAgentMiddlewareOptions, type WriteResult, createAgentMemoryMiddleware, createDeepAgent, createFilesystemMiddleware, createMemoryMiddleware, createPatchToolCallsMiddleware, createSettings, createSkillsMiddleware, createSubAgentMiddleware, findProjectRoot, isSandboxBackend, listSkills, parseSkillMetadata };
 //# sourceMappingURL=index.d.ts.map