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,88 +0,0 @@
1
- 'use strict';
2
-
3
- const fs = require('node:fs/promises');
4
- const path = require('node:path');
5
- const {
6
- TASK_ID_PATTERN,
7
- contractError,
8
- isResumeIntent,
9
- } = require('./durable-task-resume-policy.cjs');
10
-
11
- class DurableTaskResumeStore {
12
- constructor(sessionDir) {
13
- if (typeof sessionDir !== 'string' || sessionDir.length === 0) {
14
- throw contractError('session directory is required', 'persistence');
15
- }
16
- this.directory = path.join(sessionDir, 'task-resume-intents');
17
- this.intents = new Map();
18
- }
19
-
20
- fileFor(sourceTaskId) {
21
- if (!TASK_ID_PATTERN.test(sourceTaskId)) throw contractError('source task ID is invalid');
22
- return path.join(this.directory, `${sourceTaskId}.json`);
23
- }
24
-
25
- async load() {
26
- this.intents.clear();
27
- let names;
28
- try {
29
- names = await fs.readdir(this.directory);
30
- } catch (error) {
31
- if (error && error.code === 'ENOENT') return;
32
- throw error;
33
- }
34
- for (const name of names) {
35
- if (!name.endsWith('.json')) continue;
36
- const sourceTaskId = name.slice(0, -5);
37
- if (!TASK_ID_PATTERN.test(sourceTaskId)) continue;
38
- try {
39
- const intent = JSON.parse(await fs.readFile(this.fileFor(sourceTaskId), 'utf8'));
40
- if (isResumeIntent(intent) && intent.sourceTaskId === sourceTaskId) {
41
- this.intents.set(sourceTaskId, intent);
42
- }
43
- } catch {}
44
- }
45
- }
46
-
47
- getBySourceTaskId(sourceTaskId) {
48
- const intent = this.intents.get(sourceTaskId);
49
- return intent === undefined ? undefined : { ...intent };
50
- }
51
-
52
- list() {
53
- return [...this.intents.values()].map((intent) => ({ ...intent }));
54
- }
55
-
56
- startupRecoveryPlan() {
57
- return [];
58
- }
59
-
60
- async write(intent) {
61
- if (!isResumeIntent(intent)) throw contractError('resume intent is invalid', 'persistence');
62
- await fs.mkdir(this.directory, { recursive: true, mode: 0o700 });
63
- const target = this.fileFor(intent.sourceTaskId);
64
- const temporary = `${target}.tmp-${process.pid}-${Date.now().toString(36)}`;
65
- try {
66
- const handle = await fs.open(temporary, 'wx', 0o600);
67
- try {
68
- await handle.writeFile(JSON.stringify(intent, null, 2), 'utf8');
69
- await handle.sync();
70
- } finally {
71
- await handle.close();
72
- }
73
- await fs.rename(temporary, target);
74
- } catch (error) {
75
- await fs.rm(temporary, { force: true }).catch(() => {});
76
- throw error;
77
- }
78
- this.intents.set(intent.sourceTaskId, { ...intent });
79
- }
80
-
81
- async markStarted(sourceTaskId, startedAt) {
82
- const intent = this.intents.get(sourceTaskId);
83
- if (!intent) throw contractError('prepared resume intent not found', 'persistence');
84
- await this.write({ ...intent, status: 'started', startedAt });
85
- }
86
- }
87
-
88
- module.exports = { DurableTaskResumeStore };
@@ -1,540 +0,0 @@
1
- 'use strict';
2
-
3
- const {createHash} = require('node:crypto');
4
-
5
- const EDITABLE_TOOL_ALLOWLIST = Object.freeze([
6
- 'Bash',
7
- 'Read',
8
- 'Write',
9
- 'Edit',
10
- 'Glob',
11
- 'Grep',
12
- 'FetchURL',
13
- ]);
14
- const EDITABLE_TOOL_ALLOWSET = new Set(EDITABLE_TOOL_ALLOWLIST);
15
- const DANGEROUS_KEYS = new Set(['__proto__', 'prototype', 'constructor']);
16
- const APPROVAL_RESPONSE_FIELDS = new Set([
17
- 'decision',
18
- 'scope',
19
- 'feedback',
20
- 'selected_label',
21
- 'edited_tool_input',
22
- 'edited_tool_input_json',
23
- ]);
24
- const DECISIONS = new Set(['approved', 'rejected', 'cancelled', 'edited']);
25
- const DEFAULT_LIMITS = Object.freeze({
26
- maxBytes: 65_536,
27
- maxDepth: 16,
28
- maxProperties: 256,
29
- maxCollectionItems: 512,
30
- maxDecodedStringChars: 32_768,
31
- maxChangedFields: 32,
32
- });
33
-
34
- class EditableToolApprovalError extends Error {
35
- constructor(code, message) {
36
- super(message);
37
- this.name = 'EditableToolApprovalError';
38
- this.code = code;
39
- }
40
- }
41
-
42
- function fail(code, message) {
43
- throw new EditableToolApprovalError(code, message);
44
- }
45
-
46
- function resolveLimits(overrides = {}) {
47
- if (overrides === null || typeof overrides !== 'object' || Array.isArray(overrides)) {
48
- fail('EDITED_INPUT_LIMITS_INVALID', 'Edited input limits must be an object.');
49
- }
50
- const limits = {...DEFAULT_LIMITS};
51
- for (const key of Object.keys(overrides)) {
52
- if (!Object.hasOwn(DEFAULT_LIMITS, key)) {
53
- fail('EDITED_INPUT_LIMITS_INVALID', `Unknown edited input limit: ${key}`);
54
- }
55
- const value = overrides[key];
56
- if (!Number.isSafeInteger(value) || value < 0) {
57
- fail('EDITED_INPUT_LIMITS_INVALID', `Edited input limit ${key} must be a non-negative safe integer.`);
58
- }
59
- if (value > DEFAULT_LIMITS[key]) {
60
- fail('EDITED_INPUT_LIMIT_WIDENING_FORBIDDEN', `Edited input limit ${key} cannot exceed its production default.`);
61
- }
62
- limits[key] = value;
63
- }
64
- return limits;
65
- }
66
-
67
- function isEditableToolApprovalEligible(toolName) {
68
- return typeof toolName === 'string' && EDITABLE_TOOL_ALLOWSET.has(toolName);
69
- }
70
-
71
- function validateUnicodeScalarString(value) {
72
- for (let index = 0; index < value.length; index += 1) {
73
- const code = value.charCodeAt(index);
74
- if (code >= 0xd800 && code <= 0xdbff) {
75
- const next = value.charCodeAt(index + 1);
76
- if (!(next >= 0xdc00 && next <= 0xdfff)) {
77
- fail('EDITED_INPUT_INVALID_UNICODE', 'Edited input contains an unpaired high surrogate.');
78
- }
79
- index += 1;
80
- } else if (code >= 0xdc00 && code <= 0xdfff) {
81
- fail('EDITED_INPUT_INVALID_UNICODE', 'Edited input contains an unpaired low surrogate.');
82
- }
83
- }
84
- }
85
-
86
- function createCounters(limits) {
87
- return {
88
- limits,
89
- properties: 0,
90
- collectionItems: 0,
91
- decodedStringChars: 0,
92
- };
93
- }
94
-
95
- function countString(counters, value) {
96
- validateUnicodeScalarString(value);
97
- counters.decodedStringChars += value.length;
98
- if (counters.decodedStringChars > counters.limits.maxDecodedStringChars) {
99
- fail('EDITED_INPUT_STRING_LIMIT', 'Edited input exceeds the decoded string limit.');
100
- }
101
- }
102
-
103
- function countProperty(counters) {
104
- counters.properties += 1;
105
- counters.collectionItems += 1;
106
- if (counters.properties > counters.limits.maxProperties) {
107
- fail('EDITED_INPUT_PROPERTIES_LIMIT', 'Edited input exceeds the property limit.');
108
- }
109
- if (counters.collectionItems > counters.limits.maxCollectionItems) {
110
- fail('EDITED_INPUT_COLLECTION_LIMIT', 'Edited input exceeds the collection item limit.');
111
- }
112
- }
113
-
114
- function countArrayItem(counters) {
115
- counters.collectionItems += 1;
116
- if (counters.collectionItems > counters.limits.maxCollectionItems) {
117
- fail('EDITED_INPUT_COLLECTION_LIMIT', 'Edited input exceeds the collection item limit.');
118
- }
119
- }
120
-
121
- function assertDepth(counters, depth) {
122
- if (depth > counters.limits.maxDepth) {
123
- fail('EDITED_INPUT_DEPTH_LIMIT', 'Edited input exceeds the nesting depth limit.');
124
- }
125
- }
126
-
127
- function parseEditedToolInputJson(rawJson, limitOverrides) {
128
- if (typeof rawJson !== 'string') {
129
- fail('EDITED_INPUT_INVALID_JSON', 'Edited tool input must be supplied as JSON text.');
130
- }
131
- const limits = resolveLimits(limitOverrides);
132
- if (Buffer.byteLength(rawJson, 'utf8') > limits.maxBytes) {
133
- fail('EDITED_INPUT_BYTES_LIMIT', 'Edited input exceeds the raw byte limit.');
134
- }
135
-
136
- const counters = createCounters(limits);
137
- let cursor = 0;
138
-
139
- function skipWhitespace() {
140
- while (cursor < rawJson.length && /[\u0009\u000a\u000d\u0020]/.test(rawJson[cursor])) cursor += 1;
141
- }
142
-
143
- function parseString() {
144
- if (rawJson[cursor] !== '"') fail('EDITED_INPUT_INVALID_JSON', 'Expected a JSON string.');
145
- cursor += 1;
146
- let output = '';
147
- while (cursor < rawJson.length) {
148
- const char = rawJson[cursor];
149
- cursor += 1;
150
- if (char === '"') {
151
- countString(counters, output);
152
- return output;
153
- }
154
- if (char === '\\') {
155
- if (cursor >= rawJson.length) fail('EDITED_INPUT_INVALID_JSON', 'Unterminated JSON escape.');
156
- const escape = rawJson[cursor];
157
- cursor += 1;
158
- const simple = {'"': '"', '\\': '\\', '/': '/', b: '\b', f: '\f', n: '\n', r: '\r', t: '\t'};
159
- if (Object.hasOwn(simple, escape)) {
160
- output += simple[escape];
161
- continue;
162
- }
163
- if (escape !== 'u') fail('EDITED_INPUT_INVALID_JSON', 'Invalid JSON escape.');
164
- const hex = rawJson.slice(cursor, cursor + 4);
165
- if (!/^[0-9a-fA-F]{4}$/.test(hex)) fail('EDITED_INPUT_INVALID_JSON', 'Invalid JSON Unicode escape.');
166
- cursor += 4;
167
- const code = Number.parseInt(hex, 16);
168
- if (code >= 0xd800 && code <= 0xdbff) {
169
- if (rawJson.slice(cursor, cursor + 2) !== '\\u') {
170
- fail('EDITED_INPUT_INVALID_UNICODE', 'Unpaired high surrogate in JSON escape.');
171
- }
172
- const lowHex = rawJson.slice(cursor + 2, cursor + 6);
173
- if (!/^[0-9a-fA-F]{4}$/.test(lowHex)) fail('EDITED_INPUT_INVALID_JSON', 'Invalid low surrogate escape.');
174
- const low = Number.parseInt(lowHex, 16);
175
- if (!(low >= 0xdc00 && low <= 0xdfff)) {
176
- fail('EDITED_INPUT_INVALID_UNICODE', 'Unpaired high surrogate in JSON escape.');
177
- }
178
- cursor += 6;
179
- output += String.fromCodePoint(0x10000 + ((code - 0xd800) << 10) + (low - 0xdc00));
180
- } else if (code >= 0xdc00 && code <= 0xdfff) {
181
- fail('EDITED_INPUT_INVALID_UNICODE', 'Unpaired low surrogate in JSON escape.');
182
- } else {
183
- output += String.fromCharCode(code);
184
- }
185
- continue;
186
- }
187
- const code = char.charCodeAt(0);
188
- if (code < 0x20) fail('EDITED_INPUT_INVALID_JSON', 'Unescaped control character in JSON string.');
189
- if (code >= 0xd800 && code <= 0xdbff) {
190
- const next = rawJson.charCodeAt(cursor);
191
- if (!(next >= 0xdc00 && next <= 0xdfff)) {
192
- fail('EDITED_INPUT_INVALID_UNICODE', 'Unpaired high surrogate in JSON string.');
193
- }
194
- output += char + rawJson[cursor];
195
- cursor += 1;
196
- } else if (code >= 0xdc00 && code <= 0xdfff) {
197
- fail('EDITED_INPUT_INVALID_UNICODE', 'Unpaired low surrogate in JSON string.');
198
- } else {
199
- output += char;
200
- }
201
- }
202
- fail('EDITED_INPUT_INVALID_JSON', 'Unterminated JSON string.');
203
- }
204
-
205
- function parseNumber() {
206
- const remainder = rawJson.slice(cursor);
207
- const match = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?/.exec(remainder);
208
- if (!match) fail('EDITED_INPUT_INVALID_JSON', 'Invalid JSON number.');
209
- cursor += match[0].length;
210
- const value = Number(match[0]);
211
- if (!Number.isFinite(value)) fail('EDITED_INPUT_NONFINITE_NUMBER', 'Edited input number must be finite.');
212
- return value;
213
- }
214
-
215
- function parseArray(depth) {
216
- assertDepth(counters, depth);
217
- cursor += 1;
218
- const output = [];
219
- skipWhitespace();
220
- if (rawJson[cursor] === ']') {
221
- cursor += 1;
222
- Object.setPrototypeOf(output, null);
223
- return Object.freeze(output);
224
- }
225
- while (true) {
226
- countArrayItem(counters);
227
- output[output.length] = parseValue(depth + 1);
228
- skipWhitespace();
229
- if (rawJson[cursor] === ']') {
230
- cursor += 1;
231
- Object.setPrototypeOf(output, null);
232
- return Object.freeze(output);
233
- }
234
- if (rawJson[cursor] !== ',') fail('EDITED_INPUT_INVALID_JSON', 'Expected comma or array end.');
235
- cursor += 1;
236
- skipWhitespace();
237
- }
238
- }
239
-
240
- function parseObject(depth) {
241
- assertDepth(counters, depth);
242
- cursor += 1;
243
- const output = Object.create(null);
244
- const keys = new Set();
245
- skipWhitespace();
246
- if (rawJson[cursor] === '}') {
247
- cursor += 1;
248
- return Object.freeze(output);
249
- }
250
- while (true) {
251
- if (rawJson[cursor] !== '"') fail('EDITED_INPUT_INVALID_JSON', 'Expected an object key.');
252
- const key = parseString();
253
- if (DANGEROUS_KEYS.has(key)) fail('EDITED_INPUT_DANGEROUS_KEY', `Dangerous edited input key: ${key}`);
254
- if (keys.has(key)) fail('EDITED_INPUT_DUPLICATE_KEY', `Duplicate edited input key: ${key}`);
255
- keys.add(key);
256
- countProperty(counters);
257
- skipWhitespace();
258
- if (rawJson[cursor] !== ':') fail('EDITED_INPUT_INVALID_JSON', 'Expected colon after object key.');
259
- cursor += 1;
260
- output[key] = parseValue(depth + 1);
261
- skipWhitespace();
262
- if (rawJson[cursor] === '}') {
263
- cursor += 1;
264
- return Object.freeze(output);
265
- }
266
- if (rawJson[cursor] !== ',') fail('EDITED_INPUT_INVALID_JSON', 'Expected comma or object end.');
267
- cursor += 1;
268
- skipWhitespace();
269
- }
270
- }
271
-
272
- function parseValue(depth) {
273
- skipWhitespace();
274
- const char = rawJson[cursor];
275
- if (char === '{') return parseObject(depth);
276
- if (char === '[') return parseArray(depth);
277
- if (char === '"') return parseString();
278
- if (char === '-' || (char >= '0' && char <= '9')) return parseNumber();
279
- if (rawJson.startsWith('true', cursor)) {
280
- cursor += 4;
281
- return true;
282
- }
283
- if (rawJson.startsWith('false', cursor)) {
284
- cursor += 5;
285
- return false;
286
- }
287
- if (rawJson.startsWith('null', cursor)) {
288
- cursor += 4;
289
- return null;
290
- }
291
- fail('EDITED_INPUT_INVALID_JSON', 'Invalid JSON value.');
292
- }
293
-
294
- skipWhitespace();
295
- const value = parseValue(1);
296
- skipWhitespace();
297
- if (cursor !== rawJson.length) fail('EDITED_INPUT_TRAILING_CONTENT', 'Edited input has trailing content.');
298
- if (value === null || typeof value !== 'object' || Array.isArray(value)) {
299
- fail('EDITED_INPUT_OBJECT_REQUIRED', 'Edited tool input must be a top-level JSON object.');
300
- }
301
- return value;
302
- }
303
-
304
- function validateEditedToolInputObject(input, limitOverrides) {
305
- const limits = resolveLimits(limitOverrides);
306
- const counters = createCounters(limits);
307
-
308
- function clone(value, depth) {
309
- if (value === null || typeof value === 'boolean') return value;
310
- if (typeof value === 'string') {
311
- countString(counters, value);
312
- return value;
313
- }
314
- if (typeof value === 'number') {
315
- if (!Number.isFinite(value)) fail('EDITED_INPUT_NONFINITE_NUMBER', 'Edited input number must be finite.');
316
- return value;
317
- }
318
- if (value === undefined) fail('EDITED_INPUT_UNDEFINED_REJECTED', 'Undefined is not valid edited JSON input.');
319
- if (typeof value === 'function' || typeof value === 'bigint') {
320
- fail('EDITED_INPUT_EXECUTABLE_REJECTED', 'Executable or non-JSON values are forbidden in edited input.');
321
- }
322
- if (typeof value === 'symbol') fail('EDITED_INPUT_SYMBOL_REJECTED', 'Symbols are forbidden in edited input.');
323
-
324
- assertDepth(counters, depth);
325
- const symbols = Object.getOwnPropertySymbols(value);
326
- if (symbols.length > 0) fail('EDITED_INPUT_SYMBOL_REJECTED', 'Symbol keys are forbidden in edited input.');
327
- const descriptors = Object.getOwnPropertyDescriptors(value);
328
-
329
- if (Array.isArray(value)) {
330
- const prototype = Object.getPrototypeOf(value);
331
- if (prototype !== Array.prototype && prototype !== null) {
332
- fail('EDITED_INPUT_PROTOTYPE_REJECTED', 'Foreign array prototypes are forbidden in edited input.');
333
- }
334
- const output = [];
335
- for (const key of Reflect.ownKeys(descriptors)) {
336
- if (key === 'length') continue;
337
- if (typeof key !== 'string' || !/^(?:0|[1-9]\d*)$/.test(key) || Number(key) >= value.length) {
338
- fail('EDITED_INPUT_ARRAY_PROPERTY_REJECTED', 'Non-index array properties are forbidden in edited input.');
339
- }
340
- }
341
- for (let index = 0; index < value.length; index += 1) {
342
- const descriptor = descriptors[String(index)];
343
- if (!descriptor) fail('EDITED_INPUT_ARRAY_HOLE_REJECTED', 'Sparse arrays are forbidden in edited input.');
344
- if (!Object.hasOwn(descriptor, 'value')) {
345
- fail('EDITED_INPUT_ACCESSOR_REJECTED', 'Accessors are forbidden in edited input.');
346
- }
347
- countArrayItem(counters);
348
- output[index] = clone(descriptor.value, depth + 1);
349
- }
350
- Object.setPrototypeOf(output, null);
351
- return Object.freeze(output);
352
- }
353
-
354
- const prototype = Object.getPrototypeOf(value);
355
- if (prototype !== Object.prototype && prototype !== null) {
356
- fail('EDITED_INPUT_PROTOTYPE_REJECTED', 'Foreign object prototypes are forbidden in edited input.');
357
- }
358
- const output = Object.create(null);
359
- for (const key of Reflect.ownKeys(descriptors)) {
360
- if (typeof key !== 'string') fail('EDITED_INPUT_SYMBOL_REJECTED', 'Symbol keys are forbidden in edited input.');
361
- if (DANGEROUS_KEYS.has(key)) fail('EDITED_INPUT_DANGEROUS_KEY', `Dangerous edited input key: ${key}`);
362
- const descriptor = descriptors[key];
363
- if (!Object.hasOwn(descriptor, 'value')) {
364
- fail('EDITED_INPUT_ACCESSOR_REJECTED', 'Accessors are forbidden in edited input.');
365
- }
366
- if (!descriptor.enumerable) {
367
- fail('EDITED_INPUT_NONENUMERABLE_REJECTED', 'Non-enumerable properties are forbidden in edited input.');
368
- }
369
- countString(counters, key);
370
- countProperty(counters);
371
- output[key] = clone(descriptor.value, depth + 1);
372
- }
373
- return Object.freeze(output);
374
- }
375
-
376
- if (input === null || typeof input !== 'object' || Array.isArray(input)) {
377
- fail('EDITED_INPUT_OBJECT_REQUIRED', 'Edited tool input must be a top-level object.');
378
- }
379
- const output = clone(input, 1);
380
- if (Buffer.byteLength(canonicalValueJson(output), 'utf8') > limits.maxBytes) {
381
- fail('EDITED_INPUT_BYTES_LIMIT', 'Edited input exceeds the canonical byte limit.');
382
- }
383
- return output;
384
- }
385
-
386
- function readApprovalResponse(response) {
387
- if (response === null || typeof response !== 'object' || Array.isArray(response)) {
388
- fail('EDITED_APPROVAL_RESPONSE_INVALID', 'Approval response must be an object.');
389
- }
390
- const prototype = Object.getPrototypeOf(response);
391
- if (prototype !== Object.prototype && prototype !== null) {
392
- fail('EDITED_APPROVAL_RESPONSE_INVALID', 'Approval response must have a plain prototype.');
393
- }
394
- if (Object.getOwnPropertySymbols(response).length > 0) {
395
- fail('EDITED_APPROVAL_UNKNOWN_FIELD', 'Approval response symbol fields are forbidden.');
396
- }
397
- const descriptors = Object.getOwnPropertyDescriptors(response);
398
- const values = Object.create(null);
399
- for (const key of Object.keys(descriptors)) {
400
- if (!APPROVAL_RESPONSE_FIELDS.has(key)) {
401
- fail('EDITED_APPROVAL_UNKNOWN_FIELD', `Unknown approval response field: ${key}`);
402
- }
403
- const descriptor = descriptors[key];
404
- if (!Object.hasOwn(descriptor, 'value')) {
405
- fail('EDITED_APPROVAL_RESPONSE_INVALID', 'Approval response accessors are forbidden.');
406
- }
407
- values[key] = descriptor.value;
408
- }
409
- return {descriptors, values};
410
- }
411
-
412
- function validateEditedApprovalDecision({response, toolName, editCount, limits} = {}) {
413
- const {descriptors, values} = readApprovalResponse(response);
414
- if (!DECISIONS.has(values.decision)) {
415
- fail('EDITED_APPROVAL_DECISION_INVALID', 'Unknown approval decision.');
416
- }
417
- if (!Number.isSafeInteger(editCount) || editCount < 0) {
418
- fail('EDITED_APPROVAL_EDIT_COUNT_INVALID', 'Edit count must be a non-negative safe integer.');
419
- }
420
- const hasObjectInput = Object.hasOwn(descriptors, 'edited_tool_input');
421
- const hasJsonInput = Object.hasOwn(descriptors, 'edited_tool_input_json');
422
-
423
- if (values.decision !== 'edited') {
424
- if (hasObjectInput || hasJsonInput) {
425
- fail('EDITED_APPROVAL_INPUT_FORBIDDEN', 'Edited tool input is only valid for an edited decision.');
426
- }
427
- return Object.freeze({
428
- decision: values.decision,
429
- ...(Object.hasOwn(descriptors, 'scope') ? {scope: values.scope} : {}),
430
- ...(Object.hasOwn(descriptors, 'feedback') ? {feedback: values.feedback} : {}),
431
- ...(Object.hasOwn(descriptors, 'selected_label') ? {selectedLabel: values.selected_label} : {}),
432
- });
433
- }
434
-
435
- if (!isEditableToolApprovalEligible(toolName)) {
436
- fail('EDITED_APPROVAL_TOOL_INELIGIBLE', `Tool ${String(toolName)} does not allow edited approval.`);
437
- }
438
- if (editCount !== 0) fail('EDITED_APPROVAL_ALREADY_EDITED', 'A tool call may be edited at most once.');
439
- if (Object.hasOwn(descriptors, 'scope')) {
440
- fail('EDITED_APPROVAL_SCOPE_FORBIDDEN', 'Edited approval cannot create session scope.');
441
- }
442
- if (hasObjectInput === hasJsonInput) {
443
- fail('EDITED_APPROVAL_INPUT_REQUIRED', 'Edited approval requires exactly one edited input representation.');
444
- }
445
- const editedToolInput = hasJsonInput
446
- ? parseEditedToolInputJson(values.edited_tool_input_json, limits)
447
- : validateEditedToolInputObject(values.edited_tool_input, limits);
448
- return Object.freeze({decision: 'edited', editedToolInput});
449
- }
450
-
451
- function canonicalEditedToolInputJson(input) {
452
- const safeInput = validateEditedToolInputObject(input);
453
- function encode(value) {
454
- if (value === null) return 'null';
455
- if (typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number') {
456
- return JSON.stringify(value);
457
- }
458
- if (Array.isArray(value)) return `[${Array.from(value, encode).join(',')}]`;
459
- const keys = Object.keys(value).sort();
460
- return `{${keys.map((key) => `${JSON.stringify(key)}:${encode(value[key])}`).join(',')}}`;
461
- }
462
- return encode(safeInput);
463
- }
464
-
465
- function hashEditedToolInput(input) {
466
- return createHash('sha256').update(canonicalEditedToolInputJson(input), 'utf8').digest('hex');
467
- }
468
-
469
- function changedTopLevelFields(originalArgs, editedArgs) {
470
- const keys = new Set([...Object.keys(originalArgs), ...Object.keys(editedArgs)]);
471
- const changed = [];
472
- for (const key of keys) {
473
- const originalHas = Object.hasOwn(originalArgs, key);
474
- const editedHas = Object.hasOwn(editedArgs, key);
475
- if (originalHas !== editedHas) {
476
- changed.push(key);
477
- continue;
478
- }
479
- const originalValue = originalArgs[key];
480
- const editedValue = editedArgs[key];
481
- const originalJson = canonicalValueJson(originalValue);
482
- const editedJson = canonicalValueJson(editedValue);
483
- if (originalJson !== editedJson) changed.push(key);
484
- }
485
- return changed.sort();
486
- }
487
-
488
- function canonicalValueJson(value) {
489
- if (value === null) return 'null';
490
- if (typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number') return JSON.stringify(value);
491
- if (Array.isArray(value)) return `[${Array.from(value, canonicalValueJson).join(',')}]`;
492
- const keys = Object.keys(value).sort();
493
- return `{${keys.map((key) => `${JSON.stringify(key)}:${canonicalValueJson(value[key])}`).join(',')}}`;
494
- }
495
-
496
- function buildApprovalEditedEvent({
497
- turnId,
498
- toolCallId,
499
- toolName,
500
- originalArgs,
501
- editedArgs,
502
- maxChangedFields = DEFAULT_LIMITS.maxChangedFields,
503
- } = {}) {
504
- if (!Number.isSafeInteger(turnId) || turnId < 0 || typeof toolCallId !== 'string' || toolCallId.length === 0 || toolCallId.length > 512) {
505
- fail('EDITED_EVENT_IDENTITY_INVALID', 'Approval edited event identity is invalid.');
506
- }
507
- if (!isEditableToolApprovalEligible(toolName)) {
508
- fail('EDITED_APPROVAL_TOOL_INELIGIBLE', `Tool ${String(toolName)} does not allow edited approval.`);
509
- }
510
- if (!Number.isSafeInteger(maxChangedFields) || maxChangedFields < 0 || maxChangedFields > DEFAULT_LIMITS.maxChangedFields) {
511
- fail('EDITED_EVENT_CHANGED_FIELDS_LIMIT_INVALID', 'Changed-field limit is invalid.');
512
- }
513
- const safeOriginal = validateEditedToolInputObject(originalArgs);
514
- const safeEdited = validateEditedToolInputObject(editedArgs);
515
- const allChangedFields = changedTopLevelFields(safeOriginal, safeEdited);
516
- const changedFields = Object.freeze(allChangedFields.slice(0, maxChangedFields));
517
- return Object.freeze({
518
- type: 'permission.approval_edited',
519
- turnId,
520
- toolCallId,
521
- toolName,
522
- originalArgsSha256: hashEditedToolInput(safeOriginal),
523
- editedArgsSha256: hashEditedToolInput(safeEdited),
524
- changedFields,
525
- ...(allChangedFields.length > changedFields.length ? {changedFieldsTruncated: true} : {}),
526
- });
527
- }
528
-
529
- module.exports = Object.freeze({
530
- DEFAULT_LIMITS,
531
- EDITABLE_TOOL_ALLOWLIST,
532
- EditableToolApprovalError,
533
- buildApprovalEditedEvent,
534
- canonicalEditedToolInputJson,
535
- hashEditedToolInput,
536
- isEditableToolApprovalEligible,
537
- parseEditedToolInputJson,
538
- validateEditedApprovalDecision,
539
- validateEditedToolInputObject,
540
- });