blun-king-cli 9.1.587 → 9.1.588

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 (436) hide show
  1. package/CHANGELOG.md +11 -185
  2. package/LIESMICH.txt +51 -13
  3. package/README.md +44 -47
  4. package/agent-spine-plugin/.codex-plugin/plugin.json +16 -4
  5. package/agent-spine-plugin/CHANGELOG.md +37 -5
  6. package/agent-spine-plugin/README.md +3 -3
  7. package/agent-spine-plugin/blun.plugin.json +45 -10
  8. package/agent-spine-plugin/docs/artifact-evaluation.md +93 -0
  9. package/agent-spine-plugin/docs/host-integration.md +42 -27
  10. package/agent-spine-plugin/docs/preflight-recall.md +4 -2
  11. package/agent-spine-plugin/docs/session-timeline.md +97 -236
  12. package/agent-spine-plugin/docs/world-model.md +25 -0
  13. package/agent-spine-plugin/hooks/codex.json +1 -1
  14. package/agent-spine-plugin/hooks/hooks.json +1 -1
  15. package/agent-spine-plugin/package.json +1 -3
  16. package/agent-spine-plugin/scripts/check-hosts.js +3 -3
  17. package/agent-spine-plugin/scripts/release-check.js +10 -5
  18. package/agent-spine-plugin/scripts/run-checks.js +4 -1
  19. package/agent-spine-plugin/scripts/run-tests-hermetic.js +32 -6
  20. package/agent-spine-plugin/src/cli-learning.js +15 -0
  21. package/agent-spine-plugin/src/cli.js +2 -0
  22. package/agent-spine-plugin/src/hook.js +32 -32
  23. package/agent-spine-plugin/src/lib/action-lesson-recall.js +73 -8
  24. package/agent-spine-plugin/src/lib/briefing.js +146 -36
  25. package/agent-spine-plugin/src/lib/channel-continuity.js +19 -0
  26. package/agent-spine-plugin/src/lib/delivery-agent-usage.js +14 -7
  27. package/agent-spine-plugin/src/lib/gateway-group-response.js +128 -0
  28. package/agent-spine-plugin/src/lib/gateway-runs.js +24 -15
  29. package/agent-spine-plugin/src/lib/hook-briefing-use.js +13 -3
  30. package/agent-spine-plugin/src/lib/hook-context.js +16 -3
  31. package/agent-spine-plugin/src/lib/hook-output.js +129 -5
  32. package/agent-spine-plugin/src/lib/hook-timeline.js +5 -3
  33. package/agent-spine-plugin/src/lib/indexed-memory.js +2 -2
  34. package/agent-spine-plugin/src/lib/learning-artifact-evaluator.js +114 -0
  35. package/agent-spine-plugin/src/lib/learning-context.js +11 -4
  36. package/agent-spine-plugin/src/lib/learning-measurements.js +2 -2
  37. package/agent-spine-plugin/src/lib/mcp-runtime.js +89 -3
  38. package/agent-spine-plugin/src/lib/mcp-source-context.js +12 -2
  39. package/agent-spine-plugin/src/lib/mcp-timeline-tools.js +91 -8
  40. package/agent-spine-plugin/src/lib/mcp-world-tools.js +2 -2
  41. package/agent-spine-plugin/src/lib/owned-file-lock.js +20 -1
  42. package/agent-spine-plugin/src/lib/persona-runtime.js +2 -2
  43. package/agent-spine-plugin/src/lib/preflight-delivery-id.js +27 -0
  44. package/agent-spine-plugin/src/lib/preflight.js +4 -4
  45. package/agent-spine-plugin/src/lib/session-timeline-codex.js +15 -0
  46. package/agent-spine-plugin/src/lib/session-timeline-contract.js +12 -4
  47. package/agent-spine-plugin/src/lib/session-timeline-event-extract.js +36 -7
  48. package/agent-spine-plugin/src/lib/session-timeline-host-origin.js +13 -10
  49. package/agent-spine-plugin/src/lib/session-timeline-invocation.js +1 -1
  50. package/agent-spine-plugin/src/lib/session-timeline-king.js +14 -0
  51. package/agent-spine-plugin/src/lib/session-timeline-prior.js +18 -12
  52. package/agent-spine-plugin/src/lib/session-timeline-provider.js +5 -0
  53. package/agent-spine-plugin/src/lib/session-timeline-query.js +2 -0
  54. package/agent-spine-plugin/src/lib/session-timeline-results.js +35 -10
  55. package/agent-spine-plugin/src/lib/session-timeline-source-open.js +30 -0
  56. package/agent-spine-plugin/src/lib/session-timeline.js +122 -75
  57. package/agent-spine-plugin/src/lib/source-roots.js +3 -2
  58. package/agent-spine-plugin/src/lib/task-knowledge-context.js +22 -1
  59. package/agent-spine-plugin/src/lib/timeline-continuation-update.js +100 -0
  60. package/agent-spine-plugin/src/lib/timeline-tool-guard.js +30 -7
  61. package/agent-spine-plugin/src/lib/timeline-user-feedback.js +217 -0
  62. package/agent-spine-plugin/src/lib/timeline-world-capture.js +233 -0
  63. package/agent-spine-plugin/src/lib/world-knowledge.js +59 -2
  64. package/agent-spine-plugin/src/lib/world-model.js +64 -9
  65. package/agent-spine-plugin/src/worker.js +13 -1
  66. package/bin/blun.js +43 -28
  67. package/bin/core-bootstrap.js +5 -4
  68. package/bin/king.js +43 -28
  69. package/bin/launcher-mode.js +1 -10
  70. package/bin/launcher-runtime.js +128 -295
  71. package/bin/managed-node.js +0 -0
  72. package/bin/managed-plugin-selection.cjs +0 -1
  73. package/bin/native-module-repair.js +0 -0
  74. package/bin/node-runtime.js +0 -0
  75. package/bin/node-version.js +0 -0
  76. package/bin/plugin-bootstrap.js +56 -120
  77. package/bin/private-paths.js +11 -34
  78. package/bin/standard-tools-bootstrap.js +34 -114
  79. package/bin/turn-thinking-policy.cjs +3 -11
  80. package/bin/update-copy.js +200 -0
  81. package/bin/update-lease.js +0 -0
  82. package/bin/update-notice.js +136 -289
  83. package/bin/verify-agent-behavior.cjs +122 -0
  84. package/bin/verify-agent-components.cjs +104 -0
  85. package/bin/verify-bundled-agent-sources.cjs +57 -0
  86. package/blun.mjs +143076 -135288
  87. package/bundled-agent-sources.json +701 -0
  88. package/package.json +12 -15
  89. package/standard-skills/translate-native/README.md +1293 -0
  90. package/standard-skills/translate-native/SKILL.md +172 -22
  91. package/standard-skills/translate-native/VERSION +1 -1
  92. package/standard-skills/translate-native/agents/openai.yaml +18 -0
  93. package/standard-skills/translate-native/assets/icon.svg +8 -0
  94. package/standard-skills/translate-native/docs/BLUN_CODE_INTEGRATION.md +76 -0
  95. package/standard-skills/translate-native/docs/PREMORTEM.md +489 -0
  96. package/standard-skills/translate-native/docs/WEBSITE_LOCALIZATION.md +2035 -0
  97. package/standard-skills/translate-native/docs/WEBSITE_LOCALIZATION_API.md +1302 -0
  98. package/standard-skills/translate-native/docs/WEBSITE_LOCALIZATION_EVIDENCE_HTTP.md +136 -0
  99. package/standard-skills/translate-native/docs/WEBSITE_LOCALIZATION_HEALTH_HTTP.md +130 -0
  100. package/standard-skills/translate-native/docs/WEBSITE_LOCALIZATION_HTTP_PROVIDER.md +175 -0
  101. package/standard-skills/translate-native/docs/WEBSITE_LOCALIZATION_RECEIPT_VERIFIER_HTTP.md +86 -0
  102. package/standard-skills/translate-native/integrations/AGENT_RULES.md +32 -0
  103. package/standard-skills/translate-native/integrations/adapters/blun-code-language-guard.js +514 -0
  104. package/standard-skills/translate-native/integrations/adapters/node-language-guard.js +230 -0
  105. package/standard-skills/translate-native/integrations/audit_log.py +327 -0
  106. package/standard-skills/translate-native/integrations/claude_language_hook.js +1536 -0
  107. package/standard-skills/translate-native/integrations/commercial_localization_profile.py +42 -0
  108. package/standard-skills/translate-native/integrations/delivery-policy.example.json +28 -0
  109. package/standard-skills/translate-native/integrations/enforced_delivery.py +543 -0
  110. package/standard-skills/translate-native/integrations/guard_service.py +435 -0
  111. package/standard-skills/translate-native/integrations/language_gateway.py +67 -0
  112. package/standard-skills/translate-native/integrations/mcp_auth_headers.py +198 -0
  113. package/standard-skills/translate-native/integrations/mcp_http_gateway.py +429 -0
  114. package/standard-skills/translate-native/integrations/non_language_html_entities.js +1485 -0
  115. package/standard-skills/translate-native/integrations/pre_output_guard.py +65 -0
  116. package/standard-skills/translate-native/integrations/task_router.py +101 -0
  117. package/standard-skills/translate-native/integrations/website_localization.py +401 -0
  118. package/standard-skills/translate-native/integrations/website_localization_api.py +581 -0
  119. package/standard-skills/translate-native/integrations/website_localization_benchmark.py +1885 -0
  120. package/standard-skills/translate-native/integrations/website_localization_benchmark_campaign.py +1772 -0
  121. package/standard-skills/translate-native/integrations/website_localization_benchmark_candidate.py +506 -0
  122. package/standard-skills/translate-native/integrations/website_localization_benchmark_http.py +400 -0
  123. package/standard-skills/translate-native/integrations/website_localization_benchmark_review_store.py +781 -0
  124. package/standard-skills/translate-native/integrations/website_localization_benchmark_reviewer_http.py +500 -0
  125. package/standard-skills/translate-native/integrations/website_localization_benchmark_runtime.py +1107 -0
  126. package/standard-skills/translate-native/integrations/website_localization_benchmark_suite.py +463 -0
  127. package/standard-skills/translate-native/integrations/website_localization_cms.py +2835 -0
  128. package/standard-skills/translate-native/integrations/website_localization_cms_client.py +875 -0
  129. package/standard-skills/translate-native/integrations/website_localization_cms_dispatch.py +805 -0
  130. package/standard-skills/translate-native/integrations/website_localization_cms_http.py +588 -0
  131. package/standard-skills/translate-native/integrations/website_localization_cms_lifecycle_monitor.py +991 -0
  132. package/standard-skills/translate-native/integrations/website_localization_cms_receiver.py +1441 -0
  133. package/standard-skills/translate-native/integrations/website_localization_cms_receiver_runtime.py +414 -0
  134. package/standard-skills/translate-native/integrations/website_localization_cms_receiver_store.py +1073 -0
  135. package/standard-skills/translate-native/integrations/website_localization_cms_removal_dispatch.py +865 -0
  136. package/standard-skills/translate-native/integrations/website_localization_cms_source_client.py +583 -0
  137. package/standard-skills/translate-native/integrations/website_localization_cms_source_delivery.py +964 -0
  138. package/standard-skills/translate-native/integrations/website_localization_cms_source_delivery_runtime.py +665 -0
  139. package/standard-skills/translate-native/integrations/website_localization_cms_source_http.py +1153 -0
  140. package/standard-skills/translate-native/integrations/website_localization_cms_source_runtime.py +675 -0
  141. package/standard-skills/translate-native/integrations/website_localization_cms_source_service.py +1125 -0
  142. package/standard-skills/translate-native/integrations/website_localization_cms_terminal_notification.py +674 -0
  143. package/standard-skills/translate-native/integrations/website_localization_cms_terminal_notification_http.py +444 -0
  144. package/standard-skills/translate-native/integrations/website_localization_cms_terminal_notification_receiver.py +1469 -0
  145. package/standard-skills/translate-native/integrations/website_localization_cms_terminal_notification_receiver_runtime.py +1142 -0
  146. package/standard-skills/translate-native/integrations/website_localization_cms_terminal_processing_monitor.py +634 -0
  147. package/standard-skills/translate-native/integrations/website_localization_cms_terminal_receiver_client.py +804 -0
  148. package/standard-skills/translate-native/integrations/website_localization_deepl_baseline.py +922 -0
  149. package/standard-skills/translate-native/integrations/website_localization_evidence_http.py +482 -0
  150. package/standard-skills/translate-native/integrations/website_localization_health.py +1541 -0
  151. package/standard-skills/translate-native/integrations/website_localization_health_http.py +372 -0
  152. package/standard-skills/translate-native/integrations/website_localization_http_provider.py +297 -0
  153. package/standard-skills/translate-native/integrations/website_localization_native_reference_http.py +479 -0
  154. package/standard-skills/translate-native/integrations/website_localization_native_reference_intake.py +363 -0
  155. package/standard-skills/translate-native/integrations/website_localization_native_reference_queue.py +1449 -0
  156. package/standard-skills/translate-native/integrations/website_localization_native_reference_store.py +420 -0
  157. package/standard-skills/translate-native/integrations/website_localization_quality_profiles.py +235 -0
  158. package/standard-skills/translate-native/integrations/website_localization_queue.py +671 -0
  159. package/standard-skills/translate-native/integrations/website_localization_receipt_verifier_http.py +516 -0
  160. package/standard-skills/translate-native/integrations/website_localization_release.py +928 -0
  161. package/standard-skills/translate-native/integrations/website_localization_release_coordinator.py +1008 -0
  162. package/standard-skills/translate-native/integrations/website_localization_runner.py +276 -0
  163. package/standard-skills/translate-native/integrations/website_localization_runtime.py +862 -0
  164. package/standard-skills/translate-native/integrations/website_localization_service.py +350 -0
  165. package/standard-skills/translate-native/integrations/website_localization_supervisor.py +511 -0
  166. package/standard-skills/translate-native/integrations/website_localization_worker.py +663 -0
  167. package/standard-skills/translate-native/provenance.json +3 -4
  168. package/standard-skills/translate-native/references/commercial-localization.md +177 -0
  169. package/standard-skills/translate-native/scripts/blun_language_guard.py +7 -1
  170. package/standard-skills/translate-native/scripts/check_commercial_review.py +80 -0
  171. package/standard-skills/translate-native/scripts/commercial_localization_profile.py +333 -0
  172. package/standard-tools/language-guard/LICENSE +21 -0
  173. package/standard-tools/language-guard/VERSION +1 -0
  174. package/standard-tools/language-guard/blun_language_guard.py +7 -1
  175. package/standard-tools/language-guard/check_commercial_review.py +80 -0
  176. package/standard-tools/language-guard/commercial_localization_profile.py +333 -0
  177. package/standard-tools/language-guard/language_gateway.py +62 -0
  178. package/standard-tools/language-guard/pre_output_guard.py +64 -0
  179. package/standard-tools/language-guard/provenance.json +4 -11
  180. package/standard-tools/manifest.json +34 -11
  181. package/telegram-plugin/commands/access.md +2 -10
  182. package/telegram-plugin/dist/bridge.mjs +64041 -687
  183. package/telegram-plugin/dist/mcp-server.mjs +72810 -9027
  184. package/telegram-plugin/dist/noise.mjs +28 -63511
  185. package/agent-spine-plugin/CONTRIBUTING.md +0 -52
  186. package/agent-spine-plugin/SECURITY.md +0 -47
  187. package/agent-spine-plugin/docs/assignment-continuation.md +0 -48
  188. package/agent-spine-plugin/docs/releasing.md +0 -85
  189. package/agent-spine-plugin/docs/structured-completion.md +0 -67
  190. package/bin/abort-listener-policy.cjs +0 -43
  191. package/bin/active-steer-priority-policy.cjs +0 -24
  192. package/bin/agent-api-http-adapter.mjs +0 -446
  193. package/bin/agent-api-private-http-server.mjs +0 -288
  194. package/bin/agent-api-runtime.mjs +0 -252
  195. package/bin/agent-api-service-environment.mjs +0 -236
  196. package/bin/agent-api-service-host.mjs +0 -209
  197. package/bin/agent-api-service-process.mjs +0 -171
  198. package/bin/agent-api-session-registry.mjs +0 -428
  199. package/bin/agent-api-tool-broker.cjs +0 -248
  200. package/bin/agent-api-turn-controller.mjs +0 -461
  201. package/bin/agent-api-usage-journal.cjs +0 -259
  202. package/bin/agent-resume-snapshot.cjs +0 -241
  203. package/bin/agentspine-king-goal-inbox.mjs +0 -111
  204. package/bin/agentspine-king-goal-intake.mjs +0 -106
  205. package/bin/approval-rejection-stop.cjs +0 -15
  206. package/bin/assistant-message-offload-policy.cjs +0 -284
  207. package/bin/baseline-skill-performance-policy.cjs +0 -39
  208. package/bin/bash-search-scope-policy.cjs +0 -49
  209. package/bin/codebase-search-runtime.cjs +0 -23
  210. package/bin/cognitive-action-checkpoint.cjs +0 -1104
  211. package/bin/cognitive-attention-delivery.cjs +0 -76
  212. package/bin/cognitive-attention-policy.cjs +0 -143
  213. package/bin/cognitive-attention-runtime.cjs +0 -91
  214. package/bin/cognitive-context-projection.cjs +0 -73
  215. package/bin/cognitive-cross-portal-acceptance.cjs +0 -443
  216. package/bin/cognitive-effective-view.cjs +0 -77
  217. package/bin/cognitive-focus-projection.cjs +0 -206
  218. package/bin/cognitive-focus-scope.cjs +0 -37
  219. package/bin/cognitive-goal-autostart-policy.cjs +0 -72
  220. package/bin/cognitive-goal-time-trigger-controller.cjs +0 -146
  221. package/bin/cognitive-memory-adapter.cjs +0 -282
  222. package/bin/cognitive-memory-command.cjs +0 -293
  223. package/bin/cognitive-memory-provider.cjs +0 -92
  224. package/bin/cognitive-salience-policy.cjs +0 -159
  225. package/bin/cognitive-state-store.cjs +0 -508
  226. package/bin/cognitive-turn-lifecycle.cjs +0 -624
  227. package/bin/cognitive-work-focus.cjs +0 -180
  228. package/bin/compaction-history-archive.cjs +0 -166
  229. package/bin/compaction-history-startup.cjs +0 -50
  230. package/bin/compaction-model-policy.cjs +0 -31
  231. package/bin/compaction-stage-policy.cjs +0 -21
  232. package/bin/compaction-transaction-policy.cjs +0 -122
  233. package/bin/config-write-dedup-policy.cjs +0 -27
  234. package/bin/context-budget-ledger.cjs +0 -31
  235. package/bin/context-doctor-policy.cjs +0 -70
  236. package/bin/context-insight-policy.cjs +0 -36
  237. package/bin/context-performance-policy.cjs +0 -19
  238. package/bin/context-pressure-policy.cjs +0 -20
  239. package/bin/cron-run-output.cjs +0 -45
  240. package/bin/cron-run-store.cjs +0 -145
  241. package/bin/curiosity-scout-policy.cjs +0 -49
  242. package/bin/default-model-output-budget-policy.cjs +0 -28
  243. package/bin/durable-task-resume-policy.cjs +0 -130
  244. package/bin/durable-task-resume-runtime.cjs +0 -117
  245. package/bin/durable-task-resume-store.cjs +0 -88
  246. package/bin/editable-tool-approval-policy.cjs +0 -540
  247. package/bin/editable-tool-approval-runtime.cjs +0 -99
  248. package/bin/effective-system-prompt-cache-policy.cjs +0 -33
  249. package/bin/error-memory-performance-policy.cjs +0 -113
  250. package/bin/file-observation-policy.cjs +0 -133
  251. package/bin/foreground-output-capture-policy.cjs +0 -41
  252. package/bin/generated-source-health.cjs +0 -142
  253. package/bin/glob-pattern-policy.cjs +0 -13
  254. package/bin/goal-completion-evidence-policy.cjs +0 -120
  255. package/bin/grep-output-limit-policy.cjs +0 -39
  256. package/bin/historical-media-projection-policy.cjs +0 -48
  257. package/bin/history-offload-pressure-policy.cjs +0 -33
  258. package/bin/html-to-research-markdown.cjs +0 -147
  259. package/bin/identity-context-policy.cjs +0 -764
  260. package/bin/identity-journal-policy.cjs +0 -107
  261. package/bin/input-draft-persistence.cjs +0 -77
  262. package/bin/king-tui-function-contract.json +0 -33
  263. package/bin/launcher-restart-policy.cjs +0 -150
  264. package/bin/live-response-repetition-guard.cjs +0 -196
  265. package/bin/llm-config-log-dedup-policy.cjs +0 -76
  266. package/bin/loop-event-record-policy.cjs +0 -174
  267. package/bin/managed-context-startup-policy.cjs +0 -27
  268. package/bin/media-activity-layout-policy.cjs +0 -34
  269. package/bin/media-auto-retrieval-policy.cjs +0 -90
  270. package/bin/media-result-policy.cjs +0 -59
  271. package/bin/micro-compaction-policy.cjs +0 -145
  272. package/bin/mistake-relevance-policy.cjs +0 -319
  273. package/bin/model-retry-progress-policy.cjs +0 -46
  274. package/bin/native-large-file-io.cjs +0 -42
  275. package/bin/native-runtime-cache.cjs +0 -76
  276. package/bin/natural-presence-policy.cjs +0 -28
  277. package/bin/noninteractive-shell-env-policy.cjs +0 -19
  278. package/bin/observer-hooks.cjs +0 -14
  279. package/bin/outbound-claim-provenance.cjs +0 -150
  280. package/bin/oversized-context-offload-policy.cjs +0 -86
  281. package/bin/pending-media-policy.cjs +0 -182
  282. package/bin/pending-token-estimate-policy.cjs +0 -41
  283. package/bin/personal-memory-consent-policy.cjs +0 -72
  284. package/bin/personal-memory-performance-policy.cjs +0 -12
  285. package/bin/personality-choice-policy.cjs +0 -101
  286. package/bin/personality-memory-adapter.cjs +0 -379
  287. package/bin/personality-mode.cjs +0 -46
  288. package/bin/personality-setup-policy.cjs +0 -197
  289. package/bin/proactive-compaction-policy.cjs +0 -25
  290. package/bin/profile-identity-resolution.cjs +0 -136
  291. package/bin/profile-runtime.cjs +0 -318
  292. package/bin/profile-tool-exclusion-policy.cjs +0 -37
  293. package/bin/programmatic-context-isolation.cjs +0 -25
  294. package/bin/programmatic-tool-runtime.mjs +0 -627
  295. package/bin/provider-idle-timeout-policy.cjs +0 -14
  296. package/bin/provider-model-refresh-deadline.cjs +0 -53
  297. package/bin/provider-model-refresh-policy.cjs +0 -107
  298. package/bin/rate-limit-recovery-policy.cjs +0 -47
  299. package/bin/read-batch-policy.cjs +0 -32
  300. package/bin/read-continuation-policy.cjs +0 -59
  301. package/bin/recurring-cron-history-policy.cjs +0 -124
  302. package/bin/relationship-continuity-policy.cjs +0 -143
  303. package/bin/relationship-curiosity-policy.cjs +0 -107
  304. package/bin/relationship-learning-policy.cjs +0 -168
  305. package/bin/release-artifact-freeze-policy.cjs +0 -30
  306. package/bin/reload-plugin-bootstrap.cjs +0 -18
  307. package/bin/reload-queue-policy.cjs +0 -38
  308. package/bin/repeated-assistant-response-policy.cjs +0 -232
  309. package/bin/repeated-injection-projection.cjs +0 -107
  310. package/bin/repeated-user-message-projection.cjs +0 -8
  311. package/bin/research-page-result.cjs +0 -74
  312. package/bin/retry-checkpoint-policy.cjs +0 -13
  313. package/bin/runtime-exit-ledger.cjs +0 -144
  314. package/bin/scoped-cron-run-policy.cjs +0 -358
  315. package/bin/session-checkpoint-policy.cjs +0 -25
  316. package/bin/session-compaction-policy.cjs +0 -84
  317. package/bin/session-replay-policy.cjs +0 -20
  318. package/bin/session-replay-window-policy.cjs +0 -40
  319. package/bin/session-resume-checkpoint.cjs +0 -254
  320. package/bin/session-scrollback-archive.cjs +0 -229
  321. package/bin/skill-activation-performance-policy.cjs +0 -69
  322. package/bin/skill-listing-performance-policy.cjs +0 -92
  323. package/bin/soul-organization-policy.cjs +0 -78
  324. package/bin/soul-preservation-policy.cjs +0 -20
  325. package/bin/startup-preferences.cjs +0 -131
  326. package/bin/streaming-flush-performance-policy.cjs +0 -28
  327. package/bin/structured-agent-swarm-output.cjs +0 -325
  328. package/bin/structured-subagent-output.cjs +0 -252
  329. package/bin/subagent-context-fork-policy.cjs +0 -155
  330. package/bin/subagent-max-tokens-handoff-policy.cjs +0 -69
  331. package/bin/subagent-parent-responsiveness.cjs +0 -19
  332. package/bin/subagent-skill-policy.cjs +0 -206
  333. package/bin/subagent-timeout-policy.cjs +0 -182
  334. package/bin/subagent-tool-policy.cjs +0 -60
  335. package/bin/subagent-usage-rollup-policy.cjs +0 -29
  336. package/bin/system-prompt-context-policy.cjs +0 -124
  337. package/bin/system-prompt-token-cache-policy.cjs +0 -60
  338. package/bin/telegram-addressed-focus.cjs +0 -55
  339. package/bin/telegram-addressed-priority.cjs +0 -12
  340. package/bin/telegram-approval-relay.cjs +0 -290
  341. package/bin/telegram-bot-priority.cjs +0 -17
  342. package/bin/telegram-console-status-policy.cjs +0 -174
  343. package/bin/telegram-context-projection-policy.cjs +0 -141
  344. package/bin/telegram-delivery-lifecycle.cjs +0 -125
  345. package/bin/telegram-direct-focus-policy.cjs +0 -273
  346. package/bin/telegram-mcp-compatibility.cjs +0 -49
  347. package/bin/telegram-media-delivery-policy.cjs +0 -42
  348. package/bin/telegram-private-conversation-policy.cjs +0 -185
  349. package/bin/telegram-queue-handoff-policy.cjs +0 -73
  350. package/bin/telegram-remote-status-policy.cjs +0 -120
  351. package/bin/telegram-session-queue-runtime.mjs +0 -306
  352. package/bin/telegram-text-chunk-policy.cjs +0 -63
  353. package/bin/telegram-truncated-reply-policy.cjs +0 -37
  354. package/bin/telegram-urgent-policy.cjs +0 -45
  355. package/bin/telemetry-spool-policy.cjs +0 -57
  356. package/bin/thinking-activity-status-policy.cjs +0 -132
  357. package/bin/thinking-only-guard.cjs +0 -80
  358. package/bin/todo-list-turn-policy.cjs +0 -131
  359. package/bin/tool-call-loop-policy.cjs +0 -51
  360. package/bin/tool-file-persistence.cjs +0 -141
  361. package/bin/tool-result-offload-policy.cjs +0 -359
  362. package/bin/tool-result-offload-telemetry.cjs +0 -12
  363. package/bin/tool-schema-token-cache-policy.cjs +0 -41
  364. package/bin/tool-stream-preview-policy.cjs +0 -9
  365. package/bin/tui-functional-contract.cjs +0 -55
  366. package/bin/turn-tool-performance-policy.cjs +0 -486
  367. package/bin/usage-cache-efficiency-policy.cjs +0 -26
  368. package/bin/user-home-path-policy.cjs +0 -13
  369. package/bin/user-message-offload-policy.cjs +0 -103
  370. package/bin/user-prompt-hook-origin-policy.cjs +0 -34
  371. package/bin/user-tool-record-policy.cjs +0 -7
  372. package/bin/validated-learning-insight-policy.cjs +0 -58
  373. package/bin/validated-learning-outcome-trace.cjs +0 -107
  374. package/bin/validated-learning-performance-policy.cjs +0 -53
  375. package/bin/validated-learning-signal.cjs +0 -463
  376. package/bin/windows-bash-dialect-policy.cjs +0 -25
  377. package/bin/windows-node-crash-dump.cjs +0 -110
  378. package/bin/write-continuation-policy.cjs +0 -69
  379. package/codebase-index/README.md +0 -82
  380. package/codebase-index/codebase_index.py +0 -470
  381. package/standard-skills/agent-browser/SKILL.md +0 -19
  382. package/standard-skills/agent-browser/references/runtime.md +0 -8
  383. package/standard-skills/blun-session-inspector/SKILL.md +0 -41
  384. package/standard-skills/blun-session-inspector/scripts/inspect-session.cjs +0 -437
  385. package/standard-skills/design-taste-frontend/SKILL.md +0 -1206
  386. package/standard-skills/full-output-enforcement/SKILL.md +0 -49
  387. package/standard-skills/high-end-visual-design/SKILL.md +0 -98
  388. package/standard-skills/image-to-code/SKILL.md +0 -1228
  389. package/standard-skills/industrial-brutalist-ui/SKILL.md +0 -92
  390. package/standard-skills/minimalist-ui/SKILL.md +0 -85
  391. package/standard-skills/motion-design-taste/SKILL.md +0 -74
  392. package/standard-skills/playwright-testing/SKILL.md +0 -19
  393. package/standard-skills/playwright-testing/references/runtime.md +0 -7
  394. package/standard-skills/premortem/SKILL.md +0 -148
  395. package/standard-skills/redesign-existing-projects/SKILL.md +0 -178
  396. package/standard-skills/research-evidence/SKILL.md +0 -39
  397. package/standard-skills/research-evidence/references/evidence-format.md +0 -104
  398. package/standard-skills/research-evidence/scripts/evidence-collection.cjs +0 -260
  399. package/standard-skills/research-evidence/scripts/score-report.cjs +0 -130
  400. package/standard-skills/screenshot-lesen/SKILL.md +0 -52
  401. package/standard-skills/stitch-design-taste/DESIGN.md +0 -121
  402. package/standard-skills/stitch-design-taste/SKILL.md +0 -184
  403. package/standard-skills/telegram-channel/SKILL.md +0 -18
  404. package/standard-skills/telegram-channel/references/runtime.md +0 -7
  405. package/standard-skills/venture-flywheel/SKILL.md +0 -32
  406. package/standard-skills/venture-flywheel/identity/project-identity.cjs +0 -146
  407. package/standard-skills/venture-flywheel/policy/capability-engine.cjs +0 -114
  408. package/standard-skills/venture-flywheel/policy/repository-trust.cjs +0 -229
  409. package/standard-skills/venture-flywheel/references/BEISPIELE-phase0.md +0 -146
  410. package/standard-skills/venture-flywheel/references/CAPABILITY-MAP.md +0 -34
  411. package/standard-skills/venture-flywheel/references/SPEC-phase0-identity-trust.md +0 -77
  412. package/standard-skills/venture-flywheel/references/SPEC-phase0-state-events.md +0 -93
  413. package/standard-skills/venture-flywheel/schemas/capability-decision.schema.json +0 -13
  414. package/standard-skills/venture-flywheel/schemas/execution-event.schema.json +0 -44
  415. package/standard-skills/venture-flywheel/schemas/project-identity.schema.json +0 -32
  416. package/standard-skills/venture-flywheel/schemas/repository-trust.schema.json +0 -57
  417. package/standard-skills/venture-flywheel/schemas/run-transition.schema.json +0 -59
  418. package/standard-skills/venture-flywheel/state/execution-event.cjs +0 -191
  419. package/standard-skills/venture-flywheel/state/task-state-machine.cjs +0 -190
  420. package/standard-skills/web-lesen/SKILL.md +0 -73
  421. package/standard-skills/web-lesen/scripts/crawl_public.py +0 -379
  422. package/standard-skills/windows-mcp/SKILL.md +0 -19
  423. package/standard-skills/windows-mcp/references/runtime.md +0 -9
  424. package/telegram-plugin/DELIVERY.md +0 -36
  425. package/telegram-plugin/bin/telegram-approval-relay.cjs +0 -290
  426. package/telegram-plugin/bin/telegram-console-status-policy.cjs +0 -175
  427. package/telegram-plugin/bin/telegram-delivery-lifecycle.cjs +0 -125
  428. package/telegram-plugin/bin/telegram-direct-reply-policy.cjs +0 -48
  429. package/telegram-plugin/bin/telegram-launcher-status-queue.cjs +0 -122
  430. package/telegram-plugin/bin/telegram-private-conversation-policy.cjs +0 -186
  431. package/telegram-plugin/bin/telegram-remote-status-policy.cjs +0 -121
  432. package/telegram-plugin/bin/telegram-reply-parts.cjs +0 -149
  433. package/telegram-plugin/bin/telegram-text-chunk-policy.cjs +0 -63
  434. package/telegram-plugin/bin/telegram-typing-keepalive.cjs +0 -89
  435. package/telegram-plugin/compat/mcp-server-fa511cd1.mjs +0 -73825
  436. /package/{bin → scripts}/fix-node-pty-perms.js +0 -0
@@ -1,174 +0,0 @@
1
- 'use strict';
2
-
3
- const STEP_END_LIVE_ONLY_FIELDS = [
4
- 'llmFirstTokenLatencyMs',
5
- 'llmStreamDurationMs',
6
- 'llmRequestBuildMs',
7
- 'llmServerFirstTokenMs',
8
- 'llmServerDecodeMs',
9
- 'llmClientConsumeMs',
10
- 'messageId',
11
- 'reasoningFieldState',
12
- ];
13
- const STEP_END_ROUTINE_FINISH_REASONS = new Set(['tool_use', 'end_turn']);
14
- const DEFAULT_USAGE_MODEL = 'blun/king';
15
-
16
- function usageTotal(usage) {
17
- return usage.inputCacheRead + usage.inputCacheCreation + usage.inputOther + usage.output;
18
- }
19
-
20
- function resolveCompletedStepUuid(openSteps, event) {
21
- if (event.uuid !== undefined) return event.uuid;
22
- let latest;
23
- for (const uuid of openSteps.keys()) latest = uuid;
24
- return latest;
25
- }
26
-
27
- function resolveStepEventUuid(openSteps, event) {
28
- if (event.stepUuid !== undefined) return event.stepUuid;
29
- let latest;
30
- for (const uuid of openSteps.keys()) latest = uuid;
31
- return latest;
32
- }
33
-
34
- function hasOwn(object, key) {
35
- return Object.prototype.hasOwnProperty.call(object, key);
36
- }
37
-
38
- function projectUsageModelForRecord(model) {
39
- return model === DEFAULT_USAGE_MODEL ? undefined : model;
40
- }
41
-
42
- function restoreUsageModelFromRecord(model) {
43
- return model === undefined ? DEFAULT_USAGE_MODEL : model;
44
- }
45
-
46
- function projectUsageForRecord(usage) {
47
- if (!usage || typeof usage !== 'object') return usage;
48
- const omitCacheRead = usage.inputCacheRead === 0;
49
- const omitCacheCreation = usage.inputCacheCreation === 0;
50
- if (!omitCacheRead && !omitCacheCreation) return usage;
51
- const recordedUsage = { ...usage };
52
- if (omitCacheRead) delete recordedUsage.inputCacheRead;
53
- if (omitCacheCreation) delete recordedUsage.inputCacheCreation;
54
- return recordedUsage;
55
- }
56
-
57
- function restoreUsageFromRecord(usage) {
58
- if (!usage || typeof usage !== 'object') return usage;
59
- if (hasOwn(usage, 'inputCacheRead') && hasOwn(usage, 'inputCacheCreation')) return usage;
60
- return {
61
- ...usage,
62
- ...hasOwn(usage, 'inputCacheRead') ? {} : { inputCacheRead: 0 },
63
- ...hasOwn(usage, 'inputCacheCreation') ? {} : { inputCacheCreation: 0 },
64
- };
65
- }
66
-
67
- function projectLoopEventForRecord(event) {
68
- if (event?.type === 'step.begin' && hasOwn(event, 'step')) {
69
- const { step: _step, ...withoutStep } = event;
70
- if (event.step <= 1 || !hasOwn(withoutStep, 'turnId')) return withoutStep;
71
- const { turnId: _turnId, ...recordedEvent } = withoutStep;
72
- return recordedEvent;
73
- }
74
-
75
- if (
76
- event?.type === 'content.part' &&
77
- (
78
- hasOwn(event, 'uuid') ||
79
- hasOwn(event, 'turnId') ||
80
- hasOwn(event, 'step') ||
81
- hasOwn(event, 'stepUuid')
82
- )
83
- ) {
84
- const {
85
- uuid: _uuid,
86
- turnId: _turnId,
87
- step: _step,
88
- stepUuid: _stepUuid,
89
- ...recordedEvent
90
- } = event;
91
- return recordedEvent;
92
- }
93
-
94
- if (
95
- event?.type === 'tool.call' &&
96
- (
97
- hasOwn(event, 'uuid') ||
98
- hasOwn(event, 'turnId') ||
99
- hasOwn(event, 'step') ||
100
- hasOwn(event, 'stepUuid') ||
101
- hasOwn(event, 'display') ||
102
- hasOwn(event, 'description')
103
- )
104
- ) {
105
- const {
106
- uuid: _uuid,
107
- turnId: _turnId,
108
- step: _step,
109
- stepUuid: _stepUuid,
110
- display: _display,
111
- description: _description,
112
- ...recordedEvent
113
- } = event;
114
- return recordedEvent;
115
- }
116
-
117
- if (
118
- event?.type === 'tool.result' &&
119
- (hasOwn(event, 'parentUuid') || event.result?.exitCode === 0)
120
- ) {
121
- const { parentUuid: _parentUuid, ...withoutParentUuid } = event;
122
- if (event.result?.exitCode !== 0) return withoutParentUuid;
123
- const { exitCode: _exitCode, ...recordedResult } = event.result;
124
- return { ...withoutParentUuid, result: recordedResult };
125
- }
126
-
127
- const hasRoutineFinishReason = STEP_END_ROUTINE_FINISH_REASONS.has(event?.finishReason);
128
- const hasUsage = event?.type === 'step.end' && hasOwn(event, 'usage');
129
- if (
130
- event?.type !== 'step.end' ||
131
- (
132
- !hasOwn(event, 'uuid') &&
133
- !hasOwn(event, 'turnId') &&
134
- !hasOwn(event, 'step') &&
135
- !hasUsage &&
136
- !hasRoutineFinishReason &&
137
- !STEP_END_LIVE_ONLY_FIELDS.some((field) => hasOwn(event, field))
138
- )
139
- ) {
140
- return event;
141
- }
142
-
143
- const {
144
- uuid: _uuid,
145
- turnId: _turnId,
146
- step: _step,
147
- llmFirstTokenLatencyMs: _llmFirstTokenLatencyMs,
148
- llmStreamDurationMs: _llmStreamDurationMs,
149
- llmRequestBuildMs: _llmRequestBuildMs,
150
- llmServerFirstTokenMs: _llmServerFirstTokenMs,
151
- llmServerDecodeMs: _llmServerDecodeMs,
152
- llmClientConsumeMs: _llmClientConsumeMs,
153
- messageId: _messageId,
154
- reasoningFieldState: _reasoningFieldState,
155
- usage: _usage,
156
- ...recordedEvent
157
- } = event;
158
- const compactUsageEvent = hasUsage
159
- ? { ...recordedEvent, contextTokens: usageTotal(event.usage) }
160
- : recordedEvent;
161
- if (!hasRoutineFinishReason) return compactUsageEvent;
162
- const { finishReason: _finishReason, ...withoutRoutineFinishReason } = compactUsageEvent;
163
- return withoutRoutineFinishReason;
164
- }
165
-
166
- module.exports = {
167
- projectLoopEventForRecord,
168
- projectUsageModelForRecord,
169
- projectUsageForRecord,
170
- resolveCompletedStepUuid,
171
- resolveStepEventUuid,
172
- restoreUsageFromRecord,
173
- restoreUsageModelFromRecord,
174
- };
@@ -1,27 +0,0 @@
1
- 'use strict';
2
-
3
- const MANAGED_CONTEXT_MISMATCH = 'Runtime model context does not match the configured internal BLUN model.';
4
-
5
- function isManagedContextStartupRace(error) {
6
- return error?.code === 'CONFIG_INVALID' && error?.message === MANAGED_CONTEXT_MISMATCH;
7
- }
8
-
9
- async function bindManagedContextWithRetry(options) {
10
- const delaysMs = Array.isArray(options?.delaysMs) ? options.delaysMs : [100, 300];
11
- const wait = options?.wait || ((delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs)));
12
- for (let attempt = 0; ; attempt += 1) {
13
- try {
14
- return await options.bind();
15
- } catch (error) {
16
- if (!isManagedContextStartupRace(error) || attempt >= delaysMs.length) throw error;
17
- await options.refresh();
18
- await wait(delaysMs[attempt]);
19
- }
20
- }
21
- }
22
-
23
- module.exports = {
24
- MANAGED_CONTEXT_MISMATCH,
25
- bindManagedContextWithRetry,
26
- isManagedContextStartupRace,
27
- };
@@ -1,34 +0,0 @@
1
- 'use strict';
2
-
3
- function textWidth(value) {
4
- return [...String(value ?? '')].length;
5
- }
6
-
7
- function wrapMediaActivityChainItems(items, width, options = {}) {
8
- const safeItems = Array.isArray(items) ? items : [];
9
- const safeWidth = Math.max(1, Math.floor(Number(width) || 1));
10
- const measure = typeof options.measure === 'function' ? options.measure : textWidth;
11
- const firstPrefixWidth = Math.max(0, Number(options.firstPrefixWidth) || 0);
12
- const continuationPrefixWidth = Math.max(0, Number(options.continuationPrefixWidth) || 0);
13
- const separatorWidth = Math.max(0, Number(options.separatorWidth) || 0);
14
- const rows = [];
15
- let row = [];
16
- let rowWidth = firstPrefixWidth;
17
-
18
- for (const item of safeItems) {
19
- const itemWidth = Math.max(0, measure(item));
20
- const candidateWidth = rowWidth + (row.length > 0 ? separatorWidth : 0) + itemWidth;
21
- if (row.length > 0 && candidateWidth > safeWidth) {
22
- rows.push(row);
23
- row = [];
24
- rowWidth = continuationPrefixWidth;
25
- }
26
- row.push(item);
27
- rowWidth += (row.length > 1 ? separatorWidth : 0) + itemWidth;
28
- }
29
-
30
- if (row.length > 0) rows.push(row);
31
- return rows;
32
- }
33
-
34
- module.exports = { wrapMediaActivityChainItems };
@@ -1,90 +0,0 @@
1
- 'use strict';
2
-
3
- const TERMINAL_FAILURES = new Set(['blocked', 'cancelled', 'canceled', 'expired', 'failed']);
4
-
5
- function parseAcceptedMediaJob(output) {
6
- if (typeof output !== 'string') return undefined;
7
- return /\bMedia job ([A-Za-z0-9_-]{1,200}) accepted with status\b/u.exec(output)?.[1];
8
- }
9
-
10
- function createMediaAutoRetrievalController(options) {
11
- const active = new Map();
12
- const completed = new Set();
13
- const inflight = new Set();
14
- const pollIntervalMs = Math.max(1, options.pollIntervalMs ?? 5000);
15
- const schedule = options.schedule ?? ((fn, delay) => setTimeout(fn, delay));
16
- const cancel = options.cancel ?? clearTimeout;
17
-
18
- function later(id, chatId) {
19
- const timer = schedule(() => {
20
- active.delete(id);
21
- watch(id, chatId);
22
- }, pollIntervalMs);
23
- active.set(id, timer);
24
- }
25
-
26
- async function poll(id, chatId) {
27
- inflight.add(id);
28
- try {
29
- const result = await options.getMedia(id);
30
- options.tracker.observeLookup(result);
31
- if (result?.kind === 'status') {
32
- const status = String(result.status ?? '').trim().toLowerCase();
33
- if (TERMINAL_FAILURES.has(status)) {
34
- options.tracker.noteDeliveryFailure(id, `media_${status}`);
35
- completed.add(id);
36
- return;
37
- }
38
- later(id, chatId);
39
- return;
40
- }
41
- if (result?.kind !== 'file') {
42
- options.tracker.noteDeliveryFailure(id, 'media_result_not_file');
43
- completed.add(id);
44
- return;
45
- }
46
- const localPath = await options.saveMedia(result);
47
- options.tracker.noteSaved(id, localPath);
48
- const sent = await options.deliver(chatId, localPath);
49
- if (!sent) {
50
- options.tracker.noteDeliveryFailure(id, 'channel_delivery_failed');
51
- later(id, chatId);
52
- return;
53
- }
54
- options.tracker.noteDelivered(id);
55
- completed.add(id);
56
- } catch (error) {
57
- if (error?.code === 'MEDIA_QUALITY_REJECTED') {
58
- options.tracker.noteRejected?.(id, error.message);
59
- completed.add(id);
60
- return;
61
- }
62
- options.tracker.noteDeliveryFailure(id, error?.message ?? error);
63
- later(id, chatId);
64
- } finally {
65
- inflight.delete(id);
66
- }
67
- }
68
-
69
- function watch(id, chatId) {
70
- if (completed.has(id) || active.has(id) || inflight.has(id)) return;
71
- options.tracker.associateDelivery(id, chatId);
72
- void poll(id, chatId);
73
- }
74
-
75
- return {
76
- watch,
77
- resume() {
78
- for (const job of options.tracker.pendingDeliveries()) watch(job.id, job.chatId);
79
- },
80
- stop() {
81
- for (const timer of active.values()) cancel(timer);
82
- active.clear();
83
- },
84
- async flushForTest() {
85
- while (inflight.size > 0) await new Promise((resolve) => setImmediate(resolve));
86
- },
87
- };
88
- }
89
-
90
- module.exports = { createMediaAutoRetrievalController, parseAcceptedMediaJob };
@@ -1,59 +0,0 @@
1
- 'use strict';
2
-
3
- const MIN_IMAGE_BYTES = 100000;
4
- const MIN_IMAGE_EDGE = 1024;
5
-
6
- function pngDimensions(data) {
7
- const bytes = Buffer.from(data.buffer, data.byteOffset, data.byteLength);
8
- if (bytes.length < 24 || !bytes.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))) {
9
- return undefined;
10
- }
11
- if (bytes.toString('ascii', 12, 16) !== 'IHDR') return undefined;
12
- return { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20) };
13
- }
14
-
15
- function jpegDimensions(data) {
16
- const bytes = Buffer.from(data.buffer, data.byteOffset, data.byteLength);
17
- if (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8) return undefined;
18
- let offset = 2;
19
- while (offset + 9 < bytes.length) {
20
- if (bytes[offset] !== 0xff) {
21
- offset += 1;
22
- continue;
23
- }
24
- const marker = bytes[offset + 1];
25
- if ([0xc0, 0xc1, 0xc2, 0xc3, 0xc5, 0xc6, 0xc7, 0xc9, 0xca, 0xcb, 0xcd, 0xce, 0xcf].includes(marker)) {
26
- return { height: bytes.readUInt16BE(offset + 5), width: bytes.readUInt16BE(offset + 7) };
27
- }
28
- if (marker === 0xd8 || marker === 0xd9) {
29
- offset += 2;
30
- continue;
31
- }
32
- const length = bytes.readUInt16BE(offset + 2);
33
- if (length < 2) return undefined;
34
- offset += 2 + length;
35
- }
36
- return undefined;
37
- }
38
-
39
- function validateCompletedMedia(result) {
40
- if (result?.kind !== 'file' || !(result.data instanceof Uint8Array) || result.data.byteLength === 0) {
41
- return { ok: false, reason: 'empty_media_payload' };
42
- }
43
- if (!String(result.mimeType).startsWith('image/')) return { ok: true };
44
- const dimensions = result.mimeType === 'image/png'
45
- ? pngDimensions(result.data)
46
- : result.mimeType === 'image/jpeg'
47
- ? jpegDimensions(result.data)
48
- : undefined;
49
- if (!dimensions) return { ok: false, reason: 'image_dimensions_unreadable' };
50
- if (dimensions.width < MIN_IMAGE_EDGE || dimensions.height < MIN_IMAGE_EDGE) {
51
- return { ok: false, reason: `image_dimensions_below_${MIN_IMAGE_EDGE}`, ...dimensions };
52
- }
53
- if (result.data.byteLength < MIN_IMAGE_BYTES) {
54
- return { ok: false, reason: `image_payload_below_${MIN_IMAGE_BYTES}`, ...dimensions };
55
- }
56
- return { ok: true, ...dimensions };
57
- }
58
-
59
- module.exports = { validateCompletedMedia };
@@ -1,145 +0,0 @@
1
- 'use strict';
2
-
3
- const { createHash } = require('node:crypto');
4
-
5
- const MICRO_COMPACTION_PRESSURE_RATIO = 0.75;
6
- const MICRO_COMPACTION_MIN_ADVANCE_MESSAGES = 20;
7
- const MICRO_COMPACTION_RECENT_MESSAGES = 4;
8
- const MICRO_COMPACTION_TOOL_ARGUMENTS_ENABLED = false;
9
- const MICRO_COMPACTION_TOOL_ARGUMENT_MIN_TOKENS = 32;
10
-
11
- function selectMicroCompactionCutoff(options = {}) {
12
- const historyLength = nonNegativeInteger(options.historyLength);
13
- const currentCutoff = nonNegativeInteger(options.currentCutoff);
14
- const keepRecentMessages = nonNegativeInteger(options.keepRecentMessages);
15
- const nextCutoff = Math.max(0, historyLength - keepRecentMessages);
16
- if (nextCutoff <= currentCutoff) return null;
17
-
18
- const maxContextTokens = positiveFinite(options.maxContextTokens);
19
- const contextTokens = nonNegativeFinite(options.contextTokens);
20
- const contextUsageRatio = maxContextTokens === null
21
- ? 1
22
- : contextTokens / maxContextTokens;
23
- const minContextUsageRatio = nonNegativeFinite(options.minContextUsageRatio);
24
- if (contextUsageRatio < minContextUsageRatio) return null;
25
-
26
- const now = finiteOr(options.now, Date.now());
27
- const lastAssistantAt = finiteOrNull(options.lastAssistantAt);
28
- const cacheAgeMs = lastAssistantAt === null ? null : Math.max(0, now - lastAssistantAt);
29
- const cacheMissedThresholdMs = nonNegativeFinite(options.cacheMissedThresholdMs);
30
- const cacheMissed = cacheAgeMs !== null && cacheAgeMs >= cacheMissedThresholdMs;
31
- const underContextPressure = maxContextTokens !== null
32
- && contextUsageRatio >= MICRO_COMPACTION_PRESSURE_RATIO;
33
- if (!cacheMissed && !underContextPressure) return null;
34
-
35
- if (
36
- !cacheMissed
37
- && currentCutoff > 0
38
- && nextCutoff - currentCutoff < MICRO_COMPACTION_MIN_ADVANCE_MESSAGES
39
- ) {
40
- return null;
41
- }
42
-
43
- return {
44
- cacheAgeMs,
45
- contextUsageRatio,
46
- cutoff: nextCutoff,
47
- trigger: cacheMissed ? 'cache_miss' : 'context_pressure',
48
- };
49
- }
50
-
51
- function redundantHistoricalToolResultIds(messages, cutoff) {
52
- return new Set(redundantHistoricalToolResultReferences(messages, cutoff).keys());
53
- }
54
-
55
- function redundantHistoricalToolResultReferences(messages, cutoff) {
56
- if (!Array.isArray(messages)) return new Map();
57
-
58
- const historicalCutoff = Math.min(messages.length, nonNegativeInteger(cutoff));
59
- const callSignatures = new Map();
60
- for (const message of messages) {
61
- if (message?.role !== 'assistant' || !Array.isArray(message.toolCalls)) continue;
62
- for (const call of message.toolCalls) {
63
- if (
64
- typeof call?.id !== 'string'
65
- || typeof call.name !== 'string'
66
- || typeof call.arguments !== 'string'
67
- ) {
68
- continue;
69
- }
70
- callSignatures.set(call.id, JSON.stringify([call.name, call.arguments]));
71
- }
72
- }
73
-
74
- const resultsBySignature = new Map();
75
- for (let index = 0; index < messages.length; index++) {
76
- const message = messages[index];
77
- if (message?.role !== 'tool' || typeof message.toolCallId !== 'string') continue;
78
- const callSignature = callSignatures.get(message.toolCallId);
79
- if (callSignature === undefined || !Array.isArray(message.content)) continue;
80
-
81
- let resultSignature;
82
- try {
83
- resultSignature = createHash('sha256')
84
- .update(callSignature)
85
- .update('\0')
86
- .update(JSON.stringify(message.content))
87
- .digest('hex');
88
- } catch {
89
- continue;
90
- }
91
-
92
- const entries = resultsBySignature.get(resultSignature) ?? [];
93
- entries.push({ index, toolCallId: message.toolCallId });
94
- resultsBySignature.set(resultSignature, entries);
95
- }
96
-
97
- const redundantIds = new Map();
98
- for (const entries of resultsBySignature.values()) {
99
- if (entries.length < 2) continue;
100
- const newestToolCallId = entries.at(-1)?.toolCallId;
101
- if (newestToolCallId === undefined) continue;
102
- for (const entry of entries.slice(0, -1)) {
103
- if (entry.index < historicalCutoff) {
104
- redundantIds.set(entry.toolCallId, newestToolCallId);
105
- }
106
- }
107
- }
108
- return redundantIds;
109
- }
110
-
111
- function finiteOr(value, fallback) {
112
- const number = Number(value);
113
- return Number.isFinite(number) ? number : fallback;
114
- }
115
-
116
- function finiteOrNull(value) {
117
- if (value === null || value === undefined) return null;
118
- const number = Number(value);
119
- return Number.isFinite(number) ? number : null;
120
- }
121
-
122
- function nonNegativeFinite(value) {
123
- const number = Number(value);
124
- return Number.isFinite(number) && number >= 0 ? number : 0;
125
- }
126
-
127
- function nonNegativeInteger(value) {
128
- return Math.floor(nonNegativeFinite(value));
129
- }
130
-
131
- function positiveFinite(value) {
132
- const number = Number(value);
133
- return Number.isFinite(number) && number > 0 ? number : null;
134
- }
135
-
136
- module.exports = {
137
- MICRO_COMPACTION_MIN_ADVANCE_MESSAGES,
138
- MICRO_COMPACTION_PRESSURE_RATIO,
139
- MICRO_COMPACTION_RECENT_MESSAGES,
140
- MICRO_COMPACTION_TOOL_ARGUMENTS_ENABLED,
141
- MICRO_COMPACTION_TOOL_ARGUMENT_MIN_TOKENS,
142
- redundantHistoricalToolResultIds,
143
- redundantHistoricalToolResultReferences,
144
- selectMicroCompactionCutoff,
145
- };