@cleocode/adapters 2026.5.4 → 2026.5.5

package/dist/providers/pi/hooks.js

@@ -1,223 +0,0 @@
-/**
- * Pi Hook Provider
- *
- * Maps Pi coding agent native event names to CAAMP canonical hook events.
- * Pi supports 11 of 16 canonical events through its extension/event system.
- *
- * Event translation uses CAAMP normalizer APIs:
- * - `toCanonical(nativeName, 'pi')` for runtime event name resolution
- * - `getSupportedEvents('pi')` to enumerate supported canonical events
- * - `getProviderHookProfile('pi')` for the full provider profile
- *
- * A static map derived from CAAMP hook-mappings.json piEventCatalog is
- * maintained as a fallback for environments where CAAMP's runtime
- * resolution is unavailable.
- *
- * Mappings (11/16 supported):
- *   session_start          → SessionStart
- *   session_shutdown       → SessionEnd
- *   input                  → PromptSubmit
- *   turn_end               → Notification  (assistant turn complete)
- *   tool_call              → PreToolUse
- *   tool_result            → PostToolUse
- *   before_agent_start     → SubagentStart
- *   agent_end              → SubagentStop
- *   before_provider_request → PreModel
- *   context                → PreCompact    (context assembly = pre-compaction proxy)
- *
- * Unsupported (5/16):
- *   ResponseComplete, PostToolUseFailure, PermissionRequest,
- *   PostModel, PostCompact, ConfigChange
- *
- * @task T553
- */
-/** CAAMP provider identifier for Pi. */
-const PROVIDER_ID = 'pi';
-/**
- * Fallback map from Pi native event names to CAAMP canonical names.
- *
- * Derived from the `piEventCatalog` block in CAAMP hook-mappings.json.
- * Covers all 11 supported events. ResponseComplete, PostToolUseFailure,
- * PermissionRequest, PostModel, PostCompact, and ConfigChange are not
- * supported by Pi and are absent from this map.
- *
- * Used as fallback when CAAMP runtime is unavailable, and as the
- * synchronous implementation of `mapProviderEvent()`.
- */
-const PI_EVENT_MAP = {
-    // piEventCatalog: session_start → SessionStart
-    session_start: 'SessionStart',
-    // piEventCatalog: session_shutdown → SessionEnd
-    session_shutdown: 'SessionEnd',
-    // piEventCatalog: input → PromptSubmit
-    input: 'PromptSubmit',
-    // piEventCatalog: turn_end → Notification (assistant turn complete)
-    turn_end: 'Notification',
-    // piEventCatalog: tool_call → PreToolUse
-    tool_call: 'PreToolUse',
-    // piEventCatalog: tool_execution_start → PreToolUse (duplicate path)
-    tool_execution_start: 'PreToolUse',
-    // piEventCatalog: tool_result → PostToolUse
-    tool_result: 'PostToolUse',
-    // piEventCatalog: tool_execution_end → PostToolUse (duplicate path)
-    tool_execution_end: 'PostToolUse',
-    // piEventCatalog: before_agent_start → SubagentStart
-    before_agent_start: 'SubagentStart',
-    // piEventCatalog: agent_end → SubagentStop
-    agent_end: 'SubagentStop',
-    // piEventCatalog: before_provider_request → PreModel
-    before_provider_request: 'PreModel',
-    // piEventCatalog: context → PreCompact (context assembly is the pre-compaction proxy for Pi)
-    context: 'PreCompact',
-};
-/**
- * Hook provider for Pi coding agent.
- *
- * Pi registers hooks via its TypeScript extension system. Extensions are
- * loaded from `~/.pi/agent/extensions/*.ts` (global) or
- * `<projectDir>/.pi/extensions/*.ts` (project scope).
- *
- * Event mapping is based on the `piEventCatalog` block in CAAMP
- * hook-mappings.json. Async accessors (`getSupportedCanonicalEvents`,
- * `getProviderProfile`) call CAAMP directly when available.
- *
- * Since hooks are registered through the extension system (managed by the
- * install provider), `registerNativeHooks` and `unregisterNativeHooks`
- * track registration state without performing filesystem operations.
- *
- * @remarks
- * Pi is CAAMP's first-class primary harness (ADR-035). Its native events
- * use snake_case (e.g. `session_start`, `tool_call`) unlike the PascalCase
- * CAAMP canonical names. The static event map covers all 11 supported events.
- * Async CAAMP accessors fall back to the static map when CAAMP is unavailable.
- *
- * Pi does NOT support ResponseComplete, PostToolUseFailure, PermissionRequest,
- * PostModel, PostCompact, or ConfigChange canonical events.
- *
- * All hook dispatch is best-effort — hooks MUST never block or crash Pi.
- *
- * @task T553
- */
-export class PiHookProvider {
-    /** Whether hooks have been registered for the current session. */
-    registered = false;
-    /**
-     * Map a Pi native event name to a CAAMP canonical hook event name.
-     *
-     * Looks up the native event name in the map derived from the
-     * `piEventCatalog` block in CAAMP hook-mappings.json.
-     * Returns null for unrecognised or unsupported events.
-     *
-     * @param providerEvent - Pi native event (e.g. "session_start", "tool_call")
-     * @returns CAAMP canonical event name, or null if unmapped
-     * @task T553
-     */
-    mapProviderEvent(providerEvent) {
-        return PI_EVENT_MAP[providerEvent] ?? null;
-    }
-    /**
-     * Register native hooks for a project.
-     *
-     * For Pi, hooks are registered via the extension system, 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 11 supported hooks.
-     *
-     * @param _projectDir - Project directory (unused; Pi uses extension system)
-     * @task T553
-     */
-    async registerNativeHooks(_projectDir) {
-        this.registered = true;
-    }
-    /**
-     * Unregister native hooks.
-     *
-     * For Pi, this is a no-op since hooks are managed through the extension
-     * system. Unregistration happens via the install provider's uninstall method.
-     *
-     * @task T553
-     */
-    async unregisterNativeHooks() {
-        this.registered = false;
-    }
-    /**
-     * Check whether hooks have been registered via `registerNativeHooks`.
-     */
-    isRegistered() {
-        return this.registered;
-    }
-    /**
-     * Get the native→canonical event mapping for introspection and debugging.
-     *
-     * Returns the map derived from the `piEventCatalog` block in CAAMP
-     * hook-mappings.json. Use `getSupportedCanonicalEvents()` to enumerate
-     * canonical names via live CAAMP APIs.
-     *
-     * @returns Immutable record of native event name → canonical event name
-     */
-    getEventMap() {
-        return { ...PI_EVENT_MAP };
-    }
-    /**
-     * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
-     *
-     * Calls `getSupportedEvents('pi')` from the CAAMP normalizer to get the
-     * authoritative list. Pi supports 11 of 16 canonical events. Falls back
-     * to the unique values of the static event map when CAAMP is unavailable.
-     *
-     * @returns Array of CAAMP canonical event names supported by Pi
-     * @task T553
-     */
-    async getSupportedCanonicalEvents() {
-        try {
-            const { getSupportedEvents } = await import('@cleocode/caamp');
-            return getSupportedEvents(PROVIDER_ID);
-        }
-        catch {
-            return [...new Set(Object.values(PI_EVENT_MAP))];
-        }
-    }
-    /**
-     * Retrieve the full provider hook profile from CAAMP.
-     *
-     * Calls `getProviderHookProfile('pi')` from the CAAMP normalizer to get
-     * the complete profile including hook system type, config path, handler
-     * types, and all event mappings. Returns null when CAAMP is unavailable.
-     *
-     * @returns Provider hook profile or null if CAAMP is unavailable
-     * @task T553
-     */
-    async getProviderProfile() {
-        try {
-            const { getProviderHookProfile } = await import('@cleocode/caamp');
-            return getProviderHookProfile(PROVIDER_ID) ?? null;
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Translate a CAAMP canonical event to its Pi native name via CAAMP.
-     *
-     * Calls `toNative(canonical, 'pi')` from the CAAMP normalizer.
-     * Returns null for unsupported events or when CAAMP is unavailable.
-     *
-     * @param canonical - CAAMP canonical event name (e.g. "PreToolUse")
-     * @returns Pi native event name or null
-     * @task T553
-     */
-    async toNativeEvent(canonical) {
-        try {
-            const { toNative } = await import('@cleocode/caamp');
-            return toNative(canonical, PROVIDER_ID);
-        }
-        catch {
-            // Invert the static map as fallback — return the first match
-            const entry = Object.entries(PI_EVENT_MAP).find(([, v]) => v === canonical);
-            return entry?.[0] ?? null;
-        }
-    }
-}
-//# sourceMappingURL=hooks.js.map

package/dist/providers/pi/hooks.js.map

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

package/dist/providers/pi/index.js

@@ -1,38 +0,0 @@
-/**
- * @packageDocumentation
- *
- * CLEO provider adapter for Pi coding agent (https://github.com/badlogic/pi-mono).
- * Pi is CAAMP's first-class primary harness with 11/16 canonical hook events.
- * Default export is the adapter class for dynamic loading by AdapterManager.
- *
- * @task T553
- */
-import { PiAdapter } from './adapter.js';
-export { PiAdapter } from './adapter.js';
-export { PiHookProvider } from './hooks.js';
-export { PiInstallProvider } from './install.js';
-export { PiSpawnProvider } from './spawn.js';
-export default PiAdapter;
-/**
- * Factory function for creating Pi adapter instances.
- * Used by AdapterManager's dynamic import fallback.
- *
- * @remarks
- * This is the primary entry point for dynamic adapter loading.
- * AdapterManager calls this function when it resolves the pi provider
- * via its import-based discovery mechanism.
- *
- * @returns A new {@link PiAdapter} instance ready for initialization
- *
- * @example
- * ```typescript
- * import { createAdapter } from '@cleocode/adapters/providers/pi';
- *
- * const adapter = createAdapter();
- * await adapter.initialize('/path/to/project');
- * ```
- */
-export function createAdapter() {
-    return new PiAdapter();
-}
-//# sourceMappingURL=index.js.map

package/dist/providers/pi/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/pi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAe,SAAS,CAAC;AAEzB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,SAAS,EAAE,CAAC;AACzB,CAAC"}

package/dist/providers/pi/install.js

@@ -1,183 +0,0 @@
-/**
- * Pi Install Provider
- *
- * Handles CLEO installation into Pi coding agent environments:
- * - Ensures AGENTS.md has CLEO @-references (project and global scope)
- * - Manages Pi settings.json to register CLEO extension path
- *
- * Pi uses AGENTS.md (not CLAUDE.md) as its instruction file. The global
- * instruction file lives at `~/.pi/agent/AGENTS.md`; the project-level
- * file lives at `<projectDir>/AGENTS.md`.
- *
- * Detection: Pi is detected by the `PI_CODING_AGENT_DIR` or `PI_HOME`
- * environment variables, or by presence of `~/.pi/agent/` directory.
- *
- * @task T553
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { getCleoTemplatesTildePath } from '../shared/paths.js';
-/**
- * Lines that should appear in AGENTS.md to reference CLEO.
- * The CLEO-INJECTION.md path is resolved dynamically to support non-default
- * XDG / OS installation locations (T916).
- */
-const INSTRUCTION_REFERENCES = [
-    `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-    '@.cleo/memory-bridge.md',
-];
-/**
- * Resolve the Pi global state root directory.
- *
- * Honours `PI_CODING_AGENT_DIR` env var when set (with `~` expansion),
- * then `PI_HOME`, then falls back to `~/.pi/agent`.
- */
-function getPiAgentDir() {
-    const env = process.env['PI_CODING_AGENT_DIR'];
-    if (env !== undefined && env.length > 0) {
-        if (env === '~')
-            return homedir();
-        if (env.startsWith('~/'))
-            return join(homedir(), env.slice(2));
-        return env;
-    }
-    const piHome = process.env['PI_HOME'];
-    if (piHome !== undefined && piHome.length > 0) {
-        return join(piHome, 'agent');
-    }
-    return join(homedir(), '.pi', 'agent');
-}
-/**
- * Install provider for Pi coding agent.
- *
- * Manages CLEO's integration with Pi by:
- * 1. Ensuring project AGENTS.md contains @-references to CLEO instruction files
- * 2. Ensuring global AGENTS.md (~/.pi/agent/AGENTS.md) contains @-references
- *
- * @remarks
- * Installation is idempotent — running install multiple times on the same
- * project produces the same result. Pi's AGENTS.md is auto-discovered from
- * the working directory upwards, so project-level injection is the primary
- * mechanism. Global injection ensures fresh sessions always load CLEO context.
- */
-export class PiInstallProvider {
-    /**
-     * Install CLEO into a Pi coding agent project.
-     *
-     * @param options - Installation options including project directory
-     * @returns Result describing what was installed
-     */
-    async install(options) {
-        const { projectDir } = options;
-        const installedAt = new Date().toISOString();
-        const details = {};
-        // Step 1: Ensure project AGENTS.md has @-references
-        const projectUpdated = this.updateInstructionFile(projectDir, 'AGENTS.md');
-        if (projectUpdated) {
-            details.instructionFile = join(projectDir, 'AGENTS.md');
-        }
-        // Step 2: Ensure global AGENTS.md has @-references (best-effort)
-        let globalUpdated = false;
-        try {
-            const globalDir = getPiAgentDir();
-            globalUpdated = this.updateInstructionFile(globalDir, 'AGENTS.md');
-            if (globalUpdated) {
-                details.globalInstructionFile = join(globalDir, 'AGENTS.md');
-            }
-        }
-        catch {
-            // Global install is best-effort — never block project install
-        }
-        const instructionFileUpdated = projectUpdated || globalUpdated;
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            details,
-        };
-    }
-    /**
-     * Uninstall CLEO from the current Pi project.
-     *
-     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
-     */
-    async uninstall() { }
-    /**
-     * Check whether CLEO is installed in the current environment.
-     *
-     * Checks for CLEO references in the project AGENTS.md.
-     */
-    async isInstalled() {
-        const agentsMdPath = join(process.cwd(), 'AGENTS.md');
-        if (existsSync(agentsMdPath)) {
-            try {
-                const content = readFileSync(agentsMdPath, 'utf-8');
-                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-                    return true;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        // Also check global AGENTS.md
-        try {
-            const globalPath = join(getPiAgentDir(), 'AGENTS.md');
-            if (existsSync(globalPath)) {
-                const content = readFileSync(globalPath, 'utf-8');
-                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-                    return true;
-                }
-            }
-        }
-        catch {
-            // Fall through
-        }
-        return false;
-    }
-    /**
-     * Ensure AGENTS.md contains @-references to CLEO instruction files.
-     *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
-     *
-     * @param projectDir - Project root directory
-     */
-    async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir, 'AGENTS.md');
-    }
-    /**
-     * Update an instruction file with CLEO @-references.
-     *
-     * @param dir - Directory containing the instruction file
-     * @param filename - Name of the instruction file (e.g. "AGENTS.md")
-     * @returns true if the file was created or modified
-     */
-    updateInstructionFile(dir, filename) {
-        const filePath = join(dir, filename);
-        let content = '';
-        let existed = false;
-        if (existsSync(filePath)) {
-            content = readFileSync(filePath, 'utf-8');
-            existed = true;
-        }
-        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-        if (missingRefs.length === 0) {
-            return false;
-        }
-        const refsBlock = missingRefs.join('\n');
-        if (existed) {
-            // Append missing references
-            const separator = content.endsWith('\n') ? '' : '\n';
-            content = content + separator + refsBlock + '\n';
-        }
-        else {
-            // Create new file with references — ensure parent dir exists
-            mkdirSync(dir, { recursive: true });
-            content = refsBlock + '\n';
-        }
-        writeFileSync(filePath, content, 'utf-8');
-        return true;
-    }
-}
-//# sourceMappingURL=install.js.map

package/dist/providers/pi/install.js.map

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

package/dist/providers/pi/spawn.js

@@ -1,187 +0,0 @@
-/**
- * Pi Spawn Provider
- *
- * Implements AdapterSpawnProvider for Pi coding agent CLI.
- *
- * Uses the `pi` CLI (or the path from `PI_CLI_PATH` env var) to spawn
- * subagent processes with prompts written to temporary files. Processes
- * run detached and are tracked by PID for listing and termination.
- *
- * Pi detection: `PI_CLI_PATH` env var or `which pi`.
- *
- * @task T553
- */
-import { exec, spawn as nodeSpawn } from 'node:child_process';
-import { unlink, writeFile } from 'node:fs/promises';
-import { promisify } from 'node:util';
-import { getErrorMessage } from '@cleocode/contracts';
-const execAsync = promisify(exec);
-/**
- * Resolve the Pi CLI executable path.
- *
- * Honours `PI_CLI_PATH` env var when set, otherwise uses `pi` (expects
- * the binary on PATH).
- */
-function getPiCliPath() {
-    return process.env['PI_CLI_PATH'] ?? 'pi';
-}
-/**
- * Spawn provider for Pi coding agent.
- *
- * Spawns detached Pi CLI processes for subagent execution. Each spawn
- * writes its prompt to a temporary file, then runs the Pi CLI with the
- * prompt file as the primary argument as a detached, unref'd child process.
- *
- * @remarks
- * Prompts are written to temporary files under `/tmp/` and cleaned up
- * after the child process exits. Processes are tracked by instance ID in
- * an in-memory map and verified via `kill(pid, 0)` liveness checks.
- * All failures are best-effort and non-blocking.
- */
-export class PiSpawnProvider {
-    /** Map of instance IDs to tracked process info. */
-    processMap = new Map();
-    /**
-     * Check if the Pi CLI is available.
-     *
-     * Checks `PI_CLI_PATH` env var first, then tries `which pi`.
-     *
-     * @returns true if the Pi CLI is accessible
-     */
-    async canSpawn() {
-        const cliPath = getPiCliPath();
-        try {
-            if (cliPath !== 'pi') {
-                // Custom path — check if it exists
-                const { stdout } = await execAsync(`test -x "${cliPath}" && echo ok`);
-                return stdout.trim() === 'ok';
-            }
-            await execAsync('which pi');
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Spawn a subagent via Pi CLI.
-     *
-     * Writes the prompt to a temporary file and spawns a detached Pi
-     * process. The process runs independently of the parent.
-     *
-     * @param context - Spawn context with taskId, prompt, and options
-     * @returns Spawn result with instance ID and status
-     */
-    async spawn(context) {
-        const instanceId = `pi-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-        const startTime = new Date().toISOString();
-        let tmpFile;
-        try {
-            tmpFile = `/tmp/pi-spawn-${instanceId}.txt`;
-            await writeFile(tmpFile, context.prompt, 'utf-8');
-            const cliPath = getPiCliPath();
-            const args = [tmpFile];
-            const spawnOpts = {
-                detached: true,
-                stdio: 'ignore',
-            };
-            if (context.workingDirectory) {
-                spawnOpts.cwd = context.workingDirectory;
-            }
-            const child = nodeSpawn(cliPath, args, spawnOpts);
-            child.unref();
-            if (child.pid) {
-                this.processMap.set(instanceId, {
-                    pid: child.pid,
-                    taskId: context.taskId,
-                    startTime,
-                });
-            }
-            const capturedTmpFile = tmpFile;
-            child.on('exit', async () => {
-                this.processMap.delete(instanceId);
-                try {
-                    await unlink(capturedTmpFile);
-                }
-                catch {
-                    // Ignore cleanup errors
-                }
-            });
-            return {
-                instanceId,
-                taskId: context.taskId,
-                providerId: 'pi',
-                status: 'running',
-                startTime,
-            };
-        }
-        catch (error) {
-            console.error(`[PiSpawnProvider] Failed to spawn: ${getErrorMessage(error)}`);
-            if (tmpFile) {
-                try {
-                    await unlink(tmpFile);
-                }
-                catch {
-                    // Ignore cleanup errors
-                }
-            }
-            return {
-                instanceId,
-                taskId: context.taskId,
-                providerId: 'pi',
-                status: 'failed',
-                startTime,
-                endTime: new Date().toISOString(),
-                error: getErrorMessage(error),
-            };
-        }
-    }
-    /**
-     * List currently running Pi subagent processes.
-     *
-     * Checks each tracked process via kill(pid, 0) to verify it is still alive.
-     * Dead processes are automatically cleaned from the tracking map.
-     *
-     * @returns Array of spawn results for running processes
-     */
-    async listRunning() {
-        const running = [];
-        for (const [instanceId, tracked] of this.processMap.entries()) {
-            try {
-                process.kill(tracked.pid, 0);
-                running.push({
-                    instanceId,
-                    taskId: tracked.taskId,
-                    providerId: 'pi',
-                    status: 'running',
-                    startTime: tracked.startTime,
-                });
-            }
-            catch {
-                this.processMap.delete(instanceId);
-            }
-        }
-        return running;
-    }
-    /**
-     * Terminate a running spawn by instance ID.
-     *
-     * Sends SIGTERM to the tracked process. If the process is not found
-     * or has already exited, this is a no-op.
-     *
-     * @param instanceId - ID of the spawn instance to terminate
-     */
-    async terminate(instanceId) {
-        const tracked = this.processMap.get(instanceId);
-        if (!tracked)
-            return;
-        try {
-            process.kill(tracked.pid, 'SIGTERM');
-        }
-        catch {
-            // Process may have already exited
-        }
-        this.processMap.delete(instanceId);
-    }
-}
-//# sourceMappingURL=spawn.js.map

package/dist/providers/pi/spawn.js.map

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