@compilr-dev/cli 0.5.15 → 0.5.17

package/dist/agent.d.ts

@@ -194,6 +194,10 @@ export declare function getBuiltinGuardrailInfo(): Array<{
     action: 'warn' | 'confirm' | 'block';
     category: string;
 }>;
+/**
+ * Derive profile group IDs from a tool filter (array of tool names).
+ * A group is included if any of its tools are in the filter.
+ */
 /**
  * Creates an Agent instance configured with all tools.
  */

package/dist/agent.js

@@ -5,11 +5,12 @@
  * ClaudeProvider, OllamaProvider, OpenAIProvider, or GeminiProvider
  * and available tools.
  */
-import { Agent, ContextManager, DEFAULT_CONTEXT_CONFIG, createTaskTool, createSuggestTool, defaultAgentTypes, TOOL_SETS, BUILTIN_GUARDRAILS, createProviderFromType, CapabilityManager, CAPABILITY_PACKS, GIT_SAFETY_MODULE, PLATFORM_TOOL_HINTS_MODULE, FACTORY_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, createLoadCapabilityTool, generateCapabilityCatalog, } from '@compilr-dev/sdk';
+import { log } from './foundation/logger.js';
+import { Agent, ContextManager, DEFAULT_CONTEXT_CONFIG, createTaskTool, createSuggestTool, defaultAgentTypes, TOOL_SETS, BUILTIN_GUARDRAILS, createProviderFromType, CapabilityManager, CapabilityContext, CAPABILITY_PACKS, GIT_SAFETY_MODULE, PLATFORM_TOOL_HINTS_MODULE, FACTORY_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, createLoadCapabilityTool, createCapabilityHook, resolveProfileGroups, resolveUpfrontGroups, } from '@compilr-dev/sdk';
 import { isAutoCompactEnabled, isDelegationEnabled, getSetting } from './settings/index.js';
 import { getApiKey } from './utils/credentials.js';
 import { createToolRegistry, createMinimalToolRegistry, getDirectTools, getMetaTools, initializeMetaTools, getToolIndexForSystemPrompt, getFilteredToolIndexForSystemPrompt, getToolStats, setMetaToolFilter, createToolFallback, getRegisteredMetaTools, } from './tools.js';
-import { TOOL_GROUPS } from '@compilr-dev/sdk';
+// TOOL_GROUPS no longer needed — profile resolution moved to SDK
 import { setCapabilityManager } from './multi-agent/capability-loader.js';
 import { getAgentRegistry } from './agents/registry.js';
 import { SystemPromptBuilder } from './system-prompt/index.js';
@@ -135,144 +136,9 @@ function createProvider(options) {
  * Derive profile group IDs from a tool filter (array of tool names).
  * A group is included if any of its tools are in the filter.
  */
-function getProfileGroupsFromToolFilter(toolFilter) {
-    const toolSet = new Set(toolFilter);
-    const groups = [];
-    for (const [groupId, group] of Object.entries(TOOL_GROUPS)) {
-        if (group.tools.some((t) => toolSet.has(t))) {
-            groups.push(groupId);
-        }
-    }
-    return groups;
-}
-/**
- * Scan recent messages for "Tool not found: X" errors and auto-load
- * the corresponding capability packs (max 2 per turn, loadable only).
- * Also detects forbidden tool access for handoff suggestions.
- */
-function autoDetectCapabilities(manager, messages) {
-    const MAX_AUTO_LOADS = 2;
-    const result = { loaded: [], forbidden: [] };
-    const toolNotFoundPattern = /Tool not found: (\w+)/;
-    // Find the most recent user message (contains the last turn's tool results)
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const msg = messages[i];
-        if (msg.role !== 'user' || typeof msg.content === 'string')
-            continue;
-        // Scan this message's tool_result blocks for "Tool not found" errors
-        for (const block of msg.content) {
-            if (block.type !== 'tool_result' || !block.isError || !block.content)
-                continue;
-            const match = toolNotFoundPattern.exec(block.content);
-            if (!match)
-                continue;
-            const toolName = match[1];
-            const packId = manager.findPackForTool(toolName);
-            if (!packId || manager.isLoaded(packId))
-                continue;
-            const tier = manager.getTier(packId);
-            if (tier === 'loadable' && result.loaded.length < MAX_AUTO_LOADS) {
-                manager.load(packId, 'auto-detect');
-                result.loaded.push(packId);
-            }
-            else if (tier === 'forbidden') {
-                result.forbidden.push({
-                    toolName,
-                    packId,
-                    suggestedAgent: manager.getSuggestedAgent(packId),
-                });
-            }
-        }
-        // Only scan the most recent user message
-        break;
-    }
-    return result;
-}
-function createCapabilityHook(manager, basePrompt, orphanTools) {
-    return (ctx) => {
-        // Auto-detect capability needs from tool failures (safety net)
-        let forbiddenHints = [];
-        if (manager.hasLoadablePacks() || ctx.messages.length > 1) {
-            const detected = autoDetectCapabilities(manager, ctx.messages);
-            // Generate handoff suggestions for forbidden tool access
-            if (detected.forbidden.length > 0) {
-                forbiddenHints = detected.forbidden.map((f) => {
-                    const agentHint = f.suggestedAgent
-                        ? ` Consider using handoff("${f.suggestedAgent}", "Need ${f.packId} access for ${f.toolName}").`
-                        : '';
-                    return `[System] Tool "${f.toolName}" requires ${f.packId} capability which is outside your tool profile.${agentHint}`;
-                });
-            }
-        }
-        const activeToolNames = manager.getActiveToolNames();
-        const activeModuleIds = manager.getActivePromptModuleIds();
-        // Include orphan tools (not in any capability pack) — always visible
-        const allActiveTools = [...activeToolNames, ...orphanTools];
-        // Update meta-tool filter for this turn
-        setMetaToolFilter(allActiveTools);
-        // Build dynamic system prompt sections
-        const dynamicSections = [];
-        // Meta-tools protocol (how to use get_tool_info/use_tool)
-        dynamicSections.push(TOOL_USAGE_META_MODULE.content);
-        // Conditional modules based on loaded capability packs
-        if (activeModuleIds.has('git-safety')) {
-            dynamicSections.push(GIT_SAFETY_MODULE.content);
-        }
-        if (activeModuleIds.has('platform-tool-hints')) {
-            dynamicSections.push(PLATFORM_TOOL_HINTS_MODULE.content);
-        }
-        if (activeModuleIds.has('factory-tool-hints')) {
-            dynamicSections.push(FACTORY_TOOL_HINTS_MODULE.content);
-        }
-        // Prompt snippets from loaded packs
-        const snippets = manager.getActivePromptSnippets();
-        if (snippets.length > 0) {
-            dynamicSections.push('## Active Tool Capabilities\n' + snippets.join('\n'));
-        }
-        // Filtered tool index (only loaded tools)
-        const filteredIndex = getFilteredToolIndexForSystemPrompt(allActiveTools);
-        dynamicSections.push(filteredIndex);
-        // Capability catalog (if loadable packs remain)
-        if (manager.hasLoadablePacks()) {
-            const catalog = manager.getCatalog();
-            const catalogSection = generateCapabilityCatalog(catalog, manager.getLoadedPackIds());
-            if (catalogSection) {
-                dynamicSections.push(catalogSection);
-            }
-        }
-        // Preserve anchors from the current system prompt.
-        // The agents library injects anchors into systemContent BEFORE this hook runs.
-        // We must extract and re-append them, since we rebuild the prompt from basePrompt.
-        let anchorsBlock = '';
-        const anchorMarker = '## Active Anchors (Critical Information)';
-        const anchorIdx = ctx.systemPrompt.indexOf(anchorMarker);
-        if (anchorIdx > 0) {
-            // Find the preceding "---\n\n" separator
-            const separatorBefore = ctx.systemPrompt.lastIndexOf('---', anchorIdx);
-            const startIdx = separatorBefore > 0 ? separatorBefore : anchorIdx;
-            // Find the end: either the next "---" after the anchor block, or end of string
-            const afterAnchor = ctx.systemPrompt.indexOf('\n\n---\n\n', anchorIdx);
-            if (afterAnchor > 0) {
-                // Anchors are followed by more content (e.g., role ending) — extract just the anchor block
-                anchorsBlock = '\n\n' + ctx.systemPrompt.substring(startIdx, afterAnchor + 7); // include trailing "---\n\n"
-            }
-            else {
-                // Anchors are at the end of the prompt
-                anchorsBlock = '\n\n' + ctx.systemPrompt.substring(startIdx);
-            }
-        }
-        const hookResult = {
-            systemPrompt: basePrompt + '\n\n' + dynamicSections.join('\n\n') + anchorsBlock,
-        };
-        // Inject forbidden boundary messages (handoff suggestions)
-        if (forbiddenHints.length > 0) {
-            const hintContent = forbiddenHints.join('\n');
-            const hintMessage = { role: 'user', content: hintContent };
-            hookResult.messages = [...ctx.messages, hintMessage];
-        }
-        return hookResult;
-    };
-}
+// getProfileGroupsFromToolFilter → replaced by resolveProfileGroups from SDK
+// autoDetectCapabilities → replaced by autoDetectCapabilities from SDK
+// createCapabilityHook → replaced by createCapabilityHook + CapabilityContext from SDK
 /**
  * Creates an Agent instance configured with all tools.
  */
@@ -300,10 +166,10 @@ export function createAgent(options = {}) {
     const onEvent = options.verbose
         ? (event) => {
             if (event.type === 'tool_start') {
-                console.log(`\n[Tool: ${event.name}] Starting...`);
+                log.debug({ component: 'agent', tool: event.name }, 'Tool starting');
             }
             else if (event.type === 'tool_end') {
-                console.log(`[Tool: ${event.name}] Done`);
+                log.debug({ component: 'agent', tool: event.name }, 'Tool done');
             }
         }
         : undefined;
@@ -322,17 +188,14 @@ export function createAgent(options = {}) {
     // tools and prompt modules are active per-turn.
     // ==========================================================================
     let capabilityManager;
+    let capabilityContext;
     let orphanToolNames = [];
     if (useMetaTools) {
-        // Determine profile groups from toolFilter
+        // Use SDK's profile resolver instead of local implementation
         const profileGroups = options.toolFilter
-            ? getProfileGroupsFromToolFilter(options.toolFilter)
+            ? resolveProfileGroups(options.toolFilter)
             : Object.keys(CAPABILITY_PACKS);
-        // Upfront groups: all direct-tier groups that are in the profile
-        const upfrontGroupIds = Object.entries(TOOL_GROUPS)
-            .filter(([, group]) => group.tier === 'direct')
-            .map(([id]) => id)
-            .filter((id) => profileGroups.includes(id));
+        const upfrontGroupIds = resolveUpfrontGroups(profileGroups);
         capabilityManager = new CapabilityManager({
             profileGroups,
             packs: CAPABILITY_PACKS,
@@ -341,7 +204,6 @@ export function createAgent(options = {}) {
         // Expose the capability manager for slash command handlers (Phase 3)
         setCapabilityManager(capabilityManager);
         // Compute orphan tools (meta-registry tools not in any capability pack)
-        // These are always visible regardless of which packs are loaded.
         const packedTools = new Set();
         for (const pack of Object.values(CAPABILITY_PACKS)) {
             for (const tool of pack.tools) {
@@ -352,8 +214,13 @@ export function createAgent(options = {}) {
         orphanToolNames = registered
             .map((t) => t.definition.name)
             .filter((name) => !packedTools.has(name));
-        // Set initial meta-tool filter
-        setMetaToolFilter([...capabilityManager.getActiveToolNames(), ...orphanToolNames]);
+        // Create capability context (SDK) for filter sync + auto-load callback
+        capabilityContext = new CapabilityContext({
+            manager: capabilityManager,
+            orphanTools: orphanToolNames,
+            onFilterUpdate: (allowed) => { setMetaToolFilter(allowed); },
+        });
+        capabilityContext.syncFilter();
         // Log stats (unless quiet mode)
         if (!options.quiet) {
             const stats = getToolStats();
@@ -506,9 +373,17 @@ ${options.systemPromptAddition}
                     messages.splice(1, 0, { role: 'user', content: hint });
                     return { messages };
                 },
-                // Capability-aware system prompt assembly (with auto-detection safety net)
-                ...(capabilityManager && baseSystemPrompt
-                    ? [createCapabilityHook(capabilityManager, baseSystemPrompt, orphanToolNames)]
+                // Capability-aware system prompt assembly (SDK hook with auto-detection)
+                ...(capabilityContext && baseSystemPrompt
+                    ? [createCapabilityHook(capabilityContext, baseSystemPrompt, {
+                            staticSections: [TOOL_USAGE_META_MODULE.content],
+                            conditionalModules: [
+                                { content: GIT_SAFETY_MODULE.content, whenModuleActive: ['git-safety'] },
+                                { content: PLATFORM_TOOL_HINTS_MODULE.content, whenModuleActive: ['platform-tool-hints'] },
+                                { content: FACTORY_TOOL_HINTS_MODULE.content, whenModuleActive: ['factory-tool-hints'] },
+                            ],
+                            getToolIndex: (allowedNames) => getFilteredToolIndexForSystemPrompt(allowedNames),
+                        })]
                     : []),
             ],
             beforeTool: [createFileLockCheckHook(getActiveProject)],
@@ -601,7 +476,7 @@ ${options.systemPromptAddition}
             // Now uses toolUseId for direct correlation (no more FIFO matching!)
             onSpawn: (agentType, description, toolUseId) => {
                 if (options.verbose) {
-                    console.log(`\n[Sub-agent] Spawning ${agentType}: ${description} (${toolUseId ?? 'no-id'})`);
+                    log.debug({ component: 'agent', agentType, toolUseId }, 'Spawning sub-agent: %s', description);
                 }
                 // Immediately notify with toolUseId - no more queuing/matching!
                 if (toolUseId) {
@@ -613,7 +488,7 @@ ${options.systemPromptAddition}
             },
             onComplete: (agentType, result, toolUseId) => {
                 if (options.verbose) {
-                    console.log(`[Sub-agent] ${agentType} completed (${String(result.iterations)} iterations)`);
+                    log.debug({ component: 'agent', agentType, iterations: result.iterations }, 'Sub-agent completed');
                 }
                 // Direct notification with toolUseId - no more searching!
                 if (toolUseId && options.onSubagentEnd) {

package/dist/agents/registry.js

@@ -4,6 +4,7 @@
  * Handles loading, saving, and managing agent definitions.
  * Loads from both project (.compilr-dev/agents/) and user (~/.compilr-dev/agents/) directories.
  */
+import { log } from '../foundation/logger.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import { BUILTIN_AGENTS, PROJECT_AGENTS_DIR, USER_AGENTS_DIR, isValidAgentName, isBuiltinAgentName, } from './types.js';
@@ -61,16 +62,16 @@ function loadAgentsFromDir(dir, location) {
             const content = fs.readFileSync(filePath, 'utf-8');
             const parsed = parseAgentFile(content);
             if (!parsed) {
-                console.warn(`Invalid agent file (no frontmatter): ${filePath}`);
+                log.warn({ component: 'agents', filePath }, 'Invalid agent file (no frontmatter)');
                 continue;
             }
             const { frontmatter, content: systemPrompt } = parsed;
             if (!frontmatter.name || !frontmatter.description) {
-                console.warn(`Invalid agent file (missing fields): ${filePath}`);
+                log.warn({ component: 'agents', filePath }, 'Invalid agent file (missing name or description)');
                 continue;
             }
             if (!isValidAgentName(frontmatter.name)) {
-                console.warn(`Invalid agent name: ${frontmatter.name} in ${filePath}`);
+                log.warn({ component: 'agents', name: frontmatter.name, filePath }, 'Invalid agent name');
                 continue;
             }
             const model = (['sonnet', 'opus', 'haiku', 'inherit'].includes(frontmatter.model || '')
@@ -86,7 +87,7 @@ function loadAgentsFromDir(dir, location) {
             });
         }
         catch (error) {
-            console.warn(`Failed to load agent file: ${filePath}`, error);
+            log.warn({ component: 'agents', filePath, err: error }, 'Failed to load agent file');
         }
     }
     return agents;

package/dist/auth/index.js

@@ -10,6 +10,7 @@
  *     // Show login prompt
  *   }
  */
+import { log } from '../foundation/logger.js';
 import { v4 as uuidv4 } from 'uuid';
 import * as os from 'os';
 import { loadAuthData, saveAuthData, clearAuthData, updateSession, hasAuthData, checkAuthFilePermissions, } from './storage.js';
@@ -314,9 +315,8 @@ class AuthManager {
         }
         const result = await apiRefreshToken(this.authData.session.refreshToken);
         if (!result.success || !result.access_token || !result.refresh_token) {
-            // Debug: log refresh failure details
-            console.error('[auth] Token refresh failed:', result.error ?? 'missing token fields');
-            console.error('[auth] API_BASE_URL:', process.env.COMPILR_API_URL ?? '(not set, using compilr.dev)');
+            log.error({ component: 'auth', error: result.error ?? 'missing token fields' }, 'Token refresh failed');
+            log.error({ component: 'auth', apiBaseUrl: process.env.COMPILR_API_URL ?? '(not set, using compilr.dev)' }, 'API base URL at time of failure');
             return false;
         }
         // Calculate expiry from expires_in (seconds), default to 1 hour

package/dist/commands/custom-registry.js

@@ -4,6 +4,7 @@
  * Handles loading, saving, and managing custom command definitions.
  * Loads from both project (.compilr-dev/commands/) and user (~/.compilr-dev/commands/) directories.
  */
+import { log } from '../foundation/logger.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import { PROJECT_COMMANDS_DIR, USER_COMMANDS_DIR, isValidCommandName, } from './types.js';
@@ -88,11 +89,11 @@ function loadCommandsFromDir(dir, location) {
             // Name from filename (without .md extension)
             const name = path.basename(file, '.md');
             if (!isValidCommandName(name)) {
-                console.warn(`Invalid command name: ${name} in ${filePath}`);
+                log.warn({ component: 'commands', name, filePath }, 'Invalid command name');
                 continue;
             }
             if (!parsed.content) {
-                console.warn(`Empty command file: ${filePath}`);
+                log.warn({ component: 'commands', filePath }, 'Empty command file');
                 continue;
             }
             commands.push({
@@ -104,7 +105,7 @@ function loadCommandsFromDir(dir, location) {
             });
         }
         catch (error) {
-            console.warn(`Failed to load command file: ${filePath}`, error);
+            log.warn({ component: 'commands', filePath, err: error }, 'Failed to load command file');
         }
     }
     return commands;

package/dist/foundation/logger.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI logger instance.
+ *
+ * Diagnostic logging only — NOT for user-facing terminal output.
+ * User-facing output uses TerminalUI/TerminalRenderer.
+ *
+ * Logs are written to ~/.compilr-dev/logs/cli.log (rotated, 10MB x 5).
+ */
+export declare const log: import("@compilr-dev/logger").Logger;

package/dist/foundation/logger.js

@@ -0,0 +1,16 @@
+/**
+ * CLI logger instance.
+ *
+ * Diagnostic logging only — NOT for user-facing terminal output.
+ * User-facing output uses TerminalUI/TerminalRenderer.
+ *
+ * Logs are written to ~/.compilr-dev/logs/cli.log (rotated, 10MB x 5).
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+import { createLogger } from '@compilr-dev/logger';
+const logDir = join(homedir(), '.compilr-dev', 'logs');
+export const log = createLogger({
+    package: 'cli',
+    filePath: join(logDir, 'cli.log'),
+});

package/dist/repl-v2.js

@@ -10,6 +10,7 @@
  * Or imported and used with a real agent from index.ts
  */
 import { appendFileSync } from 'fs';
+import { log } from './foundation/logger.js';
 import { generateEditDiff, generateWriteDiff } from './ui/diff.js';
 import { getPendingRequestsManager, setActiveSharedContext } from './multi-agent/index.js';
 import { parseInputForMentions, hasReferences, buildMessageWithContext, ContextResolver, buildContextMap, } from './multi-agent/index.js';
@@ -153,11 +154,11 @@ ${JSON.stringify(state.messages, null, 2)}
 
 `;
         appendFileSync(DEBUG_LOG_FILE, logEntry);
-        console.log(`[DEBUG] Request #${String(debugRequestCount)} logged to ${DEBUG_LOG_FILE}`);
-        console.log(`[DEBUG] Estimated: sys:${String(systemPromptTokens)}tok + msg:${String(messagesTokens)}tok + tools:${String(totalToolTokens)}tok = ${String(totalEstimate)}tok`);
+        log.debug({ component: 'repl', requestNum: debugRequestCount, file: DEBUG_LOG_FILE }, 'Debug request logged');
+        log.debug({ component: 'repl', systemPromptTokens, messagesTokens, totalToolTokens, totalEstimate }, 'Token estimate');
     }
     catch (error) {
-        console.error('[DEBUG] Failed to log agent request:', error);
+        log.error({ component: 'repl', err: error }, 'Failed to log agent request');
     }
 }
 // =============================================================================

package/dist/settings/index.js

@@ -4,6 +4,7 @@
  * Centralized settings management for the CLI.
  * Persistence in ~/.compilr-dev/settings.json
  */
+import { log } from '../foundation/logger.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
@@ -89,7 +90,7 @@ function saveToDisk(settings) {
         fs.writeFileSync(CONFIG_FILE, JSON.stringify(settings, null, 2), 'utf-8');
     }
     catch (error) {
-        console.error('Failed to save settings:', error);
+        log.error({ component: 'settings', err: error }, 'Failed to save settings');
     }
 }
 // =============================================================================

package/dist/settings/paths.js

@@ -9,6 +9,7 @@
  * 2. Config file (~/.compilr-dev/settings.json)
  * 3. Default/derived value
  */
+import { log } from '../foundation/logger.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
@@ -60,7 +61,7 @@ function savePathConfig(pathConfig) {
         fs.writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2), 'utf-8');
     }
     catch (error) {
-        console.error('Failed to save path config:', error);
+        log.error({ component: 'settings', err: error }, 'Failed to save path config');
     }
 }
 /**

package/dist/shared-handlers.d.ts

@@ -5,38 +5,8 @@
  * accessible from tools but are set up at the application level.
  * This avoids circular imports between index.ts and tool modules.
  */
-export interface AskUserQuestion {
-    id: string;
-    header: string;
-    question: string;
-    options?: string[];
-    allowCustom?: boolean;
-    multiSelect?: boolean;
-}
-export interface AskUserInput {
-    questions: AskUserQuestion[];
-    context?: string;
-}
-export interface AskUserResult {
-    answers: Record<string, string | string[]>;
-    skipped: string[];
-}
-export type AskUserHandler = (input: AskUserInput) => Promise<AskUserResult>;
-export interface AskUserSimpleInput {
-    /** The question text */
-    question: string;
-    /** Predefined options (optional, max 5) */
-    options?: string[];
-    /** Allow free-text input (default: true) */
-    allowCustom?: boolean;
-}
-export interface AskUserSimpleResult {
-    /** User's answer */
-    answer: string;
-    /** True if user skipped the question */
-    skipped: boolean;
-}
-export type AskUserSimpleHandler = (input: AskUserSimpleInput) => Promise<AskUserSimpleResult>;
+import type { AskUserHandler, AskUserSimpleHandler } from '@compilr-dev/sdk';
+export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskUserSimpleInput, AskUserSimpleResult, AskUserSimpleHandler, } from '@compilr-dev/sdk';
 /**
  * Register the ask_user handler. Called during app initialization.
  */

package/dist/tools/ask-user-simple.d.ts

@@ -1,19 +1,8 @@
 /**
- * Ask User Simple Tool - Single question with flat schema
+ * Ask User Simple Tool — CLI wrapper around SDK factory
  *
- * A simplified version of ask_user designed for smaller models.
- * Uses a flat schema (no arrays of objects) that's easier for
- * models like Haiku, Flash, and GPT-4o-mini to generate correctly.
- *
- * Used by /sketch command for quick project outlines.
+ * Uses getAskUserSimpleHandler() from shared-handlers.ts which coordinates
+ * with the terminal footer (pause/resume) and shows the overlay.
  */
-interface AskUserSimpleInput {
-    /** The question text */
-    question: string;
-    /** Predefined options (optional, max 5) */
-    options?: string[];
-    /** Allow free-text input (default: true) */
-    allowCustom?: boolean;
-}
+import { type AskUserSimpleInput } from '@compilr-dev/sdk';
 export declare const askUserSimpleTool: import("@compilr-dev/sdk").Tool<AskUserSimpleInput>;
-export {};

package/dist/tools/ask-user-simple.js

@@ -1,87 +1,15 @@
 /**
- * Ask User Simple Tool - Single question with flat schema
+ * Ask User Simple Tool — CLI wrapper around SDK factory
  *
- * A simplified version of ask_user designed for smaller models.
- * Uses a flat schema (no arrays of objects) that's easier for
- * models like Haiku, Flash, and GPT-4o-mini to generate correctly.
- *
- * Used by /sketch command for quick project outlines.
+ * Uses getAskUserSimpleHandler() from shared-handlers.ts which coordinates
+ * with the terminal footer (pause/resume) and shows the overlay.
  */
-import { defineTool } from '@compilr-dev/sdk';
+import { createAskUserSimpleTool } from '@compilr-dev/sdk';
 import { getAskUserSimpleHandler } from '../shared-handlers.js';
-// =============================================================================
-// Tool Definition
-// =============================================================================
-export const askUserSimpleTool = defineTool({
-    name: 'ask_user_simple',
-    description: 'Ask the user a single question. ' +
-        'Provide optional predefined choices or allow free-text input. ' +
-        'Use this for simple question flows - one question at a time. ' +
-        'Best suited for /sketch command and smaller models.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            question: {
-                type: 'string',
-                description: 'The question to ask the user',
-            },
-            options: {
-                type: 'array',
-                description: 'Predefined options for the user to choose from (max 5)',
-                items: { type: 'string' },
-                maxItems: 5,
-            },
-            allowCustom: {
-                type: 'boolean',
-                description: 'Allow free-text input in addition to options (default: true)',
-            },
-        },
-        required: ['question'],
-    },
-    execute: async (input) => {
-        try {
-            // Validate input
-            if (!input.question || input.question.trim().length === 0) {
-                return {
-                    success: false,
-                    error: 'Question text is required',
-                };
-            }
-            if (input.options && input.options.length > 5) {
-                return {
-                    success: false,
-                    error: 'Maximum 5 options allowed',
-                };
-            }
-            // Get the handler from shared-handlers
-            const askUserSimpleHandler = getAskUserSimpleHandler();
-            if (!askUserSimpleHandler) {
-                return {
-                    success: false,
-                    error: 'ask_user_simple handler not initialized. This tool requires the CLI context.',
-                };
-            }
-            // Show the overlay via the handler (which pauses footer)
-            const result = await askUserSimpleHandler({
-                question: input.question,
-                options: input.options,
-                allowCustom: input.allowCustom,
-            });
-            const output = {
-                answer: result.answer,
-                skipped: result.skipped,
-            };
-            return {
-                success: true,
-                result: output,
-            };
-        }
-        catch (err) {
-            return {
-                success: false,
-                error: `Failed to ask user: ${err instanceof Error ? err.message : String(err)}`,
-            };
-        }
-    },
-    silent: true,
+export const askUserSimpleTool = createAskUserSimpleTool(async (input) => {
+    const handler = getAskUserSimpleHandler();
+    if (!handler) {
+        throw new Error('ask_user_simple handler not initialized. This tool requires the CLI context.');
+    }
+    return handler(input);
 });