@compilr-dev/sdk 0.1.24 → 0.1.25

package/dist/meta-tools/registry.d.ts

@@ -97,6 +97,7 @@ export declare class MetaToolsRegistry {
 }
 /**
  * Create the three meta-tools + fallback handler, all bound to a registry instance.
+ * Pass FallbackOptions to enable auto-loading in both use_tool and createFallback paths.
  */
-export declare function createMetaTools(registry: MetaToolsRegistry): MetaTools;
+export declare function createMetaTools(registry: MetaToolsRegistry, options?: FallbackOptions): MetaTools;
 export declare const META_TOOLS_SYSTEM_PROMPT_PREFIX = "\n## Tool Index (Specialized Tools)\n\nThese tools are called **exactly like direct tools** \u2014 just use the tool name with parameters. No special syntax or wrapper needed. The system routes them automatically.\n\n**IMPORTANT \u2014 These are CLI system tools, NOT your project's backend. Never use localhost/curl to access them.**\n\n**Parameter Rules:**\n- For **zero-parameter calls**: call the tool directly (e.g., `workitem_query()`, `git_status()`).\n- For **calls WITH parameters**: you MUST call `get_tool_info(\"tool_name\")` first to get parameter details. The signatures below are summaries only \u2014 do NOT guess parameter structure from them.\n- After a failed tool call, always call `get_tool_info()` before retrying.\n\n";

package/dist/meta-tools/registry.js

@@ -143,8 +143,9 @@ export class MetaToolsRegistry {
 // =============================================================================
 /**
  * Create the three meta-tools + fallback handler, all bound to a registry instance.
+ * Pass FallbackOptions to enable auto-loading in both use_tool and createFallback paths.
  */
-export function createMetaTools(registry) {
+export function createMetaTools(registry, options) {
     // -------------------------------------------------------------------------
     // list_tools
     // -------------------------------------------------------------------------
@@ -240,13 +241,16 @@ export function createMetaTools(registry) {
         execute: async ({ tool_name, args }) => {
             // 0. Check tool filter
             if (!registry.isToolAllowed(tool_name)) {
-                const filter = registry.getFilter();
-                const allowedTools = filter
-                    ? Array.from(filter).filter((t) => registry.getTool(t) !== undefined)
-                    : [];
-                return createErrorResult(`Tool '${tool_name}' is not available for this agent. ` +
-                    `Your available meta-registry tools: ${allowedTools.slice(0, 10).join(', ')}${allowedTools.length > 10 ? '...' : ''} ` +
-                    `Call list_tools() to see all available tools.`);
+                // Give consumer a chance to load the capability and update the filter
+                if (!(options?.onFilteredTool?.(tool_name) && registry.isToolAllowed(tool_name))) {
+                    const filter = registry.getFilter();
+                    const allowedTools = filter
+                        ? Array.from(filter).filter((t) => registry.getTool(t) !== undefined)
+                        : [];
+                    return createErrorResult(`Tool '${tool_name}' is not available for this agent. ` +
+                        `Your available meta-registry tools: ${allowedTools.slice(0, 10).join(', ')}${allowedTools.length > 10 ? '...' : ''} ` +
+                        `Call list_tools() to see all available tools.`);
+                }
             }
             // 1. Find the tool
             const tool = registry.getTool(tool_name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",