@cleocode/adapters 2026.4.11 → 2026.4.13

package/dist/providers/opencode/spawn.js

@@ -1,241 +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) {
-    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

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

@@ -1,58 +0,0 @@
-/**
- * Shared transcript-reading utility for provider hook adapters.
- *
- * Several providers (Gemini CLI, Codex CLI) store session data in a
- * flat directory of JSON/JSONL files using the same role/content schema.
- * This module centralises the "find most-recent file, parse turns"
- * logic to avoid duplicating it in each hook provider.
- *
- * Usage:
- * ```ts
- * import { readLatestTranscript } from '../shared/transcript-reader.js';
- *
- * async getTranscript(_sessionId: string, _projectDir: string) {
- *   return readLatestTranscript(join(homedir(), '.gemini'));
- * }
- * ```
- *
- * @task T161
- * @epic T134
- */
-/**
- * Read the most recent JSON or JSONL session file from `providerDir` and
- * return its contents as a flat transcript string.
- *
- * Files are sorted in descending order by filename — this works naturally
- * for providers that embed timestamps in filenames. The most recently named
- * file is read first.
- *
- * Returns `null` when:
- * - `providerDir` does not exist or cannot be read
- * - No JSON/JSONL files are present
- * - The most recent file contains no parseable turns
- *
- * @remarks
- * This utility is shared by Gemini CLI and Codex CLI hook providers which
- * both store session data in the same flat JSON/JSONL format. Only the
- * most recent file is read to keep memory usage bounded.
- *
- * @param providerDir - Absolute path to the provider's session directory
- *   (e.g. `~/.gemini` or `~/.codex`).
- * @returns A plain-text transcript with lines of the form `role: content`,
- *   or `null` if no transcript could be extracted.
- *
- * @example
- * ```typescript
- * import { readLatestTranscript } from '../shared/transcript-reader.js';
- *
- * const transcript = await readLatestTranscript('/home/user/.gemini');
- * if (transcript) {
- *   console.log(transcript);
- * }
- * ```
- *
- * @task T161
- * @epic T134
- */
-export declare function readLatestTranscript(providerDir: string): Promise<string | null>;
-//# sourceMappingURL=transcript-reader.d.ts.map

package/dist/providers/shared/transcript-reader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transcript-reader.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/transcript-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAoDH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8BtF"}

package/dist/providers/shared/transcript-reader.js

@@ -1,124 +0,0 @@
-/**
- * Shared transcript-reading utility for provider hook adapters.
- *
- * Several providers (Gemini CLI, Codex CLI) store session data in a
- * flat directory of JSON/JSONL files using the same role/content schema.
- * This module centralises the "find most-recent file, parse turns"
- * logic to avoid duplicating it in each hook provider.
- *
- * Usage:
- * ```ts
- * import { readLatestTranscript } from '../shared/transcript-reader.js';
- *
- * async getTranscript(_sessionId: string, _projectDir: string) {
- *   return readLatestTranscript(join(homedir(), '.gemini'));
- * }
- * ```
- *
- * @task T161
- * @epic T134
- */
-import { readdir, readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Parse a raw JSONL or JSON session file into an array of transcript turns.
- *
- * Lines that are not valid JSON, or that lack a string `role` and string
- * `content`, are silently skipped.
- *
- * @param raw - Raw file contents (UTF-8 string).
- * @returns Array of `{ role, content }` pairs, in file order.
- */
-function parseTranscriptLines(raw) {
-    const turns = [];
-    const lines = raw.split('\n').filter((l) => l.trim());
-    for (const line of lines) {
-        try {
-            const entry = JSON.parse(line);
-            const role = entry.role;
-            const content = entry.content;
-            if (typeof role === 'string' && typeof content === 'string') {
-                turns.push({ role, content });
-            }
-        }
-        catch {
-            // Skip malformed lines
-        }
-    }
-    return turns;
-}
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Read the most recent JSON or JSONL session file from `providerDir` and
- * return its contents as a flat transcript string.
- *
- * Files are sorted in descending order by filename — this works naturally
- * for providers that embed timestamps in filenames. The most recently named
- * file is read first.
- *
- * Returns `null` when:
- * - `providerDir` does not exist or cannot be read
- * - No JSON/JSONL files are present
- * - The most recent file contains no parseable turns
- *
- * @remarks
- * This utility is shared by Gemini CLI and Codex CLI hook providers which
- * both store session data in the same flat JSON/JSONL format. Only the
- * most recent file is read to keep memory usage bounded.
- *
- * @param providerDir - Absolute path to the provider's session directory
- *   (e.g. `~/.gemini` or `~/.codex`).
- * @returns A plain-text transcript with lines of the form `role: content`,
- *   or `null` if no transcript could be extracted.
- *
- * @example
- * ```typescript
- * import { readLatestTranscript } from '../shared/transcript-reader.js';
- *
- * const transcript = await readLatestTranscript('/home/user/.gemini');
- * if (transcript) {
- *   console.log(transcript);
- * }
- * ```
- *
- * @task T161
- * @epic T134
- */
-export async function readLatestTranscript(providerDir) {
-    let allFiles = [];
-    try {
-        const entries = await readdir(providerDir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isFile())
-                continue;
-            const name = entry.name;
-            if (name.endsWith('.json') || name.endsWith('.jsonl')) {
-                allFiles.push(join(providerDir, name));
-            }
-        }
-    }
-    catch {
-        return null;
-    }
-    if (allFiles.length === 0)
-        return null;
-    // Sort descending — timestamps in filenames sort naturally
-    allFiles = allFiles.sort((a, b) => b.localeCompare(a));
-    const mostRecent = allFiles[0];
-    if (!mostRecent)
-        return null;
-    try {
-        const raw = await readFile(mostRecent, 'utf-8');
-        const turns = parseTranscriptLines(raw);
-        return turns.length > 0 ? turns.map((t) => `${t.role}: ${t.content}`).join('\n') : null;
-    }
-    catch {
-        return null;
-    }
-}
-//# sourceMappingURL=transcript-reader.js.map

package/dist/providers/shared/transcript-reader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transcript-reader.js","sourceRoot":"","sources":["../../../src/providers/shared/transcript-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYjC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;YAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,IAAI,QAAQ,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,SAAS;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,2DAA2D;IAC3D,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/registry.d.ts

@@ -1,88 +0,0 @@
-/**
- * Adapter registry — discovers and provides access to provider manifests.
- *
- * Scans the providers/ directory for manifest.json files and returns
- * the discovered adapter manifests for use by AdapterManager.
- *
- * @task T5240
- */
-/**
- * Minimal manifest shape for provider discovery.
- *
- * @remarks
- * Each provider adapter ships a `manifest.json` in its directory under
- * `providers/`. The registry reads these at startup to populate the
- * adapter discovery surface. The shape is intentionally minimal -- only
- * the fields needed for dynamic loading and detection are required.
- */
-export interface AdapterManifest {
-    /** Unique provider identifier (e.g. "claude-code", "cursor"). */
-    id: string;
-    /** Human-readable display name for the provider. */
-    name: string;
-    /** Semantic version of the adapter. */
-    version: string;
-    /** Short description of what the provider integrates with. */
-    description: string;
-    /** Provider slug used for directory lookups. */
-    provider: string;
-    /** Relative path to the adapter's entry point module. */
-    entryPoint: string;
-    /** Capability flags declared by the adapter. */
-    capabilities: Record<string, unknown>;
-    /** Patterns used to auto-detect the provider in a project. */
-    detectionPatterns: Array<{
-        /** Detection strategy type (e.g. "file", "env"). */
-        type: string;
-        /** Glob or regex pattern to match. */
-        pattern: string;
-        /** Human-readable explanation of this detection rule. */
-        description: string;
-    }>;
-}
-/**
- * Get the manifests for all bundled provider adapters.
- *
- * @remarks
- * Scans the known provider directories for `manifest.json` files.
- * Providers whose manifests cannot be loaded (missing or malformed)
- * are silently skipped.
- *
- * @returns Array of adapter manifests for successfully loaded providers
- *
- * @example
- * ```typescript
- * import { getProviderManifests } from '@cleocode/adapters';
- *
- * const manifests = getProviderManifests();
- * for (const m of manifests) {
- *   console.log(`${m.id}: ${m.name} v${m.version}`);
- * }
- * ```
- */
-export declare function getProviderManifests(): AdapterManifest[];
-/**
- * Discover all available provider adapters.
- *
- * Returns a map of provider ID to adapter factory function.
- *
- * @remarks
- * Each factory lazily imports the provider module and constructs a new
- * adapter instance. This avoids loading all provider code upfront and
- * keeps startup fast.
- *
- * @returns Map of provider ID to async factory function that creates an adapter instance
- *
- * @example
- * ```typescript
- * import { discoverProviders } from '@cleocode/adapters';
- *
- * const providers = await discoverProviders();
- * const factory = providers.get('claude-code');
- * if (factory) {
- *   const adapter = await factory();
- * }
- * ```
- */
-export declare function discoverProviders(): Promise<Map<string, () => Promise<unknown>>>;
-//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,8DAA8D;IAC9D,iBAAiB,EAAE,KAAK,CAAC;QACvB,oDAAoD;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,sCAAsC;QACtC,OAAO,EAAE,MAAM,CAAC;QAChB,yDAAyD;QACzD,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAKD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAexD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAmBtF"}

package/dist/registry.js

@@ -1,88 +0,0 @@
-/**
- * Adapter registry — discovers and provides access to provider manifests.
- *
- * Scans the providers/ directory for manifest.json files and returns
- * the discovered adapter manifests for use by AdapterManager.
- *
- * @task T5240
- */
-import { readFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-/** Known provider IDs bundled with @cleocode/adapters. */
-const PROVIDER_IDS = ['claude-code', 'opencode', 'cursor'];
-/**
- * Get the manifests for all bundled provider adapters.
- *
- * @remarks
- * Scans the known provider directories for `manifest.json` files.
- * Providers whose manifests cannot be loaded (missing or malformed)
- * are silently skipped.
- *
- * @returns Array of adapter manifests for successfully loaded providers
- *
- * @example
- * ```typescript
- * import { getProviderManifests } from '@cleocode/adapters';
- *
- * const manifests = getProviderManifests();
- * for (const m of manifests) {
- *   console.log(`${m.id}: ${m.name} v${m.version}`);
- * }
- * ```
- */
-export function getProviderManifests() {
-    const manifests = [];
-    const baseDir = resolve(dirname(fileURLToPath(import.meta.url)), 'providers');
-    for (const providerId of PROVIDER_IDS) {
-        try {
-            const manifestPath = join(baseDir, providerId, 'manifest.json');
-            const raw = readFileSync(manifestPath, 'utf-8');
-            manifests.push(JSON.parse(raw));
-        }
-        catch {
-            // Skip providers whose manifests cannot be loaded
-        }
-    }
-    return manifests;
-}
-/**
- * Discover all available provider adapters.
- *
- * Returns a map of provider ID to adapter factory function.
- *
- * @remarks
- * Each factory lazily imports the provider module and constructs a new
- * adapter instance. This avoids loading all provider code upfront and
- * keeps startup fast.
- *
- * @returns Map of provider ID to async factory function that creates an adapter instance
- *
- * @example
- * ```typescript
- * import { discoverProviders } from '@cleocode/adapters';
- *
- * const providers = await discoverProviders();
- * const factory = providers.get('claude-code');
- * if (factory) {
- *   const adapter = await factory();
- * }
- * ```
- */
-export async function discoverProviders() {
-    const providers = new Map();
-    providers.set('claude-code', async () => {
-        const { ClaudeCodeAdapter } = await import('./providers/claude-code/index.js');
-        return new ClaudeCodeAdapter();
-    });
-    providers.set('opencode', async () => {
-        const { OpenCodeAdapter } = await import('./providers/opencode/index.js');
-        return new OpenCodeAdapter();
-    });
-    providers.set('cursor', async () => {
-        const { CursorAdapter } = await import('./providers/cursor/index.js');
-        return new CursorAdapter();
-    });
-    return providers;
-}
-//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqCzC,0DAA0D;AAC1D,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAE9E,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;YAChE,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAChD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE5D,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;QAC/E,OAAO,IAAI,iBAAiB,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;QAC1E,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QACjC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;QACtE,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC"}