@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,274 @@
1
+ import type { MessageProjection, RunResultProjection, ScratchpadProjection, TaskDetailProjection, WorklistProjection } from "@tutti/shared/schemas/api";
2
+ import type { ClarificationRequestPayload, TaskContractProjection } from "@tutti/shared/schemas/api";
3
+ import type { ProjectDocKey } from "@tutti/shared/schemas/api";
4
+ import type { ActivityRef, ClarificationRoundRef, ClarificationThreadRef, MessageId, TaskId, TaskModuleId, WorkflowInvocationRef } from "@tutti/shared/ids";
5
+ import type { RunLineage } from "@tutti/shared/domain";
6
+ import type { ProjectBriefSnapshot, ProjectBriefSourceDocument } from "../../project-brief/index.js";
7
+ export type ScratchpadRefreshWorkflowInput = {
8
+ project_brief?: ProjectBriefSnapshot;
9
+ previous: {
10
+ topic?: string;
11
+ background?: string;
12
+ consensus?: string[];
13
+ questions?: string[];
14
+ changes?: string[];
15
+ };
16
+ recent_messages: ScratchpadRefreshSourceMessageInput[];
17
+ new_messages: ScratchpadRefreshSourceMessageInput[];
18
+ };
19
+ export type ScratchpadRefreshSourceMessageInput = {
20
+ role: "human" | "tutti";
21
+ author_display_name?: string;
22
+ text: string;
23
+ ref?: string;
24
+ };
25
+ export type ScratchpadRefreshWorkflowContext = {
26
+ workflow_ref: WorkflowInvocationRef;
27
+ activity_ref: ActivityRef;
28
+ };
29
+ export type ProcedureWorkflowRunContext = {
30
+ workflow_ref: WorkflowInvocationRef;
31
+ activity_ref: ActivityRef;
32
+ };
33
+ export type ScratchpadRefreshWorkflowOutput = {
34
+ decision: "ready";
35
+ scratchpad_snapshot: {
36
+ topic: string;
37
+ background_summary: string;
38
+ current_consensus: string[];
39
+ open_questions: string[];
40
+ task_changes: string[];
41
+ };
42
+ } | {
43
+ decision: "needs_human";
44
+ request_payload: {
45
+ summary: string;
46
+ request: string;
47
+ };
48
+ };
49
+ export type TaskCompileProposal = {
50
+ modules: TaskCompileProposalModule[];
51
+ tasks: TaskCompileProposalTask[];
52
+ };
53
+ export type TaskCompileProposalModule = {
54
+ temp_key: string;
55
+ name: string;
56
+ };
57
+ export type TaskCompileProposalTask = {
58
+ module_temp_key?: string;
59
+ existing_module_key?: TaskModuleId;
60
+ title: string;
61
+ summary: string;
62
+ contract: TaskContractProjection;
63
+ };
64
+ export type TaskCompileWorkflowInput = {
65
+ workflow_ref: WorkflowInvocationRef;
66
+ scratchpad: ScratchpadProjection;
67
+ worklist: WorklistProjection;
68
+ clarification?: {
69
+ request_payload: ClarificationRequestPayload;
70
+ messages: MessageProjection[];
71
+ };
72
+ };
73
+ export type TaskCompileWorkflowOutput = {
74
+ decision: "ready";
75
+ proposal: TaskCompileProposal;
76
+ } | {
77
+ decision: "needs_human";
78
+ clarification_request_payload: ClarificationRequestPayload;
79
+ };
80
+ export type TaskCompilePromptInput = {
81
+ scratchpad: {
82
+ topic: string;
83
+ background_summary: string;
84
+ current_consensus: string[];
85
+ open_questions: string[];
86
+ task_changes: string[];
87
+ };
88
+ worklist: {
89
+ modules: Array<{
90
+ id: TaskModuleId;
91
+ name: string;
92
+ summary?: string;
93
+ archived: boolean;
94
+ tasks: Array<{
95
+ title: string;
96
+ summary: string;
97
+ status: WorklistProjection["modules"][number]["tasks"][number]["status"];
98
+ }>;
99
+ }>;
100
+ };
101
+ clarification?: {
102
+ request: {
103
+ title?: string;
104
+ summary: string;
105
+ request: string;
106
+ };
107
+ answer_messages: TaskCompilePromptClarificationMessage[];
108
+ };
109
+ };
110
+ export type TaskCompilePromptClarificationMessage = {
111
+ role: "human" | "tutti";
112
+ author_display_name?: string;
113
+ text: string;
114
+ };
115
+ export type TaskCompileStructuredOutput = {
116
+ result: {
117
+ proposal: TaskCompileStructuredProposal;
118
+ } | {
119
+ clarification_request_payload: ClarificationRequestPayload;
120
+ };
121
+ };
122
+ export type TaskCompileStructuredProposal = {
123
+ modules: TaskCompileProposalModule[];
124
+ tasks: TaskCompileStructuredProposalTask[];
125
+ };
126
+ export type TaskCompileStructuredProposalTask = {
127
+ module_ref: {
128
+ kind: "new";
129
+ key: string;
130
+ } | {
131
+ kind: "existing";
132
+ key: TaskModuleId;
133
+ };
134
+ title: string;
135
+ goal: string;
136
+ scope: string[];
137
+ };
138
+ export type ProjectContextBootstrapWorkflowInput = {
139
+ project_name: string;
140
+ missing_docs?: ProjectContextBootstrapMissingDoc[];
141
+ scratchpad?: {
142
+ topic: string;
143
+ background_summary: string;
144
+ current_consensus: string[];
145
+ open_questions: string[];
146
+ task_changes: string[];
147
+ };
148
+ };
149
+ export type ProjectContextBootstrapMissingDoc = {
150
+ doc_key: ProjectDocKey;
151
+ path: string;
152
+ };
153
+ export type ProjectContextBootstrapDocument = {
154
+ doc_key: ProjectDocKey;
155
+ content: string;
156
+ };
157
+ export type ProjectContextBootstrapWorkflowOutput = {
158
+ documents: ProjectContextBootstrapDocument[];
159
+ };
160
+ export type ContextSyncDocumentUpdate = {
161
+ path: string;
162
+ content: string;
163
+ };
164
+ export type ContextSyncWorkflowTrigger = {
165
+ kind: "manual";
166
+ } | {
167
+ kind: "worklist_all_tasks_completed";
168
+ completed_task_count: number;
169
+ module_count: number;
170
+ };
171
+ export type ContextSyncWorkflowInput = {
172
+ workflow_ref: WorkflowInvocationRef;
173
+ activity_ref: ActivityRef;
174
+ trigger: ContextSyncWorkflowTrigger;
175
+ };
176
+ export type ContextSyncWorkflowOutput = {
177
+ summary: string;
178
+ updates: ContextSyncDocumentUpdate[];
179
+ };
180
+ export type ProjectBriefRefreshWorkflowInput = {
181
+ docs: ProjectBriefSourceDocument[];
182
+ };
183
+ export type ProjectBriefRefreshWorkflowOutput = ProjectBriefSnapshot;
184
+ export type ReferenceFileSummaryWorkflowInput = {
185
+ workflow_ref: WorkflowInvocationRef;
186
+ activity_ref: ActivityRef;
187
+ file: {
188
+ path: string;
189
+ name: string;
190
+ category: "file" | "image";
191
+ size_bytes: number;
192
+ blob_oid: string;
193
+ media_type?: string;
194
+ };
195
+ };
196
+ export type ReferenceFileSummaryWorkflowOutput = {
197
+ decision: "summarized";
198
+ summary: string;
199
+ unavailable_reason: "";
200
+ read_paths: string[];
201
+ } | {
202
+ decision: "unavailable";
203
+ summary: string;
204
+ unavailable_reason: string;
205
+ read_paths: string[];
206
+ };
207
+ export type ReferenceFileSummaryStructuredOutput = {
208
+ result: {
209
+ summarized: {
210
+ summary: string;
211
+ };
212
+ } | {
213
+ unavailable: {
214
+ reason: string;
215
+ };
216
+ };
217
+ };
218
+ export type FollowUpCheckWorkflowInput = {
219
+ workflow_ref: WorkflowInvocationRef;
220
+ task_id: TaskId;
221
+ task_detail: TaskDetailProjection;
222
+ clarification_thread_ref: ClarificationThreadRef;
223
+ clarification_round_ref: ClarificationRoundRef;
224
+ clarification_request_payload: ClarificationRequestPayload;
225
+ submitted_message_refs: MessageId[];
226
+ round_messages: MessageProjection[];
227
+ latest_run_result: RunResultProjection;
228
+ run_lineage: RunLineage;
229
+ };
230
+ export type FollowUpCheckWorkflowOutput = {
231
+ decision: "resume";
232
+ summary: string;
233
+ } | {
234
+ decision: "needs_more_input";
235
+ summary: string;
236
+ clarification_request_payload: ClarificationRequestPayload;
237
+ } | {
238
+ decision: "requires_retasking";
239
+ summary: string;
240
+ };
241
+ export type FollowUpCheckStructuredOutput = {
242
+ result: {
243
+ resume: {
244
+ summary: string;
245
+ };
246
+ } | {
247
+ needs_more_input: ClarificationRequestPayload;
248
+ } | {
249
+ requires_retasking: {
250
+ summary: string;
251
+ };
252
+ };
253
+ };
254
+ export type ProcedureWorkflowRunner = {
255
+ runScratchpadRefresh: (input: ScratchpadRefreshWorkflowInput, context: ScratchpadRefreshWorkflowContext) => Promise<ScratchpadRefreshWorkflowOutput>;
256
+ runTaskCompile: (input: TaskCompileWorkflowInput, context?: ProcedureWorkflowRunContext) => Promise<TaskCompileWorkflowOutput>;
257
+ runProjectContextBootstrap?: (input: ProjectContextBootstrapWorkflowInput, context?: ProcedureWorkflowRunContext) => Promise<ProjectContextBootstrapWorkflowOutput>;
258
+ runContextSync?: (input: ContextSyncWorkflowInput, context?: ProcedureWorkflowRunContext) => Promise<ContextSyncWorkflowOutput>;
259
+ runReferenceFileSummary?: (input: ReferenceFileSummaryWorkflowInput, context?: ProcedureWorkflowRunContext) => Promise<ReferenceFileSummaryWorkflowOutput>;
260
+ runProjectBriefRefresh?: (input: ProjectBriefRefreshWorkflowInput, context?: ProcedureWorkflowRunContext) => Promise<ProjectBriefRefreshWorkflowOutput>;
261
+ runFollowUpCheck?: (input: FollowUpCheckWorkflowInput, context?: ProcedureWorkflowRunContext) => Promise<FollowUpCheckWorkflowOutput>;
262
+ };
263
+ export type ProcedureWorkflowRunnerResolution = {
264
+ kind: "ready";
265
+ runner: ProcedureWorkflowRunner;
266
+ } | {
267
+ kind: "not_configured";
268
+ } | {
269
+ kind: "unavailable";
270
+ reason: "provider_auth_invalid" | "provider_quota_or_billing_required" | "provider_rate_limited" | "provider_model_unavailable" | "provider_network_error";
271
+ retryable: boolean;
272
+ };
273
+ export type ProcedureWorkflowRunnerResolver = () => ProcedureWorkflowRunnerResolution;
274
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1,15 @@
1
+ import type { TaskId } from "@tutti/shared/ids";
2
+ import type { MessageProjection } from "@tutti/shared/schemas/api";
3
+ import type { HostProjectStore } from "../store/index.js";
4
+ import type { WorkspaceEventBus } from "../server-shell/http/workspace-events.js";
5
+ type EmitWorklistFeedbackInput = {
6
+ store: HostProjectStore;
7
+ events: WorkspaceEventBus;
8
+ now: () => Date;
9
+ };
10
+ export declare function emitWorklistCompletedFeedback(input: EmitWorklistFeedbackInput): MessageProjection | null;
11
+ export declare function emitWorklistFailedFeedback(input: EmitWorklistFeedbackInput & {
12
+ taskId: TaskId;
13
+ }): MessageProjection | null;
14
+ export {};
15
+ //# sourceMappingURL=worklist-terminal-feedback.d.ts.map
@@ -0,0 +1,135 @@
1
+ import { createMainChatAgentMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readTaskDetailProjection, readWorklistProjection, } from "../collaboration-state/index.js";
2
+ import { mainChatInvalidates } from "./invalidations.js";
3
+ const BODY_ITEM_LIMIT = 12;
4
+ function summaryText(value, fallback) {
5
+ const trimmed = (value ?? "").trim();
6
+ return trimmed.length === 0 ? fallback : trimmed;
7
+ }
8
+ function readWorklistTaskEntries(store) {
9
+ const worklist = readWorklistProjection(store.db);
10
+ return worklist.modules.flatMap((entry) => entry.tasks.map((task) => ({
11
+ task,
12
+ moduleName: entry.module.name,
13
+ detail: readTaskDetailProjection(store.db, task.id),
14
+ })));
15
+ }
16
+ function feedbackItemFromEntry(entry) {
17
+ const result = entry.detail?.detail.result;
18
+ const item = {
19
+ task_id: entry.task.id,
20
+ title: entry.task.title,
21
+ status: entry.task.status === "done" ? "done" : "failed",
22
+ summary: summaryText(result?.summary, entry.task.summary),
23
+ module_name: entry.moduleName,
24
+ };
25
+ if (result?.latest_run_result_id !== undefined) {
26
+ item.latest_run_result_id = result.latest_run_result_id;
27
+ }
28
+ return item;
29
+ }
30
+ function feedbackCounters(entries) {
31
+ const completed = entries.filter((entry) => entry.task.status === "done").length;
32
+ const failed = entries.filter((entry) => entry.task.status === "failed").length;
33
+ return {
34
+ completed,
35
+ failed,
36
+ remaining: Math.max(0, entries.length - completed - failed),
37
+ };
38
+ }
39
+ function completedFeedbackKey(items) {
40
+ const runResultKeys = items.map((item) => item.latest_run_result_id ?? item.task_id).join(",");
41
+ return `worklist-completed:${items.length}:${runResultKeys}`;
42
+ }
43
+ function failedFeedbackKey(item) {
44
+ return `worklist-failed:${item.task_id}:${item.latest_run_result_id ?? "no-result"}`;
45
+ }
46
+ function hasExistingFeedback(store, feedbackKey) {
47
+ return hasMainChatWorklistFeedbackMessage(store.db, feedbackKey);
48
+ }
49
+ function taskCountLabel(count) {
50
+ return `${count} ${count === 1 ? "task" : "tasks"}`;
51
+ }
52
+ function markdownFallback(feedback) {
53
+ const lines = [feedback.title, ""];
54
+ const visibleItems = feedback.items.slice(0, BODY_ITEM_LIMIT);
55
+ for (const item of visibleItems) {
56
+ const prefix = item.status === "done" ? "- Done" : "- Failed";
57
+ const moduleText = item.module_name === undefined ? "" : ` (${item.module_name})`;
58
+ lines.push(`${prefix}: ${item.title}${moduleText}`);
59
+ if (item.summary.trim().length > 0) {
60
+ lines.push(` ${item.summary}`);
61
+ }
62
+ }
63
+ if (feedback.items.length > visibleItems.length) {
64
+ lines.push(`- ${taskCountLabel(feedback.items.length - visibleItems.length)} hidden.`);
65
+ }
66
+ lines.push("");
67
+ if (feedback.status === "completed") {
68
+ lines.push("All Worklist tasks are done. Review the result or start the next discussion.");
69
+ }
70
+ else {
71
+ lines.push("This run has no reliable continuation path. Review the Worklist task detail and add the next step in chat.");
72
+ }
73
+ return lines.join("\n");
74
+ }
75
+ function publishFeedbackMessage(input, feedback) {
76
+ if (hasExistingFeedback(input.store, feedback.feedback_key)) {
77
+ return null;
78
+ }
79
+ const message = createMainChatAgentMessage(input.store.db, {
80
+ body: markdownFallback(feedback),
81
+ refs: {
82
+ scratchpad_source: "exclude",
83
+ worklist_feedback: feedback,
84
+ },
85
+ now: input.now,
86
+ });
87
+ input.events.publish({
88
+ event_type: "message.created",
89
+ payload: { message },
90
+ invalidates: mainChatInvalidates(),
91
+ });
92
+ return message;
93
+ }
94
+ export function emitWorklistCompletedFeedback(input) {
95
+ const entries = readWorklistTaskEntries(input.store);
96
+ if (entries.length === 0 || entries.some((entry) => entry.task.status !== "done")) {
97
+ return null;
98
+ }
99
+ const alreadyReportedTaskIds = readCompletedWorklistFeedbackTaskIds(input.store.db);
100
+ const newCompletedEntries = entries.filter((entry) => !alreadyReportedTaskIds.has(entry.task.id));
101
+ if (newCompletedEntries.length === 0) {
102
+ return null;
103
+ }
104
+ const items = newCompletedEntries.map(feedbackItemFromEntry);
105
+ const feedback = {
106
+ kind: "worklist_terminal",
107
+ status: "completed",
108
+ reason: "all_tasks_done",
109
+ title: `Completed ${taskCountLabel(items.length)}`,
110
+ feedback_key: completedFeedbackKey(items),
111
+ counters: feedbackCounters(newCompletedEntries),
112
+ items,
113
+ };
114
+ return publishFeedbackMessage(input, feedback);
115
+ }
116
+ export function emitWorklistFailedFeedback(input) {
117
+ const entries = readWorklistTaskEntries(input.store);
118
+ const failedEntry = entries.find((entry) => entry.task.id === input.taskId);
119
+ if (failedEntry === undefined || failedEntry.task.status !== "failed") {
120
+ return null;
121
+ }
122
+ const item = feedbackItemFromEntry(failedEntry);
123
+ const feedback = {
124
+ kind: "worklist_terminal",
125
+ status: "failed",
126
+ reason: "run_failed",
127
+ title: `"${failedEntry.task.title}" failed`,
128
+ feedback_key: failedFeedbackKey(item),
129
+ counters: feedbackCounters(entries),
130
+ items: [item],
131
+ primary_task_id: input.taskId,
132
+ };
133
+ return publishFeedbackMessage(input, feedback);
134
+ }
135
+ //# sourceMappingURL=worklist-terminal-feedback.js.map
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.d.ts.map
package/dist/index.js ADDED
@@ -0,0 +1,32 @@
1
+ import { serializeRuntimeErrorLog, serializeRuntimeLogLine } from "@tutti/shared/utils";
2
+ import { createHostServer } from "./server-shell/http/create-server.js";
3
+ const DEFAULT_HOST = "127.0.0.1";
4
+ const DEFAULT_PORT = 4371;
5
+ function readPort(value, fallback) {
6
+ if (value === undefined || value.trim() === "") {
7
+ return fallback;
8
+ }
9
+ const parsed = Number(value);
10
+ if (!Number.isInteger(parsed) || parsed <= 0 || parsed > 65535) {
11
+ throw new Error(`Invalid TUTTI_HOST_ENDPOINT_PORT: ${value}`);
12
+ }
13
+ return parsed;
14
+ }
15
+ try {
16
+ const app = createHostServer();
17
+ const host = process.env.TUTTI_HOST_ENDPOINT_HOST ?? DEFAULT_HOST;
18
+ const port = readPort(process.env.TUTTI_HOST_ENDPOINT_PORT, DEFAULT_PORT);
19
+ await app.listen({ host, port });
20
+ }
21
+ catch (error) {
22
+ process.stderr.write(`${serializeRuntimeLogLine({
23
+ level: "error",
24
+ service: "tutti-host",
25
+ component: "runtime",
26
+ message: "Host server startup failed",
27
+ fields: { err: serializeRuntimeErrorLog(error) },
28
+ now: () => new Date(),
29
+ })}\n`);
30
+ process.exitCode = 1;
31
+ }
32
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,56 @@
1
+ import { type ActivityRef, type WorkflowInvocationRef } from "@tutti/shared/ids";
2
+ import type { ResultAnchor, WorkflowKind } from "@tutti/shared/domain";
3
+ import type { ActivityProjection, ExecutionStatusProjection, ProcedureLane } from "@tutti/shared/schemas/api";
4
+ export type ProcedureTerminalConclusion = {
5
+ kind: "completed" | "failed" | "needs_human";
6
+ summary: string;
7
+ result_anchor?: ResultAnchor;
8
+ };
9
+ export type ProcedureExecutionContext = {
10
+ activity_ref: ActivityRef;
11
+ workflow_ref: WorkflowInvocationRef;
12
+ workflow_kind: WorkflowKind;
13
+ lane: ProcedureLane;
14
+ };
15
+ export type StartProcedureOptions = {
16
+ workflow_ref: WorkflowInvocationRef;
17
+ workflow_kind: WorkflowKind;
18
+ lane?: ProcedureLane;
19
+ title: string;
20
+ summary: string;
21
+ now?: () => Date;
22
+ execute: (context: ProcedureExecutionContext) => Promise<ProcedureTerminalConclusion>;
23
+ onError?: (input: {
24
+ context: ProcedureExecutionContext;
25
+ error: unknown;
26
+ }) => void;
27
+ onTransition?: (state: ProcedureEngineState) => void;
28
+ };
29
+ export type StartProcedureResult = {
30
+ kind: "accepted";
31
+ activity: ActivityProjection;
32
+ } | {
33
+ kind: "already_running";
34
+ activity_ref: ActivityRef;
35
+ };
36
+ export type ProcedureEngineState = {
37
+ activity: ActivityProjection;
38
+ execution_status: ExecutionStatusProjection;
39
+ };
40
+ export declare class ProcedureEngine {
41
+ private readonly activeByLane;
42
+ private lastConclusion;
43
+ private readonly now;
44
+ constructor(options?: {
45
+ now?: () => Date;
46
+ });
47
+ startProcedure(options: StartProcedureOptions): StartProcedureResult;
48
+ getActiveProcedures(): ActivityProjection[];
49
+ getExecutionStatus(): ExecutionStatusProjection;
50
+ waitForIdle(): Promise<void>;
51
+ private stateForActivity;
52
+ private finishActive;
53
+ private primaryActiveProcedure;
54
+ private orderedActiveProcedures;
55
+ }
56
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,163 @@
1
+ import { createActivityRef } from "@tutti/shared/ids";
2
+ const DEFAULT_PROCEDURE_LANE = "foreground";
3
+ const PROCEDURE_LANE_ORDER = ["foreground", "scratchpad_background"];
4
+ export class ProcedureEngine {
5
+ activeByLane = new Map();
6
+ lastConclusion = null;
7
+ now;
8
+ constructor(options = {}) {
9
+ this.now = options.now ?? (() => new Date());
10
+ }
11
+ startProcedure(options) {
12
+ const lane = options.lane ?? DEFAULT_PROCEDURE_LANE;
13
+ const activeInLane = this.activeByLane.get(lane);
14
+ if (activeInLane !== undefined) {
15
+ return {
16
+ kind: "already_running",
17
+ activity_ref: activeInLane.activity.activity_ref,
18
+ };
19
+ }
20
+ const startedAt = (options.now ?? this.now)().toISOString();
21
+ const activityRef = createActivityRef();
22
+ const activity = {
23
+ activity_ref: activityRef,
24
+ activity_kind: "procedure",
25
+ status: "running",
26
+ title: options.title,
27
+ summary: options.summary,
28
+ workflow_ref: options.workflow_ref,
29
+ workflow_kind: options.workflow_kind,
30
+ lane,
31
+ started_at: startedAt,
32
+ result_anchor: {
33
+ kind: "workflow",
34
+ workflow_ref: options.workflow_ref,
35
+ },
36
+ };
37
+ const context = {
38
+ activity_ref: activityRef,
39
+ workflow_ref: options.workflow_ref,
40
+ workflow_kind: options.workflow_kind,
41
+ lane,
42
+ };
43
+ const run = async () => {
44
+ try {
45
+ const conclusion = await options.execute(context);
46
+ this.finishActive(activityRef, lane, conclusion, options.onTransition);
47
+ }
48
+ catch (error) {
49
+ try {
50
+ options.onError?.({ context, error });
51
+ }
52
+ catch {
53
+ // Logging hooks must not change Procedure terminal semantics.
54
+ }
55
+ this.finishActive(activityRef, lane, {
56
+ kind: "failed",
57
+ summary: error instanceof Error ? error.message : "Procedure failed",
58
+ }, options.onTransition);
59
+ }
60
+ };
61
+ const promise = Promise.resolve().then(run);
62
+ this.activeByLane.set(lane, { activity, lane, promise });
63
+ options.onTransition?.(this.stateForActivity(activity));
64
+ return {
65
+ kind: "accepted",
66
+ activity,
67
+ };
68
+ }
69
+ getActiveProcedures() {
70
+ return this.orderedActiveProcedures().map((active) => active.activity);
71
+ }
72
+ getExecutionStatus() {
73
+ const active = this.primaryActiveProcedure();
74
+ if (active !== null) {
75
+ const activeActivities = this.orderedActiveProcedures().map((entry) => executionActivityFromProcedure(entry.activity));
76
+ return {
77
+ status: "running",
78
+ summary: active.activity.summary,
79
+ active_activity: executionActivityFromProcedure(active.activity),
80
+ active_activities: activeActivities,
81
+ updated_at: this.now().toISOString(),
82
+ };
83
+ }
84
+ const idle = {
85
+ status: "idle",
86
+ summary: "Idle",
87
+ updated_at: this.now().toISOString(),
88
+ };
89
+ if (this.lastConclusion !== null) {
90
+ idle.last_conclusion = this.lastConclusion;
91
+ }
92
+ return idle;
93
+ }
94
+ async waitForIdle() {
95
+ while (this.activeByLane.size > 0) {
96
+ await Promise.all(this.orderedActiveProcedures().map((active) => active.promise));
97
+ }
98
+ }
99
+ stateForActivity(activity) {
100
+ return {
101
+ activity,
102
+ execution_status: this.getExecutionStatus(),
103
+ };
104
+ }
105
+ finishActive(activityRef, lane, conclusion, onTransition) {
106
+ const active = this.activeByLane.get(lane);
107
+ if (active === undefined || active.activity.activity_ref !== activityRef) {
108
+ return;
109
+ }
110
+ const endedAt = this.now().toISOString();
111
+ const status = conclusion.kind === "completed"
112
+ ? "finished"
113
+ : conclusion.kind === "needs_human"
114
+ ? "needs_human"
115
+ : "failed";
116
+ active.activity.status = status;
117
+ active.activity.summary = conclusion.summary;
118
+ active.activity.ended_at = endedAt;
119
+ if (conclusion.result_anchor !== undefined) {
120
+ active.activity.result_anchor = conclusion.result_anchor;
121
+ }
122
+ this.lastConclusion = {
123
+ kind: conclusion.kind,
124
+ summary: conclusion.summary,
125
+ activity_ref: activityRef,
126
+ ...(active.activity.workflow_ref === undefined
127
+ ? {}
128
+ : { workflow_ref: active.activity.workflow_ref }),
129
+ occurred_at: endedAt,
130
+ };
131
+ this.activeByLane.delete(lane);
132
+ onTransition?.({
133
+ activity: active.activity,
134
+ execution_status: this.getExecutionStatus(),
135
+ });
136
+ }
137
+ primaryActiveProcedure() {
138
+ for (const lane of PROCEDURE_LANE_ORDER) {
139
+ const active = this.activeByLane.get(lane);
140
+ if (active !== undefined) {
141
+ return active;
142
+ }
143
+ }
144
+ return null;
145
+ }
146
+ orderedActiveProcedures() {
147
+ return PROCEDURE_LANE_ORDER.flatMap((lane) => {
148
+ const active = this.activeByLane.get(lane);
149
+ return active === undefined ? [] : [active];
150
+ });
151
+ }
152
+ }
153
+ function executionActivityFromProcedure(activity) {
154
+ return {
155
+ activity_ref: activity.activity_ref,
156
+ activity_kind: "procedure",
157
+ ...(activity.workflow_ref === undefined ? {} : { workflow_ref: activity.workflow_ref }),
158
+ ...(activity.workflow_kind === undefined ? {} : { workflow_kind: activity.workflow_kind }),
159
+ ...(activity.lane === undefined ? {} : { lane: activity.lane }),
160
+ ...(activity.started_at === undefined ? {} : { started_at: activity.started_at }),
161
+ };
162
+ }
163
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,4 @@
1
+ export { projectBriefSourceFingerprint, projectBriefSourceFingerprints, readProjectBriefSourceDocuments, } from "./source.js";
2
+ export { readProjectBriefProjection, upsertProjectBriefProjection, } from "./repository.js";
3
+ export type { ProjectBriefProjection, ProjectBriefRecord, ProjectBriefSnapshot, ProjectBriefSourceDocument, ProjectBriefSourceDocumentFingerprint, ProjectBriefSourceDocumentStatus, UpsertProjectBriefInput, } from "./types.js";
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,3 @@
1
+ export { projectBriefSourceFingerprint, projectBriefSourceFingerprints, readProjectBriefSourceDocuments, } from "./source.js";
2
+ export { readProjectBriefProjection, upsertProjectBriefProjection, } from "./repository.js";
3
+ //# sourceMappingURL=index.js.map