@dvmkit/sdk 0.7.0-rc.7 → 0.7.0-rc.9

package/README.md

@@ -110,7 +110,7 @@ This metadata describes the retention schedule. The SDK does not automatically d
 
 Use the Node.js release in `.nvmrc` (Node 22). Install with `npm ci`, then run the same gate CI runs with `npm run verify`. The gate checks repository metadata in the checkout, copies only tracked and unignored source into an isolated directory, installs its locked dependencies, and runs lint, build, typecheck (including the release scripts under `checkJs`), unit and database tests, API, package, consumer, packed-artifact safety, and release checks there. The clean source tree owns the complete build and test pass, so verification never depends on the checkout's `node_modules` or pre-existing `dist` and does not repeat the full suite; after every check passes, its verified `dist` replaces the checkout's build output for release packaging.
 
-`DATABASE_URL` is optional locally. Without it the database suite is skipped rather than passed, and `verify` says so in its summary, because a skipped suite verified nothing and must not be reported as green. Point `DATABASE_URL` at a scratch Postgres to run it, and pass `npm run verify -- --require-database` to make a missing one a failure, which is what CI does.
+`DATABASE_URL` is optional locally. Without it the database suite is skipped rather than passed, and `verify` says so in its summary, because a skipped suite verified nothing and must not be reported as green. Point `DATABASE_URL` at a scratch Postgres to run it, and pass `npm run verify -- --require-database` to make a missing one a failure, which is what CI does. That mode also requires the local test mint started by `node scripts/start-cashu-mint.mjs`.
 
 The public surface is exactly `@dvmkit/sdk`, `@dvmkit/sdk/server`, and `@dvmkit/sdk/testing`.
 
@@ -150,6 +150,10 @@ The same values are accepted as `--endpoint <url>` and `--job-token <hex>`. Thes
 
 If an upgrade broke something for you, an [API compatibility report](https://github.com/dvmkit/sdk/issues/new/choose) is the most useful thing you can send us. It tells us which parts of the published surface people actually build on, which no test of ours can.
 
+## Job identity field
+
+Every 200 or 202 response to `POST /v1/job`, `POST /v1/request-resume/:id` and `POST /v1/request-result/:id` carries a `DVM-Job-Identity-V1` response-head field whose value is the body's `job_id`, byte for byte, so a router or caller can learn which job a response names without reading a body of any size. No other status carries it. The value grammar is `^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$`; a server whose job ID falls outside it sends no field. A reader takes the value from `Headers.get`, trims nothing and never folds case: a repeated field (joined with `", "`), an empty value or any other character is invalid, and a trailer of the same name is never identity. The portable contract and its classification vectors are in `protocol-fixtures/job-identity-v1.json`. Hosting control's status reports `jobIdentityHeader: "v1"` when the deployment emits the field.
+
 ## Per-job costs
 
 A handler can declare what a job cost **you**, the builder, to serve — a vendor API call, a GPU minute, a per-request licence fee — and the SDK reports it to the platform alongside what the caller paid, so your dashboard can state a margin instead of guessing at one.
@@ -171,7 +175,7 @@ Three things worth knowing:
 - **Declare the cost where you incur it, including inside `ctx.step`.** The step cache carries those declarations with the result and applies them once when a replay skips the body.
 - **Every terminal job reports its declared cost.** A paid completion carries the cost on its revenue report. A free completion, failure, or cancellation sends a separate cost-only report and does not create revenue.
 
-The cost is yours, never the caller's: it is recorded separately from what the caller paid and is never netted against it. Both report shapes use the same durable outbox. Cost-only reports are keyed on the job id and revisioned, so retries and cross-machine updates converge on the latest cumulative value. With the Postgres job store, boot-time and periodic reconciliation enqueue any terminal cost revision that a process exited before reporting.
+The cost is yours, never the caller's: it is recorded separately from what the caller paid and is never netted against it. Both report shapes use the same durable outbox. Cost-only reports are keyed on the job id and revisioned, so retries and cross-machine updates converge on the latest cumulative value. With the Postgres job store, boot-time and periodic reconciliation enqueue any terminal cost revision that a process exited before reporting. Other job stores get no reconciliation: their cost-only report is durable only once the outbox insert commits, so an exit between the terminal save and that insert loses it.
 
 ## Rate cards
 

package/dist/{chunk-YK54BJ2L.js → chunk-2DE32RAW.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";

package/dist/{chunk-NUPEAWRM.js → chunk-2GTLF74N.js}

@@ -1,6 +1,6 @@
 import {
   validateCurrency
-} from "./chunk-LQQ6H4UB.js";
+} from "./chunk-5CSR33B5.js";
 
 // src/sdk/pricing/upfront.ts
 function buildUpfront(input) {

package/dist/{chunk-MYJOV4R4.js → chunk-2HAFZ5GC.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-AFV77S4C.js";
 import {
   loggers
-} from "./chunk-SX4WCPW7.js";
+} from "./chunk-RGSWVNQG.js";
 import {
   redactUrl
 } from "./chunk-KXWROQGK.js";

package/dist/{chunk-LQQ6H4UB.js → chunk-5CSR33B5.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/sdk/pricing/currency.ts
 var InvalidCurrencyError = class extends Error {

package/dist/{chunk-FXDQMJQ2.js → chunk-5PLQOC4B.js}

@@ -779,6 +779,7 @@ var diagnostic_catalogue_v1_default = {
     "hardened",
     "head_status",
     "hint",
+    "hosting_identity_revoke_failed",
     "ingest_concurrency",
     "ingest_global_concurrency",
     "ingest_ip_concurrency",
@@ -1067,6 +1068,25 @@ var diagnostic_catalogue_v1_default = {
     "UA-14",
     "UA-40",
     "UA-43"
+  ],
+  submitIdentitySources: [
+    "header",
+    "header_absent",
+    "header_invalid",
+    "not_extracted"
+  ],
+  fundedRuntimeReclaims: [
+    "closed"
+  ],
+  suspensionReasons: [
+    "request_limit",
+    "dvm_limit",
+    "behaviour",
+    "free_tier_idle",
+    "admin_org_suspend",
+    "builder_pause",
+    "withdrawn",
+    "operator"
   ]
 };
 
@@ -1080,6 +1100,12 @@ var PAYMENT_ENUMS = {
   failure_stage: new Set(diagnostic_catalogue_v1_default.paymentFailureStages),
   phase: new Set(diagnostic_catalogue_v1_default.paymentPhases)
 };
+var ROUTER_ENUMS = {
+  submit_identity_source: new Set(diagnostic_catalogue_v1_default.submitIdentitySources),
+  funded_runtime_reclaim: new Set(diagnostic_catalogue_v1_default.fundedRuntimeReclaims),
+  suspended_reclaim: new Set(diagnostic_catalogue_v1_default.suspensionReasons),
+  suspended_admin: new Set(diagnostic_catalogue_v1_default.suspensionReasons)
+};
 var EVENTS = new Set(diagnostic_catalogue_v1_default.events);
 var ROUTE_TEMPLATES = [...diagnostic_catalogue_v1_default.routeTemplates].sort(
   compareRouteTemplates
@@ -1280,9 +1306,9 @@ function projectFields(input, dataset, authority, identityAuthority) {
   return output;
 }
 function projectField(key, value, dataset, authority, identityAuthority) {
-  const paymentEnum = Object.hasOwn(PAYMENT_ENUMS, key) ? PAYMENT_ENUMS[key] : void 0;
-  if (paymentEnum)
-    return typeof value === "string" && paymentEnum.has(value) ? value : void 0;
+  const closedEnum = Object.hasOwn(PAYMENT_ENUMS, key) ? PAYMENT_ENUMS[key] : Object.hasOwn(ROUTER_ENUMS, key) ? ROUTER_ENUMS[key] : void 0;
+  if (closedEnum)
+    return typeof value === "string" && closedEnum.has(value) ? value : void 0;
   if (BOOLEAN_FIELDS.has(key))
     return typeof value === "boolean" ? value : void 0;
   if (INTEGER_FIELDS.has(key))

package/dist/{chunk-QTH7CIA3.js → chunk-5TIFEMHJ.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-BPYMEMQX.js";
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/lib/cashu/lock-pubkey.ts
 function toLockPubkey(raw) {
@@ -397,10 +397,20 @@ var DEFAULT_LOCK_RETRY_INTERVAL_MS = 1e3;
 var WALLET_VERSION = 9;
 var RECENT_SPENDS_CAP = 10;
 var DEFAULT_AGENT_MINT_URL = "https://mint.coinos.io";
+var MAX_STORABLE_JOB_ID_LENGTH = 512;
+function isStorableJobId(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= MAX_STORABLE_JOB_ID_LENGTH && // eslint-disable-next-line no-control-regex -- control characters are what this rejects
+  !/[\u0000-\u001f\u007f-\u009f]/u.test(value);
+}
 function loadWalletConfiguredMints() {
   return loadAgentWallet()?.mints ?? [];
 }
 function loadAgentWallet() {
+  const wallet = parseAgentWallet();
+  if (wallet) normalizeAcceptedUnresolved(wallet);
+  return wallet;
+}
+function parseAgentWallet() {
   if (!existsSync4(WALLET_FILE)) return null;
   const raw = readFileSync4(WALLET_FILE, "utf-8");
   let parsed;
@@ -481,6 +491,7 @@ function loadAgentWallet() {
   return parsed;
 }
 function saveAgentWallet(wallet) {
+  assertAcceptedUnresolvedStorable(wallet);
   ensureConfigDir();
   const tmp = `${WALLET_FILE}.tmp`;
   const data = JSON.stringify(wallet, null, 2) + "\n";
@@ -649,6 +660,62 @@ function migrateV8ToV9(parsed) {
     created_at: typeof parsed.created_at === "string" ? parsed.created_at : (/* @__PURE__ */ new Date()).toISOString()
   };
 }
+var ACCEPTED_UNRESOLVED_KINDS = /* @__PURE__ */ new Set([
+  "identity_mismatch",
+  "body_unreadable",
+  "router_identity_conflict"
+]);
+var OBSERVED_JOB_ID_FIELDS = ["header_job_id", "body_job_id", "accepted_job_id"];
+var PLACEHOLDER_KIND = "body_unreadable";
+var PLACEHOLDER_OBSERVED_AT = (/* @__PURE__ */ new Date(0)).toISOString();
+function assertAcceptedUnresolvedStorable(wallet) {
+  const entries = wallet.pending_submissions;
+  if (!Array.isArray(entries)) return;
+  for (const entry of entries) {
+    const record = entry?.accepted_unresolved;
+    if (record === void 0 || isStorableAcceptedUnresolved(record)) continue;
+    throw new DvmError(
+      "accepted_unresolved_invalid",
+      `Refusing to save pending submission ${String(entry?.request_id)}: its accepted_unresolved record is outside the stored contract.`,
+      "Use one of the three kinds, an ISO-8601 observed_at, and job IDs and ambiguity_id that pass isStorableJobId; omit an observed ID that does not. The wallet file was not changed."
+    );
+  }
+}
+function isStorableAcceptedUnresolved(value) {
+  if (!isPlainRecord(value)) return false;
+  return ACCEPTED_UNRESOLVED_KINDS.has(value.kind) && isIsoTimestamp(value.observed_at) && isStorableJobId(value.ambiguity_id) && OBSERVED_JOB_ID_FIELDS.every((field) => value[field] === void 0 || isStorableJobId(value[field]));
+}
+function normalizeAcceptedUnresolved(wallet) {
+  const entries = wallet.pending_submissions;
+  if (!Array.isArray(entries)) return;
+  for (const entry of entries) {
+    if (!entry || entry.accepted_unresolved === void 0) continue;
+    const stored = entry.accepted_unresolved;
+    if (isStorableAcceptedUnresolved(stored)) continue;
+    const record = isPlainRecord(stored) ? { ...stored } : {};
+    if (!ACCEPTED_UNRESOLVED_KINDS.has(record.kind)) record.kind = PLACEHOLDER_KIND;
+    if (!isIsoTimestamp(record.observed_at)) record.observed_at = PLACEHOLDER_OBSERVED_AT;
+    if (!isStorableJobId(record.ambiguity_id)) {
+      record.ambiguity_id = isStorableJobId(entry.request_id) ? entry.request_id : "missing-ambiguity";
+    }
+    for (const field of OBSERVED_JOB_ID_FIELDS) {
+      if (record[field] !== void 0 && !isStorableJobId(record[field])) delete record[field];
+    }
+    entry.accepted_unresolved = record;
+  }
+}
+function isPlainRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var ISO_TIMESTAMP = /^(\d{4})-(\d{2})-(\d{2})T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,9})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/;
+function isIsoTimestamp(value) {
+  if (typeof value !== "string") return false;
+  const match = ISO_TIMESTAMP.exec(value);
+  if (!match) return false;
+  const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
+  const date = new Date(Date.UTC(year, month - 1, day));
+  return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+}
 function isCounterMap(value) {
   if (typeof value !== "object" || value === null) return false;
   for (const inner of Object.values(value)) {
@@ -1255,6 +1322,17 @@ function buildAdminAuthHeader(args) {
   };
 }
 
+// src/lib/job-identity-header.ts
+var JOB_IDENTITY_HEADER = "dvm-job-identity-v1";
+var JOB_IDENTITY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
+function isJobIdentityValue(value) {
+  return typeof value === "string" && JOB_IDENTITY_PATTERN.test(value);
+}
+function parseJobIdentityHeader(value) {
+  if (value === null) return { kind: "absent" };
+  return isJobIdentityValue(value) ? { kind: "valid", jobId: value } : { kind: "invalid" };
+}
+
 // src/lib/builder-identity.ts
 import {
   chmodSync as chmodSync4,
@@ -1808,6 +1886,7 @@ export {
   WALLET_VERSION,
   RECENT_SPENDS_CAP,
   DEFAULT_AGENT_MINT_URL,
+  isStorableJobId,
   loadWalletConfiguredMints,
   loadAgentWallet,
   saveAgentWallet,
@@ -1835,6 +1914,9 @@ export {
   ADMIN_STATE_UNAVAILABLE,
   buildAdminChallenge,
   buildAdminAuthHeader,
+  JOB_IDENTITY_HEADER,
+  isJobIdentityValue,
+  parseJobIdentityHeader,
   generateIdentity,
   loadIdentitySecret,
   writeIdentity,

package/dist/{chunk-JUEEUV5X.js → chunk-6JZDFYQL.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-AFV77S4C.js";
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";
@@ -286,10 +286,20 @@ var PostgresJobStore = class {
       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
+      -- Terminal cost recovery runs at boot and every 30s on each machine.
+      -- Indexing only rows whose latest revision is not yet enqueued keeps each
+      -- pass proportional to that backlog; marking a row drops it from the
+      -- index. listUnreportedTerminalCosts' WHERE clause must imply this
+      -- predicate or the planner falls back to scanning terminal history.
+      DROP INDEX IF EXISTS idx_jobs_pending_cost_report;
+      CREATE INDEX IF NOT EXISTS idx_jobs_unreported_terminal_cost
         ON jobs (dvm_id, id)
         WHERE cost_revision IS NOT NULL
-          AND status IN ('completed', 'failed', 'cancelled');
+          AND (cost_reported_revision IS NULL OR cost_reported_revision < cost_revision)
+          AND (
+            status IN ('failed', 'cancelled')
+            OR (status = 'completed' AND paid_msats = 0)
+          );
       -- 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.
@@ -689,7 +699,8 @@ var PostgresJobStore = class {
   }
   /**
    * Read terminal zero-revenue jobs whose latest declared-cost revision has
-   * not yet reached the durable reporter outbox.
+   * not yet reached the durable reporter outbox. Keep the filter in step with
+   * `idx_jobs_unreported_terminal_cost`, which bounds each pass to the backlog.
    */
   async listUnreportedTerminalCosts(args) {
     const { rows } = await this.pool.query(

package/dist/{chunk-BDHJVTWA.js → chunk-7RZEJJTN.js}

@@ -4,7 +4,7 @@ import {
 import {
   diagnosticConsole,
   projectSpanRow
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/lib/x402/env.ts
 import { isAddress } from "viem";

package/dist/{chunk-XEOTTFLH.js → chunk-FYETJDBB.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-KXWROQGK.js";
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/observability/payment-diagnostics.ts
 import { AsyncLocalStorage } from "async_hooks";

package/dist/{chunk-HGMS3LR7.js → chunk-G7IXOVKV.js}

@@ -7,10 +7,10 @@ import {
   installHostedTempoCloseGuard,
   isTempoInsufficientFundsError,
   resolveTempoNetwork
-} from "./chunk-KYCLHWKO.js";
+} from "./chunk-QN3CQOE2.js";
 import {
   x402EarnedCeiling
-} from "./chunk-3VFEX2Y3.js";
+} from "./chunk-YNHXOONR.js";
 import {
   createX402FacilitatorAuthHeaders,
   createX402FacilitatorClient,
@@ -19,13 +19,13 @@ import {
   verifyWithFacilitator,
   withPaymentDiagnostics,
   withPaymentStage
-} from "./chunk-XEOTTFLH.js";
+} from "./chunk-FYETJDBB.js";
 import {
   MemoryCreditLedger
-} from "./chunk-FOJKZ4E7.js";
+} from "./chunk-YE53E4BT.js";
 import {
   PostgresJobStore
-} from "./chunk-JUEEUV5X.js";
+} from "./chunk-6JZDFYQL.js";
 import {
   parseStoreValue
 } from "./chunk-YG7G4DPZ.js";
@@ -36,7 +36,7 @@ import {
   humanizeZodIssues,
   signedRequestInput,
   zodIssuesOf
-} from "./chunk-X5RY2G3C.js";
+} from "./chunk-YS6PWVCZ.js";
 import {
   MemoryJobStore,
   UNCAPPABLE_ASK_TOTAL,
@@ -45,7 +45,7 @@ import {
   isJobRetentionStore,
   isReceiptIssuingStore,
   isStreamableJobStore
-} from "./chunk-MYJOV4R4.js";
+} from "./chunk-2HAFZ5GC.js";
 import {
   ContentHoldError,
   JobCancelledError,
@@ -65,6 +65,7 @@ import {
   ADMIN_AUTH_NONCE_TTL_SECONDS,
   ADMIN_STATE_UNAVAILABLE,
   IMPLICIT_CREDIT_TTL_MS,
+  JOB_IDENTITY_HEADER,
   TEMPO_SESSION_UPDATED_REASON,
   X402_BATCH_CHANNEL_ABI,
   attestedDvmIdentity,
@@ -74,6 +75,7 @@ import {
   createMonotonicClock,
   formatStaleness,
   getWallet,
+  isJobIdentityValue,
   isPublicRequestId,
   isX402SettlementReconciliationReason,
   parseTraceparent,
@@ -83,7 +85,7 @@ import {
   signReceipt,
   toLockPubkey,
   verifyChallenge
-} from "./chunk-QTH7CIA3.js";
+} from "./chunk-5TIFEMHJ.js";
 import {
   X402_BATCH_SETTLEMENT_SCHEME,
   X402_DEFAULT_FACILITATOR,
@@ -115,7 +117,7 @@ import {
   pinDimension,
   withSpan,
   withTraceContext
-} from "./chunk-SX4WCPW7.js";
+} from "./chunk-RGSWVNQG.js";
 import {
   StepCache
 } from "./chunk-BQJIFRAZ.js";
@@ -132,7 +134,7 @@ import {
   roundUsd,
   satsToFiat,
   validateCurrency
-} from "./chunk-LQQ6H4UB.js";
+} from "./chunk-5CSR33B5.js";
 import {
   CreditLedger,
   CreditLedgerError,
@@ -148,10 +150,10 @@ import {
   isNonChannelBitcoinRail,
   netOwedSats,
   x402SettlementPending
-} from "./chunk-WP7UX6RF.js";
+} from "./chunk-IOKEKMIU.js";
 import {
   withPostgresRecoveryContext
-} from "./chunk-6RYCZLCK.js";
+} from "./chunk-QM2OS3NJ.js";
 import {
   DvmError,
   x402NetworkByCaip2
@@ -159,7 +161,7 @@ import {
 import {
   createDiagnosticCapabilityAuthority,
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 import {
   MemoryProcessedPaymentStore,
   PostgresProcessedPaymentStore,
@@ -3875,7 +3877,7 @@ async function verifyUpfrontPaymentInScope(opts) {
           x402Requirements
         });
       }
-      const { verifyX402Payment } = await import("./x402-BN26TQZ6.js");
+      const { verifyX402Payment } = await import("./x402-T7WVKDD4.js");
       const receipt = await withPaymentStage("verifier_broadcast", () => verifyX402Payment(
         x402Payment,
         x402Config,
@@ -4863,7 +4865,7 @@ async function verifyIncomingPaymentInScope(body, opts, snapshot) {
           snapshot
         });
       }
-      const { verifyX402Payment } = await import("./x402-BN26TQZ6.js");
+      const { verifyX402Payment } = await import("./x402-T7WVKDD4.js");
       const receipt = await withPaymentStage("verifier_broadcast", () => verifyX402Payment(
         body.content.x402_payment,
         opts.x402Config,
@@ -5294,7 +5296,7 @@ async function processIncomingPaymentInScope(job, body, opts) {
     try {
       const requiredMsats = job.pendingPaymentMsats ?? 0;
       const requiredUsdcMicro = job.pendingX402AmountUsdcMicro !== void 0 ? BigInt(job.pendingX402AmountUsdcMicro) : BigInt(msatsToUsdc(requiredMsats, rate));
-      const { verifyX402Payment } = await import("./x402-BN26TQZ6.js");
+      const { verifyX402Payment } = await import("./x402-T7WVKDD4.js");
       const receipt = await withPaymentStage("verifier_broadcast", () => verifyX402Payment(
         body.content.x402_payment,
         opts.x402Config,
@@ -11769,7 +11771,8 @@ var HostingControl = class {
       pendingAdmissionCount: Number(pending.rows[0].pending),
       pendingAdmissions: inFlight.rows.map((row) => ({ admissionId: row.id, workId: row.job_id })),
       unresolvedAdmissionCount: Number(pending.rows[0].unresolved),
-      unresolvedAdmissions: unresolved.rows.map((row) => ({ admissionId: row.id, jobId: row.job_id }))
+      unresolvedAdmissions: unresolved.rows.map((row) => ({ admissionId: row.id, jobId: row.job_id })),
+      jobIdentityHeader: "v1"
     };
   }
 };
@@ -19534,7 +19537,7 @@ async function createDVMServer(descriptor, opts) {
       }
     }
     if (!opts.onJobCompleted && platformToken && platformUrl && dvmId && opts.db) {
-      const { RevenueReporter } = await import("./revenue-reporter-E56J3NZK.js");
+      const { RevenueReporter } = await import("./revenue-reporter-NRS2FANA.js");
       const reporter = new RevenueReporter(
         opts.db,
         platformUrl,
@@ -19544,7 +19547,7 @@ async function createDVMServer(descriptor, opts) {
       revenueReporter = reporter;
       await reporter.init();
       reporter.startRetryLoop();
-      const { MemoryX402BatchStore, PayoutReporter } = await import("./payout-reporter-3UVWPGMO.js");
+      const { MemoryX402BatchStore, PayoutReporter } = await import("./payout-reporter-W3CCLYCN.js");
       payoutReporter = new PayoutReporter({
         dvmId,
         db: opts.db,
@@ -22495,7 +22498,7 @@ function buildSubmitResponse(c, job, jobToken, contentFields) {
   else if (job.status === "completed") res.status = "completed";
   Object.assign(res, terminalResponseFields(job), contentFields);
   removeUnavailableContent(res);
-  return c.json(res, job.status === "completed" ? 200 : 202);
+  return c.json(res, job.status === "completed" ? 200 : 202, jobIdentityHeaders(job.id));
 }
 function requestRecoveryStore(store) {
   return store.findJobByRequestId && store.claimRequestId && store.resumeRequestId && store.releaseRequestIdClaim ? store : void 0;
@@ -22561,7 +22564,10 @@ function buildRequestResultResponse(c, requestId, job, contentFields) {
   if (job.paymentTransactionHash) res.transaction_hash = job.paymentTransactionHash;
   Object.assign(res, terminalResponseFields(job), contentFields);
   removeUnavailableContent(res);
-  return c.json(res, isTerminal(job.status) ? 200 : 202);
+  return c.json(res, isTerminal(job.status) ? 200 : 202, jobIdentityHeaders(job.id));
+}
+function jobIdentityHeaders(jobId) {
+  return isJobIdentityValue(jobId) ? { [JOB_IDENTITY_HEADER]: jobId } : {};
 }
 function requestResultNotFound(c, requestId) {
   return c.json(

package/dist/{chunk-GDCIHJAR.js → chunk-HU6ZMQDN.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-YG7G4DPZ.js";
 import {
   withPostgresTransactionRecovery
-} from "./chunk-6RYCZLCK.js";
+} from "./chunk-QM2OS3NJ.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";

package/dist/{chunk-WP7UX6RF.js → chunk-IOKEKMIU.js}

@@ -1,12 +1,12 @@
 import {
   applyRetryToPool
-} from "./chunk-6RYCZLCK.js";
+} from "./chunk-QM2OS3NJ.js";
 import {
   x402NetworkByCaip2
 } from "./chunk-BPYMEMQX.js";
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";

package/dist/{chunk-6RYCZLCK.js → chunk-QM2OS3NJ.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/lib/pg-retry.ts
 import { AsyncLocalStorage } from "async_hooks";

package/dist/{chunk-KYCLHWKO.js → chunk-QN3CQOE2.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/sdk/server/mpp-setup.ts
 import { createHash, randomUUID } from "crypto";

package/dist/{chunk-SX4WCPW7.js → chunk-RGSWVNQG.js}

@@ -8,7 +8,7 @@ import {
   extendDiagnosticIdentityAuthority,
   projectDiagnosticFields,
   projectSpanRow
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/sdk/logger.ts
 function createConsoleLogger(_jobId) {

package/dist/{chunk-HG2CZPRJ.js → chunk-RJFBBEWQ.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";

package/dist/{chunk-BIZR5ORK.js → chunk-WGK5KZ6S.js}

@@ -2,7 +2,7 @@ import {
   createX402FacilitatorAuthHeaders,
   settleWithFacilitator,
   verifyWithFacilitator
-} from "./chunk-XEOTTFLH.js";
+} from "./chunk-FYETJDBB.js";
 import {
   buildPaymentRequirements,
   decodePayment,
@@ -15,7 +15,7 @@ import {
 } from "./chunk-KXWROQGK.js";
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/lib/x402/verify.ts
 async function verifyX402Payment(paymentHeader, config, requiredUsdcMicro, resource, btcUsdRate, exactVersions = { v1: true, v2: true }) {

package/dist/{chunk-FOJKZ4E7.js → chunk-YE53E4BT.js}

@@ -15,7 +15,7 @@ import {
   lotOwedSats,
   netOwedSats,
   x402SettlementPending
-} from "./chunk-WP7UX6RF.js";
+} from "./chunk-IOKEKMIU.js";
 
 // src/sdk/server/memory-credit-ledger.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-3VFEX2Y3.js → chunk-YNHXOONR.js}

@@ -1,6 +1,6 @@
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";

package/dist/{chunk-X5RY2G3C.js → chunk-YS6PWVCZ.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-UKD3R2KU.js";
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 
 // src/sdk/server/zod-error.ts
 function humanizeZodError(err, opts) {

package/dist/{chunk-BQP3LU2O.js → chunk-ZLWPEIE2.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-YG7G4DPZ.js";
 import {
   diagnosticConsole
-} from "./chunk-FXDQMJQ2.js";
+} from "./chunk-5PLQOC4B.js";
 import {
   withSdkInitLock
 } from "./chunk-COYKJRMM.js";

package/dist/{credit-ledger-SW4BGMNH.js → credit-ledger-F2LWQU6N.js}

@@ -10,10 +10,10 @@ import {
   isDrainMethod,
   isFundingRail,
   x402SettlementPending
-} from "./chunk-WP7UX6RF.js";
-import "./chunk-6RYCZLCK.js";
+} from "./chunk-IOKEKMIU.js";
+import "./chunk-QM2OS3NJ.js";
 import "./chunk-BPYMEMQX.js";
-import "./chunk-FXDQMJQ2.js";
+import "./chunk-5PLQOC4B.js";
 import "./chunk-COYKJRMM.js";
 export {
   CreditLedger,

package/dist/{credit-menu-Bm8opjYy.d.ts → credit-menu-CUJdCfpt.d.ts}

@@ -417,6 +417,8 @@ interface HostingControlStatus {
         admissionId: string;
         jobId: string;
     }[];
+    /** Version of the job-identity response-head field this deployment emits. */
+    jobIdentityHeader: "v1";
 }
 
 interface PromptResolver {