@dvmkit/sdk 0.1.5-rc.9 → 0.2.0-rc.9

package/dist/{tempo-charge-store-RIFTALZK.js → tempo-charge-store-76TDAF34.js}

@@ -1,6 +1,6 @@
 import {
   PostgresTempoChargeStore
-} from "./chunk-JZWELPFH.js";
+} from "./chunk-MRAGS5VP.js";
 import "./chunk-YG7G4DPZ.js";
 import "./chunk-S3XAHZQY.js";
 export {

package/dist/{tempo-lifecycle-DFIXQ54Q.js → tempo-lifecycle-DXM7QXJQ.js}

@@ -1,9 +1,9 @@
 import {
   assertTempoWalletIdle
-} from "./chunk-TQWGQCNV.js";
-import "./chunk-2UUXIIOC.js";
+} from "./chunk-OMIQMMME.js";
+import "./chunk-O2X2CCKH.js";
 import "./chunk-KSQEFVFJ.js";
-import "./chunk-CGKZDODG.js";
+import "./chunk-MG67KXU7.js";
 import "./chunk-5URG56JJ.js";
 import "./chunk-MKI6OVW4.js";
 import "./chunk-FUJ36YDV.js";

package/dist/{tempo-wallet-4QKSV65O.js → tempo-wallet-O67H5M4N.js}

@@ -15,8 +15,8 @@ import {
   tempoTokenReference,
   tempoWrongAssetHint,
   tryResolveTempoAsset
-} from "./chunk-2UUXIIOC.js";
-import "./chunk-CGKZDODG.js";
+} from "./chunk-O2X2CCKH.js";
+import "./chunk-MG67KXU7.js";
 import "./chunk-MKI6OVW4.js";
 import "./chunk-FUJ36YDV.js";
 export {

package/dist/testing/index.d.ts

@@ -1,5 +1,5 @@
-import { Y as JobReceipt, a1 as Message, a2 as MessageType, K as KVStore, L as Logger, u as ResponseContent, P as PaymentContent, S as SDKJobContext } from '../step-cache-5dljDqrQ.js';
-import { c as StreamableJobStore, R as ReceiptIssuingStore, J as JobRecord, d as RequestIdClaim, e as RequestIdClaimResult, f as JobRetentionCursor, O as OutgoingMessage, A as AppendOutgoingOptions, P as PaymentCreditDelta, V as VerifyAndCreditResult, g as JobCounters } from '../job-store-BUGqvCfL.js';
+import { Y as JobReceipt, a1 as Message, a2 as MessageType, K as KVStore, L as Logger, u as ResponseContent, P as PaymentContent, S as SDKJobContext } from '../step-cache-CXg7ziML.js';
+import { c as StreamableJobStore, R as ReceiptIssuingStore, J as JobRecord, d as RequestIdClaim, e as RequestIdClaimResult, f as JobRetentionCursor, O as OutgoingMessage, A as AppendOutgoingOptions, P as PaymentCreditDelta, V as VerifyAndCreditResult, g as JobCounters } from '../job-store-B2uZvga4.js';
 import 'hono';
 import 'mppx';
 import '@x402/core/server';
@@ -11,8 +11,8 @@ import 'zod';
 import '@cashu/cashu-ts';
 
 /**
- * In-memory JobStore implementing the transactional + streaming surface
- * (internal-review). Used by unit tests; not production-safe — there's no real
+ * In-memory JobStore implementing the transactional + streaming surface;
+ * used by unit tests and not production-safe — there's no real
  * concurrency control beyond JS's single-threaded execution.
  */
 declare class MemoryJobStore implements StreamableJobStore, ReceiptIssuingStore {
@@ -23,9 +23,7 @@ declare class MemoryJobStore implements StreamableJobStore, ReceiptIssuingStore
     private notifySubscribers;
     private reactivationLocks;
     private requestIdClaims;
-    /** Per-DVM monotonic receipt counter (internal-review) — the `receipt_counter` row. */
     private receiptCounter;
-    /** Receipt sequence already allocated to a job, keyed by job id. */
     private receiptSeqs;
     get(id: string): Promise<JobRecord | undefined>;
     findJobByPaymentTxHash(txHash: string): Promise<JobRecord | undefined>;
@@ -85,12 +83,9 @@ declare class MemoryJobStore implements StreamableJobStore, ReceiptIssuingStore
 
 /** Recorded outbound message. */
 interface RecordedMessage {
-    /** Message type (e.g. "text", "artifact", "prompt", "complete"). */
     type: MessageType;
-    /** Message content payload. */
     content: Record<string, unknown>;
 }
-/** Options for creating a test context. */
 interface TestContextOpts<State = Record<string, unknown>, Input = string> {
     /** Override the job ID. Default: "test-job-1". */
     jobId?: string;
@@ -98,7 +93,6 @@ interface TestContextOpts<State = Record<string, unknown>, Input = string> {
     tags?: string[];
     /** Job input — string for unstructured, or the parsed type for schema-based DVMs. */
     input?: Input;
-    /** Job parameters as key-value pairs. */
     params?: Record<string, string>;
     /** Opaque requester identifier. */
     requesterId?: string;
@@ -121,15 +115,11 @@ interface TestContextOpts<State = Record<string, unknown>, Input = string> {
 interface TestJobContext<State = Record<string, unknown>, Input = string> extends SDKJobContext<State, Input> {
     /** All outbound messages sent during the handler. */
     readonly messages: RecordedMessage[];
-    /** Whether complete() was called. */
     readonly completed: boolean;
-    /** Whether fail() was called. */
     readonly failed: boolean;
     /** Whether fail() was called with `{ refund: true }`. */
     readonly refundRequested: boolean;
-    /** The summary string passed to complete(). */
     readonly summary: string | undefined;
-    /** The error string passed to fail(). */
     readonly failError: string | undefined;
     /**
      * What the handler declared through `ctx.cost()`, summed, in 1e-6 of
@@ -142,7 +132,7 @@ interface TestJobContext<State = Record<string, unknown>, Input = string> extend
         currency: string;
     } | undefined;
     /**
-     * Cancel the job under test (internal-review) — aborts `ctx.signal` exactly as a
+     * Cancel the job under test — aborts `ctx.signal` exactly as a
      * caller cancel, idle timeout, or stale-sweep would in the real runtime, and
      * puts the context into the same post-terminal shape: every emitter
      * (`text` / `artifact` / `sendMessage` / `working` / `progress` /

package/dist/testing/index.js

@@ -1,19 +1,19 @@
 import {
   MemoryKVStore
-} from "../chunk-RW5LP57K.js";
+} from "../chunk-SDK6KDJN.js";
 import {
   JobCancelledError,
   MemoryJobStore,
   createInstrumentedFetch
-} from "../chunk-U6M3ATSG.js";
+} from "../chunk-JDT5LCJC.js";
 import {
   createNoopLogger
-} from "../chunk-E4EVGPDX.js";
+} from "../chunk-XQXJKJ3P.js";
 import "../chunk-66HGCPBU.js";
 import "../chunk-FUJ36YDV.js";
 import {
   validateCurrency
-} from "../chunk-27V2ILSR.js";
+} from "../chunk-4A2RAKCW.js";
 import "../chunk-AT6V3SY7.js";
 
 // src/sdk/testing/test-context.ts
@@ -36,14 +36,12 @@ function createTestContext(opts) {
   const log = opts?.log ?? createNoopLogger();
   const input = opts?.input ?? "";
   const ctx = {
-    // --- Identity ---
     jobId: opts?.jobId ?? "test-job-1",
     tags: opts?.tags ?? [],
     input,
     params: opts?.params ?? {},
     requesterId: opts?.requesterId ?? "test-requester",
     paidMsats: opts?.paidMsats ?? 0,
-    // --- Test inspection ---
     get messages() {
       return messages;
     },
@@ -66,7 +64,6 @@ function createTestContext(opts) {
       if (costPoisoned || costCurrency === void 0) return void 0;
       return { amountMicro: costMicro, currency: costCurrency };
     },
-    // --- Messaging ---
     text(message) {
       if (cancelled) return;
       messages.push({ type: "text", content: { text: message } });
@@ -82,7 +79,6 @@ function createTestContext(opts) {
       if (cancelled) return;
       messages.push({ type, content });
     },
-    // --- Flow control ---
     prompt(id, text, promptOpts) {
       if (cancelled) return Promise.reject(new JobCancelledError());
       messages.push({
@@ -148,7 +144,6 @@ function createTestContext(opts) {
       cancelled = true;
       abort.abort(new JobCancelledError(reason));
     },
-    // --- Accounting ---
     cost(declared) {
       if (cancelled) return;
       const currency = validateCurrency(declared.currency);
@@ -165,11 +160,9 @@ function createTestContext(opts) {
       costAmount = total;
       costMicro = micro;
     },
-    // --- Durable execution ---
     async step(_id, fn) {
       return fn();
     },
-    // --- Platform services ---
     state,
     store,
     fetch: createInstrumentedFetch(abort.signal),

package/dist/{usd-DoRuAckA.d.ts → usd-BNDg1715.d.ts}

@@ -1,10 +1,10 @@
-import { C as Currency } from './step-cache-5dljDqrQ.js';
+import { C as Currency } from './step-cache-CXg7ziML.js';
 
 /**
  * Thrown by `fiatToSatsCeil` / `satsToFiat` when the supplied `ratePerBtc` is
  * non-finite or non-positive. Surfaces a misconfigured fx fetcher loudly
  * instead of silently producing a 0-sats charge or a 0-fiat display string —
- * a silent 0 lost real money in internal-review slice-04. Callers obtain a valid rate
+ * callers obtain a valid rate
  * from the SDK's fx fetcher (which raises `FxRateUnavailableError` on
  * upstream failure); this error is the defence-in-depth backstop for any
  * caller that constructs a rate by other means.
@@ -16,8 +16,8 @@ declare class InvalidFxRateError extends Error {
 }
 /**
  * Convert a fiat amount to integer sats at the supplied fiat-per-BTC rate.
- * Rounds **up** so the operator never overcharges the caller (caller-friendly
- * rounding). Negative or non-finite amounts collapse to 0 (a $0 charge is
+ * Rounds up to cover the fiat amount. Negative or non-finite amounts
+ * collapse to 0 (a $0 charge is
  * well-defined). A non-finite or non-positive `ratePerBtc` raises
  * `InvalidFxRateError` — a silent 0 would mask a misconfigured fetcher into
  * shipping a free charge. The math is currency-agnostic — `ratePerBtc` is the
@@ -33,7 +33,7 @@ declare function fiatToSatsCeil(amount: number, ratePerBtc: number): number;
  */
 declare function satsToFiat(sats: number, ratePerBtc: number): number;
 /**
- * Thrown when a builder-declared USD price literal is malformed (internal-review).
+ * Thrown when a builder-declared USD price literal is malformed.
  * Carries the offending value and the config field it came from so
  * `configureDVM`'s boot check can surface both without re-deriving them.
  */
@@ -52,13 +52,13 @@ declare class InvalidUsdPriceError extends Error {
  * Strict by construction on both format and precision:
  *
  * - The grammar is `$` followed by a decimal number, so `"$1abc"` (which every
- *   ad-hoc `parseFloat(v.slice(1))` used to accept as 1) is rejected.
+ * ad-hoc `parseFloat(v.slice(1))` used to accept as 1) is rejected.
  * - The amount must be expressible at {@link roundUsd}'s four decimal places,
- *   which is the precision **every** advertisement surface carries — `/v1/info`
- *   pricing ceilings, `/v1/quote` upfronts, the isolate tier's re-emit. A price
- *   finer than that advertises as a different number than it charges, and one
- *   below `$0.0001` advertises as `$0` while still gating the job: advertised
- *   paid, apparently free, which is the shape internal-review exists to close.
+ * which is the precision **every** advertisement surface carries — `/v1/info`
+ * pricing ceilings, `/v1/quote` upfronts, the isolate tier's re-emit. A price
+ * finer than that advertises as a different number than it charges, and one
+ * below `$0.0001` advertises as `$0` while still gating the job: advertised
+ * paid, apparently free, which is the mismatch this parser exists to close.
  *
  * The floor is deliberately 100× coarser than the credit ledger's micro-unit.
  * The ledger could denominate `$0.000001`; no surface a caller reads can
@@ -66,12 +66,10 @@ declare class InvalidUsdPriceError extends Error {
  */
 declare function parseUsdPrice(value: string, field: string): number;
 /**
- * Round a USD value to 4 decimal places (matches scribe's stored display
- * precision). This is the **storage / accounting** precision — preserves
+ * Round a USD value to 4 decimal places. This is the **storage / accounting**
+ * precision — preserves
  * sub-cent amounts so a `$0.0150` per-minute rate doesn't collapse to
- * `$0.02` before it ever reaches a multiplier. See {@link formatUsd} for the
- * human-render precision, which deliberately truncates at the cent boundary
- * for amounts ≥ $0.01.
+ * `$0.02` before it ever reaches a multiplier.
  */
 declare function roundUsd(usd: number): number;
 /**

package/dist/{wallet-CJC8lwxx.d.ts → wallet-Dwjs5n_M.d.ts}

@@ -5,7 +5,7 @@ import { Wallet } from '@cashu/cashu-ts';
  * session.
  *
  * When the agent has a mnemonic on disk at `~/.dvm/wallet.mnemonic` AND
- * the wallet's `mnemonic_fingerprint` matches it (internal-review), NUT-13
+ * the wallet's `mnemonic_fingerprint` matches it, NUT-13
  * deterministic secrets are eligible: the constructor receives `bip39seed`
  * derived via `mnemonicToSeedSync` and a {@link PersistentCounterSource}
  * backed by `wallet.nut13_counters`.

package/dist/{x402-5H27DCBE.js → x402-7S2EFINY.js}

@@ -10,9 +10,9 @@ import {
   saveX402Wallet,
   tryX402Payment,
   x402WrongAssetHint
-} from "./chunk-BIP6G74V.js";
+} from "./chunk-2ATUAUAO.js";
 import "./chunk-KSQEFVFJ.js";
-import "./chunk-CGKZDODG.js";
+import "./chunk-MG67KXU7.js";
 import {
   verifyX402Payment
 } from "./chunk-BIFLRKMO.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dvmkit/sdk",
-  "version": "0.1.5-rc.9",
+  "version": "0.2.0-rc.9",
   "description": "SDK for building accountless, pay-per-use Digital Vending Machines",
   "license": "Apache-2.0",
   "repository": {
@@ -94,6 +94,7 @@
     "esbuild": "0.27.7",
     "eslint": "10.9.1",
     "globals": "17.11.0",
+    "sdk-receipt-compat": "npm:@dvmkit/sdk@0.1.5-rc.9",
     "tsup": "8.5.1",
     "tsx": "4.21.0",
     "typescript": "5.9.3",