@calliopelabs/cli 0.4.6 → 0.6.0

package/dist/fuzzy-search.js

@@ -0,0 +1,240 @@
+/**
+ * Calliope CLI - Fuzzy File Search
+ *
+ * Fast fuzzy file finder with fzf-style matching.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// ============================================================================
+// Default Ignore Patterns
+// ============================================================================
+const DEFAULT_IGNORE_DIRS = [
+    'node_modules',
+    '.git',
+    '.svn',
+    '.hg',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.nuxt',
+    '__pycache__',
+    '.pytest_cache',
+    'coverage',
+    '.nyc_output',
+    'vendor',
+    'target',
+    '.cargo',
+];
+// ============================================================================
+// File Scanning
+// ============================================================================
+/**
+ * Recursively get all files in directory
+ */
+export function getAllFiles(dir, options = {}, basePath = dir) {
+    const files = [];
+    const excludeDirs = options.excludeDirs || DEFAULT_IGNORE_DIRS;
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip hidden files unless requested
+            if (!options.includeHidden && entry.name.startsWith('.')) {
+                continue;
+            }
+            const fullPath = path.join(dir, entry.name);
+            const relativePath = path.relative(basePath, fullPath);
+            if (entry.isDirectory()) {
+                // Skip excluded directories
+                if (excludeDirs.includes(entry.name)) {
+                    continue;
+                }
+                files.push(...getAllFiles(fullPath, options, basePath));
+            }
+            else if (entry.isFile()) {
+                // Filter by extension if specified
+                if (options.extensions && options.extensions.length > 0) {
+                    const ext = path.extname(entry.name).slice(1);
+                    if (!options.extensions.includes(ext)) {
+                        continue;
+                    }
+                }
+                files.push(relativePath);
+            }
+        }
+    }
+    catch {
+        // Ignore permission errors
+    }
+    return files;
+}
+// ============================================================================
+// Fuzzy Matching
+// ============================================================================
+/**
+ * Calculate fuzzy match score and positions
+ * Higher score = better match
+ */
+export function fuzzyMatch(pattern, text, caseSensitive = false) {
+    const p = caseSensitive ? pattern : pattern.toLowerCase();
+    const t = caseSensitive ? text : text.toLowerCase();
+    if (p.length === 0)
+        return { score: 0, matches: [] };
+    if (p.length > t.length)
+        return null;
+    const matches = [];
+    let score = 0;
+    let patternIdx = 0;
+    let lastMatchEnd = -1;
+    let consecutiveBonus = 0;
+    for (let textIdx = 0; textIdx < t.length && patternIdx < p.length; textIdx++) {
+        if (t[textIdx] === p[patternIdx]) {
+            // Start new match or extend existing
+            if (textIdx === lastMatchEnd) {
+                // Consecutive match - extend and add bonus
+                matches[matches.length - 1][1] = textIdx + 1;
+                consecutiveBonus += 2;
+            }
+            else {
+                // New match segment
+                matches.push([textIdx, textIdx + 1]);
+                consecutiveBonus = 0;
+            }
+            // Scoring bonuses
+            let matchScore = 1 + consecutiveBonus;
+            // Bonus for matching at start
+            if (textIdx === 0)
+                matchScore += 5;
+            // Bonus for matching after separator
+            if (textIdx > 0 && (t[textIdx - 1] === '/' || t[textIdx - 1] === '-' || t[textIdx - 1] === '_' || t[textIdx - 1] === '.')) {
+                matchScore += 3;
+            }
+            // Bonus for matching uppercase in camelCase
+            if (text[textIdx] === text[textIdx].toUpperCase() && text[textIdx] !== text[textIdx].toLowerCase()) {
+                matchScore += 2;
+            }
+            score += matchScore;
+            lastMatchEnd = textIdx + 1;
+            patternIdx++;
+        }
+    }
+    // Did we match all pattern characters?
+    if (patternIdx !== p.length)
+        return null;
+    // Penalize longer strings (prefer shorter matches)
+    score -= t.length * 0.1;
+    // Bonus for exact match
+    if (p === t)
+        score += 10;
+    // Bonus for matching filename (last segment)
+    const filename = text.split('/').pop() || '';
+    if (filename.toLowerCase().includes(p)) {
+        score += 5;
+    }
+    return { score, matches };
+}
+// ============================================================================
+// Search
+// ============================================================================
+/**
+ * Search files with fuzzy matching
+ */
+export function searchFiles(dir, pattern, options = {}) {
+    const maxResults = options.maxResults || 50;
+    const files = getAllFiles(dir, options);
+    const results = [];
+    for (const relativePath of files) {
+        const match = fuzzyMatch(pattern, relativePath, options.caseSensitive);
+        if (match) {
+            results.push({
+                path: path.join(dir, relativePath),
+                relativePath,
+                score: match.score,
+                matches: match.matches,
+            });
+        }
+    }
+    // Sort by score (descending)
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, maxResults);
+}
+/**
+ * Search with highlighting for display
+ */
+export function searchWithHighlight(dir, pattern, options = {}) {
+    const results = searchFiles(dir, pattern, options);
+    return results.map(result => ({
+        path: result.path,
+        highlighted: highlightMatches(result.relativePath, result.matches),
+        score: result.score,
+    }));
+}
+/**
+ * Highlight matching segments in text
+ */
+export function highlightMatches(text, matches, highlightStart = '\x1b[1;33m', // Bold yellow
+highlightEnd = '\x1b[0m') {
+    if (matches.length === 0)
+        return text;
+    let result = '';
+    let lastEnd = 0;
+    for (const [start, end] of matches) {
+        result += text.slice(lastEnd, start);
+        result += highlightStart + text.slice(start, end) + highlightEnd;
+        lastEnd = end;
+    }
+    result += text.slice(lastEnd);
+    return result;
+}
+/**
+ * Create interactive search state
+ */
+export function createSearchState(dir, options = {}) {
+    return {
+        query: '',
+        results: [],
+        selectedIndex: 0,
+        dir,
+        options,
+    };
+}
+/**
+ * Update search with new query
+ */
+export function updateSearch(state, query) {
+    const results = query ? searchFiles(state.dir, query, state.options) : [];
+    return {
+        ...state,
+        query,
+        results,
+        selectedIndex: 0,
+    };
+}
+/**
+ * Move selection up
+ */
+export function selectUp(state) {
+    return {
+        ...state,
+        selectedIndex: Math.max(0, state.selectedIndex - 1),
+    };
+}
+/**
+ * Move selection down
+ */
+export function selectDown(state) {
+    return {
+        ...state,
+        selectedIndex: Math.min(state.results.length - 1, state.selectedIndex + 1),
+    };
+}
+/**
+ * Get selected result
+ */
+export function getSelected(state) {
+    if (state.selectedIndex < 0 || state.selectedIndex >= state.results.length) {
+        return null;
+    }
+    return state.results[state.selectedIndex];
+}
+//# sourceMappingURL=fuzzy-search.js.map

package/dist/fuzzy-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-search.js","sourceRoot":"","sources":["../src/fuzzy-search.ts"],"names":[],"mappings":"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"}

package/dist/hooks.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Calliope CLI - Hooks System
+ *
+ * Pre/post hooks for tool execution, file changes, and events.
+ */
+export type HookEvent = 'pre-tool' | 'post-tool' | 'pre-shell' | 'post-shell' | 'pre-write' | 'post-write' | 'pre-read' | 'session-start' | 'session-end' | 'error' | 'message';
+export interface Hook {
+    id: string;
+    event: HookEvent;
+    name: string;
+    command: string;
+    enabled: boolean;
+    async: boolean;
+    timeout?: number;
+    condition?: string;
+}
+export interface HookContext {
+    event: HookEvent;
+    tool?: string;
+    toolArgs?: Record<string, unknown>;
+    toolResult?: string;
+    filePath?: string;
+    fileContent?: string;
+    command?: string;
+    exitCode?: number;
+    error?: string;
+    message?: string;
+    messageRole?: string;
+}
+export interface HookResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    blocked?: boolean;
+}
+/**
+ * Load hooks configuration
+ */
+export declare function loadHooks(): Hook[];
+/**
+ * Save hooks configuration
+ */
+export declare function saveHooks(hooks: Hook[]): void;
+/**
+ * Add a new hook
+ */
+export declare function addHook(hook: Omit<Hook, 'id'>): Hook;
+/**
+ * Remove a hook
+ */
+export declare function removeHook(id: string): boolean;
+/**
+ * Enable/disable a hook
+ */
+export declare function toggleHook(id: string, enabled: boolean): boolean;
+/**
+ * Get hooks for a specific event
+ */
+export declare function getHooksForEvent(event: HookEvent): Hook[];
+/**
+ * Execute hooks for an event
+ */
+export declare function executeHooks(event: HookEvent, context: Partial<HookContext>): Promise<HookResult[]>;
+/**
+ * Check if any hooks would block an operation
+ */
+export declare function checkHooksAllow(event: HookEvent, context: Partial<HookContext>): Promise<{
+    allowed: boolean;
+    reason?: string;
+}>;
+/**
+ * Initialize default hooks
+ */
+export declare function initDefaultHooks(): void;
+/**
+ * List all hooks formatted for display
+ */
+export declare function listHooksFormatted(): string;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,WAAW,GACX,WAAW,GACX,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,UAAU,GACV,eAAe,GACf,aAAa,GACb,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAeD;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,EAAE,CAUlC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAG7C;AAMD;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CASpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAO9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAOhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,CAEzD;AAiFD;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,UAAU,EAAE,CAAC,CAiDvB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAahD;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAmCvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C"}

package/dist/hooks.js

@@ -0,0 +1,271 @@
+/**
+ * Calliope CLI - Hooks System
+ *
+ * Pre/post hooks for tool execution, file changes, and events.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { spawn } from 'child_process';
+// ============================================================================
+// Configuration
+// ============================================================================
+const HOOKS_DIR = path.join(os.homedir(), '.calliope-cli', 'hooks');
+const HOOKS_FILE = path.join(HOOKS_DIR, 'hooks.json');
+function ensureHooksDir() {
+    if (!fs.existsSync(HOOKS_DIR)) {
+        fs.mkdirSync(HOOKS_DIR, { recursive: true });
+    }
+}
+/**
+ * Load hooks configuration
+ */
+export function loadHooks() {
+    ensureHooksDir();
+    if (!fs.existsSync(HOOKS_FILE)) {
+        return [];
+    }
+    try {
+        return JSON.parse(fs.readFileSync(HOOKS_FILE, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Save hooks configuration
+ */
+export function saveHooks(hooks) {
+    ensureHooksDir();
+    fs.writeFileSync(HOOKS_FILE, JSON.stringify(hooks, null, 2));
+}
+// ============================================================================
+// Hook Management
+// ============================================================================
+/**
+ * Add a new hook
+ */
+export function addHook(hook) {
+    const hooks = loadHooks();
+    const newHook = {
+        ...hook,
+        id: `hook_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`,
+    };
+    hooks.push(newHook);
+    saveHooks(hooks);
+    return newHook;
+}
+/**
+ * Remove a hook
+ */
+export function removeHook(id) {
+    const hooks = loadHooks();
+    const index = hooks.findIndex(h => h.id === id);
+    if (index === -1)
+        return false;
+    hooks.splice(index, 1);
+    saveHooks(hooks);
+    return true;
+}
+/**
+ * Enable/disable a hook
+ */
+export function toggleHook(id, enabled) {
+    const hooks = loadHooks();
+    const hook = hooks.find(h => h.id === id);
+    if (!hook)
+        return false;
+    hook.enabled = enabled;
+    saveHooks(hooks);
+    return true;
+}
+/**
+ * Get hooks for a specific event
+ */
+export function getHooksForEvent(event) {
+    return loadHooks().filter(h => h.enabled && h.event === event);
+}
+// ============================================================================
+// Hook Execution
+// ============================================================================
+/**
+ * Run a hook command
+ */
+async function runHookCommand(hook, context) {
+    return new Promise((resolve) => {
+        const timeout = hook.timeout || 10000;
+        // Build environment with context
+        const env = {
+            ...process.env,
+            CALLIOPE_EVENT: context.event,
+            CALLIOPE_TOOL: context.tool || '',
+            CALLIOPE_FILE: context.filePath || '',
+            CALLIOPE_COMMAND: context.command || '',
+            CALLIOPE_MESSAGE: context.message || '',
+            CALLIOPE_ERROR: context.error || '',
+        };
+        // For tool args, serialize to JSON
+        if (context.toolArgs) {
+            env.CALLIOPE_TOOL_ARGS = JSON.stringify(context.toolArgs);
+        }
+        const proc = spawn('sh', ['-c', hook.command], {
+            env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout,
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        const timer = setTimeout(() => {
+            proc.kill();
+            resolve({
+                success: false,
+                error: 'Hook timed out',
+            });
+        }, timeout);
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            // Exit code 42 means "block the operation"
+            const blocked = code === 42;
+            resolve({
+                success: code === 0 || blocked,
+                output: stdout.trim(),
+                error: stderr.trim() || undefined,
+                blocked,
+            });
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({
+                success: false,
+                error: err.message,
+            });
+        });
+    });
+}
+/**
+ * Execute hooks for an event
+ */
+export async function executeHooks(event, context) {
+    const hooks = getHooksForEvent(event);
+    const results = [];
+    const fullContext = { event, ...context };
+    for (const hook of hooks) {
+        // Check condition if specified
+        if (hook.condition) {
+            let matches = false;
+            // Tool name condition
+            if (context.tool && hook.condition.startsWith('tool:')) {
+                const toolPattern = hook.condition.slice(5);
+                matches = context.tool.includes(toolPattern);
+            }
+            // File pattern condition
+            else if (context.filePath && hook.condition.startsWith('file:')) {
+                const filePattern = hook.condition.slice(5);
+                matches = context.filePath.includes(filePattern);
+            }
+            // Command pattern condition
+            else if (context.command && hook.condition.startsWith('cmd:')) {
+                const cmdPattern = hook.condition.slice(4);
+                matches = context.command.includes(cmdPattern);
+            }
+            // Default: treat as general pattern
+            else {
+                matches = JSON.stringify(context).includes(hook.condition);
+            }
+            if (!matches)
+                continue;
+        }
+        if (hook.async) {
+            // Fire and forget
+            runHookCommand(hook, fullContext).catch(() => { });
+            results.push({ success: true });
+        }
+        else {
+            const result = await runHookCommand(hook, fullContext);
+            results.push(result);
+            // If hook blocks, stop executing more hooks
+            if (result.blocked) {
+                break;
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Check if any hooks would block an operation
+ */
+export async function checkHooksAllow(event, context) {
+    const results = await executeHooks(event, context);
+    for (const result of results) {
+        if (result.blocked) {
+            return {
+                allowed: false,
+                reason: result.output || result.error || 'Blocked by hook',
+            };
+        }
+    }
+    return { allowed: true };
+}
+// ============================================================================
+// Built-in Hooks
+// ============================================================================
+/**
+ * Initialize default hooks
+ */
+export function initDefaultHooks() {
+    const hooks = loadHooks();
+    if (hooks.length > 0)
+        return;
+    // Add some example hooks (disabled by default)
+    const defaults = [
+        {
+            event: 'post-shell',
+            name: 'Log dangerous commands',
+            command: 'echo "$CALLIOPE_COMMAND" >> ~/.calliope-cli/hooks/command-log.txt',
+            enabled: false,
+            async: true,
+            condition: 'cmd:rm -rf',
+        },
+        {
+            event: 'post-write',
+            name: 'Format on save',
+            command: 'prettier --write "$CALLIOPE_FILE" 2>/dev/null || true',
+            enabled: false,
+            async: true,
+            condition: 'file:.ts',
+        },
+        {
+            event: 'pre-shell',
+            name: 'Block sudo',
+            command: 'if echo "$CALLIOPE_COMMAND" | grep -q "^sudo"; then exit 42; fi',
+            enabled: false,
+            async: false,
+            condition: 'cmd:sudo',
+        },
+    ];
+    for (const hook of defaults) {
+        addHook(hook);
+    }
+}
+/**
+ * List all hooks formatted for display
+ */
+export function listHooksFormatted() {
+    const hooks = loadHooks();
+    if (hooks.length === 0) {
+        return 'No hooks configured.';
+    }
+    const lines = hooks.map(h => {
+        const status = h.enabled ? '✓' : '✗';
+        const async = h.async ? '(async)' : '';
+        return `${status} [${h.event}] ${h.name} ${async}\n  ${h.command}`;
+    });
+    return lines.join('\n\n');
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAmDtC,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;AACpE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAEtD,SAAS,cAAc;IACrB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,cAAc,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,cAAc,EAAE,CAAC;IACjB,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAsB;IAC5C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAS;QACpB,GAAG,IAAI;QACP,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;KACnE,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,SAAS,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvB,SAAS,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,OAAgB;IACrD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACvB,SAAS,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,OAAO,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,IAAU,EACV,OAAoB;IAEpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;QAEtC,iCAAiC;QACjC,MAAM,GAAG,GAAuC;YAC9C,GAAG,OAAO,CAAC,GAAG;YACd,cAAc,EAAE,OAAO,CAAC,KAAK;YAC7B,aAAa,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACjC,aAAa,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YACrC,gBAAgB,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YACvC,gBAAgB,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YACvC,cAAc,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;SACpC,CAAC;QAEF,mCAAmC;QACnC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YAC7C,GAAG;YACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC;gBACN,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,gBAAgB;aACxB,CAAC,CAAC;QACL,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,2CAA2C;YAC3C,MAAM,OAAO,GAAG,IAAI,KAAK,EAAE,CAAC;YAE5B,OAAO,CAAC;gBACN,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,OAAO;gBAC9B,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;gBACrB,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS;gBACjC,OAAO;aACR,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC;gBACN,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG,CAAC,OAAO;aACnB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAgB,EAChB,OAA6B;IAE7B,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,WAAW,GAAgB,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC;IAEvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,+BAA+B;QAC/B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,sBAAsB;YACtB,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC5C,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC/C,CAAC;YACD,yBAAyB;iBACpB,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC5C,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACnD,CAAC;YACD,4BAA4B;iBACvB,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC3C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACjD,CAAC;YACD,oCAAoC;iBAC/B,CAAC;gBACJ,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,CAAC,OAAO;gBAAE,SAAS;QACzB,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,kBAAkB;YAClB,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,4CAA4C;YAC5C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAgB,EAChB,OAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEnD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,IAAI,iBAAiB;aAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAE7B,+CAA+C;IAC/C,MAAM,QAAQ,GAA4B;QACxC;YACE,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,mEAAmE;YAC5E,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,YAAY;SACxB;QACD;YACE,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,uDAAuD;YAChE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,UAAU;SACtB;QACD;YACE,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,iEAAiE;YAC1E,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK;YACZ,SAAS,EAAE,UAAU;SACtB;KACF,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACrC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,GAAG,MAAM,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/keyboard.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Calliope CLI - Keyboard Shortcuts
+ *
+ * Vim-like keybindings and keyboard shortcuts.
+ */
+export type KeyAction = 'submit' | 'cancel' | 'clear' | 'historyUp' | 'historyDown' | 'complete' | 'completeNext' | 'completePrev' | 'cursorLeft' | 'cursorRight' | 'cursorWordLeft' | 'cursorWordRight' | 'cursorHome' | 'cursorEnd' | 'deleteChar' | 'deleteWord' | 'deleteLine' | 'deleteToEnd' | 'paste' | 'copy' | 'undo' | 'redo' | 'newline' | 'escape' | 'toggleVimMode' | 'vimNormal' | 'vimInsert' | 'vimAppend' | 'vimDelete' | 'vimChange' | 'vimYank' | 'none';
+export interface KeyBinding {
+    key: string;
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+    action: KeyAction;
+    description?: string;
+}
+export type VimMode = 'normal' | 'insert' | 'visual';
+export interface KeyboardState {
+    vimMode: VimMode;
+    vimEnabled: boolean;
+    pendingKeys: string;
+    lastAction?: KeyAction;
+}
+/**
+ * Check if key event matches a binding
+ */
+export declare function matchBinding(key: string, ctrl: boolean, alt: boolean, shift: boolean, bindings: KeyBinding[]): KeyBinding | null;
+/**
+ * Get action for key event
+ */
+export declare function getKeyAction(key: string, ctrl: boolean, alt: boolean, shift: boolean, state: KeyboardState): KeyAction;
+/**
+ * Create initial keyboard state
+ */
+export declare function createKeyboardState(vimEnabled?: boolean): KeyboardState;
+/**
+ * Update state after action
+ */
+export declare function updateState(state: KeyboardState, action: KeyAction): KeyboardState;
+/**
+ * Toggle vim mode
+ */
+export declare function toggleVimMode(state: KeyboardState): KeyboardState;
+/**
+ * Process vim command key sequence
+ */
+export declare function processVimCommand(state: KeyboardState, key: string): {
+    state: KeyboardState;
+    actions: KeyAction[];
+};
+/**
+ * Format keybinding for display
+ */
+export declare function formatBinding(binding: KeyBinding): string;
+/**
+ * Get all keybindings for display
+ */
+export declare function getBindingsHelp(vimEnabled: boolean): string;
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,WAAW,GACX,aAAa,GACb,UAAU,GACV,cAAc,GACd,cAAc,GACd,YAAY,GACZ,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,SAAS,GACT,QAAQ,GACR,eAAe,GACf,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AA+FD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,UAAU,EAAE,GACrB,UAAU,GAAG,IAAI,CAUnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,aAAa,GACnB,SAAS,CAiBX;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,UAAQ,GAAG,aAAa,CAMrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,GAAG,aAAa,CAiBlF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAOjE;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,MAAM,GACV;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAkDhD;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAOzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAqC3D"}