blun-king-cli 9.1.643 → 9.1.644

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 (266) hide show
  1. package/LIESMICH.txt +18 -0
  2. package/README.md +20 -6
  3. package/bin/blun.js +3 -3
  4. package/bin/king.js +3 -3
  5. package/bin/launcher-mode.js +125 -126
  6. package/bin/launcher-runtime.js +603 -616
  7. package/bin/plugin-bootstrap.js +339 -405
  8. package/bin/rename-private-staging.cjs +2 -2
  9. package/bin/retired-bundled-plugins.cjs +84 -0
  10. package/bin/startup-security-host.cjs +105 -0
  11. package/bin/startup-security.cjs +9 -105
  12. package/bin/startup-warning-policy.cjs +22 -0
  13. package/bin/update-lease-installer.cjs +125 -0
  14. package/bin/update-lease-sockets.cjs +228 -0
  15. package/bin/update-lease.js +22 -327
  16. package/bin/verify-bundled-agent-sources.cjs +2 -4
  17. package/blun.mjs +18 -179
  18. package/bundled-agent-sources.json +1 -552
  19. package/package.json +1 -5
  20. package/tool-liveness642/receipt.json +1 -1
  21. package/worker-host.mjs +3 -119
  22. package/agent-spine-plugin/.claude-plugin/marketplace.json +0 -20
  23. package/agent-spine-plugin/.claude-plugin/plugin.json +0 -14
  24. package/agent-spine-plugin/.codex-plugin/plugin.json +0 -47
  25. package/agent-spine-plugin/.mcp.json +0 -8
  26. package/agent-spine-plugin/CHANGELOG.md +0 -1614
  27. package/agent-spine-plugin/LICENSE +0 -186
  28. package/agent-spine-plugin/README.md +0 -432
  29. package/agent-spine-plugin/assets/agentspine-banner.svg +0 -32
  30. package/agent-spine-plugin/bin/agentspine-mcp.js +0 -4
  31. package/agent-spine-plugin/bin/agentspine.js +0 -7
  32. package/agent-spine-plugin/blun.plugin.json +0 -68
  33. package/agent-spine-plugin/docs/acceptance.md +0 -61
  34. package/agent-spine-plugin/docs/artifact-evaluation.md +0 -93
  35. package/agent-spine-plugin/docs/host-integration.md +0 -193
  36. package/agent-spine-plugin/docs/preflight-recall.md +0 -71
  37. package/agent-spine-plugin/docs/preservation-contract.md +0 -53
  38. package/agent-spine-plugin/docs/quality-gates.md +0 -50
  39. package/agent-spine-plugin/docs/session-timeline.md +0 -112
  40. package/agent-spine-plugin/docs/source-roots.md +0 -113
  41. package/agent-spine-plugin/docs/world-model.md +0 -119
  42. package/agent-spine-plugin/hooks/codex.json +0 -47
  43. package/agent-spine-plugin/hooks/hooks.json +0 -106
  44. package/agent-spine-plugin/hooks/version.json +0 -5
  45. package/agent-spine-plugin/package.json +0 -77
  46. package/agent-spine-plugin/scripts/check-codex-install.js +0 -226
  47. package/agent-spine-plugin/scripts/check-hosts.js +0 -208
  48. package/agent-spine-plugin/scripts/check-install-hook.js +0 -227
  49. package/agent-spine-plugin/scripts/check-install-selfstarter.js +0 -154
  50. package/agent-spine-plugin/scripts/check-install.js +0 -478
  51. package/agent-spine-plugin/scripts/check-line-budget.js +0 -58
  52. package/agent-spine-plugin/scripts/check-syntax.js +0 -29
  53. package/agent-spine-plugin/scripts/github-actions.js +0 -11
  54. package/agent-spine-plugin/scripts/hermetic-process.js +0 -191
  55. package/agent-spine-plugin/scripts/release-check.js +0 -150
  56. package/agent-spine-plugin/scripts/run-acceptance.js +0 -19
  57. package/agent-spine-plugin/scripts/run-checks.js +0 -50
  58. package/agent-spine-plugin/scripts/run-tests-hermetic.js +0 -112
  59. package/agent-spine-plugin/skills/agent-spine/SKILL.md +0 -99
  60. package/agent-spine-plugin/spine-example/1-identity.md +0 -12
  61. package/agent-spine-plugin/spine-example/2-voice.md +0 -6
  62. package/agent-spine-plugin/spine-example/3-conduct.md +0 -8
  63. package/agent-spine-plugin/spine-example/4-history.md +0 -4
  64. package/agent-spine-plugin/src/cli-agent.js +0 -315
  65. package/agent-spine-plugin/src/cli-attention.js +0 -95
  66. package/agent-spine-plugin/src/cli-autonomy.js +0 -36
  67. package/agent-spine-plugin/src/cli-common.js +0 -71
  68. package/agent-spine-plugin/src/cli-continuity.js +0 -116
  69. package/agent-spine-plugin/src/cli-core.js +0 -128
  70. package/agent-spine-plugin/src/cli-diagnostics.js +0 -291
  71. package/agent-spine-plugin/src/cli-host.js +0 -21
  72. package/agent-spine-plugin/src/cli-learning.js +0 -320
  73. package/agent-spine-plugin/src/cli-premortem.js +0 -16
  74. package/agent-spine-plugin/src/cli-sharing.js +0 -230
  75. package/agent-spine-plugin/src/cli.js +0 -181
  76. package/agent-spine-plugin/src/codex-reader-launcher.js +0 -182
  77. package/agent-spine-plugin/src/hook.js +0 -500
  78. package/agent-spine-plugin/src/index.js +0 -108
  79. package/agent-spine-plugin/src/lib/acceptance.js +0 -435
  80. package/agent-spine-plugin/src/lib/action-lesson-recall.js +0 -118
  81. package/agent-spine-plugin/src/lib/attention-context.js +0 -167
  82. package/agent-spine-plugin/src/lib/attention-events.js +0 -113
  83. package/agent-spine-plugin/src/lib/attention-privacy.js +0 -72
  84. package/agent-spine-plugin/src/lib/attention-schema.js +0 -164
  85. package/agent-spine-plugin/src/lib/attention-storage.js +0 -93
  86. package/agent-spine-plugin/src/lib/attention.js +0 -164
  87. package/agent-spine-plugin/src/lib/audit-premortem.js +0 -223
  88. package/agent-spine-plugin/src/lib/audit.js +0 -401
  89. package/agent-spine-plugin/src/lib/authentication.js +0 -515
  90. package/agent-spine-plugin/src/lib/autonomy-policy.js +0 -110
  91. package/agent-spine-plugin/src/lib/autonomy-store.js +0 -202
  92. package/agent-spine-plugin/src/lib/autonomy.js +0 -8
  93. package/agent-spine-plugin/src/lib/briefing.js +0 -493
  94. package/agent-spine-plugin/src/lib/catalog-document-read.js +0 -51
  95. package/agent-spine-plugin/src/lib/catalog.js +0 -167
  96. package/agent-spine-plugin/src/lib/channel-continuity.js +0 -19
  97. package/agent-spine-plugin/src/lib/channel-runtime.js +0 -665
  98. package/agent-spine-plugin/src/lib/codex-installation.js +0 -231
  99. package/agent-spine-plugin/src/lib/codex-skill-installation.js +0 -211
  100. package/agent-spine-plugin/src/lib/context.js +0 -156
  101. package/agent-spine-plugin/src/lib/continuity.js +0 -338
  102. package/agent-spine-plugin/src/lib/coordination.js +0 -577
  103. package/agent-spine-plugin/src/lib/delivery-agent-usage.js +0 -231
  104. package/agent-spine-plugin/src/lib/delivery-assignment.js +0 -220
  105. package/agent-spine-plugin/src/lib/delivery-command-actions.js +0 -462
  106. package/agent-spine-plugin/src/lib/delivery-knowledge.js +0 -78
  107. package/agent-spine-plugin/src/lib/delivery-premortem-binding.js +0 -107
  108. package/agent-spine-plugin/src/lib/delivery-premortem-closure.js +0 -171
  109. package/agent-spine-plugin/src/lib/delivery-premortem-codec.js +0 -45
  110. package/agent-spine-plugin/src/lib/delivery-premortem-correction.js +0 -101
  111. package/agent-spine-plugin/src/lib/delivery-premortem-file.js +0 -21
  112. package/agent-spine-plugin/src/lib/delivery-premortem-index.js +0 -493
  113. package/agent-spine-plugin/src/lib/delivery-premortem-inspection.js +0 -37
  114. package/agent-spine-plugin/src/lib/delivery-premortem-recovery.js +0 -120
  115. package/agent-spine-plugin/src/lib/delivery-premortem-rejection.js +0 -65
  116. package/agent-spine-plugin/src/lib/delivery-premortem-results.js +0 -28
  117. package/agent-spine-plugin/src/lib/delivery-premortem-session-guard.js +0 -46
  118. package/agent-spine-plugin/src/lib/delivery-premortem-write-ledger.js +0 -285
  119. package/agent-spine-plugin/src/lib/delivery-premortem.js +0 -499
  120. package/agent-spine-plugin/src/lib/delivery-shell-heredoc.js +0 -115
  121. package/agent-spine-plugin/src/lib/delivery-shell-substitutions.js +0 -111
  122. package/agent-spine-plugin/src/lib/delivery-shell-wrapper.js +0 -64
  123. package/agent-spine-plugin/src/lib/delivery-target.js +0 -73
  124. package/agent-spine-plugin/src/lib/delivery-verification.js +0 -445
  125. package/agent-spine-plugin/src/lib/documents.js +0 -239
  126. package/agent-spine-plugin/src/lib/feed-transport.js +0 -499
  127. package/agent-spine-plugin/src/lib/filesystem-retry.js +0 -34
  128. package/agent-spine-plugin/src/lib/gateway-common.js +0 -68
  129. package/agent-spine-plugin/src/lib/gateway-control.js +0 -370
  130. package/agent-spine-plugin/src/lib/gateway-delivery.js +0 -103
  131. package/agent-spine-plugin/src/lib/gateway-execution.js +0 -350
  132. package/agent-spine-plugin/src/lib/gateway-group-response.js +0 -128
  133. package/agent-spine-plugin/src/lib/gateway-host-fencing.js +0 -92
  134. package/agent-spine-plugin/src/lib/gateway-host-lifecycle.js +0 -193
  135. package/agent-spine-plugin/src/lib/gateway-inspection.js +0 -85
  136. package/agent-spine-plugin/src/lib/gateway-knowledge.js +0 -129
  137. package/agent-spine-plugin/src/lib/gateway-policy-provenance.js +0 -197
  138. package/agent-spine-plugin/src/lib/gateway-premortem-disposition.js +0 -82
  139. package/agent-spine-plugin/src/lib/gateway-premortem.js +0 -363
  140. package/agent-spine-plugin/src/lib/gateway-prepared-host.js +0 -28
  141. package/agent-spine-plugin/src/lib/gateway-runs.js +0 -345
  142. package/agent-spine-plugin/src/lib/gateway-runtime-identity.js +0 -31
  143. package/agent-spine-plugin/src/lib/gateway-runtime-records.js +0 -21
  144. package/agent-spine-plugin/src/lib/gateway-runtime.js +0 -18
  145. package/agent-spine-plugin/src/lib/gateway-state-transaction.js +0 -356
  146. package/agent-spine-plugin/src/lib/gateway-state.js +0 -344
  147. package/agent-spine-plugin/src/lib/graph.js +0 -337
  148. package/agent-spine-plugin/src/lib/hook-artifact-guards.js +0 -356
  149. package/agent-spine-plugin/src/lib/hook-audit.js +0 -43
  150. package/agent-spine-plugin/src/lib/hook-briefing-use.js +0 -78
  151. package/agent-spine-plugin/src/lib/hook-context.js +0 -441
  152. package/agent-spine-plugin/src/lib/hook-final-message.js +0 -26
  153. package/agent-spine-plugin/src/lib/hook-input.js +0 -27
  154. package/agent-spine-plugin/src/lib/hook-output.js +0 -284
  155. package/agent-spine-plugin/src/lib/hook-premortem.js +0 -257
  156. package/agent-spine-plugin/src/lib/hook-process-advisory.js +0 -36
  157. package/agent-spine-plugin/src/lib/hook-protection.js +0 -95
  158. package/agent-spine-plugin/src/lib/hook-stop-verification.js +0 -84
  159. package/agent-spine-plugin/src/lib/hook-timeline.js +0 -102
  160. package/agent-spine-plugin/src/lib/host-instruction-budget.js +0 -11
  161. package/agent-spine-plugin/src/lib/https-transport.js +0 -392
  162. package/agent-spine-plugin/src/lib/identifier-analysis.js +0 -446
  163. package/agent-spine-plugin/src/lib/indexed-memory-offline.js +0 -40
  164. package/agent-spine-plugin/src/lib/indexed-memory.js +0 -298
  165. package/agent-spine-plugin/src/lib/knowledge-evidence.js +0 -431
  166. package/agent-spine-plugin/src/lib/learning-applications.js +0 -441
  167. package/agent-spine-plugin/src/lib/learning-artifact-evaluator.js +0 -114
  168. package/agent-spine-plugin/src/lib/learning-candidates.js +0 -274
  169. package/agent-spine-plugin/src/lib/learning-context.js +0 -137
  170. package/agent-spine-plugin/src/lib/learning-delivery-contracts.js +0 -310
  171. package/agent-spine-plugin/src/lib/learning-evaluation-contracts.js +0 -350
  172. package/agent-spine-plugin/src/lib/learning-evaluation-registration.js +0 -372
  173. package/agent-spine-plugin/src/lib/learning-evaluation-revocation.js +0 -292
  174. package/agent-spine-plugin/src/lib/learning-evidence-contracts.js +0 -321
  175. package/agent-spine-plugin/src/lib/learning-findings.js +0 -458
  176. package/agent-spine-plugin/src/lib/learning-measurement-contracts.js +0 -285
  177. package/agent-spine-plugin/src/lib/learning-measurements.js +0 -265
  178. package/agent-spine-plugin/src/lib/learning-outcome-contracts.js +0 -165
  179. package/agent-spine-plugin/src/lib/learning-outcomes.js +0 -343
  180. package/agent-spine-plugin/src/lib/learning-reconciliation.js +0 -290
  181. package/agent-spine-plugin/src/lib/learning-retry-contracts.js +0 -188
  182. package/agent-spine-plugin/src/lib/learning-schema.js +0 -229
  183. package/agent-spine-plugin/src/lib/learning-scope-targets.js +0 -424
  184. package/agent-spine-plugin/src/lib/learning-state-upgrade.js +0 -477
  185. package/agent-spine-plugin/src/lib/learning-status-configuration.js +0 -476
  186. package/agent-spine-plugin/src/lib/learning-storage.js +0 -203
  187. package/agent-spine-plugin/src/lib/learning-trial-recovery.js +0 -218
  188. package/agent-spine-plugin/src/lib/learning-validation-contracts.js +0 -375
  189. package/agent-spine-plugin/src/lib/learning-validation-renewal.js +0 -298
  190. package/agent-spine-plugin/src/lib/learning-validation-runtime.js +0 -234
  191. package/agent-spine-plugin/src/lib/learning.js +0 -36
  192. package/agent-spine-plugin/src/lib/lesson-recall-session.js +0 -172
  193. package/agent-spine-plugin/src/lib/mcp-autonomy-tools.js +0 -37
  194. package/agent-spine-plugin/src/lib/mcp-delivery-completion.js +0 -124
  195. package/agent-spine-plugin/src/lib/mcp-delivery-tools.js +0 -45
  196. package/agent-spine-plugin/src/lib/mcp-premortem.js +0 -68
  197. package/agent-spine-plugin/src/lib/mcp-runtime.js +0 -355
  198. package/agent-spine-plugin/src/lib/mcp-source-context.js +0 -61
  199. package/agent-spine-plugin/src/lib/mcp-timeline-tools.js +0 -240
  200. package/agent-spine-plugin/src/lib/mcp-world-tools.js +0 -52
  201. package/agent-spine-plugin/src/lib/object-transport.js +0 -206
  202. package/agent-spine-plugin/src/lib/owned-file-lock.js +0 -182
  203. package/agent-spine-plugin/src/lib/paths.js +0 -109
  204. package/agent-spine-plugin/src/lib/peer-transport.js +0 -283
  205. package/agent-spine-plugin/src/lib/persona-runtime.js +0 -581
  206. package/agent-spine-plugin/src/lib/pre-answer-timeline-recall.js +0 -104
  207. package/agent-spine-plugin/src/lib/preflight-delivery-id.js +0 -27
  208. package/agent-spine-plugin/src/lib/preflight.js +0 -688
  209. package/agent-spine-plugin/src/lib/project-portfolio.js +0 -176
  210. package/agent-spine-plugin/src/lib/runtime.js +0 -13
  211. package/agent-spine-plugin/src/lib/selfstarter-core.js +0 -382
  212. package/agent-spine-plugin/src/lib/selfstarter-jobs.js +0 -149
  213. package/agent-spine-plugin/src/lib/selfstarter-lease.js +0 -204
  214. package/agent-spine-plugin/src/lib/selfstarter-policy.js +0 -90
  215. package/agent-spine-plugin/src/lib/selfstarter-workspace.js +0 -111
  216. package/agent-spine-plugin/src/lib/selfstarter.js +0 -11
  217. package/agent-spine-plugin/src/lib/session-timeline-auth.js +0 -316
  218. package/agent-spine-plugin/src/lib/session-timeline-codex.js +0 -69
  219. package/agent-spine-plugin/src/lib/session-timeline-contract.js +0 -56
  220. package/agent-spine-plugin/src/lib/session-timeline-enrollment-source.js +0 -38
  221. package/agent-spine-plugin/src/lib/session-timeline-enrollment-storage.js +0 -128
  222. package/agent-spine-plugin/src/lib/session-timeline-enrollment-transport.js +0 -15
  223. package/agent-spine-plugin/src/lib/session-timeline-enrollment.js +0 -478
  224. package/agent-spine-plugin/src/lib/session-timeline-event-extract.js +0 -186
  225. package/agent-spine-plugin/src/lib/session-timeline-host-origin.js +0 -73
  226. package/agent-spine-plugin/src/lib/session-timeline-host-receipt.js +0 -117
  227. package/agent-spine-plugin/src/lib/session-timeline-invocation.js +0 -201
  228. package/agent-spine-plugin/src/lib/session-timeline-king.js +0 -93
  229. package/agent-spine-plugin/src/lib/session-timeline-prior.js +0 -57
  230. package/agent-spine-plugin/src/lib/session-timeline-provider.js +0 -36
  231. package/agent-spine-plugin/src/lib/session-timeline-query.js +0 -56
  232. package/agent-spine-plugin/src/lib/session-timeline-results.js +0 -56
  233. package/agent-spine-plugin/src/lib/session-timeline-root.js +0 -11
  234. package/agent-spine-plugin/src/lib/session-timeline-search.js +0 -82
  235. package/agent-spine-plugin/src/lib/session-timeline-sid-acl.js +0 -213
  236. package/agent-spine-plugin/src/lib/session-timeline-source-open.js +0 -30
  237. package/agent-spine-plugin/src/lib/session-timeline-source.js +0 -80
  238. package/agent-spine-plugin/src/lib/session-timeline-state.js +0 -45
  239. package/agent-spine-plugin/src/lib/session-timeline-transport.js +0 -42
  240. package/agent-spine-plugin/src/lib/session-timeline-windows-acl.js +0 -145
  241. package/agent-spine-plugin/src/lib/session-timeline.js +0 -462
  242. package/agent-spine-plugin/src/lib/sharing.js +0 -969
  243. package/agent-spine-plugin/src/lib/source-roots.js +0 -475
  244. package/agent-spine-plugin/src/lib/source-tree-scan.js +0 -178
  245. package/agent-spine-plugin/src/lib/sqlite-transport.js +0 -501
  246. package/agent-spine-plugin/src/lib/task-knowledge-context.js +0 -99
  247. package/agent-spine-plugin/src/lib/telegram-adapter.js +0 -119
  248. package/agent-spine-plugin/src/lib/timeline-continuation-update.js +0 -100
  249. package/agent-spine-plugin/src/lib/timeline-tool-guard.js +0 -225
  250. package/agent-spine-plugin/src/lib/timeline-user-feedback.js +0 -216
  251. package/agent-spine-plugin/src/lib/timeline-world-capture.js +0 -233
  252. package/agent-spine-plugin/src/lib/voice-runtime.js +0 -39
  253. package/agent-spine-plugin/src/lib/world-knowledge.js +0 -306
  254. package/agent-spine-plugin/src/lib/world-model.js +0 -333
  255. package/agent-spine-plugin/src/mcp.js +0 -456
  256. package/agent-spine-plugin/src/version.js +0 -1
  257. package/agent-spine-plugin/src/worker.js +0 -257
  258. package/bin/agentspine-king-goal-inbox.mjs +0 -127
  259. package/bin/agentspine-king-goal-intake.mjs +0 -106
  260. package/bin/agentspine-king-host-runner.mjs +0 -109
  261. package/bin/agentspine-king-snapshot-policy.cjs +0 -80
  262. package/bin/agentspine-king-status-policy.mjs +0 -226
  263. package/bin/agentspine-king-worker-host.mjs +0 -160
  264. package/bin/managed-plugin-selection.cjs +0 -141
  265. package/bin/verify-agent-behavior.cjs +0 -122
  266. 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
- }