@compilr-dev/cli 0.7.4 → 0.7.6

package/dist/shared-handlers.d.ts

@@ -5,8 +5,8 @@
  * accessible from tools but are set up at the application level.
  * This avoids circular imports between index.ts and tool modules.
  */
-import type { AskUserHandler, AskUserSimpleHandler } from '@compilr-dev/sdk';
-export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskUserSimpleInput, AskUserSimpleResult, AskUserSimpleHandler, } from '@compilr-dev/sdk';
+import type { AskUserHandler, AskUserSimpleHandler, ProposeAlternativesHandler, InteractiveFlowHandler } from '@compilr-dev/sdk';
+export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskUserSimpleInput, AskUserSimpleResult, AskUserSimpleHandler, ProposeAlternativesInput, ProposeAlternativesResult, ProposeAlternativesHandler, Alternative, InteractiveFlowInput, InteractiveFlowResult, InteractiveFlowHandler, Flow, FlowNode, QuestionNode, InfoNode, BranchNode, SummaryNode, AnswerValue, AbortReason, NodeId, } from '@compilr-dev/sdk';
 /**
  * Register the ask_user handler. Called during app initialization.
  */
@@ -23,6 +23,24 @@ export declare function registerAskUserSimpleHandler(handler: AskUserSimpleHandl
  * Get the registered ask_user_simple handler. Called by the ask_user_simple tool.
  */
 export declare function getAskUserSimpleHandler(): AskUserSimpleHandler | undefined;
+/**
+ * Register the propose_alternatives handler. Called during app initialization.
+ */
+export declare function registerProposeAlternativesHandler(handler: ProposeAlternativesHandler): void;
+/**
+ * Get the registered propose_alternatives handler. Called by the
+ * propose_alternatives tool.
+ */
+export declare function getProposeAlternativesHandler(): ProposeAlternativesHandler | undefined;
+/**
+ * Register the build_interactive_flow handler. Called during app initialization.
+ */
+export declare function registerInteractiveFlowHandler(handler: InteractiveFlowHandler): void;
+/**
+ * Get the registered build_interactive_flow handler. Called by the
+ * build_interactive_flow tool.
+ */
+export declare function getInteractiveFlowHandler(): InteractiveFlowHandler | undefined;
 /**
  * Set overlay active state. Called when showing/hiding overlays.
  */
@@ -40,11 +58,20 @@ export interface DelegateInput {
     reason?: string;
 }
 export interface DelegateResult {
-    /** True if delegation was approved and switch occurred */
+    /** True if delegation completed (approval granted + specialist ran) */
     success: boolean;
-    /** True if user declined the delegation */
+    /** True if user declined the delegation via the approval overlay */
     declined: boolean;
-    /** Error message if delegation failed */
+    /**
+     * Specialist's final response text. Populated when success=true. The
+     * coordinator's `delegate` tool surfaces this back to its LLM as the
+     * tool result body. See:
+     * project-docs/00-requirements/compilr-dev-sdk/multi-agent-tools-taxonomy-spec.md
+     */
+    response?: string;
+    /** Echo of the target agent id (helpful for the coordinator's LLM). */
+    agentId?: string;
+    /** Error message if delegation failed at the platform layer. */
     error?: string;
 }
 export type DelegateHandler = (input: DelegateInput) => Promise<DelegateResult>;
@@ -93,3 +120,28 @@ export declare function registerHandoffHandler(handler: HandoffHandler): void;
  * Get the registered handoff handler. Called by the handoff tool.
  */
 export declare function getHandoffHandler(): HandoffHandler | undefined;
+export interface ConsultInput {
+    /** Target specialist agent ID */
+    agentId: string;
+    /** The focused question to ask */
+    question: string;
+    /** Optional supporting material the target needs to answer well */
+    context?: string;
+}
+export interface ConsultResult {
+    /** Final response text from the target agent. */
+    answer: string;
+    /** Echo of target agent ID (helpful for the borrower's LLM). */
+    agentId: string;
+    /** Error message if consult failed at the platform layer. */
+    error?: string;
+}
+export type ConsultHandler = (input: ConsultInput) => Promise<ConsultResult>;
+/**
+ * Register the consult handler. Called during app initialization.
+ */
+export declare function registerConsultHandler(handler: ConsultHandler): void;
+/**
+ * Get the registered consult handler. Called by the consult tool.
+ */
+export declare function getConsultHandler(): ConsultHandler | undefined;

package/dist/shared-handlers.js

@@ -35,6 +35,40 @@ export function getAskUserSimpleHandler() {
     return askUserSimpleHandler;
 }
 // =============================================================================
+// Propose Alternatives Handler Registry
+// =============================================================================
+let proposeAlternativesHandler;
+/**
+ * Register the propose_alternatives handler. Called during app initialization.
+ */
+export function registerProposeAlternativesHandler(handler) {
+    proposeAlternativesHandler = handler;
+}
+/**
+ * Get the registered propose_alternatives handler. Called by the
+ * propose_alternatives tool.
+ */
+export function getProposeAlternativesHandler() {
+    return proposeAlternativesHandler;
+}
+// =============================================================================
+// Interactive Flow Handler Registry
+// =============================================================================
+let interactiveFlowHandler;
+/**
+ * Register the build_interactive_flow handler. Called during app initialization.
+ */
+export function registerInteractiveFlowHandler(handler) {
+    interactiveFlowHandler = handler;
+}
+/**
+ * Get the registered build_interactive_flow handler. Called by the
+ * build_interactive_flow tool.
+ */
+export function getInteractiveFlowHandler() {
+    return interactiveFlowHandler;
+}
+// =============================================================================
 // Overlay State (for buffering output during overlays)
 // =============================================================================
 /**
@@ -103,3 +137,19 @@ export function registerHandoffHandler(handler) {
 export function getHandoffHandler() {
     return handoffHandler;
 }
+// =============================================================================
+// Consult Handler Registry
+// =============================================================================
+let consultHandler;
+/**
+ * Register the consult handler. Called during app initialization.
+ */
+export function registerConsultHandler(handler) {
+    consultHandler = handler;
+}
+/**
+ * Get the registered consult handler. Called by the consult tool.
+ */
+export function getConsultHandler() {
+    return consultHandler;
+}

package/dist/tools/consult.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Consult Tool — Specialist-to-Specialist Sync Borrow
+ *
+ * The CLI surfaces the SDK's `consult` semantic via a thin wrapper around
+ * the registered consult handler (same pattern as handoff). The actual
+ * sub-run of the target agent lives in `handlers/delegation-handlers.ts`.
+ *
+ * Spec: project-docs/00-requirements/compilr-dev-sdk/consult-tool-spec.md
+ */
+export declare const consultTool: import("@compilr-dev/sdk").Tool<{
+    agentId: string;
+    question: string;
+    context?: string;
+}>;

package/dist/tools/consult.js

@@ -0,0 +1,73 @@
+/**
+ * Consult Tool — Specialist-to-Specialist Sync Borrow
+ *
+ * The CLI surfaces the SDK's `consult` semantic via a thin wrapper around
+ * the registered consult handler (same pattern as handoff). The actual
+ * sub-run of the target agent lives in `handlers/delegation-handlers.ts`.
+ *
+ * Spec: project-docs/00-requirements/compilr-dev-sdk/consult-tool-spec.md
+ */
+import { defineTool } from '@compilr-dev/sdk';
+import { getConsultHandler } from '../shared-handlers.js';
+export const consultTool = defineTool({
+    name: 'consult',
+    description: 'Ask another specialist a focused question and continue the conversation yourself. ' +
+        'Use this when you need a quick opinion or expertise input from a teammate without giving up the conversation. ' +
+        'Unlike handoff, you keep ownership — the target answers and control returns to you. ' +
+        'Example: $arch can consult $pm on scope, get an answer, and continue designing.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentId: {
+                type: 'string',
+                description: 'Target specialist agent ID to consult (e.g., "pm", "qa", "dev"). ' +
+                    'Cannot be yourself or "default" (use handoff to escalate to the coordinator).',
+            },
+            question: {
+                type: 'string',
+                description: 'The focused question you want answered — be specific.',
+            },
+            context: {
+                type: 'string',
+                description: 'Optional supporting material the target needs to answer well ' +
+                    '(code snippet, design constraint, current state, etc.).',
+            },
+        },
+        required: ['agentId', 'question'],
+    },
+    execute: async (input) => {
+        if (!input.agentId || input.agentId.trim().length === 0) {
+            return { success: false, error: 'agentId is required' };
+        }
+        if (!input.question || input.question.trim().length === 0) {
+            return { success: false, error: 'question is required and cannot be empty' };
+        }
+        const handler = getConsultHandler();
+        if (!handler) {
+            return {
+                success: false,
+                error: 'Consult handler not initialized. This tool requires multi-agent mode with a team.',
+            };
+        }
+        try {
+            const result = await handler({
+                agentId: input.agentId.trim(),
+                question: input.question.trim(),
+                context: input.context?.trim() || undefined,
+            });
+            if (result.error) {
+                return { success: false, error: result.error };
+            }
+            return {
+                success: true,
+                result: { answer: result.answer, agentId: result.agentId },
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Consult failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+});

package/dist/tools/delegate.d.ts

@@ -1,14 +1,20 @@
 /**
- * Delegate Tool - Multi-Agent Task Delegation
+ * Delegate Tool - Multi-Agent Task Delegation (sync, persistent)
  *
  * Allows the coordinator to delegate tasks to specialist agents.
  * Only available to the coordinator (default agent).
  *
- * Flow:
- * 1. Coordinator calls delegate(agentId, task, reason?)
- * 2. CLI shows approval prompt
- * 3. If approved: auto-switch to specialist, inject task
- * 4. If denied: return "User declined" to coordinator
+ * Behavior (per multi-agent-tools-taxonomy-spec.md §2):
+ *   1. Coordinator calls delegate(agentId, task, reason?)
+ *   2. CLI shows approval prompt
+ *   3. If approved: specialist runs the task INLINE in their persistent
+ *      context; response is captured and returned to the coordinator
+ *   4. Coordinator stays in charge of the conversation — no permanent
+ *      speaker switch
+ *   5. If declined: return "User declined" to coordinator (continues working)
+ *
+ * For sync-without-persistence use `consult`. For async + tracking use
+ * `delegate_background`. For permanent baton-pass use `handoff`.
  */
 interface DelegateInput {
     /** Target agent ID (e.g., 'arch', 'dev', 'qa') */

package/dist/tools/delegate.js

@@ -1,14 +1,20 @@
 /**
- * Delegate Tool - Multi-Agent Task Delegation
+ * Delegate Tool - Multi-Agent Task Delegation (sync, persistent)
  *
  * Allows the coordinator to delegate tasks to specialist agents.
  * Only available to the coordinator (default agent).
  *
- * Flow:
- * 1. Coordinator calls delegate(agentId, task, reason?)
- * 2. CLI shows approval prompt
- * 3. If approved: auto-switch to specialist, inject task
- * 4. If denied: return "User declined" to coordinator
+ * Behavior (per multi-agent-tools-taxonomy-spec.md §2):
+ *   1. Coordinator calls delegate(agentId, task, reason?)
+ *   2. CLI shows approval prompt
+ *   3. If approved: specialist runs the task INLINE in their persistent
+ *      context; response is captured and returned to the coordinator
+ *   4. Coordinator stays in charge of the conversation — no permanent
+ *      speaker switch
+ *   5. If declined: return "User declined" to coordinator (continues working)
+ *
+ * For sync-without-persistence use `consult`. For async + tracking use
+ * `delegate_background`. For permanent baton-pass use `handoff`.
  */
 import { defineTool } from '@compilr-dev/sdk';
 import { getDelegateHandler } from '../shared-handlers.js';
@@ -17,10 +23,12 @@ import { getDelegateHandler } from '../shared-handlers.js';
 // =============================================================================
 export const delegateTool = defineTool({
     name: 'delegate',
-    description: 'Hand off the conversation to a specialist (foreground switch). ' +
-        'You stop working and the specialist takes over. No status tracking. ' +
-        'Use delegate_background instead if you want to continue working while ' +
-        'the specialist runs in the background (with delegation tracking). ' +
+    description: 'Delegate a task to a specialist and get their response back. ' +
+        'The specialist runs the task in their persistent context (they remember the work). ' +
+        "You stay in charge — control returns to you with the specialist's response. " +
+        'Use consult if you just want a quick answer without persistence. ' +
+        'Use delegate_background if you want the specialist to work in parallel while you continue. ' +
+        'Use handoff to permanently pass the baton (you stop working). ' +
         'Only available to the coordinator.',
     inputSchema: {
         type: 'object',
@@ -64,7 +72,8 @@ export const delegateTool = defineTool({
                         'This tool requires multi-agent mode with coordinator role.',
                 };
             }
-            // Execute delegation (shows approval prompt, switches if approved)
+            // Execute delegation: show approval prompt, run specialist inline,
+            // capture response.
             const result = await delegateHandler({
                 agentId: input.agentId.trim(),
                 task: input.task.trim(),
@@ -76,16 +85,23 @@ export const delegateTool = defineTool({
                     error: result.error,
                 };
             }
+            // User declined the approval prompt
+            if (result.declined) {
+                const output = {
+                    delegated: false,
+                    agent: input.agentId,
+                    message: 'User declined the delegation. Continue handling the task yourself.',
+                };
+                return { success: true, result: output };
+            }
+            // Approved and specialist ran — surface the response so the coordinator's
+            // LLM sees it as the tool result body.
             const output = {
-                delegated: result.success,
-                message: result.declined
-                    ? 'User declined the delegation. Continue handling the task yourself.'
-                    : `Task delegated to $${input.agentId}. They will handle it from here.`,
-            };
-            return {
-                success: true,
-                result: output,
+                delegated: true,
+                agent: result.agentId ?? input.agentId,
+                response: result.response,
             };
+            return { success: true, result: output };
         }
         catch (err) {
             return {

package/dist/tools/interactive-flow.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Interactive Flow Tool — CLI wrapper around SDK factory.
+ *
+ * Uses getInteractiveFlowHandler() from shared-handlers.ts which
+ * coordinates with the terminal footer (pause/resume), routes background
+ * agent calls through the pending-requests manager, and shows the
+ * InteractiveFlowOverlayV2 for foreground calls.
+ *
+ * Spec: project-docs/00-requirements/compilr-dev-cli/interactive-flow-cli-spec.md
+ */
+import { type InteractiveFlowInput } from '@compilr-dev/sdk';
+export type { Flow, FlowNode, QuestionNode, InfoNode, BranchNode, SummaryNode, } from '@compilr-dev/sdk';
+export declare const interactiveFlowTool: import("@compilr-dev/sdk").Tool<InteractiveFlowInput>;

package/dist/tools/interactive-flow.js

@@ -0,0 +1,19 @@
+/**
+ * Interactive Flow Tool — CLI wrapper around SDK factory.
+ *
+ * Uses getInteractiveFlowHandler() from shared-handlers.ts which
+ * coordinates with the terminal footer (pause/resume), routes background
+ * agent calls through the pending-requests manager, and shows the
+ * InteractiveFlowOverlayV2 for foreground calls.
+ *
+ * Spec: project-docs/00-requirements/compilr-dev-cli/interactive-flow-cli-spec.md
+ */
+import { createInteractiveFlowTool, } from '@compilr-dev/sdk';
+import { getInteractiveFlowHandler } from '../shared-handlers.js';
+export const interactiveFlowTool = createInteractiveFlowTool(async (input) => {
+    const handler = getInteractiveFlowHandler();
+    if (!handler) {
+        throw new Error('build_interactive_flow handler not initialized. This tool requires the CLI context.');
+    }
+    return handler(input);
+});

package/dist/tools/platform-adapter.d.ts

@@ -18,8 +18,20 @@
  */
 export declare const allPlatformTools: import("@compilr-dev/sdk").Tool<never>[];
 /**
- * All 5 factory tools from @compilr-dev/factory:
- * - 3 model tools (app_model_get, app_model_update, app_model_validate)
+ * All 29 factory tools from @compilr-dev/factory (createAllFactoryTools):
+ * - 3 app model tools (app_model_get/update/validate)
+ * - 5 research model tools + research_scaffold
+ * - 4 business model tools + business_scaffold
+ * - 5 brand model tools + content_scaffold
+ * - 3 curriculum model tools
+ * - 3 book model tools + book_scaffold
  * - 2 factory tools (factory_scaffold, factory_list_toolkits)
+ *
+ * Pre-2026-06-04 the CLI imported the narrower `createFactoryTools` which
+ * only returned 5 tools (app model + factory infra). 24 non-software model
+ * + scaffold tools were silently missing — agents in research/business/
+ * brand/curriculum/book projects saw the tools advertised by capability
+ * pack `factory_models` and `factory_scaffold` but got "Tool not found"
+ * on call. Audit TODO-5 fix.
  */
 export declare const allFactoryTools: import('@compilr-dev/agents').Tool<never>[];

package/dist/tools/platform-adapter.js

@@ -6,7 +6,7 @@
  * and delegates all 32 platform tool definitions to the SDK.
  */
 import { createPlatformTools, createSQLiteRepositories, ProjectAnchorStore, } from '@compilr-dev/sdk';
-import { createFactoryTools } from '@compilr-dev/factory';
+import { createAllFactoryTools } from '@compilr-dev/factory';
 import { getDb } from '../db/index.js';
 import { getDataPath, getSessionsPath } from '../settings/paths.js';
 import { getPermissionMode } from '../settings/index.js';
@@ -280,11 +280,23 @@ export const allPlatformTools = createPlatformTools(config, {
     },
 });
 /**
- * All 5 factory tools from @compilr-dev/factory:
- * - 3 model tools (app_model_get, app_model_update, app_model_validate)
+ * All 29 factory tools from @compilr-dev/factory (createAllFactoryTools):
+ * - 3 app model tools (app_model_get/update/validate)
+ * - 5 research model tools + research_scaffold
+ * - 4 business model tools + business_scaffold
+ * - 5 brand model tools + content_scaffold
+ * - 3 curriculum model tools
+ * - 3 book model tools + book_scaffold
  * - 2 factory tools (factory_scaffold, factory_list_toolkits)
+ *
+ * Pre-2026-06-04 the CLI imported the narrower `createFactoryTools` which
+ * only returned 5 tools (app model + factory infra). 24 non-software model
+ * + scaffold tools were silently missing — agents in research/business/
+ * brand/curriculum/book projects saw the tools advertised by capability
+ * pack `factory_models` and `factory_scaffold` but got "Tool not found"
+ * on call. Audit TODO-5 fix.
  */
-export const allFactoryTools = createFactoryTools({
+export const allFactoryTools = createAllFactoryTools({
     context,
     cwd: process.cwd(),
 });

package/dist/tools/propose-alternatives.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Propose Alternatives Tool — CLI wrapper around SDK factory.
+ *
+ * Uses getProposeAlternativesHandler() from shared-handlers.ts which
+ * coordinates with the terminal footer (pause/resume), routes background
+ * agent calls through the pending-requests manager, and shows the
+ * ProposeAlternativesOverlayV2 for foreground calls.
+ *
+ * Spec: project-docs/00-requirements/compilr-dev-cli/propose-alternatives-spec.md
+ */
+import { type ProposeAlternativesInput } from '@compilr-dev/sdk';
+export type { Alternative } from '@compilr-dev/sdk';
+export declare const proposeAlternativesTool: import("@compilr-dev/sdk").Tool<ProposeAlternativesInput>;

package/dist/tools/propose-alternatives.js

@@ -0,0 +1,19 @@
+/**
+ * Propose Alternatives Tool — CLI wrapper around SDK factory.
+ *
+ * Uses getProposeAlternativesHandler() from shared-handlers.ts which
+ * coordinates with the terminal footer (pause/resume), routes background
+ * agent calls through the pending-requests manager, and shows the
+ * ProposeAlternativesOverlayV2 for foreground calls.
+ *
+ * Spec: project-docs/00-requirements/compilr-dev-cli/propose-alternatives-spec.md
+ */
+import { createProposeAlternativesTool, } from '@compilr-dev/sdk';
+import { getProposeAlternativesHandler } from '../shared-handlers.js';
+export const proposeAlternativesTool = createProposeAlternativesTool(async (input) => {
+    const handler = getProposeAlternativesHandler();
+    if (!handler) {
+        throw new Error('propose_alternatives handler not initialized. This tool requires the CLI context.');
+    }
+    return handler(input);
+});

package/dist/tools.d.ts

@@ -1,105 +1,29 @@
 /**
- * Tool Registry Setup
+ * Tool Registry Helpers (slim).
  *
- * Configures all available tools from @compilr-dev/sdk
- * (which re-exports from @compilr-dev/agents and @compilr-dev/agents-coding).
+ * Pre-SDK migration this file owned the full HOT_TOOLS / WARM_TOOLS /
+ * DIRECT_TOOLS / META_REGISTRY_TOOLS arrays and a token-saving registry
+ * (~15K → ~2K per turn). That optimisation moved to the SDK as the
+ * capability-manager direct/meta tier split (`TOOL_GROUPS.<id>.tier`),
+ * and `createCompilrAgent({ capabilities: ... })` now handles tool
+ * registration end-to-end. See `src/agent.ts` and
+ * `@compilr-dev/sdk/src/capabilities/packs.ts`.
  *
- * ARCHITECTURE (Meta-Tools):
- * - DIRECT TOOLS: Always available, called by name (most common operations)
- * - META-REGISTRY TOOLS: Available via use_tool() (specialized operations)
+ * What remains here is the small surface CLI code outside agent.ts still
+ * touches:
+ *   - `todoStore` — alias for the SDK's `getDefaultTodoStore()` singleton,
+ *     read by the footer renderer (see `repl-v2.ts`).
+ *   - `TOOL_NAMES` / `ToolName` / `getAllToolNames` — re-exported from
+ *     `./tool-names.js` for convenience.
  *
- * This reduces token overhead from ~15K to ~2K per request.
+ * Audit refs: TODO-4 (HOT/WARM cleanup), TODO-15 (deleted the parallel
+ * dead MetaToolsRegistry singleton + its setMetaToolFilter /
+ * getRegisteredMetaTools / isMetaToolSilent surface — the SDK's
+ * per-agent CapabilityManager already handles tool filtering at agent
+ * factory time, so the CLI re-exports here were always no-ops).
  *
- * SINGLE SOURCE OF TRUTH:
- * Tool names are defined in tool-names.ts (a dependency-free module).
- * This file re-exports them for convenience. Import from here or tool-names.ts.
+ * See `project-docs/00-requirements/compilr-dev-sdk/architecture-audit-cli-vs-desktop.md`.
  */
-export { TOOL_NAMES, type ToolName, DIRECT_TOOL_NAMES, HOT_TOOL_NAMES, WARM_TOOL_NAMES, META_TOOL_NAMES, META_REGISTRY_TOOL_NAMES, getAllToolNames, } from './tool-names.js';
-import { TodoStore, type Tool } from '@compilr-dev/sdk';
+import { TodoStore } from '@compilr-dev/sdk';
+export { TOOL_NAMES, type ToolName, getAllToolNames } from './tool-names.js';
 export declare const todoStore: TodoStore;
-import { setMetaToolFilter, getRegisteredMetaTools } from './tools/meta-tools.js';
-export { setMetaToolFilter, getRegisteredMetaTools };
-/**
- * Check if a tool in the meta-registry is marked as silent.
- * Used by the repl to suppress output for warm tools like todo_write/todo_read.
- */
-export declare function isMetaToolSilent(name: string): boolean;
-/**
- * Creates the tool registry with all available tools.
- * Returns tools as-is - the Agent.registerTools() method handles typing.
- *
- * @deprecated Use createDirectToolRegistry() + initializeMetaTools() instead
- */
-export declare function createToolRegistry(): unknown[];
-/**
- * Returns a minimal set of tools for basic testing.
- */
-export declare function createMinimalToolRegistry(): unknown[];
-/**
- * Get direct tools that are always available.
- * When hotOnly is true, returns only hot tools (7 tools, ~2.1K tokens).
- * When false/undefined, returns all direct tools (18 tools, ~5.4K tokens).
- */
-export declare function getDirectTools(hotOnly?: boolean): Tool[];
-/**
- * Get meta-tools for agent registration.
- * Only get_tool_info is kept as a direct tool — use_tool and list_tools
- * are no longer needed since the fallback handler routes calls transparently.
- */
-export declare function getMetaTools(): Tool[];
-/**
- * Create a fallback handler for the tool registry.
- * When the agent calls a tool not in the direct registry, this handler
- * checks the meta-registry and executes it transparently.
- *
- * Auto-loading of capability packs for filtered tools is handled by the
- * shared onFilteredTool callback in meta-tools.ts (covers both use_tool
- * and direct fallback paths).
- */
-export declare function createToolFallback(): (name: string, input: Record<string, unknown>) => Promise<import('@compilr-dev/sdk').ToolExecutionResult | null>;
-/**
- * Check if hot-tools mode is active.
- * When true, only hot tools are declared as direct schemas; warm tools are in meta-registry.
- */
-export declare function isHotToolsMode(): boolean;
-/**
- * Initialize the meta-tool registry with specialized tools.
- * When includeWarmTools is true, warm tools are also added to the meta-registry
- * (enabling hot-tools mode where only 7 core tools are declared directly).
- * Call this once at startup.
- */
-export declare function initializeMetaTools(includeWarmTools?: boolean): void;
-/**
- * Get the tool index for the system prompt.
- * This lists all meta-registry tools with their signatures.
- */
-export declare function getToolIndexForSystemPrompt(): string;
-/**
- * Get a filtered tool index for the system prompt.
- * Only includes tools whose names are in the given set.
- * Used by the capability-aware BeforeLLM hook.
- */
-export declare function getFilteredToolIndexForSystemPrompt(activeToolNames: string[]): string;
-/**
- * Get count of meta-registry tools.
- */
-export declare function getMetaToolsCount(): number;
-/**
- * Check if meta-tools mode is enabled.
- * Returns true if the meta-tool registry has been initialized.
- */
-export declare function isMetaToolsEnabled(): boolean;
-/**
- * Get tool statistics for debugging/display.
- */
-export declare function getToolStats(): {
-    directTools: number;
-    hotTools: number;
-    warmTools: number;
-    metaRegistryTools: number;
-    totalTools: number;
-    estimatedDirectTokens: number;
-    estimatedMetaTokens: number;
-    estimatedLegacyTokens: number;
-    tokenSavings: number;
-};