@cleocode/adapters 2026.4.31 → 2026.4.35

package/dist/providers/pi/index.js

@@ -0,0 +1,38 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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 type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * 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 declare class PiInstallProvider implements AdapterInstallProvider {
+    /**
+     * Install CLEO into a Pi coding agent project.
+     *
+     * @param options - Installation options including project directory
+     * @returns Result describing what was installed
+     */
+    install(options: InstallOptions): Promise<InstallResult>;
+    /**
+     * Uninstall CLEO from the current Pi project.
+     *
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Check whether CLEO is installed in the current environment.
+     *
+     * Checks for CLEO references in the project AGENTS.md.
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * 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
+     */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+    /**
+     * 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
+     */
+    private updateInstructionFile;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/providers/pi/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAyBjG;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,sBAAsB;IAC9D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CA+B9B"}

package/dist/providers/pi/install.js

@@ -0,0 +1,175 @@
+/**
+ * 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';
+/** Lines that should appear in AGENTS.md to reference CLEO. */
+const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/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

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

package/dist/providers/pi/spawn.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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 type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
+/**
+ * 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 declare class PiSpawnProvider implements AdapterSpawnProvider {
+    /** Map of instance IDs to tracked process info. */
+    private processMap;
+    /**
+     * 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
+     */
+    canSpawn(): Promise<boolean>;
+    /**
+     * 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
+     */
+    spawn(context: SpawnContext): Promise<SpawnResult>;
+    /**
+     * 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
+     */
+    listRunning(): Promise<SpawnResult[]>;
+    /**
+     * 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
+     */
+    terminate(instanceId: string): Promise<void>;
+}
+//# sourceMappingURL=spawn.d.ts.map

package/dist/providers/pi/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAsB3F;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,YAAW,oBAAoB;IAC1D,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAelC;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAuExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}

package/dist/providers/pi/spawn.js

@@ -0,0 +1,187 @@
+/**
+ * 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

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