bigtool-ts 0.1.0

package/dist/graph/nodes.js

@@ -0,0 +1,190 @@
+/**
+ * Graph Nodes
+ *
+ * Node factories for the BigTool LangGraph agent.
+ */
+import { isAIMessage, SystemMessage, ToolMessage, } from "@langchain/core/messages";
+import { ToolNode } from "@langchain/langgraph/prebuilt";
+/**
+ * Creates the agent node that invokes the LLM with bound tools.
+ *
+ * The agent always has access to:
+ * 1. search_tools - for discovering new tools
+ * 2. pinnedTools - always available tools
+ * 3. selectedTools - tools discovered via search
+ *
+ * @param config - Agent node configuration
+ * @returns A node function for the StateGraph
+ */
+export function createAgentNode(config) {
+    const { llm, loader, pinnedTools, searchTool, systemPrompt } = config;
+    return async (state, runnableConfig) => {
+        // Load selected tools from the loader
+        const selectedTools = await Promise.all(state.selectedToolIds.map(async (id) => {
+            try {
+                return await loader.load(id);
+            }
+            catch {
+                // Tool might have been removed - skip it
+                return null;
+            }
+        }));
+        // Filter out nulls (failed loads)
+        const loadedSelectedTools = selectedTools.filter((t) => t !== null);
+        // Combine all tools: search_tools + pinned + selected
+        const allTools = [searchTool, ...pinnedTools, ...loadedSelectedTools];
+        // Bind tools to the LLM
+        if (!llm.bindTools) {
+            throw new Error('LLM does not support tool binding');
+        }
+        const modelWithTools = llm.bindTools(allTools);
+        // Prepare messages with optional system prompt
+        let messages = state.messages;
+        if (systemPrompt &&
+            (messages.length === 0 || messages[0]._getType() !== "system")) {
+            messages = [new SystemMessage(systemPrompt), ...messages];
+        }
+        // Invoke the LLM
+        const response = await modelWithTools.invoke(messages, runnableConfig);
+        return { messages: [response] };
+    };
+}
+/**
+ * Creates the search node that executes search_tools calls.
+ *
+ * This node:
+ * 1. Extracts search_tools calls from the last message
+ * 2. Executes searches against the index
+ * 3. Updates selectedToolIds with found tools
+ * 4. Returns ToolMessages with search results
+ *
+ * @param config - Search node configuration
+ * @returns A node function for the StateGraph
+ */
+export function createSearchNode(config) {
+    const { index, catalog, searchLimit = 5 } = config;
+    return async (state, _runnableConfig) => {
+        const lastMessage = state.messages[state.messages.length - 1];
+        // Verify we have an AI message with tool calls
+        if (!isAIMessage(lastMessage) || !lastMessage.tool_calls?.length) {
+            return {};
+        }
+        const toolMessages = [];
+        const newToolIds = [];
+        const searchQueries = [];
+        // Process each tool call
+        for (const toolCall of lastMessage.tool_calls) {
+            // Only handle search_tools calls
+            if (toolCall.name !== "search_tools") {
+                continue;
+            }
+            const { query } = toolCall.args;
+            // Execute the search
+            const results = await index.search(query, { limit: searchLimit });
+            const foundIds = results.map((r) => r.toolId);
+            newToolIds.push(...foundIds);
+            // Record the search for history
+            searchQueries.push({
+                query,
+                results: foundIds,
+                timestamp: Date.now(),
+            });
+            // Format the response for the LLM
+            let content;
+            if (foundIds.length === 0) {
+                content = `No tools found matching "${query}". Try a different search query.`;
+            }
+            else {
+                const toolDescriptions = foundIds
+                    .map((id) => {
+                    const meta = catalog.getMetadata(id);
+                    return meta ? `- **${meta.name}**: ${meta.description}` : null;
+                })
+                    .filter(Boolean)
+                    .join("\n");
+                content = `Found ${foundIds.length} tool${foundIds.length === 1 ? "" : "s"}:\n${toolDescriptions}\n\nYou can now use these tools.`;
+            }
+            toolMessages.push(new ToolMessage({
+                content,
+                tool_call_id: toolCall.id ?? "",
+                name: "search_tools",
+            }));
+        }
+        return {
+            messages: toolMessages,
+            selectedToolIds: newToolIds,
+            searchHistory: searchQueries,
+        };
+    };
+}
+/**
+ * Creates the execute node that runs selected tools.
+ *
+ * Uses LangGraph's ToolNode to execute tool calls from the last message.
+ * Tools are loaded from the loader + pinnedTools.
+ *
+ * @param config - Execute node configuration
+ * @returns A node function for the StateGraph
+ */
+export function createExecuteNode(config) {
+    const { loader, pinnedTools } = config;
+    return async (state, runnableConfig) => {
+        // Load selected tools
+        const selectedTools = await Promise.all(state.selectedToolIds.map(async (id) => {
+            try {
+                return await loader.load(id);
+            }
+            catch {
+                return null;
+            }
+        }));
+        const loadedSelectedTools = selectedTools.filter((t) => t !== null);
+        // Create ToolNode with all available tools
+        const allTools = [...pinnedTools, ...loadedSelectedTools];
+        const toolNode = new ToolNode(allTools);
+        // Execute the tools
+        const result = await toolNode.invoke(state, runnableConfig);
+        return result;
+    };
+}
+// ═══════════════════════════════════════════════════════════════════
+// LEGACY EXPORTS (for backwards compatibility)
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @deprecated Use createSearchNode instead
+ */
+export async function searchNode(_state, _config) {
+    throw new Error("searchNode: Use createSearchNode factory to create a configured node");
+}
+/**
+ * Routing function - determines next node based on last message.
+ *
+ * Returns:
+ * - "search" if agent called search_tools
+ * - "execute" if agent called other tools
+ * - "end" if agent responded without tool calls
+ */
+export function routeNode(state) {
+    const lastMessage = state.messages[state.messages.length - 1];
+    if (!lastMessage) {
+        return "end";
+    }
+    // Check if it's an AI message
+    if (!isAIMessage(lastMessage)) {
+        return "end";
+    }
+    // Check for tool calls
+    if (!lastMessage.tool_calls || lastMessage.tool_calls.length === 0) {
+        return "end";
+    }
+    // Check if it's a search request
+    const hasSearchCall = lastMessage.tool_calls.some((tc) => tc.name === "search_tools");
+    return hasSearchCall ? "search" : "execute";
+}
+/**
+ * @deprecated Use createExecuteNode instead
+ */
+export async function executeNode(_state, _config) {
+    throw new Error("executeNode: Use createExecuteNode factory to create a configured node");
+}
+//# sourceMappingURL=nodes.js.map

package/dist/graph/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/graph/nodes.ts"],"names":[],"mappings":"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"}

package/dist/graph/search-tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * search_tools Tool
+ *
+ * The dynamic tool that allows the LLM to discover relevant tools
+ * by searching through the tool catalog.
+ */
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import type { SearchIndex, ToolCatalog } from "../types.js";
+/**
+ * Configuration for creating the search_tools tool
+ */
+export interface CreateSearchToolsToolConfig {
+    /** The search index for finding tools */
+    index: SearchIndex;
+    /** The tool catalog for getting metadata */
+    catalog: ToolCatalog;
+    /** Maximum number of results to return */
+    limit?: number;
+}
+/**
+ * Creates the search_tools DynamicStructuredTool.
+ *
+ * This tool is always bound to the LLM and allows it to discover
+ * relevant tools based on what it needs to accomplish.
+ *
+ * @param config - Configuration for the search tool
+ * @returns A DynamicStructuredTool for searching tools
+ */
+export declare function createSearchToolsTool(config: CreateSearchToolsToolConfig): DynamicStructuredTool;
+/**
+ * Type of the search_tools tool
+ */
+export type SearchToolsTool = ReturnType<typeof createSearchToolsTool>;
+//# sourceMappingURL=search-tool.d.ts.map

package/dist/graph/search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tool.d.ts","sourceRoot":"","sources":["../../src/graph/search-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAW5D;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yCAAyC;IACzC,KAAK,EAAE,WAAW,CAAC;IACnB,4CAA4C;IAC5C,OAAO,EAAE,WAAW,CAAC;IACrB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,2BAA2B,GAClC,qBAAqB,CAgCvB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/graph/search-tool.js

@@ -0,0 +1,54 @@
+/**
+ * search_tools Tool
+ *
+ * The dynamic tool that allows the LLM to discover relevant tools
+ * by searching through the tool catalog.
+ */
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+/**
+ * Schema for the search_tools input
+ */
+const SearchToolsSchema = z.object({
+    query: z.string().describe("Search query to find relevant tools. Use natural language like 'github', 'send message', 'create file'"),
+});
+/**
+ * Creates the search_tools DynamicStructuredTool.
+ *
+ * This tool is always bound to the LLM and allows it to discover
+ * relevant tools based on what it needs to accomplish.
+ *
+ * @param config - Configuration for the search tool
+ * @returns A DynamicStructuredTool for searching tools
+ */
+export function createSearchToolsTool(config) {
+    const { index, catalog, limit = 5 } = config;
+    return new DynamicStructuredTool({
+        name: "search_tools",
+        description: `Search for relevant tools based on what you need to accomplish.
+Use this when you need to find tools for a specific task.
+Example queries: "github", "send message", "create file", "database query"
+
+After searching, the found tools will become available for you to use.`,
+        schema: SearchToolsSchema,
+        func: async ({ query }) => {
+            // Execute the search
+            const results = await index.search(query, { limit });
+            if (results.length === 0) {
+                return `No tools found matching "${query}". Try a different search query.`;
+            }
+            // Format the results with descriptions
+            const descriptions = results
+                .map((result) => {
+                const meta = catalog.getMetadata(result.toolId);
+                if (!meta)
+                    return null;
+                return `- **${meta.name}**: ${meta.description}`;
+            })
+                .filter(Boolean)
+                .join("\n");
+            return `Found ${results.length} tool${results.length === 1 ? "" : "s"}:\n${descriptions}\n\nYou can now use these tools.`;
+        },
+    });
+}
+//# sourceMappingURL=search-tool.js.map

package/dist/graph/search-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tool.js","sourceRoot":"","sources":["../../src/graph/search-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACxB,wGAAwG,CACzG;CACF,CAAC,CAAC;AAcH;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmC;IAEnC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC;IAE7C,OAAO,IAAI,qBAAqB,CAAC;QAC/B,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE;;;;uEAIsD;QACnE,MAAM,EAAE,iBAAiB;QACzB,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YACxB,qBAAqB;YACrB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAErD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,4BAA4B,KAAK,kCAAkC,CAAC;YAC7E,CAAC;YAED,uCAAuC;YACvC,MAAM,YAAY,GAAG,OAAO;iBACzB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBACd,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAChD,IAAI,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC;gBACvB,OAAO,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;YACnD,CAAC,CAAC;iBACD,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO,SAAS,OAAO,CAAC,MAAM,QAAQ,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,YAAY,kCAAkC,CAAC;QAC5H,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/graph/state.d.ts

@@ -0,0 +1,26 @@
+import type { BaseMessage } from '@langchain/core/messages';
+/**
+ * Search query recorded in history
+ */
+export interface SearchQuery {
+    query: string;
+    results: string[];
+    timestamp: number;
+}
+/**
+ * State annotation for the tool discovery graph.
+ *
+ * Tracks conversation messages, currently selected tools,
+ * and search history for context.
+ */
+export declare const ToolDiscoveryAnnotation: import("@langchain/langgraph").AnnotationRoot<{
+    /** Conversation messages with automatic message merging */
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[], BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[]>;
+    /** Currently selected tool IDs (available to the agent) */
+    selectedToolIds: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    /** History of search queries for context */
+    searchHistory: import("@langchain/langgraph").BinaryOperatorAggregate<SearchQuery[], SearchQuery[]>;
+}>;
+export type ToolDiscoveryState = typeof ToolDiscoveryAnnotation.State;
+export type ToolDiscoveryUpdate = typeof ToolDiscoveryAnnotation.Update;
+//# sourceMappingURL=state.d.ts.map

package/dist/graph/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/graph/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;IAClC,2DAA2D;;IAM3D,2DAA2D;;IAU3D,4CAA4C;;EAK5C,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,uBAAuB,CAAC,KAAK,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,OAAO,uBAAuB,CAAC,MAAM,CAAC"}

package/dist/graph/state.js

@@ -0,0 +1,29 @@
+import { Annotation, messagesStateReducer } from '@langchain/langgraph';
+/**
+ * State annotation for the tool discovery graph.
+ *
+ * Tracks conversation messages, currently selected tools,
+ * and search history for context.
+ */
+export const ToolDiscoveryAnnotation = Annotation.Root({
+    /** Conversation messages with automatic message merging */
+    messages: Annotation({
+        reducer: messagesStateReducer,
+        default: () => [],
+    }),
+    /** Currently selected tool IDs (available to the agent) */
+    selectedToolIds: Annotation({
+        reducer: (current, update) => {
+            // Deduplicate tool IDs
+            const set = new Set([...current, ...update]);
+            return Array.from(set);
+        },
+        default: () => [],
+    }),
+    /** History of search queries for context */
+    searchHistory: Annotation({
+        reducer: (current, update) => [...current, ...update],
+        default: () => [],
+    }),
+});
+//# sourceMappingURL=state.js.map

package/dist/graph/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/graph/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAYxE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC,IAAI,CAAC;IACrD,2DAA2D;IAC3D,QAAQ,EAAE,UAAU,CAAgB;QAClC,OAAO,EAAE,oBAAoB;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;IAEF,2DAA2D;IAC3D,eAAe,EAAE,UAAU,CAAW;QACpC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3B,uBAAuB;YACvB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;IAEF,4CAA4C;IAC5C,aAAa,EAAE,UAAU,CAAgB;QACvC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;QACrD,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB,CAAC;CACH,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @module @repo/bigtool-ts
+ *
+ * BigTool-TS: Dynamic tool discovery and management for LangGraph agents.
+ *
+ * This package provides a complete system for managing large tool collections
+ * with intelligent search-based discovery. Instead of loading all tools into
+ * the LLM context, agents can search for and load tools on demand.
+ *
+ * ## Core Concepts
+ *
+ * - **ToolSource**: Provides tools from a specific origin (local, MCP server, dynamic)
+ * - **ToolCatalog**: Registry that aggregates tools from multiple sources
+ * - **SearchIndex**: Enables fast tool discovery via text or semantic search
+ * - **ToolLoader**: Lazy-loads tool implementations with LRU caching
+ *
+ * ## Quick Start
+ *
+ * @example Basic usage with local tools
+ * ```typescript
+ * import { createAgent, OramaSearch } from '@repo/bigtool-ts';
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * const agent = await createAgent({
+ *   llm: new ChatOpenAI({ model: 'gpt-4o' }),
+ *   tools: [myTool1, myTool2, myTool3],
+ *   search: new OramaSearch(),
+ * });
+ *
+ * const result = await agent.invoke({
+ *   messages: [{ role: 'user', content: 'Create a GitHub PR' }]
+ * });
+ * ```
+ *
+ * @example Advanced usage with multiple sources
+ * ```typescript
+ * import {
+ *   createAgent,
+ *   LocalSource,
+ *   MCPSource,
+ *   OramaSearch,
+ * } from '@repo/bigtool-ts';
+ *
+ * const agent = await createAgent({
+ *   llm: new ChatOpenAI({ model: 'gpt-4o' }),
+ *   sources: [
+ *     new LocalSource(myLocalTools),
+ *     new MCPSource(mcpClient, { namespace: 'github' }),
+ *   ],
+ *   search: new OramaSearch({ mode: 'hybrid', embeddings }),
+ *   pinnedTools: [alwaysAvailableTool],
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createAgent, createToolDiscoveryGraph } from './graph/agent.js';
+export type { CreateAgentOptions } from './graph/agent.js';
+export type { ToolSource, ToolMetadata, ToolCatalog, ToolsChangedEvent, SearchIndex, SearchOptions, SearchResult, ToolLoader, EventEmitter, EventHandler, Unsubscribe, ToolEnhancement, EnhancedTool, } from './types.js';
+export { createEventEmitter, withMetadata } from './types.js';
+export { LocalSource } from './sources/local.js';
+export { MCPSource, createMCPSource, type MCPSourceOptions, type MCPClient, type MCPServerConfig, type MCPStdioConfig, type MCPSSEConfig, type MCPWebSocketConfig, } from './sources/mcp.js';
+export { DynamicSource, type DynamicSourceOptions } from './sources/dynamic.js';
+export { DefaultToolCatalog } from './catalog/index.js';
+export { OramaSearch, type OramaSearchConfig } from './search/index.js';
+export { DefaultToolLoader, type ToolLoaderOptions } from './loader/index.js';
+export { ToolDiscoveryAnnotation, type ToolDiscoveryState, type ToolDiscoveryUpdate, type SearchQuery } from './graph/state.js';
+export { searchNode, routeNode, executeNode } from './graph/nodes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAMH,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAM3D,YAAY,EAEV,UAAU,EACV,YAAY,EAGZ,WAAW,EACX,iBAAiB,EAGjB,WAAW,EACX,aAAa,EACb,YAAY,EAGZ,UAAU,EAGV,YAAY,EACZ,YAAY,EACZ,WAAW,EAGX,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAMhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMxD,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAMxE,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAM9E,OAAO,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChI,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,85 @@
+/**
+ * @module @repo/bigtool-ts
+ *
+ * BigTool-TS: Dynamic tool discovery and management for LangGraph agents.
+ *
+ * This package provides a complete system for managing large tool collections
+ * with intelligent search-based discovery. Instead of loading all tools into
+ * the LLM context, agents can search for and load tools on demand.
+ *
+ * ## Core Concepts
+ *
+ * - **ToolSource**: Provides tools from a specific origin (local, MCP server, dynamic)
+ * - **ToolCatalog**: Registry that aggregates tools from multiple sources
+ * - **SearchIndex**: Enables fast tool discovery via text or semantic search
+ * - **ToolLoader**: Lazy-loads tool implementations with LRU caching
+ *
+ * ## Quick Start
+ *
+ * @example Basic usage with local tools
+ * ```typescript
+ * import { createAgent, OramaSearch } from '@repo/bigtool-ts';
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * const agent = await createAgent({
+ *   llm: new ChatOpenAI({ model: 'gpt-4o' }),
+ *   tools: [myTool1, myTool2, myTool3],
+ *   search: new OramaSearch(),
+ * });
+ *
+ * const result = await agent.invoke({
+ *   messages: [{ role: 'user', content: 'Create a GitHub PR' }]
+ * });
+ * ```
+ *
+ * @example Advanced usage with multiple sources
+ * ```typescript
+ * import {
+ *   createAgent,
+ *   LocalSource,
+ *   MCPSource,
+ *   OramaSearch,
+ * } from '@repo/bigtool-ts';
+ *
+ * const agent = await createAgent({
+ *   llm: new ChatOpenAI({ model: 'gpt-4o' }),
+ *   sources: [
+ *     new LocalSource(myLocalTools),
+ *     new MCPSource(mcpClient, { namespace: 'github' }),
+ *   ],
+ *   search: new OramaSearch({ mode: 'hybrid', embeddings }),
+ *   pinnedTools: [alwaysAvailableTool],
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// ═══════════════════════════════════════════════════════════════════
+// MAIN API
+// ═══════════════════════════════════════════════════════════════════
+export { createAgent, createToolDiscoveryGraph } from './graph/agent.js';
+export { createEventEmitter, withMetadata } from './types.js';
+// ═══════════════════════════════════════════════════════════════════
+// SOURCES
+// ═══════════════════════════════════════════════════════════════════
+export { LocalSource } from './sources/local.js';
+export { MCPSource, createMCPSource, } from './sources/mcp.js';
+export { DynamicSource } from './sources/dynamic.js';
+// ═══════════════════════════════════════════════════════════════════
+// CATALOG
+// ═══════════════════════════════════════════════════════════════════
+export { DefaultToolCatalog } from './catalog/index.js';
+// ═══════════════════════════════════════════════════════════════════
+// SEARCH
+// ═══════════════════════════════════════════════════════════════════
+export { OramaSearch } from './search/index.js';
+// ═══════════════════════════════════════════════════════════════════
+// LOADER
+// ═══════════════════════════════════════════════════════════════════
+export { DefaultToolLoader } from './loader/index.js';
+// ═══════════════════════════════════════════════════════════════════
+// GRAPH
+// ═══════════════════════════════════════════════════════════════════
+export { ToolDiscoveryAnnotation } from './graph/state.js';
+export { searchNode, routeNode, executeNode } from './graph/nodes.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,sEAAsE;AACtE,WAAW;AACX,sEAAsE;AAEtE,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAkCzE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,sEAAsE;AACtE,UAAU;AACV,sEAAsE;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,SAAS,EACT,eAAe,GAOhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAEhF,sEAAsE;AACtE,UAAU;AACV,sEAAsE;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,sEAAsE;AACtE,SAAS;AACT,sEAAsE;AAEtE,OAAO,EAAE,WAAW,EAA0B,MAAM,mBAAmB,CAAC;AAExE,sEAAsE;AACtE,SAAS;AACT,sEAAsE;AAEtE,OAAO,EAAE,iBAAiB,EAA0B,MAAM,mBAAmB,CAAC;AAE9E,sEAAsE;AACtE,QAAQ;AACR,sEAAsE;AAEtE,OAAO,EAAE,uBAAuB,EAAuE,MAAM,kBAAkB,CAAC;AAChI,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}