@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/harnesses/external-impls/package-hash.js

@@ -0,0 +1,102 @@
+/**
+ * Deterministic recursive package-content hash for `manifest.package.hash`
+ * verification. Walks the package directory in sorted order, hashes each
+ * file's `relPath + "\0" + contents`, and folds the per-file digests into
+ * a rolling sha256 to produce a single hex digest the daemon can compare
+ * against the manifest's claimed `sha256:<64hex>`.
+ *
+ * Exclusions mirror `walkArtifacts` / `createWorkdirTarball` in
+ * `engine/packaging.ts`: `node_modules/`, `.git/`, `test/`, dotfiles,
+ * symlinks. Absolute paths and symlinks short-circuit (we never follow
+ * them) — the publisher must produce a pure tree of regular files.
+ *
+ * The relative path is normalised to forward-slash form before hashing so
+ * the digest is stable across Linux / macOS / Windows publishers.
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, readdirSync, lstatSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+const EXCLUDED_DIRS = new Set(['node_modules', '.git', 'test']);
+function shouldSkip(name) {
+    if (name.startsWith('.'))
+        return true; // dotfiles + .git, .DS_Store, etc.
+    if (EXCLUDED_DIRS.has(name))
+        return true;
+    return false;
+}
+function collectFiles(packageDir, current, out) {
+    let entries;
+    try {
+        entries = readdirSync(current);
+    }
+    catch {
+        return;
+    }
+    entries.sort();
+    for (const name of entries) {
+        if (shouldSkip(name))
+            continue;
+        const full = join(current, name);
+        let st;
+        try {
+            st = lstatSync(full);
+        }
+        catch {
+            continue;
+        }
+        // Refuse to follow symlinks — the package-hash contract is a tree
+        // of regular files anchored at packageDir.
+        if (st.isSymbolicLink())
+            continue;
+        if (st.isDirectory()) {
+            collectFiles(packageDir, full, out);
+        }
+        else if (st.isFile()) {
+            // Always exclude the manifest itself: its hash field is a
+            // commitment to the rest of the package (and the signature
+            // makes it tamper-evident on its own).
+            const rel = relative(packageDir, full);
+            if (rel === 'jinn.manifest.json')
+                continue;
+            out.push(full);
+        }
+    }
+}
+/**
+ * Compute the deterministic package-content sha256 for `packageDir`.
+ * Returned as `sha256:<64hex>` to match the manifest field shape.
+ */
+export function computePackageHash(packageDir) {
+    const files = [];
+    collectFiles(packageDir, packageDir, files);
+    // collectFiles produces sorted-per-directory order; normalise to a
+    // single global sort over POSIX-form relative paths so the digest is
+    // platform-stable.
+    const ordered = files
+        .map((abs) => ({
+        abs,
+        rel: relative(packageDir, abs).split(sep).join('/'),
+    }))
+        .sort((a, b) => (a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0));
+    const rolling = createHash('sha256');
+    for (const { abs, rel } of ordered) {
+        const contents = readFileSync(abs);
+        const perFile = createHash('sha256')
+            .update(rel)
+            .update(Buffer.from([0]))
+            .update(contents)
+            .digest();
+        rolling.update(perFile);
+    }
+    return `sha256:${rolling.digest('hex')}`;
+}
+/**
+ * Verify the package directory matches `manifest.package.hash`.
+ * Returns true iff the recomputed digest matches exactly.
+ */
+export async function verifyPackageHash(packageDir, manifest) {
+    const expected = manifest.package.hash;
+    const actual = computePackageHash(packageDir);
+    return actual === expected;
+}
+//# sourceMappingURL=package-hash.js.map

package/dist/harnesses/external-impls/package-hash.js.map

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

package/dist/harnesses/external-impls/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Config types for operator-declared external impls. The loader and
+ * future config parsing both consume these. Kept in a self-contained
+ * module so daemon config wiring can adopt them without pulling in
+ * loader internals.
+ *
+ * Spec: `spec/2026-05-registry-discovery.md` §4.
+ */
+export interface ExternalImplEntry {
+    /** MUST equal the manifest's `name`. */
+    name: string;
+    /**
+     * Pointer to the manifest source. Reserved for future ipfs:// /
+     * https:// fetching; currently the loader expects a local
+     * directory path (see `entry`).
+     */
+    package?: string;
+    /**
+     * Local path the loader uses to find both `jinn.manifest.json` and
+     * the entry module. Typically points to a node_modules directory
+     * (e.g. `node_modules/@example/forecaster`).
+     */
+    entry: string;
+    /**
+     * Optional operator-pinned version. When set, the loader rejects
+     * the impl if `manifest.version` does not match this string exactly.
+     * Lets operators pin a specific package version in config without
+     * relying on `node_modules/` discipline.
+     */
+    version?: string;
+}
+export interface SignerTrust {
+    alg: 'ed25519';
+    publicKey: string;
+    label?: string;
+}
+export interface HarnessesConfig {
+    /** Names of in-repo or external impls to suppress for this fleet. */
+    disabled?: readonly string[];
+    /** Operator-supplied external impls. */
+    externalImpls?: readonly ExternalImplEntry[];
+}

package/dist/harnesses/external-impls/types.js

@@ -0,0 +1,10 @@
+/**
+ * Config types for operator-declared external impls. The loader and
+ * future config parsing both consume these. Kept in a self-contained
+ * module so daemon config wiring can adopt them without pulling in
+ * loader internals.
+ *
+ * Spec: `spec/2026-05-registry-discovery.md` §4.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harnesses/external-impls/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/harnesses/external-impls/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/harnesses/freeze.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Deterministic content hashing for implStateDir directories.
+ *
+ * Used by the daemon's freeze-fence (`client/src/daemon/freeze-fence.ts`)
+ * to detect violations of the frozen-mode contract — a harness MUST NOT
+ * mutate `implStateDir` when running with `ctx.mode === 'frozen'`. The
+ * daemon hashes the directory before and after each Task and rejects the
+ * envelope on mismatch.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §6.3
+ */
+/**
+ * Compute a deterministic SHA-256 hash of an `implStateDir`'s contents.
+ *
+ * Algorithm:
+ *   1. Walk the directory tree recursively.
+ *   2. For each file, hash its content with SHA-256.
+ *   3. Sort entries by relative path (canonical ordering, OS-independent).
+ *   4. Combine "<relpath>:<filehash>\n" lines and hash the whole thing.
+ *
+ * Properties:
+ *   - Deterministic: same content → same hash.
+ *   - Order-stable: filesystem listing order does not affect output.
+ *   - Order-sensitive: file path differences DO affect output.
+ *   - Recursive: walks subdirectories.
+ *   - Metadata-independent: mtimes, permissions, file order do not affect output.
+ *
+ * Cost: O(total bytes) read + SHA-256. For typical claude-code-learner
+ * implStateDir (~few MB) this is sub-second.
+ *
+ * Returns a 64-character lowercase hex string (no `sha256:` prefix; callers
+ * that need that prefix add it themselves).
+ */
+export declare function hashImplStateDir(dirPath: string): Promise<string>;

package/dist/harnesses/freeze.js

@@ -0,0 +1,60 @@
+/**
+ * Deterministic content hashing for implStateDir directories.
+ *
+ * Used by the daemon's freeze-fence (`client/src/daemon/freeze-fence.ts`)
+ * to detect violations of the frozen-mode contract — a harness MUST NOT
+ * mutate `implStateDir` when running with `ctx.mode === 'frozen'`. The
+ * daemon hashes the directory before and after each Task and rejects the
+ * envelope on mismatch.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §6.3
+ */
+import { createHash } from 'node:crypto';
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+/**
+ * Compute a deterministic SHA-256 hash of an `implStateDir`'s contents.
+ *
+ * Algorithm:
+ *   1. Walk the directory tree recursively.
+ *   2. For each file, hash its content with SHA-256.
+ *   3. Sort entries by relative path (canonical ordering, OS-independent).
+ *   4. Combine "<relpath>:<filehash>\n" lines and hash the whole thing.
+ *
+ * Properties:
+ *   - Deterministic: same content → same hash.
+ *   - Order-stable: filesystem listing order does not affect output.
+ *   - Order-sensitive: file path differences DO affect output.
+ *   - Recursive: walks subdirectories.
+ *   - Metadata-independent: mtimes, permissions, file order do not affect output.
+ *
+ * Cost: O(total bytes) read + SHA-256. For typical claude-code-learner
+ * implStateDir (~few MB) this is sub-second.
+ *
+ * Returns a 64-character lowercase hex string (no `sha256:` prefix; callers
+ * that need that prefix add it themselves).
+ */
+export async function hashImplStateDir(dirPath) {
+    const entries = [];
+    async function walk(currentPath) {
+        const items = (await readdir(currentPath)).sort();
+        for (const item of items) {
+            const full = join(currentPath, item);
+            const s = await stat(full);
+            if (s.isDirectory()) {
+                await walk(full);
+            }
+            else if (s.isFile()) {
+                const content = await readFile(full);
+                const fileHash = createHash('sha256').update(content).digest('hex');
+                entries.push({ relPath: relative(dirPath, full), fileHash });
+            }
+            // Symlinks and special files are skipped (not expected in implStateDir).
+        }
+    }
+    await walk(dirPath);
+    entries.sort((a, b) => a.relPath.localeCompare(b.relPath));
+    const combined = entries.map((e) => `${e.relPath}:${e.fileHash}`).join('\n');
+    return createHash('sha256').update(combined).digest('hex');
+}
+//# sourceMappingURL=freeze.js.map

package/dist/harnesses/freeze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.js","sourceRoot":"","sources":["../../src/harnesses/freeze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACpD,MAAM,OAAO,GAAiD,EAAE,CAAC;IAEjE,KAAK,UAAU,IAAI,CAAC,WAAmB;QACrC,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,yEAAyE;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/harnesses/impls/claude-code-learner/adapters/claude-code.d.ts

@@ -0,0 +1,57 @@
+import { spawn } from 'node:child_process';
+import type { HarnessAdapter, TaskSessionInputs } from '../types.js';
+export interface ClaudeCodeHarnessAdapterConfig {
+    /** Path to the `claude` executable. Default: 'claude' (from PATH). */
+    claudePath?: string;
+    /** Optional model override (e.g. 'claude-sonnet-4-6'). */
+    claudeModel?: string;
+    /**
+     * Local SQLite store path forwarded to the Jinn client MCP server exposed by
+     * Network Tools. Without it, read-only record search degrades to an empty
+     * no-store response.
+     */
+    storePath?: string;
+    /** Daemon API URL used by explicit cost-mutating MCP tools such as acquire_artifact. */
+    daemonApiUrl?: string;
+    /** Bearer token for daemon API cost-mutating routes. */
+    daemonApiToken?: string;
+    /** Keyless corpus endpoints for read-only record search and inspection. */
+    corpusEnv?: {
+        subgraphUrl?: string;
+        ipfsGatewayUrl?: string;
+    };
+    /**
+     * Plugin install directory for Claude Code. Defaults to
+     * `~/.claude/plugins/`. The adapter copies (or symlinks) the plugin
+     * into this directory before spawning.
+     */
+    pluginInstallDir?: string;
+    /**
+     * Override spawn for testing. When provided, called instead of
+     * node:child_process.spawn so tests can inject a fake child process.
+     */
+    _spawnFn?: typeof spawn;
+}
+/**
+ * Real Claude Code adapter. Spawns the `claude` CLI with the plugin
+ * loaded via Claude Code's plugin install directory, sets IMPL_STATE_DIR
+ * so the session-start hook fires correctly, and hands the task context to
+ * the session.
+ *
+ * Output collection is delegated to the shim's harvester — this adapter
+ * only owns the spawn lifecycle.
+ */
+export declare class ClaudeCodeHarnessAdapter implements HarnessAdapter {
+    readonly name = "claude-code";
+    readonly allowsHarnessSelfModification = false;
+    private readonly claudePath;
+    private readonly claudeModel;
+    private readonly storePath;
+    private readonly daemonApiUrl;
+    private readonly daemonApiToken;
+    private readonly corpusEnv;
+    private readonly pluginInstallDir;
+    private readonly spawnFn;
+    constructor(config?: ClaudeCodeHarnessAdapterConfig);
+    runTask(inputs: TaskSessionInputs, pluginRoot: string): Promise<void>;
+}

package/dist/harnesses/impls/claude-code-learner/adapters/claude-code.js

@@ -0,0 +1,239 @@
+import { spawn } from 'node:child_process';
+import { createWriteStream, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { finished } from 'node:stream/promises';
+/**
+ * Allowlist of env vars that propagate to the spawned Claude session.
+ * We deliberately limit this to avoid leaking unrelated credentials
+ * into the agent process.
+ *
+ * Mirror of the canonical allowlist in client/src/runner/claude.ts.
+ * Hard-won from prior auth/runtime issues — keep in sync with that file.
+ */
+const ENV_ALLOWLIST = [
+    'PATH',
+    'HOME',
+    'USER',
+    'SHELL',
+    'LANG',
+    'TERM',
+    'TMPDIR',
+    'XDG_CONFIG_HOME',
+    'XDG_DATA_HOME',
+    'XDG_CACHE_HOME',
+    'NODE_PATH',
+    'NODE_OPTIONS',
+    'NPM_CONFIG_PREFIX',
+    // Claude Code auth — needed in Docker where keychain is unavailable.
+    // CLAUDE_CODE_OAUTH_TOKEN is the output of `claude setup-token` (subscription
+    // path, year-long validity); ANTHROPIC_API_KEY is the pay-per-request fallback.
+    // Both are Claude credentials, not Jinn operator secrets, so forwarding is
+    // scoped and intentional. Without these the spawned `claude -p …` fails with
+    // "Not logged in · Please run /login".
+    'CLAUDE_CODE_OAUTH_TOKEN',
+    'ANTHROPIC_API_KEY',
+];
+function buildAgentEnv(extra) {
+    const env = {};
+    for (const key of ENV_ALLOWLIST) {
+        if (process.env[key])
+            env[key] = process.env[key];
+    }
+    return { ...env, ...extra };
+}
+function stringField(value) {
+    return typeof value === 'string' ? value : '';
+}
+function taskContextJson(inputs) {
+    const context = inputs.taskBody?.context;
+    if (!context || typeof context !== 'object')
+        return '';
+    try {
+        return JSON.stringify(context);
+    }
+    catch {
+        return '';
+    }
+}
+function captureLogError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+/**
+ * Construct the initial task prompt. Harness/plugin-specific operating details
+ * live in the projected runtime instructions, not in this daemon handoff.
+ */
+function buildInitialPrompt(inputs) {
+    return [
+        'You are executing a Jinn task.',
+        'Complete the task described by the task payload below.',
+        'Use the available skills, plugins, tools, and runtime context exposed by this harness.',
+        'Keep all task work inside `workingDir`.',
+        'When the task requires a typed SolverNet payload, submit it through an available submission tool or write the expected payload file for the harness harvester.',
+        '',
+        'Session inputs:',
+        `- goal.id = ${inputs.taskId}`,
+        inputs.taskCid ? `- goal.cid = ${inputs.taskCid}` : '',
+        `- workingDir = ${inputs.workingDir}`,
+        `- implStateDir = ${inputs.implStateDir}`,
+        `- goal.deadline = ${inputs.windowEndTs} (ms since epoch)`,
+        `- msUntilDeadline = ${inputs.msUntilEndTs}`,
+        `- mode = ${inputs.mode}`,
+        inputs.taskBody
+            ? `\ngoal (full body):\n${JSON.stringify(inputs.taskBody, null, 2)}`
+            : '',
+    ]
+        .filter((line) => line !== '')
+        .join('\n');
+}
+/**
+ * Real Claude Code adapter. Spawns the `claude` CLI with the plugin
+ * loaded via Claude Code's plugin install directory, sets IMPL_STATE_DIR
+ * so the session-start hook fires correctly, and hands the task context to
+ * the session.
+ *
+ * Output collection is delegated to the shim's harvester — this adapter
+ * only owns the spawn lifecycle.
+ */
+export class ClaudeCodeHarnessAdapter {
+    name = 'claude-code';
+    allowsHarnessSelfModification = false;
+    claudePath;
+    claudeModel;
+    storePath;
+    daemonApiUrl;
+    daemonApiToken;
+    corpusEnv;
+    pluginInstallDir;
+    spawnFn;
+    constructor(config = {}) {
+        this.claudePath = config.claudePath ?? 'claude';
+        this.claudeModel = config.claudeModel;
+        this.storePath = config.storePath;
+        this.daemonApiUrl = config.daemonApiUrl;
+        this.daemonApiToken = config.daemonApiToken;
+        this.corpusEnv = config.corpusEnv;
+        this.pluginInstallDir = config.pluginInstallDir ?? join(homedir(), '.claude', 'plugins');
+        this.spawnFn = config._spawnFn ?? spawn;
+    }
+    async runTask(inputs, pluginRoot) {
+        // Ensure the plugin install directory exists. The adapter does NOT
+        // copy the plugin — that's the operator's responsibility per the
+        // README. If the operator has not installed it, Claude Code will
+        // not find the learn skill and will fail; check for it here.
+        mkdirSync(this.pluginInstallDir, { recursive: true });
+        const prompt = buildInitialPrompt(inputs);
+        const args = [
+            '--setting-sources',
+            'project',
+            '--permission-mode',
+            'bypassPermissions',
+            '--verbose',
+            '--output-format',
+            'stream-json',
+            '--include-hook-events',
+            '-p',
+            prompt,
+        ];
+        const claudeModel = inputs.model ?? inputs.claudeModel ?? this.claudeModel;
+        if (claudeModel)
+            args.push('--model', claudeModel);
+        for (const dir of [pluginRoot, ...(inputs.pluginRoots ?? [])]) {
+            args.push('--plugin-dir', dir);
+        }
+        const env = buildAgentEnv({
+            IMPL_STATE_DIR: inputs.implStateDir,
+            WORKING_DIR: inputs.workingDir,
+            JINN_WORKING_DIR: inputs.workingDir,
+            JINN_CLAUDE_CODE_LEARNER_PLUGIN_ROOT: pluginRoot,
+            DESIRED_STATE_ID: inputs.taskId,
+            DESIRED_STATE_DESCRIPTION: stringField(inputs.taskBody?.description),
+            DESIRED_STATE_CONTEXT: taskContextJson(inputs),
+            DESIRED_STATE_ROLE: stringField(inputs.taskBody?.role),
+            DESIRED_STATE_SOLVER_TYPE: stringField(inputs.taskBody?.solverType ?? inputs.solverType),
+            RESTORATION_REQUEST_ID: stringField(inputs.taskBody?.restorationRequestId),
+            REQUEST_ID: inputs.requestId ?? inputs.taskId,
+            STORE_PATH: this.storePath ?? '',
+            DAEMON_API_URL: this.daemonApiUrl ?? '',
+            DAEMON_API_TOKEN: this.daemonApiToken ?? '',
+            JINN_CORPUS_SUBGRAPH_URL: this.corpusEnv?.subgraphUrl ?? '',
+            JINN_CORPUS_IPFS_GATEWAY_URL: this.corpusEnv?.ipfsGatewayUrl ?? '',
+            ...(inputs.adapterEnv ?? {}),
+        });
+        const spawnOpts = {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env,
+            cwd: inputs.workingDir,
+        };
+        return new Promise((resolve, reject) => {
+            const logDir = join(inputs.workingDir, '.claude-code');
+            mkdirSync(logDir, { recursive: true });
+            const stdoutLog = createWriteStream(join(logDir, 'stdout.jsonl'), { flags: 'a' });
+            const stderrLog = createWriteStream(join(logDir, 'stderr.log'), { flags: 'a' });
+            const stdoutDone = finished(stdoutLog).then(() => null, captureLogError);
+            const stderrDone = finished(stderrLog).then(() => null, captureLogError);
+            const closeLogs = async () => {
+                if (!stdoutLog.writableEnded)
+                    stdoutLog.end();
+                if (!stderrLog.writableEnded)
+                    stderrLog.end();
+                const [stdoutErr, stderrErr] = await Promise.all([stdoutDone, stderrDone]);
+                if (stdoutErr)
+                    throw stdoutErr;
+                if (stderrErr)
+                    throw stderrErr;
+            };
+            const child = this.spawnFn(this.claudePath, args, spawnOpts);
+            // If the abort signal already fired before we got here (race), kill
+            // the child immediately. Without this, addEventListener below would
+            // never fire (signals only emit on transition to aborted, not when
+            // already aborted).
+            if (inputs.abort.aborted) {
+                if (!child.killed)
+                    child.kill('SIGTERM');
+            }
+            // Window-end abort: kill child, reject.
+            const onAbort = () => {
+                if (!child.killed)
+                    child.kill('SIGTERM');
+            };
+            inputs.abort.addEventListener('abort', onAbort);
+            let stderr = '';
+            child.stdout?.on('data', (d) => {
+                stdoutLog.write(d);
+            });
+            child.stderr?.on('data', (d) => {
+                stderrLog.write(d);
+                stderr += d.toString();
+            });
+            let settled = false;
+            const settleAfterLogs = (complete, onLogError = reject) => {
+                if (settled)
+                    return;
+                settled = true;
+                inputs.abort.removeEventListener('abort', onAbort);
+                closeLogs().then(complete, onLogError);
+            };
+            child.on('exit', (code, signal) => {
+                settleAfterLogs(() => {
+                    if (code === 0) {
+                        resolve();
+                    }
+                    else if (inputs.abort.aborted) {
+                        // Window expired; resolve anyway so harvester can collect
+                        // partial outputs. The shim's caller (engine) handles the
+                        // abort signal separately.
+                        resolve();
+                    }
+                    else {
+                        reject(new Error(`claude-code adapter: child exited with code=${code} signal=${signal}: ${stderr.slice(0, 500)}`));
+                    }
+                });
+            });
+            child.on('error', (err) => {
+                settleAfterLogs(() => reject(err), () => reject(err));
+            });
+        });
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/harnesses/impls/claude-code-learner/adapters/claude-code.js.map

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

package/dist/harnesses/impls/claude-code-learner/adapters/codex-code.d.ts

@@ -0,0 +1,31 @@
+import { spawn } from 'node:child_process';
+import type { HarnessAdapter, TaskSessionInputs } from '../types.js';
+export interface CodexCodeHarnessAdapterConfig {
+    codexPath?: string;
+    codexModel?: string;
+    storePath?: string;
+    daemonApiUrl?: string;
+    daemonApiToken?: string;
+    corpusEnv?: {
+        subgraphUrl?: string;
+        ipfsGatewayUrl?: string;
+    };
+    clientRoot?: string;
+    _spawnFn?: typeof spawn;
+    _runSessionStartHook?: boolean;
+}
+export declare class CodexCodeHarnessAdapter implements HarnessAdapter {
+    readonly name = "codex-code";
+    readonly allowsHarnessSelfModification = false;
+    private readonly codexPath;
+    private readonly codexModel;
+    private readonly storePath;
+    private readonly daemonApiUrl;
+    private readonly daemonApiToken;
+    private readonly corpusEnv;
+    private readonly clientRoot;
+    private readonly spawnFn;
+    private readonly runSessionStartHook;
+    constructor(config?: CodexCodeHarnessAdapterConfig);
+    runTask(inputs: TaskSessionInputs, pluginRoot: string): Promise<void>;
+}