@stigmer/runner 3.14.1 → 3.15.0

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 (320) hide show
  1. package/dist/.build-fingerprint +1 -1
  2. package/dist/__test-utils__/execution-record-fixture.d.ts +47 -0
  3. package/dist/__test-utils__/execution-record-fixture.js +68 -0
  4. package/dist/__test-utils__/execution-record-fixture.js.map +1 -0
  5. package/dist/__test-utils__/harness-contract/types.d.ts +166 -0
  6. package/dist/__test-utils__/harness-contract/types.js +49 -0
  7. package/dist/__test-utils__/harness-contract/types.js.map +1 -0
  8. package/dist/__test-utils__/hermetic-activity.d.ts +28 -5
  9. package/dist/__test-utils__/hermetic-activity.js +23 -7
  10. package/dist/__test-utils__/hermetic-activity.js.map +1 -1
  11. package/dist/__test-utils__/mock-workspace.d.ts +15 -0
  12. package/dist/__test-utils__/mock-workspace.js +21 -0
  13. package/dist/__test-utils__/mock-workspace.js.map +1 -0
  14. package/dist/__test-utils__/model-registry-fixture.d.ts +56 -0
  15. package/dist/__test-utils__/model-registry-fixture.js +66 -0
  16. package/dist/__test-utils__/model-registry-fixture.js.map +1 -0
  17. package/dist/__test-utils__/turn-input-fixture.d.ts +60 -0
  18. package/dist/__test-utils__/turn-input-fixture.js +118 -0
  19. package/dist/__test-utils__/turn-input-fixture.js.map +1 -0
  20. package/dist/activities/execute-cursor/__test-utils__/contract-subject.d.ts +107 -0
  21. package/dist/activities/execute-cursor/__test-utils__/contract-subject.js +344 -0
  22. package/dist/activities/execute-cursor/__test-utils__/contract-subject.js.map +1 -0
  23. package/dist/activities/execute-cursor/__test-utils__/cursor-hook-harness.d.ts +20 -0
  24. package/dist/activities/execute-cursor/__test-utils__/cursor-hook-harness.js +58 -0
  25. package/dist/activities/execute-cursor/__test-utils__/cursor-hook-harness.js.map +1 -1
  26. package/dist/activities/execute-cursor/__test-utils__/gateway-substrate.js +2 -32
  27. package/dist/activities/execute-cursor/__test-utils__/gateway-substrate.js.map +1 -1
  28. package/dist/activities/execute-cursor/__test-utils__/hermetic-cursor.d.ts +38 -62
  29. package/dist/activities/execute-cursor/__test-utils__/hermetic-cursor.js +47 -121
  30. package/dist/activities/execute-cursor/__test-utils__/hermetic-cursor.js.map +1 -1
  31. package/dist/activities/execute-cursor/__test-utils__/scripted-agent.d.ts +17 -1
  32. package/dist/activities/execute-cursor/__test-utils__/scripted-agent.js +27 -4
  33. package/dist/activities/execute-cursor/__test-utils__/scripted-agent.js.map +1 -1
  34. package/dist/activities/execute-cursor/__test-utils__/scripted-sdk.d.ts +52 -11
  35. package/dist/activities/execute-cursor/__test-utils__/scripted-sdk.js +66 -7
  36. package/dist/activities/execute-cursor/__test-utils__/scripted-sdk.js.map +1 -1
  37. package/dist/activities/execute-cursor/adapter.d.ts +55 -0
  38. package/dist/activities/execute-cursor/adapter.js +119 -0
  39. package/dist/activities/execute-cursor/adapter.js.map +1 -0
  40. package/dist/activities/execute-cursor/approval-state.d.ts +2 -2
  41. package/dist/activities/execute-cursor/approval-state.js.map +1 -1
  42. package/dist/activities/execute-cursor/capture-flow.d.ts +15 -30
  43. package/dist/activities/execute-cursor/capture-flow.js +17 -26
  44. package/dist/activities/execute-cursor/capture-flow.js.map +1 -1
  45. package/dist/activities/execute-cursor/cursor-capabilities.d.ts +23 -0
  46. package/dist/activities/execute-cursor/cursor-capabilities.js +33 -0
  47. package/dist/activities/execute-cursor/cursor-capabilities.js.map +1 -0
  48. package/dist/activities/execute-cursor/cursor-mcp-config.d.ts +2 -2
  49. package/dist/activities/execute-cursor/cursor-mcp-config.js.map +1 -1
  50. package/dist/activities/execute-cursor/fetch-interceptor.d.ts +15 -25
  51. package/dist/activities/execute-cursor/fetch-interceptor.js +39 -33
  52. package/dist/activities/execute-cursor/fetch-interceptor.js.map +1 -1
  53. package/dist/activities/execute-cursor/http2-interceptor.d.ts +21 -17
  54. package/dist/activities/execute-cursor/http2-interceptor.js +38 -31
  55. package/dist/activities/execute-cursor/http2-interceptor.js.map +1 -1
  56. package/dist/activities/execute-cursor/message-translator.d.ts +28 -19
  57. package/dist/activities/execute-cursor/message-translator.js +76 -27
  58. package/dist/activities/execute-cursor/message-translator.js.map +1 -1
  59. package/dist/activities/execute-cursor/prompt-builder.d.ts +180 -11
  60. package/dist/activities/execute-cursor/prompt-builder.js +171 -0
  61. package/dist/activities/execute-cursor/prompt-builder.js.map +1 -1
  62. package/dist/activities/execute-cursor/rejection-capture.d.ts +3 -6
  63. package/dist/activities/execute-cursor/rejection-capture.js +5 -7
  64. package/dist/activities/execute-cursor/rejection-capture.js.map +1 -1
  65. package/dist/activities/execute-cursor/session-lifecycle.d.ts +1 -4
  66. package/dist/activities/execute-cursor/session-lifecycle.js.map +1 -1
  67. package/dist/activities/execute-cursor/turn-boundary.d.ts +1 -1
  68. package/dist/activities/execute-cursor/turn-settle.d.ts +49 -0
  69. package/dist/activities/execute-cursor/turn-settle.js +507 -0
  70. package/dist/activities/execute-cursor/turn-settle.js.map +1 -0
  71. package/dist/activities/execute-cursor/turn-setup.d.ts +173 -0
  72. package/dist/activities/execute-cursor/turn-setup.js +496 -0
  73. package/dist/activities/execute-cursor/turn-setup.js.map +1 -0
  74. package/dist/activities/execute-cursor/turn-stream.d.ts +41 -71
  75. package/dist/activities/execute-cursor/turn-stream.js +70 -135
  76. package/dist/activities/execute-cursor/turn-stream.js.map +1 -1
  77. package/dist/activities/execute-cursor/turn.d.ts +43 -0
  78. package/dist/activities/execute-cursor/turn.js +222 -0
  79. package/dist/activities/execute-cursor/turn.js.map +1 -0
  80. package/dist/activities/execute-cursor/usage-pricing.d.ts +38 -0
  81. package/dist/activities/execute-cursor/usage-pricing.js +50 -0
  82. package/dist/activities/execute-cursor/usage-pricing.js.map +1 -0
  83. package/dist/activities/execute-deep-agent/approval-file-change.d.ts +1 -1
  84. package/dist/activities/execute-deep-agent/approval-file-change.js +1 -1
  85. package/dist/activities/execute-deep-agent/environment.js +1 -1
  86. package/dist/activities/execute-deep-agent/environment.js.map +1 -1
  87. package/dist/activities/execute-deep-agent/setup.js +3 -2
  88. package/dist/activities/execute-deep-agent/setup.js.map +1 -1
  89. package/dist/activities/hydrate-workflow-execution.js +1 -1
  90. package/dist/activities/hydrate-workflow-execution.js.map +1 -1
  91. package/dist/config.d.ts +15 -0
  92. package/dist/config.js.map +1 -1
  93. package/dist/harness/capabilities.d.ts +16 -0
  94. package/dist/harness/capabilities.js +1 -0
  95. package/dist/harness/capabilities.js.map +1 -1
  96. package/dist/harness/persist-chokepoint.d.ts +74 -0
  97. package/dist/harness/persist-chokepoint.js +88 -0
  98. package/dist/harness/persist-chokepoint.js.map +1 -0
  99. package/dist/harness/registry.d.ts +44 -5
  100. package/dist/harness/registry.js +61 -5
  101. package/dist/harness/registry.js.map +1 -1
  102. package/dist/harness/run-turn.d.ts +53 -0
  103. package/dist/harness/run-turn.js +528 -0
  104. package/dist/harness/run-turn.js.map +1 -0
  105. package/dist/harness/stop-controller.d.ts +50 -0
  106. package/dist/harness/stop-controller.js +62 -0
  107. package/dist/harness/stop-controller.js.map +1 -0
  108. package/dist/harness/terminal-table.d.ts +141 -0
  109. package/dist/harness/terminal-table.js +239 -0
  110. package/dist/harness/terminal-table.js.map +1 -0
  111. package/dist/harness/turn-context.d.ts +523 -0
  112. package/dist/harness/turn-context.js +739 -0
  113. package/dist/harness/turn-context.js.map +1 -0
  114. package/dist/harness/types.d.ts +232 -52
  115. package/dist/harness/types.js +17 -8
  116. package/dist/harness/types.js.map +1 -1
  117. package/dist/harness/usage-accumulator.d.ts +68 -0
  118. package/dist/harness/usage-accumulator.js +101 -0
  119. package/dist/harness/usage-accumulator.js.map +1 -0
  120. package/dist/harness-adapters.d.ts +27 -0
  121. package/dist/harness-adapters.js +28 -0
  122. package/dist/harness-adapters.js.map +1 -0
  123. package/dist/main.js.map +1 -1
  124. package/dist/runner-manager.js +64 -48
  125. package/dist/runner-manager.js.map +1 -1
  126. package/dist/runner.d.ts +5 -4
  127. package/dist/runner.js +65 -64
  128. package/dist/runner.js.map +1 -1
  129. package/dist/shared/approval-policy.d.ts +1 -1
  130. package/dist/shared/approval-policy.js.map +1 -1
  131. package/dist/{activities/execute-cursor → shared}/attachment-resolver.d.ts +2 -2
  132. package/dist/{activities/execute-cursor → shared}/attachment-resolver.js +5 -5
  133. package/dist/shared/attachment-resolver.js.map +1 -0
  134. package/dist/{activities/execute-cursor → shared}/blueprint-resolver.d.ts +7 -5
  135. package/dist/{activities/execute-cursor → shared}/blueprint-resolver.js +3 -63
  136. package/dist/shared/blueprint-resolver.js.map +1 -0
  137. package/dist/shared/channel-attachment.d.ts +1 -1
  138. package/dist/shared/channel-attachment.js.map +1 -1
  139. package/dist/{activities/execute-cursor → shared}/cost-guard.d.ts +5 -1
  140. package/dist/{activities/execute-cursor → shared}/cost-guard.js +5 -1
  141. package/dist/shared/cost-guard.js.map +1 -0
  142. package/dist/{activities/execute-cursor → shared}/env-resolver.d.ts +1 -1
  143. package/dist/shared/env-resolver.js.map +1 -0
  144. package/dist/{activities/execute-cursor → shared}/exact-apply.d.ts +1 -1
  145. package/dist/{activities/execute-cursor → shared}/exact-apply.js +6 -6
  146. package/dist/shared/exact-apply.js.map +1 -0
  147. package/dist/shared/execution-context.d.ts +35 -0
  148. package/dist/shared/execution-context.js +38 -0
  149. package/dist/shared/execution-context.js.map +1 -0
  150. package/dist/{activities/execute-cursor → shared}/extract-structured-output.d.ts +5 -2
  151. package/dist/{activities/execute-cursor → shared}/extract-structured-output.js +9 -6
  152. package/dist/shared/extract-structured-output.js.map +1 -0
  153. package/dist/shared/filereview/capture.d.ts +1 -1
  154. package/dist/shared/filereview/capture.js +1 -1
  155. package/dist/shared/heartbeat.d.ts +13 -11
  156. package/dist/shared/heartbeat.js +14 -29
  157. package/dist/shared/heartbeat.js.map +1 -1
  158. package/dist/{activities/execute-cursor → shared}/persist-decision.d.ts +5 -2
  159. package/dist/{activities/execute-cursor → shared}/persist-decision.js +4 -1
  160. package/dist/shared/persist-decision.js.map +1 -0
  161. package/dist/{activities/execute-cursor → shared}/skill-resolver.d.ts +16 -3
  162. package/dist/{activities/execute-cursor → shared}/skill-resolver.js +12 -4
  163. package/dist/shared/skill-resolver.js.map +1 -0
  164. package/dist/shared/subagent-rows.d.ts +21 -0
  165. package/dist/shared/subagent-rows.js +34 -0
  166. package/dist/shared/subagent-rows.js.map +1 -0
  167. package/dist/shared/worker-shutdown.d.ts +43 -16
  168. package/dist/shared/worker-shutdown.js +28 -13
  169. package/dist/shared/worker-shutdown.js.map +1 -1
  170. package/dist/shared/workspace/platform-dir.d.ts +1 -1
  171. package/dist/shared/workspace/platform-dir.js +1 -1
  172. package/dist/shared/workspace/session-provision.d.ts +54 -0
  173. package/dist/{activities/execute-cursor/workspace-provision.js → shared/workspace/session-provision.js} +15 -12
  174. package/dist/shared/workspace/session-provision.js.map +1 -0
  175. package/package.json +4 -4
  176. package/src/__test-utils__/__tests__/harness-contract-self-check.test.ts +110 -14
  177. package/src/__test-utils__/execution-record-fixture.ts +104 -0
  178. package/src/__test-utils__/harness-boot-order-child.ts +58 -0
  179. package/src/__test-utils__/harness-contract/contract.ts +128 -83
  180. package/src/__test-utils__/harness-contract/recording-sink.ts +15 -4
  181. package/src/__test-utils__/harness-contract/runtime-contract.ts +666 -0
  182. package/src/__test-utils__/harness-contract/scripted-adapter.ts +92 -32
  183. package/src/__test-utils__/harness-contract/types.ts +85 -9
  184. package/src/__test-utils__/hermetic-activity.ts +33 -8
  185. package/src/__test-utils__/model-registry-fixture.ts +72 -0
  186. package/src/__test-utils__/module-specifiers.ts +82 -0
  187. package/src/__test-utils__/turn-input-fixture.ts +155 -0
  188. package/src/__tests__/harness-boot-order.test.ts +77 -0
  189. package/src/__tests__/harness-contract.test.ts +7 -5
  190. package/src/__tests__/runner-manager.test.ts +18 -0
  191. package/src/activities/execute-cursor/__test-utils__/__tests__/scripted-double.test.ts +102 -0
  192. package/src/activities/execute-cursor/__test-utils__/contract-subject.ts +396 -0
  193. package/src/activities/execute-cursor/__test-utils__/cursor-hook-harness.ts +66 -0
  194. package/src/activities/execute-cursor/__test-utils__/gateway-substrate.ts +2 -43
  195. package/src/activities/execute-cursor/__test-utils__/hermetic-cursor.ts +65 -145
  196. package/src/activities/execute-cursor/__test-utils__/scripted-agent.ts +30 -4
  197. package/src/activities/execute-cursor/__test-utils__/scripted-sdk.ts +96 -8
  198. package/src/activities/execute-cursor/__tests__/adapter-is-temporal-free.test.ts +45 -0
  199. package/src/activities/execute-cursor/__tests__/approval-decisions-agree.test.ts +90 -0
  200. package/src/activities/execute-cursor/__tests__/build-prompt.test.ts +7 -8
  201. package/src/activities/execute-cursor/__tests__/capture-flow.test.ts +28 -1
  202. package/src/activities/execute-cursor/__tests__/deny-gate-exact-apply.test.ts +1 -1
  203. package/src/activities/execute-cursor/__tests__/fetch-interceptor.test.ts +64 -6
  204. package/src/activities/execute-cursor/__tests__/hermetic/deny-and-retry.test.ts +1 -1
  205. package/src/activities/execute-cursor/__tests__/hermetic/file-review-capture.test.ts +1 -1
  206. package/src/activities/execute-cursor/__tests__/hermetic/goldens/cost-cap.status.json +53 -0
  207. package/src/activities/execute-cursor/__tests__/hermetic/goldens/pause.status.json +1 -6
  208. package/src/activities/execute-cursor/__tests__/hermetic/goldens/platform-stop.status.json +56 -0
  209. package/src/activities/execute-cursor/__tests__/hermetic/goldens/recovery-transport-timeout.status.json +48 -0
  210. package/src/activities/execute-cursor/__tests__/hermetic/goldens/resolution-error.status.json +18 -0
  211. package/src/activities/execute-cursor/__tests__/hermetic/goldens/run-cancelled.status.json +36 -0
  212. package/src/activities/execute-cursor/__tests__/hermetic/goldens/run-error-non-retryable.status.json +37 -0
  213. package/src/activities/execute-cursor/__tests__/hermetic/goldens/sdk-error-at-create.status.json +38 -0
  214. package/src/activities/execute-cursor/__tests__/hermetic/goldens/stall.status.json +59 -0
  215. package/src/activities/execute-cursor/__tests__/hermetic/goldens/unattributed-hook-block.status.json +79 -0
  216. package/src/activities/execute-cursor/__tests__/hermetic/goldens/worker-shutdown.status.json +2 -7
  217. package/src/activities/execute-cursor/__tests__/hermetic/harness-contract.test.ts +170 -0
  218. package/src/activities/execute-cursor/__tests__/hermetic/pause-vs-shutdown.test.ts +22 -18
  219. package/src/activities/execute-cursor/__tests__/hermetic/plain-turn.test.ts +1 -1
  220. package/src/activities/execute-cursor/__tests__/hermetic/recovery-fresh-agent.test.ts +1 -1
  221. package/src/activities/execute-cursor/__tests__/hermetic/run-wait-arms.test.ts +286 -0
  222. package/src/activities/execute-cursor/__tests__/hermetic/stream-self-stop-arms.test.ts +332 -0
  223. package/src/activities/execute-cursor/__tests__/hermetic/thrown-error-arms.test.ts +193 -0
  224. package/src/activities/execute-cursor/__tests__/hermetic/tool-call.test.ts +1 -1
  225. package/src/activities/execute-cursor/__tests__/hermetic/unattributed-hook-block.test.ts +185 -0
  226. package/src/activities/execute-cursor/__tests__/hermetic/workspace-lock-timeout.test.ts +151 -0
  227. package/src/activities/execute-cursor/__tests__/http2-interceptor.test.ts +65 -35
  228. package/src/activities/execute-cursor/__tests__/message-translator.test.ts +0 -40
  229. package/src/activities/execute-cursor/__tests__/same-identity-reproposal.test.ts +171 -0
  230. package/src/activities/execute-cursor/__tests__/turn-stream.test.ts +118 -243
  231. package/src/activities/execute-cursor/__tests__/usage-pricing.test.ts +84 -0
  232. package/src/activities/execute-cursor/adapter.ts +138 -0
  233. package/src/activities/execute-cursor/approval-state.ts +2 -2
  234. package/src/activities/execute-cursor/capture-flow.ts +18 -41
  235. package/src/activities/execute-cursor/cursor-capabilities.ts +35 -0
  236. package/src/activities/execute-cursor/cursor-mcp-config.ts +2 -2
  237. package/src/activities/execute-cursor/fetch-interceptor.ts +48 -45
  238. package/src/activities/execute-cursor/http2-interceptor.ts +47 -34
  239. package/src/activities/execute-cursor/message-translator.ts +90 -45
  240. package/src/activities/execute-cursor/prompt-builder.ts +327 -12
  241. package/src/activities/execute-cursor/rejection-capture.ts +5 -12
  242. package/src/activities/execute-cursor/session-lifecycle.ts +1 -5
  243. package/src/activities/execute-cursor/turn-boundary.ts +1 -1
  244. package/src/activities/execute-cursor/turn-settle.ts +601 -0
  245. package/src/activities/execute-cursor/turn-setup.ts +645 -0
  246. package/src/activities/execute-cursor/turn-stream.ts +84 -210
  247. package/src/activities/execute-cursor/turn.ts +240 -0
  248. package/src/activities/execute-cursor/usage-pricing.ts +67 -0
  249. package/src/activities/execute-deep-agent/approval-file-change.ts +1 -1
  250. package/src/activities/execute-deep-agent/environment.ts +1 -1
  251. package/src/activities/execute-deep-agent/setup.ts +3 -2
  252. package/src/activities/hydrate-workflow-execution.ts +1 -1
  253. package/src/config.ts +13 -0
  254. package/src/harness/__tests__/import-direction.test.ts +168 -0
  255. package/src/harness/__tests__/persist-chokepoint.test.ts +146 -0
  256. package/src/harness/__tests__/registry.test.ts +1 -0
  257. package/src/harness/__tests__/run-turn.test.ts +165 -0
  258. package/src/harness/__tests__/stop-controller.test.ts +49 -0
  259. package/src/harness/__tests__/turn-context.test.ts +178 -0
  260. package/src/harness/__tests__/usage-accumulator.test.ts +83 -0
  261. package/src/harness/capabilities.ts +17 -0
  262. package/src/harness/persist-chokepoint.ts +112 -0
  263. package/src/harness/registry.ts +79 -5
  264. package/src/harness/run-turn.ts +618 -0
  265. package/src/harness/stop-controller.ts +83 -0
  266. package/src/harness/terminal-table.ts +276 -0
  267. package/src/harness/turn-context.ts +1028 -0
  268. package/src/harness/types.ts +248 -53
  269. package/src/harness/usage-accumulator.ts +122 -0
  270. package/src/harness-adapters.ts +30 -0
  271. package/src/main.ts +1 -1
  272. package/src/runner-manager.ts +68 -61
  273. package/src/runner.ts +67 -78
  274. package/src/shared/__tests__/attachment-naming.test.ts +1 -1
  275. package/src/{activities/execute-cursor → shared}/__tests__/attachment-resolver.test.ts +6 -4
  276. package/src/{activities/execute-cursor → shared}/__tests__/cost-guard.test.ts +2 -1
  277. package/src/{activities/execute-cursor → shared}/__tests__/exact-apply.test.ts +3 -3
  278. package/src/{activities/execute-cursor → shared}/__tests__/extract-structured-output.test.ts +8 -8
  279. package/src/{activities/execute-cursor → shared}/__tests__/persist-decision.test.ts +4 -2
  280. package/src/{activities/execute-cursor → shared}/__tests__/skill-resolver.test.ts +1 -1
  281. package/src/shared/__tests__/subagent-rows.test.ts +34 -0
  282. package/src/shared/__tests__/worker-shutdown.test.ts +44 -39
  283. package/src/shared/approval-policy.ts +1 -1
  284. package/src/{activities/execute-cursor → shared}/attachment-resolver.ts +6 -6
  285. package/src/{activities/execute-cursor → shared}/blueprint-resolver.ts +7 -78
  286. package/src/shared/channel-attachment.ts +1 -1
  287. package/src/{activities/execute-cursor → shared}/cost-guard.ts +5 -1
  288. package/src/{activities/execute-cursor → shared}/env-resolver.ts +1 -1
  289. package/src/{activities/execute-cursor → shared}/exact-apply.ts +7 -7
  290. package/src/shared/execution-context.ts +45 -0
  291. package/src/{activities/execute-cursor → shared}/extract-structured-output.ts +10 -7
  292. package/src/shared/filereview/capture.ts +1 -1
  293. package/src/shared/heartbeat.ts +13 -33
  294. package/src/{activities/execute-cursor → shared}/persist-decision.ts +5 -2
  295. package/src/{activities/execute-cursor → shared}/skill-resolver.ts +20 -6
  296. package/src/shared/subagent-rows.ts +39 -0
  297. package/src/shared/worker-shutdown.ts +55 -25
  298. package/src/{activities/execute-cursor/__tests__/workspace-provision.test.ts → shared/workspace/__tests__/session-provision.test.ts} +25 -28
  299. package/src/shared/workspace/platform-dir.ts +1 -1
  300. package/src/{activities/execute-cursor/workspace-provision.ts → shared/workspace/session-provision.ts} +29 -16
  301. package/dist/activities/execute-cursor/attachment-resolver.js.map +0 -1
  302. package/dist/activities/execute-cursor/blueprint-resolver.js.map +0 -1
  303. package/dist/activities/execute-cursor/cost-guard.js.map +0 -1
  304. package/dist/activities/execute-cursor/env-resolver.js.map +0 -1
  305. package/dist/activities/execute-cursor/exact-apply.js.map +0 -1
  306. package/dist/activities/execute-cursor/extract-structured-output.js.map +0 -1
  307. package/dist/activities/execute-cursor/index.d.ts +0 -209
  308. package/dist/activities/execute-cursor/index.js +0 -2345
  309. package/dist/activities/execute-cursor/index.js.map +0 -1
  310. package/dist/activities/execute-cursor/persist-decision.js.map +0 -1
  311. package/dist/activities/execute-cursor/skill-resolver.js.map +0 -1
  312. package/dist/activities/execute-cursor/usage-accumulator.d.ts +0 -89
  313. package/dist/activities/execute-cursor/usage-accumulator.js +0 -121
  314. package/dist/activities/execute-cursor/usage-accumulator.js.map +0 -1
  315. package/dist/activities/execute-cursor/workspace-provision.d.ts +0 -42
  316. package/dist/activities/execute-cursor/workspace-provision.js.map +0 -1
  317. package/src/activities/execute-cursor/__tests__/usage-accumulator.test.ts +0 -164
  318. package/src/activities/execute-cursor/index.ts +0 -2876
  319. package/src/activities/execute-cursor/usage-accumulator.ts +0 -169
  320. /package/dist/{activities/execute-cursor → shared}/env-resolver.js +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"turn-context.js","sourceRoot":"","sources":["../../src/harness/turn-context.ts"],"names":[],"mappings":"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"}
@@ -8,9 +8,9 @@
8
8
  * vendor SDK — fetching the execution, resolving the blueprint and the
9
9
  * environment, provisioning and locking the workspace, mounting skills,
10
10
  * resolving MCP servers and approval policies, seeding the transcript, the
11
- * persist cadence, the stall watchdog, the Temporal heartbeat, pause vs
12
- * shutdown, the cost cap, the file-review boundary, the terminal mapping
13
- * is the RUNTIME's, written once. What a harness owns is its SDK slice: how
11
+ * persist chokepoint, the stall watchdog, the Temporal heartbeat, pause vs
12
+ * shutdown, the cost cap, the terminal mapping is the RUNTIME's
13
+ * (`run-turn.ts`), written once. What a harness owns is its SDK slice: how
14
14
  * the engine is created or resumed, how the prompt is placed, how MCP servers
15
15
  * are bound, how the engine is made to stop before a gated side effect, and
16
16
  * how its events become transcript rows. This file is the whole of what a
@@ -22,15 +22,15 @@
22
22
  * runtime cannot read anywhere else. Nothing here is speculative: where the
23
23
  * program's original sketch and the code disagreed, the code won, and the
24
24
  * disagreement was ruled at the entry's gate
25
- * (stigmer-cloud `_projects/2026-09/20260911.02.sp.harness-contract-and-kit/`).
25
+ * (stigmer-cloud `_projects/2026-09/20260911.02.sp.harness-contract-and-kit/`
26
+ * for S1; `20260911.03.sp.turn-runtime-extraction/` M3 for the growth below).
26
27
  *
27
28
  * What is deliberately NOT on this contract, and why:
28
29
  *
29
30
  * - No `dispose()`. One adapter object serves many concurrent turns
30
31
  * (`maxConcurrentActivities`), so a per-turn teardown method on the
31
32
  * adapter is a race. The adapter owns its per-turn teardown in its own
32
- * `finally` inside `runTurn` (the Cursor harness already parks its agent
33
- * there).
33
+ * `finally` inside `runTurn` (the Cursor harness parks its agent there).
34
34
  * - No `isCancelled()`, no `heartbeat(details)`, no `ExecutionStatusWriter`
35
35
  * base. Each would be a second way of saying something `stopSignal`,
36
36
  * `recordActivity()` or `requestPersist()` already says, and two writers of
@@ -46,15 +46,40 @@
46
46
  * - No `TurnInput.status`. The runtime seeds `TurnSink.status` from the
47
47
  * persisted transcript; a second copy on the input is the drift the
48
48
  * single-source-of-truth mandate forbids.
49
+ * - No execution context. "This activity is execution X" is the runtime's
50
+ * ambient fact for the WHOLE activity (`shared/execution-context.ts`, an
51
+ * `AsyncLocalStorage` the runtime enters before anything runs); the
52
+ * interceptors read it per request, so no adapter establishes or
53
+ * propagates it.
54
+ * - No persist cadence. The runtime's chokepoint is single-flight and
55
+ * unconditional at settle; WHEN a streaming turn asks for a write is the
56
+ * adapter's (`shared/persist-decision.ts` over its own dirty flags, since
57
+ * what counts as a discrete change is engine knowledge), until S3 lifts
58
+ * the file-review capture and can revisit with both loops in view.
49
59
  *
50
60
  * Module shape follows `shared/checkpointer/`: `types.ts`, `capabilities.ts`,
51
- * `registry.ts`, no barrel. Nothing production-facing imports this module
52
- * until the runtime that consumes it lands (S2 of the program).
61
+ * `registry.ts`, no barrel.
53
62
  */
54
63
  import type { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
55
- import type { AgentExecutionStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
64
+ import type { AgentExecution, AgentExecutionStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
65
+ import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
56
66
  import type { Config } from "../config.js";
57
67
  import type { NormalizedActivityInput } from "../shared/activity-input.js";
68
+ import type { ArtifactStorage } from "../shared/artifact-storage.js";
69
+ import type { TimingRecorder } from "../shared/cold-start-timing.js";
70
+ import type { ResolvedBlueprint } from "../shared/blueprint-resolver.js";
71
+ import type { SessionWorkspaceProvision } from "../shared/workspace/session-provision.js";
72
+ import type { ResolvedMcpServer } from "../shared/mcp-resolver.js";
73
+ import type { ChannelMessagingInfo } from "../shared/channel-attachment.js";
74
+ import type { ActiveLeases, MergedToolPolicy } from "../shared/approval-policy.js";
75
+ import type { SkillMetadata } from "../shared/skill-resolver.js";
76
+ import type { ResolvedAttachment } from "../shared/attachment-resolver.js";
77
+ import type { NotViewableEntry, VisionImage } from "../shared/attachment-vision.js";
78
+ import type { EffectiveServiceTier } from "../shared/service-tier.js";
79
+ import type { EffectiveThinkingMode } from "../shared/thinking-mode.js";
80
+ import type { SenderIdentity } from "../shared/sender-identity.js";
81
+ import type { DeclaredPreferencesContent } from "../shared/declared-preferences.js";
82
+ import type { RecalledMemoriesContent } from "../shared/recalled-memories.js";
58
83
  import type { HarnessCapabilities } from "./capabilities.js";
59
84
  /**
60
85
  * One harness, as the runtime sees it. ONE adapter object exists per worker
@@ -108,9 +133,9 @@ export interface HarnessAdapter {
108
133
  * The rules every implementation is held to (the kit's invariants):
109
134
  *
110
135
  * - Resolves, never rejects. A vendor failure becomes
111
- * `{ kind: "failed", message }` with the user-facing sentence the
112
- * adapter's classifier produced. A `CancelledFailure` never escapes: the
113
- * runtime, not the adapter, decides what is a pause and what is a
136
+ * `{ kind: "failed", message, surface }` with the user-facing sentence
137
+ * the adapter's classifier produced. A `CancelledFailure` never escapes:
138
+ * the runtime, not the adapter, decides what is a pause and what is a
114
139
  * shutdown, and it throws exactly where Temporal semantics require.
115
140
  * - Stops promptly when `sink.stopSignal` aborts, whatever the cause,
116
141
  * settling `interrupted`. Every call the adapter makes is bounded: the
@@ -122,23 +147,93 @@ export interface HarnessAdapter {
122
147
  * `input.approvalDecisions`. APPROVE executes exactly once; REJECT and
123
148
  * SKIP never execute.
124
149
  * - Owns its own per-turn teardown in a `finally` inside this method.
150
+ * - Imports nothing from `@temporalio/*`: the kit runs an adapter outside
151
+ * any activity context, and every Temporal fact it needs arrives through
152
+ * the sink (`execute-cursor/__tests__/adapter-is-temporal-free.test.ts`).
125
153
  */
126
154
  runTurn(input: TurnInput, sink: TurnSink): Promise<TurnOutcome>;
127
155
  }
156
+ /** The resolved environment (phase 2b): the MCP-bound env map and the keys that are secrets. */
157
+ export interface TurnEnvironment {
158
+ readonly envVars: Record<string, string>;
159
+ readonly secretKeys: ReadonlySet<string>;
160
+ }
161
+ /** The provisioned workspace (phase 2c) and the capture posture derived from it. */
162
+ export interface TurnWorkspace {
163
+ /** The directories the agent operates in; never empty (`provisionSessionWorkspace` guarantees it). */
164
+ readonly dirs: readonly string[];
165
+ /** `dirs[0]`, the tree the turn's lock, gate, capture and skill mount all key on. */
166
+ readonly primaryDir: string;
167
+ /** True when `primaryDir` is a git work tree: selects the git-diff capture substrate over CAS. */
168
+ readonly gitWorkspace: boolean;
169
+ /** Apply-then-review capture (true) or the classic deny-gate (false); see `shared/filereview/capture.ts` `deriveCaptureMode`. */
170
+ readonly captureMode: boolean;
171
+ /** `${executionId}:${turnSeq}`: the deterministic id of the change set this turn may produce. */
172
+ readonly changeSetId: string;
173
+ readonly provision: SessionWorkspaceProvision;
174
+ }
175
+ /** The tool surface (phases 4 to 4b): the resolved servers with the attachments folded in, and the merged approval policies. */
176
+ export interface TurnMcp {
177
+ /** Every resolved server, synthesized attachments included; the harness projects its SDK config from this list. */
178
+ readonly servers: readonly ResolvedMcpServer[];
179
+ /** Serving proactive channels and their templates (the DD-006 D2 discovery read). */
180
+ readonly channelMessaging: readonly ChannelMessagingInfo[];
181
+ readonly leases: ActiveLeases;
182
+ readonly policies: ReadonlyMap<string, MergedToolPolicy>;
183
+ }
184
+ /** The turn's explicit inputs (phase 5b), resolved into the workspace with the vision facts derived once. */
185
+ export interface TurnAttachments {
186
+ readonly results: readonly ResolvedAttachment[];
187
+ /** The images the model sees inline, in attachment order. */
188
+ readonly visionImages: readonly VisionImage[];
189
+ /** The image-shaped attachments that degraded to path-only, disclosed in the prompt. */
190
+ readonly visionNotViewable: readonly NotViewableEntry[];
191
+ }
192
+ /** What the execution asked for (phase 6, the harness-agnostic half): the raw model name and the effective tier and thinking mode. */
193
+ export interface TurnModelPreferences {
194
+ /** `spec.executionConfig.modelName`, or `"default"`; the harness validates it against its own catalog. */
195
+ readonly requested: string;
196
+ /** Never UNSPECIFIED: `resolveEffectiveServiceTier` is where the platform default is applied. */
197
+ readonly serviceTier: EffectiveServiceTier;
198
+ /** Never UNSPECIFIED: `resolveEffectiveThinkingMode` is where the platform default is applied. */
199
+ readonly thinkingMode: EffectiveThinkingMode;
200
+ }
201
+ /**
202
+ * The standing context a first prompt carries (phase 9c) and the per-turn
203
+ * catchup, read once from the session metadata and the execution spec.
204
+ */
205
+ export interface TurnStandingContext {
206
+ readonly contextBridge: string | undefined;
207
+ readonly senderIdentity: SenderIdentity | undefined;
208
+ readonly sessionContext: string | undefined;
209
+ readonly declaredPreferences: DeclaredPreferencesContent | undefined;
210
+ readonly conversationCatchup: string | undefined;
211
+ /**
212
+ * The semantic memory selection, memoized to at most one run per
213
+ * invocation and stamping `status.recalledMemoriesReport` once. A thunk
214
+ * because only the harness knows whether its prompt carries standing
215
+ * context (a successfully resumed engine already holds it).
216
+ */
217
+ readonly selectRecalledMemories: () => Promise<RecalledMemoriesContent | undefined>;
218
+ }
128
219
  /**
129
- * What the runtime resolved for this turn and the adapter cannot read
130
- * anywhere else. This is the core; the runtime extraction (S2) grows it one
131
- * typed field per phase it takes over from the orchestrators (environment,
132
- * workspace, skills, MCP servers with merged policies, attachments, memory,
133
- * prompt bundle, model), in the `setup.ts` `SetupResult` mold.
220
+ * Everything the runtime resolved for this turn, as small named groups
221
+ * (`turn-context.ts` produces one per phase; `run-turn.ts` composes them).
222
+ * This is the whole record: the runtime keeps nothing "private" beside it —
223
+ * the lock release and the write-back coordinator are the finally's
224
+ * resources (`run-turn.ts` `TurnFrame`), not facts about the turn.
134
225
  *
135
226
  * `threadId` is the engine's state id as the runtime knows it: empty on an
136
227
  * `engine-minted` harness's first turn (nothing minted yet) and the id the
137
228
  * adapter bound through {@link TurnSink.bindHarnessState} on every later
138
229
  * invocation; the runtime-minted id on every turn of a `deterministic`
139
- * harness. An adapter derives create-vs-resume from it and its own state; the
140
- * contract carries no `isReinvocation` flag because the two harnesses would
141
- * derive it differently.
230
+ * harness. An adapter derives create-vs-resume from it and its own state
231
+ * through `turn-context.ts`'s `isReinvocation`; the contract carries no flag
232
+ * because the two harnesses would derive it differently.
233
+ *
234
+ * Adapter-only facts (the Cursor mode, the service-tier params, the seeded
235
+ * sub-agent rows) are read by the adapter from these records, never resolved
236
+ * by the runtime.
142
237
  */
143
238
  export interface TurnInput extends NormalizedActivityInput {
144
239
  /**
@@ -158,11 +253,29 @@ export interface TurnInput extends NormalizedActivityInput {
158
253
  * verdict from the rows itself.
159
254
  */
160
255
  readonly approvalDecisions: ReadonlyMap<string, ApprovalAction>;
256
+ readonly execution: AgentExecution;
257
+ /** The same object as `blueprint.session`; `bindHarnessState` writes it. */
258
+ readonly session: Session;
259
+ readonly blueprint: ResolvedBlueprint;
260
+ readonly environment: TurnEnvironment;
261
+ readonly workspace: TurnWorkspace;
262
+ readonly mcp: TurnMcp;
263
+ /** The mounted skills (phase 5): each under the session's platform dir, reachable from the workspace through its `.stigmer` link; the harness renders them into its prompt. */
264
+ readonly skills: readonly SkillMetadata[];
265
+ readonly attachments: TurnAttachments;
266
+ /** Approved whole-file writes the runtime applied itself this turn (exact-apply); the harness issues no grant for them. */
267
+ readonly appliedToolCallIds: ReadonlySet<string>;
268
+ readonly model: TurnModelPreferences;
269
+ /** `spec.executionConfig.structuredOutputSchema`, when the execution asks for structured output. */
270
+ readonly structuredOutputSchema: Record<string, unknown> | undefined;
271
+ readonly standing: TurnStandingContext;
272
+ /** Resolved once by the runtime before any phase; absent when no substrate works. */
273
+ readonly artifactStorage: ArtifactStorage | undefined;
161
274
  }
162
275
  /**
163
- * The runtime's face during one turn: the five things an adapter may ask of
164
- * it, and the one status it folds into. One sink per turn, owned by the
165
- * runtime; the adapter never constructs one.
276
+ * The runtime's face during one turn: what an adapter may ask of it, and the
277
+ * one status it folds into. One sink per turn, owned by the runtime; the
278
+ * adapter never constructs one.
166
279
  *
167
280
  * Field ownership on `status` before the canonical transcript lands (S4):
168
281
  * the adapter appends the engine's transcript rows (assistant messages,
@@ -170,7 +283,9 @@ export interface TurnInput extends NormalizedActivityInput {
170
283
  * runtime writes the phase, the terminal system messages, `streamingUsage`,
171
284
  * artifacts, write-backs and the file-review projection. An adapter never
172
285
  * writes a phase or a terminal copy: those are Temporal semantics the
173
- * runtime owns once.
286
+ * runtime owns once. (The file-review boundary itself is the adapter's until
287
+ * S3 lifts both harnesses' captures together; `execute-cursor/adapter.ts`
288
+ * says so.)
174
289
  */
175
290
  export interface TurnSink {
176
291
  /**
@@ -185,37 +300,68 @@ export interface TurnSink {
185
300
  * and maps the outcome; the adapter's only job is to settle promptly as
186
301
  * `interrupted`. `stopSignal.reason` is the runtime's own evidence — an
187
302
  * adapter never branches on it. Check `aborted` at every step boundary and
188
- * listen for `abort` inside anything long-running. May already be aborted
189
- * when `runTurn` is entered; then return `interrupted` before doing any
190
- * work.
303
+ * listen for `abort` inside anything long-running (the Cursor adapter
304
+ * cancels its SDK run from that listener). May already be aborted when
305
+ * `runTurn` is entered; then return `interrupted` before doing any work.
191
306
  */
192
307
  readonly stopSignal: AbortSignal;
193
308
  /**
194
- * "Persist the status soon": schedules a write through the runtime's single
195
- * persist chokepoint (tool-output offload, size cap, secret withholding,
196
- * the streaming scheduler). Fire and forget never awaited by the adapter,
197
- * never a promise. The runtime persists unconditionally when the turn
198
- * settles, so no adapter has to flush before returning.
309
+ * The runtime's cold-start timeline for this turn, a live handle like
310
+ * `status`. The runtime marked its own resolution segments on it before
311
+ * `runTurn`; the adapter marks its setup segments (skills, gate, engine
312
+ * resolve) and emits the `execution_setup` line once its engine is ready,
313
+ * so the one timeline reads end to end (`shared/cold-start-timing.ts`).
314
+ * Diagnostics only; nothing branches on it.
315
+ */
316
+ readonly setupTiming: TimingRecorder;
317
+ /**
318
+ * "Persist the status": a write through the runtime's single persist
319
+ * chokepoint (tool-output offload, size cap, secret withholding,
320
+ * `streamingUsage`). Single-flight: a request while a write is in flight
321
+ * coalesces into the next write. Resolves when the state as of the request
322
+ * has been written, so an adapter that needs ordering MAY await it (the
323
+ * Cursor loop awaits before pulling the next event, so a platform STOP
324
+ * answered by that write stops the turn before the next event, as it
325
+ * always has); an adapter never MUST await it, because the runtime
326
+ * persists unconditionally when the turn settles. Never rejects.
199
327
  */
200
- requestPersist(): void;
328
+ requestPersist(): Promise<void>;
201
329
  /**
202
330
  * "I made progress": resets the runtime's stall watchdog and is carried
203
- * into the next Temporal heartbeat. Call it on every engine event and every
204
- * token delta a long generation emits deltas but few discrete events, and
205
- * resetting only on events false-positives a stall. Never throws.
331
+ * into the next Temporal heartbeat. Call it on every engine event, every
332
+ * token delta, and every step boundary of the adapter's own setup (engine
333
+ * resolved, send returned, boundary done) a long generation emits deltas
334
+ * but few discrete events, and resetting only on events false-positives a
335
+ * stall. `detail` names what progressed (the Cursor loop passes the tool
336
+ * name of a `tool_call` event); the runtime quotes the last detail in the
337
+ * stall diagnostic (`last tool: shell`). Never throws.
206
338
  */
207
- recordActivity(): void;
339
+ recordActivity(detail?: string): void;
208
340
  /**
209
- * Token counts for one engine turn. The runtime accumulates, prices and
210
- * enforces `max_cost_usd`; an adapter reports and never accounts. Every
211
- * count is a non-negative delta since the previous report.
341
+ * Token counts for one engine turn, priced by the adapter against its own
342
+ * vendor's table. The runtime accumulates and enforces `max_cost_usd`; an
343
+ * adapter reports and never accounts. Every count is a non-negative delta
344
+ * since the previous report.
212
345
  */
213
346
  reportUsage(delta: UsageDelta): void;
347
+ /**
348
+ * The user-visible setup label (`status.setupProgress.currentPhase`) for a
349
+ * step only the adapter knows ("Initializing Cursor agent"). The runtime
350
+ * reports its own resolution labels itself; the adapter reports the labels
351
+ * of its setup steps exactly as the orchestrator did, so the UI's spinner
352
+ * copy is unchanged by the extraction (Q-S2-5). Resolves once the label is
353
+ * written; the write carries no phase, so it never advances the execution.
354
+ */
355
+ reportProgress(label: string): Promise<void>;
214
356
  /**
215
357
  * The engine-minted state id, the moment it exists and BEFORE the turn
216
358
  * proceeds, so a crash mid-turn still resumes on the next invocation. The
217
- * runtime writes it to the session at once (the Cursor harness's
218
- * `harness_state_id`). Called only by adapters whose
359
+ * runtime writes it to the session record the adapter was handed
360
+ * (`input.session`, with `harness_state_id` set and the metadata slug
361
+ * cleared, the agnostic quirk of `BuildUpdateStateStep`); the adapter may
362
+ * set its own harness-specific `SessionSpec` fields on that record before
363
+ * binding, one writer per field (`harnessStateId` the runtime's,
364
+ * `cursorMode` the adapter's; Q-S2-11). Called only by adapters whose
219
365
  * `capabilities.stateIdSource` is `"engine-minted"`, and before their first
220
366
  * `requestPersist`; a `deterministic` harness never calls it. Rejects when
221
367
  * the session write fails; the adapter then ends the turn `failed` with
@@ -224,44 +370,78 @@ export interface TurnSink {
224
370
  bindHarnessState(harnessStateId: string): Promise<void>;
225
371
  }
226
372
  /**
227
- * Token counts for one engine turn, as the Cursor loop reads them from the
228
- * SDK's `turn-ended` delta (`execute-cursor/usage-accumulator.ts`
229
- * `TurnUsage` is this shape; the runtime extraction collapses the two). Every
230
- * field is optional because engines report different subsets; a missing
231
- * field means zero, never "unknown".
373
+ * Token counts for one engine turn, priced. The four counts are what the
374
+ * Cursor loop reads from the SDK's `turn-ended` delta; `estimatedCostUsd` is
375
+ * the adapter's price for them at its vendor's rates (the runtime cannot
376
+ * price without the vendor's table and must not import it; Q-S2-12), and
377
+ * `model` / `requestedModelParams` name the basis it priced against, which
378
+ * the runtime records into `streamingUsage` (`model` is the catalog-validated
379
+ * id, `requestedModelParams` the JSON of the params sent — a string on the
380
+ * proto, so the SDK type stays inside the adapter). Every field is optional
381
+ * because engines report different subsets; a missing count means zero,
382
+ * never "unknown"; a missing basis inherits the previous delta's.
232
383
  */
233
384
  export interface UsageDelta {
234
385
  readonly inputTokens?: number;
235
386
  readonly outputTokens?: number;
236
387
  readonly cacheReadTokens?: number;
237
388
  readonly cacheWriteTokens?: number;
389
+ readonly estimatedCostUsd?: number;
390
+ readonly model?: string;
391
+ readonly requestedModelParams?: string;
238
392
  }
393
+ /**
394
+ * Which of the runtime's three failure copies a `failed` outcome takes. A
395
+ * classification, never copy: the runtime owns the words
396
+ * (`terminal-table.ts`), the adapter says what kind of thing failed.
397
+ *
398
+ * - `engine`: the engine reported its run as failed. The transcript already
399
+ * tells the story, so the runtime writes `status.error` and no system row
400
+ * (the Cursor `run.wait()` error arm).
401
+ * - `actionable`: the user can fix it (a foreign hook blocked a tool). One
402
+ * `Execution failed: …` row, the same shape the runtime's own settlements
403
+ * use.
404
+ * - `internal`: the runner or its transport broke unexpectedly (a thrown
405
+ * SDK error, an exception in the adapter). The boilerplate row and an
406
+ * `Error details:` row.
407
+ */
408
+ export type FailureSurface = "engine" | "actionable" | "internal";
239
409
  /**
240
410
  * How one turn ended, carrying ONLY what the runtime cannot read from
241
411
  * `sink.status` or its own evidence.
242
412
  *
243
413
  * - `completed`: the engine finished. The final text and any structured
244
414
  * output are already folded onto the status; nothing rides here.
415
+ * - `cancelled`: the engine ended its own run cancelled and there is nothing
416
+ * to wait for — an SDK-side cancel, or a deny-and-retry adapter that
417
+ * stopped its run to gate a call and then found nothing to pause for
418
+ * (an unattended denial settled as skipped). Not `interrupted`: the
419
+ * runtime's `stopSignal` never fired. The runtime writes
420
+ * `EXECUTION_CANCELLED` with no copy and completes the turn.
245
421
  * - `awaiting_approval`: the engine proposed at least one gated side effect
246
422
  * and stopped. The WAITING_APPROVAL rows are already on the status; the
247
423
  * runtime persists them and returns to the workflow, which reinvokes with
248
424
  * the decisions.
249
425
  * - `failed`: the engine or its transport failed in a way the adapter can
250
- * name. `message` is the user-facing sentence; `cause` is for the log.
251
- * The runtime persists FAILED and RETURNS (Temporal does not retry a
252
- * returned activity; re-running the same prompt would fail the same way).
426
+ * name. `message` is the user-facing sentence, `surface` which copy it
427
+ * takes, `cause` is for the log. The runtime persists FAILED and RETURNS
428
+ * (Temporal does not retry a returned activity; re-running the same
429
+ * prompt would fail the same way).
253
430
  * - `interrupted`: `sink.stopSignal` aborted and the adapter stopped. WHY it
254
431
  * aborted is the runtime's evidence (its watchdog, its accounting, its
255
- * heartbeat, its shutdown signal), so no reason rides here; the runtime
256
- * classifies and applies the throw-vs-return table.
432
+ * chokepoint, the cancellation it was delivered), so no reason rides here;
433
+ * the runtime classifies and applies the throw-vs-return table.
257
434
  */
258
435
  export type TurnOutcome = {
259
436
  readonly kind: "completed";
437
+ } | {
438
+ readonly kind: "cancelled";
260
439
  } | {
261
440
  readonly kind: "awaiting_approval";
262
441
  } | {
263
442
  readonly kind: "failed";
264
443
  readonly message: string;
444
+ readonly surface: FailureSurface;
265
445
  readonly cause?: unknown;
266
446
  } | {
267
447
  readonly kind: "interrupted";
@@ -8,9 +8,9 @@
8
8
  * vendor SDK — fetching the execution, resolving the blueprint and the
9
9
  * environment, provisioning and locking the workspace, mounting skills,
10
10
  * resolving MCP servers and approval policies, seeding the transcript, the
11
- * persist cadence, the stall watchdog, the Temporal heartbeat, pause vs
12
- * shutdown, the cost cap, the file-review boundary, the terminal mapping
13
- * is the RUNTIME's, written once. What a harness owns is its SDK slice: how
11
+ * persist chokepoint, the stall watchdog, the Temporal heartbeat, pause vs
12
+ * shutdown, the cost cap, the terminal mapping is the RUNTIME's
13
+ * (`run-turn.ts`), written once. What a harness owns is its SDK slice: how
14
14
  * the engine is created or resumed, how the prompt is placed, how MCP servers
15
15
  * are bound, how the engine is made to stop before a gated side effect, and
16
16
  * how its events become transcript rows. This file is the whole of what a
@@ -22,15 +22,15 @@
22
22
  * runtime cannot read anywhere else. Nothing here is speculative: where the
23
23
  * program's original sketch and the code disagreed, the code won, and the
24
24
  * disagreement was ruled at the entry's gate
25
- * (stigmer-cloud `_projects/2026-09/20260911.02.sp.harness-contract-and-kit/`).
25
+ * (stigmer-cloud `_projects/2026-09/20260911.02.sp.harness-contract-and-kit/`
26
+ * for S1; `20260911.03.sp.turn-runtime-extraction/` M3 for the growth below).
26
27
  *
27
28
  * What is deliberately NOT on this contract, and why:
28
29
  *
29
30
  * - No `dispose()`. One adapter object serves many concurrent turns
30
31
  * (`maxConcurrentActivities`), so a per-turn teardown method on the
31
32
  * adapter is a race. The adapter owns its per-turn teardown in its own
32
- * `finally` inside `runTurn` (the Cursor harness already parks its agent
33
- * there).
33
+ * `finally` inside `runTurn` (the Cursor harness parks its agent there).
34
34
  * - No `isCancelled()`, no `heartbeat(details)`, no `ExecutionStatusWriter`
35
35
  * base. Each would be a second way of saying something `stopSignal`,
36
36
  * `recordActivity()` or `requestPersist()` already says, and two writers of
@@ -46,10 +46,19 @@
46
46
  * - No `TurnInput.status`. The runtime seeds `TurnSink.status` from the
47
47
  * persisted transcript; a second copy on the input is the drift the
48
48
  * single-source-of-truth mandate forbids.
49
+ * - No execution context. "This activity is execution X" is the runtime's
50
+ * ambient fact for the WHOLE activity (`shared/execution-context.ts`, an
51
+ * `AsyncLocalStorage` the runtime enters before anything runs); the
52
+ * interceptors read it per request, so no adapter establishes or
53
+ * propagates it.
54
+ * - No persist cadence. The runtime's chokepoint is single-flight and
55
+ * unconditional at settle; WHEN a streaming turn asks for a write is the
56
+ * adapter's (`shared/persist-decision.ts` over its own dirty flags, since
57
+ * what counts as a discrete change is engine knowledge), until S3 lifts
58
+ * the file-review capture and can revisit with both loops in view.
49
59
  *
50
60
  * Module shape follows `shared/checkpointer/`: `types.ts`, `capabilities.ts`,
51
- * `registry.ts`, no barrel. Nothing production-facing imports this module
52
- * until the runtime that consumes it lands (S2 of the program).
61
+ * `registry.ts`, no barrel.
53
62
  */
54
63
  export {};
55
64
  //# sourceMappingURL=types.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * The turn runtime's usage accounting: the priced deltas an adapter reports
3
+ * through `TurnSink.reportUsage`, summed into the `streaming_usage` summary
4
+ * the persist chokepoint writes before every status write, and the running
5
+ * cost the `max_cost_usd` cap is enforced against.
6
+ *
7
+ * Who owns what (Q-S2-12): the ADAPTER prices, because only it has its
8
+ * vendor's rate table and variant semantics (`execute-cursor/usage-pricing.ts`
9
+ * for Cursor); the RUNTIME accounts and enforces, because the cap and the
10
+ * summary are the platform's, the same for every engine. A delta therefore
11
+ * arrives already priced, naming the basis it was priced against (`model`,
12
+ * `requestedModelParams`), and this class adds — it never multiplies. The
13
+ * tier and thinking mode it records are the runtime's own effective
14
+ * preferences (`TurnInput.model`), the audit trail that the account default
15
+ * was never left in control (#357, #772).
16
+ *
17
+ * Moved from `activities/execute-cursor/usage-accumulator.ts` at S2 M3, the
18
+ * pricing call split out; the sums, the snapshot shape and the empty
19
+ * snapshot are unchanged, so `streamingUsage` is byte-for-byte what the
20
+ * Cursor orchestrator wrote.
21
+ *
22
+ * This data is display-only. The authoritative billing source is the BiDi
23
+ * proxy, which records usage from the wire.
24
+ */
25
+ import { ServiceTier, ThinkingMode } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
26
+ import type { UsageDelta } from "./types.js";
27
+ export interface UsageSnapshot {
28
+ readonly inputTokens: bigint;
29
+ readonly outputTokens: bigint;
30
+ readonly cacheReadTokens: bigint;
31
+ readonly cacheWriteTokens: bigint;
32
+ readonly totalTokens: bigint;
33
+ readonly turnCount: number;
34
+ readonly estimatedCostUsd: number;
35
+ /** The basis the adapter last priced against (its catalog-validated model id); `""` until a delta names one. */
36
+ readonly model: string;
37
+ readonly observedAt: string;
38
+ /** Tier the runner requested — always explicit post-translation (#357). */
39
+ readonly requestedServiceTier: ServiceTier;
40
+ /** JSON-encoded params the adapter sent with its model selection; "" when none. */
41
+ readonly requestedModelParams: string;
42
+ /** Thinking mode the runner requested — always explicit post-translation (#772). */
43
+ readonly requestedThinkingMode: ThinkingMode;
44
+ }
45
+ export declare class UsageAccumulator {
46
+ /** The effective tier the runtime resolved (never UNSPECIFIED on a real turn; the default keeps the empty snapshot honest). */
47
+ private readonly requestedServiceTier;
48
+ /** The effective thinking mode the runtime resolved. Price-neutral (#772); recorded purely as the audit trail twin of the tier. */
49
+ private readonly requestedThinkingMode;
50
+ private inputTokens;
51
+ private outputTokens;
52
+ private cacheReadTokens;
53
+ private cacheWriteTokens;
54
+ private turnCount;
55
+ private estimatedCostUsd;
56
+ private observedAt;
57
+ private model;
58
+ private requestedModelParams;
59
+ constructor(
60
+ /** The effective tier the runtime resolved (never UNSPECIFIED on a real turn; the default keeps the empty snapshot honest). */
61
+ requestedServiceTier?: ServiceTier,
62
+ /** The effective thinking mode the runtime resolved. Price-neutral (#772); recorded purely as the audit trail twin of the tier. */
63
+ requestedThinkingMode?: ThinkingMode);
64
+ /** Add one priced delta. A delta without a basis inherits the previous one; a missing count is zero. */
65
+ addTurn(delta: UsageDelta): void;
66
+ get hasTurns(): boolean;
67
+ snapshot(): UsageSnapshot;
68
+ }