langchain 1.2.35 → 1.3.0-dev-1773962633795

package/dist/agents/types.d.ts

@@ -647,18 +647,10 @@ type CreateAgentParams<StructuredResponseType extends Record<string, any> = Reco
    * Determines the version of the graph to create.
    *
    * Can be one of
-   * - `"v1"`: The tool node processes the full `AIMessage` containing all tool calls. All tool
-   *           calls are executed concurrently via `Promise.all` inside a single graph node.
-   *           **Choose v1** when your tools invoke sub-graphs or other long-running async work
-   *           and you need true parallelism — the `Promise.all` approach is unaffected by
-   *           LangGraph's per-task checkpoint serialisation.
-   *
-   * - `"v2"`: Each tool call is dispatched as an independent graph task using the Send API.
-   *           Tasks are scheduled in parallel by LangGraph, but when tools invoke sub-graphs
-   *           the underlying checkpoint writes can cause effective serialisation, making
-   *           concurrent tool calls execute sequentially. v2 is the better choice when you
-   *           need per-tool-call checkpointing, independent fault isolation, or `interrupt()`
-   *           support inside individual tool calls.
+   * - `"v1"`: The tool node processes a single message. All tool calls in the message are
+   *           executed in parallel within the tool node.
+   * - `"v2"`: The tool node processes a single tool call. Tool calls are distributed across
+   *           multiple instances of the tool node using the Send API.
    *
    * @default `"v2"`
    */

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

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

package/dist/browser.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
 const require_chat_models_universal = require("./chat_models/universal.cjs");
+const require_headless = require("./tools/headless.cjs");
 let _langchain_core_messages = require("@langchain/core/messages");
 let _langchain_core_tools = require("@langchain/core/tools");
 let _langchain_core_utils_context = require("@langchain/core/utils/context");
@@ -30,7 +31,7 @@ var browser_exports = /* @__PURE__ */ require_runtime.__exportAll({
 	filterMessages: () => _langchain_core_messages.filterMessages,
 	initChatModel: () => require_chat_models_universal.initChatModel,
 	langchainMatchers: () => _langchain_core_testing.langchainMatchers,
-	tool: () => _langchain_core_tools.tool,
+	tool: () => require_headless.tool,
 	trimMessages: () => _langchain_core_messages.trimMessages
 });
 //#endregion
@@ -161,12 +162,7 @@ Object.defineProperty(exports, "langchainMatchers", {
 		return _langchain_core_testing.langchainMatchers;
 	}
 });
-Object.defineProperty(exports, "tool", {
-	enumerable: true,
-	get: function() {
-		return _langchain_core_tools.tool;
-	}
-});
+exports.tool = require_headless.tool;
 Object.defineProperty(exports, "trimMessages", {
 	enumerable: true,
 	get: function() {

package/dist/browser.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"browser.cjs","names":[],"sources":["../src/browser.ts"],"sourcesContent":["/**\n * LangChain browser exports\n */\n\n/**\n * LangChain Messages\n */\nexport {\n  BaseMessage,\n  BaseMessageChunk,\n  AIMessage,\n  AIMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n  type ContentBlock,\n  filterMessages,\n  trimMessages,\n} from \"@langchain/core/messages\";\n\n/**\n * Universal Chat Model\n */\nexport { initChatModel } from \"./chat_models/universal.js\";\n\n/**\n * LangChain Tools\n */\nexport {\n  tool,\n  Tool,\n  type ToolRuntime,\n  DynamicTool,\n  StructuredTool,\n  DynamicStructuredTool,\n} from \"@langchain/core/tools\";\n\n/**\n * LangChain utilities\n */\nexport { context } from \"@langchain/core/utils/context\";\n\n/**\n * LangChain Stores\n */\nexport { InMemoryStore } from \"@langchain/core/stores\";\n\n/**\n * LangChain Documents\n */\nexport { type DocumentInput, Document } from \"@langchain/core/documents\";\n\n/**\n * LangChain Testing Utilities\n */\nexport {\n  langchainMatchers,\n  type LangChainMatchers,\n  fakeModel,\n} from \"@langchain/core/testing\";\n"],"mappings":""}
+{"version":3,"file":"browser.cjs","names":[],"sources":["../src/browser.ts"],"sourcesContent":["/**\n * LangChain browser exports\n */\n\n/**\n * LangChain Messages\n */\nexport {\n  BaseMessage,\n  BaseMessageChunk,\n  AIMessage,\n  AIMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n  type ContentBlock,\n  filterMessages,\n  trimMessages,\n} from \"@langchain/core/messages\";\n\n/**\n * Universal Chat Model\n */\nexport { initChatModel } from \"./chat_models/universal.js\";\n\n/**\n * LangChain Tools\n */\nexport {\n  Tool,\n  type ToolRuntime,\n  DynamicTool,\n  StructuredTool,\n  DynamicStructuredTool,\n} from \"@langchain/core/tools\";\n\n/**\n * LangChain tool primitive (supports both normal and headless tools)\n */\nexport {\n  tool,\n  type HeadlessTool,\n  type HeadlessToolFields,\n  type HeadlessToolImplementation,\n} from \"./tools/headless.js\";\n\n/**\n * LangChain utilities\n */\nexport { context } from \"@langchain/core/utils/context\";\n\n/**\n * LangChain Stores\n */\nexport { InMemoryStore } from \"@langchain/core/stores\";\n\n/**\n * LangChain Documents\n */\nexport { type DocumentInput, Document } from \"@langchain/core/documents\";\n\n/**\n * LangChain Testing Utilities\n */\nexport {\n  langchainMatchers,\n  type LangChainMatchers,\n  fakeModel,\n} from \"@langchain/core/testing\";\n"],"mappings":""}

package/dist/browser.d.cts

@@ -1,8 +1,9 @@
 import { initChatModel } from "./chat_models/universal.cjs";
+import { HeadlessTool, HeadlessToolFields, HeadlessToolImplementation, tool } from "./tools/headless.cjs";
 import { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, ContentBlock, HumanMessage, HumanMessageChunk, SystemMessage, SystemMessageChunk, ToolMessage, ToolMessageChunk, filterMessages, trimMessages } from "@langchain/core/messages";
-import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, ToolRuntime, tool } from "@langchain/core/tools";
+import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, ToolRuntime } from "@langchain/core/tools";
 import { context } from "@langchain/core/utils/context";
 import { InMemoryStore } from "@langchain/core/stores";
 import { Document, DocumentInput } from "@langchain/core/documents";
 import { LangChainMatchers, fakeModel, langchainMatchers } from "@langchain/core/testing";
-export { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, type ContentBlock, Document, type DocumentInput, DynamicStructuredTool, DynamicTool, HumanMessage, HumanMessageChunk, InMemoryStore, type LangChainMatchers, StructuredTool, SystemMessage, SystemMessageChunk, Tool, ToolMessage, ToolMessageChunk, type ToolRuntime, context, fakeModel, filterMessages, initChatModel, langchainMatchers, tool, trimMessages };
+export { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, type ContentBlock, Document, type DocumentInput, DynamicStructuredTool, DynamicTool, type HeadlessTool, type HeadlessToolFields, type HeadlessToolImplementation, HumanMessage, HumanMessageChunk, InMemoryStore, type LangChainMatchers, StructuredTool, SystemMessage, SystemMessageChunk, Tool, ToolMessage, ToolMessageChunk, type ToolRuntime, context, fakeModel, filterMessages, initChatModel, langchainMatchers, tool, trimMessages };

package/dist/browser.d.ts

@@ -1,8 +1,9 @@
 import { initChatModel } from "./chat_models/universal.js";
+import { HeadlessTool, HeadlessToolFields, HeadlessToolImplementation, tool } from "./tools/headless.js";
 import { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, ContentBlock, HumanMessage, HumanMessageChunk, SystemMessage, SystemMessageChunk, ToolMessage, ToolMessageChunk, filterMessages, trimMessages } from "@langchain/core/messages";
-import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, ToolRuntime, tool } from "@langchain/core/tools";
+import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, ToolRuntime } from "@langchain/core/tools";
 import { context } from "@langchain/core/utils/context";
 import { InMemoryStore } from "@langchain/core/stores";
 import { Document, DocumentInput } from "@langchain/core/documents";
 import { LangChainMatchers, fakeModel, langchainMatchers } from "@langchain/core/testing";
-export { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, type ContentBlock, Document, type DocumentInput, DynamicStructuredTool, DynamicTool, HumanMessage, HumanMessageChunk, InMemoryStore, type LangChainMatchers, StructuredTool, SystemMessage, SystemMessageChunk, Tool, ToolMessage, ToolMessageChunk, type ToolRuntime, context, fakeModel, filterMessages, initChatModel, langchainMatchers, tool, trimMessages };
+export { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, type ContentBlock, Document, type DocumentInput, DynamicStructuredTool, DynamicTool, type HeadlessTool, type HeadlessToolFields, type HeadlessToolImplementation, HumanMessage, HumanMessageChunk, InMemoryStore, type LangChainMatchers, StructuredTool, SystemMessage, SystemMessageChunk, Tool, ToolMessage, ToolMessageChunk, type ToolRuntime, context, fakeModel, filterMessages, initChatModel, langchainMatchers, tool, trimMessages };

package/dist/browser.js

@@ -1,7 +1,8 @@
 import { __exportAll } from "./_virtual/_rolldown/runtime.js";
 import { initChatModel } from "./chat_models/universal.js";
+import { tool } from "./tools/headless.js";
 import { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, HumanMessage, HumanMessageChunk, SystemMessage, SystemMessageChunk, ToolMessage, ToolMessageChunk, filterMessages, trimMessages } from "@langchain/core/messages";
-import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, tool } from "@langchain/core/tools";
+import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool } from "@langchain/core/tools";
 import { context } from "@langchain/core/utils/context";
 import { InMemoryStore } from "@langchain/core/stores";
 import { Document } from "@langchain/core/documents";

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","names":[],"sources":["../src/browser.ts"],"sourcesContent":["/**\n * LangChain browser exports\n */\n\n/**\n * LangChain Messages\n */\nexport {\n  BaseMessage,\n  BaseMessageChunk,\n  AIMessage,\n  AIMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n  type ContentBlock,\n  filterMessages,\n  trimMessages,\n} from \"@langchain/core/messages\";\n\n/**\n * Universal Chat Model\n */\nexport { initChatModel } from \"./chat_models/universal.js\";\n\n/**\n * LangChain Tools\n */\nexport {\n  tool,\n  Tool,\n  type ToolRuntime,\n  DynamicTool,\n  StructuredTool,\n  DynamicStructuredTool,\n} from \"@langchain/core/tools\";\n\n/**\n * LangChain utilities\n */\nexport { context } from \"@langchain/core/utils/context\";\n\n/**\n * LangChain Stores\n */\nexport { InMemoryStore } from \"@langchain/core/stores\";\n\n/**\n * LangChain Documents\n */\nexport { type DocumentInput, Document } from \"@langchain/core/documents\";\n\n/**\n * LangChain Testing Utilities\n */\nexport {\n  langchainMatchers,\n  type LangChainMatchers,\n  fakeModel,\n} from \"@langchain/core/testing\";\n"],"mappings":""}
+{"version":3,"file":"browser.js","names":[],"sources":["../src/browser.ts"],"sourcesContent":["/**\n * LangChain browser exports\n */\n\n/**\n * LangChain Messages\n */\nexport {\n  BaseMessage,\n  BaseMessageChunk,\n  AIMessage,\n  AIMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n  type ContentBlock,\n  filterMessages,\n  trimMessages,\n} from \"@langchain/core/messages\";\n\n/**\n * Universal Chat Model\n */\nexport { initChatModel } from \"./chat_models/universal.js\";\n\n/**\n * LangChain Tools\n */\nexport {\n  Tool,\n  type ToolRuntime,\n  DynamicTool,\n  StructuredTool,\n  DynamicStructuredTool,\n} from \"@langchain/core/tools\";\n\n/**\n * LangChain tool primitive (supports both normal and headless tools)\n */\nexport {\n  tool,\n  type HeadlessTool,\n  type HeadlessToolFields,\n  type HeadlessToolImplementation,\n} from \"./tools/headless.js\";\n\n/**\n * LangChain utilities\n */\nexport { context } from \"@langchain/core/utils/context\";\n\n/**\n * LangChain Stores\n */\nexport { InMemoryStore } from \"@langchain/core/stores\";\n\n/**\n * LangChain Documents\n */\nexport { type DocumentInput, Document } from \"@langchain/core/documents\";\n\n/**\n * LangChain Testing Utilities\n */\nexport {\n  langchainMatchers,\n  type LangChainMatchers,\n  fakeModel,\n} from \"@langchain/core/testing\";\n"],"mappings":""}

package/dist/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
 const require_chat_models_universal = require("./chat_models/universal.cjs");
+const require_headless = require("./tools/headless.cjs");
 const require_errors = require("./agents/errors.cjs");
 const require_responses = require("./agents/responses.cjs");
 const require_utils = require("./agents/middleware/utils.cjs");
@@ -91,7 +92,7 @@ var src_exports = /* @__PURE__ */ require_runtime.__exportAll({
 	resolveRedactionRule: () => require_pii.resolveRedactionRule,
 	summarizationMiddleware: () => require_summarization.summarizationMiddleware,
 	todoListMiddleware: () => require_todoListMiddleware.todoListMiddleware,
-	tool: () => _langchain_core_tools.tool,
+	tool: () => require_headless.tool,
 	toolCallLimitMiddleware: () => require_toolCallLimit.toolCallLimitMiddleware,
 	toolEmulatorMiddleware: () => require_toolEmulator.toolEmulatorMiddleware,
 	toolRetryMiddleware: () => require_toolRetry.toolRetryMiddleware,
@@ -263,12 +264,7 @@ Object.defineProperty(exports, "src_exports", {
 });
 exports.summarizationMiddleware = require_summarization.summarizationMiddleware;
 exports.todoListMiddleware = require_todoListMiddleware.todoListMiddleware;
-Object.defineProperty(exports, "tool", {
-	enumerable: true,
-	get: function() {
-		return _langchain_core_tools.tool;
-	}
-});
+exports.tool = require_headless.tool;
 exports.toolCallLimitMiddleware = require_toolCallLimit.toolCallLimitMiddleware;
 exports.toolEmulatorMiddleware = require_toolEmulator.toolEmulatorMiddleware;
 exports.toolRetryMiddleware = require_toolRetry.toolRetryMiddleware;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * LangChain Messages\n */\nexport {\n  BaseMessage,\n  BaseMessageChunk,\n  AIMessage,\n  AIMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n  type ContentBlock,\n  filterMessages,\n  trimMessages,\n} from \"@langchain/core/messages\";\n\n/**\n * Universal Chat Model\n */\nexport { initChatModel } from \"./chat_models/universal.js\";\n\n/**\n * LangChain Tools\n */\nexport {\n  tool,\n  Tool,\n  type ToolRuntime,\n  DynamicTool,\n  StructuredTool,\n  DynamicStructuredTool,\n} from \"@langchain/core/tools\";\n\n/**\n * LangChain utilities\n */\nexport { context } from \"@langchain/core/utils/context\";\n\n/**\n * LangChain Agents\n */\nexport * from \"./agents/index.js\";\n\n/**\n * `createAgent` pre-built middleware\n */\nexport * from \"./agents/middleware/index.js\";\n\n/**\n * LangChain Stores\n */\nexport { InMemoryStore } from \"@langchain/core/stores\";\n\n/**\n * LangChain Documents\n */\nexport { type DocumentInput, Document } from \"@langchain/core/documents\";\n\n/**\n * LangChain Testing Utilities\n */\nexport {\n  langchainMatchers,\n  type LangChainMatchers,\n  fakeModel,\n} from \"@langchain/core/testing\";\n"],"mappings":""}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * LangChain Messages\n */\nexport {\n  BaseMessage,\n  BaseMessageChunk,\n  AIMessage,\n  AIMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n  type ContentBlock,\n  filterMessages,\n  trimMessages,\n} from \"@langchain/core/messages\";\n\n/**\n * Universal Chat Model\n */\nexport { initChatModel } from \"./chat_models/universal.js\";\n\n/**\n * LangChain Tools with support for headless tools\n */\nexport {\n  tool,\n  type HeadlessTool,\n  type HeadlessToolFields,\n  type HeadlessToolImplementation,\n} from \"./tools/headless.js\";\n\n/**\n * LangChain Core Tool Primitives\n */\nexport {\n  Tool,\n  type ToolRuntime,\n  DynamicTool,\n  StructuredTool,\n  DynamicStructuredTool,\n} from \"@langchain/core/tools\";\n\n/**\n * LangChain utilities\n */\nexport { context } from \"@langchain/core/utils/context\";\n\n/**\n * LangChain Agents\n */\nexport * from \"./agents/index.js\";\n\n/**\n * `createAgent` pre-built middleware\n */\nexport * from \"./agents/middleware/index.js\";\n\n/**\n * LangChain Stores\n */\nexport { InMemoryStore } from \"@langchain/core/stores\";\n\n/**\n * LangChain Documents\n */\nexport { type DocumentInput, Document } from \"@langchain/core/documents\";\n\n/**\n * LangChain Testing Utilities\n */\nexport {\n  langchainMatchers,\n  type LangChainMatchers,\n  fakeModel,\n} from \"@langchain/core/testing\";\n"],"mappings":""}

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { initChatModel } from "./chat_models/universal.cjs";
+import { HeadlessTool, HeadlessToolFields, HeadlessToolImplementation, tool } from "./tools/headless.cjs";
 import { MiddlewareError, MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError } from "./agents/errors.cjs";
 import { ProviderStrategy, ResponseFormat, ResponseFormatUndefined, ToolStrategy, TypedToolStrategy, providerStrategy, toolStrategy } from "./agents/responses.cjs";
 import { JumpToTarget } from "./agents/constants.cjs";
@@ -28,9 +29,9 @@ import { OpenAIModerationMiddlewareOptions, openAIModerationMiddleware } from ".
 import { PromptCachingMiddlewareConfig, anthropicPromptCachingMiddleware } from "./agents/middleware/provider/anthropic/promptCaching.cjs";
 import { countTokensApproximately } from "./agents/middleware/utils.cjs";
 import { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, ContentBlock, HumanMessage, HumanMessageChunk, SystemMessage, SystemMessageChunk, ToolMessage, ToolMessageChunk, filterMessages, trimMessages } from "@langchain/core/messages";
-import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, ToolRuntime, tool } from "@langchain/core/tools";
+import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, ToolRuntime } from "@langchain/core/tools";
 import { context } from "@langchain/core/utils/context";
 import { InMemoryStore } from "@langchain/core/stores";
 import { Document, DocumentInput } from "@langchain/core/documents";
 import { LangChainMatchers, fakeModel, langchainMatchers } from "@langchain/core/testing";
-export { AIMessage, AIMessageChunk, Action, ActionRequest, AfterAgentHook, AfterModelHook, AgentMiddleware, AgentTypeConfig, AnyAnnotationRoot, ApproveDecision, BaseMessage, BaseMessageChunk, BeforeAgentHook, BeforeModelHook, BuiltInPIIType, BuiltInState, ClearToolUsesEdit, ClearToolUsesEditConfig, CombineTools, type ContentBlock, ContextEdit, ContextEditingMiddlewareConfig, CreateAgentParams, Decision, DecisionType, DefaultAgentTypeConfig, DefaultMiddlewareTypeConfig, DescriptionFactory, Document, type DocumentInput, DynamicStructuredTool, DynamicSystemPromptMiddlewareConfig, DynamicTool, EditDecision, ExecutedToolCall, ExtractZodArrayTypes, FakeToolCallingModel, HITLRequest, HITLResponse, HumanInTheLoopMiddlewareConfig, HumanMessage, HumanMessageChunk, InMemoryStore, InferAgentContext, InferAgentContextSchema, InferAgentMiddleware, InferAgentResponse, InferAgentState, InferAgentStateSchema, InferAgentTools, InferAgentType, InferChannelType, InferContextInput, InferMergedInputState, InferMergedState, InferMiddlewareContext, InferMiddlewareContextInput, InferMiddlewareContextInputs, InferMiddlewareContextSchema, InferMiddlewareContexts, InferMiddlewareFullContext, InferMiddlewareInputState, InferMiddlewareInputStates, InferMiddlewareSchema, InferMiddlewareState, InferMiddlewareStates, InferMiddlewareTools, InferMiddlewareToolsArray, InferMiddlewareToolsFromConfig, InferMiddlewareType, InferSchemaInput, InferSchemaUpdateType, InferSchemaValue, InferSchemaValueType, Interrupt, InterruptOnConfig, JumpTo, JumpToTarget, LLMToolSelectorConfig, type LangChainMatchers, MIDDLEWARE_BRAND, MiddlewareError, MiddlewareResult, MiddlewareTypeConfig, ModelCallLimitMiddlewareConfig, ModelRequest, ModelRetryMiddlewareConfig, MultipleStructuredOutputsError, MultipleToolsBoundError, N, NormalizedSchemaInput, NormalizedSchemaUpdate, OpenAIModerationMiddlewareOptions, PIIDetectionError, PIIDetector, PIIMatch, PIIMiddlewareConfig, PIIRedactionMiddlewareConfig, PIIStrategy, PromptCachingMiddlewareConfig, ProviderStrategy, ReactAgent, RedactionRuleConfig, RejectDecision, ResolveAgentTypeConfig, ResolveMiddlewareTypeConfig, ResolvedRedactionRule, ResponseFormat, ResponseFormatUndefined, ReviewConfig, Runtime, StructuredOutputParsingError, StructuredTool, SummarizationMiddlewareConfig, SystemMessage, SystemMessageChunk, TODO_LIST_MIDDLEWARE_SYSTEM_PROMPT, ToAnnotationRoot, Todo, TodoListMiddlewareOptions, TokenCounter, Tool, ToolCall, ToolCallHandler, ToolCallLimitConfig, ToolCallLimitExceededError, ToolCallRequest, ToolEmulatorOptions, ToolInvocationError, ToolMessage, ToolMessageChunk, ToolResult, ToolRetryMiddlewareConfig, type ToolRuntime, ToolStrategy, ToolsToMessageToolSet, TypedToolStrategy, UserInput, WithStateGraphNodes, WrapModelCallHandler, WrapModelCallHook, WrapToolCallHook, anthropicPromptCachingMiddleware, applyStrategy, context, contextEditingMiddleware, countTokensApproximately, createAgent, createMiddleware, detectCreditCard, detectEmail, detectIP, detectMacAddress, detectUrl, dynamicSystemPromptMiddleware, fakeModel, filterMessages, humanInTheLoopMiddleware, initChatModel, langchainMatchers, llmToolSelectorMiddleware, modelCallLimitMiddleware, modelFallbackMiddleware, modelRetryMiddleware, openAIModerationMiddleware, piiMiddleware, piiRedactionMiddleware, providerStrategy, resolveRedactionRule, summarizationMiddleware, todoListMiddleware, tool, toolCallLimitMiddleware, toolEmulatorMiddleware, toolRetryMiddleware, toolStrategy, trimMessages };
+export { AIMessage, AIMessageChunk, Action, ActionRequest, AfterAgentHook, AfterModelHook, AgentMiddleware, AgentTypeConfig, AnyAnnotationRoot, ApproveDecision, BaseMessage, BaseMessageChunk, BeforeAgentHook, BeforeModelHook, BuiltInPIIType, BuiltInState, ClearToolUsesEdit, ClearToolUsesEditConfig, CombineTools, type ContentBlock, ContextEdit, ContextEditingMiddlewareConfig, CreateAgentParams, Decision, DecisionType, DefaultAgentTypeConfig, DefaultMiddlewareTypeConfig, DescriptionFactory, Document, type DocumentInput, DynamicStructuredTool, DynamicSystemPromptMiddlewareConfig, DynamicTool, EditDecision, ExecutedToolCall, ExtractZodArrayTypes, FakeToolCallingModel, HITLRequest, HITLResponse, type HeadlessTool, type HeadlessToolFields, type HeadlessToolImplementation, HumanInTheLoopMiddlewareConfig, HumanMessage, HumanMessageChunk, InMemoryStore, InferAgentContext, InferAgentContextSchema, InferAgentMiddleware, InferAgentResponse, InferAgentState, InferAgentStateSchema, InferAgentTools, InferAgentType, InferChannelType, InferContextInput, InferMergedInputState, InferMergedState, InferMiddlewareContext, InferMiddlewareContextInput, InferMiddlewareContextInputs, InferMiddlewareContextSchema, InferMiddlewareContexts, InferMiddlewareFullContext, InferMiddlewareInputState, InferMiddlewareInputStates, InferMiddlewareSchema, InferMiddlewareState, InferMiddlewareStates, InferMiddlewareTools, InferMiddlewareToolsArray, InferMiddlewareToolsFromConfig, InferMiddlewareType, InferSchemaInput, InferSchemaUpdateType, InferSchemaValue, InferSchemaValueType, Interrupt, InterruptOnConfig, JumpTo, JumpToTarget, LLMToolSelectorConfig, type LangChainMatchers, MIDDLEWARE_BRAND, MiddlewareError, MiddlewareResult, MiddlewareTypeConfig, ModelCallLimitMiddlewareConfig, ModelRequest, ModelRetryMiddlewareConfig, MultipleStructuredOutputsError, MultipleToolsBoundError, N, NormalizedSchemaInput, NormalizedSchemaUpdate, OpenAIModerationMiddlewareOptions, PIIDetectionError, PIIDetector, PIIMatch, PIIMiddlewareConfig, PIIRedactionMiddlewareConfig, PIIStrategy, PromptCachingMiddlewareConfig, ProviderStrategy, ReactAgent, RedactionRuleConfig, RejectDecision, ResolveAgentTypeConfig, ResolveMiddlewareTypeConfig, ResolvedRedactionRule, ResponseFormat, ResponseFormatUndefined, ReviewConfig, Runtime, StructuredOutputParsingError, StructuredTool, SummarizationMiddlewareConfig, SystemMessage, SystemMessageChunk, TODO_LIST_MIDDLEWARE_SYSTEM_PROMPT, ToAnnotationRoot, Todo, TodoListMiddlewareOptions, TokenCounter, Tool, ToolCall, ToolCallHandler, ToolCallLimitConfig, ToolCallLimitExceededError, ToolCallRequest, ToolEmulatorOptions, ToolInvocationError, ToolMessage, ToolMessageChunk, ToolResult, ToolRetryMiddlewareConfig, type ToolRuntime, ToolStrategy, ToolsToMessageToolSet, TypedToolStrategy, UserInput, WithStateGraphNodes, WrapModelCallHandler, WrapModelCallHook, WrapToolCallHook, anthropicPromptCachingMiddleware, applyStrategy, context, contextEditingMiddleware, countTokensApproximately, createAgent, createMiddleware, detectCreditCard, detectEmail, detectIP, detectMacAddress, detectUrl, dynamicSystemPromptMiddleware, fakeModel, filterMessages, humanInTheLoopMiddleware, initChatModel, langchainMatchers, llmToolSelectorMiddleware, modelCallLimitMiddleware, modelFallbackMiddleware, modelRetryMiddleware, openAIModerationMiddleware, piiMiddleware, piiRedactionMiddleware, providerStrategy, resolveRedactionRule, summarizationMiddleware, todoListMiddleware, tool, toolCallLimitMiddleware, toolEmulatorMiddleware, toolRetryMiddleware, toolStrategy, trimMessages };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { initChatModel } from "./chat_models/universal.js";
+import { HeadlessTool, HeadlessToolFields, HeadlessToolImplementation, tool } from "./tools/headless.js";
 import { MiddlewareError, MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError } from "./agents/errors.js";
 import { ProviderStrategy, ResponseFormat, ResponseFormatUndefined, ToolStrategy, TypedToolStrategy, providerStrategy, toolStrategy } from "./agents/responses.js";
 import { JumpToTarget } from "./agents/constants.js";
@@ -28,9 +29,9 @@ import { OpenAIModerationMiddlewareOptions, openAIModerationMiddleware } from ".
 import { PromptCachingMiddlewareConfig, anthropicPromptCachingMiddleware } from "./agents/middleware/provider/anthropic/promptCaching.js";
 import { countTokensApproximately } from "./agents/middleware/utils.js";
 import { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, ContentBlock, HumanMessage, HumanMessageChunk, SystemMessage, SystemMessageChunk, ToolMessage, ToolMessageChunk, filterMessages, trimMessages } from "@langchain/core/messages";
-import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, ToolRuntime, tool } from "@langchain/core/tools";
+import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, ToolRuntime } from "@langchain/core/tools";
 import { context } from "@langchain/core/utils/context";
 import { InMemoryStore } from "@langchain/core/stores";
 import { Document, DocumentInput } from "@langchain/core/documents";
 import { LangChainMatchers, fakeModel, langchainMatchers } from "@langchain/core/testing";
-export { AIMessage, AIMessageChunk, Action, ActionRequest, AfterAgentHook, AfterModelHook, AgentMiddleware, AgentTypeConfig, AnyAnnotationRoot, ApproveDecision, BaseMessage, BaseMessageChunk, BeforeAgentHook, BeforeModelHook, BuiltInPIIType, BuiltInState, ClearToolUsesEdit, ClearToolUsesEditConfig, CombineTools, type ContentBlock, ContextEdit, ContextEditingMiddlewareConfig, CreateAgentParams, Decision, DecisionType, DefaultAgentTypeConfig, DefaultMiddlewareTypeConfig, DescriptionFactory, Document, type DocumentInput, DynamicStructuredTool, DynamicSystemPromptMiddlewareConfig, DynamicTool, EditDecision, ExecutedToolCall, ExtractZodArrayTypes, FakeToolCallingModel, HITLRequest, HITLResponse, HumanInTheLoopMiddlewareConfig, HumanMessage, HumanMessageChunk, InMemoryStore, InferAgentContext, InferAgentContextSchema, InferAgentMiddleware, InferAgentResponse, InferAgentState, InferAgentStateSchema, InferAgentTools, InferAgentType, InferChannelType, InferContextInput, InferMergedInputState, InferMergedState, InferMiddlewareContext, InferMiddlewareContextInput, InferMiddlewareContextInputs, InferMiddlewareContextSchema, InferMiddlewareContexts, InferMiddlewareFullContext, InferMiddlewareInputState, InferMiddlewareInputStates, InferMiddlewareSchema, InferMiddlewareState, InferMiddlewareStates, InferMiddlewareTools, InferMiddlewareToolsArray, InferMiddlewareToolsFromConfig, InferMiddlewareType, InferSchemaInput, InferSchemaUpdateType, InferSchemaValue, InferSchemaValueType, Interrupt, InterruptOnConfig, JumpTo, JumpToTarget, LLMToolSelectorConfig, type LangChainMatchers, MIDDLEWARE_BRAND, MiddlewareError, MiddlewareResult, MiddlewareTypeConfig, ModelCallLimitMiddlewareConfig, ModelRequest, ModelRetryMiddlewareConfig, MultipleStructuredOutputsError, MultipleToolsBoundError, N, NormalizedSchemaInput, NormalizedSchemaUpdate, OpenAIModerationMiddlewareOptions, PIIDetectionError, PIIDetector, PIIMatch, PIIMiddlewareConfig, PIIRedactionMiddlewareConfig, PIIStrategy, PromptCachingMiddlewareConfig, ProviderStrategy, ReactAgent, RedactionRuleConfig, RejectDecision, ResolveAgentTypeConfig, ResolveMiddlewareTypeConfig, ResolvedRedactionRule, ResponseFormat, ResponseFormatUndefined, ReviewConfig, Runtime, StructuredOutputParsingError, StructuredTool, SummarizationMiddlewareConfig, SystemMessage, SystemMessageChunk, TODO_LIST_MIDDLEWARE_SYSTEM_PROMPT, ToAnnotationRoot, Todo, TodoListMiddlewareOptions, TokenCounter, Tool, ToolCall, ToolCallHandler, ToolCallLimitConfig, ToolCallLimitExceededError, ToolCallRequest, ToolEmulatorOptions, ToolInvocationError, ToolMessage, ToolMessageChunk, ToolResult, ToolRetryMiddlewareConfig, type ToolRuntime, ToolStrategy, ToolsToMessageToolSet, TypedToolStrategy, UserInput, WithStateGraphNodes, WrapModelCallHandler, WrapModelCallHook, WrapToolCallHook, anthropicPromptCachingMiddleware, applyStrategy, context, contextEditingMiddleware, countTokensApproximately, createAgent, createMiddleware, detectCreditCard, detectEmail, detectIP, detectMacAddress, detectUrl, dynamicSystemPromptMiddleware, fakeModel, filterMessages, humanInTheLoopMiddleware, initChatModel, langchainMatchers, llmToolSelectorMiddleware, modelCallLimitMiddleware, modelFallbackMiddleware, modelRetryMiddleware, openAIModerationMiddleware, piiMiddleware, piiRedactionMiddleware, providerStrategy, resolveRedactionRule, summarizationMiddleware, todoListMiddleware, tool, toolCallLimitMiddleware, toolEmulatorMiddleware, toolRetryMiddleware, toolStrategy, trimMessages };
+export { AIMessage, AIMessageChunk, Action, ActionRequest, AfterAgentHook, AfterModelHook, AgentMiddleware, AgentTypeConfig, AnyAnnotationRoot, ApproveDecision, BaseMessage, BaseMessageChunk, BeforeAgentHook, BeforeModelHook, BuiltInPIIType, BuiltInState, ClearToolUsesEdit, ClearToolUsesEditConfig, CombineTools, type ContentBlock, ContextEdit, ContextEditingMiddlewareConfig, CreateAgentParams, Decision, DecisionType, DefaultAgentTypeConfig, DefaultMiddlewareTypeConfig, DescriptionFactory, Document, type DocumentInput, DynamicStructuredTool, DynamicSystemPromptMiddlewareConfig, DynamicTool, EditDecision, ExecutedToolCall, ExtractZodArrayTypes, FakeToolCallingModel, HITLRequest, HITLResponse, type HeadlessTool, type HeadlessToolFields, type HeadlessToolImplementation, HumanInTheLoopMiddlewareConfig, HumanMessage, HumanMessageChunk, InMemoryStore, InferAgentContext, InferAgentContextSchema, InferAgentMiddleware, InferAgentResponse, InferAgentState, InferAgentStateSchema, InferAgentTools, InferAgentType, InferChannelType, InferContextInput, InferMergedInputState, InferMergedState, InferMiddlewareContext, InferMiddlewareContextInput, InferMiddlewareContextInputs, InferMiddlewareContextSchema, InferMiddlewareContexts, InferMiddlewareFullContext, InferMiddlewareInputState, InferMiddlewareInputStates, InferMiddlewareSchema, InferMiddlewareState, InferMiddlewareStates, InferMiddlewareTools, InferMiddlewareToolsArray, InferMiddlewareToolsFromConfig, InferMiddlewareType, InferSchemaInput, InferSchemaUpdateType, InferSchemaValue, InferSchemaValueType, Interrupt, InterruptOnConfig, JumpTo, JumpToTarget, LLMToolSelectorConfig, type LangChainMatchers, MIDDLEWARE_BRAND, MiddlewareError, MiddlewareResult, MiddlewareTypeConfig, ModelCallLimitMiddlewareConfig, ModelRequest, ModelRetryMiddlewareConfig, MultipleStructuredOutputsError, MultipleToolsBoundError, N, NormalizedSchemaInput, NormalizedSchemaUpdate, OpenAIModerationMiddlewareOptions, PIIDetectionError, PIIDetector, PIIMatch, PIIMiddlewareConfig, PIIRedactionMiddlewareConfig, PIIStrategy, PromptCachingMiddlewareConfig, ProviderStrategy, ReactAgent, RedactionRuleConfig, RejectDecision, ResolveAgentTypeConfig, ResolveMiddlewareTypeConfig, ResolvedRedactionRule, ResponseFormat, ResponseFormatUndefined, ReviewConfig, Runtime, StructuredOutputParsingError, StructuredTool, SummarizationMiddlewareConfig, SystemMessage, SystemMessageChunk, TODO_LIST_MIDDLEWARE_SYSTEM_PROMPT, ToAnnotationRoot, Todo, TodoListMiddlewareOptions, TokenCounter, Tool, ToolCall, ToolCallHandler, ToolCallLimitConfig, ToolCallLimitExceededError, ToolCallRequest, ToolEmulatorOptions, ToolInvocationError, ToolMessage, ToolMessageChunk, ToolResult, ToolRetryMiddlewareConfig, type ToolRuntime, ToolStrategy, ToolsToMessageToolSet, TypedToolStrategy, UserInput, WithStateGraphNodes, WrapModelCallHandler, WrapModelCallHook, WrapToolCallHook, anthropicPromptCachingMiddleware, applyStrategy, context, contextEditingMiddleware, countTokensApproximately, createAgent, createMiddleware, detectCreditCard, detectEmail, detectIP, detectMacAddress, detectUrl, dynamicSystemPromptMiddleware, fakeModel, filterMessages, humanInTheLoopMiddleware, initChatModel, langchainMatchers, llmToolSelectorMiddleware, modelCallLimitMiddleware, modelFallbackMiddleware, modelRetryMiddleware, openAIModerationMiddleware, piiMiddleware, piiRedactionMiddleware, providerStrategy, resolveRedactionRule, summarizationMiddleware, todoListMiddleware, tool, toolCallLimitMiddleware, toolEmulatorMiddleware, toolRetryMiddleware, toolStrategy, trimMessages };

package/dist/index.js

@@ -1,5 +1,6 @@
 import { __exportAll } from "./_virtual/_rolldown/runtime.js";
 import { initChatModel } from "./chat_models/universal.js";
+import { tool } from "./tools/headless.js";
 import { MiddlewareError, MultipleStructuredOutputsError, MultipleToolsBoundError, StructuredOutputParsingError, ToolInvocationError } from "./agents/errors.js";
 import { ProviderStrategy, ToolStrategy, providerStrategy, toolStrategy } from "./agents/responses.js";
 import { countTokensApproximately } from "./agents/middleware/utils.js";
@@ -25,7 +26,7 @@ import { openAIModerationMiddleware } from "./agents/middleware/provider/openai/
 import { anthropicPromptCachingMiddleware } from "./agents/middleware/provider/anthropic/promptCaching.js";
 import "./agents/middleware/index.js";
 import { AIMessage, AIMessageChunk, BaseMessage, BaseMessageChunk, HumanMessage, HumanMessageChunk, SystemMessage, SystemMessageChunk, ToolMessage, ToolMessageChunk, filterMessages, trimMessages } from "@langchain/core/messages";
-import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool, tool } from "@langchain/core/tools";
+import { DynamicStructuredTool, DynamicTool, StructuredTool, Tool } from "@langchain/core/tools";
 import { context } from "@langchain/core/utils/context";
 import { InMemoryStore } from "@langchain/core/stores";
 import { Document } from "@langchain/core/documents";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * LangChain Messages\n */\nexport {\n  BaseMessage,\n  BaseMessageChunk,\n  AIMessage,\n  AIMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n  type ContentBlock,\n  filterMessages,\n  trimMessages,\n} from \"@langchain/core/messages\";\n\n/**\n * Universal Chat Model\n */\nexport { initChatModel } from \"./chat_models/universal.js\";\n\n/**\n * LangChain Tools\n */\nexport {\n  tool,\n  Tool,\n  type ToolRuntime,\n  DynamicTool,\n  StructuredTool,\n  DynamicStructuredTool,\n} from \"@langchain/core/tools\";\n\n/**\n * LangChain utilities\n */\nexport { context } from \"@langchain/core/utils/context\";\n\n/**\n * LangChain Agents\n */\nexport * from \"./agents/index.js\";\n\n/**\n * `createAgent` pre-built middleware\n */\nexport * from \"./agents/middleware/index.js\";\n\n/**\n * LangChain Stores\n */\nexport { InMemoryStore } from \"@langchain/core/stores\";\n\n/**\n * LangChain Documents\n */\nexport { type DocumentInput, Document } from \"@langchain/core/documents\";\n\n/**\n * LangChain Testing Utilities\n */\nexport {\n  langchainMatchers,\n  type LangChainMatchers,\n  fakeModel,\n} from \"@langchain/core/testing\";\n"],"mappings":""}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * LangChain Messages\n */\nexport {\n  BaseMessage,\n  BaseMessageChunk,\n  AIMessage,\n  AIMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n  type ContentBlock,\n  filterMessages,\n  trimMessages,\n} from \"@langchain/core/messages\";\n\n/**\n * Universal Chat Model\n */\nexport { initChatModel } from \"./chat_models/universal.js\";\n\n/**\n * LangChain Tools with support for headless tools\n */\nexport {\n  tool,\n  type HeadlessTool,\n  type HeadlessToolFields,\n  type HeadlessToolImplementation,\n} from \"./tools/headless.js\";\n\n/**\n * LangChain Core Tool Primitives\n */\nexport {\n  Tool,\n  type ToolRuntime,\n  DynamicTool,\n  StructuredTool,\n  DynamicStructuredTool,\n} from \"@langchain/core/tools\";\n\n/**\n * LangChain utilities\n */\nexport { context } from \"@langchain/core/utils/context\";\n\n/**\n * LangChain Agents\n */\nexport * from \"./agents/index.js\";\n\n/**\n * `createAgent` pre-built middleware\n */\nexport * from \"./agents/middleware/index.js\";\n\n/**\n * LangChain Stores\n */\nexport { InMemoryStore } from \"@langchain/core/stores\";\n\n/**\n * LangChain Documents\n */\nexport { type DocumentInput, Document } from \"@langchain/core/documents\";\n\n/**\n * LangChain Testing Utilities\n */\nexport {\n  langchainMatchers,\n  type LangChainMatchers,\n  fakeModel,\n} from \"@langchain/core/testing\";\n"],"mappings":""}

package/dist/load/import_map.cjs

@@ -2,6 +2,7 @@ const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
 const require_chat_models_universal = require("../chat_models/universal.cjs");
 const require_index = require("../index.cjs");
 const require_browser = require("../browser.cjs");
+const require_tools_index = require("../tools/index.cjs");
 const require_load_serializable = require("./serializable.cjs");
 const require_storage_encoder_backed = require("../storage/encoder_backed.cjs");
 const require_storage_file_system = require("../storage/file_system.cjs");
@@ -27,7 +28,8 @@ var import_map_exports = /* @__PURE__ */ require_runtime.__exportAll({
 	schema__runnable: () => schema__runnable,
 	storage__encoder_backed: () => require_storage_encoder_backed.encoder_backed_exports,
 	storage__file_system: () => require_storage_file_system.file_system_exports,
-	storage__in_memory: () => require_storage_in_memory.in_memory_exports
+	storage__in_memory: () => require_storage_in_memory.in_memory_exports,
+	tools: () => require_tools_index.tools_exports
 });
 const prompts__prompt = { PromptTemplate: _langchain_core_prompts.PromptTemplate };
 const schema = {

package/dist/load/import_map.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"import_map.cjs","names":[],"sources":["../../src/load/import_map.ts"],"sourcesContent":["/** Auto-generated by import-map plugin. Do not edit manually */\n\nexport * as browser from \"../browser.js\";\nexport * as chat_models__universal from \"../chat_models/universal.js\";\nexport * as index from \"../index.js\";\nexport * as load__serializable from \"../load/serializable.js\";\nexport * as storage__encoder_backed from \"../storage/encoder_backed.js\";\nexport * as storage__file_system from \"../storage/file_system.js\";\nexport * as storage__in_memory from \"../storage/in_memory.js\";\nimport {\n  PromptTemplate,\n  AIMessagePromptTemplate,\n  ChatMessagePromptTemplate,\n  ChatPromptTemplate,\n  HumanMessagePromptTemplate,\n  MessagesPlaceholder,\n  SystemMessagePromptTemplate,\n  ImagePromptTemplate,\n  PipelinePromptTemplate,\n} from \"@langchain/core/prompts\";\nimport {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  BaseMessageChunk,\n  ChatMessage,\n  ChatMessageChunk,\n  FunctionMessage,\n  FunctionMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n} from \"@langchain/core/messages\";\nimport { StringPromptValue } from \"@langchain/core/prompt_values\";\nimport {\n  RouterRunnable,\n  RunnableAssign,\n  RunnableBinding,\n  RunnableBranch,\n  RunnableEach,\n  RunnableMap,\n  RunnableParallel,\n  RunnablePassthrough,\n  RunnablePick,\n  RunnableRetry,\n  RunnableSequence,\n  RunnableWithFallbacks,\n  RunnableWithMessageHistory,\n} from \"@langchain/core/runnables\";\nimport { ChatGenerationChunk, GenerationChunk } from \"@langchain/core/outputs\";\nconst prompts__prompt = {\n  PromptTemplate,\n};\nexport { prompts__prompt };\nconst schema = {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  BaseMessageChunk,\n  ChatMessage,\n  ChatMessageChunk,\n  FunctionMessage,\n  FunctionMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n};\nexport { schema };\nconst prompts__chat = {\n  AIMessagePromptTemplate,\n  ChatMessagePromptTemplate,\n  ChatPromptTemplate,\n  HumanMessagePromptTemplate,\n  MessagesPlaceholder,\n  SystemMessagePromptTemplate,\n};\nexport { prompts__chat };\nconst prompts__image = {\n  ImagePromptTemplate,\n};\nexport { prompts__image };\nconst prompts__pipeline = {\n  PipelinePromptTemplate,\n};\nexport { prompts__pipeline };\nconst prompts__base = {\n  StringPromptValue,\n};\nexport { prompts__base };\nconst schema__runnable = {\n  RouterRunnable,\n  RunnableAssign,\n  RunnableBinding,\n  RunnableBranch,\n  RunnableEach,\n  RunnableMap,\n  RunnableParallel,\n  RunnablePassthrough,\n  RunnablePick,\n  RunnableRetry,\n  RunnableSequence,\n  RunnableWithFallbacks,\n  RunnableWithMessageHistory,\n};\nexport { schema__runnable };\nconst schema__output = {\n  ChatGenerationChunk,\n  GenerationChunk,\n};\nexport { schema__output };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,MAAM,kBAAkB,EACtB,gBAAA,wBAAA,gBACD;AAED,MAAM,SAAS;CACb,WAAA,yBAAA;CACA,gBAAA,yBAAA;CACA,aAAA,yBAAA;CACA,kBAAA,yBAAA;CACA,aAAA,yBAAA;CACA,kBAAA,yBAAA;CACA,iBAAA,yBAAA;CACA,sBAAA,yBAAA;CACA,cAAA,yBAAA;CACA,mBAAA,yBAAA;CACA,eAAA,yBAAA;CACA,oBAAA,yBAAA;CACA,aAAA,yBAAA;CACA,kBAAA,yBAAA;CACD;AAED,MAAM,gBAAgB;CACpB,yBAAA,wBAAA;CACA,2BAAA,wBAAA;CACA,oBAAA,wBAAA;CACA,4BAAA,wBAAA;CACA,qBAAA,wBAAA;CACA,6BAAA,wBAAA;CACD;AAED,MAAM,iBAAiB,EACrB,qBAAA,wBAAA,qBACD;AAED,MAAM,oBAAoB,EACxB,wBAAA,wBAAA,wBACD;AAED,MAAM,gBAAgB,EACpB,mBAAA,8BAAA,mBACD;AAED,MAAM,mBAAmB;CACvB,gBAAA,0BAAA;CACA,gBAAA,0BAAA;CACA,iBAAA,0BAAA;CACA,gBAAA,0BAAA;CACA,cAAA,0BAAA;CACA,aAAA,0BAAA;CACA,kBAAA,0BAAA;CACA,qBAAA,0BAAA;CACA,cAAA,0BAAA;CACA,eAAA,0BAAA;CACA,kBAAA,0BAAA;CACA,uBAAA,0BAAA;CACA,4BAAA,0BAAA;CACD;AAED,MAAM,iBAAiB;CACrB,qBAAA,wBAAA;CACA,iBAAA,wBAAA;CACD"}
+{"version":3,"file":"import_map.cjs","names":[],"sources":["../../src/load/import_map.ts"],"sourcesContent":["/** Auto-generated by import-map plugin. Do not edit manually */\n\nexport * as browser from \"../browser.js\";\nexport * as chat_models__universal from \"../chat_models/universal.js\";\nexport * as index from \"../index.js\";\nexport * as load__serializable from \"../load/serializable.js\";\nexport * as storage__encoder_backed from \"../storage/encoder_backed.js\";\nexport * as storage__file_system from \"../storage/file_system.js\";\nexport * as storage__in_memory from \"../storage/in_memory.js\";\nexport * as tools from \"../tools/index.js\";\nimport {\n  PromptTemplate,\n  AIMessagePromptTemplate,\n  ChatMessagePromptTemplate,\n  ChatPromptTemplate,\n  HumanMessagePromptTemplate,\n  MessagesPlaceholder,\n  SystemMessagePromptTemplate,\n  ImagePromptTemplate,\n  PipelinePromptTemplate,\n} from \"@langchain/core/prompts\";\nimport {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  BaseMessageChunk,\n  ChatMessage,\n  ChatMessageChunk,\n  FunctionMessage,\n  FunctionMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n} from \"@langchain/core/messages\";\nimport { StringPromptValue } from \"@langchain/core/prompt_values\";\nimport {\n  RouterRunnable,\n  RunnableAssign,\n  RunnableBinding,\n  RunnableBranch,\n  RunnableEach,\n  RunnableMap,\n  RunnableParallel,\n  RunnablePassthrough,\n  RunnablePick,\n  RunnableRetry,\n  RunnableSequence,\n  RunnableWithFallbacks,\n  RunnableWithMessageHistory,\n} from \"@langchain/core/runnables\";\nimport { ChatGenerationChunk, GenerationChunk } from \"@langchain/core/outputs\";\nconst prompts__prompt = {\n  PromptTemplate,\n};\nexport { prompts__prompt };\nconst schema = {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  BaseMessageChunk,\n  ChatMessage,\n  ChatMessageChunk,\n  FunctionMessage,\n  FunctionMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n};\nexport { schema };\nconst prompts__chat = {\n  AIMessagePromptTemplate,\n  ChatMessagePromptTemplate,\n  ChatPromptTemplate,\n  HumanMessagePromptTemplate,\n  MessagesPlaceholder,\n  SystemMessagePromptTemplate,\n};\nexport { prompts__chat };\nconst prompts__image = {\n  ImagePromptTemplate,\n};\nexport { prompts__image };\nconst prompts__pipeline = {\n  PipelinePromptTemplate,\n};\nexport { prompts__pipeline };\nconst prompts__base = {\n  StringPromptValue,\n};\nexport { prompts__base };\nconst schema__runnable = {\n  RouterRunnable,\n  RunnableAssign,\n  RunnableBinding,\n  RunnableBranch,\n  RunnableEach,\n  RunnableMap,\n  RunnableParallel,\n  RunnablePassthrough,\n  RunnablePick,\n  RunnableRetry,\n  RunnableSequence,\n  RunnableWithFallbacks,\n  RunnableWithMessageHistory,\n};\nexport { schema__runnable };\nconst schema__output = {\n  ChatGenerationChunk,\n  GenerationChunk,\n};\nexport { schema__output };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,MAAM,kBAAkB,EACtB,gBAAA,wBAAA,gBACD;AAED,MAAM,SAAS;CACb,WAAA,yBAAA;CACA,gBAAA,yBAAA;CACA,aAAA,yBAAA;CACA,kBAAA,yBAAA;CACA,aAAA,yBAAA;CACA,kBAAA,yBAAA;CACA,iBAAA,yBAAA;CACA,sBAAA,yBAAA;CACA,cAAA,yBAAA;CACA,mBAAA,yBAAA;CACA,eAAA,yBAAA;CACA,oBAAA,yBAAA;CACA,aAAA,yBAAA;CACA,kBAAA,yBAAA;CACD;AAED,MAAM,gBAAgB;CACpB,yBAAA,wBAAA;CACA,2BAAA,wBAAA;CACA,oBAAA,wBAAA;CACA,4BAAA,wBAAA;CACA,qBAAA,wBAAA;CACA,6BAAA,wBAAA;CACD;AAED,MAAM,iBAAiB,EACrB,qBAAA,wBAAA,qBACD;AAED,MAAM,oBAAoB,EACxB,wBAAA,wBAAA,wBACD;AAED,MAAM,gBAAgB,EACpB,mBAAA,8BAAA,mBACD;AAED,MAAM,mBAAmB;CACvB,gBAAA,0BAAA;CACA,gBAAA,0BAAA;CACA,iBAAA,0BAAA;CACA,gBAAA,0BAAA;CACA,cAAA,0BAAA;CACA,aAAA,0BAAA;CACA,kBAAA,0BAAA;CACA,qBAAA,0BAAA;CACA,cAAA,0BAAA;CACA,eAAA,0BAAA;CACA,kBAAA,0BAAA;CACA,uBAAA,0BAAA;CACA,4BAAA,0BAAA;CACD;AAED,MAAM,iBAAiB;CACrB,qBAAA,wBAAA;CACA,iBAAA,wBAAA;CACD"}

package/dist/load/import_map.js

@@ -2,6 +2,7 @@ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import { universal_exports } from "../chat_models/universal.js";
 import { src_exports } from "../index.js";
 import { browser_exports } from "../browser.js";
+import { tools_exports } from "../tools/index.js";
 import { serializable_exports } from "./serializable.js";
 import { encoder_backed_exports } from "../storage/encoder_backed.js";
 import { file_system_exports } from "../storage/file_system.js";
@@ -27,7 +28,8 @@ var import_map_exports = /* @__PURE__ */ __exportAll({
 	schema__runnable: () => schema__runnable,
 	storage__encoder_backed: () => encoder_backed_exports,
 	storage__file_system: () => file_system_exports,
-	storage__in_memory: () => in_memory_exports
+	storage__in_memory: () => in_memory_exports,
+	tools: () => tools_exports
 });
 const prompts__prompt = { PromptTemplate };
 const schema = {

package/dist/load/import_map.js.map

@@ -1 +1 @@
-{"version":3,"file":"import_map.js","names":[],"sources":["../../src/load/import_map.ts"],"sourcesContent":["/** Auto-generated by import-map plugin. Do not edit manually */\n\nexport * as browser from \"../browser.js\";\nexport * as chat_models__universal from \"../chat_models/universal.js\";\nexport * as index from \"../index.js\";\nexport * as load__serializable from \"../load/serializable.js\";\nexport * as storage__encoder_backed from \"../storage/encoder_backed.js\";\nexport * as storage__file_system from \"../storage/file_system.js\";\nexport * as storage__in_memory from \"../storage/in_memory.js\";\nimport {\n  PromptTemplate,\n  AIMessagePromptTemplate,\n  ChatMessagePromptTemplate,\n  ChatPromptTemplate,\n  HumanMessagePromptTemplate,\n  MessagesPlaceholder,\n  SystemMessagePromptTemplate,\n  ImagePromptTemplate,\n  PipelinePromptTemplate,\n} from \"@langchain/core/prompts\";\nimport {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  BaseMessageChunk,\n  ChatMessage,\n  ChatMessageChunk,\n  FunctionMessage,\n  FunctionMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n} from \"@langchain/core/messages\";\nimport { StringPromptValue } from \"@langchain/core/prompt_values\";\nimport {\n  RouterRunnable,\n  RunnableAssign,\n  RunnableBinding,\n  RunnableBranch,\n  RunnableEach,\n  RunnableMap,\n  RunnableParallel,\n  RunnablePassthrough,\n  RunnablePick,\n  RunnableRetry,\n  RunnableSequence,\n  RunnableWithFallbacks,\n  RunnableWithMessageHistory,\n} from \"@langchain/core/runnables\";\nimport { ChatGenerationChunk, GenerationChunk } from \"@langchain/core/outputs\";\nconst prompts__prompt = {\n  PromptTemplate,\n};\nexport { prompts__prompt };\nconst schema = {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  BaseMessageChunk,\n  ChatMessage,\n  ChatMessageChunk,\n  FunctionMessage,\n  FunctionMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n};\nexport { schema };\nconst prompts__chat = {\n  AIMessagePromptTemplate,\n  ChatMessagePromptTemplate,\n  ChatPromptTemplate,\n  HumanMessagePromptTemplate,\n  MessagesPlaceholder,\n  SystemMessagePromptTemplate,\n};\nexport { prompts__chat };\nconst prompts__image = {\n  ImagePromptTemplate,\n};\nexport { prompts__image };\nconst prompts__pipeline = {\n  PipelinePromptTemplate,\n};\nexport { prompts__pipeline };\nconst prompts__base = {\n  StringPromptValue,\n};\nexport { prompts__base };\nconst schema__runnable = {\n  RouterRunnable,\n  RunnableAssign,\n  RunnableBinding,\n  RunnableBranch,\n  RunnableEach,\n  RunnableMap,\n  RunnableParallel,\n  RunnablePassthrough,\n  RunnablePick,\n  RunnableRetry,\n  RunnableSequence,\n  RunnableWithFallbacks,\n  RunnableWithMessageHistory,\n};\nexport { schema__runnable };\nconst schema__output = {\n  ChatGenerationChunk,\n  GenerationChunk,\n};\nexport { schema__output };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,MAAM,kBAAkB,EACtB,gBACD;AAED,MAAM,SAAS;CACb;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,gBAAgB;CACpB;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,iBAAiB,EACrB,qBACD;AAED,MAAM,oBAAoB,EACxB,wBACD;AAED,MAAM,gBAAgB,EACpB,mBACD;AAED,MAAM,mBAAmB;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,iBAAiB;CACrB;CACA;CACD"}
+{"version":3,"file":"import_map.js","names":[],"sources":["../../src/load/import_map.ts"],"sourcesContent":["/** Auto-generated by import-map plugin. Do not edit manually */\n\nexport * as browser from \"../browser.js\";\nexport * as chat_models__universal from \"../chat_models/universal.js\";\nexport * as index from \"../index.js\";\nexport * as load__serializable from \"../load/serializable.js\";\nexport * as storage__encoder_backed from \"../storage/encoder_backed.js\";\nexport * as storage__file_system from \"../storage/file_system.js\";\nexport * as storage__in_memory from \"../storage/in_memory.js\";\nexport * as tools from \"../tools/index.js\";\nimport {\n  PromptTemplate,\n  AIMessagePromptTemplate,\n  ChatMessagePromptTemplate,\n  ChatPromptTemplate,\n  HumanMessagePromptTemplate,\n  MessagesPlaceholder,\n  SystemMessagePromptTemplate,\n  ImagePromptTemplate,\n  PipelinePromptTemplate,\n} from \"@langchain/core/prompts\";\nimport {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  BaseMessageChunk,\n  ChatMessage,\n  ChatMessageChunk,\n  FunctionMessage,\n  FunctionMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n} from \"@langchain/core/messages\";\nimport { StringPromptValue } from \"@langchain/core/prompt_values\";\nimport {\n  RouterRunnable,\n  RunnableAssign,\n  RunnableBinding,\n  RunnableBranch,\n  RunnableEach,\n  RunnableMap,\n  RunnableParallel,\n  RunnablePassthrough,\n  RunnablePick,\n  RunnableRetry,\n  RunnableSequence,\n  RunnableWithFallbacks,\n  RunnableWithMessageHistory,\n} from \"@langchain/core/runnables\";\nimport { ChatGenerationChunk, GenerationChunk } from \"@langchain/core/outputs\";\nconst prompts__prompt = {\n  PromptTemplate,\n};\nexport { prompts__prompt };\nconst schema = {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  BaseMessageChunk,\n  ChatMessage,\n  ChatMessageChunk,\n  FunctionMessage,\n  FunctionMessageChunk,\n  HumanMessage,\n  HumanMessageChunk,\n  SystemMessage,\n  SystemMessageChunk,\n  ToolMessage,\n  ToolMessageChunk,\n};\nexport { schema };\nconst prompts__chat = {\n  AIMessagePromptTemplate,\n  ChatMessagePromptTemplate,\n  ChatPromptTemplate,\n  HumanMessagePromptTemplate,\n  MessagesPlaceholder,\n  SystemMessagePromptTemplate,\n};\nexport { prompts__chat };\nconst prompts__image = {\n  ImagePromptTemplate,\n};\nexport { prompts__image };\nconst prompts__pipeline = {\n  PipelinePromptTemplate,\n};\nexport { prompts__pipeline };\nconst prompts__base = {\n  StringPromptValue,\n};\nexport { prompts__base };\nconst schema__runnable = {\n  RouterRunnable,\n  RunnableAssign,\n  RunnableBinding,\n  RunnableBranch,\n  RunnableEach,\n  RunnableMap,\n  RunnableParallel,\n  RunnablePassthrough,\n  RunnablePick,\n  RunnableRetry,\n  RunnableSequence,\n  RunnableWithFallbacks,\n  RunnableWithMessageHistory,\n};\nexport { schema__runnable };\nconst schema__output = {\n  ChatGenerationChunk,\n  GenerationChunk,\n};\nexport { schema__output };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,MAAM,kBAAkB,EACtB,gBACD;AAED,MAAM,SAAS;CACb;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,gBAAgB;CACpB;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,iBAAiB,EACrB,qBACD;AAED,MAAM,oBAAoB,EACxB,wBACD;AAED,MAAM,gBAAgB,EACpB,mBACD;AAED,MAAM,mBAAmB;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,iBAAiB;CACrB;CACA;CACD"}

package/dist/tools/headless.cjs

@@ -0,0 +1,113 @@
+require("../_virtual/_rolldown/runtime.cjs");
+let _langchain_core_tools = require("@langchain/core/tools");
+//#region src/tools/headless.ts
+/**
+* Unified Tool Primitive for LangChain Agents
+*
+* This module re-exports the `tool` primitive from `@langchain/core/tools` with
+* an additional overload: when called without an implementation function, it
+* creates a **headless tool** that interrupts agent execution and delegates the
+* implementation to the client (e.g. via `useStream({ tools: [...] })`).
+*
+* @module
+*/
+function createHeadlessTool(fields) {
+	const { name, description, schema } = fields;
+	const wrappedTool = (0, _langchain_core_tools.tool)(async (args, config) => {
+		const { interrupt } = await import("@langchain/langgraph");
+		return interrupt({
+			type: "tool",
+			toolCall: {
+				id: config?.toolCall?.id,
+				name,
+				args
+			}
+		});
+	}, {
+		name,
+		description,
+		schema,
+		metadata: { headlessTool: true }
+	});
+	const headlessTool = Object.assign(wrappedTool, { implement: (execute) => ({
+		tool: headlessTool,
+		execute
+	}) });
+	return headlessTool;
+}
+/**
+* Unified tool primitive for LangChain agents.
+*
+* Enhances the `tool` function from `@langchain/core/tools` with a headless
+* overload: when called **without** an implementation function, the tool
+* interrupts agent execution and lets the client supply the implementation.
+*
+* ---
+*
+* **Normal tool** — pass an implementation function as the first argument:
+*
+* ```typescript
+* import { tool } from "langchain/tools";
+* import { z } from "zod";
+*
+* const getWeather = tool(
+*   async ({ city }) => `The weather in ${city} is sunny.`,
+*   {
+*     name: "get_weather",
+*     description: "Get the weather for a city",
+*     schema: z.object({ city: z.string() }),
+*   }
+* );
+* ```
+*
+* ---
+*
+* **Headless tool** — omit the implementation; the client provides it later:
+*
+* ```typescript
+* import { tool } from "langchain/tools";
+* import { z } from "zod";
+*
+* // Server: define the tool shape — no implementation needed
+* export const getLocation = tool({
+*   name: "get_location",
+*   description: "Get the user's current GPS location",
+*   schema: z.object({
+*     highAccuracy: z.boolean().optional().describe("Request high accuracy GPS"),
+*   }),
+* });
+*
+* // Server: register with the agent
+* const agent = createAgent({
+*   model: "openai:gpt-4o",
+*   tools: [getLocation],
+* });
+*
+* // Client: provide the implementation in useStream
+* const stream = useStream({
+*   assistantId: "agent",
+*   tools: [
+*     getLocation.implement(async ({ highAccuracy }) => {
+*       return new Promise((resolve, reject) => {
+*         navigator.geolocation.getCurrentPosition(
+*           (pos) => resolve({
+*             latitude: pos.coords.latitude,
+*             longitude: pos.coords.longitude,
+*           }),
+*           (err) => reject(new Error(err.message)),
+*           { enableHighAccuracy: highAccuracy }
+*         );
+*       });
+*     }),
+*   ],
+* });
+* ```
+*/
+const tool = ((funcOrFields, fields) => {
+	if (typeof funcOrFields !== "function") return createHeadlessTool(funcOrFields);
+	return (0, _langchain_core_tools.tool)(funcOrFields, fields);
+});
+//#endregion
+exports.tool = tool;
+
+//# sourceMappingURL=headless.cjs.map

package/dist/tools/headless.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.cjs","names":[],"sources":["../../src/tools/headless.ts"],"sourcesContent":["/**\n * Unified Tool Primitive for LangChain Agents\n *\n * This module re-exports the `tool` primitive from `@langchain/core/tools` with\n * an additional overload: when called without an implementation function, it\n * creates a **headless tool** that interrupts agent execution and delegates the\n * implementation to the client (e.g. via `useStream({ tools: [...] })`).\n *\n * @module\n */\n\nimport {\n  tool as coreTool,\n  DynamicStructuredTool,\n  type ToolRunnableConfig,\n} from \"@langchain/core/tools\";\nimport type {\n  InteropZodObject,\n  InferInteropZodInput,\n  InferInteropZodOutput,\n} from \"@langchain/core/utils/types\";\n\n/**\n * Configuration fields for creating a headless tool.\n */\nexport type HeadlessToolFields<\n  SchemaT extends InteropZodObject,\n  NameT extends string = string,\n> = {\n  /** The name of the tool. Used by the client to match implementations. */\n  name: NameT;\n  /** Description of what the tool does. */\n  description: string;\n  /** The Zod schema defining the tool's input. */\n  schema: SchemaT;\n};\n\n/**\n * A tool implementation that pairs a headless tool with its execution function.\n *\n * Created by calling `.implement()` on a {@link HeadlessTool}.\n * Pass to `useStream({ tools: [...] })` on the client side.\n */\nexport type HeadlessToolImplementation<\n  SchemaT extends InteropZodObject = InteropZodObject,\n  OutputT = unknown,\n  NameT extends string = string,\n> = {\n  tool: HeadlessTool<SchemaT, NameT>;\n  execute: (args: InferInteropZodOutput<SchemaT>) => Promise<OutputT>;\n};\n\n/**\n * A headless tool that always interrupts agent execution on the server.\n *\n * The implementation is provided separately on the client via\n * `useStream({ tools: [...] })` using `.implement()`.\n */\nexport type HeadlessTool<\n  SchemaT extends InteropZodObject = InteropZodObject,\n  NameT extends string = string,\n> = DynamicStructuredTool<\n  SchemaT,\n  InferInteropZodOutput<SchemaT>,\n  InferInteropZodInput<SchemaT>,\n  unknown,\n  unknown,\n  NameT\n> & {\n  /**\n   * Pairs this headless tool with a client-side implementation.\n   *\n   * The returned object should be passed to `useStream({ tools: [...] })`.\n   * The SDK matches the implementation to the tool by name and calls\n   * `execute` with the typed arguments from the interrupt payload.\n   *\n   * @param execute - The function that implements the tool on the client\n   */\n  implement: <OutputT>(\n    execute: (args: InferInteropZodOutput<SchemaT>) => Promise<OutputT>\n  ) => HeadlessToolImplementation<SchemaT, OutputT, NameT>;\n};\n\nfunction createHeadlessTool<\n  SchemaT extends InteropZodObject,\n  NameT extends string,\n>(fields: HeadlessToolFields<SchemaT, NameT>): HeadlessTool<SchemaT, NameT> {\n  const { name, description, schema } = fields;\n\n  const wrappedTool = coreTool(\n    async (\n      args: InferInteropZodOutput<SchemaT>,\n      config?: ToolRunnableConfig\n    ) => {\n      const { interrupt } = await import(\"@langchain/langgraph\");\n      return interrupt({\n        type: \"tool\",\n        toolCall: {\n          id: config?.toolCall?.id,\n          name,\n          args,\n        },\n      });\n    },\n    {\n      name,\n      description,\n      schema,\n      metadata: {\n        headlessTool: true,\n      },\n    }\n  );\n\n  const headlessTool: HeadlessTool<SchemaT, NameT> = Object.assign(\n    wrappedTool,\n    {\n      implement: <OutputT>(\n        execute: (args: InferInteropZodOutput<SchemaT>) => Promise<OutputT>\n      ): HeadlessToolImplementation<SchemaT, OutputT, NameT> => ({\n        tool: headlessTool,\n        execute,\n      }),\n    }\n  ) as HeadlessTool<SchemaT, NameT>;\n\n  return headlessTool;\n}\n\n/**\n * The headless overload signature added to the core `tool` function.\n *\n * When called **without** an implementation function — just `tool({ name, description, schema })` —\n * returns a {@link HeadlessTool} that interrupts on every agent invocation.\n * The client provides the implementation via `useStream({ tools: [...] })`.\n */\ntype HeadlessToolOverload = {\n  <SchemaT extends InteropZodObject, NameT extends string>(\n    fields: HeadlessToolFields<SchemaT, NameT>\n  ): HeadlessTool<SchemaT, NameT>;\n};\n\n/**\n * Unified tool primitive for LangChain agents.\n *\n * Enhances the `tool` function from `@langchain/core/tools` with a headless\n * overload: when called **without** an implementation function, the tool\n * interrupts agent execution and lets the client supply the implementation.\n *\n * ---\n *\n * **Normal tool** — pass an implementation function as the first argument:\n *\n * ```typescript\n * import { tool } from \"langchain/tools\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n *   async ({ city }) => `The weather in ${city} is sunny.`,\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather for a city\",\n *     schema: z.object({ city: z.string() }),\n *   }\n * );\n * ```\n *\n * ---\n *\n * **Headless tool** — omit the implementation; the client provides it later:\n *\n * ```typescript\n * import { tool } from \"langchain/tools\";\n * import { z } from \"zod\";\n *\n * // Server: define the tool shape — no implementation needed\n * export const getLocation = tool({\n *   name: \"get_location\",\n *   description: \"Get the user's current GPS location\",\n *   schema: z.object({\n *     highAccuracy: z.boolean().optional().describe(\"Request high accuracy GPS\"),\n *   }),\n * });\n *\n * // Server: register with the agent\n * const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [getLocation],\n * });\n *\n * // Client: provide the implementation in useStream\n * const stream = useStream({\n *   assistantId: \"agent\",\n *   tools: [\n *     getLocation.implement(async ({ highAccuracy }) => {\n *       return new Promise((resolve, reject) => {\n *         navigator.geolocation.getCurrentPosition(\n *           (pos) => resolve({\n *             latitude: pos.coords.latitude,\n *             longitude: pos.coords.longitude,\n *           }),\n *           (err) => reject(new Error(err.message)),\n *           { enableHighAccuracy: highAccuracy }\n *         );\n *       });\n *     }),\n *   ],\n * });\n * ```\n */\nexport const tool: HeadlessToolOverload & typeof coreTool = ((\n  funcOrFields: unknown,\n  fields?: unknown\n) => {\n  if (typeof funcOrFields !== \"function\") {\n    return createHeadlessTool(\n      funcOrFields as HeadlessToolFields<InteropZodObject, string>\n    );\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return (coreTool as any)(funcOrFields, fields);\n}) as HeadlessToolOverload & typeof coreTool;\n"],"mappings":";;;;;;;;;;;;;AAmFA,SAAS,mBAGP,QAA0E;CAC1E,MAAM,EAAE,MAAM,aAAa,WAAW;CAEtC,MAAM,eAAA,GAAA,sBAAA,MACJ,OACE,MACA,WACG;EACH,MAAM,EAAE,cAAc,MAAM,OAAO;AACnC,SAAO,UAAU;GACf,MAAM;GACN,UAAU;IACR,IAAI,QAAQ,UAAU;IACtB;IACA;IACD;GACF,CAAC;IAEJ;EACE;EACA;EACA;EACA,UAAU,EACR,cAAc,MACf;EACF,CACF;CAED,MAAM,eAA6C,OAAO,OACxD,aACA,EACE,YACE,aACyD;EACzD,MAAM;EACN;EACD,GACF,CACF;AAED,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFT,MAAa,SACX,cACA,WACG;AACH,KAAI,OAAO,iBAAiB,WAC1B,QAAO,mBACL,aACD;AAGH,SAAA,GAAA,sBAAA,MAAyB,cAAc,OAAO"}

package/dist/tools/headless.d.cts

@@ -0,0 +1,122 @@
+import { DynamicStructuredTool, tool } from "@langchain/core/tools";
+import { InferInteropZodInput, InferInteropZodOutput, InteropZodObject } from "@langchain/core/utils/types";
+
+//#region src/tools/headless.d.ts
+/**
+ * Configuration fields for creating a headless tool.
+ */
+type HeadlessToolFields<SchemaT extends InteropZodObject, NameT extends string = string> = {
+  /** The name of the tool. Used by the client to match implementations. */name: NameT; /** Description of what the tool does. */
+  description: string; /** The Zod schema defining the tool's input. */
+  schema: SchemaT;
+};
+/**
+ * A tool implementation that pairs a headless tool with its execution function.
+ *
+ * Created by calling `.implement()` on a {@link HeadlessTool}.
+ * Pass to `useStream({ tools: [...] })` on the client side.
+ */
+type HeadlessToolImplementation<SchemaT extends InteropZodObject = InteropZodObject, OutputT = unknown, NameT extends string = string> = {
+  tool: HeadlessTool<SchemaT, NameT>;
+  execute: (args: InferInteropZodOutput<SchemaT>) => Promise<OutputT>;
+};
+/**
+ * A headless tool that always interrupts agent execution on the server.
+ *
+ * The implementation is provided separately on the client via
+ * `useStream({ tools: [...] })` using `.implement()`.
+ */
+type HeadlessTool<SchemaT extends InteropZodObject = InteropZodObject, NameT extends string = string> = DynamicStructuredTool<SchemaT, InferInteropZodOutput<SchemaT>, InferInteropZodInput<SchemaT>, unknown, unknown, NameT> & {
+  /**
+   * Pairs this headless tool with a client-side implementation.
+   *
+   * The returned object should be passed to `useStream({ tools: [...] })`.
+   * The SDK matches the implementation to the tool by name and calls
+   * `execute` with the typed arguments from the interrupt payload.
+   *
+   * @param execute - The function that implements the tool on the client
+   */
+  implement: <OutputT>(execute: (args: InferInteropZodOutput<SchemaT>) => Promise<OutputT>) => HeadlessToolImplementation<SchemaT, OutputT, NameT>;
+};
+/**
+ * The headless overload signature added to the core `tool` function.
+ *
+ * When called **without** an implementation function — just `tool({ name, description, schema })` —
+ * returns a {@link HeadlessTool} that interrupts on every agent invocation.
+ * The client provides the implementation via `useStream({ tools: [...] })`.
+ */
+type HeadlessToolOverload = {
+  <SchemaT extends InteropZodObject, NameT extends string>(fields: HeadlessToolFields<SchemaT, NameT>): HeadlessTool<SchemaT, NameT>;
+};
+/**
+ * Unified tool primitive for LangChain agents.
+ *
+ * Enhances the `tool` function from `@langchain/core/tools` with a headless
+ * overload: when called **without** an implementation function, the tool
+ * interrupts agent execution and lets the client supply the implementation.
+ *
+ * ---
+ *
+ * **Normal tool** — pass an implementation function as the first argument:
+ *
+ * ```typescript
+ * import { tool } from "langchain/tools";
+ * import { z } from "zod";
+ *
+ * const getWeather = tool(
+ *   async ({ city }) => `The weather in ${city} is sunny.`,
+ *   {
+ *     name: "get_weather",
+ *     description: "Get the weather for a city",
+ *     schema: z.object({ city: z.string() }),
+ *   }
+ * );
+ * ```
+ *
+ * ---
+ *
+ * **Headless tool** — omit the implementation; the client provides it later:
+ *
+ * ```typescript
+ * import { tool } from "langchain/tools";
+ * import { z } from "zod";
+ *
+ * // Server: define the tool shape — no implementation needed
+ * export const getLocation = tool({
+ *   name: "get_location",
+ *   description: "Get the user's current GPS location",
+ *   schema: z.object({
+ *     highAccuracy: z.boolean().optional().describe("Request high accuracy GPS"),
+ *   }),
+ * });
+ *
+ * // Server: register with the agent
+ * const agent = createAgent({
+ *   model: "openai:gpt-4o",
+ *   tools: [getLocation],
+ * });
+ *
+ * // Client: provide the implementation in useStream
+ * const stream = useStream({
+ *   assistantId: "agent",
+ *   tools: [
+ *     getLocation.implement(async ({ highAccuracy }) => {
+ *       return new Promise((resolve, reject) => {
+ *         navigator.geolocation.getCurrentPosition(
+ *           (pos) => resolve({
+ *             latitude: pos.coords.latitude,
+ *             longitude: pos.coords.longitude,
+ *           }),
+ *           (err) => reject(new Error(err.message)),
+ *           { enableHighAccuracy: highAccuracy }
+ *         );
+ *       });
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare const tool$1: HeadlessToolOverload & typeof tool;
+//#endregion
+export { HeadlessTool, HeadlessToolFields, HeadlessToolImplementation, tool$1 as tool };
+//# sourceMappingURL=headless.d.cts.map

package/dist/tools/headless.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.cts","names":[],"sources":["../../src/tools/headless.ts"],"mappings":";;;;;;;KAyBY,kBAAA,iBACM,gBAAA;EAIV,yEAAN,IAAA,EAAM,KAAA,EAIN;EAFA,WAAA,UAEe;EAAf,MAAA,EAAQ,OAAA;AAAA;;;;;;;KASE,0BAAA,iBACM,gBAAA,GAAmB,gBAAA;EAInC,IAAA,EAAM,YAAA,CAAa,OAAA,EAAS,KAAA;EAC5B,OAAA,GAAU,IAAA,EAAM,qBAAA,CAAsB,OAAA,MAAa,OAAA,CAAQ,OAAA;AAAA;;;;;;;KASjD,YAAA,iBACM,gBAAA,GAAmB,gBAAA,mCAEjC,qBAAA,CACF,OAAA,EACA,qBAAA,CAAsB,OAAA,GACtB,oBAAA,CAAqB,OAAA,qBAGrB,KAAA;EArBA;;;;;;;;;EAgCA,SAAA,YACE,OAAA,GAAU,IAAA,EAAM,qBAAA,CAAsB,OAAA,MAAa,OAAA,CAAQ,OAAA,MACxD,0BAAA,CAA2B,OAAA,EAAS,OAAA,EAAS,KAAA;AAAA;;;AAtBpD;;;;;KA8EK,oBAAA;EAAA,iBACc,gBAAA,wBACf,MAAA,EAAQ,kBAAA,CAAmB,OAAA,EAAS,KAAA,IACnC,YAAA,CAAa,OAAA,EAAS,KAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA1DzB;;;;;;;;;;;;;;;;;;;;;;;;AAiIF;;;;;cAAa,MAAA,EAAM,oBAAA,UAA8B,IAAA"}