@lucid-agents/taskmarket 1.8.0 → 1.10.0

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 };
 
 // src/index.ts
-import { Command as Command67 } from "commander";
+import { Command as Command68 } from "commander";
 import { createRequire } from "module";
 
 // src/commands/init.ts
@@ -4499,6 +4499,57 @@ var TaskInboxResponseSchema = external_exports.object({
   // than a separate notification-center feature.
   invitedPrivateTasks: external_exports.array(TaskResponseSchema).optional().default([])
 });
+var TaskActionIntent = external_exports.enum([
+  "review_work",
+  "select_worker",
+  "submit_work",
+  "settle_expired",
+  "evaluate_work",
+  "appeal_verdict",
+  "resolve_dispute",
+  "finalize_verdict",
+  "rate_workers",
+  "select_auction_winner"
+]);
+var TaskActionPriority = external_exports.enum(["urgent", "required", "follow_up"]);
+var TaskActionProgressSchema = external_exports.object({
+  completed: external_exports.number().int().nonnegative(),
+  total: external_exports.number().int().positive()
+}).refine(({ completed, total }) => completed <= total, {
+  message: "Completed progress cannot exceed the target total",
+  path: ["completed"]
+});
+var TaskActionQueueItemSchema = external_exports.object({
+  id: external_exports.string(),
+  task: TaskResponseSchema,
+  role: PendingActionSchema.shape.role,
+  intent: TaskActionIntent,
+  actions: PendingActionSchema.array().min(1),
+  priority: TaskActionPriority,
+  dueAt: external_exports.string().nullable(),
+  progress: TaskActionProgressSchema.nullable().optional()
+});
+var TaskActionWaitingReason = external_exports.enum([
+  "waiting_for_submissions",
+  "waiting_for_worker",
+  "waiting_for_review",
+  "waiting_for_evaluator",
+  "waiting_for_appeal_window",
+  "waiting_for_settlement"
+]);
+var TaskActionWaitingItemSchema = external_exports.object({
+  id: external_exports.string(),
+  task: TaskResponseSchema,
+  role: PendingActionSchema.shape.role,
+  reason: TaskActionWaitingReason,
+  dueAt: external_exports.string().nullable()
+});
+var TaskActionQueueResponseSchema = external_exports.object({
+  items: TaskActionQueueItemSchema.array(),
+  total: external_exports.number().int().nonnegative(),
+  urgentTotal: external_exports.number().int().nonnegative(),
+  waiting: TaskActionWaitingItemSchema.array()
+});
 var TaskDetailResponseSchema = TaskResponseSchema.extend({
   pendingActions: PendingActionSchema.array(),
   awards: TaskAwardSchema.array().optional(),
@@ -4740,6 +4791,20 @@ var HealthResponseSchema = external_exports.object({
   status: external_exports.literal("ok"),
   timestamp: external_exports.string(),
   environment: external_exports.string(),
+  /**
+   * The commit this process was built from, when the deploy stamped one.
+   *
+   * Reported so a deploy can prove it actually replaced what was running. The production
+   * deploy workflow uploads with `railway up` and previously did so with `--detach`, which
+   * returns as soon as the upload is accepted -- so the job went green whether the build
+   * succeeded, failed, or never started, and a failed build left the previous version
+   * serving with nothing to say so. A health check cannot distinguish that either: the old
+   * version answers `ok` perfectly happily.
+   *
+   * Absent rather than a placeholder when unstamped, so a local or unstamped process cannot
+   * be mistaken for a verified one.
+   */
+  commitSha: external_exports.string().optional(),
   /**
    * The submission limits this process is actually enforcing, after any environment
    * override. Reported because a limit a caller cannot observe is a limit a test can only
@@ -8529,9 +8594,24 @@ var inboxCommand = new Command43("inbox").description("Show tasks you created an
   printResult({ ...taskResult, pendingBids });
 });
 
-// src/commands/deposit.ts
+// src/commands/actions.ts
 import { Command as Command44 } from "commander";
-var depositCommand = new Command44("deposit").description("Show wallet address and network info for funding").action(async () => {
+var actionsCommand = new Command44("actions").description("Show lifecycle actions awaiting you, grouped and prioritized by the server").action(async () => {
+  const auth = await signReadAuth();
+  if (!auth) {
+    printError("No keystore found. Run `taskmarket init` first.");
+    return;
+  }
+  const params = new URLSearchParams({ address: auth.walletAddress });
+  const queue = await apiGet(`/api/agents/action-queue?${params.toString()}`, {
+    headers: auth.headers
+  });
+  printResult(queue);
+});
+
+// src/commands/deposit.ts
+import { Command as Command45 } from "commander";
+var depositCommand = new Command45("deposit").description("Show wallet address and network info for funding").action(async () => {
   let address;
   try {
     address = await getWalletAddress();
@@ -8558,11 +8638,11 @@ var depositCommand = new Command44("deposit").description("Show wallet address a
 });
 
 // src/commands/wallet/index.ts
-import { Command as Command50 } from "commander";
+import { Command as Command51 } from "commander";
 
 // src/commands/wallet/balance.ts
-import { Command as Command45 } from "commander";
-var walletBalanceCommand = new Command45("balance").description("Show USDC balance").option("--address <addr>", "Address to check (defaults to own wallet)").action(async (opts) => {
+import { Command as Command46 } from "commander";
+var walletBalanceCommand = new Command46("balance").description("Show USDC balance").option("--address <addr>", "Address to check (defaults to own wallet)").action(async (opts) => {
   let address = opts.address;
   if (!address) {
     const keystore = await loadKeystore();
@@ -8573,7 +8653,7 @@ var walletBalanceCommand = new Command45("balance").description("Show USDC balan
 });
 
 // src/commands/wallet/import.ts
-import { Command as Command46 } from "commander";
+import { Command as Command47 } from "commander";
 import { createInterface as createInterface2 } from "readline";
 import { privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
 function normalizePrivateKey(raw) {
@@ -8608,7 +8688,7 @@ function promptHiddenInput(prompt) {
     });
   });
 }
-var walletImportCommand = new Command46("import").description("Import an existing private key as the agent wallet").option("--key <privateKey>", "Private key to import (64 hex chars, with or without 0x prefix)").option(
+var walletImportCommand = new Command47("import").description("Import an existing private key as the agent wallet").option("--key <privateKey>", "Private key to import (64 hex chars, with or without 0x prefix)").option(
   "--yes",
   "Confirm legal acceptance non-interactively after reviewing every current policy"
 ).action(async (opts) => {
@@ -8687,11 +8767,11 @@ var walletImportCommand = new Command46("import").description("Import an existin
 });
 
 // src/commands/wallet/set-withdrawal-address.ts
-import { Command as Command47 } from "commander";
+import { Command as Command48 } from "commander";
 function isValidAddress(addr) {
   return /^0x[a-fA-F0-9]{40}$/.test(addr);
 }
-var setWithdrawalAddressCommand = new Command47("set-withdrawal-address").description("Set a withdrawal address for USDC withdrawals (one-time, free)").argument("<address>", "Ethereum address to receive withdrawals").action(async (address) => {
+var setWithdrawalAddressCommand = new Command48("set-withdrawal-address").description("Set a withdrawal address for USDC withdrawals (one-time, free)").argument("<address>", "Ethereum address to receive withdrawals").action(async (address) => {
   if (!isValidAddress(address)) {
     printError("Invalid Ethereum address: must be 0x followed by 40 hex characters");
     return;
@@ -8718,8 +8798,8 @@ var setWithdrawalAddressCommand = new Command47("set-withdrawal-address").descri
 });
 
 // src/commands/wallet/publish-key.ts
-import { Command as Command48 } from "commander";
-var publishKeyCommand = new Command48("publish-key").description("Publish your secp256k1 public key so others can encrypt files for you").action(async () => {
+import { Command as Command49 } from "commander";
+var publishKeyCommand = new Command49("publish-key").description("Publish your secp256k1 public key so others can encrypt files for you").action(async () => {
   let keystore;
   try {
     keystore = await loadKeystore();
@@ -8739,13 +8819,13 @@ var publishKeyCommand = new Command48("publish-key").description("Publish your s
 });
 
 // src/commands/wallet/withdraw-dreams.ts
-import { Command as Command49 } from "commander";
+import { Command as Command50 } from "commander";
 import { toHex as toHex2 } from "viem";
 var AUTHORIZATION_VALIDITY_SECONDS = 300;
 function isValidAddress2(addr) {
   return /^0x[a-fA-F0-9]{40}$/.test(addr);
 }
-var withdrawDreamsCommand = new Command49("withdraw-dreams").description("Withdraw accumulated DREAMS rewards to the withdrawal address").option("--destination <addr>", "Destination address (defaults to registered withdrawal address)").action(async (opts) => {
+var withdrawDreamsCommand = new Command50("withdraw-dreams").description("Withdraw accumulated DREAMS rewards to the withdrawal address").option("--destination <addr>", "Destination address (defaults to registered withdrawal address)").action(async (opts) => {
   let keystore;
   try {
     keystore = await loadKeystore();
@@ -8799,7 +8879,7 @@ var withdrawDreamsCommand = new Command49("withdraw-dreams").description("Withdr
 });
 
 // src/commands/wallet/index.ts
-var walletCommand = new Command50("wallet").description("Wallet management commands");
+var walletCommand = new Command51("wallet").description("Wallet management commands");
 walletCommand.addCommand(walletBalanceCommand);
 walletCommand.addCommand(walletImportCommand);
 walletCommand.addCommand(setWithdrawalAddressCommand);
@@ -8807,7 +8887,7 @@ walletCommand.addCommand(publishKeyCommand);
 walletCommand.addCommand(withdrawDreamsCommand);
 
 // src/commands/withdraw.ts
-import { Command as Command51 } from "commander";
+import { Command as Command52 } from "commander";
 import { toHex as toHex3 } from "viem";
 var USDC_TYPES = {
   TransferWithAuthorization: [
@@ -8819,7 +8899,7 @@ var USDC_TYPES = {
     { name: "nonce", type: "bytes32" }
   ]
 };
-var withdrawCommand = new Command51("withdraw").description("Withdraw USDC to the registered withdrawal address").argument("<amount>", "Amount in USDC (e.g. 5 for 5 USDC)").action(async (amount) => {
+var withdrawCommand = new Command52("withdraw").description("Withdraw USDC to the registered withdrawal address").argument("<amount>", "Amount in USDC (e.g. 5 for 5 USDC)").action(async (amount) => {
   const parsed = parseFloat(amount);
   if (isNaN(parsed) || parsed <= 0) {
     printError("Invalid amount: must be a positive number (e.g. 5 for 5 USDC)");
@@ -8878,9 +8958,9 @@ var withdrawCommand = new Command51("withdraw").description("Withdraw USDC to th
 });
 
 // src/commands/encrypt.ts
-import { Command as Command52 } from "commander";
+import { Command as Command53 } from "commander";
 import { promises as fs3 } from "fs";
-var encryptCommand = new Command52("encrypt").description("Encrypt a file with ECIES using wallet keys").argument("<file>", "Path to the file to encrypt").option("--recipient <address>", "Recipient wallet address (default: self)").option("--output <path>", "Output path (default: <file>.enc)").action(async (file, opts) => {
+var encryptCommand = new Command53("encrypt").description("Encrypt a file with ECIES using wallet keys").argument("<file>", "Path to the file to encrypt").option("--recipient <address>", "Recipient wallet address (default: self)").option("--output <path>", "Output path (default: <file>.enc)").action(async (file, opts) => {
   let plaintext;
   try {
     plaintext = await fs3.readFile(file);
@@ -8928,9 +9008,9 @@ var encryptCommand = new Command52("encrypt").description("Encrypt a file with E
 });
 
 // src/commands/decrypt.ts
-import { Command as Command53 } from "commander";
+import { Command as Command54 } from "commander";
 import { promises as fs4 } from "fs";
-var decryptCommand = new Command53("decrypt").description("Decrypt a file using your wallet key").argument("<file>", "Path to the encrypted file").option("--output <path>", "Output path (default: strips .enc, otherwise appends .dec)").action(async (file, opts) => {
+var decryptCommand = new Command54("decrypt").description("Decrypt a file using your wallet key").argument("<file>", "Path to the encrypted file").option("--output <path>", "Output path (default: strips .enc, otherwise appends .dec)").action(async (file, opts) => {
   let ciphertext;
   try {
     ciphertext = await fs4.readFile(file);
@@ -8970,7 +9050,7 @@ var decryptCommand = new Command53("decrypt").description("Decrypt a file using
 });
 
 // src/commands/xmtp.ts
-import { Command as Command54 } from "commander";
+import { Command as Command55 } from "commander";
 
 // src/lib/xmtp-client.ts
 import os3 from "os";
@@ -9734,7 +9814,7 @@ function getDefaultQueryTimeoutMs() {
   }
   return Math.floor(parsed);
 }
-var xmtpCommand = new Command54("xmtp").description("Manage XMTP messaging for this agent");
+var xmtpCommand = new Command55("xmtp").description("Manage XMTP messaging for this agent");
 xmtpCommand.command("init").description("Initialize XMTP client and register installation metadata with backend").action(async () => {
   const keystore = await loadKeystore();
   const client = await createXmtpClient({
@@ -9971,7 +10051,7 @@ xmtpCommand.command("purge").description("Revoke stale XMTP installations that h
 });
 
 // src/commands/daemon.ts
-import { Command as Command55 } from "commander";
+import { Command as Command56 } from "commander";
 function diffTaskStatuses(prev, next) {
   const changes = [];
   for (const [taskId, newStatus] of next) {
@@ -9999,7 +10079,7 @@ function sleepOrAbort(ms, signal) {
   });
 }
 var MAX_SEEN_TASK_IDS = 2e3;
-var daemonCommand = new Command55("daemon").description("Long-running agent daemon: XMTP stream, heartbeats, and task polling").option("--heartbeat-interval <ms>", "Heartbeat interval in milliseconds", "1800000").option("--inbox-interval <ms>", "Inbox poll interval in milliseconds", "15000").option("--task-interval <ms>", "New task poll interval in milliseconds", "15000").option(
+var daemonCommand = new Command56("daemon").description("Long-running agent daemon: XMTP stream, heartbeats, and task polling").option("--heartbeat-interval <ms>", "Heartbeat interval in milliseconds", "1800000").option("--inbox-interval <ms>", "Inbox poll interval in milliseconds", "15000").option("--task-interval <ms>", "New task poll interval in milliseconds", "15000").option(
   "--auction-poll-interval <ms>",
   "Poll interval for clock-based auction tasks (dutch/reverse_dutch) in milliseconds",
   "15000"
@@ -10281,7 +10361,16 @@ var daemonCommand = new Command55("daemon").description("Long-running agent daem
                     fromAddress: email.fromAddress,
                     subject: email.subject,
                     bodyText: email.bodyText,
-                    receivedAt: email.receivedAt
+                    receivedAt: email.receivedAt,
+                    // Carried onto the event, not left in the API response. This stdout stream
+                    // is the documented machine-readable interface an agent framework consumes,
+                    // so it is the last boundary where anything can say what this content is:
+                    // text written by an unauthenticated sender, whose `fromAddress` is a claim
+                    // rather than an identity unless senderVerification says 'pass'. Defaulted
+                    // rather than omitted so a consumer never has to distinguish "old backend"
+                    // from "verified".
+                    source: email.source ?? "external_email",
+                    senderVerification: email.senderVerification ?? "unverified"
                   });
                   try {
                     await apiPost("/api/emails/mark-read", {
@@ -10323,11 +10412,11 @@ var daemonCommand = new Command55("daemon").description("Long-running agent daem
 );
 
 // src/commands/email/index.ts
-import { Command as Command64 } from "commander";
+import { Command as Command65 } from "commander";
 
 // src/commands/email/register.ts
-import { Command as Command56 } from "commander";
-var registerCommand = new Command56("register").description("Register an email address for this agent").requiredOption("--username <name>", "Desired username (e.g. myagent)").action(async (opts) => {
+import { Command as Command57 } from "commander";
+var registerCommand = new Command57("register").description("Register an email address for this agent").requiredOption("--username <name>", "Desired username (e.g. myagent)").action(async (opts) => {
   const check = await apiGet(
     `/api/emails/check-username?username=${encodeURIComponent(opts.username)}`
   );
@@ -10348,8 +10437,8 @@ var registerCommand = new Command56("register").description("Register an email a
 });
 
 // src/commands/email/inbox.ts
-import { Command as Command57 } from "commander";
-var inboxCommand2 = new Command57("inbox").description("List emails in your inbox").option("--limit <n>", "Number of emails to return", "20").option("--unread", "Show only unread emails").action(async (opts) => {
+import { Command as Command58 } from "commander";
+var inboxCommand2 = new Command58("inbox").description("List emails in your inbox").option("--limit <n>", "Number of emails to return", "20").option("--unread", "Show only unread emails").action(async (opts) => {
   const keystore = await loadKeystore();
   const params = new URLSearchParams({
     deviceId: keystore.deviceId,
@@ -10364,8 +10453,8 @@ var inboxCommand2 = new Command57("inbox").description("List emails in your inbo
 });
 
 // src/commands/email/read.ts
-import { Command as Command58 } from "commander";
-var readCommand = new Command58("read").description("Read an email by ID (marks it as read)").argument("<id>", "Email ID").action(async (id) => {
+import { Command as Command59 } from "commander";
+var readCommand = new Command59("read").description("Read an email by ID (marks it as read)").argument("<id>", "Email ID").action(async (id) => {
   const keystore = await loadKeystore();
   const params = new URLSearchParams({
     deviceId: keystore.deviceId,
@@ -10377,8 +10466,8 @@ var readCommand = new Command58("read").description("Read an email by ID (marks
 });
 
 // src/commands/email/send.ts
-import { Command as Command59 } from "commander";
-var sendCommand = new Command59("send").description("Send an email").requiredOption("--to <address>", "Recipient email address").requiredOption("--subject <subject>", "Email subject").requiredOption("--body <text>", "Email body text").action(async (opts) => {
+import { Command as Command60 } from "commander";
+var sendCommand = new Command60("send").description("Send an email").requiredOption("--to <address>", "Recipient email address").requiredOption("--subject <subject>", "Email subject").requiredOption("--body <text>", "Email body text").action(async (opts) => {
   const keystore = await loadKeystore();
   const { data: result, idempotencyKey } = await apiPost("/api/emails/send", {
     deviceId: keystore.deviceId,
@@ -10391,8 +10480,8 @@ var sendCommand = new Command59("send").description("Send an email").requiredOpt
 });
 
 // src/commands/email/reply.ts
-import { Command as Command60 } from "commander";
-var replyCommand = new Command60("reply").description("Reply to an email").argument("<id>", "Email ID to reply to").requiredOption("--body <text>", "Reply body text").action(async (id, opts) => {
+import { Command as Command61 } from "commander";
+var replyCommand = new Command61("reply").description("Reply to an email").argument("<id>", "Email ID to reply to").requiredOption("--body <text>", "Reply body text").action(async (id, opts) => {
   const keystore = await loadKeystore();
   const params = new URLSearchParams({
     deviceId: keystore.deviceId,
@@ -10414,8 +10503,8 @@ var replyCommand = new Command60("reply").description("Reply to an email").argum
 });
 
 // src/commands/email/delete.ts
-import { Command as Command61 } from "commander";
-var deleteCommand = new Command61("delete").description("Delete an email by ID").argument("<id>", "Email ID").action(async (id) => {
+import { Command as Command62 } from "commander";
+var deleteCommand = new Command62("delete").description("Delete an email by ID").argument("<id>", "Email ID").action(async (id) => {
   const keystore = await loadKeystore();
   const { data: result, idempotencyKey } = await apiPost(
     "/api/emails/delete",
@@ -10429,15 +10518,15 @@ var deleteCommand = new Command61("delete").description("Delete an email by ID")
 });
 
 // src/commands/email/address.ts
-import { Command as Command62 } from "commander";
-var addressCommand2 = new Command62("address").description("Show your registered email address").action(async () => {
+import { Command as Command63 } from "commander";
+var addressCommand2 = new Command63("address").description("Show your registered email address").action(async () => {
   const keystore = await loadKeystore();
   const result = await apiGet(`/api/agents/stats?address=${keystore.walletAddress}`);
   printResult({ emailAddress: result.emailAddress ?? null });
 });
 
 // src/commands/email/mark-read.ts
-import { Command as Command63 } from "commander";
+import { Command as Command64 } from "commander";
 async function setReadStatus(id, read) {
   const keystore = await loadKeystore();
   const { data: result, idempotencyKey } = await apiPost(
@@ -10451,12 +10540,12 @@ async function setReadStatus(id, read) {
   );
   printResult({ id: result.id, isRead: result.isRead }, { idempotencyKey });
 }
-var markReadCommand = new Command63("mark-read").description("Mark an email as read or unread").argument("<id>", "Email ID").option("--unread", "Mark as unread instead of read").action(async (id, opts) => {
+var markReadCommand = new Command64("mark-read").description("Mark an email as read or unread").argument("<id>", "Email ID").option("--unread", "Mark as unread instead of read").action(async (id, opts) => {
   await setReadStatus(id, !opts.unread);
 });
 
 // src/commands/email/index.ts
-var emailCommand = new Command64("email").description("Email management commands");
+var emailCommand = new Command65("email").description("Email management commands");
 emailCommand.addCommand(registerCommand);
 emailCommand.addCommand(inboxCommand2);
 emailCommand.addCommand(readCommand);
@@ -10467,11 +10556,11 @@ emailCommand.addCommand(addressCommand2);
 emailCommand.addCommand(markReadCommand);
 
 // src/commands/requester/index.ts
-import { Command as Command66 } from "commander";
+import { Command as Command67 } from "commander";
 
 // src/commands/requester/stats.ts
-import { Command as Command65 } from "commander";
-var requesterStatsCmd = new Command65("stats").description("Get requester reputation stats for an address").argument("<address>", "Wallet address of the requester").action(async (address) => {
+import { Command as Command66 } from "commander";
+var requesterStatsCmd = new Command66("stats").description("Get requester reputation stats for an address").argument("<address>", "Wallet address of the requester").action(async (address) => {
   if (!/^0x[0-9a-fA-F]{40}$/.test(address)) {
     printError("Address must be a 0x-prefixed 20-byte hex string");
     return;
@@ -10485,12 +10574,12 @@ var requesterStatsCmd = new Command65("stats").description("Get requester reputa
 });
 
 // src/commands/requester/index.ts
-var requesterCmd = new Command66("requester").description("Requester reputation commands").addCommand(requesterStatsCmd);
+var requesterCmd = new Command67("requester").description("Requester reputation commands").addCommand(requesterStatsCmd);
 
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
-var program = new Command67();
+var program = new Command68();
 program.name("taskmarket").description("Taskmarket CLI for AI agents").version(version);
 program.addCommand(initCommand);
 program.addCommand(walletCommand);
@@ -10500,6 +10589,7 @@ program.addCommand(statsCommand);
 program.addCommand(taskCommand);
 program.addCommand(agentsCommand);
 program.addCommand(inboxCommand);
+program.addCommand(actionsCommand);
 program.addCommand(depositCommand);
 program.addCommand(withdrawCommand);
 program.addCommand(encryptCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucid-agents/taskmarket",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "type": "module",
   "bin": {
     "taskmarket": "./dist/index.js"
@@ -17,8 +17,8 @@
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",
     "vitest": "^2.0.0",
-    "@taskmarket/prettier-config": "0.0.0",
     "@taskmarket/eslint-config": "0.0.0",
+    "@taskmarket/prettier-config": "0.0.0",
     "@taskmarket/shared": "2.0.0"
   },
   "files": [