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

package/dist/solver-types/prediction-v0-auto.js

@@ -0,0 +1,146 @@
+/**
+ * Auto-generator for prediction.v1 tasks.
+ *
+ * Produces a fresh Task per hour bucket: reads current Chainlink
+ * price, builds a template with the configured threshold sentinel
+ * (default "current+0.5%" — coin-flip-ish, slightly biased NO), and resolves
+ * it via the shared template helper. Stable ID per hour prevents duplicate
+ * posts within a window; the CreatorLoop's SQLite cache guards against
+ * restart-replay.
+ *
+ * Wired in main.ts for testnet-only (jinn-mono-9ew). Operators can opt out
+ * with JINN_DISABLE_AUTO_TASKS=1.
+ */
+import { randomUUID } from 'node:crypto';
+import { createPublicClient, http } from 'viem';
+import { base, baseSepolia } from 'viem/chains';
+import { readChainlinkLatest, scaleToDecimal } from '../venues/chainlink/client.js';
+import { resolvePredictionV1Template } from './prediction-v0-template.js';
+import { signTaskV1 } from '../tasks/signing.js';
+// ── Generator factory ──────────────────────────────────────────────────────────
+/**
+ * Build a generator closure. Calling the closure returns a freshly-resolved
+ * Task for the current hour bucket, or null if Chainlink is
+ * unreachable (caller skips this tick).
+ */
+export function makePredictionV1Generator(config) {
+    const threshold = config.thresholdSentinel ?? 'current+0.5%';
+    const operator = config.operator ?? 'GT';
+    const windowDurationMs = config.windowDurationMs ?? 600_000; // 10 min default (fast-test)
+    const resolveGapMs = config.resolveGapMs ?? 300_000; // 5 min default
+    // Lazy publicClient construction — reused across calls.
+    let publicClient = config._publicClient ?? null;
+    const getPublicClient = () => {
+        if (publicClient)
+            return publicClient;
+        const chain = config.venue === 'chainlink-base' ? base : baseSepolia;
+        const rpcUrl = config.rpcUrl ?? (config.venue === 'chainlink-base'
+            ? 'https://mainnet.base.org'
+            : 'https://sepolia.base.org');
+        publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+        return publicClient;
+    };
+    return async () => {
+        // Bucket start = windowDurationMs boundary ≤ now. Stable ID per bucket
+        // prevents duplicate posts within the same window.
+        const now = Date.now();
+        const startTs = Math.floor(now / windowDurationMs) * windowDurationMs;
+        const endTs = startTs + windowDurationMs;
+        const resolveTs = endTs + resolveGapMs;
+        const template = {
+            id: `pred-v1-auto-${startTs}`,
+            solverType: 'prediction.v1',
+            description: `Auto-generated prediction.v1 task — ${config.feedDescription} ${operator} ${threshold} at ${new Date(resolveTs).toISOString()}`,
+            window: { startTs, endTs },
+            spec: {
+                oracle: {
+                    venue: config.venue,
+                    feed: config.feed,
+                    feedDescription: config.feedDescription,
+                },
+                question: {
+                    kind: 'threshold',
+                    operator,
+                    threshold,
+                    resolveTs,
+                },
+            },
+            eligibility: { maxSubmissionDelayMs: 60_000 },
+            claimPolicy: {
+                mode: 'parallel',
+                maxClaims: 25,
+                maxClaimsPerOperator: 1,
+                claimWindowStartTs: startTs,
+                claimWindowEndTs: endTs,
+                submissionDeadlineTs: endTs,
+                claimLeaseTtlSeconds: Math.max(60, Math.floor((endTs - startTs) / 1000)),
+            },
+        };
+        try {
+            const resolved = await resolvePredictionV1Template(template, {
+                readCurrent: async ({ feed }) => {
+                    const reading = await readChainlinkLatest(feed, getPublicClient());
+                    return scaleToDecimal(reading.answer, reading.decimals);
+                },
+            });
+            // When signing credentials AND a SolverNet manifest CID are available,
+            // produce a SignedTaskV1 and embed it in the Task's `task` field so
+            // MechAdapter's `state.signedTask ?? buildTaskPayload(...)` path picks
+            // it up. Without a `solverNetManifestCid` we cannot derive the on-chain
+            // `manifestDigest` (spec §14, Task 24) — fall back to the unsigned shape.
+            if (config.agentEoa &&
+                config.safeAddress &&
+                config.agentPrivateKey &&
+                config.solverNetManifestCid) {
+                const taskDoc = {
+                    schemaVersion: 'task.v1',
+                    id: resolved.id ?? randomUUID(),
+                    solverType: 'prediction.v1',
+                    contractId: 'prediction',
+                    contractVersion: 'v1',
+                    solverNetManifestCid: config.solverNetManifestCid,
+                    role: 'restoration',
+                    description: resolved.description,
+                    window: resolved.window,
+                    spec: resolved.spec,
+                    eligibility: resolved.eligibility ?? {},
+                    claimPolicy: template.claimPolicy,
+                    creator: {
+                        safeAddress: config.safeAddress,
+                        agentEoa: config.agentEoa,
+                    },
+                    createdAt: Date.now(),
+                };
+                const signed = await signTaskV1(taskDoc, config.agentPrivateKey);
+                const task = {
+                    ...resolved,
+                    solverType: 'prediction.v1',
+                    contractId: 'prediction',
+                    contractVersion: 'v1',
+                    solverNetManifestCid: config.solverNetManifestCid,
+                    claimPolicy: template.claimPolicy,
+                    spec: Object.fromEntries(Object.entries((resolved.spec ?? {})).filter(([key]) => key !== 'kind')),
+                };
+                return { ...task, signedTask: signed };
+            }
+            // No signing credentials (or no manifest CID) — return the resolved
+            // shape without a signed task.
+            return {
+                ...resolved,
+                solverType: 'prediction.v1',
+                contractId: 'prediction',
+                contractVersion: 'v1',
+                ...(config.solverNetManifestCid
+                    ? { solverNetManifestCid: config.solverNetManifestCid }
+                    : {}),
+                claimPolicy: template.claimPolicy,
+                spec: Object.fromEntries(Object.entries((resolved.spec ?? {})).filter(([key]) => key !== 'kind')),
+            };
+        }
+        catch {
+            // Chainlink read failure or schema mismatch — skip this tick, try next.
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=prediction-v0-auto.js.map

package/dist/solver-types/prediction-v0-auto.js.map

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

package/dist/solver-types/prediction-v0-template.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Sentinel resolution for prediction.v1 Task templates.
+ *
+ * Two sentinels are supported in template JSON (e.g.,
+ * `client/fixtures/prediction-v1-task.example.json`):
+ *
+ *   1. window.startTs = 0 → rewritten as Date.now() at call time; the rest of
+ *      the window (endTs) and resolveTs are computed relative to that.
+ *
+ *   2. spec.question.threshold = "current[±N[%]]" → read the Chainlink feed
+ *      named in spec.oracle and substitute an absolute price:
+ *
+ *        "current"         → current price exactly
+ *        "current+0.5%"    → current × 1.005
+ *        "current-2%"      → current × 0.98
+ *        "current+100"     → current + 100
+ *        "current-50"      → current - 50
+ *
+ *      The on-chain Task always carries an absolute decimal string; the
+ *      sentinel is ONLY resolved at post time. Evaluator + Harnesses
+ *      never see the sentinel form.
+ *
+ * Exported as a pure function with a `readCurrent` dep so it's trivially
+ * unit-testable. Both the `jinn tasks submit --spec-file` path and the
+ * future auto-generator (jinn-mono-9ew) call through this helper.
+ */
+import { type PredictionV1Task } from '../types/prediction.js';
+/** Returns true iff the given value looks like a "current[±N[%]]" sentinel. */
+export declare function isCurrentSentinel(value: unknown): boolean;
+export interface TemplateReaderDeps {
+    /**
+     * Read the current price of the Chainlink feed referenced in the template.
+     * Required only when the template uses a `current[±…]` threshold sentinel
+     * (see {@link predictionV1TemplateNeedsReadCurrent}).
+     */
+    readCurrent?: (args: {
+        feed: `0x${string}`;
+        venue: 'chainlink-base' | 'chainlink-base-sepolia';
+    }) => Promise<string>;
+    /**
+     * Window duration when the template uses `window.startTs = 0` (now-relative
+     * sentinel). Default: 10 min — syncs with the 15-min fast-test epoch cadence
+     * on testnet. Set to 3_600_000 for a 1h window (mainnet-style dogfood).
+     */
+    windowDurationMs?: number;
+    /**
+     * Resolve gap when the template uses `window.startTs = 0`. Default: 5 min.
+     * `resolveTs = endTs + resolveGapMs`. Bounded by schema to ≤ 1h.
+     */
+    resolveGapMs?: number;
+}
+/** Default window duration for the startTs-sentinel fill. Tuned for fast-test. */
+export declare const DEFAULT_WINDOW_DURATION_MS = 600000;
+/** Default resolve gap for the startTs-sentinel fill. Tuned for fast-test. */
+export declare const DEFAULT_RESOLVE_GAP_MS = 300000;
+/**
+ * True if {@link resolvePredictionV1Template} will call `readCurrent` for this
+ * template (Chainlink). `window.startTs === 0` does not need `readCurrent`.
+ */
+export declare function predictionV1TemplateNeedsReadCurrent(template: unknown): boolean;
+/**
+ * Resolve all supported sentinels in a raw prediction.v1 template + return a
+ * parsed, validated PredictionV1Task.
+ *
+ * The template must be the JSON shape of a PredictionV1Task with optional
+ * sentinel values. Callers that build the template from multiple sources
+ * (CLI --spec-file + --id + --description) should merge their bits BEFORE
+ * calling this helper.
+ */
+export declare function resolvePredictionV1Template(template: unknown, deps: TemplateReaderDeps): Promise<PredictionV1Task>;

package/dist/solver-types/prediction-v0-template.js

@@ -0,0 +1,145 @@
+/**
+ * Sentinel resolution for prediction.v1 Task templates.
+ *
+ * Two sentinels are supported in template JSON (e.g.,
+ * `client/fixtures/prediction-v1-task.example.json`):
+ *
+ *   1. window.startTs = 0 → rewritten as Date.now() at call time; the rest of
+ *      the window (endTs) and resolveTs are computed relative to that.
+ *
+ *   2. spec.question.threshold = "current[±N[%]]" → read the Chainlink feed
+ *      named in spec.oracle and substitute an absolute price:
+ *
+ *        "current"         → current price exactly
+ *        "current+0.5%"    → current × 1.005
+ *        "current-2%"      → current × 0.98
+ *        "current+100"     → current + 100
+ *        "current-50"      → current - 50
+ *
+ *      The on-chain Task always carries an absolute decimal string; the
+ *      sentinel is ONLY resolved at post time. Evaluator + Harnesses
+ *      never see the sentinel form.
+ *
+ * Exported as a pure function with a `readCurrent` dep so it's trivially
+ * unit-testable. Both the `jinn tasks submit --spec-file` path and the
+ * future auto-generator (jinn-mono-9ew) call through this helper.
+ */
+import { PredictionV1TaskSchema, } from '../types/prediction.js';
+import { PREDICTION_V1_KIND } from './constants.js';
+// ── Sentinel parsers ──────────────────────────────────────────────────────────
+/**
+ * Parse a `current[±N[%]]` sentinel. Returns a function that takes the current
+ * price (decimal string) and produces an absolute threshold (decimal string).
+ * Throws if the sentinel doesn't match the expected grammar.
+ */
+function parseCurrentSentinel(sentinel) {
+    if (sentinel === 'current') {
+        return (current) => current;
+    }
+    const match = sentinel.match(/^current([+-])(\d+(?:\.\d+)?)(%?)$/);
+    if (!match) {
+        throw new Error(`invalid threshold sentinel: ${JSON.stringify(sentinel)}. ` +
+            `Expected "current" or "current±N" or "current±N%" (e.g., "current+0.5%").`);
+    }
+    const [, sign, numStr, pct] = match;
+    const delta = parseFloat(numStr);
+    if (!Number.isFinite(delta) || delta < 0) {
+        throw new Error(`invalid threshold sentinel magnitude: ${numStr}`);
+    }
+    return (current) => {
+        const curNum = parseFloat(current);
+        if (!Number.isFinite(curNum) || curNum < 0) {
+            throw new Error(`invalid current price for sentinel resolution: ${current}`);
+        }
+        const offset = pct ? curNum * (delta / 100) : delta;
+        const signed = sign === '+' ? offset : -offset;
+        const result = curNum + signed;
+        // 4 decimal places is plenty of resolution for price comparisons.
+        // Strip trailing zeros for human-readable output.
+        return result.toFixed(4).replace(/\.?0+$/, '');
+    };
+}
+/** Returns true iff the given value looks like a "current[±N[%]]" sentinel. */
+export function isCurrentSentinel(value) {
+    return typeof value === 'string' && /^current([+-]\d+(\.\d+)?%?)?$/.test(value);
+}
+/** Default window duration for the startTs-sentinel fill. Tuned for fast-test. */
+export const DEFAULT_WINDOW_DURATION_MS = 600_000;
+/** Default resolve gap for the startTs-sentinel fill. Tuned for fast-test. */
+export const DEFAULT_RESOLVE_GAP_MS = 300_000;
+/**
+ * True if {@link resolvePredictionV1Template} will call `readCurrent` for this
+ * template (Chainlink). `window.startTs === 0` does not need `readCurrent`.
+ */
+export function predictionV1TemplateNeedsReadCurrent(template) {
+    if (typeof template !== 'object' || template === null)
+        return false;
+    const t = template;
+    const spec = t['spec'];
+    if ((t['solverType'] ?? PREDICTION_V1_KIND) !== PREDICTION_V1_KIND)
+        return false;
+    if (spec?.question?.kind === 'threshold' && typeof spec.question.threshold === 'string') {
+        return isCurrentSentinel(spec.question.threshold);
+    }
+    return false;
+}
+/**
+ * Resolve all supported sentinels in a raw prediction.v1 template + return a
+ * parsed, validated PredictionV1Task.
+ *
+ * The template must be the JSON shape of a PredictionV1Task with optional
+ * sentinel values. Callers that build the template from multiple sources
+ * (CLI --spec-file + --id + --description) should merge their bits BEFORE
+ * calling this helper.
+ */
+export async function resolvePredictionV1Template(template, deps) {
+    if (typeof template !== 'object' || template === null) {
+        throw new Error('resolvePredictionV1Template: template must be an object');
+    }
+    // Shallow clone so we don't mutate caller's input.
+    const stub = JSON.parse(JSON.stringify(template));
+    // ── (1) window.startTs = 0 → now-relative ──────────────────────────────────
+    const windowMs = deps.windowDurationMs ?? DEFAULT_WINDOW_DURATION_MS;
+    const resolveMs = deps.resolveGapMs ?? DEFAULT_RESOLVE_GAP_MS;
+    const win = stub['window'];
+    if (win && win.startTs === 0) {
+        const now = Date.now();
+        win.startTs = now;
+        win.endTs = now + windowMs;
+        const spec = stub['spec'];
+        if (spec?.question) {
+            spec.question.resolveTs = now + windowMs + resolveMs;
+        }
+    }
+    // ── (2) spec.question.threshold sentinel → absolute price ──────────────────
+    const spec = stub['spec'];
+    if (spec &&
+        spec.question?.kind === 'threshold' &&
+        typeof spec.question.threshold === 'string') {
+        const t = spec.question.threshold;
+        if (isCurrentSentinel(t)) {
+            if (!deps.readCurrent) {
+                throw new Error('resolvePredictionV1Template: readCurrent is required when spec.question.threshold uses a current[±…] sentinel');
+            }
+            if (!spec.oracle?.feed || !spec.oracle.venue) {
+                throw new Error('cannot resolve threshold sentinel: spec.oracle.feed and spec.oracle.venue are required');
+            }
+            const current = await deps.readCurrent({
+                feed: spec.oracle.feed,
+                venue: spec.oracle.venue,
+            });
+            const resolveFn = parseCurrentSentinel(t);
+            spec.question.threshold = resolveFn(current);
+        }
+        else if (t.toLowerCase().startsWith('current')) {
+            // Eager error: looks like an intended sentinel but didn't match the grammar.
+            // Saves operators from pushing garbage on-chain only to fail at eval time.
+            throw new Error(`unknown threshold sentinel: ${JSON.stringify(t)}. ` +
+                `Expected "current" or "current±N" or "current±N%" (e.g., "current+0.5%"). ` +
+                `If you meant a literal absolute threshold, use a pure decimal string (e.g., "3000").`);
+        }
+    }
+    // Final Zod parse — all refinements (window span, resolveTs offset) enforced.
+    return PredictionV1TaskSchema.parse(stub);
+}
+//# sourceMappingURL=prediction-v0-template.js.map

package/dist/solver-types/prediction-v0-template.js.map

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

package/dist/solver-types/prediction-v0.d.ts

@@ -0,0 +1,13 @@
+import { type PredictionV1AutoConfig } from './prediction-v0-auto.js';
+import type { SolverTypeDefinition } from './solver-type.js';
+/**
+ * Legacy Chainlink prediction.v1 SolverType — retained for spec parsing only.
+ * This module is not registered in the SOLVER_TYPES dispatch table; the
+ * Polymarket-driven `predictionV1` definition in `./prediction-v1.ts` is the
+ * canonical entry. Task 22 of
+ * spec/2026-05-05-solvernet-creation-and-launch.md retired the
+ * `getTestnetAutoConfig` plumbing; existing test consumers wire
+ * `makePredictionV1Generator` (the Chainlink-specific factory in
+ * `./prediction-v0-auto.ts`) directly.
+ */
+export declare const legacyChainlinkPredictionV1: SolverTypeDefinition<PredictionV1AutoConfig>;

package/dist/solver-types/prediction-v0.js

@@ -0,0 +1,31 @@
+import { predictionV1TemplateNeedsReadCurrent, resolvePredictionV1Template, } from './prediction-v0-template.js';
+import { makePredictionV1Generator } from './prediction-v0-auto.js';
+import { PREDICTION_V1_KIND } from './constants.js';
+/**
+ * Legacy Chainlink prediction.v1 SolverType — retained for spec parsing only.
+ * This module is not registered in the SOLVER_TYPES dispatch table; the
+ * Polymarket-driven `predictionV1` definition in `./prediction-v1.ts` is the
+ * canonical entry. Task 22 of
+ * spec/2026-05-05-solvernet-creation-and-launch.md retired the
+ * `getTestnetAutoConfig` plumbing; existing test consumers wire
+ * `makePredictionV1Generator` (the Chainlink-specific factory in
+ * `./prediction-v0-auto.ts`) directly.
+ */
+export const legacyChainlinkPredictionV1 = {
+    solverType: PREDICTION_V1_KIND,
+    async parseSpec(raw, deps) {
+        if (predictionV1TemplateNeedsReadCurrent(raw) && !deps?.readCurrent) {
+            throw new Error('prediction.v1 parseSpec requires readCurrent (Chainlink) when the template uses a current[±…] threshold sentinel');
+        }
+        const task = await resolvePredictionV1Template(raw, {
+            readCurrent: deps?.readCurrent,
+        });
+        return { window: task.window, spec: task.spec, eligibility: task.eligibility };
+    },
+    buildGenerator: (config) => makePredictionV1Generator(config),
+    ui: {
+        description: 'Price threshold prediction (Chainlink oracle)',
+        category: 'prediction',
+    },
+};
+//# sourceMappingURL=prediction-v0.js.map

package/dist/solver-types/prediction-v0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prediction-v0.js","sourceRoot":"","sources":["../../src/solver-types/prediction-v0.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,yBAAyB,EAA+B,MAAM,yBAAyB,CAAC;AAEjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAiD;IACvF,UAAU,EAAE,kBAAkB;IAC9B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI;QACvB,IAAI,oCAAoC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CACb,kHAAkH,CACnH,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,2BAA2B,CAAC,GAAG,EAAE;YAClD,WAAW,EAAE,IAAI,EAAE,WAAW;SAC/B,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;IACjF,CAAC;IACD,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC;IAC7D,EAAE,EAAE;QACF,WAAW,EAAE,+CAA+C;QAC5D,QAAQ,EAAE,YAAY;KACvB;CACF,CAAC"}

package/dist/solver-types/prediction-v1-auto.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Auto-generator for prediction.v1 Polymarket forecast rounds.
+ */
+import type { Task } from '../types/task.js';
+import type { LaunchedSolverNetRecord } from '../solvernets/store.js';
+import { type PolymarketClientConfig } from '../venues/polymarket/client.js';
+export interface PredictionV1AutoConfig extends PolymarketClientConfig {
+    minTimeToResolutionHours?: number;
+    maxTimeToResolutionHours?: number;
+    minLiquidityUsd?: string;
+    minVolume24hUsd?: string;
+    maxYesSpread?: string;
+    maxOrderbookAgeSeconds?: number;
+    cadenceMs?: number;
+    maxNewRoundsPerPoll?: number;
+    maxNewRoundsPerDay?: number;
+    maxOpenRounds?: number;
+    submissionWindowMs?: number;
+    agentEoa?: `0x${string}`;
+    safeAddress?: `0x${string}`;
+    agentPrivateKey?: `0x${string}`;
+    allowlistConditionIds?: string[];
+    blocklistConditionIds?: string[];
+}
+/**
+ * Persistent state observable via `getState()` (Task 5 of
+ * spec/2026-05-05-launcher-role-and-mode.md §5.3). The launcher status
+ * endpoint surfaces these fields verbatim. Stale-poll detection
+ * (lastPollAt + 2*cadence) is computed by the endpoint, not here.
+ */
+export type PredictionV1SkipReason = 'already_posted' | 'blocklisted' | 'no_rules_text' | 'low_liquidity' | 'low_volume' | 'invalid_resolution_time' | 'too_soon' | 'too_late' | 'resolution_fetch_failed' | 'already_resolved' | 'inactive_or_closed' | 'orderbook_fetch_failed' | 'orderbook_stale' | 'spread_too_wide';
+export interface PredictionV1GeneratorState {
+    lastPollAt?: string;
+    lastPollSummary?: {
+        evaluated: number;
+        posted: number;
+        skipped: number;
+        skipReasons?: Partial<Record<PredictionV1SkipReason, number>>;
+    };
+    lastError?: {
+        message: string;
+        at: string;
+    };
+}
+export interface PredictionV1GeneratorStateSnapshot extends PredictionV1GeneratorState {
+    cadenceMs: number;
+}
+export type PredictionV1GeneratorTick = (() => Promise<Task[] | null>) & {
+    getState(): PredictionV1GeneratorStateSnapshot;
+};
+/**
+ * Hot-applyable subset of `PredictionV1AutoConfig`. Anything in here can be
+ * edited at runtime through the SolverNet config API endpoint (Task 14) and
+ * picked up within one generator cadence — the daemon updates
+ * `configRef.current` and persists to disk; the next tick reads the new
+ * value through the closure.
+ *
+ * Kept narrow on purpose: agent identity (EOA / Safe / private key) and the
+ * polymarket transport (`fetchImpl`, base URLs) are captured once at
+ * construction time and live in `staticConfig` below.
+ */
+export interface PredictionV1GeneratorRuntimeConfig {
+    cadenceMs?: number;
+    maxNewRoundsPerPoll?: number;
+    maxNewRoundsPerDay?: number;
+    maxOpenRounds?: number;
+    submissionWindowMs?: number;
+    allowlistConditionIds?: string[];
+    blocklistConditionIds?: string[];
+    minTimeToResolutionHours?: number;
+    maxTimeToResolutionHours?: number;
+    minLiquidityUsd?: string;
+    minVolume24hUsd?: string;
+    maxYesSpread?: string;
+    maxOrderbookAgeSeconds?: number;
+}
+/**
+ * Static-at-construction-time portion of the generator config — set once when
+ * the daemon spawns the generator from a launched record and never read from
+ * the configRef after that. Polymarket transport plus the agent's signing
+ * material.
+ */
+export interface PredictionV1GeneratorStaticConfig extends PolymarketClientConfig {
+    agentEoa?: `0x${string}`;
+    safeAddress?: `0x${string}`;
+    agentPrivateKey?: `0x${string}`;
+}
+export interface MakePredictionV1GeneratorForLaunchedRecordOpts {
+    /**
+     * Live mirror of the launched record. The daemon flips status / toggles
+     * generatorEnabled by mutating `current` after persisting to disk; the
+     * generator's per-tick gate reads `current.status` and
+     * `current.generatorEnabled` directly.
+     */
+    recordRef: {
+        current: LaunchedSolverNetRecord;
+    };
+    /**
+     * Live mirror of the hot-applyable config. The SolverNet config API
+     * endpoint (Task 14) mutates `current` after persisting to disk; the next
+     * tick reads cadence/allow-block-lists/max-caps from
+     * `current.<field>`.
+     */
+    configRef: {
+        current: PredictionV1GeneratorRuntimeConfig;
+    };
+    /** Construction-time-fixed deps (transport + agent identity). */
+    staticConfig?: PredictionV1GeneratorStaticConfig;
+}
+/**
+ * Factory that builds a `prediction.v1` Polymarket auto-generator gated on a
+ * locally owned launched record + a hot-applyable runtime config. Used by
+ * the SolverNet subsystem (`daemon-init.ts`) to spawn one generator per
+ * `pendingGenerators` entry.
+ *
+ * The returned callable retains the existing `getState()` extension (the
+ * launcher-status endpoint reads it). Cadence in the snapshot reflects the
+ * LIVE configRef value, not the construction-time one — operators editing
+ * cadence through the API see the change in `/v1/launcher/status` on the
+ * next status read.
+ */
+export declare function makePredictionV1GeneratorForLaunchedRecord(opts: MakePredictionV1GeneratorForLaunchedRecordOpts): PredictionV1GeneratorTick;