@cleocode/adapters 2026.4.59 → 2026.4.60

package/dist/providers/shared/conduit-trace-writer.js

@@ -1,65 +0,0 @@
-/**
- * Shared conduit trace writer for SDK-backed providers.
- *
- * Writes structured span events to conduit.db via the CLEO transport layer.
- * Both T581 (Claude SDK) and T582 (OpenAI SDK) use this module so the
- * conduit write path stays DRY.
- *
- * The writer is fire-and-forget: if conduit is unavailable, write failures are
- * silently swallowed so that missing tracing never breaks agent execution.
- *
- * @task T582
- */
-/**
- * Write a single span event to conduit via `cleo` CLI transport.
- *
- * Falls back gracefully when conduit is unavailable. All errors are caught
- * and returned in the result rather than thrown.
- *
- * @param event - The span event to persist.
- * @returns Result indicating whether the write succeeded.
- *
- * @remarks
- * The current implementation writes to conduit using the `cleo conduit send`
- * CLI command. This keeps the trace writer free of direct DB dependencies and
- * consistent with the no-direct-SQLite rule (ADR).
- *
- * When conduit grows a native TS API this writer can be updated without
- * changing caller code.
- */
-export async function writeSpanToConduit(event) {
-    try {
-        const { exec } = await import('node:child_process');
-        const { promisify } = await import('node:util');
-        const execAsync = promisify(exec);
-        const payload = JSON.stringify({
-            type: 'agent_span',
-            version: '1',
-            ...event,
-        });
-        // Use the CLEO conduit send command which handles DB access via the
-        // business logic layer (no direct SQLite per ADR-013 §9).
-        await execAsync(`cleo conduit send --type agent_span --payload ${JSON.stringify(payload)}`);
-        return { written: true };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { written: false, error: message };
-    }
-}
-/**
- * Write multiple span events to conduit, swallowing individual write failures.
- *
- * @param events - Array of span events to persist.
- * @returns Number of events successfully written.
- */
-export async function writeSpanBatchToConduit(events) {
-    let written = 0;
-    for (const event of events) {
-        const result = await writeSpanToConduit(event);
-        if (result.written)
-            written++;
-    }
-    return written;
-}
-//# sourceMappingURL=conduit-trace-writer.js.map

package/dist/providers/shared/conduit-trace-writer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"conduit-trace-writer.js","sourceRoot":"","sources":["../../../src/providers/shared/conduit-trace-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqCH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAuB;IAC9D,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAElC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,GAAG;YACZ,GAAG,KAAK;SACT,CAAC,CAAC;QAEH,oEAAoE;QACpE,0DAA0D;QAC1D,MAAM,SAAS,CAAC,iDAAiD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAA0B;IACtE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/providers/shared/sdk-result-mapper.js

@@ -1,54 +0,0 @@
-/**
- * Shared SDK result mapper for CLEO spawn providers.
- *
- * Normalises provider-specific run results (OpenAI Agents SDK, Claude Agent SDK)
- * into the canonical {@link SpawnResult} contract used by CLEO orchestration.
- *
- * Both T581 (Claude SDK) and T582 (OpenAI SDK) import from this module so the
- * mapping logic stays DRY.
- *
- * @task T582
- */
-/**
- * Map a raw SDK run outcome to the canonical CLEO {@link SpawnResult}.
- *
- * @param instanceId - Unique identifier for this spawn instance.
- * @param taskId - CLEO task ID associated with the run.
- * @param providerId - Identifier of the provider that performed the run (e.g. `'openai-sdk'`).
- * @param startTime - ISO timestamp captured just before the run was started.
- * @param outcome - Normalised run outcome from the SDK provider.
- * @returns A fully-populated {@link SpawnResult} ready for return from `spawn()`.
- *
- * @example
- * ```typescript
- * const result = mapSdkRunOutcome('openai-sdk-123', 'T582', 'openai-sdk', start, {
- *   finalOutput: 'Done',
- *   succeeded: true,
- * });
- * // result.status === 'completed'
- * ```
- */
-export function mapSdkRunOutcome(instanceId, taskId, providerId, startTime, outcome) {
-    const endTime = new Date().toISOString();
-    if (outcome.succeeded) {
-        return {
-            instanceId,
-            taskId,
-            providerId,
-            status: 'completed',
-            output: outcome.finalOutput,
-            startTime,
-            endTime,
-        };
-    }
-    return {
-        instanceId,
-        taskId,
-        providerId,
-        status: 'failed',
-        startTime,
-        endTime,
-        error: outcome.errorMessage ?? 'SDK run failed without a message',
-    };
-}
-//# sourceMappingURL=sdk-result-mapper.js.map

package/dist/providers/shared/sdk-result-mapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk-result-mapper.js","sourceRoot":"","sources":["../../../src/providers/shared/sdk-result-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuBH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,MAAc,EACd,UAAkB,EAClB,SAAiB,EACjB,OAAyB;IAEzB,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEzC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,UAAU;YACV,MAAM;YACN,UAAU;YACV,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,OAAO,CAAC,WAAW;YAC3B,SAAS;YACT,OAAO;SACR,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU;QACV,MAAM;QACN,UAAU;QACV,MAAM,EAAE,QAAQ;QAChB,SAAS;QACT,OAAO;QACP,KAAK,EAAE,OAAO,CAAC,YAAY,IAAI,kCAAkC;KAClE,CAAC;AACJ,CAAC"}

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.js

@@ -1,92 +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', 'pi'];
-/**
- * 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();
-    });
-    providers.set('pi', async () => {
-        const { PiAdapter } = await import('./providers/pi/index.js');
-        return new PiAdapter();
-    });
-    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,EAAE,IAAI,CAAU,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;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,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QAC7B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QAC9D,OAAO,IAAI,SAAS,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC"}