@x-otto/cli 0.0.1-alpha.2 → 0.0.1-alpha.21

package/dist/observe-CZ96Vre9.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import{a as e,i as t,r as n}from"./service-client-Cr4sxDVM.js";import{SERVICE_URL as r}from"@x-otto/env";import{BREAKPOINT_POINTS as i}from"@x-otto/agent";const a=i.map(e=>e.point);async function o(r,i={}){let o=i.stdout??(e=>process.stdout.write(e)),c=i.stderr??(e=>process.stderr.write(e)),f,p;try{({baseUrl:f,rest:p}=e(r))}catch(e){return t(`debug`,e,c)}let[m,...h]=p;if(!m||m===`help`)return o(`otto debug — 调试面板（断点管理 / 状态查看）
+
+用法:
+  otto debug breakpoints list              列出所有断点及启用状态
+  otto debug breakpoints set <point>       设置断点（默认启用）
+  otto debug breakpoints remove <point>    移除断点
+  otto debug breakpoints enable <point>    启用断点
+  otto debug breakpoints disable <point>   禁用断点
+  otto debug breakpoints enable-all        全部启用
+  otto debug breakpoints disable-all       全部禁用
+  otto debug points                        列出所有可用断点位
+  otto debug state                         调试器状态（断点统计 + 挂起的暂停）
+
+选项:
+  --remote <url>   service 地址（默认 OTTO_SERVICE_URL 或 http:
+
+断点位（BREAKPOINT_POINTS）:
+${a.map(e=>`  ${e}`).join(`
+`)}
+
+注：需要 \`otto serve --inspect\` 启动的 service（调试器默认关闭）。
+resume/inject 等运行时命令经 REST：POST /api/debugger/resume | /inject。
+`),0;let g=n(f,i.fetch);try{switch(m){case`breakpoints`:{let e=h[0];switch(e){case`list`:return await s(g,o);case`set`:return await l(g,h[1],!0,o,c);case`remove`:return await l(g,h[1],!1,o,c,`removed`);case`enable`:return await l(g,h[1],!0,o,c,`enabled`);case`disable`:return await l(g,h[1],!1,o,c,`disabled`);case`enable-all`:return await g.post(`/api/debugger/breakpoints/enable-all`),o(`All breakpoints enabled.
+`),0;case`disable-all`:return await g.post(`/api/debugger/breakpoints/disable-all`),o(`All breakpoints disabled.
+`),0;default:return c(`otto debug breakpoints: unknown sub-action '${e}'.\n`),1}}case`points`:return await u(g,o);case`state`:return await d(g,o);default:return c(`otto debug: unknown action '${m}'. Use breakpoints | points | state.\n`),1}}catch(e){return t(`debug`,e,c)}}async function s(e,t){let{breakpoints:n}=await e.get(`/api/debugger/breakpoints`);if(n.length===0)return t(`No breakpoints set.
+`),0;t(`${`point`.padEnd(36)} enabled\n${`-`.repeat(46)}\n`);for(let e of n)t(`${e.point.padEnd(36)} ${e.enabled?`✓`:`✗`}\n`);return 0}function c(e){return!!e&&a.includes(e)}async function l(e,t,n,r,i,a){return c(t)?(await e.put(`/api/debugger/breakpoints/${t}`,{enabled:n}),r(`Breakpoint ${a??`set: ${t} (${n?`enabled`:`disabled`})`}${a?`: ${t}`:``}\n`),0):(i(`otto debug: invalid or missing breakpoint point.
+Use 'otto debug points' to list valid points.
+`),1)}async function u(e,t){let{breakpoints:n}=await e.get(`/api/debugger/breakpoints`),r=new Map(n.map(e=>[e.point,e]));t(`Available breakpoint points:
+`);for(let e of i){let n=r.get(e.point),i=n?.set?n.enabled?`enabled`:`disabled`:`not set`;t(`  ${e.point.padEnd(36)} ${i}\n`)}return 0}async function d(e,t){let n=await e.get(`/api/debugger/state`);t(`Debugger state
+  breakpoints: ${n.breakpoints.enabled}/${n.breakpoints.total} enabled
+  paused:      ${n.paused?`yes`:`no`}
+`);for(let e of n.pendingPauses)t(`  ⏸ ${e.point} (turn ${e.turn}) pauseId=${e.pauseId}\n`);return 0}async function f(i,a={}){let o=a.stdout??(e=>process.stdout.write(e)),s=a.stderr??(e=>process.stderr.write(e)),c,l;try{({baseUrl:c,rest:l}=e(i))}catch(e){return t(`time-travel`,e,s)}let[u,d,...f]=l;if(!u||u===`help`)return o(`otto time-travel — 回放+回滚面板
+
+用法:
+  otto time-travel checkpoints <session-id>           列出所有 checkpoint
+  otto time-travel checkpoint <session-id> [--label X] 创建新 checkpoint
+  otto time-travel scrubber <session-id> <seq>         显示 traceback 视图
+  otto time-travel restore <session-id> <seq> [--mode M] [--rollback]
+                                                          恢复/回滚 (mode: conversation|code|both)
+  otto time-travel fork <session-id> <seq>             从 checkpoint 分叉新会话
+  otto time-travel replay <session-id>                 启动确定性重放
+
+选项:
+  --remote <url>   service 地址（默认 OTTO_SERVICE_URL 或 ${r}）
+`),0;if(!d)return s(`otto time-travel: session-id is required.
+`),1;let y=n(c,a.fetch);try{switch(u){case`checkpoints`:return await p(y,d,o);case`checkpoint`:return await m(y,d,f,o);case`scrubber`:return await h(y,d,f[0],o,s);case`restore`:return await g(y,d,f,o,s);case`fork`:return await _(y,d,f[0],o,s);case`replay`:return await v(y,d,o);default:return s(`otto time-travel: unknown action '${u}'.\n`),1}}catch(e){return t(`time-travel`,e,s)}}async function p(e,t,n){let{checkpoints:r}=await e.get(`/api/sessions/${t}/checkpoints`);if(r.length===0)return n(`Session ${t}: no checkpoints found.\n`),0;n(`Checkpoints — ${t} (${r.length})\n`),n(`${`seq`.padStart(4)} ${`traceSeq`.padStart(9)} ${`label`.padEnd(24)} created\n`),n(`${`-`.repeat(70)}\n`);for(let e of r){let t=(e.label??``).padEnd(24),r=new Date(e.createdAt).toISOString(),i=e.traceSeq===void 0?`        -`:String(e.traceSeq).padStart(9);n(`${String(e.seq).padStart(4)} ${i} ${t} ${r}\n`)}return 0}async function m(e,t,n,r){let i=n.indexOf(`--label`),a=i>=0?n[i+1]:void 0,{checkpoint:o}=await e.post(`/api/sessions/${t}/checkpoints`,{label:a});return r(`Checkpoint created: seq=${o.seq}${o.label?` label="${o.label}"`:``} traceSeq=${o.traceSeq}\n`),0}async function h(e,t,n,r,i){let a=Number(n);if(!Number.isInteger(a))return i(`otto time-travel scrubber: seq (integer) is required.
+`),1;let o=await e.get(`/api/sessions/${t}/traceback?to=${a}`);r(`Traceback — ${t} @ seq=${o.toSeq}\n`),o.baselineCheckpointSeq===null?r(`  Baseline: none (folded from seq 0)
+`):r(`  Baseline: checkpoint seq=${o.baselineCheckpointSeq} (fromTraceSeq=${o.fromTraceSeq})\n`),r(`  Events folded: ${o.events.length}\n`),r(`  Messages reconstructed: ${o.messages.length}\n\n`);for(let e of o.messages)r(`  ${e.role.padEnd(12)} ${typeof e.content==`string`?e.content.slice(0,120):JSON.stringify(e.content).slice(0,120)}\n`);return 0}async function g(e,t,n,r,i){let a=Number(n[0]);if(!Number.isInteger(a))return i(`otto time-travel restore: seq (integer) is required.
+`),1;let o=n.indexOf(`--mode`),s=o>=0?n[o+1]:`both`;if(s!==`conversation`&&s!==`code`&&s!==`both`)return i(`otto time-travel restore: invalid mode '${s}'. Use conversation | code | both.\n`),1;let c=n.includes(`--rollback`);return await e.post(`/api/sessions/${t}/checkpoints/${a}/restore`,{mode:s,truncate:c}),r(`Restored to checkpoint seq=${a} mode=${s} rollback=${c}\n`),0}async function _(e,t,n,r,i){let a=Number(n);return Number.isInteger(a)?(r(`Forked session: ${(await e.post(`/api/sessions/${t}/checkpoints/${a}/fork`,{})).forkedSessionId} (from ${t} @ seq=${a})\n`),0):(i(`otto time-travel fork: seq (integer) is required.
+`),1)}async function v(e,t,n){return n(`Replay session created: ${(await e.post(`/api/sessions/${t}/replay`,{})).replaySessionId} (source: ${t})\n`),0}async function y(i,a={}){let s=a.stdout??(e=>process.stdout.write(e)),c=a.stderr??(e=>process.stderr.write(e)),[l,...u]=i;if(l===`debug`)return o(u,a);if(l===`replay`)return f(u,a);let d=i.indexOf(`--json`),p=d>=0,m=p?i.filter((e,t)=>t!==d):i,h,g;try{({baseUrl:h,rest:g}=e(m))}catch(e){return t(`observe`,e,c)}let[_,v]=g;if(!_||_===`help`)return s(`otto observe — 观测面板（trace 时间线 / 摘要 / span 树）
+
+用法:
+  otto observe summary <session-id>    trace 聚合统计
+  otto observe timeline <session-id>   文本时间线
+  otto observe spans <session-id>      span 树视图
+  otto observe debug <action> [...]   调试面板（breakpoints / points / state）
+  otto observe replay <action> <id>   时间旅行（checkpoints / scrubber / restore / fork / replay）
+
+选项:
+  --remote <url>   service 地址（默认 OTTO_SERVICE_URL 或 ${r}）
+  --json           输出结构化 JSON（需 service 运行）
+`),0;if(!v)return c(`otto observe: session-id is required.
+`),1;let y=n(h,a.fetch);try{if(p)return await w(y,v,s,c);switch(_){case`summary`:return await x(y,v,s);case`timeline`:return await S(y,v,s);case`spans`:return await C(y,v,s);default:return c(`otto observe: unknown action '${_}'. Use summary | timeline | spans.\n`),1}}catch(e){return t(`observe`,e,c)}}function b(e,t){return e.get(`/api/sessions/${t}/trace/spans`)}async function x(e,t,n){let r=await e.get(`/api/sessions/${t}/trace/summary`);if(r.totalEvents===0)return n(`Session ${t}: no trace events found.\n`),0;let{totalEvents:i,kinds:a,turns:o,toolCalls:s,firstTs:c,lastTs:l}=r;return n(`Trace Summary — ${t}
+──────────────────────────────────────────
+  Total events:     ${i}
+  Turns:            ${o}
+  Tool calls:       ${s}
+  Time span:        ${c!==void 0&&l!==void 0?`${l-c}ms`:`N/A`}
+  First event:      ${c?new Date(c).toISOString():`N/A`}
+  Last event:       ${l?new Date(l).toISOString():`N/A`}
+
+  By kind:
+${Object.entries(a).map(([e,t])=>`    ${e.padEnd(14)} ${t}`).join(`
+`)}
+`),0}async function S(e,t,n){let{spans:r}=await b(e,t);if(r.length===0)return n(`Session ${t}: no trace events found.\n`),0;let i=r.map(e=>{let t=new Date(e.ts).toISOString().slice(11,23),n=e.turn===void 0?`  -`:`T${String(e.turn).padStart(2)}`,r=(e.node??``).padEnd(26);return`${String(e.seq).padStart(5)} ${t} ${n} ${e.kind.padEnd(12)} ${r}${e.digest??``}`});return n(`Trace Timeline — ${t} (${i.length} events)
+${`seq`.padStart(5)} time       turn ${`kind`.padEnd(12)} ${`node`.padEnd(26)} digest
+${`-`.repeat(100)}
+${i.join(`
+`)}
+`),0}async function C(e,t,n){let{spans:r}=await b(e,t);if(r.length===0)return n(`Session ${t}: no trace events found.\n`),0;let i=new Map,a=-1;for(let e of r){let t=e.turn??0;t>a&&(a=t);let n=i.get(t)??[];n.push(e),i.set(t,n)}n(`Trace Spans — ${t} (${a+1} turns)
+`);for(let e=0;e<=a;e++){let t=i.get(e);if(t){n(`▼ Turn ${e} (${t.length} events)\n`);for(let e of t){let t=e.node?`[${e.node}] `:``;n(`  ├─ ${e.kind.padEnd(12)} ${t}${e.digest??``}\n`)}}}return 0}async function w(e,t,n,r){try{let r=await e.get(`/api/sessions/${t}/trace/timeline`);return n(`${JSON.stringify(r,null,2)}\n`),0}catch(e){return r(`observe --json: ${e instanceof Error?e.message:String(e)}\n`),1}}export{y as runObserveCommand};
+//# sourceMappingURL=observe-CZ96Vre9.js.map

package/dist/observe-CZ96Vre9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-CZ96Vre9.js","names":[],"sources":["../src/commands/debug.ts","../src/commands/time-travel.ts","../src/commands/observe.ts"],"sourcesContent":["/**\n * `otto debug` 子命令 —— 调试面板：断点管理 / 状态查看。\n *\n * 设计依据：design/observability-platform.md §4/§5 + design/m17-platform-activation.md §1/§3。\n * 数据源 = service REST（/api/debugger 路由；此前各自起 in-memory 进程，\n * 断点状态随进程消失、对运行中引擎无效）。默认连 `otto serve --inspect`\n * 实例，`--remote <url>` 覆盖。断点缺省 disabled，设置即对运行中会话生效。\n */\nimport { BREAKPOINT_POINTS } from '@x-otto/agent'\nimport {\n  createServiceClient,\n  reportServiceError,\n  resolveRemote,\n  type ServiceClient,\n} from './service-client'\n\nconst POINT_NAMES: readonly string[] = BREAKPOINT_POINTS.map((d) => d.point)\n\nexport interface DebugDeps {\n  stdout?: (s: string) => void\n  stderr?: (s: string) => void\n  /** fetch 注入（测试用）。 */\n  fetch?: typeof globalThis.fetch\n}\n\ninterface BreakpointEntry {\n  point: string\n  enabled: boolean\n  set?: boolean\n}\n\nexport async function runDebugCommand(\n  args: string[],\n  deps: DebugDeps = {},\n): Promise<number> {\n  const stdout = deps.stdout ?? ((s) => process.stdout.write(s))\n  const stderr = deps.stderr ?? ((s) => process.stderr.write(s))\n\n  let baseUrl: string\n  let rest: string[]\n  try {\n    ;({ baseUrl, rest } = resolveRemote(args))\n  } catch (error) {\n    return reportServiceError('debug', error, stderr)\n  }\n\n  const [action, ...sub] = rest\n\n  if (!action || action === 'help') {\n    stdout(`otto debug — 调试面板（断点管理 / 状态查看）\n\n用法:\n  otto debug breakpoints list              列出所有断点及启用状态\n  otto debug breakpoints set <point>       设置断点（默认启用）\n  otto debug breakpoints remove <point>    移除断点\n  otto debug breakpoints enable <point>    启用断点\n  otto debug breakpoints disable <point>   禁用断点\n  otto debug breakpoints enable-all        全部启用\n  otto debug breakpoints disable-all       全部禁用\n  otto debug points                        列出所有可用断点位\n  otto debug state                         调试器状态（断点统计 + 挂起的暂停）\n\n选项:\n  --remote <url>   service 地址（默认 OTTO_SERVICE_URL 或 http:\n\n断点位（BREAKPOINT_POINTS）:\n${POINT_NAMES.map((p) => `  ${p}`).join('\\n')}\n\n注：需要 \\`otto serve --inspect\\` 启动的 service（调试器默认关闭）。\nresume/inject 等运行时命令经 REST：POST /api/debugger/resume | /inject。\n`)\n    return 0\n  }\n\n  const client = createServiceClient(baseUrl, deps.fetch)\n\n  try {\n    switch (action) {\n      case 'breakpoints': {\n        const op = sub[0]\n        switch (op) {\n          case 'list':\n            return await listBreakpoints(client, stdout)\n          case 'set':\n            return await setBreakpoint(client, sub[1], true, stdout, stderr)\n          case 'remove':\n            return await setBreakpoint(client, sub[1], false, stdout, stderr, 'removed')\n          case 'enable':\n            return await setBreakpoint(client, sub[1], true, stdout, stderr, 'enabled')\n          case 'disable':\n            return await setBreakpoint(client, sub[1], false, stdout, stderr, 'disabled')\n          case 'enable-all':\n            await client.post('/api/debugger/breakpoints/enable-all')\n            stdout('All breakpoints enabled.\\n')\n            return 0\n          case 'disable-all':\n            await client.post('/api/debugger/breakpoints/disable-all')\n            stdout('All breakpoints disabled.\\n')\n            return 0\n          default:\n            stderr(`otto debug breakpoints: unknown sub-action '${op}'.\\n`)\n            return 1\n        }\n      }\n      case 'points':\n        return await listPoints(client, stdout)\n      case 'state':\n        return await showState(client, stdout)\n      default:\n        stderr(`otto debug: unknown action '${action}'. Use breakpoints | points | state.\\n`)\n        return 1\n    }\n  } catch (error) {\n    return reportServiceError('debug', error, stderr)\n  }\n}\n\nasync function listBreakpoints(client: ServiceClient, stdout: (s: string) => void): Promise<number> {\n  const { breakpoints } = await client.get<{ breakpoints: BreakpointEntry[] }>(\n    '/api/debugger/breakpoints',\n  )\n  if (breakpoints.length === 0) {\n    stdout('No breakpoints set.\\n')\n    return 0\n  }\n  stdout(`${'point'.padEnd(36)} enabled\\n${'-'.repeat(46)}\\n`)\n  for (const bp of breakpoints) {\n    stdout(`${bp.point.padEnd(36)} ${bp.enabled ? '✓' : '✗'}\\n`)\n  }\n  return 0\n}\n\nfunction isValidPoint(point: string | undefined): point is string {\n  return !!point && POINT_NAMES.includes(point)\n}\n\nasync function setBreakpoint(\n  client: ServiceClient,\n  point: string | undefined,\n  enabled: boolean,\n  stdout: (s: string) => void,\n  stderr: (s: string) => void,\n  verb?: string,\n): Promise<number> {\n  if (!isValidPoint(point)) {\n    stderr(\n      `otto debug: invalid or missing breakpoint point.\\nUse 'otto debug points' to list valid points.\\n`,\n    )\n    return 1\n  }\n  await client.put(`/api/debugger/breakpoints/${point}`, { enabled })\n  stdout(`Breakpoint ${verb ?? `set: ${point} (${enabled ? 'enabled' : 'disabled'})`}${verb ? `: ${point}` : ''}\\n`)\n  return 0\n}\n\nasync function listPoints(client: ServiceClient, stdout: (s: string) => void): Promise<number> {\n  const { breakpoints } = await client.get<{ breakpoints: BreakpointEntry[] }>(\n    '/api/debugger/breakpoints',\n  )\n  const byPoint = new Map(breakpoints.map((bp) => [bp.point, bp]))\n\n  stdout('Available breakpoint points:\\n')\n  for (const def of BREAKPOINT_POINTS) {\n    const bp = byPoint.get(def.point)\n    const status = bp?.set ? (bp.enabled ? 'enabled' : 'disabled') : 'not set'\n    stdout(`  ${def.point.padEnd(36)} ${status}\\n`)\n  }\n  return 0\n}\n\nasync function showState(client: ServiceClient, stdout: (s: string) => void): Promise<number> {\n  const state = await client.get<{\n    breakpoints: { total: number; enabled: number }\n    paused: boolean\n    pendingPauses: { pauseId: string; point: string; turn: number }[]\n  }>('/api/debugger/state')\n\n  stdout(`Debugger state\n  breakpoints: ${state.breakpoints.enabled}/${state.breakpoints.total} enabled\n  paused:      ${state.paused ? 'yes' : 'no'}\n`)\n  for (const p of state.pendingPauses) {\n    stdout(`  ⏸ ${p.point} (turn ${p.turn}) pauseId=${p.pauseId}\\n`)\n  }\n  return 0\n}\n","/**\n * `otto time-travel` 子命令 —— 回放+回滚面板。\n *\n * 设计依据：design/observability-platform.md §4/§5 + design/m17-platform-activation.md §3。\n * 数据源 = service REST（timetravel 路由）。默认连 `otto serve` 实例，`--remote <url>` 覆盖。\n */\nimport { SERVICE_URL } from '@x-otto/env'\n\nimport {\n  createServiceClient,\n  reportServiceError,\n  resolveRemote,\n  type ServiceClient,\n} from './service-client'\n\nexport interface TimeTravelDeps {\n  stdout?: (s: string) => void\n  stderr?: (s: string) => void\n  /** fetch 注入（测试用）。 */\n  fetch?: typeof globalThis.fetch\n}\n\ninterface CheckpointInfo {\n  seq: number\n  label?: string\n  createdAt: number\n  traceSeq?: number\n}\n\ninterface TracebackView {\n  toSeq: number\n  baselineCheckpointSeq: number | null\n  fromTraceSeq: number\n  events: unknown[]\n  messages: { role: string; content: unknown }[]\n}\n\nexport async function runTimeTravelCommand(\n  args: string[],\n  deps: TimeTravelDeps = {},\n): Promise<number> {\n  const stdout = deps.stdout ?? ((s) => process.stdout.write(s))\n  const stderr = deps.stderr ?? ((s) => process.stderr.write(s))\n\n  let baseUrl: string\n  let rest: string[]\n  try {\n    ;({ baseUrl, rest } = resolveRemote(args))\n  } catch (error) {\n    return reportServiceError('time-travel', error, stderr)\n  }\n\n  const [action, sessionId, ...extra] = rest\n\n  if (!action || action === 'help') {\n    stdout(`otto time-travel — 回放+回滚面板\n\n用法:\n  otto time-travel checkpoints <session-id>           列出所有 checkpoint\n  otto time-travel checkpoint <session-id> [--label X] 创建新 checkpoint\n  otto time-travel scrubber <session-id> <seq>         显示 traceback 视图\n  otto time-travel restore <session-id> <seq> [--mode M] [--rollback]\n                                                          恢复/回滚 (mode: conversation|code|both)\n  otto time-travel fork <session-id> <seq>             从 checkpoint 分叉新会话\n  otto time-travel replay <session-id>                 启动确定性重放\n\n选项:\n  --remote <url>   service 地址（默认 OTTO_SERVICE_URL 或 ${SERVICE_URL}）\n`)\n    return 0\n  }\n\n  if (!sessionId) {\n    stderr('otto time-travel: session-id is required.\\n')\n    return 1\n  }\n\n  const client = createServiceClient(baseUrl, deps.fetch)\n\n  try {\n    switch (action) {\n      case 'checkpoints':\n        return await listCheckpoints(client, sessionId, stdout)\n      case 'checkpoint':\n        return await createCheckpoint(client, sessionId, extra, stdout)\n      case 'scrubber':\n        return await showScrubber(client, sessionId, extra[0], stdout, stderr)\n      case 'restore':\n        return await restoreCheckpoint(client, sessionId, extra, stdout, stderr)\n      case 'fork':\n        return await forkCheckpoint(client, sessionId, extra[0], stdout, stderr)\n      case 'replay':\n        return await startReplay(client, sessionId, stdout)\n      default:\n        stderr(`otto time-travel: unknown action '${action}'.\\n`)\n        return 1\n    }\n  } catch (error) {\n    return reportServiceError('time-travel', error, stderr)\n  }\n}\n\nasync function listCheckpoints(\n  client: ServiceClient,\n  sessionId: string,\n  stdout: (s: string) => void,\n): Promise<number> {\n  const { checkpoints } = await client.get<{ checkpoints: CheckpointInfo[] }>(\n    `/api/sessions/${sessionId}/checkpoints`,\n  )\n  if (checkpoints.length === 0) {\n    stdout(`Session ${sessionId}: no checkpoints found.\\n`)\n    return 0\n  }\n\n  stdout(`Checkpoints — ${sessionId} (${checkpoints.length})\\n`)\n  stdout(`${'seq'.padStart(4)} ${'traceSeq'.padStart(9)} ${'label'.padEnd(24)} ${'created'}\\n`)\n  stdout(`${'-'.repeat(70)}\\n`)\n  for (const cp of checkpoints) {\n    const label = (cp.label ?? '').padEnd(24)\n    const created = new Date(cp.createdAt).toISOString()\n    const traceSeq = cp.traceSeq !== undefined ? String(cp.traceSeq).padStart(9) : '        -'\n    stdout(`${String(cp.seq).padStart(4)} ${traceSeq} ${label} ${created}\\n`)\n  }\n  return 0\n}\n\nasync function createCheckpoint(\n  client: ServiceClient,\n  sessionId: string,\n  rest: string[],\n  stdout: (s: string) => void,\n): Promise<number> {\n  const labelIdx = rest.indexOf('--label')\n  const label = labelIdx >= 0 ? rest[labelIdx + 1] : undefined\n\n  const { checkpoint } = await client.post<{ checkpoint: CheckpointInfo }>(\n    `/api/sessions/${sessionId}/checkpoints`,\n    { label },\n  )\n  stdout(\n    `Checkpoint created: seq=${checkpoint.seq}${checkpoint.label ? ` label=\"${checkpoint.label}\"` : ''} traceSeq=${checkpoint.traceSeq}\\n`,\n  )\n  return 0\n}\n\nasync function showScrubber(\n  client: ServiceClient,\n  sessionId: string,\n  seqRaw: string | undefined,\n  stdout: (s: string) => void,\n  stderr: (s: string) => void,\n): Promise<number> {\n  const seq = Number(seqRaw)\n  if (!Number.isInteger(seq)) {\n    stderr('otto time-travel scrubber: seq (integer) is required.\\n')\n    return 1\n  }\n\n  const view = await client.get<TracebackView>(`/api/sessions/${sessionId}/traceback?to=${seq}`)\n\n  stdout(`Traceback — ${sessionId} @ seq=${view.toSeq}\\n`)\n  if (view.baselineCheckpointSeq !== null) {\n    stdout(`  Baseline: checkpoint seq=${view.baselineCheckpointSeq} (fromTraceSeq=${view.fromTraceSeq})\\n`)\n  } else {\n    stdout(`  Baseline: none (folded from seq 0)\\n`)\n  }\n  stdout(`  Events folded: ${view.events.length}\\n`)\n  stdout(`  Messages reconstructed: ${view.messages.length}\\n\\n`)\n\n  for (const msg of view.messages) {\n    const role = msg.role.padEnd(12)\n    const content =\n      typeof msg.content === 'string'\n        ? msg.content.slice(0, 120)\n        : JSON.stringify(msg.content).slice(0, 120)\n    stdout(`  ${role} ${content}\\n`)\n  }\n  return 0\n}\n\nasync function restoreCheckpoint(\n  client: ServiceClient,\n  sessionId: string,\n  rest: string[],\n  stdout: (s: string) => void,\n  stderr: (s: string) => void,\n): Promise<number> {\n  const seq = Number(rest[0])\n  if (!Number.isInteger(seq)) {\n    stderr('otto time-travel restore: seq (integer) is required.\\n')\n    return 1\n  }\n\n  const modeIdx = rest.indexOf('--mode')\n  const modeRaw = modeIdx >= 0 ? rest[modeIdx + 1] : 'both'\n  if (modeRaw !== 'conversation' && modeRaw !== 'code' && modeRaw !== 'both') {\n    stderr(`otto time-travel restore: invalid mode '${modeRaw}'. Use conversation | code | both.\\n`)\n    return 1\n  }\n  const rollback = rest.includes('--rollback')\n\n  await client.post(`/api/sessions/${sessionId}/checkpoints/${seq}/restore`, {\n    mode: modeRaw,\n    truncate: rollback,\n  })\n  stdout(`Restored to checkpoint seq=${seq} mode=${modeRaw} rollback=${rollback}\\n`)\n  return 0\n}\n\nasync function forkCheckpoint(\n  client: ServiceClient,\n  sessionId: string,\n  seqRaw: string | undefined,\n  stdout: (s: string) => void,\n  stderr: (s: string) => void,\n): Promise<number> {\n  const seq = Number(seqRaw)\n  if (!Number.isInteger(seq)) {\n    stderr('otto time-travel fork: seq (integer) is required.\\n')\n    return 1\n  }\n\n  const result = await client.post<{ forkedSessionId: string }>(\n    `/api/sessions/${sessionId}/checkpoints/${seq}/fork`,\n    {},\n  )\n  stdout(`Forked session: ${result.forkedSessionId} (from ${sessionId} @ seq=${seq})\\n`)\n  return 0\n}\n\nasync function startReplay(\n  client: ServiceClient,\n  sessionId: string,\n  stdout: (s: string) => void,\n): Promise<number> {\n  const result = await client.post<{ replaySessionId: string }>(\n    `/api/sessions/${sessionId}/replay`,\n    {},\n  )\n  stdout(`Replay session created: ${result.replaySessionId} (source: ${sessionId})\\n`)\n  return 0\n}\n","/**\n * `otto observe` 子命令 —— 观测面板：trace 时间线 / 摘要 / span 树。\n *\n * 设计依据：design/observability-platform.md §4/§5 + design/m17-platform-activation.md §3。\n * 数据源 = service REST。\n * 默认连 `http://127.0.0.1:${SERVICE_PORT}`（`otto serve` 启动），`--remote <url>` 覆盖；\n * service 不可达 → 明确报错而非静默空数据。聚合算法在 @x-otto/agent，两端同源。\n */\nimport { SERVICE_URL } from '@x-otto/env'\n\nimport {\n  createServiceClient,\n  reportServiceError,\n  resolveRemote,\n  type ServiceClient,\n} from './service-client'\nimport { runDebugCommand } from './debug'\nimport { runTimeTravelCommand } from './time-travel'\nimport type { TraceSpan, TraceSummary } from '@x-otto/agent'\nimport type { TraceTimelineView } from '@x-otto/trace-view'\n\nexport interface ObserveDeps {\n  /** 输出（便于测试注入）。 */\n  stdout?: (s: string) => void\n  stderr?: (s: string) => void\n  /** fetch 注入（测试用）。 */\n  fetch?: typeof globalThis.fetch\n}\n\nexport async function runObserveCommand(\n  args: string[],\n  deps: ObserveDeps = {},\n): Promise<number> {\n  const stdout = deps.stdout ?? ((s) => process.stdout.write(s))\n  const stderr = deps.stderr ?? ((s) => process.stderr.write(s))\n\n  // RFC-367 M4：observe 吸收 debug/time-travel 为子命令。\n  // `otto observe debug ...` → runDebugCommand\n  // `otto observe replay ...` → runTimeTravelCommand\n  const [subCommand, ...subRest] = args\n  if (subCommand === 'debug') {\n    return runDebugCommand(subRest, deps)\n  }\n  if (subCommand === 'replay') {\n    return runTimeTravelCommand(subRest, deps)\n  }\n\n  // 提取 --json 标志（在 resolveRemote 之前，避免被当作 remote URL）\n  const jsonIdx = args.indexOf('--json')\n  const json = jsonIdx >= 0\n  const cleanArgs = json ? args.filter((_, i) => i !== jsonIdx) : args\n\n  let baseUrl: string\n  let rest: string[]\n  try {\n    ;({ baseUrl, rest } = resolveRemote(cleanArgs))\n  } catch (error) {\n    return reportServiceError('observe', error, stderr)\n  }\n\n  const [action, sessionId] = rest\n\n  if (!action || action === 'help') {\n    stdout(`otto observe — 观测面板（trace 时间线 / 摘要 / span 树）\n\n用法:\n  otto observe summary <session-id>    trace 聚合统计\n  otto observe timeline <session-id>   文本时间线\n  otto observe spans <session-id>      span 树视图\n  otto observe debug <action> [...]   调试面板（breakpoints / points / state）\n  otto observe replay <action> <id>   时间旅行（checkpoints / scrubber / restore / fork / replay）\n\n选项:\n  --remote <url>   service 地址（默认 OTTO_SERVICE_URL 或 ${SERVICE_URL}）\n  --json           输出结构化 JSON（需 service 运行）\n`)\n    return 0\n  }\n\n  if (!sessionId) {\n    stderr('otto observe: session-id is required.\\n')\n    return 1\n  }\n\n  const client = createServiceClient(baseUrl, deps.fetch)\n\n  try {\n    // --json 模式：调用 /trace/timeline 输出结构化 JSON\n    if (json) {\n      return await observeJson(client, sessionId, stdout, stderr)\n    }\n    switch (action) {\n      case 'summary':\n        return await observeSummary(client, sessionId, stdout)\n      case 'timeline':\n        return await observeTimeline(client, sessionId, stdout)\n      case 'spans':\n        return await observeSpans(client, sessionId, stdout)\n      default:\n        stderr(`otto observe: unknown action '${action}'. Use summary | timeline | spans.\\n`)\n        return 1\n    }\n  } catch (error) {\n    return reportServiceError('observe', error, stderr)\n  }\n}\n\nfunction fetchSpans(client: ServiceClient, sessionId: string): Promise<{ spans: TraceSpan[] }> {\n  return client.get<{ spans: TraceSpan[] }>(`/api/sessions/${sessionId}/trace/spans`)\n}\n\nasync function observeSummary(\n  client: ServiceClient,\n  sessionId: string,\n  stdout: (s: string) => void,\n): Promise<number> {\n  const summary = await client.get<TraceSummary>(`/api/sessions/${sessionId}/trace/summary`)\n\n  if (summary.totalEvents === 0) {\n    stdout(`Session ${sessionId}: no trace events found.\\n`)\n    return 0\n  }\n\n  const { totalEvents, kinds, turns, toolCalls, firstTs, lastTs } = summary\n  const duration = firstTs !== undefined && lastTs !== undefined ? `${lastTs - firstTs}ms` : 'N/A'\n\n  stdout(`Trace Summary — ${sessionId}\n──────────────────────────────────────────\n  Total events:     ${totalEvents}\n  Turns:            ${turns}\n  Tool calls:       ${toolCalls}\n  Time span:        ${duration}\n  First event:      ${firstTs ? new Date(firstTs).toISOString() : 'N/A'}\n  Last event:       ${lastTs ? new Date(lastTs).toISOString() : 'N/A'}\n\n  By kind:\n${Object.entries(kinds).map(([k, v]) => `    ${k.padEnd(14)} ${v}`).join('\\n')}\n`)\n  return 0\n}\n\nasync function observeTimeline(\n  client: ServiceClient,\n  sessionId: string,\n  stdout: (s: string) => void,\n): Promise<number> {\n  const { spans } = await fetchSpans(client, sessionId)\n  if (spans.length === 0) {\n    stdout(`Session ${sessionId}: no trace events found.\\n`)\n    return 0\n  }\n\n  const lines = spans.map((span) => {\n    const ts = new Date(span.ts).toISOString().slice(11, 23)\n    const turn = span.turn !== undefined ? `T${String(span.turn).padStart(2)}` : '  -'\n    const node = (span.node ?? '').padEnd(26)\n    return `${String(span.seq).padStart(5)} ${ts} ${turn} ${span.kind.padEnd(12)} ${node}${span.digest ?? ''}`\n  })\n\n  stdout(`Trace Timeline — ${sessionId} (${lines.length} events)\n${'seq'.padStart(5)} ${'time'}       ${'turn'} ${'kind'.padEnd(12)} ${'node'.padEnd(26)} digest\n${'-'.repeat(100)}\n${lines.join('\\n')}\n`)\n  return 0\n}\n\nasync function observeSpans(\n  client: ServiceClient,\n  sessionId: string,\n  stdout: (s: string) => void,\n): Promise<number> {\n  const { spans } = await fetchSpans(client, sessionId)\n  if (spans.length === 0) {\n    stdout(`Session ${sessionId}: no trace events found.\\n`)\n    return 0\n  }\n\n  const turnSpans = new Map<number, TraceSpan[]>()\n  let maxTurn = -1\n  for (const span of spans) {\n    const turn = span.turn ?? 0\n    if (turn > maxTurn) maxTurn = turn\n    const group = turnSpans.get(turn) ?? []\n    group.push(span)\n    turnSpans.set(turn, group)\n  }\n\n  stdout(`Trace Spans — ${sessionId} (${maxTurn + 1} turns)\n`)\n  for (let t = 0; t <= maxTurn; t++) {\n    const group = turnSpans.get(t)\n    if (!group) continue\n    stdout(`▼ Turn ${t} (${group.length} events)\\n`)\n    for (const span of group) {\n      const node = span.node ? `[${span.node}] ` : ''\n      stdout(`  ├─ ${span.kind.padEnd(12)} ${node}${span.digest ?? ''}\\n`)\n    }\n  }\n  return 0\n}\n\nasync function observeJson(\n  client: ServiceClient,\n  sessionId: string,\n  stdout: (s: string) => void,\n  stderr: (s: string) => void,\n): Promise<number> {\n  try {\n    const timeline = await client.get<TraceTimelineView>(\n      `/api/sessions/${sessionId}/trace/timeline`,\n    )\n    stdout(`${JSON.stringify(timeline, null, 2)}\\n`)\n    return 0\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error)\n    stderr(`observe --json: ${msg}\\n`)\n    return 1\n  }\n}\n"],"mappings":";2JAgBA,MAAM,EAAiC,EAAkB,IAAK,GAAM,EAAE,MAAM,CAe5E,eAAsB,EACpB,EACA,EAAkB,EAAE,CACH,CACjB,IAAM,EAAS,EAAK,SAAY,GAAM,QAAQ,OAAO,MAAM,EAAE,EACvD,EAAS,EAAK,SAAY,GAAM,QAAQ,OAAO,MAAM,EAAE,EAEzD,EACA,EACJ,GAAI,EACA,mBAAoB,EAAc,EAAK,QAClC,EAAO,CACd,OAAO,EAAmB,QAAS,EAAO,EAAO,CAGnD,GAAM,CAAC,EAAQ,GAAG,GAAO,EAEzB,GAAI,CAAC,GAAU,IAAW,OAuBxB,OAtBA,EAAO;;;;;;;;;;;;;;;;;EAiBT,EAAY,IAAK,GAAM,KAAK,IAAI,CAAC,KAAK;EAAK,CAAC;;;;EAI5C,CACS,EAGT,IAAM,EAAS,EAAoB,EAAS,EAAK,MAAM,CAEvD,GAAI,CACF,OAAQ,EAAR,CACE,IAAK,cAAe,CAClB,IAAM,EAAK,EAAI,GACf,OAAQ,EAAR,CACE,IAAK,OACH,OAAO,MAAM,EAAgB,EAAQ,EAAO,CAC9C,IAAK,MACH,OAAO,MAAM,EAAc,EAAQ,EAAI,GAAI,GAAM,EAAQ,EAAO,CAClE,IAAK,SACH,OAAO,MAAM,EAAc,EAAQ,EAAI,GAAI,GAAO,EAAQ,EAAQ,UAAU,CAC9E,IAAK,SACH,OAAO,MAAM,EAAc,EAAQ,EAAI,GAAI,GAAM,EAAQ,EAAQ,UAAU,CAC7E,IAAK,UACH,OAAO,MAAM,EAAc,EAAQ,EAAI,GAAI,GAAO,EAAQ,EAAQ,WAAW,CAC/E,IAAK,aAGH,OAFA,MAAM,EAAO,KAAK,uCAAuC,CACzD,EAAO;EAA6B,CAC7B,EACT,IAAK,cAGH,OAFA,MAAM,EAAO,KAAK,wCAAwC,CAC1D,EAAO;EAA8B,CAC9B,EACT,QAEE,OADA,EAAO,+CAA+C,EAAG,MAAM,CACxD,GAGb,IAAK,SACH,OAAO,MAAM,EAAW,EAAQ,EAAO,CACzC,IAAK,QACH,OAAO,MAAM,EAAU,EAAQ,EAAO,CACxC,QAEE,OADA,EAAO,+BAA+B,EAAO,wCAAwC,CAC9E,SAEJ,EAAO,CACd,OAAO,EAAmB,QAAS,EAAO,EAAO,EAIrD,eAAe,EAAgB,EAAuB,EAA8C,CAClG,GAAM,CAAE,eAAgB,MAAM,EAAO,IACnC,4BACD,CACD,GAAI,EAAY,SAAW,EAEzB,OADA,EAAO;EAAwB,CACxB,EAET,EAAO,GAAG,QAAQ,OAAO,GAAG,CAAC,YAAY,IAAI,OAAO,GAAG,CAAC,IAAI,CAC5D,IAAK,IAAM,KAAM,EACf,EAAO,GAAG,EAAG,MAAM,OAAO,GAAG,CAAC,GAAG,EAAG,QAAU,IAAM,IAAI,IAAI,CAE9D,MAAO,GAGT,SAAS,EAAa,EAA4C,CAChE,MAAO,CAAC,CAAC,GAAS,EAAY,SAAS,EAAM,CAG/C,eAAe,EACb,EACA,EACA,EACA,EACA,EACA,EACiB,CASjB,OARK,EAAa,EAAM,EAMxB,MAAM,EAAO,IAAI,6BAA6B,IAAS,CAAE,UAAS,CAAC,CACnE,EAAO,cAAc,GAAQ,QAAQ,EAAM,IAAI,EAAU,UAAY,WAAW,KAAK,EAAO,KAAK,IAAU,GAAG,IAAI,CAC3G,IAPL,EACE;;EACD,CACM,GAOX,eAAe,EAAW,EAAuB,EAA8C,CAC7F,GAAM,CAAE,eAAgB,MAAM,EAAO,IACnC,4BACD,CACK,EAAU,IAAI,IAAI,EAAY,IAAK,GAAO,CAAC,EAAG,MAAO,EAAG,CAAC,CAAC,CAEhE,EAAO;EAAiC,CACxC,IAAK,IAAM,KAAO,EAAmB,CACnC,IAAM,EAAK,EAAQ,IAAI,EAAI,MAAM,CAC3B,EAAS,GAAI,IAAO,EAAG,QAAU,UAAY,WAAc,UACjE,EAAO,KAAK,EAAI,MAAM,OAAO,GAAG,CAAC,GAAG,EAAO,IAAI,CAEjD,MAAO,GAGT,eAAe,EAAU,EAAuB,EAA8C,CAC5F,IAAM,EAAQ,MAAM,EAAO,IAIxB,sBAAsB,CAEzB,EAAO;iBACQ,EAAM,YAAY,QAAQ,GAAG,EAAM,YAAY,MAAM;iBACrD,EAAM,OAAS,MAAQ,KAAK;EAC3C,CACA,IAAK,IAAM,KAAK,EAAM,cACpB,EAAO,OAAO,EAAE,MAAM,SAAS,EAAE,KAAK,YAAY,EAAE,QAAQ,IAAI,CAElE,MAAO,GCnJT,eAAsB,EACpB,EACA,EAAuB,EAAE,CACR,CACjB,IAAM,EAAS,EAAK,SAAY,GAAM,QAAQ,OAAO,MAAM,EAAE,EACvD,EAAS,EAAK,SAAY,GAAM,QAAQ,OAAO,MAAM,EAAE,EAEzD,EACA,EACJ,GAAI,EACA,mBAAoB,EAAc,EAAK,QAClC,EAAO,CACd,OAAO,EAAmB,cAAe,EAAO,EAAO,CAGzD,GAAM,CAAC,EAAQ,EAAW,GAAG,GAAS,EAEtC,GAAI,CAAC,GAAU,IAAW,OAexB,OAdA,EAAO;;;;;;;;;;;;sDAY2C,EAAY;EAChE,CACS,EAGT,GAAI,CAAC,EAEH,OADA,EAAO;EAA8C,CAC9C,EAGT,IAAM,EAAS,EAAoB,EAAS,EAAK,MAAM,CAEvD,GAAI,CACF,OAAQ,EAAR,CACE,IAAK,cACH,OAAO,MAAM,EAAgB,EAAQ,EAAW,EAAO,CACzD,IAAK,aACH,OAAO,MAAM,EAAiB,EAAQ,EAAW,EAAO,EAAO,CACjE,IAAK,WACH,OAAO,MAAM,EAAa,EAAQ,EAAW,EAAM,GAAI,EAAQ,EAAO,CACxE,IAAK,UACH,OAAO,MAAM,EAAkB,EAAQ,EAAW,EAAO,EAAQ,EAAO,CAC1E,IAAK,OACH,OAAO,MAAM,EAAe,EAAQ,EAAW,EAAM,GAAI,EAAQ,EAAO,CAC1E,IAAK,SACH,OAAO,MAAM,EAAY,EAAQ,EAAW,EAAO,CACrD,QAEE,OADA,EAAO,qCAAqC,EAAO,MAAM,CAClD,SAEJ,EAAO,CACd,OAAO,EAAmB,cAAe,EAAO,EAAO,EAI3D,eAAe,EACb,EACA,EACA,EACiB,CACjB,GAAM,CAAE,eAAgB,MAAM,EAAO,IACnC,iBAAiB,EAAU,cAC5B,CACD,GAAI,EAAY,SAAW,EAEzB,OADA,EAAO,WAAW,EAAU,2BAA2B,CAChD,EAGT,EAAO,iBAAiB,EAAU,IAAI,EAAY,OAAO,KAAK,CAC9D,EAAO,GAAG,MAAM,SAAS,EAAE,CAAC,GAAG,WAAW,SAAS,EAAE,CAAC,GAAG,QAAQ,OAAO,GAAG,CAAC,YAAiB,CAC7F,EAAO,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,CAC7B,IAAK,IAAM,KAAM,EAAa,CAC5B,IAAM,GAAS,EAAG,OAAS,IAAI,OAAO,GAAG,CACnC,EAAU,IAAI,KAAK,EAAG,UAAU,CAAC,aAAa,CAC9C,EAAW,EAAG,WAAa,IAAA,GAA8C,YAAlC,OAAO,EAAG,SAAS,CAAC,SAAS,EAAE,CAC5E,EAAO,GAAG,OAAO,EAAG,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,EAAS,GAAG,EAAM,GAAG,EAAQ,IAAI,CAE3E,MAAO,GAGT,eAAe,EACb,EACA,EACA,EACA,EACiB,CACjB,IAAM,EAAW,EAAK,QAAQ,UAAU,CAClC,EAAQ,GAAY,EAAI,EAAK,EAAW,GAAK,IAAA,GAE7C,CAAE,cAAe,MAAM,EAAO,KAClC,iBAAiB,EAAU,cAC3B,CAAE,QAAO,CACV,CAID,OAHA,EACE,2BAA2B,EAAW,MAAM,EAAW,MAAQ,WAAW,EAAW,MAAM,GAAK,GAAG,YAAY,EAAW,SAAS,IACpI,CACM,EAGT,eAAe,EACb,EACA,EACA,EACA,EACA,EACiB,CACjB,IAAM,EAAM,OAAO,EAAO,CAC1B,GAAI,CAAC,OAAO,UAAU,EAAI,CAExB,OADA,EAAO;EAA0D,CAC1D,EAGT,IAAM,EAAO,MAAM,EAAO,IAAmB,iBAAiB,EAAU,gBAAgB,IAAM,CAE9F,EAAO,eAAe,EAAU,SAAS,EAAK,MAAM,IAAI,CACpD,EAAK,wBAA0B,KAGjC,EAAO;EAAyC,CAFhD,EAAO,8BAA8B,EAAK,sBAAsB,iBAAiB,EAAK,aAAa,KAAK,CAI1G,EAAO,oBAAoB,EAAK,OAAO,OAAO,IAAI,CAClD,EAAO,6BAA6B,EAAK,SAAS,OAAO,MAAM,CAE/D,IAAK,IAAM,KAAO,EAAK,SAMrB,EAAO,KALM,EAAI,KAAK,OAAO,GAAG,CAKf,GAHf,OAAO,EAAI,SAAY,SACnB,EAAI,QAAQ,MAAM,EAAG,IAAI,CACzB,KAAK,UAAU,EAAI,QAAQ,CAAC,MAAM,EAAG,IAAI,CACnB,IAAI,CAElC,MAAO,GAGT,eAAe,EACb,EACA,EACA,EACA,EACA,EACiB,CACjB,IAAM,EAAM,OAAO,EAAK,GAAG,CAC3B,GAAI,CAAC,OAAO,UAAU,EAAI,CAExB,OADA,EAAO;EAAyD,CACzD,EAGT,IAAM,EAAU,EAAK,QAAQ,SAAS,CAChC,EAAU,GAAW,EAAI,EAAK,EAAU,GAAK,OACnD,GAAI,IAAY,gBAAkB,IAAY,QAAU,IAAY,OAElE,OADA,EAAO,2CAA2C,EAAQ,sCAAsC,CACzF,EAET,IAAM,EAAW,EAAK,SAAS,aAAa,CAO5C,OALA,MAAM,EAAO,KAAK,iBAAiB,EAAU,eAAe,EAAI,UAAW,CACzE,KAAM,EACN,SAAU,EACX,CAAC,CACF,EAAO,8BAA8B,EAAI,QAAQ,EAAQ,YAAY,EAAS,IAAI,CAC3E,EAGT,eAAe,EACb,EACA,EACA,EACA,EACA,EACiB,CACjB,IAAM,EAAM,OAAO,EAAO,CAW1B,OAVK,OAAO,UAAU,EAAI,EAS1B,EAAO,oBAJQ,MAAM,EAAO,KAC1B,iBAAiB,EAAU,eAAe,EAAI,OAC9C,EAAE,CACH,EACgC,gBAAgB,SAAS,EAAU,SAAS,EAAI,KAAK,CAC/E,IATL,EAAO;EAAsD,CACtD,GAWX,eAAe,EACb,EACA,EACA,EACiB,CAMjB,OADA,EAAO,4BAJQ,MAAM,EAAO,KAC1B,iBAAiB,EAAU,SAC3B,EAAE,CACH,EACwC,gBAAgB,YAAY,EAAU,KAAK,CAC7E,ECpNT,eAAsB,EACpB,EACA,EAAoB,EAAE,CACL,CACjB,IAAM,EAAS,EAAK,SAAY,GAAM,QAAQ,OAAO,MAAM,EAAE,EACvD,EAAS,EAAK,SAAY,GAAM,QAAQ,OAAO,MAAM,EAAE,EAKvD,CAAC,EAAY,GAAG,GAAW,EACjC,GAAI,IAAe,QACjB,OAAO,EAAgB,EAAS,EAAK,CAEvC,GAAI,IAAe,SACjB,OAAO,EAAqB,EAAS,EAAK,CAI5C,IAAM,EAAU,EAAK,QAAQ,SAAS,CAChC,EAAO,GAAW,EAClB,EAAY,EAAO,EAAK,QAAQ,EAAG,IAAM,IAAM,EAAQ,CAAG,EAE5D,EACA,EACJ,GAAI,EACA,mBAAoB,EAAc,EAAU,QACvC,EAAO,CACd,OAAO,EAAmB,UAAW,EAAO,EAAO,CAGrD,GAAM,CAAC,EAAQ,GAAa,EAE5B,GAAI,CAAC,GAAU,IAAW,OAcxB,OAbA,EAAO;;;;;;;;;;sDAU2C,EAAY;;EAEhE,CACS,EAGT,GAAI,CAAC,EAEH,OADA,EAAO;EAA0C,CAC1C,EAGT,IAAM,EAAS,EAAoB,EAAS,EAAK,MAAM,CAEvD,GAAI,CAEF,GAAI,EACF,OAAO,MAAM,EAAY,EAAQ,EAAW,EAAQ,EAAO,CAE7D,OAAQ,EAAR,CACE,IAAK,UACH,OAAO,MAAM,EAAe,EAAQ,EAAW,EAAO,CACxD,IAAK,WACH,OAAO,MAAM,EAAgB,EAAQ,EAAW,EAAO,CACzD,IAAK,QACH,OAAO,MAAM,EAAa,EAAQ,EAAW,EAAO,CACtD,QAEE,OADA,EAAO,iCAAiC,EAAO,sCAAsC,CAC9E,SAEJ,EAAO,CACd,OAAO,EAAmB,UAAW,EAAO,EAAO,EAIvD,SAAS,EAAW,EAAuB,EAAoD,CAC7F,OAAO,EAAO,IAA4B,iBAAiB,EAAU,cAAc,CAGrF,eAAe,EACb,EACA,EACA,EACiB,CACjB,IAAM,EAAU,MAAM,EAAO,IAAkB,iBAAiB,EAAU,gBAAgB,CAE1F,GAAI,EAAQ,cAAgB,EAE1B,OADA,EAAO,WAAW,EAAU,4BAA4B,CACjD,EAGT,GAAM,CAAE,cAAa,QAAO,QAAO,YAAW,UAAS,UAAW,EAelE,OAZA,EAAO,mBAAmB,EAAU;;sBAEhB,EAAY;sBACZ,EAAM;sBACN,EAAU;sBANb,IAAY,IAAA,IAAa,IAAW,IAAA,GAAY,GAAG,EAAS,EAAQ,IAAM,MAO9D;sBACT,EAAU,IAAI,KAAK,EAAQ,CAAC,aAAa,CAAG,MAAM;sBAClD,EAAS,IAAI,KAAK,EAAO,CAAC,aAAa,CAAG,MAAM;;;EAGpE,OAAO,QAAQ,EAAM,CAAC,KAAK,CAAC,EAAG,KAAO,OAAO,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK;EAAK,CAAC;EAC7E,CACO,EAGT,eAAe,EACb,EACA,EACA,EACiB,CACjB,GAAM,CAAE,SAAU,MAAM,EAAW,EAAQ,EAAU,CACrD,GAAI,EAAM,SAAW,EAEnB,OADA,EAAO,WAAW,EAAU,4BAA4B,CACjD,EAGT,IAAM,EAAQ,EAAM,IAAK,GAAS,CAChC,IAAM,EAAK,IAAI,KAAK,EAAK,GAAG,CAAC,aAAa,CAAC,MAAM,GAAI,GAAG,CAClD,EAAO,EAAK,OAAS,IAAA,GAAkD,MAAtC,IAAI,OAAO,EAAK,KAAK,CAAC,SAAS,EAAE,GAClE,GAAQ,EAAK,MAAQ,IAAI,OAAO,GAAG,CACzC,MAAO,GAAG,OAAO,EAAK,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,EAAG,GAAG,EAAK,GAAG,EAAK,KAAK,OAAO,GAAG,CAAC,GAAG,IAAO,EAAK,QAAU,MACtG,CAOF,OALA,EAAO,oBAAoB,EAAU,IAAI,EAAM,OAAO;EACtD,MAAM,SAAS,EAAE,CAAC,mBAA6B,OAAO,OAAO,GAAG,CAAC,GAAG,OAAO,OAAO,GAAG,CAAC;EACtF,IAAI,OAAO,IAAI,CAAC;EAChB,EAAM,KAAK;EAAK,CAAC;EACjB,CACO,EAGT,eAAe,EACb,EACA,EACA,EACiB,CACjB,GAAM,CAAE,SAAU,MAAM,EAAW,EAAQ,EAAU,CACrD,GAAI,EAAM,SAAW,EAEnB,OADA,EAAO,WAAW,EAAU,4BAA4B,CACjD,EAGT,IAAM,EAAY,IAAI,IAClB,EAAU,GACd,IAAK,IAAM,KAAQ,EAAO,CACxB,IAAM,EAAO,EAAK,MAAQ,EACtB,EAAO,IAAS,EAAU,GAC9B,IAAM,EAAQ,EAAU,IAAI,EAAK,EAAI,EAAE,CACvC,EAAM,KAAK,EAAK,CAChB,EAAU,IAAI,EAAM,EAAM,CAG5B,EAAO,iBAAiB,EAAU,IAAI,EAAU,EAAE;EAClD,CACA,IAAK,IAAI,EAAI,EAAG,GAAK,EAAS,IAAK,CACjC,IAAM,EAAQ,EAAU,IAAI,EAAE,CACzB,KACL,GAAO,UAAU,EAAE,IAAI,EAAM,OAAO,YAAY,CAChD,IAAK,IAAM,KAAQ,EAAO,CACxB,IAAM,EAAO,EAAK,KAAO,IAAI,EAAK,KAAK,IAAM,GAC7C,EAAO,QAAQ,EAAK,KAAK,OAAO,GAAG,CAAC,GAAG,IAAO,EAAK,QAAU,GAAG,IAAI,GAGxE,MAAO,GAGT,eAAe,EACb,EACA,EACA,EACA,EACiB,CACjB,GAAI,CACF,IAAM,EAAW,MAAM,EAAO,IAC5B,iBAAiB,EAAU,iBAC5B,CAED,OADA,EAAO,GAAG,KAAK,UAAU,EAAU,KAAM,EAAE,CAAC,IAAI,CACzC,QACA,EAAO,CAGd,OADA,EAAO,mBADK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,CACpC,IAAI,CAC3B"}

package/dist/parse-cli-CqocMnXY.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{ot as e}from"./command-dispatcher-ZyrfHgIk.js";import{t}from"./version-Cq2kcrXL.js";import{resolve as n}from"node:path";var r=e({SUB_COMMAND_NAMES:()=>i,getHelpLines:()=>c,parseCLI:()=>s});const i=new Set([`run`,`serve`,`daemon`,`doctor`,`config`,`migrate`,`auth`,`observe`,`debug`,`time-travel`,`mcp`,`persistenced`,`remote-persistence-server`,`persistence`,`extension`,`ps`,`feedback`]),a=new Map([{flags:[`--print`,`-p`],type:`mode`,value:`print`},{flags:[`--interactive`,`-i`],type:`mode`,value:`interactive`},{flags:[`--json`],type:`mode`,value:`json`},{flags:[`--model`,`-m`],type:`string`,key:`model`},{flags:[`--config`,`-c`],type:`string`,key:`configPath`},{flags:[`--project`,`-d`],type:`path`,key:`projectDir`},{flags:[`--quiet`,`-q`],type:`boolean`,key:`quiet`},{flags:[`--verbose`],type:`boolean`,key:`verbose`},{flags:[`--max-tool-turns`],type:`number`,key:`maxToolTurns`},{flags:[`--max-tool-turn-extensions`],type:`number`,key:`maxToolTurnExtensions`},{flags:[`--prompt-token-budget`],type:`number`,key:`promptTokenBudget`},{flags:[`--prompt-time-budget`],type:`number`,key:`promptTimeBudgetMin`},{flags:[`--session-cost-budget`],type:`number`,key:`sessionCostBudget`},{flags:[`--no-stall-detection`],type:`boolean`,key:`noStallDetection`},{flags:[`--stall-window-turns`],type:`number`,key:`stallWindowTurns`},{flags:[`--stall-repeat-threshold`],type:`number`,key:`stallRepeatThreshold`},{flags:[`--continue`],type:`string`,key:`continueSession`},{flags:[`--attach`],type:`string`,key:`attachSession`},{flags:[`--force-write-lease`],type:`boolean`,key:`forceWriteLease`},{flags:[`--memory-restart-grace`],type:`boolean`,key:`memoryRestartGrace`},{flags:[`--resume-prompt`],type:`string`,key:`resumePrompt`},{flags:[`--session-url`],type:`string`,key:`sessionUrl`},{flags:[`--session-token`],type:`string`,key:`sessionToken`},{flags:[`--id`],type:`string`,key:`workspaceId`},{flags:[`--shadow`],type:`boolean`,key:`shadow`},{flags:[`--help`,`-h`],type:`boolean`,key:`showHelp`},{flags:[`--version`,`-v`],type:`action`,handler:l}].flatMap(e=>e.flags.map(t=>[t,e])));var o=class{i;constructor(e){this.args=e,this.i=0}current(){return this.args[this.i]}next(){return this.args[++this.i]}advance(){this.i++}skip(e){this.i+=e}pos(){return this.i}};function s(e){let t=e.slice(2),r=new o(t),s={mode:`interactive`,projectDir:process.cwd(),verbose:!1,quiet:!1},c=r.current(),l,u=``,d,f;c&&i.has(c)?(l=c,u=t.slice(1).join(` `),r.skip(1),l===`run`&&(s.prompt=t.slice(1).filter(e=>!e.startsWith(`-`)).join(` `),s.mode=`print`)):c&&!c.startsWith(`-`)&&(d=c,f=t.slice(1));let p=s.prompt?[s.prompt]:[];for(;r.current()!==void 0;){let e=r.current();if(e===`--inspect`){s.inspect=!0,r.advance();continue}if(e?.startsWith(`--inspect=`)){let t=Number(e.slice(10));s.inspect=Number.isInteger(t)&&t>0?t:!0,r.advance();continue}if(e?.startsWith(`--restart-generation=`)){let t=Number(e.slice(21));Number.isInteger(t)&&t>0&&(s.restartGeneration=t),r.advance();continue}let t=a.get(e);if(t){switch(r.advance(),t.type){case`boolean`:s[t.key]=!0;break;case`mode`:s.mode=t.value;break;case`string`:s[t.key]=r.current(),r.advance();break;case`number`:s[t.key]=Number(r.current()),r.advance();break;case`path`:s[t.key]=n(r.current()??process.cwd()),r.advance();break;case`action`:t.handler();break}continue}e&&!e.startsWith(`-`)&&!l&&(s.prompt===void 0&&s.mode===`interactive`&&(s.mode=`print`),p.push(e)),r.advance()}return p.length>0&&(s.prompt=p.join(` `)),{options:s,subCommand:l,subCommandArgs:u,unresolvedCommandName:d,unresolvedCommandArgs:f}}function c(){return[``,`otto - AI 助理命令行工具`,``,`用法:`,`  otto [提示词]              使用提示词启动（print 模式）`,`  otto                       进入交互式 TUI 模式`,`  otto --json "query"        JSON 输出模式`,``,`选项:`,`  -i, --interactive         Interactive 模式（默认）`,`  -p, --print               Print 模式（非交互）`,`  --json                    JSON 输出模式`,`  -m, --model <id>          指定模型`,`  -c, --config <path>       配置文件路径`,`  -d, --project <dir>       项目目录`,`  --verbose                 输出详细日志`,`  -q, --quiet               只输出 error 日志`,`  --shadow                  影子模式：otto 自有状态（凭据/会话/记忆/教训/配置/trace/日志）本次会话零磁盘写入（不保证 provider 服务端日志与 shell/OS 层痕迹；RFC-345）`,`  --max-tool-turns <n>      单个用户回合最大工具回合数（默认 120）`,`  --max-tool-turn-extensions <n>  触顶后压缩续跑的扩展次数（默认主会话 3 / 子 agent 0）`,`  --prompt-token-budget <n> 单回合输出 token 预算（配置后轮次上限 ×4 退位安全阀；RFC-104）`,`  --prompt-time-budget <min> 单回合墙钟时间预算（分钟）`,`  --session-cost-budget <usd> 会话累计成本软预算（美元，超过一次性提醒不阻断；RFC-204）`,`  --no-stall-detection      关闭早期停滞检测（默认开启；RFC-203）`,`  --stall-window-turns <n>  停滞检测滑动窗口大小（需与 --stall-repeat-threshold 同时提供，默认 8）`,`  --stall-repeat-threshold <n> 停滞检测同签名重复阈值（需与 --stall-window-turns 同时提供，默认 4）`,`  --continue <id>           继续已有会话`,`  --session-url <url>       远端会话持久化地址（如 http://host:3001/sessions）`,`  --session-token <token>   远端会话持久化 Bearer token`,`  --inspect[=port]          启用 Node.js inspector（默认: 9229）`,`  -h, --help                显示帮助`,`  --version, -v             显示版本`,``,`命令:`,`  otto run <prompt>              执行一次性任务`,`  otto serve [--port N] [--inspect] [--static <dir>] [--token <t>]  启动 HTTP/WS service（--static 同源托管前端 SPA，--token 启用鉴权）`,`  otto doctor [--summary|--json] 环境健康检查（环境/配置/存储状态/连通性）`,`  otto auth login <provider>     登录（cursor / anthropic / openai-codex / github-copilot）`,`  otto auth status               查看各 provider 凭据来源`,`  otto auth logout <provider>    注销并清除凭据`,`  otto config export [--project] [-o <path>]  导出配置（RFC-219）`,`  otto config import <file> [--dry-run] [--scope global|project] [--no-plugins] [--plugins-only] [--yes]  导入配置`,`  otto config restore [--list]   撤销最近一次导入`,`  otto migrate export [--no-sessions] [-o <path>]  导出配置+插件清单+会话数据为迁移包（换电脑用）`,`  otto migrate import <archive> [--no-sessions]    导入迁移包（目标已有会话数据时跳过会话部分）`,`  otto observe <action> <id>     观测面板（summary / timeline / spans）`,`  otto observe debug <action> [...]      调试面板（breakpoints / points / state）`,`  otto observe replay <action> <id>     时间旅行（checkpoints / scrubber / restore / fork / replay）`,`  otto debug <action> [...]      (alias: otto observe debug)`,`  otto time-travel <action> <id> (alias: otto observe replay)`,`  otto mcp login <name>         MCP server OAuth 登录`,`  otto mcp logout <name>        登出 MCP server`,`  otto mcp list                 列出已认证的 MCP server`,`  otto extension create <name>     生成插件骨架（命令 + 面板 + manifest，开箱即用）`,`  otto extension install <name> [--yes]  安装首方/自定义插件（anthropic-provider / deepseek-provider / browser-use / …）`,`  otto extension update [name]     检查并重装已过期的已安装 skill/plugin`,`  otto persistence local [...flags]   启动独立持久化服务（storage + events + sync）`,`  otto persistence remote [...flags]  启动最小化远程持久化服务（5 REST 端点）`,`  otto persistenced [...flags]        (alias: otto persistence local)`,`  otto remote-persistence-server [...flags]  (alias: otto persistence remote)`,`  otto ps [--sweep] [--include-weak] [--json]  进程群列表与孤儿清扫（SIGTERM only，RFC-196）`,``,"面板命令默认连 `otto serve` 实例（http://127.0.0.1:8417，OTTO_SERVICE_URL/--remote 可覆盖）。"]}function l(){process.stdout.write(`otto ${t()}\n`),process.exit(0)}export{s as n,r,i as t};
+//# sourceMappingURL=parse-cli-CqocMnXY.js.map

package/dist/parse-cli-CqocMnXY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cli-CqocMnXY.js","names":[],"sources":["../src/parse-cli.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport type { CLIOptions, RunMode } from './types'\nimport { getVersion } from './version'\n\nexport type SubCommand = 'run' | 'serve' | 'daemon' | 'doctor' | 'config' | 'migrate' | 'auth' | 'observe' | 'debug' | 'time-travel' | 'mcp' | 'persistenced' | 'remote-persistence-server' | 'persistence' | 'extension' | 'ps' | 'feedback'\n\nexport interface ParsedCLI {\n  options: CLIOptions\n  /** 未命中任何内建子命令时为 `undefined`（而非 `null` 哨兵——与 SUB_COMMAND_NAMES 的\n   *  元素类型保持一致，消费方无需 `.filter(n => n !== null)` 剔除哨兵值）。 */\n  subCommand: SubCommand | undefined\n  subCommandArgs: string\n  /**\n   * RFC-112 D2：内建 `SUB_COMMAND_NAMES` 未命中的第一个位置参数（候选插件 CLI 命令名，\n   * 如 `otto feishu ...` 里的 `\"feishu\"`）。`undefined` 表示第一个参数已命中内建命令，\n   * 或压根没有位置参数。**不改变** `options.prompt`/`subCommand` 的既有构建逻辑——\n   * 这两者仍然按\"当作 prompt\"的旧行为完整计算好，供插件命令名查无匹配时零改动回退。\n   */\n  unresolvedCommandName?: string\n  /**\n   * 与 `unresolvedCommandName` 配对：该候选名之后的**原始** args（未做 flag 过滤，含 `-h`\n   * 等字面量），只在插件命令表命中该名字时使用（透传给插件可执行文件）。\n   */\n  unresolvedCommandArgs?: string[]\n}\n\n/** RFC-112 D2：导出供 `cli.ts` 构建插件 CLI 命令表时用作保留字集合（插件不得覆盖）。 */\nexport const SUB_COMMAND_NAMES = new Set<SubCommand>([\n  'run', 'serve', 'daemon', 'doctor', 'config', 'migrate', 'auth', 'observe', 'debug', 'time-travel', 'mcp', 'persistenced', 'remote-persistence-server', 'persistence', 'extension', 'ps', 'feedback',\n])\n\ntype OptionEntry =\n  | { flags: string[]; type: 'boolean';    key: keyof CLIOptions }\n  | { flags: string[]; type: 'mode';       value: RunMode }\n  | { flags: string[]; type: 'string';     key: keyof CLIOptions }\n  | { flags: string[]; type: 'number';     key: keyof CLIOptions }\n  | { flags: string[]; type: 'path';       key: keyof CLIOptions }\n  | { flags: string[]; type: 'action';     handler: () => void }\n\nconst OPTIONS: OptionEntry[] = [\n  { flags: ['--print', '-p'],              type: 'mode',    value: 'print' },\n  { flags: ['--interactive', '-i'],         type: 'mode',    value: 'interactive' },\n  { flags: ['--json'],                      type: 'mode',    value: 'json' },\n  { flags: ['--model', '-m'],               type: 'string',  key: 'model' },\n  { flags: ['--config', '-c'],              type: 'string',  key: 'configPath' },\n  { flags: ['--project', '-d'],             type: 'path',    key: 'projectDir' },\n  { flags: ['--quiet', '-q'],               type: 'boolean', key: 'quiet' },\n  { flags: ['--verbose'],                   type: 'boolean', key: 'verbose' },\n  { flags: ['--max-tool-turns'],            type: 'number',  key: 'maxToolTurns' },\n  { flags: ['--max-tool-turn-extensions'],  type: 'number',  key: 'maxToolTurnExtensions' },\n  { flags: ['--prompt-token-budget'],       type: 'number',  key: 'promptTokenBudget' },\n  { flags: ['--prompt-time-budget'],        type: 'number',  key: 'promptTimeBudgetMin' },\n  { flags: ['--session-cost-budget'],       type: 'number',  key: 'sessionCostBudget' },\n  { flags: ['--no-stall-detection'],        type: 'boolean', key: 'noStallDetection' },\n  { flags: ['--stall-window-turns'],        type: 'number',  key: 'stallWindowTurns' },\n  { flags: ['--stall-repeat-threshold'],    type: 'number',  key: 'stallRepeatThreshold' },\n  { flags: ['--continue'],                  type: 'string',  key: 'continueSession' },\n  { flags: ['--attach'],                    type: 'string',  key: 'attachSession' },\n  { flags: ['--force-write-lease'],         type: 'boolean', key: 'forceWriteLease' },\n  // RFC-115 M3（P1-1 修正）：仅由 cli.ts 的内存治理触发重启 chaperone 附加，不对外文档化——\n  // 区分\"内存压力触发的自动重启\"与\"用户手动 otto --continue\"，前者才应起算 D5 宽限期。\n  { flags: ['--memory-restart-grace'],       type: 'boolean', key: 'memoryRestartGrace' },\n  // RFC-115 M4：仅由 cli.ts 的内存治理触发重启 chaperone 附加，不对外文档化——重启前\n  // 会话正忙时的续跑原文，子进程启动后自动重新提交为续跑轮。\n  { flags: ['--resume-prompt'],              type: 'string',  key: 'resumePrompt' },\n  { flags: ['--session-url'],               type: 'string',  key: 'sessionUrl' },\n  { flags: ['--session-token'],             type: 'string',  key: 'sessionToken' },\n  { flags: ['--id'],                        type: 'string',  key: 'workspaceId' },\n  { flags: ['--shadow'],                    type: 'boolean', key: 'shadow' },\n  { flags: ['--help', '-h'],                type: 'boolean', key: 'showHelp' },\n  { flags: ['--version', '-v'],             type: 'action',  handler: printVersion },\n]\n\nconst OPTION_LOOKUP: Map<string, OptionEntry> = new Map(\n  OPTIONS.flatMap(e => e.flags.map(f => [f, e] as const)),\n)\n\nclass ArgCursor {\n  private i: number\n  constructor(private args: string[]) {\n    this.i = 0\n  }\n  current(): string | undefined { return this.args[this.i] }\n  next(): string | undefined { return this.args[++this.i] }\n  advance(): void { this.i++ }\n  skip(count: number): void { this.i += count }\n  pos(): number { return this.i }\n}\n\nexport function parseCLI(argv: string[]): ParsedCLI {\n  const args = argv.slice(2)\n  const cursor = new ArgCursor(args)\n\n  const options: CLIOptions = {\n    mode: 'interactive',\n    projectDir: process.cwd(),\n    verbose: false,\n    quiet: false,\n  }\n\n  const first = cursor.current()\n  let subCommand: SubCommand | undefined\n  let subCommandArgs = ''\n  let unresolvedCommandName: string | undefined\n  let unresolvedCommandArgs: string[] | undefined\n  if (first && SUB_COMMAND_NAMES.has(first as SubCommand)) {\n    subCommand = first as SubCommand\n    subCommandArgs = args.slice(1).join(' ')\n    cursor.skip(1)\n\n    if (subCommand === 'run') {\n      options.prompt = args.slice(1).filter(a => !a.startsWith('-')).join(' ')\n      options.mode = 'print'\n    }\n  } else if (first && !first.startsWith('-')) {\n    // RFC-112 D2：第一个位置参数不是内建命令，也不以 `-` 开头（不是 flag）——\n    // 记录为候选插件 CLI 命令名，供 cli.ts 查插件表二次判定；不改变下方现有的\n    // \"当作 prompt\" 逻辑（该逻辑仍会照常把 first 纳入 promptParts，回退路径零改动）。\n    unresolvedCommandName = first\n    unresolvedCommandArgs = args.slice(1)\n  }\n\n  let promptParts: string[] = options.prompt ? [options.prompt] : []\n\n  while (cursor.current() !== undefined) {\n    const arg = cursor.current()!\n\n    if (arg === '--inspect') {\n      options.inspect = true\n      cursor.advance()\n      continue\n    }\n    if (arg?.startsWith('--inspect=')) {\n      const port = Number(arg.slice('--inspect='.length))\n      options.inspect = Number.isInteger(port) && port > 0 ? port : true\n      cursor.advance()\n      continue\n    }\n    // RFC-196 M3：重启代际计数（chaperone 重启 spawn 注入，不文档化——内部可观测标记，\n    // 供 ≥3 代告警与 otto ps GEN 列展示；不驱动任何行为分支）。\n    if (arg?.startsWith('--restart-generation=')) {\n      const gen = Number(arg.slice('--restart-generation='.length))\n      if (Number.isInteger(gen) && gen > 0) options.restartGeneration = gen\n      cursor.advance()\n      continue\n    }\n\n    const entry = OPTION_LOOKUP.get(arg)\n    if (entry) {\n      cursor.advance()\n      switch (entry.type) {\n        case 'boolean':\n          ;(options as unknown as Record<string, unknown>)[entry.key] = true\n          break\n        case 'mode':\n          options.mode = entry.value\n          break\n        case 'string':\n          ;(options as unknown as Record<string, unknown>)[entry.key] = cursor.current()\n          cursor.advance()\n          break\n        case 'number':\n          ;(options as unknown as Record<string, unknown>)[entry.key] = Number(cursor.current())\n          cursor.advance()\n          break\n        case 'path':\n          ;(options as unknown as Record<string, unknown>)[entry.key] = resolve(cursor.current() ?? process.cwd())\n          cursor.advance()\n          break\n        case 'action':\n          entry.handler()\n          break\n      }\n      continue\n    }\n\n    if (arg && !arg.startsWith('-') && !subCommand) {\n      if (options.prompt === undefined && options.mode === 'interactive') {\n        options.mode = 'print'\n      }\n      promptParts.push(arg)\n    }\n    cursor.advance()\n  }\n\n  if (promptParts.length > 0) {\n    options.prompt = promptParts.join(' ')\n  }\n\n  return { options, subCommand, subCommandArgs, unresolvedCommandName, unresolvedCommandArgs }\n}\n\n/** 帮助文本行（供 plain-text printHelp 与 TUI InfoDialog 共用）。 */\nexport function getHelpLines(): string[] {\n  return [\n    '',\n    'otto - AI 助理命令行工具',\n    '',\n    '用法:',\n    '  otto [提示词]              使用提示词启动（print 模式）',\n    '  otto                       进入交互式 TUI 模式',\n    '  otto --json \"query\"        JSON 输出模式',\n    '',\n    '选项:',\n    '  -i, --interactive         Interactive 模式（默认）',\n    '  -p, --print               Print 模式（非交互）',\n    '  --json                    JSON 输出模式',\n    '  -m, --model <id>          指定模型',\n    '  -c, --config <path>       配置文件路径',\n    '  -d, --project <dir>       项目目录',\n    '  --verbose                 输出详细日志',\n    '  -q, --quiet               只输出 error 日志',\n    '  --shadow                  影子模式：otto 自有状态（凭据/会话/记忆/教训/配置/trace/日志）本次会话零磁盘写入（不保证 provider 服务端日志与 shell/OS 层痕迹；RFC-345）',\n    '  --max-tool-turns <n>      单个用户回合最大工具回合数（默认 120）',\n    '  --max-tool-turn-extensions <n>  触顶后压缩续跑的扩展次数（默认主会话 3 / 子 agent 0）',\n    '  --prompt-token-budget <n> 单回合输出 token 预算（配置后轮次上限 ×4 退位安全阀；RFC-104）',\n    '  --prompt-time-budget <min> 单回合墙钟时间预算（分钟）',\n    '  --session-cost-budget <usd> 会话累计成本软预算（美元，超过一次性提醒不阻断；RFC-204）',\n    '  --no-stall-detection      关闭早期停滞检测（默认开启；RFC-203）',\n    '  --stall-window-turns <n>  停滞检测滑动窗口大小（需与 --stall-repeat-threshold 同时提供，默认 8）',\n    '  --stall-repeat-threshold <n> 停滞检测同签名重复阈值（需与 --stall-window-turns 同时提供，默认 4）',\n    '  --continue <id>           继续已有会话',\n    '  --session-url <url>       远端会话持久化地址（如 http://host:3001/sessions）',\n    '  --session-token <token>   远端会话持久化 Bearer token',\n    '  --inspect[=port]          启用 Node.js inspector（默认: 9229）',\n    '  -h, --help                显示帮助',\n    '  --version, -v             显示版本',\n    '',\n    '命令:',\n    '  otto run <prompt>              执行一次性任务',\n    '  otto serve [--port N] [--inspect] [--static <dir>] [--token <t>]  启动 HTTP/WS service（--static 同源托管前端 SPA，--token 启用鉴权）',\n    '  otto doctor [--summary|--json] 环境健康检查（环境/配置/存储状态/连通性）',\n    '  otto auth login <provider>     登录（cursor / anthropic / openai-codex / github-copilot）',\n    '  otto auth status               查看各 provider 凭据来源',\n    '  otto auth logout <provider>    注销并清除凭据',\n    '  otto config export [--project] [-o <path>]  导出配置（RFC-219）',\n    '  otto config import <file> [--dry-run] [--scope global|project] [--no-plugins] [--plugins-only] [--yes]  导入配置',\n    '  otto config restore [--list]   撤销最近一次导入',\n    '  otto migrate export [--no-sessions] [-o <path>]  导出配置+插件清单+会话数据为迁移包（换电脑用）',\n    '  otto migrate import <archive> [--no-sessions]    导入迁移包（目标已有会话数据时跳过会话部分）',\n    '  otto observe <action> <id>     观测面板（summary / timeline / spans）',\n    '  otto observe debug <action> [...]      调试面板（breakpoints / points / state）',\n    '  otto observe replay <action> <id>     时间旅行（checkpoints / scrubber / restore / fork / replay）',\n    '  otto debug <action> [...]      (alias: otto observe debug)',\n    '  otto time-travel <action> <id> (alias: otto observe replay)',\n    '  otto mcp login <name>         MCP server OAuth 登录',\n    '  otto mcp logout <name>        登出 MCP server',\n    '  otto mcp list                 列出已认证的 MCP server',\n    '  otto extension create <name>     生成插件骨架（命令 + 面板 + manifest，开箱即用）',\n    '  otto extension install <name> [--yes]  安装首方/自定义插件（anthropic-provider / deepseek-provider / browser-use / …）',\n    '  otto extension update [name]     检查并重装已过期的已安装 skill/plugin',\n    '  otto persistence local [...flags]   启动独立持久化服务（storage + events + sync）',\n    '  otto persistence remote [...flags]  启动最小化远程持久化服务（5 REST 端点）',\n    '  otto persistenced [...flags]        (alias: otto persistence local)',\n    '  otto remote-persistence-server [...flags]  (alias: otto persistence remote)',\n    '  otto ps [--sweep] [--include-weak] [--json]  进程群列表与孤儿清扫（SIGTERM only，RFC-196）',\n    '',\n    '面板命令默认连 `otto serve` 实例（http://127.0.0.1:8417，OTTO_SERVICE_URL/--remote 可覆盖）。',\n  ]\n}\n\nfunction printVersion(): void {\n  process.stdout.write(`otto ${getVersion()}\\n`)\n  process.exit(0)\n}\n"],"mappings":"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"}

package/dist/persistence-CTXa-OyC.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+import{t as e}from"./daemon-base-YOWgYYN7.js";import{PERSISTENCED_DEFAULT_PORT as t,startPersistenced as n}from"@x-otto/service";import{REMOTE_PERSISTENCE_DEFAULT_PORT as r}from"@x-otto/remote-persistence-server";const i=t,a=`127.0.0.1`;async function o(t,r={}){let o=r.stdout??(e=>process.stdout.write(e)),c=r.stderr??(e=>process.stderr.write(e));if(t[0]===`help`||t[0]===`--help`)return s(o),0;let l,u=i,d=a,f;for(let e=0;e<t.length;e++){let n=t[e];if(n===`--dir`||n===`-d`)l=t[++e];else if(n===`--port`||n===`-p`){let n=t[++e],r=Number(n);if(!Number.isInteger(r)||r<1||r>65535)return c(`otto persistenced: invalid --port value: ${n??`(missing)`}\n`),1;u=r}else n===`--host`||n===`-h`?d=t[++e]??a:(n===`--token`||n===`-t`)&&(f=t[++e])}if(!l)return c(`otto persistenced: --dir is required
+`),1;if(!f)return c(`otto persistenced: --token is required
+`),1;try{let{url:t}=await n({dir:l,port:u,host:d,token:f});return o(`persistenced listening on ${t}
+  storage:  ${t}/api/storage/:namespace
+  events:   ${t}/api/events/:namespace  (SSE)
+  sync:     ${t}/api/sync/:namespace
+  health:   ${t}/health
+  stop:     Ctrl-C
+`),await e(r.signal),o(`persistenced shutting down
+`),0}catch(e){return c(`otto persistenced: ${e instanceof Error?e.message:String(e)}\n`),1}}function s(e){e(`otto persistenced — 独立持久化存储服务（SQLite + HTTP API）
+
+用法:
+  otto persistenced --dir <path> --token <token> [--port <n>] [--host <ip>]
+
+选项:
+  --dir, -d <path>    数据目录（SQLite db 文件存放位置，必填）
+  --token, -t <token> Bearer token（所有 /api/* 请求必须携带，必填）
+  --port, -p <n>      监听端口（默认 ${i}）
+  --host, -h <ip>     监听地址（默认 ${a}，0.0.0.0 = 公网暴露）
+
+示例:
+  otto persistenced --dir /var/lib/otto/storage --token "\$TOKEN"
+  otto persistenced --dir ./data --port 3002 --token dev-secret
+
+端点:
+  GET  /health                         健康检查
+  GET  /api/storage/:namespace         列出文档 ID / 分页列表
+  GET  /api/storage/:namespace/:id     读取文档
+  PUT  /api/storage/:namespace/:id     写入文档
+  DELETE /api/storage/:namespace/:id   删除文档
+  GET  /api/events/:namespace          SSE 变更推送
+  POST /api/sync/:namespace/push       批量写入（离线同步）
+  GET  /api/sync/:namespace/pull       增量拉取
+`)}const c=r,l=`127.0.0.1`;async function u(t,n={}){let r=n.stdout??(e=>process.stdout.write(e)),i=n.stderr??(e=>process.stderr.write(e));if(t[0]===`help`||t[0]===`--help`)return d(r),0;let a,o=c,s=l,u;for(let e=0;e<t.length;e++){let n=t[e];if(n===`--dir`||n===`-d`)a=t[++e];else if(n===`--port`||n===`-p`){let n=t[++e],r=Number(n);if(!Number.isInteger(r)||r<1||r>65535)return i(`otto remote-persistence-server: invalid --port value: ${n??`(missing)`}\n`),1;o=r}else n===`--host`||n===`-h`?s=t[++e]??l:(n===`--token`||n===`-t`)&&(u=t[++e])}if(!a)return i(`otto remote-persistence-server: --dir is required
+`),1;if(u===void 0)return i(`otto remote-persistence-server: --token is required (use --token "" to disable auth for dev only)
+`),1;let{startServer:f}=await import(`@x-otto/remote-persistence-server`);try{let{url:t,server:i,store:c}=await f({dataDir:a,port:o,authToken:u},{host:s});return r(`remote-persistence-server listening on ${t}
+  sessions:  ${t}/sessions
+  health:    ${t}/health
+  stop:      Ctrl-C
+`),await e(n.signal),r(`remote-persistence-server shutting down
+`),await new Promise(e=>i.close(()=>e())),c.close(),0}catch(e){return i(`otto remote-persistence-server: ${e instanceof Error?e.message:String(e)}\n`),1}}function d(e){e(`otto remote-persistence-server — 最小化远程持久化服务（Hono + SQLite，5 REST 端点）
+
+用法:
+  otto remote-persistence-server --dir <path> --token <token> [--port <n>] [--host <ip>]
+
+选项:
+  --dir, -d <path>    数据目录（SQLite db 文件存放位置，必填）
+  --token, -t <token> Bearer token（所有 /sessions/* 请求必须携带，必填）
+  --port, -p <n>      监听端口（默认 ${c}）
+  --host, -h <ip>     监听地址（默认 ${l}，0.0.0.0 = 公网暴露）
+
+示例:
+  otto remote-persistence-server --dir ./data --token dev-secret
+  otto remote-persistence-server --dir /var/lib/otto/storage --port 3002 --token "\$TOKEN"
+
+端点（:wsKey 为客户端工作区分区段，本服务 accept-and-ignore，按 token 派生 userId 分区）:
+  GET  /health                        健康检查（无需认证）
+  GET  /sessions/:wsKey               列出会话 ID（需要 Bearer token）
+  GET  /sessions/:wsKey/:id           读取会话快照
+  PUT  /sessions/:wsKey/:id           写入/更新会话快照
+  DELETE /sessions/:wsKey/:id         删除会话快照
+
+对端客户端:
+  另一台机器上的 Otto CLI:
+    otto --session-url http://<host>:<port>/sessions --session-token <token>
+`)}async function f(e,t={}){let n=t.stdout??(e=>process.stdout.write(e)),[r,...i]=e;switch(r){case`local`:return o(i,t);case`remote`:return u(i,t);default:return n(`otto persistence — 持久化服务族（local / remote）
+
+用法:
+  otto persistence local [...flags]     启动独立持久化服务（storage + events + sync）
+  otto persistence remote [...flags]    启动最小化远程持久化服务（5 REST 端点）
+
+子命令说明:
+  local    等价于旧 otto persistenced（SQLite + HTTP API，storage/events/sync）
+  remote   等价于旧 otto remote-persistence-server（Hono + SQLite，5 REST 端点）
+
+通用选项（详见各子命令 --help）:
+  --dir, -d <path>      数据目录（必填）
+  --token, -t <token>   Bearer token（必填）
+  --port, -p <n>        监听端口（各子命令有各自默认端口）
+  --host, -h <ip>        监听地址（默认 127.0.0.1，0.0.0.0 = 公网暴露）
+
+注：旧命令 otto persistenced / otto remote-persistence-server 仍可用（别名转发）。
+`),0}}export{f as runPersistenceCommand};
+//# sourceMappingURL=persistence-CTXa-OyC.js.map

package/dist/persistence-CTXa-OyC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-CTXa-OyC.js","names":["DEFAULT_PORT","DEFAULT_HOST","printHelp"],"sources":["../src/commands/persistenced.ts","../src/commands/remote-persistence-server.ts","../src/commands/persistence.ts"],"sourcesContent":["import { startPersistenced, PERSISTENCED_DEFAULT_PORT } from '@x-otto/service'\n\nimport { waitForShutdown } from './daemon-base'\n\nexport interface PersistencedDeps {\n  stdout?: (s: string) => void\n  stderr?: (s: string) => void\n  signal?: AbortSignal\n}\n\n/** 复用 @x-otto/service 的族内单源默认端口，消除双源漂移。 */\nconst DEFAULT_PORT = PERSISTENCED_DEFAULT_PORT\nconst DEFAULT_HOST = '127.0.0.1'\n\nexport async function runPersistencedCommand(\n  args: string[],\n  deps: PersistencedDeps = {},\n): Promise<number> {\n  const stdout = deps.stdout ?? ((s) => process.stdout.write(s))\n  const stderr = deps.stderr ?? ((s) => process.stderr.write(s))\n\n  if (args[0] === 'help' || args[0] === '--help') {\n    printHelp(stdout)\n    return 0\n  }\n\n  let dir: string | undefined\n  let port = DEFAULT_PORT\n  let host = DEFAULT_HOST\n  let token: string | undefined\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i]\n    if (arg === '--dir' || arg === '-d') {\n      dir = args[++i]\n    } else if (arg === '--port' || arg === '-p') {\n      const raw = args[++i]\n      const n = Number(raw)\n      if (!Number.isInteger(n) || n < 1 || n > 65535) {\n        stderr(`otto persistenced: invalid --port value: ${raw ?? '(missing)'}\\n`)\n        return 1\n      }\n      port = n\n    } else if (arg === '--host' || arg === '-h') {\n      host = args[++i] ?? DEFAULT_HOST\n    } else if (arg === '--token' || arg === '-t') {\n      token = args[++i]\n    }\n  }\n\n  if (!dir) {\n    stderr('otto persistenced: --dir is required\\n')\n    return 1\n  }\n\n  if (!token) {\n    stderr('otto persistenced: --token is required\\n')\n    return 1\n  }\n\n  try {\n    const { url } = await startPersistenced({ dir, port, host, token })\n\n    stdout(`persistenced listening on ${url}\n  storage:  ${url}/api/storage/:namespace\n  events:   ${url}/api/events/:namespace  (SSE)\n  sync:     ${url}/api/sync/:namespace\n  health:   ${url}/health\n  stop:     Ctrl-C\n`)\n\n    await waitForShutdown(deps.signal)\n    stdout('persistenced shutting down\\n')\n    return 0\n  } catch (error) {\n    stderr(\n      `otto persistenced: ${error instanceof Error ? error.message : String(error)}\\n`,\n    )\n    return 1\n  }\n}\n\nfunction printHelp(stdout: (s: string) => void): void {\n  stdout(`otto persistenced — 独立持久化存储服务（SQLite + HTTP API）\n\n用法:\n  otto persistenced --dir <path> --token <token> [--port <n>] [--host <ip>]\n\n选项:\n  --dir, -d <path>    数据目录（SQLite db 文件存放位置，必填）\n  --token, -t <token> Bearer token（所有 /api/* 请求必须携带，必填）\n  --port, -p <n>      监听端口（默认 ${DEFAULT_PORT}）\n  --host, -h <ip>     监听地址（默认 ${DEFAULT_HOST}，0.0.0.0 = 公网暴露）\n\n示例:\n  otto persistenced --dir /var/lib/otto/storage --token \"\\$TOKEN\"\n  otto persistenced --dir ./data --port 3002 --token dev-secret\n\n端点:\n  GET  /health                         健康检查\n  GET  /api/storage/:namespace         列出文档 ID / 分页列表\n  GET  /api/storage/:namespace/:id     读取文档\n  PUT  /api/storage/:namespace/:id     写入文档\n  DELETE /api/storage/:namespace/:id   删除文档\n  GET  /api/events/:namespace          SSE 变更推送\n  POST /api/sync/:namespace/push       批量写入（离线同步）\n  GET  /api/sync/:namespace/pull       增量拉取\n`)\n}\n\n","import { REMOTE_PERSISTENCE_DEFAULT_PORT, type ServerConfig } from '@x-otto/remote-persistence-server'\n\nimport { waitForShutdown } from './daemon-base'\n\nexport interface RemotePersistenceServerDeps {\n  stdout?: (s: string) => void\n  stderr?: (s: string) => void\n  signal?: AbortSignal\n}\n\n/** 复用 @x-otto/remote-persistence-server 的族内单源默认端口，消除双源漂移。 */\nconst DEFAULT_PORT = REMOTE_PERSISTENCE_DEFAULT_PORT\nconst DEFAULT_HOST = '127.0.0.1'\n\nexport async function runRemotePersistenceServerCommand(\n  args: string[],\n  deps: RemotePersistenceServerDeps = {},\n): Promise<number> {\n  const stdout = deps.stdout ?? ((s) => process.stdout.write(s))\n  const stderr = deps.stderr ?? ((s) => process.stderr.write(s))\n\n  if (args[0] === 'help' || args[0] === '--help') {\n    printHelp(stdout)\n    return 0\n  }\n\n  let dir: string | undefined\n  let port = DEFAULT_PORT\n  let host = DEFAULT_HOST\n  let token: string | undefined\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i]\n    if (arg === '--dir' || arg === '-d') {\n      dir = args[++i]\n    } else if (arg === '--port' || arg === '-p') {\n      const raw = args[++i]\n      const n = Number(raw)\n      if (!Number.isInteger(n) || n < 1 || n > 65535) {\n        stderr(\n          `otto remote-persistence-server: invalid --port value: ${raw ?? '(missing)'}\\n`,\n        )\n        return 1\n      }\n      port = n\n    } else if (arg === '--host' || arg === '-h') {\n      host = args[++i] ?? DEFAULT_HOST\n    } else if (arg === '--token' || arg === '-t') {\n      token = args[++i]\n    }\n  }\n\n  if (!dir) {\n    stderr('otto remote-persistence-server: --dir is required\\n')\n    return 1\n  }\n\n  if (token === undefined) {\n    stderr(\n      'otto remote-persistence-server: --token is required (use --token \"\" to disable auth for dev only)\\n',\n    )\n    return 1\n  }\n\n  const { startServer } = await import('@x-otto/remote-persistence-server')\n\n  try {\n    const config: ServerConfig = { dataDir: dir, port, authToken: token }\n    const { url, server, store } = await startServer(config, { host })\n\n    stdout(`remote-persistence-server listening on ${url}\n  sessions:  ${url}/sessions\n  health:    ${url}/health\n  stop:      Ctrl-C\n`)\n\n    await waitForShutdown(deps.signal)\n    stdout('remote-persistence-server shutting down\\n')\n    await new Promise<void>((resolve) => server.close(() => resolve()))\n    store.close()\n    return 0\n  } catch (error) {\n    stderr(\n      `otto remote-persistence-server: ${error instanceof Error ? error.message : String(error)}\\n`,\n    )\n    return 1\n  }\n}\n\nfunction printHelp(stdout: (s: string) => void): void {\n  stdout(`otto remote-persistence-server — 最小化远程持久化服务（Hono + SQLite，5 REST 端点）\n\n用法:\n  otto remote-persistence-server --dir <path> --token <token> [--port <n>] [--host <ip>]\n\n选项:\n  --dir, -d <path>    数据目录（SQLite db 文件存放位置，必填）\n  --token, -t <token> Bearer token（所有 /sessions/* 请求必须携带，必填）\n  --port, -p <n>      监听端口（默认 ${DEFAULT_PORT}）\n  --host, -h <ip>     监听地址（默认 ${DEFAULT_HOST}，0.0.0.0 = 公网暴露）\n\n示例:\n  otto remote-persistence-server --dir ./data --token dev-secret\n  otto remote-persistence-server --dir /var/lib/otto/storage --port 3002 --token \"\\$TOKEN\"\n\n端点（:wsKey 为客户端工作区分区段，本服务 accept-and-ignore，按 token 派生 userId 分区）:\n  GET  /health                        健康检查（无需认证）\n  GET  /sessions/:wsKey               列出会话 ID（需要 Bearer token）\n  GET  /sessions/:wsKey/:id           读取会话快照\n  PUT  /sessions/:wsKey/:id           写入/更新会话快照\n  DELETE /sessions/:wsKey/:id         删除会话快照\n\n对端客户端:\n  另一台机器上的 Otto CLI:\n    otto --session-url http://<host>:<port>/sessions --session-token <token>\n`)\n}\n","/**\n * `otto persistence` 子命令 —— 持久化服务族（local / remote）的薄路由。\n *\n * RFC-367 M4：persistence 收编 persistenced（local）与 remote-persistence-server（remote）\n * 为子命令。旧入口 `otto persistenced` / `otto remote-persistence-server` 作为别名保留，\n * 内部分别转发到本命令的 `local` / `remote` 子路径。\n */\nimport { runPersistencedCommand, type PersistencedDeps } from './persistenced'\nimport {\n  runRemotePersistenceServerCommand,\n  type RemotePersistenceServerDeps,\n} from './remote-persistence-server'\n\n/**\n * persistence 路由的 deps —— 是 PersistencedDeps 与 RemotePersistenceServerDeps 的并集\n * （两者结构相同：stdout? / stderr? / signal?，并集保持兼容）。\n */\nexport type PersistenceDeps = PersistencedDeps & RemotePersistenceServerDeps\n\nexport async function runPersistenceCommand(\n  args: string[],\n  deps: PersistenceDeps = {},\n): Promise<number> {\n  const stdout = deps.stdout ?? ((s) => process.stdout.write(s))\n\n  const [subCommand, ...rest] = args\n\n  switch (subCommand) {\n    case 'local':\n      return runPersistencedCommand(rest, deps)\n    case 'remote':\n      return runRemotePersistenceServerCommand(rest, deps)\n    default:\n      stdout(`otto persistence — 持久化服务族（local / remote）\n\n用法:\n  otto persistence local [...flags]     启动独立持久化服务（storage + events + sync）\n  otto persistence remote [...flags]    启动最小化远程持久化服务（5 REST 端点）\n\n子命令说明:\n  local    等价于旧 otto persistenced（SQLite + HTTP API，storage/events/sync）\n  remote   等价于旧 otto remote-persistence-server（Hono + SQLite，5 REST 端点）\n\n通用选项（详见各子命令 --help）:\n  --dir, -d <path>      数据目录（必填）\n  --token, -t <token>   Bearer token（必填）\n  --port, -p <n>        监听端口（各子命令有各自默认端口）\n  --host, -h <ip>        监听地址（默认 127.0.0.1，0.0.0.0 = 公网暴露）\n\n注：旧命令 otto persistenced / otto remote-persistence-server 仍可用（别名转发）。\n`)\n      return 0\n  }\n}\n"],"mappings":"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"}

package/dist/plugin-assembly-check-C2TephMb.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+function e(e){let t=new Set(e.disabled??[]),n=new Set(e.active.map(e=>e.id)),r=e.discovered.filter(e=>!n.has(e.id)&&!t.has(e.id));return{missingFromRuntime:r,missingBundled:r.filter(e=>e.scope===`bundled`),hasGap:r.length>0}}function t(e){if(!e.hasGap)return[];let t=[];e.missingBundled.length>0&&t.push(`内置扩展未装载：${e.missingBundled.map(e=>e.id).join(`, `)}`,`  → 宿主装配参数未传达（RFC-364）。若为嵌入式调用，检查 createApp 的 pluginBundledDirs。`);let n=e.missingFromRuntime.filter(e=>e.scope!==`bundled`);return n.length>0&&t.push(`插件已发现但未激活：${n.map(e=>e.id).join(`, `)}`,`  → 可能是依赖缺失/版本不兼容/未信任。查看启动日志的 fail-closed 告警定位具体原因。`),t}export{e as checkPluginAssembly,t as formatAssemblyGap};
+//# sourceMappingURL=plugin-assembly-check-C2TephMb.js.map

package/dist/plugin-assembly-check-C2TephMb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-assembly-check-C2TephMb.js","names":[],"sources":["../src/plugin-assembly-check.ts"],"sourcesContent":["/**\n * plugin-assembly-check.ts —— RFC-364 M2：装配一致性自检。\n *\n * ## 要解决的问题\n * M1 收敛了装配点，但那只修好了**当前**六处入口。真正的风险是**下一次**——任何新的\n * 装配路径若漏配宿主自描述参数，表现仍然是\"插件静默消失\"，用户侧症状是\n * 「Setup Wizard 走完了但模型列表空白」，与真实根因（宿主没告诉 App 自己带了什么）\n * 相距甚远，极难诊断。\n *\n * RFC-364 §4 规则 2：装配缺失必须 fail-loud，不得只写 warn 日志了事。\n *\n * ## 判据\n * 比对两个视图：\n *  - **应该可见**：`discoverPluginsWithBundled()`（cli 侧完整发现，含 bundled 层）\n *  - **实际装载**：`app.activePlugins()`（App 运行时真正激活的集合）\n *\n * 二者的差集分两类，语义不同、处置不同：\n *  - `missingFromRuntime`：发现得到却没装载 → **装配缺口或依赖 fail-closed**，需报告；\n *  - 反向差集不检查：App 侧可能因 disabled 配置少装，那是用户意图，不是缺陷。\n *\n * ## 为什么放 cli 而不是 coding\n * 判据依赖 `discoverPluginsWithBundled()`（知道 bundled 目录 = cli 独有知识，见\n * `create-host-app.ts` 头注释论证）。放 coding 会重蹈\"下游包推导宿主布局\"的覆辙。\n *\n * 纯函数 + 端口注入：便于穷举单测，不触真实 App。\n */\n\n/** 一个插件的最小身份（两个视图的公共子集）。 */\nexport interface AssemblyPluginRef {\n  id: string\n  scope?: string\n}\n\nexport interface AssemblyCheckInput {\n  /** cli 侧完整发现的插件（含 bundled 层）。 */\n  discovered: readonly AssemblyPluginRef[]\n  /** App 运行时实际激活的插件。 */\n  active: readonly AssemblyPluginRef[]\n  /** 用户显式禁用的插件 id（`disabled_plugins` 配置）——不计入缺口。 */\n  disabled?: readonly string[]\n}\n\nexport interface AssemblyCheckResult {\n  /** 发现得到但未装载（排除用户显式禁用者）。非空 = 装配不完整。 */\n  missingFromRuntime: AssemblyPluginRef[]\n  /** 其中属于 bundled 作用域的——这类最可能是\"漏传宿主自描述参数\"的信号。 */\n  missingBundled: AssemblyPluginRef[]\n  /** 是否存在缺口（供调用方决定是否 fail-loud）。 */\n  hasGap: boolean\n}\n\n/**\n * 比对「应该可见」与「实际装载」，给出装配缺口。\n *\n * 用户显式 `disabled` 的插件被排除——那是用户意图，不是装配缺陷。这条很重要：\n * 否则任何禁用过插件的用户都会看到假告警，告警一旦有噪音就会被忽略，\n * 这道门也就失去意义了。\n */\nexport function checkPluginAssembly(input: AssemblyCheckInput): AssemblyCheckResult {\n  const disabled = new Set(input.disabled ?? [])\n  const activeIds = new Set(input.active.map((p) => p.id))\n\n  const missingFromRuntime = input.discovered.filter(\n    (p) => !activeIds.has(p.id) && !disabled.has(p.id),\n  )\n  const missingBundled = missingFromRuntime.filter((p) => p.scope === 'bundled')\n\n  return {\n    missingFromRuntime,\n    missingBundled,\n    hasGap: missingFromRuntime.length > 0,\n  }\n}\n\n/**\n * 把缺口渲染成面向用户的可执行诊断文本（`otto doctor` 消费）。\n *\n * 措辞指向**根因方向**而非症状：bundled 缺失几乎必然是装配漏配（宿主自描述参数没传到），\n * 其余缺失更可能是依赖 fail-closed（missingDeps/版本门/信任门）。两者给不同的下一步，\n * 避免用户拿着\"插件不见了\"去猜。\n */\nexport function formatAssemblyGap(result: AssemblyCheckResult): string[] {\n  if (!result.hasGap) return []\n\n  const lines: string[] = []\n  if (result.missingBundled.length > 0) {\n    lines.push(\n      `内置扩展未装载：${result.missingBundled.map((p) => p.id).join(', ')}`,\n      '  → 宿主装配参数未传达（RFC-364）。若为嵌入式调用，检查 createApp 的 pluginBundledDirs。',\n    )\n  }\n  const others = result.missingFromRuntime.filter((p) => p.scope !== 'bundled')\n  if (others.length > 0) {\n    lines.push(\n      `插件已发现但未激活：${others.map((p) => p.id).join(', ')}`,\n      '  → 可能是依赖缺失/版本不兼容/未信任。查看启动日志的 fail-closed 告警定位具体原因。',\n    )\n  }\n  return lines\n}\n"],"mappings":";AA0DA,SAAgB,EAAoB,EAAgD,CAClF,IAAM,EAAW,IAAI,IAAI,EAAM,UAAY,EAAE,CAAC,CACxC,EAAY,IAAI,IAAI,EAAM,OAAO,IAAK,GAAM,EAAE,GAAG,CAAC,CAElD,EAAqB,EAAM,WAAW,OACzC,GAAM,CAAC,EAAU,IAAI,EAAE,GAAG,EAAI,CAAC,EAAS,IAAI,EAAE,GAAG,CACnD,CAGD,MAAO,CACL,qBACA,eAJqB,EAAmB,OAAQ,GAAM,EAAE,QAAU,UAAU,CAK5E,OAAQ,EAAmB,OAAS,EACrC,CAUH,SAAgB,EAAkB,EAAuC,CACvE,GAAI,CAAC,EAAO,OAAQ,MAAO,EAAE,CAE7B,IAAM,EAAkB,EAAE,CACtB,EAAO,eAAe,OAAS,GACjC,EAAM,KACJ,WAAW,EAAO,eAAe,IAAK,GAAM,EAAE,GAAG,CAAC,KAAK,KAAK,GAC5D,mEACD,CAEH,IAAM,EAAS,EAAO,mBAAmB,OAAQ,GAAM,EAAE,QAAU,UAAU,CAO7E,OANI,EAAO,OAAS,GAClB,EAAM,KACJ,aAAa,EAAO,IAAK,GAAM,EAAE,GAAG,CAAC,KAAK,KAAK,GAC/C,sDACD,CAEI"}

package/dist/registry-BOX7DaxS.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{i as e,r as t}from"./registry-BdCcwyGy.js";export{t as makeRegistryClient,e as searchRegistries};

package/dist/{registry-D0NONjLv.js → registry-BdCcwyGy.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import{RegistryClient as e,builtinOfficialSource as t}from"@x-otto/coding";import{rankCandidates as n}from"@x-otto/shared";import{OTTO_HOME as r,OTTO_USER_CONFIG_DIR as i}from"@x-otto/env";function a(e){return process.env.OTTO_OFFICIAL_REGISTRY_URL??`https://x-ottojs.github.io/otto-registry/registry.json`}function o(n){return new e({configDir:i,ottoHome:r,officialSource:t(a(n))})}function s(e){return o(e.app)}async function c(e,t){let n=s(t),[r,...i]=e.filter(e=>!e.startsWith(`-`));try{if(r===`add`){let[e,r]=i;if(!e||!r){t.tui.info.showToast(`Registry`,`Usage: /registry add <name> <url>`);return}n.addSource(e,r),t.tui.info.showToast(`Registry`,`已注册 '${e}' → ${r}`);return}if(r===`remove`){let[e]=i;if(!e){t.tui.info.showToast(`Registry`,`Usage: /registry remove <name>`);return}n.removeSource(e),t.tui.info.showToast(`Registry`,`已移除 '${e}'`);return}let e=n.listSources(),{registries:a,warnings:o}=await n.loadAll(),s=new Map,c=new Map;for(let e of a)s.set(e.sourceName,e.entries.length),c.set(e.sourceName,e.stale);let l=e.map(e=>{let t=s.get(e.name),n=t===void 0?``:`${t} entries`,r=c.get(e.name)?` (stale cache)`:``,i=e.disabled?`✗ disabled`:`✓ enabled`,a=e.builtin?` · builtin`:``;return{label:e.name,value:e.name,detail:`${i}${a}${n?` · ${n}`:``}${r}\n${e.url}`,disabled:!1}}),u=e.filter(e=>!e.disabled).length;t.tui.modal.openModal({kind:`select`,title:`Registry Sources (${u}/${e.length} enabled)`,subtitle:o.length>0?o.map(e=>`⚠ ${e}`).join(`
+import{RegistryClient as e,builtinOfficialSource as t}from"@x-otto/coding";import{rankCandidates as n}from"@x-otto/shared";import{OTTO_HOME as r,OTTO_USER_CONFIG_DIR as i}from"@x-otto/env";function a(e){return process.env.OTTO_OFFICIAL_REGISTRY_URL??`https://x-ottojs.github.io/otto-registry/registry.json`}function o(n){return new e({configDir:i,ottoHome:r,officialSource:t(a(n))})}function s(e){return o(e.app)}async function c(e,t){let n=s(t),[r,...i]=e.filter(e=>!e.startsWith(`-`));try{if(r===`add`){let[e,r]=i;if(!e||!r){t.tui.info.showToast(`Registry`,`Usage: /registry add <name> <url>`);return}n.addSource(e,r),t.tui.info.showToast(`Registry`,`已注册 '${e}' → ${r}`);return}if(r===`remove`){let[e]=i;if(!e){t.tui.info.showToast(`Registry`,`Usage: /registry remove <name>`);return}n.removeSource(e),t.tui.info.showToast(`Registry`,`已移除 '${e}'`);return}let e=await n.listSourcesAsync(),{registries:a,warnings:o}=await n.loadAll(),s=new Map,c=new Map;for(let e of a)s.set(e.sourceName,e.entries.length),c.set(e.sourceName,e.stale);let l=e.map(e=>{let t=s.get(e.name),n=t===void 0?``:`${t} entries`,r=c.get(e.name)?` (stale cache)`:``,i=e.disabled?`✗ disabled`:`✓ enabled`,a=e.builtin?` · builtin`:``;return{label:e.name,value:e.name,detail:`${i}${a}${n?` · ${n}`:``}${r}\n${e.url}`,disabled:!1}}),u=e.filter(e=>!e.disabled).length;t.tui.modal.openModal({kind:`select`,title:`Registry Sources (${u}/${e.length} enabled)`,subtitle:o.length>0?o.map(e=>`⚠ ${e}`).join(`
 `):void 0,options:l,onSelect:n=>{let r=e.find(e=>e.name===n);if(!r)return;let i=s.get(r.name),a=`${i===void 0?``:`${i} entries · `}${r.disabled?`disabled`:`enabled`}${r.builtin?` · builtin`:``}\n${r.url}`,o=[];r.builtin?o.push(r.disabled?`/registry re-enable (coming soon)`:`/registry disable (coming soon)`):o.push(`/registry remove ${r.name}`),t.tui.info.showToast(r.name,`${a}\n${o.join(` · `)}`)},onCancel:()=>{}})}catch(e){t.tui.info.showToast(`Registry`,e instanceof Error?e.message:String(e))}}async function l(e,t){let{registries:r,warnings:i}=await s(e).loadAll();return{hits:n(r.flatMap(e=>e.entries.map(t=>({entry:t,registry:e}))).map(e=>({text:e.entry.id,aliases:[e.entry.description,...e.entry.keywords??[]],payload:e})),t,{maxResults:20}).map(e=>({entry:e.item.payload.entry,sourceName:e.item.payload.registry.sourceName,stale:e.item.payload.registry.stale})),warnings:i}}async function u(e,t){let r=e.filter(e=>!e.startsWith(`-`)).join(` `).trim();if(!r){t.tui.info.showToast(`Search`,`Usage: /search <keyword>`);return}let i;t.tui.modal.openModal({kind:`select`,title:`Search '${r}'`,subtitle:``,options:[],searchable:!0,onSelect:e=>{if(!i)return;let n=i[Number(e)];if(!n)return;let{entry:r}=n.item.payload,a=[`--as`,r.type,...r.subPath?[`--sub-path`,r.subPath]:[],r.source];import(`./install-WCcQ9k9M.js`).then(({handleInstall:e})=>e(a,t))},onCancel:()=>{},async:(async()=>{let{registries:e,warnings:a}=await s(t).loadAll();if(i=n(e.flatMap(e=>e.entries.map(t=>({entry:t,registry:e}))).map(e=>({text:e.entry.id,aliases:[e.entry.description,...e.entry.keywords??[]],payload:e})),r,{maxResults:20}),i.length===0){let e=a.length>0?`\n${a.map(e=>`⚠ ${e}`).join(`
 `)}`:``;return{title:`Search '${r}' — 0 hits`,subtitle:`No matches for '${r}'.${e}`,options:[]}}let o=new Map;for(let e of i){let t=e.item.payload.entry.id;o.set(t,(o.get(t)??0)+1)}let c=a.length>0?`\n${a.map(e=>`⚠ ${e}`).join(`
 `)}`:``;return{title:`Search '${r}' — ${i.length} hits`,subtitle:`Enter install (preview first) · Esc cancel${c}`,options:i.map((e,t)=>{let{entry:n,registry:r}=e.item.payload,i=n.capabilities?.length?`[${n.capabilities.join(`, `)}]`:``,a=r.stale?` (stale cache)`:``,s=(o.get(n.id)??0)>1?` @${r.sourceName}`:``;return{label:`${n.id}${s}  (${n.type})  ${i}${a}`,value:String(t),detail:n.description}})}})()})}export{l as i,u as n,o as r,c as t};
-//# sourceMappingURL=registry-D0NONjLv.js.map
+//# sourceMappingURL=registry-BdCcwyGy.js.map

package/dist/registry-BdCcwyGy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-BdCcwyGy.js","names":[],"sources":["../src/commands/handlers/registry.ts"],"sourcesContent":["/**\n * /registry 命令：插件注册源管理（add/remove/list + 检查）\n */\nimport { RegistryClient, builtinOfficialSource } from '@x-otto/coding'\nimport { OTTO_HOME, OTTO_USER_CONFIG_DIR } from '@x-otto/env'\nimport { rankCandidates } from '@x-otto/shared'\n\nimport type { App, LoadedRegistry, RegistryEntry } from '@x-otto/coding'\nimport type { CliContext } from '../../command-dispatcher'\nimport type { SelectOption } from '@x-otto/tui'\n\n/**\n * 官方源 URL（RFC-221 D1）：registry.json 经独立发布仓库（`x-ottojs/otto-registry`）\n * 的 GitHub Pages 单独发布，仓库本身保持 private（路径 B，已 grill 确认）。\n * `OTTO_OFFICIAL_REGISTRY_URL` 环境变量覆盖机制保留（开发者本地测试/CI 调试用）。\n *\n * 发布机制（RFC-221 M1）：CI workflow `.github/workflows/publish-registry.yml` 在\n * `docs/registry/registry.json` 变更推送到 main 后自动同步到 otto-registry 仓库。\n * 首次发布在 CI 验证完整链路前已手动推送完成（因 GitHub Actions 计费额度暂限制了\n * CI runner 执行，已直接 SSH push 验证内容可达，计费恢复后 CI 自动化同步即正常）。\n */\nfunction officialRegistryUrl(_app: Pick<App, 'workspaceDir'>): string {\n  return process.env['OTTO_OFFICIAL_REGISTRY_URL'] ??\n    'https://x-ottojs.github.io/otto-registry/registry.json'\n}\n\n/**\n * `App` 版工厂（导出复用于 `/registry remove` 参数补全接线——interactive-setup.ts 只持有\n * `App`，不持有完整 `CliContext`，见 RFC-125 D3 同款模式）。\n */\nexport function makeRegistryClient(app: Pick<App, 'workspaceDir'>): RegistryClient {\n  return new RegistryClient({\n    configDir: OTTO_USER_CONFIG_DIR,\n    ottoHome: OTTO_HOME,\n    officialSource: builtinOfficialSource(officialRegistryUrl(app)),\n  })\n}\n\nfunction makeClient(ctx: CliContext): RegistryClient {\n  return makeRegistryClient(ctx.app)\n}\n\nexport async function handleRegistry(args: string[], ctx: CliContext): Promise<void> {\n  const client = makeClient(ctx)\n  const [sub, ...rest] = args.filter((a) => !a.startsWith('-'))\n\n  try {\n    if (sub === 'add') {\n      const [name, url] = rest\n      if (!name || !url) {\n        ctx.tui.info.showToast('Registry', 'Usage: /registry add <name> <url>')\n        return\n      }\n      client.addSource(name, url)\n      ctx.tui.info.showToast('Registry', `已注册 '${name}' → ${url}`)\n      return\n    }\n    if (sub === 'remove') {\n      const [name] = rest\n      if (!name) {\n        ctx.tui.info.showToast('Registry', 'Usage: /registry remove <name>')\n        return\n      }\n      client.removeSource(name)\n      ctx.tui.info.showToast('Registry', `已移除 '${name}'`)\n      return\n    }\n    // 缺省/list：升级为交互式选择面板（此前是纯文本 system_notification 推对话流，\n    // 无上下选择/详情展开/启用禁用入口，无法快速浏览或操作多源）。\n    // RFC-341 G2：用 listSourcesAsync 而非 listSources，与下方 loadAll 内部走的源列表\n    // 一致（含内网可达时自动出现的 otto-official-internal）——否则面板选项与\n    // entryCounts/staleFlags 会对不上号（loadAll 加载了内网源但列表没显示它）。\n    const sources = await client.listSourcesAsync()\n\n    // 异步加载各源的条目计数（用于面板内展示，fail-soft：加载失败不阻断面板打开）\n    const { registries, warnings } = await client.loadAll()\n    const entryCounts = new Map<string, number>()\n    const staleFlags = new Map<string, boolean>()\n    for (const reg of registries) {\n      entryCounts.set(reg.sourceName, reg.entries.length)\n      staleFlags.set(reg.sourceName, reg.stale)\n    }\n\n    const options: SelectOption[] = sources.map((s) => {\n      const count = entryCounts.get(s.name)\n      const countStr = count !== undefined ? `${count} entries` : ''\n      const stale = staleFlags.get(s.name) ? ' (stale cache)' : ''\n      const status = s.disabled ? '✗ disabled' : '✓ enabled'\n      const builtin = s.builtin ? ' · builtin' : ''\n      return {\n        label: s.name,\n        value: s.name,\n        detail: `${status}${builtin}${countStr ? ` · ${countStr}` : ''}${stale}\\n${s.url}`,\n        disabled: false, // disabled 源仍可选中查看详情/重新启用\n      }\n    })\n\n    const enabledCount = sources.filter((s) => !s.disabled).length\n    ctx.tui.modal.openModal({\n      kind: 'select',\n      title: `Registry Sources (${enabledCount}/${sources.length} enabled)`,\n      subtitle: warnings.length > 0 ? warnings.map((w) => `⚠ ${w}`).join('\\n') : undefined,\n      options,\n      onSelect: (value: string) => {\n        const source = sources.find((s) => s.name === value)\n        if (!source) return\n        // 选中后显示详情 toast + 操作提示（启用/禁用、删除非内置源）\n        const count = entryCounts.get(source.name)\n        const countStr = count !== undefined ? `${count} entries · ` : ''\n        const details = `${countStr}${source.disabled ? 'disabled' : 'enabled'}${source.builtin ? ' · builtin' : ''}\\n${source.url}`\n        const actionHints: string[] = []\n        if (source.builtin) {\n          actionHints.push(source.disabled ? '/registry re-enable (coming soon)' : '/registry disable (coming soon)')\n        } else {\n          actionHints.push(`/registry remove ${source.name}`)\n        }\n        ctx.tui.info.showToast(source.name, `${details}\\n${actionHints.join(' · ')}`)\n      },\n      onCancel: () => {},\n    })\n  } catch (error) {\n    ctx.tui.info.showToast('Registry', error instanceof Error ? error.message : String(error))\n  }\n}\n\n/** search 数据面（/search 命令与 /extension 发现入口共用；RFC-201 M3）。 */\nexport async function searchRegistries(\n  ctx: CliContext,\n  keyword: string,\n): Promise<{ hits: Array<{ entry: RegistryEntry; sourceName: string; stale: boolean }>; warnings: string[] }> {\n  const client = makeClient(ctx)\n  const { registries, warnings } = await client.loadAll()\n  const candidates = registries.flatMap((registry) =>\n    registry.entries.map((entry) => ({ entry, registry })),\n  )\n  const ranked = rankCandidates(\n    candidates.map((hit) => ({\n      text: hit.entry.id,\n      aliases: [hit.entry.description, ...(hit.entry.keywords ?? [])],\n      payload: hit,\n    })),\n    keyword,\n    { maxResults: 20 },\n  )\n  return {\n    hits: ranked.map((r) => ({\n      entry: r.item.payload.entry,\n      sourceName: r.item.payload.registry.sourceName,\n      stale: r.item.payload.registry.stale,\n    })),\n    warnings,\n  }\n}\n\nexport async function handleSearch(args: string[], ctx: CliContext): Promise<void> {\n  const keyword = args.filter((a) => !a.startsWith('-')).join(' ').trim()\n  if (!keyword) {\n    ctx.tui.info.showToast('Search', 'Usage: /search <keyword>')\n    return\n  }\n\n  // RFC-227：框架层 async loading 门——将\"await 全流程 → openModal\"改为\n  // \"openModal + async 字段：promise 内做 loadAll+rank，resolve 返回内容，\n  // 框架层自动处理 loading→内容过渡\"。ranked 在 outer scope 声明供 onSelect\n  // 闭包引用，async promise 内赋值（lesson_104：透传，非重新计算）。\n  interface Hit { entry: RegistryEntry; registry: LoadedRegistry }\n  let ranked: Array<{ item: { payload: Hit } }> | undefined\n\n  ctx.tui.modal.openModal({\n    kind: 'select',\n    title: `Search '${keyword}'`,\n    subtitle: '',  // loading 态框架层填充，此处占位\n    options: [] as never,  // async 存在时 options 由框架层管理\n    searchable: true,  // 先占 searchable 模式，等结果数决定是否真的 searchable\n    onSelect: (v: string) => {\n      if (!ranked) return\n      const hit = ranked[Number(v)]\n      if (!hit) return\n      const { entry } = hit.item.payload\n      const installArgs = ['--as', entry.type, ...(entry.subPath ? ['--sub-path', entry.subPath] : []), entry.source]\n      void import('./install').then(({ handleInstall }) => handleInstall(installArgs, ctx))\n    },\n    onCancel: () => {},\n    async: (async () => {\n      const client = makeClient(ctx)\n      const { registries, warnings } = await client.loadAll()\n\n      interface Hit { entry: RegistryEntry; registry: LoadedRegistry }\n      const candidates: Hit[] = registries.flatMap((registry) =>\n        registry.entries.map((entry) => ({ entry, registry })),\n      )\n\n      ranked = rankCandidates(\n        candidates.map((hit) => ({\n          text: hit.entry.id,\n          aliases: [hit.entry.description, ...(hit.entry.keywords ?? [])],\n          payload: hit,\n        })),\n        keyword,\n        { maxResults: 20 },\n      )\n\n      if (ranked.length === 0) {\n        const extra = warnings.length > 0 ? `\\n${warnings.map((w) => `⚠ ${w}`).join('\\n')}` : ''\n        // 零命中结果——返回空选项列表，subtitle 告知用户\n        return {\n          title: `Search '${keyword}' — 0 hits`,\n          subtitle: `No matches for '${keyword}'.${extra}`,\n          options: [],\n        }\n      }\n\n      const idCounts = new Map<string, number>()\n      for (const r of ranked) {\n        const id = r.item.payload.entry.id\n        idCounts.set(id, (idCounts.get(id) ?? 0) + 1)\n      }\n\n      const subtitleWarnings = warnings.length > 0\n        ? `\\n${warnings.map((w) => `⚠ ${w}`).join('\\n')}`\n        : ''\n\n      return {\n        title: `Search '${keyword}' — ${ranked.length} hits`,\n        subtitle: `Enter install (preview first) · Esc cancel${subtitleWarnings}`,\n        options: ranked.map((r, i) => {\n          const { entry, registry } = r.item.payload\n          const caps = entry.capabilities?.length ? `[${entry.capabilities.join(', ')}]` : ''\n          const stale = registry.stale ? ' (stale cache)' : ''\n          const dupMark = (idCounts.get(entry.id) ?? 0) > 1 ? ` @${registry.sourceName}` : ''\n          return {\n            label: `${entry.id}${dupMark}  (${entry.type})  ${caps}${stale}`,\n            value: String(i),\n            detail: entry.description,\n          }\n        }),\n      }\n    })(),\n  })\n}\n"],"mappings":"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"}

package/dist/{run-attach-Ci5jYyCa.js → run-attach-CvGCWF_i.js}

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import{r as e}from"./service-client-BLNeugM9.js";import{createAttachSessionDataSource as t,createSessionEventReduceBridge as n,createStoreTuiSink as r,startTui as i}from"@x-otto/tui";const a=e=>typeof e==`object`&&!!e&&!Array.isArray(e);function o(e,t){let n;n=e.startsWith(`https://`)?`wss://${e.slice(8)}`:e.startsWith(`http://`)?`ws://${e.slice(7)}`:e.startsWith(`localhost`)||e.startsWith(`127.`)?`ws://${e}`:`wss://${e}`;let r=`${n.replace(/\/$/,``)}/ws`;return t?`${r}?token=${encodeURIComponent(t)}`:r}function s(e,t,n){let r=n.WebSocketImpl??globalThis.WebSocket,i=n.setTimeoutImpl??setTimeout,s=n.clearTimeoutImpl??clearTimeout,c=n.initialBackoffMs??500,l=n.maxBackoffMs??1e4,u=null,d=c,f=null,p=!1,m=0,h=null,g=null,_=1,v=new Map,y=null,b=e=>{e!==y&&(y=e,n.onStateChange?.(e))},x=(e=u)=>{!e||e.readyState!==e.OPEN||e.send(JSON.stringify({method:`Session.subscribe`,params:{sessionId:t,since:m}}))},S=()=>{p||f!==null||(f=i(()=>{f=null,b(`connecting`),w()},d),d=Math.min(d*2,l))},C=e=>{e.onopen=null,e.onmessage=null,e.onclose=null,e.onerror=null;try{e.close()}catch{}u===e&&(u=null)},w=()=>{if(p)return;b(`connecting`);let i;try{i=new r(o(e))}catch{S();return}u=i,i.onopen=()=>{d=c,b(`connected`),x(i)},i.onmessage=e=>{let r;try{r=JSON.parse(String(e.data))}catch{return}if(r.type===`Session.event`&&a(r.data)){let e=r.data;if(typeof e.sessionId!=`string`||e.sessionId!==t||!Number.isSafeInteger(e.seq)||e.seq<0)return;let n=e.seq;if(n<_||v.has(n))return;let{seq:i,...a}=e;for(v.set(n,{seq:n,payload:a});v.has(_);){let e=v.get(_);v.delete(_),h?.(e),m=_,_+=1}return}if(r.type===`Runtime.writeLease`&&a(r.data)){let e=r.data;n.onWriteLease?.({sessionId:typeof e.sessionId==`string`?e.sessionId:t,state:e.state??`not-held`,reason:typeof e.reason==`string`?e.reason:void 0,leaseOwner:typeof e.leaseOwner==`string`?e.leaseOwner:void 0});return}if(r.type===`Runtime.error`&&a(r.data)){let e=r.data,t=typeof e.message==`string`?e.message:``;if(e.code===`EVENT_LOG_GAP`){g?.({reason:`gap`,oldestAvailable:_}),C(i),S();return}n.onNotify?.(`[service] ${e.code??`runtime`}: ${t}`)}},i.onclose=()=>{u===i&&(u=null),p?b(`closed`):(b(`reconnecting`),S())},i.onerror=()=>{}};return{fetchSnapshot:e=>n.fetchSnapshot(e),subscribe(e,t,n,r){m=t,h=n,g=r,m=Math.max(m,t),_=m+1;for(let e of v.keys())e<=m&&v.delete(e);return u?u.readyState===u.OPEN&&x():w(),()=>{p=!0,f!==null&&(s(f),f=null),b(`closed`),u&&C(u),h=null,g=null}},sendVerb(e,t){p||!u||u.readyState!==u.OPEN||u.send(JSON.stringify({method:e,params:t}))}}}async function c(a){let o=a.stdout??process.stdout,c=a.stdin??process.stdin,l=a.fetchImpl??globalThis.fetch,u=!0,d,f=e(a.baseUrl,l,{token:a.token}),p;try{p=await f.fetchSnapshot(a.sessionId)}catch(e){throw o.write(`otto --attach: 无法连接 serve 上的会话 ${a.sessionId}：${e instanceof Error?e.message:String(e)}\n`),e}let m=p.session.id,h,g=e=>{if(!h)return;let t={role:`assistant`,content:[{type:`text`,text:e}]};h.messages.pushMessage(t)};h=await i({stdin:c,stdout:o,columns:o.columns??100,needsSetup:!1,welcome:{cwd:void 0},onSubmit:e=>{let t=e.trimStart();if(t.startsWith(`/`)){g(`[attach] \`${t.split(/\s+/)[0]}\` 为 attach 暂未支持命令。\n仅支持纯文本提交（经 Chat.query 下发到 serve）；如需本地命令请退出 attach 后运行。`);return}if(h){if(!u){g(`[attach] 会话的写权已被另一 client 持有（${d??`?`}）——本端变只读观察者。请另选 session 或让对方退出 attach。`);return}(async()=>{try{await f.sendPrompt(m,e)}catch(e){g(`[attach] 提交失败：${e instanceof Error?e.message:String(e)}`)}})()}}});let _=s(a.baseUrl,m,{fetchSnapshot:async e=>await f.fetchSnapshot(e),onNotify:e=>g(`[attach] ${e}`),onStateChange:e=>{e===`connected`?(g(`[attach] 已连接 serve。`),a.forceWriteLease?(g(`[attach] --force-write-lease：向服务端发起 force_acquire（kill -9 解锁通道）……`),_.sendVerb(`Session.writeLease.force_acquire`,{sessionId:m})):_.sendVerb(`Session.writeLease.acquire`,{sessionId:m})):e===`reconnecting`?(u=!1,g(`[attach] 连接断开，正在重连……`)):e===`closed`&&(u=!1,g(`[attach] 连接已关闭。`))},onWriteLease:e=>{e.state===`acquired`?(u=!0,d=e.leaseOwner,g(`[attach] 获会话写权——纯文本会走 Chat.query 到 service。`)):e.state===`denied`?(u=!1,d=e.leaseOwner,g(`[attach] 会话写权被另一 client 持有（${e.leaseOwner??`?`}）——本端变只读观察者态；提交纯文本会被本端予拦截。\n若对方是 kill -9 残留，可重启带 \`--force-write-lease\` 强抢写权。`)):e.state===`released`&&(u=!1,d=e.leaseOwner,e.reason===`forced_by_other_client`?g(`[attach] 写权被另一 client 强行剥夺（force_acquire by ${e.leaseOwner??`?`}）——本端变只读观察者态。`):g(`[attach] 写权已释放——重新 conn 上可申请。`))}}),v=n(r({pushMessage:h.messages.pushMessage,echoUserInput:h.messages.echoUserInput,pushEngineEvent:h.engine.pushEngineEvent,getNotifyStats:h.info.getNotifyStats,setTasks:h.stores.tasks.setTasks,addTurnBoundary:h.stores.tasks.addTurnBoundary})),y=t({transport:_,sessionId:m,onSessionEvent:v.handle,hydrateMessages:(e,t)=>{e.messageStore.setState(()=>({messages:[]})),t.length>0&&e.messageStore.setState(()=>({messages:[...t]})),v.reset(t.length)},onGap:()=>{g(`[attach] 会话事件日志 gap（cursor 被 service 逐出）——已重新水合 messages 快照。`)}});await h.lifecycle.attachSessionSource(y),g(`[attach] 已连接会话 ${m}（host=${p.authority.hostname} pid=${p.authority.pid}）。\nsnapshot messages 已灌入 store；后续 Session.event 经 WS 实时应用；纯文本走 Chat.query；/xxx 斜杠命令暂未支持。`)}export{c as runAttach};
-//# sourceMappingURL=run-attach-Ci5jYyCa.js.map
+import{r as e}from"./service-client-Cr4sxDVM.js";import{createAttachSessionDataSource as t,createSessionEventReduceBridge as n,createStoreTuiSink as r,startTui as i}from"@x-otto/tui";const a=e=>typeof e==`object`&&!!e&&!Array.isArray(e);function o(e,t){let n;n=e.startsWith(`https://`)?`wss://${e.slice(8)}`:e.startsWith(`http://`)?`ws://${e.slice(7)}`:e.startsWith(`localhost`)||e.startsWith(`127.`)?`ws://${e}`:`wss://${e}`;let r=`${n.replace(/\/$/,``)}/ws`;return t?`${r}?token=${encodeURIComponent(t)}`:r}function s(e,t,n){let r=n.WebSocketImpl??globalThis.WebSocket,i=n.setTimeoutImpl??setTimeout,s=n.clearTimeoutImpl??clearTimeout,c=n.initialBackoffMs??500,l=n.maxBackoffMs??1e4,u=null,d=c,f=null,p=!1,m=0,h=null,g=null,_=1,v=new Map,y=null,b=e=>{e!==y&&(y=e,n.onStateChange?.(e))},x=(e=u)=>{!e||e.readyState!==e.OPEN||e.send(JSON.stringify({method:`Session.subscribe`,params:{sessionId:t,since:m}}))},S=()=>{p||f!==null||(f=i(()=>{f=null,b(`connecting`),w()},d),d=Math.min(d*2,l))},C=e=>{e.onopen=null,e.onmessage=null,e.onclose=null,e.onerror=null;try{e.close()}catch{}u===e&&(u=null)},w=()=>{if(p)return;b(`connecting`);let i;try{i=new r(o(e))}catch{S();return}u=i,i.onopen=()=>{d=c,b(`connected`),x(i)},i.onmessage=e=>{let r;try{r=JSON.parse(String(e.data))}catch{return}if(r.type===`Session.event`&&a(r.data)){let e=r.data;if(typeof e.sessionId!=`string`||e.sessionId!==t||!Number.isSafeInteger(e.seq)||e.seq<0)return;let n=e.seq;if(n<_||v.has(n))return;let{seq:i,...a}=e;for(v.set(n,{seq:n,payload:a});v.has(_);){let e=v.get(_);v.delete(_),h?.(e),m=_,_+=1}return}if(r.type===`Runtime.writeLease`&&a(r.data)){let e=r.data;n.onWriteLease?.({sessionId:typeof e.sessionId==`string`?e.sessionId:t,state:e.state??`not-held`,reason:typeof e.reason==`string`?e.reason:void 0,leaseOwner:typeof e.leaseOwner==`string`?e.leaseOwner:void 0});return}if(r.type===`Runtime.error`&&a(r.data)){let e=r.data,t=typeof e.message==`string`?e.message:``;if(e.code===`EVENT_LOG_GAP`){g?.({reason:`gap`,oldestAvailable:_}),C(i),S();return}n.onNotify?.(`[service] ${e.code??`runtime`}: ${t}`)}},i.onclose=()=>{u===i&&(u=null),p?b(`closed`):(b(`reconnecting`),S())},i.onerror=()=>{}};return{fetchSnapshot:e=>n.fetchSnapshot(e),subscribe(e,t,n,r){m=t,h=n,g=r,m=Math.max(m,t),_=m+1;for(let e of v.keys())e<=m&&v.delete(e);return u?u.readyState===u.OPEN&&x():w(),()=>{p=!0,f!==null&&(s(f),f=null),b(`closed`),u&&C(u),h=null,g=null}},sendVerb(e,t){p||!u||u.readyState!==u.OPEN||u.send(JSON.stringify({method:e,params:t}))}}}async function c(a){let o=a.stdout??process.stdout,c=a.stdin??process.stdin,l=a.fetchImpl??globalThis.fetch,u=!0,d,f=e(a.baseUrl,l,{token:a.token}),p;try{p=await f.fetchSnapshot(a.sessionId)}catch(e){throw o.write(`otto --attach: 无法连接 serve 上的会话 ${a.sessionId}：${e instanceof Error?e.message:String(e)}\n`),e}let m=p.session.id,h,g=e=>{if(!h)return;let t={role:`assistant`,content:[{type:`text`,text:e}]};h.messages.pushMessage(t)};h=await i({stdin:c,stdout:o,columns:o.columns??100,needsSetup:!1,welcome:{cwd:void 0},onSubmit:e=>{let t=e.trimStart();if(t.startsWith(`/`)){g(`[attach] \`${t.split(/\s+/)[0]}\` 为 attach 暂未支持命令。\n仅支持纯文本提交（经 Chat.query 下发到 serve）；如需本地命令请退出 attach 后运行。`);return}if(h){if(!u){g(`[attach] 会话的写权已被另一 client 持有（${d??`?`}）——本端变只读观察者。请另选 session 或让对方退出 attach。`);return}(async()=>{try{await f.sendPrompt(m,e)}catch(e){g(`[attach] 提交失败：${e instanceof Error?e.message:String(e)}`)}})()}}});let _=s(a.baseUrl,m,{fetchSnapshot:async e=>await f.fetchSnapshot(e),onNotify:e=>g(`[attach] ${e}`),onStateChange:e=>{e===`connected`?(g(`[attach] 已连接 serve。`),a.forceWriteLease?(g(`[attach] --force-write-lease：向服务端发起 force_acquire（kill -9 解锁通道）……`),_.sendVerb(`Session.writeLease.force_acquire`,{sessionId:m})):_.sendVerb(`Session.writeLease.acquire`,{sessionId:m})):e===`reconnecting`?(u=!1,g(`[attach] 连接断开，正在重连……`)):e===`closed`&&(u=!1,g(`[attach] 连接已关闭。`))},onWriteLease:e=>{e.state===`acquired`?(u=!0,d=e.leaseOwner,g(`[attach] 获会话写权——纯文本会走 Chat.query 到 service。`)):e.state===`denied`?(u=!1,d=e.leaseOwner,g(`[attach] 会话写权被另一 client 持有（${e.leaseOwner??`?`}）——本端变只读观察者态；提交纯文本会被本端予拦截。\n若对方是 kill -9 残留，可重启带 \`--force-write-lease\` 强抢写权。`)):e.state===`released`&&(u=!1,d=e.leaseOwner,e.reason===`forced_by_other_client`?g(`[attach] 写权被另一 client 强行剥夺（force_acquire by ${e.leaseOwner??`?`}）——本端变只读观察者态。`):g(`[attach] 写权已释放——重新 conn 上可申请。`))}}),v=n(r({pushMessage:h.messages.pushMessage,echoUserInput:h.messages.echoUserInput,pushEngineEvent:h.engine.pushEngineEvent,getNotifyStats:h.info.getNotifyStats,setTasks:h.stores.tasks.setTasks,addTurnBoundary:h.stores.tasks.addTurnBoundary})),y=t({transport:_,sessionId:m,onSessionEvent:v.handle,hydrateMessages:(e,t)=>{e.messageStore.setState(()=>({messages:[]})),t.length>0&&e.messageStore.setState(()=>({messages:[...t]})),v.reset(t.length)},onGap:()=>{g(`[attach] 会话事件日志 gap（cursor 被 service 逐出）——已重新水合 messages 快照。`)}});await h.lifecycle.attachSessionSource(y),g(`[attach] 已连接会话 ${m}（host=${p.authority.hostname} pid=${p.authority.pid}）。\nsnapshot messages 已灌入 store；后续 Session.event 经 WS 实时应用；纯文本走 Chat.query；/xxx 斜杠命令暂未支持。`)}export{c as runAttach};
+//# sourceMappingURL=run-attach-CvGCWF_i.js.map