@lucid-agents/taskmarket 1.16.0 → 1.17.1

package/dist/chunk-73RXOYME.js

@@ -0,0 +1,185 @@
+import { createRequire as __tmCreateRequire } from 'node:module'; import { fileURLToPath as __tmFileURLToPath } from 'node:url'; import { dirname as __tmDirname } from 'node:path'; const require = __tmCreateRequire(import.meta.url); const __tmFilename = __tmFileURLToPath(import.meta.url); const __tmDirnameValue = __tmDirname(__tmFilename);
+
+// src/lib/agent/budget-view.ts
+var AGENT_VIEW_VERSION = 1;
+var USDC_DECIMALS = 6;
+function formatUsdc(atomic) {
+  let value;
+  try {
+    value = typeof atomic === "bigint" ? atomic : BigInt(atomic);
+  } catch {
+    return "$?";
+  }
+  const negative = value < 0n;
+  const abs = negative ? -value : value;
+  const scale = 10n ** BigInt(USDC_DECIMALS);
+  const fraction = (abs % scale).toString().padStart(USDC_DECIMALS, "0").replace(/0+$/, "");
+  return `${negative ? "-" : ""}$${abs / scale}.${fraction.padEnd(2, "0")}`;
+}
+function formatCredits(value) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) return value;
+  return number >= 100 ? number.toFixed(0) : number.toFixed(1);
+}
+function usdcToAtomic(value) {
+  const match = /^(\d{1,12})(?:\.(\d{1,6}))?$/.exec(value.trim().replace(/^\$/, ""));
+  if (!match) return void 0;
+  return (BigInt(match[1]) * 10n ** BigInt(USDC_DECIMALS) + BigInt((match[2] ?? "").padEnd(USDC_DECIMALS, "0"))).toString();
+}
+function burnRate(debits) {
+  let seconds = 0;
+  let credits = 0;
+  for (const debit of debits) {
+    if (!(debit.seconds > 0)) continue;
+    seconds += debit.seconds;
+    credits += Number(debit.credits);
+    if (seconds >= 3600) break;
+  }
+  if (seconds === 0 || !Number.isFinite(credits)) return null;
+  return (credits * 3600 / seconds).toFixed(4);
+}
+function computeLow(input) {
+  if (input.warning === "low_credit" || input.warning === "credit_exhausted") return true;
+  if (input.availableCredits === null) return false;
+  const available = Number(input.availableCredits);
+  if (input.thresholdCredits !== void 0 && available < Number(input.thresholdCredits)) {
+    return true;
+  }
+  return input.burnCreditsPerHour !== null && available < Number(input.burnCreditsPerHour);
+}
+function remainingBudget(view) {
+  const channels = view.channels.filter((channel) => channel.state === "open" && !channel.retired).reduce(
+    (sum, channel) => sum + BigInt(channel.amounts.refundable) + BigInt(channel.amounts.lifetimeRoom),
+    0n
+  );
+  if (!view.budget) return channels;
+  const left = BigInt(view.budget.cap) - BigInt(view.budget.used);
+  const budget = left > 0n ? left : 0n;
+  return channels < budget ? channels : budget;
+}
+function blockingPurchases(view) {
+  const ids = new Set(view.unresolved);
+  for (const channel of view.channels) {
+    if (channel.pendingOperation?.kind === "payment") ids.add(channel.pendingOperation.id);
+  }
+  return [...ids];
+}
+function statusBarText(view) {
+  const parts = [];
+  parts.push(view.lastTurn ? `turn ${formatUsdc(view.lastTurn.chargedAtomic)}` : "turn -");
+  const active = view.channels.filter((channel) => !channel.retired);
+  if (active.length > 0) {
+    const open = active.some((channel) => channel.state === "open");
+    parts.push(
+      open ? `budget ${formatUsdc(remainingBudget(view))} left` : `channel ${active[0].state.replace("_", " ")}`
+    );
+  }
+  const compute = view.compute;
+  if (compute?.configured && compute.availableCredits !== null) {
+    const burn = compute.burnCreditsPerHour !== null ? ` at ${formatCredits(compute.burnCreditsPerHour)}/h` : "";
+    parts.push(
+      `compute ${formatCredits(compute.availableCredits)} cr${burn}${compute.low ? " LOW: /credits" : ""}`
+    );
+  } else if (compute && !compute.configured) {
+    parts.push("compute: not set up");
+  }
+  const blocking = blockingPurchases(view);
+  if (blocking.length > 0) {
+    const id = blocking[0].length > 12 ? `${blocking[0].slice(0, 12)}...` : blocking[0];
+    parts.push(`purchase ${id} unresolved: new turns blocked, see /budget`);
+  }
+  return parts.join(" | ");
+}
+function channelLines(channel) {
+  const a = channel.amounts;
+  return [
+    `Channel ${channel.rail}${channel.retired ? " (retired)" : ""} ${channel.channelId} (${channel.network}, ${channel.route}): ${channel.state.replace("_", " ")}`,
+    `  Locked ${formatUsdc(a.locked)} (deposited, not spent); charged ${formatUsdc(a.charged)}; pending vouchers ${formatUsdc(a.pending)}; refunded ${formatUsdc(a.refunded)}`,
+    `  Refundable ${formatUsdc(a.refundable)}: what further turns can use and a close returns`,
+    `  Budget ${formatUsdc(a.budget)}; ${formatUsdc(a.lifetimeRoom)} may still be deposited; next deposit ${formatUsdc(a.depositTarget)}${Number(a.depositing) > 0 ? `; ${formatUsdc(a.depositing)} being deposited` : ""}`,
+    ...channel.pendingOperation ? [
+      channel.pendingOperation.kind === "payment" ? `  Purchase ${channel.pendingOperation.id} is unresolved and blocks new turns: taskmarket agent reconcile ${channel.pendingOperation.id}` : `  A refund or withdrawal (${channel.pendingOperation.id}) is unresolved: taskmarket agent close checks it again`
+    ] : [],
+    ...channel.blockingDivergences.length > 0 ? [
+      `  Blocked: the journal, the router and the chain disagree (${channel.blockingDivergences.join(", ")})`
+    ] : []
+  ];
+}
+function budgetLines(view) {
+  const lines = [
+    `This session: ${view.session.turns} paid turn${view.session.turns === 1 ? "" : "s"}, ${formatUsdc(view.session.chargedAtomic)}${view.lastTurn ? `; last turn ${formatUsdc(view.lastTurn.chargedAtomic)}` : ""}`
+  ];
+  for (const channel of view.channels) lines.push(...channelLines(channel));
+  for (const allocation of view.allocations) {
+    lines.push(
+      `Allocation ${allocation.allocationId} (${allocation.exposure})${allocation.closed ? ", closed" : ""}: used ${formatUsdc(allocation.used.total)} of ${formatUsdc(allocation.caps.amount)}${allocation.caps.perDay ? `; today ${formatUsdc(allocation.used.today)} of ${formatUsdc(allocation.caps.perDay)}` : ""}`
+    );
+  }
+  for (const id of blockingPurchases(view)) {
+    lines.push(uncertainPurchaseMessage(id));
+  }
+  const compute = view.compute;
+  if (compute) lines.push(...computeLines(compute));
+  return lines;
+}
+function computeLines(compute) {
+  if (!compute.configured) {
+    return ["Compute credit: not set up; run taskmarket agent credits setup"];
+  }
+  if (compute.error !== void 0 || compute.availableCredits === null) {
+    return [`Compute credit: unavailable (${compute.error ?? "not read"})`];
+  }
+  return [
+    `Compute credit: ${formatCredits(compute.availableCredits)} available${compute.burnCreditsPerHour !== null ? `, burning ${formatCredits(compute.burnCreditsPerHour)} an hour while the sandbox runs` : ""}${compute.low ? ". Low: buy more with /credits" : ""}`,
+    ...compute.pendingPurchases > 0 ? [
+      `  ${compute.pendingPurchases} purchase(s) not settled yet: taskmarket agent credits reconcile`
+    ] : [],
+    ...compute.autoTopUp ? [
+      `  Auto-top-up: $${compute.autoTopUp.amountUsd} below ${compute.autoTopUp.thresholdCredits} credits, at most ${compute.autoTopUp.maxChunksPerDay} a day`
+    ] : []
+  ];
+}
+var LOST_RESPONSE_TEXT = "It was charged, and the response cannot be recovered or regenerated: xgate delivers it live only and keeps no copy. Asking again is a new paid turn.";
+function uncertainPurchaseMessage(invocationId) {
+  return `The outcome of purchase ${invocationId} is unknown. It is never sent again, and new turns on its channel are blocked until it is reconciled: taskmarket agent reconcile ${invocationId}. If it was charged, its response cannot be recovered or regenerated.`;
+}
+var CHARGED_UNDELIVERED = /* @__PURE__ */ new Set([
+  "result_too_large",
+  "response_rejected",
+  "invalid_response",
+  "response_hook_failed"
+]);
+function purchaseFailureNotice(failure) {
+  if (failure.pending) {
+    return {
+      level: "warning",
+      text: uncertainPurchaseMessage(failure.invocationId || "(unknown)")
+    };
+  }
+  const charged = failure.payment?.chargedAtomic;
+  if (charged !== void 0 || CHARGED_UNDELIVERED.has(failure.code)) {
+    return {
+      level: "error",
+      text: `This turn was paid${charged !== void 0 ? ` (${formatUsdc(charged)})` : ""} but its response was lost (${failure.code}). ${LOST_RESPONSE_TEXT}`
+    };
+  }
+  return void 0;
+}
+
+export {
+  AGENT_VIEW_VERSION,
+  formatUsdc,
+  formatCredits,
+  usdcToAtomic,
+  burnRate,
+  computeLow,
+  remainingBudget,
+  blockingPurchases,
+  statusBarText,
+  channelLines,
+  budgetLines,
+  computeLines,
+  LOST_RESPONSE_TEXT,
+  uncertainPurchaseMessage,
+  purchaseFailureNotice
+};