deepagents 1.7.4 → 1.7.5

package/dist/index.d.cts

@@ -570,9 +570,11 @@ declare const TASK_SYSTEM_PROMPT = "## `task` (subagent spawner)\n\nYou have acc
  * 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.
+ *   When using `createAgent` or `createDeepAgent`, this preserves the middleware
+ *   types for type inference. Uses `ReactAgent<any>` to accept agents with any
+ *   type configuration (including DeepAgent instances).
  */
-interface CompiledSubAgent<TRunnable extends ReactAgent | Runnable = ReactAgent | Runnable> {
+interface CompiledSubAgent<TRunnable extends ReactAgent<any> | Runnable = ReactAgent<any> | Runnable> {
   /** The name of the agent */
   name: string;
   /** The description of the agent */
@@ -893,19 +895,59 @@ 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) */
+  /**
+   * Skill identifier.
+   *
+   * Constraints per Agent Skills specification:
+   *
+   * - 1-64 characters
+   * - Unicode lowercase alphanumeric and hyphens only (`a-z` and `-`).
+   * - Must not start or end with `-`
+   * - Must not contain consecutive `--`
+   * - Must match the parent directory name containing the `SKILL.md` file
+   */
   name: string;
-  /** What the skill does (max 1024 chars) */
+  /**
+   * What the skill does.
+   *
+   * Constraints per Agent Skills specification:
+   *
+   * - 1-1024 characters
+   * - Should describe both what the skill does and when to use it
+   * - Should include specific keywords that help agents identify relevant tasks
+   */
   description: string;
   /** Path to the SKILL.md file in the backend */
   path: string;
-  /** License name or reference to bundled license file */
+  /** License name or reference to bundled license file. */
   license?: string | null;
-  /** Environment requirements (max 500 chars) */
+  /**
+   * Environment requirements.
+   *
+   * Constraints per Agent Skills specification:
+   *
+   * - 1-500 characters if provided
+   * - Should only be included if there are specific compatibility requirements
+   * - Can indicate intended product, required packages, etc.
+   */
   compatibility?: string | null;
-  /** Arbitrary key-value mapping for additional metadata */
+  /**
+   * Arbitrary key-value mapping for additional metadata.
+   *
+   * Clients can use this to store additional properties not defined by the spec.
+   *
+   * It is recommended to keep key names unique to avoid conflicts.
+   */
   metadata?: Record<string, string>;
-  /** List of pre-approved tools (experimental) */
+  /**
+   * Tool names the skill recommends using.
+   *
+   * Warning: this is experimental.
+   *
+   * Constraints per Agent Skills specification:
+   *
+   * - Space-delimited list of tool names
+   */
   allowedTools?: string[];
 }
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as langchain from "langchain";
-import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, InferMiddlewareStates, InterruptOnConfig, ReactAgent, ResponseFormat, ResponseFormatUndefined, StructuredTool, SystemMessage, ToolMessage } from "langchain";
+import { AgentMiddleware, AgentMiddleware as AgentMiddleware$1, AgentTypeConfig, HumanMessage, InferMiddlewareStates, InterruptOnConfig, ReactAgent, ResponseFormat, ResponseFormatUndefined, StructuredTool, SystemMessage, ToolMessage } from "langchain";
 import { Runnable } from "@langchain/core/runnables";
 import * as _langchain_langgraph0 from "@langchain/langgraph";
 import { AnnotationRoot, Command, ReducedValue, StateSchema } from "@langchain/langgraph";
@@ -570,9 +570,11 @@ declare const TASK_SYSTEM_PROMPT = "## `task` (subagent spawner)\n\nYou have acc
  * 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.
+ *   When using `createAgent` or `createDeepAgent`, this preserves the middleware
+ *   types for type inference. Uses `ReactAgent<any>` to accept agents with any
+ *   type configuration (including DeepAgent instances).
  */
-interface CompiledSubAgent<TRunnable extends ReactAgent | Runnable = ReactAgent | Runnable> {
+interface CompiledSubAgent<TRunnable extends ReactAgent<any> | Runnable = ReactAgent<any> | Runnable> {
   /** The name of the agent */
   name: string;
   /** The description of the agent */
@@ -893,19 +895,59 @@ 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) */
+  /**
+   * Skill identifier.
+   *
+   * Constraints per Agent Skills specification:
+   *
+   * - 1-64 characters
+   * - Unicode lowercase alphanumeric and hyphens only (`a-z` and `-`).
+   * - Must not start or end with `-`
+   * - Must not contain consecutive `--`
+   * - Must match the parent directory name containing the `SKILL.md` file
+   */
   name: string;
-  /** What the skill does (max 1024 chars) */
+  /**
+   * What the skill does.
+   *
+   * Constraints per Agent Skills specification:
+   *
+   * - 1-1024 characters
+   * - Should describe both what the skill does and when to use it
+   * - Should include specific keywords that help agents identify relevant tasks
+   */
   description: string;
   /** Path to the SKILL.md file in the backend */
   path: string;
-  /** License name or reference to bundled license file */
+  /** License name or reference to bundled license file. */
   license?: string | null;
-  /** Environment requirements (max 500 chars) */
+  /**
+   * Environment requirements.
+   *
+   * Constraints per Agent Skills specification:
+   *
+   * - 1-500 characters if provided
+   * - Should only be included if there are specific compatibility requirements
+   * - Can indicate intended product, required packages, etc.
+   */
   compatibility?: string | null;
-  /** Arbitrary key-value mapping for additional metadata */
+  /**
+   * Arbitrary key-value mapping for additional metadata.
+   *
+   * Clients can use this to store additional properties not defined by the spec.
+   *
+   * It is recommended to keep key names unique to avoid conflicts.
+   */
   metadata?: Record<string, string>;
-  /** List of pre-approved tools (experimental) */
+  /**
+   * Tool names the skill recommends using.
+   *
+   * Warning: this is experimental.
+   *
+   * Constraints per Agent Skills specification:
+   *
+   * - Space-delimited list of tool names
+   */
   allowedTools?: string[];
 }
 /**

package/dist/index.js

@@ -1,10 +1,10 @@
-import { AIMessage, SystemMessage, ToolMessage, anthropicPromptCachingMiddleware, createAgent, createMiddleware, humanInTheLoopMiddleware, summarizationMiddleware, todoListMiddleware, tool } from "langchain";
+import { AIMessage, HumanMessage, SystemMessage, ToolMessage, anthropicPromptCachingMiddleware, createAgent, createMiddleware, humanInTheLoopMiddleware, summarizationMiddleware, todoListMiddleware, tool } from "langchain";
 import { Runnable } from "@langchain/core/runnables";
 import { Command, REMOVE_ALL_MESSAGES, ReducedValue, StateSchema, getCurrentTaskInput, isCommand } from "@langchain/langgraph";
 import { z } from "zod/v4";
 import micromatch from "micromatch";
 import { basename } from "path";
-import { HumanMessage, RemoveMessage } from "@langchain/core/messages";
+import { HumanMessage as HumanMessage$1, RemoveMessage } from "@langchain/core/messages";
 import { z as z$1 } from "zod";
 import yaml from "yaml";
 import "uuid";
@@ -1403,7 +1403,7 @@ function createTaskTool(options) {
 		}
 		const subagent = subagentGraphs[subagent_type];
 		const subagentState = filterStateForSubagent(getCurrentTaskInput());
-		subagentState.messages = [new HumanMessage({ content: description })];
+		subagentState.messages = [new HumanMessage$1({ content: description })];
 		const result = await subagent.invoke(subagentState, config);
 		if (!config.toolCall?.id) throw new Error("Tool call ID is required for subagent invocation");
 		return returnCommandWithStateUpdate(result, config.toolCall.id);
@@ -1821,6 +1821,7 @@ function createMemoryMiddleware(options) {
 const MAX_SKILL_FILE_SIZE = 10 * 1024 * 1024;
 const MAX_SKILL_NAME_LENGTH = 64;
 const MAX_SKILL_DESCRIPTION_LENGTH = 1024;
+const MAX_SKILL_COMPATIBILITY_LENGTH = 500;
 /**
 * Zod schema for a single skill metadata entry.
 */
@@ -1908,6 +1909,22 @@ Remember: Skills are tools to make you more capable and consistent. When in doub
 `;
 /**
 * Validate skill name per Agent Skills specification.
+*
+* Constraints per Agent Skills specification:
+*
+* - 1-64 characters
+* - Unicode lowercase alphanumeric and hyphens only (`a-z` and `-`).
+* - Must not start or end with `-`
+* - Must not contain consecutive `--`
+* - Must match the parent directory name containing the `SKILL.md` file
+*
+* Unicode lowercase alphanumeric means any lowercase or decimal digit, which
+* covers accented Latin characters (e.g., `'café'`, `'über-tool'`) and other
+* scripts.
+*
+* @param name - The skill name from YAML frontmatter
+* @param directoryName - The parent directory name
+* @returns `{ valid, error }` tuple. Error is empty string if valid.
 */
 function validateSkillName$1(name, directoryName) {
 	if (!name) return {
@@ -1918,10 +1935,18 @@ function validateSkillName$1(name, directoryName) {
 		valid: false,
 		error: "name exceeds 64 characters"
 	};
-	if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(name)) return {
+	if (name.startsWith("-") || name.endsWith("-") || name.includes("--")) return {
 		valid: false,
 		error: "name must be lowercase alphanumeric with single hyphens only"
 	};
+	for (const c of name) {
+		if (c === "-") continue;
+		if (/\p{Ll}/u.test(c) || /\p{Nd}/u.test(c)) continue;
+		return {
+			valid: false,
+			error: "name must be lowercase alphanumeric with single hyphens only"
+		};
+	}
 	if (name !== directoryName) return {
 		valid: false,
 		error: `name '${name}' must match directory name '${directoryName}'`
@@ -1932,7 +1957,52 @@ function validateSkillName$1(name, directoryName) {
 	};
 }
 /**
-* Parse YAML frontmatter from SKILL.md content.
+* Validate and normalize the metadata field from YAML frontmatter.
+*
+* YAML parsing can return any type for the `metadata` key. This ensures the
+* value in {@link SkillMetadata} is always a `Record<string, string>` by
+* coercing via `String()` and rejecting non-object inputs.
+*
+* @param raw - Raw value from `frontmatterData.metadata`.
+* @param skillPath - Path to the `SKILL.md` file (for warning messages).
+* @returns A validated `Record<string, string>`.
+*/
+function validateMetadata(raw, skillPath) {
+	if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+		if (raw) console.warn(`Ignoring non-object metadata in ${skillPath} (got ${typeof raw})`);
+		return {};
+	}
+	const result = {};
+	for (const [k, v] of Object.entries(raw)) result[String(k)] = String(v);
+	return result;
+}
+/**
+* Build a parenthetical annotation string from optional skill fields.
+*
+* Combines license and compatibility into a comma-separated string for
+* display in the system prompt skill listing.
+*
+* @param skill - Skill metadata to extract annotations from.
+* @returns Annotation string like `'License: MIT, Compatibility: Python 3.10+'`,
+*   or empty string if neither field is set.
+*/
+function formatSkillAnnotations(skill) {
+	const parts = [];
+	if (skill.license) parts.push(`License: ${skill.license}`);
+	if (skill.compatibility) parts.push(`Compatibility: ${skill.compatibility}`);
+	return parts.join(", ");
+}
+/**
+* Parse YAML frontmatter from `SKILL.md` content.
+*
+* Extracts metadata per Agent Skills specification from YAML frontmatter
+* delimited by `---` markers at the start of the content.
+*
+* @param content - Content of the `SKILL.md` file
+* @param skillPath - Path to the `SKILL.md` file (for error messages and metadata)
+* @param directoryName - Name of the parent directory containing the skill
+* @returns `SkillMetadata` if parsing succeeds, `null` if parsing fails or
+*   validation errors occur
 */
 function parseSkillMetadataFromContent(content, skillPath, directoryName) {
 	if (content.length > MAX_SKILL_FILE_SIZE) {
@@ -1956,28 +2026,36 @@ function parseSkillMetadataFromContent(content, skillPath, directoryName) {
 		console.warn(`Skipping ${skillPath}: frontmatter is not a mapping`);
 		return null;
 	}
-	const name = frontmatterData.name;
-	const description = frontmatterData.description;
+	const name = String(frontmatterData.name ?? "").trim();
+	const description = String(frontmatterData.description ?? "").trim();
 	if (!name || !description) {
 		console.warn(`Skipping ${skillPath}: missing required 'name' or 'description'`);
 		return null;
 	}
-	const validation = validateSkillName$1(String(name), directoryName);
+	const validation = validateSkillName$1(name, directoryName);
 	if (!validation.valid) console.warn(`Skill '${name}' in ${skillPath} does not follow Agent Skills specification: ${validation.error}. Consider renaming for spec compliance.`);
-	let descriptionStr = String(description).trim();
+	let descriptionStr = description;
 	if (descriptionStr.length > MAX_SKILL_DESCRIPTION_LENGTH) {
 		console.warn(`Description exceeds ${MAX_SKILL_DESCRIPTION_LENGTH} characters in ${skillPath}, truncating`);
 		descriptionStr = descriptionStr.slice(0, MAX_SKILL_DESCRIPTION_LENGTH);
 	}
-	const allowedToolsStr = frontmatterData["allowed-tools"];
-	const allowedTools = allowedToolsStr ? allowedToolsStr.split(" ") : [];
+	const rawTools = frontmatterData["allowed-tools"];
+	let allowedTools;
+	if (rawTools) if (Array.isArray(rawTools)) allowedTools = rawTools.map((t) => String(t).trim()).filter(Boolean);
+	else allowedTools = String(rawTools).split(/\s+/).filter(Boolean);
+	else allowedTools = [];
+	let compatibilityStr = String(frontmatterData.compatibility ?? "").trim() || null;
+	if (compatibilityStr && compatibilityStr.length > MAX_SKILL_COMPATIBILITY_LENGTH) {
+		console.warn(`Compatibility exceeds ${MAX_SKILL_COMPATIBILITY_LENGTH} characters in ${skillPath}, truncating`);
+		compatibilityStr = compatibilityStr.slice(0, MAX_SKILL_COMPATIBILITY_LENGTH);
+	}
 	return {
-		name: String(name),
+		name,
 		description: descriptionStr,
 		path: skillPath,
-		metadata: frontmatterData.metadata || {},
-		license: typeof frontmatterData.license === "string" ? frontmatterData.license.trim() || null : null,
-		compatibility: typeof frontmatterData.compatibility === "string" ? frontmatterData.compatibility.trim() || null : null,
+		metadata: validateMetadata(frontmatterData.metadata ?? {}, skillPath),
+		license: String(frontmatterData.license ?? "").trim() || null,
+		compatibility: compatibilityStr,
 		allowedTools
 	};
 }
@@ -2041,7 +2119,10 @@ function formatSkillsList(skills, sources) {
 	if (skills.length === 0) return `(No skills available yet. You can create skills in ${sources.map((s) => `\`${s}\``).join(" or ")})`;
 	const lines = [];
 	for (const skill of skills) {
-		lines.push(`- **${skill.name}**: ${skill.description}`);
+		const annotations = formatSkillAnnotations(skill);
+		let descLine = `- **${skill.name}**: ${skill.description}`;
+		if (annotations) descLine += ` (${annotations})`;
+		lines.push(descLine);
 		if (skill.allowedTools && skill.allowedTools.length > 0) lines.push(`  → Allowed tools: ${skill.allowedTools.join(", ")}`);
 		lines.push(`  → Read \`${skill.path}\` for full instructions`);
 	}
@@ -2154,9 +2235,25 @@ function createSkillsMiddleware(options) {
 * from `langchain` directly.
 */
 /**
+* Zod schema for a summarization event that tracks what was summarized and
+* where the cutoff is.
+*
+* Instead of rewriting LangGraph state with `RemoveMessage(REMOVE_ALL_MESSAGES)`,
+* the middleware stores this event and uses it to reconstruct the effective message
+* list on subsequent calls.
+*/
+const SummarizationEventSchema = z$1.object({
+	cutoffIndex: z$1.number(),
+	summaryMessage: z$1.instanceof(HumanMessage),
+	filePath: z$1.string().nullable()
+});
+/**
 * State schema for summarization middleware.
 */
-const SummarizationStateSchema = z$1.object({ _summarizationSessionId: z$1.string().optional() });
+const SummarizationStateSchema = z$1.object({
+	_summarizationSessionId: z$1.string().optional(),
+	_summarizationEvent: SummarizationEventSchema.optional()
+});
 
 //#endregion
 //#region src/backends/store.ts