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

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

@@ -0,0 +1,257 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { createWriteStream, mkdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { finished } from 'node:stream/promises';
+import { fileURLToPath } from 'node:url';
+import { prepareCodexPluginWorkspace } from './codex-workspace.js';
+const DEFAULT_CODEX_MODEL = 'gpt-5.4-mini';
+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',
+    'OPENAI_API_KEY',
+    'CODEX_HOME',
+];
+function defaultClientRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, '..', '..', '..', '..', '..');
+}
+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 taskBodyRecord(inputs) {
+    const body = inputs.taskBody;
+    return body && typeof body === 'object' && !Array.isArray(body)
+        ? body
+        : null;
+}
+function nestedRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function sweRebenchV2Guidance(inputs) {
+    const body = taskBodyRecord(inputs);
+    if (body?.solverType !== 'swe-rebench-v2.v1' || body.role === 'evaluation') {
+        return [];
+    }
+    const spec = nestedRecord(body.spec);
+    const repo = typeof spec?.repo === 'string' && spec.repo.trim() ? spec.repo.trim() : '<goal.spec.repo>';
+    const baseCommit = typeof spec?.base_commit === 'string' && spec.base_commit.trim()
+        ? spec.base_commit.trim()
+        : '<goal.spec.base_commit>';
+    return [
+        '',
+        'SWE-rebench v2 restoration requirements:',
+        `- Use ${inputs.workingDir}/repo as the only task repository checkout. Do not reuse a repo from another workingDir or from implStateDir.`,
+        `- If ${inputs.workingDir}/repo/.git is missing, clone https://github.com/${repo}.git into ${inputs.workingDir}/repo and checkout ${baseCommit} before editing.`,
+        '- Before planning, use Network Tools to search donated SWE execution data: call search_records, inspect_record, and acquire_artifact for useful donated IPFS records.',
+        `- Submit the final swe-rebench-v2-solution.v1 payload through submit_typed_payload, or write ${inputs.workingDir}/.execute/solution-payload.json.`,
+        `- If you rely on the harvester git-diff fallback, the patch must be present as git diff output under ${inputs.workingDir}/repo.`,
+    ];
+}
+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.',
+        ...sweRebenchV2Guidance(inputs),
+        '',
+        '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');
+}
+function captureLogError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+export class CodexCodeHarnessAdapter {
+    name = 'codex-code';
+    allowsHarnessSelfModification = false;
+    codexPath;
+    codexModel;
+    storePath;
+    daemonApiUrl;
+    daemonApiToken;
+    corpusEnv;
+    clientRoot;
+    spawnFn;
+    runSessionStartHook;
+    constructor(config = {}) {
+        this.codexPath = config.codexPath ?? 'codex';
+        this.codexModel = config.codexModel ?? DEFAULT_CODEX_MODEL;
+        this.storePath = config.storePath;
+        this.daemonApiUrl = config.daemonApiUrl;
+        this.daemonApiToken = config.daemonApiToken;
+        this.corpusEnv = config.corpusEnv;
+        this.clientRoot = config.clientRoot ?? defaultClientRoot();
+        this.spawnFn = config._spawnFn ?? spawn;
+        this.runSessionStartHook = config._runSessionStartHook ?? true;
+    }
+    async runTask(inputs, pluginRoot) {
+        const prompt = buildInitialPrompt(inputs);
+        const baseEnv = {
+            IMPL_STATE_DIR: inputs.implStateDir,
+            WORKING_DIR: inputs.workingDir,
+            JINN_WORKING_DIR: inputs.workingDir,
+            PLUGIN_ROOT: pluginRoot,
+            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 env = buildAgentEnv(baseEnv);
+        if (this.runSessionStartHook) {
+            const hook = spawnSync('bash', [join(pluginRoot, 'hooks', 'session-start')], {
+                cwd: inputs.workingDir,
+                env,
+                encoding: 'utf8',
+            });
+            if (hook.status !== 0) {
+                throw new Error(`codex-code adapter: session-start hook failed: ${(hook.stderr || hook.stdout || '').slice(0, 500)}`);
+            }
+        }
+        const prepared = prepareCodexPluginWorkspace({
+            workingDir: inputs.workingDir,
+            pluginRoots: [pluginRoot, ...(inputs.pluginRoots ?? [])],
+            clientRoot: this.clientRoot,
+            mcpEnv: baseEnv,
+        });
+        const args = [
+            'exec',
+            '--json',
+            '--ignore-user-config',
+            '--disable',
+            'plugins',
+            '--sandbox',
+            'danger-full-access',
+            '--dangerously-bypass-approvals-and-sandbox',
+            '-C',
+            inputs.workingDir,
+            '-m',
+            inputs.model ?? inputs.claudeModel ?? this.codexModel,
+        ];
+        for (const configArg of prepared.configArgs) {
+            args.push('-c', configArg);
+        }
+        args.push(prompt);
+        const spawnOpts = {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env,
+            cwd: inputs.workingDir,
+        };
+        return new Promise((resolvePromise, reject) => {
+            const logDir = join(inputs.workingDir, '.codex-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.codexPath, args, spawnOpts);
+            if (inputs.abort.aborted) {
+                if (!child.killed)
+                    child.kill('SIGTERM');
+            }
+            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) {
+                        resolvePromise();
+                    }
+                    else if (inputs.abort.aborted) {
+                        resolvePromise();
+                    }
+                    else {
+                        reject(new Error(`codex-code adapter: child exited with code=${code} signal=${signal}: ${stderr.slice(0, 500)}`));
+                    }
+                });
+            });
+            child.on('error', (err) => {
+                settleAfterLogs(() => reject(err), () => reject(err));
+            });
+        });
+    }
+}
+//# sourceMappingURL=codex-code.js.map

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

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

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

@@ -0,0 +1,21 @@
+export interface CodexMcpServerConfig {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export interface PreparedCodexWorkspace {
+    pluginRoots: string[];
+    skillLinks: string[];
+    mcpServers: Record<string, CodexMcpServerConfig>;
+    marketplacePath: string;
+    configArgs: string[];
+}
+export interface PrepareCodexWorkspaceInput {
+    workingDir: string;
+    pluginRoots: string[];
+    clientRoot: string;
+    mcpEnv?: Record<string, string>;
+    copyPlugins?: boolean;
+}
+export declare function prepareCodexPluginWorkspace(input: PrepareCodexWorkspaceInput): PreparedCodexWorkspace;

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

@@ -0,0 +1,193 @@
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, rmSync, symlinkSync, writeFileSync, } from 'node:fs';
+import { basename, isAbsolute, join, resolve } from 'node:path';
+function readJson(path) {
+    if (!existsSync(path))
+        return null;
+    const raw = JSON.parse(readFileSync(path, 'utf8'));
+    return raw && typeof raw === 'object' && !Array.isArray(raw)
+        ? raw
+        : null;
+}
+function readCodexManifest(root) {
+    const raw = readJson(join(root, '.codex-plugin', 'plugin.json'));
+    if (!raw)
+        return null;
+    return {
+        ...(typeof raw['name'] === 'string' ? { name: raw['name'] } : {}),
+        ...(typeof raw['skills'] === 'string' ? { skills: raw['skills'] } : {}),
+        ...(typeof raw['mcpServers'] === 'string' ? { mcpServers: raw['mcpServers'] } : {}),
+    };
+}
+function pluginInfo(root) {
+    const manifest = readCodexManifest(root);
+    return {
+        name: manifest?.name && manifest.name.trim() ? manifest.name.trim() : basename(root),
+        manifest,
+    };
+}
+function cleanSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'plugin';
+}
+function removeIfExists(path) {
+    if (!existsSync(path))
+        return;
+    rmSync(path, { force: true, recursive: true });
+}
+function materializePluginRoot(sourceRoot, targetRoot, copy) {
+    removeIfExists(targetRoot);
+    mkdirSync(resolve(targetRoot, '..'), { recursive: true });
+    if (copy) {
+        cpSync(sourceRoot, targetRoot, { recursive: true, dereference: true });
+        return;
+    }
+    try {
+        symlinkSync(sourceRoot, targetRoot, 'dir');
+    }
+    catch {
+        cpSync(sourceRoot, targetRoot, { recursive: true, dereference: true });
+    }
+}
+function skillDirs(skillsRoot) {
+    if (!existsSync(skillsRoot))
+        return [];
+    const stat = lstatSync(skillsRoot);
+    if (stat.isDirectory() && existsSync(join(skillsRoot, 'SKILL.md')))
+        return [skillsRoot];
+    if (!stat.isDirectory())
+        return [];
+    return readdirSync(skillsRoot, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => join(skillsRoot, entry.name))
+        .filter((dir) => existsSync(join(dir, 'SKILL.md')));
+}
+function configPath(parts) {
+    return parts.map((part) => /^[A-Za-z0-9_-]+$/.test(part)
+        ? part
+        : `"${part.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`).join('.');
+}
+function configValue(value) {
+    return JSON.stringify(value);
+}
+function toConfigArgs(servers) {
+    const args = [];
+    for (const [name, server] of Object.entries(servers).sort(([a], [b]) => a.localeCompare(b))) {
+        const prefix = ['mcp_servers', name];
+        args.push(`${configPath([...prefix, 'command'])}=${configValue(server.command)}`);
+        if (server.args)
+            args.push(`${configPath([...prefix, 'args'])}=${configValue(server.args)}`);
+        if (server.cwd)
+            args.push(`${configPath([...prefix, 'cwd'])}=${configValue(server.cwd)}`);
+        if (server.env) {
+            for (const [key, value] of Object.entries(server.env).sort(([a], [b]) => a.localeCompare(b))) {
+                args.push(`${configPath([...prefix, 'env', key])}=${configValue(value)}`);
+            }
+        }
+    }
+    return args;
+}
+function writeMarketplace(workingDir, plugins) {
+    const marketplacePath = join(workingDir, '.agents', 'plugins', 'marketplace.json');
+    mkdirSync(resolve(marketplacePath, '..'), { recursive: true });
+    writeFileSync(marketplacePath, JSON.stringify({
+        name: 'jinn-runtime',
+        interface: {
+            displayName: 'Jinn Runtime',
+        },
+        plugins,
+    }, null, 2));
+    return marketplacePath;
+}
+function resolveRelative(root, value) {
+    return isAbsolute(value) ? value : resolve(root, value);
+}
+function readMcpServers(projectedRoot, manifest, pluginName, clientRoot, mcpEnv) {
+    const rel = manifest?.mcpServers;
+    if (!rel)
+        return {};
+    const raw = readJson(resolveRelative(projectedRoot, rel));
+    const mcpServers = raw?.['mcpServers'];
+    if (!mcpServers || typeof mcpServers !== 'object' || Array.isArray(mcpServers))
+        return {};
+    const out = {};
+    for (const [name, value] of Object.entries(mcpServers)) {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            continue;
+        const record = value;
+        if (typeof record['command'] !== 'string')
+            continue;
+        const args = Array.isArray(record['args'])
+            ? record['args'].filter((item) => typeof item === 'string')
+            : undefined;
+        const cwd = typeof record['cwd'] === 'string'
+            ? resolveRelative(projectedRoot, record['cwd'])
+            : projectedRoot;
+        const declaredEnv = record['env'] && typeof record['env'] === 'object' && !Array.isArray(record['env'])
+            ? Object.fromEntries(Object.entries(record['env'])
+                .filter((entry) => typeof entry[1] === 'string'))
+            : {};
+        out[name] = {
+            command: record['command'],
+            ...(args ? { args } : {}),
+            cwd,
+            env: {
+                ...mcpEnv,
+                ...(pluginName === 'network-tools' ? { JINN_NETWORK_TOOLS_CLIENT_ROOT: clientRoot } : {}),
+                ...declaredEnv,
+            },
+        };
+    }
+    return out;
+}
+export function prepareCodexPluginWorkspace(input) {
+    const pluginRoots = Array.from(new Set(input.pluginRoots.map((root) => resolve(root))));
+    const projectedPluginsDir = join(input.workingDir, 'plugins');
+    const skillsDir = join(input.workingDir, '.agents', 'skills');
+    mkdirSync(projectedPluginsDir, { recursive: true });
+    mkdirSync(skillsDir, { recursive: true });
+    const projectedRoots = [];
+    const skillLinks = [];
+    const mcpServers = {};
+    const marketplacePlugins = [];
+    for (const root of pluginRoots) {
+        const info = pluginInfo(root);
+        const safeName = cleanSegment(info.name);
+        const projectedRoot = join(projectedPluginsDir, safeName);
+        materializePluginRoot(root, projectedRoot, Boolean(input.copyPlugins));
+        projectedRoots.push(projectedRoot);
+        marketplacePlugins.push({
+            name: safeName,
+            source: {
+                source: 'local',
+                path: `./plugins/${safeName}`,
+            },
+            policy: {
+                installation: 'INSTALLED_BY_DEFAULT',
+                authentication: 'NONE',
+            },
+            category: 'Coding',
+        });
+        const skillsPath = info.manifest?.skills
+            ? resolveRelative(projectedRoot, info.manifest.skills)
+            : join(projectedRoot, 'skills');
+        for (const dir of skillDirs(skillsPath)) {
+            const link = join(skillsDir, `${safeName}__${basename(dir)}`);
+            removeIfExists(link);
+            try {
+                symlinkSync(dir, link, 'dir');
+            }
+            catch {
+                cpSync(dir, link, { recursive: true, dereference: true });
+            }
+            skillLinks.push(link);
+        }
+        Object.assign(mcpServers, readMcpServers(projectedRoot, info.manifest, safeName, input.clientRoot, input.mcpEnv ?? {}));
+    }
+    return {
+        pluginRoots: projectedRoots,
+        skillLinks,
+        mcpServers,
+        marketplacePath: writeMarketplace(input.workingDir, marketplacePlugins),
+        configArgs: toConfigArgs(mcpServers),
+    };
+}
+//# sourceMappingURL=codex-workspace.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { Harness, HarnessContext, Solution } from '../../types.js';
+import type { ClaudeCodeLearnerConfig } from './types.js';
+/**
+ * `Harness` shell. Bridges the engine's dispatch contract
+ * (`await impl.run(ctx)`) into the harness adapter + markdown plugin.
+ *
+ * `supports()` returns true for any non-evaluation SolverType. The registry
+ * keeps this Harness as the default, so explicit specialists can still claim
+ * their SolverTypes without being wrapped.
+ */
+export declare class ClaudeCodeLearnerImpl implements Harness {
+    readonly name: string;
+    readonly version: string;
+    private readonly adapter;
+    private readonly pluginRoot;
+    constructor(config: ClaudeCodeLearnerConfig);
+    supports(spec: {
+        solverType: string;
+        role?: 'restoration' | 'evaluation';
+    }): boolean;
+    run(ctx: HarnessContext): Promise<Solution>;
+}

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

@@ -0,0 +1,62 @@
+import { CLAUDE_CODE_HARNESS } from '../../names.js';
+import { resolvePluginRoot } from './plugin-path.js';
+import { harvestOutput } from './harvest.js';
+/**
+ * `Harness` shell. Bridges the engine's dispatch contract
+ * (`await impl.run(ctx)`) into the harness adapter + markdown plugin.
+ *
+ * `supports()` returns true for any non-evaluation SolverType. The registry
+ * keeps this Harness as the default, so explicit specialists can still claim
+ * their SolverTypes without being wrapped.
+ */
+export class ClaudeCodeLearnerImpl {
+    name;
+    version;
+    adapter;
+    pluginRoot;
+    constructor(config) {
+        this.adapter = config.adapter;
+        this.name = config.name ?? CLAUDE_CODE_HARNESS;
+        this.version = config.version ?? '0.1.0-shim';
+        this.pluginRoot = config.pluginRoot ?? resolvePluginRoot();
+    }
+    supports(spec) {
+        if (spec.role === 'evaluation')
+            return false;
+        // These SolverTypes have first-party restoration Harnesses that return
+        // typed solutionPayload objects. The learner emits phase artifacts for its
+        // own pipeline; letting it claim these specialist tasks can run Claude but
+        // fail packaging when the phase artifacts are absent.
+        if (spec.solverType === 'prediction.v1' || spec.solverType === 'prediction.apy.v0') {
+            return false;
+        }
+        return true;
+    }
+    async run(ctx) {
+        const window = ctx.task.window ?? { startTs: 0, endTs: 0 };
+        const inputs = {
+            taskId: ctx.task.id,
+            requestId: ctx.requestId,
+            taskCid: ctx.taskCid,
+            solverType: ctx.task.solverType,
+            model: ctx.solverNet?.model,
+            claudeModel: ctx.solverNet?.model,
+            taskBody: ctx.task,
+            implStateDir: ctx.implStateDir,
+            workingDir: ctx.workingDir,
+            pluginRoots: [...(ctx.solverPluginRoots ?? [])],
+            windowStartTs: window.startTs,
+            windowEndTs: window.endTs,
+            msUntilEndTs: ctx.msUntilEndTs(),
+            abort: ctx.abort,
+            mode: ctx.mode,
+        };
+        await this.adapter.runTask(inputs, this.pluginRoot);
+        const solution = await harvestOutput(ctx.workingDir, undefined, ctx.task);
+        return {
+            ...solution,
+            venueRef: { ...solution.venueRef, name: this.name },
+        };
+    }
+}
+//# sourceMappingURL=harness.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-code-learner/harness.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAMrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IACvB,IAAI,CAAS;IACb,OAAO,CAAS;IACR,OAAO,CAAiB;IACxB,UAAU,CAAS;IAEpC,YAAY,MAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,mBAAmB,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,YAAY,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAC7D,CAAC;IAED,QAAQ,CAAC,IAAiE;QACxE,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,KAAK,CAAC;QAC7C,uEAAuE;QACvE,2EAA2E;QAC3E,2EAA2E;QAC3E,sDAAsD;QACtD,IAAI,IAAI,CAAC,UAAU,KAAK,eAAe,IAAI,IAAI,CAAC,UAAU,KAAK,mBAAmB,EAAE,CAAC;YACnF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAmB;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAsB;YAChC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE;YACnB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU;YAC/B,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK;YAC3B,WAAW,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK;YACjC,QAAQ,EAAE,GAAG,CAAC,IAAqC;YACnD,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YAC/C,aAAa,EAAE,MAAM,CAAC,OAAO;YAC7B,WAAW,EAAE,MAAM,CAAC,KAAK;YACzB,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE;YAChC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC;QAEF,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEpD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1E,OAAO;YACL,GAAG,QAAQ;YACX,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;SACpD,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,20 @@
+import type { Task } from '../../../types/task.js';
+import type { Solution } from '../../types.js';
+/**
+ * Like safeReadJson but throws on missing file or invalid JSON.
+ * Used for required phase artifacts where a silent failure would allow an
+ * empty-looking success to propagate through the engine.
+ */
+export declare function requiredReadJson(path: string): Record<string, unknown>;
+/**
+ * Construct Solution from the plugin's per-phase artifacts.
+ *
+ * Phase range (from phaseRange arg, LEARNER_PHASE_RANGE env, or 'full'):
+ *   full         — all 7 phases required
+ *   pre-execute  — orient, strategize, plan required (phases 1–3)
+ *   post-execute — debrief, improve, memory-consolidation required (phases 5–7)
+ *
+ * Required phase artifacts: hard-fail (throw) if missing or corrupt JSON.
+ * Optional phase artifacts (outside the required range): safeReadJson + warn on null.
+ */
+export declare function harvestOutput(workingDir: string, phaseRange?: string, task?: Task): Solution;