@compilr-dev/agents 0.3.9 → 0.3.11

package/dist/index.d.ts

@@ -31,7 +31,7 @@ export { PerplexityProvider, createPerplexityProvider } from './providers/index.
 export type { PerplexityProviderConfig } from './providers/index.js';
 export { OpenRouterProvider, createOpenRouterProvider } from './providers/index.js';
 export type { OpenRouterProviderConfig } from './providers/index.js';
-export type { Tool, ToolHandler, ToolRegistry, ToolInputSchema, ToolExecutionResult, ToolRegistryOptions, DefineToolOptions, ReadFileInput, WriteFileInput, BashInput, BashResult, FifoDetectionResult, GrepInput, GlobInput, EditInput, TodoWriteInput, TodoReadInput, TodoItem, TodoStatus, TodoContextCleanupOptions, TaskInput, TaskResult, AgentTypeConfig, TaskToolOptions, ContextMode, ThoroughnessLevel, SubAgentEventInfo, SuggestInput, SuggestToolOptions, } from './tools/index.js';
+export type { Tool, ToolHandler, ToolRegistry, ToolInputSchema, ToolExecutionResult, ToolRegistryOptions, ToolFallbackHandler, DefineToolOptions, ReadFileInput, WriteFileInput, BashInput, BashResult, FifoDetectionResult, GrepInput, GlobInput, EditInput, TodoWriteInput, TodoReadInput, TodoItem, TodoStatus, TodoContextCleanupOptions, TaskInput, TaskResult, AgentTypeConfig, TaskToolOptions, ContextMode, ThoroughnessLevel, SubAgentEventInfo, SuggestInput, SuggestToolOptions, } from './tools/index.js';
 export { defineTool, createSuccessResult, createErrorResult, wrapToolExecute, DefaultToolRegistry, createToolRegistry, } from './tools/index.js';
 export { readFileTool, createReadFileTool, writeFileTool, createWriteFileTool, bashTool, createBashTool, execStream, detectFifoUsage, bashOutputTool, createBashOutputTool, killShellTool, createKillShellTool, ShellManager, getDefaultShellManager, setDefaultShellManager, grepTool, createGrepTool, globTool, createGlobTool, editTool, createEditTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, resetDefaultTodoStore, getDefaultTodoStore, createIsolatedTodoStore, cleanupTodoContextMessages, getTodoContextStats, webFetchTool, createWebFetchTool, createTaskTool, defaultAgentTypes, suggestTool, createSuggestTool, builtinTools, allBuiltinTools, TOOL_NAMES, TOOL_SETS, } from './tools/index.js';
 export { userMessage, assistantMessage, systemMessage, textBlock, toolUseBlock, toolResultBlock, getTextContent, getToolUses, getToolResults, hasToolUses, validateToolUseResultPairing, repairToolPairing, ensureMessageContent, normalizeMessages, } from './messages/index.js';

package/dist/tools/registry.d.ts

@@ -1,7 +1,8 @@
 /**
  * ToolRegistry - Manages available tools for an agent
  */
-import type { Tool, ToolDefinition, ToolRegistry as IToolRegistry, ToolExecutionResult, ToolExecutionContext } from './types.js';
+import type { Tool, ToolDefinition, ToolRegistry as IToolRegistry, ToolExecutionResult, ToolExecutionContext, ToolFallbackHandler } from './types.js';
+export type { ToolFallbackHandler } from './types.js';
 /**
  * Options for creating a DefaultToolRegistry
  */
@@ -15,6 +16,11 @@ export interface ToolRegistryOptions {
      * Per-tool timeout overrides (tool name -> timeout in ms)
      */
     toolTimeouts?: Record<string, number>;
+    /**
+     * Fallback handler for tools not found in the primary registry.
+     * Enables transparent routing to secondary registries (e.g., meta-tools).
+     */
+    fallbackHandler?: ToolFallbackHandler;
 }
 /**
  * Default implementation of ToolRegistry
@@ -23,7 +29,13 @@ export declare class DefaultToolRegistry implements IToolRegistry {
     private readonly tools;
     private readonly defaultTimeoutMs;
     private readonly toolTimeouts;
+    private fallbackHandler;
     constructor(options?: ToolRegistryOptions);
+    /**
+     * Set a fallback handler for tools not found in the primary registry.
+     * Enables transparent routing to secondary registries (e.g., meta-tools).
+     */
+    setFallbackHandler(handler: ToolFallbackHandler | null): void;
     /**
      * Register a tool
      */

package/dist/tools/registry.js

@@ -13,9 +13,18 @@ export class DefaultToolRegistry {
     tools = new Map();
     defaultTimeoutMs;
     toolTimeouts;
+    fallbackHandler;
     constructor(options) {
         this.defaultTimeoutMs = options?.defaultTimeoutMs ?? DEFAULT_TOOL_TIMEOUT_MS;
         this.toolTimeouts = options?.toolTimeouts ?? {};
+        this.fallbackHandler = options?.fallbackHandler ?? null;
+    }
+    /**
+     * Set a fallback handler for tools not found in the primary registry.
+     * Enables transparent routing to secondary registries (e.g., meta-tools).
+     */
+    setFallbackHandler(handler) {
+        this.fallbackHandler = handler;
     }
     /**
      * Register a tool
@@ -81,6 +90,14 @@ export class DefaultToolRegistry {
     async execute(name, input, contextOrTimeout, timeoutMs) {
         const tool = this.tools.get(name);
         if (!tool) {
+            // Try fallback handler (e.g., meta-tools registry)
+            if (this.fallbackHandler) {
+                const context = typeof contextOrTimeout === 'object' ? contextOrTimeout : undefined;
+                const fallbackResult = await this.fallbackHandler(name, input, context);
+                if (fallbackResult !== null) {
+                    return fallbackResult;
+                }
+            }
             return {
                 success: false,
                 error: `Tool not found: ${name}`,

package/dist/tools/types.d.ts

@@ -79,6 +79,16 @@ export interface Tool<T = object> {
      */
     silent?: boolean;
 }
+/**
+ * Fallback handler for tools not found in the primary registry.
+ * Used by meta-tools to transparently route calls to a secondary registry.
+ *
+ * @param name - Tool name that was not found
+ * @param input - Tool input parameters
+ * @param context - Optional execution context
+ * @returns Result if handled, or null to return the default "not found" error
+ */
+export type ToolFallbackHandler = (name: string, input: Record<string, unknown>, context?: ToolExecutionContext) => Promise<ToolExecutionResult | null>;
 /**
  * Tool registry for managing available tools
  */
@@ -102,4 +112,9 @@ export interface ToolRegistry {
      * @param context - Optional execution context for streaming
      */
     execute(name: string, input: Record<string, unknown>, context?: ToolExecutionContext): Promise<ToolExecutionResult>;
+    /**
+     * Set a fallback handler for tools not found in the primary registry.
+     * Enables transparent routing to secondary registries (e.g., meta-tools).
+     */
+    setFallbackHandler(handler: ToolFallbackHandler | null): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/agents",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "Lightweight multi-LLM agent library for building CLI AI assistants",
   "type": "module",
   "main": "dist/index.js",
@@ -52,7 +52,7 @@
     "node": ">=18.0.0"
   },
   "peerDependencies": {
-    "@anthropic-ai/sdk": "^0.72.1",
+    "@anthropic-ai/sdk": ">=0.72.1",
     "@modelcontextprotocol/sdk": "^1.23.0"
   },
   "peerDependenciesMeta": {
@@ -64,17 +64,17 @@
     }
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.72.1",
+    "@anthropic-ai/sdk": "^0.74.0",
     "@eslint/js": "^9.39.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
-    "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@types/node": "^25.2.3",
+    "@vitest/coverage-v8": "^4.0.18",
     "dotenv": "^17.2.3",
     "eslint": "^9.39.1",
     "prettier": "^3.7.1",
     "typescript": "^5.3.0",
     "typescript-eslint": "^8.48.0",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "@google/genai": "^1.38.0"