@cleocode/adapters 2026.4.11 → 2026.4.13

package/dist/providers/claude-code/adapter.d.ts

@@ -1,95 +0,0 @@
-/**
- * Claude Code Adapter
- *
- * Main CLEOProviderAdapter implementation for Anthropic's Claude Code CLI.
- * Provides spawn, hooks, and install capabilities for CLEO integration.
- *
- * @task T5240
- */
-import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
-import { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
-import { ClaudeCodeHookProvider } from './hooks.js';
-import { ClaudeCodeInstallProvider } from './install.js';
-import { ClaudeCodePathProvider } from './paths.js';
-import { ClaudeCodeSpawnProvider } from './spawn.js';
-import { ClaudeCodeTaskSyncProvider } from './task-sync.js';
-import { ClaudeCodeTransportProvider } from './transport.js';
-/**
- * CLEO provider adapter for Anthropic Claude Code CLI.
- *
- * Bridges CLEO's adapter system with Claude Code's native capabilities:
- * - Hooks: Maps Claude Code events (SessionStart, PostToolUse, etc.) to CAAMP events
- * - Spawn: Launches subagent processes via the `claude` CLI
- * - Install: Manages instruction files and brain observation plugin registration
- *
- * @remarks
- * This is the most feature-complete adapter in the CLEO system, supporting
- * 14 of 16 CAAMP canonical events, subagent spawning via the `claude` CLI,
- * context monitoring with statusline integration, task sync via TodoWrite,
- * and inter-agent transport. It serves as the reference implementation for
- * other provider adapters.
- */
-export declare class ClaudeCodeAdapter implements CLEOProviderAdapter {
-    /** Unique provider identifier. */
-    readonly id = "claude-code";
-    /** Human-readable provider name. */
-    readonly name = "Claude Code";
-    /** Adapter version string. */
-    readonly version = "1.0.0";
-    /** Declared capabilities for this provider. */
-    capabilities: AdapterCapabilities;
-    /** Hook provider for CAAMP event mapping and registration. */
-    hooks: ClaudeCodeHookProvider;
-    /** Spawn provider for launching subagent processes via `claude` CLI. */
-    spawn: ClaudeCodeSpawnProvider;
-    /** Install provider for managing instruction files and plugin registration. */
-    install: ClaudeCodeInstallProvider;
-    /** Path provider for resolving Claude Code directory locations. */
-    paths: ClaudeCodePathProvider;
-    /** Context monitor for tracking context window usage and statusline output. */
-    contextMonitor: ClaudeCodeContextMonitorProvider;
-    /** Transport provider for inter-agent communication. */
-    transport: ClaudeCodeTransportProvider;
-    /** Task sync provider bridging Claude's TodoWrite format to CLEO tasks. */
-    taskSync: ClaudeCodeTaskSyncProvider;
-    /** Project directory this adapter was initialized with, or null. */
-    private projectDir;
-    /** Whether {@link initialize} has been called. */
-    private initialized;
-    constructor();
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * Validates the environment by checking for the Claude CLI
-     * and Claude Code configuration directory.
-     *
-     * @param projectDir - Root directory of the project
-     */
-    initialize(projectDir: string): Promise<void>;
-    /**
-     * Dispose the adapter and clean up resources.
-     *
-     * Unregisters hooks and releases any tracked state.
-     */
-    dispose(): Promise<void>;
-    /**
-     * Run a health check to verify Claude Code is accessible.
-     *
-     * Checks:
-     * 1. Adapter has been initialized
-     * 2. Claude CLI is available in PATH
-     * 3. ~/.claude/ configuration directory exists
-     *
-     * @returns Health status with details about each check
-     */
-    healthCheck(): Promise<AdapterHealthStatus>;
-    /**
-     * Check whether the adapter has been initialized.
-     */
-    isInitialized(): boolean;
-    /**
-     * Get the project directory this adapter was initialized with.
-     */
-    getProjectDir(): string | null;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/claude-code/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA8B/B;IAEF,8DAA8D;IAC9D,KAAK,EAAE,sBAAsB,CAAC;IAC9B,wEAAwE;IACxE,KAAK,EAAE,uBAAuB,CAAC;IAC/B,+EAA+E;IAC/E,OAAO,EAAE,yBAAyB,CAAC;IACnC,mEAAmE;IACnE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,EAAE,gCAAgC,CAAC;IACjD,wDAAwD;IACxD,SAAS,EAAE,2BAA2B,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,EAAE,0BAA0B,CAAC;IAErC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;OAOG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/claude-code/adapter.js

@@ -1,185 +0,0 @@
-/**
- * Claude Code Adapter
- *
- * Main CLEOProviderAdapter implementation for Anthropic's Claude Code CLI.
- * Provides spawn, hooks, and install capabilities for CLEO integration.
- *
- * @task T5240
- */
-import { exec } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { promisify } from 'node:util';
-import { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
-import { ClaudeCodeHookProvider } from './hooks.js';
-import { ClaudeCodeInstallProvider } from './install.js';
-import { ClaudeCodePathProvider } from './paths.js';
-import { ClaudeCodeSpawnProvider } from './spawn.js';
-import { ClaudeCodeTaskSyncProvider } from './task-sync.js';
-import { ClaudeCodeTransportProvider } from './transport.js';
-const execAsync = promisify(exec);
-/**
- * CLEO provider adapter for Anthropic Claude Code CLI.
- *
- * Bridges CLEO's adapter system with Claude Code's native capabilities:
- * - Hooks: Maps Claude Code events (SessionStart, PostToolUse, etc.) to CAAMP events
- * - Spawn: Launches subagent processes via the `claude` CLI
- * - Install: Manages instruction files and brain observation plugin registration
- *
- * @remarks
- * This is the most feature-complete adapter in the CLEO system, supporting
- * 14 of 16 CAAMP canonical events, subagent spawning via the `claude` CLI,
- * context monitoring with statusline integration, task sync via TodoWrite,
- * and inter-agent transport. It serves as the reference implementation for
- * other provider adapters.
- */
-export class ClaudeCodeAdapter {
-    /** Unique provider identifier. */
-    id = 'claude-code';
-    /** Human-readable provider name. */
-    name = 'Claude Code';
-    /** Adapter version string. */
-    version = '1.0.0';
-    /** Declared capabilities for this provider. */
-    capabilities = {
-        supportsHooks: true,
-        // 14/16 canonical events — derived from getProviderHookProfile('claude-code') in CAAMP 1.9.1.
-        // PreModel and PostModel are not supported by Claude Code.
-        supportedHookEvents: [
-            'SessionStart',
-            'SessionEnd',
-            'PromptSubmit',
-            'ResponseComplete',
-            'PreToolUse',
-            'PostToolUse',
-            'PostToolUseFailure',
-            'PermissionRequest',
-            'SubagentStart',
-            'SubagentStop',
-            'PreCompact',
-            'PostCompact',
-            'Notification',
-            'ConfigChange',
-        ],
-        supportsSpawn: true,
-        supportsInstall: true,
-        supportsMcp: false,
-        supportsInstructionFiles: true,
-        instructionFilePattern: 'CLAUDE.md',
-        supportsContextMonitor: true,
-        supportsStatusline: true,
-        supportsProviderPaths: true,
-        supportsTransport: true,
-        supportsTaskSync: true,
-    };
-    /** Hook provider for CAAMP event mapping and registration. */
-    hooks;
-    /** Spawn provider for launching subagent processes via `claude` CLI. */
-    spawn;
-    /** Install provider for managing instruction files and plugin registration. */
-    install;
-    /** Path provider for resolving Claude Code directory locations. */
-    paths;
-    /** Context monitor for tracking context window usage and statusline output. */
-    contextMonitor;
-    /** Transport provider for inter-agent communication. */
-    transport;
-    /** Task sync provider bridging Claude's TodoWrite format to CLEO tasks. */
-    taskSync;
-    /** Project directory this adapter was initialized with, or null. */
-    projectDir = null;
-    /** Whether {@link initialize} has been called. */
-    initialized = false;
-    constructor() {
-        this.hooks = new ClaudeCodeHookProvider();
-        this.spawn = new ClaudeCodeSpawnProvider();
-        this.install = new ClaudeCodeInstallProvider();
-        this.paths = new ClaudeCodePathProvider();
-        this.contextMonitor = new ClaudeCodeContextMonitorProvider();
-        this.transport = new ClaudeCodeTransportProvider();
-        this.taskSync = new ClaudeCodeTaskSyncProvider();
-    }
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * Validates the environment by checking for the Claude CLI
-     * and Claude Code configuration directory.
-     *
-     * @param projectDir - Root directory of the project
-     */
-    async initialize(projectDir) {
-        this.projectDir = projectDir;
-        this.initialized = true;
-    }
-    /**
-     * Dispose the adapter and clean up resources.
-     *
-     * Unregisters hooks and releases any tracked state.
-     */
-    async dispose() {
-        if (this.hooks.isRegistered()) {
-            await this.hooks.unregisterNativeHooks();
-        }
-        this.initialized = false;
-        this.projectDir = null;
-    }
-    /**
-     * Run a health check to verify Claude Code is accessible.
-     *
-     * Checks:
-     * 1. Adapter has been initialized
-     * 2. Claude CLI is available in PATH
-     * 3. ~/.claude/ configuration directory exists
-     *
-     * @returns Health status with details about each check
-     */
-    async healthCheck() {
-        const details = {};
-        if (!this.initialized) {
-            return {
-                healthy: false,
-                provider: this.id,
-                details: { error: 'Adapter not initialized' },
-            };
-        }
-        // Check Claude CLI availability
-        let cliAvailable = false;
-        try {
-            const { stdout } = await execAsync('which claude');
-            cliAvailable = stdout.trim().length > 0;
-            details.cliPath = stdout.trim();
-        }
-        catch {
-            details.cliAvailable = false;
-        }
-        // Check for Claude Code config directory
-        const claudeConfigDir = join(homedir(), '.claude');
-        const configExists = existsSync(claudeConfigDir);
-        details.configDirExists = configExists;
-        // Check for CLAUDE_CODE_ENTRYPOINT env var
-        const entrypointSet = process.env.CLAUDE_CODE_ENTRYPOINT !== undefined;
-        details.entrypointEnvSet = entrypointSet;
-        // Healthy if CLI is available (primary requirement)
-        const healthy = cliAvailable;
-        details.cliAvailable = cliAvailable;
-        return {
-            healthy,
-            provider: this.id,
-            details,
-        };
-    }
-    /**
-     * Check whether the adapter has been initialized.
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get the project directory this adapter was initialized with.
-     */
-    getProjectDir() {
-        return this.projectDir;
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/dist/providers/claude-code/adapter.js.map

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

package/dist/providers/claude-code/context-monitor.d.ts

@@ -1,35 +0,0 @@
-/**
- * Claude Code context monitor provider.
- *
- * Implements AdapterContextMonitorProvider for Claude Code's context window
- * tracking and statusline integration.
- *
- * @task T5240
- */
-import type { AdapterContextMonitorProvider } from '@cleocode/contracts';
-/**
- * Context monitor provider for Claude Code.
- *
- * Processes context window JSON from Claude Code and writes state files
- * for statusline display. Also provides statusline configuration
- * and setup instructions specific to Claude Code's settings.json.
- *
- * @remarks
- * The provider writes a JSON state file to `.cleo/context-states/.context-state.json`
- * which can be read by external statusline scripts (e.g. tmux, starship).
- * Context thresholds at 50%, 70%, 85%, and 95% map to warning, caution,
- * critical, and emergency status levels respectively.
- */
-export declare class ClaudeCodeContextMonitorProvider implements AdapterContextMonitorProvider {
-    /** Path provider for resolving Claude Code directory locations. */
-    private pathProvider;
-    /** Process raw context window JSON and return a formatted summary string. */
-    processContextInput(input: unknown, cwd?: string): Promise<string>;
-    /** Check the current statusline integration status in Claude Code settings. */
-    checkStatuslineIntegration(): 'configured' | 'not_configured' | 'custom_no_cleo' | 'no_settings';
-    /** Get the recommended statusline configuration object for Claude Code settings. */
-    getStatuslineConfig(): Record<string, unknown>;
-    /** Get human-readable setup instructions for enabling context monitoring. */
-    getSetupInstructions(): string;
-}
-//# sourceMappingURL=context-monitor.d.ts.map

package/dist/providers/claude-code/context-monitor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-monitor.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/context-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAkCzE;;;;;;;;;;;;GAYG;AACH,qBAAa,gCAAiC,YAAW,6BAA6B;IACpF,mEAAmE;IACnE,OAAO,CAAC,YAAY,CAAgC;IAEpD,6EAA6E;IACvE,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0DxE,+EAA+E;IAC/E,0BAA0B,IAAI,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa;IAsChG,oFAAoF;IACpF,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS9C,6EAA6E;IAC7E,oBAAoB,IAAI,MAAM;CAY/B"}

package/dist/providers/claude-code/context-monitor.js

@@ -1,159 +0,0 @@
-/**
- * Claude Code context monitor provider.
- *
- * Implements AdapterContextMonitorProvider for Claude Code's context window
- * tracking and statusline integration.
- *
- * @task T5240
- */
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { mkdir } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-import { ClaudeCodePathProvider } from './paths.js';
-/** Thresholds for context window status levels. */
-const THRESHOLDS = {
-    WARNING: 50,
-    CAUTION: 70,
-    CRITICAL: 85,
-    EMERGENCY: 95,
-};
-function getContextStatusFromPercentage(percentage) {
-    if (percentage >= THRESHOLDS.EMERGENCY)
-        return 'emergency';
-    if (percentage >= THRESHOLDS.CRITICAL)
-        return 'critical';
-    if (percentage >= THRESHOLDS.CAUTION)
-        return 'caution';
-    if (percentage >= THRESHOLDS.WARNING)
-        return 'warning';
-    return 'ok';
-}
-/**
- * Context monitor provider for Claude Code.
- *
- * Processes context window JSON from Claude Code and writes state files
- * for statusline display. Also provides statusline configuration
- * and setup instructions specific to Claude Code's settings.json.
- *
- * @remarks
- * The provider writes a JSON state file to `.cleo/context-states/.context-state.json`
- * which can be read by external statusline scripts (e.g. tmux, starship).
- * Context thresholds at 50%, 70%, 85%, and 95% map to warning, caution,
- * critical, and emergency status levels respectively.
- */
-export class ClaudeCodeContextMonitorProvider {
-    /** Path provider for resolving Claude Code directory locations. */
-    pathProvider = new ClaudeCodePathProvider();
-    /** Process raw context window JSON and return a formatted summary string. */
-    async processContextInput(input, cwd) {
-        const typed = input;
-        const contextSize = typed.context_window?.context_window_size ?? 200000;
-        const usage = typed.context_window?.current_usage;
-        if (!usage)
-            return '-- no data';
-        const inputTokens = usage.input_tokens ?? 0;
-        const outputTokens = usage.output_tokens ?? 0;
-        const cacheCreate = usage.cache_creation_input_tokens ?? 0;
-        const totalTokens = inputTokens + outputTokens + cacheCreate;
-        const percentage = Math.floor((totalTokens * 100) / contextSize);
-        const status = getContextStatusFromPercentage(percentage);
-        // Write state file if CLEO dir exists
-        const cleoDir = cwd ? join(cwd, '.cleo') : '.cleo';
-        if (existsSync(cleoDir)) {
-            const stateDir = join(cleoDir, 'context-states');
-            const statePath = join(stateDir, '.context-state.json');
-            const state = {
-                $schema: 'https://cleo-dev.com/schemas/v1/context-state.schema.json',
-                version: '1.0.0',
-                timestamp: new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'),
-                staleAfterMs: 5000,
-                contextWindow: {
-                    maxTokens: contextSize,
-                    currentTokens: totalTokens,
-                    percentage,
-                    breakdown: {
-                        inputTokens,
-                        outputTokens,
-                        cacheCreationTokens: cacheCreate,
-                        cacheReadTokens: usage.cache_read_input_tokens ?? 0,
-                    },
-                },
-                thresholds: {
-                    warning: THRESHOLDS.WARNING,
-                    caution: THRESHOLDS.CAUTION,
-                    critical: THRESHOLDS.CRITICAL,
-                    emergency: THRESHOLDS.EMERGENCY,
-                },
-                status,
-                cleoSessionId: '',
-            };
-            try {
-                await mkdir(dirname(statePath), { recursive: true });
-                writeFileSync(statePath, JSON.stringify(state, null, 2));
-            }
-            catch {
-                // Non-fatal
-            }
-        }
-        return `${percentage}% | ${totalTokens}/${contextSize}`;
-    }
-    /** Check the current statusline integration status in Claude Code settings. */
-    checkStatuslineIntegration() {
-        const settingsPath = this.pathProvider.getSettingsPath();
-        if (!settingsPath || !existsSync(settingsPath))
-            return 'no_settings';
-        try {
-            const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-            const statusLine = settings.statusLine;
-            if (!statusLine?.type)
-                return 'not_configured';
-            if (statusLine.type !== 'command')
-                return 'custom_no_cleo';
-            const cmd = statusLine.command ?? '';
-            if (cmd.includes('context-monitor.sh') ||
-                cmd.includes('cleo-statusline') ||
-                cmd.includes('.context-state.json') ||
-                cmd.includes('context-states')) {
-                return 'configured';
-            }
-            const scriptPath = cmd.startsWith('~') ? cmd.replace('~', homedir()) : cmd;
-            if (existsSync(scriptPath)) {
-                try {
-                    const content = readFileSync(scriptPath, 'utf-8');
-                    if (content.includes('context-state.json'))
-                        return 'configured';
-                }
-                catch {
-                    /* unreadable */
-                }
-            }
-            return 'custom_no_cleo';
-        }
-        catch {
-            return 'no_settings';
-        }
-    }
-    /** Get the recommended statusline configuration object for Claude Code settings. */
-    getStatuslineConfig() {
-        return {
-            statusLine: {
-                type: 'command',
-                command: join(homedir(), '.cleo', 'lib', 'session', 'context-monitor.sh'),
-            },
-        };
-    }
-    /** Get human-readable setup instructions for enabling context monitoring. */
-    getSetupInstructions() {
-        const settingsPath = this.pathProvider.getSettingsPath() ?? '~/.claude/settings.json';
-        return [
-            'To enable context monitoring, add to your Claude Code settings:',
-            `File: ${settingsPath}`,
-            '',
-            JSON.stringify(this.getStatuslineConfig(), null, 2),
-            '',
-            'This enables real-time context window tracking in the CLI.',
-        ].join('\n');
-    }
-}
-//# sourceMappingURL=context-monitor.js.map

package/dist/providers/claude-code/context-monitor.js.map

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

package/dist/providers/claude-code/hooks.d.ts

@@ -1,146 +0,0 @@
-/**
- * Claude Code Hook Provider
- *
- * Maps Claude Code's native hook events to CAAMP canonical hook events.
- * Claude Code supports 14 of 16 canonical events (all except PreModel, PostModel).
- *
- * Event translation uses CAAMP normalizer APIs:
- * - `toCanonical(nativeName, 'claude-code')` for runtime event name resolution
- * - `getSupportedEvents('claude-code')` to enumerate supported canonical events
- * - `getProviderHookProfile('claude-code')` for the full provider profile
- *
- * A static map derived from CAAMP 1.9.1 hook-mappings.json is maintained as
- * a fallback for environments where CAAMP's runtime resolution is unavailable.
- *
- * @task T164
- * @epic T134
- */
-import type { AdapterHookProvider } from '@cleocode/contracts';
-/**
- * Hook provider for Claude Code.
- *
- * Claude Code registers hooks via its global config at `~/.claude/settings.json`.
- * Supported handler types: command, http, prompt, agent.
- *
- * Event mapping is based on `getProviderHookProfile('claude-code')` from
- * CAAMP 1.9.1. Async accessors (`getSupportedCanonicalEvents`,
- * `getProviderProfile`) call CAAMP directly when available.
- *
- * Since hooks are registered through the config system (managed by the install
- * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
- * state without performing filesystem operations.
- *
- * @remarks
- * Claude Code is the only provider that supports all 14 of its declared
- * canonical events at runtime. The static event map is maintained as a
- * synchronous fallback; async methods like {@link getSupportedCanonicalEvents}
- * and {@link getProviderProfile} call CAAMP directly when available.
- *
- * @task T164
- * @epic T134
- */
-export declare class ClaudeCodeHookProvider implements AdapterHookProvider {
-    /** Whether hooks have been registered for the current session. */
-    private registered;
-    /**
-     * Map a Claude Code native event name to a CAAMP canonical hook event name.
-     *
-     * Looks up the native event name in the map derived from
-     * `getProviderHookProfile('claude-code').mappings` (CAAMP 1.9.1).
-     * Returns null for unrecognised events (e.g. PreModel, PostModel which
-     * Claude Code does not support).
-     *
-     * @param providerEvent - Claude Code native event (e.g. "UserPromptSubmit", "Stop")
-     * @returns CAAMP canonical event name, or null if unmapped
-     * @task T164
-     */
-    mapProviderEvent(providerEvent: string): string | null;
-    /**
-     * Register native hooks for a project.
-     *
-     * For Claude Code, hooks are registered via the config system
-     * (`~/.claude/settings.json`), managed by the install provider.
-     * This method marks hooks as registered without performing filesystem operations.
-     *
-     * Iterating supported events is handled at install time using
-     * `getSupportedCanonicalEvents()` to enumerate all 14 supported hooks.
-     *
-     * @param _projectDir - Project directory (unused; Claude Code uses global config)
-     * @task T164
-     */
-    registerNativeHooks(_projectDir: string): Promise<void>;
-    /**
-     * Unregister native hooks.
-     *
-     * For Claude Code, this is a no-op since hooks are managed through the config
-     * system. Unregistration happens via the install provider's uninstall method.
-     *
-     * @task T164
-     */
-    unregisterNativeHooks(): Promise<void>;
-    /**
-     * Check whether hooks have been registered via `registerNativeHooks`.
-     */
-    isRegistered(): boolean;
-    /**
-     * Get the native→canonical event mapping for introspection and debugging.
-     *
-     * Returns the map derived from `getProviderHookProfile('claude-code').mappings`
-     * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
-     * names via live CAAMP APIs.
-     *
-     * @returns Immutable record of native event name → canonical event name
-     */
-    getEventMap(): Readonly<Record<string, string>>;
-    /**
-     * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
-     *
-     * Calls `getSupportedEvents('claude-code')` from the CAAMP normalizer to
-     * get the authoritative list. Claude Code supports 14 of 16 canonical events
-     * (PreModel and PostModel are not supported). Falls back to the values of
-     * the static event map when CAAMP is unavailable at runtime.
-     *
-     * @returns Array of CAAMP canonical event names supported by Claude Code
-     * @task T164
-     */
-    getSupportedCanonicalEvents(): Promise<string[]>;
-    /**
-     * Retrieve the full provider hook profile from CAAMP.
-     *
-     * Calls `getProviderHookProfile('claude-code')` from the CAAMP normalizer to
-     * get the complete profile: hook system type (`config`), config path
-     * (`~/.claude/settings.json`), handler types, and all event mappings.
-     * Returns null when CAAMP is unavailable at runtime.
-     *
-     * @returns Provider hook profile or null if CAAMP is unavailable
-     * @task T164
-     */
-    getProviderProfile(): Promise<unknown | null>;
-    /**
-     * Translate a CAAMP canonical event to its Claude Code native name via CAAMP.
-     *
-     * Calls `toNative(canonical, 'claude-code')` from the CAAMP normalizer.
-     * Returns null for unsupported events (PreModel, PostModel) or when
-     * CAAMP is unavailable.
-     *
-     * @param canonical - CAAMP canonical event name (e.g. "PromptSubmit")
-     * @returns Claude Code native event name or null
-     * @task T164
-     */
-    toNativeEvent(canonical: string): Promise<string | null>;
-    /**
-     * Extract a plain-text transcript from Claude Code session JSONL files.
-     *
-     * Reads the most recent .jsonl file under `~/.claude/projects/` and
-     * extracts user/assistant turn text into a flat string for brain
-     * observation extraction.
-     *
-     * Returns null when no session data is found or on any read error.
-     *
-     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
-     * @param _projectDir - Project directory (unused; Claude Code uses global paths)
-     * @task T144 @epic T134
-     */
-    getTranscript(_sessionId: string, _projectDir: string): Promise<string | null>;
-}
-//# sourceMappingURL=hooks.d.ts.map

package/dist/providers/claude-code/hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA8C/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW9D;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA2DrF"}