@cleocode/adapters 2026.4.59 → 2026.4.62

package/dist/providers/opencode/install.js

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

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

package/dist/providers/opencode/spawn.js

@@ -1,256 +0,0 @@
-/**
- * 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, enrichedInstructions) {
-    const agentDir = join(workingDirectory, '.opencode', 'agent');
-    const agentPath = join(agentDir, `${OPENCODE_SUBAGENT_NAME}.md`);
-    const description = 'CLEO task executor with protocol compliance and CANT context.';
-    const instructions = enrichedInstructions ??
-        [
-            '# 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 {
-            // Enrich prompt with CANT bundle, memory bridge, and mental model (T555).
-            // Best-effort: if CANT context is unavailable, the raw prompt is used.
-            let enrichedInstructions;
-            try {
-                const { buildCantEnrichedPrompt } = await import('../../cant-context.js');
-                enrichedInstructions = await buildCantEnrichedPrompt({
-                    projectDir: workingDirectory,
-                    basePrompt: context.prompt,
-                    agentName: context.options?.agentName ?? undefined,
-                });
-            }
-            catch {
-                // CANT enrichment unavailable — use raw prompt
-            }
-            let agentName;
-            try {
-                agentName = await ensureSubagentDefinition(workingDirectory, enrichedInstructions);
-            }
-            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

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

package/dist/providers/pi/adapter.js

@@ -1,220 +0,0 @@
-/**
- * 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 { 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 { PiHookProvider } from './hooks.js';
-import { PiInstallProvider } from './install.js';
-import { PiSpawnProvider } from './spawn.js';
-const execAsync = promisify(exec);
-/**
- * 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');
-}
-/**
- * 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 class PiAdapter {
-    /** Unique provider identifier. */
-    id = 'pi';
-    /** Human-readable provider name. */
-    name = 'Pi';
-    /** Adapter version string. */
-    version = '1.0.0';
-    /** Declared capabilities for this provider. */
-    capabilities = {
-        supportsHooks: true,
-        // 11/16 canonical events — derived from piEventCatalog in CAAMP hook-mappings.json.
-        // ResponseComplete, PostToolUseFailure, PermissionRequest, PostModel, PostCompact,
-        // and ConfigChange are not supported by Pi's extension system.
-        supportedHookEvents: [
-            'SessionStart',
-            'SessionEnd',
-            'PromptSubmit',
-            'Notification',
-            'PreToolUse',
-            'PostToolUse',
-            'SubagentStart',
-            'SubagentStop',
-            'PreModel',
-            'PreCompact',
-        ],
-        supportsSpawn: true,
-        supportsInstall: true,
-        supportsInstructionFiles: true,
-        instructionFilePattern: 'AGENTS.md',
-        supportsContextMonitor: false,
-        supportsStatusline: false,
-        supportsProviderPaths: true,
-        supportsTransport: false,
-        supportsTaskSync: false,
-    };
-    /** Hook provider for CAAMP event mapping and registration. */
-    hooks;
-    /** Spawn provider for launching subagent processes via `pi` CLI. */
-    spawn;
-    /** Install provider for managing AGENTS.md instruction files. */
-    install;
-    /** Project directory this adapter was initialized with, or null. */
-    projectDir = null;
-    /** Whether {@link initialize} has been called. */
-    initialized = false;
-    constructor() {
-        this.hooks = new PiHookProvider();
-        this.spawn = new PiSpawnProvider();
-        this.install = new PiInstallProvider();
-    }
-    /**
-     * 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
-     */
-    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 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
-     */
-    async healthCheck() {
-        const details = {};
-        if (!this.initialized) {
-            return {
-                healthy: false,
-                provider: this.id,
-                details: { error: 'Adapter not initialized' },
-            };
-        }
-        // Check Pi CLI availability
-        let cliAvailable = false;
-        const cliPath = process.env['PI_CLI_PATH'] ?? 'pi';
-        try {
-            if (cliPath !== 'pi') {
-                const { stdout } = await execAsync(`test -x "${cliPath}" && echo ok`);
-                cliAvailable = stdout.trim() === 'ok';
-                details.cliPath = cliPath;
-            }
-            else {
-                const { stdout } = await execAsync('which pi');
-                cliAvailable = stdout.trim().length > 0;
-                details.cliPath = stdout.trim();
-            }
-        }
-        catch {
-            details.cliAvailable = false;
-        }
-        // Check for Pi global state root
-        const agentDir = getPiAgentDir();
-        const agentDirExists = existsSync(agentDir);
-        details.agentDirExists = agentDirExists;
-        details.agentDir = agentDir;
-        // Check for project-level .pi/ directory
-        if (this.projectDir) {
-            const projectPiDir = join(this.projectDir, '.pi');
-            details.projectPiDirExists = existsSync(projectPiDir);
-        }
-        // Check detection env vars
-        details.piCodingAgentDirSet = process.env['PI_CODING_AGENT_DIR'] !== undefined;
-        details.piHomeSet = process.env['PI_HOME'] !== undefined;
-        details.piCliPathSet = process.env['PI_CLI_PATH'] !== undefined;
-        // Healthy if either CLI is available or global state root exists
-        const healthy = cliAvailable || agentDirExists;
-        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/pi/adapter.js.map

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