agentbnb 8.2.3 → 8.3.0

package/dist/chunk-EE3V3DXK.js

@@ -0,0 +1,60 @@
+// src/identity/agent-identity.ts
+var AGENTS_SCHEMA = `
+  CREATE TABLE IF NOT EXISTS agents (
+    agent_id TEXT PRIMARY KEY,
+    display_name TEXT NOT NULL,
+    public_key TEXT NOT NULL,
+    operator_id TEXT,
+    server_id TEXT,
+    legacy_owner TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_agents_operator ON agents(operator_id);
+  CREATE INDEX IF NOT EXISTS idx_agents_legacy_owner ON agents(legacy_owner);
+`;
+function ensureAgentsTable(db) {
+  db.exec(AGENTS_SCHEMA);
+}
+function lookupAgent(db, agentId) {
+  return db.prepare("SELECT * FROM agents WHERE agent_id = ?").get(agentId) ?? null;
+}
+function lookupAgentByOwner(db, owner) {
+  return db.prepare("SELECT * FROM agents WHERE legacy_owner = ?").get(owner) ?? null;
+}
+function resolveCanonicalIdentity(db, identifier) {
+  ensureAgentsTable(db);
+  if (/^[a-f0-9]{16}$/.test(identifier)) {
+    const byAgentId = lookupAgent(db, identifier);
+    if (byAgentId) {
+      return {
+        agent_id: byAgentId.agent_id,
+        legacy_owner: byAgentId.legacy_owner,
+        resolved: true,
+        source: "agent_id"
+      };
+    }
+  }
+  const byOwner = lookupAgentByOwner(db, identifier);
+  if (byOwner) {
+    return {
+      agent_id: byOwner.agent_id,
+      legacy_owner: byOwner.legacy_owner,
+      resolved: true,
+      source: "legacy_owner"
+    };
+  }
+  return {
+    agent_id: identifier,
+    legacy_owner: null,
+    resolved: false,
+    source: "unresolved"
+  };
+}
+
+export {
+  ensureAgentsTable,
+  lookupAgent,
+  resolveCanonicalIdentity
+};

package/dist/{chunk-RYISHSHB.js → chunk-F3KIEVJ2.js}

@@ -1,79 +1,22 @@
 import {
+  canonicalizeCreditOwner,
   ensureReliabilityTable,
+  migrateCreditOwnerData,
   recordSuccessfulHire
-} from "./chunk-NWIQJ2CL.js";
+} from "./chunk-U6LP4KWN.js";
 import {
   getFeedbackForProvider
-} from "./chunk-S3V6R3EN.js";
+} from "./chunk-5AIYALBX.js";
+import {
+  ensureAgentsTable
+} from "./chunk-WTHMHNKC.js";
 import {
   AgentBnBError
-} from "./chunk-WVY2W7AA.js";
+} from "./chunk-I7KWA7OB.js";
 
 // src/credit/ledger.ts
 import Database from "better-sqlite3";
 import { randomUUID } from "crypto";
-
-// src/identity/agent-identity.ts
-var AGENTS_SCHEMA = `
-  CREATE TABLE IF NOT EXISTS agents (
-    agent_id TEXT PRIMARY KEY,
-    display_name TEXT NOT NULL,
-    public_key TEXT NOT NULL,
-    operator_id TEXT,
-    server_id TEXT,
-    legacy_owner TEXT,
-    created_at TEXT NOT NULL,
-    updated_at TEXT NOT NULL
-  );
-
-  CREATE INDEX IF NOT EXISTS idx_agents_operator ON agents(operator_id);
-  CREATE INDEX IF NOT EXISTS idx_agents_legacy_owner ON agents(legacy_owner);
-`;
-function ensureAgentsTable(db) {
-  db.exec(AGENTS_SCHEMA);
-}
-function createAgentRecord(db, agent) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const record = {
-    agent_id: agent.agent_id,
-    display_name: agent.display_name,
-    public_key: agent.public_key,
-    operator_id: agent.operator_id ?? null,
-    server_id: agent.server_id ?? null,
-    legacy_owner: agent.legacy_owner ?? null,
-    created_at: now,
-    updated_at: now
-  };
-  const result = db.prepare(
-    `INSERT OR IGNORE INTO agents
-       (agent_id, display_name, public_key, operator_id, server_id, legacy_owner, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    record.agent_id,
-    record.display_name,
-    record.public_key,
-    record.operator_id,
-    record.server_id,
-    record.legacy_owner,
-    record.created_at,
-    record.updated_at
-  );
-  if (result.changes === 0) {
-    throw new AgentBnBError(
-      "AGENT_EXISTS",
-      `Agent ${agent.agent_id} already exists`
-    );
-  }
-  return record;
-}
-function lookupAgent(db, agentId) {
-  return db.prepare("SELECT * FROM agents WHERE agent_id = ?").get(agentId) ?? null;
-}
-function lookupAgentByOwner(db, owner) {
-  return db.prepare("SELECT * FROM agents WHERE legacy_owner = ?").get(owner) ?? null;
-}
-
-// src/credit/ledger.ts
 var CREDIT_SCHEMA = `
   CREATE TABLE IF NOT EXISTS credit_balances (
     owner TEXT PRIMARY KEY,
@@ -133,30 +76,33 @@ function openCreditDb(path = ":memory:") {
   return db;
 }
 function bootstrapAgent(db, owner, amount = 100) {
+  const canonicalOwner = canonicalizeCreditOwner(db, owner);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   let isNew = false;
   db.transaction(() => {
-    const result = db.prepare("INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, ?, ?)").run(owner, amount, now);
+    const result = db.prepare("INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, ?, ?)").run(canonicalOwner, amount, now);
     if (result.changes > 0) {
       isNew = true;
       db.prepare(
         "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-      ).run(randomUUID(), owner, amount, "bootstrap", null, now);
+      ).run(randomUUID(), canonicalOwner, amount, "bootstrap", null, now);
     }
   })();
   if (isNew) {
-    issueVoucher(db, owner, 50, 30);
+    issueVoucher(db, canonicalOwner, 50, 30);
   }
 }
 function getBalance(db, owner) {
-  const row = db.prepare("SELECT balance FROM credit_balances WHERE owner = ?").get(owner);
+  const canonicalOwner = canonicalizeCreditOwner(db, owner);
+  const row = db.prepare("SELECT balance FROM credit_balances WHERE owner = ?").get(canonicalOwner);
   return row?.balance ?? 0;
 }
 function getTransactions(db, owner, opts = 100) {
+  const canonicalOwner = canonicalizeCreditOwner(db, owner);
   const page = typeof opts === "number" ? { limit: opts } : opts;
   const limit = page.limit ?? 100;
   const conditions = ["owner = ?"];
-  const params = [owner];
+  const params = [canonicalOwner];
   if (page.before) {
     conditions.push("created_at < ?");
     params.push(page.before);
@@ -171,15 +117,17 @@ function getTransactions(db, owner, opts = 100) {
   ).all(...params);
 }
 function registerProvider(db, owner) {
+  const canonicalOwner = canonicalizeCreditOwner(db, owner);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const maxRow = db.prepare("SELECT MAX(provider_number) as maxNum FROM provider_registry").get();
   const nextNum = (maxRow?.maxNum ?? 0) + 1;
-  db.prepare("INSERT OR IGNORE INTO provider_registry (owner, provider_number, registered_at) VALUES (?, ?, ?)").run(owner, nextNum, now);
-  const row = db.prepare("SELECT provider_number FROM provider_registry WHERE owner = ?").get(owner);
+  db.prepare("INSERT OR IGNORE INTO provider_registry (owner, provider_number, registered_at) VALUES (?, ?, ?)").run(canonicalOwner, nextNum, now);
+  const row = db.prepare("SELECT provider_number FROM provider_registry WHERE owner = ?").get(canonicalOwner);
   return row.provider_number;
 }
 function getProviderNumber(db, owner) {
-  const row = db.prepare("SELECT provider_number FROM provider_registry WHERE owner = ?").get(owner);
+  const canonicalOwner = canonicalizeCreditOwner(db, owner);
+  const row = db.prepare("SELECT provider_number FROM provider_registry WHERE owner = ?").get(canonicalOwner);
   return row?.provider_number ?? null;
 }
 function getProviderBonus(providerNumber) {
@@ -188,19 +136,21 @@ function getProviderBonus(providerNumber) {
   return 1;
 }
 function issueVoucher(db, owner, amount = 50, daysValid = 30) {
+  const canonicalOwner = canonicalizeCreditOwner(db, owner);
   const id = randomUUID();
   const now = /* @__PURE__ */ new Date();
   const expiresAt = new Date(now.getTime() + daysValid * 24 * 60 * 60 * 1e3);
   db.prepare(
     "INSERT INTO demand_vouchers (id, owner, amount, remaining, created_at, expires_at, is_active) VALUES (?, ?, ?, ?, ?, ?, 1)"
-  ).run(id, owner, amount, amount, now.toISOString(), expiresAt.toISOString());
+  ).run(id, canonicalOwner, amount, amount, now.toISOString(), expiresAt.toISOString());
   return id;
 }
 function getActiveVoucher(db, owner) {
+  const canonicalOwner = canonicalizeCreditOwner(db, owner);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const row = db.prepare(
     "SELECT id, remaining, expires_at FROM demand_vouchers WHERE owner = ? AND is_active = 1 AND remaining > 0 AND expires_at > ? ORDER BY created_at ASC LIMIT 1"
-  ).get(owner, now);
+  ).get(canonicalOwner, now);
   return row ?? null;
 }
 function consumeVoucher(db, voucherId, amount) {
@@ -208,189 +158,10 @@ function consumeVoucher(db, voucherId, amount) {
     "UPDATE demand_vouchers SET remaining = remaining - ? WHERE id = ? AND remaining >= ?"
   ).run(amount, voucherId, amount);
 }
-function recordEarning(db, owner, amount, _cardId, receiptNonce) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  db.transaction(() => {
-    const existing = db.prepare(
-      "SELECT id FROM credit_transactions WHERE reference_id = ? AND reason = 'remote_earning'"
-    ).get(receiptNonce);
-    if (existing) return;
-    db.prepare(
-      "INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, 0, ?)"
-    ).run(owner, now);
-    db.prepare(
-      "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
-    ).run(amount, now, owner);
-    db.prepare(
-      "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-    ).run(randomUUID(), owner, amount, "remote_earning", receiptNonce, now);
-  })();
-}
 function migrateOwner(db, oldOwner, newOwner) {
   if (oldOwner === newOwner) return;
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  db.transaction(() => {
-    const oldRow = db.prepare("SELECT balance FROM credit_balances WHERE owner = ?").get(oldOwner);
-    if (!oldRow) return;
-    const newRow = db.prepare("SELECT balance FROM credit_balances WHERE owner = ?").get(newOwner);
-    if (newRow) {
-      db.prepare("UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?").run(oldRow.balance, now, newOwner);
-    } else {
-      db.prepare("UPDATE credit_balances SET owner = ?, updated_at = ? WHERE owner = ?").run(newOwner, now, oldOwner);
-    }
-    if (newRow) {
-      db.prepare("DELETE FROM credit_balances WHERE owner = ?").run(oldOwner);
-    }
-    db.prepare("UPDATE credit_transactions SET owner = ? WHERE owner = ?").run(newOwner, oldOwner);
-    db.prepare("UPDATE credit_escrow SET owner = ? WHERE owner = ?").run(newOwner, oldOwner);
-  })();
-}
-
-// src/credit/escrow.ts
-import { randomUUID as randomUUID2 } from "crypto";
-var NETWORK_FEE_RATE = 0.05;
-function holdEscrow(db, owner, amount, cardId) {
-  const escrowId = randomUUID2();
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const hold = db.transaction(() => {
-    const voucher = getActiveVoucher(db, owner);
-    if (voucher && voucher.remaining >= amount) {
-      consumeVoucher(db, voucher.id, amount);
-      db.prepare(
-        "INSERT INTO credit_escrow (id, owner, amount, card_id, status, created_at, funding_source) VALUES (?, ?, ?, ?, ?, ?, ?)"
-      ).run(escrowId, owner, amount, cardId, "held", now, "voucher");
-      db.prepare(
-        "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-      ).run(randomUUID2(), owner, -amount, "voucher_hold", escrowId, now);
-    } else {
-      const row = db.prepare("SELECT balance FROM credit_balances WHERE owner = ?").get(owner);
-      if (!row || row.balance < amount) {
-        throw new AgentBnBError("Insufficient credits", "INSUFFICIENT_CREDITS");
-      }
-      db.prepare(
-        "UPDATE credit_balances SET balance = balance - ?, updated_at = ? WHERE owner = ? AND balance >= ?"
-      ).run(amount, now, owner, amount);
-      db.prepare(
-        "INSERT INTO credit_escrow (id, owner, amount, card_id, status, created_at, funding_source) VALUES (?, ?, ?, ?, ?, ?, ?)"
-      ).run(escrowId, owner, amount, cardId, "held", now, "balance");
-      db.prepare(
-        "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-      ).run(randomUUID2(), owner, -amount, "escrow_hold", escrowId, now);
-    }
-  });
-  hold();
-  return escrowId;
-}
-function settleEscrow(db, escrowId, recipientOwner) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const settle = db.transaction(() => {
-    const escrow = db.prepare("SELECT id, owner, amount, status, funding_source FROM credit_escrow WHERE id = ?").get(escrowId);
-    if (!escrow) {
-      throw new AgentBnBError(`Escrow not found: ${escrowId}`, "ESCROW_NOT_FOUND");
-    }
-    if (escrow.status !== "held") {
-      throw new AgentBnBError(
-        `Escrow ${escrowId} is already ${escrow.status}`,
-        "ESCROW_ALREADY_SETTLED"
-      );
-    }
-    const feeAmount = Math.floor(escrow.amount * NETWORK_FEE_RATE);
-    const providerAmount = escrow.amount - feeAmount;
-    db.prepare(
-      "INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, 0, ?)"
-    ).run(recipientOwner, now);
-    db.prepare(
-      "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
-    ).run(providerAmount, now, recipientOwner);
-    if (feeAmount > 0) {
-      db.prepare(
-        "INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, 0, ?)"
-      ).run("platform_treasury", now);
-      db.prepare(
-        "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
-      ).run(feeAmount, now, "platform_treasury");
-      db.prepare(
-        "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-      ).run(randomUUID2(), "platform_treasury", feeAmount, "network_fee", escrowId, now);
-    }
-    db.prepare(
-      "UPDATE credit_escrow SET status = ?, settled_at = ? WHERE id = ?"
-    ).run("settled", now, escrowId);
-    db.prepare(
-      "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-    ).run(randomUUID2(), recipientOwner, providerAmount, "settlement", escrowId, now);
-    let providerNum = getProviderNumber(db, recipientOwner);
-    if (providerNum === null) {
-      providerNum = registerProvider(db, recipientOwner);
-    }
-    const bonus = getProviderBonus(providerNum);
-    if (bonus > 1) {
-      const bonusAmount = Math.floor(providerAmount * (bonus - 1));
-      if (bonusAmount > 0) {
-        db.prepare(
-          "INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, 0, ?)"
-        ).run("platform_treasury", now);
-        db.prepare(
-          "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
-        ).run(bonusAmount, now, recipientOwner);
-        db.prepare(
-          "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-        ).run(randomUUID2(), recipientOwner, bonusAmount, "provider_bonus", escrowId, now);
-      }
-    }
-    try {
-      recordSuccessfulHire(db, recipientOwner, escrow.owner);
-    } catch {
-    }
-  });
-  settle();
-}
-function releaseEscrow(db, escrowId) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const release = db.transaction(() => {
-    const escrow = db.prepare("SELECT id, owner, amount, status, funding_source FROM credit_escrow WHERE id = ?").get(escrowId);
-    if (!escrow) {
-      throw new AgentBnBError(`Escrow not found: ${escrowId}`, "ESCROW_NOT_FOUND");
-    }
-    if (escrow.status !== "held") {
-      throw new AgentBnBError(
-        `Escrow ${escrowId} is already ${escrow.status}`,
-        "ESCROW_ALREADY_SETTLED"
-      );
-    }
-    db.prepare(
-      "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
-    ).run(escrow.amount, now, escrow.owner);
-    db.prepare(
-      "UPDATE credit_escrow SET status = ?, settled_at = ? WHERE id = ?"
-    ).run("released", now, escrowId);
-    db.prepare(
-      "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-    ).run(randomUUID2(), escrow.owner, escrow.amount, "refund", escrowId, now);
-  });
-  release();
-}
-function confirmEscrowDebit(db, escrowId) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const confirm = db.transaction(() => {
-    const escrow = db.prepare("SELECT id, owner, amount, status, funding_source FROM credit_escrow WHERE id = ?").get(escrowId);
-    if (!escrow) {
-      throw new AgentBnBError(`Escrow not found: ${escrowId}`, "ESCROW_NOT_FOUND");
-    }
-    if (escrow.status !== "held") {
-      throw new AgentBnBError(
-        `Escrow ${escrowId} is already ${escrow.status}`,
-        "ESCROW_ALREADY_SETTLED"
-      );
-    }
-    db.prepare(
-      "UPDATE credit_escrow SET status = ?, settled_at = ? WHERE id = ?"
-    ).run("settled", now, escrowId);
-    db.prepare(
-      "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
-    ).run(randomUUID2(), escrow.owner, 0, "remote_settlement_confirmed", escrowId, now);
-  });
-  confirm();
+  const canonicalNewOwner = canonicalizeCreditOwner(db, newOwner);
+  migrateCreditOwnerData(db, oldOwner, canonicalNewOwner);
 }
 
 // src/feedback/reputation.ts
@@ -586,6 +357,180 @@ function buildReputationMap(db, owners) {
   return map;
 }
 
+// src/credit/escrow.ts
+import { randomUUID as randomUUID2 } from "crypto";
+var NETWORK_FEE_RATE = 0.05;
+var FINALIZABLE_ESCROW_STATUSES = /* @__PURE__ */ new Set([
+  "held",
+  "started",
+  "progressing",
+  "abandoned"
+]);
+var TERMINAL_ESCROW_STATUSES = /* @__PURE__ */ new Set(["settled", "released"]);
+function getEscrowForMutation(db, escrowId) {
+  const escrow = db.prepare("SELECT id, owner, amount, status, funding_source FROM credit_escrow WHERE id = ?").get(escrowId);
+  if (!escrow) {
+    throw new AgentBnBError(`Escrow not found: ${escrowId}`, "ESCROW_NOT_FOUND");
+  }
+  return {
+    ...escrow,
+    owner: canonicalizeCreditOwner(db, escrow.owner)
+  };
+}
+function updateEscrowStatus(db, escrowId, fromStatuses, toStatus) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const transition = db.transaction(() => {
+    const escrow = getEscrowForMutation(db, escrowId);
+    const current = escrow.status;
+    if (!fromStatuses.includes(current)) {
+      throw new AgentBnBError(
+        `Invalid escrow transition for ${escrowId}: ${current} -> ${toStatus}`,
+        "ESCROW_INVALID_TRANSITION"
+      );
+    }
+    if (current === toStatus) return;
+    const settledAt = TERMINAL_ESCROW_STATUSES.has(toStatus) ? now : null;
+    db.prepare("UPDATE credit_escrow SET status = ?, settled_at = ? WHERE id = ?").run(
+      toStatus,
+      settledAt,
+      escrowId
+    );
+  });
+  transition();
+}
+function assertEscrowCanFinalize(escrow) {
+  const status = escrow.status;
+  if (FINALIZABLE_ESCROW_STATUSES.has(status)) {
+    return;
+  }
+  if (TERMINAL_ESCROW_STATUSES.has(status)) {
+    throw new AgentBnBError(
+      `Escrow ${escrow.id} is already ${status}`,
+      "ESCROW_ALREADY_SETTLED"
+    );
+  }
+  throw new AgentBnBError(
+    `Escrow ${escrow.id} has invalid lifecycle status: ${escrow.status}`,
+    "ESCROW_INVALID_TRANSITION"
+  );
+}
+function holdEscrow(db, owner, amount, cardId) {
+  const canonicalOwner = canonicalizeCreditOwner(db, owner);
+  const escrowId = randomUUID2();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const hold = db.transaction(() => {
+    const voucher = getActiveVoucher(db, canonicalOwner);
+    if (voucher && voucher.remaining >= amount) {
+      consumeVoucher(db, voucher.id, amount);
+      db.prepare(
+        "INSERT INTO credit_escrow (id, owner, amount, card_id, status, created_at, funding_source) VALUES (?, ?, ?, ?, ?, ?, ?)"
+      ).run(escrowId, canonicalOwner, amount, cardId, "held", now, "voucher");
+      db.prepare(
+        "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
+      ).run(randomUUID2(), canonicalOwner, -amount, "voucher_hold", escrowId, now);
+    } else {
+      const row = db.prepare("SELECT balance FROM credit_balances WHERE owner = ?").get(canonicalOwner);
+      if (!row || row.balance < amount) {
+        throw new AgentBnBError("Insufficient credits", "INSUFFICIENT_CREDITS");
+      }
+      db.prepare(
+        "UPDATE credit_balances SET balance = balance - ?, updated_at = ? WHERE owner = ? AND balance >= ?"
+      ).run(amount, now, canonicalOwner, amount);
+      db.prepare(
+        "INSERT INTO credit_escrow (id, owner, amount, card_id, status, created_at, funding_source) VALUES (?, ?, ?, ?, ?, ?, ?)"
+      ).run(escrowId, canonicalOwner, amount, cardId, "held", now, "balance");
+      db.prepare(
+        "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
+      ).run(randomUUID2(), canonicalOwner, -amount, "escrow_hold", escrowId, now);
+    }
+  });
+  hold();
+  return escrowId;
+}
+function markEscrowStarted(db, escrowId) {
+  updateEscrowStatus(db, escrowId, ["held", "started"], "started");
+}
+function markEscrowProgressing(db, escrowId) {
+  updateEscrowStatus(db, escrowId, ["held", "started", "progressing"], "progressing");
+}
+function markEscrowAbandoned(db, escrowId) {
+  updateEscrowStatus(db, escrowId, ["started", "progressing", "abandoned"], "abandoned");
+}
+function settleEscrow(db, escrowId, recipientOwner) {
+  const canonicalRecipientOwner = canonicalizeCreditOwner(db, recipientOwner);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const settle = db.transaction(() => {
+    const escrow = getEscrowForMutation(db, escrowId);
+    assertEscrowCanFinalize(escrow);
+    const feeAmount = Math.floor(escrow.amount * NETWORK_FEE_RATE);
+    const providerAmount = escrow.amount - feeAmount;
+    db.prepare(
+      "INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, 0, ?)"
+    ).run(canonicalRecipientOwner, now);
+    db.prepare(
+      "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
+    ).run(providerAmount, now, canonicalRecipientOwner);
+    if (feeAmount > 0) {
+      db.prepare(
+        "INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, 0, ?)"
+      ).run("platform_treasury", now);
+      db.prepare(
+        "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
+      ).run(feeAmount, now, "platform_treasury");
+      db.prepare(
+        "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
+      ).run(randomUUID2(), "platform_treasury", feeAmount, "network_fee", escrowId, now);
+    }
+    db.prepare(
+      "UPDATE credit_escrow SET status = ?, settled_at = ? WHERE id = ?"
+    ).run("settled", now, escrowId);
+    db.prepare(
+      "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
+    ).run(randomUUID2(), canonicalRecipientOwner, providerAmount, "settlement", escrowId, now);
+    let providerNum = getProviderNumber(db, canonicalRecipientOwner);
+    if (providerNum === null) {
+      providerNum = registerProvider(db, canonicalRecipientOwner);
+    }
+    const bonus = getProviderBonus(providerNum);
+    if (bonus > 1) {
+      const bonusAmount = Math.floor(providerAmount * (bonus - 1));
+      if (bonusAmount > 0) {
+        db.prepare(
+          "INSERT OR IGNORE INTO credit_balances (owner, balance, updated_at) VALUES (?, 0, ?)"
+        ).run("platform_treasury", now);
+        db.prepare(
+          "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
+        ).run(bonusAmount, now, canonicalRecipientOwner);
+        db.prepare(
+          "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
+        ).run(randomUUID2(), canonicalRecipientOwner, bonusAmount, "provider_bonus", escrowId, now);
+      }
+    }
+    try {
+      recordSuccessfulHire(db, canonicalRecipientOwner, escrow.owner);
+    } catch {
+    }
+  });
+  settle();
+}
+function releaseEscrow(db, escrowId) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const release = db.transaction(() => {
+    const escrow = getEscrowForMutation(db, escrowId);
+    assertEscrowCanFinalize(escrow);
+    db.prepare(
+      "UPDATE credit_balances SET balance = balance + ?, updated_at = ? WHERE owner = ?"
+    ).run(escrow.amount, now, escrow.owner);
+    db.prepare(
+      "UPDATE credit_escrow SET status = ?, settled_at = ? WHERE id = ?"
+    ).run("released", now, escrowId);
+    db.prepare(
+      "INSERT INTO credit_transactions (id, owner, amount, reason, reference_id, created_at) VALUES (?, ?, ?, ?, ?, ?)"
+    ).run(randomUUID2(), escrow.owner, escrow.amount, "refund", escrowId, now);
+  });
+  release();
+}
+
 // src/cli/remote-registry.ts
 var RegistryTimeoutError = class extends AgentBnBError {
   constructor(url) {
@@ -670,24 +615,21 @@ function mergeResults(localCards, remoteCards, hasQuery) {
 }
 
 export {
-  createAgentRecord,
-  lookupAgent,
-  lookupAgentByOwner,
   openCreditDb,
   bootstrapAgent,
   getBalance,
   getTransactions,
-  recordEarning,
   migrateOwner,
-  NETWORK_FEE_RATE,
-  holdEscrow,
-  settleEscrow,
-  releaseEscrow,
-  confirmEscrowDebit,
   computeReputation,
   searchCards,
   filterCards,
   buildReputationMap,
+  holdEscrow,
+  markEscrowStarted,
+  markEscrowProgressing,
+  markEscrowAbandoned,
+  settleEscrow,
+  releaseEscrow,
   fetchRemoteCards,
   mergeResults
 };