@cleocode/adapters 2026.4.31 → 2026.4.36

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAe,eAAe,CAAC;AAE/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/providers/opencode/install.js

@@ -0,0 +1,115 @@
+/**
+ * OpenCode Install Provider
+ *
+ * Handles CLEO installation into OpenCode environments:
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T5240
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+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'];
+/**
+ * Install provider for OpenCode.
+ *
+ * Manages CLEO's integration with OpenCode by:
+ * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *
+ * @remarks
+ * Installation is idempotent -- running install multiple times on the same
+ * project produces the same result. Only AGENTS.md is managed; OpenCode's
+ * plugin system is handled separately by the hook provider.
+ */
+export class OpenCodeInstallProvider {
+    /**
+     * Install CLEO into an OpenCode 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();
+        let instructionFileUpdated = false;
+        const details = {};
+        // Step 1: Ensure AGENTS.md has @-references
+        instructionFileUpdated = this.updateInstructionFile(projectDir);
+        if (instructionFileUpdated) {
+            details.instructionFile = join(projectDir, 'AGENTS.md');
+        }
+        return {
+            success: true,
+            installedAt,
+            instructionFileUpdated,
+            details,
+        };
+    }
+    /**
+     * Uninstall CLEO from the current OpenCode 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 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
+            }
+        }
+        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);
+    }
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @returns true if the file was created or modified
+     */
+    updateInstructionFile(projectDir) {
+        const agentsMdPath = join(projectDir, 'AGENTS.md');
+        let content = '';
+        let existed = false;
+        if (existsSync(agentsMdPath)) {
+            content = readFileSync(agentsMdPath, '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 AGENTS.md with references
+            content = refsBlock + '\n';
+        }
+        writeFileSync(agentsMdPath, content, 'utf-8');
+        return true;
+    }
+}
+//# sourceMappingURL=install.js.map

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

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

package/dist/providers/opencode/spawn.js

@@ -0,0 +1,241 @@
+/**
+ * OpenCode Spawn Provider
+ *
+ * Implements AdapterSpawnProvider for OpenCode CLI.
+ * Migrated from src/core/spawn/adapters/opencode-adapter.ts
+ *
+ * Uses `opencode run --agent ... --format json` to spawn subagent
+ * processes. Processes run detached and are tracked by PID for
+ * listing and termination.
+ *
+ * @task T5240
+ */
+import { exec, spawn as nodeSpawn } from 'node:child_process';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+/** Name used for the CLEO subagent definition in OpenCode's agent directory. */
+const OPENCODE_SUBAGENT_NAME = 'cleo-subagent';
+/** Fallback agent name when custom agent definition cannot be created. */
+const OPENCODE_FALLBACK_AGENT = 'general';
+/**
+ * Build the markdown content for an OpenCode agent definition file.
+ *
+ * OpenCode agents are defined as markdown files with YAML frontmatter
+ * in the .opencode/agent/ directory.
+ *
+ * @remarks
+ * The generated markdown uses YAML frontmatter with `mode: subagent`
+ * and `hidden: true` so the agent does not appear in OpenCode's
+ * interactive agent selection menu.
+ *
+ * @param description - Agent description for frontmatter
+ * @param instructions - Markdown instructions body
+ * @returns Complete agent definition markdown with YAML frontmatter
+ *
+ * @example
+ * ```typescript
+ * import { buildOpenCodeAgentMarkdown } from '@cleocode/adapters/providers/opencode/spawn';
+ *
+ * const md = buildOpenCodeAgentMarkdown(
+ *   'CLEO task executor',
+ *   '# Subagent\n\nExecute the delegated task.',
+ * );
+ * ```
+ */
+export function buildOpenCodeAgentMarkdown(description, instructions) {
+    const normalizedDesc = description.replace(/\s+/g, ' ').trim();
+    return [
+        '---',
+        `description: ${JSON.stringify(normalizedDesc)}`,
+        'mode: subagent',
+        'hidden: true',
+        '---',
+        '',
+        instructions.trim(),
+        '',
+    ].join('\n');
+}
+/**
+ * Ensure the CLEO subagent definition exists in the project's
+ * .opencode/agent/ directory.
+ *
+ * Creates or updates the agent definition file if the content has changed.
+ *
+ * @param workingDirectory - Project root directory
+ * @returns The agent name to use for spawning
+ */
+async function ensureSubagentDefinition(workingDirectory) {
+    const agentDir = join(workingDirectory, '.opencode', 'agent');
+    const agentPath = join(agentDir, `${OPENCODE_SUBAGENT_NAME}.md`);
+    const description = 'CLEO task executor with protocol compliance.';
+    const instructions = [
+        '# CLEO Subagent',
+        '',
+        'You are a CLEO subagent executing a delegated task.',
+        'Follow the CLEO protocol and complete the assigned work.',
+        '',
+        '@~/.cleo/templates/CLEO-INJECTION.md',
+    ].join('\n');
+    const content = buildOpenCodeAgentMarkdown(description, instructions);
+    await mkdir(agentDir, { recursive: true });
+    let existing = null;
+    try {
+        existing = await readFile(agentPath, 'utf-8');
+    }
+    catch {
+        existing = null;
+    }
+    if (existing !== content) {
+        await writeFile(agentPath, content, 'utf-8');
+    }
+    return OPENCODE_SUBAGENT_NAME;
+}
+/**
+ * Spawn provider for OpenCode.
+ *
+ * Spawns detached OpenCode CLI processes for subagent execution.
+ * Each spawn ensures a CLEO subagent definition exists, then runs
+ * `opencode run --format json --agent <name> --title <title> <prompt>`
+ * as a detached, unref'd child process.
+ *
+ * @remarks
+ * Before spawning, the provider ensures a `cleo-subagent` agent definition
+ * exists in `.opencode/agent/`. If the definition cannot be created, it
+ * falls back to the built-in `general` agent. Processes are tracked by
+ * instance ID in an in-memory map and verified via `kill(pid, 0)` liveness
+ * checks.
+ */
+export class OpenCodeSpawnProvider {
+    /** Map of instance IDs to tracked process info. */
+    processMap = new Map();
+    /**
+     * Check if the OpenCode CLI is available in PATH.
+     *
+     * @returns true if `opencode` is found via `which`
+     */
+    async canSpawn() {
+        try {
+            await execAsync('which opencode');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Spawn a subagent via OpenCode CLI.
+     *
+     * Ensures the CLEO subagent definition exists in the project's
+     * .opencode/agent/ directory, then spawns a detached OpenCode
+     * 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 = `opencode-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+        const startTime = new Date().toISOString();
+        const workingDirectory = context.workingDirectory ?? process.cwd();
+        try {
+            let agentName;
+            try {
+                agentName = await ensureSubagentDefinition(workingDirectory);
+            }
+            catch {
+                agentName = OPENCODE_FALLBACK_AGENT;
+            }
+            const child = nodeSpawn('opencode', [
+                'run',
+                '--format',
+                'json',
+                '--agent',
+                agentName,
+                '--title',
+                `CLEO ${context.taskId}`,
+                context.prompt,
+            ], {
+                cwd: workingDirectory,
+                detached: true,
+                stdio: 'ignore',
+            });
+            child.unref();
+            if (child.pid) {
+                this.processMap.set(instanceId, {
+                    pid: child.pid,
+                    taskId: context.taskId,
+                    startTime,
+                });
+            }
+            child.on('exit', () => {
+                this.processMap.delete(instanceId);
+            });
+            return {
+                instanceId,
+                taskId: context.taskId,
+                providerId: 'opencode',
+                status: 'running',
+                startTime,
+            };
+        }
+        catch {
+            return {
+                instanceId,
+                taskId: context.taskId,
+                providerId: 'opencode',
+                status: 'failed',
+                startTime,
+                endTime: new Date().toISOString(),
+            };
+        }
+    }
+    /**
+     * List currently running OpenCode 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: 'opencode',
+                    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/opencode/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/providers/opencode/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,gFAAgF;AAChF,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAE/C,0EAA0E;AAC1E,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAS1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,YAAoB;IAClF,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,OAAO;QACL,KAAK;QACL,gBAAgB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE;QAChD,gBAAgB;QAChB,cAAc;QACd,KAAK;QACL,EAAE;QACF,YAAY,CAAC,IAAI,EAAE;QACnB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,wBAAwB,CAAC,gBAAwB;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,sBAAsB,KAAK,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,8CAA8C,CAAC;IACnE,MAAM,YAAY,GAAG;QACnB,iBAAiB;QACjB,EAAE;QACF,qDAAqD;QACrD,0DAA0D;QAC1D,EAAE;QACF,sCAAsC;KACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,OAAO,GAAG,0BAA0B,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEtE,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,qBAAqB;IAChC,mDAAmD;IAC3C,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEvD;;;;OAIG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,MAAM,UAAU,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC1F,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAEnE,IAAI,CAAC;YACH,IAAI,SAAiB,CAAC;YACtB,IAAI,CAAC;gBACH,SAAS,GAAG,MAAM,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,GAAG,uBAAuB,CAAC;YACtC,CAAC;YAED,MAAM,KAAK,GAAG,SAAS,CACrB,UAAU,EACV;gBACE,KAAK;gBACL,UAAU;gBACV,MAAM;gBACN,SAAS;gBACT,SAAS;gBACT,SAAS;gBACT,QAAQ,OAAO,CAAC,MAAM,EAAE;gBACxB,OAAO,CAAC,MAAM;aACf,EACD;gBACE,GAAG,EAAE,gBAAgB;gBACrB,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,QAAQ;aAChB,CACF,CAAC;YAEF,KAAK,CAAC,KAAK,EAAE,CAAC;YAEd,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACd,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE;oBAC9B,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;YAED,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBACpB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,UAAU;gBACV,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,UAAU;gBACtB,MAAM,EAAE,SAAS;gBACjB,SAAS;aACV,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,UAAU;gBACV,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,UAAU;gBACtB,MAAM,EAAE,QAAQ;gBAChB,SAAS;gBACT,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAClC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC;oBACX,UAAU;oBACV,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,UAAU,EAAE,UAAU;oBACtB,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CAAC,UAAkB;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;CACF"}

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

@@ -0,0 +1,102 @@
+/**
+ * Pi Adapter
+ *
+ * Main CLEOProviderAdapter implementation for the Pi coding agent
+ * (https://github.com/badlogic/pi-mono). Pi is CAAMP's first-class primary
+ * harness and owns skills, instructions, extensions, and subagent spawning
+ * through native filesystem conventions.
+ *
+ * Pi supports 11 of 16 CAAMP canonical events through its TypeScript extension
+ * system (session_start, session_shutdown, input, turn_end, tool_call,
+ * tool_result, before_agent_start, agent_end, before_provider_request, context).
+ *
+ * Detection: PI_CLI_PATH env var, PI_CODING_AGENT_DIR env var, PI_HOME env var,
+ * or presence of ~/.pi/agent/ directory.
+ *
+ * @task T553
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { PiHookProvider } from './hooks.js';
+import { PiInstallProvider } from './install.js';
+import { PiSpawnProvider } from './spawn.js';
+/**
+ * CLEO provider adapter for Pi coding agent.
+ *
+ * Bridges CLEO's adapter system with Pi's native capabilities:
+ * - Hooks: Maps Pi events (session_start, tool_call, etc.) to CAAMP events
+ * - Spawn: Launches subagent processes via the `pi` CLI
+ * - Install: Manages AGENTS.md instruction files and global Pi state root
+ *
+ * @remarks
+ * Pi is CAAMP's first-class primary harness (ADR-035). It supports 11 of 16
+ * canonical hook events through its TypeScript extension system. Extensions
+ * live at `~/.pi/agent/extensions/` (global) or `<projectDir>/.pi/extensions/`
+ * (project scope).
+ *
+ * The session_shutdown event handler in `cleo-cant-bridge.ts` clears module
+ * cache. The adapter's hook mapping ensures that Pi's session lifecycle events
+ * are visible in the CAAMP event stream for downstream listeners (e.g. memory
+ * refresh triggers, backup triggers).
+ *
+ * Detection hierarchy (first match wins):
+ * 1. `PI_CLI_PATH` env var set
+ * 2. `PI_CODING_AGENT_DIR` env var set
+ * 3. `PI_HOME` env var set
+ * 4. `~/.pi/agent/` directory exists
+ * 5. `pi` CLI available in PATH
+ */
+export declare class PiAdapter implements CLEOProviderAdapter {
+    /** Unique provider identifier. */
+    readonly id = "pi";
+    /** Human-readable provider name. */
+    readonly name = "Pi";
+    /** Adapter version string. */
+    readonly version = "1.0.0";
+    /** Declared capabilities for this provider. */
+    capabilities: AdapterCapabilities;
+    /** Hook provider for CAAMP event mapping and registration. */
+    hooks: PiHookProvider;
+    /** Spawn provider for launching subagent processes via `pi` CLI. */
+    spawn: PiSpawnProvider;
+    /** Install provider for managing AGENTS.md instruction files. */
+    install: PiInstallProvider;
+    /** 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 Pi CLI and Pi state root.
+     *
+     * @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 Pi is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Pi CLI is available (via PI_CLI_PATH or `which pi`)
+     * 3. Pi global state root (~/.pi/agent/ or PI_CODING_AGENT_DIR) 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/pi/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAwB7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,SAAU,YAAW,mBAAmB;IACnD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,QAAQ;IACnB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,QAAQ;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA0B/B;IAEF,8DAA8D;IAC9D,KAAK,EAAE,cAAc,CAAC;IACtB,oEAAoE;IACpE,KAAK,EAAE,eAAe,CAAC;IACvB,iEAAiE;IACjE,OAAO,EAAE,iBAAiB,CAAC;IAE3B,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAQ5B;;;;;;OAMG;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;IAwDjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}