@dvmkit/sdk 0.1.0-rc.2 → 0.1.0-rc.3

package/dist/{chunk-DCNT4PJS.js → chunk-XY5Y5REG.js}

@@ -1,28 +1,13 @@
+import {
+  DvmError
+} from "./chunk-5SO7ZVOH.js";
 import {
   callerLoggers
-} from "./chunk-KXWROQGK.js";
+} from "./chunk-66HGCPBU.js";
 
 // src/lib/x402/constants.ts
 var X402_DEFAULT_FACILITATOR = "https://x402.org/facilitator";
 
-// src/lib/errors.ts
-var DvmError = class extends Error {
-  constructor(code, message, hint, data, display, proseSources) {
-    super(message);
-    this.code = code;
-    this.hint = hint;
-    this.data = data;
-    this.display = display;
-    this.proseSources = proseSources;
-    this.name = "DvmError";
-  }
-  code;
-  hint;
-  data;
-  display;
-  proseSources;
-};
-
 // src/lib/x402/networks.ts
 var X402_NETWORKS = [
   {
@@ -459,231 +444,13 @@ function isOptionalRecord(value) {
   return value === void 0 || value === null || isRecord(value);
 }
 
-// src/lib/credit-implicit.ts
-var IMPLICIT_CREDIT_TTL_MS = 30 * 24 * 60 * 60 * 1e3;
-
-// src/lib/currency.ts
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { dirname } from "path";
-
-// src/defaults.ts
-import { homedir } from "os";
-import { join } from "path";
-var CONFIG_DIR = process.env.DVM_CONFIG_DIR ?? join(homedir(), ".dvm");
-var CONFIG_FILE = join(CONFIG_DIR, "config.json");
-var CONFIG_BACKUP_FILE = join(CONFIG_DIR, "config.json.bak");
-var CONFIG_AUDIT_FILE = join(CONFIG_DIR, "config-audit.jsonl");
-var CONFIG_PINNED_FILE = join(CONFIG_DIR, "config.json.pinned");
-var JOBS_FILE = join(CONFIG_DIR, "jobs.json");
-var REQUEST_INTENTS_DIR = join(CONFIG_DIR, "request-intents");
-var FAVORITES_FILE = join(CONFIG_DIR, "favorites.json");
-var MESSAGES_DIR = join(CONFIG_DIR, "messages");
-var RECEIPTS_FILE = join(CONFIG_DIR, "receipts.jsonl");
-var CREDITS_FILE = join(CONFIG_DIR, "credits.json");
-var X402_CHANNELS_FILE = join(CONFIG_DIR, "x402-channels.json");
-var TEMPO_CHANNELS_FILE = join(CONFIG_DIR, "tempo-channels.json");
-var FEEDBACK_NUDGES_FILE = join(CONFIG_DIR, "feedback-nudges.json");
-var RECOVERY_MNEMONIC_FILE = join(CONFIG_DIR, "recovery.mnemonic");
-var WALLET_FILE = join(CONFIG_DIR, "wallet.json");
-var AGENT_MNEMONIC_FILE = join(CONFIG_DIR, "wallet.mnemonic");
-var IDENTITIES_FILE = join(CONFIG_DIR, "identities.json");
-var PAIRINGS_DIR = join(CONFIG_DIR, "pairings");
-var BUDGET_FILE = join(CONFIG_DIR, "budget.json");
-var BTC_RATE_FILE = join(CONFIG_DIR, "btc-rate.json");
-var ADMIN_DIR = join(CONFIG_DIR, "admin");
-var PROXY_STATE_FILE = join(ADMIN_DIR, "proxy.json");
-var BUILDER_CONFIG_DIR = process.env.DVMKIT_CONFIG_DIR ?? join(homedir(), ".dvmkit");
-var BUILDER_FILE = join(BUILDER_CONFIG_DIR, "builder.json");
-var BUILDER_MNEMONIC_FILE = join(BUILDER_CONFIG_DIR, "recovery.mnemonic");
-var BUILDER_KEY_FILE = join(BUILDER_CONFIG_DIR, "builder.key");
-var MELT_PENDING_LOG_FILE = join(BUILDER_CONFIG_DIR, "melt-pending.log");
-var DRAIN_PARK_LOG_FILE = join(BUILDER_CONFIG_DIR, "drain-park.log");
-var DRAIN_HOLD_STATE_FILE = join(BUILDER_CONFIG_DIR, "drain-hold.json");
-var MELT_SUCCESS_FILE = join(BUILDER_CONFIG_DIR, "melt-success.json");
-
-// src/lib/config-dir.ts
-import { chmodSync, mkdirSync, statSync } from "fs";
-var CONFIG_DIR_MODE = 448;
-function ensureConfigDir() {
-  ensureConfigSubdir(CONFIG_DIR);
-}
-function ensureConfigSubdir(path) {
-  mkdirSync(path, { recursive: true, mode: CONFIG_DIR_MODE });
-}
-
-// src/lib/fx-coingecko.ts
-var COINGECKO_BTC_USD_URL = "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd";
-var DEFAULT_TIMEOUT_MS = 5e3;
-var DEFAULT_USER_AGENT = "dvmkit-platform/1.0 (+https://dvmkit.com)";
-async function fetchCoinGeckoBtcUsd(opts) {
-  const body = await fetchCoinGeckoBody(opts, COINGECKO_BTC_USD_URL);
-  const btc = body.bitcoin?.usd;
-  if (!isPositiveNumber(btc)) {
-    throw new Error("coingecko response missing bitcoin.usd");
-  }
-  return { btc_usd: btc, as_of: (/* @__PURE__ */ new Date()).toISOString() };
-}
-async function fetchCoinGeckoBody(opts, defaultUrl) {
-  const url = opts?.url ?? defaultUrl;
-  const fetchImpl = opts?.fetchImpl ?? fetch;
-  const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  const userAgent = opts?.userAgent ?? DEFAULT_USER_AGENT;
-  const res = await fetchImpl(url, {
-    headers: { "User-Agent": userAgent, Accept: "application/json" },
-    signal: AbortSignal.timeout(timeoutMs)
-  });
-  if (!res.ok) {
-    throw new Error(`coingecko returned HTTP ${res.status.toString()}`);
-  }
-  return await res.json();
-}
-function isPositiveNumber(v) {
-  return typeof v === "number" && Number.isFinite(v) && v > 0;
-}
-
-// src/lib/currency.ts
-function msatsToUsd(msats, rate) {
-  return msats / 1e11 * rate;
-}
-function usdToMsats(usd, rate) {
-  return Math.round(usd / rate * 1e11);
-}
-function msatsToUsdc(msats, btcUsdRate) {
-  const usd = msatsToUsd(msats, btcUsdRate);
-  return Math.ceil(usd * 1e6);
-}
-function usdcToMsats(usdc, btcUsdRate) {
-  return usdToMsats(usdc, btcUsdRate);
-}
-var COST_ANCHOR_BANDS = {
-  usd: [0.01, 0.1, 1, 10],
-  eur: [0.01, 0.1, 1, 10],
-  gbp: [0.01, 0.1, 1, 10],
-  jpy: [1, 10, 100, 1500]
-};
-function costAnchor(amount, currency = "usd") {
-  const bands = COST_ANCHOR_BANDS[currency] ?? COST_ANCHOR_BANDS.usd;
-  if (amount < bands[0]) return "fraction of a cent";
-  if (amount <= bands[1]) return "comparable to an API call";
-  if (amount <= bands[2]) return "comparable to a ChatGPT query";
-  if (amount <= bands[3]) return "comparable to a coffee";
-  return "significant purchase \u2014 review carefully";
-}
-function formatUsd(usd) {
-  if (usd === 0) return "0.00";
-  if (usd >= 0.01) return usd.toFixed(2);
-  const digits = Math.max(2, -Math.floor(Math.log10(usd)) + 1);
-  return usd.toFixed(digits);
-}
-async function fetchBtcUsdRate() {
-  if (memRate && Date.now() - memTime < CACHE_TTL) {
-    return memRate;
-  }
-  const disk = readDiskCache();
-  if (disk) {
-    memRate = disk;
-    memTime = Date.now();
-    return disk;
-  }
-  const rate = await fetchFromApi();
-  memRate = rate;
-  memTime = Date.now();
-  writeDiskCache(rate);
-  return rate;
-}
-function getLastKnownBtcRate() {
-  if (memRate && memTime > 0) return { rate: memRate, cachedAt: memTime };
-  return readDiskCacheStale();
-}
-function formatStaleness(cachedAt, now = Date.now()) {
-  const ageMs = Math.max(0, now - cachedAt);
-  const seconds = Math.floor(ageMs / 1e3);
-  if (seconds < 60) return `${seconds}s ago`;
-  const minutes = Math.floor(seconds / 60);
-  if (minutes < 60) return `${minutes} min ago`;
-  const hours = Math.floor(minutes / 60);
-  if (hours < 24) return `${hours} hour${hours === 1 ? "" : "s"} ago`;
-  const days = Math.floor(hours / 24);
-  return `${days} day${days === 1 ? "" : "s"} ago`;
-}
-var CACHE_TTL = 5 * 60 * 1e3;
-var CACHE_FILE = BTC_RATE_FILE;
-var memRate = null;
-var memTime = 0;
-function readDiskCache() {
-  try {
-    if (!existsSync(CACHE_FILE)) return null;
-    const data = JSON.parse(readFileSync(CACHE_FILE, "utf-8"));
-    if (Date.now() - data.timestamp >= CACHE_TTL) return null;
-    if (!isPlausibleBtcUsdRate(data.rate)) return null;
-    return data.rate;
-  } catch {
-    return null;
-  }
-}
-function readDiskCacheStale() {
-  try {
-    if (!existsSync(CACHE_FILE)) return null;
-    const data = JSON.parse(readFileSync(CACHE_FILE, "utf-8"));
-    if (!isPlausibleBtcUsdRate(data.rate)) return null;
-    return { rate: data.rate, cachedAt: data.timestamp };
-  } catch {
-    return null;
-  }
-}
-function writeDiskCache(rate) {
-  try {
-    ensureConfigSubdir(dirname(CACHE_FILE));
-    writeFileSync(CACHE_FILE, JSON.stringify({ rate, timestamp: Date.now() }));
-  } catch {
-  }
-}
-var MAX_PLAUSIBLE_BTC_USD = 1e7;
-function isPlausibleBtcUsdRate(rate) {
-  return typeof rate === "number" && Number.isFinite(rate) && rate > 0 && rate < MAX_PLAUSIBLE_BTC_USD;
-}
-async function fetchFromApi() {
-  const spot = await fetchCoinGeckoBtcUsd();
-  const rate = spot.btc_usd;
-  if (!isPlausibleBtcUsdRate(rate)) {
-    throw new Error(`implausible BTC/USD rate from upstream: ${String(rate)}`);
-  }
-  return rate;
-}
-
-// src/lib/payment-rails/rpc.ts
-function resolveRpcOverride(envValue, bundled) {
-  const override = envValue?.trim() ?? "";
-  return override.length > 0 ? { url: override, source: "override" } : { url: bundled, source: "bundled" };
-}
-function resolveRpcHttpTransportOptions(source, envValue) {
-  if (source !== "override" || !envValue?.trim()) return void 0;
-  let parsed;
-  try {
-    parsed = JSON.parse(envValue);
-  } catch {
-    throw new Error("RPC headers must be a JSON object of non-empty string values.");
-  }
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-    throw new Error("RPC headers must be a JSON object of non-empty string values.");
-  const headers = {};
-  for (const [name, value] of Object.entries(parsed)) {
-    if (!/^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/.test(name) || typeof value !== "string" || value.length === 0 || /[\r\n]/.test(value))
-      throw new Error("RPC headers must be a JSON object of non-empty string values.");
-    headers[name] = value;
-  }
-  if (Object.keys(headers).length === 0)
-    throw new Error("RPC headers must be a JSON object of non-empty string values.");
-  return { fetchOptions: { headers } };
-}
-
 export {
   X402_DEFAULT_FACILITATOR,
   createX402FacilitatorAuthHeaders,
   createX402FacilitatorClient,
-  DvmError,
   X402_NETWORKS,
   x402NetworkByCaip2,
+  x402NetworkBySlug,
   x402NetworkLabel,
   x402NetworkListForCopy,
   assertSupportedX402Network,
@@ -710,24 +477,5 @@ export {
   exactEvmAuthorization,
   encodeSettleResponseHeader,
   verifyWithFacilitator,
-  settleWithFacilitator,
-  IMPLICIT_CREDIT_TTL_MS,
-  CONFIG_FILE,
-  CONFIG_BACKUP_FILE,
-  CONFIG_AUDIT_FILE,
-  CONFIG_PINNED_FILE,
-  X402_CHANNELS_FILE,
-  WALLET_FILE,
-  AGENT_MNEMONIC_FILE,
-  ensureConfigDir,
-  msatsToUsd,
-  msatsToUsdc,
-  usdcToMsats,
-  costAnchor,
-  formatUsd,
-  fetchBtcUsdRate,
-  getLastKnownBtcRate,
-  formatStaleness,
-  resolveRpcOverride,
-  resolveRpcHttpTransportOptions
+  settleWithFacilitator
 };

package/dist/chunk-XYTSDAPH.js

@@ -0,0 +1,232 @@
+import {
+  DEFAULT_CREDIT_MAX,
+  DEFAULT_CREDIT_MIN,
+  DEFAULT_CREDIT_TTL_SECONDS,
+  isZodSchema
+} from "./chunk-AZBXSXQT.js";
+import {
+  InvalidCurrencyError,
+  validateCurrency
+} from "./chunk-27V2ILSR.js";
+import {
+  parseUsdPrice
+} from "./chunk-AT6V3SY7.js";
+
+// src/lib/wire-schema.ts
+var CAPABILITY_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
+
+// src/sdk/configure.ts
+function configureDVM(config) {
+  const tags = collectTags(config);
+  const currency = resolvePricingCurrency(config.currency);
+  const capabilities = buildCapabilityMap(config, currency);
+  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,
+    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 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,
+    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,
+      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 || 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]];
+}
+
+export {
+  CAPABILITY_NAME_RE,
+  configureDVM,
+  isConfiguredDVMDescriptor
+};