@octopi-agent/engine 0.102.10 → 0.121.10

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.
Files changed (317) hide show
  1. package/dist/builtin-model-info.js +28 -7
  2. package/dist/config-admin/agent-presets.d.ts +32 -0
  3. package/dist/config-admin/agent-presets.js +133 -0
  4. package/dist/config-admin/discover.d.ts +33 -4
  5. package/dist/config-admin/discover.js +101 -6
  6. package/dist/config-admin/env.d.ts +11 -0
  7. package/dist/config-admin/env.js +41 -0
  8. package/dist/config-admin/error-copy.d.ts +106 -0
  9. package/dist/config-admin/error-copy.js +287 -0
  10. package/dist/config-admin/i18n.d.ts +21 -0
  11. package/dist/config-admin/i18n.js +19 -0
  12. package/dist/config-admin/index.d.ts +6 -2
  13. package/dist/config-admin/index.js +3 -1
  14. package/dist/config-admin/model-presets.d.ts +14 -0
  15. package/dist/config-admin/model-presets.js +595 -70
  16. package/dist/config-admin/onboarding-apply.d.ts +71 -0
  17. package/dist/config-admin/onboarding-apply.js +235 -0
  18. package/dist/config-admin/onboarding.d.ts +154 -0
  19. package/dist/config-admin/onboarding.js +270 -0
  20. package/dist/config-admin/redact.d.ts +42 -9
  21. package/dist/config-admin/redact.js +69 -5
  22. package/dist/config-schema/agent.d.ts +5 -1
  23. package/dist/config-schema/agent.js +20 -2
  24. package/dist/config-schema/browser.d.ts +62 -0
  25. package/dist/config-schema/browser.js +89 -0
  26. package/dist/config-schema/context.d.ts +7 -2
  27. package/dist/config-schema/context.js +6 -3
  28. package/dist/config-schema/engine.d.ts +86 -7
  29. package/dist/config-schema/engine.js +9 -2
  30. package/dist/config-schema/governance.d.ts +12 -1
  31. package/dist/config-schema/governance.js +10 -2
  32. package/dist/config-schema/models.d.ts +12 -8
  33. package/dist/config-schema/models.js +16 -1
  34. package/dist/config-schema/run.d.ts +4 -0
  35. package/dist/config-schema/run.js +10 -0
  36. package/dist/config-schema/shared.d.ts +1 -0
  37. package/dist/config-schema/shared.js +4 -2
  38. package/dist/config-schema/substrate.d.ts +5 -0
  39. package/dist/config-schema/substrate.js +8 -0
  40. package/dist/config.d.ts +116 -10
  41. package/dist/config.js +109 -13
  42. package/dist/file-mode.d.ts +67 -0
  43. package/dist/file-mode.js +182 -0
  44. package/dist/fork-child.d.ts +82 -0
  45. package/dist/fork-child.js +123 -0
  46. package/dist/harness/activation/delegated-run.d.ts +42 -0
  47. package/dist/harness/activation/delegated-run.js +71 -0
  48. package/dist/harness/activation/dispatcher.js +4 -0
  49. package/dist/harness/activation/index.d.ts +1 -0
  50. package/dist/harness/activation/run-backend.d.ts +92 -0
  51. package/dist/harness/activation/run-backend.js +16 -0
  52. package/dist/harness/activation/run-protocol.d.ts +392 -0
  53. package/dist/harness/activation/run-protocol.js +19 -0
  54. package/dist/harness/activation/runtime.d.ts +33 -0
  55. package/dist/harness/activation/runtime.js +119 -28
  56. package/dist/harness/activation/types.d.ts +19 -2
  57. package/dist/harness/agent/builder.d.ts +12 -0
  58. package/dist/harness/agent/builder.js +78 -22
  59. package/dist/harness/agent/config-bridge.d.ts +10 -1
  60. package/dist/harness/agent/config-bridge.js +15 -3
  61. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  62. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  63. package/dist/harness/agent/wire-agent-builder.d.ts +2 -0
  64. package/dist/harness/agent/wire-agent-builder.js +9 -2
  65. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  66. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  67. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  68. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  69. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  70. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  71. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  72. package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -0
  73. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +13 -3
  76. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +48 -39
  77. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +3 -0
  78. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +4 -0
  79. package/dist/harness/collaboration/delegation/child-run.d.ts +9 -0
  80. package/dist/harness/collaboration/delegation/child-run.js +34 -2
  81. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  82. package/dist/harness/collaboration/delegation/service.d.ts +9 -4
  83. package/dist/harness/collaboration/delegation/service.js +33 -12
  84. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  85. package/dist/harness/collaboration/delegation/store.js +1 -0
  86. package/dist/harness/collaboration/delegation/types.d.ts +11 -0
  87. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  88. package/dist/harness/collaboration/delegation/wiring.js +1 -0
  89. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -5
  90. package/dist/harness/context/capabilities/compact/engine.js +127 -39
  91. package/dist/harness/context/capabilities/compact/index.d.ts +2 -1
  92. package/dist/harness/context/capabilities/compact/index.js +1 -1
  93. package/dist/harness/context/capabilities/compact/types.d.ts +59 -9
  94. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  95. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  96. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  97. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  98. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  99. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  100. package/dist/harness/context/capabilities/summary/types.d.ts +16 -0
  101. package/dist/harness/context/constitution/default-agents.md +85 -0
  102. package/dist/harness/context/context-size-ledger.js +8 -1
  103. package/dist/harness/context/default-context-engine.d.ts +100 -6
  104. package/dist/harness/context/default-context-engine.js +382 -89
  105. package/dist/harness/context/index.d.ts +2 -1
  106. package/dist/harness/context/index.js +1 -0
  107. package/dist/harness/context/layer-health.d.ts +4 -0
  108. package/dist/harness/context/layer-health.js +4 -0
  109. package/dist/harness/context/layer-types.d.ts +57 -0
  110. package/dist/harness/context/layer-types.js +73 -1
  111. package/dist/harness/context/layers.d.ts +3 -0
  112. package/dist/harness/context/layers.js +13 -6
  113. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  114. package/dist/harness/context/prefix-fingerprint.js +52 -0
  115. package/dist/harness/context/summarize.js +18 -0
  116. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  117. package/dist/harness/context/system-prompt-assembler.js +5 -2
  118. package/dist/harness/context/tool-result-aging.d.ts +104 -16
  119. package/dist/harness/context/tool-result-aging.js +211 -57
  120. package/dist/harness/context/types.d.ts +71 -4
  121. package/dist/harness/context/types.js +25 -1
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  123. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  124. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  125. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  126. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +27 -1
  127. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  128. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  129. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  130. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  131. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  132. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  133. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +168 -1
  134. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +156 -15
  135. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  136. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  137. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  138. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  139. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +40 -5
  140. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +45 -26
  141. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -1
  142. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +11 -1
  143. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +42 -76
  144. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +30 -1
  145. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +46 -0
  146. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +19 -14
  148. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +3 -1
  149. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +1 -1
  150. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  151. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  152. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  153. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  154. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  155. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  156. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -0
  157. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  158. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  159. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  160. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  161. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  162. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  163. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  164. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  165. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  166. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +10 -24
  167. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  168. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  169. package/dist/harness/governance/credentials/db.d.ts +9 -0
  170. package/dist/harness/governance/credentials/db.js +122 -31
  171. package/dist/harness/governance/credentials/store.d.ts +68 -7
  172. package/dist/harness/governance/credentials/store.js +177 -64
  173. package/dist/harness/governance/credentials/types.d.ts +13 -2
  174. package/dist/harness/governance/index.d.ts +1 -0
  175. package/dist/harness/governance/index.js +1 -0
  176. package/dist/harness/governance/registry/db.d.ts +32 -0
  177. package/dist/harness/governance/registry/db.js +142 -0
  178. package/dist/harness/governance/registry/index.d.ts +9 -0
  179. package/dist/harness/governance/registry/index.js +9 -0
  180. package/dist/harness/governance/registry/service.d.ts +381 -0
  181. package/dist/harness/governance/registry/service.js +825 -0
  182. package/dist/harness/governance/registry/types.d.ts +77 -0
  183. package/dist/harness/governance/registry/types.js +7 -0
  184. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  185. package/dist/harness/governance/security/default-security-guard.js +12 -1
  186. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  187. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  188. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  189. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  190. package/dist/harness/index.d.ts +5 -3
  191. package/dist/harness/index.js +2 -2
  192. package/dist/harness/knowledge/boot-config.d.ts +2 -0
  193. package/dist/harness/knowledge/boot-config.js +2 -0
  194. package/dist/harness/knowledge/client.d.ts +53 -7
  195. package/dist/harness/knowledge/client.js +77 -20
  196. package/dist/harness/knowledge/db.d.ts +16 -0
  197. package/dist/harness/knowledge/db.js +107 -41
  198. package/dist/harness/knowledge/engine-thread.js +5 -7
  199. package/dist/harness/knowledge/grounding.js +4 -1
  200. package/dist/harness/knowledge/http-app.d.ts +15 -0
  201. package/dist/harness/knowledge/http-app.js +82 -21
  202. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  203. package/dist/harness/knowledge/http-bridge.js +19 -0
  204. package/dist/harness/knowledge/knowledge-serve-child.js +2 -3
  205. package/dist/harness/knowledge/query-service.d.ts +12 -2
  206. package/dist/harness/knowledge/query-service.js +75 -41
  207. package/dist/harness/knowledge/query-worker-client.d.ts +5 -1
  208. package/dist/harness/knowledge/query-worker-client.js +4 -1
  209. package/dist/harness/knowledge/query-worker.js +5 -3
  210. package/dist/harness/knowledge/read-http.d.ts +2 -0
  211. package/dist/harness/knowledge/read-http.js +9 -2
  212. package/dist/harness/knowledge/retriever.d.ts +1 -1
  213. package/dist/harness/knowledge/retriever.js +1 -2
  214. package/dist/harness/knowledge/serve.d.ts +6 -1
  215. package/dist/harness/knowledge/serve.js +5 -6
  216. package/dist/harness/knowledge/source-store.d.ts +101 -5
  217. package/dist/harness/knowledge/source-store.js +297 -71
  218. package/dist/harness/knowledge/start-service-process.d.ts +27 -8
  219. package/dist/harness/knowledge/start-service-process.js +49 -90
  220. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  221. package/dist/harness/knowledge/tenant-gate.js +167 -0
  222. package/dist/harness/knowledge/writer-service.d.ts +18 -2
  223. package/dist/harness/knowledge/writer-service.js +80 -16
  224. package/dist/harness/knowledge/writer-worker-client.d.ts +9 -2
  225. package/dist/harness/knowledge/writer-worker-client.js +20 -3
  226. package/dist/harness/knowledge/writer-worker.js +11 -4
  227. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  228. package/dist/harness/memory/backfill-trigger.js +19 -19
  229. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  230. package/dist/harness/memory/cognition-seeds.js +67 -0
  231. package/dist/harness/memory/cognition.d.ts +12 -3
  232. package/dist/harness/memory/cognition.js +55 -35
  233. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  234. package/dist/harness/memory/conceptualizer.js +10 -1
  235. package/dist/harness/memory/context-slice.d.ts +42 -0
  236. package/dist/harness/memory/context-slice.js +197 -0
  237. package/dist/harness/memory/health-probe.d.ts +8 -2
  238. package/dist/harness/memory/health-probe.js +10 -13
  239. package/dist/harness/memory/index.d.ts +5 -1
  240. package/dist/harness/memory/index.js +3 -1
  241. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  242. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  243. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  244. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  245. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  246. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  247. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  248. package/dist/harness/memory/types.d.ts +18 -2
  249. package/dist/harness/observability/observer/hub.d.ts +10 -0
  250. package/dist/harness/observability/observer/hub.js +95 -2
  251. package/dist/harness/run/agent/agent.js +3 -2
  252. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  253. package/dist/harness/run/reliability/run-agent.d.ts +22 -0
  254. package/dist/harness/run/reliability/run-agent.js +79 -10
  255. package/dist/harness/run/run-host.d.ts +302 -0
  256. package/dist/harness/run/run-host.js +978 -0
  257. package/dist/harness/run/run-scope.d.ts +11 -0
  258. package/dist/harness/run/run-scope.js +19 -1
  259. package/dist/harness/run/runner.d.ts +149 -22
  260. package/dist/harness/run/runner.js +352 -35
  261. package/dist/harness/session/in-memory-store.js +13 -1
  262. package/dist/harness/session/schedules/service.d.ts +10 -2
  263. package/dist/harness/session/schedules/service.js +13 -2
  264. package/dist/harness/session/tasks/tools.js +12 -0
  265. package/dist/harness/session/types.d.ts +10 -14
  266. package/dist/harness/shared/events/agent-event-map.d.ts +29 -0
  267. package/dist/harness/shared/types/agent-definition.d.ts +6 -0
  268. package/dist/index.d.ts +3 -2
  269. package/dist/index.js +2 -1
  270. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  271. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  272. package/dist/integration/browser/camoufox.d.ts +40 -0
  273. package/dist/integration/browser/camoufox.js +80 -0
  274. package/dist/integration/browser/index.d.ts +91 -0
  275. package/dist/integration/browser/index.js +110 -0
  276. package/dist/integration/browser/install.d.ts +47 -0
  277. package/dist/integration/browser/install.js +214 -0
  278. package/dist/integration/browser/playwright.d.ts +224 -0
  279. package/dist/integration/browser/playwright.js +925 -0
  280. package/dist/integration/browser/service.d.ts +41 -0
  281. package/dist/integration/browser/service.js +181 -0
  282. package/dist/integration/browser/stealth.d.ts +42 -0
  283. package/dist/integration/browser/stealth.js +104 -0
  284. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  285. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  286. package/dist/integration/providers/anthropic.js +27 -2
  287. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  288. package/dist/integration/providers/fetch-timeout.js +24 -0
  289. package/dist/integration/providers/openai.d.ts +8 -0
  290. package/dist/integration/providers/openai.js +41 -1
  291. package/dist/integration/providers/wire-dump-diff.js +2 -1
  292. package/dist/integration/providers/wire-dump.d.ts +56 -2
  293. package/dist/integration/providers/wire-dump.js +119 -6
  294. package/dist/integration/storage/archive-manager.d.ts +14 -2
  295. package/dist/integration/storage/archive-manager.js +24 -8
  296. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  297. package/dist/integration/storage/atomic-tmp.js +36 -0
  298. package/dist/integration/storage/jsonl.d.ts +9 -0
  299. package/dist/integration/storage/jsonl.js +137 -38
  300. package/dist/integration/storage/session-index.d.ts +5 -0
  301. package/dist/integration/storage/session-index.js +25 -4
  302. package/dist/integration/tools/assemble.d.ts +50 -0
  303. package/dist/integration/tools/assemble.js +137 -0
  304. package/dist/paths.d.ts +18 -0
  305. package/dist/paths.js +36 -0
  306. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  307. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  308. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  309. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  310. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  311. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  312. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  313. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  314. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  315. package/dist/subsystems/wisdom-steward/formation/config.yaml +3 -0
  316. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  317. package/package.json +5 -3
@@ -0,0 +1,287 @@
1
+ /**
2
+ * 错误分类与人话文案单源(批 3-2:批 2 登记项「错误映射四份单源化」;本批扩展为域×档)。
3
+ *
4
+ * 收敛前四份各自维护:engine `classifyProbeError`(分类)、webui `probeCopy`、
5
+ * CLI `probeLabels`、webui `error-classify`(文案)——码集漂移(server vs context)
6
+ * 与口径漂移正是两处真相病。本模块是唯一实现:
7
+ *
8
+ * - **分类**:`classifyErrorKind` —— probe 与运行期共用一套关键词规则
9
+ * - **码集**:`auth | network | timeout | rate_limit | model | context | server`
10
+ * - **来源域**:`provider`(模型服务)| `tool`(工具执行)| `app`(界面/会话操作)——
11
+ * 工具错误与 app 错误不是模型服务错误,不共用 provider 分类器(语义即契约)
12
+ * - **处置档**:`self-heal`(可自愈,不进错误卡)| `user-action`(卡+出路)| `support`(卡+诊断 ID)
13
+ * - **文案**:probe 语境(向导,有「上一步」)与 run 语境(对话流,有「去设置」)
14
+ * 各一张表,zh/en 双语——UI 只做渲染与 CTA 装配,不再自持文案
15
+ *
16
+ * @module
17
+ */
18
+ import { isContextLengthErrorText } from '@octopi-agent/core/loop/error-classifier.js';
19
+ /**
20
+ * 错误文本 → 分类码(probe 与运行期共用;关键词规则唯一实现)。
21
+ *
22
+ * @param raw - 原始错误文本
23
+ * @returns 分类码(无法归类时 'server')
24
+ */
25
+ export function classifyErrorKind(raw) {
26
+ const t = raw.toLowerCase();
27
+ if (t.includes('401') ||
28
+ t.includes('403') ||
29
+ t.includes('unauthorized') ||
30
+ t.includes('forbidden') ||
31
+ t.includes('api key') ||
32
+ t.includes('apikey') ||
33
+ t.includes('api-key') || // m4:api-key / api_key 变体(x-api-key 等;旧正则 api.?key 覆盖)
34
+ t.includes('api_key') ||
35
+ t.includes('invalid key') ||
36
+ t.includes('authentication')) {
37
+ return 'auth';
38
+ }
39
+ if (/\b429\b/.test(raw) ||
40
+ t.includes('rate limit') ||
41
+ t.includes('ratelimit') ||
42
+ t.includes('too many requests') ||
43
+ t.includes('quota') ||
44
+ t.includes('overloaded')) {
45
+ return 'rate_limit';
46
+ }
47
+ if (t.includes('timeout') ||
48
+ t.includes('timed out') ||
49
+ t.includes('timedout') ||
50
+ t.includes('etimedout') ||
51
+ t.includes('deadline exceeded')) {
52
+ return 'timeout';
53
+ }
54
+ if (t.includes('econnrefused') ||
55
+ t.includes('enotfound') ||
56
+ t.includes('econnreset') ||
57
+ t.includes('fetch failed') ||
58
+ t.includes('network') ||
59
+ t.includes('getaddrinfo')) {
60
+ return 'network';
61
+ }
62
+ if (t.includes('model') &&
63
+ (t.includes('not found') ||
64
+ t.includes('does not exist') ||
65
+ t.includes('unknown') ||
66
+ t.includes('no such') ||
67
+ t.includes('invalid'))) {
68
+ return 'model';
69
+ }
70
+ // context 判定复用 core 的跨 provider 长度错误文本单源(M4:Anthropic
71
+ // "prompt is too long: … > … maximum"、Gemini "input token count … exceeds…")
72
+ if ((t.includes('context') && (t.includes('length') || t.includes('exceed') || t.includes('too long') || t.includes('maximum'))) ||
73
+ isContextLengthErrorText(raw)) {
74
+ return 'context';
75
+ }
76
+ return 'server';
77
+ }
78
+ /**
79
+ * 守卫 violation 文本判定(单源:classifyToolErrorKind 的 blocked 与
80
+ * securityBlockedCopy 共用)。真实工具阻断文本是 violation description
81
+ * (`工具 "shell" download pipe to interpreter (remote code execution)`),
82
+ * 只有 afterToolCall 输出扫描才带 `Blocked by SecurityGuard:` 前缀。
83
+ */
84
+ export function securityViolationKind(text) {
85
+ const t = text.toLowerCase();
86
+ if (t.includes('remote code execution'))
87
+ return 'rce';
88
+ if (t.includes('disk wipe') || t.includes('recursive delete') || t.includes('递归删除'))
89
+ return 'disk_wipe';
90
+ if (t.includes('prompt injection'))
91
+ return 'injection';
92
+ if (text.includes('保护路径') || t.includes('protected path'))
93
+ return 'protected_path';
94
+ if (t.includes('sensitive') || text.includes('密钥') || text.includes('凭证'))
95
+ return 'secret';
96
+ return null;
97
+ }
98
+ /**
99
+ * 工具错误 → 分类码(启发式)。
100
+ *
101
+ * - `blocked`:守卫拦截(模型收到后换方案即可,可自愈)
102
+ * - `internal`:BUG 级内部异常(堆栈帧落在 octopi 包内)→ 该找支持
103
+ * - `failed`:其余执行失败(参数错误、路径不存在、exit≠0…)→ 模型可自救
104
+ *
105
+ * @param raw - 工具错误原文
106
+ * @returns 分类码
107
+ */
108
+ export function classifyToolErrorKind(raw) {
109
+ const t = raw.toLowerCase();
110
+ if (t.includes('blocked by securityguard') || securityViolationKind(raw))
111
+ return 'blocked';
112
+ // internal 只认「堆栈 + octopi 包内路径」:用户脚本 stderr 里的 TypeError/堆栈
113
+ // 是执行失败(模型可自救),不是工具内部异常
114
+ const hasStack = /\n\s+at\s/.test(raw);
115
+ const inPackage = /(packages\/|node_modules\/@octopi|@octopi-agent)/.test(raw);
116
+ if (hasStack && inPackage)
117
+ return 'internal';
118
+ return 'failed';
119
+ }
120
+ const PROBE_COPY = {
121
+ auth: {
122
+ zh: { title: '密钥没通过校验', detail: '请检查 API Key 是否正确(回到上一步修改)。' },
123
+ en: { title: 'API key rejected', detail: 'Check the API key and go back to fix it.' },
124
+ },
125
+ network: {
126
+ zh: { title: '连不上模型服务', detail: '请检查 baseUrl 与网络连接后重试。' },
127
+ en: { title: 'Cannot reach the service', detail: 'Check the base URL and network, then retry.' },
128
+ },
129
+ timeout: {
130
+ zh: { title: '连接超时', detail: '请检查网络后重试。' },
131
+ en: { title: 'Connection timed out', detail: 'Check the network, then retry.' },
132
+ },
133
+ rate_limit: {
134
+ zh: { title: '请求太频繁', detail: '请稍后重试。' },
135
+ en: { title: 'Too many requests', detail: 'Retry later.' },
136
+ },
137
+ model: {
138
+ zh: { title: '模型不存在', detail: '请回到上一步换一个模型。' },
139
+ en: { title: 'Model not found', detail: 'Go back and pick a different model.' },
140
+ },
141
+ server: {
142
+ zh: { title: '模型服务出错', detail: '服务端异常,请稍后重试;持续失败请查看服务日志。' },
143
+ en: { title: 'Provider error', detail: 'The provider had an error. Retry later; check service logs if it persists.' },
144
+ },
145
+ };
146
+ const RUNTIME_COPY = {
147
+ auth: {
148
+ zh: { title: '模型服务的密钥无效或已过期', detail: '请到「设置 → 模型」更新 API Key 后重试。' },
149
+ en: { title: 'Invalid or expired API key', detail: 'Update the API key in Settings → Models, then retry.' },
150
+ },
151
+ network: {
152
+ zh: { title: '连不上模型服务', detail: '请检查网络或模型服务地址(设置 → 模型),稍后重试。' },
153
+ en: { title: 'Cannot reach the model service', detail: 'Check the network or service URL (Settings → Models), then retry.' },
154
+ },
155
+ timeout: {
156
+ zh: { title: '模型服务响应超时', detail: '服务响应太慢或网络不佳,可稍后重试。' },
157
+ en: { title: 'Model service timed out', detail: 'The service responded too slowly. Retry later.' },
158
+ },
159
+ rate_limit: {
160
+ zh: { title: '请求太频繁', detail: '模型服务限流或配额用尽,可稍后再试。' },
161
+ en: { title: 'Too many requests', detail: 'The service rate-limited the request or the quota is spent. Try again later.' },
162
+ },
163
+ model: {
164
+ zh: { title: '所选模型不可用', detail: '模型名可能已下线或拼写有误,请到「设置 → 模型」换一个模型。' },
165
+ en: { title: 'Model unavailable', detail: 'The model may be retired or misspelled. Pick another in Settings → Models.' },
166
+ },
167
+ context: {
168
+ zh: { title: '消息太长,超出模型的记忆容量', detail: '可以压缩早期消息(对话顶部「压缩」)或新开会话再试。' },
169
+ en: { title: 'Message too long', detail: 'Compact earlier messages (the Compact button on top) or start a new session.' },
170
+ },
171
+ server: {
172
+ zh: { title: '模型服务出错了', detail: '这不是你的操作问题。复制下面的诊断 ID 反馈给支持人员即可。' },
173
+ en: { title: 'Provider error', detail: 'This is not your fault. Copy the diagnostic ID below and send it to support.' },
174
+ },
175
+ };
176
+ const TOOL_COPY = {
177
+ blocked: {
178
+ zh: { title: '操作已被安全策略拦截', detail: 'agent 将换一种方案继续。' },
179
+ en: { title: 'Blocked by security policy', detail: 'The agent will try a different approach.' },
180
+ },
181
+ failed: {
182
+ zh: { title: '工具执行未成功', detail: 'agent 会根据错误信息调整方案继续。' },
183
+ en: { title: 'Tool call failed', detail: 'The agent will adjust and continue.' },
184
+ },
185
+ internal: {
186
+ zh: { title: '工具内部异常', detail: '这不是你的操作问题。复制下面的诊断 ID 反馈给支持人员即可。' },
187
+ en: { title: 'Tool internal error', detail: 'This is not your fault. Copy the diagnostic ID below and send it to support.' },
188
+ },
189
+ };
190
+ const APP_COPY = {
191
+ failed: {
192
+ zh: { title: '操作失败', detail: '请稍后重试;持续失败请查看服务日志。' },
193
+ en: { title: 'Operation failed', detail: 'Retry later; check service logs if it persists.' },
194
+ },
195
+ };
196
+ /**
197
+ * 域分类主入口:按来源域分流到对应分类器与文案表,并给出处置档。
198
+ *
199
+ * - `provider`:`classifyErrorKind` 七类码;`server` 兜底 → support,其余 user-action
200
+ * - `tool`:`classifyToolErrorKind`;`internal` → support,其余 self-heal(模型可自救)
201
+ * - `app`:操作失败 → user-action
202
+ *
203
+ * @param raw - 原始错误文本
204
+ * @param domain - 来源域
205
+ * @param lang - 语言
206
+ * @returns 域分类结果(level + 人话文案)
207
+ */
208
+ export function classifyError(raw, domain, lang = 'zh') {
209
+ if (domain === 'tool') {
210
+ const kind = classifyToolErrorKind(raw);
211
+ return {
212
+ domain,
213
+ kind,
214
+ level: kind === 'internal' ? 'support' : 'self-heal',
215
+ copy: TOOL_COPY[kind][lang],
216
+ };
217
+ }
218
+ if (domain === 'app') {
219
+ return { domain, kind: 'failed', level: 'user-action', copy: APP_COPY.failed[lang] };
220
+ }
221
+ const kind = classifyErrorKind(raw);
222
+ return {
223
+ domain,
224
+ kind,
225
+ level: kind === 'server' ? 'support' : 'user-action',
226
+ copy: RUNTIME_COPY[kind][lang],
227
+ };
228
+ }
229
+ /**
230
+ * 守卫拦截消息人话化(security.blocked 的 reason 是审计语,不直接给用户)。
231
+ *
232
+ * @param reason - violation description 原文
233
+ * @param lang - 语言
234
+ * @returns 标题与详情(UI 可在详情后附注 reason 保留可诊断性)
235
+ */
236
+ export function securityBlockedCopy(reason, lang = 'zh') {
237
+ const zh = (title) => ({ title, detail: 'agent 将换一种方案继续。' });
238
+ const en = (title) => ({ title, detail: 'The agent will try a different approach.' });
239
+ switch (securityViolationKind(reason)) {
240
+ case 'rce':
241
+ return lang === 'zh' ? zh('已拦截:可能下载并执行远程代码') : en('Blocked: possible download-and-execute');
242
+ case 'disk_wipe':
243
+ return lang === 'zh' ? zh('已拦截:可能清空磁盘') : en('Blocked: possible disk wipe');
244
+ case 'protected_path':
245
+ return lang === 'zh' ? zh('已拦截:可能破坏系统保护路径') : en('Blocked: possible damage to a protected path');
246
+ case 'injection':
247
+ return lang === 'zh' ? zh('已拦截:可能的提示注入') : en('Blocked: possible prompt injection');
248
+ case 'secret':
249
+ return lang === 'zh' ? zh('已拦截:可能泄露敏感信息') : en('Blocked: possible sensitive-data exposure');
250
+ default:
251
+ return lang === 'zh' ? zh('已拦截可疑操作') : en('Blocked: suspicious operation');
252
+ }
253
+ }
254
+ /**
255
+ * probe 语境文案(向导)。
256
+ *
257
+ * @param kind - 分类码(不含 'context')
258
+ * @param lang - 语言
259
+ * @returns 标题与详情
260
+ */
261
+ export function probeErrorCopy(kind, lang = 'zh') {
262
+ return PROBE_COPY[kind][lang];
263
+ }
264
+ /** probe 分类码全集(Record 全键派生——扩类时编译器强制补表,消费侧码表不静默缺键) */
265
+ const PROBE_KIND_CHECK = {
266
+ auth: true,
267
+ network: true,
268
+ timeout: true,
269
+ rate_limit: true,
270
+ model: true,
271
+ server: true,
272
+ };
273
+ export const PROBE_ERROR_KINDS = Object.keys(PROBE_KIND_CHECK);
274
+ /** 诊断 ID(support 档展示与反馈对账用) */
275
+ export function makeDiagnosticId() {
276
+ return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
277
+ }
278
+ /**
279
+ * 运行期语境文案(对话流错误卡)。
280
+ *
281
+ * @param kind - 分类码
282
+ * @param lang - 语言
283
+ * @returns 标题与详情
284
+ */
285
+ export function runtimeErrorCopy(kind, lang = 'zh') {
286
+ return RUNTIME_COPY[kind][lang];
287
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * 产品语言本地化原语 — 预设表(provider / agent 角色)展示文案共用。
3
+ *
4
+ * 语义:`LocalizedText` 是可选的双语映射;渲染时按当前语言取值,
5
+ * 缺译回落 `label` / `description` 基准字段(基准字段永在,不拆两套表)。
6
+ *
7
+ * @module
8
+ */
9
+ /** 产品语言(顶层 `language` 配置取值域) */
10
+ export type ProductLang = 'zh' | 'en';
11
+ /** 双语文案映射(缺省语言回落基准字段) */
12
+ export type LocalizedText = Partial<Record<ProductLang, string>>;
13
+ /**
14
+ * 取本地化文案
15
+ *
16
+ * @param map - 双语映射(可空)
17
+ * @param fallback - 基准字段(label / description 等,永不为空)
18
+ * @param lang - 当前语言
19
+ * @returns 本地化文案;无译文时返回 fallback
20
+ */
21
+ export declare function pickLocalized(map: LocalizedText | undefined, fallback: string, lang: ProductLang): string;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * 产品语言本地化原语 — 预设表(provider / agent 角色)展示文案共用。
3
+ *
4
+ * 语义:`LocalizedText` 是可选的双语映射;渲染时按当前语言取值,
5
+ * 缺译回落 `label` / `description` 基准字段(基准字段永在,不拆两套表)。
6
+ *
7
+ * @module
8
+ */
9
+ /**
10
+ * 取本地化文案
11
+ *
12
+ * @param map - 双语映射(可空)
13
+ * @param fallback - 基准字段(label / description 等,永不为空)
14
+ * @param lang - 当前语言
15
+ * @returns 本地化文案;无译文时返回 fallback
16
+ */
17
+ export function pickLocalized(map, fallback, lang) {
18
+ return map?.[lang]?.trim() || fallback;
19
+ }
@@ -7,8 +7,10 @@
7
7
  * @module
8
8
  */
9
9
  export { assertSafeConfigName } from './name-guard.js';
10
- export { BUILTIN_AGENT_ROLE_PRESETS, getAgentRolePreset, renderAgentRole, } from './agent-presets.js';
11
- export type { AgentRolePreset, AgentRoleSlots, RenderedAgentRole, EffectMode, } from './agent-presets.js';
10
+ export { pickLocalized } from './i18n.js';
11
+ export type { ProductLang, LocalizedText } from './i18n.js';
12
+ export { BUILTIN_AGENT_ROLE_PRESETS, getAgentRolePreset, renderAgentRole, renderRolePreset, } from './agent-presets.js';
13
+ export type { AgentRolePreset, AgentRoleSlots, AgentRoleSkill, AgentRolePersonaFile, RenderedAgentRole, EffectMode, } from './agent-presets.js';
12
14
  export { BUILTIN_MODEL_PRESETS, getProviderPreset, listProviderPresets, expandProviderPreset, } from './model-presets.js';
13
15
  export type { ModelPresetModel, ProviderPreset } from './model-presets.js';
14
16
  export { redactSecret, redactProvider } from './redact.js';
@@ -18,3 +20,5 @@ export { ConfigConflictError } from './port.js';
18
20
  export type { ConfigAdminPort, ConfigAdminSnapshot, ConfigAdminWriteResult, } from './port.js';
19
21
  export { discoverProviderModels } from './discover.js';
20
22
  export type { DiscoverModelsRequest, DiscoverModelsResult } from './discover.js';
23
+ export { ONBOARDING_STEPS, DEPLOYMENT_MODES, pickLang, apiKeyEnvVar, validateStep, assembleOnboarding, providerChoices, } from './onboarding.js';
24
+ export type { OnboardingStepId, InitMode, DeploymentMode, DeploymentModeChoice, OnboardingChoices, OnboardingOutput, } from './onboarding.js';
@@ -7,9 +7,11 @@
7
7
  * @module
8
8
  */
9
9
  export { assertSafeConfigName } from './name-guard.js';
10
- export { BUILTIN_AGENT_ROLE_PRESETS, getAgentRolePreset, renderAgentRole, } from './agent-presets.js';
10
+ export { pickLocalized } from './i18n.js';
11
+ export { BUILTIN_AGENT_ROLE_PRESETS, getAgentRolePreset, renderAgentRole, renderRolePreset, } from './agent-presets.js';
11
12
  export { BUILTIN_MODEL_PRESETS, getProviderPreset, listProviderPresets, expandProviderPreset, } from './model-presets.js';
12
13
  export { redactSecret, redactProvider } from './redact.js';
13
14
  export { computeConfigHash, getJsonPath, setJsonPath, deleteJsonPath, findProviderReferences, } from './patch.js';
14
15
  export { ConfigConflictError } from './port.js';
15
16
  export { discoverProviderModels } from './discover.js';
17
+ export { ONBOARDING_STEPS, DEPLOYMENT_MODES, pickLang, apiKeyEnvVar, validateStep, assembleOnboarding, providerChoices, } from './onboarding.js';
@@ -8,6 +8,16 @@
8
8
  * 模型参数(contextWindow / maxTokens)为**参考值**,以厂商文档为准;
9
9
  * 表单允许逐字段覆盖,错了不致命(只影响路由与截断预算)。
10
10
  *
11
+ * 取值口径(2026-11-20 按各厂商官方文档逐项核对):
12
+ * - 只写官方文档明写的数字;「1M / 128K」这类简称按 1048576 / 131072 换算。
13
+ * - 官方只给「输入 X / 输出 Y」两条独立上限时,允许折成总窗口 `X + Y` 写入
14
+ * `contextWindow`(分配器的不变量是 input+output ≤ 窗口),但必须在条目注释里标明折算依据。
15
+ * - 官方未公布逐模型输出上限的厂商(xAI / Mistral / 硅基流动 / Ollama 等),
16
+ * `maxTokens` 留空 —— 不填保守估算值,避免用一个假上限收紧截断预算。
17
+ * - `maxTokens` 必须小于 `contextWindow`:分配器按「input+output ≤ contextWindow」硬预留输出,
18
+ * 输出上限等于整窗时(如 Spark 的低窗口档、豆包 turbo)同样留空,否则输入预算归零。
19
+ * - `models` 至少一条(config-schema 要求 `.min(1)`);`custom` 是唯一空清单模板。
20
+ *
11
21
  * @module
12
22
  */
13
23
  /** 预设中的单个模型条目(参数为参考值,可改) */
@@ -31,12 +41,16 @@ export interface ProviderPreset {
31
41
  id: string;
32
42
  /** 展示名 */
33
43
  label: string;
44
+ /** 展示名本地化(缺省回落 label;品牌名常两语同形) */
45
+ labels?: import('./i18n.js').LocalizedText;
34
46
  /** API 协议 */
35
47
  api: 'openai-completions' | 'anthropic-messages';
36
48
  /** 默认 baseUrl */
37
49
  baseUrl: string;
38
50
  /** 建议的 apiKey 环境变量名(表单提示用,非绑定) */
39
51
  apiKeyEnvHint: string;
52
+ /** 「去哪拿 key」提示(向导用;缺省回落 docsUrl) */
53
+ keyHints?: import('./i18n.js').LocalizedText;
40
54
  /** 厂商文档链接 */
41
55
  docsUrl?: string;
42
56
  /** 预置模型清单(参考值) */