@t2000/cli 9.6.0 → 9.7.1

package/dist/{dist-WHAWAYBP.js → dist-DHOTKMC2.js}

@@ -1,5 +1,6 @@
 import { createRequire as __createRequire } from 'module'; import { fileURLToPath as __fileURLToPath } from 'url'; import { dirname as __pathDirname } from 'path'; const require = __createRequire(import.meta.url); const __filename = __fileURLToPath(import.meta.url); const __dirname = __pathDirname(__filename);
 import {
+  A2A_ESCROW_PACKAGE_ID,
   AGENT_ID_PARENT,
   AGENT_ID_PARENT_NAME,
   AGENT_ID_PARENT_NFT_ID,
@@ -18,6 +19,7 @@ import {
   GAS_RESERVE_MIN,
   IKA_TYPE,
   InvalidAddressError,
+  JOB_STATES,
   KNOWN_TARGETS,
   KeypairSigner,
   LABEL_PATTERNS,
@@ -25,6 +27,7 @@ import {
   LimitEnforcer,
   LimitExceededError,
   MANIFEST_TYPE,
+  MAX_JOB_USDC,
   MIST_PER_SUI,
   NAVX_TYPE,
   OPERATION_ASSETS,
@@ -61,6 +64,11 @@ import {
   assertAllowedAsset,
   assertLimitConfig,
   buildAddLeafTx,
+  buildCreateJobTx,
+  buildDeliverJobTx,
+  buildRefundJobTx,
+  buildRejectJobTx,
+  buildReleaseJobTx,
   buildRevokeLeafTx,
   buildSendTx,
   buildSwapTx,
@@ -95,6 +103,7 @@ import {
   getCoinMeta,
   getDecimals,
   getDecimalsForCoinType,
+  getJob,
   getLimits,
   getSponsoredSwapProviders,
   getSuiClient,
@@ -104,6 +113,7 @@ import {
   isAllowedAsset,
   isCetusRouteFresh,
   isInRegistry,
+  jobActionsFor,
   keypairFromPrivateKey,
   listModels,
   loadKey,
@@ -117,6 +127,7 @@ import {
   parseMppSuiChallenge,
   parseSuiRpcTx,
   payWithMpp,
+  preflightCreateJob,
   preflightFail,
   preflightPay,
   preflightSend,
@@ -148,10 +159,11 @@ import {
   validateAddress,
   validateLabel,
   verifyCetusRouteCoinMatch,
+  verifyJobForSeller,
   verifyReceipt,
   walletExists,
   writeLimitsFile
-} from "./chunk-UGQY67E3.js";
+} from "./chunk-SXB4BX4Y.js";
 import "./chunk-634W6JCI.js";
 import "./chunk-BHQGGFE6.js";
 import "./chunk-QHLVOCU6.js";
@@ -165,6 +177,7 @@ import "./chunk-SUSL7H4U.js";
 import "./chunk-PDKJSPAS.js";
 import "./chunk-YPWSCLE3.js";
 export {
+  A2A_ESCROW_PACKAGE_ID,
   AGENT_ID_PARENT,
   AGENT_ID_PARENT_NAME,
   AGENT_ID_PARENT_NFT_ID,
@@ -183,6 +196,7 @@ export {
   GAS_RESERVE_MIN,
   IKA_TYPE,
   InvalidAddressError,
+  JOB_STATES,
   KNOWN_TARGETS,
   KeypairSigner,
   LABEL_PATTERNS,
@@ -190,6 +204,7 @@ export {
   LimitEnforcer,
   LimitExceededError,
   MANIFEST_TYPE,
+  MAX_JOB_USDC,
   MIST_PER_SUI,
   NAVX_TYPE,
   OPERATION_ASSETS,
@@ -226,6 +241,11 @@ export {
   assertAllowedAsset,
   assertLimitConfig,
   buildAddLeafTx,
+  buildCreateJobTx,
+  buildDeliverJobTx,
+  buildRefundJobTx,
+  buildRejectJobTx,
+  buildReleaseJobTx,
   buildRevokeLeafTx,
   buildSendTx,
   buildSwapTx,
@@ -260,6 +280,7 @@ export {
   getCoinMeta,
   getDecimals,
   getDecimalsForCoinType,
+  getJob,
   getLimits,
   getSponsoredSwapProviders,
   getSuiClient,
@@ -269,6 +290,7 @@ export {
   isAllowedAsset,
   isCetusRouteFresh,
   isInRegistry,
+  jobActionsFor,
   keypairFromPrivateKey,
   listModels,
   loadKey,
@@ -282,6 +304,7 @@ export {
   parseMppSuiChallenge,
   parseSuiRpcTx,
   payWithMpp,
+  preflightCreateJob,
   preflightFail,
   preflightPay,
   preflightSend,
@@ -313,8 +336,9 @@ export {
   validateAddress,
   validateLabel,
   verifyCetusRouteCoinMatch,
+  verifyJobForSeller,
   verifyReceipt,
   walletExists,
   writeLimitsFile
 };
-//# sourceMappingURL=dist-WHAWAYBP.js.map
+//# sourceMappingURL=dist-DHOTKMC2.js.map

package/dist/index.js

@@ -4,22 +4,28 @@ import {
   require_safer
 } from "./chunk-FNQMIHYC.js";
 import {
+  MAX_JOB_USDC,
   T2000,
   clearLimits,
   formatUsd,
   generateKeypair,
   getAddress,
+  getJob,
   getLimits,
+  getSuiClient,
   hasLimits,
+  jobActionsFor,
   keypairFromPrivateKey,
   listModels,
   saveBech32,
   saveKey,
   setLimits,
   truncateAddress,
+  validateAddress,
+  verifyJobForSeller,
   verifyReceipt,
   walletExists
-} from "./chunk-UGQY67E3.js";
+} from "./chunk-SXB4BX4Y.js";
 import "./chunk-634W6JCI.js";
 import "./chunk-BHQGGFE6.js";
 import "./chunk-QHLVOCU6.js";
@@ -22272,7 +22278,7 @@ async function runEstimate(url, opts) {
   let req = accepts.find((a) => a.scheme === "exact" && a.network?.startsWith("sui:")) ?? accepts[0];
   let dialect = "x402";
   if (!req) {
-    const { parseMppSuiChallenge } = await import("./dist-WHAWAYBP.js");
+    const { parseMppSuiChallenge } = await import("./dist-DHOTKMC2.js");
     const challenge = await parseMppSuiChallenge(response);
     if (!challenge) {
       throw new Error(
@@ -23364,7 +23370,7 @@ function registerMcpStart(parent) {
   parent.command("start", { isDefault: true }).description("Start MCP server (stdio transport \u2014 for AI client integration)").option("--key <path>", "Custom wallet path (default ~/.t2000/wallet.key)").action(async (opts) => {
     let mod;
     try {
-      mod = await import("./dist-VTNYUSEM.js");
+      mod = await import("./dist-7NJYMC53.js");
     } catch {
       console.error("MCP server not installed. Run:\n  npm install -g @t2000/mcp");
       process.exit(1);
@@ -24438,6 +24444,329 @@ function registerAgents(program3) {
   );
 }
 
+// src/commands/check.ts
+var DEFAULT_GATEWAY_BASE2 = process.env.T2000_GATEWAY_URL ?? "https://mpp.t2000.ai";
+function registerCheck(program3) {
+  program3.command("check").argument("<url>", "Your paid API endpoint (https, answers 402)").description(
+    "Check a paid API against the t2 Agents listing gates (payable 402 \xB7 x402 envelope \xB7 price cap) \u2014 dry run, nothing is paid or listed. Add --list to list it. No account needed: the 402 challenge\u2019s payTo wallet is the seller identity."
+  ).option("--list", "List it in the catalog when the checks pass").option("--gateway <url>", `Gateway base URL (default ${DEFAULT_GATEWAY_BASE2})`).action(async (url, opts) => {
+    try {
+      const base = opts.gateway ?? DEFAULT_GATEWAY_BASE2;
+      const route = opts.list ? "submit" : "preview";
+      const res = await fetch(`${base}/api/catalog/${route}`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ url })
+      });
+      const out = await res.json().catch(() => ({}));
+      if (out.error && !out.gates) {
+        throw new Error(out.error);
+      }
+      if (isJsonMode()) {
+        printJson(out);
+        if (!out.ok) process.exitCode = 1;
+        return;
+      }
+      printBlank();
+      for (const gate of out.gates ?? []) {
+        printInfo(`${gate.ok ? "\u2713" : "\u2717"} ${gate.gate}: ${gate.detail}`);
+      }
+      printBlank();
+      if (!out.ok) {
+        printInfo("Not listable yet \u2014 fix the failing gate above and re-run.");
+        printInfo(`Seller guide: ${base}/sellers.md`);
+        printBlank();
+        process.exitCode = 1;
+        return;
+      }
+      if (opts.list) {
+        printSuccess("Listed.");
+        if (out.url) printKeyValue("Catalog", out.url);
+        if (out.storeUrl) printKeyValue("Store page", out.storeUrl);
+      } else {
+        printHeader(out.service?.name ?? url);
+        if (out.payTo) printKeyValue("Pays", out.payTo);
+        for (const ep of out.service?.endpoints ?? []) {
+          printLine(`  ${ep.method} ${ep.path} \u2014 $${ep.price}${ep.description ? ` \u2014 ${ep.description}` : ""}`);
+        }
+        printBlank();
+        printInfo("All gates pass. List it with: t2 check <url> --list");
+      }
+      const warnings = out.warnings ?? [];
+      if (warnings.length > 0) {
+        printBlank();
+        printHeader(`Listing quality \u2014 ${warnings.length} improvement(s)`);
+        for (const w of warnings) {
+          printInfo(`\u2022 ${w.message}`);
+          printLine("  Paste this into your coding agent to fix it:");
+          printLine(`  ${w.prompt}`);
+          printBlank();
+        }
+      }
+      printBlank();
+    } catch (error) {
+      handleError(error);
+    }
+  });
+}
+
+// src/commands/job.ts
+var import_picocolors15 = __toESM(require_picocolors(), 1);
+import { createHash } from "crypto";
+import { readFile as readFile3 } from "fs/promises";
+var DEFAULT_API_BASE5 = process.env.T2000_API_URL ?? "https://api.t2000.ai/v1";
+var DEFAULT_REVIEW_WINDOW_MS = 24 * 60 * 60 * 1e3;
+var DEFAULT_REJECT_SPLIT_BPS = 8e3;
+function parseDuration(input) {
+  const m = /^(\d+(?:\.\d+)?)([mhd]?)$/.exec(input.trim());
+  if (!m) {
+    throw new Error(`Invalid duration "${input}". Use e.g. 30m, 24h, 7d.`);
+  }
+  const n = Number(m[1]);
+  const unit = m[2] || "m";
+  const ms = unit === "d" ? n * 864e5 : unit === "h" ? n * 36e5 : n * 6e4;
+  if (ms <= 0) throw new Error(`Duration must be positive (got "${input}").`);
+  return Math.round(ms);
+}
+async function resolveCommitment(input) {
+  if (/^0x[0-9a-fA-F]+$/.test(input) && input.length % 2 === 0) return input;
+  let bytes;
+  try {
+    bytes = await readFile3(input);
+  } catch {
+    bytes = Buffer.from(input, "utf8");
+  }
+  return `0x${createHash("sha256").update(bytes).digest("hex")}`;
+}
+function stateColor(state) {
+  if (state === "released") return import_picocolors15.default.green(state);
+  if (state === "refunded" || state === "rejected") return import_picocolors15.default.yellow(state);
+  return import_picocolors15.default.cyan(state);
+}
+function printJob(job, me) {
+  printKeyValue("Job", job.id);
+  printKeyValue("State", stateColor(job.state));
+  printKeyValue("Buyer", truncateAddress(job.buyer) + (me === job.buyer ? import_picocolors15.default.dim(" (you)") : ""));
+  printKeyValue("Seller", truncateAddress(job.seller) + (me === job.seller ? import_picocolors15.default.dim(" (you)") : ""));
+  printKeyValue("Amount", `$${job.amountUsdc.toFixed(2)} USDC`);
+  printKeyValue("Deliver by", new Date(job.deliverByMs).toISOString());
+  if (job.deliveredAtMs) {
+    printKeyValue("Delivered", new Date(job.deliveredAtMs).toISOString());
+    printKeyValue(
+      "Review closes",
+      new Date(job.deliveredAtMs + job.reviewWindowMs).toISOString()
+    );
+  }
+  if (job.deliveryHash) printKeyValue("Delivery hash", job.deliveryHash);
+  printKeyValue("Reject split", `${job.rejectSplitBps / 100}% buyer / ${(1e4 - job.rejectSplitBps) / 100}% seller`);
+}
+async function sponsoredJobVerb(opts) {
+  const agent = await withAgent({ keyPath: opts.keyPath });
+  const address = agent.address();
+  const { digest } = await runSponsoredTx({
+    keypair: agent.keypair,
+    actor: address,
+    prepareUrl: `${opts.base}/job/prepare`,
+    prepareBody: { address, action: opts.action, params: opts.params },
+    submitUrl: `${opts.base}/job/submit`
+  });
+  return { address, digest };
+}
+function registerJob(program3) {
+  const group = program3.command("job").description(
+    "A2A escrow jobs \u2014 USDC locked in a shared Move object, released on delivery (no platform custody)"
+  ).addHelpText(
+    "after",
+    `
+The escrow is a Sui object, not a company: funds lock inside the Job object at
+create; release/refund are pure functions of (state, clock, caller). A ghosting
+buyer can't strand a delivering seller (anyone may release after the review
+window) and a no-show seller can never keep funds (anyone may refund after the
+deadline). v1 caps jobs at ${MAX_JOB_USDC} USDC.
+
+Typical flow:
+  buyer   $ t2 job create 5 0xSELLER --spec brief.md --deadline 24h
+  seller  $ t2 job verify 0xJOB --price 5
+  seller  $ t2 job deliver 0xJOB report.pdf
+  buyer   $ t2 job release 0xJOB          (or: t2 job reject 0xJOB)
+  either  $ t2 job watch 0xJOB
+`
+  );
+  group.command("create").argument("<amount>", `USDC to escrow (max ${MAX_JOB_USDC})`).argument("<seller>", "The seller's Sui address (their listing's payTo wallet)").description("Create + fund an escrow job in one transaction (buyer)").requiredOption("--spec <file-or-text>", "Job spec \u2014 a file path or inline text (hashed on-chain), or a 0x\u2026 hash").option("--deadline <duration>", "Time the seller has to deliver (e.g. 30m, 24h, 7d)", "24h").option("--review <duration>", "Your accept/reject window after delivery", "24h").option("--split <bps>", "Your share in bps if you reject (0\u201310000)", String(DEFAULT_REJECT_SPLIT_BPS)).option("--key <path>", "Custom wallet path (default ~/.t2000/wallet.key)").option("--api <url>", `API base URL (default ${DEFAULT_API_BASE5})`).action(
+    async (amountArg, sellerArg, opts) => {
+      try {
+        const amountUsdc = Number.parseFloat(amountArg);
+        if (!Number.isFinite(amountUsdc) || amountUsdc <= 0) {
+          throw new Error(`Amount must be a positive number (got "${amountArg}").`);
+        }
+        const seller = validateAddress(sellerArg);
+        const specHash = await resolveCommitment(opts.spec);
+        const deliverByMs = Date.now() + parseDuration(opts.deadline);
+        const reviewWindowMs = opts.review ? parseDuration(opts.review) : DEFAULT_REVIEW_WINDOW_MS;
+        const rejectSplitBps = Number.parseInt(opts.split, 10);
+        const base = opts.api ?? DEFAULT_API_BASE5;
+        const { address, digest } = await sponsoredJobVerb({
+          base,
+          keyPath: opts.key,
+          action: "create",
+          params: { seller, amountUsdc, specHash, deliverByMs, reviewWindowMs, rejectSplitBps }
+        });
+        const client = getSuiClient();
+        let jobId;
+        if (digest) {
+          try {
+            const result = await client.core.waitForTransaction({
+              digest,
+              include: { objectTypes: true },
+              timeout: 15e3
+            });
+            const txn = result.$kind === "Transaction" ? result.Transaction : result.FailedTransaction;
+            const types = txn.objectTypes ?? {};
+            jobId = Object.keys(types).find((id) => types[id]?.includes("::escrow::Job<"));
+          } catch {
+          }
+        }
+        if (isJsonMode()) {
+          printJson({ jobId, digest, buyer: address, seller, amountUsdc, specHash, deliverByMs, reviewWindowMs, rejectSplitBps });
+          return;
+        }
+        printBlank();
+        printSuccess(`Escrowed $${amountUsdc.toFixed(2)} USDC \u2192 job for ${truncateAddress(seller)}`);
+        if (jobId) printKeyValue("Job", jobId);
+        printKeyValue("Spec hash", specHash);
+        printKeyValue("Deliver by", new Date(deliverByMs).toISOString());
+        if (digest) printKeyValue("Tx", digest);
+        printBlank();
+        if (jobId) {
+          printInfo(`Hand the seller the job id \u2014 they verify it with: t2 job verify ${jobId} --price ${amountUsdc}`);
+        }
+        printBlank();
+      } catch (error) {
+        handleError(error);
+      }
+    }
+  );
+  group.command("verify").argument("<jobId>", "The Job object id (0x\u2026)").description("Seller-side check: the job is funded, pays YOU, and covers the price").requiredOption("--price <usdc>", "Your price for this job class").option("--key <path>", "Custom wallet path (default ~/.t2000/wallet.key)").action(async (jobId, opts) => {
+    try {
+      const agent = await withAgent({ keyPath: opts.key });
+      const client = getSuiClient();
+      const result = await verifyJobForSeller({
+        client,
+        jobId,
+        seller: agent.address(),
+        minAmountUsdc: Number.parseFloat(opts.price)
+      });
+      if (isJsonMode()) {
+        printJson({ ok: result.ok, problems: result.problems, job: result.job });
+        if (!result.ok) process.exitCode = 1;
+        return;
+      }
+      printBlank();
+      if (result.ok) {
+        printSuccess("Escrow verified \u2014 funded, pays this wallet, covers the price. Safe to start work.");
+      } else {
+        printError("Do NOT start work on this job:");
+        for (const p of result.problems) printWarning(`  ${p}`);
+        process.exitCode = 1;
+      }
+      printBlank();
+      printJob(result.job, agent.address());
+      printBlank();
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  group.command("deliver").argument("<jobId>", "The Job object id (0x\u2026)").argument("<proof>", "Delivery artifact \u2014 a file path or text (hashed on-chain), or a 0x\u2026 hash").description("Post your proof-of-delivery before the deadline (seller)").option("--key <path>", "Custom wallet path (default ~/.t2000/wallet.key)").option("--api <url>", `API base URL (default ${DEFAULT_API_BASE5})`).action(async (jobId, proof, opts) => {
+    try {
+      const deliveryHash = await resolveCommitment(proof);
+      const { digest } = await sponsoredJobVerb({
+        base: opts.api ?? DEFAULT_API_BASE5,
+        keyPath: opts.key,
+        action: "deliver",
+        params: { jobId, deliveryHash }
+      });
+      if (isJsonMode()) {
+        printJson({ jobId, deliveryHash, digest });
+        return;
+      }
+      printBlank();
+      printSuccess("Delivery posted \u2014 the buyer's review window is now open.");
+      printKeyValue("Delivery hash", deliveryHash);
+      if (digest) printKeyValue("Tx", digest);
+      printInfo("If the buyer neither accepts nor rejects before the window closes, anyone (including you) can run `t2 job release` to settle.");
+      printBlank();
+    } catch (error) {
+      handleError(error);
+    }
+  });
+  for (const [verb, description, note] of [
+    [
+      "release",
+      "Accept delivery \u2014 funds go to the seller (buyer; or anyone once the review window lapses)",
+      "Funds released to the seller."
+    ],
+    [
+      "reject",
+      "Reject a delivery within the review window \u2014 funds split per the create terms (buyer)",
+      "Delivery rejected \u2014 funds split per the terms agreed at create."
+    ],
+    [
+      "refund",
+      "Reclaim funds after the deadline passed with no delivery (anyone may crank this)",
+      "Escrow refunded to the buyer."
+    ]
+  ]) {
+    group.command(verb).argument("<jobId>", "The Job object id (0x\u2026)").description(description).option("--key <path>", "Custom wallet path (default ~/.t2000/wallet.key)").option("--api <url>", `API base URL (default ${DEFAULT_API_BASE5})`).action(async (jobId, opts) => {
+      try {
+        const { digest } = await sponsoredJobVerb({
+          base: opts.api ?? DEFAULT_API_BASE5,
+          keyPath: opts.key,
+          action: verb,
+          params: { jobId }
+        });
+        if (isJsonMode()) {
+          printJson({ jobId, action: verb, digest });
+          return;
+        }
+        printBlank();
+        printSuccess(note);
+        if (digest) printKeyValue("Tx", digest);
+        printBlank();
+      } catch (error) {
+        handleError(error);
+      }
+    });
+  }
+  group.command("watch").argument("<jobId>", "The Job object id (0x\u2026)").description("Poll the job \u2014 state, timers, and what YOU can do right now").option("--interval <seconds>", "Poll interval", "15").option("--once", "Print the current state and exit").option("--key <path>", "Custom wallet path (default ~/.t2000/wallet.key)").action(async (jobId, opts) => {
+    try {
+      const agent = await withAgent({ keyPath: opts.key });
+      const me = agent.address();
+      const client = getSuiClient();
+      const intervalMs = Math.max(5, Number.parseInt(opts.interval, 10) || 15) * 1e3;
+      for (; ; ) {
+        const job = await getJob(client, jobId);
+        const actions = jobActionsFor(job, me);
+        const terminal = job.state === "released" || job.state === "refunded" || job.state === "rejected";
+        if (isJsonMode()) {
+          printJson({ job, yourActions: actions, terminal });
+        } else {
+          printBlank();
+          printJob(job, me);
+          if (actions.length > 0) {
+            printInfo(`You can now: ${actions.map((a) => `t2 job ${a} ${truncateAddress(jobId)}`).join("  \xB7  ")}`);
+          } else if (!terminal) {
+            printInfo("Nothing for you to do yet \u2014 waiting on the counterparty / clock.");
+          }
+        }
+        if (terminal || opts.once || isJsonMode()) return;
+        await new Promise((r) => setTimeout(r, intervalMs));
+      }
+    } catch (error) {
+      handleError(error);
+    }
+  });
+}
+
 // src/program.ts
 var require3 = createRequire2(import.meta.url);
 var { version: CLI_VERSION2 } = require3("../package.json");
@@ -24459,6 +24788,8 @@ Examples:
   $ t2 connect t2code --key sk-...     Point a coding tool at Private Inference
   $ t2 pay <url> --estimate            Preview an x402 service's price + input schema (no payment)
   $ t2 services search "image"         Discover x402 services in the gateway catalog
+  $ t2 check <url>                     Validate your paid API against the listing gates (add --list to sell it)
+  $ t2 job create 5 0xSELLER --spec brief.md --deadline 24h   Escrow USDC for deliverable work (A2A)
   $ t2 agents                          Look up the agent directory (agents.t2000.ai)
   $ t2 limit set --daily 100           Change the daily spend cap (default $100/day)
   $ t2 mcp install                     Connect Claude / Cursor / Windsurf
@@ -24481,6 +24812,8 @@ Examples:
   registerSkills(program3);
   registerAgent(program3);
   registerAgents(program3);
+  registerCheck(program3);
+  registerJob(program3);
   return program3;
 }