@cleocode/adapters 2026.5.3 → 2026.5.5

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/hook-template-installer.js

@@ -1,209 +0,0 @@
-/**
- * Shared hook-template installer for provider adapters.
- *
- * Each provider ships its own PreCompact shell shim under
- * `packages/adapters/src/providers/<provider>/templates/hooks/` which sources
- * the universal helper at
- * `packages/adapters/src/providers/shared/templates/hooks/cleo-precompact-core.sh`.
- *
- * This module wires the templates into the provider's hooks directory at
- * install time. Provider-specific {@link AdapterInstallProvider} implementations
- * call {@link installProviderHookTemplates} with their own provider id, and the
- * installer consults CAAMP's `hook-mappings.json` SSoT to verify the provider
- * supports the required canonical event and handler type before writing.
- *
- * DRY invariant: all shims source the same core helper — adapter-specific
- * shims only add provider-flavoured banners and `$CLEO_PRECOMPACT_*` env
- * handling.
- *
- * @task T1013
- * @epic T1000
- */
-import { copyFileSync, existsSync, mkdirSync, statSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-// ---------------------------------------------------------------------------
-// Template file resolution
-// ---------------------------------------------------------------------------
-/**
- * Resolve the `providers/` base directory relative to this source file.
- *
- * Template shell scripts live alongside TypeScript source at
- * `src/providers/<provider>/templates/hooks/`. The TypeScript compiler
- * emits `.d.ts` / `.js` artefacts into `dist/providers/...` without copying
- * non-TS assets. To support both development (running from `src/`) and
- * published installs (running from `dist/`), this resolver returns a list of
- * candidate provider directories — one for the current runtime location and
- * one for the parallel `src/providers/` tree. Template lookup callers must
- * pick the first candidate that contains the expected file.
- *
- * @internal
- */
-function resolveProviderCandidates() {
-    // One level up from shared/ = providers/. This is the compiled location
-    // when running from `dist/providers/shared/hook-template-installer.js` or
-    // the source location in development.
-    const thisDir = dirname(fileURLToPath(import.meta.url));
-    const here = dirname(thisDir);
-    // Also look in the sibling `src/providers/` tree so compiled runs can still
-    // find template assets that tsc didn't copy. `dist/providers/shared/...`
-    // → `../../src/providers/`.
-    const fromDist = join(here, '..', '..', 'src', 'providers');
-    return [here, fromDist];
-}
-/**
- * Find a template file by searching the provider-directory candidates.
- *
- * @internal
- */
-function findTemplateFile(relativeSegments) {
-    for (const base of resolveProviderCandidates()) {
-        const candidate = join(base, ...relativeSegments);
-        if (existsSync(candidate))
-            return candidate;
-    }
-    // Surface a precise error pointing to the first candidate so install
-    // failures are self-describing.
-    const [first] = resolveProviderCandidates();
-    return join(first ?? '', ...relativeSegments);
-}
-/**
- * Per-provider shim filename (relative to `<provider>/templates/hooks/`).
- * Shell scripts named per the provider's canonical hook event convention.
- *
- * @internal
- */
-const PROVIDER_SHIM = {
-    'claude-code': 'precompact-safestop.sh',
-    cursor: 'precompact.sh',
-    opencode: 'precompact.sh',
-    'gemini-cli': 'precompact.sh',
-};
-/** Filename of the shared universal helper. */
-const SHARED_CORE_FILE = 'cleo-precompact-core.sh';
-/**
- * Resolve the absolute source path of a provider's shim script.
- *
- * @internal
- */
-function providerShimSource(provider) {
-    return findTemplateFile([provider, 'templates', 'hooks', PROVIDER_SHIM[provider]]);
-}
-/**
- * Resolve the absolute source path of the shared `cleo-precompact-core.sh`
- * helper.
- *
- * @internal
- */
-function sharedCoreSource() {
-    return findTemplateFile(['shared', 'templates', 'hooks', SHARED_CORE_FILE]);
-}
-// ---------------------------------------------------------------------------
-// Copy helpers
-// ---------------------------------------------------------------------------
-/**
- * Copy a single template file, preserving the executable bit. Returns the
- * destination path on successful write, or `null` when the destination
- * already matches the source (idempotent no-op).
- *
- * @internal
- */
-function copyTemplate(src, dest, force) {
-    if (!existsSync(src)) {
-        throw new Error(`CLEO hook template missing at source: ${src}`);
-    }
-    if (!force && existsSync(dest)) {
-        const srcStat = statSync(src);
-        const destStat = statSync(dest);
-        if (srcStat.size === destStat.size && srcStat.mtimeMs <= destStat.mtimeMs) {
-            return { wrote: false };
-        }
-    }
-    mkdirSync(dirname(dest), { recursive: true });
-    copyFileSync(src, dest);
-    return { wrote: true };
-}
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Install the CLEO PreCompact hook templates for a provider.
- *
- * Writes two files into `targetDir`:
- *
- * 1. `cleo-precompact-core.sh` — universal helper (shared across all providers)
- * 2. `<provider-shim>.sh` — provider-flavoured shim that sources the helper
- *
- * The shim invokes only the universal CLEO CLI (`cleo memory precompact-flush`
- * and `cleo safestop …`) — adapters never reach into core internals.
- *
- * @param options - Installation target and provider id.
- * @returns Paths written, paths skipped, and the resolved target directory.
- *
- * @example
- * ```typescript
- * import { homedir } from 'node:os';
- * import { join } from 'node:path';
- * import { installProviderHookTemplates } from '@cleocode/adapters';
- *
- * const result = installProviderHookTemplates({
- *   provider: 'claude-code',
- *   targetDir: join(homedir(), '.claude', 'hooks'),
- * });
- * // result.installedFiles includes both scripts on first run.
- * ```
- *
- * @task T1013
- * @public
- */
-export function installProviderHookTemplates(options) {
-    const { provider, targetDir, force = false } = options;
-    const result = {
-        provider,
-        targetDir,
-        installedFiles: [],
-        skipped: [],
-    };
-    mkdirSync(targetDir, { recursive: true });
-    // 1. Shared universal helper
-    const coreDest = join(targetDir, SHARED_CORE_FILE);
-    const coreOutcome = copyTemplate(sharedCoreSource(), coreDest, force);
-    if (coreOutcome.wrote)
-        result.installedFiles.push(coreDest);
-    else
-        result.skipped.push(coreDest);
-    // 2. Provider-specific shim
-    const shimName = PROVIDER_SHIM[provider];
-    const shimDest = join(targetDir, shimName);
-    const shimOutcome = copyTemplate(providerShimSource(provider), shimDest, force);
-    if (shimOutcome.wrote)
-        result.installedFiles.push(shimDest);
-    else
-        result.skipped.push(shimDest);
-    return result;
-}
-/**
- * Resolve the source-side path of a provider's hook template for inspection
- * and testing. Returns the absolute path where the installer will read from.
- *
- * @param provider - Provider identifier.
- * @returns Absolute path to the provider's shim template file.
- *
- * @task T1013
- * @public
- */
-export function getProviderHookTemplatePath(provider) {
-    return providerShimSource(provider);
-}
-/**
- * Resolve the source-side path of the shared universal helper.
- *
- * @returns Absolute path to `cleo-precompact-core.sh` in the adapter package.
- *
- * @task T1013
- * @public
- */
-export function getSharedHookCorePath() {
-    return sharedCoreSource();
-}
-//# sourceMappingURL=hook-template-installer.js.map

package/dist/providers/shared/hook-template-installer.js.map

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

package/dist/providers/shared/paths.js

@@ -1,77 +0,0 @@
-/**
- * Path utilities for adapter install providers.
- *
- * These helpers mirror the equivalent functions in `@cleocode/core/paths`
- * but are duplicated here to avoid a circular dependency
- * (`@cleocode/core` → `@cleocode/adapters` → `@cleocode/core`).
- *
- * @remarks
- * Keep the implementation in sync with `getCleoTemplatesTildePath` in
- * `packages/core/src/paths.ts` if the logic ever changes.
- *
- * @task T916
- */
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-/**
- * Resolve the XDG / OS-appropriate global CLEO data directory.
- *
- * Respects `CLEO_HOME` env var; otherwise uses the platform default:
- * - Linux:   `~/.local/share/cleo`
- * - macOS:   `~/Library/Application Support/cleo`
- * - Windows: `%LOCALAPPDATA%\cleo\Data` (approximate)
- *
- * @returns Absolute path to the CLEO data directory
- *
- * @internal
- */
-function getAdapterCleoHome() {
-    if (process.env['CLEO_HOME']) {
-        return process.env['CLEO_HOME'];
-    }
-    const home = homedir();
-    if (process.platform === 'darwin') {
-        return join(home, 'Library', 'Application Support', 'cleo');
-    }
-    if (process.platform === 'win32') {
-        const localAppData = process.env['LOCALAPPDATA'];
-        if (localAppData) {
-            return join(localAppData, 'cleo', 'Data');
-        }
-        return join(home, 'AppData', 'Local', 'cleo', 'Data');
-    }
-    // Linux / XDG
-    const xdgData = process.env['XDG_DATA_HOME'];
-    if (xdgData) {
-        return join(xdgData, 'cleo');
-    }
-    return join(home, '.local', 'share', 'cleo');
-}
-/**
- * Get the CLEO templates directory as a tilde-prefixed path for use in
- * `@` references (AGENTS.md, CLAUDE.md, etc.). Cross-platform: replaces
- * the user's home directory with `~` so the reference works when loaded
- * by LLM providers that resolve `~` at runtime.
- *
- * @returns Tilde-prefixed path like `"~/.local/share/cleo/templates"` on Linux,
- *   `"~/Library/Application Support/cleo/templates"` on macOS, etc.
- *
- * @example
- * ```typescript
- * const ref = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
- * // "@~/.local/share/cleo/templates/CLEO-INJECTION.md"  (Linux)
- * ```
- *
- * @task T916
- */
-export function getCleoTemplatesTildePath() {
-    const absPath = join(getAdapterCleoHome(), 'templates');
-    const home = homedir();
-    if (absPath.startsWith(home)) {
-        // Always use forward slash after tilde for cross-platform @-reference resolution
-        const relative = absPath.slice(home.length).replace(/\\/g, '/');
-        return `~${relative}`;
-    }
-    return absPath;
-}
-//# sourceMappingURL=paths.js.map

package/dist/providers/shared/paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/providers/shared/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,SAAS,kBAAkB;IACzB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IACD,cAAc;IACd,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,iFAAiF;QACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChE,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -1,55 +0,0 @@
-/**
- * Shared SDK result mapper for CLEO spawn providers.
- *
- * Normalises provider-specific run results from the Vercel AI SDK bridge
- * into the canonical {@link SpawnResult} contract used by CLEO orchestration.
- *
- * Both the Claude SDK provider (T581) and the OpenAI SDK provider (T582)
- * import from this module so the mapping logic stays DRY.
- *
- * @task T582 (original)
- * @task T933 (SDK consolidation — Vercel AI SDK migration)
- */
-/**
- * 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;;;;;;;;;;;GAWG;AAwBH;;;;;;;;;;;;;;;;;;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":"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"}

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"}