@jinn-network/client 0.1.2 → 0.1.3-canary.216cf7e6

package/dist/store/store.d.ts

@@ -1,11 +1,12 @@
 import Database from 'better-sqlite3';
+import type { EnvelopeProjection, EnvelopeProjectionQuery } from '../corpus/types.js';
 export interface ActivityEventInput {
     ts: string | null;
     kind: string;
     requestId?: string | null;
     serviceIndex?: number | null;
     txHash?: string | null;
-    specKind?: string | null;
+    solverType?: string | null;
     outcome?: string | null;
     detail?: string | null;
 }
@@ -16,7 +17,7 @@ export interface ActivityEventRow {
     requestId: string | null;
     serviceIndex: number | null;
     txHash: string | null;
-    specKind: string | null;
+    solverType: string | null;
     outcome: string | null;
     detail: string | null;
 }
@@ -39,13 +40,123 @@ export interface BalanceCacheEntry {
     fetchedAt: string;
     error?: string | null;
 }
-export type IntentPostingPolicyType = 'once_per_safe' | 'once_per_bucket' | 'interval';
-export interface IntentPostRecord {
+export interface ServedArtifactInput {
+    sha256: string;
+    artifactType: string;
+    requestId?: string | null;
+    envelopeCid?: string | null;
+    content: Buffer;
+    priceUsdc: string;
+    createdAt: string;
+}
+export interface ServedArtifactRow {
+    sha256: string;
+    artifactType: string;
+    requestId: string | null;
+    envelopeCid: string | null;
+    content: Buffer;
+    contentSize: number;
+    priceUsdc: string;
+    createdAt: string;
+}
+export interface ServedArtifactMetadataRow {
+    sha256: string;
+    artifactType: string;
+    requestId: string | null;
+    envelopeCid: string | null;
+    contentSize: number;
+    priceUsdc: string;
+    createdAt: string;
+}
+export type ArtifactAccessOutcome = 'free_served' | 'payment_required' | 'paid_served' | 'verification_failed' | 'settlement_failed' | 'payment_malformed' | 'not_found';
+export interface ArtifactAccessEventInput {
+    sha256: string;
+    artifactType?: string | null;
+    priceUsdc?: string | null;
+    outcome: ArtifactAccessOutcome;
+    httpStatus: number;
+    payer?: string | null;
+    settlementTx?: string | null;
+    errorReason?: string | null;
+    remoteAddr?: string | null;
+    userAgent?: string | null;
+    createdAt: string;
+}
+export interface ArtifactAccessEventRow {
+    id: number;
+    sha256: string;
+    artifactType: string | null;
+    priceUsdc: string | null;
+    outcome: ArtifactAccessOutcome;
+    httpStatus: number;
+    payer: string | null;
+    settlementTx: string | null;
+    errorReason: string | null;
+    remoteAddr: string | null;
+    userAgent: string | null;
+    createdAt: string;
+}
+export interface ArtifactAccessStats {
+    accessCount: number;
+    paidServeCount: number;
+    freeServeCount: number;
+    failedPaymentCount: number;
+    paymentRequiredCount: number;
+    revenueUsdc: string;
+    lastAccessAt: string | null;
+    lastPaidAt: string | null;
+}
+export type NetworkArtifactSource = 'origin' | 'route-resolver' | 'self-store-mirror';
+export interface NetworkArtifactInput {
+    sha256: string;
+    artifactType: string;
+    envelopeCid?: string | null;
+    content: Buffer;
+    source: NetworkArtifactSource;
+    sourceOperator?: string | null;
+    sourceEndpoint?: string | null;
+    paidAmountUsdc: string;
+    fetchedAt: string;
+    /** When set, links this blob to a row from the HTTP catalog / peer sync `artifacts.id`. */
+    peerCatalogId?: string | null;
+}
+export interface NetworkArtifactRow {
+    sha256: string;
+    artifactType: string;
+    envelopeCid: string | null;
+    content: Buffer;
+    contentSize: number;
+    source: NetworkArtifactSource;
+    sourceOperator: string | null;
+    sourceEndpoint: string | null;
+    paidAmountUsdc: string;
+    fetchedAt: string;
+    lastUsedAt: string;
+    peerCatalogId: string | null;
+}
+export interface NetworkArtifactMetadataRow {
+    sha256: string;
+    artifactType: string;
+    envelopeCid: string | null;
+    contentSize: number;
+    source: NetworkArtifactSource;
+    sourceOperator: string | null;
+    sourceEndpoint: string | null;
+    paidAmountUsdc: string;
+    fetchedAt: string;
+    lastUsedAt: string;
+    peerCatalogId: string | null;
+}
+export type TaskPostingPolicyType = 'once_per_safe' | 'once_per_bucket' | 'interval';
+type LauncherTaskProjectionState = 'open' | 'claims-in-flight' | 'fully-claimed' | 'settled' | 'failed';
+export interface TaskPostRecord {
     creatorSafeAddress: string;
     sourceKey: string;
-    policyType: IntentPostingPolicyType;
+    policyType: TaskPostingPolicyType;
     scopeKey: string;
-    desiredStateId: string;
+    taskId: string;
+    protocolTaskId?: string | null;
+    taskCid?: string | null;
     requestId: string;
     firstPostedAt: string;
     lastPostedAt: string;
@@ -56,6 +167,20 @@ export declare class Store {
     readonly db: Database.Database;
     readonly path: string;
     constructor(dbPath: string);
+    /** Older request-first DBs keyed artifacts by desired_state_id before Task-native IDs landed. */
+    private ensureArtifactsTaskColumns;
+    /** Older on-disk DBs predate `peer_catalog_id` on network_artifacts. */
+    private ensureNetworkArtifactsPeerCatalogId;
+    /** Fresh v1 state is Task-first; older local DBs get additive columns only. */
+    private ensureTaskPostsTaskCoordinatorColumns;
+    /** Older local DBs may have the projection table from before Task grouping fields landed. */
+    private ensureEnvelopeProjectionColumns;
+    /**
+     * Task-native startup ignores the retired request-first `restoration_intents`
+     * table. Keep a one-time local marker when old in-flight rows are present so
+     * operators can see why they were not resumed without blocking Store startup.
+     */
+    private recordLegacyRestorationIntentsIgnored;
     /** Idempotent: older DBs before idx_reward_claims_tx may lack the unique index. */
     private ensureRewardClaimsTxIndex;
     recordOwnActivity(requestId: string, role: 'created' | 'claimed' | 'delivered' | 'evaluated'): void;
@@ -67,26 +192,63 @@ export declare class Store {
     /** Generic config row (e.g. last_reward_claim_tick_at). */
     getConfigValue(key: string): string | null;
     setConfigValue(key: string, value: string): void;
-    getIntentPostRecord(args: {
+    getTaskPostRecord(args: {
         creatorSafeAddress: string;
         sourceKey: string;
-        policyType: IntentPostingPolicyType;
+        policyType: TaskPostingPolicyType;
         scopeKey: string;
-    }): IntentPostRecord | null;
-    upsertIntentPostRecord(record: IntentPostRecord): void;
-    acquireIntentPostLock(args: {
+    }): TaskPostRecord | null;
+    /**
+     * Posted Tasks for the launcher mode (`GET /v1/launcher/tasks`,
+     * spec/2026-05-05-launcher-role-and-mode.md §5.3). Returns rows from
+     * `task_posts` filtered by creator Safe address, sorted by `last_posted_at
+     * DESC` (most recent first). The `solverType` is denormalised in by joining
+     * `activity_events` on `request_id` for the `task_posted` kind — that's
+     * where `posting-service.ts` writes the SolverType when the post lands.
+     *
+     * `before` filters to rows with `last_posted_at < before` (ISO-8601). When
+     * `before` is undefined, returns the most recent `limit` rows.
+     *
+     * Caller-side: `gatherLauncherTasks` (`api/launcher-tasks.ts`) maps the
+     * solver_type back to the operator's SolverNet name via config lookup.
+     */
+    listPostedTasksByCreator(args: {
+        creatorSafeAddress: string;
+        limit: number;
+        before?: string;
+    }): Array<{
+        taskId: string;
+        taskCid: string;
+        solverType: string | null;
+        requestId: string;
+        postedAt: string;
+        state?: LauncherTaskProjectionState;
+        claims?: {
+            current?: number;
+            max?: number;
+        };
+    }>;
+    /** Count of posted Tasks for this creator with the given solver_type. v1
+     *  treats every posted Task as in-flight (state derivation lands with
+     *  router-watcher hardening, jinn-mono-l2zl.12). */
+    countPostedTasksByCreatorAndSolverType(args: {
+        creatorSafeAddress: string;
+        solverType: string;
+    }): number;
+    upsertTaskPostRecord(record: TaskPostRecord): void;
+    acquireTaskPostLock(args: {
         creatorSafeAddress: string;
         sourceKey: string;
-        policyType: IntentPostingPolicyType;
+        policyType: TaskPostingPolicyType;
         scopeKey: string;
         ownerToken: string;
         lockedAt: string;
         staleAfterMs: number;
     }): boolean;
-    releaseIntentPostLock(args: {
+    releaseTaskPostLock(args: {
         creatorSafeAddress: string;
         sourceKey: string;
-        policyType: IntentPostingPolicyType;
+        policyType: TaskPostingPolicyType;
         scopeKey: string;
         ownerToken: string;
     }): void;
@@ -116,11 +278,12 @@ export declare class Store {
     upsertBalanceCache(entry: BalanceCacheEntry): void;
     getBalanceCache(): BalanceCacheEntry[];
     private backfillActivityEvents;
+    getTaskEvidenceHash(requestId: string): string | null;
     getLastProcessedBlock(): bigint | null;
     setLastProcessedBlock(block: bigint): void;
     insertArtifact(artifact: {
         id: string;
-        desiredStateId: string;
+        taskId: string;
         requestId: string;
         title: string;
         content: string;
@@ -131,7 +294,7 @@ export declare class Store {
         tags?: string[];
         outcome?: string;
         requestId?: string;
-        desiredStateId?: string;
+        taskId?: string;
         after?: string;
         before?: string;
         limit?: number;
@@ -142,12 +305,12 @@ export declare class Store {
         tags: string[];
         outcome: string;
         request_id: string;
-        desired_state_id: string;
+        task_id: string;
         created_at: string;
     }>;
     insertRemoteArtifact(artifact: {
         id: string;
-        desiredStateId: string;
+        taskId: string;
         requestId: string;
         title: string;
         tags: string[];
@@ -156,8 +319,13 @@ export declare class Store {
         endpoint: string;
         price?: string;
     }): void;
-    getArtifactContent(id: string): string | null;
-    getRemoteArtifactInfo(id: string): {
+    /**
+     * Text body for a catalog artifact id: local `artifacts.content`, else a peer-cached
+     * blob in `network_artifacts` (via `peer_catalog_id`).
+     */
+    resolveCatalogArtifactContent(id: string): string | null;
+    /** Endpoint / owner for a remote (peer-synced) catalog row in `artifacts`. */
+    getRemoteDiscoveryMetadata(id: string): {
         endpoint: string;
         ownerAddress: string;
         price?: string;
@@ -169,6 +337,52 @@ export declare class Store {
         tags: string[];
         outcome: string;
     } | null;
-    cacheRemoteContent(id: string, content: string): void;
+    saveServedArtifact(input: ServedArtifactInput): void;
+    getServedArtifact(sha256: string): ServedArtifactRow | null;
+    getServedArtifactMetadata(sha256: string): ServedArtifactMetadataRow | null;
+    listServedArtifactMetadata(filter?: {
+        artifactType?: string;
+        limit?: number;
+    }): ServedArtifactMetadataRow[];
+    recordArtifactAccessEvent(input: ArtifactAccessEventInput): void;
+    listArtifactAccessEvents(filter?: {
+        sha256?: string;
+        limit?: number;
+    }): ArtifactAccessEventRow[];
+    getArtifactAccessSummary(): ArtifactAccessStats;
+    getArtifactAccessStatsBySha(sha256s: string[]): Record<string, ArtifactAccessStats>;
+    setServedArtifactEnvelopeCid(sha256: string, envelopeCid: string): void;
+    getServedArtifactsByRequestId(requestId: string): ServedArtifactRow[];
+    saveNetworkArtifact(input: NetworkArtifactInput): void;
+    getNetworkArtifact(sha256: string): NetworkArtifactRow | null;
+    getNetworkArtifactMetadata(sha256: string): NetworkArtifactMetadataRow | null;
+    listNetworkArtifactMetadata(filter?: {
+        artifactType?: string;
+        limit?: number;
+    }): NetworkArtifactMetadataRow[];
+    touchNetworkArtifactUsage(sha256: string, ts: string): void;
+    /**
+     * Local fast-path search across own (served) artifacts and cached (network)
+     * artifacts. Used by MCP record search to prepend locally held matches to
+     * corpus query results without loading artifact bytes.
+     */
+    searchOwnAndCached(filter: {
+        artifactType?: string;
+        limit: number;
+    }): Array<{
+        sha256: string;
+        artifactType: string;
+        source: 'served' | 'network';
+        envelopeCid: string | null;
+        createdAt: string;
+        contentSize: number;
+        priceUsdc?: string;
+        sourceEndpoint?: string | null;
+        sourceOperator?: string | null;
+        paidAmountUsdc?: string;
+    }>;
+    saveEnvelopeProjection(projection: EnvelopeProjection): void;
+    queryEnvelopeProjections(query?: EnvelopeProjectionQuery): EnvelopeProjection[];
     close(): void;
 }
+export {};