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

package/dist/solver-types/swe-rebench-v2-auto.js

@@ -0,0 +1,56 @@
+/**
+ * Task generator for the swe-rebench-v2.v1 SolverNet. Implements the
+ * full-historical-pool + post-until-target-successes policy from DR-i.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §3.6
+ * DR: log/decisions/2026-05-06-task-generator-success-cap.md (P5)
+ */
+export const DEFAULT_GENERATOR_CONFIG = {
+    N_target_successes: 3,
+    N_max_postings_per_task: 10,
+    cooldown_ms: 24 * 60 * 60 * 1000,
+};
+/**
+ * Choose the next eligible task to post on JinnRouter, or undefined if no
+ * task is currently eligible (all saturated, in cooldown, or capped).
+ *
+ * Eligibility filter:
+ *   - successful_count[task] < N_target_successes
+ *   - posted_count[task] < N_max_postings_per_task
+ *   - now - last_posted_at[task] >= cooldown_ms
+ *
+ * Among eligible tasks, prefer a different language than the last-posted one
+ * (simple round-robin balance). Tie-break by lower posted_count, then by
+ * earliest last_posted_at, then by instance_id (deterministic).
+ */
+export function selectNextPostingCandidate(args) {
+    const eligible = args.pool.filter((task) => {
+        const c = args.counters.get(task.instance_id) ?? { posted: 0, successful: 0, last_posted_at: 0 };
+        if (c.successful >= args.config.N_target_successes)
+            return false;
+        if (c.posted >= args.config.N_max_postings_per_task)
+            return false;
+        // Tasks with last_posted_at=0 have never been posted, so skip cooldown check
+        if (c.last_posted_at > 0 && args.now - c.last_posted_at < args.config.cooldown_ms)
+            return false;
+        return true;
+    });
+    if (eligible.length === 0)
+        return undefined;
+    // Round-robin language preference
+    const differentLanguage = args.lastPostedLanguage
+        ? eligible.filter((t) => t.language !== args.lastPostedLanguage)
+        : eligible;
+    const candidates = differentLanguage.length > 0 ? differentLanguage : eligible;
+    candidates.sort((a, b) => {
+        const cA = args.counters.get(a.instance_id) ?? { posted: 0, successful: 0, last_posted_at: 0 };
+        const cB = args.counters.get(b.instance_id) ?? { posted: 0, successful: 0, last_posted_at: 0 };
+        if (cA.posted !== cB.posted)
+            return cA.posted - cB.posted;
+        if (cA.last_posted_at !== cB.last_posted_at)
+            return cA.last_posted_at - cB.last_posted_at;
+        return a.instance_id.localeCompare(b.instance_id);
+    });
+    return candidates[0];
+}
+//# sourceMappingURL=swe-rebench-v2-auto.js.map

package/dist/solver-types/swe-rebench-v2-auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swe-rebench-v2-auto.js","sourceRoot":"","sources":["../../src/solver-types/swe-rebench-v2-auto.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,kBAAkB,EAAE,CAAC;IACrB,uBAAuB,EAAE,EAAE;IAC3B,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CACjC,CAAC;AAYF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAgB;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACzC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QACjG,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB;YAAE,OAAO,KAAK,CAAC;QACjE,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,uBAAuB;YAAE,OAAO,KAAK,CAAC;QAClE,6EAA6E;QAC7E,IAAI,CAAC,CAAC,cAAc,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAChG,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,kCAAkC;IAClC,MAAM,iBAAiB,GAAG,IAAI,CAAC,kBAAkB;QAC/C,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,kBAAkB,CAAC;QAChE,CAAC,CAAC,QAAQ,CAAC;IACb,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE/E,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC/F,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC/F,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;QAC1D,IAAI,EAAE,CAAC,cAAc,KAAK,EAAE,CAAC,cAAc;YAAE,OAAO,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,cAAc,CAAC;QAC1F,OAAO,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/solver-types/swe-rebench-v2.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SolverTypeDefinition for swe-rebench-v2.v1.
+ *
+ * Wires the pool builder, state store, and selectNextPostingCandidate
+ * policy from the supporting modules (_swe-rebench-v2-pool, _swe-rebench-v2-state,
+ * swe-rebench-v2-auto) into the SolverTypeDefinition interface consumed by
+ * collectTestnetAutoTaskGenerators.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §3.6
+ */
+import type { SolverTypeDefinition } from './solver-type.js';
+import { type GeneratorConfig } from './swe-rebench-v2-auto.js';
+import { GeneratorStateStore } from './_swe-rebench-v2-state.js';
+/** Config passed to buildGenerator — sourced from env or TestnetAutoContext. */
+export interface SweRebenchV2AutoConfig {
+    stateDir: string;
+    generatorConfig?: GeneratorConfig;
+}
+export declare const sweRebenchV2: SolverTypeDefinition<SweRebenchV2AutoConfig>;
+/**
+ * Accessor for the GeneratorStateStore used by the delivery-watcher verdict hook.
+ * Returns a store rooted at the same default stateDir as the generator.
+ */
+export declare function getSweRebenchV2StateStore(stateDir?: string): GeneratorStateStore;

package/dist/solver-types/swe-rebench-v2.js

@@ -0,0 +1,146 @@
+/**
+ * SolverTypeDefinition for swe-rebench-v2.v1.
+ *
+ * Wires the pool builder, state store, and selectNextPostingCandidate
+ * policy from the supporting modules (_swe-rebench-v2-pool, _swe-rebench-v2-state,
+ * swe-rebench-v2-auto) into the SolverTypeDefinition interface consumed by
+ * collectTestnetAutoTaskGenerators.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §3.6
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { SweRebenchV2TaskSchema } from '../vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2.js';
+import { selectNextPostingCandidate, DEFAULT_GENERATOR_CONFIG, } from './swe-rebench-v2-auto.js';
+import { GeneratorStateStore } from './_swe-rebench-v2-state.js';
+import { buildHistoricalPool, fetchHfSplit, listMonthlyPartitions, } from './_swe-rebench-v2-pool.js';
+const HF_DATASET = 'nebius/SWE-rebench-leaderboard';
+/** How long the pool is cached before a full refresh (24 h). */
+const POOL_REFRESH_MS = 24 * 60 * 60 * 1000;
+/**
+ * Build a TaskGenerator that wraps the full-historical-pool +
+ * post-until-target-successes policy.
+ */
+function makeSweRebenchV2Generator(config) {
+    const stateStore = new GeneratorStateStore({ stateDir: config.stateDir });
+    const genConfig = config.generatorConfig ?? DEFAULT_GENERATOR_CONFIG;
+    let pool = [];
+    let poolLoadedAt = 0;
+    let lastPostedLanguage;
+    async function refreshPool() {
+        try {
+            // Fetch available splits from the HF datasets-server
+            const splitsUrl = `https://datasets-server.huggingface.co/splits?dataset=${encodeURIComponent(HF_DATASET)}`;
+            const response = await fetch(splitsUrl);
+            if (!response.ok)
+                throw new Error(`HF splits fetch failed: ${response.status}`);
+            const json = (await response.json());
+            const splitNames = (json.splits ?? []).map((s) => s.split);
+            const months = listMonthlyPartitions(splitNames);
+            if (months.length === 0)
+                return;
+            pool = await buildHistoricalPool({
+                months,
+                fetchSplit: (split) => fetchHfSplit({ dataset: HF_DATASET, split, limit: 100 }),
+            });
+            poolLoadedAt = Date.now();
+        }
+        catch (err) {
+            // Non-fatal: keep the existing pool if already loaded
+            console.warn(`[swe-rebench-v2-gen] pool refresh failed (using ${pool.length} cached tasks):`, err instanceof Error ? err.message : String(err));
+        }
+    }
+    return async () => {
+        const now = Date.now();
+        // Refresh pool if stale or empty
+        if (pool.length === 0 || now - poolLoadedAt > POOL_REFRESH_MS) {
+            await refreshPool();
+        }
+        if (pool.length === 0)
+            return null;
+        // Load all counters for eligible tasks
+        const counters = new Map();
+        for (const task of pool) {
+            counters.set(task.instance_id, await stateStore.getCounters(task.instance_id));
+        }
+        const candidate = selectNextPostingCandidate({
+            pool,
+            counters,
+            config: genConfig,
+            now,
+            lastPostedLanguage,
+        });
+        if (!candidate)
+            return null;
+        // Record the posting
+        await stateStore.recordPosted(candidate.instance_id, now);
+        lastPostedLanguage = candidate.language;
+        // Build the Task
+        const deadlineUnix = Math.floor((now + 7 * 24 * 60 * 60 * 1000) / 1000); // 7-day window
+        const roundMonth = new Date(now).toISOString().slice(0, 7); // YYYY-MM
+        const windowEndTs = deadlineUnix * 1000;
+        const spec = {
+            schemaVersion: 'swe-rebench-v2.v1',
+            instance_id: candidate.instance_id,
+            repo: `${candidate.instance_id.split('__')[0]}/${candidate.instance_id.split('__')[1]?.split('-')[0] ?? candidate.instance_id}`,
+            base_commit: '0000000000000000000000000000000000000000',
+            language: candidate.language ?? 'python',
+            problem_statement: `SWE-rebench v2 instance: ${candidate.instance_id}`,
+            interface: '',
+            hf_dataset: candidate.hf_dataset,
+            hf_split: candidate.hf_split,
+            deadline_unix: deadlineUnix,
+            round_month: roundMonth,
+        };
+        const task = {
+            id: randomUUID(),
+            description: `SWE-rebench v2: ${candidate.instance_id}`,
+            solverType: 'swe-rebench-v2.v1',
+            role: 'restoration',
+            window: {
+                startTs: now,
+                endTs: windowEndTs,
+            },
+            spec,
+        };
+        return task;
+    };
+}
+export const sweRebenchV2 = {
+    solverType: 'swe-rebench-v2.v1',
+    async parseSpec(raw) {
+        const task = SweRebenchV2TaskSchema.parse(raw);
+        return {
+            window: undefined,
+            spec: task,
+            eligibility: {},
+        };
+    },
+    buildGenerator: (config) => makeSweRebenchV2Generator(config),
+    getTestnetAutoConfig: (ctx) => {
+        if (ctx.network !== 'testnet')
+            return undefined;
+        // Only activate when explicitly opted in via env flag
+        if (process.env['JINN_SWE_REBENCH_V2_LAUNCHER_ENABLED'] !== '1')
+            return undefined;
+        const stateDir = process.env['JINN_SWE_REBENCH_V2_STATE_DIR'] ??
+            join(process.env['HOME'] ?? homedir(), '.jinn-client', 'swe-rebench-v2');
+        return { stateDir };
+    },
+    ui: {
+        description: 'SWE-rebench v2 coding benchmark (HuggingFace dataset)',
+        category: 'code',
+    },
+};
+/**
+ * Accessor for the GeneratorStateStore used by the delivery-watcher verdict hook.
+ * Returns a store rooted at the same default stateDir as the generator.
+ */
+export function getSweRebenchV2StateStore(stateDir) {
+    const dir = stateDir ??
+        process.env['JINN_SWE_REBENCH_V2_STATE_DIR'] ??
+        join(process.env['HOME'] ?? homedir(), '.jinn-client', 'swe-rebench-v2');
+    return new GeneratorStateStore({ stateDir: dir });
+}
+//# sourceMappingURL=swe-rebench-v2.js.map

package/dist/solver-types/swe-rebench-v2.js.map

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

package/dist/solvernets/daemon-init.d.ts

@@ -0,0 +1,291 @@
+/**
+ * Daemon-side bootstrap of the SolverNet subsystem.
+ *
+ * Spec: `spec/2026-05-05-solvernet-creation-and-launch.md` Task 11 (daemon
+ * startup integration). Wires the persistence, recovery, and operator
+ * catalog surfaces so the daemon can resume in-flight launches/lifecycle
+ * transitions and serve the operator catalog UI.
+ *
+ * This module is intentionally THIN: it composes existing pieces (`SolverNetStore`,
+ * `recoverInFlightLaunches`, `recoverInFlightLifecycleTransitions`, and the
+ * `IdentityRegistryBackedSolverNetRegistryClient`) into a single
+ * `initSolverNetSubsystem(deps)` call that `main.ts` invokes once after the
+ * `FleetBootstrapper` finishes. Task 11 sets up the SCAFFOLDING; Task 12
+ * is responsible for the gating refactor that swaps out the legacy
+ * `collectTestnetAutoTaskGenerators` path for owned launched-record-driven
+ * generator construction.
+ *
+ * Order of operations (mirrors the per-section ordering in
+ * `launch-state-machine.ts` and `lifecycle-transitions.ts`):
+ *
+ *   1. Resume any record stuck in `status: 'launching'` →
+ *      `recoverInFlightLaunches`. Safe to call when no records are in flight.
+ *   2. Resume any record with `lifecycleProgress` set →
+ *      `recoverInFlightLifecycleTransitions`. Same safety property.
+ *   3. Load owned records → identify which ones have
+ *      `status === 'launched' && generatorEnabled`; those are the
+ *      "ready-to-spawn" set the next-task generator wiring will iterate.
+ *   4. Start the operator catalog refresher loop (interval-driven) so the
+ *      daemon API can hand SPA reads without a synchronous subgraph round
+ *      trip on every poll.
+ *
+ * Out of scope for Task 11 (do NOT add here):
+ *
+ *   - Actually constructing `prediction.v1` generators per launched record
+ *     (Task 12).
+ *   - Wiring the catalog cache into the API server's `/v1/solvernets/*`
+ *     endpoints (Task 14/15).
+ *   - Removing the legacy `collectTestnetAutoTaskGenerators` path
+ *     (Task 12).
+ *
+ * Day-1 SubgraphClient note: the canonical Jinn subgraph has not yet
+ * surfaced the `solvernet-manifest:` setMetadata index (Task 25 wires the
+ * extension). Until then, callers may pass `createNoopSubgraphClient()` so
+ * `recoverInFlightLaunches` and `listLaunched` return empty arrays
+ * gracefully — recovery only short-circuits via subgraph events on
+ * mempool-drop (rare); the catalog refresher logs a one-line warning when
+ * it observes the no-op path so the operator can see the wiring is
+ * incomplete. Production wiring happens in Task 25.
+ */
+import { type IpfsClient, type MetadataPublisher, type SubgraphClient } from './registry-client-erc8004.js';
+import { type LaunchActionDeps, type ResolveSigner } from './launch-state-machine.js';
+import { type LifecycleTransitionDeps } from './lifecycle-transitions.js';
+import type { SolverNetRegistryClient, SolverNetManifestSummary } from './registry-client.js';
+import type { LaunchedSolverNetRecord, SolverNetStore } from './store.js';
+import type { PredictionV1GeneratorRuntimeConfig } from '../solver-types/prediction-v1-auto.js';
+import type { PublicClient, WalletClient } from 'viem';
+/**
+ * How often the operator catalog cache is refreshed against the registry
+ * client. 30 seconds is conservative — operators rarely launch multiple
+ * SolverNets per minute, and the SPA's join-flow polling is on a similar
+ * cadence. Tunable via `initSolverNetSubsystem.catalogRefreshIntervalMs`.
+ */
+export declare const DEFAULT_CATALOG_REFRESH_INTERVAL_MS = 30000;
+/**
+ * Catalog-cache surface — what the daemon API will read in Task 14/15.
+ *
+ * `getCatalog()` returns the most recently fetched summaries (or an empty
+ * array before the first refresh succeeds). `refresh()` forces an immediate
+ * fetch outside the periodic interval — useful for tests and for
+ * post-action UI invalidation. `stop()` cancels the periodic interval.
+ */
+export interface SolverNetCatalogCache {
+    getCatalog(): SolverNetManifestSummary[];
+    refresh(): Promise<void>;
+    stop(): void;
+    /** Last successful refresh. `null` until the first refresh lands. */
+    lastRefreshedAt(): Date | null;
+    /** Last refresh error, if any. Cleared on the next successful refresh. */
+    lastError(): {
+        message: string;
+        at: Date;
+    } | null;
+}
+/**
+ * One spawn-ready entry surfaced to `main.ts`. The daemon constructs a
+ * generator per entry using `makePredictionV1GeneratorForLaunchedRecord`
+ * (Task 12 of spec/2026-05-05-solvernet-creation-and-launch.md §11) and
+ * passes the same `recordRef` and `configRef` so:
+ *
+ *   - Lifecycle transitions (pause/resume/retire) update `recordRef.current`
+ *     and the per-tick gate sees the new status within one cadence.
+ *   - The SolverNet config API endpoint (Task 14) mutates `configRef.current`
+ *     and the per-tick reads the new cadence / allowlist / caps within one
+ *     cadence — no daemon restart, no generator recreation.
+ *
+ * The same refs are also the source of truth that the catalog/status
+ * endpoints read so SPA reads always match what the generator is actually
+ * doing. Task 12 wires the generator construction; Tasks 14/15 hand these
+ * refs to the API server.
+ */
+export interface PendingGeneratorSpawn {
+    /** Snapshot of the launched record at subsystem-init time. */
+    record: LaunchedSolverNetRecord;
+    /**
+     * Live mirror of the launched record. The lifecycle-transition path
+     * mutates `recordRef.current` immediately after persisting status changes
+     * to disk (and Task 12 also wires lifecycle resume to mutate it on
+     * recovery).
+     */
+    recordRef: {
+        current: LaunchedSolverNetRecord;
+    };
+    /**
+     * Live mirror of the hot-applyable runtime generator config. The
+     * subsystem seeds it with the record's last-saved config (or all-default
+     * empty config when no per-record overrides are set yet). Task 14 mutates
+     * this when the operator edits cadence / allow-block-lists / caps.
+     */
+    configRef: {
+        current: PredictionV1GeneratorRuntimeConfig;
+    };
+}
+/**
+ * What `initSolverNetSubsystem` returns. Tasks 14/15 hand
+ * `pendingGenerators` and the catalog cache to the API server; `main.ts`
+ * iterates `pendingGenerators` to actually construct generators (Task 12
+ * wires the generator factory).
+ */
+export interface SolverNetSubsystem {
+    /** All launched records currently on disk (post-recovery). */
+    records: LaunchedSolverNetRecord[];
+    /**
+     * Subset of `records` where `status === 'launched'` and
+     * `generatorEnabled === true`, paired with the live refs the generator
+     * factory and the API endpoints share.
+     */
+    pendingGenerators: PendingGeneratorSpawn[];
+    /** Operator catalog cache, populated on first refresh. */
+    catalog: SolverNetCatalogCache;
+    /** The registry client (for reuse by the daemon API). */
+    registryClient: SolverNetRegistryClient;
+    /** Outcomes of the recovery scans. Useful for test assertions and logging. */
+    recovery: {
+        inFlightLaunches: {
+            resumed: number;
+            failed: Array<{
+                solverNetId: string;
+                error: Error;
+            }>;
+        };
+        inFlightLifecycle: {
+            resumed: number;
+            failed: Array<{
+                solverNetId: string;
+                error: Error;
+            }>;
+        };
+    };
+    /** Stop the catalog refresher and any future timers. Idempotent. */
+    stop(): void;
+}
+/**
+ * Required inputs. The store / clients can be the production
+ * implementations or test mocks — the module is dep-injected end to end
+ * so unit tests don't have to mock viem.
+ *
+ * `network` is the chain the catalog cache filters on (per
+ * `IdentityRegistryBackedSolverNetRegistryClient.listLaunched`).
+ *
+ * `resolveSigner` is required for the launch-recovery branch (the launch
+ * state machine signs re-broadcasts on resume). Lifecycle resume takes
+ * a single `signer` directly — production passes the same signer for
+ * both, since one daemon owns one launcher.
+ */
+export interface InitSolverNetSubsystemDeps {
+    store: SolverNetStore;
+    ipfs: IpfsClient;
+    publisher: MetadataPublisher;
+    subgraph: SubgraphClient;
+    registryClient: SolverNetRegistryClient;
+    network: 'base-sepolia' | 'base';
+    resolveSigner: ResolveSigner;
+    /**
+     * Single signer used by the lifecycle-resume scan. Production owns one
+     * launcher per daemon; multi-launcher recovery is out of scope.
+     */
+    lifecycleSigner: LifecycleTransitionDeps['signer'];
+    /** Resolves a tx hash to a confirmed receipt. Same as the state machines. */
+    awaitTxConfirmation: LaunchActionDeps['awaitTxConfirmation'];
+    /** Optional override for `setInterval` / `clearInterval` (tests). */
+    scheduler?: {
+        setInterval: (cb: () => void, ms: number) => unknown;
+        clearInterval: (handle: unknown) => void;
+    };
+    /** Period (ms) for the catalog refresher. */
+    catalogRefreshIntervalMs?: number;
+    /**
+     * If `true`, skip starting the catalog refresher interval — useful for
+     * tests that only assert the load+recover flow. The catalog is still
+     * exposed; tests call `catalog.refresh()` manually.
+     */
+    disableCatalogAutoRefresh?: boolean;
+    /**
+     * Optional logger for catalog-refresh errors and recovery summaries.
+     * Defaults to `console`.
+     */
+    logger?: {
+        warn: (msg: string) => void;
+        info: (msg: string) => void;
+    };
+    /** Override the wall clock for deterministic tests. */
+    now?: () => Date;
+}
+/**
+ * Initialise the SolverNet subsystem at daemon startup.
+ *
+ * Call after `FleetBootstrapper` resolves (so the master Safe + agent EOA
+ * referenced by launched records are available) and before any task
+ * generators are constructed.
+ *
+ * Errors during the recovery scans are captured per-record into
+ * `recovery.inFlightLaunches.failed` / `recovery.inFlightLifecycle.failed`
+ * so a single broken record cannot block daemon startup. Errors during
+ * the initial catalog refresh are logged and stored on the cache; the
+ * refresher continues ticking.
+ */
+export declare function initSolverNetSubsystem(deps: InitSolverNetSubsystemDeps): Promise<SolverNetSubsystem>;
+/**
+ * Wrap the existing global `uploadToIpfs` / `fetchFromIpfs` helpers in the
+ * `IpfsClient` interface used by the SolverNet registry client. Same
+ * canonical-JSON semantics as the rest of the daemon.
+ */
+export declare function createIpfsClientAdapter(args: {
+    registryUrl: string;
+    gatewayUrl: string;
+}): IpfsClient;
+/**
+ * Day-1 stub `SubgraphClient` returning empty arrays for both queries. The
+ * real subgraph extension lands in Task 25; until then the launch state
+ * machine and registry catalog still function (recovery only consults
+ * the subgraph on mempool-drop, which is rare; catalog refresh produces an
+ * empty list, which the SPA renders as "no SolverNets launched yet" — a
+ * truthful zero state until Task 25 indexes the events).
+ *
+ * Exported so tests can pin a deterministic baseline.
+ */
+export declare function createNoopSubgraphClient(): SubgraphClient;
+/**
+ * jinn-mono-{follow-up}: real subgraph adapter that queries the deployed
+ * Jinn subgraph (e.g. https://api.studio.thegraph.com/query/.../jinn-testnet/...)
+ * for `SolverNetManifestEvent` rows and JCS-decodes each event's payload
+ * bytes into the typed lifecycle payload. Replaces `createNoopSubgraphClient`
+ * for any daemon that reads `JINN_SUBGRAPH_URL`.
+ *
+ * The schema only stores `solvernet-manifest:<cid>` events (lifecycle and
+ * launch share the prefix). `keyPrefix` is therefore an effective filter:
+ * the entity itself encodes that constraint, so we do not pass it to the
+ * GraphQL query. Callers passing a different prefix get an empty list.
+ */
+export declare function createGraphqlSubgraphClient(args: {
+    url: string;
+}): SubgraphClient;
+/**
+ * Adapter that turns a viem (walletClient, publicClient, identityRegistryAddress)
+ * triple into a `MetadataPublisher` whose `value` is treated as raw bytes
+ * (the JCS-encoded SolverNet lifecycle payload), bypassing the
+ * `IdentityPublisher`'s ABI-encoded execution-payload tuple. Production
+ * `main.ts` constructs one of these alongside the existing `IdentityPublisher`
+ * — they share the same on-chain `setMetadata` ABI but encode different
+ * payload schemas under different `metadataKey` prefixes.
+ *
+ * `signer` from the call site is passed through but unused here — the
+ * walletClient is bound at construction time. The interface keeps it so
+ * tests can swap in a mock that does inspect it.
+ */
+export declare function createMetadataPublisherFromViem(args: {
+    identityRegistryAddress: `0x${string}`;
+    walletClient: WalletClient;
+    publicClient: PublicClient;
+}): MetadataPublisher;
+/**
+ * Build a production `IdentityRegistryBackedSolverNetRegistryClient` from a
+ * pre-built deps bundle. Convenience wrapper kept here so `main.ts` only
+ * imports from `./solvernets/daemon-init.js` for the whole subsystem.
+ */
+export declare function createDefaultRegistryClient(args: {
+    ipfs: IpfsClient;
+    publisher: MetadataPublisher;
+    subgraph: SubgraphClient;
+    network: 'base-sepolia' | 'base';
+}): SolverNetRegistryClient;