@tanstack/ai 0.42.0 → 0.43.1

package/dist/esm/activities/chat/tools/lazy-tool-manager.js

@@ -1,194 +1,167 @@
 import { convertSchemaToJsonSchema } from "./schema-converter.js";
 import { renderLazyCatalogEntry } from "./lazy-tools.js";
-const DISCOVERY_TOOL_NAME = "__lazy__tool__discovery__";
-class LazyToolManager {
-  eagerTools;
-  lazyToolMap;
-  discoveredTools;
-  hasNewDiscoveries;
-  discoveryTool;
-  lazyToolsConfig;
-  constructor(tools, messages, lazyToolsConfig = {}) {
-    this.lazyToolsConfig = lazyToolsConfig;
-    const eager = [];
-    this.lazyToolMap = /* @__PURE__ */ new Map();
-    this.discoveredTools = /* @__PURE__ */ new Set();
-    this.hasNewDiscoveries = false;
-    for (const tool of tools) {
-      if (tool.lazy) {
-        this.lazyToolMap.set(tool.name, tool);
-      } else {
-        eager.push(tool);
-      }
-    }
-    this.eagerTools = eager;
-    if (this.lazyToolMap.size === 0) {
-      this.discoveryTool = null;
-      return;
-    }
-    this.scanMessageHistory(messages);
-    this.discoveryTool = this.createDiscoveryTool();
-  }
-  /**
-   * Returns the set of tools that should be sent to the LLM:
-   * eager tools + discovered lazy tools + discovery tool (if undiscovered tools remain).
-   * Resets the hasNewDiscoveries flag.
-   */
-  getActiveTools() {
-    this.hasNewDiscoveries = false;
-    const active = [...this.eagerTools];
-    for (const name of this.discoveredTools) {
-      const tool = this.lazyToolMap.get(name);
-      if (tool) {
-        active.push(tool);
-      }
-    }
-    if (this.discoveryTool && this.discoveredTools.size < this.lazyToolMap.size) {
-      active.push(this.discoveryTool);
-    }
-    return active;
-  }
-  /**
-   * Returns the tools that should be available for *execution* this turn.
-   *
-   * This is the advertised set (`getActiveTools()`, passed in as `activeTools`)
-   * plus the discovery tool when a pending call references it but it is no
-   * longer advertised. Once every lazy tool has been discovered the discovery
-   * tool is dropped from the advertised set, but a model may still re-request
-   * discovery (long context / hallucination); keeping it executable lets that
-   * call return the schemas again instead of failing with "Unknown tool".
-   *
-   * The advertised set is intentionally left unchanged — only execution lookup
-   * is widened. Operates on the already-built `activeTools`: it must NOT call
-   * `getActiveTools()`, which would reset `hasNewDiscoveries` before the
-   * post-execution refresh check in the agent loop.
-   */
-  getExecutableTools(activeTools, pendingToolCallNames) {
-    if (this.discoveryTool && pendingToolCallNames.includes(DISCOVERY_TOOL_NAME) && !activeTools.some((t) => t.name === DISCOVERY_TOOL_NAME)) {
-      return [...activeTools, this.discoveryTool];
-    }
-    return activeTools;
-  }
-  /**
-   * Returns whether new tools have been discovered since the last getActiveTools() call.
-   */
-  hasNewlyDiscoveredTools() {
-    return this.hasNewDiscoveries;
-  }
-  /**
-   * Returns true if the given name is a lazy tool that has not yet been discovered.
-   */
-  isUndiscoveredLazyTool(name) {
-    return this.lazyToolMap.has(name) && !this.discoveredTools.has(name);
-  }
-  /**
-   * Returns a helpful error message for when an undiscovered lazy tool is called.
-   */
-  getUndiscoveredToolError(name) {
-    return `Error: Tool '${name}' must be discovered first. Call ${DISCOVERY_TOOL_NAME} with toolNames: ['${name}'] to discover it.`;
-  }
-  /**
-   * Scans message history to find previously discovered lazy tools.
-   * Looks for assistant messages with discovery tool calls and their
-   * corresponding tool result messages.
-   */
-  scanMessageHistory(messages) {
-    const discoveryCallIds = /* @__PURE__ */ new Set();
-    for (const msg of messages) {
-      if (msg.role === "assistant" && msg.toolCalls) {
-        for (const tc of msg.toolCalls) {
-          if (tc.function.name === DISCOVERY_TOOL_NAME) {
-            discoveryCallIds.add(tc.id);
-          }
-        }
-      }
-    }
-    if (discoveryCallIds.size === 0) return;
-    for (const msg of messages) {
-      if (msg.role === "tool" && msg.toolCallId && discoveryCallIds.has(msg.toolCallId)) {
-        try {
-          const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
-          const parsed = JSON.parse(content);
-          if (parsed && Array.isArray(parsed.tools)) {
-            for (const tool of parsed.tools) {
-              if (tool && typeof tool.name === "string" && this.lazyToolMap.has(tool.name)) {
-                this.discoveredTools.add(tool.name);
-              }
-            }
-          }
-        } catch {
-        }
-      }
-    }
-  }
-  /**
-   * Creates the synthetic discovery tool that the LLM can call
-   * to discover lazy tools' descriptions and schemas.
-   */
-  createDiscoveryTool() {
-    const undiscoveredNames = () => {
-      const names = [];
-      for (const [name] of this.lazyToolMap) {
-        if (!this.discoveredTools.has(name)) {
-          names.push(name);
-        }
-      }
-      return names;
-    };
-    const lazyToolMap = this.lazyToolMap;
-    const include = this.lazyToolsConfig.includeDescription ?? "none";
-    const allLazyEntries = Array.from(this.lazyToolMap.values()).map(
-      (t) => renderLazyCatalogEntry(t.name, t.description, include)
-    );
-    const description = `You have access to additional tools that can be discovered. Available tools: [${allLazyEntries.join(", ")}]. Call this tool with a list of tool names to discover their full descriptions and argument schemas before using them.`;
-    const manager = this;
-    return {
-      name: DISCOVERY_TOOL_NAME,
-      description,
-      inputSchema: {
-        type: "object",
-        properties: {
-          toolNames: {
-            type: "array",
-            items: { type: "string" },
-            description: "List of tool names to discover. Each name must match one of the available tools."
-          }
-        },
-        required: ["toolNames"]
-      },
-      execute: (args) => {
-        const tools = [];
-        const errors = [];
-        for (const name of args.toolNames) {
-          const tool = lazyToolMap.get(name);
-          if (tool) {
-            if (!manager.discoveredTools.has(name)) {
-              manager.discoveredTools.add(name);
-              manager.hasNewDiscoveries = true;
-            }
-            const jsonSchema = tool.inputSchema ? convertSchemaToJsonSchema(tool.inputSchema) : void 0;
-            tools.push({
-              name: tool.name,
-              description: tool.description,
-              ...jsonSchema ? { inputSchema: jsonSchema } : {}
-            });
-          } else {
-            errors.push(
-              `Unknown tool: '${name}'. Available tools: [${undiscoveredNames().join(", ")}]`
-            );
-          }
-        }
-        const result = { tools };
-        if (errors.length > 0) {
-          result.errors = errors;
-        }
-        return result;
-      }
-    };
-  }
-}
-export {
-  DISCOVERY_TOOL_NAME,
-  LazyToolManager
+//#region src/activities/chat/tools/lazy-tool-manager.ts
+/**
+* Name of the synthetic tool the LLM calls to discover lazy tools.
+*
+* Exported so callers building custom message-compaction / history-trimming
+* logic can reference the discovery tool by constant instead of hard-coding
+* the string (which is an internal contract that could change).
+*/
+var DISCOVERY_TOOL_NAME = "__lazy__tool__discovery__";
+/**
+* Manages lazy tool discovery for the chat agent loop.
+*
+* Lazy tools are not sent to the LLM initially. Instead, a synthetic
+* "discovery tool" is provided that lets the LLM discover lazy tools
+* by name, receiving their full descriptions and schemas on demand.
+*/
+var LazyToolManager = class {
+	eagerTools;
+	lazyToolMap;
+	discoveredTools;
+	hasNewDiscoveries;
+	discoveryTool;
+	lazyToolsConfig;
+	constructor(tools, messages, lazyToolsConfig = {}) {
+		this.lazyToolsConfig = lazyToolsConfig;
+		const eager = [];
+		this.lazyToolMap = /* @__PURE__ */ new Map();
+		this.discoveredTools = /* @__PURE__ */ new Set();
+		this.hasNewDiscoveries = false;
+		for (const tool of tools) if (tool.lazy) this.lazyToolMap.set(tool.name, tool);
+		else eager.push(tool);
+		this.eagerTools = eager;
+		if (this.lazyToolMap.size === 0) {
+			this.discoveryTool = null;
+			return;
+		}
+		this.scanMessageHistory(messages);
+		this.discoveryTool = this.createDiscoveryTool();
+	}
+	/**
+	* Returns the set of tools that should be sent to the LLM:
+	* eager tools + discovered lazy tools + discovery tool (if undiscovered tools remain).
+	* Resets the hasNewDiscoveries flag.
+	*/
+	getActiveTools() {
+		this.hasNewDiscoveries = false;
+		const active = [...this.eagerTools];
+		for (const name of this.discoveredTools) {
+			const tool = this.lazyToolMap.get(name);
+			if (tool) active.push(tool);
+		}
+		if (this.discoveryTool && this.discoveredTools.size < this.lazyToolMap.size) active.push(this.discoveryTool);
+		return active;
+	}
+	/**
+	* Returns the tools that should be available for *execution* this turn.
+	*
+	* This is the advertised set (`getActiveTools()`, passed in as `activeTools`)
+	* plus the discovery tool when a pending call references it but it is no
+	* longer advertised. Once every lazy tool has been discovered the discovery
+	* tool is dropped from the advertised set, but a model may still re-request
+	* discovery (long context / hallucination); keeping it executable lets that
+	* call return the schemas again instead of failing with "Unknown tool".
+	*
+	* The advertised set is intentionally left unchanged — only execution lookup
+	* is widened. Operates on the already-built `activeTools`: it must NOT call
+	* `getActiveTools()`, which would reset `hasNewDiscoveries` before the
+	* post-execution refresh check in the agent loop.
+	*/
+	getExecutableTools(activeTools, pendingToolCallNames) {
+		if (this.discoveryTool && pendingToolCallNames.includes("__lazy__tool__discovery__") && !activeTools.some((t) => t.name === "__lazy__tool__discovery__")) return [...activeTools, this.discoveryTool];
+		return activeTools;
+	}
+	/**
+	* Returns whether new tools have been discovered since the last getActiveTools() call.
+	*/
+	hasNewlyDiscoveredTools() {
+		return this.hasNewDiscoveries;
+	}
+	/**
+	* Returns true if the given name is a lazy tool that has not yet been discovered.
+	*/
+	isUndiscoveredLazyTool(name) {
+		return this.lazyToolMap.has(name) && !this.discoveredTools.has(name);
+	}
+	/**
+	* Returns a helpful error message for when an undiscovered lazy tool is called.
+	*/
+	getUndiscoveredToolError(name) {
+		return `Error: Tool '${name}' must be discovered first. Call ${DISCOVERY_TOOL_NAME} with toolNames: ['${name}'] to discover it.`;
+	}
+	/**
+	* Scans message history to find previously discovered lazy tools.
+	* Looks for assistant messages with discovery tool calls and their
+	* corresponding tool result messages.
+	*/
+	scanMessageHistory(messages) {
+		const discoveryCallIds = /* @__PURE__ */ new Set();
+		for (const msg of messages) if (msg.role === "assistant" && msg.toolCalls) {
+			for (const tc of msg.toolCalls) if (tc.function.name === "__lazy__tool__discovery__") discoveryCallIds.add(tc.id);
+		}
+		if (discoveryCallIds.size === 0) return;
+		for (const msg of messages) if (msg.role === "tool" && msg.toolCallId && discoveryCallIds.has(msg.toolCallId)) try {
+			const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
+			const parsed = JSON.parse(content);
+			if (parsed && Array.isArray(parsed.tools)) {
+				for (const tool of parsed.tools) if (tool && typeof tool.name === "string" && this.lazyToolMap.has(tool.name)) this.discoveredTools.add(tool.name);
+			}
+		} catch {}
+	}
+	/**
+	* Creates the synthetic discovery tool that the LLM can call
+	* to discover lazy tools' descriptions and schemas.
+	*/
+	createDiscoveryTool() {
+		const undiscoveredNames = () => {
+			const names = [];
+			for (const [name] of this.lazyToolMap) if (!this.discoveredTools.has(name)) names.push(name);
+			return names;
+		};
+		const lazyToolMap = this.lazyToolMap;
+		const include = this.lazyToolsConfig.includeDescription ?? "none";
+		const description = `You have access to additional tools that can be discovered. Available tools: [${Array.from(this.lazyToolMap.values()).map((t) => renderLazyCatalogEntry(t.name, t.description, include)).join(", ")}]. Call this tool with a list of tool names to discover their full descriptions and argument schemas before using them.`;
+		const manager = this;
+		return {
+			name: DISCOVERY_TOOL_NAME,
+			description,
+			inputSchema: {
+				type: "object",
+				properties: { toolNames: {
+					type: "array",
+					items: { type: "string" },
+					description: "List of tool names to discover. Each name must match one of the available tools."
+				} },
+				required: ["toolNames"]
+			},
+			execute: (args) => {
+				const tools = [];
+				const errors = [];
+				for (const name of args.toolNames) {
+					const tool = lazyToolMap.get(name);
+					if (tool) {
+						if (!manager.discoveredTools.has(name)) {
+							manager.discoveredTools.add(name);
+							manager.hasNewDiscoveries = true;
+						}
+						const jsonSchema = tool.inputSchema ? convertSchemaToJsonSchema(tool.inputSchema) : void 0;
+						tools.push({
+							name: tool.name,
+							description: tool.description,
+							...jsonSchema ? { inputSchema: jsonSchema } : {}
+						});
+					} else errors.push(`Unknown tool: '${name}'. Available tools: [${undiscoveredNames().join(", ")}]`);
+				}
+				const result = { tools };
+				if (errors.length > 0) result.errors = errors;
+				return result;
+			}
+		};
+	}
 };
-//# sourceMappingURL=lazy-tool-manager.js.map
+//#endregion
+export { DISCOVERY_TOOL_NAME, LazyToolManager };
+
+//# sourceMappingURL=lazy-tool-manager.js.map

package/dist/esm/activities/chat/tools/lazy-tool-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-tool-manager.js","sources":["../../../../../src/activities/chat/tools/lazy-tool-manager.ts"],"sourcesContent":["import { convertSchemaToJsonSchema } from './schema-converter'\nimport { renderLazyCatalogEntry } from './lazy-tools'\nimport type { AnyTool, LazyToolsConfig, Tool } from '../../../types'\n\n/**\n * Name of the synthetic tool the LLM calls to discover lazy tools.\n *\n * Exported so callers building custom message-compaction / history-trimming\n * logic can reference the discovery tool by constant instead of hard-coding\n * the string (which is an internal contract that could change).\n */\nexport const DISCOVERY_TOOL_NAME = '__lazy__tool__discovery__'\n\n/**\n * Manages lazy tool discovery for the chat agent loop.\n *\n * Lazy tools are not sent to the LLM initially. Instead, a synthetic\n * \"discovery tool\" is provided that lets the LLM discover lazy tools\n * by name, receiving their full descriptions and schemas on demand.\n */\nexport class LazyToolManager {\n  private readonly eagerTools: ReadonlyArray<Tool>\n  private readonly lazyToolMap: Map<string, Tool>\n  private readonly discoveredTools: Set<string>\n  private hasNewDiscoveries: boolean\n  private readonly discoveryTool: Tool | null\n  private readonly lazyToolsConfig: LazyToolsConfig\n\n  constructor(\n    tools: ReadonlyArray<Tool>,\n    messages: ReadonlyArray<{\n      role: string\n      content?: any\n      toolCalls?: Array<{\n        id: string\n        type: string\n        function: { name: string; arguments: string }\n      }>\n      toolCallId?: string\n    }>,\n    lazyToolsConfig: LazyToolsConfig = {},\n  ) {\n    this.lazyToolsConfig = lazyToolsConfig\n    const eager: Array<Tool> = []\n    this.lazyToolMap = new Map()\n    this.discoveredTools = new Set()\n    this.hasNewDiscoveries = false\n\n    // Separate tools into eager and lazy\n    for (const tool of tools) {\n      if (tool.lazy) {\n        this.lazyToolMap.set(tool.name, tool)\n      } else {\n        eager.push(tool)\n      }\n    }\n    this.eagerTools = eager\n\n    // If no lazy tools, no discovery tool needed\n    if (this.lazyToolMap.size === 0) {\n      this.discoveryTool = null\n      return\n    }\n\n    // Scan message history to pre-populate discoveredTools\n    this.scanMessageHistory(messages)\n\n    // Create the synthetic discovery tool\n    this.discoveryTool = this.createDiscoveryTool()\n  }\n\n  /**\n   * Returns the set of tools that should be sent to the LLM:\n   * eager tools + discovered lazy tools + discovery tool (if undiscovered tools remain).\n   * Resets the hasNewDiscoveries flag.\n   */\n  getActiveTools(): Array<Tool> {\n    this.hasNewDiscoveries = false\n\n    const active: Array<Tool> = [...this.eagerTools]\n\n    // Add discovered lazy tools\n    for (const name of this.discoveredTools) {\n      const tool = this.lazyToolMap.get(name)\n      if (tool) {\n        active.push(tool)\n      }\n    }\n\n    // Add discovery tool if there are still undiscovered lazy tools\n    if (\n      this.discoveryTool &&\n      this.discoveredTools.size < this.lazyToolMap.size\n    ) {\n      active.push(this.discoveryTool)\n    }\n\n    return active\n  }\n\n  /**\n   * Returns the tools that should be available for *execution* this turn.\n   *\n   * This is the advertised set (`getActiveTools()`, passed in as `activeTools`)\n   * plus the discovery tool when a pending call references it but it is no\n   * longer advertised. Once every lazy tool has been discovered the discovery\n   * tool is dropped from the advertised set, but a model may still re-request\n   * discovery (long context / hallucination); keeping it executable lets that\n   * call return the schemas again instead of failing with \"Unknown tool\".\n   *\n   * The advertised set is intentionally left unchanged — only execution lookup\n   * is widened. Operates on the already-built `activeTools`: it must NOT call\n   * `getActiveTools()`, which would reset `hasNewDiscoveries` before the\n   * post-execution refresh check in the agent loop.\n   */\n  getExecutableTools(\n    activeTools: ReadonlyArray<AnyTool>,\n    pendingToolCallNames: ReadonlyArray<string>,\n  ): ReadonlyArray<AnyTool> {\n    if (\n      this.discoveryTool &&\n      pendingToolCallNames.includes(DISCOVERY_TOOL_NAME) &&\n      !activeTools.some((t) => t.name === DISCOVERY_TOOL_NAME)\n    ) {\n      return [...activeTools, this.discoveryTool]\n    }\n    return activeTools\n  }\n\n  /**\n   * Returns whether new tools have been discovered since the last getActiveTools() call.\n   */\n  hasNewlyDiscoveredTools(): boolean {\n    return this.hasNewDiscoveries\n  }\n\n  /**\n   * Returns true if the given name is a lazy tool that has not yet been discovered.\n   */\n  isUndiscoveredLazyTool(name: string): boolean {\n    return this.lazyToolMap.has(name) && !this.discoveredTools.has(name)\n  }\n\n  /**\n   * Returns a helpful error message for when an undiscovered lazy tool is called.\n   */\n  getUndiscoveredToolError(name: string): string {\n    return `Error: Tool '${name}' must be discovered first. Call ${DISCOVERY_TOOL_NAME} with toolNames: ['${name}'] to discover it.`\n  }\n\n  /**\n   * Scans message history to find previously discovered lazy tools.\n   * Looks for assistant messages with discovery tool calls and their\n   * corresponding tool result messages.\n   */\n  private scanMessageHistory(\n    messages: ReadonlyArray<{\n      role: string\n      content?: any\n      toolCalls?: Array<{\n        id: string\n        type: string\n        function: { name: string; arguments: string }\n      }>\n      toolCallId?: string\n    }>,\n  ): void {\n    // Collect tool call IDs for discovery tool invocations\n    const discoveryCallIds = new Set<string>()\n\n    for (const msg of messages) {\n      if (msg.role === 'assistant' && msg.toolCalls) {\n        for (const tc of msg.toolCalls) {\n          if (tc.function.name === DISCOVERY_TOOL_NAME) {\n            discoveryCallIds.add(tc.id)\n          }\n        }\n      }\n    }\n\n    if (discoveryCallIds.size === 0) return\n\n    // Find corresponding tool result messages\n    for (const msg of messages) {\n      if (\n        msg.role === 'tool' &&\n        msg.toolCallId &&\n        discoveryCallIds.has(msg.toolCallId)\n      ) {\n        try {\n          const content =\n            typeof msg.content === 'string'\n              ? msg.content\n              : JSON.stringify(msg.content)\n          const parsed = JSON.parse(content)\n          if (parsed && Array.isArray(parsed.tools)) {\n            for (const tool of parsed.tools) {\n              if (\n                tool &&\n                typeof tool.name === 'string' &&\n                this.lazyToolMap.has(tool.name)\n              ) {\n                this.discoveredTools.add(tool.name)\n              }\n            }\n          }\n        } catch {\n          // Malformed JSON — skip gracefully\n        }\n      }\n    }\n  }\n\n  /**\n   * Creates the synthetic discovery tool that the LLM can call\n   * to discover lazy tools' descriptions and schemas.\n   */\n  private createDiscoveryTool(): Tool {\n    const undiscoveredNames = (): Array<string> => {\n      const names: Array<string> = []\n      for (const [name] of this.lazyToolMap) {\n        if (!this.discoveredTools.has(name)) {\n          names.push(name)\n        }\n      }\n      return names\n    }\n\n    const lazyToolMap = this.lazyToolMap\n\n    // Build the static description, rendering each entry per includeDescription.\n    // With the default 'none' this is byte-identical to the legacy output.\n    const include = this.lazyToolsConfig.includeDescription ?? 'none'\n    const allLazyEntries = Array.from(this.lazyToolMap.values()).map((t) =>\n      renderLazyCatalogEntry(t.name, t.description, include),\n    )\n    const description = `You have access to additional tools that can be discovered. Available tools: [${allLazyEntries.join(', ')}]. Call this tool with a list of tool names to discover their full descriptions and argument schemas before using them.`\n\n    // Use the arrow function to capture `this` context\n    const manager = this\n\n    return {\n      name: DISCOVERY_TOOL_NAME,\n      description,\n      inputSchema: {\n        type: 'object',\n        properties: {\n          toolNames: {\n            type: 'array',\n            items: { type: 'string' },\n            description:\n              'List of tool names to discover. Each name must match one of the available tools.',\n          },\n        },\n        required: ['toolNames'],\n      },\n      execute: (args: { toolNames: Array<string> }) => {\n        const tools: Array<{\n          name: string\n          description: string\n          inputSchema?: any\n        }> = []\n        const errors: Array<string> = []\n\n        for (const name of args.toolNames) {\n          const tool = lazyToolMap.get(name)\n          if (tool) {\n            // Only flag a refresh for genuinely new discoveries. Re-requesting\n            // an already-discovered tool still returns its schema below (the\n            // model asked for it), but must not trigger a redundant tool-list\n            // refresh + continue in the agent loop.\n            if (!manager.discoveredTools.has(name)) {\n              manager.discoveredTools.add(name)\n              manager.hasNewDiscoveries = true\n            }\n            const jsonSchema = tool.inputSchema\n              ? convertSchemaToJsonSchema(tool.inputSchema)\n              : undefined\n            tools.push({\n              name: tool.name,\n              description: tool.description,\n              ...(jsonSchema ? { inputSchema: jsonSchema } : {}),\n            })\n          } else {\n            errors.push(\n              `Unknown tool: '${name}'. Available tools: [${undiscoveredNames().join(', ')}]`,\n            )\n          }\n        }\n\n        const result: {\n          tools: typeof tools\n          errors?: Array<string>\n        } = { tools }\n\n        if (errors.length > 0) {\n          result.errors = errors\n        }\n\n        return result\n      },\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"lazy-tool-manager.js","names":[],"sources":["../../../../../src/activities/chat/tools/lazy-tool-manager.ts"],"sourcesContent":["import { convertSchemaToJsonSchema } from './schema-converter'\nimport { renderLazyCatalogEntry } from './lazy-tools'\nimport type { AnyTool, LazyToolsConfig, Tool } from '../../../types'\n\n/**\n * Name of the synthetic tool the LLM calls to discover lazy tools.\n *\n * Exported so callers building custom message-compaction / history-trimming\n * logic can reference the discovery tool by constant instead of hard-coding\n * the string (which is an internal contract that could change).\n */\nexport const DISCOVERY_TOOL_NAME = '__lazy__tool__discovery__'\n\n/**\n * Manages lazy tool discovery for the chat agent loop.\n *\n * Lazy tools are not sent to the LLM initially. Instead, a synthetic\n * \"discovery tool\" is provided that lets the LLM discover lazy tools\n * by name, receiving their full descriptions and schemas on demand.\n */\nexport class LazyToolManager {\n  private readonly eagerTools: ReadonlyArray<Tool>\n  private readonly lazyToolMap: Map<string, Tool>\n  private readonly discoveredTools: Set<string>\n  private hasNewDiscoveries: boolean\n  private readonly discoveryTool: Tool | null\n  private readonly lazyToolsConfig: LazyToolsConfig\n\n  constructor(\n    tools: ReadonlyArray<Tool>,\n    messages: ReadonlyArray<{\n      role: string\n      content?: any\n      toolCalls?: Array<{\n        id: string\n        type: string\n        function: { name: string; arguments: string }\n      }>\n      toolCallId?: string\n    }>,\n    lazyToolsConfig: LazyToolsConfig = {},\n  ) {\n    this.lazyToolsConfig = lazyToolsConfig\n    const eager: Array<Tool> = []\n    this.lazyToolMap = new Map()\n    this.discoveredTools = new Set()\n    this.hasNewDiscoveries = false\n\n    // Separate tools into eager and lazy\n    for (const tool of tools) {\n      if (tool.lazy) {\n        this.lazyToolMap.set(tool.name, tool)\n      } else {\n        eager.push(tool)\n      }\n    }\n    this.eagerTools = eager\n\n    // If no lazy tools, no discovery tool needed\n    if (this.lazyToolMap.size === 0) {\n      this.discoveryTool = null\n      return\n    }\n\n    // Scan message history to pre-populate discoveredTools\n    this.scanMessageHistory(messages)\n\n    // Create the synthetic discovery tool\n    this.discoveryTool = this.createDiscoveryTool()\n  }\n\n  /**\n   * Returns the set of tools that should be sent to the LLM:\n   * eager tools + discovered lazy tools + discovery tool (if undiscovered tools remain).\n   * Resets the hasNewDiscoveries flag.\n   */\n  getActiveTools(): Array<Tool> {\n    this.hasNewDiscoveries = false\n\n    const active: Array<Tool> = [...this.eagerTools]\n\n    // Add discovered lazy tools\n    for (const name of this.discoveredTools) {\n      const tool = this.lazyToolMap.get(name)\n      if (tool) {\n        active.push(tool)\n      }\n    }\n\n    // Add discovery tool if there are still undiscovered lazy tools\n    if (\n      this.discoveryTool &&\n      this.discoveredTools.size < this.lazyToolMap.size\n    ) {\n      active.push(this.discoveryTool)\n    }\n\n    return active\n  }\n\n  /**\n   * Returns the tools that should be available for *execution* this turn.\n   *\n   * This is the advertised set (`getActiveTools()`, passed in as `activeTools`)\n   * plus the discovery tool when a pending call references it but it is no\n   * longer advertised. Once every lazy tool has been discovered the discovery\n   * tool is dropped from the advertised set, but a model may still re-request\n   * discovery (long context / hallucination); keeping it executable lets that\n   * call return the schemas again instead of failing with \"Unknown tool\".\n   *\n   * The advertised set is intentionally left unchanged — only execution lookup\n   * is widened. Operates on the already-built `activeTools`: it must NOT call\n   * `getActiveTools()`, which would reset `hasNewDiscoveries` before the\n   * post-execution refresh check in the agent loop.\n   */\n  getExecutableTools(\n    activeTools: ReadonlyArray<AnyTool>,\n    pendingToolCallNames: ReadonlyArray<string>,\n  ): ReadonlyArray<AnyTool> {\n    if (\n      this.discoveryTool &&\n      pendingToolCallNames.includes(DISCOVERY_TOOL_NAME) &&\n      !activeTools.some((t) => t.name === DISCOVERY_TOOL_NAME)\n    ) {\n      return [...activeTools, this.discoveryTool]\n    }\n    return activeTools\n  }\n\n  /**\n   * Returns whether new tools have been discovered since the last getActiveTools() call.\n   */\n  hasNewlyDiscoveredTools(): boolean {\n    return this.hasNewDiscoveries\n  }\n\n  /**\n   * Returns true if the given name is a lazy tool that has not yet been discovered.\n   */\n  isUndiscoveredLazyTool(name: string): boolean {\n    return this.lazyToolMap.has(name) && !this.discoveredTools.has(name)\n  }\n\n  /**\n   * Returns a helpful error message for when an undiscovered lazy tool is called.\n   */\n  getUndiscoveredToolError(name: string): string {\n    return `Error: Tool '${name}' must be discovered first. Call ${DISCOVERY_TOOL_NAME} with toolNames: ['${name}'] to discover it.`\n  }\n\n  /**\n   * Scans message history to find previously discovered lazy tools.\n   * Looks for assistant messages with discovery tool calls and their\n   * corresponding tool result messages.\n   */\n  private scanMessageHistory(\n    messages: ReadonlyArray<{\n      role: string\n      content?: any\n      toolCalls?: Array<{\n        id: string\n        type: string\n        function: { name: string; arguments: string }\n      }>\n      toolCallId?: string\n    }>,\n  ): void {\n    // Collect tool call IDs for discovery tool invocations\n    const discoveryCallIds = new Set<string>()\n\n    for (const msg of messages) {\n      if (msg.role === 'assistant' && msg.toolCalls) {\n        for (const tc of msg.toolCalls) {\n          if (tc.function.name === DISCOVERY_TOOL_NAME) {\n            discoveryCallIds.add(tc.id)\n          }\n        }\n      }\n    }\n\n    if (discoveryCallIds.size === 0) return\n\n    // Find corresponding tool result messages\n    for (const msg of messages) {\n      if (\n        msg.role === 'tool' &&\n        msg.toolCallId &&\n        discoveryCallIds.has(msg.toolCallId)\n      ) {\n        try {\n          const content =\n            typeof msg.content === 'string'\n              ? msg.content\n              : JSON.stringify(msg.content)\n          const parsed = JSON.parse(content)\n          if (parsed && Array.isArray(parsed.tools)) {\n            for (const tool of parsed.tools) {\n              if (\n                tool &&\n                typeof tool.name === 'string' &&\n                this.lazyToolMap.has(tool.name)\n              ) {\n                this.discoveredTools.add(tool.name)\n              }\n            }\n          }\n        } catch {\n          // Malformed JSON — skip gracefully\n        }\n      }\n    }\n  }\n\n  /**\n   * Creates the synthetic discovery tool that the LLM can call\n   * to discover lazy tools' descriptions and schemas.\n   */\n  private createDiscoveryTool(): Tool {\n    const undiscoveredNames = (): Array<string> => {\n      const names: Array<string> = []\n      for (const [name] of this.lazyToolMap) {\n        if (!this.discoveredTools.has(name)) {\n          names.push(name)\n        }\n      }\n      return names\n    }\n\n    const lazyToolMap = this.lazyToolMap\n\n    // Build the static description, rendering each entry per includeDescription.\n    // With the default 'none' this is byte-identical to the legacy output.\n    const include = this.lazyToolsConfig.includeDescription ?? 'none'\n    const allLazyEntries = Array.from(this.lazyToolMap.values()).map((t) =>\n      renderLazyCatalogEntry(t.name, t.description, include),\n    )\n    const description = `You have access to additional tools that can be discovered. Available tools: [${allLazyEntries.join(', ')}]. Call this tool with a list of tool names to discover their full descriptions and argument schemas before using them.`\n\n    // Use the arrow function to capture `this` context\n    const manager = this\n\n    return {\n      name: DISCOVERY_TOOL_NAME,\n      description,\n      inputSchema: {\n        type: 'object',\n        properties: {\n          toolNames: {\n            type: 'array',\n            items: { type: 'string' },\n            description:\n              'List of tool names to discover. Each name must match one of the available tools.',\n          },\n        },\n        required: ['toolNames'],\n      },\n      execute: (args: { toolNames: Array<string> }) => {\n        const tools: Array<{\n          name: string\n          description: string\n          inputSchema?: any\n        }> = []\n        const errors: Array<string> = []\n\n        for (const name of args.toolNames) {\n          const tool = lazyToolMap.get(name)\n          if (tool) {\n            // Only flag a refresh for genuinely new discoveries. Re-requesting\n            // an already-discovered tool still returns its schema below (the\n            // model asked for it), but must not trigger a redundant tool-list\n            // refresh + continue in the agent loop.\n            if (!manager.discoveredTools.has(name)) {\n              manager.discoveredTools.add(name)\n              manager.hasNewDiscoveries = true\n            }\n            const jsonSchema = tool.inputSchema\n              ? convertSchemaToJsonSchema(tool.inputSchema)\n              : undefined\n            tools.push({\n              name: tool.name,\n              description: tool.description,\n              ...(jsonSchema ? { inputSchema: jsonSchema } : {}),\n            })\n          } else {\n            errors.push(\n              `Unknown tool: '${name}'. Available tools: [${undiscoveredNames().join(', ')}]`,\n            )\n          }\n        }\n\n        const result: {\n          tools: typeof tools\n          errors?: Array<string>\n        } = { tools }\n\n        if (errors.length > 0) {\n          result.errors = errors\n        }\n\n        return result\n      },\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/esm/activities/chat/tools/lazy-tools.js

@@ -1,16 +1,28 @@
+//#region src/activities/chat/tools/lazy-tools.ts
+/**
+* Extract the first sentence of a description (up to the first ., !, or ?
+* followed by whitespace or end-of-string). Falls back to the whole trimmed
+* string when there is no sentence terminator.
+*/
 function firstSentence(text) {
-  const trimmed = text.trim();
-  if (!trimmed) return "";
-  const match = trimmed.match(/^.*?[.!?](?=\s|$)/);
-  return (match ? match[0] : trimmed).trim();
+	const trimmed = text.trim();
+	if (!trimmed) return "";
+	const match = trimmed.match(/^.*?[.!?](?=\s|$)/);
+	return (match ? match[0] : trimmed).trim();
 }
+/**
+* Render one entry in a lazy-tool catalog according to `includeDescription`.
+* - 'none' (default) → bare name (preserves legacy chat behavior)
+* - 'first-sentence' → `name — <first sentence>`
+* - 'full' → `name — <full description>`
+* Falls back to the bare name when there is no description.
+*/
 function renderLazyCatalogEntry(name, description, includeDescription = "none") {
-  if (includeDescription === "none" || !description.trim()) return name;
-  const desc = includeDescription === "first-sentence" ? firstSentence(description) : description.trim();
-  return desc ? `${name} — ${desc}` : name;
+	if (includeDescription === "none" || !description.trim()) return name;
+	const desc = includeDescription === "first-sentence" ? firstSentence(description) : description.trim();
+	return desc ? `${name} — ${desc}` : name;
 }
-export {
-  firstSentence,
-  renderLazyCatalogEntry
-};
-//# sourceMappingURL=lazy-tools.js.map
+//#endregion
+export { firstSentence, renderLazyCatalogEntry };
+
+//# sourceMappingURL=lazy-tools.js.map

package/dist/esm/activities/chat/tools/lazy-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-tools.js","sources":["../../../../../src/activities/chat/tools/lazy-tools.ts"],"sourcesContent":["import type { LazyToolsConfig } from '../../../types'\n\n/**\n * Extract the first sentence of a description (up to the first ., !, or ?\n * followed by whitespace or end-of-string). Falls back to the whole trimmed\n * string when there is no sentence terminator.\n */\nexport function firstSentence(text: string): string {\n  const trimmed = text.trim()\n  if (!trimmed) return ''\n  const match = trimmed.match(/^.*?[.!?](?=\\s|$)/)\n  return (match ? match[0] : trimmed).trim()\n}\n\n/**\n * Render one entry in a lazy-tool catalog according to `includeDescription`.\n * - 'none' (default) → bare name (preserves legacy chat behavior)\n * - 'first-sentence' → `name — <first sentence>`\n * - 'full' → `name — <full description>`\n * Falls back to the bare name when there is no description.\n */\nexport function renderLazyCatalogEntry(\n  name: string,\n  description: string,\n  includeDescription: LazyToolsConfig['includeDescription'] = 'none',\n): string {\n  if (includeDescription === 'none' || !description.trim()) return name\n  const desc =\n    includeDescription === 'first-sentence'\n      ? firstSentence(description)\n      : description.trim()\n  return desc ? `${name} — ${desc}` : name\n}\n"],"names":[],"mappings":"AAOO,SAAS,cAAc,MAAsB;AAClD,QAAM,UAAU,KAAK,KAAA;AACrB,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,QAAQ,QAAQ,MAAM,mBAAmB;AAC/C,UAAQ,QAAQ,MAAM,CAAC,IAAI,SAAS,KAAA;AACtC;AASO,SAAS,uBACd,MACA,aACA,qBAA4D,QACpD;AACR,MAAI,uBAAuB,UAAU,CAAC,YAAY,KAAA,EAAQ,QAAO;AACjE,QAAM,OACJ,uBAAuB,mBACnB,cAAc,WAAW,IACzB,YAAY,KAAA;AAClB,SAAO,OAAO,GAAG,IAAI,MAAM,IAAI,KAAK;AACtC;"}
+{"version":3,"file":"lazy-tools.js","names":[],"sources":["../../../../../src/activities/chat/tools/lazy-tools.ts"],"sourcesContent":["import type { LazyToolsConfig } from '../../../types'\n\n/**\n * Extract the first sentence of a description (up to the first ., !, or ?\n * followed by whitespace or end-of-string). Falls back to the whole trimmed\n * string when there is no sentence terminator.\n */\nexport function firstSentence(text: string): string {\n  const trimmed = text.trim()\n  if (!trimmed) return ''\n  const match = trimmed.match(/^.*?[.!?](?=\\s|$)/)\n  return (match ? match[0] : trimmed).trim()\n}\n\n/**\n * Render one entry in a lazy-tool catalog according to `includeDescription`.\n * - 'none' (default) → bare name (preserves legacy chat behavior)\n * - 'first-sentence' → `name — <first sentence>`\n * - 'full' → `name — <full description>`\n * Falls back to the bare name when there is no description.\n */\nexport function renderLazyCatalogEntry(\n  name: string,\n  description: string,\n  includeDescription: LazyToolsConfig['includeDescription'] = 'none',\n): string {\n  if (includeDescription === 'none' || !description.trim()) return name\n  const desc =\n    includeDescription === 'first-sentence'\n      ? firstSentence(description)\n      : description.trim()\n  return desc ? `${name} — ${desc}` : name\n}\n"],"mappings":";;;;;;AAOA,SAAgB,cAAc,MAAsB;CAClD,MAAM,UAAU,KAAK,KAAK;CAC1B,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,QAAQ,QAAQ,MAAM,mBAAmB;CAC/C,QAAQ,QAAQ,MAAM,KAAK,QAAA,CAAS,KAAK;AAC3C;;;;;;;;AASA,SAAgB,uBACd,MACA,aACA,qBAA4D,QACpD;CACR,IAAI,uBAAuB,UAAU,CAAC,YAAY,KAAK,GAAG,OAAO;CACjE,MAAM,OACJ,uBAAuB,mBACnB,cAAc,WAAW,IACzB,YAAY,KAAK;CACvB,OAAO,OAAO,GAAG,KAAK,KAAK,SAAS;AACtC"}