blun-king-cli 9.1.643 → 9.1.645

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 (268) hide show
  1. package/CHANGELOG.md +19 -123
  2. package/LIESMICH.txt +17 -45
  3. package/README.md +15 -76
  4. package/RELEASE-9.1.645.md +29 -0
  5. package/bin/blun.js +3 -3
  6. package/bin/king.js +3 -3
  7. package/bin/launcher-mode.js +125 -126
  8. package/bin/launcher-runtime.js +603 -616
  9. package/bin/plugin-bootstrap.js +339 -405
  10. package/bin/rename-private-staging.cjs +2 -2
  11. package/bin/retired-bundled-plugins.cjs +84 -0
  12. package/bin/startup-security-host.cjs +105 -0
  13. package/bin/startup-security.cjs +9 -105
  14. package/bin/startup-warning-policy.cjs +22 -0
  15. package/bin/update-lease-installer.cjs +125 -0
  16. package/bin/update-lease-sockets.cjs +228 -0
  17. package/bin/update-lease.js +22 -327
  18. package/bin/verify-bundled-agent-sources.cjs +2 -4
  19. package/blun.mjs +77 -180
  20. package/bundled-agent-sources.json +1 -552
  21. package/package.json +3 -6
  22. package/tool-liveness642/receipt.json +1 -1
  23. package/worker-host.mjs +62 -120
  24. package/agent-spine-plugin/.claude-plugin/marketplace.json +0 -20
  25. package/agent-spine-plugin/.claude-plugin/plugin.json +0 -14
  26. package/agent-spine-plugin/.codex-plugin/plugin.json +0 -47
  27. package/agent-spine-plugin/.mcp.json +0 -8
  28. package/agent-spine-plugin/CHANGELOG.md +0 -1614
  29. package/agent-spine-plugin/LICENSE +0 -186
  30. package/agent-spine-plugin/README.md +0 -432
  31. package/agent-spine-plugin/assets/agentspine-banner.svg +0 -32
  32. package/agent-spine-plugin/bin/agentspine-mcp.js +0 -4
  33. package/agent-spine-plugin/bin/agentspine.js +0 -7
  34. package/agent-spine-plugin/blun.plugin.json +0 -68
  35. package/agent-spine-plugin/docs/acceptance.md +0 -61
  36. package/agent-spine-plugin/docs/artifact-evaluation.md +0 -93
  37. package/agent-spine-plugin/docs/host-integration.md +0 -193
  38. package/agent-spine-plugin/docs/preflight-recall.md +0 -71
  39. package/agent-spine-plugin/docs/preservation-contract.md +0 -53
  40. package/agent-spine-plugin/docs/quality-gates.md +0 -50
  41. package/agent-spine-plugin/docs/session-timeline.md +0 -112
  42. package/agent-spine-plugin/docs/source-roots.md +0 -113
  43. package/agent-spine-plugin/docs/world-model.md +0 -119
  44. package/agent-spine-plugin/hooks/codex.json +0 -47
  45. package/agent-spine-plugin/hooks/hooks.json +0 -106
  46. package/agent-spine-plugin/hooks/version.json +0 -5
  47. package/agent-spine-plugin/package.json +0 -77
  48. package/agent-spine-plugin/scripts/check-codex-install.js +0 -226
  49. package/agent-spine-plugin/scripts/check-hosts.js +0 -208
  50. package/agent-spine-plugin/scripts/check-install-hook.js +0 -227
  51. package/agent-spine-plugin/scripts/check-install-selfstarter.js +0 -154
  52. package/agent-spine-plugin/scripts/check-install.js +0 -478
  53. package/agent-spine-plugin/scripts/check-line-budget.js +0 -58
  54. package/agent-spine-plugin/scripts/check-syntax.js +0 -29
  55. package/agent-spine-plugin/scripts/github-actions.js +0 -11
  56. package/agent-spine-plugin/scripts/hermetic-process.js +0 -191
  57. package/agent-spine-plugin/scripts/release-check.js +0 -150
  58. package/agent-spine-plugin/scripts/run-acceptance.js +0 -19
  59. package/agent-spine-plugin/scripts/run-checks.js +0 -50
  60. package/agent-spine-plugin/scripts/run-tests-hermetic.js +0 -112
  61. package/agent-spine-plugin/skills/agent-spine/SKILL.md +0 -99
  62. package/agent-spine-plugin/spine-example/1-identity.md +0 -12
  63. package/agent-spine-plugin/spine-example/2-voice.md +0 -6
  64. package/agent-spine-plugin/spine-example/3-conduct.md +0 -8
  65. package/agent-spine-plugin/spine-example/4-history.md +0 -4
  66. package/agent-spine-plugin/src/cli-agent.js +0 -315
  67. package/agent-spine-plugin/src/cli-attention.js +0 -95
  68. package/agent-spine-plugin/src/cli-autonomy.js +0 -36
  69. package/agent-spine-plugin/src/cli-common.js +0 -71
  70. package/agent-spine-plugin/src/cli-continuity.js +0 -116
  71. package/agent-spine-plugin/src/cli-core.js +0 -128
  72. package/agent-spine-plugin/src/cli-diagnostics.js +0 -291
  73. package/agent-spine-plugin/src/cli-host.js +0 -21
  74. package/agent-spine-plugin/src/cli-learning.js +0 -320
  75. package/agent-spine-plugin/src/cli-premortem.js +0 -16
  76. package/agent-spine-plugin/src/cli-sharing.js +0 -230
  77. package/agent-spine-plugin/src/cli.js +0 -181
  78. package/agent-spine-plugin/src/codex-reader-launcher.js +0 -182
  79. package/agent-spine-plugin/src/hook.js +0 -500
  80. package/agent-spine-plugin/src/index.js +0 -108
  81. package/agent-spine-plugin/src/lib/acceptance.js +0 -435
  82. package/agent-spine-plugin/src/lib/action-lesson-recall.js +0 -118
  83. package/agent-spine-plugin/src/lib/attention-context.js +0 -167
  84. package/agent-spine-plugin/src/lib/attention-events.js +0 -113
  85. package/agent-spine-plugin/src/lib/attention-privacy.js +0 -72
  86. package/agent-spine-plugin/src/lib/attention-schema.js +0 -164
  87. package/agent-spine-plugin/src/lib/attention-storage.js +0 -93
  88. package/agent-spine-plugin/src/lib/attention.js +0 -164
  89. package/agent-spine-plugin/src/lib/audit-premortem.js +0 -223
  90. package/agent-spine-plugin/src/lib/audit.js +0 -401
  91. package/agent-spine-plugin/src/lib/authentication.js +0 -515
  92. package/agent-spine-plugin/src/lib/autonomy-policy.js +0 -110
  93. package/agent-spine-plugin/src/lib/autonomy-store.js +0 -202
  94. package/agent-spine-plugin/src/lib/autonomy.js +0 -8
  95. package/agent-spine-plugin/src/lib/briefing.js +0 -493
  96. package/agent-spine-plugin/src/lib/catalog-document-read.js +0 -51
  97. package/agent-spine-plugin/src/lib/catalog.js +0 -167
  98. package/agent-spine-plugin/src/lib/channel-continuity.js +0 -19
  99. package/agent-spine-plugin/src/lib/channel-runtime.js +0 -665
  100. package/agent-spine-plugin/src/lib/codex-installation.js +0 -231
  101. package/agent-spine-plugin/src/lib/codex-skill-installation.js +0 -211
  102. package/agent-spine-plugin/src/lib/context.js +0 -156
  103. package/agent-spine-plugin/src/lib/continuity.js +0 -338
  104. package/agent-spine-plugin/src/lib/coordination.js +0 -577
  105. package/agent-spine-plugin/src/lib/delivery-agent-usage.js +0 -231
  106. package/agent-spine-plugin/src/lib/delivery-assignment.js +0 -220
  107. package/agent-spine-plugin/src/lib/delivery-command-actions.js +0 -462
  108. package/agent-spine-plugin/src/lib/delivery-knowledge.js +0 -78
  109. package/agent-spine-plugin/src/lib/delivery-premortem-binding.js +0 -107
  110. package/agent-spine-plugin/src/lib/delivery-premortem-closure.js +0 -171
  111. package/agent-spine-plugin/src/lib/delivery-premortem-codec.js +0 -45
  112. package/agent-spine-plugin/src/lib/delivery-premortem-correction.js +0 -101
  113. package/agent-spine-plugin/src/lib/delivery-premortem-file.js +0 -21
  114. package/agent-spine-plugin/src/lib/delivery-premortem-index.js +0 -493
  115. package/agent-spine-plugin/src/lib/delivery-premortem-inspection.js +0 -37
  116. package/agent-spine-plugin/src/lib/delivery-premortem-recovery.js +0 -120
  117. package/agent-spine-plugin/src/lib/delivery-premortem-rejection.js +0 -65
  118. package/agent-spine-plugin/src/lib/delivery-premortem-results.js +0 -28
  119. package/agent-spine-plugin/src/lib/delivery-premortem-session-guard.js +0 -46
  120. package/agent-spine-plugin/src/lib/delivery-premortem-write-ledger.js +0 -285
  121. package/agent-spine-plugin/src/lib/delivery-premortem.js +0 -499
  122. package/agent-spine-plugin/src/lib/delivery-shell-heredoc.js +0 -115
  123. package/agent-spine-plugin/src/lib/delivery-shell-substitutions.js +0 -111
  124. package/agent-spine-plugin/src/lib/delivery-shell-wrapper.js +0 -64
  125. package/agent-spine-plugin/src/lib/delivery-target.js +0 -73
  126. package/agent-spine-plugin/src/lib/delivery-verification.js +0 -445
  127. package/agent-spine-plugin/src/lib/documents.js +0 -239
  128. package/agent-spine-plugin/src/lib/feed-transport.js +0 -499
  129. package/agent-spine-plugin/src/lib/filesystem-retry.js +0 -34
  130. package/agent-spine-plugin/src/lib/gateway-common.js +0 -68
  131. package/agent-spine-plugin/src/lib/gateway-control.js +0 -370
  132. package/agent-spine-plugin/src/lib/gateway-delivery.js +0 -103
  133. package/agent-spine-plugin/src/lib/gateway-execution.js +0 -350
  134. package/agent-spine-plugin/src/lib/gateway-group-response.js +0 -128
  135. package/agent-spine-plugin/src/lib/gateway-host-fencing.js +0 -92
  136. package/agent-spine-plugin/src/lib/gateway-host-lifecycle.js +0 -193
  137. package/agent-spine-plugin/src/lib/gateway-inspection.js +0 -85
  138. package/agent-spine-plugin/src/lib/gateway-knowledge.js +0 -129
  139. package/agent-spine-plugin/src/lib/gateway-policy-provenance.js +0 -197
  140. package/agent-spine-plugin/src/lib/gateway-premortem-disposition.js +0 -82
  141. package/agent-spine-plugin/src/lib/gateway-premortem.js +0 -363
  142. package/agent-spine-plugin/src/lib/gateway-prepared-host.js +0 -28
  143. package/agent-spine-plugin/src/lib/gateway-runs.js +0 -345
  144. package/agent-spine-plugin/src/lib/gateway-runtime-identity.js +0 -31
  145. package/agent-spine-plugin/src/lib/gateway-runtime-records.js +0 -21
  146. package/agent-spine-plugin/src/lib/gateway-runtime.js +0 -18
  147. package/agent-spine-plugin/src/lib/gateway-state-transaction.js +0 -356
  148. package/agent-spine-plugin/src/lib/gateway-state.js +0 -344
  149. package/agent-spine-plugin/src/lib/graph.js +0 -337
  150. package/agent-spine-plugin/src/lib/hook-artifact-guards.js +0 -356
  151. package/agent-spine-plugin/src/lib/hook-audit.js +0 -43
  152. package/agent-spine-plugin/src/lib/hook-briefing-use.js +0 -78
  153. package/agent-spine-plugin/src/lib/hook-context.js +0 -441
  154. package/agent-spine-plugin/src/lib/hook-final-message.js +0 -26
  155. package/agent-spine-plugin/src/lib/hook-input.js +0 -27
  156. package/agent-spine-plugin/src/lib/hook-output.js +0 -284
  157. package/agent-spine-plugin/src/lib/hook-premortem.js +0 -257
  158. package/agent-spine-plugin/src/lib/hook-process-advisory.js +0 -36
  159. package/agent-spine-plugin/src/lib/hook-protection.js +0 -95
  160. package/agent-spine-plugin/src/lib/hook-stop-verification.js +0 -84
  161. package/agent-spine-plugin/src/lib/hook-timeline.js +0 -102
  162. package/agent-spine-plugin/src/lib/host-instruction-budget.js +0 -11
  163. package/agent-spine-plugin/src/lib/https-transport.js +0 -392
  164. package/agent-spine-plugin/src/lib/identifier-analysis.js +0 -446
  165. package/agent-spine-plugin/src/lib/indexed-memory-offline.js +0 -40
  166. package/agent-spine-plugin/src/lib/indexed-memory.js +0 -298
  167. package/agent-spine-plugin/src/lib/knowledge-evidence.js +0 -431
  168. package/agent-spine-plugin/src/lib/learning-applications.js +0 -441
  169. package/agent-spine-plugin/src/lib/learning-artifact-evaluator.js +0 -114
  170. package/agent-spine-plugin/src/lib/learning-candidates.js +0 -274
  171. package/agent-spine-plugin/src/lib/learning-context.js +0 -137
  172. package/agent-spine-plugin/src/lib/learning-delivery-contracts.js +0 -310
  173. package/agent-spine-plugin/src/lib/learning-evaluation-contracts.js +0 -350
  174. package/agent-spine-plugin/src/lib/learning-evaluation-registration.js +0 -372
  175. package/agent-spine-plugin/src/lib/learning-evaluation-revocation.js +0 -292
  176. package/agent-spine-plugin/src/lib/learning-evidence-contracts.js +0 -321
  177. package/agent-spine-plugin/src/lib/learning-findings.js +0 -458
  178. package/agent-spine-plugin/src/lib/learning-measurement-contracts.js +0 -285
  179. package/agent-spine-plugin/src/lib/learning-measurements.js +0 -265
  180. package/agent-spine-plugin/src/lib/learning-outcome-contracts.js +0 -165
  181. package/agent-spine-plugin/src/lib/learning-outcomes.js +0 -343
  182. package/agent-spine-plugin/src/lib/learning-reconciliation.js +0 -290
  183. package/agent-spine-plugin/src/lib/learning-retry-contracts.js +0 -188
  184. package/agent-spine-plugin/src/lib/learning-schema.js +0 -229
  185. package/agent-spine-plugin/src/lib/learning-scope-targets.js +0 -424
  186. package/agent-spine-plugin/src/lib/learning-state-upgrade.js +0 -477
  187. package/agent-spine-plugin/src/lib/learning-status-configuration.js +0 -476
  188. package/agent-spine-plugin/src/lib/learning-storage.js +0 -203
  189. package/agent-spine-plugin/src/lib/learning-trial-recovery.js +0 -218
  190. package/agent-spine-plugin/src/lib/learning-validation-contracts.js +0 -375
  191. package/agent-spine-plugin/src/lib/learning-validation-renewal.js +0 -298
  192. package/agent-spine-plugin/src/lib/learning-validation-runtime.js +0 -234
  193. package/agent-spine-plugin/src/lib/learning.js +0 -36
  194. package/agent-spine-plugin/src/lib/lesson-recall-session.js +0 -172
  195. package/agent-spine-plugin/src/lib/mcp-autonomy-tools.js +0 -37
  196. package/agent-spine-plugin/src/lib/mcp-delivery-completion.js +0 -124
  197. package/agent-spine-plugin/src/lib/mcp-delivery-tools.js +0 -45
  198. package/agent-spine-plugin/src/lib/mcp-premortem.js +0 -68
  199. package/agent-spine-plugin/src/lib/mcp-runtime.js +0 -355
  200. package/agent-spine-plugin/src/lib/mcp-source-context.js +0 -61
  201. package/agent-spine-plugin/src/lib/mcp-timeline-tools.js +0 -240
  202. package/agent-spine-plugin/src/lib/mcp-world-tools.js +0 -52
  203. package/agent-spine-plugin/src/lib/object-transport.js +0 -206
  204. package/agent-spine-plugin/src/lib/owned-file-lock.js +0 -182
  205. package/agent-spine-plugin/src/lib/paths.js +0 -109
  206. package/agent-spine-plugin/src/lib/peer-transport.js +0 -283
  207. package/agent-spine-plugin/src/lib/persona-runtime.js +0 -581
  208. package/agent-spine-plugin/src/lib/pre-answer-timeline-recall.js +0 -104
  209. package/agent-spine-plugin/src/lib/preflight-delivery-id.js +0 -27
  210. package/agent-spine-plugin/src/lib/preflight.js +0 -688
  211. package/agent-spine-plugin/src/lib/project-portfolio.js +0 -176
  212. package/agent-spine-plugin/src/lib/runtime.js +0 -13
  213. package/agent-spine-plugin/src/lib/selfstarter-core.js +0 -382
  214. package/agent-spine-plugin/src/lib/selfstarter-jobs.js +0 -149
  215. package/agent-spine-plugin/src/lib/selfstarter-lease.js +0 -204
  216. package/agent-spine-plugin/src/lib/selfstarter-policy.js +0 -90
  217. package/agent-spine-plugin/src/lib/selfstarter-workspace.js +0 -111
  218. package/agent-spine-plugin/src/lib/selfstarter.js +0 -11
  219. package/agent-spine-plugin/src/lib/session-timeline-auth.js +0 -316
  220. package/agent-spine-plugin/src/lib/session-timeline-codex.js +0 -69
  221. package/agent-spine-plugin/src/lib/session-timeline-contract.js +0 -56
  222. package/agent-spine-plugin/src/lib/session-timeline-enrollment-source.js +0 -38
  223. package/agent-spine-plugin/src/lib/session-timeline-enrollment-storage.js +0 -128
  224. package/agent-spine-plugin/src/lib/session-timeline-enrollment-transport.js +0 -15
  225. package/agent-spine-plugin/src/lib/session-timeline-enrollment.js +0 -478
  226. package/agent-spine-plugin/src/lib/session-timeline-event-extract.js +0 -186
  227. package/agent-spine-plugin/src/lib/session-timeline-host-origin.js +0 -73
  228. package/agent-spine-plugin/src/lib/session-timeline-host-receipt.js +0 -117
  229. package/agent-spine-plugin/src/lib/session-timeline-invocation.js +0 -201
  230. package/agent-spine-plugin/src/lib/session-timeline-king.js +0 -93
  231. package/agent-spine-plugin/src/lib/session-timeline-prior.js +0 -57
  232. package/agent-spine-plugin/src/lib/session-timeline-provider.js +0 -36
  233. package/agent-spine-plugin/src/lib/session-timeline-query.js +0 -56
  234. package/agent-spine-plugin/src/lib/session-timeline-results.js +0 -56
  235. package/agent-spine-plugin/src/lib/session-timeline-root.js +0 -11
  236. package/agent-spine-plugin/src/lib/session-timeline-search.js +0 -82
  237. package/agent-spine-plugin/src/lib/session-timeline-sid-acl.js +0 -213
  238. package/agent-spine-plugin/src/lib/session-timeline-source-open.js +0 -30
  239. package/agent-spine-plugin/src/lib/session-timeline-source.js +0 -80
  240. package/agent-spine-plugin/src/lib/session-timeline-state.js +0 -45
  241. package/agent-spine-plugin/src/lib/session-timeline-transport.js +0 -42
  242. package/agent-spine-plugin/src/lib/session-timeline-windows-acl.js +0 -145
  243. package/agent-spine-plugin/src/lib/session-timeline.js +0 -462
  244. package/agent-spine-plugin/src/lib/sharing.js +0 -969
  245. package/agent-spine-plugin/src/lib/source-roots.js +0 -475
  246. package/agent-spine-plugin/src/lib/source-tree-scan.js +0 -178
  247. package/agent-spine-plugin/src/lib/sqlite-transport.js +0 -501
  248. package/agent-spine-plugin/src/lib/task-knowledge-context.js +0 -99
  249. package/agent-spine-plugin/src/lib/telegram-adapter.js +0 -119
  250. package/agent-spine-plugin/src/lib/timeline-continuation-update.js +0 -100
  251. package/agent-spine-plugin/src/lib/timeline-tool-guard.js +0 -225
  252. package/agent-spine-plugin/src/lib/timeline-user-feedback.js +0 -216
  253. package/agent-spine-plugin/src/lib/timeline-world-capture.js +0 -233
  254. package/agent-spine-plugin/src/lib/voice-runtime.js +0 -39
  255. package/agent-spine-plugin/src/lib/world-knowledge.js +0 -306
  256. package/agent-spine-plugin/src/lib/world-model.js +0 -333
  257. package/agent-spine-plugin/src/mcp.js +0 -456
  258. package/agent-spine-plugin/src/version.js +0 -1
  259. package/agent-spine-plugin/src/worker.js +0 -257
  260. package/bin/agentspine-king-goal-inbox.mjs +0 -127
  261. package/bin/agentspine-king-goal-intake.mjs +0 -106
  262. package/bin/agentspine-king-host-runner.mjs +0 -109
  263. package/bin/agentspine-king-snapshot-policy.cjs +0 -80
  264. package/bin/agentspine-king-status-policy.mjs +0 -226
  265. package/bin/agentspine-king-worker-host.mjs +0 -160
  266. package/bin/managed-plugin-selection.cjs +0 -141
  267. package/bin/verify-agent-behavior.cjs +0 -122
  268. package/bin/verify-agent-components.cjs +0 -104
@@ -1,356 +0,0 @@
1
- import { AsyncLocalStorage } from "node:async_hooks";
2
- import { createHash, randomUUID } from "node:crypto";
3
- import { readdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
4
- import { basename, join } from "node:path";
5
- import { replaceFileWithRetry } from "./filesystem-retry.js";
6
- import { readGatewayJson, writeGatewayJson } from "./gateway-policy-provenance.js";
7
- import { withOwnedFileLock } from "./owned-file-lock.js";
8
-
9
- const TRANSACTION_SCHEMA = "agentspine.gateway-state-transaction/v1";
10
- const AUTHORITY = "state-coordination-only";
11
- const MAX_STATE_BYTES = 8 * 1024 * 1024;
12
- const MAX_TRANSACTION_BYTES = 16 * 1024;
13
- const DIGEST_RE = /^[a-f0-9]{64}$/;
14
- const UUID_RE = /^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/;
15
- const STAGE_RE = /^gateway-pair-[a-f0-9-]{36}-(?:policy|runtime)\.next\.json$/;
16
- const contextStore = new AsyncLocalStorage();
17
- const testHookStore = new AsyncLocalStorage();
18
-
19
- function canonical(value) {
20
- if (value === null || typeof value !== "object") return JSON.stringify(value);
21
- if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
22
- return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`).join(",")}}`;
23
- }
24
-
25
- function sha256(value) {
26
- return createHash("sha256").update(value).digest("hex");
27
- }
28
-
29
- function stateContent(value) {
30
- const content = `${JSON.stringify(value, null, 2)}\n`;
31
- if (Buffer.byteLength(content) > MAX_STATE_BYTES) throw new Error("gateway state exceeds 8 MiB");
32
- return content;
33
- }
34
-
35
- async function fileDigest(path, maximum = MAX_STATE_BYTES) {
36
- try {
37
- const metadata = await stat(path);
38
- if (metadata.size > maximum) throw new Error("gateway transaction file exceeds its byte limit");
39
- return sha256(await readFile(path));
40
- } catch (error) {
41
- if (error.code === "ENOENT") return null;
42
- throw error;
43
- }
44
- }
45
-
46
- async function readBounded(path, maximum) {
47
- const metadata = await stat(path);
48
- if (metadata.size > maximum) throw new Error("gateway transaction file exceeds its byte limit");
49
- const content = await readFile(path, "utf8");
50
- if (Buffer.byteLength(content) > maximum) throw new Error("gateway transaction file exceeds its byte limit");
51
- return content;
52
- }
53
-
54
- function transactionPaths(paths, transactionId = null) {
55
- const prefix = transactionId ? `gateway-pair-${transactionId}` : null;
56
- return {
57
- lockPath: join(paths.directory, "gateway-runtime.lock"),
58
- journalPath: join(paths.directory, "gateway-state-transaction.json"),
59
- policyStagePath: prefix ? join(paths.directory, `${prefix}-policy.next.json`) : null,
60
- runtimeStagePath: prefix ? join(paths.directory, `${prefix}-runtime.next.json`) : null
61
- };
62
- }
63
-
64
- function transactionMaterial(value) {
65
- return {
66
- schema: value.schema,
67
- transactionId: value.transactionId,
68
- projectRootDigest: value.projectRootDigest,
69
- before: value.before,
70
- after: value.after,
71
- stages: value.stages,
72
- authority: value.authority
73
- };
74
- }
75
-
76
- function exactKeys(value, keys) {
77
- return value && canonical(Object.keys(value).sort()) === canonical([...keys].sort());
78
- }
79
-
80
- function validDigestPair(value, nullable) {
81
- return exactKeys(value, ["policy", "runtime"])
82
- && [value.policy, value.runtime].every((digest) => (nullable && digest === null) || DIGEST_RE.test(digest || ""));
83
- }
84
-
85
- function validTransaction(value, paths) {
86
- if (!exactKeys(value, ["schema", "transactionId", "projectRootDigest", "before", "after", "stages", "authority", "digest"])
87
- || value.schema !== TRANSACTION_SCHEMA || !UUID_RE.test(value.transactionId || "")
88
- || value.projectRootDigest !== sha256(paths.catalog.root) || value.authority !== AUTHORITY
89
- || !validDigestPair(value.before, true) || !validDigestPair(value.after, false)
90
- || !exactKeys(value.stages, ["policy", "runtime"])) return false;
91
- const expected = transactionPaths(paths, value.transactionId);
92
- return value.stages.policy === basename(expected.policyStagePath)
93
- && value.stages.runtime === basename(expected.runtimeStagePath)
94
- && value.digest === sha256(canonical(transactionMaterial(value)));
95
- }
96
-
97
- async function atomicWrite(path, content, { assertOwned, beforeFinalCheck, expectedDigest, maximum }) {
98
- if (Buffer.byteLength(content) > maximum) throw new Error("gateway transaction file exceeds its byte limit");
99
- const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
100
- try {
101
- await writeFile(temporary, content, { mode: 0o600 });
102
- await replaceFileWithRetry(temporary, path, { beforeAttempt: async () => {
103
- await assertOwned();
104
- if (await fileDigest(path, maximum) !== expectedDigest) {
105
- throw new Error("gateway transaction predecessor changed before atomic replace");
106
- }
107
- await beforeFinalCheck?.();
108
- await assertOwned();
109
- } });
110
- } finally {
111
- await unlink(temporary).catch((error) => { if (error.code !== "ENOENT") throw error; });
112
- }
113
- }
114
-
115
- async function writeStage(path, content, assertOwned) {
116
- await assertOwned();
117
- await writeFile(path, content, { flag: "wx", mode: 0o600 });
118
- }
119
-
120
- async function readTransaction(paths) {
121
- const { journalPath } = transactionPaths(paths);
122
- try {
123
- const value = JSON.parse(await readBounded(journalPath, MAX_TRANSACTION_BYTES));
124
- if (!validTransaction(value, paths)) throw new Error("gateway state transaction journal is invalid");
125
- return value;
126
- } catch (error) {
127
- if (error.code === "ENOENT") return null;
128
- if (error instanceof SyntaxError) throw new Error("gateway state transaction journal is invalid");
129
- throw error;
130
- }
131
- }
132
-
133
- async function readStage(path, expectedDigest, schema, root) {
134
- const content = await readBounded(path, MAX_STATE_BYTES);
135
- if (sha256(content) !== expectedDigest) throw new Error("gateway state transaction stage digest mismatch");
136
- let value;
137
- try { value = JSON.parse(content); }
138
- catch { throw new Error("gateway state transaction stage is invalid"); }
139
- if (value?.schema !== schema || value.root !== root) throw new Error("gateway state transaction stage scope mismatch");
140
- return { content, value };
141
- }
142
-
143
- async function currentPair(paths) {
144
- return {
145
- policy: await fileDigest(paths.gatewayPolicyPath),
146
- runtime: await fileDigest(paths.gatewayRuntimePath)
147
- };
148
- }
149
-
150
- function pairMatches(pair, expected) {
151
- return pair.policy === expected.policy && pair.runtime === expected.runtime;
152
- }
153
-
154
- function pairWithinTransaction(pair, transaction) {
155
- return ["policy", "runtime"].every((key) =>
156
- pair[key] === transaction.before[key] || pair[key] === transaction.after[key]);
157
- }
158
-
159
- async function removeTransactionFiles(paths, transaction, assertOwned) {
160
- const names = transactionPaths(paths, transaction.transactionId);
161
- await assertOwned();
162
- await unlink(names.journalPath);
163
- await Promise.all([names.policyStagePath, names.runtimeStagePath].map((path) =>
164
- unlink(path).catch((error) => { if (error.code !== "ENOENT") throw error; })));
165
- }
166
-
167
- async function runTestHook(context, phase) {
168
- if (typeof context.testHook === "function") await context.testHook(phase, {
169
- paths: context.paths,
170
- transactionId: context.transactionId || null
171
- });
172
- }
173
-
174
- async function validateStatePair(context, policy, runtime) {
175
- if (typeof context.validatePair !== "function") {
176
- throw new Error("gateway state pair validation is unavailable");
177
- }
178
- await context.validatePair(structuredClone(policy), structuredClone(runtime));
179
- }
180
-
181
- async function installTransaction(context, transaction) {
182
- const paths = context.paths;
183
- const names = transactionPaths(paths, transaction.transactionId);
184
- const [policyStage, runtimeStage] = await Promise.all([
185
- readStage(names.policyStagePath, transaction.after.policy, "agentspine.gateway-policy/v2", paths.catalog.root),
186
- readStage(names.runtimeStagePath, transaction.after.runtime, "agentspine.gateway-runtime/v1", paths.catalog.root)
187
- ]);
188
- await validateStatePair(context, policyStage.value, runtimeStage.value);
189
- const current = await currentPair(paths);
190
- if (!pairWithinTransaction(current, transaction)) {
191
- throw new Error("gateway state changed outside the prepared transaction");
192
- }
193
- await writeGatewayJson(paths.gatewayPolicyPath, policyStage.value, {
194
- assertOwned: context.assertOwned,
195
- expectedDigest: current.policy
196
- });
197
- await runTestHook(context, "after-policy-install");
198
- const runtimeBase = await fileDigest(paths.gatewayRuntimePath);
199
- if (![transaction.before.runtime, transaction.after.runtime].includes(runtimeBase)) {
200
- throw new Error("gateway runtime changed outside the prepared transaction");
201
- }
202
- await writeGatewayJson(paths.gatewayRuntimePath, runtimeStage.value, {
203
- assertOwned: context.assertOwned,
204
- expectedDigest: runtimeBase
205
- });
206
- await runTestHook(context, "after-runtime-install");
207
- if (!pairMatches(await currentPair(paths), transaction.after)) {
208
- throw new Error("gateway state transaction did not install the exact pair");
209
- }
210
- await removeTransactionFiles(paths, transaction, context.assertOwned);
211
- context.expected = { ...transaction.after };
212
- }
213
-
214
- async function cleanOrphanStages(paths, assertOwned) {
215
- let entries;
216
- try { entries = await readdir(paths.directory, { withFileTypes: true }); }
217
- catch (error) { if (error.code === "ENOENT") return; throw error; }
218
- for (const entry of entries.filter((item) => item.isFile() && STAGE_RE.test(item.name)).slice(0, 64)) {
219
- await assertOwned();
220
- await unlink(join(paths.directory, entry.name)).catch((error) => {
221
- if (error.code !== "ENOENT") throw error;
222
- });
223
- }
224
- }
225
-
226
- async function recoverPreparedTransaction(context) {
227
- const transaction = await readTransaction(context.paths);
228
- if (!transaction) {
229
- await cleanOrphanStages(context.paths, context.assertOwned);
230
- return;
231
- }
232
- context.transactionId = transaction.transactionId;
233
- await installTransaction(context, transaction);
234
- context.transactionId = null;
235
- }
236
-
237
- export async function withGatewayStateLock(paths, task, options = {}) {
238
- if (!paths?.catalog?.root || !paths.directory || typeof task !== "function") {
239
- throw new Error("gateway state lock requires exact paths and a task");
240
- }
241
- const names = transactionPaths(paths);
242
- const lockOptions = options.lockOptions || {
243
- staleAfterMs: 120000,
244
- heartbeatIntervalMs: 1000,
245
- retryDelayMs: 25,
246
- maxAttempts: 160
247
- };
248
- return withOwnedFileLock(names.lockPath, async ({ assertOwned, token }) => {
249
- const context = { paths, assertOwned, token, expected: null, validatePair: options.validatePair || null,
250
- transactionId: null, testHook: options.testHook || testHookStore.getStore() || null };
251
- return contextStore.run(context, async () => {
252
- await recoverPreparedTransaction(context);
253
- context.expected = await currentPair(paths);
254
- const result = await task();
255
- await assertOwned();
256
- if (!pairMatches(await currentPair(paths), context.expected)
257
- || await fileDigest(names.journalPath, MAX_TRANSACTION_BYTES) !== null) {
258
- throw new Error("gateway state changed outside its owned transaction");
259
- }
260
- return result;
261
- });
262
- }, lockOptions);
263
- }
264
-
265
- export async function withGatewayStateTestHook(testHook, task) {
266
- if (typeof testHook !== "function" || typeof task !== "function") {
267
- throw new Error("gateway state test hook requires two functions");
268
- }
269
- return testHookStore.run(testHook, task);
270
- }
271
-
272
- function activeContext() {
273
- const context = contextStore.getStore();
274
- if (!context) throw new Error("gateway state write requires the owned gateway lock");
275
- return context;
276
- }
277
-
278
- function stateKey(context, path) {
279
- if (path === context.paths.gatewayPolicyPath) return "policy";
280
- if (path === context.paths.gatewayRuntimePath) return "runtime";
281
- throw new Error("gateway state write target is outside the bound pair");
282
- }
283
-
284
- export async function writeGatewayStateJson(path, value) {
285
- const context = activeContext();
286
- const key = stateKey(context, path);
287
- await writeGatewayJson(path, value, {
288
- assertOwned: context.assertOwned,
289
- expectedDigest: context.expected[key]
290
- });
291
- context.expected[key] = sha256(stateContent(value));
292
- }
293
-
294
- export async function readGatewayStateJson(path, root, normalize, empty) {
295
- const context = activeContext();
296
- const key = stateKey(context, path);
297
- return readGatewayJson(path, root, normalize, empty, { assertOwned: context.assertOwned,
298
- afterWrite: (digest) => { context.expected[key] = digest; } });
299
- }
300
-
301
- export async function writeGatewayStatePair(policy, runtime) {
302
- const context = activeContext();
303
- const paths = context.paths;
304
- if (policy?.root !== paths.catalog.root || runtime?.root !== paths.catalog.root
305
- || policy?.schema !== "agentspine.gateway-policy/v2"
306
- || runtime?.schema !== "agentspine.gateway-runtime/v1") {
307
- throw new Error("gateway state transaction pair has an invalid scope or schema");
308
- }
309
- await validateStatePair(context, policy, runtime);
310
- if (!pairMatches(await currentPair(paths), context.expected)) {
311
- throw new Error("gateway state predecessor changed before transaction prepare");
312
- }
313
- const transactionId = randomUUID();
314
- const names = transactionPaths(paths, transactionId);
315
- const policyContent = stateContent(policy);
316
- const runtimeContent = stateContent(runtime);
317
- await writeStage(names.policyStagePath, policyContent, context.assertOwned);
318
- try {
319
- await writeStage(names.runtimeStagePath, runtimeContent, context.assertOwned);
320
- const material = {
321
- schema: TRANSACTION_SCHEMA,
322
- transactionId,
323
- projectRootDigest: sha256(paths.catalog.root),
324
- before: { ...context.expected },
325
- after: { policy: sha256(policyContent), runtime: sha256(runtimeContent) },
326
- stages: { policy: basename(names.policyStagePath), runtime: basename(names.runtimeStagePath) },
327
- authority: AUTHORITY
328
- };
329
- const transaction = { ...material, digest: sha256(canonical(material)) };
330
- await atomicWrite(names.journalPath, `${JSON.stringify(transaction, null, 2)}\n`, {
331
- assertOwned: context.assertOwned,
332
- beforeFinalCheck: () => runTestHook(context, "after-journal-predecessor-check"),
333
- expectedDigest: null,
334
- maximum: MAX_TRANSACTION_BYTES
335
- });
336
- context.transactionId = transactionId;
337
- await runTestHook(context, "after-prepare");
338
- await installTransaction(context, transaction);
339
- context.transactionId = null;
340
- } catch (error) {
341
- if (!await fileDigest(names.journalPath, MAX_TRANSACTION_BYTES)) {
342
- await Promise.all([names.policyStagePath, names.runtimeStagePath].map((path) =>
343
- unlink(path).catch((cleanupError) => { if (cleanupError.code !== "ENOENT") throw cleanupError; })));
344
- }
345
- throw error;
346
- }
347
- }
348
-
349
- export async function inspectGatewayStateTransaction(paths) {
350
- try {
351
- const transaction = await readTransaction(paths);
352
- return { status: transaction ? "prepared" : "none", transaction };
353
- } catch (error) {
354
- return { status: "invalid", transaction: null, error: error.message };
355
- }
356
- }