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

package/dist/api/launcher-status.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Launcher mode status assembler.
+ *
+ * Composes per-SolverNet generator state, open-Task counts, and Safe budget
+ * runway into the canonical `LauncherStatusResponse`. Surfaces every
+ * SolverNet entry the daemon has loaded — launcher ownership is no longer
+ * expressed via an operator-config `'launching'` role (Task 22 of
+ * spec/2026-05-05-solvernet-creation-and-launch.md dropped that enum value);
+ * the launched-record subsystem owns that signal now.
+ *
+ * Stale-poll detection is computed here from the generator's reported
+ * `lastPollAt` and `cadenceMs`: a poll is stale when the wall clock has
+ * advanced past `lastPollAt + 2 * cadenceMs`. The 2× factor matches
+ * spec/2026-05-05-launcher-role-and-mode.md §5.3.
+ *
+ * The deps shape is intentionally narrow — every external surface is a
+ * function so tests can inject deterministic state without standing up the
+ * full daemon. Subdeps that require deeper integration (open-Task counts,
+ * reserved-budget math, Safe-balance reads) are abstract here; v1 wires them
+ * to placeholder accessors with TODO pointers at Task 7.
+ */
+import type { JinnConfig } from '../config.js';
+export interface LauncherStatusGeneratorView {
+    state: 'active' | 'paused' | 'errored';
+    lastPollAt?: string;
+    lastPollSummary?: {
+        evaluated: number;
+        posted: number;
+        skipped: number;
+    };
+    lastError?: {
+        message: string;
+        at: string;
+    };
+    cadenceMs: number;
+    stale: boolean;
+}
+export interface LauncherStatusBudgetView {
+    safeAddress: string;
+    safeBalanceWei: string;
+    reservedBudgetWei: string;
+    runwayDays?: number;
+}
+export interface LauncherStatusNetEntry {
+    name: string;
+    generator: LauncherStatusGeneratorView;
+    openTasks: number;
+    budget: LauncherStatusBudgetView;
+}
+export interface LauncherStatusResponse {
+    schemaVersion: 1;
+    generatedAt: string;
+    nets: LauncherStatusNetEntry[];
+}
+/**
+ * Generator state snapshot the gather function consumes. Matches
+ * `PredictionV1GeneratorStateSnapshot` in shape but is declared here so the
+ * gather function does not depend on a specific SolverType module.
+ */
+export interface LauncherGeneratorStateSnapshot {
+    lastPollAt?: string;
+    lastPollSummary?: {
+        evaluated: number;
+        posted: number;
+        skipped: number;
+    };
+    lastError?: {
+        message: string;
+        at: string;
+    };
+    cadenceMs: number;
+}
+export interface GatherLauncherStatusDeps {
+    config: Pick<JinnConfig, 'solverNets'>;
+    /** Returns the generator's live state, or `undefined` if the SolverNet has no generator. */
+    getGeneratorState: (netName: string) => LauncherGeneratorStateSnapshot | undefined;
+    /** Count of Tasks created by the operator that are still in flight for the named SolverNet. */
+    getOpenTaskCount: (netName: string) => Promise<number> | number;
+    /** Sum of unconsumed claim payments across open Tasks (wei string). */
+    getReservedBudgetWei: (netName: string) => Promise<string> | string;
+    /** Safe ETH balance in wei (string) for the operator's funding wallet. */
+    getSafeBalanceWei: () => Promise<string> | string;
+    /**
+     * Operator Safe address used for budget views. Either a literal string (when
+     * known at construction time, e.g. tests) or a getter (when the address only
+     * resolves after bootstrap completes — see main.ts wiring).
+     */
+    safeAddress: string | (() => string);
+    /** Now-source override for deterministic tests. */
+    now?: () => number;
+}
+export declare function gatherLauncherStatus(deps: GatherLauncherStatusDeps): Promise<LauncherStatusResponse>;

package/dist/api/launcher-status.js

@@ -0,0 +1,82 @@
+/**
+ * Derive the high-level generator state. `errored` wins over `active`/`paused`
+ * because the operator wants to see the failure first; `paused` only fires
+ * when no generator state is exposed at all (closed role gate before the very
+ * first tick, or a SolverNet without a launcher implementation).
+ *
+ * NOTE (v1 edge case, jinn-mono-l2zl carry-over from Task 6 review): a
+ * generator with a `cadenceMs > 0` and no `lastError` reports `active` even
+ * before its first poll has completed. If the daemon has been running long
+ * enough that the first poll *should* have completed but `lastPollAt` is
+ * still undefined, the operator UI will show "active, not stale" — which is
+ * misleading. The fix requires tracking a `genStartedAt` timestamp on the
+ * generator so the gather function can compare `now - genStartedAt`
+ * against `2 * cadenceMs`. Deferred to a follow-up: in v1 the prediction.v1
+ * cadence is 6h, so the window between "started" and "first tick" is short
+ * enough that the misclassification is rare in practice. Tracked under
+ * the launcher-mode plan (spec/2026-05-05-launcher-role-and-mode.md §5.3).
+ */
+function deriveGeneratorState(snapshot) {
+    if (!snapshot)
+        return 'paused';
+    if (snapshot.lastError)
+        return 'errored';
+    return 'active';
+}
+function isStalePoll(snapshot, now) {
+    if (!snapshot || !snapshot.lastPollAt)
+        return false;
+    const lastPollMs = Date.parse(snapshot.lastPollAt);
+    if (!Number.isFinite(lastPollMs))
+        return false;
+    const cadenceMs = snapshot.cadenceMs ?? 0;
+    if (cadenceMs <= 0)
+        return false;
+    return now - lastPollMs > 2 * cadenceMs;
+}
+export async function gatherLauncherStatus(deps) {
+    const now = deps.now?.() ?? Date.now();
+    const nets = [];
+    for (const [name, _net] of Object.entries(deps.config.solverNets ?? {})) {
+        // Task 22 of spec/2026-05-05-solvernet-creation-and-launch.md removed
+        // the operator-config `'launching'` role; surface every loaded SolverNet
+        // entry. Launched-record ownership filters happen at the launched-record
+        // surface, not here.
+        const snapshot = deps.getGeneratorState(name);
+        const generatorState = deriveGeneratorState(snapshot);
+        const stale = isStalePoll(snapshot, now);
+        const [openTasks, reservedBudgetWei, safeBalanceWei] = await Promise.all([
+            Promise.resolve(deps.getOpenTaskCount(name)),
+            Promise.resolve(deps.getReservedBudgetWei(name)),
+            Promise.resolve(deps.getSafeBalanceWei()),
+        ]);
+        const generator = {
+            state: generatorState,
+            cadenceMs: snapshot?.cadenceMs ?? 0,
+            stale,
+        };
+        if (snapshot?.lastPollAt)
+            generator.lastPollAt = snapshot.lastPollAt;
+        if (snapshot?.lastPollSummary)
+            generator.lastPollSummary = { ...snapshot.lastPollSummary };
+        if (snapshot?.lastError)
+            generator.lastError = { ...snapshot.lastError };
+        const safeAddress = typeof deps.safeAddress === 'function' ? deps.safeAddress() : deps.safeAddress;
+        nets.push({
+            name,
+            generator,
+            openTasks,
+            budget: {
+                safeAddress,
+                safeBalanceWei,
+                reservedBudgetWei,
+            },
+        });
+    }
+    return {
+        schemaVersion: 1,
+        generatedAt: new Date(now).toISOString(),
+        nets,
+    };
+}
+//# sourceMappingURL=launcher-status.js.map

package/dist/api/launcher-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-status.js","sourceRoot":"","sources":["../../src/api/launcher-status.ts"],"names":[],"mappings":"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"}

package/dist/api/launcher-tasks.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Launcher-mode posted-Tasks query. Returns the canonical
+ * `LauncherTasksResponse` for `GET /v1/launcher/tasks` — the SPA's
+ * PostedTasksList consumes this directly.
+ *
+ * Pagination: `before` cursor is an ISO timestamp; results are returned in
+ * `postedAt DESC` order. When the page fills (`tasks.length === limit`) the
+ * response includes a `cursor.before` set to the oldest entry's `postedAt`
+ * so the next call can resume.
+ *
+ * What is and isn't sourced today (Task 7 of
+ * spec/2026-05-05-launcher-role-and-mode.md):
+ *   ✓ taskId / taskCid / postedAt — from `task_posts` + `activity_events`
+ *   ✓ solverNet — derived by mapping the `task_posted` event's `solver_type`
+ *     back to the SolverNet name in config (the only solver-type → net mapping
+ *     in v1 is 1:1, so the lookup is straightforward).
+ *   ✗ state / claims.current / budget.remainingWei — require on-chain state
+ *     tracking that the v1 daemon does not yet maintain. The router-watcher
+ *     hardening lane (bd jinn-mono-l2zl.12) will add per-Task lifecycle
+ *     events; until then we report `state: 'open'`, `claims.current: 0`, and
+ *     `budget: { totalWei: '0', remainingWei: '0' }`. These defaults are
+ *     accurate for the freshly-posted Task case, which is the one operators
+ *     see most often in the day-1 launcher UI.
+ *   ✗ summary.title / summary.resolutionTime — would require persisting the
+ *     full Task spec at post-time. Out of scope for v1; the SPA falls back
+ *     to taskId/postedAt when summary is absent.
+ *
+ * Spec: spec/2026-05-05-launcher-role-and-mode.md §5.3.
+ */
+import type { JinnConfig } from '../config.js';
+export type LauncherTaskState = 'open' | 'claims-in-flight' | 'fully-claimed' | 'settled' | 'failed';
+export interface LauncherTaskEntry {
+    taskId: string;
+    taskCid: string;
+    solverNet: string;
+    postedAt: string;
+    state: LauncherTaskState;
+    claims: {
+        current: number;
+        max: number;
+    };
+    budget: {
+        totalWei: string;
+        remainingWei: string;
+        reclaimableAt?: string;
+    };
+    summary?: {
+        title?: string;
+        resolutionTime?: string;
+    };
+}
+export interface LauncherTasksResponse {
+    schemaVersion: 1;
+    generatedAt: string;
+    cursor?: {
+        before: string;
+    };
+    tasks: LauncherTaskEntry[];
+}
+/** A single posted-Task row as surfaced by the daemon's store accessor. */
+export interface PostedTaskRecord {
+    taskId: string;
+    taskCid: string;
+    /** Optional — if present, used to derive `solverNet` via config lookup. */
+    solverType?: string;
+    /** Optional override; when set, takes precedence over solverType-based mapping. */
+    solverNet?: string;
+    /** ISO-8601 timestamp; the response sorts on this DESC. */
+    postedAt: string;
+    state?: LauncherTaskState;
+    claims?: {
+        current?: number;
+        max?: number;
+    };
+    budget?: {
+        totalWei?: string;
+        remainingWei?: string;
+        reclaimableAt?: string;
+    };
+    summary?: {
+        title?: string;
+        resolutionTime?: string;
+    };
+}
+export interface FetchPostedTasksOptions {
+    creatorAddress: string;
+    /** Inclusive upper bound on result count after deps applies its own page logic. */
+    limit: number;
+    /** ISO-8601 timestamp; filter to rows with `postedAt < before`. */
+    before?: string;
+}
+export interface GatherLauncherTasksDeps {
+    config: Pick<JinnConfig, 'solverNets'>;
+    creatorAddress: string;
+    fetchPostedTasks: (opts: FetchPostedTasksOptions) => Promise<PostedTaskRecord[]> | PostedTaskRecord[];
+    now?: () => number;
+}
+export interface GatherLauncherTasksOptions {
+    /** Page size; clamped to [1, 100]. Default 25 (matches spec). */
+    limit?: number;
+    /** ISO-8601 timestamp; filter to rows with `postedAt < before`. */
+    before?: string;
+}
+export declare function gatherLauncherTasks(deps: GatherLauncherTasksDeps, opts?: GatherLauncherTasksOptions): Promise<LauncherTasksResponse>;

package/dist/api/launcher-tasks.js

@@ -0,0 +1,83 @@
+const DEFAULT_LIMIT = 25;
+const MAX_LIMIT = 100;
+const DEFAULT_CLAIMS_MAX = 25;
+/**
+ * Build a solverType → solverNet-name lookup from the live config. The v1
+ * mapping is 1:1 (one SolverNet per solver-type), but we index defensively so
+ * a future fork-of-prediction config doesn't silently mislabel posted Tasks.
+ */
+function buildSolverTypeToNetIndex(solverNets) {
+    const index = new Map();
+    if (!solverNets)
+        return index;
+    for (const [name, net] of Object.entries(solverNets)) {
+        const solverType = net?.solverType;
+        if (typeof solverType === 'string' && solverType.length > 0 && !index.has(solverType)) {
+            index.set(solverType, name);
+        }
+    }
+    return index;
+}
+function mapRecordToEntry(record, solverTypeIndex) {
+    const solverNet = record.solverNet
+        ?? (record.solverType ? solverTypeIndex.get(record.solverType) : undefined)
+        ?? 'unknown';
+    const claimsCurrent = record.claims?.current ?? 0;
+    const claimsMax = record.claims?.max ?? DEFAULT_CLAIMS_MAX;
+    const totalWei = record.budget?.totalWei ?? '0';
+    const remainingWei = record.budget?.remainingWei ?? totalWei;
+    const entry = {
+        taskId: record.taskId,
+        taskCid: record.taskCid,
+        solverNet,
+        postedAt: record.postedAt,
+        state: record.state ?? 'open',
+        claims: { current: claimsCurrent, max: claimsMax },
+        budget: { totalWei, remainingWei },
+    };
+    if (record.budget?.reclaimableAt) {
+        entry.budget.reclaimableAt = record.budget.reclaimableAt;
+    }
+    if (record.summary) {
+        entry.summary = { ...record.summary };
+    }
+    return entry;
+}
+export async function gatherLauncherTasks(deps, opts = {}) {
+    const requested = opts.limit ?? DEFAULT_LIMIT;
+    const limit = Math.min(MAX_LIMIT, Math.max(1, Math.floor(requested)));
+    const fetched = await Promise.resolve(deps.fetchPostedTasks({
+        creatorAddress: deps.creatorAddress,
+        limit,
+        before: opts.before,
+    }));
+    // Defensive sort: the store accessor returns rows in DESC `postedAt`
+    // order, but the gather function is also reachable from tests that pass
+    // unsorted fixtures. Sort here so the response invariant is unconditional.
+    const sorted = [...fetched].sort((a, b) => {
+        const ta = Date.parse(a.postedAt);
+        const tb = Date.parse(b.postedAt);
+        if (Number.isFinite(ta) && Number.isFinite(tb))
+            return tb - ta;
+        if (Number.isFinite(ta))
+            return -1;
+        if (Number.isFinite(tb))
+            return 1;
+        return 0;
+    });
+    const solverTypeIndex = buildSolverTypeToNetIndex(deps.config.solverNets);
+    const tasks = sorted.slice(0, limit).map((record) => mapRecordToEntry(record, solverTypeIndex));
+    const cursor = tasks.length === limit && tasks.length > 0
+        ? { before: tasks[tasks.length - 1].postedAt }
+        : undefined;
+    const generatedAtMs = deps.now?.() ?? Date.now();
+    const response = {
+        schemaVersion: 1,
+        generatedAt: new Date(generatedAtMs).toISOString(),
+        tasks,
+    };
+    if (cursor)
+        response.cursor = cursor;
+    return response;
+}
+//# sourceMappingURL=launcher-tasks.js.map

package/dist/api/launcher-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-tasks.js","sourceRoot":"","sources":["../../src/api/launcher-tasks.ts"],"names":[],"mappings":"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"}

package/dist/api/leaderboard-api.d.ts

@@ -0,0 +1,20 @@
+import { Hono } from 'hono';
+export interface LeaderboardDeps {
+    querySubgraph(mode: 'train' | 'frozen'): Promise<{
+        harnessRollups: Array<{
+            implName: string;
+            codeDigest: string;
+            mode: 'train' | 'frozen';
+            verdictCount: number;
+            scoreSum: number;
+            uniqueOperators: number;
+            lastSeenAt: number;
+            meanResolved?: number;
+        }>;
+    }>;
+    isCheckpointVerified(args: {
+        implName: string;
+        codeDigest: string;
+    }): Promise<boolean>;
+}
+export declare function leaderboardRoutes(deps: LeaderboardDeps): Hono;

package/dist/api/leaderboard-api.js

@@ -0,0 +1,18 @@
+import { Hono } from 'hono';
+export function leaderboardRoutes(deps) {
+    const app = new Hono();
+    app.get('/api/solvernets/:name/leaderboard', async (c) => {
+        const mode = (c.req.query('mode') ?? 'train');
+        const result = await deps.querySubgraph(mode);
+        const rollups = await Promise.all(result.harnessRollups.map(async (r) => ({
+            ...r,
+            meanResolved: r.verdictCount > 0 ? r.scoreSum / r.verdictCount : 0,
+            verified: mode === 'frozen'
+                ? await deps.isCheckpointVerified({ implName: r.implName, codeDigest: r.codeDigest })
+                : null,
+        })));
+        return c.json({ rollups });
+    });
+    return app;
+}
+//# sourceMappingURL=leaderboard-api.js.map

package/dist/api/leaderboard-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard-api.js","sourceRoot":"","sources":["../../src/api/leaderboard-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAkB5B,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,GAAG,CAAC,GAAG,CAAC,mCAAmC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACvD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,OAAO,CAAuB,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,GAAG,CAAC;YACJ,YAAY,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAClE,QAAQ,EACN,IAAI,KAAK,QAAQ;gBACf,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;gBACrF,CAAC,CAAC,IAAI;SACX,CAAC,CAAC,CACJ,CAAC;QACF,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/api/peers.js

@@ -4,6 +4,7 @@
  * On startup and periodically, queries each peer's /artifacts/search endpoint
  * and stores results as remote artifacts in the local SQLite store.
  */
+import { createHash } from 'node:crypto';
 import { signRequestWithErc8128, } from '../auth/erc8128.js';
 export class PeerSync {
     stopped = false;
@@ -51,13 +52,13 @@ export class PeerSync {
         const data = await response.json();
         let synced = 0;
         for (const artifact of data.results) {
-            // Skip if we already have this artifact locally
-            const existing = this.store.getArtifactContent(artifact.id);
+            // Skip if we already have this artifact body (local row or peer-cached network blob)
+            const existing = this.store.resolveCatalogArtifactContent(artifact.id);
             if (existing !== null)
                 continue;
             this.store.insertRemoteArtifact({
                 id: artifact.id,
-                desiredStateId: '',
+                taskId: '',
                 requestId: '',
                 title: artifact.title,
                 tags: artifact.tags,
@@ -70,7 +71,10 @@ export class PeerSync {
         return synced;
     }
     async acquireContent(artifactId) {
-        const info = this.store.getRemoteArtifactInfo(artifactId);
+        const cached = this.store.resolveCatalogArtifactContent(artifactId);
+        if (cached !== null)
+            return cached;
+        const info = this.store.getRemoteDiscoveryMetadata(artifactId);
         if (!info)
             return null;
         const url = `${info.endpoint}/artifacts/${artifactId}/content`;
@@ -86,8 +90,19 @@ export class PeerSync {
             throw new Error(`Failed to acquire artifact ${artifactId}: ${response.status}`);
         }
         const data = await response.json();
-        // Cache locally
-        this.store.cacheRemoteContent(artifactId, data.content);
+        const buf = Buffer.from(data.content, 'utf-8');
+        const sha256 = createHash('sha256').update(buf).digest('hex');
+        this.store.saveNetworkArtifact({
+            sha256,
+            artifactType: 'api-catalog',
+            content: buf,
+            source: 'origin',
+            sourceOperator: info.ownerAddress || null,
+            sourceEndpoint: info.endpoint,
+            paidAmountUsdc: '0',
+            fetchedAt: new Date().toISOString(),
+            peerCatalogId: artifactId,
+        });
         return data.content;
     }
 }

package/dist/api/peers.js.map

@@ -1 +1 @@
-{"version":3,"file":"peers.js","sourceRoot":"","sources":["../../src/api/peers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"peers.js","sourceRoot":"","sources":["../../src/api/peers.ts"],"names":[],"mappings":"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"}

package/dist/api/portfolio-v0-build.d.ts

@@ -1,20 +1,20 @@
 /**
  * portfolio.v0 dashboard data assembly (§10 step 8 of spec/2026-04-17-portfolio-v0-design.md).
  *
- * Collects in-flight restoration intents, recent verdicts (COMPLETE / FAILED
- * terminal intents), and recent system_snapshot artifacts for the /v1/status
+ * Collects in-flight restoration tasks, recent verdicts (COMPLETE / FAILED
+ * terminal tasks), and recent system_snapshot artifacts for the /v1/status
  * response under the `portfolioV0` key.
  *
  * Designed to be called from gather-status.ts with the Store instance. Does not
  * hit the network — all data comes from SQLite.
  */
 import type { Store } from '../store/store.js';
-/** Default per-intent engine work root; kept in sync with `config.engine.workingDirRoot`. */
+/** Default per-task engine work root; kept in sync with `config.engine.workingDirRoot`. */
 export declare const DEFAULT_ENGINE_WORKING_DIR_ROOT: string;
-export interface InFlightIntentSummary {
+export interface InFlightTaskSummary {
     requestId: string;
     state: string;
-    specKind: string | null;
+    solverType: string | null;
     implName: string | null;
     windowStartTs: number;
     windowEndTs: number;
@@ -26,7 +26,7 @@ export interface VerdictSummary {
     requestId: string;
     state: 'COMPLETE' | 'FAILED';
     implName: string | null;
-    specKind: string | null;
+    solverType: string | null;
     windowStartTs: number;
     windowEndTs: number;
     stateUpdatedAt: number;
@@ -61,9 +61,15 @@ export interface ClaudeOutcomeSummary {
     fillsQueryError?: string;
 }
 export interface PortfolioV0Status {
-    /** Intents currently being processed (not in a terminal state). */
-    inFlight: InFlightIntentSummary[];
-    /** Last N completed or failed intents — most recent first. */
+    totals: {
+        /** Tasks that reached terminal success and delivered their result. */
+        delivered: number;
+        failed: number;
+        active: number;
+    };
+    /** Tasks currently being processed (not in a terminal state). */
+    inFlight: InFlightTaskSummary[];
+    /** Last N completed or failed tasks — most recent first. */
     recentVerdicts: VerdictSummary[];
     /** Recent system_snapshot artifacts from the store — most recent first. */
     recentSnapshots: SnapshotSummary[];
@@ -77,7 +83,7 @@ export interface PortfolioV0Status {
 }
 /**
  * Gather portfolio.v0 dashboard data from SQLite. Safe to call even when the
- * restoration_intents table does not exist yet (table created on first Store
+ * task_runs table does not exist yet (table created on first Store
  * construction, so this is always present when the daemon is running).
  */
 export declare function gatherPortfolioV0Status(store: Store, workingDirRoot?: string): PortfolioV0Status;