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