@dvmkit/sdk 0.1.2-rc.7 → 0.1.4-rc.7

package/dist/chunk-RW5LP57K.js

@@ -0,0 +1,44 @@
+// src/sdk/store.ts
+var MemoryKVStore = class {
+  data = /* @__PURE__ */ new Map();
+  /** Retrieve a value by key. Returns undefined if not found or expired. */
+  get(key) {
+    const entry = this.data.get(key);
+    if (!entry) return Promise.resolve(void 0);
+    if (entry.expiry !== void 0 && Date.now() > entry.expiry) {
+      this.data.delete(key);
+      return Promise.resolve(void 0);
+    }
+    return Promise.resolve(entry.value);
+  }
+  /** Store a value. Optionally set a TTL in seconds. */
+  set(key, value, opts) {
+    const expiry = opts?.ttl !== void 0 ? Date.now() + opts.ttl * 1e3 : void 0;
+    this.data.set(key, { value, expiry });
+    return Promise.resolve();
+  }
+  /** Delete a key. */
+  delete(key) {
+    this.data.delete(key);
+    return Promise.resolve();
+  }
+  /** List keys, optionally filtered by prefix. Excludes expired entries. */
+  list(prefix) {
+    const now = Date.now();
+    const keys = [];
+    for (const [key, entry] of this.data) {
+      if (entry.expiry !== void 0 && now > entry.expiry) {
+        this.data.delete(key);
+        continue;
+      }
+      if (prefix === void 0 || key.startsWith(prefix)) {
+        keys.push(key);
+      }
+    }
+    return Promise.resolve(keys);
+  }
+};
+
+export {
+  MemoryKVStore
+};

package/dist/{chunk-6JZIX5WW.js → chunk-SSSZUVWM.js}

@@ -125,6 +125,7 @@ var ListenChannel = class {
 
 // src/sdk/server/postgres-job-store.ts
 var JOB_MESSAGES_CHANNEL = "job_messages";
+var JOB_DVM_ID = /* @__PURE__ */ Symbol("jobDvmId");
 var PostgresJobStore = class {
   pool;
   listenChannel = null;
@@ -177,6 +178,18 @@ var PostgresJobStore = class {
       ALTER TABLE jobs ADD COLUMN IF NOT EXISTS native_amount DOUBLE PRECISION;
       ALTER TABLE jobs ADD COLUMN IF NOT EXISTS native_asset TEXT;
       ALTER TABLE jobs ADD COLUMN IF NOT EXISTS cashu_flow TEXT;
+      -- internal-review: what the job cost the BUILDER to serve, declared by the
+      -- handler through ctx.cost(). NULL is "unreported", deliberately
+      -- distinguishable from a declared zero.
+      ALTER TABLE jobs ADD COLUMN IF NOT EXISTS cost_amount_micro BIGINT;
+      ALTER TABLE jobs ADD COLUMN IF NOT EXISTS cost_currency TEXT;
+      ALTER TABLE jobs ADD COLUMN IF NOT EXISTS cost_revision BIGINT;
+      -- Cost-only reports are queued after the terminal row lands. Keep the
+      -- owning DVM and the last durably-enqueued revision on that row so a
+      -- restarted (or sibling) process can close that crash window without
+      -- replaying another mount's jobs.
+      ALTER TABLE jobs ADD COLUMN IF NOT EXISTS dvm_id TEXT;
+      ALTER TABLE jobs ADD COLUMN IF NOT EXISTS cost_reported_revision BIGINT;
       ALTER TABLE jobs ADD COLUMN IF NOT EXISTS required_msats BIGINT;
       -- next_seq is intentionally absent from isolate_jobs (platform/db.ts).
       -- It powers StreamableJobStore cross-machine seq allocation; isolate
@@ -202,6 +215,7 @@ var PostgresJobStore = class {
       -- receipt or re-allocate a sequence number.
       ALTER TABLE jobs ADD COLUMN IF NOT EXISTS receipt JSONB;
       ALTER TABLE jobs ADD COLUMN IF NOT EXISTS receipt_seq BIGINT;
+      ALTER TABLE jobs ADD COLUMN IF NOT EXISTS redacted_at BIGINT;
       -- internal-review: credit-ledger linkage. Written at submission alongside the
       -- payment fields; the terminal funnel settles/releases the draw and the
       -- receipt countersigns the ReceiptCredit block from it.
@@ -241,6 +255,13 @@ var PostgresJobStore = class {
       $migration$;
       UPDATE jobs SET next_seq = seq + 1 WHERE next_seq <= seq;
       CREATE INDEX IF NOT EXISTS idx_jobs_status ON jobs (status);
+      CREATE INDEX IF NOT EXISTS idx_jobs_retention
+        ON jobs (last_activity_at, id)
+        WHERE redacted_at IS NULL AND status IN ('completed', 'failed', 'cancelled');
+      CREATE INDEX IF NOT EXISTS idx_jobs_pending_cost_report
+        ON jobs (dvm_id, id)
+        WHERE cost_revision IS NOT NULL
+          AND status IN ('completed', 'failed', 'cancelled');
       -- internal-review: the idempotent-replay lookup. payment_tx_hash carries the
       -- caller's X-Cashu-Request-Id on the accumulator path, so a retried paid
       -- submit finds the job its payment already created.
@@ -409,18 +430,32 @@ var PostgresJobStore = class {
     held.client.release();
   }
   async save(record) {
+    await this.saveRecord(record, record[JOB_DVM_ID]);
+  }
+  /** Persist a job while retaining its mount identity for cost-report recovery. */
+  async saveForDvm(record, dvmId) {
+    const scoped = record;
+    scoped[JOB_DVM_ID] = dvmId;
+    try {
+      await this.save(scoped);
+    } finally {
+      delete scoped[JOB_DVM_ID];
+    }
+  }
+  async saveRecord(record, dvmId) {
     const { rowCount } = await this.pool.query(
       `INSERT INTO jobs (
         id, tags, capability, input, params, requester_id, status, summary,
         messages, seq, paid_msats, payment_mint, payment_rail,
         payment_tx_hash, payment_transaction_hash, native_amount, native_asset, cashu_flow,
+        cost_amount_micro, cost_currency, cost_revision,
         received_proofs, pending_payment_msats, pending_mpp_challenge_ids,
         pending_x402_nonce, pending_x402_amount_usdc_micro, required_msats, step_cache, state, created_at,
         last_activity_at, next_seq, requester_token_hash, requester_token,
         request_fingerprint, requester_pubkey, request_id, credit_id, draw_id,
         pending_payment_fiat_micro, pending_payment_fiat_currency, auth_request_path,
-        funding_receipt, funding_credit
-      ) VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13,$14,$15,$16,$17,$18,$19,$20,$21,$22,$23,$24,$25,$26,$27,$28,$29,$30,$31,$32,$33,$34,$35,$36,$37,$38,$39,$40,$41)
+        funding_receipt, funding_credit, dvm_id
+      ) VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13,$14,$15,$16,$17,$18,$19,$20,$21,$22,$23,$24,$25,$26,$27,$28,$29,$30,$31,$32,$33,$34,$35,$36,$37,$38,$39,$40,$41,$42,$43,$44,$45)
       ON CONFLICT (id) DO UPDATE SET
         status = EXCLUDED.status,
         summary = EXCLUDED.summary,
@@ -436,6 +471,29 @@ var PostgresJobStore = class {
         native_amount = EXCLUDED.native_amount,
         native_asset = EXCLUDED.native_asset,
         cashu_flow = EXCLUDED.cashu_flow,
+        -- Cost declarations are revisioned because a terminal snapshot can be
+        -- re-saved by a different machine. Never let a stale persisted prefix
+        -- replace the handler owner's later cumulative declaration; a higher
+        -- revision with NULL amount/currency is an intentional invalidation.
+        cost_amount_micro = CASE
+          WHEN EXCLUDED.cost_revision IS NOT NULL
+            AND (jobs.cost_revision IS NULL OR EXCLUDED.cost_revision >= jobs.cost_revision)
+          THEN EXCLUDED.cost_amount_micro
+          ELSE jobs.cost_amount_micro
+        END,
+        cost_currency = CASE
+          WHEN EXCLUDED.cost_revision IS NOT NULL
+            AND (jobs.cost_revision IS NULL OR EXCLUDED.cost_revision >= jobs.cost_revision)
+          THEN EXCLUDED.cost_currency
+          ELSE jobs.cost_currency
+        END,
+        cost_revision = CASE
+          WHEN EXCLUDED.cost_revision IS NOT NULL
+            AND (jobs.cost_revision IS NULL OR EXCLUDED.cost_revision >= jobs.cost_revision)
+          THEN EXCLUDED.cost_revision
+          ELSE jobs.cost_revision
+        END,
+        dvm_id = COALESCE(jobs.dvm_id, EXCLUDED.dvm_id),
         received_proofs = EXCLUDED.received_proofs,
         pending_mpp_challenge_ids = EXCLUDED.pending_mpp_challenge_ids,
         pending_x402_nonce = EXCLUDED.pending_x402_nonce,
@@ -452,8 +510,9 @@ var PostgresJobStore = class {
       -- idempotent re-persist of the same outcome); a different status is
       -- rejected wholesale, so the row can't end up as a Frankenstein of a
       -- cancelled status and a completed snapshot.
-      WHERE jobs.status NOT IN ('completed', 'failed', 'cancelled')
-         OR jobs.status = EXCLUDED.status`,
+      WHERE jobs.redacted_at IS NULL
+        AND (jobs.status NOT IN ('completed', 'failed', 'cancelled')
+          OR jobs.status = EXCLUDED.status)`,
       [
         record.id,
         JSON.stringify(record.tags),
@@ -473,6 +532,9 @@ var PostgresJobStore = class {
         record.nativeAmount ?? null,
         record.nativeAsset ?? null,
         record.cashuFlow ?? null,
+        record.costAmountMicro ?? null,
+        record.costCurrency ?? null,
+        record.costRevision ?? null,
         JSON.stringify(record.receivedProofs),
         record.pendingPaymentMsats ?? null,
         record.pendingMppChallengeIds ? JSON.stringify(record.pendingMppChallengeIds) : null,
@@ -508,7 +570,8 @@ var PostgresJobStore = class {
         // whose live gate accepted this proof.
         record.authRequestPath ?? null,
         record.fundingReceipt ? JSON.stringify(record.fundingReceipt) : null,
-        record.fundingCredit ? JSON.stringify(record.fundingCredit) : null
+        record.fundingCredit ? JSON.stringify(record.fundingCredit) : null,
+        dvmId ?? null
       ]
     );
     if (rowCount === 0) {
@@ -525,10 +588,109 @@ var PostgresJobStore = class {
       await this.pool.query("DELETE FROM job_messages WHERE job_id = $1", [record.id]).catch(() => void 0);
     }
   }
+  /**
+   * Read terminal zero-revenue jobs whose latest declared-cost revision has
+   * not yet reached the durable reporter outbox.
+   */
+  async listUnreportedTerminalCosts(args) {
+    const { rows } = await this.pool.query(
+      `SELECT *
+       FROM jobs
+       WHERE dvm_id = $1
+         AND cost_revision IS NOT NULL
+         AND (cost_reported_revision IS NULL OR cost_reported_revision < cost_revision)
+         AND (
+           status IN ('failed', 'cancelled')
+           OR (status = 'completed' AND paid_msats = 0)
+         )
+         AND ($2::text IS NULL OR id > $2)
+       ORDER BY id
+       LIMIT $3`,
+      [args.dvmId, args.afterJobId ?? null, args.limit]
+    );
+    return rows.map(rowToRecord);
+  }
+  /** Mark one revision only after its report has reached durable enqueue. */
+  async markTerminalCostReported(jobId, costRevision) {
+    const { rowCount } = await this.pool.query(
+      `UPDATE jobs
+       SET cost_reported_revision = GREATEST(COALESCE(cost_reported_revision, -1), $2)
+       WHERE id = $1 AND cost_revision = $2`,
+      [jobId, costRevision]
+    );
+    return rowCount === 1;
+  }
   async delete(id) {
     await this.pool.query("DELETE FROM jobs WHERE id = $1", [id]);
     await this.pool.query("DELETE FROM job_messages WHERE job_id = $1", [id]).catch(() => void 0);
   }
+  async listJobsForRetention(args) {
+    const after = args.after;
+    const capabilityClause = args.capabilities === null ? "" : "AND capability = ANY($5::text[])";
+    const params = [
+      args.lastActivityBeforeMs,
+      args.limit,
+      after?.lastActivityAt ?? null,
+      after?.id ?? null
+    ];
+    if (args.capabilities !== null) params.push(args.capabilities);
+    const { rows } = await this.pool.query(
+      `SELECT * FROM jobs
+        WHERE redacted_at IS NULL
+          AND status IN ('completed', 'failed', 'cancelled')
+          AND last_activity_at < $1
+          AND ($3::bigint IS NULL OR (last_activity_at, id) > ($3::bigint, $4::text))
+          ${capabilityClause}
+        ORDER BY last_activity_at, id
+        LIMIT $2`,
+      params
+    );
+    return rows.map((row) => rowToRecord(row));
+  }
+  async redactJob(args) {
+    const client = await this.pool.connect();
+    try {
+      await client.query("BEGIN");
+      const { rowCount } = await client.query(
+        `UPDATE jobs SET
+         input = '',
+         params = '{}'::jsonb,
+         summary = NULL,
+         messages = '[]'::jsonb,
+         received_proofs = '[]'::jsonb,
+         pending_payment_msats = NULL,
+         pending_mpp_challenge_ids = NULL,
+         pending_x402_nonce = NULL,
+         pending_x402_amount_usdc_micro = NULL,
+         pending_payment_fiat_micro = NULL,
+         pending_payment_fiat_currency = NULL,
+         step_cache = '[]'::jsonb,
+         state = '{}'::jsonb,
+         requester_token = NULL,
+         request_fingerprint = NULL,
+         auth_request_path = NULL,
+         redacted_at = $3
+       WHERE id = $1
+         AND last_activity_at = $2
+         AND redacted_at IS NULL
+         AND status IN ('completed', 'failed', 'cancelled')`,
+        [args.jobId, args.expectedLastActivityAt, args.redactedAt]
+      );
+      if (rowCount === 1) {
+        await client.query("DELETE FROM job_messages WHERE job_id = $1", [args.jobId]);
+      }
+      await client.query("COMMIT");
+      return rowCount === 1;
+    } catch (err) {
+      try {
+        await client.query("ROLLBACK");
+      } catch {
+      }
+      throw err;
+    } finally {
+      client.release();
+    }
+  }
   async claimReceiptSeq(jobId) {
     const client = await this.pool.connect();
     try {
@@ -577,7 +739,9 @@ var PostgresJobStore = class {
     try {
       await client.query("BEGIN");
       const { rows } = await client.query(
-        "UPDATE jobs SET next_seq = next_seq + 1, last_activity_at = $2 WHERE id = $1 RETURNING (next_seq - 1) AS seq",
+        `UPDATE jobs SET next_seq = next_seq + 1, last_activity_at = $2
+           WHERE id = $1 AND redacted_at IS NULL
+           RETURNING (next_seq - 1) AS seq`,
         [jobId, Date.now()]
       );
       if (rows.length === 0) {
@@ -667,7 +831,9 @@ var PostgresJobStore = class {
     try {
       await client.query("BEGIN");
       const { rows } = await client.query(
-        "UPDATE jobs SET next_seq = next_seq + 1, last_activity_at = $2 WHERE id = $1 RETURNING (next_seq - 1) AS seq",
+        `UPDATE jobs SET next_seq = next_seq + 1, last_activity_at = $2
+           WHERE id = $1 AND redacted_at IS NULL
+           RETURNING (next_seq - 1) AS seq`,
         [jobId, Date.now()]
       );
       if (rows.length === 0) {
@@ -1127,6 +1293,9 @@ function rowToRecord(row) {
     nativeAmount: row.native_amount,
     nativeAsset: row.native_asset,
     cashuFlow: row.cashu_flow,
+    costAmountMicro: row.cost_amount_micro == null ? void 0 : Number(row.cost_amount_micro),
+    costCurrency: row.cost_currency ?? void 0,
+    costRevision: row.cost_revision == null ? void 0 : Number(row.cost_revision),
     creditId: row.credit_id ?? void 0,
     drawId: row.draw_id ?? void 0,
     fundingReceipt: row.funding_receipt ?? void 0,
@@ -1146,7 +1315,8 @@ function rowToRecord(row) {
     stepCache: row.step_cache,
     state: row.state,
     createdAt: Number(row.created_at),
-    lastActivityAt: Number(row.last_activity_at)
+    lastActivityAt: Number(row.last_activity_at),
+    redactedAt: row.redacted_at == null ? void 0 : Number(row.redacted_at)
   };
 }