@xfey/tutti 0.1.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 (564) hide show
  1. package/README.md +50 -0
  2. package/dist/approvals/index.d.ts +3 -0
  3. package/dist/approvals/index.js +3 -0
  4. package/dist/approvals/manager.d.ts +47 -0
  5. package/dist/approvals/manager.js +180 -0
  6. package/dist/approvals/projections.d.ts +34 -0
  7. package/dist/approvals/projections.js +444 -0
  8. package/dist/artifacts/index.d.ts +4 -0
  9. package/dist/artifacts/index.js +4 -0
  10. package/dist/artifacts/manifest.d.ts +48 -0
  11. package/dist/artifacts/manifest.js +334 -0
  12. package/dist/artifacts/preview-runtime.d.ts +97 -0
  13. package/dist/artifacts/preview-runtime.js +585 -0
  14. package/dist/artifacts/static-preview.d.ts +17 -0
  15. package/dist/artifacts/static-preview.js +180 -0
  16. package/dist/chat-assistant/index.d.ts +66 -0
  17. package/dist/chat-assistant/index.js +268 -0
  18. package/dist/checks/index.d.ts +47 -0
  19. package/dist/checks/index.js +169 -0
  20. package/dist/collaboration-state/clarification-messages.d.ts +8 -0
  21. package/dist/collaboration-state/clarification-messages.js +180 -0
  22. package/dist/collaboration-state/clarification-records.d.ts +27 -0
  23. package/dist/collaboration-state/clarification-records.js +266 -0
  24. package/dist/collaboration-state/clarification-round-writes.d.ts +14 -0
  25. package/dist/collaboration-state/clarification-round-writes.js +58 -0
  26. package/dist/collaboration-state/clarification-rounds.d.ts +19 -0
  27. package/dist/collaboration-state/clarification-rounds.js +347 -0
  28. package/dist/collaboration-state/clarification-successors.d.ts +8 -0
  29. package/dist/collaboration-state/clarification-successors.js +318 -0
  30. package/dist/collaboration-state/execution-status.d.ts +3 -0
  31. package/dist/collaboration-state/execution-status.js +8 -0
  32. package/dist/collaboration-state/index.d.ts +17 -0
  33. package/dist/collaboration-state/index.js +16 -0
  34. package/dist/collaboration-state/messages.d.ts +25 -0
  35. package/dist/collaboration-state/messages.js +371 -0
  36. package/dist/collaboration-state/read-state.d.ts +7 -0
  37. package/dist/collaboration-state/read-state.js +136 -0
  38. package/dist/collaboration-state/recovery.d.ts +6 -0
  39. package/dist/collaboration-state/recovery.js +125 -0
  40. package/dist/collaboration-state/run-recording.d.ts +5 -0
  41. package/dist/collaboration-state/run-recording.js +216 -0
  42. package/dist/collaboration-state/run-results.d.ts +12 -0
  43. package/dist/collaboration-state/run-results.js +202 -0
  44. package/dist/collaboration-state/scratchpad-source-state.d.ts +46 -0
  45. package/dist/collaboration-state/scratchpad-source-state.js +207 -0
  46. package/dist/collaboration-state/scratchpad.d.ts +8 -0
  47. package/dist/collaboration-state/scratchpad.js +84 -0
  48. package/dist/collaboration-state/serialization.d.ts +16 -0
  49. package/dist/collaboration-state/serialization.js +71 -0
  50. package/dist/collaboration-state/storage-types.d.ts +136 -0
  51. package/dist/collaboration-state/storage-types.js +2 -0
  52. package/dist/collaboration-state/task-details.d.ts +5 -0
  53. package/dist/collaboration-state/task-details.js +25 -0
  54. package/dist/collaboration-state/types.d.ts +289 -0
  55. package/dist/collaboration-state/types.js +2 -0
  56. package/dist/collaboration-state/worklist.d.ts +11 -0
  57. package/dist/collaboration-state/worklist.js +286 -0
  58. package/dist/control-plane/clarification-commands.d.ts +34 -0
  59. package/dist/control-plane/clarification-commands.js +106 -0
  60. package/dist/control-plane/command-recovery.d.ts +3 -0
  61. package/dist/control-plane/command-recovery.js +79 -0
  62. package/dist/control-plane/context-sync.d.ts +47 -0
  63. package/dist/control-plane/context-sync.js +207 -0
  64. package/dist/control-plane/event-publishers.d.ts +24 -0
  65. package/dist/control-plane/event-publishers.js +192 -0
  66. package/dist/control-plane/execution-status.d.ts +13 -0
  67. package/dist/control-plane/execution-status.js +130 -0
  68. package/dist/control-plane/follow-up-context.d.ts +27 -0
  69. package/dist/control-plane/follow-up-context.js +93 -0
  70. package/dist/control-plane/follow-up-output.d.ts +53 -0
  71. package/dist/control-plane/follow-up-output.js +141 -0
  72. package/dist/control-plane/follow-up-run.d.ts +22 -0
  73. package/dist/control-plane/follow-up-run.js +90 -0
  74. package/dist/control-plane/follow-up-start.d.ts +26 -0
  75. package/dist/control-plane/follow-up-start.js +101 -0
  76. package/dist/control-plane/formatters.d.ts +12 -0
  77. package/dist/control-plane/formatters.js +47 -0
  78. package/dist/control-plane/index.d.ts +62 -0
  79. package/dist/control-plane/index.js +416 -0
  80. package/dist/control-plane/invalidations.d.ts +12 -0
  81. package/dist/control-plane/invalidations.js +67 -0
  82. package/dist/control-plane/procedure-logging.d.ts +11 -0
  83. package/dist/control-plane/procedure-logging.js +95 -0
  84. package/dist/control-plane/project-brief-refresh.d.ts +31 -0
  85. package/dist/control-plane/project-brief-refresh.js +105 -0
  86. package/dist/control-plane/project-context-bootstrap.d.ts +39 -0
  87. package/dist/control-plane/project-context-bootstrap.js +107 -0
  88. package/dist/control-plane/reference-summary-refresh.d.ts +22 -0
  89. package/dist/control-plane/reference-summary-refresh.js +344 -0
  90. package/dist/control-plane/run-lineage.d.ts +8 -0
  91. package/dist/control-plane/run-lineage.js +13 -0
  92. package/dist/control-plane/run-result-recording.d.ts +46 -0
  93. package/dist/control-plane/run-result-recording.js +81 -0
  94. package/dist/control-plane/run-scheduler.d.ts +35 -0
  95. package/dist/control-plane/run-scheduler.js +110 -0
  96. package/dist/control-plane/run-start.d.ts +30 -0
  97. package/dist/control-plane/run-start.js +167 -0
  98. package/dist/control-plane/scratchpad-auto-refresh.d.ts +32 -0
  99. package/dist/control-plane/scratchpad-auto-refresh.js +150 -0
  100. package/dist/control-plane/scratchpad-refresh-start.d.ts +60 -0
  101. package/dist/control-plane/scratchpad-refresh-start.js +240 -0
  102. package/dist/control-plane/scratchpad-refresh.d.ts +29 -0
  103. package/dist/control-plane/scratchpad-refresh.js +55 -0
  104. package/dist/control-plane/scratchpad-source-messages.d.ts +10 -0
  105. package/dist/control-plane/scratchpad-source-messages.js +131 -0
  106. package/dist/control-plane/startup-recovery.d.ts +19 -0
  107. package/dist/control-plane/startup-recovery.js +113 -0
  108. package/dist/control-plane/task-compile-continuation.d.ts +25 -0
  109. package/dist/control-plane/task-compile-continuation.js +127 -0
  110. package/dist/control-plane/task-compile-output.d.ts +29 -0
  111. package/dist/control-plane/task-compile-output.js +122 -0
  112. package/dist/control-plane/task-compile-start.d.ts +43 -0
  113. package/dist/control-plane/task-compile-start.js +280 -0
  114. package/dist/control-plane/task-proposal.d.ts +3 -0
  115. package/dist/control-plane/task-proposal.js +37 -0
  116. package/dist/control-plane/types.d.ts +155 -0
  117. package/dist/control-plane/types.js +2 -0
  118. package/dist/control-plane/workflows/index.d.ts +4 -0
  119. package/dist/control-plane/workflows/index.js +4 -0
  120. package/dist/control-plane/workflows/openai.d.ts +34 -0
  121. package/dist/control-plane/workflows/openai.js +411 -0
  122. package/dist/control-plane/workflows/structured-output-schemas.d.ts +9 -0
  123. package/dist/control-plane/workflows/structured-output-schemas.js +289 -0
  124. package/dist/control-plane/workflows/structured-output-validators.d.ts +15 -0
  125. package/dist/control-plane/workflows/structured-output-validators.js +295 -0
  126. package/dist/control-plane/workflows/structured-output.d.ts +3 -0
  127. package/dist/control-plane/workflows/structured-output.js +3 -0
  128. package/dist/control-plane/workflows/types.d.ts +274 -0
  129. package/dist/control-plane/workflows/types.js +2 -0
  130. package/dist/control-plane/worklist-terminal-feedback.d.ts +15 -0
  131. package/dist/control-plane/worklist-terminal-feedback.js +135 -0
  132. package/dist/index.d.ts +2 -0
  133. package/dist/index.js +32 -0
  134. package/dist/procedure-engine/index.d.ts +56 -0
  135. package/dist/procedure-engine/index.js +163 -0
  136. package/dist/project-brief/index.d.ts +4 -0
  137. package/dist/project-brief/index.js +3 -0
  138. package/dist/project-brief/repository.d.ts +5 -0
  139. package/dist/project-brief/repository.js +97 -0
  140. package/dist/project-brief/source.d.ts +8 -0
  141. package/dist/project-brief/source.js +75 -0
  142. package/dist/project-brief/types.d.ts +40 -0
  143. package/dist/project-brief/types.js +2 -0
  144. package/dist/project-docs/context.d.ts +34 -0
  145. package/dist/project-docs/context.js +86 -0
  146. package/dist/project-timeline/index.d.ts +20 -0
  147. package/dist/project-timeline/index.js +100 -0
  148. package/dist/prompt-templates/index.d.ts +13 -0
  149. package/dist/prompt-templates/index.js +86 -0
  150. package/dist/provider-usage/index.d.ts +37 -0
  151. package/dist/provider-usage/index.js +227 -0
  152. package/dist/providers/index.d.ts +2 -0
  153. package/dist/providers/index.js +2 -0
  154. package/dist/providers/openai/app-server/json-rpc.d.ts +71 -0
  155. package/dist/providers/openai/app-server/json-rpc.js +298 -0
  156. package/dist/providers/openai/app-server/permission-profile.d.ts +64 -0
  157. package/dist/providers/openai/app-server/permission-profile.js +67 -0
  158. package/dist/providers/openai/app-server/provider-config.d.ts +10 -0
  159. package/dist/providers/openai/app-server/provider-config.js +39 -0
  160. package/dist/providers/openai/app-server/read-only-procedure.d.ts +68 -0
  161. package/dist/providers/openai/app-server/read-only-procedure.js +293 -0
  162. package/dist/providers/openai/app-server/runtime-helpers.d.ts +20 -0
  163. package/dist/providers/openai/app-server/runtime-helpers.js +151 -0
  164. package/dist/providers/openai/app-server/skills.d.ts +82 -0
  165. package/dist/providers/openai/app-server/skills.js +222 -0
  166. package/dist/providers/openai/app-server/smoke-cli.d.ts +2 -0
  167. package/dist/providers/openai/app-server/smoke-cli.js +42 -0
  168. package/dist/providers/openai/app-server/smoke-helpers.d.ts +19 -0
  169. package/dist/providers/openai/app-server/smoke-helpers.js +125 -0
  170. package/dist/providers/openai/app-server/smoke-provider-input.d.ts +6 -0
  171. package/dist/providers/openai/app-server/smoke-provider-input.js +20 -0
  172. package/dist/providers/openai/app-server/smoke-types.d.ts +49 -0
  173. package/dist/providers/openai/app-server/smoke-types.js +20 -0
  174. package/dist/providers/openai/app-server/smoke.d.ts +9 -0
  175. package/dist/providers/openai/app-server/smoke.js +157 -0
  176. package/dist/providers/openai/app-server/workspace-write-run.d.ts +87 -0
  177. package/dist/providers/openai/app-server/workspace-write-run.js +379 -0
  178. package/dist/providers/openai/chat-assistant.d.ts +34 -0
  179. package/dist/providers/openai/chat-assistant.js +72 -0
  180. package/dist/providers/openai/codex-app-server.d.ts +126 -0
  181. package/dist/providers/openai/codex-app-server.js +147 -0
  182. package/dist/providers/openai/credential-store.d.ts +31 -0
  183. package/dist/providers/openai/credential-store.js +143 -0
  184. package/dist/providers/openai/credential-validation.d.ts +45 -0
  185. package/dist/providers/openai/credential-validation.js +190 -0
  186. package/dist/providers/openai/index.d.ts +13 -0
  187. package/dist/providers/openai/index.js +13 -0
  188. package/dist/providers/openai/machine-local-files.d.ts +19 -0
  189. package/dist/providers/openai/machine-local-files.js +55 -0
  190. package/dist/providers/openai/model-config.d.ts +4 -0
  191. package/dist/providers/openai/model-config.js +4 -0
  192. package/dist/providers/openai/provider-config-errors.d.ts +6 -0
  193. package/dist/providers/openai/provider-config-errors.js +13 -0
  194. package/dist/providers/openai/provider-config-shape.d.ts +3 -0
  195. package/dist/providers/openai/provider-config-shape.js +108 -0
  196. package/dist/providers/openai/provider-config-toml.d.ts +13 -0
  197. package/dist/providers/openai/provider-config-toml.js +113 -0
  198. package/dist/providers/openai/provider-config.d.ts +73 -0
  199. package/dist/providers/openai/provider-config.js +117 -0
  200. package/dist/providers/openai/provider-setup.d.ts +31 -0
  201. package/dist/providers/openai/provider-setup.js +88 -0
  202. package/dist/providers/openai/sdk-procedure-runner.d.ts +70 -0
  203. package/dist/providers/openai/sdk-procedure-runner.js +123 -0
  204. package/dist/providers/openai/token-usage.d.ts +11 -0
  205. package/dist/providers/openai/token-usage.js +90 -0
  206. package/dist/run-engine/index.d.ts +61 -0
  207. package/dist/run-engine/index.js +140 -0
  208. package/dist/run-pipeline/candidate-diff.d.ts +3 -0
  209. package/dist/run-pipeline/candidate-diff.js +10 -0
  210. package/dist/run-pipeline/openai.d.ts +41 -0
  211. package/dist/run-pipeline/openai.js +548 -0
  212. package/dist/run-pipeline/promotion-reconcile.d.ts +13 -0
  213. package/dist/run-pipeline/promotion-reconcile.js +138 -0
  214. package/dist/run-pipeline/result-projections.d.ts +39 -0
  215. package/dist/run-pipeline/result-projections.js +115 -0
  216. package/dist/run-pipeline/task-run-invocation.d.ts +6 -0
  217. package/dist/run-pipeline/task-run-invocation.js +130 -0
  218. package/dist/run-pipeline/task-run-output.d.ts +38 -0
  219. package/dist/run-pipeline/task-run-output.js +146 -0
  220. package/dist/server-shell/cli/args.d.ts +7 -0
  221. package/dist/server-shell/cli/args.js +30 -0
  222. package/dist/server-shell/cli/cli.d.ts +3 -0
  223. package/dist/server-shell/cli/cli.js +57 -0
  224. package/dist/server-shell/cli/errors.d.ts +9 -0
  225. package/dist/server-shell/cli/errors.js +53 -0
  226. package/dist/server-shell/cli/git-bootstrap.d.ts +24 -0
  227. package/dist/server-shell/cli/git-bootstrap.js +246 -0
  228. package/dist/server-shell/cli/host-lifecycle.d.ts +45 -0
  229. package/dist/server-shell/cli/host-lifecycle.js +298 -0
  230. package/dist/server-shell/cli/host-relay-status.d.ts +6 -0
  231. package/dist/server-shell/cli/host-relay-status.js +43 -0
  232. package/dist/server-shell/cli/host-runtime-endpoint.d.ts +22 -0
  233. package/dist/server-shell/cli/host-runtime-endpoint.js +120 -0
  234. package/dist/server-shell/cli/host-server-runtime.d.ts +30 -0
  235. package/dist/server-shell/cli/host-server-runtime.js +432 -0
  236. package/dist/server-shell/cli/index.d.ts +8 -0
  237. package/dist/server-shell/cli/index.js +8 -0
  238. package/dist/server-shell/cli/launch.d.ts +45 -0
  239. package/dist/server-shell/cli/launch.js +115 -0
  240. package/dist/server-shell/cli/machine-local.d.ts +69 -0
  241. package/dist/server-shell/cli/machine-local.js +223 -0
  242. package/dist/server-shell/cli/project-identity.d.ts +20 -0
  243. package/dist/server-shell/cli/project-identity.js +87 -0
  244. package/dist/server-shell/cli/relay-registration.d.ts +31 -0
  245. package/dist/server-shell/cli/relay-registration.js +61 -0
  246. package/dist/server-shell/command-idempotency/index.d.ts +44 -0
  247. package/dist/server-shell/command-idempotency/index.js +155 -0
  248. package/dist/server-shell/dev-runner/cli.d.ts +2 -0
  249. package/dist/server-shell/dev-runner/cli.js +10 -0
  250. package/dist/server-shell/dev-runner/config.d.ts +38 -0
  251. package/dist/server-shell/dev-runner/config.js +277 -0
  252. package/dist/server-shell/dev-runner/host-cli.d.ts +2 -0
  253. package/dist/server-shell/dev-runner/host-cli.js +22 -0
  254. package/dist/server-shell/dev-runner/index.d.ts +3 -0
  255. package/dist/server-shell/dev-runner/index.js +3 -0
  256. package/dist/server-shell/dev-runner/runner.d.ts +30 -0
  257. package/dist/server-shell/dev-runner/runner.js +236 -0
  258. package/dist/server-shell/http/create-server.d.ts +18 -0
  259. package/dist/server-shell/http/create-server.js +51 -0
  260. package/dist/server-shell/http/host-tunnel.d.ts +15 -0
  261. package/dist/server-shell/http/host-tunnel.js +154 -0
  262. package/dist/server-shell/http/logger.d.ts +7 -0
  263. package/dist/server-shell/http/logger.js +19 -0
  264. package/dist/server-shell/http/routes/agent-context-auth.d.ts +41 -0
  265. package/dist/server-shell/http/routes/agent-context-auth.js +73 -0
  266. package/dist/server-shell/http/routes/agent-context-errors.d.ts +6 -0
  267. package/dist/server-shell/http/routes/agent-context-errors.js +9 -0
  268. package/dist/server-shell/http/routes/agent-context-messages-routes.d.ts +4 -0
  269. package/dist/server-shell/http/routes/agent-context-messages-routes.js +74 -0
  270. package/dist/server-shell/http/routes/agent-context-project-doc-routes.d.ts +4 -0
  271. package/dist/server-shell/http/routes/agent-context-project-doc-routes.js +86 -0
  272. package/dist/server-shell/http/routes/agent-context-project-docs.d.ts +40 -0
  273. package/dist/server-shell/http/routes/agent-context-project-docs.js +98 -0
  274. package/dist/server-shell/http/routes/agent-context-query.d.ts +31 -0
  275. package/dist/server-shell/http/routes/agent-context-query.js +72 -0
  276. package/dist/server-shell/http/routes/agent-context-reference-routes.d.ts +4 -0
  277. package/dist/server-shell/http/routes/agent-context-reference-routes.js +82 -0
  278. package/dist/server-shell/http/routes/agent-context-references.d.ts +21 -0
  279. package/dist/server-shell/http/routes/agent-context-references.js +85 -0
  280. package/dist/server-shell/http/routes/agent-context-shared.d.ts +34 -0
  281. package/dist/server-shell/http/routes/agent-context-shared.js +44 -0
  282. package/dist/server-shell/http/routes/agent-context-skills-routes.d.ts +4 -0
  283. package/dist/server-shell/http/routes/agent-context-skills-routes.js +85 -0
  284. package/dist/server-shell/http/routes/agent-context-workspace-routes.d.ts +4 -0
  285. package/dist/server-shell/http/routes/agent-context-workspace-routes.js +130 -0
  286. package/dist/server-shell/http/routes/agent-context.d.ts +8 -0
  287. package/dist/server-shell/http/routes/agent-context.js +16 -0
  288. package/dist/server-shell/http/routes/health.d.ts +7 -0
  289. package/dist/server-shell/http/routes/health.js +41 -0
  290. package/dist/server-shell/http/routes/local-control.d.ts +40 -0
  291. package/dist/server-shell/http/routes/local-control.js +260 -0
  292. package/dist/server-shell/http/routes/project-api/approval-routes.d.ts +4 -0
  293. package/dist/server-shell/http/routes/project-api/approval-routes.js +64 -0
  294. package/dist/server-shell/http/routes/project-api/artifacts-routes.d.ts +8 -0
  295. package/dist/server-shell/http/routes/project-api/artifacts-routes.js +166 -0
  296. package/dist/server-shell/http/routes/project-api/clarification-routes.d.ts +4 -0
  297. package/dist/server-shell/http/routes/project-api/clarification-routes.js +150 -0
  298. package/dist/server-shell/http/routes/project-api/constants.d.ts +3 -0
  299. package/dist/server-shell/http/routes/project-api/constants.js +3 -0
  300. package/dist/server-shell/http/routes/project-api/errors.d.ts +26 -0
  301. package/dist/server-shell/http/routes/project-api/errors.js +41 -0
  302. package/dist/server-shell/http/routes/project-api/events-stream.d.ts +11 -0
  303. package/dist/server-shell/http/routes/project-api/events-stream.js +55 -0
  304. package/dist/server-shell/http/routes/project-api/execution-routes.d.ts +4 -0
  305. package/dist/server-shell/http/routes/project-api/execution-routes.js +92 -0
  306. package/dist/server-shell/http/routes/project-api/headers.d.ts +2 -0
  307. package/dist/server-shell/http/routes/project-api/headers.js +7 -0
  308. package/dist/server-shell/http/routes/project-api/invalidations.d.ts +10 -0
  309. package/dist/server-shell/http/routes/project-api/invalidations.js +57 -0
  310. package/dist/server-shell/http/routes/project-api/messages-routes.d.ts +8 -0
  311. package/dist/server-shell/http/routes/project-api/messages-routes.js +80 -0
  312. package/dist/server-shell/http/routes/project-api/openapi-approval-routes.d.ts +128 -0
  313. package/dist/server-shell/http/routes/project-api/openapi-approval-routes.js +32 -0
  314. package/dist/server-shell/http/routes/project-api/openapi-artifacts-routes.d.ts +51 -0
  315. package/dist/server-shell/http/routes/project-api/openapi-artifacts-routes.js +56 -0
  316. package/dist/server-shell/http/routes/project-api/openapi-collaboration-routes.d.ts +466 -0
  317. package/dist/server-shell/http/routes/project-api/openapi-collaboration-routes.js +165 -0
  318. package/dist/server-shell/http/routes/project-api/openapi-diagnostic-routes.d.ts +16 -0
  319. package/dist/server-shell/http/routes/project-api/openapi-diagnostic-routes.js +17 -0
  320. package/dist/server-shell/http/routes/project-api/openapi-execution-routes.d.ts +215 -0
  321. package/dist/server-shell/http/routes/project-api/openapi-execution-routes.js +75 -0
  322. package/dist/server-shell/http/routes/project-api/openapi-path-parameters.d.ts +9 -0
  323. package/dist/server-shell/http/routes/project-api/openapi-path-parameters.js +18 -0
  324. package/dist/server-shell/http/routes/project-api/openapi-skills-routes.d.ts +60 -0
  325. package/dist/server-shell/http/routes/project-api/openapi-skills-routes.js +51 -0
  326. package/dist/server-shell/http/routes/project-api/openapi-timeline-routes.d.ts +115 -0
  327. package/dist/server-shell/http/routes/project-api/openapi-timeline-routes.js +17 -0
  328. package/dist/server-shell/http/routes/project-api/openapi-viewer-routes.d.ts +323 -0
  329. package/dist/server-shell/http/routes/project-api/openapi-viewer-routes.js +120 -0
  330. package/dist/server-shell/http/routes/project-api/openapi-workspace-routes.d.ts +1317 -0
  331. package/dist/server-shell/http/routes/project-api/openapi-workspace-routes.js +95 -0
  332. package/dist/server-shell/http/routes/project-api/openapi.d.ts +2457 -0
  333. package/dist/server-shell/http/routes/project-api/openapi.js +30 -0
  334. package/dist/server-shell/http/routes/project-api/payload-validation.d.ts +6 -0
  335. package/dist/server-shell/http/routes/project-api/payload-validation.js +36 -0
  336. package/dist/server-shell/http/routes/project-api/project-docs-helpers.d.ts +9 -0
  337. package/dist/server-shell/http/routes/project-api/project-docs-helpers.js +17 -0
  338. package/dist/server-shell/http/routes/project-api/project-docs-routes.d.ts +8 -0
  339. package/dist/server-shell/http/routes/project-api/project-docs-routes.js +151 -0
  340. package/dist/server-shell/http/routes/project-api/project-timeline-projection.d.ts +8 -0
  341. package/dist/server-shell/http/routes/project-api/project-timeline-projection.js +658 -0
  342. package/dist/server-shell/http/routes/project-api/project-timeline-routes.d.ts +4 -0
  343. package/dist/server-shell/http/routes/project-api/project-timeline-routes.js +23 -0
  344. package/dist/server-shell/http/routes/project-api/read-state-routes.d.ts +8 -0
  345. package/dist/server-shell/http/routes/project-api/read-state-routes.js +82 -0
  346. package/dist/server-shell/http/routes/project-api/reference-files-routes.d.ts +8 -0
  347. package/dist/server-shell/http/routes/project-api/reference-files-routes.js +184 -0
  348. package/dist/server-shell/http/routes/project-api/reference-files.d.ts +17 -0
  349. package/dist/server-shell/http/routes/project-api/reference-files.js +212 -0
  350. package/dist/server-shell/http/routes/project-api/repo-projection.d.ts +3 -0
  351. package/dist/server-shell/http/routes/project-api/repo-projection.js +58 -0
  352. package/dist/server-shell/http/routes/project-api/schemas.d.ts +1351 -0
  353. package/dist/server-shell/http/routes/project-api/schemas.js +441 -0
  354. package/dist/server-shell/http/routes/project-api/session-requirements.d.ts +10 -0
  355. package/dist/server-shell/http/routes/project-api/session-requirements.js +60 -0
  356. package/dist/server-shell/http/routes/project-api/skills-helpers.d.ts +7 -0
  357. package/dist/server-shell/http/routes/project-api/skills-helpers.js +48 -0
  358. package/dist/server-shell/http/routes/project-api/skills-routes.d.ts +8 -0
  359. package/dist/server-shell/http/routes/project-api/skills-routes.js +185 -0
  360. package/dist/server-shell/http/routes/project-api/staged-uploads.d.ts +14 -0
  361. package/dist/server-shell/http/routes/project-api/staged-uploads.js +149 -0
  362. package/dist/server-shell/http/routes/project-api/system-routes.d.ts +8 -0
  363. package/dist/server-shell/http/routes/project-api/system-routes.js +141 -0
  364. package/dist/server-shell/http/routes/project-api/types.d.ts +137 -0
  365. package/dist/server-shell/http/routes/project-api/types.js +2 -0
  366. package/dist/server-shell/http/routes/project-api/viewer-projections.d.ts +17 -0
  367. package/dist/server-shell/http/routes/project-api/viewer-projections.js +102 -0
  368. package/dist/server-shell/http/routes/project-api/viewer-routes.d.ts +4 -0
  369. package/dist/server-shell/http/routes/project-api/viewer-routes.js +100 -0
  370. package/dist/server-shell/http/routes/project-api/workflow-routes.d.ts +4 -0
  371. package/dist/server-shell/http/routes/project-api/workflow-routes.js +85 -0
  372. package/dist/server-shell/http/routes/project-api/workspace-projections.d.ts +5 -0
  373. package/dist/server-shell/http/routes/project-api/workspace-projections.js +103 -0
  374. package/dist/server-shell/http/routes/project-api.d.ts +8 -0
  375. package/dist/server-shell/http/routes/project-api.js +34 -0
  376. package/dist/server-shell/http/sse-replay-buffer.d.ts +54 -0
  377. package/dist/server-shell/http/sse-replay-buffer.js +110 -0
  378. package/dist/server-shell/http/sse.d.ts +12 -0
  379. package/dist/server-shell/http/sse.js +22 -0
  380. package/dist/server-shell/http/static-web.d.ts +6 -0
  381. package/dist/server-shell/http/static-web.js +52 -0
  382. package/dist/server-shell/http/validation.d.ts +13 -0
  383. package/dist/server-shell/http/validation.js +136 -0
  384. package/dist/server-shell/http/workspace-events.d.ts +38 -0
  385. package/dist/server-shell/http/workspace-events.js +98 -0
  386. package/dist/server-shell/session/relay-session-context.d.ts +25 -0
  387. package/dist/server-shell/session/relay-session-context.js +49 -0
  388. package/dist/server-shell/smoke/e2e-client.d.ts +59 -0
  389. package/dist/server-shell/smoke/e2e-client.js +304 -0
  390. package/dist/server-shell/smoke/index.d.ts +2 -0
  391. package/dist/server-shell/smoke/index.js +2 -0
  392. package/dist/skills/constants.d.ts +8 -0
  393. package/dist/skills/constants.js +9 -0
  394. package/dist/skills/errors.d.ts +6 -0
  395. package/dist/skills/errors.js +9 -0
  396. package/dist/skills/index.d.ts +41 -0
  397. package/dist/skills/index.js +171 -0
  398. package/dist/skills/metadata.d.ts +8 -0
  399. package/dist/skills/metadata.js +80 -0
  400. package/dist/skills/zip-import.d.ts +18 -0
  401. package/dist/skills/zip-import.js +241 -0
  402. package/dist/store/command-recovery.d.ts +26 -0
  403. package/dist/store/command-recovery.js +71 -0
  404. package/dist/store/index.d.ts +6 -0
  405. package/dist/store/index.js +6 -0
  406. package/dist/store/lifecycle.d.ts +23 -0
  407. package/dist/store/lifecycle.js +53 -0
  408. package/dist/store/metadata.d.ts +18 -0
  409. package/dist/store/metadata.js +30 -0
  410. package/dist/store/migrations.d.ts +20 -0
  411. package/dist/store/migrations.js +76 -0
  412. package/dist/store/sqlite.d.ts +11 -0
  413. package/dist/store/sqlite.js +21 -0
  414. package/dist/workspace-ops/constants.d.ts +15 -0
  415. package/dist/workspace-ops/constants.js +20 -0
  416. package/dist/workspace-ops/errors.d.ts +8 -0
  417. package/dist/workspace-ops/errors.js +33 -0
  418. package/dist/workspace-ops/git.d.ts +13 -0
  419. package/dist/workspace-ops/git.js +53 -0
  420. package/dist/workspace-ops/index.d.ts +11 -0
  421. package/dist/workspace-ops/index.js +9 -0
  422. package/dist/workspace-ops/mainline.d.ts +2 -0
  423. package/dist/workspace-ops/mainline.js +16 -0
  424. package/dist/workspace-ops/project-doc-templates.d.ts +12 -0
  425. package/dist/workspace-ops/project-doc-templates.js +180 -0
  426. package/dist/workspace-ops/project-docs.d.ts +7 -0
  427. package/dist/workspace-ops/project-docs.js +156 -0
  428. package/dist/workspace-ops/reference-files.d.ts +3 -0
  429. package/dist/workspace-ops/reference-files.js +137 -0
  430. package/dist/workspace-ops/reference-metadata.d.ts +13 -0
  431. package/dist/workspace-ops/reference-metadata.js +86 -0
  432. package/dist/workspace-ops/reference-summaries.d.ts +17 -0
  433. package/dist/workspace-ops/reference-summaries.js +298 -0
  434. package/dist/workspace-ops/run-workspaces.d.ts +18 -0
  435. package/dist/workspace-ops/run-workspaces.js +271 -0
  436. package/dist/workspace-ops/types.d.ts +219 -0
  437. package/dist/workspace-ops/types.js +2 -0
  438. package/dist/workspace-ops/viewer-file.d.ts +4 -0
  439. package/dist/workspace-ops/viewer-file.js +207 -0
  440. package/dist/workspace-ops/viewer-git.d.ts +20 -0
  441. package/dist/workspace-ops/viewer-git.js +111 -0
  442. package/dist/workspace-ops/viewer-paths.d.ts +3 -0
  443. package/dist/workspace-ops/viewer-paths.js +13 -0
  444. package/dist/workspace-ops/viewer-tree.d.ts +9 -0
  445. package/dist/workspace-ops/viewer-tree.js +144 -0
  446. package/dist/workspace-ops/viewer.d.ts +5 -0
  447. package/dist/workspace-ops/viewer.js +5 -0
  448. package/migrations/0001_init.sql +674 -0
  449. package/migrations/0002_allow_sealed_round_successor_note.sql +14 -0
  450. package/migrations/0003_drop_scratchpad_source_message_refs.sql +1 -0
  451. package/migrations/0004_read_state.sql +109 -0
  452. package/migrations/0005_provider_usage.sql +15 -0
  453. package/migrations/0006_scratchpad_source_state.sql +29 -0
  454. package/migrations/0007_workspace_signal_read_state_scopes.sql +74 -0
  455. package/migrations/0008_provider_usage_anchors.sql +32 -0
  456. package/migrations/0009_project_timeline_events.sql +33 -0
  457. package/migrations/0010_project_brief.sql +13 -0
  458. package/migrations/0011_message_author_avatar.sql +5 -0
  459. package/migrations/README.md +44 -0
  460. package/node_modules/@tutti/relay-client/dist/host-control.d.ts +164 -0
  461. package/node_modules/@tutti/relay-client/dist/host-control.js +284 -0
  462. package/node_modules/@tutti/relay-client/dist/index.d.ts +3 -0
  463. package/node_modules/@tutti/relay-client/dist/index.js +3 -0
  464. package/node_modules/@tutti/relay-client/dist/tunnel-frames.d.ts +8 -0
  465. package/node_modules/@tutti/relay-client/dist/tunnel-frames.js +124 -0
  466. package/node_modules/@tutti/relay-client/dist/tunnel-types.d.ts +61 -0
  467. package/node_modules/@tutti/relay-client/dist/tunnel-types.js +2 -0
  468. package/node_modules/@tutti/relay-client/dist/tunnel.d.ts +4 -0
  469. package/node_modules/@tutti/relay-client/dist/tunnel.js +144 -0
  470. package/node_modules/@tutti/relay-client/package.json +18 -0
  471. package/node_modules/@tutti/shared/dist/domain/index.d.ts +59 -0
  472. package/node_modules/@tutti/shared/dist/domain/index.js +37 -0
  473. package/node_modules/@tutti/shared/dist/ids/index.d.ts +85 -0
  474. package/node_modules/@tutti/shared/dist/ids/index.js +88 -0
  475. package/node_modules/@tutti/shared/dist/index.d.ts +6 -0
  476. package/node_modules/@tutti/shared/dist/index.js +6 -0
  477. package/node_modules/@tutti/shared/dist/schemas/api/approvals.d.ts +307 -0
  478. package/node_modules/@tutti/shared/dist/schemas/api/approvals.js +110 -0
  479. package/node_modules/@tutti/shared/dist/schemas/api/artifacts.d.ts +173 -0
  480. package/node_modules/@tutti/shared/dist/schemas/api/artifacts.js +107 -0
  481. package/node_modules/@tutti/shared/dist/schemas/api/clarifications.d.ts +704 -0
  482. package/node_modules/@tutti/shared/dist/schemas/api/clarifications.js +224 -0
  483. package/node_modules/@tutti/shared/dist/schemas/api/index.d.ts +18 -0
  484. package/node_modules/@tutti/shared/dist/schemas/api/index.js +17 -0
  485. package/node_modules/@tutti/shared/dist/schemas/api/messages.d.ts +370 -0
  486. package/node_modules/@tutti/shared/dist/schemas/api/messages.js +134 -0
  487. package/node_modules/@tutti/shared/dist/schemas/api/openapi.d.ts +32 -0
  488. package/node_modules/@tutti/shared/dist/schemas/api/openapi.js +100 -0
  489. package/node_modules/@tutti/shared/dist/schemas/api/primitives.d.ts +109 -0
  490. package/node_modules/@tutti/shared/dist/schemas/api/primitives.js +174 -0
  491. package/node_modules/@tutti/shared/dist/schemas/api/project-timeline.d.ts +149 -0
  492. package/node_modules/@tutti/shared/dist/schemas/api/project-timeline.js +44 -0
  493. package/node_modules/@tutti/shared/dist/schemas/api/provider-config.d.ts +21 -0
  494. package/node_modules/@tutti/shared/dist/schemas/api/provider-config.js +33 -0
  495. package/node_modules/@tutti/shared/dist/schemas/api/provider-usage.d.ts +87 -0
  496. package/node_modules/@tutti/shared/dist/schemas/api/provider-usage.js +48 -0
  497. package/node_modules/@tutti/shared/dist/schemas/api/read-state.d.ts +89 -0
  498. package/node_modules/@tutti/shared/dist/schemas/api/read-state.js +39 -0
  499. package/node_modules/@tutti/shared/dist/schemas/api/runtime-events.d.ts +484 -0
  500. package/node_modules/@tutti/shared/dist/schemas/api/runtime-events.js +185 -0
  501. package/node_modules/@tutti/shared/dist/schemas/api/skills.d.ts +88 -0
  502. package/node_modules/@tutti/shared/dist/schemas/api/skills.js +71 -0
  503. package/node_modules/@tutti/shared/dist/schemas/api/types.d.ts +253 -0
  504. package/node_modules/@tutti/shared/dist/schemas/api/types.js +2 -0
  505. package/node_modules/@tutti/shared/dist/schemas/api/uploads.d.ts +103 -0
  506. package/node_modules/@tutti/shared/dist/schemas/api/uploads.js +78 -0
  507. package/node_modules/@tutti/shared/dist/schemas/api/viewer-reference.d.ts +484 -0
  508. package/node_modules/@tutti/shared/dist/schemas/api/viewer-reference.js +267 -0
  509. package/node_modules/@tutti/shared/dist/schemas/api/work-items.d.ts +264 -0
  510. package/node_modules/@tutti/shared/dist/schemas/api/work-items.js +196 -0
  511. package/node_modules/@tutti/shared/dist/schemas/api/workspace-commands.d.ts +179 -0
  512. package/node_modules/@tutti/shared/dist/schemas/api/workspace-commands.js +137 -0
  513. package/node_modules/@tutti/shared/dist/schemas/domain/index.d.ts +31 -0
  514. package/node_modules/@tutti/shared/dist/schemas/domain/index.js +49 -0
  515. package/node_modules/@tutti/shared/dist/schemas/internal/index.d.ts +46 -0
  516. package/node_modules/@tutti/shared/dist/schemas/internal/index.js +46 -0
  517. package/node_modules/@tutti/shared/dist/utils/command-idempotency/index.d.ts +40 -0
  518. package/node_modules/@tutti/shared/dist/utils/command-idempotency/index.js +100 -0
  519. package/node_modules/@tutti/shared/dist/utils/index.d.ts +5 -0
  520. package/node_modules/@tutti/shared/dist/utils/index.js +5 -0
  521. package/node_modules/@tutti/shared/dist/utils/logging/index.d.ts +34 -0
  522. package/node_modules/@tutti/shared/dist/utils/logging/index.js +130 -0
  523. package/node_modules/@tutti/shared/dist/utils/path-policy/index.d.ts +13 -0
  524. package/node_modules/@tutti/shared/dist/utils/path-policy/index.js +80 -0
  525. package/node_modules/@tutti/shared/dist/utils/redaction/index.d.ts +19 -0
  526. package/node_modules/@tutti/shared/dist/utils/redaction/index.js +158 -0
  527. package/node_modules/@tutti/shared/package.json +63 -0
  528. package/package.json +47 -0
  529. package/prompts/README.md +36 -0
  530. package/prompts/chat-assistant.md +43 -0
  531. package/prompts/codex/README.md +13 -0
  532. package/prompts/codex/no-write-smoke.md +35 -0
  533. package/prompts/procedures/README.md +38 -0
  534. package/prompts/procedures/context-sync.md +66 -0
  535. package/prompts/procedures/follow-up-check.md +83 -0
  536. package/prompts/procedures/project-brief-refresh.md +79 -0
  537. package/prompts/procedures/project-context-bootstrap.md +58 -0
  538. package/prompts/procedures/reference-file-summary.md +49 -0
  539. package/prompts/procedures/scratchpad-refresh.md +83 -0
  540. package/prompts/procedures/task-compile.md +116 -0
  541. package/prompts/prompt-flow-experiment-plan.md +203 -0
  542. package/prompts/prompt-flow-map.md +478 -0
  543. package/prompts/runs/README.md +17 -0
  544. package/prompts/runs/task-continuation.md +148 -0
  545. package/prompts/runs/task-retry.md +153 -0
  546. package/prompts/runs/task-run.md +135 -0
  547. package/prompts/skills/README.md +25 -0
  548. package/prompts/skills/read-main-chat/README.md +8 -0
  549. package/prompts/skills/read-main-chat/SKILL.md +18 -0
  550. package/prompts/skills/read-project-docs/README.md +13 -0
  551. package/prompts/skills/read-project-docs/SKILL.md +42 -0
  552. package/prompts/skills/read-references/README.md +9 -0
  553. package/prompts/skills/read-references/SKILL.md +26 -0
  554. package/prompts/skills/read-scratchpad/README.md +8 -0
  555. package/prompts/skills/read-scratchpad/SKILL.md +16 -0
  556. package/prompts/skills/read-user-skills/README.md +7 -0
  557. package/prompts/skills/read-user-skills/SKILL.md +22 -0
  558. package/prompts/skills/read-worklist/README.md +9 -0
  559. package/prompts/skills/read-worklist/SKILL.md +20 -0
  560. package/web/assets/Tutti-B7gEyTp1.png +0 -0
  561. package/web/assets/Tutti-square-BqFU7F0D.png +0 -0
  562. package/web/assets/index-CWkBgHap.js +29 -0
  563. package/web/assets/index-D8xJY8Gr.css +1 -0
  564. package/web/index.html +13 -0
@@ -0,0 +1,658 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { providerUsageSourceMetadata, readProviderUsageBreakdownForAnchors, readProviderUsageModelSummariesForAnchors, readProviderUsageProjection, readProviderUsageSourceSummariesForAnchors, } from "../../../../provider-usage/index.js";
3
+ import { readProjectTimelineEventItems } from "../../../../project-timeline/index.js";
4
+ import { HOST_MAINLINE_BRANCH } from "./constants.js";
5
+ const TIMELINE_LIMIT = 50;
6
+ const COMMIT_TIMELINE_LIMIT = 30;
7
+ const RUN_RESULT_TIMELINE_LIMIT = 50;
8
+ const TASK_TIMELINE_LIMIT = 50;
9
+ const CLARIFICATION_TIMELINE_LIMIT = 50;
10
+ const RECOVERY_TIMELINE_LIMIT = 30;
11
+ const DURABLE_EVENT_TIMELINE_LIMIT = 50;
12
+ const RUN_USAGE_SOURCES = [
13
+ "workspace_write_run",
14
+ "follow_up_run",
15
+ "pipeline_self_correction",
16
+ ];
17
+ const TASK_ADDED_USAGE_SOURCES = ["task_compile"];
18
+ const CONTEXT_SYNC_USAGE_SOURCES = ["context_sync"];
19
+ const REFERENCE_SUMMARY_USAGE_SOURCES = ["reference_summary_refresh"];
20
+ function compareTimelineItemsByTimeDesc(left, right) {
21
+ const leftTime = Date.parse(left.occurred_at);
22
+ const rightTime = Date.parse(right.occurred_at);
23
+ const byTime = Number.isFinite(leftTime) && Number.isFinite(rightTime)
24
+ ? rightTime - leftTime
25
+ : right.occurred_at.localeCompare(left.occurred_at);
26
+ return byTime === 0 ? right.id.localeCompare(left.id) : byTime;
27
+ }
28
+ function attachProviderUsageToItem(db, item, anchors, options = {}) {
29
+ const tokenUsage = readProviderUsageBreakdownForAnchors(db, anchors, options);
30
+ if (tokenUsage.event_count <= 0) {
31
+ return false;
32
+ }
33
+ item.token_usage = tokenUsage;
34
+ item.usage_sources = readProviderUsageSourceSummariesForAnchors(db, anchors, options);
35
+ item.usage_models = readProviderUsageModelSummariesForAnchors(db, anchors, options);
36
+ return true;
37
+ }
38
+ function pushConsumedProcedureUsageAnchors(consumed, sources, anchors) {
39
+ const hasAnchor = anchors.activity_ref !== undefined ||
40
+ anchors.workflow_ref !== undefined ||
41
+ anchors.task_id !== undefined;
42
+ if (!hasAnchor) {
43
+ return;
44
+ }
45
+ for (const source of sources) {
46
+ if (anchors.activity_ref !== undefined) {
47
+ consumed.push({ source, activity_ref: anchors.activity_ref });
48
+ }
49
+ if (anchors.workflow_ref !== undefined) {
50
+ consumed.push({ source, workflow_ref: anchors.workflow_ref });
51
+ }
52
+ if (anchors.task_id !== undefined) {
53
+ consumed.push({ source, task_id: anchors.task_id });
54
+ }
55
+ }
56
+ }
57
+ function isProcedureUsageConsumed(row, consumed) {
58
+ return consumed.some((anchor) => {
59
+ if (anchor.source !== row.source) {
60
+ return false;
61
+ }
62
+ if (anchor.activity_ref !== undefined && anchor.activity_ref !== row.activity_ref) {
63
+ return false;
64
+ }
65
+ if (anchor.workflow_ref !== undefined && anchor.workflow_ref !== row.workflow_ref) {
66
+ return false;
67
+ }
68
+ if (anchor.task_id !== undefined && anchor.task_id !== row.task_id) {
69
+ return false;
70
+ }
71
+ return true;
72
+ });
73
+ }
74
+ function runGit(args, cwd) {
75
+ const result = spawnSync("git", [...args], {
76
+ cwd,
77
+ encoding: "utf8",
78
+ shell: false,
79
+ });
80
+ if (result.status !== 0) {
81
+ return null;
82
+ }
83
+ return (result.stdout ?? "").trim();
84
+ }
85
+ function parseJsonObject(value) {
86
+ try {
87
+ const parsed = JSON.parse(value);
88
+ if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
89
+ return parsed;
90
+ }
91
+ }
92
+ catch {
93
+ return {};
94
+ }
95
+ return {};
96
+ }
97
+ function parseJsonStringArray(value) {
98
+ try {
99
+ const parsed = JSON.parse(value);
100
+ if (!Array.isArray(parsed)) {
101
+ return [];
102
+ }
103
+ return parsed.filter((item) => typeof item === "string" && item.trim() !== "");
104
+ }
105
+ catch {
106
+ return [];
107
+ }
108
+ }
109
+ function readCommitTimelineItems(workspaceRoot) {
110
+ if (workspaceRoot === undefined) {
111
+ return [];
112
+ }
113
+ const output = runGit([
114
+ "log",
115
+ HOST_MAINLINE_BRANCH,
116
+ `--max-count=${COMMIT_TIMELINE_LIMIT}`,
117
+ "--date=iso-strict",
118
+ "--pretty=format:%H%x00%cI%x00%s",
119
+ ], workspaceRoot);
120
+ if (output === null || output.length === 0) {
121
+ return [];
122
+ }
123
+ return output
124
+ .split("\n")
125
+ .map((line) => {
126
+ const [oid, committedAt, subject] = line.split("\0");
127
+ if (oid === undefined || committedAt === undefined || subject === undefined) {
128
+ return null;
129
+ }
130
+ return {
131
+ id: `commit:${oid}`,
132
+ kind: "commit",
133
+ occurred_at: committedAt,
134
+ title: subject.trim() === "" ? "Mainline commit" : subject,
135
+ commit_oid: oid,
136
+ commit_short_oid: oid.slice(0, 12),
137
+ status: "completed",
138
+ };
139
+ })
140
+ .filter((item) => item !== null);
141
+ }
142
+ function runResultStatus(row, result) {
143
+ if (row.result_kind === "needs_human") {
144
+ return "needs_human";
145
+ }
146
+ if (row.result_kind === "failed" || result.outcome === "failed") {
147
+ return "failed";
148
+ }
149
+ return "completed";
150
+ }
151
+ function runResultTitle(row, status) {
152
+ const taskTitle = row.task_title ?? "Task";
153
+ if (status === "needs_human") {
154
+ return `Needs input: ${taskTitle}`;
155
+ }
156
+ if (status === "failed") {
157
+ return `Run failed: ${taskTitle}`;
158
+ }
159
+ return `Run completed: ${taskTitle}`;
160
+ }
161
+ function stringValue(record, key) {
162
+ const value = record[key];
163
+ return typeof value === "string" && value.trim() !== "" ? value : undefined;
164
+ }
165
+ function promotionCommit(result) {
166
+ const promotion = result.promotion;
167
+ if (typeof promotion !== "object" || promotion === null || Array.isArray(promotion)) {
168
+ return undefined;
169
+ }
170
+ return stringValue(promotion, "commit_oid");
171
+ }
172
+ function runResultMeta(result) {
173
+ const meta = [];
174
+ const checks = stringValue(result, "checks");
175
+ const docs = stringValue(result, "docs");
176
+ const promotion = result.promotion;
177
+ if (checks !== undefined) {
178
+ meta.push(`checks: ${checks}`);
179
+ }
180
+ if (docs !== undefined) {
181
+ meta.push(`docs: ${docs}`);
182
+ }
183
+ if (typeof promotion === "object" && promotion !== null && !Array.isArray(promotion)) {
184
+ const promotionStatus = stringValue(promotion, "status");
185
+ if (promotionStatus !== undefined) {
186
+ meta.push(`promotion: ${promotionStatus}`);
187
+ }
188
+ }
189
+ return meta;
190
+ }
191
+ function readTaskTimelineItems(db, consumedProcedureUsageAnchors) {
192
+ if (db === undefined) {
193
+ return [];
194
+ }
195
+ const rows = db
196
+ .prepare(`
197
+ SELECT
198
+ tasks.id,
199
+ tasks.title,
200
+ tasks.summary,
201
+ tasks.status,
202
+ tasks.created_from_workflow_ref,
203
+ tasks.created_at,
204
+ task_modules.name AS module_name
205
+ FROM tasks
206
+ LEFT JOIN task_modules ON task_modules.id = tasks.module_id
207
+ ORDER BY tasks.created_at DESC, tasks.id DESC
208
+ LIMIT ${TASK_TIMELINE_LIMIT}
209
+ `)
210
+ .all();
211
+ return rows.map((row) => {
212
+ const meta = [`status: ${row.status}`];
213
+ if (row.module_name !== null && row.module_name.trim() !== "") {
214
+ meta.unshift(`module: ${row.module_name}`);
215
+ }
216
+ const item = {
217
+ id: `task:${row.id}`,
218
+ kind: "procedure",
219
+ occurred_at: row.created_at,
220
+ title: `Task added: ${row.title}`,
221
+ summary: row.summary,
222
+ task_id: row.id,
223
+ task_title: row.title,
224
+ workflow_ref: row.created_from_workflow_ref,
225
+ status: "completed",
226
+ meta,
227
+ };
228
+ const anchors = { workflow_ref: row.created_from_workflow_ref };
229
+ if (attachProviderUsageToItem(db, item, anchors, {
230
+ sources: TASK_ADDED_USAGE_SOURCES,
231
+ })) {
232
+ pushConsumedProcedureUsageAnchors(consumedProcedureUsageAnchors, TASK_ADDED_USAGE_SOURCES, anchors);
233
+ }
234
+ return item;
235
+ });
236
+ }
237
+ function readRunResultTimelineRows(db) {
238
+ return db
239
+ .prepare(`
240
+ SELECT
241
+ run_results.id,
242
+ run_results.activity_ref,
243
+ run_results.task_id,
244
+ run_results.result_kind,
245
+ run_results.result_json,
246
+ run_results.created_at,
247
+ tasks.title AS task_title
248
+ FROM run_results
249
+ LEFT JOIN tasks ON tasks.id = run_results.task_id
250
+ ORDER BY run_results.created_at DESC, run_results.id DESC
251
+ LIMIT ${RUN_RESULT_TIMELINE_LIMIT}
252
+ `)
253
+ .all();
254
+ }
255
+ function readRunTimelineItems(db, rows) {
256
+ if (db === undefined) {
257
+ return [];
258
+ }
259
+ return rows.map((row) => {
260
+ const result = parseJsonObject(row.result_json);
261
+ const status = runResultStatus(row, result);
262
+ const commitOid = promotionCommit(result);
263
+ const item = {
264
+ id: `run:${row.id}`,
265
+ kind: "run",
266
+ occurred_at: row.created_at,
267
+ title: runResultTitle(row, status),
268
+ task_id: row.task_id,
269
+ activity_ref: row.activity_ref,
270
+ status,
271
+ meta: runResultMeta(result),
272
+ };
273
+ const summary = stringValue(result, "summary");
274
+ if (summary !== undefined) {
275
+ item.summary = summary;
276
+ }
277
+ if (row.task_title !== null && row.task_title.trim() !== "") {
278
+ item.task_title = row.task_title;
279
+ }
280
+ if (commitOid !== undefined) {
281
+ item.commit_oid = commitOid;
282
+ item.commit_short_oid = commitOid.slice(0, 12);
283
+ }
284
+ const tokenUsage = readProviderUsageBreakdownForAnchors(db, {
285
+ activity_ref: row.activity_ref,
286
+ run_result_id: row.id,
287
+ }, {
288
+ sources: RUN_USAGE_SOURCES,
289
+ });
290
+ if (tokenUsage.event_count > 0) {
291
+ item.token_usage = tokenUsage;
292
+ item.usage_sources = readProviderUsageSourceSummariesForAnchors(db, {
293
+ activity_ref: row.activity_ref,
294
+ run_result_id: row.id,
295
+ }, {
296
+ sources: RUN_USAGE_SOURCES,
297
+ });
298
+ item.usage_models = readProviderUsageModelSummariesForAnchors(db, {
299
+ activity_ref: row.activity_ref,
300
+ run_result_id: row.id,
301
+ }, {
302
+ sources: RUN_USAGE_SOURCES,
303
+ });
304
+ }
305
+ return item;
306
+ });
307
+ }
308
+ function checksStatus(value) {
309
+ if (value === "passed") {
310
+ return "completed";
311
+ }
312
+ if (value === "failed") {
313
+ return "failed";
314
+ }
315
+ if (value === "skipped") {
316
+ return "skipped";
317
+ }
318
+ return undefined;
319
+ }
320
+ function readChecksTimelineItems(rows) {
321
+ if (rows.length === 0) {
322
+ return [];
323
+ }
324
+ return rows.flatMap((row) => {
325
+ const result = parseJsonObject(row.result_json);
326
+ const checks = stringValue(result, "checks");
327
+ const status = checksStatus(checks);
328
+ if (checks === undefined || status === undefined) {
329
+ return [];
330
+ }
331
+ const taskTitle = row.task_title ?? "Task";
332
+ const item = {
333
+ id: `checks:${row.id}`,
334
+ kind: "checks",
335
+ occurred_at: row.created_at,
336
+ title: `Checks ${checks}: ${taskTitle}`,
337
+ task_id: row.task_id,
338
+ activity_ref: row.activity_ref,
339
+ status,
340
+ meta: [`run result: ${row.id}`],
341
+ };
342
+ if (row.task_title !== null && row.task_title.trim() !== "") {
343
+ item.task_title = row.task_title;
344
+ }
345
+ const summary = stringValue(result, "skip_reason_summary") ??
346
+ (checks === "skipped" ? stringValue(result, "skip_reason_code") : undefined);
347
+ if (summary !== undefined) {
348
+ item.summary = summary;
349
+ }
350
+ return [item];
351
+ });
352
+ }
353
+ function usageBreakdownFromTimelineRow(row) {
354
+ return {
355
+ input_tokens: row.input_tokens ?? 0,
356
+ cached_input_tokens: row.cached_input_tokens ?? 0,
357
+ output_tokens: row.output_tokens ?? 0,
358
+ reasoning_output_tokens: row.reasoning_output_tokens ?? 0,
359
+ total_tokens: row.total_tokens ?? 0,
360
+ event_count: row.event_count ?? 0,
361
+ };
362
+ }
363
+ function readProcedureUsageTimelineItems(db, consumedProcedureUsageAnchors) {
364
+ if (db === undefined) {
365
+ return [];
366
+ }
367
+ const rows = db
368
+ .prepare(`
369
+ SELECT
370
+ source,
371
+ activity_ref,
372
+ workflow_ref,
373
+ task_id,
374
+ MAX(recorded_at) AS occurred_at,
375
+ COALESCE(SUM(input_tokens), 0) AS input_tokens,
376
+ COALESCE(SUM(cached_input_tokens), 0) AS cached_input_tokens,
377
+ COALESCE(SUM(output_tokens), 0) AS output_tokens,
378
+ COALESCE(SUM(reasoning_output_tokens), 0) AS reasoning_output_tokens,
379
+ COALESCE(SUM(total_tokens), 0) AS total_tokens,
380
+ COUNT(*) AS event_count
381
+ FROM provider_usage_events
382
+ WHERE
383
+ (activity_ref IS NOT NULL OR workflow_ref IS NOT NULL) AND
384
+ source NOT IN ('workspace_write_run', 'follow_up_run', 'pipeline_self_correction')
385
+ GROUP BY source, activity_ref, workflow_ref, task_id
386
+ ORDER BY occurred_at DESC
387
+ LIMIT 50
388
+ `)
389
+ .all();
390
+ return rows
391
+ .filter((row) => !isProcedureUsageConsumed(row, consumedProcedureUsageAnchors))
392
+ .map((row) => {
393
+ const source = providerUsageSourceMetadata(row.source);
394
+ const anchor = row.activity_ref ?? row.workflow_ref ?? row.source;
395
+ const item = {
396
+ id: `procedure:${anchor}:${row.source}`,
397
+ kind: "procedure",
398
+ occurred_at: row.occurred_at,
399
+ title: source.label,
400
+ status: "completed",
401
+ token_usage: usageBreakdownFromTimelineRow(row),
402
+ usage_sources: [
403
+ {
404
+ source: row.source,
405
+ ...source,
406
+ ...usageBreakdownFromTimelineRow(row),
407
+ },
408
+ ],
409
+ meta: [`category: ${source.category}`],
410
+ };
411
+ if (row.activity_ref !== null) {
412
+ item.activity_ref = row.activity_ref;
413
+ }
414
+ if (row.workflow_ref !== null) {
415
+ item.workflow_ref = row.workflow_ref;
416
+ }
417
+ if (row.task_id !== null) {
418
+ item.task_id = row.task_id;
419
+ }
420
+ item.usage_models = readProviderUsageModelSummariesForAnchors(db, {
421
+ ...(row.activity_ref === null ? {} : { activity_ref: row.activity_ref }),
422
+ ...(row.workflow_ref === null ? {} : { workflow_ref: row.workflow_ref }),
423
+ ...(row.task_id === null ? {} : { task_id: row.task_id }),
424
+ }, { sources: [row.source] });
425
+ return item;
426
+ });
427
+ }
428
+ function clarificationOwnerLabel(row) {
429
+ if (row.owner_kind === "task") {
430
+ return row.task_title ?? "Task";
431
+ }
432
+ return "Worklist planning";
433
+ }
434
+ function clarificationSummary(row) {
435
+ return stringValue(parseJsonObject(row.request_payload_json), "summary");
436
+ }
437
+ function clarificationMeta(row, phase) {
438
+ const meta = [
439
+ row.owner_kind === "task" ? "owner: task" : "owner: task_compile",
440
+ `round: ${row.round_index}`,
441
+ ];
442
+ if (phase === "answered") {
443
+ meta.push(`successor: ${row.successor_status}`);
444
+ }
445
+ return meta;
446
+ }
447
+ function assignClarificationAnchors(item, row) {
448
+ if (row.owner_task_id !== null) {
449
+ item.task_id = row.owner_task_id;
450
+ }
451
+ if (row.task_title !== null && row.task_title.trim() !== "") {
452
+ item.task_title = row.task_title;
453
+ }
454
+ if (row.owner_workflow_ref !== null) {
455
+ item.workflow_ref = row.owner_workflow_ref;
456
+ }
457
+ if (row.created_from_activity_ref !== null) {
458
+ item.activity_ref = row.created_from_activity_ref;
459
+ }
460
+ }
461
+ function readClarificationTimelineItems(db) {
462
+ if (db === undefined) {
463
+ return [];
464
+ }
465
+ const rows = db
466
+ .prepare(`
467
+ SELECT
468
+ clarification_rounds.id,
469
+ clarification_rounds.round_index,
470
+ clarification_rounds.status,
471
+ clarification_rounds.request_payload_json,
472
+ clarification_rounds.submitted_at,
473
+ clarification_rounds.successor_status,
474
+ clarification_rounds.created_at,
475
+ clarification_threads.owner_kind,
476
+ clarification_threads.owner_workflow_ref,
477
+ clarification_threads.owner_task_id,
478
+ clarification_threads.created_from_activity_ref,
479
+ tasks.title AS task_title
480
+ FROM clarification_rounds
481
+ JOIN clarification_threads
482
+ ON clarification_threads.id = clarification_rounds.clarification_thread_id
483
+ LEFT JOIN tasks ON tasks.id = clarification_threads.owner_task_id
484
+ ORDER BY clarification_rounds.created_at DESC, clarification_rounds.id DESC
485
+ LIMIT ${CLARIFICATION_TIMELINE_LIMIT}
486
+ `)
487
+ .all();
488
+ return rows.flatMap((row) => {
489
+ const ownerLabel = clarificationOwnerLabel(row);
490
+ const summary = clarificationSummary(row);
491
+ const requested = {
492
+ id: `clarification:${row.id}:requested`,
493
+ kind: "clarification",
494
+ occurred_at: row.created_at,
495
+ title: `Clarification requested: ${ownerLabel}`,
496
+ status: row.status === "writable" ? "needs_human" : "completed",
497
+ meta: clarificationMeta(row, "requested"),
498
+ };
499
+ if (summary !== undefined) {
500
+ requested.summary = summary;
501
+ }
502
+ assignClarificationAnchors(requested, row);
503
+ if (row.submitted_at === null) {
504
+ return [requested];
505
+ }
506
+ const answered = {
507
+ id: `clarification:${row.id}:answered`,
508
+ kind: "clarification",
509
+ occurred_at: row.submitted_at,
510
+ title: `Clarification answered: ${ownerLabel}`,
511
+ summary: "Human input submitted.",
512
+ status: "completed",
513
+ meta: clarificationMeta(row, "answered"),
514
+ };
515
+ assignClarificationAnchors(answered, row);
516
+ return [requested, answered];
517
+ });
518
+ }
519
+ function readRecoveryTimelineItems(db) {
520
+ if (db === undefined) {
521
+ return [];
522
+ }
523
+ const rows = db
524
+ .prepare(`
525
+ SELECT
526
+ id,
527
+ affected_activities_json,
528
+ summary,
529
+ created_at
530
+ FROM recovery_summaries
531
+ ORDER BY created_at DESC, id DESC
532
+ LIMIT ${RECOVERY_TIMELINE_LIMIT}
533
+ `)
534
+ .all();
535
+ return rows.map((row) => {
536
+ const affectedActivities = parseJsonStringArray(row.affected_activities_json);
537
+ const item = {
538
+ id: `recovery:${row.id}`,
539
+ kind: "recovery",
540
+ occurred_at: row.created_at,
541
+ title: "Workspace recovery completed",
542
+ summary: row.summary,
543
+ status: "completed",
544
+ meta: [`affected activities: ${affectedActivities.length}`],
545
+ };
546
+ if (affectedActivities.length === 1) {
547
+ item.activity_ref = affectedActivities[0];
548
+ }
549
+ return item;
550
+ });
551
+ }
552
+ function usageSourcesForDurableEventItem(item) {
553
+ if (item.title === "Docs sync completed" || item.title === "Docs sync failed") {
554
+ return CONTEXT_SYNC_USAGE_SOURCES;
555
+ }
556
+ if (item.title === "Reference summaries refreshed" ||
557
+ item.title === "Reference summary refresh failed") {
558
+ return REFERENCE_SUMMARY_USAGE_SOURCES;
559
+ }
560
+ return [];
561
+ }
562
+ function attachDurableEventUsage(db, item, consumedProcedureUsageAnchors) {
563
+ if (db === undefined) {
564
+ return item;
565
+ }
566
+ const sources = usageSourcesForDurableEventItem(item);
567
+ if (sources.length === 0) {
568
+ return item;
569
+ }
570
+ const anchors = {};
571
+ if (item.activity_ref !== undefined) {
572
+ anchors.activity_ref = item.activity_ref;
573
+ }
574
+ if (item.workflow_ref !== undefined) {
575
+ anchors.workflow_ref = item.workflow_ref;
576
+ }
577
+ if (item.task_id !== undefined) {
578
+ anchors.task_id = item.task_id;
579
+ }
580
+ if (attachProviderUsageToItem(db, item, anchors, { sources })) {
581
+ pushConsumedProcedureUsageAnchors(consumedProcedureUsageAnchors, sources, anchors);
582
+ }
583
+ return item;
584
+ }
585
+ function shouldDisplayDurableEventItem(item) {
586
+ if (item.kind === "promotion") {
587
+ return false;
588
+ }
589
+ return item.title !== "Docs sync completed" && item.title !== "Reference summaries refreshed";
590
+ }
591
+ export function readProjectTimelineProjection(input) {
592
+ const now = input.now ?? (() => new Date());
593
+ const runRows = input.db === undefined ? [] : readRunResultTimelineRows(input.db);
594
+ const consumedProcedureUsageAnchors = [];
595
+ const durableEventItems = input.db === undefined
596
+ ? []
597
+ : readProjectTimelineEventItems(input.db, { limit: DURABLE_EVENT_TIMELINE_LIMIT })
598
+ .filter(shouldDisplayDurableEventItem)
599
+ .map((item) => attachDurableEventUsage(input.db, item, consumedProcedureUsageAnchors));
600
+ const items = [
601
+ ...readTaskTimelineItems(input.db, consumedProcedureUsageAnchors),
602
+ ...readRunTimelineItems(input.db, runRows),
603
+ ...readChecksTimelineItems(runRows),
604
+ ...readProcedureUsageTimelineItems(input.db, consumedProcedureUsageAnchors),
605
+ ...readClarificationTimelineItems(input.db),
606
+ ...readRecoveryTimelineItems(input.db),
607
+ ...durableEventItems,
608
+ ...readCommitTimelineItems(input.workspaceRoot),
609
+ ]
610
+ .filter((item) => item.status !== "skipped")
611
+ .sort(compareTimelineItemsByTimeDesc);
612
+ return {
613
+ generated_at: now().toISOString(),
614
+ usage_overview: input.db === undefined
615
+ ? {
616
+ total_tokens: 0,
617
+ totals: {
618
+ input_tokens: 0,
619
+ cached_input_tokens: 0,
620
+ output_tokens: 0,
621
+ reasoning_output_tokens: 0,
622
+ total_tokens: 0,
623
+ event_count: 0,
624
+ },
625
+ by_source: [],
626
+ by_model: [],
627
+ recent_windows: {
628
+ today: {
629
+ input_tokens: 0,
630
+ cached_input_tokens: 0,
631
+ output_tokens: 0,
632
+ reasoning_output_tokens: 0,
633
+ total_tokens: 0,
634
+ event_count: 0,
635
+ },
636
+ last_7_days: {
637
+ input_tokens: 0,
638
+ cached_input_tokens: 0,
639
+ output_tokens: 0,
640
+ reasoning_output_tokens: 0,
641
+ total_tokens: 0,
642
+ event_count: 0,
643
+ },
644
+ last_30_days: {
645
+ input_tokens: 0,
646
+ cached_input_tokens: 0,
647
+ output_tokens: 0,
648
+ reasoning_output_tokens: 0,
649
+ total_tokens: 0,
650
+ event_count: 0,
651
+ },
652
+ },
653
+ }
654
+ : readProviderUsageProjection(input.db, { now }),
655
+ items: items.slice(0, TIMELINE_LIMIT),
656
+ };
657
+ }
658
+ //# sourceMappingURL=project-timeline-projection.js.map
@@ -0,0 +1,4 @@
1
+ import type { FastifyInstance } from "fastify";
2
+ import type { HostProjectApiRouteOptions } from "./types.js";
3
+ export declare function registerProjectTimelineRoutes(app: FastifyInstance, options: HostProjectApiRouteOptions): void;
4
+ //# sourceMappingURL=project-timeline-routes.d.ts.map
@@ -0,0 +1,23 @@
1
+ import { ProjectTimelineResponseSchema } from "./schemas.js";
2
+ import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
3
+ import { requireHostProjectSession } from "./session-requirements.js";
4
+ import { readProjectTimelineProjection } from "./project-timeline-projection.js";
5
+ export function registerProjectTimelineRoutes(app, options) {
6
+ app.get(`${HOST_PROJECT_API_BASE_PATH}/project-timeline`, {
7
+ schema: {
8
+ response: {
9
+ 200: ProjectTimelineResponseSchema,
10
+ },
11
+ },
12
+ }, (request) => {
13
+ requireHostProjectSession(request, options);
14
+ return readProjectTimelineProjection({
15
+ ...(options.store === undefined ? {} : { db: options.store.db }),
16
+ ...(options.workspaceOps === undefined
17
+ ? {}
18
+ : { workspaceRoot: options.workspaceOps.workspaceRoot }),
19
+ ...(options.now === undefined ? {} : { now: options.now }),
20
+ });
21
+ });
22
+ }
23
+ //# sourceMappingURL=project-timeline-routes.js.map
@@ -0,0 +1,8 @@
1
+ import type { FastifyInstance } from "fastify";
2
+ import type { WorkspaceEventBus } from "../../workspace-events.js";
3
+ import type { HostProjectApiRouteOptions } from "./types.js";
4
+ export declare function registerReadStateRoutes(app: FastifyInstance, { options, workspaceEvents, }: {
5
+ options: HostProjectApiRouteOptions;
6
+ workspaceEvents: WorkspaceEventBus;
7
+ }): void;
8
+ //# sourceMappingURL=read-state-routes.d.ts.map