@dvmkit/sdk 0.7.0-rc.1 → 0.7.0-rc.10

package/dist/{chunk-ETXDTUJO.js → chunk-ZCNPIILZ.js}

@@ -337,6 +337,9 @@ var diagnostic_catalogue_v1_default = {
     "revenue_skipped_unsettled_draw",
     "rollback",
     "router.proxy",
+    "sanctions_ip_data_incomplete",
+    "sanctions_ip_data_load_failed",
+    "sanctions_ip_data_stale",
     "scrape_cache_touch_failed",
     "scrape_cache_write_failed",
     "scrape_card_segmentation_failed",
@@ -409,6 +412,7 @@ var diagnostic_catalogue_v1_default = {
     "tempo_observer_health_unavailable",
     "tempo_observer_scan_failed",
     "tempo_refund_amount_unreported",
+    "tempo_replay_mark_failed",
     "tempo_routine_sweep",
     "tempo_routine_sweep_failed",
     "tempo_session_advertised_refresh_failed",
@@ -416,6 +420,7 @@ var diagnostic_catalogue_v1_default = {
     "tempo_session_close_failed",
     "tempo_session_close_failure_reconcile_failed",
     "tempo_session_close_recovery_failed",
+    "tempo_session_close_recovery_unmatched",
     "tempo_session_open_refused",
     "tempo_session_settled",
     "tempo_session_withheld",
@@ -776,6 +781,7 @@ var diagnostic_catalogue_v1_default = {
     "hardened",
     "head_status",
     "hint",
+    "hosting_identity_revoke_failed",
     "ingest_concurrency",
     "ingest_global_concurrency",
     "ingest_ip_concurrency",
@@ -825,6 +831,7 @@ var diagnostic_catalogue_v1_default = {
     "quota_exceeded",
     "rate_limited",
     "rate_limited_by_target",
+    "region_unavailable",
     "replay_detected",
     "request_integrity_failed",
     "retry_hardened",
@@ -977,6 +984,7 @@ var diagnostic_catalogue_v1_default = {
   ],
   tokenFields: [],
   hashFields: [
+    "job_id_hash",
     "key_hash",
     "prefix_hash"
   ],
@@ -998,11 +1006,108 @@ var diagnostic_catalogue_v1_default = {
   ],
   clientVersionFields: [
     "client.version"
+  ],
+  paymentSkipReasons: [
+    "credit_or_draw_missing",
+    "draw_not_pending",
+    "draw_job_mismatch",
+    "rail_mismatch",
+    "channel_binding_mismatch",
+    "denomination_unavailable",
+    "topup_cap_unavailable",
+    "topup_cap_currency_mismatch",
+    "unknown"
+  ],
+  denominationCauses: [
+    "no_msats",
+    "sub_micro",
+    "unsupported_currency",
+    "rate_unavailable",
+    "rate_stale_refused",
+    "unknown"
+  ],
+  fxSourceFailures: [
+    "network_error",
+    "http_error",
+    "invalid_body",
+    "no_usable_rate",
+    "missing_currency",
+    "unknown"
+  ],
+  paymentFailureCategories: [
+    "invalid_challenge",
+    "malformed_credential",
+    "payment_expired",
+    "verification_failed",
+    "insufficient_funds",
+    "invalid_signature",
+    "unsupported_method",
+    "replay_detected",
+    "ledger_refused",
+    "settlement_failed",
+    "unsupported_version",
+    "unknown"
+  ],
+  paymentFailureStages: [
+    "verifier",
+    "broadcast",
+    "verifier_broadcast",
+    "replay_store",
+    "funding_ledger",
+    "unknown"
+  ],
+  paymentPhases: [
+    "upfront",
+    "mid-job"
+  ],
+  sanctionsRegions: [
+    "BY",
+    "CU",
+    "IR",
+    "KP",
+    "RU",
+    "UA-09",
+    "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"
   ]
 };
 
 // src/observability/projection.ts
 var DIAGNOSTIC_CATALOGUE_VERSION = diagnostic_catalogue_v1_default.version;
+var PAYMENT_ENUMS = {
+  reason: new Set(diagnostic_catalogue_v1_default.paymentSkipReasons),
+  cause: new Set(diagnostic_catalogue_v1_default.denominationCauses),
+  source_failure: new Set(diagnostic_catalogue_v1_default.fxSourceFailures),
+  failure_category: new Set(diagnostic_catalogue_v1_default.paymentFailureCategories),
+  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
@@ -1027,6 +1132,7 @@ var CLIENT_PROTOCOL_VERSIONS = new Set(
   diagnostic_catalogue_v1_default.clientProtocolVersions
 );
 var CLIENT_VERSION_FIELDS = new Set(diagnostic_catalogue_v1_default.clientVersionFields);
+var SANCTIONS_REGIONS = new Set(diagnostic_catalogue_v1_default.sanctionsRegions);
 var SPAN_ID_RE = /^(?!0{16}$)[0-9a-f]{16}$/;
 var TRACE_ID_RE = /^(?!0{32}$)[0-9a-f]{32}$/;
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -1202,6 +1308,9 @@ function projectFields(input, dataset, authority, identityAuthority) {
   return output;
 }
 function projectField(key, value, dataset, authority, identityAuthority) {
+  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))
@@ -1218,7 +1327,7 @@ function projectField(key, value, dataset, authority, identityAuthority) {
   if (key === "route") return projectQualifiedRoute(value);
   if (key === "http.route" || key === "resource_path")
     return projectRouteTemplate(value);
-  if (key === "status_code" || key === "http.status_code") {
+  if (key === "status_code" || key === "http.status_code" || key === "source_status") {
     return Number.isInteger(value) && value >= 100 && value <= 599 ? value : void 0;
   }
   if (key === "method" || key === "http.method") {
@@ -1252,6 +1361,8 @@ function projectField(key, value, dataset, authority, identityAuthority) {
     return typeof value === "string" && STRIPE_EVENT_RE.test(value) ? value : void 0;
   if (key === "reject_reason")
     return value === "scanner_probe" ? value : void 0;
+  if (key === "sanctions_region")
+    return typeof value === "string" && SANCTIONS_REGIONS.has(value) ? value : void 0;
   return void 0;
 }
 function projectService(value) {

package/dist/{content-retention-DHyLdA6b.d.ts → content-retention-D2K4MKNO.d.ts}

@@ -1,4 +1,4 @@
-import { b as JobStore, J as JobRecord } from './job-store-DdLXBpol.js';
+import { b as JobStore, J as JobRecord } from './job-store-DCvJQUX0.js';
 
 /** Authenticated caller metadata; omitted fields on older services mean unknown. */
 interface JobContentMetadata {

package/dist/{credit-ledger-MCUXYKSJ.js → credit-ledger-MFIIOSZH.js}

@@ -10,11 +10,11 @@ import {
   isDrainMethod,
   isFundingRail,
   x402SettlementPending
-} from "./chunk-6XF3RVVX.js";
-import "./chunk-COYKJRMM.js";
-import "./chunk-P6QON7ER.js";
+} from "./chunk-IRXIH775.js";
+import "./chunk-NV7Z7377.js";
 import "./chunk-BPYMEMQX.js";
-import "./chunk-ETXDTUJO.js";
+import "./chunk-ZCNPIILZ.js";
+import "./chunk-COYKJRMM.js";
 export {
   CreditLedger,
   CreditLedgerError,

package/dist/{credit-menu-DjnkeEUU.d.ts → credit-menu-D2t1-Tf6.d.ts}

@@ -1,11 +1,11 @@
-import { g as LockPubkey, f as CheckMintHealthOptions, b as LightningBackend, A as AttestationPayload } from './lightning-backend-Bw-qtAbt.js';
-import { cf as HostingCleanupFence, cV as HostedIntent, aj as FundingMethod, o as PaymentMethod, bN as CreditLedgerLike, a3 as Message, _ as FundingReceipt, bP as CreditSnapshot, $ as JobReceipt, S as SDKJobContext, aw as StepCache, u as ResponseContent, P as PaymentContent, a4 as MessageType, bj as X402Receipt, aE as X402Config, bi as X402ExactVersionSupport, cW as X402SettlementIntent, aa as PaymentRequirementsV2, cX as HostedFundingReservation, c2 as CreditLedgerQuerier, cY as X402SettlementCursor, bR as X402SettlementStatus, cZ as X402SettlementWriteOff, bO as X402RefundSettlementGate, c_ as X402FacilitatorAuth, c$ as X402BatchSettlementConfig, cB as PostgresX402ChannelStorage, d0 as X402PayoutObserver, bL as HostedSettlementReportObligations, br as MppxServer, ae as CashuMode, d1 as CreditDepositEnqueue, d2 as X402SettlementReconciliationReason, aq as PaymentRequirements, a2 as MppxCredential, bm as CreditDepositPayload, bQ as DrawResult, cp as CreditLedgerError, a7 as ReceiptCredit, ag as DrainReceiptEvent, a6 as DrainReceipt, K as KVStore, y as SignedRequestAudience, d3 as CreditDrawReleaseEnqueue, cz as JobCostReportPayload, cA as JobTerminalReportPayload, cD as RevenueSkippedNoRailPayload, Z as ZodLike, a as DVMDescriptor, bW as CreditInvoiceRecord, bX as InvoiceSettlement, cj as ClientCompatibilityGate, ch as ClientCompatibility, bv as PostgresTempoSessionStore, bu as PayoutReporter, R as ResolvedCreditConfig, g as CreditView } from './step-cache-2MkvenJn.js';
+import { f as LockPubkey, e as CheckMintHealthOptions, b as LightningBackend, A as AttestationPayload } from './lightning-backend-CY5ML3km.js';
+import { cg as HostingCleanupFence, cW as HostedIntent, aj as FundingMethod, p as PaymentMethod, bO as CreditLedgerLike, a5 as Message, $ as FundingReceipt, bQ as CreditSnapshot, a0 as JobReceipt, S as SDKJobContext, ax as StepCache, v as ResponseContent, P as PaymentContent, a1 as MessageType, bk as X402Receipt, aF as X402Config, bj as X402ExactVersionSupport, cX as X402SettlementIntent, ab as PaymentRequirementsV2, cY as HostedFundingReservation, c3 as CreditLedgerQuerier, cZ as X402SettlementCursor, bS as X402SettlementStatus, c_ as X402SettlementWriteOff, bP as X402RefundSettlementGate, c$ as X402FacilitatorAuth, d0 as X402BatchSettlementConfig, cC as PostgresX402ChannelStorage, d1 as X402PayoutObserver, bM as HostedSettlementReportObligations, bn as CreditDepositPayload, bs as MppxServer, ae as CashuMode, d2 as CreditDepositEnqueue, d3 as X402SettlementReconciliationReason, aq as PaymentRequirements, a3 as MppxCredential, bR as DrawResult, cq as CreditLedgerError, a7 as ReceiptCredit, ag as DrainReceiptEvent, a8 as DrainReceipt, K as KVStore, z as SignedRequestAudience, d4 as CreditDrawReleaseEnqueue, cA as JobCostReportPayload, cB as JobTerminalReportPayload, cE as RevenueSkippedNoRailPayload, Z as ZodLike, a as DVMDescriptor, bX as CreditInvoiceRecord, bY as InvoiceSettlement, ck as ClientCompatibilityGate, ci as ClientCompatibility, bw as PostgresTempoSessionStore, bv as PayoutReporter, R as ResolvedCreditConfig, h as CreditView } from './step-cache-BOWAn_BH.js';
 import { ProofLike, SerializedDLEQ, Proof } from '@cashu/cashu-ts';
 import { Hono, Context } from 'hono';
 import { Pool } from 'pg';
-import { b as FxRateSnapshot, F as FxFetcher } from './fx-zMWFzfrU.js';
+import { d as FxSourceFailure, b as FxRateSnapshot, F as FxFetcher } from './fx-Ql4nvdbh.js';
 import { Store, Challenge } from 'mppx';
-import { T as TopUpCapUnenforcedReason, A as AppendOutgoingOptions, J as JobRecord, b as JobStore } from './job-store-DdLXBpol.js';
+import { T as TopUpCapUnenforcedReason, A as AppendOutgoingOptions, J as JobRecord, b as JobStore } from './job-store-DCvJQUX0.js';
 import { SettleResponse, SupportedResponse } from '@x402/core/types';
 import { Channel, AutoSettlementConfig } from '@x402/evm/batch-settlement/server';
 import { FacilitatorClient } from '@x402/core/server';
@@ -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 {
@@ -882,6 +884,7 @@ type ResolvedFx = {
     ok: false;
     reason: FiatDenominationFailure;
     detail?: string;
+    sourceFailure?: FxSourceFailure;
 };
 /**
  * The result of denominating an msat amount. See {@link msatsToFiatMicro}.
@@ -903,6 +906,7 @@ type FiatDenomination = {
     ok: false;
     reason: FiatDenominationFailure;
     detail?: string;
+    sourceFailure?: FxSourceFailure;
 };
 /**
  * A live fetch failure may use lastKnown(), but a known-stale refusal never
@@ -1430,9 +1434,9 @@ interface X402SettlementEvidenceReader extends X402ExactSettlementEvidenceReader
 declare const X402_BATCH_SETTLEMENT_NETWORK = "eip155:84532";
 /** Base mainnet channel network, enabled only with an in-process relay. */
 declare const X402_BATCH_SETTLEMENT_MAINNET_NETWORK = "eip155:8453";
-/** Policy floor advertised to callers and enforced at boot. */
+/** Default withdrawal grace and minimum outside Base Sepolia; seconds. */
 declare const X402_BATCH_MIN_WITHDRAW_DELAY_SECONDS = 86400;
-/** Default claim and transfer cadence; comfortably inside the 24-hour exit window. */
+/** Default claim and transfer cadence; comfortably inside the default 24-hour exit window. */
 declare const X402_BATCH_AUTO_SETTLEMENT: AutoSettlementConfig;
 /** Natural identity and incremental value carried by an accepted channel voucher. */
 interface X402BatchFunding {
@@ -1857,6 +1861,8 @@ interface CreditFundingReport {
     fundedAt: number;
     /** Current credit expiry after this funding committed (epoch ms). */
     expiryMs: number;
+    /** The funded credit's stored instrument; absent for Cashu. */
+    instrument?: CreditInstrument;
     /** TIP-1034 voucher identity, present only for session-funded credit. */
     tempoSession?: {
         channelId: string;
@@ -2502,6 +2508,7 @@ declare function repairX402ExactSettlementEffect(args: {
     enqueueCreditDeposit?: CreditDepositEnqueue;
     tx?: CreditLedgerQuerier;
 }): Promise<CommittedFunding | undefined>;
+type CreditInstrument = NonNullable<CreditDepositPayload["instrument"]>;
 
 interface ReceiptIssuerOpts {
     /** 32-byte hex receipt secret — `DVMKIT_RECEIPT_KEY`, or an ephemeral dev key. */

package/dist/{fx-zMWFzfrU.d.ts → fx-Ql4nvdbh.d.ts}

@@ -1,4 +1,4 @@
-import { C as Currency } from './step-cache-2MkvenJn.js';
+import { C as Currency } from './step-cache-BOWAn_BH.js';
 
 /**
  * Quote-time FX snapshot. `rates` maps configured lowercase currency codes to
@@ -61,6 +61,12 @@ interface PlatformFxSource {
 declare const FX_CACHE_TTL_MS = 300000;
 /** Default retry budget per `fetch()` call before raising `fx_rate_unavailable`. */
 declare const FX_RETRY_COUNT = 2;
+type FxSourceFailureCategory = "network_error" | "http_error" | "invalid_body" | "no_usable_rate" | "missing_currency" | "unknown";
+/** Observed source failure only; never provider text or an inferred root cause. */
+interface FxSourceFailure {
+    category: FxSourceFailureCategory;
+    httpStatus?: number;
+}
 interface FxRateUnavailableCopy {
     display?: string;
     hint?: string;
@@ -109,7 +115,8 @@ declare class FxRateUnavailableError extends Error {
      * the last-known rate without it. See {@link FxKnownStale}.
      */
     readonly knownStale?: FxKnownStale;
-    constructor(message?: string, copy?: FxRateUnavailableCopy, knownStale?: FxKnownStale);
+    readonly sourceFailure?: FxSourceFailure;
+    constructor(message?: string, copy?: FxRateUnavailableCopy, knownStale?: FxKnownStale, sourceFailure?: FxSourceFailure);
 }
 /**
  * Snapshot fetcher for BTC against one or more fiat currencies. Caches
@@ -196,4 +203,4 @@ declare function fxRateFor(snapshot: FxRateSnapshot, currency: Currency): number
  */
 declare function resolveFxSourceFromEnv(env: Record<string, string | undefined>): string | PlatformFxSource | undefined;
 
-export { type CreateFxFetcherOpts as C, DEFAULT_FX_CURRENCIES as D, type FxFetcher as F, type PlatformFxSource as P, DEFAULT_FX_RATE_SOURCE as a, type FxRateSnapshot as b, FxRateUnavailableError as c, createFxFetcher as d, FX_CACHE_TTL_MS as e, fxRateFor as f, FX_RETRY_COUNT as g, resolveFxSourceFromEnv as r, warmFxSnapshot as w };
+export { type CreateFxFetcherOpts as C, DEFAULT_FX_CURRENCIES as D, type FxFetcher as F, type PlatformFxSource as P, DEFAULT_FX_RATE_SOURCE as a, type FxRateSnapshot as b, FxRateUnavailableError as c, type FxSourceFailure as d, type FxSourceFailureCategory as e, createFxFetcher as f, fxRateFor as g, FX_CACHE_TTL_MS as h, FX_RETRY_COUNT as i, resolveFxSourceFromEnv as r, warmFxSnapshot as w };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as Currency, Z as ZodLike, D as DVMConfig, a as DVMDescriptor } from './step-cache-2MkvenJn.js';
-export { A as ApprovalContent, b as ArtifactContent, c as CancelContent, d as CanonicalEnvelope, e as CreateSignedRequestVerifierOpts, f as CreditConfig, g as CreditView, h as DEFAULT_CREDIT_MAX, i as DEFAULT_CREDIT_MIN, j as DEFAULT_CREDIT_TTL_SECONDS, k as DEFAULT_JOB_RETENTION_DAYS, l as DVMRouteContext, I as IncomingMessage, m as InputType, n as InvalidCurrencyError, J as JobCost, K as KVStore, L as Logger, P as PaymentContent, o as PaymentMethod, p as PriceValue, q as ProgressContent, r as PromptOpts, Q as QuoteConfig, s as QuoteContext, t as QuoteResult, R as ResolvedCreditConfig, u as ResponseContent, S as SDKJobContext, v as SDKPaymentRequestOpts, w as SIGNED_REQUEST_AUTH_ID, x as SIGNED_REQUEST_STATEMENT_VERSION, y as SignedRequestAudience, z as SignedRequestDomain, B as SignedRequestError, E as SignedRequestFailure, F as SignedRequestReplayStore, G as SignedRequestSignOpts, H as SignedRequestStatementHeader, M as SignedRequestVerifier, U as UnsupportedCurrencyError, N as createSignedRequestVerifier, O as isZodSchema, T as signedRequestStatementHeader, V as validateCurrency } from './step-cache-2MkvenJn.js';
-export { C as CreateFxFetcherOpts, D as DEFAULT_FX_CURRENCIES, a as DEFAULT_FX_RATE_SOURCE, F as FxFetcher, b as FxRateSnapshot, c as FxRateUnavailableError, P as PlatformFxSource, d as createFxFetcher, f as fxRateFor, r as resolveFxSourceFromEnv } from './fx-zMWFzfrU.js';
-export { I as InvalidFxRateError, f as fiatToSatsCeil, a as formatFiat, b as formatUsd, r as roundUsd, s as satsToFiat } from './usd-DI3d3gTK.js';
-export { J as JobRecord, a as JobStatus, b as JobStore } from './job-store-DdLXBpol.js';
+import { C as Currency, Z as ZodLike, D as DVMConfig, a as DVMDescriptor } from './step-cache-BOWAn_BH.js';
+export { A as ApprovalContent, b as ArtifactContent, c as CancelContent, d as CanonicalEnvelope, e as CapabilityRate, f as CreateSignedRequestVerifierOpts, g as CreditConfig, h as CreditView, i as DEFAULT_CREDIT_MAX, j as DEFAULT_CREDIT_MIN, k as DEFAULT_CREDIT_TTL_SECONDS, l as DEFAULT_JOB_RETENTION_DAYS, m as DVMRouteContext, I as IncomingMessage, n as InputType, o as InvalidCurrencyError, J as JobCost, K as KVStore, L as Logger, P as PaymentContent, p as PaymentMethod, q as PriceValue, r as ProgressContent, s as PromptOpts, Q as QuoteConfig, t as QuoteContext, u as QuoteResult, R as ResolvedCreditConfig, v as ResponseContent, S as SDKJobContext, w as SDKPaymentRequestOpts, x as SIGNED_REQUEST_AUTH_ID, y as SIGNED_REQUEST_STATEMENT_VERSION, z as SignedRequestAudience, B as SignedRequestDomain, E as SignedRequestError, F as SignedRequestFailure, G as SignedRequestReplayStore, H as SignedRequestSignOpts, M as SignedRequestStatementHeader, N as SignedRequestVerifier, U as UnsupportedCurrencyError, O as createSignedRequestVerifier, T as isZodSchema, V as signedRequestStatementHeader, W as validateCurrency } from './step-cache-BOWAn_BH.js';
+export { C as CreateFxFetcherOpts, D as DEFAULT_FX_CURRENCIES, a as DEFAULT_FX_RATE_SOURCE, F as FxFetcher, b as FxRateSnapshot, c as FxRateUnavailableError, d as FxSourceFailure, e as FxSourceFailureCategory, P as PlatformFxSource, f as createFxFetcher, g as fxRateFor, r as resolveFxSourceFromEnv } from './fx-Ql4nvdbh.js';
+export { I as InvalidFxRateError, f as fiatToSatsCeil, a as formatFiat, b as formatUsd, r as roundUsd, s as satsToFiat } from './usd-MAtMp3DB.js';
+export { J as JobRecord, a as JobStatus, b as JobStore } from './job-store-DCvJQUX0.js';
 export { P as PinnedFetch, S as SSRFError, a as SSRFGuardOpts, b as SSRFReason, c as SSRFResolver, d as assertSafeUrl, e as createPinnedFetch } from './ssrf-dMooihtY.js';
 export { z } from 'zod';
 import 'hono';

package/dist/index.js

@@ -5,13 +5,12 @@ import {
   envFlag
 } from "./chunk-TVI4V7GF.js";
 import {
-  configureDVM,
-  isConfiguredDVMDescriptor
-} from "./chunk-HCLVYZUZ.js";
+  CAPABILITY_NAME_RE
+} from "./chunk-A262WVYX.js";
 import {
   SignedRequestError,
   createSignedRequestVerifier
-} from "./chunk-N5RZ5HVB.js";
+} from "./chunk-X6S2CHFM.js";
 import {
   DEFAULT_CREDIT_MAX,
   DEFAULT_CREDIT_MIN,
@@ -21,29 +20,262 @@ import {
   SIGNED_REQUEST_STATEMENT_VERSION,
   isZodSchema,
   signedRequestStatementHeader
-} from "./chunk-RCM3P2HE.js";
-import "./chunk-OFVV37XC.js";
+} from "./chunk-UKD3R2KU.js";
+import {
+  buildUpfront
+} from "./chunk-6HJEVCVI.js";
 import {
   DEFAULT_FX_CURRENCIES,
   DEFAULT_FX_RATE_SOURCE,
   FxRateUnavailableError,
   InvalidCurrencyError,
+  InvalidFxRateError,
   UnsupportedCurrencyError,
-  buildUpfront,
   createFxFetcher,
-  fxRateFor,
-  resolveFxSourceFromEnv,
-  validateCurrency
-} from "./chunk-BYCEKO65.js";
-import {
-  InvalidFxRateError,
   fiatToSatsCeil,
   formatFiat,
   formatUsd,
+  fxRateFor,
+  parseUsdPrice,
+  resolveFxSourceFromEnv,
   roundUsd,
-  satsToFiat
-} from "./chunk-AT6V3SY7.js";
-import "./chunk-ETXDTUJO.js";
+  satsToFiat,
+  validateCurrency
+} from "./chunk-HPCXF3DV.js";
+import "./chunk-ZCNPIILZ.js";
+
+// src/sdk/configure.ts
+function configureDVM(config) {
+  const tags = collectTags(config);
+  const currency = resolvePricingCurrency(config.currency);
+  const capabilities = buildCapabilityMap(config, currency);
+  const jobRetentionDays = resolveJobRetentionDays(config.jobRetentionDays);
+  const onlyCapability = singleCapabilityEntry(capabilities);
+  const descriptor = {
+    name: config.name,
+    description: config.description ?? "",
+    tags,
+    currency,
+    price: onlyCapability?.price,
+    inputSchema: onlyCapability?.input,
+    state: onlyCapability?.state ?? {},
+    idleTimeout: config.idleTimeout ?? 3600,
+    processingWatchdog: config.processingWatchdog,
+    jobRetentionDays,
+    config,
+    capabilities,
+    paymentMethods: config.paymentMethods,
+    x402: config.x402,
+    mpp: config.mpp,
+    credit: resolveCreditConfig(config.credit),
+    auth: config.auth
+  };
+  CONFIGURED_DVM_DESCRIPTORS.add(descriptor);
+  return Object.freeze(descriptor);
+}
+function resolveJobRetentionDays(raw) {
+  const days = raw ?? DEFAULT_JOB_RETENTION_DAYS;
+  if (!Number.isSafeInteger(days) || days < 0 || days > Math.floor((Number.MAX_SAFE_INTEGER - Date.now()) / 864e5)) {
+    throw new Error(
+      `configureDVM: jobRetentionDays must be a non-negative whole number of days; received ${JSON.stringify(raw)}`
+    );
+  }
+  return days;
+}
+function isConfiguredDVMDescriptor(value) {
+  return typeof value === "object" && value !== null && CONFIGURED_DVM_DESCRIPTORS.has(value);
+}
+var CONFIGURED_DVM_DESCRIPTORS = /* @__PURE__ */ new WeakSet();
+function resolvePricingCurrency(raw) {
+  if (raw === void 0) return "usd";
+  try {
+    return validateCurrency(raw);
+  } catch (err) {
+    if (err instanceof InvalidCurrencyError) {
+      throw new Error(
+        `configureDVM: currency ${JSON.stringify(raw)} is not an ISO 4217 lowercase code like "usd" or "eur". Omit the field to price in USD.`,
+        { cause: err }
+      );
+    }
+    throw err;
+  }
+}
+function resolveCreditConfig(credit) {
+  if (!credit) return void 0;
+  const min = credit.min ?? DEFAULT_CREDIT_MIN;
+  const max = credit.max ?? DEFAULT_CREDIT_MAX;
+  const ttlSeconds = credit.ttl ?? DEFAULT_CREDIT_TTL_SECONDS;
+  const minAmount = validatePriceLiteral(min, "credit.min");
+  const maxAmount = validatePriceLiteral(max, "credit.max");
+  if (minAmount > maxAmount) {
+    throw new Error(
+      `credit.min (${JSON.stringify(min)}) exceeds credit.max (${JSON.stringify(max)}) \u2014 no funding amount could satisfy both.`
+    );
+  }
+  if (!Number.isFinite(ttlSeconds) || ttlSeconds <= 0) {
+    throw new Error(`credit.ttl must be a positive number of seconds (got ${ttlSeconds}).`);
+  }
+  const allowOneShotStablecoin = credit.allowOneShotStablecoin === true;
+  return { min, max, ttlSeconds, allowOneShotStablecoin };
+}
+function validatePriceLiteral(value, field, key = field) {
+  if (typeof value === "number") {
+    throw new Error(
+      `${field} is a number (${value}). Prices are USD literals \u2014 write ${key}: "$0.01" for one cent. Callers still pay in sats; the SDK converts at request time. Omit the field for a free capability, or use \`onQuote\` for dynamic pricing.`
+    );
+  }
+  if (typeof value !== "string") {
+    throw new Error(`${field} must be a USD literal like "$0.05" (got ${JSON.stringify(value)}).`);
+  }
+  return parseUsdPrice(value, field);
+}
+function validateCapabilityPrice(price, capabilityName, currency) {
+  if (price === void 0) return;
+  if (currency !== "usd") {
+    throw new Error(
+      `configureDVM: capability "${capabilityName}" declares a static price (${JSON.stringify(price)}) but this DVM prices in ${currency}. Static prices are USD literals, so they cannot express ${currency} \u2014 price this capability with \`onQuote\` returning { amount, currency: ${JSON.stringify(currency)} }, or drop the DVM-level \`currency\` to price in USD.`
+    );
+  }
+  validatePriceLiteral(price, `configureDVM: capability "${capabilityName}" price`, "price");
+}
+function collectTags(config) {
+  const tagSet = /* @__PURE__ */ new Set();
+  if (config.tag) tagSet.add(config.tag);
+  if (config.tags) {
+    for (const t of config.tags) tagSet.add(t);
+  }
+  return [...tagSet];
+}
+function buildCapabilityMap(config, currency) {
+  const hasExplicitBlock = config.capabilities !== void 0;
+  const hasFlatCapabilityName = typeof config.capability === "string";
+  const hasFlatHandler = typeof config.onJob === "function";
+  if (hasExplicitBlock && (hasFlatCapabilityName || hasFlatHandler || flatPerCapFieldsSet(config))) {
+    throw new Error(
+      "configureDVM: pass either the flat single-capability shape (capability + onJob + ...) or the explicit `capabilities` block, not both."
+    );
+  }
+  if (hasExplicitBlock) {
+    return buildExplicitCapabilities(config.capabilities ?? {}, currency);
+  }
+  if (!hasFlatHandler) {
+    throw new Error("configureDVM: onJob handler is required");
+  }
+  const name = typeof config.capability === "string" ? config.capability : slugifyCapabilityName(config.name);
+  validateCapabilityName(name);
+  validateCapabilityPrice(config.price, name, currency);
+  validateExampleAgainstInput(name, config.input, config.example);
+  const entry = {
+    name,
+    description: config.description ?? "",
+    input: config.input,
+    example: config.example,
+    state: config.state ?? {},
+    price: config.price,
+    onQuote: config.onQuote,
+    rates: snapshotRates(config.rates),
+    onJob: config.onJob,
+    onResponse: config.onResponse,
+    onPayment: config.onPayment,
+    onApproval: config.onApproval,
+    onCancel: config.onCancel,
+    onMessage: config.onMessage
+  };
+  return { [name]: entry };
+}
+function buildExplicitCapabilities(capabilities, currency) {
+  const keys = Object.keys(capabilities);
+  if (keys.length === 0) {
+    throw new Error("configureDVM: `capabilities` block must declare at least one capability");
+  }
+  const out = {};
+  for (const name of keys) {
+    validateCapabilityName(name);
+    const cap = capabilities[name];
+    if (typeof cap.onJob !== "function") {
+      throw new Error(`configureDVM: capability "${name}" is missing required onJob handler`);
+    }
+    validateCapabilityPrice(cap.price, name, currency);
+    validateExampleAgainstInput(name, cap.input, cap.example);
+    const entry = {
+      name,
+      description: cap.description ?? "",
+      // Per-capability `input` is the builder's Zod schema; the `any` widening
+      // through `Record<string, CapabilityConfig<any, any>>` is unavoidable
+      // here.
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+      input: cap.input,
+      example: cap.example,
+      state: cap.state !== void 0 ? structuredClone(cap.state) : {},
+      price: cap.price,
+      onQuote: cap.onQuote,
+      rates: snapshotRates(cap.rates),
+      onJob: cap.onJob,
+      onResponse: cap.onResponse,
+      onPayment: cap.onPayment,
+      onApproval: cap.onApproval,
+      onCancel: cap.onCancel,
+      onMessage: cap.onMessage
+    };
+    out[name] = entry;
+  }
+  return out;
+}
+function flatPerCapFieldsSet(config) {
+  return config.input !== void 0 || config.example !== void 0 || config.state !== void 0 || config.price !== void 0 || config.onQuote !== void 0 || config.rates !== void 0 || typeof config.onResponse === "function" || typeof config.onPayment === "function" || typeof config.onApproval === "function" || typeof config.onCancel === "function" || typeof config.onMessage === "function";
+}
+function validateExampleAgainstInput(capName, input, example) {
+  if (example === void 0) return;
+  if (!isZodSchema(input)) return;
+  const result = input.safeParse(example);
+  if (result.success) return;
+  throw new Error(
+    `configureDVM: capability "${capName}" example does not satisfy its input schema. Update the example to match the schema (including any \`.refine()\` checks). Issues: ${formatZodIssues(result.error)}`
+  );
+}
+function formatZodIssues(err) {
+  if (err && typeof err === "object" && "issues" in err && Array.isArray(err.issues)) {
+    const issues = err.issues;
+    if (issues.length === 0) return "(no issues reported)";
+    return issues.map((issue) => {
+      const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+      return `${path}: ${issue.message}`;
+    }).join("; ");
+  }
+  if (err && typeof err === "object" && "message" in err && typeof err.message === "string") {
+    return err.message.replace(/\s+/g, " ").trim();
+  }
+  try {
+    return JSON.stringify(err);
+  } catch {
+    return String(err);
+  }
+}
+function validateCapabilityName(name) {
+  if (!CAPABILITY_NAME_RE.test(name)) {
+    throw new Error(
+      `configureDVM: invalid capability name "${name}" \u2014 must be lowercase letters/digits/hyphens, must start with a letter or digit, must not contain slashes.`
+    );
+  }
+}
+function slugifyCapabilityName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function singleCapabilityEntry(capabilities) {
+  const keys = Object.keys(capabilities);
+  if (keys.length !== 1) return void 0;
+  return capabilities[keys[0]];
+}
+function snapshotRates(rates) {
+  if (rates === void 0) return void 0;
+  const copy = structuredClone(rates);
+  if (Array.isArray(copy)) {
+    for (const entry of copy) {
+      if (typeof entry === "object" && entry !== null) Object.freeze(entry);
+    }
+  }
+  return Object.freeze(copy);
+}
 
 // src/sdk/heartbeat.ts
 async function withProgressHeartbeat(opts, fn) {