@sema-agent/core 7.66.1 → 7.67.1

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 (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -1,7 +1,8 @@
1
1
  import { selectModel } from "./select-model.js";
2
2
  import { namesRoleBase } from "../prompt-assembly/role-base.js";
3
3
  import { readPromptRole } from "../prompt-assembly/select.js";
4
- import { bindingShown, isList, isModelSnapshot, modelBindingRefusal, receiveModel } from "./model-receipt.js";
4
+ import { bindingShown, forkModelSnapshot, isList, isModelSnapshot, modelBindingRefusal, receiveModel } from "./model-receipt.js";
5
+ import { MAX_MODEL_FALLBACKS, modelFallbackRefusal, recordedFallbackChainOf, recordFallbackChain } from "./model-fallbacks.js";
5
6
  import { describeFault, receive } from "./mods/kernel/receive.js";
6
7
  import { CONFIG_RECEIPT_MODE, DECLARATION_RECEIPT_MODE, receiveOwnProperties } from "./own-property-receipt.js";
7
8
  import { MODEL_ROLES } from "./types.js";
@@ -12,8 +13,30 @@ function catalogEntry(ref, models) {
12
13
  return m || undefined;
13
14
  }
14
15
  export function catalogModel(ref, models, seat, what = `${bindingShown(ref)} (a catalog entry)`) {
15
- const m = catalogEntry(ref, models);
16
- return m === undefined ? undefined : receiveModel(m, seat, what);
16
+ const at = entryAt(ref, models, seat, what);
17
+ return at === undefined ? undefined : chainedRead(at, models, seat, () => readSubject(ref, seat), (word) => entryAt(word, models, seat, `${bindingShown(word)} (a fallback of the catalog entry ${bindingShown(ref)})`)?.entry);
18
+ }
19
+ const readSubject = (ref, seat) => `the \`fallbacks\` of the catalog entry ${bindingShown(ref)} (read at ${seat})`;
20
+ function entryAt(ref, models, seat, what) {
21
+ const written = catalogEntry(ref, models);
22
+ return written === undefined ? undefined : { written, entry: receiveModel(written, seat, what, "", true) };
23
+ }
24
+ function chainedRead(at, models, seat, subject, hopOf) {
25
+ const { written, entry } = at;
26
+ const words = entry.fallbacks;
27
+ if (words === undefined || written === entry)
28
+ return entry;
29
+ return chainedSnapshot(entry, chainHops(entry, words, hopOf, models, seat, subject()));
30
+ }
31
+ export function isCatalogEntry(ref, models) {
32
+ return catalogEntry(ref, models) !== undefined;
33
+ }
34
+ export function catalogSliceOf(ref, models) {
35
+ const entry = catalogEntry(ref, models);
36
+ const slice = {};
37
+ if (entry !== undefined)
38
+ Object.defineProperty(slice, ref, { value: entry, enumerable: true, writable: true, configurable: true });
39
+ return slice;
17
40
  }
18
41
  const ROLE_RECORD_KEYS = new Set(["model", "select", "thinking", "promptRole", "systemPrompt"]);
19
42
  function isBindingObject(value) {
@@ -35,7 +58,7 @@ function modelObjectAt(value, seat, binds) {
35
58
  if (typeof value !== "object" || value === null || isList(value)) {
36
59
  throw modelBindingRefusal(seat, "not_a_model_ref", `${seat} is ${bindingShown(value)}, not a model reference — ${binds}.`);
37
60
  }
38
- return receiveModel(value, seat, "a Model object", binds === ROLE_BINDS ? " At a role seat an object that is not a plain record of model / select / thinking / promptRole / systemPrompt is read as a Model, not as a role record." : "");
61
+ return receiveModel(value, seat, "a Model object", binds === ROLE_BINDS ? " At a role seat an object that is not a plain record of model / select / thinking / promptRole / systemPrompt is read as a Model, not as a role record." : "", binds === TIER_BINDS);
39
62
  }
40
63
  const ROLE_BINDS = "a role binds a catalog model name or a Model object";
41
64
  const TIER_BINDS = "a tier binds a catalog model name or a Model object";
@@ -109,7 +132,7 @@ export function resolveModelDisplayLabel(ref) {
109
132
  }
110
133
  const TIERS_ACTIVE = Symbol.for("sema.tiersActive");
111
134
  const TIER_ALIAS_VIA = Symbol.for("sema.tierAliasVia");
112
- export function expandTiers(models, tiers) {
135
+ function expandTierKeys(models, tiers, laidOut) {
113
136
  if (!tiers || Object.keys(tiers).length === 0)
114
137
  return models;
115
138
  const out = { ...models };
@@ -120,7 +143,13 @@ export function expandTiers(models, tiers) {
120
143
  const b = Object.hasOwn(tiers, name) ? tiers[name] : undefined;
121
144
  if (b === undefined)
122
145
  return undefined;
123
- return modelOfBinding(b, models, `tiers.${name}`, TIER_BINDS);
146
+ const seat = `tiers.${name}`;
147
+ if (typeof b !== "string")
148
+ return { model: modelObjectAt(b, seat, TIER_BINDS), written: b };
149
+ const at = entryAt(b, models, seat, `${bindingShown(b)} (a catalog entry)`);
150
+ if (at === undefined)
151
+ throw unknownModelRefRefusal(b, seat);
152
+ return { model: at.entry, written: at.written };
124
153
  };
125
154
  const ownKey = (k) => models !== undefined && Object.hasOwn(models, k) && Boolean(models[k]);
126
155
  const landing = (t, self) => {
@@ -128,7 +157,7 @@ export function expandTiers(models, tiers) {
128
157
  if (!m)
129
158
  return undefined;
130
159
  const b = Object.hasOwn(tiers, t) ? tiers[t] : undefined;
131
- return { model: m, via: [...(t !== self && !ownKey(t) ? [t] : []), ...(typeof b === "string" ? [b] : [])] };
160
+ return { ...m, via: [...(t !== self && !ownKey(t) ? [t] : []), ...(typeof b === "string" ? [b] : [])], seat: `tiers.${t}` };
132
161
  };
133
162
  const resolveTier = (name, self = name) => {
134
163
  const direct = landing(name, self);
@@ -140,14 +169,15 @@ export function expandTiers(models, tiers) {
140
169
  for (let i = at + 1; i < DEFAULT_TIER_ORDER.length; i++) {
141
170
  const next = landing(DEFAULT_TIER_ORDER[i], self);
142
171
  if (next)
143
- return { model: next.model, via: [...(name !== self && !ownKey(name) ? [name] : []), ...next.via] };
172
+ return { ...next, via: [...(name !== self && !ownKey(name) ? [name] : []), ...next.via] };
144
173
  }
145
174
  return undefined;
146
175
  };
147
176
  const shadowed = (key) => Object.hasOwn(out, key) && Boolean(out[key]);
148
- const put = (key, m, via) => {
149
- Object.defineProperty(out, key, { value: m, writable: true, enumerable: true, configurable: true });
150
- aliasVia.set(key, via);
177
+ const put = (key, r) => {
178
+ Object.defineProperty(out, key, { value: r.model, writable: true, enumerable: true, configurable: true });
179
+ aliasVia.set(key, r.via);
180
+ laidOut?.set(key, r);
151
181
  };
152
182
  const tierNames = new Set([...DEFAULT_TIER_ORDER, ...Object.keys(tiers)]);
153
183
  for (const name of tierNames) {
@@ -155,26 +185,39 @@ export function expandTiers(models, tiers) {
155
185
  continue;
156
186
  const r = resolveTier(name);
157
187
  if (r)
158
- put(name, r.model, r.via);
188
+ put(name, r);
159
189
  }
160
190
  for (const [alias, tier] of Object.entries(CC_MODEL_TIER_ALIASES)) {
161
191
  if (shadowed(alias))
162
192
  continue;
163
193
  const r = resolveTier(tier, alias);
164
194
  if (r)
165
- put(alias, r.model, r.via);
195
+ put(alias, r);
166
196
  }
167
197
  if (!shadowed("best")) {
168
198
  for (const name of DEFAULT_TIER_ORDER) {
169
199
  const r = landing(name, "best");
170
200
  if (r) {
171
- put("best", r.model, r.via);
201
+ put("best", r);
172
202
  break;
173
203
  }
174
204
  }
175
205
  }
176
206
  return out;
177
207
  }
208
+ export function expandTiers(models, tiers) {
209
+ const laidOut = new Map();
210
+ const out = expandTierKeys(models, tiers, laidOut);
211
+ if (out === undefined || out === models)
212
+ return out;
213
+ for (const [key, { model, seat, written }] of laidOut) {
214
+ const subject = () => `the \`fallbacks\` of the model the tier key ${bindingShown(key)} lays out (${seat})`;
215
+ const chained = chainedRead({ written, entry: model }, out, seat, subject, (word) => entryAt(word, out, seat, `${bindingShown(word)} (a fallback of the model the tier key ${bindingShown(key)} lays out)`)?.entry);
216
+ if (chained !== model)
217
+ Object.defineProperty(out, key, { value: chained, writable: true, enumerable: true, configurable: true });
218
+ }
219
+ return out;
220
+ }
178
221
  const RECEIVED_CATALOGS = new WeakSet();
179
222
  export function isReceivedCatalog(models) {
180
223
  return models !== undefined && RECEIVED_CATALOGS.has(models);
@@ -189,7 +232,7 @@ export function receiveModelCatalog(models, tiers, field) {
189
232
  held = {};
190
233
  for (const key of Object.keys(given)) {
191
234
  const m = given[key];
192
- Object.defineProperty(held, key, { value: m ? receiveModel(m, `${field}.models.${key}`, `${bindingShown(key)} (a catalog entry)`) : m, enumerable: true, writable: true, configurable: true });
235
+ Object.defineProperty(held, key, { value: m ? receiveModel(m, `${field}.models.${key}`, `${bindingShown(key)} (a catalog entry)`, "", true) : m, enumerable: true, writable: true, configurable: true });
193
236
  }
194
237
  }
195
238
  let bindings;
@@ -202,11 +245,87 @@ export function receiveModelCatalog(models, tiers, field) {
202
245
  }
203
246
  Object.freeze(bindings);
204
247
  }
205
- const expanded = bindings !== undefined && Object.keys(bindings).length > 0 ? expandTiers(held, bindings) : held;
206
- if (expanded !== undefined)
248
+ const expanded = bindings !== undefined && Object.keys(bindings).length > 0 ? expandTierKeys(held, bindings) : held;
249
+ if (expanded !== undefined) {
250
+ resolveFallbackChains(expanded, field);
207
251
  RECEIVED_CATALOGS.add(Object.freeze(expanded));
252
+ }
208
253
  return { ...(expanded !== undefined ? { models: expanded } : {}), ...(bindings !== undefined ? { tiers: bindings } : {}) };
209
254
  }
255
+ function resolveFallbackChains(catalog, field) {
256
+ const firstKey = new Map();
257
+ for (const key of Object.keys(catalog)) {
258
+ const entry = catalogEntry(key, catalog);
259
+ if (entry !== undefined)
260
+ firstKey.set(entry, firstKey.get(entry) ?? key);
261
+ }
262
+ const resolved = new Map();
263
+ for (const [entry, key] of firstKey) {
264
+ const words = entry.fallbacks;
265
+ if (words === undefined)
266
+ continue;
267
+ const seat = `${field}.models.${key}.fallbacks`;
268
+ resolved.set(entry, chainHops(entry, words, (word) => catalogEntry(word, catalog), catalog, seat, seat));
269
+ }
270
+ const forks = new Map();
271
+ for (const [entry, hops] of resolved) {
272
+ const chained = chainedSnapshot(entry, hops);
273
+ if (chained !== entry)
274
+ forks.set(entry, chained);
275
+ }
276
+ if (forks.size === 0)
277
+ return;
278
+ for (const key of Object.keys(catalog)) {
279
+ const fork = forks.get(Object.getOwnPropertyDescriptor(catalog, key)?.value);
280
+ if (fork !== undefined)
281
+ Object.defineProperty(catalog, key, { value: fork, writable: true, enumerable: true, configurable: true });
282
+ }
283
+ }
284
+ function chainHops(entry, words, hopOf, catalog, field, subject) {
285
+ if (words.length > MAX_MODEL_FALLBACKS) {
286
+ throw modelFallbackRefusal(field, `${subject} names ${words.length} models — a chain holds at most ${MAX_MODEL_FALLBACKS} (more is refused, never cut).`);
287
+ }
288
+ const hops = [];
289
+ for (const word of words) {
290
+ const hop = hopOf(word);
291
+ if (hop === undefined)
292
+ throw modelFallbackRefusal(field, `${subject} names ${bindingShown(word)}, which this catalog does not hold — a fallback is a catalog word.${unexpandedTierWordNote(word, catalog)}`);
293
+ if (hop === entry || hop.id === entry.id)
294
+ throw modelFallbackRefusal(field, `${subject} names ${bindingShown(word)}, which is the model ${bindingShown(entry.id)} itself — a fallback is another model.`);
295
+ if (hops.some((h) => h === hop || h.id === hop.id))
296
+ throw modelFallbackRefusal(field, `${subject} names ${bindingShown(word)}, the model ${bindingShown(hop.id)} a word before it already names — each hop is a different model.`);
297
+ hops.push(hop);
298
+ }
299
+ return hops;
300
+ }
301
+ function chainedSnapshot(entry, hops) {
302
+ const before = recordedFallbackChainOf(entry);
303
+ if (before === undefined) {
304
+ recordFallbackChain(entry, hops);
305
+ return entry;
306
+ }
307
+ return sameHops(before, hops) ? entry : chainedFork(entry, hops);
308
+ }
309
+ function sameHops(a, b) {
310
+ return a.length === b.length && a.every((h, i) => h === b[i]);
311
+ }
312
+ const FORKS = new WeakMap();
313
+ function chainedFork(entry, hops) {
314
+ const known = FORKS.get(entry) ?? [];
315
+ const found = known.find((f) => sameHops(recordedFallbackChainOf(f) ?? [], hops));
316
+ if (found !== undefined)
317
+ return found;
318
+ const fork = forkModelSnapshot(entry);
319
+ recordFallbackChain(fork, hops);
320
+ FORKS.set(entry, [...known, fork]);
321
+ return fork;
322
+ }
323
+ function unexpandedTierWordNote(word, catalog) {
324
+ const tierWord = DEFAULT_TIER_ORDER.includes(word) || Object.hasOwn(CC_MODEL_TIER_ALIASES, word) || word === "best";
325
+ if (!tierWord || catalog?.[TIERS_ACTIVE] === true)
326
+ return "";
327
+ return ` ${bindingShown(word)} is a tier word, and this catalog was handed over without its tier expansion: hand over the tier bindings beside it (\`tiers\`), or its expansion (\`expandTiers(models, tiers)\`), and the word is one of its keys.`;
328
+ }
210
329
  export function tierAliasVia(word, models) {
211
330
  const via = models?.[TIER_ALIAS_VIA];
212
331
  return via?.get(word) ?? [];
@@ -332,13 +451,21 @@ function partsModel(parts, models, seat = "a role seat") {
332
451
  if (needs != null && !Array.isArray(needs)) {
333
452
  throw modelBindingRefusal(`${seat}.select`, "not_a_model_ref", `${seat}.select.needs is ${bindingShown(needs)}, not a list of capabilities (vision / reasoning).`);
334
453
  }
454
+ const at = `${seat}.select`;
335
455
  const held = [];
456
+ const byKey = new Map();
336
457
  for (const key of models != null && typeof models === "object" ? Object.keys(models) : []) {
337
- const m = catalogModel(key, models, `${seat}.select`, `the catalog entry ${bindingShown(key)} the criteria read`);
338
- if (m !== undefined)
339
- held.push(m);
458
+ const read = entryAt(key, models, at, `the catalog entry ${bindingShown(key)} the criteria read`);
459
+ if (read === undefined)
460
+ continue;
461
+ held.push(read.entry);
462
+ byKey.set(key, read);
340
463
  }
341
- return selectModel(held, parts.select);
464
+ const picked = selectModel(held, parts.select);
465
+ if (picked === undefined)
466
+ return undefined;
467
+ const [key, read] = [...byKey].find(([, r]) => r.entry === picked);
468
+ return chainedRead(read, models, at, () => readSubject(key, at), (word) => byKey.get(word)?.entry ?? entryAt(word, models, at, `${bindingShown(word)} (a fallback of the catalog entry ${bindingShown(key)})`)?.entry);
342
469
  }
343
470
  return undefined;
344
471
  }
@@ -0,0 +1,149 @@
1
+ /**
2
+ * The shape reading of a persisted row, written once per row family: a MEMBER-SHAPE TABLE beside the family's row type, and
3
+ * one factory ({@link rowShapeReader}) that turns it into the family's only reader. Every face of a store that reaches into a
4
+ * stored row's members — the replay's row judge, a listing, a `get`, a transition that reads a member before it writes — asks
5
+ * that reader, so no face answers "this row reads" for a row another face cannot read.
6
+ *
7
+ * NAMED SEGMENTS, IN ORDER. A table is a list of named segments. The `rowKey` segment is the family's row predicate as the
8
+ * replay reads it (what files a row under its key); the others are the members the readers reach for. A face judges exactly
9
+ * the segments it judged before this table existed, named at the call — the replay judges `rowKey` alone, so a row the replay
10
+ * kept is still kept; a listing or a `get` judges every segment. Event envelopes (the tag, the event's own key, a delete arm)
11
+ * and container predicates (a document's own shape) are not rows and stay with their store.
12
+ *
13
+ * EXITS, PER MEMBER, FROM A CLOSED SET ({@link ROW_EXITS}). A table names the exit of a row that does not read; an entry may name
14
+ * another for its member; a row's exit is the exit of the FIRST member that does not read. `list-damaged`: the row stays where
15
+ * it is, a listing answers it by its identity and a damaged verdict, a `get` and every verb that reads its members refuse in the
16
+ * family's code, deletion by key goes on. `block`: an ordered log's exit — the readable prefix is served and nothing is served,
17
+ * leased, acknowledged or counted past the first record that does not read. `omit` and `refuse-container` are the exits of a
18
+ * rule family's row (one row left out with a disclosure on every read; the whole container refused); no table here uses them yet.
19
+ *
20
+ * NOTHING IS ERASED FOR NOT READING: a reader answers; it never removes a row, and no face removes a row because it does not read.
21
+ *
22
+ * WORDS: the corrupt forms are the store contract's ({@link CorruptBodyForm}) — a member that is absent where the table requires
23
+ * it is `missing-required`; one of another type, outside its closed set, or contradicting the row's key is `wrong-type`; a row
24
+ * that is no object is `not-an-object`. An answer's `why` names the member by its path and its shape, never by its value.
25
+ */
26
+ import type { CorruptBodyForm } from "./store-contracts/read-back-shape-contract.js";
27
+ /** The exits of a row that does not read (closed; see the module note). */
28
+ export declare const ROW_EXITS: readonly ["list-damaged", "block", "omit", "refuse-container"];
29
+ export type RowExit = (typeof ROW_EXITS)[number];
30
+ /** What a store knows about a row besides its body: the key it files the row under, and the members its medium holds as the
31
+ * authority over the body (a SQL row's primary key, partition scope and OCC revision columns — never a lossy display column). */
32
+ export interface RowContext {
33
+ readonly key: string;
34
+ readonly authoritative?: Readonly<Record<string, unknown>>;
35
+ }
36
+ /** A row that does not read: the corrupt form, the segment and member that failed first, the exit it takes, and why. */
37
+ export interface RowCorrupt {
38
+ readonly corrupt: CorruptBodyForm;
39
+ readonly segment: string;
40
+ readonly member: string;
41
+ readonly exit: RowExit;
42
+ readonly why: string;
43
+ }
44
+ /**
45
+ * A reader's answer: `row` — the row as its readers read it (the stored object itself, or a shallow copy carrying the readings of
46
+ * members that were absent, that a member's own reader normalizes, or that the medium holds authoritatively) — or a corrupt row.
47
+ */
48
+ export type RowAnswer<T> = {
49
+ readonly row: T;
50
+ } | RowCorrupt;
51
+ /** A listed row's verdict: `ok`, or `damaged` with the family's code, the member that failed first, its corrupt form and the
52
+ * family's fixed engine sentence (the sentence a refusal of the same row starts with). Closed words and engine text only. */
53
+ export type RowVerdict = {
54
+ readonly kind: "ok";
55
+ } | DamagedRowVerdict;
56
+ /** The verdict of a row that does not read. A listing's damaged entry carries it as `rowVerdict` — the member a readable entry never
57
+ * has, so `"rowVerdict" in entry` is the narrowing. */
58
+ export interface DamagedRowVerdict {
59
+ readonly kind: "damaged";
60
+ readonly code: string;
61
+ readonly member: string;
62
+ readonly form: CorruptBodyForm;
63
+ readonly sentence: string;
64
+ }
65
+ /** One member's reading: it reads as stored, it reads AS a value (an absent member's reading, a reader's normalization), or not. */
66
+ export type MemberReading = {
67
+ readonly reads: true;
68
+ readonly as?: unknown;
69
+ readonly replaced?: true;
70
+ } | {
71
+ readonly form: CorruptBodyForm;
72
+ readonly why: string;
73
+ };
74
+ /** One entry of a table: the member's name (its path, for an answer) and its judgment over the record and the row's context. */
75
+ export interface MemberEntry {
76
+ readonly member: string;
77
+ readonly exit?: RowExit;
78
+ readonly judge: (row: Readonly<Record<string, unknown>>, ctx: RowContext) => MemberReading;
79
+ }
80
+ /** A named segment of a table (see the module note). */
81
+ export interface RowSegment {
82
+ readonly name: string;
83
+ readonly entries: readonly MemberEntry[];
84
+ }
85
+ /** A family's member-shape table. `admitOnly` entries are invariants only the write gate holds a candidate to. */
86
+ export interface RowShapeTable {
87
+ readonly family: string;
88
+ /** The family's refusal code — one code for the write gate and every read face. */
89
+ readonly code: string;
90
+ /** The fixed engine sentence of a refusal and of a damaged verdict — never built from the row. */
91
+ readonly sentence: string;
92
+ readonly segments: readonly RowSegment[];
93
+ readonly exit: RowExit;
94
+ readonly admitOnly?: readonly MemberEntry[];
95
+ }
96
+ /** A family's reader ({@link rowShapeReader}). */
97
+ export interface RowShapeReader<T> {
98
+ readonly table: RowShapeTable;
99
+ /** Judge `raw` over the named segments (default: every segment, in table order). Total over JSON values. */
100
+ read(raw: unknown, ctx: RowContext, segments?: readonly string[]): RowAnswer<T>;
101
+ /** Judge a write's candidate — the row as the store is about to keep it, its key and revision already placed by the store's own
102
+ * rule — over the named segments, then the `admitOnly` entries. The answered row is what the store keeps. */
103
+ admit(candidate: unknown, ctx: RowContext, segments?: readonly string[]): RowAnswer<T>;
104
+ /** The family's row predicate (the `rowKey` segment alone): what the replay files under its key. */
105
+ rowKey(raw: unknown): boolean;
106
+ /** The verdict a listing carries for an answer. */
107
+ verdictOf(answer: RowAnswer<T>): RowVerdict;
108
+ /** The damaged verdict of a corrupt row (what a listing carries for it). */
109
+ damagedVerdict(corrupt: RowCorrupt): DamagedRowVerdict;
110
+ /** The text of a refusal of a corrupt row: the fixed sentence, then the member's diagnostic. */
111
+ refusalText(corrupt: RowCorrupt): string;
112
+ }
113
+ /** Is an answer a corrupt row? */
114
+ export declare function isRowCorrupt<T>(answer: RowAnswer<T>): answer is RowCorrupt;
115
+ /** A face's check that a corrupt row takes the exit the face implements: the exit is the table's declaration, so a member whose
116
+ * declared exit this face does not implement is an engine defect, refused here rather than answered by another exit's rule. */
117
+ export declare function takesExit(corrupt: RowCorrupt, exit: RowExit, face: string): void;
118
+ /**
119
+ * The family's reader over its table: the only mechanism; the table carries the family's facts.
120
+ */
121
+ export declare function rowShapeReader<T>(table: RowShapeTable): RowShapeReader<T>;
122
+ /** A value shape: `undefined` = the value reads; otherwise the phrase that follows "its <member>" (a path step, or " is not …"). */
123
+ export type ValueShape = (value: unknown) => string | undefined;
124
+ export declare const isString: ValueShape;
125
+ export declare const isNonBlankString: ValueShape;
126
+ export declare const isBoolean: ValueShape;
127
+ export declare const isFiniteNumber: ValueShape;
128
+ /** A non-negative safe integer (a revision, a generation). */
129
+ export declare const isCount: ValueShape;
130
+ export declare const isRecord: ValueShape;
131
+ /** A member of a closed word set. */
132
+ export declare function isWord(words: readonly string[]): ValueShape;
133
+ /** A list whose every element reads as `element`. */
134
+ export declare function isListOf(element: ValueShape): ValueShape;
135
+ /** A record whose named members read as their shapes (a member absent from `optional` is required). */
136
+ export declare function isRecordOf(members: Readonly<Record<string, ValueShape>>, optional?: readonly string[]): ValueShape;
137
+ /** A member the row must carry, of `shape`. */
138
+ export declare function required(member: string, shape: ValueShape, exit?: RowExit): MemberEntry;
139
+ /** A member the row may omit; present, it is of `shape`. */
140
+ export declare function optional(member: string, shape: ValueShape, exit?: RowExit): MemberEntry;
141
+ /** A member whose ABSENCE reads as a value (what the absence means, in a read and a write alike); present, it is of `shape`.
142
+ * `fill` may throw (the absence has no reading for this row): the row then does not read, `missing-required`. */
143
+ export declare function absentReads(member: string, fill: (row: Readonly<Record<string, unknown>>) => unknown, shape: ValueShape): MemberEntry;
144
+ /** A member a reader of its own reads (`reader` answers its reading or throws its refusal): a throw is a member that does not
145
+ * read; a reading other than the stored value (the reader's registered normalization) is what the row reads as. */
146
+ export declare function via(member: string, reader: (value: unknown) => unknown): MemberEntry;
147
+ /** A judgment over the whole row and its context (a member against the key, a member against another): `check` answers
148
+ * `undefined` or the sentence that says what does not read. */
149
+ export declare function pair(member: string, check: (row: Readonly<Record<string, unknown>>, ctx: RowContext) => string | undefined, form?: CorruptBodyForm): MemberEntry;
@@ -0,0 +1,184 @@
1
+ import { thrownName } from "./thrown-value.js";
2
+ export const ROW_EXITS = Object.freeze(["list-damaged", "block", "omit", "refuse-container"]);
3
+ const READS = Object.freeze({ reads: true });
4
+ const OK_VERDICT = Object.freeze({ kind: "ok" });
5
+ export function isRowCorrupt(answer) {
6
+ return "corrupt" in answer;
7
+ }
8
+ export function takesExit(corrupt, exit, face) {
9
+ if (corrupt.exit !== exit)
10
+ throw new TypeError(`${face}: the row's member ${corrupt.member} declares the exit ${corrupt.exit}, which this face does not implement (it implements ${exit})`);
11
+ }
12
+ function isRecordValue(value) {
13
+ return typeof value === "object" && value !== null && !Array.isArray(value);
14
+ }
15
+ function coveredBy(raw, authoritative) {
16
+ const out = { ...raw };
17
+ for (const [member, value] of Object.entries(authoritative)) {
18
+ if (value === null || value === undefined)
19
+ Reflect.deleteProperty(out, member);
20
+ else
21
+ out[member] = value;
22
+ }
23
+ return out;
24
+ }
25
+ export function rowShapeReader(table) {
26
+ const names = new Set(table.segments.map((s) => s.name));
27
+ const selected = (segments) => {
28
+ if (segments === undefined)
29
+ return table.segments;
30
+ for (const name of segments)
31
+ if (!names.has(name))
32
+ throw new TypeError(`row shape table ${table.family}: no segment named ${JSON.stringify(name)}`);
33
+ return table.segments.filter((s) => segments.includes(s.name));
34
+ };
35
+ const judge = (raw, ctx, segments, admitOnly) => {
36
+ if (!isRecordValue(raw))
37
+ return { corrupt: "not-an-object", segment: segments[0]?.name ?? "admitOnly", member: "(row)", exit: table.exit, why: "the row is not an object" };
38
+ let readAs = ctx.authoritative === undefined ? undefined : coveredBy(raw, ctx.authoritative);
39
+ const pass = (segment, entries) => {
40
+ for (const entry of entries) {
41
+ const reading = entry.judge(readAs ?? raw, ctx);
42
+ if ("form" in reading)
43
+ return { corrupt: reading.form, segment, member: entry.member, exit: entry.exit ?? table.exit, why: reading.why };
44
+ if (reading.replaced === true) {
45
+ readAs ??= { ...raw };
46
+ if (reading.as === undefined)
47
+ Reflect.deleteProperty(readAs, entry.member);
48
+ else
49
+ readAs[entry.member] = reading.as;
50
+ }
51
+ }
52
+ return undefined;
53
+ };
54
+ for (const segment of segments) {
55
+ const corrupt = pass(segment.name, segment.entries);
56
+ if (corrupt !== undefined)
57
+ return corrupt;
58
+ }
59
+ const gate = pass("admitOnly", admitOnly);
60
+ if (gate !== undefined)
61
+ return gate;
62
+ return { row: (readAs ?? raw) };
63
+ };
64
+ const rowKeySegment = table.segments.filter((s) => s.name === "rowKey");
65
+ const damagedVerdict = (corrupt) => Object.freeze({ kind: "damaged", code: table.code, member: corrupt.member, form: corrupt.corrupt, sentence: table.sentence });
66
+ return {
67
+ table,
68
+ read: (raw, ctx, segments) => judge(raw, ctx, selected(segments), []),
69
+ admit: (candidate, ctx, segments) => judge(candidate, ctx, selected(segments), table.admitOnly ?? []),
70
+ rowKey: (raw) => "row" in judge(raw, { key: "" }, rowKeySegment, []),
71
+ verdictOf: (answer) => ("corrupt" in answer ? damagedVerdict(answer) : OK_VERDICT),
72
+ damagedVerdict,
73
+ refusalText: (corrupt) => `${table.sentence} Diagnostic: ${corrupt.why}.`,
74
+ };
75
+ }
76
+ const phrase = (member, problem) => `its ${member}${problem.startsWith(".") || problem.startsWith("[") ? "" : " "}${problem}`;
77
+ export const isString = (v) => (typeof v === "string" ? undefined : "is not a string");
78
+ export const isNonBlankString = (v) => (typeof v === "string" && v.trim() !== "" ? undefined : "is not a non-blank string");
79
+ export const isBoolean = (v) => (typeof v === "boolean" ? undefined : "is not a boolean");
80
+ export const isFiniteNumber = (v) => (typeof v === "number" && Number.isFinite(v) ? undefined : "is not a finite number");
81
+ export const isCount = (v) => (typeof v === "number" && Number.isSafeInteger(v) && v >= 0 ? undefined : "is not a non-negative safe integer");
82
+ export const isRecord = (v) => (isRecordValue(v) ? undefined : "is not an object");
83
+ export function isWord(words) {
84
+ return (v) => (typeof v === "string" && words.includes(v) ? undefined : `is not one of ${words.join(" / ")}`);
85
+ }
86
+ export function isListOf(element) {
87
+ return (v) => {
88
+ if (!Array.isArray(v))
89
+ return "is not a list";
90
+ for (let i = 0; i < v.length; i++) {
91
+ const problem = element(v[i]);
92
+ if (problem !== undefined)
93
+ return `[${i}]${problem.startsWith(".") || problem.startsWith("[") ? "" : " "}${problem}`;
94
+ }
95
+ return undefined;
96
+ };
97
+ }
98
+ export function isRecordOf(members, optional = []) {
99
+ return (v) => {
100
+ if (!isRecordValue(v))
101
+ return "is not an object";
102
+ for (const [name, shape] of Object.entries(members)) {
103
+ const value = v[name];
104
+ if (value === undefined) {
105
+ if (optional.includes(name))
106
+ continue;
107
+ return `.${name} is missing`;
108
+ }
109
+ const problem = shape(value);
110
+ if (problem !== undefined)
111
+ return `.${name}${problem.startsWith(".") || problem.startsWith("[") ? "" : " "}${problem}`;
112
+ }
113
+ return undefined;
114
+ };
115
+ }
116
+ export function required(member, shape, exit) {
117
+ return {
118
+ member,
119
+ ...(exit !== undefined ? { exit } : {}),
120
+ judge: (row) => {
121
+ const value = row[member];
122
+ if (value === undefined)
123
+ return { form: "missing-required", why: `its ${member} is missing` };
124
+ const problem = shape(value);
125
+ return problem === undefined ? READS : { form: "wrong-type", why: phrase(member, problem) };
126
+ },
127
+ };
128
+ }
129
+ export function optional(member, shape, exit) {
130
+ return {
131
+ member,
132
+ ...(exit !== undefined ? { exit } : {}),
133
+ judge: (row) => {
134
+ const value = row[member];
135
+ if (value === undefined)
136
+ return READS;
137
+ const problem = shape(value);
138
+ return problem === undefined ? READS : { form: "wrong-type", why: phrase(member, problem) };
139
+ },
140
+ };
141
+ }
142
+ export function absentReads(member, fill, shape) {
143
+ return {
144
+ member,
145
+ judge: (row) => {
146
+ const value = row[member];
147
+ if (value === undefined) {
148
+ try {
149
+ return { reads: true, as: fill(row), replaced: true };
150
+ }
151
+ catch {
152
+ return { form: "missing-required", why: `its ${member} is missing and its absence has no reading for this row` };
153
+ }
154
+ }
155
+ const problem = shape(value);
156
+ return problem === undefined ? READS : { form: "wrong-type", why: phrase(member, problem) };
157
+ },
158
+ };
159
+ }
160
+ export function via(member, reader) {
161
+ return {
162
+ member,
163
+ judge: (row) => {
164
+ const value = row[member];
165
+ let reading;
166
+ try {
167
+ reading = reader(value);
168
+ }
169
+ catch (e) {
170
+ return { form: "wrong-type", why: `its ${member} does not read (${thrownName(e) ?? typeof e})` };
171
+ }
172
+ return reading === value ? READS : { reads: true, as: reading, replaced: true };
173
+ },
174
+ };
175
+ }
176
+ export function pair(member, check, form = "wrong-type") {
177
+ return {
178
+ member,
179
+ judge: (row, ctx) => {
180
+ const why = check(row, ctx);
181
+ return why === undefined ? READS : { form, why };
182
+ },
183
+ };
184
+ }