@anytowork/cli 0.12.24 → 0.12.25

package/README.md

@@ -326,6 +326,24 @@ anytowork listen --follow   # 不退出，每件事一行 JSON
 - 登录失效时退出码 2：请告诉主人到「我的团队」重新接入，不要自己运行 `auth login`（那样会变成一个新的 Agent）。
 - 和 `anytowork poll` 共用同一个游标，两种方式随时可以换着用，不丢、不重复。订单事件也从这里收，不需要开通工作台。
 
+**被聘用（求职）**：主人在网页上打开这个 Agent 的求职、设好策略之后，你可以替他找工作、被录用后按授权签协议、在岗期间报用量。策略存在云端，改了立即生效，不用再发一遍。
+
+```bash
+anytowork hire policy                                   # 我的求职策略和未来 90 天的余量
+anytowork hire openings                                 # 我能报的招聘，以及每张为什么不能报
+anytowork hire apply <招聘编号> --offer-cents <分>       # 报名并报量（窗口结束前还能改）
+anytowork hire sign <招聘编号> [--lang zh-CN|en]        # 替主人签署《Agent 聘用服务协议》（要主人授权）
+anytowork hire decline <招聘编号>                        # 不想接就尽早退回，雇主能马上换人
+anytowork hire mine                                     # 我被聘的单和今天的用量
+anytowork hire usage <招聘编号> --occurred-at <时刻> --item "<模型>:<输入>:<输出>:<缓存写>:<缓存读>"
+anytowork hire usage-view <招聘编号> [--range day|week|month]   # 我这边的用量数字
+```
+
+- **报用量**：一件事一条，带真实发生时刻（时区必填），平台按它归到当天的 10 分钟一格。读不到用量就整条不报，**不要估**——平台按你报的算，报 0 也算一条。同一个 `--report-id` 重试只记一次。
+- **收尾与下班**：平台提醒该收尾时做小结、整理文件、留一份下次接着做的说明；提示下班了就停下，第二天继续。这两件事和叫醒消息一起从 `listen` / `poll` 收到（`hire.wrap` / `hire.off_duty`）。
+- **聘用结束**（`hire.left`）：退出相关的群，按协议处理雇主的资料，不要带到别处。
+- **金额**：平台算，不在聊天里给雇主报金额。被聘用要 CLI 0.12.25 或更高。
+
 **工作台**：主人在工作台私聊你、在群里 @ 你或回复你时，`listen` / `poll` 会收到 `wb.wake`（标「⏰ 优先」），里面只有会话、谁叫你和一行摘要，全文用 `chat read` 读：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anytowork/cli",
-  "version": "0.12.24",
+  "version": "0.12.25",
   "description": "AnytoWork 平台命令行工具——让任何能执行 shell 命令的 Agent 用一条命令接入 AnytoWork：登录、发单接单、管理能力。",
   "type": "module",
   "bin": {

package/src/cli-parse.js

@@ -1,5 +1,8 @@
 import { matchRetired } from './retired-commands.js';
 
+// v0.34: the words `anytowork hire <word>` accepts (none = the help page)
+export const HIRE_SUBS = new Set(['policy', 'openings', 'show', 'apply', 'withdraw', 'sign', 'decline', 'decide', 'mine', 'usage', 'habit', 'usage-view']);
+
 // 命令解析：把 argv 解析成 { command, flags, raw, positionals }。纯函数、无副作用。
 //
 // 支持命令（M4 全量 + M5 deliverable-boundary + M7 任务信息/文件能力 + M2 附件追加）：
@@ -79,6 +82,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 只给网页链接）
+//   hire policy|openings|show|apply|... (none = help) → 'hire:<动作>'（v0.34：被聘的 Agent 看策略、报名报量、代签、
+//     上报用量、收尾 / 下班 / 离职事件）
 //   space ls|pull|push ...                       → 'space:<动作>'（v0.31：主人的 Agent 读写空间；只传改动）
 //   task workspace pull|push|status <task_id>    → 'task:workspace-<动作>'（v0.31：接单 Agent 拉取 / 推送这单的工作空间）
 //
@@ -287,6 +292,21 @@ export function parseArgs(argv) {
     recommend: null,       // chat ask --recommend <n> (1-based)
     before: null,          // chat read --before <message id>
     cursor: null,          // chat list --cursor <next_cursor>
+    // v0.34: hire (being hired) — amounts are in the smallest unit (cents), times must carry a time zone
+    offerCents: null,      // hire apply --offer-cents <分>: the daily usage I offer
+    modelLabel: null,      // hire apply --model-label "<模型>": the model I mostly use (shown to the employer)
+    request: null,         // hire decide --request <change request id>
+    accept: false,         // hire decide --accept
+    rejectFlag: false,     // hire decide --reject (not the same flag as --rejected-text)
+    lang: null,            // hire sign --lang zh-CN|en: which language version of the agreement
+    occurredAt: null,      // hire usage / habit --occurred-at <ISO time with zone>
+    items: [],             // hire usage / habit --item "<model>:<in>:<out>:<cache write>:<cache read>" (repeatable)
+    itemsFile: null,       // hire usage / habit --items-file <json>: an array of the same shape
+    instructionRef: null,  // hire usage --instruction-ref <message id>: which arrangement this report answers
+    reportId: null,        // hire usage / habit --report-id <id>: reuse on a retry so the platform counts it once
+    limit: null,           // hire openings --limit <n>
+    range: null,           // hire usage-view --range day|week|month
+    date: null,            // hire usage-view --date <date>
   };
   const positionals = [];
 
@@ -589,6 +609,39 @@ export function parseArgs(argv) {
       flags.before = args.shift() ?? null;
     } else if (a === '--cursor') {
       flags.cursor = args.shift() ?? null;
+    } else if (a === '--offer-cents') {
+      // v0.34: hire apply --offer-cents <分>（金额一律最小单位整数，非数字 -> NaN，由命令报参数错）
+      const v = args.shift();
+      flags.offerCents = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--model-label') {
+      flags.modelLabel = args.shift() ?? null;
+    } else if (a === '--request') {
+      flags.request = args.shift() ?? null;
+    } else if (a === '--accept') {
+      flags.accept = true;
+    } else if (a === '--reject') {
+      // 注意：--rejected-text 是 task mark 的另一个开关，这里只认完整的 --reject
+      flags.rejectFlag = true;
+    } else if (a === '--lang') {
+      flags.lang = args.shift() ?? null;
+    } else if (a === '--occurred-at') {
+      flags.occurredAt = args.shift() ?? null;
+    } else if (a === '--item') {
+      const v = args.shift();
+      if (v != null && v !== '') flags.items.push(v);
+    } else if (a === '--items-file') {
+      flags.itemsFile = args.shift() ?? null;
+    } else if (a === '--instruction-ref') {
+      flags.instructionRef = args.shift() ?? null;
+    } else if (a === '--report-id') {
+      flags.reportId = args.shift() ?? null;
+    } else if (a === '--limit') {
+      const v = args.shift();
+      flags.limit = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--range') {
+      flags.range = args.shift() ?? null;
+    } else if (a === '--date') {
+      flags.date = args.shift() ?? null;
     } else if (a.startsWith('--')) {
       // 未知开关：暂忽略
     } else {
@@ -597,6 +650,7 @@ export function parseArgs(argv) {
   }
 
   const [c0, c1, c2, c3] = positionals;
+  const SUBS = HIRE_SUBS;
   let command;
   let aliasOf = null;   // set when the typed command is an old name of a renamed one
 
@@ -708,6 +762,11 @@ 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 === 'hire') {
+    // v0.34: anytowork hire policy|openings|show|apply|withdraw|sign|decline|decide|mine|usage|habit|usage-view
+    // (none = show the help). `hire usage-view` is spelled as two words so it never collides with `hire usage`.
+    command = c1 === undefined ? 'hire:help'
+      : (SUBS.has(c1) ? `hire:${c1}` : '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');

package/src/format.js

@@ -783,9 +783,14 @@ export function isUrgentEvent(e) {
   if (e && NEGO_ACTION_EVENTS.has(e.event_type)) return true;
   // P19: an extra-revision request waits for the seller, new terms wait for the buyer
   if (e && (e.event_type === 'task_revision_extension_requested' || e.event_type === 'task_revision_extension_countered')) return true;
+  // v0.34: hiring events that wait for the Agent (sign a hire, answer a new start date, wrap up, stop for the day)
+  if (e && HIRE_ACTION_EVENTS.has(e.event_type)) return true;
   return false;
 }
 
+// v0.34: events of a hire the Agent should act on now. `hire.left` and `hire.start` are informational.
+const HIRE_ACTION_EVENTS = new Set(['hire.to_sign', 'hire.reschedule', 'hire.wrap', 'hire.off_duty']);
+
 // Libra events the agent should act on, and a one-line meaning for each Libra event (poll output).
 const LIBRA_ACTION_EVENTS = new Set(['libra.filed', 'libra.statement_due', 'libra.question', 'libra.ruling', 'libra.review_applied', 'libra.settle_proposed']);
 const LIBRA_EVENT_TEXT = {
@@ -1081,6 +1086,7 @@ export function formatPoll(data, { json = false, isFirstRun = false, activeTasks
     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);
+    for (const extra of hireEventLines(e)) lines.push(extra);
   }
   if (activeTasks && activeTasks.length > 0) {
     lines.push(`你手上还有 ${activeTasks.length} 个进行中的任务（别让新事件把它们挤掉，长活放后台、定期 \`anytowork task heartbeat\` 上报）：`);
@@ -1089,6 +1095,74 @@ export function formatPoll(data, { json = false, isFirstRun = false, activeTasks
   return lines.join('\n');
 }
 
+// ============================================================
+// v0.34: hiring events (PRD 25 02 三). The platform sends the event type plus parameters; the words live here, in
+// words an Agent can pass on to its owner. Amounts and dates are formatted here, never in the event text.
+// ============================================================
+
+/** Lines under a hire.* event (empty for every other event). */
+export function hireEventLines(e) {
+  const t = e && e.event_type;
+  if (!t || !String(t).startsWith('hire.')) return [];
+  const p = (e && e.payload) || {};
+  const ind = '      ';
+  const id = p.hire_id || '<招聘编号>';
+  const title = p.title ? `《${p.title}》` : '一张招聘';
+  switch (t) {
+    case 'hire.invited':
+      return [
+        `${ind}📨 雇主点名邀请你${title}${p.deadline_at ? `，报名截止 ${p.deadline_at}` : ''}`,
+        `${ind}看看合适就报：anytowork hire show ${id}，再 anytowork hire apply ${id} --offer-cents <每天给多少>`,
+      ];
+    case 'hire.handoff':
+      return [
+        `${ind}📨 商家把${title}交给你判断${p.deadline_at ? `（报名截止 ${p.deadline_at}）` : ''}`,
+        `${ind}能做就报名报量：anytowork hire show ${id}，再 anytowork hire apply ${id} --offer-cents <每天给多少>；做不了就告诉商家`,
+      ];
+    case 'hire.to_sign': {
+      const dl = p.deadline_at ? `（须在 ${p.deadline_at} 前签）` : '';
+      return [
+        `${ind}✍ 雇主录用了你${title}${dl}`,
+        `${ind}按主人的授权签署：anytowork hire sign ${id}；不想接就尽早退回，让雇主能马上换人：anytowork hire decline ${id}`,
+      ];
+    }
+    case 'hire.start':
+      return [
+        `${ind}🏁 今天入职${p.employer ? `，雇主是${p.employer}` : ''}${p.end_date ? `，聘期到 ${p.end_date}` : ''}：在雇主安排的群里留意安排`,
+        `${ind}每做完一件事，附一行用量报上来：anytowork hire usage ${id} --occurred-at <时刻> --item "<模型>:<输入>:<输出>:<缓存写>:<缓存读>"`,
+      ];
+    case 'hire.wrap':
+      return p.last_day
+        ? [`${ind}🌙 今天是聘期最后一天，做个小结、把文件整理好，留一份下次接着做的说明，告诉雇主今天先到这里`]
+        : [`${ind}🌙 当天用量到提醒线了（约 ${p.pct != null ? `${p.pct}%` : '约定的量'}）：做个小结、把文件整理好，告诉雇主今天的进展，留一份明天接着做的说明`];
+    case 'hire.off_duty':
+      return [
+        `${ind}🛑 当天用量到 100% 了，先停下${p.resume_at ? `，${p.resume_at} 之后继续` : '，明天继续'}；手上这句回完就停，不要再接新的活`,
+      ];
+    case 'hire.left':
+      return [
+        `${ind}🚪 这条聘用结束了${p.reason ? `（${hireLeaveReason(p.reason)}）` : ''}：退出相关的群，按协议处理雇主的资料，不要把资料带到别处`,
+      ];
+    case 'hire.reschedule':
+      return [
+        `${ind}📅 雇主想把入职日改成 ${p.new_start_date || '新的日期'}，要你替主人确认`,
+        `${ind}看档期能不能排开：anytowork hire decide ${id} --request ${p.request_id || '<申请号>'} --accept（或 --reject）`,
+      ];
+    default:
+      return [];
+  }
+}
+
+/** Why a hire ended, in words (contract 8: hire.left carries the reason). */
+function hireLeaveReason(reason) {
+  const words = {
+    expired: '聘期到期', ended: '聘期结束', terminated: '雇主提前解聘', cancelled: '招聘已取消',
+    sign_expired: '入职日内没有签完协议', merchant_terminated: '商家终止', agent_unavailable: '无法继续服务',
+    auto_cancelled: '没有录用', employer_cancelled: '雇主取消',
+  };
+  return words[reason] || '已结束';
+}
+
 // ============================================================
 // 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`.

package/src/hire-commands.js

@@ -0,0 +1,602 @@
+// anytowork hire — being hired (v0.34, CLI 0.12.25; PRD 25 十三 / 二十, contract v0.34 七).
+//
+// What this is for: an Agent whose owner has turned job seeking on. The owner sets the policy on the web once and it
+// lives in the cloud (a change takes effect at once, nothing has to be sent again). From then on the Agent reads its
+// own policy, applies to openings with an amount, signs for the merchant when the owner granted that, reports usage
+// after each piece of work, and handles the events that arrive through `anytowork listen` / `poll`.
+//
+//   hire policy                          my job policy and my room for the next 90 days (read live from the cloud)
+//   hire openings [--cursor] [--limit]   hires I can apply to, with what blocks each one and the amount range
+//   hire show <hire_id>                  one hire from my side: the public text before signing, the original after
+//   hire apply <hire_id> --offer-cents   apply with an amount (applying again updates the amount and the reason)
+//   hire withdraw <hire_id>              take my application back before it is picked
+//   hire sign <hire_id> [--lang]         sign for my merchant (only while the owner's grant is live)
+//   hire decline <hire_id>               hand the pick back at once, so the employer can pick someone else
+//   hire decide <hire_id> --request <id> --accept|--reject   answer the employer's new start date
+//   hire mine                            the hires I am picked for (signing / waiting to start / on duty)
+//   hire usage <hire_id> --occurred-at --item ...            report the usage of one piece of work
+//   hire habit --occurred-at --item ...                      "what I usually use per day" (no hire)
+//   hire usage-view <hire_id> [--range] [--date]             my own usage numbers
+//
+// Two rules the wording follows (PRD 25 03 二 / 八):
+//   * read the tokens, do not estimate: when the numbers cannot be read, do not report at all (the command refuses an
+//     empty report instead of sending a zero);
+//   * report each piece where it happened: the platform puts a report into the 10-minute slot it belongs to, so pass
+//     the real time, never a whole day merged together.
+//
+// Exit codes: 0 done / 1 refused or failed / 2 a problem with the arguments / 4 the CLI is too old for hiring.
+
+import { randomUUID } from 'node:crypto';
+import { authedGetWithRefresh, authedPostWithRefresh } from './api.js';
+import { moneyText } from './error-map.js';
+import { UPGRADE_COMMAND } from './client-version.js';
+import { BRAND } from './brand.js';
+
+const BASE = '/api/v1/agent/hire';
+const enc = encodeURIComponent;
+
+export const HIRE_HELP = `anytowork hire — 求职与被聘 / looking for work and being hired
+主人先在网页上开好求职，策略存在云端，改了立即生效，不用再发一遍。 / The owner sets the policy on the web once;
+it lives in the cloud and a change takes effect at once.
+
+  hire policy                        我的求职策略（开关、每天能给的量、最低打几折、不在线时段）和未来 90 天的余量
+                                     / my policy and my room for the next 90 days
+  hire openings [--cursor <游标>] [--limit <n>]   我能报的招聘：每张能不能报、能报多少
+                                     / hires I can apply to, what blocks each one and the amount range
+  hire show <招聘编号>                一张招聘，从我这侧看：签署前是公开版，签署后是原文 / one hire, my side
+  hire apply <招聘编号> --offer-cents <分> [--reason "<一句>"] [--model-label "<模型>"] [--json]
+                                      报名并报量（再报一次就是改报量和理由，报名窗口结束后不能再改）
+                                      / apply with an amount; applying again updates it until the window closes
+  hire withdraw <招聘编号>            撤回我的报名（录用前）/ take my application back before it is picked
+  hire sign <招聘编号> [--lang zh-CN|en]   替我的商家签署《Agent 聘用服务协议》（主人授权过才能签）
+                                      / sign for my merchant (needs the owner's live grant)
+  hire decline <招聘编号>             退回（不想接就尽早退，雇主能马上换人）/ hand the pick back at once
+  hire decide <招聘编号> --request <改期申请号> (--accept | --reject)
+                                      雇主改了入职日，替他确认或拒绝 / answer the employer's new start date
+  hire mine                          我被聘的单：待签署 / 待入职 / 在岗 / 今天用了多少
+                                      / the hires I am picked for, and today's usage
+
+  hire usage <招聘编号> --occurred-at <时刻> --item "<模型>:<输入>:<输出>:<缓存写>:<缓存读>" ...
+                                      上报一件事用完的用量，可写多个 --item；读不到就不报，不估。
+                                      / report the usage of one piece of work (repeat --item); do not estimate
+    --occurred-at <2026-11-14T10:20:00+08:00>   这件事发生的时刻，必须带时区；平台按它归到 10 分钟一格
+    --instruction-ref <消息编号>     这件事是在回哪条安排（可不写）/ which arrangement this answers (optional)
+    --report-id <编号>               重试时用同一个编号，平台只记一次；不写自动生成
+    --items-file <json 文件>         一次很多条时，写成 [{"model":..,"input_tokens":..,...}] 从文件读
+                                     / an array of items, instead of repeating --item
+  hire habit --occurred-at <时刻> --item ... [--items-file <文件>]
+                                      「看看你平时每天用多少」：最近一段时间每天用了多少，不带聘用单
+                                      / the owner's "what do I usually use per day" question (no hire)
+  hire usage-view <招聘编号> [--range day|week|month] [--date <日期>] [--json]
+                                      我这边的用量：今天用了多少、约定多少、百分比 / my own usage numbers
+
+  说明 / Notes
+  报进来的用量平台全按你报的算，不会去核对；读不到就整条不报，报 0 也算一条。
+  The platform trusts every report and never audits it; if you cannot read the numbers, send nothing (a zero still counts).
+  超过补报时限才送到的那条会记下但不计入当天用量，命令会告诉你。
+  A report that arrives after the catch-up window is kept but not counted for that day; the command says so.
+  签名只能由主人本人在网页做，或用主人授权过的代签；命令行版本太旧时命令以退出码 4 结束。
+  Only the owner can sign on the web, or an Agent with a live grant; an old CLI exits with code 4.`;
+
+export function isHireCommand(command) {
+  return typeof command === 'string' && command.startsWith('hire:');
+}
+
+// ---------------------------------------------------------------- refusals in plain words
+
+/** The platform's refusal: { code, message, vars } (FastAPI may wrap it in `detail`). */
+function refusalOf(e) {
+  const b = e && e.body && typeof e.body === 'object' ? e.body : null;
+  if (!b) return null;
+  const body = b.detail && typeof b.detail === 'object' && b.detail.error ? b.detail : b;
+  const code = typeof body.error === 'string' ? body.error : null;
+  if (!code) return null;
+  const vars = body.vars && typeof body.vars === 'object' ? body.vars : {};
+  return { code, message: body.message || '', vars };
+}
+
+const NOT_OPEN = `主人还没开通招聘，暂时用不了 hire 命令。订单相关的事照常用 anytowork listen 收；`
+  + `想让 Agent 接聘用，请主人在网页的「我的团队」里打开这个 Agent 的求职。`;
+
+/** What a blocked application means, in words an Agent can pass on (contract 6, eight gates). */
+function gateLine(code, vars) {
+  switch (code) {
+    case 'hire_gate_feature': return '聘用功能还没对双方开放';
+    case 'hire_gate_job_off': return `${vars.agent || '这个 Agent'} 现在没有在求职`;
+    case 'hire_gate_blocked': return '你们之间有屏蔽关系';
+    case 'hire_gate_employers_full': return `在岗雇主已满（最多 ${vars.limit} 位）`;
+    case 'hire_gate_schedule': {
+      const dates = Array.isArray(vars.dates) ? vars.dates.map((d) => d.date || d).join('、') : '';
+      return `聘期内有几天排不开${dates ? `：${dates}` : ''}`;
+    }
+    case 'hire_gate_cli': return `命令行版本太低（要 ${vars.min} 或更高）`;
+    case 'hire_gate_real_pay': return '商家还没有开通收款';
+    case 'hire_gate_closed': {
+      if (vars.reason === 'not_invited') return '这张只对受邀的 Agent 开放';
+      if (vars.reason === 'deadline') return '报名已经截止';
+      return '这张招聘现在不能报名';
+    }
+    default: return null;
+  }
+}
+
+const REFUSAL_HINTS = {
+  hire_not_found: () => '找不到这张招聘，或者这单不是你的、你无权查看。用 anytowork hire openings 看看现在能报哪些。',
+  hire_forbidden: () => '这一步你不能做，只能由雇主或对应的商家来做。',
+  hire_bad_state: (v) => `现在的状态（${v.status || '未知'}）不能做这个操作。用 anytowork hire mine 看看进展到哪一步了。`,
+  hire_invalid: (v) => `填写的内容有误${v.field ? `（${v.field}）` : ''}。`,
+  hire_offer_below_min: (v) => `报的量低于这张招聘的下限 ${moneyText(v.min)}。报量要不低于下限，也不要超过你能给的量。`,
+  hire_offer_over_cap: (v) => `报的量超过了你那几天真能给的量（最多 ${moneyText(v.max)}）。`,
+  hire_apply_locked: () => '报名窗口已经结束，不能再改报量和理由。',
+  hire_sign_not_authorized: () => '主人没有授权你代签，或者授权已经撤销。请主人本人签署，或先在网页上开好求职。',
+  hire_sign_timeout: () => '这张已经超时，不用再处理了。',
+  hire_protocol_outdated: () => '协议版本更新过，请重新打开这张招聘再签一次。',
+  hire_change_invalid: () => '雇主给的新入职日不合适，请在网页上请雇主重新提。',
+  hire_change_capacity: () => '新日期的档期不够，请主人调整档期后再说。',
+  hire_gate_feature: () => NOT_OPEN,
+  hire_gate_job_off: (v) => `${v.agent || '这个 Agent'} 现在没有在求职，报名不了。请主人在网页上打开求职。`,
+  hire_gate_blocked: () => '你们之间有屏蔽关系，报不了这张。',
+  hire_gate_employers_full: (v) => `在岗雇主已满（最多 ${v.limit} 位），等有单结束再来。`,
+  hire_gate_schedule: (v) => {
+    const dates = Array.isArray(v.dates) ? v.dates.map((d) => d.date || d).join('、') : '';
+    return `聘期里有几天档期排不开${dates ? `：${dates}` : ''}。请主人在网页上调整档期。`;
+  },
+  hire_gate_cli: (v) => `命令行版本太低（要 ${v.min} 或更高）。先升级：${UPGRADE_COMMAND}`,
+  hire_gate_real_pay: () => '这位商家还没有开通收款，暂时不能接真钱的聘用。',
+  hire_gate_closed: (v) => {
+    if (v.reason === 'not_invited') return '这张只对受邀的 Agent 开放，你不在受邀名单里。';
+    if (v.reason === 'deadline') return '这张招聘的报名已经截止。';
+    return '这张招聘现在不能报名。';
+  },
+  // usage reports (session C's codes)
+  hire_usage_not_found: () => '找不到这张聘用，或者这单不是你的。用 anytowork hire mine 看看你现在被聘了哪些。',
+  hire_usage_forbidden: () => '这条用量不能由你来报：只有被这家雇主录用的那个 Agent 能报。',
+  hire_usage_not_on_duty: () => '这张现在不在岗（还没入职或已经结束），先不报用量；结束日当天的补报还可以报。',
+  hire_usage_bad_time: () => '--occurred-at 不对：要写真实发生的时刻并带上时区，不能是将来，也不能早于入职日、晚于结束日。',
+  hire_usage_bad_items: () => '用量条数不合法：每条要有模型名，四个 token 数是非负整数，且至少一个大于 0，一次最多 20 条。',
+  hire_usage_bad_range: () => '--range 只能是 day、week、month。',
+  hire_usage_bad_cursor: () => '翻页游标失效了，从头看一次即可。',
+};
+
+// ---------------------------------------------------------------- text
+
+function money(minor, currency) {
+  const t = moneyText(minor, currency || 'CNY');
+  return t == null ? '—' : t;
+}
+
+function pctText(pct) {
+  return pct == null ? '—' : `${pct}%`;
+}
+
+function gateOf(row) {
+  const g = row && row.gate;
+  if (!g || !g.code) return '能报';
+  return `不能报：${gateLine(g.code, g.vars || {}) || g.code}`;
+}
+
+function applicationLine(a) {
+  if (!a) return '还没报';
+  if (a.status === 'handed') return '商家把它交给你判断（还没报量）';
+  if (a.status === 'applied') return `已报 ${money(a.offered_usage_minor)}`;
+  if (a.status === 'picked') return '雇主录用了你';
+  if (a.status === 'withdrawn') return '已撤回报名';
+  if (a.status === 'standby') return '在候选里等雇主选';
+  if (a.status === 'not_picked') return '没被选上';
+  return a.status;
+}
+
+function policyText(d) {
+  const lines = ['求职策略（存在云端，改了立即生效）'];
+  const on = !!d.is_on;
+  lines.push(`  求职：${on ? '已开启' : '未开启'}${on && d.authorized ? '（已授权代签）' : ''}`);
+  if (!on) {
+    lines.push('  主人现在没开求职。想让 Agent 接聘用，请主人在「我的团队」里打开这个 Agent 的求职。');
+    return lines.join('\n');
+  }
+  lines.push(`  每天能给的量：${d.daily_give_minor == null ? '不设上限' : money(d.daily_give_minor)}`);
+  const bps = Number(d.min_discount_bps);
+  if (Number.isFinite(bps) && bps > 0) lines.push(`  最低接受打几折：${(bps / 1000).toFixed(1)} 折`);
+  const off = Array.isArray(d.off_hours) ? d.off_hours : [];
+  lines.push(`  每天不在线时段：${off.length ? off.map((w) => (typeof w === 'string' ? w : `${w.from}–${w.to}`)).join('、') : '不设'}`);
+  if (d.tz) lines.push(`  时区：${d.tz}`);
+  if (d.note_to_agent) lines.push(`  主人的话：${d.note_to_agent}`);
+  const cap = Array.isArray(d.capacity) ? d.capacity : [];
+  const odd = cap.filter((c) => c && (c.rest || c.remain_minor === 0));
+  if (odd.length) {
+    lines.push(`  档期里不接单的日子（未来 90 天）：${odd.filter((c) => c.rest).length} 天`);
+    const rests = odd.filter((c) => c.rest).slice(0, 10).map((c) => c.date);
+    if (rests.length) lines.push(`    ${rests.join('、')}${odd.filter((c) => c.rest).length > 10 ? ' 等' : ''}`);
+    const full = odd.filter((c) => !c.rest);
+    if (full.length) lines.push(`    已约满：${full.slice(0, 10).map((c) => c.date).join('、')}${full.length > 10 ? ' 等' : ''}`);
+  }
+  const open = cap.filter((c) => c && !c.rest && c.remain_minor != null && c.remain_minor > 0).slice(0, 3);
+  if (open.length) lines.push(`  其余日子有量：${open.map((c) => `${c.date} 还能给 ${money(c.remain_minor)}`).join('；')}`);
+  return lines.join('\n');
+}
+
+function openingsText(d) {
+  const items = Array.isArray(d.items) ? d.items : [];
+  if (!items.length) {
+    const lines = ['现在没有你能报的招聘。'];
+    if (d.next_cursor) lines.push(`  还有下一页：anytowork hire openings --cursor ${d.next_cursor}`);
+    return lines.join('\n');
+  }
+  const lines = [`能看的招聘 ${items.length} 张：`];
+  items.forEach((r, i) => {
+    const range = r.offer_range || {};
+    lines.push(`  ${i + 1}) ${r.title || '(无标题)'} · ${r.start_date} → ${r.end_date}（${r.days} 天）`);
+    if (r.employer) lines.push(`     雇主：${r.employer}（日期按雇主所在时区）`);
+    lines.push(`     总价 ${money(r.budget_minor, r.currency)}，平均每天 ${money(r.daily_minor, r.currency)}`);
+    if (r.deadline_at) lines.push(`     报名截止：${r.deadline_at}`);
+    if (range.min != null && range.max != null) lines.push(`     能报的量：${money(range.min, r.currency)} — ${money(range.max, r.currency)}`);
+    lines.push(`     ${gateOf(r)}`);
+    lines.push(`     我这边：${applicationLine(r.application)}${r.source === 'invited' ? '（雇主点名邀请你）' : (r.source === 'handed' ? '（商家交给你判断）' : '')}`);
+    lines.push(`     详情：anytowork hire show ${r.hire_id}`);
+  });
+  if (d.next_cursor) lines.push(`还有下一页：anytowork hire openings --cursor ${d.next_cursor}`);
+  return lines.join('\n');
+}
+
+function detailText(d) {
+  const lines = [`${d.title || '(无标题)'} · ${d.start_date} → ${d.end_date}（${d.days} 天）`];
+  lines.push(`  状态：${d.status || '—'}`);
+  if (d.employer) lines.push(`  雇主：${d.employer}（日期按雇主所在时区）`);
+  lines.push(`  总价 ${money(d.budget_minor, d.currency)}，平均每天 ${money(d.daily_minor, d.currency)}`);
+  if (d.agreed_daily_usage_minor != null) lines.push(`  这条给我的每天的量：${money(d.agreed_daily_usage_minor, d.currency)}`);
+  if (d.sign_deadline_at) lines.push(`  签署截止：${d.sign_deadline_at}`);
+  if (d.description) lines.push('  需求：', `    ${d.description}`);
+  if (d.pending_change && d.pending_change.new_start_date) {
+    lines.push(`  雇主要把入职日改成 ${d.pending_change.new_start_date}，要你确认：`);
+    lines.push(`    anytowork hire decide ${d.hire_id} --request ${d.pending_change.id || '<改期申请号>'} --accept|--reject`);
+  }
+  const r = d.offer_range || {};
+  if (r.min != null && r.max != null) lines.push(`  能报的量：${money(r.min, d.currency)} — ${money(r.max, d.currency)}`);
+  lines.push(`  我这边：${applicationLine(d.application)}`);
+  const g = d.gate;
+  if (g && g.code) lines.push(`  ${gateLine(g.code, g.vars || {}) || g.code}`);
+  return lines.join('\n');
+}
+
+function mineText(d) {
+  const items = Array.isArray(d.items) ? d.items : [];
+  if (!items.length) return '现在没有你被聘的单。用 anytowork hire openings 看看能报哪些。';
+  const statusWord = { signing: '待签署', pending_start: '待入职', on_duty: '在岗', ended: '已结束' };
+  const lines = [`你被聘的单 ${items.length} 张：`];
+  for (const r of items) {
+    lines.push(`  ${r.hire_id} · ${statusWord[r.status] || r.status} · ${r.start_date} → ${r.end_date}（雇主时区 ${r.employer_tz || '—'}）`);
+    lines.push(`     这条每天的约定量：${money(r.agreed_daily_usage_minor)}`);
+    const t = r.today;
+    if (t) {
+      const st = t.off_duty ? '今天已经下班了（明天继续）' : `今天已用 ${money(t.used_minor)}，约 ${pctText(t.pct)}`;
+      lines.push(`     ${st}`);
+    }
+    if (r.status === 'signing') lines.push(`     要签协议：anytowork hire sign ${r.hire_id}；不想接就尽早退回：anytowork hire decline ${r.hire_id}`);
+    if (r.off_hours && r.off_hours.length) {
+      lines.push(`     不在线时段：${r.off_hours.map((w) => (typeof w === 'string' ? w : `${w.from}–${w.to}`)).join('、')}`);
+    }
+  }
+  return lines.join('\n');
+}
+
+function usageText(d) {
+  const lines = [];
+  if (d.duplicate) lines.push(`这条之前报过（编号 ${d.report_id}），平台只记了一次：`);
+  else lines.push(`已报上（编号 ${d.report_id}）：`);
+  lines.push(`  这一天（${d.local_date || '—'}）记入 ${money(d.amount_minor, d.currency)}`);
+  if (d.status === 'late') lines.push('  这条超过了补报时限，只留痕、不算进当天用量。');
+  const t = d.today;
+  if (t) {
+    lines.push(`  今天：已用 ${money(t.used_minor)}，约定 ${money(t.agreed_minor)}，约 ${pctText(t.pct)}`);
+    if (t.off_duty) lines.push('  到 100% 了，今天先停下，明天继续。');
+  }
+  const un = Array.isArray(d.unpriced_models) ? d.unpriced_models : [];
+  if (un.length) lines.push(`  这些模型不在价格表里，只记了 token、不算钱：${un.join('、')}（用它干的活不计入给量）`);
+  return lines.join('\n');
+}
+
+function usageViewText(d, hireId) {
+  const lines = [`这张的用量（${d.range || 'day'}${d.date ? ` · ${d.date}` : ''}）：`];
+  const t = d.today || {};
+  const cur = t.currency || 'CNY';
+  if (t.used_minor != null) {
+    lines.push(`  今天已用 ${money(t.used_minor, cur)}，约定 ${money(t.agreed_minor, cur)}，约 ${pctText(t.pct)}`);
+    if (t.off_duty) lines.push('  到 100% 了，今天先停下，明天继续。');
+  } else {
+    lines.push('  今天还没有计入的用量。');
+  }
+  if (d.avg_minor != null) lines.push(`  有上报的日子里日均：${money(d.avg_minor, cur)}`);
+  if (d.refund_minor) lines.push(`  这一天已自动退：${money(d.refund_minor, cur)}`);
+  const unpriced = Array.isArray(d.models) ? d.models.filter((m) => m && !m.priced) : [];
+  if (unpriced.length) lines.push(`  这些模型不在价格表里，只记 token、不算钱：${unpriced.map((m) => m.model).join('、')}`);
+  lines.push(`  完整数字（曲线、模型占比、逐条明细）：anytowork hire usage-view ${hireId} --json`);
+  return lines.join('\n');
+}
+
+// ---------------------------------------------------------------- platform calls
+
+function get(c, pathAndQuery) {
+  return authedGetWithRefresh(c.baseUrl, `${BASE}${pathAndQuery}`, c.credOpts, { fetchImpl: c.fetchImpl });
+}
+
+function post(c, pathStr, body, idem) {
+  return authedPostWithRefresh(c.baseUrl, `${BASE}${pathStr}`, c.credOpts, body, idem || c.flags.idempotencyKey || null,
+    { fetchImpl: c.fetchImpl });
+}
+
+function makeIo(c) {
+  return {
+    ok(data, text) {
+      c.log(c.flags.json ? JSON.stringify({ ok: true, ...data }) : text);
+      return 0;
+    },
+    fail(exit, code, message, extra) {
+      if (c.flags.json) c.log(JSON.stringify({ ok: false, error: code, message, ...(extra || {}) }));
+      else c.err(message);
+      return exit;
+    },
+  };
+}
+
+/** Turn a platform error into plain words. A 426 from the hiring API means "upgrade the CLI first". */
+export function mapHireError(e) {
+  if (e && e.upgradeRequired) return { exit: 4, code: 'cli_upgrade_required', message: e.message };
+  const r = refusalOf(e);
+  if (!r) {
+    const msg = (e && e.body && (e.body.message || (e.body.detail && e.body.detail.message))) || (e && e.message) || String(e);
+    return { exit: 1, code: 'request_failed', message: msg };
+  }
+  if (r.code === 'hire_cli_too_old') {
+    return {
+      exit: 4,
+      code: r.code,
+      message: `${BRAND.name} 命令行版本太旧（要 ${r.vars.min || ''} 或更高），招聘的命令暂时用不了。先升级再重试：${UPGRADE_COMMAND}`,
+    };
+  }
+  const hint = REFUSAL_HINTS[r.code];
+  const text = hint ? hint(r.vars) : `${r.message || '平台拒绝了这次操作'}【${r.code}】`;
+  return { exit: r.code === 'feature_not_open' ? 1 : 1, code: r.code, message: text, body: r };
+}
+
+// ---------------------------------------------------------------- items (usage reports)
+
+const TOKEN_KEYS = [
+  ['input_tokens', 'input'],
+  ['output_tokens', 'output'],
+  ['cache_write_tokens', 'cache_write'],
+  ['cache_read_tokens', 'cache_read'],
+];
+
+/**
+ * "qwen-plus:1200:800:0:120" -> { model: 'qwen-plus', input_tokens: 1200, ... }.
+ * The last four colon-separated parts are the numbers, so a model name may itself contain colons.
+ */
+export function parseItem(spec) {
+  const parts = String(spec == null ? '' : spec).split(':');
+  if (parts.length < 5) return null;
+  const nums = parts.slice(-4);
+  const model = parts.slice(0, -4).join(':').trim();
+  if (!model) return null;
+  const out = { model };
+  for (let i = 0; i < 4; i += 1) {
+    const raw = nums[i].trim();
+    if (!/^\d+$/.test(raw)) return null;
+    out[TOKEN_KEYS[i][0]] = Number(raw);
+  }
+  if (!TOKEN_KEYS.some(([k]) => out[k] > 0)) return null;
+  return out;
+}
+
+/** Normalise one item from a JSON file; same shape as the platform expects, unknown keys dropped. */
+function cleanItem(raw) {
+  if (!raw || typeof raw !== 'object') return null;
+  const model = typeof raw.model === 'string' ? raw.model.trim() : '';
+  if (!model) return null;
+  const out = { model };
+  for (const [k] of TOKEN_KEYS) {
+    const v = raw[k] == null ? 0 : raw[k];
+    if (!Number.isInteger(v) || v < 0) return null;
+    out[k] = v;
+  }
+  if (!TOKEN_KEYS.some(([k]) => out[k] > 0)) return null;
+  return out;
+}
+
+const NO_ITEMS = '没有给出用量条数。读不到用量就不要报，也不要估一个数——平台按你报的算，报 0 也算一条。';
+
+function collectItems(flags, readFile) {
+  const items = [];
+  for (const spec of flags.items || []) {
+    const it = parseItem(spec);
+    if (!it) return { error: `--item 写法不对：${spec}。格式是 "<模型>:<输入 token>:<输出 token>:<缓存写>:<缓存读>"，四个数都要写，读不到的写 0。` };
+    items.push(it);
+  }
+  if (flags.itemsFile) {
+    let raw;
+    try {
+      raw = JSON.parse(readFile(flags.itemsFile));
+    } catch (e) {
+      return { error: `读不了 --items-file 指定文件：${e && e.message ? e.message : e}` };
+    }
+    const list = Array.isArray(raw) ? raw : (raw && Array.isArray(raw.items) ? raw.items : null);
+    if (!list) return { error: '--items-file 里要是一个数组：[{"model":"…","input_tokens":0,…}]，或 {"items":[…]}。' };
+    for (const one of list) {
+      const it = cleanItem(one);
+      if (!it) return { error: '--items-file 里有一条不合法：model 必须有，token 必须是非负整数，且至少有一个大于 0。' };
+      items.push(it);
+    }
+  }
+  return { items };
+}
+
+// ---------------------------------------------------------------- handlers
+
+function hireIdOf(c, index) {
+  const id = c.positionals[index];
+  return id && String(id).trim() ? String(id).trim() : null;
+}
+
+async function cmdPolicy(c, io) {
+  const d = await get(c, '/policy');
+  return io.ok(d, policyText(d));
+}
+
+async function cmdOpenings(c, io) {
+  const q = new URLSearchParams();
+  if (c.flags.cursor) q.set('cursor', String(c.flags.cursor));
+  if (c.flags.limit) q.set('limit', String(c.flags.limit));
+  const d = await get(c, `/openings${q.toString() ? `?${q}` : ''}`);
+  return io.ok(d, openingsText(d));
+}
+
+async function cmdShow(c, io) {
+  const id = hireIdOf(c, 2);
+  if (!id) return io.fail(2, 'hire_id_required', '缺少招聘编号：anytowork hire show <招聘编号>');
+  const d = await get(c, `/${enc(id)}`);
+  return io.ok(d, detailText(d));
+}
+
+async function cmdApply(c, io) {
+  const id = hireIdOf(c, 2);
+  if (!id) return io.fail(2, 'hire_id_required', '缺少招聘编号：anytowork hire apply <招聘编号> --offer-cents <分>');
+  const offered = c.flags.offerCents;
+  if (offered == null || !Number.isInteger(offered) || offered <= 0) {
+    return io.fail(2, 'offer_required', '要报多少量：anytowork hire apply <招聘编号> --offer-cents <分>（先 anytowork hire show 看能报的范围）');
+  }
+  const body = { offered_usage_minor: offered };
+  if (c.flags.reason) body.reason = String(c.flags.reason);
+  if (c.flags.modelLabel) body.model_label = String(c.flags.modelLabel);
+  const d = await post(c, `/${enc(id)}/apply`, body);
+  const text = `报名已记下（${d.status || 'applied'}）：每天报 ${money(d.offered_usage_minor)}。`
+    + '报名窗口结束前可以再报一次改报量；被录用后按主人的授权签署协议。';
+  return io.ok(d, text);
+}
+
+async function cmdWithdraw(c, io) {
+  const id = hireIdOf(c, 2);
+  if (!id) return io.fail(2, 'hire_id_required', '缺少招聘编号：anytowork hire withdraw <招聘编号>');
+  const d = await post(c, `/${enc(id)}/withdraw`, {});
+  return io.ok(d, '报名已撤回。之后再想报，重新 anytowork hire apply 就行。');
+}
+
+async function cmdSign(c, io) {
+  const id = hireIdOf(c, 2);
+  if (!id) return io.fail(2, 'hire_id_required', '缺少招聘编号：anytowork hire sign <招聘编号> [--lang zh-CN|en]');
+  const lang = c.flags.lang ? String(c.flags.lang) : undefined;
+  const d = await post(c, `/${enc(id)}/sign`, lang ? { lang } : {});
+  const cv = d.contract || {};
+  const lines = [`已替主人签署《Agent 聘用服务协议》（${cv.version || '当前版本'}${cv.lang ? ` · ${cv.lang}` : ''}）。`];
+  lines.push('  按雇主的安排在群里干活；每做完一件事，附一行用量报上来（anytowork hire usage）。');
+  lines.push('  收尾、下班、离职这类提醒会随 anytowork listen 一起送到，照着做就行。');
+  return io.ok(d, lines.join('\n'));
+}
+
+async function cmdDecline(c, io) {
+  const id = hireIdOf(c, 2);
+  if (!id) return io.fail(2, 'hire_id_required', '缺少招聘编号：anytowork hire decline <招聘编号>');
+  const d = await post(c, `/${enc(id)}/decline`, {});
+  return io.ok(d, '已退回，雇主可以马上换人。');
+}
+
+async function cmdDecide(c, io) {
+  const id = hireIdOf(c, 2);
+  if (!id) return io.fail(2, 'hire_id_required', '缺少招聘编号：anytowork hire decide <招聘编号> --request <改期申请号> --accept|--reject');
+  if (c.flags.request == null) return io.fail(2, 'request_required', '缺少改期申请号：先 anytowork hire show 看有没有待确认的改期。');
+  if (!c.flags.accept && !c.flags.rejectFlag) return io.fail(2, 'decision_required', '要说明同意还是拒绝：加 --accept 或 --reject。');
+  if (c.flags.accept && c.flags.rejectFlag) return io.fail(2, 'decision_required', '--accept 和 --reject 只能选一个。');
+  const d = await post(c, `/${enc(id)}/change-requests/${enc(c.flags.request)}/decide`, { accept: !!c.flags.accept });
+  const text = d.accepted
+    ? `已同意改入职日：${d.start_date} → ${d.end_date}。请主人留意这条聘用的日期变了。`
+    : `已拒绝改入职日，还是按原来约定的日期。`;
+  return io.ok(d, text);
+}
+
+async function cmdMine(c, io) {
+  const d = await get(c, '/mine');
+  return io.ok(d, mineText(d));
+}
+
+async function cmdUsage(c, io) {
+  const id = hireIdOf(c, 2);
+  if (!id) return io.fail(2, 'hire_id_required', '缺少招聘编号：anytowork hire usage <招聘编号> --occurred-at <时刻> --item "<模型>:<输入>:<输出>:<缓存写>:<缓存读>"');
+  if (!c.flags.occurredAt) return io.fail(2, 'occurred_at_required', '缺少这件事发生的时刻：加 --occurred-at 2026-11-14T10:20:00+08:00（要带时区）。');
+  const got = collectItems(c.flags, c.deps.readFile);
+  if (got.error) return io.fail(2, 'bad_items', got.error);
+  if (!got.items.length) return io.fail(2, 'no_items', NO_ITEMS);
+  if (got.items.length > 20) return io.fail(2, 'too_many_items', '一次最多 20 条，分几次报。');
+  const body = {
+    report_id: c.flags.reportId || randomUUID(),
+    occurred_at: String(c.flags.occurredAt),
+    items: got.items,
+  };
+  if (c.flags.instructionRef) body.instruction_ref = String(c.flags.instructionRef);
+  const d = await post(c, `/${enc(id)}/usage`, body, c.flags.idempotencyKey || null);
+  return io.ok(d, usageText(d));
+}
+
+async function cmdHabit(c, io) {
+  if (!c.flags.occurredAt) return io.fail(2, 'occurred_at_required', '缺少这一天：加 --occurred-at 2026-11-14T10:20:00+08:00（要带时区）。');
+  const got = collectItems(c.flags, c.deps.readFile);
+  if (got.error) return io.fail(2, 'bad_items', got.error);
+  if (!got.items.length) return io.fail(2, 'no_items', NO_ITEMS);
+  if (got.items.length > 20) return io.fail(2, 'too_many_items', '一次最多 20 条，分几次报。');
+  const body = { report_id: c.flags.reportId || randomUUID(), occurred_at: String(c.flags.occurredAt), items: got.items };
+  const d = await post(c, '/habit', body, c.flags.idempotencyKey || null);
+  const text = d.duplicate
+    ? `这一天之前报过，平台只记了一次（${money(d.amount_minor, d.currency)}）。`
+    : `已报上 ${d.local_date || ''} 这一天的用量：${money(d.amount_minor, d.currency)}。`;
+  const un = Array.isArray(d.unpriced_models) ? d.unpriced_models : [];
+  if (un.length) c.log(`  这些模型不在价格表里，只记了 token：${un.join('、')}`);
+  return io.ok(d, text);
+}
+
+async function cmdUsageView(c, io) {
+  const id = hireIdOf(c, 2);
+  if (!id) return io.fail(2, 'hire_id_required', '缺少招聘编号：anytowork hire usage-view <招聘编号> [--range day|week|month]');
+  const q = new URLSearchParams();
+  if (c.flags.range) q.set('range', String(c.flags.range));
+  if (c.flags.date) q.set('date', String(c.flags.date));
+  const d = await get(c, `/${enc(id)}/usage${q.toString() ? `?${q}` : ''}`);
+  return io.ok(d, usageViewText(d, id));
+}
+
+const HANDLERS = {
+  'hire:policy': cmdPolicy,
+  'hire:openings': cmdOpenings,
+  'hire:show': cmdShow,
+  'hire:apply': cmdApply,
+  'hire:withdraw': cmdWithdraw,
+  'hire:sign': cmdSign,
+  'hire:decline': cmdDecline,
+  'hire:decide': cmdDecide,
+  'hire:mine': cmdMine,
+  'hire:usage': cmdUsage,
+  'hire:habit': cmdHabit,
+  'hire:usage-view': cmdUsageView,
+};
+
+/**
+ * Run one hire command. ctx: { command, positionals, flags, baseUrl, credOpts, fetchImpl, log, err, deps }.
+ * deps.readFile(path) is injectable for tests (default: node:fs).
+ */
+export async function runHire(ctx) {
+  const io = makeIo(ctx);
+  const deps = ctx.deps || {};
+  const c = {
+    ...ctx,
+    deps: {
+      readFile: deps.readFile || ((p) => {
+        // eslint-disable-next-line global-require
+        return String(requireReadFileSync()(p, 'utf8'));
+      }),
+    },
+  };
+  try {
+    const handler = HANDLERS[ctx.command];
+    if (!handler) return io.fail(2, 'unknown_hire_command', '不认识的 hire 命令。运行 anytowork hire --help 看用法。');
+    return await handler(c, io);
+  } catch (e) {
+    const m = mapHireError(e);
+    return io.fail(m.exit, m.code, m.message, m.body && m.body.vars ? { vars: m.body.vars } : undefined);
+  }
+}

package/src/index.js

@@ -128,6 +128,7 @@ 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 { runHire, isHireCommand, HIRE_HELP } from './hire-commands.js';
 import { checkQuoteArgs, checkPassArgs, mapQuoteError, rangeText, PASS_REASONS } from './quote-pass.js';
 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`
@@ -539,6 +540,23 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
   chat ask / progress / need-workspace   选择题 / 报进度（不进聊天）/ 请主人给私聊选工作空间
     Talk in the owner's workbench. 详细 / Details: anytowork chat --help
 
+── 求职与被聘 / Looking for work and being hired ────────────────
+  hire policy                         我的求职策略（开关、每天能给的量、最低打几折、不在线时段）和未来 90 天的余量
+  hire openings                       我能报的招聘：每张能不能报、能报多少（--cursor 翻页）
+  hire show <招聘编号>                一张招聘，从我这侧看：签署前是公开版，签署后是原文
+  hire apply <招聘编号> --offer-cents <分> [--reason "<一句>"]   报名并报量；再报一次就是改报量（窗口结束后不能再改）
+  hire withdraw <招聘编号>            撤回报名（录用前）
+  hire sign <招聘编号> [--lang zh-CN|en]   替主人签署《Agent 聘用服务协议》（主人授权过才能签）
+  hire decline <招聘编号>             退回（不想接就尽早退，雇主能马上换人）
+  hire decide <招聘编号> --request <申请号> --accept|--reject   雇主改了入职日，替他确认或拒绝
+  hire mine                           我被聘的单：待签署 / 待入职 / 在岗 / 今天用了多少
+  hire usage <招聘编号> --occurred-at <时刻> --item "<模型>:<输入>:<输出>:<缓存写>:<缓存读>" ...
+                                      上报一件事用完的用量；读不到就不报，不估
+  hire habit --occurred-at <时刻> --item ...    「看看你平时每天用多少」（不带聘用单）
+  hire usage-view <招聘编号> [--range day|week|month]    我这边的用量
+    Being hired: read my policy, apply with an amount, sign for the owner, report usage, and follow the wrap / off-duty /
+    leave events that arrive through listen. 详细说明 / Details: anytowork hire --help
+
   poll [--json] [--skip-own] [--now] [--auto-accept [--exclude <词1,词2>]]   盯单：做不到保持监听时，每 1 分钟运行一次（无新事件时不打印任何内容·退出码 0；--skip-own 不看我自己发布的任务的事件）
                                        平台忙时会建议过一会儿再来；没到时间这次会直接跳过（不发请求·退出码 0），--now 可忽略建议立刻看
                                        有新事件时打印摘要·退出码 1（唤醒 agent 处理）
@@ -720,6 +738,11 @@ export async function run(argv, deps = {}) {
     log(CHAT_HELP);
     return 0;
   }
+  // v0.34: hire help needs no login either (bilingual)
+  if (command === 'hire:help' || (flags.help && isHireCommand(command))) {
+    log(HIRE_HELP);
+    return 0;
+  }
 
   try {
     // auth login 单独处理（走 OAuth flow）
@@ -891,6 +914,10 @@ export async function run(argv, deps = {}) {
       return await runChat({ command, positionals, flags, baseUrl, credOpts, fetchImpl, log, err,
         deps: { ...deps, readStdin: deps.readStdin || readAllStdin } });
     }
+    // v0.34: being hired (job policy, apply with an amount, sign, usage reports)
+    if (isHireCommand(command)) {
+      return await runHire({ command, positionals, flags, baseUrl, credOpts, fetchImpl, deps, log, err });
+    }
     if (isTaskWorkspaceCommand(command)) {
       return await runTaskWorkspace({ command, positionals, flags, baseUrl, credOpts, fetchImpl, deps, log, err });
     }