@x-otto/cli 0.0.1-alpha.4 → 0.0.1-alpha.41
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +65 -65
- package/bin/otto.js +6 -0
- package/dist/{auth-command-CXAB3_hs.js → auth-command-D1T16ed-.js} +3 -3
- package/dist/auth-command-D1T16ed-.js.map +1 -0
- package/dist/build-id-DuVd7k7E.js +3 -0
- package/dist/build-id-DuVd7k7E.js.map +1 -0
- package/dist/bundled-extensions/plugin-otto-wire-protocols/plugin-dist/meta.json +1 -1
- package/dist/bundled-extensions/plugin-otto-wire-protocols/plugin-dist/plugin.cjs +949 -42999
- package/dist/bundled-extensions/plugin-otto-wire-protocols/src/anthropic-messages.ts +2 -2
- package/dist/bundled-extensions/plugin-otto-wire-protocols/src/openai-completions.ts +12 -5
- package/dist/bundled-extensions/plugin-otto-wire-protocols/src/openai-responses.ts +4 -1
- package/dist/bundled-extensions-C3n8jg20.js +3 -0
- package/dist/bundled-extensions-C3n8jg20.js.map +1 -0
- package/dist/command-dispatcher-BtW9xSr5.js +21 -0
- package/dist/command-dispatcher-BtW9xSr5.js.map +1 -0
- package/dist/create-host-app-BXQ8bU-B.js +3 -0
- package/dist/create-host-app-BXQ8bU-B.js.map +1 -0
- package/dist/create-host-app-DXII2WTM.js +2 -0
- package/dist/discover-with-bundled-B5d4q___.js +2 -0
- package/dist/discover-with-bundled-CF8qFP41.js +3 -0
- package/dist/discover-with-bundled-CF8qFP41.js.map +1 -0
- package/dist/doctor-CuNvDmyA.js +36 -0
- package/dist/doctor-CuNvDmyA.js.map +1 -0
- package/dist/extension-1-lxuerZ.js +178 -0
- package/dist/extension-1-lxuerZ.js.map +1 -0
- package/dist/extension-DWGIIBc6.js +2 -0
- package/dist/feedback-C0oxUebv.js +21 -0
- package/dist/feedback-C0oxUebv.js.map +1 -0
- package/dist/feedback-eJ87AQPr.js +2 -0
- package/dist/{feishu-setup-D6vnuNLw.js → feishu-setup-B6ETf-8Y.js} +2 -2
- package/dist/{feishu-setup-D6vnuNLw.js.map → feishu-setup-B6ETf-8Y.js.map} +1 -1
- package/dist/ftue-doctor-recovery-DeAf8jVo.js +3 -0
- package/dist/ftue-doctor-recovery-DeAf8jVo.js.map +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +11 -13
- package/dist/index.js.map +1 -1
- package/dist/install-DlVJRHRT.js.map +1 -1
- package/dist/observe-CZ96Vre9.js +83 -0
- package/dist/observe-CZ96Vre9.js.map +1 -0
- package/dist/parse-cli-DO9wTwtm.js +3 -0
- package/dist/parse-cli-DO9wTwtm.js.map +1 -0
- package/dist/persistence-CpwMgSMe.js +85 -0
- package/dist/persistence-CpwMgSMe.js.map +1 -0
- package/dist/plugin-assembly-check-C2TephMb.js +3 -0
- package/dist/plugin-assembly-check-C2TephMb.js.map +1 -0
- package/dist/registry-BOX7DaxS.js +2 -0
- package/dist/{registry-D0NONjLv.js → registry-BdCcwyGy.js} +2 -2
- package/dist/registry-BdCcwyGy.js.map +1 -0
- package/dist/{run-attach-Ci5jYyCa.js → run-attach-CvGCWF_i.js} +2 -2
- package/dist/{run-attach-Ci5jYyCa.js.map → run-attach-CvGCWF_i.js.map} +1 -1
- package/dist/serve-DbBDYdoC.js +21 -0
- package/dist/serve-DbBDYdoC.js.map +1 -0
- package/dist/{service-client-BLNeugM9.js → service-client-Cr4sxDVM.js} +1 -1
- package/dist/{service-client-BLNeugM9.js.map → service-client-Cr4sxDVM.js.map} +1 -1
- package/dist/{version-C0qM-qJM.js → version-0tC0345U.js} +2 -2
- package/dist/{version-C0qM-qJM.js.map → version-0tC0345U.js.map} +1 -1
- package/package.json +23 -23
- package/dist/auth-command-CXAB3_hs.js.map +0 -1
- package/dist/build-id-BX4QHzM0.js +0 -3
- package/dist/build-id-BX4QHzM0.js.map +0 -1
- package/dist/bundled-extensions/plugin-skill-inductor/otto-plugin.json +0 -8
- package/dist/bundled-extensions/plugin-skill-inductor/plugin-dist/meta.json +0 -1
- package/dist/bundled-extensions/plugin-skill-inductor/plugin-dist/plugin.cjs +0 -52781
- package/dist/bundled-extensions/plugin-skill-inductor/plugin.ts +0 -77
- package/dist/bundled-extensions/plugin-skill-inductor/src/candidate-detector.ts +0 -210
- package/dist/bundled-extensions/plugin-skill-inductor/src/candidate-digest.ts +0 -146
- package/dist/bundled-extensions/plugin-skill-inductor/src/candidate-store.ts +0 -87
- package/dist/bundled-extensions/plugin-skill-inductor/src/episode-store.ts +0 -122
- package/dist/bundled-extensions/plugin-skill-inductor/src/episode.ts +0 -125
- package/dist/bundled-extensions/plugin-skill-inductor/src/extraction-prompt.ts +0 -97
- package/dist/bundled-extensions/plugin-skill-inductor/src/inductor-service.ts +0 -183
- package/dist/bundled-extensions/plugin-skill-inductor/src/similarity.ts +0 -58
- package/dist/command-dispatcher-BVGddstc.js +0 -13
- package/dist/command-dispatcher-BVGddstc.js.map +0 -1
- package/dist/debug-CiosFwme.js +0 -34
- package/dist/debug-CiosFwme.js.map +0 -1
- package/dist/discover-with-bundled-CznLjkkw.js +0 -3
- package/dist/discover-with-bundled-CznLjkkw.js.map +0 -1
- package/dist/doctor-C84-hhEr.js +0 -30
- package/dist/doctor-C84-hhEr.js.map +0 -1
- package/dist/extension-BKXIr86F.js +0 -170
- package/dist/extension-BKXIr86F.js.map +0 -1
- package/dist/extension-CnON6Xum.js +0 -2
- package/dist/extension-plugin-DB-bWOIf.js +0 -7
- package/dist/extension-plugin-DB-bWOIf.js.map +0 -1
- package/dist/extension-plugin-DoKKFxRC.js +0 -2
- package/dist/feedback-BES_6ebi.js +0 -21
- package/dist/feedback-BES_6ebi.js.map +0 -1
- package/dist/feedback-BRbLUn9u.js +0 -2
- package/dist/model-auth-B95mFA-O.js +0 -2
- package/dist/model-auth-BlaZzUUK.js +0 -3
- package/dist/model-auth-BlaZzUUK.js.map +0 -1
- package/dist/observe-CVg-MRM2.js +0 -32
- package/dist/observe-CVg-MRM2.js.map +0 -1
- package/dist/parse-cli-cYMjnAum.js +0 -3
- package/dist/parse-cli-cYMjnAum.js.map +0 -1
- package/dist/persistenced-CCwHu1Ww.js +0 -36
- package/dist/persistenced-CCwHu1Ww.js.map +0 -1
- package/dist/registry-B3nfN62q.js +0 -2
- package/dist/registry-D0NONjLv.js.map +0 -1
- package/dist/remote-persistence-server-B_hONoVR.js +0 -35
- package/dist/remote-persistence-server-B_hONoVR.js.map +0 -1
- package/dist/serve-pVR6UIT9.js +0 -21
- package/dist/serve-pVR6UIT9.js.map +0 -1
- package/dist/time-travel-ZozuPPI-.js +0 -21
- package/dist/time-travel-ZozuPPI-.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"install-DlVJRHRT.js","names":[],"sources":["../src/commands/handlers/install.ts"],"sourcesContent":["/**\n * handlers/install.ts — /install 命令处理\n *\n * /install [--global] [--force] [--dry-run] [--as <type>] [--type <src>] <source>\n *\n * 安装 skill/plugin/mcp 包到项目 (.otto/) 或全局 (~/.otto/)。\n * 支持 file/url/git/npm 四种来源,自动检测内容类型。\n */\nimport { i18next } from '@x-otto/tui'\nimport { InstallManager, defaultPostInstallExecutor } from '@x-otto/coding'\nimport { formatBytes } from '@x-otto/shared'\nimport type { InstallOptions, InstallProgress, InstallResult } from '@x-otto/coding'\nimport type { McpServersConfig } from '@x-otto/setting'\nimport type { SelectOption } from '@x-otto/tui'\nimport type { CliContext } from '../../command-dispatcher'\n\nconst VALID_AS = new Set(['plugin', 'skill', 'mcp'])\n\nexport async function handleInstall(\n args: string[],\n ctx: CliContext,\n): Promise<void> {\n const parsed = parseArgs(args)\n if (!parsed.source) {\n ctx.tui.info.showToast(i18next.t('cmd.titleInstall'), i18next.t('cmd.installUsage'))\n return\n }\n\n const isGlobal = parsed.flags.has('--global')\n const isHere = parsed.flags.has('--here')\n\n if (isGlobal && isHere) {\n ctx.tui.info.showToast(i18next.t('cmd.titleInstall'), i18next.t('cmd.installMutuallyExclusive'))\n return\n }\n\n const options: InstallOptions = {\n // --here:锚到当前命令目录,绕过 ctx.app.workspaceDir 的向上工作区根查找。\n workspaceDir: isHere ? process.cwd() : ctx.app.workspaceDir,\n global: isGlobal,\n force: parsed.flags.has('--force'),\n dryRun: parsed.flags.has('--dry-run'),\n as: parsed.as,\n type: parsed.type,\n env: parsed.env,\n subPath: parsed.subPath,\n ref: parsed.ref,\n postInstallExecutor: defaultPostInstallExecutor,\n // RFC-131: 进度回调 — 仅非 dry-run 时注入\n onProgress: !parsed.dryRun ? (p) => {\n const prefix = p.total && p.current ? `[${p.current}/${p.total}] ` : ''\n ctx.tui.info.showToast('Installing', `${prefix}${p.message}`)\n } : undefined,\n }\n\n // 确认优先(P3 安全边界):始终先 dry-run 取 plan 展示——含将运行的 postinstall/setup\n // shell 命令——确认后才真装(项目级插件真装含 auto-trust + 立即跑 postinstall)。\n // --dry-run 仅预览,不提供安装按钮。\n await showConfirmPanel(parsed.source, options, ctx, !parsed.dryRun)\n}\n\n// ── 参数解析 ──\n\ninterface ParsedArgs {\n source: string | undefined\n flags: Set<string>\n as: 'plugin' | 'skill' | 'mcp' | undefined\n type: 'file' | 'url' | 'git' | 'npm' | undefined\n env: Record<string, string> | undefined\n /** RFC-201:monorepo 子目录(--sub-path,registry 条目 subPath 的 CLI 透传面)。 */\n subPath: string | undefined\n /**\n * RFC-221 D2/T221-3:git 来源的 tag/branch 名(`--ref`),透传到\n * `InstallOptions.ref` → `resolveGitSource(gitUrl, ref)`。仅对 git 来源有效,\n * 其余来源类型忽略此参数(不报错,与 subPath 对非 git/归档来源的静默忽略语义一致)。\n * 不支持 commit hash——见 `git-resolver.ts` 头部注释(主流托管方服务端默认拒绝)。\n */\n ref: string | undefined\n dryRun: boolean\n}\n\n/** 导出供单测覆盖 `--ref`/`--sub-path` 等标志解析行为(RFC-221 T221-3),非公开 API。 */\nexport function parseArgs(args: string[]): ParsedArgs {\n const flags = new Set<string>()\n let as: 'plugin' | 'skill' | 'mcp' | undefined\n let type: 'file' | 'url' | 'git' | 'npm' | undefined\n let env: Record<string, string> | undefined\n let subPath: string | undefined\n let ref: string | undefined\n let dryRun = false\n let i = 0\n\n while (i < args.length) {\n const a = args[i]!\n if (a === '--as') {\n i++\n const val = args[i]?.toLowerCase()\n if (VALID_AS.has(val ?? '')) as = val as typeof as\n } else if (a === '--type') {\n i++\n const val = args[i]?.toLowerCase()\n if (val === 'file' || val === 'url' || val === 'git' || val === 'npm') {\n type = val\n }\n } else if (a === '--sub-path') {\n // RFC-201 M0/M1:monorepo 子目录安装(registry 条目 subPath 的 CLI 透传面)\n i++\n subPath = args[i]\n } else if (a === '--ref') {\n // RFC-221 D2/T221-3:git 来源 tag/branch 指定安装\n i++\n ref = args[i]\n } else if (a === '--env') {\n i++\n const kv = args[i]\n if (kv) {\n const eq = kv.indexOf('=')\n if (eq > 0) {\n env = env ?? {}\n env[kv.slice(0, eq)] = kv.slice(eq + 1)\n }\n }\n } else if (a.startsWith('--')) {\n flags.add(a)\n } else {\n // positional (source)\n dryRun = flags.has('--dry-run')\n const rest = args.slice(i).filter((x) => !x.startsWith('--'))\n return { source: rest[0], flags, as, type, env, subPath, ref, dryRun }\n }\n i++\n }\n\n dryRun = flags.has('--dry-run')\n return { source: undefined, flags, as, type, env, subPath, ref, dryRun }\n}\n\n// ── 确认面板 ──\n\n/**\n * 先 dry-run 取安装 plan 并展示确认屏。\n *\n * RFC-226:命令发出到确认框出现之间新增 loading 反馈——dry-run 探测(git clone/npm pack/\n * url 下载 + 内容检测)本身耗时不短,此前全程静默。改造后:① 立即展示 loading 态弹窗\n * (options=[] 空选项态,D2);② dry-run 探测阶段(resolving/detecting)的进度通过局部\n * `onProgress`(不复用 `options.onProgress` toast 版本,D5b/R6)实时刷新 loading 文案;\n * ③ dry-run 完成后原地过渡为确认框或错误态(D3/D5a)。\n *\n * **修复**(dialog 栈堆积):此前每次状态转换(loading→进度更新→确认/错误/预览)都调用\n * `ctx.tui.modal.openModal({ kind: 'select' })`,而同步 select 路径每次 `router.navigate` 都是\n * push 新栈条目,导致对话框层层堆积、用户要按多次 Esc 才能退出。现改用框架层 `async` 字段:\n * loading 态由框架自动展示,dry-run 在 async promise 内完成,resolve 后框架用 `replace: true`\n * 原地过渡为真实内容。最终的确认/错误/预览弹窗由 `onSelect` 回调内驱动(此时 loading 弹窗\n * 已被框架 replace 为最终态,Esc 一次即可退出)。\n *\n * @param proceed true=确认后真装([安装, 取消]);false=纯预览(--dry-run,仅[关闭])。\n */\nasync function showConfirmPanel(\n source: string,\n options: InstallOptions,\n ctx: CliContext,\n proceed: boolean,\n): Promise<void> {\n const manager = new InstallManager()\n const loadingTitle = `${i18next.t('cmd.titleInstall')} — \"${source}\"`\n\n // dry-run 专用局部 onProgress——不复用 options.onProgress(toast 版本,只服务\n // executeInstall 真实安装路径)。探测阶段进度文案由 async promise 内部记录,\n // resolve 时作为 subtitle 回灌(框架 replace 一次性更新)。\n let progressMessage = i18next.t('cmd.installLoadingHint')\n const dryOptions: InstallOptions = {\n ...options,\n dryRun: true,\n onProgress: (p: InstallProgress) => {\n progressMessage = p.message\n },\n }\n\n ctx.tui.modal.openModal({\n kind: 'select',\n title: loadingTitle,\n subtitle: `${i18next.t('cmd.titleDryRun')}...\\n${progressMessage}`,\n layout: 'buttons',\n options: [],\n onCancel: () => {\n ctx.tui.info.showToast(i18next.t('cmd.titleInstall'), i18next.t('cmd.selectCancelled'))\n },\n // async:dry-run 探测在 promise 内完成,resolve 后框架用 replace:true 原地过渡。\n async: (async (): Promise<{ title?: string; subtitle?: string; options: SelectOption[] }> => {\n const result = await manager.install(\n source,\n dryOptions,\n () => ctx.app.settings.get('mcp_servers') as Record<string, unknown> | undefined,\n async (servers) => {\n await ctx.app.settings.persist({ mcp_servers: servers as McpServersConfig })\n },\n )\n\n if (!result.success) {\n return {\n title: loadingTitle,\n subtitle: i18next.t('cmd.dryRunDetectFailed', { err: result.error ?? i18next.t('cmd.unknownError') }),\n options: [{ label: i18next.t('cmd.commonClose'), value: 'close', color: 'gray' }],\n }\n }\n\n if (!result.plan || result.plan.length === 0) {\n return {\n title: loadingTitle,\n subtitle: i18next.t('cmd.dryRunPreviewOk', { name: result.name ?? i18next.t('cmd.unknownLabel') }),\n options: [{ label: i18next.t('cmd.commonClose'), value: 'close', color: 'gray' }],\n }\n }\n\n const plan = result.plan.filter((l) => !l.startsWith(i18next.t('cmd.planSourcePrefix')))\n const name = result.name ?? i18next.t('cmd.unknownLabel')\n const isMultiSkill = result.results !== undefined\n\n // RFC-130: 多 skill 仓库 → 聚合面板\n if (isMultiSkill) {\n const count = result.results!.length\n const title = `${i18next.t('cmd.titleInstall')} — \"${count} skills (${source})\"`\n\n if (!proceed) {\n return {\n title,\n subtitle: plan.join('\\n'),\n options: [{ label: i18next.t('cmd.commonClose'), value: 'close', color: 'gray' }],\n }\n }\n\n return {\n title,\n subtitle: plan.join('\\n'),\n options: [\n { label: i18next.t('cmd.installActionLabel'), value: 'install', color: 'accent' },\n { label: i18next.t('cmd.commonCancel'), value: 'cancel', color: 'gray' },\n ],\n }\n }\n\n // --dry-run:纯预览,不提供安装入口(修正旧语义——旧 dry-run 的\"安装\"按钮会真装)。\n if (!proceed) {\n return {\n title: `${i18next.t('cmd.titleDryRun')} — \"${name}\"`,\n subtitle: plan.join('\\n'),\n options: [{ label: i18next.t('cmd.commonClose'), value: 'close', color: 'gray' }],\n }\n }\n\n return {\n title: `${i18next.t('cmd.titleInstall')} — \"${name}\"`,\n subtitle: plan.join('\\n'),\n options: [\n { label: i18next.t('cmd.installActionLabel'), value: 'install', color: 'accent' },\n { label: i18next.t('cmd.commonCancel'), value: 'cancel', color: 'gray' },\n ],\n }\n })(),\n onSelect: async (v: string) => {\n if (v === 'cancel' || v === 'close') return\n if (v === 'install') {\n await executeInstall(source, { ...options, dryRun: false }, ctx)\n }\n },\n })\n}\n\n// ── 执行安装 ──\n\n/**\n * RFC-224 D2/D3:安装进度 fraction 计算——字节级进度(bytesDownloaded/bytesTotal)\n * 优先于多 skill 计数(current/total),两者互斥语义(见 InstallProgress JSDoc)。\n * 导出供单测覆盖(`install-progress-bytes.test.ts`),不作为公开 API。\n */\nexport function computeProgressFraction(p: {\n bytesDownloaded?: number\n bytesTotal?: number\n current?: number\n total?: number\n}): number {\n if (p.bytesTotal !== undefined && p.bytesDownloaded !== undefined) {\n return p.bytesDownloaded / p.bytesTotal\n }\n if (p.current && p.total) {\n return p.current / p.total\n }\n return 0\n}\n\n/**\n * RFC-224 D2/R4:安装进度 detail 文案格式化——bytesDownloaded 存在时渲染字节数\n * (`formatBytes`),Content-Length 缺失(bytesTotal 为 undefined)时降级为纯字节\n * 计数,不编造总数;否则保持原始 message 不变。导出供单测覆盖。\n */\nexport function formatProgressDetail(p: {\n message: string\n bytesDownloaded?: number\n bytesTotal?: number\n}): string {\n if (p.bytesDownloaded === undefined) return p.message\n if (p.bytesTotal !== undefined) {\n return `${p.message} ${formatBytes(p.bytesDownloaded)} / ${formatBytes(p.bytesTotal)}`\n }\n return `${p.message} ${formatBytes(p.bytesDownloaded)}`\n}\n\n/** `Refreshing…` 在四阶段清单中的下标(RFC-286 D4:该阶段由 CLI 持有)。 */\nconst REFRESHING_PHASE_INDEX = 3\n\n/** partial 面板最多直接列出的失败项条数,超出部分转由 command_echo 承载(RFC-286 D6)。 */\nconst PARTIAL_DETAIL_MAX_ITEMS = 3\n\n/**\n * RFC-286 D6:把失败子项渲染成面板可读的一行摘要。\n *\n * 面板是窄栏终端 UI,超过 `PARTIAL_DETAIL_MAX_ITEMS` 条时只列前几条并指向消息流\n * ——完整清单由 `executeInstall` 的 command_echo 承载(R5:不依赖 toast 单槽通道)。\n */\n/** 拼接多条子错误前去掉句末句号,避免出现「。;」这类双标点(RFC-290 T290-11 收尾)。 */\nfunction stripTrailingPeriod(text: string): string {\n return text.replace(/[。.]\\s*$/, '')\n}\n\nfunction describeFailures(\n subs: Array<{ success: boolean; name?: string; error?: string }> | undefined,\n unknownErrorLabel: string,\n): string {\n const failed = (subs ?? []).filter((r) => !r.success)\n if (failed.length === 0) return unknownErrorLabel\n const shown = failed.slice(0, PARTIAL_DETAIL_MAX_ITEMS)\n const details = shown\n .map((r) => `${r.name ?? '?'} —— ${stripTrailingPeriod(r.error ?? unknownErrorLabel)}`)\n .join(';')\n return failed.length > shown.length ? `${details}${i18next.t('install.failureOverflow')}` : details\n}\n\n/**\n * RFC-290 D2:冲突类失败 → `--force` 建议。\n *\n * **只读结构化的 `failureKind`,绝不匹配 `error` 文案**——错误文案是本地化的人读文本,\n * 子串嗅探(如判断是否含\"已存在\")会在换 locale 或改措辞时静默失效。\n * 单结果读顶层字段,多结果要求**全部**失败项同为 conflict(混合原因不给建议,R4)。\n */\nfunction resolveConflictNextStep(\n result: { failureKind?: 'conflict' },\n subs: Array<{ success: boolean; failureKind?: 'conflict' }> | undefined,\n): { nextStep: { kind: 'force'; label: string } } | undefined {\n const failed = (subs ?? []).filter((r) => !r.success)\n const isConflict = subs\n ? failed.length > 0 && failed.every((r) => r.failureKind === 'conflict')\n : result.failureKind === 'conflict'\n if (!isConflict) return undefined\n return { nextStep: { kind: 'force', label: i18next.t('install.nextStepForce') } }\n}\n\n/**\n * RFC-286 D2/D3/D6:安装终态裁决——把 `InstallResult` + reload 结果映射为进度对话框终态。\n *\n * 映射表(RFC-286 D2 唯一定义处):\n * - 全部成功且 reload 成功 → `success`(2s 自动关闭)\n * - 部分成功(ok>0 && fail>0)→ `partial`(不自动关闭)\n * - 全部失败 → `error`(不自动关闭)\n * - 产物已装、仅 reload 失败 → `partial`(degraded success,提示 /reload)\n *\n * 三种非 success 终态都显式下发 `percent` 与 `phaseStatuses`(R4),失败阶段标 `'error'`\n * ——该取值此前在全仓无任何生产者,`ProgressDialog` 的行内错误渲染是死代码,本函数激活它。\n *\n * 导出供单测覆盖(`install-terminal-state.test.ts`),不作为公开 API。\n */\nexport function computeTerminalProgress(\n result: {\n success: boolean\n error?: string\n failureKind?: 'conflict'\n results?: Array<{ success: boolean; name?: string; error?: string; failureKind?: 'conflict' }>\n },\n reloadError: string | undefined,\n unknownErrorLabel: string,\n): {\n status: 'success' | 'partial' | 'error'\n percent: number\n phaseStatuses: Array<'pending' | 'active' | 'done' | 'error'>\n errorMessage?: string\n nextStep?: { kind: 'force' | 'reload'; label: string }\n} {\n const subs = result.results\n const okCount = subs ? subs.filter((r) => r.success).length : result.success ? 1 : 0\n const failCount = subs ? subs.length - okCount : result.success ? 0 : 1\n\n // 全部失败 → error。失败阶段停在 `installing`(写盘阶段),而非 refreshing——\n // 安装根本没成功,不该显示\"刷新\"阶段被走到过。\n //\n // R3:错误文案按「顶层 error → 子项 error 还原 → 兜底文案」逐级降级。兜底只在\n // 上游连子项原因都没给时才允许出现,绝不用它掩盖上游缺口(本次事故的根因模式)。\n if (okCount === 0) {\n return {\n status: 'error',\n percent: 100,\n phaseStatuses: ['done', 'done', 'error', 'pending'],\n errorMessage: result.error ?? describeFailures(subs, unknownErrorLabel),\n ...(resolveConflictNextStep(result, subs) ?? {}),\n }\n }\n\n // 有成功项但也有失败项 → partial\n if (failCount > 0) {\n return {\n status: 'partial',\n percent: 100,\n phaseStatuses: ['done', 'done', 'error', 'done'],\n errorMessage:\n i18next.t('install.partialCounts', { ok: okCount, fail: failCount }) +\n describeFailures(subs, unknownErrorLabel),\n ...(resolveConflictNextStep(result, subs) ?? {}),\n }\n }\n\n // 全部装好但能力刷新失败 → degraded success(产物已落盘,不能报 error)\n if (reloadError) {\n return {\n status: 'partial',\n percent: 100,\n phaseStatuses: ['done', 'done', 'done', 'error'],\n errorMessage: i18next.t('cmd.installedRefreshErr', { err: reloadError }),\n nextStep: { kind: 'reload', label: i18next.t('install.nextStepReload') },\n }\n }\n\n return { status: 'success', percent: 100, phaseStatuses: ['done', 'done', 'done', 'done'] }\n}\n\nfunction applyTerminalProgress(\n ctx: CliContext,\n result: InstallResult,\n reloadError: string | undefined,\n): void {\n ctx.tui.modal.updateProgress(computeTerminalProgress(result, reloadError, i18next.t('cmd.unknownError')))\n}\n\nasync function executeInstall(\n source: string,\n options: InstallOptions,\n ctx: CliContext,\n): Promise<void> {\n const manager = new InstallManager()\n const label = i18next.t('cmd.titleInstall')\n\n // 打开进度条 dialog(聚焦阻断输入)\n // RFC-290 D5:阶段名与标题走 i18n——此前是硬编码英文字面量,中文环境下面板会突兀\n // 蹦出英文,与其余 20+ 弹窗不一致。\n const phases = [\n i18next.t('install.phaseResolving'),\n i18next.t('install.phaseDetecting'),\n i18next.t('install.phaseInstalling'),\n i18next.t('install.phaseRefreshing'),\n ]\n ctx.tui.modal.openModal({ kind: 'progress', title: i18next.t('install.title', { source }), phases })\n\n // 安装进度 → dialog 更新\n const phaseMap: Record<string, number> = { resolving: 0, detecting: 1, installing: 2, refreshing: 3 }\n const progressOptions: InstallOptions = {\n ...options,\n onProgress: (p) => {\n const idx = phaseMap[p.phase] ?? -1\n if (idx >= 0) {\n const statuses = phases.map((_, i) => {\n if (i < idx) return 'done' as const\n if (i === idx) return 'active' as const\n return 'pending' as const\n })\n const fraction = computeProgressFraction(p)\n const detail = formatProgressDetail(p)\n ctx.tui.modal.updateProgress({\n phaseIndex: idx,\n phaseStatuses: statuses,\n percent: Math.round(((idx + fraction) / phases.length) * 90),\n detail,\n subProgress: p.current !== undefined && p.total !== undefined ? { current: p.current, total: p.total } : undefined,\n })\n }\n },\n }\n\n const result = await manager.install(\n source,\n progressOptions,\n () => ctx.app.settings.get('mcp_servers') as Record<string, unknown> | undefined,\n async (servers) => {\n await ctx.app.settings.persist({ mcp_servers: servers as McpServersConfig })\n },\n )\n\n // ── 安装写盘结束 → 真实能力刷新(RFC-286 D4/D5) ──\n //\n // `refreshing` 阶段由本处 fire——`InstallManager` 不再自行 fire(它没有 App 句柄,\n // 其 refreshing 与真实 reload 无关,属伪进度)。谁执行谁上报:面板上的\n // \"Refreshing…\" 从此对应下方 `reloadCapabilities()` 的真实耗时。\n //\n // 时序变更:终态裁决移到 reload **之后**(此前在 reload 前就置 success 并开始\n // 2s 自动关闭倒计时)。这样 reload 失败才能降级为 partial 呈现给用户。\n const installOk = result.success || (result.results?.some((r) => r.success) ?? false)\n let reloadError: string | undefined\n if (installOk) {\n ctx.tui.modal.updateProgress({\n phaseIndex: REFRESHING_PHASE_INDEX,\n phaseStatuses: ['done', 'done', 'done', 'active'],\n percent: 90,\n detail: i18next.t('install.reloadingDetail'),\n })\n try {\n await ctx.app.reloadCapabilities()\n ctx.tui.plugins.setPluginRegistrations(ctx.app.getPluginRegistrations())\n } catch (err) {\n reloadError = err instanceof Error ? err.message : String(err)\n }\n }\n\n // 安装结束 → dialog 终态(RFC-286 D2/D3/R4:终态必须同时下发 percent 与\n // phaseStatuses,不得让面板继承中途快照——此前只传 status/errorMessage,\n // 导致失败面板冻结在 68% 且阶段行仍是 active,看起来像还在刷新)。\n applyTerminalProgress(ctx, result, reloadError)\n\n if (!result.success) {\n // 多 skill 部分失败时继续(D5:独立安装不回滚)\n // 全部失败时展示第一个错误\n if (!result.results || result.results.every((r) => !r.success)) {\n ctx.tui.info.showToast(label, i18next.t('cmd.installFailed', { err: result.error ?? i18next.t('cmd.unknownError') }))\n if (!result.results) return\n // 多 skill 全部失败但仍然有 results→继续执行 toast 汇总\n }\n }\n\n const scopeLabel = options.global ? i18next.t('cmd.scopeGlobal') : i18next.t('cmd.scopeProject')\n\n // RFC-130: 多 skill → 逐条 toast + 汇总\n if (result.results) {\n let ok = 0\n let fail = 0\n for (const r of result.results) {\n if (r.success) {\n ok++\n ctx.tui.info.showToast(\n label,\n i18next.t('cmd.installedTo', { name: r.name ?? 'extension', scope: scopeLabel, seg: r.targetPath ? ` (${r.targetPath})` : '' }),\n )\n } else {\n fail++\n ctx.tui.info.showToast(label, i18next.t('cmd.installFailed', { err: r.error ?? i18next.t('cmd.unknownError') }))\n }\n }\n const summary = `${ok} installed${fail > 0 ? `, ${fail} failed` : ''}`\n ctx.tui.info.showToast(label, summary)\n\n // RFC-286 D6/R5:失败清单必须落到消息流。上面的逐条 toast 是单槽通道\n // (`main.ts` 的 showToast 每次都覆盖上一条),多个失败项之间会互相顶掉,\n // 面板终态又只列前 3 条——没有这条 command_echo,超出部分将彻底不可见。\n if (fail > 0) {\n const failedLines = result.results\n .filter((r) => !r.success)\n .map((r) => `✗ ${r.name ?? '?'} —— ${r.error ?? i18next.t('cmd.unknownError')}`)\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'error',\n summary,\n detail: failedLines.join('\\n'),\n })\n }\n\n // 聚合 warnings\n if (result.warnings && result.warnings.length > 0) {\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'warn',\n summary: `${result.warnings.length} 项警告`,\n detail: result.warnings.map((w) => `⚠ ${w}`).join('\\n'),\n })\n }\n\n // 能力刷新已在终态裁决前统一执行(RFC-286 D4,见上方 `refreshing` 阶段),\n // 失败已降级为 partial 面板终态;此处只补一条 command_echo 供回溯(R5:\n // 关键失败信息不依赖 toast 单槽通道)。\n reportReloadOutcome(ctx, reloadError)\n return\n }\n\n // RFC-080:postinstall 钩子结果反馈\n if (result.postinstall) {\n if (result.postinstall.success) {\n ctx.tui.info.showToast(label, `\"${result.name}\" installed (${scopeLabel}). postinstall: ok`)\n } else {\n const reason = result.postinstall.timeout\n ? 'timed out (30s)'\n : result.postinstall.error ?? `exit=${result.postinstall.exitCode ?? 'N/A'}`\n ctx.tui.info.showToast(label, `\"${result.name}\" installed (${scopeLabel}). postinstall: FAILED (${reason})`)\n\n const lines = [`Plugin \"${result.name}\" postinstall hook failed:`]\n lines.push(` command: ${result.postinstall.command}`)\n if (result.postinstall.exitCode != null) lines.push(` exit code: ${result.postinstall.exitCode}`)\n if (result.postinstall.stderr) lines.push(` stderr: ${result.postinstall.stderr}`)\n if (result.postinstall.truncated) lines.push(' (output truncated)')\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'error',\n summary: `\"${result.name}\" postinstall hook failed`,\n detail: lines.join('\\n'),\n })\n }\n } else {\n ctx.tui.info.showToast(\n label,\n i18next.t('cmd.installedTo', { name: result.name ?? 'extension', scope: scopeLabel, seg: result.targetPath ? ` (${result.targetPath})` : '' }),\n )\n }\n\n // warnings(RFC-080:信任持久化失败等非致命警告)\n if (result.warnings && result.warnings.length > 0) {\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'warn',\n summary: `${result.warnings.length} 项警告`,\n detail: result.warnings.map((w) => `⚠ ${w}`).join('\\n'),\n })\n }\n\n // 能力刷新已在终态裁决前统一执行(RFC-286 D4)。\n reportReloadOutcome(ctx, reloadError)\n}\n\n/**\n * RFC-286 D4/R5:能力刷新结果的消息通道反馈。\n *\n * 刷新本身已在终态裁决前执行完毕(面板 `Refreshing…` 阶段对应其真实耗时),失败时面板\n * 已降级为 `partial`。此处只负责消息流留痕:成功走 toast(非关键信息,可被覆盖);\n * 失败走 command_echo(关键信息,不依赖 toast 单槽通道)。\n */\nfunction reportReloadOutcome(ctx: CliContext, reloadError: string | undefined): void {\n if (reloadError) {\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'error',\n summary: i18next.t('cmd.installedRefreshErr', { err: reloadError }),\n })\n return\n }\n ctx.tui.info.showToast(i18next.t('cmd.titleInstall'), i18next.t('cmd.capRefreshedInstall'))\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"install-DlVJRHRT.js","names":[],"sources":["../src/commands/handlers/install.ts"],"sourcesContent":["/**\n * handlers/install.ts — /install 命令处理\n *\n * /install [--global] [--force] [--dry-run] [--as <type>] [--type <src>] <source>\n *\n * 安装 skill/plugin/mcp 包到项目 (.otto/) 或全局 (~/.otto/)。\n * 支持 file/url/git/npm 四种来源,自动检测内容类型。\n */\nimport { i18next } from '@x-otto/tui'\nimport { InstallManager, defaultPostInstallExecutor } from '@x-otto/coding'\nimport { formatBytes } from '@x-otto/shared'\nimport type { InstallOptions, InstallProgress, InstallResult } from '@x-otto/coding'\nimport type { McpServersConfig } from '@x-otto/setting'\nimport type { SelectOption } from '@x-otto/tui'\nimport type { CliContext } from '../../command-dispatcher'\n\nconst VALID_AS = new Set(['plugin', 'skill', 'mcp'])\n\nexport async function handleInstall(\n args: string[],\n ctx: CliContext,\n): Promise<void> {\n const parsed = parseArgs(args)\n if (!parsed.source) {\n ctx.tui.info.showToast(i18next.t('cmd.titleInstall'), i18next.t('cmd.installUsage'))\n return\n }\n\n const isGlobal = parsed.flags.has('--global')\n const isHere = parsed.flags.has('--here')\n\n if (isGlobal && isHere) {\n ctx.tui.info.showToast(i18next.t('cmd.titleInstall'), i18next.t('cmd.installMutuallyExclusive'))\n return\n }\n\n const options: InstallOptions = {\n // --here:锚到当前命令目录,绕过 ctx.app.workspaceDir 的向上工作区根查找。\n workspaceDir: isHere ? process.cwd() : ctx.app.workspaceDir,\n global: isGlobal,\n force: parsed.flags.has('--force'),\n dryRun: parsed.flags.has('--dry-run'),\n as: parsed.as,\n type: parsed.type,\n env: parsed.env,\n subPath: parsed.subPath,\n ref: parsed.ref,\n postInstallExecutor: defaultPostInstallExecutor,\n // RFC-131: 进度回调 — 仅非 dry-run 时注入\n onProgress: !parsed.dryRun ? (p) => {\n const prefix = p.total && p.current ? `[${p.current}/${p.total}] ` : ''\n ctx.tui.info.showToast('Installing', `${prefix}${p.message}`)\n } : undefined,\n }\n\n // 确认优先(P3 安全边界):始终先 dry-run 取 plan 展示——含将运行的 postinstall/setup\n // shell 命令——确认后才真装(项目级插件真装含 auto-trust + 立即跑 postinstall)。\n // --dry-run 仅预览,不提供安装按钮。\n await showConfirmPanel(parsed.source, options, ctx, !parsed.dryRun)\n}\n\n// ── 参数解析 ──\n\ninterface ParsedArgs {\n source: string | undefined\n flags: Set<string>\n as: 'plugin' | 'skill' | 'mcp' | undefined\n type: 'file' | 'url' | 'git' | 'npm' | undefined\n env: Record<string, string> | undefined\n /** RFC-201:monorepo 子目录(--sub-path,registry 条目 subPath 的 CLI 透传面)。 */\n subPath: string | undefined\n /**\n * RFC-221 D2/T221-3:git 来源的 tag/branch 名(`--ref`),透传到\n * `InstallOptions.ref` → `resolveGitSource(gitUrl, ref)`。仅对 git 来源有效,\n * 其余来源类型忽略此参数(不报错,与 subPath 对非 git/归档来源的静默忽略语义一致)。\n * 不支持 commit hash——见 `git-resolver.ts` 头部注释(主流托管方服务端默认拒绝)。\n */\n ref: string | undefined\n dryRun: boolean\n}\n\n/** 导出供单测覆盖 `--ref`/`--sub-path` 等标志解析行为(RFC-221 T221-3),非公开 API。 */\nexport function parseArgs(args: string[]): ParsedArgs {\n const flags = new Set<string>()\n let as: 'plugin' | 'skill' | 'mcp' | undefined\n let type: 'file' | 'url' | 'git' | 'npm' | undefined\n let env: Record<string, string> | undefined\n let subPath: string | undefined\n let ref: string | undefined\n let dryRun = false\n let i = 0\n\n while (i < args.length) {\n const a = args[i]!\n if (a === '--as') {\n i++\n const val = args[i]?.toLowerCase()\n if (VALID_AS.has(val ?? '')) as = val as typeof as\n } else if (a === '--type') {\n i++\n const val = args[i]?.toLowerCase()\n if (val === 'file' || val === 'url' || val === 'git' || val === 'npm') {\n type = val\n }\n } else if (a === '--sub-path') {\n // RFC-201 M0/M1:monorepo 子目录安装(registry 条目 subPath 的 CLI 透传面)\n i++\n subPath = args[i]\n } else if (a === '--ref') {\n // RFC-221 D2/T221-3:git 来源 tag/branch 指定安装\n i++\n ref = args[i]\n } else if (a === '--env') {\n i++\n const kv = args[i]\n if (kv) {\n const eq = kv.indexOf('=')\n if (eq > 0) {\n env = env ?? {}\n env[kv.slice(0, eq)] = kv.slice(eq + 1)\n }\n }\n } else if (a.startsWith('--')) {\n flags.add(a)\n } else {\n // positional (source)\n dryRun = flags.has('--dry-run')\n const rest = args.slice(i).filter((x) => !x.startsWith('--'))\n return { source: rest[0], flags, as, type, env, subPath, ref, dryRun }\n }\n i++\n }\n\n dryRun = flags.has('--dry-run')\n return { source: undefined, flags, as, type, env, subPath, ref, dryRun }\n}\n\n// ── 确认面板 ──\n\n/**\n * 先 dry-run 取安装 plan 并展示确认屏。\n *\n * RFC-226:命令发出到确认框出现之间新增 loading 反馈——dry-run 探测(git clone/npm pack/\n * url 下载 + 内容检测)本身耗时不短,此前全程静默。改造后:① 立即展示 loading 态弹窗\n * (options=[] 空选项态,D2);② dry-run 探测阶段(resolving/detecting)的进度通过局部\n * `onProgress`(不复用 `options.onProgress` toast 版本,D5b/R6)实时刷新 loading 文案;\n * ③ dry-run 完成后原地过渡为确认框或错误态(D3/D5a)。\n *\n * **修复**(dialog 栈堆积):此前每次状态转换(loading→进度更新→确认/错误/预览)都调用\n * `ctx.tui.modal.openModal({ kind: 'select' })`,而同步 select 路径每次 `router.navigate` 都是\n * push 新栈条目,导致对话框层层堆积、用户要按多次 Esc 才能退出。现改用框架层 `async` 字段:\n * loading 态由框架自动展示,dry-run 在 async promise 内完成,resolve 后框架用 `replace: true`\n * 原地过渡为真实内容。最终的确认/错误/预览弹窗由 `onSelect` 回调内驱动(此时 loading 弹窗\n * 已被框架 replace 为最终态,Esc 一次即可退出)。\n *\n * @param proceed true=确认后真装([安装, 取消]);false=纯预览(--dry-run,仅[关闭])。\n */\nasync function showConfirmPanel(\n source: string,\n options: InstallOptions,\n ctx: CliContext,\n proceed: boolean,\n): Promise<void> {\n const manager = new InstallManager()\n const loadingTitle = `${i18next.t('cmd.titleInstall')} — \"${source}\"`\n\n // dry-run 专用局部 onProgress——不复用 options.onProgress(toast 版本,只服务\n // executeInstall 真实安装路径)。探测阶段进度文案由 async promise 内部记录,\n // resolve 时作为 subtitle 回灌(框架 replace 一次性更新)。\n let progressMessage = i18next.t('cmd.installLoadingHint')\n const dryOptions: InstallOptions = {\n ...options,\n dryRun: true,\n onProgress: (p: InstallProgress) => {\n progressMessage = p.message\n },\n }\n\n ctx.tui.modal.openModal({\n kind: 'select',\n title: loadingTitle,\n subtitle: `${i18next.t('cmd.titleDryRun')}...\\n${progressMessage}`,\n layout: 'buttons',\n options: [],\n onCancel: () => {\n ctx.tui.info.showToast(i18next.t('cmd.titleInstall'), i18next.t('cmd.selectCancelled'))\n },\n // async:dry-run 探测在 promise 内完成,resolve 后框架用 replace:true 原地过渡。\n async: (async (): Promise<{ title?: string; subtitle?: string; options: SelectOption[] }> => {\n const result = await manager.install(\n source,\n dryOptions,\n () => ctx.app.settings.get('mcp_servers') as Record<string, unknown> | undefined,\n async (servers) => {\n await ctx.app.settings.persist({ mcp_servers: servers as McpServersConfig })\n },\n )\n\n if (!result.success) {\n return {\n title: loadingTitle,\n subtitle: i18next.t('cmd.dryRunDetectFailed', { err: result.error ?? i18next.t('cmd.unknownError') }),\n options: [{ label: i18next.t('cmd.commonClose'), value: 'close', color: 'gray' }],\n }\n }\n\n if (!result.plan || result.plan.length === 0) {\n return {\n title: loadingTitle,\n subtitle: i18next.t('cmd.dryRunPreviewOk', { name: result.name ?? i18next.t('cmd.unknownLabel') }),\n options: [{ label: i18next.t('cmd.commonClose'), value: 'close', color: 'gray' }],\n }\n }\n\n const plan = result.plan.filter((l) => !l.startsWith(i18next.t('cmd.planSourcePrefix')))\n const name = result.name ?? i18next.t('cmd.unknownLabel')\n const isMultiSkill = result.results !== undefined\n\n // RFC-130: 多 skill 仓库 → 聚合面板\n if (isMultiSkill) {\n const count = result.results!.length\n const title = `${i18next.t('cmd.titleInstall')} — \"${count} skills (${source})\"`\n\n if (!proceed) {\n return {\n title,\n subtitle: plan.join('\\n'),\n options: [{ label: i18next.t('cmd.commonClose'), value: 'close', color: 'gray' }],\n }\n }\n\n return {\n title,\n subtitle: plan.join('\\n'),\n options: [\n { label: i18next.t('cmd.installActionLabel'), value: 'install', color: 'accent' },\n { label: i18next.t('cmd.commonCancel'), value: 'cancel', color: 'gray' },\n ],\n }\n }\n\n // --dry-run:纯预览,不提供安装入口(修正旧语义——旧 dry-run 的\"安装\"按钮会真装)。\n if (!proceed) {\n return {\n title: `${i18next.t('cmd.titleDryRun')} — \"${name}\"`,\n subtitle: plan.join('\\n'),\n options: [{ label: i18next.t('cmd.commonClose'), value: 'close', color: 'gray' }],\n }\n }\n\n return {\n title: `${i18next.t('cmd.titleInstall')} — \"${name}\"`,\n subtitle: plan.join('\\n'),\n options: [\n { label: i18next.t('cmd.installActionLabel'), value: 'install', color: 'accent' },\n { label: i18next.t('cmd.commonCancel'), value: 'cancel', color: 'gray' },\n ],\n }\n })(),\n onSelect: async (v: string) => {\n if (v === 'cancel' || v === 'close') return\n if (v === 'install') {\n await executeInstall(source, { ...options, dryRun: false }, ctx)\n }\n },\n })\n}\n\n// ── 执行安装 ──\n\n/**\n * RFC-224 D2/D3:安装进度 fraction 计算——字节级进度(bytesDownloaded/bytesTotal)\n * 优先于多 skill 计数(current/total),两者互斥语义(见 InstallProgress JSDoc)。\n * 导出供单测覆盖(`install-progress-bytes.test.ts`),不作为公开 API。\n */\nexport function computeProgressFraction(p: {\n bytesDownloaded?: number\n bytesTotal?: number\n current?: number\n total?: number\n}): number {\n if (p.bytesTotal !== undefined && p.bytesDownloaded !== undefined) {\n return p.bytesDownloaded / p.bytesTotal\n }\n if (p.current && p.total) {\n return p.current / p.total\n }\n return 0\n}\n\n/**\n * RFC-224 D2/R4:安装进度 detail 文案格式化——bytesDownloaded 存在时渲染字节数\n * (`formatBytes`),Content-Length 缺失(bytesTotal 为 undefined)时降级为纯字节\n * 计数,不编造总数;否则保持原始 message 不变。导出供单测覆盖。\n */\nexport function formatProgressDetail(p: {\n message: string\n bytesDownloaded?: number\n bytesTotal?: number\n}): string {\n if (p.bytesDownloaded === undefined) return p.message\n if (p.bytesTotal !== undefined) {\n return `${p.message} ${formatBytes(p.bytesDownloaded)} / ${formatBytes(p.bytesTotal)}`\n }\n return `${p.message} ${formatBytes(p.bytesDownloaded)}`\n}\n\n/** `Refreshing…` 在四阶段清单中的下标(RFC-286 D4:该阶段由 CLI 持有)。 */\nconst REFRESHING_PHASE_INDEX = 3\n\n/** partial 面板最多直接列出的失败项条数,超出部分转由 command_echo 承载(RFC-286 D6)。 */\nconst PARTIAL_DETAIL_MAX_ITEMS = 3\n\n/**\n * RFC-286 D6:把失败子项渲染成面板可读的一行摘要。\n *\n * 面板是窄栏终端 UI,超过 `PARTIAL_DETAIL_MAX_ITEMS` 条时只列前几条并指向消息流\n * ——完整清单由 `executeInstall` 的 command_echo 承载(R5:不依赖 toast 单槽通道)。\n */\n/** 拼接多条子错误前去掉句末句号,避免出现「。;」这类双标点(RFC-290 T290-11 收尾)。 */\nfunction stripTrailingPeriod(text: string): string {\n return text.replace(/[。.]\\s*$/, '')\n}\n\nfunction describeFailures(\n subs: Array<{ success: boolean; name?: string; error?: string }> | undefined,\n unknownErrorLabel: string,\n): string {\n const failed = (subs ?? []).filter((r) => !r.success)\n if (failed.length === 0) return unknownErrorLabel\n const shown = failed.slice(0, PARTIAL_DETAIL_MAX_ITEMS)\n const details = shown\n .map((r) => `${r.name ?? '?'} —— ${stripTrailingPeriod(r.error ?? unknownErrorLabel)}`)\n .join(';')\n return failed.length > shown.length ? `${details}${i18next.t('install.failureOverflow')}` : details\n}\n\n/**\n * RFC-290 D2:冲突类失败 → `--force` 建议。\n *\n * **只读结构化的 `failureKind`,绝不匹配 `error` 文案**——错误文案是本地化的人读文本,\n * 子串嗅探(如判断是否含\"已存在\")会在换 locale 或改措辞时静默失效。\n * 单结果读顶层字段,多结果要求**全部**失败项同为 conflict(混合原因不给建议,R4)。\n */\nfunction resolveConflictNextStep(\n result: { failureKind?: 'conflict' },\n subs: Array<{ success: boolean; failureKind?: 'conflict' }> | undefined,\n): { nextStep: { kind: 'force'; label: string } } | undefined {\n const failed = (subs ?? []).filter((r) => !r.success)\n const isConflict = subs\n ? failed.length > 0 && failed.every((r) => r.failureKind === 'conflict')\n : result.failureKind === 'conflict'\n if (!isConflict) return undefined\n return { nextStep: { kind: 'force', label: i18next.t('install.nextStepForce') } }\n}\n\n/**\n * RFC-286 D2/D3/D6:安装终态裁决——把 `InstallResult` + reload 结果映射为进度对话框终态。\n *\n * 映射表(RFC-286 D2 唯一定义处):\n * - 全部成功且 reload 成功 → `success`(2s 自动关闭)\n * - 部分成功(ok>0 && fail>0)→ `partial`(不自动关闭)\n * - 全部失败 → `error`(不自动关闭)\n * - 产物已装、仅 reload 失败 → `partial`(degraded success,提示 /extension reload)\n *\n * 三种非 success 终态都显式下发 `percent` 与 `phaseStatuses`(R4),失败阶段标 `'error'`\n * ——该取值此前在全仓无任何生产者,`ProgressDialog` 的行内错误渲染是死代码,本函数激活它。\n *\n * 导出供单测覆盖(`install-terminal-state.test.ts`),不作为公开 API。\n */\nexport function computeTerminalProgress(\n result: {\n success: boolean\n error?: string\n failureKind?: 'conflict'\n results?: Array<{ success: boolean; name?: string; error?: string; failureKind?: 'conflict' }>\n },\n reloadError: string | undefined,\n unknownErrorLabel: string,\n): {\n status: 'success' | 'partial' | 'error'\n percent: number\n phaseStatuses: Array<'pending' | 'active' | 'done' | 'error'>\n errorMessage?: string\n nextStep?: { kind: 'force' | 'reload'; label: string }\n} {\n const subs = result.results\n const okCount = subs ? subs.filter((r) => r.success).length : result.success ? 1 : 0\n const failCount = subs ? subs.length - okCount : result.success ? 0 : 1\n\n // 全部失败 → error。失败阶段停在 `installing`(写盘阶段),而非 refreshing——\n // 安装根本没成功,不该显示\"刷新\"阶段被走到过。\n //\n // R3:错误文案按「顶层 error → 子项 error 还原 → 兜底文案」逐级降级。兜底只在\n // 上游连子项原因都没给时才允许出现,绝不用它掩盖上游缺口(本次事故的根因模式)。\n if (okCount === 0) {\n return {\n status: 'error',\n percent: 100,\n phaseStatuses: ['done', 'done', 'error', 'pending'],\n errorMessage: result.error ?? describeFailures(subs, unknownErrorLabel),\n ...(resolveConflictNextStep(result, subs) ?? {}),\n }\n }\n\n // 有成功项但也有失败项 → partial\n if (failCount > 0) {\n return {\n status: 'partial',\n percent: 100,\n phaseStatuses: ['done', 'done', 'error', 'done'],\n errorMessage:\n i18next.t('install.partialCounts', { ok: okCount, fail: failCount }) +\n describeFailures(subs, unknownErrorLabel),\n ...(resolveConflictNextStep(result, subs) ?? {}),\n }\n }\n\n // 全部装好但能力刷新失败 → degraded success(产物已落盘,不能报 error)\n if (reloadError) {\n return {\n status: 'partial',\n percent: 100,\n phaseStatuses: ['done', 'done', 'done', 'error'],\n errorMessage: i18next.t('cmd.installedRefreshErr', { err: reloadError }),\n nextStep: { kind: 'reload', label: i18next.t('install.nextStepReload') },\n }\n }\n\n return { status: 'success', percent: 100, phaseStatuses: ['done', 'done', 'done', 'done'] }\n}\n\nfunction applyTerminalProgress(\n ctx: CliContext,\n result: InstallResult,\n reloadError: string | undefined,\n): void {\n ctx.tui.modal.updateProgress(computeTerminalProgress(result, reloadError, i18next.t('cmd.unknownError')))\n}\n\nasync function executeInstall(\n source: string,\n options: InstallOptions,\n ctx: CliContext,\n): Promise<void> {\n const manager = new InstallManager()\n const label = i18next.t('cmd.titleInstall')\n\n // 打开进度条 dialog(聚焦阻断输入)\n // RFC-290 D5:阶段名与标题走 i18n——此前是硬编码英文字面量,中文环境下面板会突兀\n // 蹦出英文,与其余 20+ 弹窗不一致。\n const phases = [\n i18next.t('install.phaseResolving'),\n i18next.t('install.phaseDetecting'),\n i18next.t('install.phaseInstalling'),\n i18next.t('install.phaseRefreshing'),\n ]\n ctx.tui.modal.openModal({ kind: 'progress', title: i18next.t('install.title', { source }), phases })\n\n // 安装进度 → dialog 更新\n const phaseMap: Record<string, number> = { resolving: 0, detecting: 1, installing: 2, refreshing: 3 }\n const progressOptions: InstallOptions = {\n ...options,\n onProgress: (p) => {\n const idx = phaseMap[p.phase] ?? -1\n if (idx >= 0) {\n const statuses = phases.map((_, i) => {\n if (i < idx) return 'done' as const\n if (i === idx) return 'active' as const\n return 'pending' as const\n })\n const fraction = computeProgressFraction(p)\n const detail = formatProgressDetail(p)\n ctx.tui.modal.updateProgress({\n phaseIndex: idx,\n phaseStatuses: statuses,\n percent: Math.round(((idx + fraction) / phases.length) * 90),\n detail,\n subProgress: p.current !== undefined && p.total !== undefined ? { current: p.current, total: p.total } : undefined,\n })\n }\n },\n }\n\n const result = await manager.install(\n source,\n progressOptions,\n () => ctx.app.settings.get('mcp_servers') as Record<string, unknown> | undefined,\n async (servers) => {\n await ctx.app.settings.persist({ mcp_servers: servers as McpServersConfig })\n },\n )\n\n // ── 安装写盘结束 → 真实能力刷新(RFC-286 D4/D5) ──\n //\n // `refreshing` 阶段由本处 fire——`InstallManager` 不再自行 fire(它没有 App 句柄,\n // 其 refreshing 与真实 reload 无关,属伪进度)。谁执行谁上报:面板上的\n // \"Refreshing…\" 从此对应下方 `reloadCapabilities()` 的真实耗时。\n //\n // 时序变更:终态裁决移到 reload **之后**(此前在 reload 前就置 success 并开始\n // 2s 自动关闭倒计时)。这样 reload 失败才能降级为 partial 呈现给用户。\n const installOk = result.success || (result.results?.some((r) => r.success) ?? false)\n let reloadError: string | undefined\n if (installOk) {\n ctx.tui.modal.updateProgress({\n phaseIndex: REFRESHING_PHASE_INDEX,\n phaseStatuses: ['done', 'done', 'done', 'active'],\n percent: 90,\n detail: i18next.t('install.reloadingDetail'),\n })\n try {\n await ctx.app.reloadCapabilities()\n ctx.tui.plugins.setPluginRegistrations(ctx.app.getPluginRegistrations())\n } catch (err) {\n reloadError = err instanceof Error ? err.message : String(err)\n }\n }\n\n // 安装结束 → dialog 终态(RFC-286 D2/D3/R4:终态必须同时下发 percent 与\n // phaseStatuses,不得让面板继承中途快照——此前只传 status/errorMessage,\n // 导致失败面板冻结在 68% 且阶段行仍是 active,看起来像还在刷新)。\n applyTerminalProgress(ctx, result, reloadError)\n\n if (!result.success) {\n // 多 skill 部分失败时继续(D5:独立安装不回滚)\n // 全部失败时展示第一个错误\n if (!result.results || result.results.every((r) => !r.success)) {\n ctx.tui.info.showToast(label, i18next.t('cmd.installFailed', { err: result.error ?? i18next.t('cmd.unknownError') }))\n if (!result.results) return\n // 多 skill 全部失败但仍然有 results→继续执行 toast 汇总\n }\n }\n\n const scopeLabel = options.global ? i18next.t('cmd.scopeGlobal') : i18next.t('cmd.scopeProject')\n\n // RFC-130: 多 skill → 逐条 toast + 汇总\n if (result.results) {\n let ok = 0\n let fail = 0\n for (const r of result.results) {\n if (r.success) {\n ok++\n ctx.tui.info.showToast(\n label,\n i18next.t('cmd.installedTo', { name: r.name ?? 'extension', scope: scopeLabel, seg: r.targetPath ? ` (${r.targetPath})` : '' }),\n )\n } else {\n fail++\n ctx.tui.info.showToast(label, i18next.t('cmd.installFailed', { err: r.error ?? i18next.t('cmd.unknownError') }))\n }\n }\n const summary = `${ok} installed${fail > 0 ? `, ${fail} failed` : ''}`\n ctx.tui.info.showToast(label, summary)\n\n // RFC-286 D6/R5:失败清单必须落到消息流。上面的逐条 toast 是单槽通道\n // (`main.ts` 的 showToast 每次都覆盖上一条),多个失败项之间会互相顶掉,\n // 面板终态又只列前 3 条——没有这条 command_echo,超出部分将彻底不可见。\n if (fail > 0) {\n const failedLines = result.results\n .filter((r) => !r.success)\n .map((r) => `✗ ${r.name ?? '?'} —— ${r.error ?? i18next.t('cmd.unknownError')}`)\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'error',\n summary,\n detail: failedLines.join('\\n'),\n })\n }\n\n // 聚合 warnings\n if (result.warnings && result.warnings.length > 0) {\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'warn',\n summary: `${result.warnings.length} 项警告`,\n detail: result.warnings.map((w) => `⚠ ${w}`).join('\\n'),\n })\n }\n\n // 能力刷新已在终态裁决前统一执行(RFC-286 D4,见上方 `refreshing` 阶段),\n // 失败已降级为 partial 面板终态;此处只补一条 command_echo 供回溯(R5:\n // 关键失败信息不依赖 toast 单槽通道)。\n reportReloadOutcome(ctx, reloadError)\n return\n }\n\n // RFC-080:postinstall 钩子结果反馈\n if (result.postinstall) {\n if (result.postinstall.success) {\n ctx.tui.info.showToast(label, `\"${result.name}\" installed (${scopeLabel}). postinstall: ok`)\n } else {\n const reason = result.postinstall.timeout\n ? 'timed out (30s)'\n : result.postinstall.error ?? `exit=${result.postinstall.exitCode ?? 'N/A'}`\n ctx.tui.info.showToast(label, `\"${result.name}\" installed (${scopeLabel}). postinstall: FAILED (${reason})`)\n\n const lines = [`Plugin \"${result.name}\" postinstall hook failed:`]\n lines.push(` command: ${result.postinstall.command}`)\n if (result.postinstall.exitCode != null) lines.push(` exit code: ${result.postinstall.exitCode}`)\n if (result.postinstall.stderr) lines.push(` stderr: ${result.postinstall.stderr}`)\n if (result.postinstall.truncated) lines.push(' (output truncated)')\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'error',\n summary: `\"${result.name}\" postinstall hook failed`,\n detail: lines.join('\\n'),\n })\n }\n } else {\n ctx.tui.info.showToast(\n label,\n i18next.t('cmd.installedTo', { name: result.name ?? 'extension', scope: scopeLabel, seg: result.targetPath ? ` (${result.targetPath})` : '' }),\n )\n }\n\n // warnings(RFC-080:信任持久化失败等非致命警告)\n if (result.warnings && result.warnings.length > 0) {\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'warn',\n summary: `${result.warnings.length} 项警告`,\n detail: result.warnings.map((w) => `⚠ ${w}`).join('\\n'),\n })\n }\n\n // 能力刷新已在终态裁决前统一执行(RFC-286 D4)。\n reportReloadOutcome(ctx, reloadError)\n}\n\n/**\n * RFC-286 D4/R5:能力刷新结果的消息通道反馈。\n *\n * 刷新本身已在终态裁决前执行完毕(面板 `Refreshing…` 阶段对应其真实耗时),失败时面板\n * 已降级为 `partial`。此处只负责消息流留痕:成功走 toast(非关键信息,可被覆盖);\n * 失败走 command_echo(关键信息,不依赖 toast 单槽通道)。\n */\nfunction reportReloadOutcome(ctx: CliContext, reloadError: string | undefined): void {\n if (reloadError) {\n ctx.tui.messages.pushMessage({\n role: 'command_echo',\n command: '/install',\n status: 'error',\n summary: i18next.t('cmd.installedRefreshErr', { err: reloadError }),\n })\n return\n }\n ctx.tui.info.showToast(i18next.t('cmd.titleInstall'), i18next.t('cmd.capRefreshedInstall'))\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
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 — 调试面板(断点管理 / 状态查看)
|
|
3
|
+
|
|
4
|
+
用法:
|
|
5
|
+
otto debug breakpoints list 列出所有断点及启用状态
|
|
6
|
+
otto debug breakpoints set <point> 设置断点(默认启用)
|
|
7
|
+
otto debug breakpoints remove <point> 移除断点
|
|
8
|
+
otto debug breakpoints enable <point> 启用断点
|
|
9
|
+
otto debug breakpoints disable <point> 禁用断点
|
|
10
|
+
otto debug breakpoints enable-all 全部启用
|
|
11
|
+
otto debug breakpoints disable-all 全部禁用
|
|
12
|
+
otto debug points 列出所有可用断点位
|
|
13
|
+
otto debug state 调试器状态(断点统计 + 挂起的暂停)
|
|
14
|
+
|
|
15
|
+
选项:
|
|
16
|
+
--remote <url> service 地址(默认 OTTO_SERVICE_URL 或 http:
|
|
17
|
+
|
|
18
|
+
断点位(BREAKPOINT_POINTS):
|
|
19
|
+
${a.map(e=>` ${e}`).join(`
|
|
20
|
+
`)}
|
|
21
|
+
|
|
22
|
+
注:需要 \`otto serve --inspect\` 启动的 service(调试器默认关闭)。
|
|
23
|
+
resume/inject 等运行时命令经 REST:POST /api/debugger/resume | /inject。
|
|
24
|
+
`),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.
|
|
25
|
+
`),0;case`disable-all`:return await g.post(`/api/debugger/breakpoints/disable-all`),o(`All breakpoints disabled.
|
|
26
|
+
`),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.
|
|
27
|
+
`),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.
|
|
28
|
+
Use 'otto debug points' to list valid points.
|
|
29
|
+
`),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:
|
|
30
|
+
`);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
|
|
31
|
+
breakpoints: ${n.breakpoints.enabled}/${n.breakpoints.total} enabled
|
|
32
|
+
paused: ${n.paused?`yes`:`no`}
|
|
33
|
+
`);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 — 回放+回滚面板
|
|
34
|
+
|
|
35
|
+
用法:
|
|
36
|
+
otto time-travel checkpoints <session-id> 列出所有 checkpoint
|
|
37
|
+
otto time-travel checkpoint <session-id> [--label X] 创建新 checkpoint
|
|
38
|
+
otto time-travel scrubber <session-id> <seq> 显示 traceback 视图
|
|
39
|
+
otto time-travel restore <session-id> <seq> [--mode M] [--rollback]
|
|
40
|
+
恢复/回滚 (mode: conversation|code|both)
|
|
41
|
+
otto time-travel fork <session-id> <seq> 从 checkpoint 分叉新会话
|
|
42
|
+
otto time-travel replay <session-id> 启动确定性重放
|
|
43
|
+
|
|
44
|
+
选项:
|
|
45
|
+
--remote <url> service 地址(默认 OTTO_SERVICE_URL 或 ${r})
|
|
46
|
+
`),0;if(!d)return s(`otto time-travel: session-id is required.
|
|
47
|
+
`),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.
|
|
48
|
+
`),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)
|
|
49
|
+
`):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.
|
|
50
|
+
`),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.
|
|
51
|
+
`),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 树)
|
|
52
|
+
|
|
53
|
+
用法:
|
|
54
|
+
otto observe summary <session-id> trace 聚合统计
|
|
55
|
+
otto observe timeline <session-id> 文本时间线
|
|
56
|
+
otto observe spans <session-id> span 树视图
|
|
57
|
+
otto observe debug <action> [...] 调试面板(breakpoints / points / state)
|
|
58
|
+
otto observe replay <action> <id> 时间旅行(checkpoints / scrubber / restore / fork / replay)
|
|
59
|
+
|
|
60
|
+
选项:
|
|
61
|
+
--remote <url> service 地址(默认 OTTO_SERVICE_URL 或 ${r})
|
|
62
|
+
--json 输出结构化 JSON(需 service 运行)
|
|
63
|
+
`),0;if(!v)return c(`otto observe: session-id is required.
|
|
64
|
+
`),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}
|
|
65
|
+
──────────────────────────────────────────
|
|
66
|
+
Total events: ${i}
|
|
67
|
+
Turns: ${o}
|
|
68
|
+
Tool calls: ${s}
|
|
69
|
+
Time span: ${c!==void 0&&l!==void 0?`${l-c}ms`:`N/A`}
|
|
70
|
+
First event: ${c?new Date(c).toISOString():`N/A`}
|
|
71
|
+
Last event: ${l?new Date(l).toISOString():`N/A`}
|
|
72
|
+
|
|
73
|
+
By kind:
|
|
74
|
+
${Object.entries(a).map(([e,t])=>` ${e.padEnd(14)} ${t}`).join(`
|
|
75
|
+
`)}
|
|
76
|
+
`),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)
|
|
77
|
+
${`seq`.padStart(5)} time turn ${`kind`.padEnd(12)} ${`node`.padEnd(26)} digest
|
|
78
|
+
${`-`.repeat(100)}
|
|
79
|
+
${i.join(`
|
|
80
|
+
`)}
|
|
81
|
+
`),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)
|
|
82
|
+
`);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};
|
|
83
|
+
//# sourceMappingURL=observe-CZ96Vre9.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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-369 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":"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"}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import{ot as e}from"./command-dispatcher-BtW9xSr5.js";import{t}from"./version-0tC0345U.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};
|
|
3
|
+
//# sourceMappingURL=parse-cli-DO9wTwtm.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"parse-cli-DO9wTwtm.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":";oMA4BA,MAAa,EAAoB,IAAI,IAAgB,CACnD,MAAO,QAAS,SAAU,SAAU,SAAU,UAAW,OAAQ,UAAW,QAAS,cAAe,MAAO,eAAgB,4BAA6B,cAAe,YAAa,KAAM,WAC3L,CAAC,CA4CI,EAA0C,IAAI,IAlCrB,CAC7B,CAAE,MAAO,CAAC,UAAW,KAAK,CAAe,KAAM,OAAW,MAAO,QAAS,CAC1E,CAAE,MAAO,CAAC,gBAAiB,KAAK,CAAU,KAAM,OAAW,MAAO,cAAe,CACjF,CAAE,MAAO,CAAC,SAAS,CAAuB,KAAM,OAAW,MAAO,OAAQ,CAC1E,CAAE,MAAO,CAAC,UAAW,KAAK,CAAgB,KAAM,SAAW,IAAK,QAAS,CACzE,CAAE,MAAO,CAAC,WAAY,KAAK,CAAe,KAAM,SAAW,IAAK,aAAc,CAC9E,CAAE,MAAO,CAAC,YAAa,KAAK,CAAc,KAAM,OAAW,IAAK,aAAc,CAC9E,CAAE,MAAO,CAAC,UAAW,KAAK,CAAgB,KAAM,UAAW,IAAK,QAAS,CACzE,CAAE,MAAO,CAAC,YAAY,CAAoB,KAAM,UAAW,IAAK,UAAW,CAC3E,CAAE,MAAO,CAAC,mBAAmB,CAAa,KAAM,SAAW,IAAK,eAAgB,CAChF,CAAE,MAAO,CAAC,6BAA6B,CAAG,KAAM,SAAW,IAAK,wBAAyB,CACzF,CAAE,MAAO,CAAC,wBAAwB,CAAQ,KAAM,SAAW,IAAK,oBAAqB,CACrF,CAAE,MAAO,CAAC,uBAAuB,CAAS,KAAM,SAAW,IAAK,sBAAuB,CACvF,CAAE,MAAO,CAAC,wBAAwB,CAAQ,KAAM,SAAW,IAAK,oBAAqB,CACrF,CAAE,MAAO,CAAC,uBAAuB,CAAS,KAAM,UAAW,IAAK,mBAAoB,CACpF,CAAE,MAAO,CAAC,uBAAuB,CAAS,KAAM,SAAW,IAAK,mBAAoB,CACpF,CAAE,MAAO,CAAC,2BAA2B,CAAK,KAAM,SAAW,IAAK,uBAAwB,CACxF,CAAE,MAAO,CAAC,aAAa,CAAmB,KAAM,SAAW,IAAK,kBAAmB,CACnF,CAAE,MAAO,CAAC,WAAW,CAAqB,KAAM,SAAW,IAAK,gBAAiB,CACjF,CAAE,MAAO,CAAC,sBAAsB,CAAU,KAAM,UAAW,IAAK,kBAAmB,CAGnF,CAAE,MAAO,CAAC,yBAAyB,CAAQ,KAAM,UAAW,IAAK,qBAAsB,CAGvF,CAAE,MAAO,CAAC,kBAAkB,CAAe,KAAM,SAAW,IAAK,eAAgB,CACjF,CAAE,MAAO,CAAC,gBAAgB,CAAgB,KAAM,SAAW,IAAK,aAAc,CAC9E,CAAE,MAAO,CAAC,kBAAkB,CAAc,KAAM,SAAW,IAAK,eAAgB,CAChF,CAAE,MAAO,CAAC,OAAO,CAAyB,KAAM,SAAW,IAAK,cAAe,CAC/E,CAAE,MAAO,CAAC,WAAW,CAAqB,KAAM,UAAW,IAAK,SAAU,CAC1E,CAAE,MAAO,CAAC,SAAU,KAAK,CAAiB,KAAM,UAAW,IAAK,WAAY,CAC5E,CAAE,MAAO,CAAC,YAAa,KAAK,CAAc,KAAM,SAAW,QAAS,EAAc,CACnF,CAGS,QAAQ,GAAK,EAAE,MAAM,IAAI,GAAK,CAAC,EAAG,EAAE,CAAU,CAAC,CACxD,CAED,IAAM,EAAN,KAAgB,CACd,EACA,YAAY,EAAwB,CAAhB,KAAA,KAAA,EAClB,KAAK,EAAI,EAEX,SAA8B,CAAE,OAAO,KAAK,KAAK,KAAK,GACtD,MAA2B,CAAE,OAAO,KAAK,KAAK,EAAE,KAAK,GACrD,SAAgB,CAAE,KAAK,IACvB,KAAK,EAAqB,CAAE,KAAK,GAAK,EACtC,KAAc,CAAE,OAAO,KAAK,IAG9B,SAAgB,EAAS,EAA2B,CAClD,IAAM,EAAO,EAAK,MAAM,EAAE,CACpB,EAAS,IAAI,EAAU,EAAK,CAE5B,EAAsB,CAC1B,KAAM,cACN,WAAY,QAAQ,KAAK,CACzB,QAAS,GACT,MAAO,GACR,CAEK,EAAQ,EAAO,SAAS,CAC1B,EACA,EAAiB,GACjB,EACA,EACA,GAAS,EAAkB,IAAI,EAAoB,EACrD,EAAa,EACb,EAAiB,EAAK,MAAM,EAAE,CAAC,KAAK,IAAI,CACxC,EAAO,KAAK,EAAE,CAEV,IAAe,QACjB,EAAQ,OAAS,EAAK,MAAM,EAAE,CAAC,OAAO,GAAK,CAAC,EAAE,WAAW,IAAI,CAAC,CAAC,KAAK,IAAI,CACxE,EAAQ,KAAO,UAER,GAAS,CAAC,EAAM,WAAW,IAAI,GAIxC,EAAwB,EACxB,EAAwB,EAAK,MAAM,EAAE,EAGvC,IAAI,EAAwB,EAAQ,OAAS,CAAC,EAAQ,OAAO,CAAG,EAAE,CAElE,KAAO,EAAO,SAAS,GAAK,IAAA,IAAW,CACrC,IAAM,EAAM,EAAO,SAAS,CAE5B,GAAI,IAAQ,YAAa,CACvB,EAAQ,QAAU,GAClB,EAAO,SAAS,CAChB,SAEF,GAAI,GAAK,WAAW,aAAa,CAAE,CACjC,IAAM,EAAO,OAAO,EAAI,MAAM,GAAoB,CAAC,CACnD,EAAQ,QAAU,OAAO,UAAU,EAAK,EAAI,EAAO,EAAI,EAAO,GAC9D,EAAO,SAAS,CAChB,SAIF,GAAI,GAAK,WAAW,wBAAwB,CAAE,CAC5C,IAAM,EAAM,OAAO,EAAI,MAAM,GAA+B,CAAC,CACzD,OAAO,UAAU,EAAI,EAAI,EAAM,IAAG,EAAQ,kBAAoB,GAClE,EAAO,SAAS,CAChB,SAGF,IAAM,EAAQ,EAAc,IAAI,EAAI,CACpC,GAAI,EAAO,CAET,OADA,EAAO,SAAS,CACR,EAAM,KAAd,CACE,IAAK,UACD,EAA+C,EAAM,KAAO,GAC9D,MACF,IAAK,OACH,EAAQ,KAAO,EAAM,MACrB,MACF,IAAK,SACD,EAA+C,EAAM,KAAO,EAAO,SAAS,CAC9E,EAAO,SAAS,CAChB,MACF,IAAK,SACD,EAA+C,EAAM,KAAO,OAAO,EAAO,SAAS,CAAC,CACtF,EAAO,SAAS,CAChB,MACF,IAAK,OACD,EAA+C,EAAM,KAAO,EAAQ,EAAO,SAAS,EAAI,QAAQ,KAAK,CAAC,CACxG,EAAO,SAAS,CAChB,MACF,IAAK,SACH,EAAM,SAAS,CACf,MAEJ,SAGE,GAAO,CAAC,EAAI,WAAW,IAAI,EAAI,CAAC,IAC9B,EAAQ,SAAW,IAAA,IAAa,EAAQ,OAAS,gBACnD,EAAQ,KAAO,SAEjB,EAAY,KAAK,EAAI,EAEvB,EAAO,SAAS,CAOlB,OAJI,EAAY,OAAS,IACvB,EAAQ,OAAS,EAAY,KAAK,IAAI,EAGjC,CAAE,UAAS,aAAY,iBAAgB,wBAAuB,wBAAuB,CAI9F,SAAgB,GAAyB,CACvC,MAAO,CACL,GACA,oBACA,GACA,MACA,8CACA,4CACA,yCACA,GACA,MACA,iDACA,4CACA,wCACA,mCACA,qCACA,mCACA,qCACA,2CACA,yHACA,oDACA,sEACA,uEACA,6CACA,iEACA,qDACA,gFACA,gFACA,qCACA,qEACA,mDACA,6DACA,mCACA,mCACA,GACA,MACA,2CACA,2HACA,0DACA,0FACA,qDACA,2CACA,8DACA,iHACA,4CACA,8EACA,4EACA,oEACA,8EACA,iGACA,+DACA,gEACA,sDACA,gDACA,oDACA,qEACA,gHACA,+DACA,2EACA,gEACA,wEACA,gFACA,kFACA,GACA,gFACD,CAGH,SAAS,GAAqB,CAC5B,QAAQ,OAAO,MAAM,QAAQ,GAAY,CAAC,IAAI,CAC9C,QAAQ,KAAK,EAAE"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
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
|
|
3
|
+
`),1;if(!f)return c(`otto persistenced: --token is required
|
|
4
|
+
`),1;try{let{url:t}=await n({dir:l,port:u,host:d,token:f});o(`persistenced listening on ${t}
|
|
5
|
+
storage: ${t}/api/storage/:namespace
|
|
6
|
+
events: ${t}/api/events/:namespace (SSE)
|
|
7
|
+
sync: ${t}/api/sync/:namespace
|
|
8
|
+
health: ${t}/health
|
|
9
|
+
stop: Ctrl-C
|
|
10
|
+
`),await e(r.signal),o(`persistenced shutting down
|
|
11
|
+
`),process.exit(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)
|
|
12
|
+
|
|
13
|
+
用法:
|
|
14
|
+
otto persistenced --dir <path> --token <token> [--port <n>] [--host <ip>]
|
|
15
|
+
|
|
16
|
+
选项:
|
|
17
|
+
--dir, -d <path> 数据目录(SQLite db 文件存放位置,必填)
|
|
18
|
+
--token, -t <token> Bearer token(所有 /api/* 请求必须携带,必填)
|
|
19
|
+
--port, -p <n> 监听端口(默认 ${i})
|
|
20
|
+
--host, -h <ip> 监听地址(默认 ${a},0.0.0.0 = 公网暴露)
|
|
21
|
+
|
|
22
|
+
示例:
|
|
23
|
+
otto persistenced --dir /var/lib/otto/storage --token "\$TOKEN"
|
|
24
|
+
otto persistenced --dir ./data --port 3002 --token dev-secret
|
|
25
|
+
|
|
26
|
+
端点:
|
|
27
|
+
GET /health 健康检查
|
|
28
|
+
GET /api/storage/:namespace 列出文档 ID / 分页列表
|
|
29
|
+
GET /api/storage/:namespace/:id 读取文档
|
|
30
|
+
PUT /api/storage/:namespace/:id 写入文档
|
|
31
|
+
DELETE /api/storage/:namespace/:id 删除文档
|
|
32
|
+
GET /api/events/:namespace SSE 变更推送
|
|
33
|
+
POST /api/sync/:namespace/push 批量写入(离线同步)
|
|
34
|
+
GET /api/sync/:namespace/pull 增量拉取
|
|
35
|
+
`)}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
|
|
36
|
+
`),1;if(u===void 0)return i(`otto remote-persistence-server: --token is required (use --token "" to disable auth for dev only)
|
|
37
|
+
`),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});r(`remote-persistence-server listening on ${t}
|
|
38
|
+
sessions: ${t}/sessions
|
|
39
|
+
health: ${t}/health
|
|
40
|
+
stop: Ctrl-C
|
|
41
|
+
`),await e(n.signal),r(`remote-persistence-server shutting down
|
|
42
|
+
`),await new Promise(e=>i.close(()=>e())),c.close(),process.exit(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 端点)
|
|
43
|
+
|
|
44
|
+
用法:
|
|
45
|
+
otto remote-persistence-server --dir <path> --token <token> [--port <n>] [--host <ip>]
|
|
46
|
+
|
|
47
|
+
选项:
|
|
48
|
+
--dir, -d <path> 数据目录(SQLite db 文件存放位置,必填)
|
|
49
|
+
--token, -t <token> Bearer token(所有 /sessions/* 请求必须携带,必填)
|
|
50
|
+
--port, -p <n> 监听端口(默认 ${c})
|
|
51
|
+
--host, -h <ip> 监听地址(默认 ${l},0.0.0.0 = 公网暴露)
|
|
52
|
+
|
|
53
|
+
示例:
|
|
54
|
+
otto remote-persistence-server --dir ./data --token dev-secret
|
|
55
|
+
otto remote-persistence-server --dir /var/lib/otto/storage --port 3002 --token "\$TOKEN"
|
|
56
|
+
|
|
57
|
+
端点(:wsKey 为客户端工作区分区段,本服务 accept-and-ignore,按 token 派生 userId 分区):
|
|
58
|
+
GET /health 健康检查(无需认证)
|
|
59
|
+
GET /sessions/:wsKey 列出会话 ID(需要 Bearer token)
|
|
60
|
+
GET /sessions/:wsKey/:id 读取会话快照
|
|
61
|
+
PUT /sessions/:wsKey/:id 写入/更新会话快照
|
|
62
|
+
DELETE /sessions/:wsKey/:id 删除会话快照
|
|
63
|
+
|
|
64
|
+
对端客户端:
|
|
65
|
+
另一台机器上的 Otto CLI:
|
|
66
|
+
otto --session-url http://<host>:<port>/sessions --session-token <token>
|
|
67
|
+
`)}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)
|
|
68
|
+
|
|
69
|
+
用法:
|
|
70
|
+
otto persistence local [...flags] 启动独立持久化服务(storage + events + sync)
|
|
71
|
+
otto persistence remote [...flags] 启动最小化远程持久化服务(5 REST 端点)
|
|
72
|
+
|
|
73
|
+
子命令说明:
|
|
74
|
+
local 等价于旧 otto persistenced(SQLite + HTTP API,storage/events/sync)
|
|
75
|
+
remote 等价于旧 otto remote-persistence-server(Hono + SQLite,5 REST 端点)
|
|
76
|
+
|
|
77
|
+
通用选项(详见各子命令 --help):
|
|
78
|
+
--dir, -d <path> 数据目录(必填)
|
|
79
|
+
--token, -t <token> Bearer token(必填)
|
|
80
|
+
--port, -p <n> 监听端口(各子命令有各自默认端口)
|
|
81
|
+
--host, -h <ip> 监听地址(默认 127.0.0.1,0.0.0.0 = 公网暴露)
|
|
82
|
+
|
|
83
|
+
注:旧命令 otto persistenced / otto remote-persistence-server 仍可用(别名转发)。
|
|
84
|
+
`),0}}export{f as runPersistenceCommand};
|
|
85
|
+
//# sourceMappingURL=persistence-CpwMgSMe.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"persistence-CpwMgSMe.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 // 硬退出:同 serve.ts,避免孤儿 handle 吊住事件循环。\n process.exit(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 // 硬退出:同 serve.ts,避免孤儿 handle 吊住事件循环。\n process.exit(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-369 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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"}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
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};
|
|
3
|
+
//# sourceMappingURL=plugin-assembly-check-C2TephMb.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
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.
|
|
2
|
+
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(`
|
|
3
3
|
`):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(`
|
|
4
4
|
`)}`:``;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(`
|
|
5
5
|
`)}`:``;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};
|
|
6
|
-
//# sourceMappingURL=registry-
|
|
6
|
+
//# sourceMappingURL=registry-BdCcwyGy.js.map
|