@octopi-agent/engine 0.98.4 → 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 (493) 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 +40 -6
  23. package/dist/config-schema/agent.js +44 -6
  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 +12 -37
  27. package/dist/config-schema/context.js +10 -31
  28. package/dist/config-schema/engine.d.ts +140 -164
  29. package/dist/config-schema/engine.js +10 -7
  30. package/dist/config-schema/governance.d.ts +20 -2
  31. package/dist/config-schema/governance.js +18 -3
  32. package/dist/config-schema/models.d.ts +10 -12
  33. package/dist/config-schema/models.js +16 -3
  34. package/dist/config-schema/run.d.ts +6 -2
  35. package/dist/config-schema/run.js +12 -2
  36. package/dist/config-schema/shared.d.ts +1 -3
  37. package/dist/config-schema/shared.js +4 -4
  38. package/dist/config-schema/substrate.d.ts +19 -88
  39. package/dist/config-schema/substrate.js +30 -107
  40. package/dist/config.d.ts +161 -123
  41. package/dist/config.js +109 -7
  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 +11 -0
  49. package/dist/harness/activation/inbox.d.ts +3 -3
  50. package/dist/harness/activation/inbox.js +3 -3
  51. package/dist/harness/activation/index.d.ts +1 -0
  52. package/dist/harness/activation/run-backend.d.ts +92 -0
  53. package/dist/harness/activation/run-backend.js +16 -0
  54. package/dist/harness/activation/run-protocol.d.ts +392 -0
  55. package/dist/harness/activation/run-protocol.js +19 -0
  56. package/dist/harness/activation/runtime.d.ts +33 -0
  57. package/dist/harness/activation/runtime.js +130 -31
  58. package/dist/harness/activation/types.d.ts +20 -3
  59. package/dist/harness/agent/builder.d.ts +36 -3
  60. package/dist/harness/agent/builder.js +206 -46
  61. package/dist/harness/agent/config-bridge.d.ts +10 -1
  62. package/dist/harness/agent/config-bridge.js +24 -5
  63. package/dist/harness/agent/config-integrity.js +19 -2
  64. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  65. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  66. package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
  67. package/dist/harness/agent/wire-agent-builder.js +35 -9
  68. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  69. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  70. package/dist/harness/capabilities/document/factory.js +1 -0
  71. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  72. package/dist/harness/capabilities/document/port.js +6 -3
  73. package/dist/harness/capabilities/document/types.d.ts +5 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  76. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  77. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  78. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
  80. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  87. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  89. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
  90. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
  91. package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
  92. package/dist/harness/collaboration/delegation/child-run.js +38 -6
  93. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  94. package/dist/harness/collaboration/delegation/index.js +1 -1
  95. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  96. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  97. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  98. package/dist/harness/collaboration/delegation/service.d.ts +11 -4
  99. package/dist/harness/collaboration/delegation/service.js +35 -13
  100. package/dist/harness/collaboration/delegation/store.d.ts +4 -0
  101. package/dist/harness/collaboration/delegation/store.js +3 -1
  102. package/dist/harness/collaboration/delegation/types.d.ts +34 -2
  103. package/dist/harness/collaboration/delegation/types.js +22 -0
  104. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  105. package/dist/harness/collaboration/delegation/wiring.js +12 -1
  106. package/dist/harness/context/budget-allocator.d.ts +26 -18
  107. package/dist/harness/context/budget-allocator.js +67 -32
  108. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
  109. package/dist/harness/context/capabilities/compact/engine.js +296 -160
  110. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  111. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  112. package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
  113. package/dist/harness/context/capabilities/compact/index.js +5 -1
  114. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  115. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  116. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  117. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  118. package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
  119. package/dist/harness/context/capabilities/compact/types.js +11 -1
  120. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  121. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  122. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  123. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  124. package/dist/harness/context/capabilities/summary/port.js +0 -1
  125. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  126. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  127. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  128. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  129. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  130. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  131. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  132. package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
  133. package/dist/harness/context/constitution/default-agents.md +85 -0
  134. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  135. package/dist/harness/context/context-size-ledger.js +243 -0
  136. package/dist/harness/context/default-context-engine.d.ts +290 -120
  137. package/dist/harness/context/default-context-engine.js +1555 -764
  138. package/dist/harness/context/index.d.ts +3 -2
  139. package/dist/harness/context/index.js +2 -1
  140. package/dist/harness/context/layer-health.d.ts +4 -0
  141. package/dist/harness/context/layer-health.js +4 -0
  142. package/dist/harness/context/layer-types.d.ts +72 -0
  143. package/dist/harness/context/layer-types.js +87 -2
  144. package/dist/harness/context/layers.d.ts +17 -15
  145. package/dist/harness/context/layers.js +54 -17
  146. package/dist/harness/context/message-selector.d.ts +10 -8
  147. package/dist/harness/context/message-selector.js +49 -27
  148. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  149. package/dist/harness/context/prefix-fingerprint.js +52 -0
  150. package/dist/harness/context/summarize.d.ts +2 -2
  151. package/dist/harness/context/summarize.js +27 -2
  152. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  153. package/dist/harness/context/system-prompt-assembler.js +7 -3
  154. package/dist/harness/context/token-constants.d.ts +8 -6
  155. package/dist/harness/context/token-constants.js +8 -7
  156. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  157. package/dist/harness/context/token-estimate-fns.js +85 -66
  158. package/dist/harness/context/token-estimator.d.ts +27 -12
  159. package/dist/harness/context/token-estimator.js +120 -66
  160. package/dist/harness/context/token-segments.d.ts +88 -0
  161. package/dist/harness/context/token-segments.js +103 -0
  162. package/dist/harness/context/tool-result-aging.d.ts +109 -16
  163. package/dist/harness/context/tool-result-aging.js +220 -55
  164. package/dist/harness/context/tool-result-body.js +2 -0
  165. package/dist/harness/context/transform/anchors.d.ts +66 -0
  166. package/dist/harness/context/transform/anchors.js +125 -0
  167. package/dist/harness/context/transform/fold.d.ts +56 -0
  168. package/dist/harness/context/transform/fold.js +135 -0
  169. package/dist/harness/context/transform/migrate.d.ts +41 -0
  170. package/dist/harness/context/transform/migrate.js +69 -0
  171. package/dist/harness/context/transform/types.d.ts +129 -0
  172. package/dist/harness/context/transform/types.js +19 -0
  173. package/dist/harness/context/turn-envelope.d.ts +6 -3
  174. package/dist/harness/context/types.d.ts +196 -119
  175. package/dist/harness/context/types.js +25 -1
  176. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  177. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  178. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  179. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  180. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  181. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  182. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  183. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
  184. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  185. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  186. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  187. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  188. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  189. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  190. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  191. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  192. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  193. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  194. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  195. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  196. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  197. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  198. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  199. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  200. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  201. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  202. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  203. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  204. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  205. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  206. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  207. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  208. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  209. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  210. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  211. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  212. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  213. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  214. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  215. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  216. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
  217. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
  218. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  219. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  220. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  221. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  222. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
  223. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
  224. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  225. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  226. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  227. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  228. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  229. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  230. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
  231. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
  232. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
  233. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
  234. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
  235. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
  236. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
  237. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  238. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  239. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  240. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  241. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  242. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  243. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  244. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  245. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  246. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  247. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  248. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
  249. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  250. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  251. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  252. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  253. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  254. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  255. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  256. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  257. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  258. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  259. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  260. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  261. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
  262. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  263. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  264. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  265. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  266. package/dist/harness/governance/credentials/db.d.ts +9 -0
  267. package/dist/harness/governance/credentials/db.js +122 -31
  268. package/dist/harness/governance/credentials/store.d.ts +68 -7
  269. package/dist/harness/governance/credentials/store.js +177 -64
  270. package/dist/harness/governance/credentials/types.d.ts +13 -2
  271. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  272. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  273. package/dist/harness/governance/index.d.ts +1 -0
  274. package/dist/harness/governance/index.js +1 -0
  275. package/dist/harness/governance/registry/db.d.ts +32 -0
  276. package/dist/harness/governance/registry/db.js +142 -0
  277. package/dist/harness/governance/registry/index.d.ts +9 -0
  278. package/dist/harness/governance/registry/index.js +9 -0
  279. package/dist/harness/governance/registry/service.d.ts +381 -0
  280. package/dist/harness/governance/registry/service.js +825 -0
  281. package/dist/harness/governance/registry/types.d.ts +77 -0
  282. package/dist/harness/governance/registry/types.js +7 -0
  283. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  284. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  285. package/dist/harness/governance/security/default-security-guard.js +12 -1
  286. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  287. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  288. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  289. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  290. package/dist/harness/index.d.ts +17 -15
  291. package/dist/harness/index.js +9 -9
  292. package/dist/harness/knowledge/boot-config.d.ts +57 -0
  293. package/dist/harness/knowledge/boot-config.js +52 -0
  294. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  295. package/dist/harness/knowledge/client.d.ts +77 -9
  296. package/dist/harness/knowledge/client.js +95 -24
  297. package/dist/harness/knowledge/db.d.ts +16 -0
  298. package/dist/harness/knowledge/db.js +112 -41
  299. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  300. package/dist/harness/knowledge/describe-sample.js +58 -0
  301. package/dist/harness/knowledge/describe.d.ts +8 -0
  302. package/dist/harness/knowledge/describe.js +18 -2
  303. package/dist/harness/knowledge/engine-thread.js +11 -7
  304. package/dist/harness/knowledge/grounding.js +7 -2
  305. package/dist/harness/knowledge/http-app.d.ts +15 -0
  306. package/dist/harness/knowledge/http-app.js +117 -25
  307. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  308. package/dist/harness/knowledge/http-bridge.js +19 -0
  309. package/dist/harness/knowledge/http-params.d.ts +18 -0
  310. package/dist/harness/knowledge/http-params.js +24 -0
  311. package/dist/harness/knowledge/index.d.ts +2 -0
  312. package/dist/harness/knowledge/index.js +1 -0
  313. package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
  314. package/dist/harness/knowledge/purge.js +5 -2
  315. package/dist/harness/knowledge/query-service.d.ts +25 -4
  316. package/dist/harness/knowledge/query-service.js +79 -43
  317. package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
  318. package/dist/harness/knowledge/query-worker-client.js +8 -3
  319. package/dist/harness/knowledge/query-worker.js +9 -5
  320. package/dist/harness/knowledge/read-http.d.ts +2 -0
  321. package/dist/harness/knowledge/read-http.js +14 -3
  322. package/dist/harness/knowledge/retriever.d.ts +1 -1
  323. package/dist/harness/knowledge/retriever.js +1 -2
  324. package/dist/harness/knowledge/serve.d.ts +14 -8
  325. package/dist/harness/knowledge/serve.js +14 -6
  326. package/dist/harness/knowledge/source-store.d.ts +101 -5
  327. package/dist/harness/knowledge/source-store.js +323 -74
  328. package/dist/harness/knowledge/start-service-process.d.ts +41 -14
  329. package/dist/harness/knowledge/start-service-process.js +67 -96
  330. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  331. package/dist/harness/knowledge/tenant-gate.js +167 -0
  332. package/dist/harness/knowledge/types.d.ts +7 -0
  333. package/dist/harness/knowledge/writer-service.d.ts +55 -11
  334. package/dist/harness/knowledge/writer-service.js +200 -30
  335. package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
  336. package/dist/harness/knowledge/writer-worker-client.js +40 -5
  337. package/dist/harness/knowledge/writer-worker.js +20 -5
  338. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  339. package/dist/harness/memory/backfill-trigger.js +19 -19
  340. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  341. package/dist/harness/memory/cognition-seeds.js +67 -0
  342. package/dist/harness/memory/cognition.d.ts +12 -3
  343. package/dist/harness/memory/cognition.js +55 -35
  344. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  345. package/dist/harness/memory/conceptualizer.js +10 -1
  346. package/dist/harness/memory/context-slice.d.ts +42 -0
  347. package/dist/harness/memory/context-slice.js +197 -0
  348. package/dist/harness/memory/health-probe.d.ts +8 -2
  349. package/dist/harness/memory/health-probe.js +10 -13
  350. package/dist/harness/memory/index.d.ts +5 -1
  351. package/dist/harness/memory/index.js +3 -1
  352. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  353. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  354. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  355. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  356. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  357. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  358. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  359. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  360. package/dist/harness/memory/types.d.ts +24 -6
  361. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  362. package/dist/harness/memory/wisdom-formation.js +85 -22
  363. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  364. package/dist/harness/memory/wisdom-gates.js +59 -19
  365. package/dist/harness/memory/wisdom.js +9 -0
  366. package/dist/harness/observability/observer/hub.d.ts +10 -0
  367. package/dist/harness/observability/observer/hub.js +120 -17
  368. package/dist/harness/observability/observer/types.d.ts +10 -6
  369. package/dist/harness/run/agent/agent.d.ts +40 -21
  370. package/dist/harness/run/agent/agent.js +67 -13
  371. package/dist/harness/run/agent/index.d.ts +1 -1
  372. package/dist/harness/run/budget/budget.d.ts +28 -10
  373. package/dist/harness/run/budget/budget.js +38 -15
  374. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  375. package/dist/harness/run/model/index.d.ts +3 -1
  376. package/dist/harness/run/model/index.js +2 -1
  377. package/dist/harness/run/model/resolver.d.ts +4 -1
  378. package/dist/harness/run/model/resolver.js +36 -2
  379. package/dist/harness/run/model/run-scope.d.ts +2 -0
  380. package/dist/harness/run/model/run-scope.js +7 -0
  381. package/dist/harness/run/model/types.d.ts +22 -5
  382. package/dist/harness/run/model/types.js +3 -2
  383. package/dist/harness/run/model/window-truth.d.ts +37 -0
  384. package/dist/harness/run/model/window-truth.js +39 -0
  385. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  386. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  387. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  388. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  389. package/dist/harness/run/reliability/run-agent.d.ts +32 -4
  390. package/dist/harness/run/reliability/run-agent.js +216 -63
  391. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  392. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  393. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  394. package/dist/harness/run/run-host.d.ts +302 -0
  395. package/dist/harness/run/run-host.js +978 -0
  396. package/dist/harness/run/run-scope.d.ts +48 -4
  397. package/dist/harness/run/run-scope.js +19 -1
  398. package/dist/harness/run/runner.d.ts +181 -39
  399. package/dist/harness/run/runner.js +654 -119
  400. package/dist/harness/session/attachments/index.d.ts +1 -0
  401. package/dist/harness/session/attachments/index.js +1 -0
  402. package/dist/harness/session/attachments/inject.d.ts +21 -10
  403. package/dist/harness/session/attachments/inject.js +76 -24
  404. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  405. package/dist/harness/session/attachments/recall-index.js +219 -0
  406. package/dist/harness/session/attachments/service.d.ts +21 -0
  407. package/dist/harness/session/attachments/service.js +258 -139
  408. package/dist/harness/session/attachments/types.d.ts +6 -0
  409. package/dist/harness/session/in-memory-store.js +13 -1
  410. package/dist/harness/session/schedules/service.d.ts +10 -2
  411. package/dist/harness/session/schedules/service.js +13 -2
  412. package/dist/harness/session/tasks/tools.js +12 -0
  413. package/dist/harness/session/transform-store.d.ts +136 -0
  414. package/dist/harness/session/transform-store.js +302 -0
  415. package/dist/harness/session/types.d.ts +11 -15
  416. package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
  417. package/dist/harness/shared/events/agent-event-map.js +3 -2
  418. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  419. package/dist/harness/shared/types/agent-definition.d.ts +7 -2
  420. package/dist/index.d.ts +16 -18
  421. package/dist/index.js +9 -10
  422. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  423. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  424. package/dist/integration/browser/camoufox.d.ts +40 -0
  425. package/dist/integration/browser/camoufox.js +80 -0
  426. package/dist/integration/browser/index.d.ts +91 -0
  427. package/dist/integration/browser/index.js +110 -0
  428. package/dist/integration/browser/install.d.ts +47 -0
  429. package/dist/integration/browser/install.js +214 -0
  430. package/dist/integration/browser/playwright.d.ts +224 -0
  431. package/dist/integration/browser/playwright.js +925 -0
  432. package/dist/integration/browser/service.d.ts +41 -0
  433. package/dist/integration/browser/service.js +181 -0
  434. package/dist/integration/browser/stealth.d.ts +42 -0
  435. package/dist/integration/browser/stealth.js +104 -0
  436. package/dist/integration/observability/metrics.d.ts +6 -6
  437. package/dist/integration/observability/metrics.js +13 -13
  438. package/dist/integration/observability/observer-bridge.js +2 -2
  439. package/dist/integration/observability/trace-collector.d.ts +5 -5
  440. package/dist/integration/observability/trace-collector.js +34 -35
  441. package/dist/integration/observability/trace-events.d.ts +3 -3
  442. package/dist/integration/observability/trace-events.js +3 -3
  443. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  444. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  445. package/dist/integration/providers/anthropic.js +41 -3
  446. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  447. package/dist/integration/providers/fetch-timeout.js +24 -0
  448. package/dist/integration/providers/openai.d.ts +8 -0
  449. package/dist/integration/providers/openai.js +48 -2
  450. package/dist/integration/providers/usage.d.ts +1 -1
  451. package/dist/integration/providers/wire-dump-diff.js +2 -1
  452. package/dist/integration/providers/wire-dump.d.ts +57 -3
  453. package/dist/integration/providers/wire-dump.js +119 -6
  454. package/dist/integration/storage/archive-manager.d.ts +20 -2
  455. package/dist/integration/storage/archive-manager.js +34 -8
  456. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  457. package/dist/integration/storage/atomic-tmp.js +36 -0
  458. package/dist/integration/storage/jsonl.d.ts +10 -1
  459. package/dist/integration/storage/jsonl.js +155 -54
  460. package/dist/integration/storage/session-index.d.ts +5 -0
  461. package/dist/integration/storage/session-index.js +25 -4
  462. package/dist/integration/tools/assemble.d.ts +50 -0
  463. package/dist/integration/tools/assemble.js +137 -0
  464. package/dist/paths.d.ts +18 -0
  465. package/dist/paths.js +36 -0
  466. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  467. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  468. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  469. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  470. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  471. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  472. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  473. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  474. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  475. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  476. package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
  477. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  478. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  479. package/package.json +14 -15
  480. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  481. package/dist/harness/context/hybrid-compressor.js +0 -159
  482. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  483. package/dist/harness/context/llm-summarizer.js +0 -249
  484. package/dist/harness/context/smart-router.d.ts +0 -75
  485. package/dist/harness/context/smart-router.js +0 -118
  486. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  487. package/dist/harness/context/truncate-compressor.js +0 -107
  488. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  489. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  490. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  491. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  492. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  493. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -56,6 +56,8 @@ export class CredentialStore {
56
56
  return CredentialStore.open({
57
57
  dbPath: paths.dbPath,
58
58
  requireBindings: options?.requireBindings,
59
+ // 这是产品自有的数据面目录(resolveCredentialPaths 产出),可以安全收紧
60
+ hardenDir: true,
59
61
  });
60
62
  }
61
63
  get database() {
@@ -77,6 +79,23 @@ export class CredentialStore {
77
79
  if (mode === 'file' && !write.secretFile?.trim()) {
78
80
  throw new Error('secretMode=file requires secretFile');
79
81
  }
82
+ // 域(§4):唯一键 (name, scope_level, scope_key)——同名分域各存各的,不互覆。
83
+ // 先校验后归一化(评审 MAJ-3):非 global 域必须显式 key;global 不得携带异域 key
84
+ const scopeLevel = write.scope?.level ?? 'global';
85
+ let scopeKey;
86
+ if (scopeLevel === 'global') {
87
+ const key = write.scope?.key?.trim();
88
+ if (key && key !== 'global') {
89
+ throw new Error('scope.level=global must not carry a tenant/agent key');
90
+ }
91
+ scopeKey = 'global';
92
+ }
93
+ else {
94
+ scopeKey = write.scope?.key?.trim() ?? '';
95
+ if (!scopeKey) {
96
+ throw new Error(`scope.level=${scopeLevel} requires scope.key (e.g. tenantId for level=tenant)`);
97
+ }
98
+ }
80
99
  let cipher = null;
81
100
  let nonce = null;
82
101
  if (mode === 'encrypted') {
@@ -85,51 +104,72 @@ export class CredentialStore {
85
104
  cipher = enc.cipher;
86
105
  nonce = enc.nonce;
87
106
  }
88
- else if (!this.hasCipher(write.name)) {
107
+ else if (!this.hasCipher(write.name, scopeLevel, scopeKey)) {
89
108
  throw new Error('secretMode=encrypted requires secretValue');
90
109
  }
91
110
  }
92
- const existing = this.get(write.name);
111
+ const existingRow = this.findByScope(write.name, scopeLevel, scopeKey);
112
+ const existing = existingRow ? rowToMeta(existingRow) : null;
93
113
  const id = existing?.id ?? `cred_${randomUUID().slice(0, 12)}`;
94
- const scopeLevel = write.scope?.level ?? 'global';
95
- const scopeKey = scopeLevel === 'global' ? 'global' : (write.scope?.key ?? 'global');
96
114
  this.db.raw
97
- .prepare(`INSERT INTO credentials (
98
- id, name, kind, description, username, header_name, header_prefix,
99
- secret_mode, secret_env, secret_cipher, secret_nonce, secret_file,
100
- scope_level, scope_key, created_at, updated_at, last_used_at, expires_at
101
- ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
102
- ON CONFLICT(name) DO UPDATE SET
103
- kind=excluded.kind,
104
- description=excluded.description,
105
- username=excluded.username,
106
- header_name=excluded.header_name,
107
- header_prefix=excluded.header_prefix,
108
- secret_mode=excluded.secret_mode,
109
- secret_env=excluded.secret_env,
110
- secret_cipher=COALESCE(excluded.secret_cipher, credentials.secret_cipher),
111
- secret_nonce=COALESCE(excluded.secret_nonce, credentials.secret_nonce),
112
- secret_file=excluded.secret_file,
113
- scope_level=excluded.scope_level,
114
- scope_key=excluded.scope_key,
115
- updated_at=excluded.updated_at,
115
+ .prepare(`INSERT INTO credentials (
116
+ id, name, kind, description, username, header_name, header_prefix,
117
+ secret_mode, secret_env, secret_cipher, secret_nonce, secret_file,
118
+ scope_level, scope_key, created_at, updated_at, last_used_at, expires_at
119
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
120
+ ON CONFLICT(name, scope_level, scope_key) DO UPDATE SET
121
+ kind=excluded.kind,
122
+ description=excluded.description,
123
+ username=excluded.username,
124
+ header_name=excluded.header_name,
125
+ header_prefix=excluded.header_prefix,
126
+ secret_mode=excluded.secret_mode,
127
+ secret_env=excluded.secret_env,
128
+ secret_cipher=COALESCE(excluded.secret_cipher, credentials.secret_cipher),
129
+ secret_nonce=COALESCE(excluded.secret_nonce, credentials.secret_nonce),
130
+ secret_file=excluded.secret_file,
131
+ updated_at=excluded.updated_at,
116
132
  expires_at=excluded.expires_at`)
117
133
  .run(id, write.name, write.kind, write.description ?? null, write.username ?? null, write.headerName ?? null, write.headerPrefix ?? null, mode, write.secretEnv ?? null, cipher, nonce, write.secretFile ?? null, scopeLevel, scopeKey, existing?.createdAt ?? now, now, existing?.lastUsedAt ?? null, write.expiresAt ?? existing?.expiresAt ?? null);
118
- return this.get(write.name);
134
+ return rowToMeta(this.findByScope(write.name, scopeLevel, scopeKey));
135
+ }
136
+ /** 按域精确定位(唯一键 (name, scope_level, scope_key)) */ findByScope(name, scopeLevel, scopeKey) {
137
+ return this.db.raw
138
+ .prepare('SELECT * FROM credentials WHERE name = ? AND scope_level = ? AND scope_key = ?')
139
+ .get(name, scopeLevel, scopeKey);
119
140
  }
120
- hasCipher(name) {
121
- const row = this.db.raw
122
- .prepare(`SELECT secret_cipher FROM credentials WHERE name = ?`)
141
+ /**
142
+ * 域内按名定位(§4 域分离):
143
+ * - 有归属租户:本租户私有(level=tenant, key=tenantId)优先——同名遮蔽平台同名;
144
+ * 平台域兜底;他租户私有对本域不存在(不泄露存在性)。
145
+ * - 无归属:**平台域**(level != tenant,含管理域 project/agent/plugin),不含任何
146
+ * 租户私有行——租户密文只经归属租户解析(MAJ-10/评审 MIN-18:unattributed 解析
147
+ * 不得成为读他租户密文的旁路)。管理面(get/list/delete)仍可不带域查看全量元数据。
148
+ */
149
+ findRow(name, tenantId) {
150
+ if (tenantId) {
151
+ return (this.findByScope(name, 'tenant', tenantId) ??
152
+ this.db.raw
153
+ .prepare(`SELECT * FROM credentials WHERE name = ? AND scope_level != 'tenant' ORDER BY created_at, rowid LIMIT 1`)
154
+ .get(name));
155
+ }
156
+ return this.db.raw
157
+ .prepare(`SELECT * FROM credentials WHERE name = ? AND scope_level != 'tenant' ORDER BY created_at, rowid LIMIT 1`)
123
158
  .get(name);
159
+ }
160
+ hasCipher(name, scopeLevel, scopeKey) {
161
+ const row = this.findByScope(name, scopeLevel, scopeKey);
124
162
  return Boolean(row?.secret_cipher);
125
163
  }
126
164
  /**
127
- * 读元数据(无密文)
165
+ * 读元数据(无密文)。
166
+ * 同名跨域(遮蔽)时:给 scope 精确定位;不给取最早登记(宿主面确定性视图)。
167
+ *
168
+ * @param name - 凭证名
169
+ * @param scope - 域(level/key);缺省不限域
128
170
  */
129
- get(name) {
130
- const row = this.db.raw
131
- .prepare(`SELECT * FROM credentials WHERE name = ?`)
132
- .get(name);
171
+ get(name, scope) {
172
+ const row = scope ? this.findByScope(name, scope.level, scope.key) : this.findRow(name);
133
173
  return row ? rowToMeta(row) : null;
134
174
  }
135
175
  list() {
@@ -138,13 +178,61 @@ export class CredentialStore {
138
178
  .all();
139
179
  return rows.map(rowToMeta);
140
180
  }
141
- delete(name) {
142
- const meta = this.get(name);
143
- if (!meta)
181
+ /**
182
+ * 删除凭证(含绑定)。同名跨域且未给 scope = 歧义 fail-loud——域唯一后
183
+ * name 不再是唯一身份,静默删错行等于数据事故。
184
+ *
185
+ * @param name - 凭证名
186
+ * @param scope - 域(level/key);缺省不限域
187
+ * @returns 是否删除了记录
188
+ */
189
+ delete(name, scope) {
190
+ const metas = this.findAll(name, scope);
191
+ if (metas.length === 0)
144
192
  return false;
145
- this.db.raw.prepare(`DELETE FROM credential_bindings WHERE credential_id = ?`).run(meta.id);
146
- const res = this.db.raw.prepare(`DELETE FROM credentials WHERE id = ?`).run(meta.id);
147
- return Number(res.changes ?? 0) > 0;
193
+ if (metas.length > 1 && !scope) {
194
+ throw new Error(`credential "${name}" matches multiple domains; pass scope to delete`);
195
+ }
196
+ let deleted = false;
197
+ for (const meta of metas) {
198
+ this.db.raw.prepare(`DELETE FROM credential_bindings WHERE credential_id = ?`).run(meta.id);
199
+ const res = this.db.raw.prepare(`DELETE FROM credentials WHERE id = ?`).run(meta.id);
200
+ deleted = deleted || Number(res.changes ?? 0) > 0;
201
+ }
202
+ return deleted;
203
+ }
204
+ /** 按名(可选域)取全部匹配行 */
205
+ findAll(name, scope) {
206
+ const rows = scope
207
+ ? [this.findByScope(name, scope.level, scope.key)].filter(Boolean)
208
+ : this.db.raw
209
+ .prepare('SELECT * FROM credentials WHERE name = ? ORDER BY created_at, rowid')
210
+ .all(name);
211
+ return rows.map((r) => rowToMeta(r));
212
+ }
213
+ /** 按名(可选域)定位唯一行;歧义 fail-loud(写路径专用) */
214
+ requireNamed(name, scope) {
215
+ const metas = this.findAll(name, scope);
216
+ if (metas.length === 0)
217
+ throw new Error(`credential not found: ${name}`);
218
+ if (metas.length > 1 && !scope) {
219
+ throw new Error(`credential "${name}" matches multiple domains; pass scope`);
220
+ }
221
+ return metas[0];
222
+ }
223
+ /**
224
+ * 用时解析为明文 secret(短命;调用方禁止日志/持久化)。
225
+ * 消费约束与 {@link resolve} 相同(SEC-3c 绑定检查、过期返回 null)。
226
+ * 供插件 secret 原语(api.secrets)等非 header 形态的消费者使用。
227
+ *
228
+ * @param name - 凭证名
229
+ * @param consumer - 消费方;绑定非空时必填
230
+ * @param options - requireBindings 覆盖
231
+ * @returns 明文 secret;无档、无密钥材料或过期时 null
232
+ * @throws 绑定策略拒绝时抛错(勿静默降级)
233
+ */
234
+ async reveal(name, consumer, options) {
235
+ return this.revealSecret(name, consumer, options);
148
236
  }
149
237
  /**
150
238
  * 用时解析为请求头(短命;调用方禁止日志)。
@@ -158,18 +246,37 @@ export class CredentialStore {
158
246
  * @throws 绑定策略拒绝时抛错(勿静默降级)
159
247
  */
160
248
  async resolve(name, consumer, options) {
161
- const row = this.db.raw
162
- .prepare(`SELECT * FROM credentials WHERE name = ?`)
163
- .get(name);
249
+ const row = this.findRow(name, options?.tenantId);
164
250
  if (!row)
165
251
  return null;
166
252
  const meta = rowToMeta(row);
253
+ const secret = await this.revealSecret(name, consumer, options, meta, row);
254
+ if (!secret)
255
+ return null;
256
+ return {
257
+ name: meta.name,
258
+ headers: defaultCredentialHeaders({
259
+ kind: meta.kind,
260
+ username: meta.username,
261
+ headerName: meta.headerName,
262
+ headerPrefix: meta.headerPrefix,
263
+ secret,
264
+ }),
265
+ };
266
+ }
267
+ /** 明文解析单一实现点(reveal/resolve 共用):材料解析 + 绑定检查 + last_used_at。 */
268
+ async revealSecret(name, consumer, options, knownMeta, knownRow) {
269
+ const row = knownRow ?? this.findRow(name, options?.tenantId);
270
+ if (!row)
271
+ return null;
272
+ const meta = knownMeta ?? rowToMeta(row);
167
273
  if (meta.expiresAt != null && meta.expiresAt < Date.now()) {
168
274
  return null;
169
275
  }
170
276
  // 只紧不松:显式 true 可收紧;false/undefined 不得覆盖 store 级 requireBindings
171
277
  const require = options?.requireBindings === true || this.requireBindings === true;
172
- const bindings = this.listBindings(name);
278
+ // 绑定检查按命中行的域定位(遮蔽场景不得串查平台同名行的绑定表)
279
+ const bindings = this.listBindings(name, meta.scope);
173
280
  if (require && bindings.length === 0) {
174
281
  throw new Error(`credential "${name}" has no bindings and requireBindings is enabled`);
175
282
  }
@@ -183,7 +290,6 @@ export class CredentialStore {
183
290
  throw new Error(`credential "${name}" is not bound to consumer ${ref.kind}:${ref.id}`);
184
291
  }
185
292
  }
186
- const kind = meta.kind;
187
293
  let secret = null;
188
294
  if (meta.secretMode === 'env' && meta.secretEnv) {
189
295
  const v = process.env[meta.secretEnv];
@@ -215,36 +321,43 @@ export class CredentialStore {
215
321
  this.db.raw
216
322
  .prepare(`UPDATE credentials SET last_used_at = ? WHERE id = ?`)
217
323
  .run(Date.now(), meta.id);
218
- return {
219
- name: meta.name,
220
- headers: defaultCredentialHeaders({
221
- kind,
222
- username: meta.username,
223
- headerName: meta.headerName,
224
- headerPrefix: meta.headerPrefix,
225
- secret,
226
- }),
227
- };
324
+ return secret;
228
325
  }
229
- bind(consumer, name) {
230
- const meta = this.get(name);
231
- if (!meta)
232
- throw new Error(`credential not found: ${name}`);
326
+ /**
327
+ * 绑定消费方。同名跨域且未给 scope = 歧义 fail-loud。
328
+ *
329
+ * @param consumer - 消费方
330
+ * @param name - 凭证名
331
+ * @param scope - 域(level/key);缺省不限域
332
+ */
333
+ bind(consumer, name, scope) {
334
+ const meta = this.requireNamed(name, scope);
233
335
  this.db.raw
234
- .prepare(`INSERT OR IGNORE INTO credential_bindings (credential_id, consumer_kind, consumer_id, created_at)
336
+ .prepare(`INSERT OR IGNORE INTO credential_bindings (credential_id, consumer_kind, consumer_id, created_at)
235
337
  VALUES (?, ?, ?, ?)`)
236
338
  .run(meta.id, consumer.kind, consumer.id, Date.now());
237
339
  }
238
- unbind(consumer, name) {
239
- const meta = this.get(name);
240
- if (!meta)
241
- return;
340
+ /**
341
+ * 解绑消费方。同名跨域且未给 scope = 歧义 fail-loud。
342
+ *
343
+ * @param consumer - 消费方
344
+ * @param name - 凭证名
345
+ * @param scope - 域(level/key);缺省不限域
346
+ */
347
+ unbind(consumer, name, scope) {
348
+ const meta = this.requireNamed(name, scope);
242
349
  this.db.raw
243
350
  .prepare(`DELETE FROM credential_bindings WHERE credential_id = ? AND consumer_kind = ? AND consumer_id = ?`)
244
351
  .run(meta.id, consumer.kind, consumer.id);
245
352
  }
246
- listBindings(name) {
247
- const meta = this.get(name);
353
+ /**
354
+ * 列绑定(按命中行 id;同名跨域给 scope 定位)。
355
+ *
356
+ * @param name - 凭证名
357
+ * @param scope - 域(level/key);缺省不限域(取最早登记)
358
+ */
359
+ listBindings(name, scope) {
360
+ const meta = this.get(name, scope);
248
361
  if (!meta)
249
362
  return [];
250
363
  const rows = this.db.raw
@@ -5,12 +5,17 @@
5
5
  */
6
6
  export type CredentialKind = 'bearer' | 'basic' | 'api_key' | 'header_map' | 'oauth2_client';
7
7
  export type SecretMode = 'env' | 'encrypted' | 'file';
8
- export type CredentialScopeLevel = 'global' | 'project' | 'agent';
8
+ /**
9
+ * 凭证域(arch/multi-tenancy.md §4 credentials 行):
10
+ * - `global` / `project` / `agent` / `plugin` = 平台域(宿主管理;租户可引)
11
+ * - `tenant` = 租户私有域(key = tenantId);租户只引自己的 + 平台域
12
+ */
13
+ export type CredentialScopeLevel = 'global' | 'project' | 'agent' | 'plugin' | 'tenant';
9
14
  export interface CredentialScopeRef {
10
15
  level: CredentialScopeLevel;
11
16
  key: string;
12
17
  }
13
- export type CredentialConsumerKind = 'knowledge_source' | 'tool' | 'agent' | 'connector';
18
+ export type CredentialConsumerKind = 'knowledge_source' | 'tool' | 'agent' | 'connector' | 'plugin';
14
19
  export interface CredentialConsumerRef {
15
20
  kind: CredentialConsumerKind;
16
21
  id: string;
@@ -68,6 +73,12 @@ export interface ResolveCredentialOptions {
68
73
  consumer?: CredentialConsumerRef | null;
69
74
  /** 覆盖 store 级 requireBindings(untrusted 严档 / 配置) */
70
75
  requireBindings?: boolean;
76
+ /**
77
+ * 请求方归属租户(§4 域分离)。
78
+ * 在场:解析域 = 平台域 ∪ 本租户私有域(私有同名**遮蔽**平台同名);他租户私有对本域不存在。
79
+ * 缺场 = 宿主面(信任边界,与 query 自报收口同语义):不限域。
80
+ */
81
+ tenantId?: string;
71
82
  }
72
83
  export declare function defaultCredentialHeaders(input: {
73
84
  kind: CredentialKind;
@@ -12,7 +12,7 @@
12
12
  */
13
13
  import type { HitlDecision } from '@octopi-agent/core/types/tools.js';
14
14
  /** Which confirm surface produced the decision */
15
- export type HitlChannel = 'high_risk' | 'effect';
15
+ export type HitlChannel = 'high_risk' | 'effect' | 'plugin_hook';
16
16
  /** Cached scope of a remembered approval */
17
17
  export type HitlCacheScope = 'session' | 'always';
18
18
  /** 非人工拒绝来源(人工决策不带此标注);用于错误面与审计如实归因 */
@@ -62,7 +62,7 @@ export declare class HitlDecisionCache {
62
62
  /**
63
63
  * Look up a remembered approval.
64
64
  *
65
- * @param channel - high_risk | effect
65
+ * @param channel - high_risk | effect | plugin_hook
66
66
  * @param key - tool name or effect kind
67
67
  * @param options - sessionId (session scope) and/or agentId (always scope)
68
68
  * @returns `'approve'` if cached, otherwise `null`
@@ -79,7 +79,7 @@ export declare class HitlDecisionCache {
79
79
  * Missing scope id → silently one-shot (fail-safe, never over-grant).
80
80
  *
81
81
  * @param decision - host decision
82
- * @param channel - high_risk | effect
82
+ * @param channel - high_risk | effect | plugin_hook
83
83
  * @param key - tool name or effect kind
84
84
  * @param options - sessionId and/or agentId
85
85
  */
@@ -43,7 +43,7 @@ export class HitlDecisionCache {
43
43
  /**
44
44
  * Look up a remembered approval.
45
45
  *
46
- * @param channel - high_risk | effect
46
+ * @param channel - high_risk | effect | plugin_hook
47
47
  * @param key - tool name or effect kind
48
48
  * @param options - sessionId (session scope) and/or agentId (always scope)
49
49
  * @returns `'approve'` if cached, otherwise `null`
@@ -74,7 +74,7 @@ export class HitlDecisionCache {
74
74
  * Missing scope id → silently one-shot (fail-safe, never over-grant).
75
75
  *
76
76
  * @param decision - host decision
77
- * @param channel - high_risk | effect
77
+ * @param channel - high_risk | effect | plugin_hook
78
78
  * @param key - tool name or effect kind
79
79
  * @param options - sessionId and/or agentId
80
80
  */
@@ -8,3 +8,4 @@ export * from './security/index.js';
8
8
  export * from './human-in-the-loop/index.js';
9
9
  export * from './credentials/index.js';
10
10
  export * from './accounting/index.js';
11
+ export * from './registry/index.js';
@@ -8,3 +8,4 @@ export * from './security/index.js';
8
8
  export * from './human-in-the-loop/index.js';
9
9
  export * from './credentials/index.js';
10
10
  export * from './accounting/index.js';
11
+ export * from './registry/index.js';
@@ -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';