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,290 +0,0 @@
1
- 'use strict';
2
-
3
- const crypto = require('node:crypto');
4
- const fs = require('node:fs');
5
- const os = require('node:os');
6
- const path = require('node:path');
7
-
8
- const RELAY_VERSION = 1;
9
- const DEFAULT_TIMEOUT_MS = 60_000;
10
- const DEFAULT_POLL_INTERVAL_MS = 250;
11
- const MAX_LABEL_CHARS = 48;
12
- const ALLOWED_RESPONSES = new Set(['approved', 'approved_for_session', 'rejected']);
13
-
14
- function relayRoot(homeDir = os.homedir()) {
15
- return path.join(homeDir, '.blun', 'channels', 'telegram', 'approvals');
16
- }
17
-
18
- function relayPaths(homeDir) {
19
- const root = relayRoot(homeDir);
20
- return {
21
- root,
22
- pending: path.join(root, 'pending'),
23
- responses: path.join(root, 'responses'),
24
- resolved: path.join(root, 'resolved'),
25
- sent: path.join(root, 'sent'),
26
- };
27
- }
28
-
29
- function ensureRelayDirs(homeDir) {
30
- const dirs = relayPaths(homeDir);
31
- for (const dir of Object.values(dirs).slice(1)) {
32
- fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
33
- }
34
- return dirs;
35
- }
36
-
37
- function safeId(value) {
38
- return crypto.createHash('sha256').update(String(value)).digest('hex').slice(0, 24);
39
- }
40
-
41
- function requestFileName(requestId) {
42
- return `${safeId(requestId)}.json`;
43
- }
44
-
45
- function atomicWriteJson(file, value) {
46
- const temp = `${file}.${process.pid}.${crypto.randomBytes(4).toString('hex')}.tmp`;
47
- fs.writeFileSync(temp, `${JSON.stringify(value)}\n`, { encoding: 'utf8', mode: 0o600 });
48
- fs.renameSync(temp, file);
49
- }
50
-
51
- function readJson(file) {
52
- try {
53
- return JSON.parse(fs.readFileSync(file, 'utf8'));
54
- } catch {
55
- return null;
56
- }
57
- }
58
-
59
- function compactLabel(value) {
60
- const normalized = String(value ?? '').replace(/\s+/gu, ' ').trim();
61
- if (normalized.length <= MAX_LABEL_CHARS) return normalized;
62
- return `${normalized.slice(0, MAX_LABEL_CHARS - 1)}…`;
63
- }
64
-
65
- function resolveTelegramApprovalTarget(allowFrom, configuredChatId) {
66
- const allowed = Array.isArray(allowFrom)
67
- ? [...new Set(allowFrom.map(String).filter((value) => value.length > 0))]
68
- : [];
69
- const configured = String(configuredChatId ?? '').trim();
70
- if (configured.length > 0) return allowed.includes(configured) ? configured : null;
71
- const privateChats = allowed.filter((value) => /^[1-9]\d*$/u.test(value));
72
- if (privateChats.length === 1) return privateChats[0];
73
- return allowed.length === 1 ? allowed[0] : null;
74
- }
75
-
76
- function parseTelegramApprovalCallback(data) {
77
- const match = /^blun-appr:([a-f0-9]{24}):(\d+)$/u.exec(String(data ?? ''));
78
- if (match === null) return null;
79
- const choiceIndex = Number(match[2]);
80
- if (!Number.isSafeInteger(choiceIndex)) return null;
81
- return { requestId: match[1], choiceIndex };
82
- }
83
-
84
- function buildTelegramApprovalCard(request) {
85
- return {
86
- text: request.toolName,
87
- reply_markup: {
88
- inline_keyboard: request.choices.map((choice) => [{
89
- text: choice.label,
90
- callback_data: `blun-appr:${request.requestId}:${choice.index}`,
91
- }]),
92
- },
93
- };
94
- }
95
-
96
- function isAuthorizedTelegramApprovalCallback(expectedChatId, senderId, chatId) {
97
- if (expectedChatId === null || expectedChatId === undefined) return false;
98
- return String(senderId ?? '') === String(expectedChatId)
99
- && String(chatId ?? '') === String(expectedChatId);
100
- }
101
-
102
- function shouldRelayTelegramApproval(permissionMode) {
103
- return permissionMode !== 'yolo';
104
- }
105
-
106
- function buildTelegramApprovalRequest(payload, options = {}) {
107
- const now = Number.isFinite(options.now) ? options.now : Date.now();
108
- const timeoutMs = Number.isFinite(options.timeoutMs) && options.timeoutMs > 0
109
- ? options.timeoutMs
110
- : DEFAULT_TIMEOUT_MS;
111
- const requestId = crypto.randomBytes(12).toString('hex');
112
- const nonce = crypto.randomBytes(16).toString('hex');
113
- const choices = (Array.isArray(payload?.choices) ? payload.choices : [])
114
- .filter((choice) => choice?.requires_feedback !== true && ALLOWED_RESPONSES.has(choice?.response))
115
- .map((choice, index) => ({
116
- index,
117
- label: compactLabel(choice.label || choice.response),
118
- response: choice.response,
119
- }));
120
- if (choices.length === 0) return null;
121
- return {
122
- v: RELAY_VERSION,
123
- requestId,
124
- nonce,
125
- approvalId: String(payload?.id ?? ''),
126
- toolName: compactLabel(payload?.tool_name || 'Werkzeug'),
127
- choices,
128
- createdAt: now,
129
- expiresAt: now + timeoutMs,
130
- };
131
- }
132
-
133
- function responseForChoice(request, choiceIndex) {
134
- const choice = request?.choices?.find((candidate) => candidate.index === choiceIndex);
135
- if (choice === undefined) return null;
136
- if (choice.response === 'approved_for_session') {
137
- return { decision: 'approved', scope: 'session', selectedLabel: choice.label };
138
- }
139
- return {
140
- decision: choice.response === 'approved' ? 'approved' : 'rejected',
141
- selectedLabel: choice.label,
142
- };
143
- }
144
-
145
- function validateTelegramApprovalResponse(request, response, now = Date.now()) {
146
- if (request?.v !== RELAY_VERSION || response?.v !== RELAY_VERSION) return null;
147
- if (request.requestId !== response.requestId || request.nonce !== response.nonce) return null;
148
- if (!Number.isFinite(request.expiresAt) || now > request.expiresAt) return null;
149
- if (!Number.isInteger(response.choiceIndex)) return null;
150
- return responseForChoice(request, response.choiceIndex);
151
- }
152
-
153
- function beginTelegramApprovalRelay(payload, options = {}) {
154
- const request = buildTelegramApprovalRequest(payload, options);
155
- if (request === null) return null;
156
- const dirs = ensureRelayDirs(options.homeDir);
157
- const fileName = requestFileName(request.requestId);
158
- const pendingFile = path.join(dirs.pending, fileName);
159
- const responseFile = path.join(dirs.responses, fileName);
160
- const resolvedFile = path.join(dirs.resolved, fileName);
161
- atomicWriteJson(pendingFile, request);
162
-
163
- let settled = false;
164
- let interval;
165
- let resolvePromise;
166
- const promise = new Promise((resolve) => { resolvePromise = resolve; });
167
- const finish = (response) => {
168
- if (settled) return false;
169
- settled = true;
170
- if (interval !== undefined) clearInterval(interval);
171
- const persistedResponse = response?.decision === 'edited' ? { decision: 'edited' } : response;
172
- try {
173
- atomicWriteJson(resolvedFile, {
174
- v: RELAY_VERSION,
175
- requestId: request.requestId,
176
- resolvedAt: Date.now(),
177
- response: persistedResponse,
178
- });
179
- } catch (error) {
180
- try { options.onError?.(error); } catch {}
181
- } finally {
182
- resolvePromise(response);
183
- }
184
- return true;
185
- };
186
- const poll = () => {
187
- if (settled) return;
188
- if (Date.now() > request.expiresAt) {
189
- finish(null);
190
- return;
191
- }
192
- const raw = readJson(responseFile);
193
- if (raw === null) return;
194
- const response = validateTelegramApprovalResponse(request, raw);
195
- if (response !== null) finish(response);
196
- };
197
- interval = setInterval(poll, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
198
- interval.unref?.();
199
- return {
200
- request,
201
- promise,
202
- complete: finish,
203
- poll,
204
- dispose: () => {
205
- if (interval !== undefined) clearInterval(interval);
206
- interval = undefined;
207
- },
208
- };
209
- }
210
-
211
- function listPendingTelegramApprovals(options = {}) {
212
- const dirs = ensureRelayDirs(options.homeDir);
213
- const now = Number.isFinite(options.now) ? options.now : Date.now();
214
- const results = [];
215
- for (const name of fs.readdirSync(dirs.pending)) {
216
- if (!name.endsWith('.json')) continue;
217
- if (fs.existsSync(path.join(dirs.resolved, name))) continue;
218
- const request = readJson(path.join(dirs.pending, name));
219
- if (request?.v !== RELAY_VERSION || now > request.expiresAt) continue;
220
- results.push(request);
221
- }
222
- return results.sort((left, right) => left.createdAt - right.createdAt);
223
- }
224
-
225
- function writeTelegramApprovalResponse(request, choiceIndex, metadata = {}, options = {}) {
226
- if (responseForChoice(request, choiceIndex) === null) return false;
227
- const dirs = ensureRelayDirs(options.homeDir);
228
- const fileName = requestFileName(request.requestId);
229
- if (fs.existsSync(path.join(dirs.resolved, fileName))) return false;
230
- const response = {
231
- v: RELAY_VERSION,
232
- requestId: request.requestId,
233
- nonce: request.nonce,
234
- choiceIndex,
235
- senderId: String(metadata.senderId ?? ''),
236
- chatId: String(metadata.chatId ?? ''),
237
- respondedAt: Number.isFinite(metadata.now) ? metadata.now : Date.now(),
238
- };
239
- const file = path.join(dirs.responses, fileName);
240
- try {
241
- fs.writeFileSync(file, `${JSON.stringify(response)}\n`, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
242
- return true;
243
- } catch (error) {
244
- if (error?.code === 'EEXIST') return false;
245
- throw error;
246
- }
247
- }
248
-
249
- function markTelegramApprovalSent(request, metadata = {}, options = {}) {
250
- const dirs = ensureRelayDirs(options.homeDir);
251
- const file = path.join(dirs.sent, requestFileName(request.requestId));
252
- const value = {
253
- v: RELAY_VERSION,
254
- requestId: request.requestId,
255
- chatId: String(metadata.chatId ?? ''),
256
- messageId: String(metadata.messageId ?? ''),
257
- sentAt: Number.isFinite(metadata.now) ? metadata.now : Date.now(),
258
- };
259
- try {
260
- fs.writeFileSync(file, `${JSON.stringify(value)}\n`, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
261
- return true;
262
- } catch (error) {
263
- if (error?.code === 'EEXIST') return false;
264
- throw error;
265
- }
266
- }
267
-
268
- function wasTelegramApprovalSent(request, options = {}) {
269
- const dirs = ensureRelayDirs(options.homeDir);
270
- return fs.existsSync(path.join(dirs.sent, requestFileName(request.requestId)));
271
- }
272
-
273
- module.exports = {
274
- DEFAULT_TIMEOUT_MS,
275
- beginTelegramApprovalRelay,
276
- buildTelegramApprovalCard,
277
- buildTelegramApprovalRequest,
278
- listPendingTelegramApprovals,
279
- markTelegramApprovalSent,
280
- relayPaths,
281
- resolveTelegramApprovalTarget,
282
- parseTelegramApprovalCallback,
283
- isAuthorizedTelegramApprovalCallback,
284
- requestFileName,
285
- responseForChoice,
286
- shouldRelayTelegramApproval,
287
- validateTelegramApprovalResponse,
288
- wasTelegramApprovalSent,
289
- writeTelegramApprovalResponse,
290
- };
@@ -1,175 +0,0 @@
1
- 'use strict';
2
-
3
- const { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } = require('node:fs');
4
- const { join } = require('node:path');
5
-
6
- const STATUS_FILE = 'telegram-console-status.json';
7
- const MAX_STATUS_BYTES = 16_384;
8
- const MAX_TASK_CHARS = 240;
9
- const MAX_TOOL_NAME_CHARS = 80;
10
- const MAX_VERSION_CHARS = 80;
11
-
12
- function validInstant(value) {
13
- if (typeof value !== 'string' || value.length === 0) return undefined;
14
- return Number.isFinite(Date.parse(value)) ? value : undefined;
15
- }
16
-
17
- function boundedTask(value) {
18
- if (typeof value !== 'string') return undefined;
19
- const title = value.replace(/\s+/gu, ' ').trim();
20
- return title.length > 0 ? title.slice(0, MAX_TASK_CHARS) : undefined;
21
- }
22
-
23
- function boundedToolName(value) {
24
- if (typeof value !== 'string') return undefined;
25
- const name = value.replace(/\s+/gu, ' ').trim();
26
- return name.length > 0 ? name.slice(0, MAX_TOOL_NAME_CHARS) : undefined;
27
- }
28
-
29
- function boundedVersion(value) {
30
- if (typeof value !== 'string') return undefined;
31
- const version = value.trim();
32
- return version.length > 0
33
- && version.length <= MAX_VERSION_CHARS
34
- && /^[0-9A-Za-z][0-9A-Za-z.+-]*$/u.test(version)
35
- ? version
36
- : undefined;
37
- }
38
-
39
- function instantFromMilliseconds(value) {
40
- if (!Number.isFinite(value) || value < 0) return undefined;
41
- try {
42
- return new Date(value).toISOString();
43
- } catch {
44
- return undefined;
45
- }
46
- }
47
-
48
- function buildTurnDiagnostics(turnActive, activity) {
49
- if (!turnActive || activity?.active !== true) return {};
50
- const turnStartedAt = instantFromMilliseconds(activity.startedAtMs);
51
- const lastProgressAt = instantFromMilliseconds(activity.lastProgressAtMs);
52
- const lastToolName = boundedToolName(activity.lastToolName);
53
- const failedRepetitions = Number.isSafeInteger(activity.failedRepetitions)
54
- && activity.failedRepetitions >= 0
55
- && activity.failedRepetitions <= 100
56
- ? activity.failedRepetitions
57
- : undefined;
58
- return {
59
- ...(turnStartedAt === undefined ? {} : { turnStartedAt }),
60
- ...(lastProgressAt === undefined ? {} : { lastProgressAt }),
61
- ...(lastToolName === undefined ? {} : { lastToolName }),
62
- ...(failedRepetitions === undefined ? {} : { failedRepetitions }),
63
- };
64
- }
65
-
66
- function buildTelegramConsoleStatus(input = {}) {
67
- const capturedAt = validInstant(input.capturedAt);
68
- const loadedVersion = boundedVersion(input.loadedVersion);
69
- const processStartedAt = validInstant(input.processStartedAt);
70
- const pid = Number.isSafeInteger(input.pid) && input.pid > 1 ? input.pid : undefined;
71
- const step = Number.isSafeInteger(input.step) && input.step >= 0 ? input.step : 0;
72
- if (capturedAt === undefined || processStartedAt === undefined || pid === undefined
73
- || typeof input.turnActive !== 'boolean') {
74
- throw new TypeError('invalid Telegram console status');
75
- }
76
- const activeTask = input.turnActive
77
- ? boundedTask(input.todos?.find((todo) => todo?.status === 'in_progress')?.title)
78
- : undefined;
79
- return {
80
- version: 1,
81
- ...(loadedVersion === undefined ? {} : { loadedVersion }),
82
- pid,
83
- capturedAt,
84
- processStartedAt,
85
- turnActive: input.turnActive,
86
- step,
87
- ...(activeTask === undefined ? {} : { activeTask }),
88
- ...buildTurnDiagnostics(input.turnActive, input.turnActivity),
89
- };
90
- }
91
-
92
- function parseTelegramConsoleStatus(value, options = {}) {
93
- try {
94
- const text = typeof value === 'string' ? value : JSON.stringify(value);
95
- if (text.length === 0 || Buffer.byteLength(text, 'utf8') > MAX_STATUS_BYTES) return undefined;
96
- const parsed = typeof value === 'string' ? JSON.parse(value) : value;
97
- if (parsed?.version !== 1 || !Number.isSafeInteger(parsed.pid) || parsed.pid <= 1
98
- || (options.expectedPid !== undefined && parsed.pid !== options.expectedPid)
99
- || validInstant(parsed.capturedAt) === undefined
100
- || validInstant(parsed.processStartedAt) === undefined
101
- || typeof parsed.turnActive !== 'boolean'
102
- || !Number.isSafeInteger(parsed.step) || parsed.step < 0) return undefined;
103
- const activeTask = boundedTask(parsed.activeTask);
104
- const hasLoadedVersion = Object.hasOwn(parsed, 'loadedVersion');
105
- const loadedVersion = boundedVersion(parsed.loadedVersion);
106
- const hasTurnStartedAt = Object.hasOwn(parsed, 'turnStartedAt');
107
- const hasLastProgressAt = Object.hasOwn(parsed, 'lastProgressAt');
108
- const hasLastToolName = Object.hasOwn(parsed, 'lastToolName');
109
- const hasFailedRepetitions = Object.hasOwn(parsed, 'failedRepetitions');
110
- const turnStartedAt = validInstant(parsed.turnStartedAt);
111
- const lastProgressAt = validInstant(parsed.lastProgressAt);
112
- const lastToolName = boundedToolName(parsed.lastToolName);
113
- const failedRepetitions = parsed.failedRepetitions;
114
- if ((hasLoadedVersion && loadedVersion === undefined)
115
- || (hasTurnStartedAt && turnStartedAt === undefined)
116
- || (hasLastProgressAt && lastProgressAt === undefined)
117
- || (hasLastToolName && lastToolName === undefined)
118
- || (hasFailedRepetitions && (!Number.isSafeInteger(failedRepetitions)
119
- || failedRepetitions < 0 || failedRepetitions > 100))) return undefined;
120
- const diagnostics = parsed.turnActive ? {
121
- ...(turnStartedAt === undefined ? {} : { turnStartedAt }),
122
- ...(lastProgressAt === undefined ? {} : { lastProgressAt }),
123
- ...(lastToolName === undefined ? {} : { lastToolName }),
124
- ...(hasFailedRepetitions ? { failedRepetitions } : {}),
125
- } : {};
126
- return {
127
- version: 1,
128
- ...(loadedVersion === undefined ? {} : { loadedVersion }),
129
- pid: parsed.pid,
130
- capturedAt: parsed.capturedAt,
131
- processStartedAt: parsed.processStartedAt,
132
- turnActive: parsed.turnActive,
133
- step: parsed.step,
134
- ...(parsed.turnActive && activeTask !== undefined ? { activeTask } : {}),
135
- ...diagnostics,
136
- };
137
- } catch {
138
- return undefined;
139
- }
140
- }
141
-
142
- function writeTelegramConsoleStatus(input = {}) {
143
- const status = buildTelegramConsoleStatus(input);
144
- const directory = input.directory;
145
- if (typeof directory !== 'string' || directory.length === 0) {
146
- throw new TypeError('invalid Telegram console status directory');
147
- }
148
- mkdirSync(directory, { recursive: true, mode: 0o700 });
149
- const target = join(directory, STATUS_FILE);
150
- const temporary = join(directory, `.telegram-console-status.${status.pid}.${Date.now()}.tmp`);
151
- try {
152
- writeFileSync(temporary, `${JSON.stringify(status)}\n`, { encoding: 'utf8', mode: 0o600 });
153
- renameSync(temporary, target);
154
- } finally {
155
- rmSync(temporary, { force: true });
156
- }
157
- return status;
158
- }
159
-
160
- function readTelegramConsoleStatus(directory, options = {}) {
161
- try {
162
- return parseTelegramConsoleStatus(readFileSync(join(directory, STATUS_FILE), 'utf8'), options);
163
- } catch {
164
- return undefined;
165
- }
166
- }
167
-
168
- module.exports = {
169
- STATUS_FILE,
170
- buildTelegramConsoleStatus,
171
- parseTelegramConsoleStatus,
172
- readTelegramConsoleStatus,
173
- writeTelegramConsoleStatus,
174
- };
175
-
@@ -1,125 +0,0 @@
1
- 'use strict';
2
-
3
- const crypto = require('node:crypto');
4
- const fs = require('node:fs');
5
- const path = require('node:path');
6
-
7
- const DEFAULT_MAX_BYTES = 2 * 1024 * 1024;
8
- const JOURNAL_NAME = 'delivery-lifecycle.jsonl';
9
- const PREVIOUS_NAME = 'delivery-lifecycle.previous.jsonl';
10
-
11
- function cleanToken(value, maximum = 80) {
12
- if (value === undefined || value === null) return undefined;
13
- const text = String(value).replace(/[^a-zA-Z0-9_.:-]/gu, '_').slice(0, maximum);
14
- return text.length > 0 ? text : undefined;
15
- }
16
-
17
- function boundedInteger(value) {
18
- const number = Number(value);
19
- if (!Number.isSafeInteger(number) || number < 0) return undefined;
20
- return Math.min(number, Number.MAX_SAFE_INTEGER);
21
- }
22
-
23
- function numericMessageId(value) {
24
- if (value === undefined || value === null) return undefined;
25
- const text = String(value);
26
- return /^[1-9][0-9]{0,39}$/u.test(text) ? text : undefined;
27
- }
28
-
29
- function strictChatHash(value) {
30
- if (value === undefined || value === null) return undefined;
31
- const text = String(value);
32
- return /^[a-f0-9]{12}$/u.test(text) ? text : undefined;
33
- }
34
-
35
- function hashChatId(chatId) {
36
- if (chatId === undefined || chatId === null || String(chatId).length === 0) return undefined;
37
- return crypto.createHash('sha256').update(String(chatId)).digest('hex').slice(0, 12);
38
- }
39
-
40
- function telegramDeliveryIdentity(meta = {}) {
41
- const messageId = numericMessageId(meta.message_id ?? meta.messageId);
42
- const chatHash = hashChatId(meta.chat_id ?? meta.chatId);
43
- return {
44
- ...(messageId === undefined ? {} : { messageId }),
45
- ...(chatHash === undefined ? {} : { chatHash }),
46
- };
47
- }
48
-
49
- function lifecycleRecord(event, now, pid) {
50
- const messageId = numericMessageId(event.messageId);
51
- const chatHash = event.chatHash === undefined
52
- ? undefined
53
- : strictChatHash(event.chatHash);
54
- const identity = {
55
- ...(messageId === undefined ? {} : { messageId }),
56
- ...(event.chatHash === undefined
57
- ? telegramDeliveryIdentity({ chatId: event.chatId })
58
- : chatHash === undefined ? {} : { chatHash }),
59
- };
60
- const record = {
61
- version: 1,
62
- at: now().toISOString(),
63
- pid,
64
- stage: cleanToken(event.stage, 48) ?? 'unknown',
65
- ...identity,
66
- };
67
- for (const [key, limit] of [
68
- ['route', 24],
69
- ['priority', 24],
70
- ['turnId', 48],
71
- ['reason', 48],
72
- ]) {
73
- const value = cleanToken(event[key], limit);
74
- if (value !== undefined) record[key] = value;
75
- }
76
- for (const key of ['queueDepth', 'attempt', 'checkpointOffset']) {
77
- const value = boundedInteger(event[key]);
78
- if (value !== undefined) record[key] = value;
79
- }
80
- return record;
81
- }
82
-
83
- function rotateJournal(file, previous, maximum) {
84
- try {
85
- if (fs.statSync(file).size < maximum) return;
86
- } catch {
87
- return;
88
- }
89
- try {
90
- fs.rmSync(previous, { force: true });
91
- fs.renameSync(file, previous);
92
- } catch {}
93
- }
94
-
95
- function createTelegramDeliveryLifecycle(options = {}) {
96
- const directory = options.stateDir;
97
- const maximum = Number.isSafeInteger(options.maxBytes) && options.maxBytes > 0
98
- ? options.maxBytes
99
- : DEFAULT_MAX_BYTES;
100
- const now = typeof options.now === 'function' ? options.now : () => new Date();
101
- const pid = Number.isSafeInteger(options.pid) ? options.pid : process.pid;
102
- const file = path.join(directory, JOURNAL_NAME);
103
- const previous = path.join(directory, PREVIOUS_NAME);
104
-
105
- return {
106
- record(event) {
107
- try {
108
- fs.mkdirSync(directory, { recursive: true });
109
- rotateJournal(file, previous, maximum);
110
- fs.appendFileSync(file, `${JSON.stringify(lifecycleRecord(event, now, pid))}\n`, {
111
- encoding: 'utf8',
112
- mode: 0o600,
113
- });
114
- return true;
115
- } catch {
116
- return false;
117
- }
118
- },
119
- };
120
- }
121
-
122
- module.exports = {
123
- createTelegramDeliveryLifecycle,
124
- telegramDeliveryIdentity,
125
- };
@@ -1,48 +0,0 @@
1
- 'use strict';
2
-
3
- const { readJsonlTail } = require('./telegram-private-conversation-policy.cjs');
4
- const MAX_AGE_MS = 30 * 60 * 1000;
5
- const PRESENCE_ANSWER = /^(?:(?:ja )?(?:bin da|bin hier|ich bin da|hier bin ich|ich bin hier|bereit|i am here|i m here|here|ready))(?: (?:was brauchst du|was gibt es|was liegt an|wie kann ich helfen|what do you need|how can i help))?$/u;
6
- const PRESENCE_QUESTION = /^(?:bist du da|bist du hier|bist du erreichbar|are you there|are you here)$/u;
7
-
8
- function normalize(value) {
9
- return String(value ?? '').normalize('NFKC').toLocaleLowerCase('de-DE')
10
- .replace(/[^\p{L}\p{N}\s]/gu, ' ').replace(/\s+/gu, ' ').trim();
11
- }
12
-
13
- function messageId(value) {
14
- if (typeof value !== 'string' && typeof value !== 'number') return null;
15
- if (!/^[1-9]\d*$/u.test(String(value))) return null;
16
- const number = Number(value);
17
- return Number.isSafeInteger(number) ? number : null;
18
- }
19
-
20
- function ownPresenceQuestion(content, recipientName) {
21
- if (typeof content !== 'string' || content.length > 512) return false;
22
- if (typeof recipientName !== 'string' || recipientName.length > 128) return false;
23
- const name = normalize(recipientName), text = normalize(content);
24
- if (!name) return false;
25
- if (text === name) return true;
26
- return text.startsWith(name + ' ') && PRESENCE_QUESTION.test(text.slice(name.length + 1));
27
- }
28
-
29
- function permitsPresenceReply({ text, chatId, replyTo, inboxFile,
30
- recipientName = process.env.BLUN_TELEGRAM_PERSONA_NAME || '', now = Date.now() }) {
31
- if (typeof text !== 'string' || text.length > 160 || !PRESENCE_ANSWER.test(normalize(text))) return false;
32
- const wantedId = messageId(replyTo), wantedChat = String(chatId ?? '');
33
- if (wantedId === null || !/^-[1-9]\d*$/u.test(wantedChat) || !Number.isFinite(now)) return false;
34
- // A semantic marker is shared by legacy recipients; only a bound own-name ping can refine it.
35
- const records = readJsonlTail(inboxFile);
36
- for (let index = records.length - 1; index >= 0; index -= 1) {
37
- const record = records[index], meta = record.meta;
38
- if (record.direction !== 'in' || !meta || String(meta.chat_id) !== wantedChat || messageId(meta.message_id) !== wantedId) continue;
39
- const timestamp = Date.parse(String(meta.ts ?? record.ts ?? ''));
40
- if (!Number.isFinite(timestamp) || timestamp > now || now - timestamp > MAX_AGE_MS) return false;
41
- return meta.addressed === true || meta.addressed === 'true'
42
- || meta.addressed === 1 || meta.addressed === '1'
43
- || (meta.addressed === 'semantic' && ownPresenceQuestion(record.content, recipientName));
44
- }
45
- return false;
46
- }
47
-
48
- module.exports = { MAX_AGE_MS, messageId, ownPresenceQuestion, permitsPresenceReply };