@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,32 @@
1
+ /**
2
+ * RegistryDatabase — OCTOPI_HOME/registry.db
3
+ *
4
+ * 租户与定义面的权威数据(arch/multi-tenancy.md §3)。单机起步落在 gateway 进程内
5
+ * (Q12),API 按服务化契约设计——分布式时迁 C 机服务、调用面不变。
6
+ */
7
+ import type { DatabaseSync } from 'node:sqlite';
8
+ export interface RegistryDatabaseOptions {
9
+ dbPath?: string;
10
+ wal?: boolean;
11
+ busyTimeoutMs?: number;
12
+ }
13
+ export interface RegistryPaths {
14
+ dbPath: string;
15
+ }
16
+ /**
17
+ * 解析 registry 数据面路径
18
+ *
19
+ * @param octopiHome - OCTOPI_HOME 绝对路径
20
+ */
21
+ export declare function resolveRegistryPaths(octopiHome: string): RegistryPaths;
22
+ export declare class RegistryDatabase {
23
+ private db;
24
+ private constructor();
25
+ /**
26
+ * 打开/创建 registry.db(Node >= 24 node:sqlite)
27
+ */
28
+ static create(options?: RegistryDatabaseOptions): Promise<RegistryDatabase>;
29
+ private createTables;
30
+ get raw(): DatabaseSync;
31
+ close(): void;
32
+ }
@@ -0,0 +1,142 @@
1
+ /**
2
+ * RegistryDatabase — OCTOPI_HOME/registry.db
3
+ *
4
+ * 租户与定义面的权威数据(arch/multi-tenancy.md §3)。单机起步落在 gateway 进程内
5
+ * (Q12),API 按服务化契约设计——分布式时迁 C 机服务、调用面不变。
6
+ */
7
+ import { mkdir } from 'node:fs/promises';
8
+ import { dirname, join } from 'node:path';
9
+ /**
10
+ * 解析 registry 数据面路径
11
+ *
12
+ * @param octopiHome - OCTOPI_HOME 绝对路径
13
+ */
14
+ export function resolveRegistryPaths(octopiHome) {
15
+ return { dbPath: join(octopiHome, 'registry.db') };
16
+ }
17
+ export class RegistryDatabase {
18
+ db;
19
+ constructor(db) {
20
+ this.db = db;
21
+ }
22
+ /**
23
+ * 打开/创建 registry.db(Node >= 24 node:sqlite)
24
+ */
25
+ static async create(options) {
26
+ let DatabaseSyncCtor;
27
+ try {
28
+ const mod = await import('node:sqlite');
29
+ DatabaseSyncCtor = mod.DatabaseSync;
30
+ }
31
+ catch {
32
+ throw new Error(`RegistryDatabase requires Node.js >= 24 built-in "node:sqlite". process.version=${process.version}`);
33
+ }
34
+ const dbPath = options?.dbPath ?? ':memory:';
35
+ if (dbPath !== ':memory:') {
36
+ await mkdir(dirname(dbPath), { recursive: true });
37
+ }
38
+ const db = new DatabaseSyncCtor(dbPath, {
39
+ timeout: options?.busyTimeoutMs ?? 5000,
40
+ enableForeignKeyConstraints: false,
41
+ });
42
+ if (options?.wal !== false) {
43
+ db.exec('PRAGMA journal_mode = WAL');
44
+ }
45
+ const rdb = new RegistryDatabase(db);
46
+ rdb.createTables();
47
+ return rdb;
48
+ }
49
+ createTables() {
50
+ this.db.exec(`
51
+ CREATE TABLE IF NOT EXISTS tenants (
52
+ tenant_id TEXT PRIMARY KEY,
53
+ name TEXT NOT NULL UNIQUE,
54
+ created_at INTEGER NOT NULL
55
+ );
56
+
57
+ CREATE TABLE IF NOT EXISTS users (
58
+ user_id TEXT PRIMARY KEY,
59
+ tenant_id TEXT NOT NULL,
60
+ name TEXT NOT NULL UNIQUE,
61
+ is_platform_admin INTEGER NOT NULL DEFAULT 0,
62
+ created_at INTEGER NOT NULL
63
+ );
64
+
65
+ CREATE TABLE IF NOT EXISTS agents (
66
+ agent_id TEXT PRIMARY KEY,
67
+ tenant_id TEXT NOT NULL,
68
+ owner_user_id TEXT NOT NULL,
69
+ visibility TEXT NOT NULL DEFAULT 'private',
70
+ name TEXT NOT NULL,
71
+ definition TEXT NOT NULL DEFAULT '{}',
72
+ home_ref TEXT,
73
+ created_at INTEGER NOT NULL,
74
+ updated_at INTEGER NOT NULL
75
+ );
76
+ CREATE UNIQUE INDEX IF NOT EXISTS idx_agents_tenant_name
77
+ ON agents(tenant_id, name);
78
+
79
+ CREATE TABLE IF NOT EXISTS bindings (
80
+ binding_id TEXT PRIMARY KEY,
81
+ tenant_id TEXT NOT NULL,
82
+ platform TEXT NOT NULL,
83
+ identity TEXT NOT NULL,
84
+ agent_id TEXT NOT NULL,
85
+ session_policy TEXT NOT NULL DEFAULT 'per-user',
86
+ created_at INTEGER NOT NULL,
87
+ UNIQUE (tenant_id, platform, identity)
88
+ );
89
+
90
+ CREATE TABLE IF NOT EXISTS mounts (
91
+ mount_id TEXT PRIMARY KEY,
92
+ tenant_id TEXT NOT NULL,
93
+ consumer_type TEXT NOT NULL,
94
+ consumer_id TEXT NOT NULL,
95
+ source_type TEXT NOT NULL,
96
+ source_id TEXT NOT NULL,
97
+ agent_ref TEXT,
98
+ created_at INTEGER NOT NULL,
99
+ UNIQUE (tenant_id, consumer_type, consumer_id, source_type, source_id)
100
+ );
101
+
102
+ CREATE TABLE IF NOT EXISTS knowledge_sources (
103
+ source_id TEXT PRIMARY KEY,
104
+ scope TEXT NOT NULL,
105
+ tenant_id TEXT,
106
+ name TEXT NOT NULL,
107
+ created_at INTEGER NOT NULL
108
+ );
109
+
110
+ CREATE TABLE IF NOT EXISTS auth_tokens (
111
+ token TEXT PRIMARY KEY,
112
+ user_id TEXT NOT NULL,
113
+ created_at INTEGER NOT NULL
114
+ );
115
+ `);
116
+ // mounts.agent_ref(T3b):session 挂载的反物化锚(消费会话所属 agent);
117
+ // 存量库补列
118
+ const mountCols = this.db.prepare('PRAGMA table_info(mounts)').all();
119
+ if (!mountCols.some((c) => c.name === 'agent_ref')) {
120
+ this.db.exec('ALTER TABLE mounts ADD COLUMN agent_ref TEXT');
121
+ }
122
+ // 密码认证面(product-onboarding.md §6):users 补 scrypt 列、auth_tokens 补过期列;
123
+ // 存量库补列(同 agent_ref 先例;NULL = 无密码/不过期,兼容存量)
124
+ const userCols = this.db.prepare('PRAGMA table_info(users)').all();
125
+ if (!userCols.some((c) => c.name === 'password_hash')) {
126
+ this.db.exec('ALTER TABLE users ADD COLUMN password_hash TEXT');
127
+ }
128
+ if (!userCols.some((c) => c.name === 'password_salt')) {
129
+ this.db.exec('ALTER TABLE users ADD COLUMN password_salt TEXT');
130
+ }
131
+ const tokenCols = this.db.prepare('PRAGMA table_info(auth_tokens)').all();
132
+ if (!tokenCols.some((c) => c.name === 'expires_at')) {
133
+ this.db.exec('ALTER TABLE auth_tokens ADD COLUMN expires_at INTEGER');
134
+ }
135
+ }
136
+ get raw() {
137
+ return this.db;
138
+ }
139
+ close() {
140
+ this.db.close();
141
+ }
142
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Registry — 租户与定义面(arch/multi-tenancy.md)
3
+ *
4
+ * 拥有:Tenant / User / Agent 定义 / Binding(渠道路由)/ Mount(知识挂载)。
5
+ * 所有权锚=tenantId;「租户内是引用,跨租户是集成」。
6
+ */
7
+ export * from './types.js';
8
+ export * from './db.js';
9
+ export * from './service.js';
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Registry — 租户与定义面(arch/multi-tenancy.md)
3
+ *
4
+ * 拥有:Tenant / User / Agent 定义 / Binding(渠道路由)/ Mount(知识挂载)。
5
+ * 所有权锚=tenantId;「租户内是引用,跨租户是集成」。
6
+ */
7
+ export * from './types.js';
8
+ export * from './db.js';
9
+ export * from './service.js';
@@ -0,0 +1,381 @@
1
+ /**
2
+ * RegistryService — 租户与定义面服务(arch/multi-tenancy.md)。
3
+ *
4
+ * 核心原则:**租户内是「引用」,跨租户是「集成」**——租户内自由(互委派/共 session/
5
+ * 共挂载),跨租户一律不穿透。所有权锚=tenantId;ownerUserId=管理归属;visibility
6
+ * 决定租户内可见性。
7
+ *
8
+ * Q12:单机起步(gateway 进程内 + registry.db),API 按服务化契约设计——分布式时
9
+ * 迁 C 机服务、调用面不变。
10
+ */
11
+ import type { RegistryDatabaseOptions } from './db.js';
12
+ import type { AgentId, AuthToken, AgentRecord, AgentVisibility, Binding, BindingId, KnowledgeSource, Mount, MountConsumerType, MountId, MountSourceType, SessionPolicy, Tenant, TenantId, User, UserId } from './types.js';
13
+ export interface RegisterUserInput {
14
+ name: string;
15
+ }
16
+ export interface CreateAgentInput {
17
+ tenantId: TenantId;
18
+ ownerUserId: UserId;
19
+ name: string;
20
+ /** 定义 JSON 文本(config/persona/skills 引用);须为合法 JSON */
21
+ definition?: string;
22
+ visibility?: AgentVisibility;
23
+ homeRef?: string;
24
+ }
25
+ export interface UpdateAgentInput {
26
+ agentId: AgentId;
27
+ /** 操作者:须为 owner 或平台 admin */
28
+ viewerUserId: UserId;
29
+ patch: {
30
+ name?: string;
31
+ definition?: string;
32
+ visibility?: AgentVisibility;
33
+ homeRef?: string | null;
34
+ };
35
+ }
36
+ export interface CreateBindingInput {
37
+ tenantId: TenantId;
38
+ platform: string;
39
+ identity: string;
40
+ agentId: AgentId;
41
+ sessionPolicy?: SessionPolicy;
42
+ }
43
+ export interface CreateMountInput {
44
+ tenantId: TenantId;
45
+ consumerType: MountConsumerType;
46
+ consumerId: string;
47
+ sourceType: MountSourceType;
48
+ sourceId: string;
49
+ /** session 挂载必填:反物化锚(消费会话所属 agent) */
50
+ agentRef?: string;
51
+ }
52
+ export interface CreateKnowledgeSourceInput {
53
+ scope: 'platform' | 'tenant';
54
+ /** scope=tenant 时必填 */
55
+ tenantId?: TenantId;
56
+ name: string;
57
+ /**
58
+ * 关联的知识面行 id(knowledge.db `knowledge_sources.id`)。
59
+ * 受管注册入口先在知识面建档、再以同一 id 登记所有权(定义面 ↔ 执法面链接);
60
+ * 缺省自生成(纯定义面登记,暂无知识面行)。
61
+ */
62
+ sourceId?: string;
63
+ }
64
+ export declare class RegistryService {
65
+ private db;
66
+ private constructor();
67
+ /**
68
+ * 创建 RegistryService
69
+ *
70
+ * @param options - 透传 RegistryDatabase 选项(dbPath/wal/busyTimeoutMs)
71
+ */
72
+ static create(options?: RegistryDatabaseOptions): Promise<RegistryService>;
73
+ close(): void;
74
+ /**
75
+ * 注册用户(一用户=一租户策略):建 tenant + user(1:1)。
76
+ * 首个注册用户为平台 admin(Q13)。
77
+ *
78
+ * @param input - name(用户名/租户名,全局唯一)
79
+ * @returns 新建的 tenant 与 user
80
+ */
81
+ registerUser(input: RegisterUserInput): {
82
+ tenant: Tenant;
83
+ user: User;
84
+ };
85
+ /**
86
+ * 查询用户
87
+ *
88
+ * @param userId - 用户 id
89
+ */
90
+ getUser(userId: UserId): User | null;
91
+ /**
92
+ * 按用户名查询(MVP 登录面:token 会话 + 名称直登,口令/SSO 属 P3)。
93
+ *
94
+ * @param name - 用户名(全局唯一)
95
+ */
96
+ getUserByName(name: string): User | null;
97
+ /**
98
+ * 创建 agent。所有权锚=tenantId;owner 须属于该租户。
99
+ *
100
+ * @param input - 租户/owner/名称/定义/可见性
101
+ */
102
+ createAgent(input: CreateAgentInput): AgentRecord;
103
+ /**
104
+ * 列出 viewer 可见的 agent:private=仅 owner;tenant=租户共享。
105
+ *
106
+ * @param input - 租户与查看者
107
+ */
108
+ listAgents(input: {
109
+ tenantId: TenantId;
110
+ viewerUserId: UserId;
111
+ }): AgentRecord[];
112
+ /**
113
+ * 查询知识源定义(不做可见性过滤——管理面)。
114
+ *
115
+ * @param sourceId - 知识面行 id(knowledge.db id)
116
+ */
117
+ getKnowledgeSource(sourceId: string): KnowledgeSource | null;
118
+ /**
119
+ * 列知识源定义(T3b 管理面):platform 库 + 本租户库;平台 admin 全量。
120
+ *
121
+ * @param input - 调用方租户 / admin
122
+ */
123
+ listKnowledgeSources(input: {
124
+ viewerTenantId: TenantId;
125
+ isPlatformAdmin: boolean;
126
+ }): KnowledgeSource[];
127
+ /**
128
+ * 知识源写权限断言(platform 库=平台 admin;tenant 库=本租户)。返回记录供调用方使用。
129
+ *
130
+ * @param input - sourceId + 调用方租户/admin
131
+ */
132
+ assertKnowledgeSourceAccess(input: {
133
+ sourceId: string;
134
+ viewerTenantId: TenantId;
135
+ isPlatformAdmin: boolean;
136
+ }): KnowledgeSource;
137
+ /**
138
+ * 查询 agent(不做可见性过滤——调用方按需用 listAgents)。
139
+ *
140
+ * @param agentId - agent id
141
+ */
142
+ getAgent(agentId: AgentId): AgentRecord | null;
143
+ /**
144
+ * 列出全部 agent(宿主管理面:启动装载 / 对账;租户过滤的可见列表用 listAgents)。
145
+ */
146
+ listAllAgents(): AgentRecord[];
147
+ /**
148
+ * 租户是否存在(渠道锚启动校验用)。
149
+ *
150
+ * @param tenantId - 租户 id
151
+ */
152
+ hasTenant(tenantId: TenantId): boolean;
153
+ /**
154
+ * 更新 agent(写权限:owner 或平台 admin)。
155
+ *
156
+ * @param input - agentId + viewerUserId + 变更补丁
157
+ */
158
+ updateAgent(input: UpdateAgentInput): AgentRecord;
159
+ /**
160
+ * 删除 agent(写权限:owner 或平台 admin)。
161
+ *
162
+ * @param input - agentId + viewerUserId
163
+ * @returns 是否删除了记录
164
+ */
165
+ deleteAgent(input: {
166
+ agentId: AgentId;
167
+ viewerUserId: UserId;
168
+ }): boolean;
169
+ /**
170
+ * 创建渠道绑定(路由真相源)。agent 须属于同租户(挂载/绑定不出租户)。
171
+ *
172
+ * @param input - 租户/平台/身份/agent/会话策略
173
+ */
174
+ createBinding(input: CreateBindingInput): Binding;
175
+ /**
176
+ * 解析渠道绑定(§2.3 ② 绑定解析)。
177
+ *
178
+ * @param input - 租户/平台/身份
179
+ */
180
+ resolveBinding(input: {
181
+ tenantId: TenantId;
182
+ platform: string;
183
+ identity: string;
184
+ }): Binding | null;
185
+ /**
186
+ * 创建挂载(租户内 consumer→source)。source 须为 platform 公共或同租户私有。
187
+ *
188
+ * @param input - 租户/消费方/资产
189
+ */
190
+ createMount(input: CreateMountInput): Mount;
191
+ /**
192
+ * 可见知识源集合(§6 检索上下文):挂载库 ∪ 本租户公共 ∪ platform 公共。
193
+ *
194
+ * @param input - 租户 + 消费方
195
+ */
196
+ listVisibleSources(input: {
197
+ tenantId: TenantId;
198
+ consumerType: MountConsumerType;
199
+ consumerId: string;
200
+ }): KnowledgeSource[];
201
+ /**
202
+ * 创建知识源(platform 公共 / tenant 私有)。
203
+ *
204
+ * @param input - scope/tenantId/name
205
+ */
206
+ createKnowledgeSource(input: CreateKnowledgeSourceInput): KnowledgeSource;
207
+ /**
208
+ * 删除知识源定义(连带删除其挂载)。platform 库仅平台 admin;tenant 库限本租户。
209
+ *
210
+ * @param input - sourceId + 调用方租户/admin
211
+ * @returns 是否删除了记录
212
+ */
213
+ deleteKnowledgeSource(input: {
214
+ sourceId: string;
215
+ viewerTenantId: TenantId;
216
+ isPlatformAdmin: boolean;
217
+ }): boolean;
218
+ /**
219
+ * 列挂载(按消费方或资产过滤;租户收口——platform 库挂载可见,他租户挂载不出界)。
220
+ *
221
+ * @param input - 租户 + 过滤条件
222
+ */
223
+ listMounts(input: {
224
+ tenantId: TenantId;
225
+ consumerType?: MountConsumerType;
226
+ consumerId?: string;
227
+ sourceId?: string;
228
+ }): Mount[];
229
+ /**
230
+ * 查询挂载(管理面)。
231
+ *
232
+ * @param mountId - 挂载 id
233
+ */
234
+ getMount(mountId: MountId): Mount | null;
235
+ /**
236
+ * 删除挂载(租户收口:本租户挂载才可删)。
237
+ *
238
+ * @param input - mountId + 调用方租户
239
+ * @returns 是否删除了记录
240
+ */
241
+ deleteMount(input: {
242
+ mountId: MountId;
243
+ tenantId: TenantId;
244
+ }): boolean;
245
+ /**
246
+ * 签发会话 token(MVP 鉴权:token 会话;企业 SSO 属 P3)。
247
+ *
248
+ * @param userId - 用户 id
249
+ * @param ttlMs - 可选有效期(毫秒);缺省不过期(兼容存量语义)
250
+ * @returns 不透明 token(存储于 registry.db auth_tokens)
251
+ */
252
+ issueToken(userId: UserId, ttlMs?: number): AuthToken;
253
+ /**
254
+ * 解析会话 token → 用户(过期 token 视为无效并顺手清除)。
255
+ *
256
+ * @param token - Bearer token
257
+ */
258
+ resolveToken(token: string): User | null;
259
+ /**
260
+ * 撤销会话 token。
261
+ *
262
+ * @param token - Bearer token
263
+ * @returns 是否撤销了记录
264
+ */
265
+ revokeToken(token: string): boolean;
266
+ /**
267
+ * 设置/更新用户密码(scrypt + 随机盐;节点内置,不引第三方依赖)。
268
+ *
269
+ * 异步 scrypt 走线程池,不阻塞事件循环(评审 M5)。
270
+ *
271
+ * @param userId - 用户 id
272
+ * @param password - 明文密码(两遍确认等 UX 由调用方负责)
273
+ * @throws registry_user_not_found 用户不存在
274
+ */
275
+ setUserPassword(userId: UserId, password: string): Promise<void>;
276
+ /**
277
+ * 用户是否已设密码(路由层据此决定是否强制验密)。
278
+ *
279
+ * @param userId - 用户 id
280
+ */
281
+ hasPassword(userId: UserId): boolean;
282
+ /**
283
+ * 密码登录校验(product-onboarding.md §6:身份 = (tenant, name) 二元组 + 密码)。
284
+ *
285
+ * tenant 显式给定时按二元组定位(多租户撞名消歧);缺省按用户名唯一定位
286
+ * (registerUser 一用户一租户的形态)。返回 null 的一切路径**等耗时**(评审 M3:
287
+ * 未知用户/无密码用户也跑一次等价 KDF,抹平时序侧信道);比较用 timingSafeEqual。
288
+ * 无密码用户返回 null——免密语义只属于 loopback 名登录兼容路径。
289
+ *
290
+ * @param input - 用户名 + 明文密码(可选组织/租户名)
291
+ * @returns 校验通过的用户;失败 null
292
+ */
293
+ authenticate(input: {
294
+ tenant?: string;
295
+ name: string;
296
+ password: string;
297
+ }): Promise<User | null>;
298
+ /**
299
+ * 在既有租户内创建用户(②③部署模式的成员面;registerUser「一用户一租户」之外的补充入口)。
300
+ *
301
+ * 插入 + 设密同事务(m7 对称 registerUser):设密失败不留「无密码半用户」。
302
+ *
303
+ * @param input - tenantId + name + 可选 password / isPlatformAdmin
304
+ * @returns 新建用户
305
+ * @throws registry_tenant_not_found / registry_password 相关
306
+ */
307
+ createUserInTenant(input: {
308
+ tenantId: TenantId;
309
+ name: string;
310
+ password?: string;
311
+ isPlatformAdmin?: boolean;
312
+ }): Promise<User>;
313
+ /**
314
+ * 按 (tenantId, name) 取用户(部署模式播种的精确查找,M10;不做全局名碰撞误配)。
315
+ *
316
+ * @param tenantId - 租户 id
317
+ * @param name - 用户名
318
+ */
319
+ getUserInTenant(tenantId: TenantId, name: string): User | null;
320
+ /**
321
+ * 幂等确保租户存在(部署模式播种用;registerUser「一用户一租户」之外的主机侧配置面)。
322
+ *
323
+ * @param name - 租户(组织)名
324
+ * @param explicitId - 显式租户 id(personal/②模式用 'default' = core DEFAULT_TENANT_ID 语义,
325
+ * 与 config agent 的 default 域同 ID 空间;缺省自生成 uuid)
326
+ * @returns 租户(已存在则返回既有;同 id 撞异名 fail-loud)
327
+ * @throws registry_tenant_id_conflict 显式 id 已被不同名占用
328
+ */
329
+ ensureTenant(name: string, explicitId?: string): Tenant;
330
+ /**
331
+ * 列出租户内绑定(渠道路由真相源)。
332
+ *
333
+ * @param input - 租户
334
+ */
335
+ listBindings(input: {
336
+ tenantId: TenantId;
337
+ }): Binding[];
338
+ /**
339
+ * 查询单条绑定(管理面)。
340
+ *
341
+ * @param bindingId - 绑定 id
342
+ */
343
+ getBinding(bindingId: BindingId): Binding | null;
344
+ /**
345
+ * 更新绑定(换目标 agent / 会话策略)。绑定是租户资产:tenantId 域内可管;
346
+ * 换目标 agent 时重验租户内约束(与 createBinding 同闸)。
347
+ *
348
+ * @param input - bindingId + 租户域 + 变更补丁
349
+ */
350
+ updateBinding(input: {
351
+ bindingId: BindingId;
352
+ tenantId: TenantId;
353
+ patch: {
354
+ agentId?: AgentId;
355
+ sessionPolicy?: SessionPolicy;
356
+ };
357
+ }): Binding;
358
+ /**
359
+ * 删除绑定(租户域内)。行不存在或不属本租户 = false(幂等重试不炸)。
360
+ *
361
+ * @param input - bindingId + 租户域
362
+ * @returns 是否删除了记录
363
+ */
364
+ deleteBinding(input: {
365
+ bindingId: BindingId;
366
+ tenantId: TenantId;
367
+ }): boolean;
368
+ private requireBinding;
369
+ /**
370
+ * 同租户断言(§8 委派/参与边界的执行点):一组 agent 必须同属一个租户。
371
+ *
372
+ * @param agentIds - 参与 agent 列表
373
+ * @returns 共同租户 id
374
+ */
375
+ assertSameTenant(agentIds: readonly AgentId[]): TenantId;
376
+ private countUsers;
377
+ private requireTenant;
378
+ private requireAgent;
379
+ private requireSource;
380
+ private requireManageAuth;
381
+ }