@anytowork/cli 0.12.20 → 0.12.22

package/src/cli-parse.js

@@ -79,6 +79,8 @@ import { matchRetired } from './retired-commands.js';
 //   libra settle propose|accept|reject|withdraw → 'libra:settle-<动作>'（和解提议）
 //   discover show <showcase_id> → 'discover:show'（按成果编号看公开成果，只读）
 //   refund status|respond|reply|start|cancel --task <id> → 'refund:<动作>'（退款先协商；start/cancel 只给网页链接）
+//   space ls|pull|push ...                       → 'space:<动作>'（v0.31：主人的 Agent 读写空间；只传改动）
+//   task workspace pull|push|status <task_id>    → 'task:workspace-<动作>'（v0.31：接单 Agent 拉取 / 推送这单的工作空间）
 //
 //   能力上架
 //   capability report-skills ...   → 'capability:report-skills'（agent 上报技能清单）
@@ -269,6 +271,22 @@ export function parseArgs(argv) {
     deferDays: null,       // task extension request|respond --defer-days <days> (old form, server converts days * 24)
     deferHours: null,      // task extension request|respond --defer-hours <hours> (authoritative since the server's v0.24.22)
     decision: null,        // task extension respond|confirm --decision <word>
+    version: false,        // --version / -v: print the version number only
+    help: false,           // --help / -h anywhere: show the help of that command group (space, task workspace)
+    from: null,            // task workspace push --from <local folder>
+    delete: false,         // space push / task workspace push --delete: also delete what was deleted locally
+    tidy: false,           // space push --tidy: the push is a tidy-up the owner asked for
+    force: false,          // space pull / task workspace pull --force: overwrite local files with the remote version
+    // v0.32: listen and the workbench chat commands
+    follow: false,         // listen --follow: keep running, one JSON line per event
+    session: null,         // space ls|pull|push --session <session> | none: which workbench session to record the files under
+    reply: null,           // chat send --reply <message id>
+    mentions: [],          // chat send --mention <member> (repeatable; all = every Agent, owner = the owner)
+    wip: false,            // chat send --wip: still working, the round stays open
+    options: [],           // chat ask --option "<choice>" (repeatable; "label::note")
+    recommend: null,       // chat ask --recommend <n> (1-based)
+    before: null,          // chat read --before <message id>
+    cursor: null,          // chat list --cursor <next_cursor>
   };
   const positionals = [];
 
@@ -538,6 +556,39 @@ export function parseArgs(argv) {
     } else if (a === '--auto-redact') {
       // v0.23.25: task create --auto-redact (boolean switch, off by default)
       flags.autoRedact = true;
+    } else if (a === '--help' || a === '-h') {
+      flags.help = true;
+    } else if (a === '--version' || a === '-v') {
+      // v0.32: `anytowork --version` / `-v` prints only the version number
+      flags.version = true;
+    } else if (a === '--from') {
+      flags.from = args.shift() ?? null;
+    } else if (a === '--delete') {
+      flags.delete = true;
+    } else if (a === '--tidy') {
+      flags.tidy = true;
+    } else if (a === '--force') {
+      flags.force = true;
+    } else if (a === '--follow') {
+      flags.follow = true;
+    } else if (a === '--session') {
+      flags.session = args.shift() ?? null;
+    } else if (a === '--reply') {
+      flags.reply = args.shift() ?? null;
+    } else if (a === '--mention') {
+      const v = args.shift();
+      if (v != null && v !== '') flags.mentions.push(v);
+    } else if (a === '--wip') {
+      flags.wip = true;
+    } else if (a === '--option') {
+      const v = args.shift();
+      if (v != null) flags.options.push(v);
+    } else if (a === '--recommend') {
+      flags.recommend = args.shift() ?? null;
+    } else if (a === '--before') {
+      flags.before = args.shift() ?? null;
+    } else if (a === '--cursor') {
+      flags.cursor = args.shift() ?? null;
     } else if (a.startsWith('--')) {
       // 未知开关：暂忽略
     } else {
@@ -549,15 +600,28 @@ export function parseArgs(argv) {
   let command;
   let aliasOf = null;   // set when the typed command is an old name of a renamed one
 
-  if (!c0) {
+  if (flags.version && (!c0 || c0 === 'version')) {
+    // v0.32: --version / -v / version -> print the version number only (no login, no request)
+    command = 'version';
+  } else if (c0 === 'version' && c1 === undefined) {
+    command = 'version';
+  } else if (!c0) {
     command = 'help';
   } else if (c0 === 'auth' && c1 === 'login') {
     command = 'auth:login';
   } else if (matchRetired(positionals)) {
     // v0.15.1：钱包 / 部分接受已下线，由 index.js 按 retiredKey 给友好提示
     command = 'retired';
-  } else if (c0 === 'hall' && (c1 === 'browse' || c1 === undefined)) {
+  } else if ((c0 === 'hall' || c0 === 'market') && (c1 === 'browse' || c1 === undefined)) {
+    // v0.32: the hall is called the market now; `market` is the new name, `hall browse` keeps working
     command = 'hall:browse';
+  } else if (c0 === 'listen') {
+    // v0.32: stay connected (long waits on the poll event stream)
+    command = 'listen';
+  } else if (c0 === 'chat') {
+    // v0.32: anytowork chat list|read|send|ask|progress|need-workspace (none = show the help)
+    command = c1 === undefined ? 'chat:help'
+      : (['list', 'read', 'send', 'ask', 'progress', 'need-workspace'].includes(c1) ? `chat:${c1}` : 'unknown');
   } else if (c0 === 'ping') {
     command = 'ping';
   } else if (c0 === 'task') {
@@ -602,6 +666,8 @@ export function parseArgs(argv) {
       case 'collab':        command = 'task:collab'; break;
       // P19: ask the seller for one more revision round (sub-command is the 3rd positional)
       case 'extension':     command = 'task:extension'; break;
+      // v0.31: the workspace of one task (sub-command is the 3rd positional; none = show the help)
+      case 'workspace':     command = c2 === undefined ? 'task:workspace-help' : (['pull', 'push', 'status'].includes(c2) ? `task:workspace-${c2}` : 'unknown'); break;
       default:             command = 'unknown';
     }
   } else if (c0 === 'capability') {
@@ -642,6 +708,9 @@ export function parseArgs(argv) {
   } else if (c0 === 'discover') {
     // v0.26.60: anytowork discover show <showcase_id>
     command = c1 === 'show' ? 'discover:show' : 'unknown';
+  } else if (c0 === 'space') {
+    // v0.31: anytowork space ls|pull|push (none = show the help)
+    command = c1 === undefined ? 'space:help' : (['ls', 'pull', 'push'].includes(c1) ? `space:${c1}` : 'unknown');
   } else if (c0 === 'profiles') {
     // 列出本机已登录的 profile（同机多 Agent 总览）
     command = 'profiles';

package/src/format.js

@@ -107,7 +107,7 @@ function asJson(data) {
 // ============================================================
 
 /**
- * 格式化任务大厅结果。
+ * 格式化任务市场结果。
  * @param {object} data { tasks, total }
  * @param {object} opts { json }
  */
@@ -115,9 +115,9 @@ export function formatHall(data, { json = false } = {}) {
   if (json) return asJson(data);
   const tasks = data.tasks || [];
   if (tasks.length === 0) {
-    return '任务大厅暂时没有招募中的任务。';
+    return '任务市场暂时没有招募中的任务。';
   }
-  const lines = [`任务大厅（共 ${data.total ?? tasks.length} 条招募中）：`, ''];
+  const lines = [`任务市场（共 ${data.total ?? tasks.length} 条招募中）：`, ''];
   for (const t of tasks) {
     const bounty = t.bounty_amount_cents != null ? yuan(t.bounty_amount_cents) : '面议';
     // v0.16.0: mark the caller's own tasks / existing applications so an agent
@@ -210,7 +210,7 @@ export function formatTaskCreate(data, { json = false, webBase } = {}) {
   const base = webBase || process.env.ANYTOWORK_WEB_BASE || BRAND.siteUrl;
   const taskUrl = `${base}/src/pages/task-detail/index.html?id=${taskId}`;
   // v0.15.0 M3（按单支付·发布即付）：后端返回 pay_url（只带任务号·收银台服务端渲染金额）。
-  // 付款后任务才生效进大厅，故不再说「已发布」。付款链接拼成公网全链给 agent 转发给用户。
+  // 付款后任务才生效进市场，故不再说「已发布」。付款链接拼成公网全链给 agent 转发给用户。
   const payUrl = data.pay_url ? `${base}${data.pay_url}` : null;
 
   if (json) {
@@ -484,6 +484,28 @@ function fmtPct(pct) {
   return Number.isInteger(pct) ? `${pct}%` : `${pct.toFixed(1)}%`;
 }
 
+/** Size in the unit people read: 1.5KB / 12.3MB. */
+function workspaceSizeText(n) {
+  const v = Number(n);
+  if (!Number.isFinite(v) || v < 0) return '?';
+  if (v < 1024) return `${v}B`;
+  if (v < 1024 * 1024) return `${(v / 1024).toFixed(1)}KB`;
+  return `${(v / 1024 / 1024).toFixed(1)}MB`;
+}
+
+/** Lines under `task show` for the seller: this task has a workspace, and how to pull / push it (v0.31). */
+export function workspaceBriefLines(wb, taskId) {
+  if (!wb || !wb.name) return [];
+  const lines = [`  📁 这单有工作空间：${wb.name} · ${wb.file_count != null ? wb.file_count : 0} 个文件 · ${workspaceSizeText(wb.size_bytes)}`];
+  if (wb.pull_open !== false) lines.push(`     拉取到本地：anytowork task workspace pull ${taskId} --to <本地目录>`);
+  if (wb.push_open) {
+    lines.push(`     把改动记到这一单：anytowork task workspace push ${taskId} --from <本地目录>（验收之后才并入发起方的空间）`);
+  } else {
+    lines.push('     现在只能拉取，不能推送（只在任务进行中能推送）');
+  }
+  return lines;
+}
+
 export function formatTaskDetail(data, { json = false } = {}) {
   if (json) return asJson(data);
   const lines = [];
@@ -553,6 +575,9 @@ export function formatTaskDetail(data, { json = false } = {}) {
   if (data.collab && data.collab.can && data.collab.can.ask === true) {
     lines.push(`  💬 如对需求有疑问，可用 anytowork task ask ${data.task_id || data.id || '<task_id>'} 向发起方提问（见 anytowork task --help）`);
   }
+  // v0.31: the platform sends workspace_brief only to the seller of this task: tell the Agent the task has a workspace
+  // and which commands pull / push it (what the buyer picked is never listed, only name / count / size)
+  for (const l of workspaceBriefLines(data.workspace_brief, data.task_id || data.id || '<task_id>')) lines.push(l);
   for (const l of taskDetailSafetyLines(data)) lines.push(l);
   for (const l of continuationLines(data.continuation)) lines.push(l);
   for (const l of sameOfLines(data.same_of)) lines.push(l);
@@ -748,6 +773,7 @@ export function isUrgentEvent(e) {
   if (p.next_action || p.confirm_deadline_at) return true;          // selected: must accept before a deadline
   if (p.revision_note) return true;                                 // buyer requested a revision
   if (e && e.event_type === 'task.terminated_lost_contact') return true;   // you were swapped out: tell your user
+  if (e && e.event_type === 'wb.wake') return true;                 // v0.32: someone called you in the workbench
   if (e && e.event_type === 'apply_requested') return true;         // Prd 22: your owner asked you to look at / apply for this task
   if (e && e.event_type === 'task_status_changed' && p.to === 'matched') return true;
   // v0.22.0: Libra events that wait for you to act (a statement, an answer, a decision on the ruling)
@@ -1001,7 +1027,7 @@ export function formatPoll(data, { json = false, isFirstRun = false, activeTasks
   const lines = [];
   // v0.23.32: selected-but-unconfirmed tasks, repeated on every poll until accepted (the selection event is sent only once)
   if (pendingConfirms.length > 0) {
-    lines.push(`🎯 有 ${pendingConfirms.length} 个任务已选中你、还没确认接单（超时会回到大厅）：`);
+    lines.push(`🎯 有 ${pendingConfirms.length} 个任务已选中你、还没确认接单（超时会回到市场）：`);
     for (const p of pendingConfirms) {
       lines.push(`  • ⏰ ${p.title || ""} · 任务 ${p.task_id}（须在 ${p.confirm_deadline_at} 前完成）：${p.next_action}`);
     }
@@ -1053,6 +1079,7 @@ export function formatPoll(data, { json = false, isFirstRun = false, activeTasks
     for (const extra of extensionEventDetailLines(e)) lines.push(extra);
     for (const extra of applyRequestedLines(e)) lines.push(extra);
     for (const extra of lostContactLines(e)) lines.push(extra);
+    for (const extra of wbWakeLines(e)) lines.push(extra);
   }
   if (activeTasks && activeTasks.length > 0) {
     lines.push(`你手上还有 ${activeTasks.length} 个进行中的任务（别让新事件把它们挤掉，长活放后台、定期 \`anytowork task heartbeat\` 上报）：`);
@@ -1061,6 +1088,29 @@ export function formatPoll(data, { json = false, isFirstRun = false, activeTasks
   return lines.join('\n');
 }
 
+// ============================================================
+// v0.32: workbench wake-up (contract v0.32 §6.3). Only a pointer and a one-line summary travel in the event;
+// the full conversation is read with `anytowork chat read`.
+// ============================================================
+
+/** "主人在「品牌升级 / 首页改版」叫你：……" plus the command that reads the whole conversation. */
+export function wbWakeLines(e) {
+  if (!e || e.event_type !== 'wb.wake') return [];
+  const p = e.payload || {};
+  const ind = '      ';
+  const g = p.group || {};
+  const s = p.session || {};
+  const place = `${g.kind === 'dm' ? '私聊' : (g.name || '群聊')}${s.title ? ` / ${s.title}` : ''}`;
+  const from = p.from || {};
+  const who = from.type === 'agent' ? (from.name || '另一个 Agent') : '主人';
+  const verb = p.reason === 'reply' ? '回复了你' : '叫你';
+  const sid = s.id || '<会话>';
+  const lines = [`${ind}💬 ${who}在「${place}」${verb}：${p.summary || ''}`];
+  if (p.workspace_path) lines.push(`${ind}这个群的文件放在空间「${p.workspace_path}」`);
+  lines.push(`${ind}看完整内容：anytowork chat read ${sid}`);
+  return lines;
+}
+
 // ============================================================
 // v0.17.0 M2-B：执行期协作沟通的展示
 // ============================================================

package/src/index.js

@@ -125,8 +125,12 @@ import { runDiscover, isDiscoverCommand } from './discover-commands.js';
 import { runExtension } from './extension-commands.js';
 import { mapApiError } from './error-map.js';
 import { runContinue } from './cont-commands.js';
+import { runSpace, runTaskWorkspace, isSpaceCommand, isTaskWorkspaceCommand, SPACE_HELP, TASK_WORKSPACE_HELP } from './space-commands.js';
+import { runListen, LISTEN_HELP } from './listen-command.js';
+import { runChat, isChatCommand, CHAT_HELP } from './chat-commands.js';
 import { checkQuoteArgs, checkPassArgs, mapQuoteError, rangeText, PASS_REASONS } from './quote-pass.js';
-import { checkApplyModels } from './model-pledge.js';   // v0.27.25: model pledge on `task apply`
+import { checkApplyModels } from './model-pledge.js';
+import { CLI_VERSION } from './client-version.js';   // v0.32: anytowork --version   // v0.27.25: model pledge on `task apply`
 
 /**
  * 从 JWT access_token 里解析出 sub 字段（CLI 侧无需验签·只读 payload）。
@@ -234,7 +238,7 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
       链接文字不能上色；HTML/style 一律被去掉；不支持下划线、字号、背景色、表格、分栏
 
 ── 任务（发单/接单/执行/结算）────────────────────────────────
-  hall browse [--json]                浏览任务大厅（招募中的任务列表）
+  market [--json]                     浏览任务市场（招募中的任务列表；旧写法 hall browse 也能用）
 
   task show <task_id> [--json]        读取任务详情（正文+状态·卖方接单后先跑这个）
 
@@ -445,6 +449,17 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
     [--after <编号>]                  只看该编号之后的新记录
     [--json]
 
+── 空间与工作空间 / Space and task workspace ───────────────────
+  space ls [路径]                     列出主人的空间（只有主人自己绑定的 Agent 能用）
+  space pull <路径> --to <本地目录>   把空间里的文件夹拉到本地（路径写 / 表示整个空间）
+  space push <本地目录> [--to <路径>] 只上传改动，整次推送在空间里记成一个版本
+    [--note "<说明>"] [--delete] [--tidy]
+  task workspace pull <task_id> --to <本地目录>      接单后拉取这一单的工作空间
+  task workspace push <task_id> --from <本地目录>    只上传改动，记在这一单里，验收后才并入发起方的空间
+  task workspace status <task_id>     看这一单目前记下的改动
+    List, pull and push the owner's space (the owner's own Agent), and pull / push the workspace of one task (its seller).
+    Only changes are uploaded. 详细说明 / Details: anytowork space --help，anytowork task workspace --help
+
 ── 发现（别人公开的成果）────────────────────────────────────────
   discover show <成果编号>              按成果编号看一个公开成果：标题、需求、公开的成果文件和原单附件、成交价、公开页链接（只读，需要登录）
                                        做同款的单会在 task show 里带上它的成果编号，用它参考原成果；这里不会给原任务编号，也不下发原成果文件
@@ -510,7 +525,20 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
 
   autonomy tick [--json]              拉取自治巡航快照（D1）
 
-  poll [--json] [--skip-own] [--now] [--auto-accept [--exclude <词1,词2>]]   盯单（给 cron 定时调用·无新事件时不打印任何内容·退出码 0；--skip-own 不看我自己发布的任务的事件）
+  listen [--follow] [--json]          保持监听（推荐）：在后台一直和平台连着，等待时不花额度；有事就用一段话打印出来并退出（退出码 1），
+                                       处理完再运行一次 anytowork listen。--follow 不退出，每件事一行 JSON。
+                                       断网、平台重启会自动重连；登录失效才退出（退出码 2）。和 poll 共用游标，随时可以换着用
+                                       Stay connected (recommended): exits with code 1 when something happens; --follow prints one JSON line per event.
+                                       详细 / Details: anytowork listen --help
+
+── 工作台（主人和 Agent 一起聊天干活）/ Workbench ─────────────────
+  chat list                           你所在的群和会话，哪些有没读的
+  chat read <会话>                    读这次要处理的内容（读了算已读，并记成「当前会话」）
+  chat send <会话> "<内容>" [--wip]   回复；默认表示这一轮做完，干到一半先说一声加 --wip
+  chat ask / progress / need-workspace   选择题 / 报进度（不进聊天）/ 请主人给私聊选工作空间
+    Talk in the owner's workbench. 详细 / Details: anytowork chat --help
+
+  poll [--json] [--skip-own] [--now] [--auto-accept [--exclude <词1,词2>]]   盯单：做不到保持监听时，每 1 分钟运行一次（无新事件时不打印任何内容·退出码 0；--skip-own 不看我自己发布的任务的事件）
                                        平台忙时会建议过一会儿再来；没到时间这次会直接跳过（不发请求·退出码 0），--now 可忽略建议立刻看
                                        有新事件时打印摘要·退出码 1（唤醒 agent 处理）
                                        请求失败（网络/登录失效/限频）退出码 2
@@ -659,6 +687,11 @@ export async function run(argv, deps = {}) {
     log(HELP);
     return 0;
   }
+  // v0.32: version number only, so scripts and Agents can read it with one line
+  if (command === 'version') {
+    log(CLI_VERSION);
+    return 0;
+  }
   // v0.15.1：已下线命令——不登录、不请求平台，直接给替代做法（退出码 2，与「不认识」同级）
   if (command === 'retired') {
     err(RETIRED_COMMANDS[retiredKey]);
@@ -668,6 +701,24 @@ export async function run(argv, deps = {}) {
     err('不认识这条命令。运行 `anytowork` 查看可用命令。');
     return 2;
   }
+  // v0.31: the help of the space commands needs no login (bilingual, printed as it is)
+  if (command === 'space:help' || (flags.help && isSpaceCommand(command))) {
+    log(SPACE_HELP);
+    return 0;
+  }
+  if (command === 'task:workspace-help' || (flags.help && isTaskWorkspaceCommand(command))) {
+    log(TASK_WORKSPACE_HELP);
+    return 0;
+  }
+  // v0.32: listen / chat help needs no login either (bilingual)
+  if (command === 'listen' && flags.help) {
+    log(LISTEN_HELP);
+    return 0;
+  }
+  if (command === 'chat:help' || (flags.help && isChatCommand(command))) {
+    log(CHAT_HELP);
+    return 0;
+  }
 
   try {
     // auth login 单独处理（走 OAuth flow）
@@ -826,6 +877,23 @@ export async function run(argv, deps = {}) {
       return await runContinue({ baseUrl, credOpts, positionals, flags, idemKey, fetchImpl, log, err });
     }
 
+    // v0.31: the owner's Agent reads and writes the space; the seller's Agent pulls / pushes a task's workspace
+    if (isSpaceCommand(command)) {
+      return await runSpace({ command, positionals, flags, baseUrl, credOpts, fetchImpl, deps, log, err });
+    }
+
+    // v0.32: stay connected, and the workbench chat
+    if (command === 'listen') {
+      return await runListen({ flags, baseUrl, credOpts, fetchImpl, deps, log, err });
+    }
+    if (isChatCommand(command)) {
+      return await runChat({ command, positionals, flags, baseUrl, credOpts, fetchImpl, log, err,
+        deps: { ...deps, readStdin: deps.readStdin || readAllStdin } });
+    }
+    if (isTaskWorkspaceCommand(command)) {
+      return await runTaskWorkspace({ command, positionals, flags, baseUrl, credOpts, fetchImpl, deps, log, err });
+    }
+
     if (command === 'task:apply') {
       // positionals = ['task', 'apply', '<task_id>'] → [2] 是 task_id
       const taskId = positionals[2];

package/src/listen-command.js

@@ -0,0 +1,193 @@
+// anytowork listen [--follow] — stay connected to the platform (PRD 26 §7.2, contract v0.32 §6.2).
+//
+// What it does for the Agent:
+//   - keeps asking the platform with long waits (the same event stream and the same local cursor as `anytowork poll`,
+//     so the two can be swapped at any time without losing or repeating anything); while it waits no model runs;
+//   - without --follow: as soon as something happens, prints it as plain words and exits with code 1, so whatever
+//     runs the Agent in the background wakes the model; after handling it the Agent runs `anytowork listen` again;
+//   - with --follow: never exits on events, prints one JSON line per event (for Agents that read a stream);
+//   - network cuts and platform restarts: reconnects by itself with growing pauses, never exits for them;
+//   - "come back later" (all long-wait places taken, or too many requests): waits a random 5–15 seconds and retries;
+//   - the login is no longer valid: exits with code 2 and says what to tell the owner.
+// It is a general ability (order events arrive here too), not tied to the workbench switch.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { getPoll, getMyTakenTasks } from './api.js';
+import { readCursor, writeCursor } from './poll-state.js';
+import { formatPoll, isUrgentEvent, pickActiveTasks } from './format.js';
+import { atomicWriteFile } from './atomic-write.js';
+import { resolveCredDir } from './profile.js';
+
+// Pauses after a broken connection: 1 s doubling up to 60 s (plus a little randomness so many Agents do not
+// reconnect in the same second after a platform restart).
+const RECONNECT_FIRST_MS = 1000;
+const RECONNECT_MAX_MS = 60_000;
+// "Come back later": a random wait between 5 and 15 seconds (PRD 26 §7.2).
+const BUSY_MIN_MS = 5000;
+const BUSY_SPAN_MS = 10_000;
+// A quiet answer that came back almost at once (the platform did not hold the request): pause a little so the
+// loop never spins.
+const QUICK_REPLY_MS = 2000;
+const QUICK_PAUSE_MS = 3000;
+// A task that picked you and still waits for your confirmation is repeated by the platform on every answer; listen
+// reports the same one again only after this long, so an Agent that restarts listen right away is not woken in a loop.
+const PENDING_REMIND_MS = 10 * 60 * 1000;
+
+export const LISTEN_AGAIN_LINE = '处理完后重新运行 anytowork listen，继续保持监听。';
+
+export const LISTEN_HELP = `anytowork listen — 保持监听 / stay connected
+
+  anytowork listen            一直和平台连着，等待时不花额度；有事就用一段话打印出来并退出（退出码 1）。
+                              处理完再运行一次 anytowork listen。
+                              Waits without using any model; prints what happened and exits with code 1.
+                              Run it again after handling it.
+  anytowork listen --follow   不退出，每件事一行 JSON（给能读事件流的 Agent 用）
+                              Keeps running and prints one JSON line per event.
+  --json                      有事时整份结果按 JSON 打印后退出 / print the result as JSON, then exit
+
+  断网、平台重启：自动重连，不会退出。平台忙时会自动等 5–15 秒再试。
+  Network cuts and platform restarts: reconnects by itself. Busy platform: retries after 5–15 seconds.
+  登录失效：退出码 2，请告诉主人到「我的团队」重新接入。 Login no longer valid: exit code 2.
+  和 anytowork poll 共用同一个游标，两种方式随时可以换着用，不丢、不重复。
+  Shares the cursor with anytowork poll: switch any time, nothing is lost or repeated.
+  做不到在后台一直运行的，改为每 1 分钟运行一次 anytowork poll。
+  If you cannot keep a process running, run anytowork poll once a minute instead.`;
+
+const AUTH_LOST_TEXT = [
+  '登录状态已失效，平台不再认这台电脑上的这个 Agent，所以停止了监听（退出码 2）。',
+  '请告诉主人：到「我的团队」里给这个 Agent 重新接入。不要自己运行 auth login（那样会变成一个新的 Agent）。',
+].join('\n');
+
+function defaultSleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+/** What kind of failure this is: 'upgrade' | 'auth' | 'busy' | 'transient' | 'fatal'. */
+export function classifyListenError(e) {
+  if (!e) return 'transient';
+  if (e.upgradeRequired) return 'upgrade';
+  if (e.authExpired) return 'auth';
+  const st = Number(e.status);
+  const code = e.body && typeof e.body === 'object' ? (e.body.error || (e.body.detail && e.body.detail.error)) : null;
+  if (st === 503 && code === 'hold_limit_reached') return 'busy';
+  if (st === 429) return 'busy';
+  if (st === 401) return 'auth';
+  if (Number.isFinite(st) && st >= 500) return 'transient';    // platform restarting / gateway in between
+  if (Number.isFinite(st) && st >= 400) return 'fatal';        // the platform refused this request on purpose
+  return 'transient';                                          // no answer at all: network cut, DNS, reset ...
+}
+
+function remindFile(credOpts) {
+  return path.join(resolveCredDir(credOpts), 'listen-reminded');
+}
+
+function readReminded(credOpts) {
+  try {
+    const o = JSON.parse(fs.readFileSync(remindFile(credOpts), 'utf8'));
+    return o && typeof o === 'object' ? o : {};
+  } catch {
+    return {};
+  }
+}
+
+/** Pending confirmations not reported in the last PENDING_REMIND_MS; remembers the ones returned. */
+function freshPending(pending, credOpts, nowMs) {
+  if (!pending.length) return [];
+  const seen = readReminded(credOpts);
+  const out = [];
+  const keep = {};
+  for (const [k, at] of Object.entries(seen)) if (nowMs - Number(at) < PENDING_REMIND_MS) keep[k] = at;
+  for (const p of pending) {
+    const key = `${p.task_id}|${p.confirm_deadline_at || ''}`;
+    if (keep[key] != null) continue;
+    keep[key] = nowMs;
+    out.push(p);
+  }
+  if (out.length) {
+    try { atomicWriteFile(remindFile(credOpts), JSON.stringify(keep), 0o600); } catch { /* best effort */ }
+  }
+  return out;
+}
+
+/**
+ * @param {object} p { flags, baseUrl, credOpts, fetchImpl, log, err, deps }
+ *   deps.sleep(ms), deps.random(), deps.nowMs(), deps.listenShouldStop() — for tests.
+ * @returns {Promise<number>} 1 = something happened (printed) · 2 = login lost / refused · 4 is thrown by the caller
+ */
+export async function runListen(p) {
+  const { flags, baseUrl, credOpts, fetchImpl, log, err } = p;
+  const deps = p.deps || {};
+  const sleep = deps.sleep || defaultSleep;
+  const random = deps.random || Math.random;
+  const nowMs = deps.nowMs || Date.now;
+  const shouldStop = deps.listenShouldStop || (() => false);
+
+  let reconnectMs = RECONNECT_FIRST_MS;
+  let broken = false;      // a "connection lost" line was printed; say so when it is back
+  let busyNoted = false;
+
+  while (!shouldStop()) {
+    const started = nowMs();
+    let data;
+    try {
+      data = await getPoll(baseUrl, credOpts, { cursor: readCursor(credOpts), mode: 'listen', fetchImpl });
+    } catch (e) {
+      const kind = classifyListenError(e);
+      if (kind === 'upgrade') throw e;                   // the shared handler prints it with exit code 4
+      if (kind === 'auth') {
+        if (flags.json || flags.follow) log(JSON.stringify({ ok: false, error: 'auth_expired', message: AUTH_LOST_TEXT }));
+        err(AUTH_LOST_TEXT);
+        return 2;
+      }
+      if (kind === 'fatal') {
+        const msg = (e.body && (e.body.message || (e.body.detail && e.body.detail.message))) || e.message || String(e);
+        err(`平台拒绝了监听请求，已停止：${msg}`);
+        return 2;
+      }
+      if (kind === 'busy') {
+        const wait = BUSY_MIN_MS + Math.floor(random() * BUSY_SPAN_MS);
+        if (!busyNoted) err(`平台这会儿忙，${Math.round(wait / 1000)} 秒后自动再试（不用处理）。`);
+        busyNoted = true;
+        await sleep(wait);
+        continue;
+      }
+      // transient: keep the cursor, pause, try again
+      if (!broken) err(`和平台的连接断了（${e && e.message ? e.message : '没有回应'}），正在自动重连，不用处理。`);
+      broken = true;
+      const jitter = Math.floor(random() * reconnectMs * 0.2);
+      await sleep(reconnectMs + jitter);
+      reconnectMs = Math.min(reconnectMs * 2, RECONNECT_MAX_MS);
+      continue;
+    }
+
+    if (broken) err('已重新连上平台，继续监听。');
+    broken = false;
+    busyNoted = false;
+    reconnectMs = RECONNECT_FIRST_MS;
+    // Always save the cursor, even for a quiet answer (same rule as `anytowork poll`).
+    if (data && data.next_cursor != null) writeCursor(data.next_cursor, credOpts);
+
+    const events = (data && data.events) || [];
+    const pending = freshPending(((data && data.pending_confirms) || []).filter((x) => x && x.task_id), credOpts, nowMs());
+
+    if (flags.follow) {
+      // One JSON line per event; never exit for events.
+      for (const e of events) log(JSON.stringify({ ...e, urgent: isUrgentEvent(e) }));
+      for (const x of pending) log(JSON.stringify({ event_type: 'pending_confirm', urgent: true, payload: x }));
+    } else if (events.length || pending.length) {
+      let activeTasks = null;
+      if (events.length) {
+        try { activeTasks = pickActiveTasks(await getMyTakenTasks(baseUrl, credOpts, { fetchImpl })); } catch { activeTasks = null; }
+      }
+      const shown = { ...data, events, pending_confirms: pending };
+      const text = formatPoll(shown, { json: flags.json, activeTasks, annotate: true });
+      if (text) log(flags.json ? text : `${text}\n${LISTEN_AGAIN_LINE}`);
+      return 1;
+    }
+
+    // A quiet answer that came back at once: pause briefly so the loop never spins.
+    if (!events.length && nowMs() - started < QUICK_REPLY_MS) await sleep(QUICK_PAUSE_MS);
+  }
+  return 0;
+}

package/src/multipart-upload.js

@@ -13,14 +13,18 @@ const PART_RETRIES = 4;
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
-function call(baseUrl, credOpts, fetchImpl, action, body) {
-  return authedPostWithRefresh(baseUrl, `/api/v1/uploads/multipart/${action}`, credOpts, body, null, { fetchImpl });
+/** Where the part endpoints live by default; the space and a task's workspace have their own (v0.31, CLI 0.12.21). */
+export const DEFAULT_MULTIPART_BASE = '/api/v1/uploads/multipart';
+
+function callPart(baseUrl, credOpts, fetchImpl, action, body, base = DEFAULT_MULTIPART_BASE, wrap = (fn) => fn()) {
+  return wrap(() => authedPostWithRefresh(baseUrl, `${base}/${action}`, credOpts, body, null, { fetchImpl }));
 }
 
 /**
  * Upload one registered file (POST /uploads already gave its file_id) in parts.
  *
- * @param {object} p { baseUrl, credOpts, fetchImpl?, putFetch?, fileId, absPath, size, filename, progress?(msg), makeError(msg) }
+ * @param {object} p { baseUrl, credOpts, fetchImpl?, putFetch?, fileId, absPath, size, filename, progress?(msg), makeError(msg),
+ *                   pathBase? (part endpoints, default the task-attachment ones), wrap? (runs every platform call, e.g. to wait out a 429) }
  * @throws whatever makeError builds, with a Chinese message
  */
 export async function uploadMultipart(p) {
@@ -28,10 +32,13 @@ export async function uploadMultipart(p) {
   const putFetch = p.putFetch || fetchImpl || globalThis.fetch;
   const progress = p.progress || (() => {});
   const base = { file_id: fileId };
+  const pathBase = p.pathBase || DEFAULT_MULTIPART_BASE;
+  const wrap = p.wrap || ((fn) => fn());
+  const call = (action, body) => callPart(baseUrl, credOpts, fetchImpl, action, body, pathBase, wrap);
 
   let init;
   try {
-    init = await call(baseUrl, credOpts, fetchImpl, 'init', base);
+    init = await call('init', base);
   } catch (e) {
     if (e && e.upgradeRequired) throw e;
     throw makeError(`开始分片上传 ${filename} 失败：${e && e.message ? e.message : e}`);
@@ -44,7 +51,7 @@ export async function uploadMultipart(p) {
   const urls = {};
   const sign = async (nums) => {
     for (let i = 0; i < nums.length; i += 100) {
-      const r = await call(baseUrl, credOpts, fetchImpl, 'sign', { ...base, upload_id: uploadId, part_numbers: nums.slice(i, i + 100) });
+      const r = await call('sign', { ...base, upload_id: uploadId, part_numbers: nums.slice(i, i + 100) });
       Object.assign(urls, r.urls);
     }
   };
@@ -95,7 +102,7 @@ export async function uploadMultipart(p) {
 
     // an ETag the storage did not let us read is taken from the server's list of stored parts
     if (numbers.some((n) => !etags[String(n)])) {
-      const listed = await call(baseUrl, credOpts, fetchImpl, 'parts', { ...base, upload_id: uploadId });
+      const listed = await call('parts', { ...base, upload_id: uploadId });
       for (const part of listed.parts || []) {
         if (!etags[String(part.part_number)]) etags[String(part.part_number)] = part.etag;
       }
@@ -103,12 +110,12 @@ export async function uploadMultipart(p) {
     const parts = numbers.map((n) => ({ part_number: n, etag: etags[String(n)] }));
     if (parts.some((x) => !x.etag)) throw makeError(`上传 ${filename} 没有传完整，请重新运行同一条命令。`);
     try {
-      await call(baseUrl, credOpts, fetchImpl, 'complete', { ...base, upload_id: uploadId, parts });
+      await call('complete', { ...base, upload_id: uploadId, parts });
     } catch (e) {
       throw makeError(`合并 ${filename} 失败：${e && e.message ? e.message : e}。可重新运行同一条命令。`);
     }
   } catch (e) {
-    try { await call(baseUrl, credOpts, fetchImpl, 'abort', { ...base, upload_id: uploadId }); } catch { /* the platform clears leftovers by itself */ }
+    try { await call('abort', { ...base, upload_id: uploadId }); } catch { /* the platform clears leftovers by itself */ }
     throw e;
   } finally {
     await fh.close();