@a5c-ai/adapters-codecs 5.1.1-staging.52898ebfc24f

package/dist/babysitter-adapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * BabysitterAdapter — Babysitter orchestration harness adapter.
+ *
+ * Spawns the `agent-platform` CLI (`invoke` / `call`) and
+ * parses its JSONL output into normalized AgentEvent streams.
+ */
+import type { AgentCapabilities, ModelCapabilities, AgentConfigSchema, AuthState, AuthSetupGuidance, Session, SpawnArgs, ParseContext, RunOptions, AgentEvent, AgentConfig } from '@a5c-ai/comm-adapter';
+import { BaseAgentAdapter } from './base-adapter.js';
+export declare class BabysitterAdapter extends BaseAgentAdapter {
+    readonly agent: string;
+    readonly displayName = "Babysitter";
+    readonly cliCommand: string;
+    readonly minVersion = "0.1.0";
+    constructor(agent?: string, cliCommand?: string);
+    readonly hostEnvSignals: readonly ["BABYSITTER_SESSION_ID", "AGENT_SESSION_ID"];
+    readonly capabilities: AgentCapabilities;
+    readonly models: ModelCapabilities[];
+    readonly defaultModelId: undefined;
+    readonly configSchema: AgentConfigSchema;
+    buildSpawnArgs(options: RunOptions): SpawnArgs;
+    parseEvent(line: string, context: ParseContext): AgentEvent | AgentEvent[] | null;
+    detectAuth(): Promise<AuthState>;
+    getAuthGuidance(): AuthSetupGuidance;
+    sessionDir(cwd?: string): string;
+    parseSessionFile(filePath: string): Promise<Session>;
+    listSessionFiles(cwd?: string): Promise<string[]>;
+    readConfig(_cwd?: string): Promise<AgentConfig>;
+    writeConfig(config: Partial<AgentConfig>, _cwd?: string): Promise<void>;
+}

package/dist/babysitter-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"babysitter-adapter.d.ts","sourceRoot":"","sources":["../src/babysitter-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,gBAAgB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,WAAW;gBAElB,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAK/C,QAAQ,CAAC,cAAc,yDAA0D;IAEjF,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAwDtC;IAIF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAM;IAE1C,QAAQ,CAAC,cAAc,YAAa;IAEpC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAUtC;IAEF,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS;IAsD9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IAmI3E,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IActC,eAAe,IAAI,iBAAiB;IAcpC,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAI1B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBpD,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBjD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/C,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9E"}

package/dist/babysitter-adapter.js

@@ -0,0 +1,335 @@
+/**
+ * BabysitterAdapter — Babysitter orchestration harness adapter.
+ *
+ * Spawns the `agent-platform` CLI (`invoke` / `call`) and
+ * parses its JSONL output into normalized AgentEvent streams.
+ */
+import * as path from 'node:path';
+import { existsSync } from 'node:fs';
+import * as fs from 'node:fs/promises';
+import { BaseAgentAdapter } from './base-adapter.js';
+export class BabysitterAdapter extends BaseAgentAdapter {
+    agent;
+    displayName = 'Babysitter';
+    cliCommand;
+    minVersion = '0.1.0';
+    constructor(agent, cliCommand) {
+        super();
+        this.agent = agent ?? 'babysitter';
+        this.cliCommand = cliCommand ?? 'agent-platform';
+    }
+    hostEnvSignals = ['BABYSITTER_SESSION_ID', 'AGENT_SESSION_ID'];
+    capabilities = {
+        agent: 'babysitter',
+        canResume: true,
+        canFork: false,
+        supportsMultiTurn: true,
+        sessionPersistence: 'file',
+        supportsTextStreaming: true,
+        supportsToolCallStreaming: false,
+        supportsThinkingStreaming: false,
+        supportsNativeTools: false,
+        supportsMCP: true,
+        supportsParallelToolCalls: false,
+        requiresToolApproval: true,
+        approvalModes: ['yolo', 'prompt'],
+        runtimeHooks: {
+            preToolUse: 'unsupported',
+            postToolUse: 'unsupported',
+            sessionStart: 'unsupported',
+            sessionEnd: 'unsupported',
+            stop: 'unsupported',
+            userPromptSubmit: 'unsupported',
+        },
+        supportsThinking: false,
+        thinkingEffortLevels: [],
+        supportsThinkingBudgetTokens: false,
+        supportsJsonMode: true,
+        supportsStructuredOutput: false,
+        structuredSessionTransport: 'persistent',
+        sessionControlPlane: 'self-managed',
+        supportsSkills: true,
+        supportsAgentsMd: false,
+        skillsFormat: 'directory',
+        supportsSubagentDispatch: true,
+        supportsParallelExecution: true,
+        maxParallelTasks: 4,
+        supportsInteractiveMode: true,
+        supportsStdinInjection: true,
+        supportsImageInput: false,
+        supportsImageOutput: false,
+        supportsFileAttachments: false,
+        supportsPlugins: true,
+        pluginFormats: ['skill-directory'],
+        pluginInstallCmd: 'babysitter plugin:install',
+        pluginListCmd: 'babysitter plugin:list-installed',
+        pluginUninstallCmd: 'babysitter plugin:uninstall',
+        pluginRegistries: [],
+        supportedPlatforms: ['darwin', 'linux', 'win32'],
+        requiresGitRepo: false,
+        requiresPty: false,
+        authMethods: [
+            { type: 'api_key', name: 'CLI Presence', description: 'Babysitter delegates auth to the underlying harness' },
+        ],
+        authFiles: [],
+        installMethods: [
+            { platform: 'all', type: 'npm', command: 'npm install -g @a5c-ai/genty-platform' },
+        ],
+    };
+    // Babysitter delegates model selection to the underlying harness.
+    // Models are determined by the harness babysitter invokes, not babysitter itself.
+    models = [];
+    defaultModelId = undefined;
+    configSchema = {
+        agent: 'babysitter',
+        version: 1,
+        fields: [
+            { key: 'defaultHarness', label: 'Default harness', type: 'string', default: 'claude-code' },
+            { key: 'maxIterations', label: 'Max iterations', type: 'number', default: 256 },
+            { key: 'runsDir', label: 'Runs directory', type: 'string', default: '~/.a5c/runs' },
+        ],
+        configFormat: 'json',
+        supportsProjectConfig: true,
+    };
+    buildSpawnArgs(options) {
+        const args = [];
+        const harness = options.env?.['BABYSITTER_HARNESS'] || 'claude-code';
+        const prompt = this.normalizePrompt(options.prompt);
+        const sessionId = this.resolveSessionId(options);
+        if (options.maxTurns && options.maxTurns > 1) {
+            args.push('create-run');
+            args.push('--harness', harness);
+            args.push('--prompt', prompt);
+            if (options.maxTurns) {
+                args.push('--max-iterations', String(options.maxTurns));
+            }
+        }
+        else {
+            args.push('invoke', harness);
+            args.push('--prompt', prompt);
+        }
+        if (options.cwd) {
+            args.push('--workspace', options.cwd);
+        }
+        if (options.model) {
+            args.push('--model', options.model);
+        }
+        if (sessionId) {
+            args.push('--run-id', sessionId);
+        }
+        if (options.nonInteractive || options.approvalMode === 'yolo') {
+            args.push('--non-interactive');
+        }
+        args.push('--output-format', 'adapters-events');
+        const timeout = options.timeout || 120000;
+        return {
+            command: this.cliCommand,
+            args,
+            env: {
+                ...this.buildEnvFromOptions(options),
+                AGENT_SESSION_ID: sessionId || '',
+                BABYSITTER_MAX_ITERATIONS: String(options.maxTurns || 256),
+            },
+            cwd: options.cwd ?? process.cwd(),
+            usePty: false,
+            closeStdinAfterSpawn: true,
+            timeout,
+            inactivityTimeout: options.inactivityTimeout,
+        };
+    }
+    parseEvent(line, context) {
+        const parsed = this.parseJsonLine(line);
+        if (parsed == null || typeof parsed !== 'object') {
+            // Not JSON — treat as plaintext output
+            return context.outputFormat === 'text' ? this.parsePlaintextEvent(line, context) : null;
+        }
+        const obj = parsed;
+        const ts = Date.now();
+        const base = { runId: context.runId, agent: this.agent, timestamp: ts };
+        // babysitter outputs structured JSON with a 'type' field
+        // matching adapters event types when --output-format adapters-events is used
+        if (obj['type'] && obj['runId']) {
+            return obj;
+        }
+        const type = obj['type'];
+        // Session/run events
+        if (type === 'session_start' || type === 'run_started') {
+            return {
+                ...base,
+                type: 'session_start',
+                sessionId: String(obj['sessionId'] ?? obj['runId'] ?? context.sessionId ?? ''),
+                resumed: Boolean(context.sessionId),
+            };
+        }
+        // Text output
+        if (type === 'text_delta' || type === 'text' || type === 'message') {
+            const content = (obj['text'] ?? obj['delta'] ?? obj['content'] ?? '');
+            if (content) {
+                const accumulated = `${String(context.adapterState['__babysitterTextAccumulated'] ?? '')}${content}`;
+                context.adapterState['__babysitterTextAccumulated'] = accumulated;
+                return { ...base, type: 'text_delta', delta: content, accumulated };
+            }
+        }
+        // Tool call events
+        if (type === 'tool_call_start' || type === 'tool_use') {
+            return {
+                ...base,
+                type: 'tool_call_start',
+                toolCallId: String(obj['toolCallId'] ?? obj['id'] ?? ''),
+                toolName: String(obj['toolName'] ?? obj['name'] ?? ''),
+                inputAccumulated: JSON.stringify(obj['input'] ?? {}),
+            };
+        }
+        // Tool result events
+        if (type === 'tool_result') {
+            return {
+                ...base,
+                type: 'tool_result',
+                toolCallId: String(obj['toolCallId'] ?? obj['id'] ?? ''),
+                toolName: String(obj['toolName'] ?? obj['name'] ?? ''),
+                output: obj['output'] ?? '',
+                durationMs: 0,
+            };
+        }
+        // Error events
+        if (type === 'error') {
+            return {
+                ...base,
+                type: 'error',
+                code: 'INTERNAL',
+                message: (obj['message'] ?? obj['error'] ?? 'Unknown babysitter error'),
+                recoverable: false,
+            };
+        }
+        // Cost events
+        if (type === 'cost') {
+            const cost = this.assembleCostRecord(obj['cost'] ?? obj);
+            if (cost) {
+                return { ...base, type: 'cost', cost };
+            }
+        }
+        // Turn boundary events (iteration boundaries)
+        if (type === 'turn_start' || type === 'iteration_start') {
+            const nextTurnIndex = typeof context.adapterState['__babysitterTurnIndex'] === 'number'
+                ? context.adapterState['__babysitterTurnIndex'] + 1
+                : 0;
+            context.adapterState['__babysitterTurnIndex'] = nextTurnIndex;
+            return {
+                ...base,
+                type: 'turn_start',
+                turnIndex: nextTurnIndex,
+            };
+        }
+        if (type === 'turn_end' || type === 'iteration_end') {
+            return {
+                ...base,
+                type: 'turn_end',
+                turnIndex: typeof context.adapterState['__babysitterTurnIndex'] === 'number'
+                    ? context.adapterState['__babysitterTurnIndex']
+                    : 0,
+            };
+        }
+        // Legacy format: older babysitter harness invoke output
+        if (obj['status'] === 'completed') {
+            return {
+                ...base,
+                type: 'session_end',
+                sessionId: String(context.sessionId ?? context.runId),
+                turnCount: typeof context.adapterState['__babysitterTurnIndex'] === 'number'
+                    ? context.adapterState['__babysitterTurnIndex'] + 1
+                    : 0,
+            };
+        }
+        // Session end
+        if (type === 'session_end' || type === 'run_completed') {
+            return {
+                ...base,
+                type: 'session_end',
+                sessionId: String(obj['sessionId'] ?? context.sessionId ?? context.runId),
+                turnCount: typeof context.adapterState['__babysitterTurnIndex'] === 'number'
+                    ? context.adapterState['__babysitterTurnIndex'] + 1
+                    : 0,
+            };
+        }
+        return null;
+    }
+    async detectAuth() {
+        // Babysitter itself doesn't need auth — the underlying harness does.
+        // Check if babysitter CLI is available.
+        try {
+            const installation = await this.detectInstallation();
+            if (installation.installed) {
+                return { status: 'authenticated', method: 'api_key', identity: 'babysitter-cli' };
+            }
+        }
+        catch {
+            // fall through
+        }
+        return { status: 'unauthenticated' };
+    }
+    getAuthGuidance() {
+        return {
+            agent: 'babysitter',
+            providerName: 'Babysitter',
+            steps: [
+                { step: 1, description: 'Install babysitter agent CLI', command: 'npm i -g @a5c-ai/genty-platform' },
+                { step: 2, description: 'Configure the underlying harness auth (e.g., Claude, Codex)', command: 'agent-platform discover' },
+            ],
+            envVars: [],
+            documentationUrls: ['https://github.com/a5c-ai/babysitter'],
+            verifyCommand: 'agent-platform version',
+        };
+    }
+    sessionDir(cwd) {
+        return path.join(cwd || process.cwd(), '.a5c', 'runs');
+    }
+    async parseSessionFile(filePath) {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        const runJson = JSON.parse(raw);
+        return {
+            agent: 'babysitter',
+            sessionId: String(runJson['runId'] ?? ''),
+            title: typeof runJson['prompt'] === 'string'
+                ? runJson['prompt'].slice(0, 80) || 'Babysitter run'
+                : 'Babysitter run',
+            createdAt: typeof runJson['createdAt'] === 'string'
+                ? runJson['createdAt']
+                : new Date().toISOString(),
+            updatedAt: typeof runJson['createdAt'] === 'string'
+                ? runJson['createdAt']
+                : new Date().toISOString(),
+            turnCount: 0,
+            model: typeof runJson['model'] === 'string' ? runJson['model'] : undefined,
+            tags: runJson['processId'] ? [String(runJson['processId'])] : [],
+            cwd: path.dirname(path.dirname(filePath)),
+            messages: [],
+        };
+    }
+    async listSessionFiles(cwd) {
+        const runsDir = this.sessionDir(cwd);
+        if (!existsSync(runsDir))
+            return [];
+        try {
+            const entries = await fs.readdir(runsDir);
+            const results = [];
+            for (const entry of entries) {
+                const runJsonPath = path.join(runsDir, entry, 'run.json');
+                if (existsSync(runJsonPath)) {
+                    results.push(runJsonPath);
+                }
+            }
+            return results;
+        }
+        catch {
+            return [];
+        }
+    }
+    async readConfig(_cwd) {
+        return { agent: 'babysitter', source: 'global' };
+    }
+    async writeConfig(config, _cwd) {
+        // Babysitter config is managed by the babysitter CLI itself.
+        // No-op in the adapters adapter.
+    }
+}
+//# sourceMappingURL=babysitter-adapter.js.map

package/dist/babysitter-adapter.js.map

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

package/dist/base-adapter-helpers.d.ts

@@ -0,0 +1,7 @@
+import type { CostRecord, Spawner } from '@a5c-ai/comm-adapter';
+/**
+ * Default Spawner that runs the command via `child_process.spawn`, capturing
+ * stdout/stderr. `shell: false`, `windowsHide: true`.
+ */
+export declare const defaultSpawner: Spawner;
+export declare function assembleCostRecord(raw: unknown): CostRecord | null;

package/dist/base-adapter-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter-helpers.d.ts","sourceRoot":"","sources":["../src/base-adapter-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,OAiBzB,CAAC;AAEL,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CA2BlE"}

package/dist/base-adapter-helpers.js

@@ -0,0 +1,68 @@
+import { spawn } from 'node:child_process';
+/**
+ * Default Spawner that runs the command via `child_process.spawn`, capturing
+ * stdout/stderr. `shell: false`, `windowsHide: true`.
+ */
+export const defaultSpawner = (command, args, options) => new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: false,
+        windowsHide: true,
+        env: options?.env ? { ...process.env, ...options.env } : process.env,
+        cwd: options?.cwd,
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout?.setEncoding('utf8');
+    child.stderr?.setEncoding('utf8');
+    child.stdout?.on('data', (c) => { stdout += c; });
+    child.stderr?.on('data', (c) => { stderr += c; });
+    child.on('error', (err) => reject(err));
+    child.on('exit', (code) => resolve({ code: code ?? 1, stdout, stderr }));
+});
+export function assembleCostRecord(raw) {
+    if (raw == null || typeof raw !== 'object')
+        return null;
+    const obj = raw;
+    const totalUsd = extractNumber(obj, ['totalUsd', 'total_usd', 'cost', 'total_cost', 'totalCost']) ?? 0;
+    const inputTokens = extractNumber(obj, ['inputTokens', 'input_tokens', 'prompt_tokens']) ?? 0;
+    const outputTokens = extractNumber(obj, ['outputTokens', 'output_tokens', 'completion_tokens']) ?? 0;
+    const thinkingTokens = extractNumber(obj, ['thinkingTokens', 'thinking_tokens', 'reasoning_tokens']);
+    const cacheCreationTokens = extractNumber(obj, ['cacheCreationTokens', 'cache_creation_tokens', 'cache_write_tokens']);
+    const cacheReadTokens = extractNumber(obj, ['cacheReadTokens', 'cache_read_tokens', 'cache_read_input_tokens']);
+    const cachedTokens = extractNumber(obj, ['cachedTokens', 'cached_tokens']) ??
+        ((cacheCreationTokens != null && cacheReadTokens != null) ? cacheCreationTokens + cacheReadTokens : undefined);
+    if (totalUsd === 0 && inputTokens === 0 && outputTokens === 0)
+        return null;
+    const record = {
+        totalUsd,
+        inputTokens,
+        outputTokens,
+    };
+    if (thinkingTokens != null)
+        record.thinkingTokens = thinkingTokens;
+    if (cachedTokens != null)
+        record.cachedTokens = cachedTokens;
+    if (cacheCreationTokens != null)
+        record.cacheCreationTokens = cacheCreationTokens;
+    if (cacheReadTokens != null)
+        record.cacheReadTokens = cacheReadTokens;
+    return record;
+}
+function extractNumber(obj, keys) {
+    for (const key of keys) {
+        const val = obj[key];
+        if (typeof val === 'number' && Number.isFinite(val))
+            return val;
+        if (typeof val === 'object' && val !== null) {
+            const nested = val;
+            for (const nk of Object.keys(nested)) {
+                const nv = nested[nk];
+                if (typeof nv === 'number' && Number.isFinite(nv))
+                    return nv;
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=base-adapter-helpers.js.map

package/dist/base-adapter-helpers.js.map

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

package/dist/base-adapter.d.ts

@@ -0,0 +1,157 @@
+/**
+ * BaseAgentAdapter — abstract base class for agent adapters.
+ *
+ * Provides shared utilities and hook points with sensible defaults.
+ * All built-in adapters extend this class.
+ *
+ * @see 05-adapter-system.md §4
+ */
+import type { AgentName, CostRecord, RetryPolicy, AgentCapabilities, ModelCapabilities, AgentConfig, AgentConfigSchema, AuthState, AuthSetupGuidance, Session, InstalledPlugin, PluginInstallOptions, PluginSearchOptions, PluginListing, SpawnArgs, ParseContext, SubprocessAdapter, RunOptions, AgentEvent, DetectInstallationResult, InstallResult, AdapterInstallOptions, AdapterUpdateOptions, Spawner, InstallMethod } from '@a5c-ai/comm-adapter';
+import { StreamAssembler } from '@a5c-ai/comm-adapter';
+export { defaultSpawner } from './base-adapter-helpers.js';
+export declare function registerAdapterFactory(name: string, factory: () => SubprocessAdapter): void;
+export declare function getAdapterFactory(name: string): (() => SubprocessAdapter) | undefined;
+export declare function listRegisteredAdapters(): string[];
+export declare abstract class BaseAgentAdapter implements SubprocessAdapter {
+    readonly adapterType: "subprocess";
+    abstract readonly agent: AgentName;
+    abstract readonly displayName: string;
+    abstract readonly cliCommand: string;
+    abstract readonly minVersion?: string;
+    abstract readonly capabilities: AgentCapabilities;
+    abstract readonly models: ModelCapabilities[];
+    abstract readonly defaultModelId?: string;
+    abstract readonly configSchema: AgentConfigSchema;
+    abstract buildSpawnArgs(options: RunOptions): SpawnArgs;
+    abstract parseEvent(line: string, context: ParseContext): AgentEvent | AgentEvent[] | null;
+    abstract detectAuth(): Promise<AuthState>;
+    abstract getAuthGuidance(): AuthSetupGuidance;
+    abstract sessionDir(cwd?: string): string;
+    abstract parseSessionFile(filePath: string): Promise<Session>;
+    abstract listSessionFiles(cwd?: string): Promise<string[]>;
+    abstract readConfig(cwd?: string): Promise<AgentConfig>;
+    abstract writeConfig(config: Partial<AgentConfig>, cwd?: string): Promise<void>;
+    listPlugins?(): Promise<InstalledPlugin[]>;
+    installPlugin?(pluginId: string, options?: PluginInstallOptions): Promise<InstalledPlugin>;
+    uninstallPlugin?(pluginId: string): Promise<void>;
+    searchPlugins?(query: string, options?: PluginSearchOptions): Promise<PluginListing[]>;
+    protected readonly streamAssembler: StreamAssembler;
+    /** Subprocess runner used by install/update/detect. Swap for tests. */
+    protected _spawner: Spawner;
+    /** Replaces the internal Spawner (used by tests and CLI DI). */
+    setSpawner(spawner: Spawner): void;
+    protected normalizePrompt(prompt: string | string[]): string;
+    protected stripAnsi(text: string): string;
+    protected parsePlaintextEvent(line: string, context: ParseContext): AgentEvent | null;
+    protected buildPromptTransport(options: RunOptions): {
+        prompt: string;
+        stdin?: string;
+    };
+    /**
+     * Locates the harness binary and queries its `--version`. Default
+     * implementation uses `which`/`where` + `<cli> --version`.
+     */
+    detectInstallation(): Promise<DetectInstallationResult>;
+    /**
+     * Parses a `--version` output line. Default: first semver-like token.
+     * Override to accommodate bespoke version formats.
+     */
+    protected parseVersionOutput(raw: string): string | undefined;
+    protected resolveWindowsBinaryPath(binPath: string): string;
+    protected resolveVersionProbeCommand(binPath: string): {
+        command: string;
+        args: string[];
+    };
+    /**
+     * Picks an install method compatible with the current platform, runs it,
+     * then re-detects. Honors `force` and `dryRun`.
+     */
+    private _installContext;
+    install(opts?: AdapterInstallOptions): Promise<InstallResult>;
+    /** Runs the update/upgrade variant of the install command. */
+    update(opts?: AdapterUpdateOptions): Promise<InstallResult>;
+    /**
+     * Picks the first InstallMethod compatible with the current platform,
+     * preferring non-manual methods.
+     */
+    protected pickInstallMethod(): InstallMethod | undefined;
+    /**
+     * Replace `<pkg>` tail with `<pkg>@<version>` for npm-typed methods.
+     */
+    protected applyVersionToCommand(method: InstallMethod, version?: string): string;
+    /**
+     * Derives an update command from an install method.
+     */
+    protected deriveUpdateCommand(method: InstallMethod): string | null;
+    /**
+     * Attempts to parse a line as JSON. Returns the parsed value on success,
+     * or null if the line is not valid JSON. Does not throw.
+     */
+    protected parseJsonLine(line: string): unknown | null;
+    /**
+     * Normalizes a raw cost/usage object from agent output into the
+     * standard CostRecord type.
+     */
+    protected assembleCostRecord(raw: unknown): CostRecord | null;
+    /**
+     * Detects the installed CLI version. Returns null in the base implementation.
+     * Subclasses should override to run the agent's CLI with a version flag.
+     */
+    protected detectVersionFromCli(): Promise<string | null>;
+    /**
+     * Builds the environment variable record for the subprocess from RunOptions.
+     */
+    protected buildEnvFromOptions(options: RunOptions): Record<string, string>;
+    /**
+     * Resolves the session ID to use for this run.
+     */
+    protected resolveSessionId(options: RunOptions): string | undefined;
+    /**
+     * Called when the agent subprocess fails to spawn.
+     */
+    onSpawnError(error: Error): AgentEvent;
+    /**
+     * Called when the inactivity timeout fires.
+     */
+    onTimeout(): AgentEvent;
+    /**
+     * Called when the agent subprocess exits.
+     */
+    onProcessExit(exitCode: number, signal: string | null): AgentEvent[];
+    /**
+     * Determines whether a failed run should be retried.
+     */
+    shouldRetry(event: AgentEvent, attempt: number, policy: RetryPolicy): boolean;
+    /**
+     * Default hook installation: registers in .adapters/hooks.json only.
+     * Override in subclasses to also write native harness config (e.g.
+     * ~/.claude/settings.json) so the hook fires without adapters present.
+     */
+    installHook(hookType: string, command: string, opts?: {
+        scope?: 'global' | 'project';
+        id?: string;
+    }): Promise<void>;
+    /** Register a hook in the unified .adapters/hooks.json store. */
+    protected registerHookInConfig(hookType: string, command: string, opts?: {
+        scope?: 'global' | 'project';
+        id?: string;
+    }): Promise<void>;
+    /**
+     * Write the hook into the harness's native config. Default: append
+     * `{ command }` to `hooks[hookType]` in configFilePaths[0] if it is
+     * a .json file. Subclasses override to use harness-specific schema.
+     * Best-effort: failures are swallowed so SDK registration still succeeds.
+     */
+    protected writeNativeHook(hookType: string, command: string): Promise<void>;
+    uninstallHook(id: string, opts?: {
+        scope?: 'global' | 'project';
+    }): Promise<boolean>;
+    /**
+     * Append `{ command }` to `hooks[hookType]` in the given JSON file,
+     * preserving any existing hooks and creating the parent directory if
+     * needed. Used by adapters that expose a simple JSON-based native
+     * hook config (codex, gemini, copilot, cursor, opencode, pi, omp,
+     * openclaw, hermes).
+     */
+    protected appendJsonHook(settingsPath: string, hookType: string, entry: Record<string, unknown>): Promise<void>;
+}

package/dist/base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../src/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,YAAY,EAEZ,iBAAiB,EACjB,UAAU,EACV,UAAU,EAEV,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,OAAO,EACP,aAAa,EACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAIvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAe3D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,iBAAiB,CAAC,GAAG,SAAS,CAErF;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD;AAID,8BAAsB,gBAAiB,YAAW,iBAAiB;IAGjE,QAAQ,CAAC,WAAW,EAAG,YAAY,CAAU;IAG7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAElD,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS;IACvD,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IAC1F,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IACzC,QAAQ,CAAC,eAAe,IAAI,iBAAiB;IAC7C,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IACzC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAC7D,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,WAAW,CAAC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAC1C,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC1F,eAAe,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAItF,SAAS,CAAC,QAAQ,CAAC,eAAe,kBAAyB;IAI3D,uEAAuE;IACvE,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAkB;IAE7C,gEAAgE;IAChE,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM;IAI5D,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzC,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,IAAI;IAqErF,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAiBvF;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IA8C7D;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK7D,SAAS,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAgB3D,SAAS,CAAC,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IA4B1F;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYjB,OAAO,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAMvE,8DAA8D;IACxD,MAAM,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAMrE;;;OAGG;IACH,SAAS,CAAC,iBAAiB,IAAI,aAAa,GAAG,SAAS;IA2BxD;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAYhF;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI;IA+BnE;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAQrD;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI;IAI7D;;;OAGG;cACa,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9D;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IA0B1E;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;IASnE;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU;IAWtC;;OAEG;IACH,SAAS,IAAI,UAAU;IAYvB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,EAAE;IA6BpE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO;IAmB7E;;;;OAIG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GACvD,OAAO,CAAC,IAAI,CAAC;IAKhB,iEAAiE;cACjD,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GACvD,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;;OAKG;cACa,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3E,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;KAAO,GAC1C,OAAO,CAAC,OAAO,CAAC;IAMnB;;;;;;OAMG;cACa,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;CAsBjB"}