@orcareplay/adapters 0.1.0

package/dist/registry.js

@@ -0,0 +1,82 @@
+import { claudeCodeAdapter } from './claude-code.js';
+import { codexAdapter } from './codex.js';
+import { genericOpenAiAdapter } from './generic-openai.js';
+import { grokAdapter } from './grok.js';
+import { openClawAdapter } from './openclaw.js';
+import { nodeAdapter } from './node.js';
+import { openCodeAdapter } from './opencode.js';
+export class AdapterRegistry {
+    #adapters = new Map();
+    /** Alias → canonical id. Kept apart from #adapters so `ids()` stays the canonical id space. */
+    #aliases = new Map();
+    register(adapter) {
+        const existing = this.#adapters.get(adapter.id);
+        if (existing && existing !== adapter) {
+            throw new Error(`adapter id '${adapter.id}' is already registered; two adapters cannot share an id — ` +
+                'rename one of them');
+        }
+        for (const alias of adapter.aliases ?? []) {
+            // An alias that shadows a real id, or one already claimed, would make `orca record <name>`
+            // silently launch a different harness than the name says. Fail at registration instead.
+            const clash = this.#adapters.get(alias) ?? this.#adapters.get(this.#aliases.get(alias) ?? '');
+            if (clash && clash !== adapter) {
+                throw new Error(`adapter '${adapter.id}' claims the alias '${alias}', which already resolves to ` +
+                    `'${clash.id}' — an alias cannot point at two harnesses`);
+            }
+            this.#aliases.set(alias, adapter.id);
+        }
+        this.#adapters.set(adapter.id, adapter);
+    }
+    get(id) {
+        const adapter = this.#adapters.get(id) ?? this.#adapters.get(this.#aliases.get(id) ?? '');
+        if (!adapter) {
+            throw new Error(`unknown adapter '${id}'. Known adapters: ${this.names().join(', ')}. ` +
+                "If your agent is not listed, run it under 'generic-openai' and pass the command after " +
+                '--, e.g. orca record generic-openai -- my-agent --task ...');
+        }
+        return adapter;
+    }
+    /** Canonical ids. This is the id space a manifest is written in. */
+    ids() {
+        return [...this.#adapters.keys()];
+    }
+    /**
+     * Everything a user may type, canonical ids with their aliases attached.
+     *
+     * Error messages and help text use this rather than `ids()`: someone who just typed `claude`
+     * needs to see that `claude` is spelled `claude`, not be shown a list that omits it.
+     */
+    names() {
+        return this.ids().map((id) => {
+            const aliases = [...this.#aliases.entries()]
+                .filter(([, target]) => target === id)
+                .map(([alias]) => alias);
+            return aliases.length === 0 ? id : `${id} (or ${aliases.join(', ')})`;
+        });
+    }
+    /** First adapter that claims the workspace. A detector that throws is treated as "no". */
+    async detect(cwd) {
+        for (const adapter of this.#adapters.values()) {
+            try {
+                if (await adapter.detect(cwd))
+                    return adapter;
+            }
+            catch {
+                continue;
+            }
+        }
+        return undefined;
+    }
+}
+export function defaultAdapters() {
+    const registry = new AdapterRegistry();
+    registry.register(claudeCodeAdapter);
+    registry.register(codexAdapter);
+    registry.register(openCodeAdapter);
+    registry.register(grokAdapter);
+    registry.register(openClawAdapter);
+    registry.register(nodeAdapter);
+    registry.register(genericOpenAiAdapter);
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Adapters are the growth loop: they are how OrcaReplay reaches harnesses its maintainers have
+ * never run. This returns file *contents* rather than writing them — the CLI owns the filesystem,
+ * and data comes back testable, so the generated code is held to the same contract as the shipped
+ * adapters instead of being hoped about.
+ */
+export interface ScaffoldFile {
+    /** Path relative to packages/adapters, where a contributor would add the file. */
+    path: string;
+    contents: string;
+}
+export interface ScaffoldResult {
+    files: ScaffoldFile[];
+}
+export interface ScaffoldOptions {
+    /** Binary that launches the harness. Defaults to the adapter id. */
+    command?: string;
+    /** Variable the harness reads for its API origin. One of MODEL_BASE_URL_VARS. */
+    baseUrlVar?: string;
+    /** Credential the harness reads. Defaults to the base-url variable's provider. */
+    apiKeyVar?: string;
+    /** Path appended to the proxy url — OpenAI SDK clients want the version segment, others do not. */
+    basePath?: string;
+}
+export declare function scaffoldAdapter(name: string, opts?: ScaffoldOptions): ScaffoldResult;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,cAAc,CA+BxF"}

package/dist/scaffold.js

@@ -0,0 +1,125 @@
+import { MODEL_BASE_URL_VARS } from './contract.js';
+export function scaffoldAdapter(name, opts = {}) {
+    const id = toId(name);
+    if (id === '') {
+        throw new Error(`adapter name '${name}' has no usable characters; ids are lowercase kebab-case, e.g. 'my-agent'`);
+    }
+    const baseUrlVar = opts.baseUrlVar ?? 'OPENAI_BASE_URL';
+    if (!MODEL_BASE_URL_VARS.includes(baseUrlVar)) {
+        throw new Error(`${baseUrlVar} is not a variable the proxy speaks. Use one of ${MODEL_BASE_URL_VARS.join(', ')} — the proxy serves the Anthropic and OpenAI wire protocols, and a harness-specific variable is something you add alongside one of these, never instead of it`);
+    }
+    const provider = baseUrlVar.split('_')[0] ?? 'OPENAI';
+    const command = opts.command ?? id;
+    const apiKeyVar = opts.apiKeyVar ?? `${provider}_API_KEY`;
+    const basePath = opts.basePath ?? (provider === 'OPENAI' ? 'v1' : '');
+    const constName = exportName(id);
+    return {
+        files: [
+            {
+                path: `src/${id}.ts`,
+                contents: adapterSource({ id, constName, command, baseUrlVar, apiKeyVar, basePath }),
+            },
+            {
+                path: `test/${id}.test.ts`,
+                contents: testSource({ id, constName, command, baseUrlVar, apiKeyVar, basePath }),
+            },
+        ],
+    };
+}
+function adapterSource(n) {
+    return `import type { Adapter, Launch, RecordContext } from '@orcareplay/plugin-api';
+import { hasBinary } from './detect.js';
+import { passKey, proxyBase } from './env.js';
+
+/**
+ * TODO: confirm that ${n.command} really reads ${n.baseUrlVar} for its API origin, then record
+ * what you verified in fixtures/harness/${n.id}.json. If the harness reads some other variable,
+ * this adapter captures nothing and every run still looks exactly like it worked.
+ */
+export const ${n.constName}: Adapter = {
+  id: '${n.id}',
+  // harnessVersions: '>=1.0.0', // the range you actually tested against, once you have one
+
+  async detect(_cwd: string): Promise<boolean> {
+    return hasBinary('${n.command}');
+  },
+
+  async prepare(ctx: RecordContext): Promise<Launch> {
+    const env: Record<string, string> = { ${n.baseUrlVar}: ${proxyCall(n.basePath)} };
+    passKey(env, ctx.env, '${n.apiKeyVar}');
+    return { command: '${n.command}', args: [...ctx.userArgs], env };
+  },
+};
+`;
+}
+function testSource(n) {
+    return `import type { RecordContext } from '@orcareplay/plugin-api';
+import { describe, expect, it } from 'vitest';
+import { checkAdapterContract } from '../src/contract.js';
+import { ${n.constName} } from '../src/${n.id}.js';
+
+/**
+ * Register the adapter in src/index.ts and src/registry.ts and record its wire contract in
+ * fixtures/harness/${n.id}.json; test/contract.test.ts and test/harness-versions.test.ts then
+ * cover it with no further opt-in. This file is for what only you can assert — the flags and
+ * environment this particular harness needs.
+ */
+
+function ctx(over: Partial<RecordContext> = {}): RecordContext {
+  return {
+    runId: 'run_scaffold',
+    cwd: '/work',
+    proxyUrl: 'http://127.0.0.1:51733',
+    runDir: '/work/.orca/runs/run_scaffold',
+    userArgs: [],
+    env: {},
+    ...over,
+  };
+}
+
+describe('${n.constName}', () => {
+  it('satisfies the adapter contract', async () => {
+    const result = await checkAdapterContract(${n.constName});
+    expect(result.failed).toEqual([]);
+  });
+
+  it('points ${n.command} at the recording proxy', async () => {
+    const launch = await ${n.constName}.prepare(ctx());
+    expect(launch.command).toBe('${n.command}');
+    expect(launch.env.${n.baseUrlVar}).toBe('${expectedBaseUrl(n.basePath)}');
+  });
+
+  it('passes a real key through, and substitutes a placeholder when there is none', async () => {
+    const real = await ${n.constName}.prepare(ctx({ env: { ${n.apiKeyVar}: 'sk-real' } }));
+    expect(real.env.${n.apiKeyVar}).toBe('sk-real');
+    const none = await ${n.constName}.prepare(ctx());
+    expect(none.env.${n.apiKeyVar}).toBe('orca-recorded');
+  });
+
+  it('resolves detect() rather than throwing, even for a path that does not exist', async () => {
+    await expect(${n.constName}.detect('/nope/does/not/exist')).resolves.toBe(false);
+  });
+});
+`;
+}
+function proxyCall(basePath) {
+    return basePath === '' ? 'proxyBase(ctx.proxyUrl)' : `proxyBase(ctx.proxyUrl, '${basePath}')`;
+}
+function expectedBaseUrl(basePath) {
+    return basePath === '' ? 'http://127.0.0.1:51733' : `http://127.0.0.1:51733/${basePath}`;
+}
+function toId(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function exportName(id) {
+    const camel = id.replace(/-([a-z0-9])/g, (_, char) => char.toUpperCase());
+    // An identifier cannot start with a digit, and a scaffold that emits code which will not parse
+    // is worse than one that renames.
+    const safe = /^[0-9]/.test(camel) ? `agent${camel[0]?.toUpperCase()}${camel.slice(1)}` : camel;
+    return `${safe}Adapter`;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,47 @@
+import type { SessionSupport } from '@orcareplay/plugin-api';
+export type { SessionSupport };
+/**
+ * Capturing what the harness itself wrote about the session.
+ *
+ * Orca's own capture layers record the *effects* of a run — model calls, tool calls, file writes,
+ * shell commands. None of them record the *stimulus*: what the person typed. A run started as
+ * `orca record claude` and driven by hand therefore replays into an agent with nothing to make it
+ * ask anything, which is why an interactive recording came back blank while an `-p` one replayed
+ * perfectly.
+ *
+ * Both harnesses already write that missing half to disk themselves, in their own transcript, and
+ * both can be pointed back at a session by id. So orca does not need to intercept a terminal: it
+ * needs to notice which file the harness just wrote, keep a copy, and read the prompts back out.
+ */
+/** What a harness recorded about one session, in the two forms orca needs. */
+export interface SessionCapture {
+    /** Harness session id, where the harness has one. This is what `--resume` takes. */
+    id?: string;
+    /** Path of the transcript relative to the harness session directory. */
+    relPath: string;
+    /** The harness's own file, verbatim. Restoring it is what makes a native fork possible. */
+    bytes: Uint8Array;
+    /** The user's turns, in order — the stimulus orca could not otherwise reconstruct. */
+    prompts: string[];
+}
+/** A directory listing keyed by path, so a second listing can be diffed against it. */
+export type DirSnapshot = Map<string, number>;
+/**
+ * List every file under `dir` with its mtime.
+ *
+ * Never throws. A harness that has never run has no directory, a sandbox may deny it, and neither
+ * is a reason to fail a recording that is otherwise fine.
+ */
+export declare function snapshotDir(dir: string | undefined): Promise<DirSnapshot>;
+/**
+ * The transcript this run produced: the newest file that is new, or whose mtime moved.
+ *
+ * Newest rather than only-new because a harness resumed into an existing session appends to the
+ * file it already had, and that session is still the one this run belongs to.
+ */
+export declare function captureSession(support: SessionSupport, cwd: string, env: Record<string, string | undefined>, before: DirSnapshot): Promise<SessionCapture | undefined>;
+/** Read a JSONL transcript into objects, skipping anything that does not parse. */
+export declare function parseJsonl(bytes: Uint8Array): Record<string, unknown>[];
+/** Flatten the several shapes a harness uses for message content into plain text. */
+export declare function contentText(content: unknown): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;;;;GAYG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,KAAK,EAAE,UAAU,CAAC;IAClB,sFAAsF;IACtF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CA0B/E;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CA2BrC;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAYvE;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAYpD"}

package/dist/session.js

@@ -0,0 +1,112 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * List every file under `dir` with its mtime.
+ *
+ * Never throws. A harness that has never run has no directory, a sandbox may deny it, and neither
+ * is a reason to fail a recording that is otherwise fine.
+ */
+export async function snapshotDir(dir) {
+    const seen = new Map();
+    if (dir === undefined)
+        return seen;
+    async function walk(current, prefix) {
+        let entries;
+        try {
+            entries = await readdir(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const rel = prefix === '' ? entry.name : `${prefix}/${entry.name}`;
+            const full = join(current, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full, rel);
+            }
+            else if (entry.isFile()) {
+                try {
+                    seen.set(rel, (await stat(full)).mtimeMs);
+                }
+                catch {
+                    // Vanished between listing and stat — a rotating transcript, and not ours to mind.
+                }
+            }
+        }
+    }
+    await walk(dir, '');
+    return seen;
+}
+/**
+ * The transcript this run produced: the newest file that is new, or whose mtime moved.
+ *
+ * Newest rather than only-new because a harness resumed into an existing session appends to the
+ * file it already had, and that session is still the one this run belongs to.
+ */
+export async function captureSession(support, cwd, env, before) {
+    const dir = support.dir(cwd, env);
+    if (dir === undefined)
+        return undefined;
+    const after = await snapshotDir(dir);
+    let best;
+    for (const [relPath, mtime] of after) {
+        if (before.get(relPath) === mtime)
+            continue;
+        if (best === undefined || mtime > best.mtime)
+            best = { relPath, mtime };
+    }
+    if (best === undefined)
+        return undefined;
+    let bytes;
+    try {
+        bytes = await readFile(join(dir, best.relPath));
+    }
+    catch {
+        return undefined;
+    }
+    let parsed = { prompts: [] };
+    try {
+        parsed = support.parse(bytes);
+    }
+    catch {
+        // A format orca does not recognise still has value as bytes a human can read; losing the
+        // prompts is a degraded capture, not a failed one.
+    }
+    return { id: parsed.id, relPath: best.relPath, bytes, prompts: parsed.prompts };
+}
+/** Read a JSONL transcript into objects, skipping anything that does not parse. */
+export function parseJsonl(bytes) {
+    const out = [];
+    for (const line of new TextDecoder().decode(bytes).split(/\r?\n/)) {
+        if (line.trim() === '')
+            continue;
+        try {
+            const value = JSON.parse(line);
+            if (value !== null && typeof value === 'object')
+                out.push(value);
+        }
+        catch {
+            // A half-written final line is normal for a transcript captured while the harness exits.
+        }
+    }
+    return out;
+}
+/** Flatten the several shapes a harness uses for message content into plain text. */
+export function contentText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (typeof block === 'string')
+            parts.push(block);
+        else if (block !== null && typeof block === 'object' && 'text' in block) {
+            const text = block.text;
+            if (typeof text === 'string')
+                parts.push(text);
+        }
+    }
+    return parts.join('');
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@orcareplay/adapters",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@orcareplay/node-instrument": "0.1.0",
+    "@orcareplay/plugin-api": "0.1.0"
+  }
+}