bigtool-ts 0.1.0

package/dist/adapters/inngest.js

@@ -0,0 +1,276 @@
+/**
+ * Inngest AgentKit adapter for bigtool-ts.
+ *
+ * Converts bigtool-ts tools to Inngest AgentKit format and provides
+ * search tools for dynamic tool discovery.
+ *
+ * @module adapters/inngest
+ *
+ * @example
+ * ```typescript
+ * import { createInngestAdapter } from '@repo/bigtool-ts/adapters';
+ * import { createAgent, openai } from '@inngest/agent-kit';
+ *
+ * const adapter = createInngestAdapter({ catalog, loader, searchIndex });
+ *
+ * const agent = createAgent({
+ *   name: 'tool-user',
+ *   model: openai({ model: 'gpt-4o' }),
+ *   tools: [
+ *     adapter.createSearchTool(),
+ *     adapter.createCallToolTool(),
+ *   ],
+ *   system: 'You are a helpful assistant...',
+ * });
+ * ```
+ */
+import { z } from 'zod';
+// ═══════════════════════════════════════════════════════════════════
+// ADAPTER IMPLEMENTATION
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Inngest AgentKit adapter for bigtool-ts.
+ *
+ * Implements the ToolAdapter interface to convert bigtool-ts tools
+ * to Inngest AgentKit format. Provides additional tools for dynamic
+ * tool discovery and execution.
+ *
+ * Key features:
+ * - Automatic durable execution wrapping via step.run()
+ * - Search tool for runtime tool discovery
+ * - Call tool for executing discovered tools by name
+ *
+ * @example Basic usage
+ * ```typescript
+ * const adapter = createInngestAdapter({ catalog, loader, searchIndex });
+ *
+ * // Get specific tools by ID
+ * const tools = await adapter.getTools(['github:create_pr', 'slack:send']);
+ *
+ * // Create discovery tools
+ * const searchTool = adapter.createSearchTool({ limit: 5 });
+ * const callTool = adapter.createCallToolTool();
+ * ```
+ */
+export class InngestAdapter {
+    catalog;
+    loader;
+    searchIndex;
+    constructor(config) {
+        this.catalog = config.catalog;
+        this.loader = config.loader;
+        this.searchIndex = config.searchIndex;
+    }
+    /**
+     * Convert bigtool-ts metadata to an Inngest AgentKit tool.
+     *
+     * The resulting tool wraps the bigtool-ts loader and automatically
+     * uses step.run() for durable execution when available.
+     *
+     * **Note:** Parameter schemas are not converted from ToolMetadata to Zod.
+     * The underlying bigtool-ts tool handles its own input validation.
+     * If you need Inngest-side schema validation, provide tools with Zod
+     * schemas directly rather than using the adapter.
+     *
+     * @param metadata - Tool metadata from the catalog
+     * @returns Inngest-compatible tool
+     */
+    toFrameworkTool(metadata) {
+        const loader = this.loader;
+        // Note: We don't convert metadata.parameters (JSON Schema) to Zod because
+        // the conversion is complex and error-prone. The underlying tool validates
+        // its own input. If Zod schemas are needed, use createTool directly.
+        return {
+            name: metadata.name,
+            description: metadata.description,
+            parameters: undefined,
+            handler: async (input, opts) => {
+                const execute = async () => {
+                    const tool = await loader.load(metadata.id);
+                    return tool.invoke(input);
+                };
+                // Use step.run for durable execution when available
+                if (opts.step) {
+                    return opts.step.run(`bigtool:${metadata.name}`, execute);
+                }
+                return execute();
+            },
+        };
+    }
+    /**
+     * Get multiple tools by their IDs.
+     *
+     * Tools not found in the catalog are silently skipped.
+     * Use this when you know which tools you need ahead of time.
+     *
+     * @param toolIds - Array of tool IDs to retrieve
+     * @returns Array of Inngest-compatible tools
+     */
+    async getTools(toolIds) {
+        const tools = [];
+        for (const id of toolIds) {
+            const metadata = this.catalog.getMetadata(id);
+            if (metadata) {
+                tools.push(this.toFrameworkTool(metadata));
+            }
+        }
+        return tools;
+    }
+    /**
+     * Get all tools from the catalog.
+     *
+     * Use sparingly - prefer getTools() or createSearchTool() for
+     * large catalogs.
+     *
+     * @returns Array of all Inngest-compatible tools
+     */
+    async getAllTools() {
+        const allMetadata = this.catalog.getAllMetadata();
+        return allMetadata.map((m) => this.toFrameworkTool(m));
+    }
+    /**
+     * Get tools filtered by category.
+     *
+     * @param categories - Categories to filter by (matches any)
+     * @returns Array of matching Inngest-compatible tools
+     */
+    async getToolsByCategory(categories) {
+        const allMetadata = this.catalog.getAllMetadata();
+        const filtered = allMetadata.filter((m) => m.categories?.some((c) => categories.includes(c)));
+        return filtered.map((m) => this.toFrameworkTool(m));
+    }
+    /**
+     * Create a search tool for discovering available tools.
+     *
+     * This is the core tool for dynamic tool discovery. The agent
+     * can search for tools by natural language query and get back
+     * matching tool names and descriptions.
+     *
+     * @param options - Search options (limit, threshold, categories)
+     * @returns Inngest-compatible search tool
+     *
+     * @example
+     * ```typescript
+     * const searchTool = adapter.createSearchTool({ limit: 5 });
+     * // Agent calls: search_tools({ query: "create github pr" })
+     * // Returns: [{ name: "create_pr", description: "...", score: 0.95 }]
+     * ```
+     */
+    createSearchTool(options = {}) {
+        const { limit = 5, threshold = 0, categories } = options;
+        const searchIndex = this.searchIndex;
+        const catalog = this.catalog;
+        return {
+            name: 'search_tools',
+            description: 'Search for available tools by query. Use this to discover what tools are available before calling them. Returns tool names and descriptions.',
+            parameters: z.object({
+                query: z
+                    .string()
+                    .describe('Natural language search query describing what you want to do'),
+            }),
+            handler: async (input, opts) => {
+                const { query } = input;
+                const execute = async () => {
+                    const results = await searchIndex.search(query, {
+                        limit,
+                        threshold,
+                        categories,
+                    });
+                    return results.map((r) => {
+                        const meta = catalog.getMetadata(r.toolId);
+                        return {
+                            name: meta?.name ?? r.toolId,
+                            description: meta?.description ?? '',
+                            score: r.score,
+                        };
+                    });
+                };
+                // Wrap in step.run for durability when available
+                if (opts.step) {
+                    return opts.step.run('bigtool:search_tools', execute);
+                }
+                return execute();
+            },
+        };
+    }
+    /**
+     * Create a tool for executing discovered tools by name.
+     *
+     * Use this in combination with createSearchTool() to enable
+     * dynamic tool discovery and execution patterns.
+     *
+     * **Note:** Tool lookup uses name matching. If multiple tools share the
+     * same name (from different sources), the first match wins. Ensure tool
+     * names are unique within your catalog to avoid ambiguity.
+     *
+     * @returns Inngest-compatible call tool
+     *
+     * @example
+     * ```typescript
+     * const callTool = adapter.createCallToolTool();
+     * // Agent calls: call_tool({ toolName: "create_pr", arguments: { title: "..." } })
+     * ```
+     */
+    createCallToolTool() {
+        const loader = this.loader;
+        const catalog = this.catalog;
+        return {
+            name: 'call_tool',
+            description: 'Call a tool by name with the given arguments. Use this after discovering tools via search_tools.',
+            parameters: z.object({
+                toolName: z.string().describe('The name of the tool to call'),
+                arguments: z.record(z.unknown()).describe('Arguments to pass to the tool'),
+            }),
+            handler: async (input, opts) => {
+                const { toolName, arguments: args } = input;
+                const execute = async () => {
+                    // Find the tool by name
+                    const allMetadata = catalog.getAllMetadata();
+                    const metadata = allMetadata.find((m) => m.name === toolName);
+                    if (!metadata) {
+                        throw new Error(`Tool not found: ${toolName}`);
+                    }
+                    const tool = await loader.load(metadata.id);
+                    return tool.invoke(args);
+                };
+                // Wrap in step.run for durability when available
+                if (opts.step) {
+                    return opts.step.run(`bigtool:call:${toolName}`, execute);
+                }
+                return execute();
+            },
+        };
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+// FACTORY FUNCTION
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Create an Inngest AgentKit adapter.
+ *
+ * Factory function for creating InngestAdapter instances. Use this
+ * as the primary entry point for the adapter.
+ *
+ * @param config - Adapter configuration with catalog, loader, and search index
+ * @returns Configured InngestAdapter instance
+ *
+ * @example
+ * ```typescript
+ * import { createInngestAdapter } from '@repo/bigtool-ts/adapters';
+ * import { DefaultToolCatalog, OramaSearch, DefaultToolLoader } from '@repo/bigtool-ts';
+ *
+ * const catalog = new DefaultToolCatalog();
+ * await catalog.register(new LocalSource(myTools));
+ *
+ * const searchIndex = new OramaSearch();
+ * await searchIndex.index(catalog.getAllMetadata());
+ *
+ * const loader = new DefaultToolLoader(catalog);
+ *
+ * const adapter = createInngestAdapter({ catalog, loader, searchIndex });
+ * ```
+ */
+export function createInngestAdapter(config) {
+    return new InngestAdapter(config);
+}
+//# sourceMappingURL=inngest.js.map

package/dist/adapters/inngest.js.map

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

package/dist/adapters/mastra.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Mastra Adapter for bigtool-ts
+ *
+ * Converts bigtool-ts tools to Mastra-compatible tools.
+ *
+ * @module adapters/mastra
+ *
+ * @example
+ * ```typescript
+ * import { createMastraAdapter } from '@repo/bigtool-ts/adapters';
+ * import { Agent } from '@mastra/core/agent';
+ *
+ * const adapter = createMastraAdapter({ catalog, loader, searchIndex });
+ *
+ * const agent = new Agent({
+ *   id: 'my-agent',
+ *   tools: {
+ *     search: adapter.createSearchTool(),
+ *     ...await adapter.getToolsAsRecord(['github:create_pr']),
+ *   },
+ * });
+ * ```
+ *
+ * @remarks
+ * Requires `@mastra/core` v1.0.0-beta.24+ as a peer dependency.
+ * Install separately: `pnpm add @mastra/core`
+ */
+import { z } from 'zod';
+import type { ToolMetadata } from '../types.js';
+import type { AdapterConfig, ToolAdapter, SearchToolOptions } from './types.js';
+/**
+ * Mastra tool execution context.
+ *
+ * Provides access to Mastra runtime services during tool execution.
+ * All properties are optional to handle various execution contexts.
+ */
+export interface MastraToolContext {
+    /** Mastra runtime instance for accessing services */
+    mastra?: unknown;
+    /** Request context for HTTP-triggered executions */
+    requestContext?: unknown;
+    /** Tracing context for observability */
+    tracingContext?: unknown;
+    /** Abort signal for cancellation support */
+    abortSignal?: AbortSignal;
+    /** Agent-specific context (suspend/resume support) */
+    agent?: unknown;
+    /** Workflow-specific context */
+    workflow?: unknown;
+}
+/**
+ * Mastra tool definition shape.
+ *
+ * This matches the output of `createTool()` from `@mastra/core/tools`.
+ *
+ * Key differences from other frameworks:
+ * - Uses `id` only (no `name` property)
+ * - Execute signature: `(inputData, context?)` NOT `({ input })`
+ * - Context is optional second parameter
+ */
+export interface MastraTool<TInput = unknown, TOutput = unknown> {
+    /** Unique identifier for the tool */
+    id: string;
+    /** Description of what the tool does */
+    description: string;
+    /** Zod schema for input validation */
+    inputSchema: z.ZodSchema<TInput>;
+    /** Zod schema for output validation (null if not specified) */
+    outputSchema: z.ZodSchema<TOutput> | undefined;
+    /** Tool execution function */
+    execute: (inputData: TInput, context?: MastraToolContext) => Promise<TOutput>;
+}
+/**
+ * Adapter for converting bigtool-ts tools to Mastra format.
+ *
+ * Implements the `ToolAdapter` interface for Mastra framework
+ * compatibility. Provides both array and record output formats
+ * to match Mastra's agent API expectations.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new MastraAdapter({ catalog, loader, searchIndex });
+ *
+ * // Get tools as array
+ * const tools = await adapter.getTools(['github:create_pr']);
+ *
+ * // Get tools as Record for Agent constructor
+ * const toolRecord = await adapter.getToolsAsRecord(['github:create_pr']);
+ * ```
+ */
+export declare class MastraAdapter implements ToolAdapter<MastraTool> {
+    private readonly catalog;
+    private readonly loader;
+    private readonly searchIndex;
+    constructor(config: AdapterConfig);
+    /**
+     * Convert bigtool-ts metadata to a Mastra tool.
+     *
+     * Creates a Mastra-compatible tool definition that lazily loads
+     * and executes the underlying bigtool-ts tool implementation.
+     *
+     * @param metadata - Tool metadata from the catalog
+     * @returns Mastra tool definition
+     */
+    toFrameworkTool(metadata: ToolMetadata): MastraTool;
+    /**
+     * Get tools by IDs as an array.
+     *
+     * Converts each tool from bigtool-ts format to Mastra format.
+     * Tools not found in the catalog are silently skipped.
+     *
+     * @param toolIds - Array of tool IDs to retrieve
+     * @returns Array of Mastra tools
+     */
+    getTools(toolIds: string[]): Promise<MastraTool[]>;
+    /**
+     * Get tools as a Record for Mastra Agent constructor.
+     *
+     * Mastra agents expect tools in `Record<string, Tool>` format.
+     * Uses the tool name (last segment of ID) as the record key.
+     *
+     * @param toolIds - Array of tool IDs to retrieve
+     * @returns Record of tool name to Mastra tool
+     *
+     * @example
+     * ```typescript
+     * const tools = await adapter.getToolsAsRecord(['github:create_pr']);
+     * // Returns: { create_pr: MastraTool }
+     *
+     * const agent = new Agent({
+     *   tools: {
+     *     search: adapter.createSearchTool(),
+     *     ...tools,
+     *   },
+     * });
+     * ```
+     */
+    getToolsAsRecord(toolIds: string[]): Promise<Record<string, MastraTool>>;
+    /**
+     * Create a search tool for discovering available tools.
+     *
+     * Returns a Mastra tool that agents can use to search the
+     * bigtool-ts catalog using natural language queries.
+     *
+     * @param options - Search configuration options
+     * @returns Mastra search tool
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({
+     *   tools: {
+     *     search_tools: adapter.createSearchTool({ limit: 10 }),
+     *   },
+     * });
+     * ```
+     */
+    createSearchTool(options?: SearchToolOptions): MastraTool;
+    /**
+     * Extract the tool key from a fully-qualified tool ID.
+     *
+     * For IDs like 'github:create_pr', returns 'create_pr'.
+     * For IDs without a namespace, returns the full ID.
+     */
+    private extractToolKey;
+    /**
+     * Build a Zod schema from JSON Schema parameters.
+     *
+     * Returns a permissive schema that accepts any object shape.
+     * Validation is delegated to the underlying bigtool-ts tool,
+     * avoiding the complexity of JSON Schema to Zod conversion.
+     *
+     * @remarks
+     * Converting JSON Schema to Zod at runtime would require a
+     * library like `json-schema-to-zod`. Since bigtool-ts tools
+     * perform their own validation, this passthrough approach
+     * avoids that dependency while maintaining compatibility.
+     */
+    private buildInputSchema;
+}
+/**
+ * Create a Mastra adapter for bigtool-ts.
+ *
+ * Factory function that creates a configured `MastraAdapter` instance.
+ *
+ * @param config - Adapter configuration with catalog, loader, and search index
+ * @returns Configured Mastra adapter
+ *
+ * @example
+ * ```typescript
+ * import { createMastraAdapter } from '@repo/bigtool-ts/adapters';
+ * import { DefaultToolCatalog, DefaultToolLoader, OramaSearch } from '@repo/bigtool-ts';
+ *
+ * const catalog = new DefaultToolCatalog();
+ * const loader = new DefaultToolLoader(catalog);
+ * const searchIndex = new OramaSearch();
+ *
+ * const adapter = createMastraAdapter({ catalog, loader, searchIndex });
+ * ```
+ */
+export declare function createMastraAdapter(config: AdapterConfig): MastraAdapter;
+//# sourceMappingURL=mastra.d.ts.map

package/dist/adapters/mastra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mastra.d.ts","sourceRoot":"","sources":["../../src/adapters/mastra.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMhF;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC7D,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,+DAA+D;IAC/D,YAAY,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,8BAA8B;IAC9B,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAsBD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAc,YAAW,WAAW,CAAC,UAAU,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;gBAE/C,MAAM,EAAE,aAAa;IAMjC;;;;;;;;OAQG;IACH,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU;IAkBnD;;;;;;;;OAQG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAcxD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAgB9E;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU;IAiD7D;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gBAAgB;CAGzB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAExE"}