@jinn-network/client 0.1.2 → 0.1.3-canary.12cf8b76

package/dist/harnesses/impls/prediction-v1-evaluator/index.js

@@ -0,0 +1,219 @@
+/**
+ * prediction-v1-evaluator — deterministic Brier scorer for Polymarket Tasks.
+ */
+import { createHash } from 'node:crypto';
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { REQUIRES_LIVE_DAEMON_READINESS } from '../../types.js';
+import { SignedEnvelopeSchema } from '../../../types/envelope.js';
+import { PredictionV1TaskSchema } from '../../../types/prediction-v1.js';
+import { PredictionV1RestorationPayloadSchema, } from '../../../types/payloads/prediction-v1.js';
+import { canonicalJson } from '../../engine/canonical-json.js';
+import { RESTORATION_ENVELOPE_CID_CONTEXT_KEY, RESTORATION_TASK_CID_CONTEXT_KEY, } from '../evaluation-context.js';
+import { checkManifestSignature, checkTaskRef, checkTaskRefMissingExpected, recomputeTopLevelSignatureHash, } from '../prediction-v0-evaluator/checks/integrity.js';
+import { getResolution, } from '../../../venues/polymarket/client.js';
+export class PredictionV1Evaluator {
+    config;
+    name = 'prediction-v1-evaluator';
+    version = '1.0.0';
+    constructor(config = {}) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.solverType === 'prediction.v1' && ctx.role === 'evaluation';
+    }
+    async isReady() {
+        if (this.config.stub)
+            return { ...REQUIRES_LIVE_DAEMON_READINESS };
+        return { ready: true };
+    }
+    async canAttempt(task) {
+        if (task.solverType !== 'prediction.v1')
+            return { ok: false, reason: 'solverType is not prediction.v1' };
+        if (task.role !== 'evaluation')
+            return { ok: false, reason: 'role is not evaluation' };
+        if (typeof task.context?.['restorationResult'] !== 'string') {
+            return { ok: false, reason: 'context.restorationResult required' };
+        }
+        if (typeof task.context?.[RESTORATION_TASK_CID_CONTEXT_KEY] !== 'string') {
+            return { ok: false, reason: `context.${RESTORATION_TASK_CID_CONTEXT_KEY} required` };
+        }
+        return { ok: true };
+    }
+    async run(ctx) {
+        if (this.config.stub) {
+            throw new Error('prediction-v1-evaluator: stub registry cannot run evaluation (requires live daemon)');
+        }
+        const task = PredictionV1TaskSchema.parse(ctx.task);
+        const ids = task.spec.source.identifiers;
+        const checks = [];
+        const manifestJson = ctx.task.context['restorationResult'];
+        const rawEnvelope = JSON.parse(manifestJson);
+        const solutionEnvelopeSha256 = createHash('sha256').update(canonicalJson(rawEnvelope)).digest('hex');
+        const solutionEnvelopeCid = ctx.task.context?.[RESTORATION_ENVELOPE_CID_CONTEXT_KEY]
+            ?? ctx.task.restorationRequestId
+            ?? '';
+        let solution = null;
+        try {
+            const envelope = SignedEnvelopeSchema.parse(rawEnvelope);
+            if (envelope.solverType !== 'prediction.v1' || envelope.role !== 'restoration') {
+                checks.push({
+                    name: 'solution.envelope',
+                    status: 'FAIL',
+                    detail: `expected prediction.v1/restoration, got ${envelope.solverType}/${envelope.role}`,
+                });
+            }
+            else {
+                checks.push({ name: 'solution.envelope', status: 'PASS' });
+            }
+            checks.push(await checkManifestSignature(recomputeTopLevelSignatureHash(rawEnvelope), envelope.signature));
+            const expectedTaskCid = ctx.task.context?.[RESTORATION_TASK_CID_CONTEXT_KEY];
+            if (expectedTaskCid) {
+                checks.push(checkTaskRef(envelope.task.cid, expectedTaskCid));
+            }
+            else {
+                checks.push(checkTaskRefMissingExpected());
+            }
+            solution = PredictionV1RestorationPayloadSchema.parse(envelope.payload);
+            checks.push({ name: 'solution.schema', status: 'PASS' });
+        }
+        catch (err) {
+            checks.push({
+                name: 'solution.schema',
+                status: 'FAIL',
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        if (solution) {
+            const submittedAt = Date.parse(solution.submittedAt);
+            if (Number.isFinite(submittedAt) && submittedAt >= task.window.startTs && submittedAt <= task.window.endTs) {
+                checks.push({ name: 'solution.window', status: 'PASS' });
+            }
+            else {
+                checks.push({
+                    name: 'solution.window',
+                    status: 'FAIL',
+                    detail: { submittedAt: solution.submittedAt, window: task.window },
+                });
+            }
+        }
+        const resolution = await this.readResolution(ids.marketId, ids.conditionId, task.spec.source.url);
+        checks.push(checkResolutionIdentity(resolution, ids));
+        if (resolution.status === 'resolved') {
+            checks.push({ name: 'market.resolution', status: 'PASS' });
+        }
+        else if (resolution.status === 'unresolved') {
+            checks.push({ name: 'market.resolution', status: 'INDETERMINATE' });
+        }
+        else {
+            checks.push({ name: 'market.resolution', status: 'FAIL', detail: resolution.status });
+        }
+        const verdict = deriveVerdict(checks, resolution);
+        const scores = verdict === 'SCORED' && solution && resolution.outcome
+            ? scoreBrier(solution.probabilityYes, task.spec.consensusSnapshot.probabilityYes, resolution.outcome)
+            : undefined;
+        const payload = {
+            verdict,
+            ...(resolution.outcome ? { outcome: resolution.outcome } : verdict === 'INVALID' ? { outcome: 'INVALID' } : {}),
+            ...(resolution.resolvedAt ? { resolvedAt: resolution.resolvedAt } : {}),
+            resolutionSource: {
+                venue: 'polymarket',
+                url: resolution.sourceUrl,
+                marketId: ids.marketId,
+                conditionId: ids.conditionId,
+            },
+            task: {
+                cid: ctx.taskCid ?? '',
+                id: task.id,
+            },
+            solutionEnvelope: {
+                cid: solutionEnvelopeCid,
+                sha256: solutionEnvelopeSha256,
+            },
+            ...(solution
+                ? {
+                    claimed: {
+                        probabilityYes: solution.probabilityYes,
+                        submittedAt: solution.submittedAt,
+                        modelId: solution.modelId,
+                    },
+                }
+                : {}),
+            benchmark: {
+                probabilityYes: task.spec.consensusSnapshot.probabilityYes,
+                sampledAt: task.spec.consensusSnapshot.sampledAt,
+                method: task.spec.consensusSnapshot.method,
+            },
+            ...(scores ? { scores } : {}),
+            checks,
+        };
+        writeFileSync(join(ctx.workingDir, 'prediction-v1-verdict.json'), JSON.stringify(payload, null, 2));
+        return {
+            venueRef: { name: 'polymarket' },
+            gating: {
+                verdict,
+                outcome: resolution.outcome ?? resolution.status,
+                ...(scores ?? {}),
+            },
+            informational: {
+                resolution,
+            },
+            verdictPayload: payload,
+            artifacts: [
+                {
+                    path: 'prediction-v1-verdict.json',
+                    artifactType: 'prediction_v1_verdict',
+                    metadata: { verdict, ...(scores ?? {}) },
+                    access: { priceUsdc: '0' },
+                },
+            ],
+        };
+    }
+    async readResolution(marketId, conditionId, sourceUrl) {
+        const read = this.config._testDeps?.getResolution ?? getResolution;
+        return read({ marketId, conditionId, sourceUrl });
+    }
+}
+function deriveVerdict(checks, resolution) {
+    if (checks.some((check) => check.status === 'FAIL' && check.name !== 'market.resolution'))
+        return 'REJECTED';
+    if (checks.some((check) => check.status === 'INDETERMINATE'))
+        return 'INDETERMINATE';
+    if (resolution.status === 'resolved' && resolution.outcome)
+        return 'SCORED';
+    if (resolution.status === 'unresolved')
+        return 'INDETERMINATE';
+    return 'INVALID';
+}
+function checkResolutionIdentity(resolution, ids) {
+    const marketMatches = resolution.marketId === ids.marketId;
+    const conditionMatches = resolution.conditionId.toLowerCase() === ids.conditionId.toLowerCase();
+    if (marketMatches && conditionMatches) {
+        return { name: 'market.identity', status: 'PASS' };
+    }
+    return {
+        name: 'market.identity',
+        status: 'FAIL',
+        detail: {
+            expectedMarketId: ids.marketId,
+            actualMarketId: resolution.marketId,
+            expectedConditionId: ids.conditionId,
+            actualConditionId: resolution.conditionId,
+        },
+    };
+}
+function scoreBrier(probabilityYes, consensusProbabilityYes, outcome) {
+    const target = outcome === 'YES' ? 1 : 0;
+    const solver = Number(probabilityYes);
+    const consensus = Number(consensusProbabilityYes);
+    const solverBrier = (solver - target) ** 2;
+    const consensusBrier = (consensus - target) ** 2;
+    return {
+        scoreBasis: 'brier-loss.v1',
+        solverBrier: solverBrier.toFixed(6),
+        consensusBrier: consensusBrier.toFixed(6),
+        brierSpread: (solverBrier - consensusBrier).toFixed(6),
+    };
+}
+export default PredictionV1Evaluator;
+//# sourceMappingURL=index.js.map

package/dist/harnesses/impls/prediction-v1-evaluator/index.js.map

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

package/dist/harnesses/impls/swe-rebench-v2-evaluator/eval-runner.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Thin Python-subprocess wrapper around `scripts/eval.py` from the upstream
+ * SWE-rebench/SWE-rebench-V2 repo (MIT). Operators install the upstream
+ * harness as a Python dependency; this runner shells out and parses the
+ * structured JSON report.
+ */
+import type { EvalRunner } from './index.js';
+export interface PythonEvalRunnerOptions {
+    /** Path to the cloned SWE-rebench-V2 repo (cached locally). */
+    upstreamRepoDir: string;
+    /** Override Python executable. Defaults to `python3`. */
+    pythonBin?: string;
+    /** Workers for parallel eval (defaults to 1; we run one task at a time). */
+    maxWorkers?: number;
+}
+export declare class PythonEvalRunner implements EvalRunner {
+    private readonly opts;
+    constructor(opts: PythonEvalRunnerOptions);
+    runEval(args: Parameters<EvalRunner['runEval']>[0]): ReturnType<EvalRunner['runEval']>;
+}

package/dist/harnesses/impls/swe-rebench-v2-evaluator/eval-runner.js

@@ -0,0 +1,88 @@
+/**
+ * Thin Python-subprocess wrapper around `scripts/eval.py` from the upstream
+ * SWE-rebench/SWE-rebench-V2 repo (MIT). Operators install the upstream
+ * harness as a Python dependency; this runner shells out and parses the
+ * structured JSON report.
+ */
+import { spawn } from 'node:child_process';
+import { mkdtemp, writeFile, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+export class PythonEvalRunner {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async runEval(args) {
+        const tmp = await mkdtemp(join(tmpdir(), 'swerebench-eval-'));
+        // Single-task runner: we use the placeholder instance_id "task" in both
+        // the task spec and the patches override; eval.py matches them by id.
+        const INSTANCE_ID = 'task';
+        const taskJson = [{
+                instance_id: INSTANCE_ID,
+                image_name: args.image,
+                FAIL_TO_PASS: args.fail_to_pass,
+                PASS_TO_PASS: args.pass_to_pass,
+                test_patch: args.test_patch,
+                install_config: { test_cmd: args.test_cmd, log_parser: args.log_parser },
+            }];
+        // Upstream eval.py expects --patches to be a JSON list of
+        // `{instance_id, patch, test_patch?}` overrides keyed by instance_id.
+        const patchesJson = [{ instance_id: INSTANCE_ID, patch: args.patch }];
+        const taskJsonPath = join(tmp, 'task.json');
+        const patchesJsonPath = join(tmp, 'patches.json');
+        const reportPath = join(tmp, 'report.json');
+        await writeFile(taskJsonPath, JSON.stringify(taskJson));
+        await writeFile(patchesJsonPath, JSON.stringify(patchesJson));
+        const pyArgs = [
+            '-m', 'scripts.eval',
+            '--json', taskJsonPath,
+            '--patches', patchesJsonPath,
+            '--max-workers', String(this.opts.maxWorkers ?? 1),
+            '--report-json', reportPath,
+        ];
+        const child = spawn(this.opts.pythonBin ?? 'python3', pyArgs, {
+            cwd: this.opts.upstreamRepoDir,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stderr = '';
+        child.stderr.on('data', (d) => { stderr += d.toString(); });
+        let stdout = '';
+        child.stdout.on('data', (d) => { stdout += d.toString(); });
+        const exitCode = await new Promise((resolve, reject) => {
+            child.on('close', (code) => resolve(code ?? 1));
+            child.on('error', reject);
+        });
+        let report;
+        try {
+            report = JSON.parse(await readFile(reportPath, 'utf8'));
+        }
+        catch {
+            await rm(tmp, { recursive: true, force: true });
+            throw new Error(`Eval runner failed: exitCode=${exitCode}, stderr=${stderr.slice(-500)}`);
+        }
+        // Upstream report shape: { total, passed, items: [{instance_id, passed_match,
+        // from_fail_to_pass, failed_from_pass_to_pass, exit_code, log_path, error}] }.
+        const items = Array.isArray(report.items) ? report.items : [];
+        const item = items.find((i) => i['instance_id'] === INSTANCE_ID) ?? items[0] ?? {};
+        let logBody = '';
+        const logPath = item['log_path'];
+        if (typeof logPath === 'string' && logPath.length > 0) {
+            try {
+                logBody = await readFile(logPath, 'utf8');
+            }
+            catch {
+                logBody = '';
+            }
+        }
+        await rm(tmp, { recursive: true, force: true });
+        return {
+            passed_match: item['passed_match'] === true,
+            passed: Array.isArray(item['from_fail_to_pass']) ? item['from_fail_to_pass'] : [],
+            failed: Array.isArray(item['failed_from_pass_to_pass']) ? item['failed_from_pass_to_pass'] : [],
+            log: stdout + logBody,
+            exitCode,
+        };
+    }
+}
+//# sourceMappingURL=eval-runner.js.map

package/dist/harnesses/impls/swe-rebench-v2-evaluator/eval-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval-runner.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/swe-rebench-v2-evaluator/eval-runner.ts"],"names":[],"mappings":"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"}

package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SWE-rebench v2 evaluator. Wraps the upstream `scripts/eval.py` (MIT) to
+ * grade Solver patches against the per-instance Docker test suite.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §3.4
+ */
+import type { SweRebenchV2Task, SweRebenchV2SolutionPayload, SweRebenchV2VerdictPayload } from '../../../vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2.js';
+export interface HfRow {
+    instance_id: string;
+    image_name: string;
+    FAIL_TO_PASS: string[];
+    PASS_TO_PASS: string[];
+    test_patch: string;
+    install_config: {
+        test_cmd: string | string[];
+        log_parser: string;
+    };
+}
+export interface HfFetcher {
+    fetchTaskRow(args: {
+        hf_dataset: string;
+        hf_split: string;
+        instance_id: string;
+    }): Promise<HfRow>;
+}
+export interface EvalRunner {
+    runEval(args: {
+        image: string;
+        patch: string;
+        test_patch: string;
+        test_cmd: string | string[];
+        log_parser: string;
+        fail_to_pass: string[];
+        pass_to_pass: string[];
+    }): Promise<{
+        passed_match: boolean;
+        passed: string[];
+        failed: string[];
+        log: string;
+        exitCode: number;
+    }>;
+}
+export interface GradeArgs {
+    task: SweRebenchV2Task;
+    solutionPayload: SweRebenchV2SolutionPayload;
+}
+export declare class SweRebenchV2Evaluator {
+    private readonly deps;
+    constructor(deps: {
+        fetcher: HfFetcher;
+        runner: EvalRunner;
+    });
+    grade(args: GradeArgs): Promise<SweRebenchV2VerdictPayload & {
+        test_log: string;
+    }>;
+}

package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.js

@@ -0,0 +1,40 @@
+/**
+ * SWE-rebench v2 evaluator. Wraps the upstream `scripts/eval.py` (MIT) to
+ * grade Solver patches against the per-instance Docker test suite.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §3.4
+ */
+export class SweRebenchV2Evaluator {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async grade(args) {
+        const row = await this.deps.fetcher.fetchTaskRow({
+            hf_dataset: args.task.hf_dataset,
+            hf_split: args.task.hf_split,
+            instance_id: args.task.instance_id,
+        });
+        if (!row.image_name) {
+            throw new Error(`HF row for ${args.task.instance_id} missing image_name`);
+        }
+        const result = await this.deps.runner.runEval({
+            image: row.image_name,
+            patch: args.solutionPayload.patch,
+            test_patch: row.test_patch,
+            test_cmd: row.install_config.test_cmd,
+            log_parser: row.install_config.log_parser,
+            fail_to_pass: row.FAIL_TO_PASS,
+            pass_to_pass: row.PASS_TO_PASS,
+        });
+        return {
+            schemaVersion: 'swe-rebench-v2-verdict.v1',
+            score: result.passed_match ? 1 : 0,
+            passed_match: result.passed_match,
+            test_log_cid: '', // populated by caller after IPFS pin
+            evaluator_cost_usd: 0, // populated by caller from runtime metrics
+            test_log: result.log,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/swe-rebench-v2-evaluator/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4CH,MAAM,OAAO,qBAAqB;IAEb;IADnB,YACmB,IAAgD;QAAhD,SAAI,GAAJ,IAAI,CAA4C;IAChE,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,IAAe;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;YAC/C,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAChC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC5B,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;SACnC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,WAAW,qBAAqB,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAC5C,KAAK,EAAE,GAAG,CAAC,UAAU;YACrB,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK;YACjC,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,GAAG,CAAC,cAAc,CAAC,QAAQ;YACrC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,UAAU;YACzC,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAC,CAAC;QACH,OAAO;YACL,aAAa,EAAE,2BAA2B;YAC1C,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,YAAY,EAAE,EAAE,EAAG,qCAAqC;YACxD,kBAAkB,EAAE,CAAC,EAAG,2CAA2C;YACnE,QAAQ,EAAE,MAAM,CAAC,GAAG;SACrB,CAAC;IACJ,CAAC;CACF"}

package/dist/harnesses/manifest/index.d.ts

@@ -0,0 +1,3 @@
+export { loadManifest } from './load.js';
+export { canonicaliseManifest, verifyManifestSignature } from './verify.js';
+export type { JinnManifest, SignerTrustEntry, CapabilityAllowEntry, ManifestRpcAllow, TypedDataAllowEntry, } from './types.js';

package/dist/harnesses/manifest/index.js

@@ -0,0 +1,3 @@
+export { loadManifest } from './load.js';
+export { canonicaliseManifest, verifyManifestSignature } from './verify.js';
+//# sourceMappingURL=index.js.map

package/dist/harnesses/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harnesses/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/harnesses/manifest/load.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Load a `jinn.manifest.json` from disk and validate it against the
+ * Jinn manifest JSON Schema. Pure (no signature verification — that is
+ * `verifyManifestSignature` in `verify.ts`).
+ */
+import type { JinnManifest } from './types.js';
+export declare function loadManifest(absPath: string): Promise<JinnManifest>;

package/dist/harnesses/manifest/load.js

@@ -0,0 +1,49 @@
+/**
+ * Load a `jinn.manifest.json` from disk and validate it against the
+ * Jinn manifest JSON Schema. Pure (no signature verification — that is
+ * `verifyManifestSignature` in `verify.ts`).
+ */
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { resolve } from 'node:path';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import * as addFormatsModule from 'ajv-formats';
+// `ajv-formats` is published as CJS; under Node16 module resolution
+// the callable plugin lives on `.default`.
+const addFormats = addFormatsModule
+    .default;
+const SCHEMA_PATH = fileURLToPath(new URL('../../../schemas/jinn-manifest-v1.json', import.meta.url));
+let validatorPromise = null;
+let lastValidator;
+async function getValidator() {
+    if (validatorPromise)
+        return validatorPromise;
+    validatorPromise = (async () => {
+        const ajv = new Ajv2020({ allErrors: true, strict: false });
+        addFormats(ajv);
+        const schema = JSON.parse(await readFile(SCHEMA_PATH, 'utf8'));
+        const compiled = ajv.compile(schema);
+        lastValidator = compiled;
+        return compiled;
+    })();
+    return validatorPromise;
+}
+export async function loadManifest(absPath) {
+    const text = await readFile(resolve(absPath), 'utf8');
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        throw new Error(`manifest at ${absPath} is not valid JSON: ${err.message}`);
+    }
+    const validate = await getValidator();
+    if (!validate(parsed)) {
+        const errs = (lastValidator?.errors ?? [])
+            .map((e) => `${e.instancePath} ${e.message}`)
+            .join('; ');
+        throw new Error(`manifest at ${absPath} failed schema validation: ${errs}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=load.js.map

package/dist/harnesses/manifest/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/harnesses/manifest/load.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC;AAEhD,oEAAoE;AACpE,2CAA2C;AAC3C,MAAM,UAAU,GAAI,gBAA4D;KAC7E,OAAO,CAAC;AAGX,MAAM,WAAW,GAAG,aAAa,CAC/B,IAAI,GAAG,CAAC,wCAAwC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CACnE,CAAC;AAEF,IAAI,gBAAgB,GAA4C,IAAI,CAAC;AACrE,IAAI,aAEH,CAAC;AAEF,KAAK,UAAU,YAAY;IACzB,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAC9C,gBAAgB,GAAG,CAAC,KAAK,IAAI,EAAE;QAC7B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,UAAU,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAElC,CAAC;QACF,aAAa,GAAG,QAAQ,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,uBAAwB,GAAa,CAAC,OAAO,EAAE,CACtE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,IAAI,EAAE,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;aAC5C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,8BAA8B,IAAI,EAAE,CAC3D,CAAC;IACJ,CAAC;IACD,OAAO,MAAsB,CAAC;AAChC,CAAC"}

package/dist/harnesses/manifest/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Daemon-side manifest types. Same shape as the SDK manifest type;
+ * mirrored locally so the client doesn't have to depend on
+ * @jinn-network/sdk/harness at runtime (the SDK is a publish-time
+ * boundary).
+ */
+export interface CapabilityAllowEntry {
+    chainId: number;
+    to: `0x${string}`;
+    selector: `0x${string}`;
+    description?: string;
+}
+/**
+ * EIP-712 typed-data domain allow-list entry. The daemon's scoped
+ * signer refuses any `signTypedData` call whose domain does not
+ * match one of these entries.
+ *
+ * - `chainId` MUST match exactly.
+ * - `verifyingContract` / `name` / `version` match only when set on
+ *   the entry; an unset field on the entry means "any value".
+ * - An empty / omitted `typedDataDomains` array means default-deny:
+ *   every `signTypedData` call throws.
+ */
+export interface TypedDataAllowEntry {
+    chainId: number;
+    name?: string;
+    version?: string;
+    verifyingContract?: `0x${string}`;
+}
+export interface ManifestRpcAllow {
+    chainId: number;
+    methods: ReadonlyArray<'eth_call' | 'eth_getBlockByNumber' | 'eth_getLogs' | 'eth_getTransactionReceipt' | 'eth_chainId' | 'eth_blockNumber' | 'eth_getBalance' | 'eth_getCode'>;
+    rateLimit?: {
+        perSec: number;
+    };
+}
+export interface JinnManifest {
+    schemaVersion: '1.0.0';
+    name: string;
+    version: string;
+    description?: string;
+    supportedSolverTypes: readonly string[];
+    entry: string;
+    package: {
+        cid: string;
+        hash: `sha256:${string}`;
+    };
+    capabilities: {
+        signer?: {
+            selectors: ReadonlyArray<CapabilityAllowEntry>;
+            typedDataDomains?: ReadonlyArray<TypedDataAllowEntry>;
+        };
+        rpc?: ReadonlyArray<ManifestRpcAllow>;
+        secrets?: ReadonlyArray<{
+            name: string;
+            description: string;
+            required: boolean;
+        }>;
+    };
+    signature: {
+        alg: 'ed25519';
+        publicKey: string;
+        sig: string;
+    };
+    author?: {
+        name: string;
+        url?: string;
+    };
+    license?: string;
+}
+export interface SignerTrustEntry {
+    alg: 'ed25519';
+    publicKey: string;
+    label?: string;
+}

package/dist/harnesses/manifest/types.js

@@ -0,0 +1,8 @@
+/**
+ * Daemon-side manifest types. Same shape as the SDK manifest type;
+ * mirrored locally so the client doesn't have to depend on
+ * @jinn-network/sdk/harness at runtime (the SDK is a publish-time
+ * boundary).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harnesses/manifest/types.js.map

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

package/dist/harnesses/manifest/verify.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Manifest signature verifier (ed25519).
+ *
+ * Canonicalisation: RFC 8785 JCS over the manifest with the `signature`
+ * field stripped. Authors sign the resulting bytes.
+ */
+import type { JinnManifest, SignerTrustEntry } from './types.js';
+/**
+ * Canonicalise a manifest for signing/verification: RFC 8785 JCS with
+ * the signature field stripped. Recursive (nested objects sort their
+ * own keys), so a third-party verifier with any standard JCS library
+ * can reproduce the signing pre-image byte-for-byte.
+ */
+export declare function canonicaliseManifest(manifest: JinnManifest): string;
+export declare function verifyManifestSignature(manifest: JinnManifest, trustedSigners: readonly SignerTrustEntry[]): Promise<boolean>;