@compilr-dev/sdk 0.1.24 → 0.1.26

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/dist/system-prompt/builder.d.ts

@@ -22,8 +22,12 @@ export interface SystemPromptContext {
     enableMetaTools?: boolean;
     /** Does the agent have a role-specific identity? (team agents) */
     hasRoleIdentity?: boolean;
-    /** Active project name (for explicit identification) */
+    /** Active project display name (human-readable, e.g. "Hr Manager") */
     projectName?: string;
+    /** Active project slug (unique identifier, e.g. "hr-manager") */
+    projectSlug?: string;
+    /** Active project ID (numeric database identifier) */
+    projectId?: number;
     /** Project context from COMPILR.md (appended at end) */
     projectContext?: string;
     /** Guided mode context (appended at end) */
@@ -79,6 +83,10 @@ export declare class SystemPromptBuilder {
      * Build the system prompt based on current context
      */
     build(): BuildResult;
+    /**
+     * Build project metadata lines (name, slug, ID) for the system prompt.
+     */
+    private buildProjectMeta;
     /**
      * Build and return just the prompt string
      */

package/dist/system-prompt/builder.js

@@ -168,10 +168,12 @@ export class SystemPromptBuilder {
             const projectHeader = this.context.projectName
                 ? `## Project Context (${this.context.projectName})`
                 : '## Project Context';
-            prompt += `\n\n---\n\n${projectHeader}\n\nThe following is project-specific context loaded from COMPILR.md:\n\n${this.context.projectContext}`;
+            const projectMeta = this.buildProjectMeta();
+            prompt += `\n\n---\n\n${projectHeader}${projectMeta}\n\nThe following is project-specific context loaded from COMPILR.md:\n\n${this.context.projectContext}`;
         }
         else if (this.context.projectName) {
-            prompt += `\n\n---\n\n## Active Project\n\nThe current project is: **${this.context.projectName}**`;
+            const projectMeta = this.buildProjectMeta();
+            prompt += `\n\n---\n\n## Active Project${projectMeta}`;
         }
         // Append guided mode context if provided
         if (this.context.guidedModeContext) {
@@ -196,6 +198,22 @@ export class SystemPromptBuilder {
             estimatedTokens: baseTokens + appendedTokens,
         };
     }
+    /**
+     * Build project metadata lines (name, slug, ID) for the system prompt.
+     */
+    buildProjectMeta() {
+        const lines = [];
+        if (this.context.projectName) {
+            lines.push(`- **Name:** ${this.context.projectName}`);
+        }
+        if (this.context.projectSlug) {
+            lines.push(`- **Slug:** \`${this.context.projectSlug}\` (unique identifier — use this for tool lookups)`);
+        }
+        if (this.context.projectId !== undefined) {
+            lines.push(`- **ID:** ${String(this.context.projectId)}`);
+        }
+        return lines.length > 0 ? '\n\n' + lines.join('\n') : '';
+    }
     /**
      * Build and return just the prompt string
      */

package/package.json

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