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,73 +0,0 @@
1
- import { consumeHookBriefingOrigin } from "./hook-briefing-use.js";
2
- import { runtimeHostForTimeline, timelineHostForRuntime, timelineHostHome, timelineProtocolFromRuntime, timelineSourceFromRuntime,
3
- validTimelineHost } from "./session-timeline-provider.js";
4
-
5
- const verifiedOrigins = new WeakSet();
6
- const USER_PROMPT_SUBMIT = "UserPromptSubmit";
7
-
8
- function timelineBinding(input, scope) {
9
- const binding = {
10
- host: scope?.host, sessionId: input?.session_id ?? input?.sessionId,
11
- entityId: scope?.entityId, userId: scope?.userId, tenantId: scope?.tenantId,
12
- projectId: scope?.projectId, groupId: scope?.groupId,
13
- taskId: scope?.currentTaskId, goalId: scope?.goalId, goalStepId: scope?.goalStepId
14
- };
15
- if (scope?.portalRef || scope?.threadRef) {
16
- binding.portalRef = scope?.portalRef;
17
- binding.threadRef = scope?.threadRef;
18
- }
19
- return binding;
20
- }
21
-
22
- function sameBinding(left, right) {
23
- return ["host", "sessionId", "entityId", "userId", "tenantId", "projectId", "groupId", "taskId", "goalId", "goalStepId",
24
- "portalRef", "threadRef"].every((key) => (left?.[key] ?? null) === (right?.[key] ?? null));
25
- }
26
-
27
- function sameInput(left, right) {
28
- return (left?.transcript_path ?? left?.transcriptPath) === (right?.transcript_path ?? right?.transcriptPath)
29
- && (left?.event_id ?? left?.hook_event_id ?? null) === (right?.event_id ?? right?.hook_event_id ?? null)
30
- && (left?.protocol_version ?? null) === (right?.protocol_version ?? null);
31
- }
32
-
33
- function consumedResult(origin, briefingOrigin) { return { consumed: true, origin, briefingOrigin }; }
34
-
35
- function eligibleTimelineOrigin(binding, input) {
36
- const transcriptPath = input?.transcript_path ?? input?.transcriptPath;
37
- return validTimelineHost(binding.host) && binding.groupId === null
38
- && typeof transcriptPath === "string" && transcriptPath.length > 0;
39
- }
40
-
41
- export async function consumeTimelineHostOrigin({
42
- event, input, scope, resolvedSources, preflight, prompt, environment = process.env, now = new Date()
43
- }) {
44
- if (event !== USER_PROMPT_SUBMIT || !input || !scope || !resolvedSources || typeof prompt !== "string") return null;
45
- const briefingOrigin = await consumeHookBriefingOrigin({ event, input, scope,
46
- resolvedSources, preflight, prompt, environment, now });
47
- if (!briefingOrigin) return null;
48
- const receipt = preflight.receipt;
49
- const timelineHost = timelineHostForRuntime(scope.host, environment);
50
- const binding = timelineBinding(input, { ...scope, host: timelineHost });
51
- const expectedReceiptHost = runtimeHostForTimeline(timelineHost);
52
- if (receipt.host !== expectedReceiptHost
53
- || receipt.hookEvent !== USER_PROMPT_SUBMIT || receipt.sessionId !== binding.sessionId
54
- || receipt.agentId !== binding.entityId || receipt.userId !== binding.userId || receipt.tenantId !== binding.tenantId
55
- || receipt.projectId !== binding.projectId || receipt.groupId !== binding.groupId || receipt.taskId !== binding.taskId) {
56
- return consumedResult(null, briefingOrigin);
57
- }
58
- const sourceInput = { transcript_path: timelineSourceFromRuntime(timelineHost, input, environment),
59
- event_id: input.event_id ?? input.hook_event_id ?? null,
60
- protocol_version: timelineProtocolFromRuntime(timelineHost, environment) };
61
- if (!eligibleTimelineOrigin(binding, sourceInput)) return consumedResult(null, briefingOrigin);
62
- const origin = Object.freeze({ binding, input: Object.freeze({
63
- ...sourceInput,
64
- }), root: resolvedSources.projectRoot, hostHome: timelineHostHome(timelineHost, environment), event });
65
- verifiedOrigins.add(origin);
66
- return consumedResult(origin, briefingOrigin);
67
- }
68
-
69
- export function validVerifiedTimelineHostOrigin({ origin, root, input, binding, hostHome, event }) {
70
- return verifiedOrigins.has(origin) && origin.event === USER_PROMPT_SUBMIT && event === USER_PROMPT_SUBMIT
71
- && origin.root === root && origin.hostHome === hostHome && sameInput(origin.input, input)
72
- && sameBinding(origin.binding, binding);
73
- }
@@ -1,117 +0,0 @@
1
- import { createHash, randomBytes } from "node:crypto";
2
- import { completeTimelineBinding, sameTimelineBinding, validTimelineBinding } from "./session-timeline-contract.js";
3
- import { sameTimelineTransportDigest, validTimelineTransportDigest } from "./session-timeline-transport.js";
4
- import { sessionTimelineRootDigest } from "./session-timeline-root.js";
5
- import { validSessionTimelineSourceMetadata } from "./session-timeline-source.js";
6
-
7
- export const PRIVATE_TIMELINE_HOST_RECEIPT_SCHEMA = "agentspine.session-timeline-host-receipt/v1";
8
- export const PRIVATE_TIMELINE_HOST_RECEIPT_ORIGIN = "claude-user-prompt-v1";
9
- export const HOST_RECEIPT_TTL_MS = 15 * 60 * 1000;
10
- export const MAX_PENDING_RECEIPTS = 32;
11
-
12
- const AUTHORITY = "context-only";
13
- const HOST_RECEIPT_RE = /^asthr_[A-Za-z0-9_-]{43}$/;
14
-
15
- function receiptOrigin(host) {
16
- return host === "king" ? "king-user-prompt-v1"
17
- : host === "codex" ? "codex-user-prompt-v1" : PRIVATE_TIMELINE_HOST_RECEIPT_ORIGIN;
18
- }
19
-
20
- function canonical(value) {
21
- if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
22
- if (value && typeof value === "object") {
23
- return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`).join(",")}}`;
24
- }
25
- return JSON.stringify(value);
26
- }
27
-
28
- function digest(value) { return createHash("sha256").update(value).digest("hex"); }
29
-
30
- function sourceMetadata(source) {
31
- return {
32
- path: source?.path, profileRoot: source?.profileRoot, projectsRoot: source?.projectsRoot,
33
- pathDigest: source?.pathDigest, identity: source?.identity, size: source?.size,
34
- mtimeNs: source?.mtimeNs, ctimeNs: source?.ctimeNs,
35
- prefixBytes: source?.prefixBytes, prefixDigest: source?.prefixDigest
36
- };
37
- }
38
-
39
- function validSourceSnapshot(source) {
40
- return validSessionTimelineSourceMetadata(source)
41
- && Number.isSafeInteger(source?.prefixBytes) && source.prefixBytes >= 0 && source.prefixBytes <= 4096
42
- && source.prefixBytes <= source.size && /^[a-f0-9]{64}$/.test(source.prefixDigest || "");
43
- }
44
-
45
- function sameSourceSnapshot(left, right) {
46
- const first = sourceMetadata(left);
47
- const second = sourceMetadata(right);
48
- return validSourceSnapshot(first) && validSourceSnapshot(second)
49
- && ["path", "profileRoot", "projectsRoot", "pathDigest", "identity", "size", "mtimeNs", "ctimeNs", "prefixBytes", "prefixDigest"]
50
- .every((key) => first[key] === second[key]);
51
- }
52
-
53
- function eventDigest(value) {
54
- return typeof value === "string" && value.length > 0 && value.length <= 256 ? digest(value) : null;
55
- }
56
-
57
- function receiptDigest(root, value) {
58
- return digest(canonical({ schema: value.schema, id: value.id, rootDigest: sessionTimelineRootDigest(root), binding: value.binding,
59
- source: sourceMetadata(value.source), transportDigest: value.transportDigest, origin: value.origin,
60
- eventDigest: value.eventDigest, issuedAt: value.issuedAt, expiresAt: value.expiresAt, authority: value.authority }));
61
- }
62
-
63
- export function validHostTranscriptReceipt(value, root) {
64
- const issuedAt = new Date(value?.issuedAt).getTime();
65
- const expiresAt = new Date(value?.expiresAt).getTime();
66
- return value && value.schema === PRIVATE_TIMELINE_HOST_RECEIPT_SCHEMA && HOST_RECEIPT_RE.test(value.id || "")
67
- && value.rootDigest === sessionTimelineRootDigest(root) && validTimelineBinding(value.binding) && completeTimelineBinding(value.binding)
68
- && value.binding.groupId === null && validSourceSnapshot(value.source)
69
- && validTimelineTransportDigest(value.transportDigest) && value.origin === receiptOrigin(value.binding.host)
70
- && (value.eventDigest === null || /^[a-f0-9]{64}$/.test(value.eventDigest || "")) && Number.isFinite(issuedAt)
71
- && Number.isFinite(expiresAt) && expiresAt > issuedAt && expiresAt - issuedAt <= HOST_RECEIPT_TTL_MS + 1000
72
- && value.authority === AUTHORITY && /^[a-f0-9]{64}$/.test(value.receiptDigest || "")
73
- && value.receiptDigest === receiptDigest(root, value);
74
- }
75
-
76
- export function hostReceiptResult(receipt) {
77
- return { schema: PRIVATE_TIMELINE_HOST_RECEIPT_SCHEMA, status: "pending", receipt: receipt.id,
78
- expiresAt: receipt.expiresAt, authority: AUTHORITY };
79
- }
80
-
81
- export function hostReceiptUnavailable(reason) {
82
- return { schema: PRIVATE_TIMELINE_HOST_RECEIPT_SCHEMA, status: "unavailable", reason,
83
- receipt: null, expiresAt: null, authority: AUTHORITY };
84
- }
85
-
86
- export function purgeExpiredHostReceipts(state, current) {
87
- const retained = state.pendingReceipts.filter((item) => new Date(item.expiresAt).getTime() > current.getTime());
88
- const changed = retained.length !== state.pendingReceipts.length;
89
- state.pendingReceipts = retained;
90
- return changed;
91
- }
92
-
93
- export function makeHostTranscriptReceipt({ root, binding, source, transportDigest, current, eventId }) {
94
- const receipt = {
95
- schema: PRIVATE_TIMELINE_HOST_RECEIPT_SCHEMA, id: `asthr_${randomBytes(32).toString("base64url")}`,
96
- rootDigest: sessionTimelineRootDigest(root), binding: { ...binding }, source: sourceMetadata(source), transportDigest,
97
- origin: receiptOrigin(binding.host), eventDigest: eventDigest(eventId),
98
- issuedAt: current.toISOString(), expiresAt: new Date(current.getTime() + HOST_RECEIPT_TTL_MS).toISOString(),
99
- authority: AUTHORITY
100
- };
101
- receipt.receiptDigest = receiptDigest(root, receipt);
102
- return receipt;
103
- }
104
-
105
- export function sameIssuedHostTranscriptEvent(left, right) {
106
- return left.eventDigest === right.eventDigest
107
- && (left.eventDigest !== null || right.eventDigest === null)
108
- && sameTimelineBinding(left.binding, right.binding) && sameSourceSnapshot(left.source, right.source)
109
- && sameTimelineTransportDigest(left.transportDigest, right.transportDigest)
110
- && left.origin === right.origin;
111
- }
112
-
113
- export function sameHostReceiptSource(left, right) {
114
- return sameSourceSnapshot(left?.source ?? left, right?.source ?? right);
115
- }
116
-
117
- export function hostReceiptId(value) { return typeof value === "string" && HOST_RECEIPT_RE.test(value); }
@@ -1,201 +0,0 @@
1
- import { createHash, randomUUID } from "node:crypto";
2
- import { unlink, writeFile } from "node:fs/promises";
3
- import { replaceFileWithRetry } from "./filesystem-retry.js";
4
- import { withOwnedFileLock } from "./owned-file-lock.js";
5
- import {
6
- readAuthenticatedTimelineState, sealSessionTimelineState, sessionTimelinePrivatePaths,
7
- verifySessionTimelineState
8
- } from "./session-timeline-auth.js";
9
- import { sameTimelineTransportDigest, validTimelineTransportDigest } from "./session-timeline-transport.js";
10
- import { sessionTimelineRootDigest } from "./session-timeline-root.js";
11
-
12
- const SCHEMA = "agentspine.session-timeline-invocations/v1";
13
- const HEAD_SCHEMA = "agentspine.session-timeline-invocation-head/v1";
14
- const AUTHORITY = "context-only";
15
- const MAX_BYTES = 256 * 1024;
16
- const HEAD_MAX_BYTES = 64 * 1024;
17
- const MAX_PERMITS = 64;
18
- const PERMIT_TTL_MS = 60_000;
19
-
20
- function canonical(value) {
21
- if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
22
- if (value && typeof value === "object") {
23
- return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`).join(",")}}`;
24
- }
25
- return JSON.stringify(value);
26
- }
27
-
28
- function digest(value) { return createHash("sha256").update(value).digest("hex"); }
29
- function validDate(value) { return Number.isFinite(new Date(value).getTime()); }
30
- function validSignature(value) { return /^[a-f0-9]{64}$/.test(value || ""); }
31
- function validGeneration(value) { return Number.isSafeInteger(value) && value > 0; }
32
- function empty(root) {
33
- return { schema: SCHEMA, rootDigest: sessionTimelineRootDigest(root), permits: [], generation: 0,
34
- previousSignature: null, authority: AUTHORITY };
35
- }
36
-
37
- function validPermit(item) {
38
- return item && validSignature(item.requestDigest) && validTimelineTransportDigest(item.transportDigest)
39
- && validSignature(item.toolUseDigest) && validDate(item.expiresAt) && item.authority === AUTHORITY;
40
- }
41
-
42
- function validate(state, root) {
43
- if (!state || state.schema !== SCHEMA || state.rootDigest !== sessionTimelineRootDigest(root) || state.authority !== AUTHORITY
44
- || !validGeneration(state.generation) || !validSignature(state.signature)
45
- || (state.generation === 1 ? state.previousSignature !== null : !validSignature(state.previousSignature))
46
- || !Array.isArray(state.permits) || state.permits.length > MAX_PERMITS || !state.permits.every(validPermit)) {
47
- throw new Error("session timeline invocation state is invalid");
48
- }
49
- return state;
50
- }
51
-
52
- function validateHead(head, root) {
53
- if (!head || head.schema !== HEAD_SCHEMA || head.rootDigest !== sessionTimelineRootDigest(root) || head.authority !== AUTHORITY
54
- || !validGeneration(head.generation) || !validSignature(head.signature) || !validSignature(head.stateSignature)
55
- || (head.generation === 1 ? head.previousSignature !== null : !validSignature(head.previousSignature))) {
56
- throw new Error("session timeline invocation head is invalid");
57
- }
58
- return head;
59
- }
60
-
61
- async function readHead(path, root, assertStable) {
62
- const text = await readAuthenticatedTimelineState(path, HEAD_MAX_BYTES, assertStable);
63
- return verifySessionTimelineState(validateHead(JSON.parse(text), root));
64
- }
65
-
66
- function matchesHead(state, head) {
67
- return state.generation === head.generation && state.signature === head.stateSignature
68
- && state.previousSignature === head.previousSignature;
69
- }
70
-
71
- function recoverableForwardCommit(state, head) {
72
- return state.generation === head.generation + 1 && state.previousSignature === head.stateSignature;
73
- }
74
-
75
- async function readState(path, headPath, root, assertStable, assertOwned) {
76
- let text;
77
- try {
78
- text = await readAuthenticatedTimelineState(path, MAX_BYTES, assertStable);
79
- } catch (error) {
80
- if (error.code === "ENOENT") {
81
- try { await readHead(headPath, root, assertStable); }
82
- catch (headError) {
83
- if (headError.code === "ENOENT") return empty(root);
84
- throw headError;
85
- }
86
- throw new Error("session timeline invocation state is unavailable");
87
- }
88
- throw error;
89
- }
90
- const state = await verifySessionTimelineState(validate(JSON.parse(text), root));
91
- const head = await readHead(headPath, root, assertStable);
92
- if (matchesHead(state, head)) return state;
93
- if (!recoverableForwardCommit(state, head)) throw new Error("session timeline invocation replay was rejected");
94
- await saveHead(state, headPath, root, assertOwned, assertStable);
95
- return state;
96
- }
97
-
98
- async function writeSigned(value, path, maximumBytes, assertOwned, assertStable) {
99
- const assertWritable = async () => { await assertStable(); await assertOwned(); };
100
- await assertWritable();
101
- await sealSessionTimelineState(value);
102
- const content = `${JSON.stringify(value)}\n`;
103
- if (Buffer.byteLength(content) > maximumBytes) throw new Error("session timeline invocation integrity record exceeds its byte budget");
104
- const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
105
- await assertWritable();
106
- await writeFile(temporary, content, { mode: 0o600 });
107
- try {
108
- await replaceFileWithRetry(temporary, path, { beforeAttempt: assertWritable });
109
- await assertWritable();
110
- } catch (error) {
111
- await unlink(temporary).catch((cleanup) => { if (cleanup.code !== "ENOENT") error.cleanupError = cleanup; });
112
- throw error;
113
- }
114
- }
115
-
116
- async function saveHead(state, path, root, assertOwned, assertStable) {
117
- const head = { schema: HEAD_SCHEMA, rootDigest: sessionTimelineRootDigest(root), generation: state.generation,
118
- stateSignature: state.signature, previousSignature: state.previousSignature, authority: AUTHORITY };
119
- await writeSigned(head, path, HEAD_MAX_BYTES, assertOwned, assertStable);
120
- }
121
-
122
- async function saveState(state, path, headPath, root, assertOwned, assertStable) {
123
- if (!Number.isSafeInteger(state.generation) || state.generation < 0 || state.generation >= Number.MAX_SAFE_INTEGER) {
124
- throw new Error("session timeline invocation generation is invalid");
125
- }
126
- state.previousSignature = state.generation === 0 ? null : state.signature;
127
- state.generation += 1;
128
- delete state.signature;
129
- await writeSigned(state, path, MAX_BYTES, assertOwned, assertStable);
130
- validate(state, root);
131
- await saveHead(state, headPath, root, assertOwned, assertStable);
132
- }
133
-
134
- function requestDigest({ root, tool, binding, sourceDigest, request }) {
135
- if (!/^(index|search|capture)$/.test(tool || "") || !/^[a-f0-9]{64}$/.test(sourceDigest || "")
136
- || !binding || !request) {
137
- throw new Error("session timeline invocation binding is invalid");
138
- }
139
- return digest(canonical({ rootDigest: sessionTimelineRootDigest(root), tool, binding, sourceDigest, request }));
140
- }
141
-
142
- function purgeExpired(state, now) {
143
- const timestamp = now.getTime();
144
- state.permits = state.permits.filter((item) => new Date(item.expiresAt).getTime() > timestamp);
145
- }
146
-
147
- export async function issueSessionTimelineInvocation({
148
- root, tool, binding, sourceDigest, request, toolUseId, transportDigest, now = new Date()
149
- }) {
150
- const current = new Date(now);
151
- if (!Number.isFinite(current.getTime()) || typeof toolUseId !== "string" || toolUseId.length < 1 || toolUseId.length > 256) {
152
- throw new Error("session timeline invocation time or tool use is invalid");
153
- }
154
- if (!validTimelineTransportDigest(transportDigest)) throw new Error("session timeline transport is unavailable");
155
- const requested = requestDigest({ root, tool, binding, sourceDigest, request });
156
- const toolUseDigest = digest(toolUseId);
157
- const [names, heads] = await Promise.all([
158
- sessionTimelinePrivatePaths(root, "invocations"), sessionTimelinePrivatePaths(root, "invocation-head")
159
- ]);
160
- await withOwnedFileLock(names.lock, async ({ assertOwned }) => {
161
- const state = await readState(names.path, heads.path, root, names.assertStable, assertOwned);
162
- purgeExpired(state, current);
163
- if (state.permits.some((item) => item.toolUseDigest === toolUseDigest)) {
164
- throw new Error("session timeline invocation was already issued for this tool use");
165
- }
166
- state.permits.push({ requestDigest: requested, transportDigest, toolUseDigest,
167
- expiresAt: new Date(current.getTime() + PERMIT_TTL_MS).toISOString(), authority: AUTHORITY });
168
- state.permits = state.permits.slice(-MAX_PERMITS);
169
- await saveState(state, names.path, heads.path, root, assertOwned, names.assertStable);
170
- }, { assertPath: names.assertStable });
171
- return true;
172
- }
173
-
174
- export async function consumeSessionTimelineInvocation({
175
- root, tool, binding, sourceDigest, request, transportDigest, now = new Date()
176
- }) {
177
- const current = new Date(now);
178
- if (!Number.isFinite(current.getTime()) || !validTimelineTransportDigest(transportDigest)) {
179
- return false;
180
- }
181
- let requested;
182
- try { requested = requestDigest({ root, tool, binding, sourceDigest, request }); }
183
- catch { return false; }
184
- const [names, heads] = await Promise.all([
185
- sessionTimelinePrivatePaths(root, "invocations").catch(() => null),
186
- sessionTimelinePrivatePaths(root, "invocation-head").catch(() => null)
187
- ]);
188
- if (!names || !heads) return false;
189
- try {
190
- return await withOwnedFileLock(names.lock, async ({ assertOwned }) => {
191
- const state = await readState(names.path, heads.path, root, names.assertStable, assertOwned);
192
- purgeExpired(state, current);
193
- const index = state.permits.findIndex((item) => item.requestDigest === requested
194
- && sameTimelineTransportDigest(item.transportDigest, transportDigest));
195
- if (index < 0) return false;
196
- state.permits.splice(index, 1);
197
- await saveState(state, names.path, heads.path, root, assertOwned, names.assertStable);
198
- return true;
199
- }, { assertPath: names.assertStable });
200
- } catch { return false; }
201
- }
@@ -1,93 +0,0 @@
1
- import { constants } from "node:fs";
2
- import { open } from "node:fs/promises";
3
- import { basename, dirname } from "node:path";
4
- import { matchesSourceMetadata } from "./session-timeline-source.js";
5
-
6
- export const KING_HISTORY_ADAPTER = "king-agent-wire-jsonl/v1";
7
- export const KING_HISTORY_CONTRACT_COMMIT = "fbb97459a3fa2157f8bfea3d24931be63288ab11";
8
- export const KING_HISTORY_RUNTIME_VERSION = "0.12.1";
9
- const HEADER_BYTES = 64 * 1024;
10
- const ID = /^[A-Za-z0-9][A-Za-z0-9:_.@/-]{0,127}$/;
11
- const VERSION = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,63}$/;
12
- const RECORDS = new Set([
13
- "metadata", "forked", "turn.prompt", "turn.steer", "turn.cancel", "config.update",
14
- "permission.set_mode", "permission.record_approval_result", "full_compaction.begin",
15
- "plan_mode.enter", "plan_mode.cancel", "plan_mode.exit", "swarm_mode.enter", "swarm_mode.exit",
16
- "tools.register_user_tool", "tools.unregister_user_tool", "tools.set_active_tools", "usage.record",
17
- "full_compaction.cancel", "full_compaction.complete", "micro_compaction.apply",
18
- "context.append_message", "context.append_loop_event", "context.clear", "context.apply_compaction",
19
- "context.undo", "tools.update_store", "goal.create", "goal.update", "goal.clear"
20
- ]);
21
-
22
- function sessionDirectory(path) {
23
- return basename(dirname(dirname(dirname(path))));
24
- }
25
-
26
- function exactWirePath(path, sessionId) {
27
- const agent = dirname(path);
28
- const agents = dirname(agent);
29
- const session = dirname(agents);
30
- return basename(path) === "wire.jsonl" && basename(agent) === "main" && basename(agents) === "agents"
31
- && [sessionId, sessionId.startsWith("session_") ? sessionId : `session_${sessionId}`].includes(basename(session))
32
- && sessionDirectory(path) === basename(session);
33
- }
34
-
35
- export async function validateKingTimelineHeader({ source, sessionId, protocolVersion }) {
36
- if (!ID.test(sessionId || "") || !VERSION.test(protocolVersion || "")
37
- || !exactWirePath(source.path, sessionId)) return false;
38
- let handle;
39
- try {
40
- handle = await open(source.path, constants.O_RDONLY | (constants.O_NOFOLLOW || 0));
41
- if (!matchesSourceMetadata(await handle.stat({ bigint: true }), source)) return false;
42
- const bytes = Buffer.alloc(Math.min(source.size, HEADER_BYTES));
43
- const read = await handle.read(bytes, 0, bytes.length, 0);
44
- const end = bytes.indexOf(0x0a);
45
- if (read.bytesRead !== bytes.length || end < 0) return false;
46
- const line = JSON.parse(bytes.subarray(0, end).toString("utf8"));
47
- const keys = Object.keys(line).sort();
48
- const allowed = line.time === undefined ? ["created_at", "protocol_version", "type"]
49
- : ["created_at", "protocol_version", "time", "type"];
50
- if (keys.join("\0") !== allowed.sort().join("\0") || line.type !== "metadata"
51
- || line.protocol_version !== protocolVersion || !Number.isSafeInteger(line.created_at)
52
- || line.created_at <= 0 || (line.time !== undefined && (!Number.isSafeInteger(line.time) || line.time <= 0))) return false;
53
- return matchesSourceMetadata(await handle.stat({ bigint: true }), source);
54
- } catch { return false; }
55
- finally { await handle?.close(); }
56
- }
57
-
58
- function textOutput(value) {
59
- if (typeof value === "string") return value;
60
- if (!Array.isArray(value) || value.length > 12) return null;
61
- if (value.some((part) => !part || !["text", "input_text", "output_text"].includes(part.type)
62
- || typeof part.text !== "string")) return null;
63
- return value.map((part) => part.text).join("\n");
64
- }
65
-
66
- export function kingTimelineToolResult(line) {
67
- if (!RECORDS.has(line?.type) || line.schema_version !== undefined) {
68
- throw new Error("king-history-format-mismatch");
69
- }
70
- if (line.type !== "context.append_loop_event") return null;
71
- const event = line.event;
72
- if (!event || event.type !== "tool.result" || !ID.test(event.toolCallId || "")
73
- || !event.result || typeof event.result !== "object") return null;
74
- const output = textOutput(event.result.output);
75
- if (output === null) return null;
76
- const at = Number.isSafeInteger(line.time) && line.time > 0 ? new Date(line.time) : null;
77
- if (!at || !Number.isFinite(at.getTime())) return null;
78
- return { role: "tool", content: output, nativeMessageId: event.toolCallId, at: at.toISOString() };
79
- }
80
-
81
- export function kingTimelineUserMessage(line) {
82
- if (!RECORDS.has(line?.type) || line.schema_version !== undefined) {
83
- throw new Error("king-history-format-mismatch");
84
- }
85
- if (line.type !== "context.append_message" || line.message?.role !== "user") return null;
86
- const content = textOutput(line.message.content);
87
- const nativeMessageId = line.message.id === undefined ? undefined
88
- : ID.test(line.message.id) ? line.message.id : null;
89
- const at = Number.isSafeInteger(line.time) && line.time > 0 ? new Date(line.time) : null;
90
- if (content === null || nativeMessageId === null || !at || !Number.isFinite(at.getTime())) return null;
91
- return { role: "user", content, at: at.toISOString(),
92
- ...(nativeMessageId ? { nativeMessageId } : {}) };
93
- }
@@ -1,57 +0,0 @@
1
- import { createHash } from "node:crypto";
2
- import { matchesTimelineEvent, rankTimelineEvents } from "./session-timeline-query.js";
3
- const CONTINUITY_FIELDS = ["entityId", "userId", "tenantId", "projectId", "taskId", "portalRef", "threadRef"];
4
- const REFERENCE_FIELDS = ["host", ...CONTINUITY_FIELDS, "sessionId"];
5
- function digest(value) {
6
- return createHash("sha256").update(value).digest("hex");
7
- }
8
- function sameContinuationScope(candidate, current, includePriorProviders) {
9
- return candidate.groupId === null && current.groupId === null
10
- && (candidate.host !== current.host || candidate.sessionId !== current.sessionId)
11
- && (includePriorProviders || candidate.host === current.host)
12
- && CONTINUITY_FIELDS.every((field) => (candidate[field] ?? null) === (current[field] ?? null))
13
- && (!candidate.goalId || !current.goalId || candidate.goalId === current.goalId);
14
- }
15
- export function timelineSessionReference(binding) {
16
- const fields = binding.portalRef || binding.threadRef ? [...REFERENCE_FIELDS, "portalRef", "threadRef"] : REFERENCE_FIELDS;
17
- const material = fields
18
- .map((field) => `${field}:${binding[field] || ""}`).join("\0");
19
- return `session-ref:${digest(material).slice(0, 32)}`;
20
- }
21
- export function priorTimelineSources(state, scoped, { includePriorProviders = false } = {}) {
22
- return state.sources.filter((source) => sameContinuationScope(source.binding, scoped, includePriorProviders))
23
- .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
24
- }
25
- export function selectPriorTimelineSource(state, scoped, { target, wanted, windowMs, includePriorProviders = false, sessionRef = null }) {
26
- const eligible = priorTimelineSources(state, scoped, { includePriorProviders })
27
- .filter((source) => !sessionRef || timelineSessionReference(source.binding) === sessionRef);
28
- const indexed = eligible.flatMap((source, sourceIndex) => rankTimelineEvents(source.events
29
- .filter((event) => matchesTimelineEvent(event, wanted, target, windowMs)), wanted, target)
30
- .slice(0, 8).map((event) => ({ ...event, sourceIndex })));
31
- const ranked = rankTimelineEvents(indexed, wanted, target);
32
- return eligible[ranked[0]?.sourceIndex ?? 0] || null;
33
- }
34
- export function priorTimelineHint(state, scoped, sourceDigest, { includePriorProviders = false } = {}) {
35
- const sources = priorTimelineSources(state, scoped, { includePriorProviders });
36
- const latest = sources.flatMap((source) => source.events.map((event) => ({ source, event })))
37
- .sort((left, right) => right.event.at.localeCompare(left.event.at))[0] || null;
38
- return {
39
- available: sources.length > 0,
40
- sessions: sources.length,
41
- indexedEvents: sources.reduce((total, source) => total + source.events.length, 0),
42
- latest: latest ? {
43
- sessionRef: timelineSessionReference(latest.source.binding),
44
- messageRef: latest.event.id,
45
- sourceProvider: latest.source.binding.host,
46
- ...(latest.source.binding.portalRef && latest.source.binding.threadRef
47
- ? { portalRef: latest.source.binding.portalRef, threadRef: latest.source.binding.threadRef } : {}),
48
- sourceDigest: sourceDigest(latest.source),
49
- at: latest.event.at,
50
- outcome: latest.event.outcome,
51
- testLabel: latest.event.testLabel
52
- } : null,
53
- instruction: null,
54
- freshness: "source-not-read",
55
- authority: "context-only"
56
- };
57
- }
@@ -1,36 +0,0 @@
1
- export const TIMELINE_HOSTS = Object.freeze(["claude", "codex", "king"]);
2
- export const KING_TIMELINE_SOURCE_ENV = "AGENTSPINE_KING_TIMELINE_SOURCE";
3
- export const KING_WIRE_PROTOCOL_ENV = "AGENTSPINE_KING_WIRE_PROTOCOL_VERSION";
4
- export const TIMELINE_CROSS_PROVIDER_ENV = "AGENTSPINE_TIMELINE_CROSS_PROVIDER";
5
-
6
- export function validTimelineHost(value) {
7
- return TIMELINE_HOSTS.includes(value);
8
- }
9
-
10
- export function crossProviderTimelineEnabled(environment = process.env) {
11
- return environment?.[TIMELINE_CROSS_PROVIDER_ENV] === "1";
12
- }
13
-
14
- export function timelineHostForRuntime(host, environment = process.env) {
15
- if (environment?.BLUN_HOME || environment?.BLUN_PLUGIN_ROOT) return "king";
16
- return validTimelineHost(host) ? host : null;
17
- }
18
-
19
- export function runtimeHostForTimeline(host) {
20
- return host === "king" ? "codex" : host;
21
- }
22
-
23
- export function timelineHostHome(host, environment = process.env) {
24
- if (host === "king") return environment?.BLUN_HOME ?? null;
25
- if (host === "codex") return environment?.CODEX_HOME ?? null;
26
- return host === "claude" ? environment?.CLAUDE_CONFIG_DIR ?? null : null;
27
- }
28
-
29
- export function timelineSourceFromRuntime(host, input, environment = process.env) {
30
- if (host === "king") return environment?.[KING_TIMELINE_SOURCE_ENV] ?? null;
31
- return input?.transcript_path ?? input?.transcriptPath ?? null;
32
- }
33
-
34
- export function timelineProtocolFromRuntime(host, environment = process.env) {
35
- return host === "king" ? environment?.[KING_WIRE_PROTOCOL_ENV] ?? null : null;
36
- }
@@ -1,56 +0,0 @@
1
- const STOP_WORDS = new Set([
2
- "about", "after", "before", "diese", "dieser", "einem", "einen", "einer", "eines", "haben", "heute",
3
- "ihrem", "ihren", "immer", "nicht", "schon", "sollte", "the", "this", "that", "with", "without", "what",
4
- "when", "where", "which", "would"
5
- ]);
6
-
7
- export function timelineTerms(value) {
8
- return [...new Set((String(value || "").toLowerCase().normalize("NFKC").match(/[\p{L}\p{N}]{3,}/gu) || [])
9
- .filter((item) => !STOP_WORDS.has(item)))].slice(0, 24);
10
- }
11
-
12
- export function exactTimelineUtc(value) {
13
- if (typeof value !== "string" || !/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d{3})?Z$/.test(value)) {
14
- throw new Error("timeline timestamp must be exact UTC ISO-8601");
15
- }
16
- const parsed = new Date(value);
17
- if (!Number.isFinite(parsed.getTime())) throw new Error("timeline timestamp must be exact UTC ISO-8601");
18
- const canonical = value.includes(".") ? parsed.toISOString() : parsed.toISOString().replace(".000Z", "Z");
19
- if (canonical !== value) throw new Error("timeline timestamp must be exact UTC ISO-8601");
20
- return parsed;
21
- }
22
-
23
- export function timelineQuery({ at, query }) {
24
- const target = at === undefined || at === null || at === "" ? null : exactTimelineUtc(at);
25
- if (query === undefined || query === null || query === "") {
26
- if (!target) throw new Error("timeline search requires an exact UTC timestamp or two specific terms");
27
- return { target, wanted: [] };
28
- }
29
- if (typeof query !== "string" || query.length < 3 || query.length > 512) throw new Error("timeline query is invalid");
30
- const wanted = timelineTerms(query);
31
- if (wanted.length < 2) throw new Error("timeline query requires at least two specific terms");
32
- return { target, wanted: wanted.slice(0, 16) };
33
- }
34
-
35
- export function matchesTimelineEvent(event, wanted, target, windowMs) {
36
- if (event.kind === "user-message-candidate" && !(wanted.includes("user") && wanted.includes("message"))) return false;
37
- return (!target || Math.abs(new Date(event.at).getTime() - target.getTime()) <= windowMs)
38
- && (!wanted.length || wanted.filter((term) => event.terms.includes(term)).length >= 2);
39
- }
40
-
41
- export function rankTimelineEvents(events, wanted, target) {
42
- return [...events].sort((left, right) => {
43
- if (target) {
44
- const distance = Math.abs(new Date(left.at).getTime() - target.getTime())
45
- - Math.abs(new Date(right.at).getTime() - target.getTime());
46
- if (distance) return distance;
47
- }
48
- const overlap = wanted.filter((term) => right.terms.includes(term)).length
49
- - wanted.filter((term) => left.terms.includes(term)).length;
50
- return overlap || right.at.localeCompare(left.at) || left.offset - right.offset;
51
- });
52
- }
53
-
54
- export function timelineRoomId(sourceDigest, offset, roomBytes) {
55
- return `room:${sourceDigest.slice(0, 24)}:${Math.floor(offset / roomBytes) + 1}`;
56
- }