@librechat/agents 3.3.5 → 3.3.6

package/dist/esm/tools/ReadFile.mjs

@@ -1,5 +1,6 @@
 import "../common/enum.mjs";
 import "../common/index.mjs";
+import { INTENT_PROPERTY } from "./intentArg.mjs";
 //#region src/tools/ReadFile.ts
 const ReadFileToolName = "read_file";
 const ReadFileToolDescription = `Read the contents of a file. Returns text content with line numbers for easy reference.
@@ -19,10 +20,13 @@ CONSTRAINTS:
 - Do not guess file paths. Use paths from the skill documentation or tool output.`;
 const ReadFileToolSchema = {
 	type: "object",
-	properties: { path: {
-		type: "string",
-		description: "Path to the file. For skill files: \"{skillName}/{path}\" (e.g. \"pdf-analyzer/src/utils.py\"). For code execution output: the path as returned by the execution tool."
-	} },
+	properties: {
+		intent: { ...INTENT_PROPERTY },
+		path: {
+			type: "string",
+			description: "Path to the file. For skill files: \"{skillName}/{path}\" (e.g. \"pdf-analyzer/src/utils.py\"). For code execution output: the path as returned by the execution tool."
+		}
+	},
 	required: ["path"]
 };
 const ReadFileToolDefinition = {

package/dist/esm/tools/ReadFile.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ReadFile.mjs","names":[],"sources":["../../../src/tools/ReadFile.ts"],"sourcesContent":["// src/tools/ReadFile.ts\nimport { Constants } from '@/common';\n\nexport const ReadFileToolName = Constants.READ_FILE;\n\nexport const ReadFileToolDescription = `Read the contents of a file. Returns text content with line numbers for easy reference.\n\nFor skill files, use the path format: {skillName}/{filePath} (e.g. \"pdf-analyzer/src/utils.py\", \"code-review/SKILL.md\").\n\nBEHAVIOR:\n- Text files: returned with numbered lines.\n- Images (png, jpeg, gif, webp): returned as visual content the model can see.\n- PDFs: returned as document content.\n- Other binary files: metadata returned with a note to use bash for processing.\n- Large files (>256KB text, >10MB binary): metadata only.\n- SKILL.md: returns the skill's instructions directly.\n\nCONSTRAINTS:\n- Only files from invoked skills or code execution output are accessible.\n- Do not guess file paths. Use paths from the skill documentation or tool output.`;\n\nexport const ReadFileToolSchema = {\n  type: 'object',\n  properties: {\n    path: {\n      type: 'string',\n      description:\n        'Path to the file. For skill files: \"{skillName}/{path}\" (e.g. \"pdf-analyzer/src/utils.py\"). For code execution output: the path as returned by the execution tool.',\n    },\n  },\n  required: ['path'],\n} as const;\n\nexport const ReadFileToolDefinition = {\n  name: ReadFileToolName,\n  description: ReadFileToolDescription,\n  parameters: ReadFileToolSchema,\n  responseFormat: 'content_and_artifact' as const,\n} as const;\n"],"mappings":";;;AAGA,MAAa,mBAAA;AAEb,MAAa,0BAA0B;;;;;;;;;;;;;;;AAgBvC,MAAa,qBAAqB;CAChC,MAAM;CACN,YAAY,EACV,MAAM;EACJ,MAAM;EACN,aACE;CACJ,EACF;CACA,UAAU,CAAC,MAAM;AACnB;AAEA,MAAa,yBAAyB;CACpC,MAAM;CACN,aAAa;CACb,YAAY;CACZ,gBAAgB;AAClB"}
+{"version":3,"file":"ReadFile.mjs","names":[],"sources":["../../../src/tools/ReadFile.ts"],"sourcesContent":["// src/tools/ReadFile.ts\nimport { INTENT_PROPERTY } from '@/tools/intentArg';\nimport { Constants } from '@/common';\n\nexport const ReadFileToolName = Constants.READ_FILE;\n\nexport const ReadFileToolDescription = `Read the contents of a file. Returns text content with line numbers for easy reference.\n\nFor skill files, use the path format: {skillName}/{filePath} (e.g. \"pdf-analyzer/src/utils.py\", \"code-review/SKILL.md\").\n\nBEHAVIOR:\n- Text files: returned with numbered lines.\n- Images (png, jpeg, gif, webp): returned as visual content the model can see.\n- PDFs: returned as document content.\n- Other binary files: metadata returned with a note to use bash for processing.\n- Large files (>256KB text, >10MB binary): metadata only.\n- SKILL.md: returns the skill's instructions directly.\n\nCONSTRAINTS:\n- Only files from invoked skills or code execution output are accessible.\n- Do not guess file paths. Use paths from the skill documentation or tool output.`;\n\nexport const ReadFileToolSchema = {\n  type: 'object',\n  properties: {\n    intent: { ...INTENT_PROPERTY },\n    path: {\n      type: 'string',\n      description:\n        'Path to the file. For skill files: \"{skillName}/{path}\" (e.g. \"pdf-analyzer/src/utils.py\"). For code execution output: the path as returned by the execution tool.',\n    },\n  },\n  required: ['path'],\n} as const;\n\nexport const ReadFileToolDefinition = {\n  name: ReadFileToolName,\n  description: ReadFileToolDescription,\n  parameters: ReadFileToolSchema,\n  responseFormat: 'content_and_artifact' as const,\n} as const;\n"],"mappings":";;;;AAIA,MAAa,mBAAA;AAEb,MAAa,0BAA0B;;;;;;;;;;;;;;;AAgBvC,MAAa,qBAAqB;CAChC,MAAM;CACN,YAAY;EACV,QAAQ,EAAE,GAAG,gBAAgB;EAC7B,MAAM;GACJ,MAAM;GACN,aACE;EACJ;CACF;CACA,UAAU,CAAC,MAAM;AACnB;AAEA,MAAa,yBAAyB;CACpC,MAAM;CACN,aAAa;CACb,YAAY;CACZ,gBAAgB;AAClB"}

package/dist/esm/tools/SkillTool.mjs

@@ -1,5 +1,6 @@
 import "../common/enum.mjs";
 import "../common/index.mjs";
+import { INTENT_PROPERTY } from "./intentArg.mjs";
 //#region src/tools/SkillTool.ts
 const SkillToolName = "skill";
 const SkillToolDescription = `Invoke a skill from the user's library. Skills provide domain-specific instructions loaded into the conversation context, and may also provide files accessible via available tools depending on the runtime environment.
@@ -24,6 +25,7 @@ CONSTRAINTS:
 const SkillToolSchema = {
 	type: "object",
 	properties: {
+		intent: { ...INTENT_PROPERTY },
 		skillName: {
 			type: "string",
 			description: "The kebab-case identifier of the skill to invoke (e.g. \"financial-analyzer\", \"meeting-notes\"). Must match a name from the \"Available Skills\" section."

package/dist/esm/tools/SkillTool.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"SkillTool.mjs","names":[],"sources":["../../../src/tools/SkillTool.ts"],"sourcesContent":["// src/tools/SkillTool.ts\nimport { Constants } from '@/common';\n\nexport const SkillToolName = Constants.SKILL_TOOL;\n\nexport const SkillToolDescription = `Invoke a skill from the user's library. Skills provide domain-specific instructions loaded into the conversation context, and may also provide files accessible via available tools depending on the runtime environment.\n\nWHEN TO USE:\n- The user's request matches a skill listed in the \"Available Skills\" section of the system prompt.\n- You MUST invoke the matching skill BEFORE attempting the task yourself.\n\nWHAT HAPPENS:\n- The skill's full instructions are loaded into the conversation as context.\n- Files bundled with the skill may become accessible via available tools.\n- Follow the skill's instructions to complete the task.\n\nCONSTRAINTS:\n- Do not invoke a skill that is already active in this conversation.\n- Skill names come from the catalog only. Do not guess names.`;\n\n/**\n * JSON Schema for the SkillTool parameters.\n * Single source of truth used by both SkillToolDefinition (LCTool registry)\n * and createSkillTool() (DynamicStructuredTool instance).\n */\nexport const SkillToolSchema = {\n  type: 'object',\n  properties: {\n    skillName: {\n      type: 'string',\n      description:\n        'The kebab-case identifier of the skill to invoke (e.g. \"financial-analyzer\", \"meeting-notes\"). Must match a name from the \"Available Skills\" section.',\n    },\n    args: {\n      type: 'string',\n      description: 'Optional freeform arguments string passed to the skill.',\n    },\n  },\n  required: ['skillName'],\n} as const;\n\nexport const SkillToolDefinition = {\n  name: SkillToolName,\n  description: SkillToolDescription,\n  parameters: SkillToolSchema,\n} as const;\n"],"mappings":";;;AAGA,MAAa,gBAAA;AAEb,MAAa,uBAAuB;;;;;;;;;;;;;;;;;;;AAoBpC,MAAa,kBAAkB;CAC7B,MAAM;CACN,YAAY;EACV,WAAW;GACT,MAAM;GACN,aACE;EACJ;EACA,MAAM;GACJ,MAAM;GACN,aAAa;EACf;CACF;CACA,UAAU,CAAC,WAAW;AACxB;AAEA,MAAa,sBAAsB;CACjC,MAAM;CACN,aAAa;CACb,YAAY;AACd"}
+{"version":3,"file":"SkillTool.mjs","names":[],"sources":["../../../src/tools/SkillTool.ts"],"sourcesContent":["// src/tools/SkillTool.ts\nimport { INTENT_PROPERTY } from '@/tools/intentArg';\nimport { Constants } from '@/common';\n\nexport const SkillToolName = Constants.SKILL_TOOL;\n\nexport const SkillToolDescription = `Invoke a skill from the user's library. Skills provide domain-specific instructions loaded into the conversation context, and may also provide files accessible via available tools depending on the runtime environment.\n\nWHEN TO USE:\n- The user's request matches a skill listed in the \"Available Skills\" section of the system prompt.\n- You MUST invoke the matching skill BEFORE attempting the task yourself.\n\nWHAT HAPPENS:\n- The skill's full instructions are loaded into the conversation as context.\n- Files bundled with the skill may become accessible via available tools.\n- Follow the skill's instructions to complete the task.\n\nCONSTRAINTS:\n- Do not invoke a skill that is already active in this conversation.\n- Skill names come from the catalog only. Do not guess names.`;\n\n/**\n * JSON Schema for the SkillTool parameters.\n * Single source of truth used by both SkillToolDefinition (LCTool registry)\n * and createSkillTool() (DynamicStructuredTool instance).\n */\nexport const SkillToolSchema = {\n  type: 'object',\n  properties: {\n    intent: { ...INTENT_PROPERTY },\n    skillName: {\n      type: 'string',\n      description:\n        'The kebab-case identifier of the skill to invoke (e.g. \"financial-analyzer\", \"meeting-notes\"). Must match a name from the \"Available Skills\" section.',\n    },\n    args: {\n      type: 'string',\n      description: 'Optional freeform arguments string passed to the skill.',\n    },\n  },\n  required: ['skillName'],\n} as const;\n\nexport const SkillToolDefinition = {\n  name: SkillToolName,\n  description: SkillToolDescription,\n  parameters: SkillToolSchema,\n} as const;\n"],"mappings":";;;;AAIA,MAAa,gBAAA;AAEb,MAAa,uBAAuB;;;;;;;;;;;;;;;;;;;AAoBpC,MAAa,kBAAkB;CAC7B,MAAM;CACN,YAAY;EACV,QAAQ,EAAE,GAAG,gBAAgB;EAC7B,WAAW;GACT,MAAM;GACN,aACE;EACJ;EACA,MAAM;GACJ,MAAM;GACN,aAAa;EACf;CACF;CACA,UAAU,CAAC,WAAW;AACxB;AAEA,MAAa,sBAAsB;CACjC,MAAM;CACN,aAAa;CACb,YAAY;AACd"}

package/dist/esm/tools/SubagentTool.mjs

@@ -1,5 +1,6 @@
 import "../common/enum.mjs";
 import "../common/index.mjs";
+import { INTENT_PROPERTY } from "./intentArg.mjs";
 //#region src/tools/SubagentTool.ts
 const SubagentToolName = "subagent";
 const SubagentToolDescription = `Delegate a task to a specialized subagent that runs in an isolated context window. The subagent executes independently and returns only its final text result — all intermediate tool calls, reasoning, and context stay isolated.
@@ -22,6 +23,7 @@ const SUBAGENT_TYPE_PROP_DESCRIPTION = "Which subagent type to delegate to. Must
 const SubagentToolSchema = {
 	type: "object",
 	properties: {
+		intent: { ...INTENT_PROPERTY },
 		description: {
 			type: "string",
 			description: DESCRIPTION_PROP_DESCRIPTION
@@ -51,6 +53,7 @@ function buildSubagentToolParams(configs) {
 		schema: {
 			type: "object",
 			properties: {
+				intent: { ...INTENT_PROPERTY },
 				description: {
 					type: "string",
 					description: DESCRIPTION_PROP_DESCRIPTION

package/dist/esm/tools/SubagentTool.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"SubagentTool.mjs","names":[],"sources":["../../../src/tools/SubagentTool.ts"],"sourcesContent":["import type { JsonSchemaType, LCTool } from '@/types/tools';\nimport type { SubagentConfig } from '@/types';\nimport { Constants } from '@/common';\n\nexport const SubagentToolName = Constants.SUBAGENT;\n\nexport const SubagentToolDescription = `Delegate a task to a specialized subagent that runs in an isolated context window. The subagent executes independently and returns only its final text result — all intermediate tool calls, reasoning, and context stay isolated.\n\nWHEN TO USE:\n- The task is self-contained and can be described in a single prompt.\n- You want to offload verbose or exploratory work without bloating your own context.\n- A specialized subagent is available for the task domain.\n\nWHAT HAPPENS:\n- A fresh agent is created with the task description as its only input.\n- The subagent runs to completion using its own tools and context.\n- Only the final text response is returned to you.\n\nCONSTRAINTS:\n- subagent_type must match one of the available types listed below.\n- The subagent cannot see your conversation history.`;\n\nconst DESCRIPTION_PROP_DESCRIPTION =\n  'Complete task description for the subagent. This is the ONLY information it receives — include all necessary context, requirements, and constraints.';\n\nconst SUBAGENT_TYPE_PROP_DESCRIPTION =\n  'Which subagent type to delegate to. Must be one of the available types.';\n\nexport const SubagentToolSchema = {\n  type: 'object',\n  properties: {\n    description: {\n      type: 'string',\n      description: DESCRIPTION_PROP_DESCRIPTION,\n    },\n    subagent_type: {\n      type: 'string',\n      description: SUBAGENT_TYPE_PROP_DESCRIPTION,\n    },\n  },\n  required: ['description', 'subagent_type'] as string[],\n} as const;\n\nexport const SubagentToolDefinition: LCTool = {\n  name: SubagentToolName,\n  description: SubagentToolDescription,\n  parameters: SubagentToolSchema,\n};\n\n/**\n * Build the name, schema, and description params for `tool()` from available configs.\n * Used by `Graph.createAgentNode()` when constructing the runtime tool instance.\n * Extends `SubagentToolSchema` by populating `subagent_type.enum` dynamically.\n */\nexport function buildSubagentToolParams(configs: SubagentConfig[]): {\n  name: string;\n  schema: JsonSchemaType;\n  description: string;\n} {\n  const types = configs.map((c) => c.type);\n  const typeDescriptions = configs\n    .map((c) => `- \"${c.type}\" (${c.name}): ${c.description}`)\n    .join('\\n');\n\n  return {\n    name: SubagentToolName,\n    schema: {\n      type: 'object',\n      properties: {\n        description: {\n          type: 'string',\n          description: DESCRIPTION_PROP_DESCRIPTION,\n        },\n        subagent_type: {\n          type: 'string',\n          enum: types,\n          description: `${SUBAGENT_TYPE_PROP_DESCRIPTION} Available: ${types.join(', ')}.`,\n        },\n      },\n      required: ['description', 'subagent_type'],\n    },\n    description: `${SubagentToolDescription}\\n\\nAvailable types:\\n${typeDescriptions}`,\n  };\n}\n\n/**\n * Create a SubagentTool LCTool definition with dynamic enum and description\n * populated from the available subagent configs.\n * Used for the tool registry in event-driven mode.\n */\nexport function createSubagentToolDefinition(\n  configs: SubagentConfig[]\n): LCTool {\n  const params = buildSubagentToolParams(configs);\n  return {\n    name: params.name,\n    description: params.description,\n    parameters: params.schema,\n  };\n}\n"],"mappings":";;;AAIA,MAAa,mBAAA;AAEb,MAAa,0BAA0B;;;;;;;;;;;;;;;AAgBvC,MAAM,+BACJ;AAEF,MAAM,iCACJ;AAEF,MAAa,qBAAqB;CAChC,MAAM;CACN,YAAY;EACV,aAAa;GACX,MAAM;GACN,aAAa;EACf;EACA,eAAe;GACb,MAAM;GACN,aAAa;EACf;CACF;CACA,UAAU,CAAC,eAAe,eAAe;AAC3C;AAEA,MAAa,yBAAiC;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;AACd;;;;;;AAOA,SAAgB,wBAAwB,SAItC;CACA,MAAM,QAAQ,QAAQ,KAAK,MAAM,EAAE,IAAI;CACvC,MAAM,mBAAmB,QACtB,KAAK,MAAM,MAAM,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,aAAa,CAAC,CACzD,KAAK,IAAI;CAEZ,OAAO;EACL,MAAM;EACN,QAAQ;GACN,MAAM;GACN,YAAY;IACV,aAAa;KACX,MAAM;KACN,aAAa;IACf;IACA,eAAe;KACb,MAAM;KACN,MAAM;KACN,aAAa,GAAG,+BAA+B,cAAc,MAAM,KAAK,IAAI,EAAE;IAChF;GACF;GACA,UAAU,CAAC,eAAe,eAAe;EAC3C;EACA,aAAa,GAAG,wBAAwB,wBAAwB;CAClE;AACF;;;;;;AAOA,SAAgB,6BACd,SACQ;CACR,MAAM,SAAS,wBAAwB,OAAO;CAC9C,OAAO;EACL,MAAM,OAAO;EACb,aAAa,OAAO;EACpB,YAAY,OAAO;CACrB;AACF"}
+{"version":3,"file":"SubagentTool.mjs","names":[],"sources":["../../../src/tools/SubagentTool.ts"],"sourcesContent":["import type { JsonSchemaType, LCTool } from '@/types/tools';\nimport type { SubagentConfig } from '@/types';\nimport { INTENT_PROPERTY } from '@/tools/intentArg';\nimport { Constants } from '@/common';\n\nexport const SubagentToolName = Constants.SUBAGENT;\n\nexport const SubagentToolDescription = `Delegate a task to a specialized subagent that runs in an isolated context window. The subagent executes independently and returns only its final text result — all intermediate tool calls, reasoning, and context stay isolated.\n\nWHEN TO USE:\n- The task is self-contained and can be described in a single prompt.\n- You want to offload verbose or exploratory work without bloating your own context.\n- A specialized subagent is available for the task domain.\n\nWHAT HAPPENS:\n- A fresh agent is created with the task description as its only input.\n- The subagent runs to completion using its own tools and context.\n- Only the final text response is returned to you.\n\nCONSTRAINTS:\n- subagent_type must match one of the available types listed below.\n- The subagent cannot see your conversation history.`;\n\nconst DESCRIPTION_PROP_DESCRIPTION =\n  'Complete task description for the subagent. This is the ONLY information it receives — include all necessary context, requirements, and constraints.';\n\nconst SUBAGENT_TYPE_PROP_DESCRIPTION =\n  'Which subagent type to delegate to. Must be one of the available types.';\n\nexport const SubagentToolSchema = {\n  type: 'object',\n  properties: {\n    intent: { ...INTENT_PROPERTY },\n    description: {\n      type: 'string',\n      description: DESCRIPTION_PROP_DESCRIPTION,\n    },\n    subagent_type: {\n      type: 'string',\n      description: SUBAGENT_TYPE_PROP_DESCRIPTION,\n    },\n  },\n  required: ['description', 'subagent_type'] as string[],\n} as const;\n\nexport const SubagentToolDefinition: LCTool = {\n  name: SubagentToolName,\n  description: SubagentToolDescription,\n  parameters: SubagentToolSchema,\n};\n\n/**\n * Build the name, schema, and description params for `tool()` from available configs.\n * Used by `Graph.createAgentNode()` when constructing the runtime tool instance.\n * Extends `SubagentToolSchema` by populating `subagent_type.enum` dynamically.\n */\nexport function buildSubagentToolParams(configs: SubagentConfig[]): {\n  name: string;\n  schema: JsonSchemaType;\n  description: string;\n} {\n  const types = configs.map((c) => c.type);\n  const typeDescriptions = configs\n    .map((c) => `- \"${c.type}\" (${c.name}): ${c.description}`)\n    .join('\\n');\n\n  return {\n    name: SubagentToolName,\n    schema: {\n      type: 'object',\n      properties: {\n        intent: { ...INTENT_PROPERTY },\n        description: {\n          type: 'string',\n          description: DESCRIPTION_PROP_DESCRIPTION,\n        },\n        subagent_type: {\n          type: 'string',\n          enum: types,\n          description: `${SUBAGENT_TYPE_PROP_DESCRIPTION} Available: ${types.join(', ')}.`,\n        },\n      },\n      required: ['description', 'subagent_type'],\n    },\n    description: `${SubagentToolDescription}\\n\\nAvailable types:\\n${typeDescriptions}`,\n  };\n}\n\n/**\n * Create a SubagentTool LCTool definition with dynamic enum and description\n * populated from the available subagent configs.\n * Used for the tool registry in event-driven mode.\n */\nexport function createSubagentToolDefinition(\n  configs: SubagentConfig[]\n): LCTool {\n  const params = buildSubagentToolParams(configs);\n  return {\n    name: params.name,\n    description: params.description,\n    parameters: params.schema,\n  };\n}\n"],"mappings":";;;;AAKA,MAAa,mBAAA;AAEb,MAAa,0BAA0B;;;;;;;;;;;;;;;AAgBvC,MAAM,+BACJ;AAEF,MAAM,iCACJ;AAEF,MAAa,qBAAqB;CAChC,MAAM;CACN,YAAY;EACV,QAAQ,EAAE,GAAG,gBAAgB;EAC7B,aAAa;GACX,MAAM;GACN,aAAa;EACf;EACA,eAAe;GACb,MAAM;GACN,aAAa;EACf;CACF;CACA,UAAU,CAAC,eAAe,eAAe;AAC3C;AAEA,MAAa,yBAAiC;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;AACd;;;;;;AAOA,SAAgB,wBAAwB,SAItC;CACA,MAAM,QAAQ,QAAQ,KAAK,MAAM,EAAE,IAAI;CACvC,MAAM,mBAAmB,QACtB,KAAK,MAAM,MAAM,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,aAAa,CAAC,CACzD,KAAK,IAAI;CAEZ,OAAO;EACL,MAAM;EACN,QAAQ;GACN,MAAM;GACN,YAAY;IACV,QAAQ,EAAE,GAAG,gBAAgB;IAC7B,aAAa;KACX,MAAM;KACN,aAAa;IACf;IACA,eAAe;KACb,MAAM;KACN,MAAM;KACN,aAAa,GAAG,+BAA+B,cAAc,MAAM,KAAK,IAAI,EAAE;IAChF;GACF;GACA,UAAU,CAAC,eAAe,eAAe;EAC3C;EACA,aAAa,GAAG,wBAAwB,wBAAwB;CAClE;AACF;;;;;;AAOA,SAAgB,6BACd,SACQ;CACR,MAAM,SAAS,wBAAwB,OAAO;CAC9C,OAAO;EACL,MAAM,OAAO;EACb,aAAa,OAAO;EACpB,YAAY,OAAO;CACrB;AACF"}

package/dist/esm/tools/ToolNode.mjs

@@ -6,6 +6,7 @@ import { cloneToolMessageWithContent, compactToolContent, hasComputerCallOutputM
 import { safeDispatchCustomEvent } from "../utils/events.mjs";
 import { convertInjectedMessages } from "../messages/injected.mjs";
 import { buildToolExecutionRequestPlan, recordArgsEqual, resolveRuntimeSessionHint } from "./eagerEventExecution.mjs";
+import { INTENT_ARG, isIntentLabelProperty, outcomeFieldsFromResult, readOutcomeFields, resolveToolOutcome } from "./intentArg.mjs";
 import { ToolOutputReferenceRegistry, buildReferenceKey } from "./toolOutputReferences.mjs";
 import { RunnableCallable } from "../utils/run.mjs";
 import "../utils/index.mjs";
@@ -19,6 +20,12 @@ import { Command, END, Send, interrupt, isCommand, isGraphInterrupt } from "@lan
 import { nanoid } from "nanoid";
 import { AsyncLocalStorageProviderSingleton } from "@langchain/core/singletons";
 //#region src/tools/ToolNode.ts
+function createToolErrorOwnership() {
+	return {
+		handlerOwned: /* @__PURE__ */ new Set(),
+		undispatched: /* @__PURE__ */ new Set()
+	};
+}
 /**
 * Produces the provider preview and, when requested, the exact registry prefix
 * in one bounded traversal. String outputs already exist in memory when a tool
@@ -251,12 +258,12 @@ var ToolNode = class extends RunnableCallable {
 	toolCallStepIds;
 	errorHandler;
 	/**
-	* Tool call ids whose `errorHandler` did NOT dispatch the error completion
-	* event (it returned `false` or threw). The output loop must dispatch the
-	* completion for these itself — skipping them there would strand the
-	* client's tool-call part without a terminal event.
+	* Fallback error-completion ownership for calls that reach `runTool`
+	* outside a batch context (direct `runTool` use in tests / embedders).
+	* Batch-scoped ownership is threaded via `RunToolBatchContext` instead —
+	* see {@link ToolErrorOwnership} for why per-invocation scoping matters.
 	*/
-	undispatchedToolErrors = /* @__PURE__ */ new Set();
+	looseErrorOwnership = createToolErrorOwnership();
 	toolUsageCount;
 	/** Maps toolCallId → turn captured in runTool, used by handleRunToolCompletions */
 	toolCallTurns = /* @__PURE__ */ new Map();
@@ -543,8 +550,9 @@ var ToolNode = class extends RunnableCallable {
 		const tool = this.toolMap.get(call.name);
 		const registry = this.toolOutputRegistry;
 		let resolveFn;
-		if (preBatchSnapshot != null) resolveFn = (_runId, args) => preBatchSnapshot.resolve(args);
-		else if (registry != null) resolveFn = (runIdArg, args) => registry.resolve(runIdArg, args);
+		const resolveOptions = { substituteIntentKey: this.toolDeclaresBusinessIntent(call.name) };
+		if (preBatchSnapshot != null) resolveFn = (_runId, args) => preBatchSnapshot.resolve(args, resolveOptions);
+		else if (registry != null) resolveFn = (runIdArg, args) => registry.resolve(runIdArg, args, resolveOptions);
 		/**
 		* Precompute the reference key once per call — captured locally
 		* so concurrent `invoke()` calls on the same ToolNode cannot race
@@ -737,12 +745,14 @@ var ToolNode = class extends RunnableCallable {
 			if (!this.handleToolErrors) throw e;
 			if (isGraphInterrupt(e)) throw e;
 			if (this.errorHandler) try {
-				if (await this.errorHandler({
+				const dispatched = await this.errorHandler({
 					error: e,
 					id: call.id,
 					name: call.name,
 					input: call.args
-				}, config.metadata) === false && call.id != null && call.id !== "")
+				}, config.metadata);
+				const ownership = batchContext.errorOwnership ?? this.looseErrorOwnership;
+				if (call.id != null && call.id !== "") if (dispatched === false)
  /**
 				* The handler could not dispatch the error completion (typically
 				* a resume pass, where a fast-failing tool errors before the
@@ -750,8 +760,10 @@ var ToolNode = class extends RunnableCallable {
 				* output loop dispatches the completion itself instead of
 				* assuming the handler covered it.
 				*/
-				this.undispatchedToolErrors.add(call.id);
+				ownership.undispatched.add(call.id);
+				else ownership.handlerOwned.add(call.id);
 			} catch (handlerError) {
+				if (call.id != null && call.id !== "") (batchContext.errorOwnership ?? this.looseErrorOwnership).handlerOwned.add(call.id);
 				console.error("Error in errorHandler:", {
 					toolName: call.name,
 					toolCallId: call.id,
@@ -852,11 +864,12 @@ var ToolNode = class extends RunnableCallable {
 		const turn = usageCount;
 		const stepId = this.toolCallStepIds?.get(call.id ?? "") ?? "";
 		let resolvedArgs = call.args;
+		const hookResolveOptions = { substituteIntentKey: this.toolDeclaresBusinessIntent(call.name) };
 		if (batchContext.preBatchSnapshot != null) {
-			const { resolved } = batchContext.preBatchSnapshot.resolve(call.args);
+			const { resolved } = batchContext.preBatchSnapshot.resolve(call.args, hookResolveOptions);
 			resolvedArgs = resolved;
 		} else if (this.toolOutputRegistry != null) {
-			const { resolved } = this.toolOutputRegistry.resolve(registryRunId, call.args);
+			const { resolved } = this.toolOutputRegistry.resolve(registryRunId, call.args, hookResolveOptions);
 			resolvedArgs = resolved;
 		}
 		let effectiveCall = call;
@@ -968,6 +981,16 @@ var ToolNode = class extends RunnableCallable {
 				}
 			}
 		}
+		/**
+		* A hook (`PreToolUse.updatedInput`) or HITL `edit` decision rewrote the
+		* args: expose the EFFECTIVE args to downstream completion handling
+		* (`handleRunToolCompletions` reads this sink), so the emitted
+		* `tool_call.args` — and any intent/outcome label resolved from them —
+		* reflect what the tool actually ran with. `runTool`'s own placeholder
+		* substitution may overwrite this entry with the post-substitution args,
+		* which is strictly more accurate.
+		*/
+		if (effectiveCall !== call && batchContext.resolvedArgsByCallId != null && call.id != null && call.id !== "") batchContext.resolvedArgsByCallId.set(call.id, effectiveCall.args);
 		const output = await this.runTool(effectiveCall, config, {
 			...batchContext,
 			usageCount
@@ -1174,7 +1197,8 @@ var ToolNode = class extends RunnableCallable {
 	*   by `runTool`. Threaded as a local map (instead of instance state)
 	*   so concurrent batches cannot read each other's entries.
 	*/
-	async handleRunToolCompletions(calls, outputs, config, resolvedArgsByCallId) {
+	async handleRunToolCompletions(calls, outputs, config, resolvedArgsByCallId, errorOwnership) {
+		const ownership = errorOwnership ?? this.looseErrorOwnership;
 		for (let i = 0; i < calls.length; i++) {
 			const call = calls[i];
 			const output = outputs[i];
@@ -1182,8 +1206,13 @@ var ToolNode = class extends RunnableCallable {
 			if (isCommand(output)) continue;
 			const toolMessage = output;
 			const toolCallId = call.id ?? "";
-			if (toolMessage.status === "error" && this.errorHandler != null) if (this.undispatchedToolErrors.has(toolCallId)) this.undispatchedToolErrors.delete(toolCallId);
-			else continue;
+			if (toolMessage.status === "error" && this.errorHandler != null) {
+				if (ownership.handlerOwned.has(toolCallId)) {
+					ownership.handlerOwned.delete(toolCallId);
+					continue;
+				}
+				ownership.undispatched.delete(toolCallId);
+			}
 			if (this.sessions && this.participatesInCodeSession(call.name)) {
 				const artifact = toolMessage.artifact;
 				const execSessionId = artifact?.session_id;
@@ -1195,16 +1224,27 @@ var ToolNode = class extends RunnableCallable {
 			if (isComputerCallOutputMessage(toolMessage)) contentString = truncateToolResultContent("[Computer screenshot omitted from completion event]", this.maxToolResultChars);
 			else if (typeof toolMessage.content === "string") contentString = toolMessage.content;
 			else contentString = serializeStructuredValueBounded(toolMessage.content, this.maxToolResultChars).content;
+			/**
+			* Prefer the post-substitution args when a `{{…}}` placeholder
+			* was resolved in `runTool`. This keeps
+			* `ON_RUN_STEP_COMPLETED.tool_call.args` consistent with what
+			* the tool actually received rather than leaking the template.
+			*/
+			const effectiveArgs = resolvedArgsByCallId?.get(toolCallId) ?? call.args;
+			/** Authored outcomes apply to failed calls too (“Search failed for…”);
+			*  without one, an error call simply stays unlabeled. */
+			const outcome = resolveToolOutcome(effectiveArgs, readOutcomeFields(toolMessage.artifact), { isError: toolMessage.status === "error" });
 			await safeDispatchCustomEvent("on_run_step_completed", { result: {
 				id: stepId,
 				index: turn,
 				type: "tool_call",
 				tool_call: {
-					args: serializeToolContentBounded(resolvedArgsByCallId?.get(toolCallId) ?? call.args ?? {}, this.maxToolResultChars),
+					args: serializeToolContentBounded(effectiveArgs ?? {}, this.maxToolResultChars),
 					name: call.name,
 					id: toolCallId,
 					output: contentString,
-					progress: 1
+					progress: 1,
+					...outcome != null && { outcome }
 				}
 			} }, config);
 		}
@@ -1253,7 +1293,7 @@ var ToolNode = class extends RunnableCallable {
 				resolvedArgs = pre.resolved;
 				if (pre.unresolved.length > 0 && call.id != null) unresolvedByCallId.set(call.id, pre.unresolved);
 			} else if (registry != null) {
-				const { resolved, unresolved } = registry.resolve(registryRunId, originalArgs);
+				const { resolved, unresolved } = registry.resolve(registryRunId, originalArgs, { substituteIntentKey: this.toolDeclaresBusinessIntent(call.name) });
 				resolvedArgs = resolved;
 				if (unresolved.length > 0 && call.id != null) unresolvedByCallId.set(call.id, unresolved);
 			}
@@ -1429,7 +1469,7 @@ var ToolNode = class extends RunnableCallable {
 			*/
 			const applyInputOverride = (entry, nextArgs) => {
 				if (registry != null) {
-					const { resolved, unresolved } = (preBatchSnapshot ?? { resolve: (args) => registry.resolve(registryRunId, args) }).resolve(nextArgs);
+					const { resolved, unresolved } = (preBatchSnapshot ?? { resolve: (args, options) => registry.resolve(registryRunId, args, options) }).resolve(nextArgs, { substituteIntentKey: this.toolDeclaresBusinessIntent(entry.call.name) });
 					entry.args = resolved;
 					if (entry.call.id != null) if (unresolved.length > 0) unresolvedByCallId.set(entry.call.id, unresolved);
 					else unresolvedByCallId.delete(entry.call.id);
@@ -1890,7 +1930,7 @@ var ToolNode = class extends RunnableCallable {
 						...successRefMeta != null && { additional_kwargs: successRefMeta }
 					});
 				}
-				if (!eagerCompletionDispatchedIds.has(result.toolCallId) && !earlyCompletionDispatchedIds.has(result.toolCallId)) await this.dispatchStepCompleted(result.toolCallId, toolName, request?.args ?? {}, contentString, config, request?.turn);
+				if (!eagerCompletionDispatchedIds.has(result.toolCallId) && !earlyCompletionDispatchedIds.has(result.toolCallId)) await this.dispatchStepCompleted(result.toolCallId, toolName, request?.args ?? {}, contentString, config, request?.turn, resolveToolOutcome(request?.args, outcomeFieldsFromResult(result), { isError: result.status === "error" }));
 				postToolBatchEntryByCallId.set(result.toolCallId, {
 					toolName,
 					toolInput: request?.args ?? {},
@@ -2026,7 +2066,21 @@ var ToolNode = class extends RunnableCallable {
 			console.warn("[ToolNode] Failed to convert PostToolBatch injectedMessages:", e instanceof Error ? e.message : e);
 		}
 	}
-	async dispatchStepCompleted(toolCallId, toolName, args, output, config, turn) {
+	/**
+	* Whether `name`'s own schema declares a BUSINESS parameter called
+	* `intent` (declared, and not the injected label contract — see
+	* `isIntentLabelProperty`). Such a parameter must keep participating in
+	* `{{tool…}}` placeholder substitution; only the display label is exempt.
+	*/
+	toolDeclaresBusinessIntent(name) {
+		const instance = this.toolMap.get(name);
+		const instanceProp = instance?.schema?.properties?.["intent"] ?? instance?.schema?.shape?.["intent"];
+		if (instanceProp != null) return !isIntentLabelProperty(instanceProp);
+		const defProp = this.toolRegistry?.get(name)?.parameters?.properties?.[INTENT_ARG];
+		if (defProp != null) return !isIntentLabelProperty(defProp);
+		return false;
+	}
+	async dispatchStepCompleted(toolCallId, toolName, args, output, config, turn, outcome) {
 		const stepId = this.toolCallStepIds?.get(toolCallId) ?? "";
 		if (!stepId) console.warn(`[ToolNode] toolCallStepIds missing entry for toolCallId=${toolCallId} (tool=${toolName}). This indicates a race between the stream consumer and graph execution. Map size: ${this.toolCallStepIds?.size ?? 0}`);
 		return await safeDispatchCustomEvent("on_run_step_completed", { result: {
@@ -2038,7 +2092,8 @@ var ToolNode = class extends RunnableCallable {
 				name: toolName,
 				id: toolCallId,
 				output,
-				progress: 1
+				progress: 1,
+				...outcome != null && { outcome }
 			}
 		} }, config) !== false;
 	}
@@ -2051,7 +2106,7 @@ var ToolNode = class extends RunnableCallable {
 	*/
 	async dispatchEarlyToolCompletion(result, request, config) {
 		const output = result.status === "error" ? truncateToolResultContent(`Error: ${result.errorMessage ?? "Unknown error"}\n Please fix your mistakes.`, this.maxToolResultChars) : serializeToolOutputWithinLimits(result.content, this.maxToolResultChars).content;
-		return this.dispatchStepCompleted(result.toolCallId, request.name, request.args, output, config, request.turn);
+		return this.dispatchStepCompleted(result.toolCallId, request.name, request.args, output, config, request.turn, resolveToolOutcome(request.args, outcomeFieldsFromResult(result), { isError: result.status === "error" }));
 	}
 	/**
 	* Execute a group of direct (in-process) tool calls with interrupt-safe
@@ -2132,6 +2187,8 @@ var ToolNode = class extends RunnableCallable {
 		* ToolNode cannot read or wipe each other's entries.
 		*/
 		const resolvedArgsByCallId = /* @__PURE__ */ new Map();
+		/** Per-invocation error-completion ownership — see `ToolErrorOwnership`. */
+		const errorOwnership = createToolErrorOwnership();
 		const batchScopeId = config.configurable?.run_id ?? `\0anon-${this.anonBatchCounter++}`;
 		const turn = this.toolOutputRegistry?.nextTurn(batchScopeId) ?? 0;
 		let outputs;
@@ -2149,6 +2206,7 @@ var ToolNode = class extends RunnableCallable {
 				turn,
 				batchScopeId,
 				resolvedArgsByCallId,
+				errorOwnership,
 				additionalContextsSink: directAdditionalContexts,
 				runInput: sendState
 			});
@@ -2159,7 +2217,7 @@ var ToolNode = class extends RunnableCallable {
 					source: "hook"
 				}
 			})] : [sendOutput];
-			await this.handleRunToolCompletions([input.lg_tool_call], [sendOutput], config, resolvedArgsByCallId);
+			await this.handleRunToolCompletions([input.lg_tool_call], [sendOutput], config, resolvedArgsByCallId, errorOwnership);
 		} else {
 			let messages;
 			if (Array.isArray(input)) messages = input;
@@ -2237,7 +2295,7 @@ var ToolNode = class extends RunnableCallable {
 				const preBatchSnapshot = this.toolOutputRegistry?.snapshot(batchScopeId);
 				if (preBatchSnapshot != null) {
 					for (const entry of eventEntries) if (entry.call.id != null) {
-						const { resolved, unresolved } = preBatchSnapshot.resolve(entry.call.args);
+						const { resolved, unresolved } = preBatchSnapshot.resolve(entry.call.args, { substituteIntentKey: this.toolDeclaresBusinessIntent(entry.call.name) });
 						preResolvedEventArgs.set(entry.call.id, {
 							resolved,
 							unresolved
@@ -2249,11 +2307,12 @@ var ToolNode = class extends RunnableCallable {
 					turn,
 					batchScopeId,
 					resolvedArgsByCallId,
+					errorOwnership,
 					preBatchSnapshot,
 					additionalContextsSink: directAdditionalContexts,
 					runInput: input
 				}) : [];
-				if (directCalls.length > 0 && directOutputs.length > 0) await this.handleRunToolCompletions(directCalls, directOutputs, config, resolvedArgsByCallId);
+				if (directCalls.length > 0 && directOutputs.length > 0) await this.handleRunToolCompletions(directCalls, directOutputs, config, resolvedArgsByCallId, errorOwnership);
 				const eventResult = eventCalls.length > 0 ? await this.dispatchToolEvents(eventCalls, config, {
 					batchIndices: eventIndices,
 					turn,
@@ -2284,11 +2343,12 @@ var ToolNode = class extends RunnableCallable {
 					turn,
 					batchScopeId,
 					resolvedArgsByCallId,
+					errorOwnership,
 					preBatchSnapshot,
 					additionalContextsSink: directAdditionalContexts,
 					runInput: input
 				});
-				await this.handleRunToolCompletions(filteredCalls, toolOutputs, config, resolvedArgsByCallId);
+				await this.handleRunToolCompletions(filteredCalls, toolOutputs, config, resolvedArgsByCallId, errorOwnership);
 				outputs = directAdditionalContexts.length > 0 ? [...toolOutputs, new HumanMessage({
 					content: directAdditionalContexts.join("\n\n"),
 					additional_kwargs: {
@@ -2394,6 +2454,6 @@ function toolsCondition(state, toolNode, invokedToolIds) {
 	return END;
 }
 //#endregion
-export { ToolNode, toolsCondition };
+export { ToolNode, createToolErrorOwnership, toolsCondition };
 
 //# sourceMappingURL=ToolNode.mjs.map