smithers-orchestrator 0.14.1 → 0.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (230) hide show
  1. package/README.md +6 -5
  2. package/docs/api/effect.mdx +933 -0
  3. package/docs/cli/overview.mdx +927 -141
  4. package/docs/cli/quickstart.mdx +125 -0
  5. package/docs/components/approval-gate.mdx +2 -1
  6. package/docs/components/approval.mdx +100 -5
  7. package/docs/components/branch.mdx +4 -4
  8. package/docs/components/check-suite.mdx +33 -0
  9. package/docs/components/continue-as-new.mdx +163 -0
  10. package/docs/components/drift-detector.mdx +1 -1
  11. package/docs/components/human-task.mdx +35 -6
  12. package/docs/components/kanban.mdx +21 -0
  13. package/docs/components/loop.mdx +36 -6
  14. package/docs/components/panel.mdx +23 -0
  15. package/docs/components/parallel.mdx +4 -4
  16. package/docs/components/saga.mdx +2 -2
  17. package/docs/components/sandbox.mdx +325 -0
  18. package/docs/components/sequence.mdx +3 -3
  19. package/docs/components/signal.mdx +65 -0
  20. package/docs/components/task.mdx +74 -8
  21. package/docs/components/timer.mdx +135 -0
  22. package/docs/components/wait-for-event.mdx +41 -0
  23. package/docs/components/workflow.mdx +7 -7
  24. package/docs/components/worktree.mdx +4 -4
  25. package/docs/concepts/agents-and-tools.mdx +10 -8
  26. package/docs/concepts/approvals.mdx +9 -7
  27. package/docs/concepts/control-flow.mdx +11 -8
  28. package/docs/concepts/data-model.mdx +200 -9
  29. package/docs/concepts/evals.mdx +147 -10
  30. package/docs/concepts/execution-model.mdx +18 -14
  31. package/docs/concepts/human-in-the-loop.mdx +97 -4
  32. package/docs/concepts/memory.mdx +29 -2
  33. package/docs/concepts/openapi-tools.mdx +109 -1
  34. package/docs/concepts/rag.mdx +104 -6
  35. package/docs/concepts/reactivity.mdx +7 -6
  36. package/docs/concepts/suspend-and-resume.mdx +7 -5
  37. package/docs/concepts/time-travel.mdx +118 -5
  38. package/docs/concepts/voice.mdx +189 -0
  39. package/docs/concepts/workflow-state.mdx +46 -0
  40. package/docs/concepts/workflows-overview.mdx +24 -22
  41. package/docs/docs.json +235 -266
  42. package/docs/examples/approval-gate.mdx +8 -7
  43. package/docs/examples/generate-llms-txt.mdx +1 -1
  44. package/docs/examples/hello-world.mdx +2 -1
  45. package/docs/examples/loop.mdx +2 -1
  46. package/docs/examples/multi-agent-review.mdx +3 -1
  47. package/docs/examples/tools-agent.mdx +4 -1
  48. package/docs/examples/workflow-approval.mdx +12 -8
  49. package/docs/examples/workflow-hello.mdx +3 -2
  50. package/docs/examples/workflow-quickstart.mdx +26 -31
  51. package/docs/guides/alerting.mdx +110 -0
  52. package/docs/guides/best-practices.mdx +53 -11
  53. package/docs/guides/debugging.mdx +43 -15
  54. package/docs/guides/error-handling.mdx +83 -3
  55. package/docs/guides/hot-reload.mdx +1 -1
  56. package/docs/guides/memory-quickstart.mdx +16 -1
  57. package/docs/guides/monitoring-logs.mdx +12 -4
  58. package/docs/guides/patterns.mdx +11 -10
  59. package/docs/guides/project-structure.mdx +3 -0
  60. package/docs/guides/review-loop.mdx +11 -9
  61. package/docs/guides/structured-output.mdx +2 -2
  62. package/docs/guides/third-party-hooks.mdx +302 -0
  63. package/docs/guides/troubleshooting.mdx +1 -1
  64. package/docs/guides/tutorial-workflow.mdx +26 -16
  65. package/docs/guides/vcs.mdx +80 -10
  66. package/docs/index.mdx +42 -355
  67. package/docs/installation.mdx +28 -11
  68. package/docs/integrations/cli-agents.mdx +357 -7
  69. package/docs/integrations/common-tools.mdx +244 -0
  70. package/docs/integrations/external-workflows.mdx +381 -0
  71. package/docs/integrations/gateway.mdx +824 -0
  72. package/docs/integrations/github-bot.mdx +445 -0
  73. package/docs/integrations/ide.mdx +519 -0
  74. package/docs/integrations/mcp-server.mdx +709 -0
  75. package/docs/integrations/pi-extension.mdx +248 -0
  76. package/docs/integrations/sdk-agents.mdx +7 -3
  77. package/docs/integrations/server.mdx +105 -5
  78. package/docs/integrations/tools.mdx +100 -2
  79. package/docs/introduction.mdx +54 -31
  80. package/docs/jsx/installation.mdx +25 -29
  81. package/docs/jsx/overview.mdx +13 -13
  82. package/docs/jsx/quickstart.mdx +20 -8
  83. package/docs/llms-full.txt +30657 -0
  84. package/docs/llms.txt +12 -2
  85. package/docs/quickstart.mdx +39 -15
  86. package/docs/reference/errors.mdx +4 -24
  87. package/docs/reference/package-configuration.mdx +158 -0
  88. package/docs/reference/types.mdx +83 -9
  89. package/docs/runtime/events.mdx +785 -36
  90. package/docs/runtime/run-workflow.mdx +9 -2
  91. package/observability/dashboards/smithers.json +223 -0
  92. package/package.json +21 -13
  93. package/src/AgentLike.ts +4 -0
  94. package/src/RunAuthContext.ts +6 -0
  95. package/src/RunOptions.ts +10 -0
  96. package/src/SmithersCtx.ts +9 -1
  97. package/src/SmithersEvent.ts +48 -0
  98. package/src/SmithersWorkflowOptions.ts +41 -0
  99. package/src/TaskDescriptor.ts +17 -1
  100. package/src/agents/BaseCliAgent.ts +547 -207
  101. package/src/agents/ClaudeCodeAgent.ts +56 -0
  102. package/src/agents/CodexAgent.ts +51 -45
  103. package/src/agents/GeminiAgent.ts +43 -1
  104. package/src/agents/KimiAgent.ts +37 -0
  105. package/src/agents/PiAgent.ts +41 -1
  106. package/src/agents/capability-registry.ts +138 -0
  107. package/src/agents/cli-capabilities.ts +203 -0
  108. package/src/agents/index.ts +7 -0
  109. package/src/agents/schema.ts +71 -0
  110. package/src/cli/agent-contract.ts +421 -0
  111. package/src/cli/ask.ts +457 -95
  112. package/src/cli/event-categories.ts +5 -0
  113. package/src/cli/format.ts +6 -0
  114. package/src/cli/hijack-session.ts +4 -1
  115. package/src/cli/index.ts +915 -12
  116. package/src/cli/resume-detached.ts +22 -2
  117. package/src/cli/scheduler.ts +162 -54
  118. package/src/cli/supervisor.ts +20 -33
  119. package/src/cli/why-diagnosis.ts +38 -8
  120. package/src/cli/workflow-pack.ts +471 -206
  121. package/src/components/Approval.ts +158 -10
  122. package/src/components/ApprovalGate.ts +1 -1
  123. package/src/components/HumanTask.ts +32 -14
  124. package/src/components/Kanban.ts +31 -22
  125. package/src/components/Poller.ts +23 -8
  126. package/src/components/Ralph.ts +1 -1
  127. package/src/components/Runbook.ts +1 -1
  128. package/src/components/Saga.ts +15 -4
  129. package/src/components/Signal.ts +70 -0
  130. package/src/components/Subflow.ts +3 -2
  131. package/src/components/SuperSmithers.ts +1 -1
  132. package/src/components/Task.ts +100 -13
  133. package/src/components/Timer.ts +1 -1
  134. package/src/components/TryCatchFinally.ts +16 -13
  135. package/src/components/WaitForEvent.ts +4 -1
  136. package/src/components/control-flow-utils.ts +40 -0
  137. package/src/components/index.ts +10 -0
  138. package/src/context.ts +19 -1
  139. package/src/create.ts +166 -23
  140. package/src/db/adapter.ts +1602 -523
  141. package/src/db/ensure.ts +5 -316
  142. package/src/db/internal-schema.ts +51 -0
  143. package/src/db/output.ts +44 -25
  144. package/src/db/write-retry.ts +77 -42
  145. package/src/dom/extract.ts +92 -23
  146. package/src/dom/renderer.ts +9 -3
  147. package/src/effect/activity-bridge.ts +158 -0
  148. package/src/effect/bridge-utils.ts +40 -0
  149. package/src/effect/builder.ts +18 -1480
  150. package/src/effect/compute-task-bridge.ts +897 -0
  151. package/src/effect/deferred-bridge.ts +72 -0
  152. package/src/effect/deferred-state-bridge.ts +1604 -0
  153. package/src/effect/diff-bundle.ts +309 -0
  154. package/src/effect/durable-deferred-bridge.ts +358 -0
  155. package/src/effect/entity-worker.ts +172 -0
  156. package/src/effect/http-runner.ts +114 -0
  157. package/src/effect/logging.ts +21 -3
  158. package/src/effect/metrics.ts +845 -18
  159. package/src/effect/rpc-schema.ts +130 -0
  160. package/src/effect/runtime.ts +37 -2
  161. package/src/effect/sandbox-entity.ts +215 -0
  162. package/src/effect/single-runner.ts +206 -0
  163. package/src/effect/socket-runner.ts +82 -0
  164. package/src/effect/sql-message-storage.ts +813 -0
  165. package/src/effect/static-task-bridge.ts +394 -0
  166. package/src/effect/versioning.ts +128 -0
  167. package/src/effect/workflow-bridge.ts +399 -0
  168. package/src/effect/workflow-make-bridge.ts +301 -0
  169. package/src/engine/approvals.ts +113 -15
  170. package/src/engine/child-workflow.ts +48 -0
  171. package/src/engine/index.ts +1889 -981
  172. package/src/engine/scheduler.ts +261 -52
  173. package/src/engine/signals.ts +106 -0
  174. package/src/errors/tagged.ts +290 -0
  175. package/src/events.ts +94 -41
  176. package/src/examples-entry.ts +1 -0
  177. package/src/external/create-external-smithers.ts +162 -0
  178. package/src/external/index.ts +6 -0
  179. package/src/external/json-schema-to-zod.ts +199 -0
  180. package/src/external/python-subprocess.ts +148 -0
  181. package/src/external/python.ts +66 -0
  182. package/src/gateway/index.ts +3134 -0
  183. package/src/human-requests.ts +120 -0
  184. package/src/ide/SmithersIdeService.ts +591 -0
  185. package/src/ide/index.ts +60 -0
  186. package/src/ide/tools.ts +101 -0
  187. package/src/index.ts +69 -6
  188. package/src/mcp/semantic-server.ts +52 -0
  189. package/src/mcp/semantic-tools.ts +1410 -0
  190. package/src/memory/service.ts +42 -30
  191. package/src/memory/store.ts +29 -3
  192. package/src/observability/correlation.ts +130 -0
  193. package/src/observability/index.ts +232 -105
  194. package/src/openapi/schema-converter.ts +2 -2
  195. package/src/pi-plugin/extension.ts +409 -187
  196. package/src/rag/pipeline.ts +14 -28
  197. package/src/rag/vector-store.ts +39 -4
  198. package/src/retry-task.ts +263 -0
  199. package/src/runtime-owner.ts +30 -0
  200. package/src/sandbox/bundle.ts +106 -0
  201. package/src/sandbox/execute.ts +3 -3
  202. package/src/sandbox/transport.ts +21 -144
  203. package/src/server/index.ts +243 -27
  204. package/src/server/serve.ts +85 -4
  205. package/src/time-travel/fork.ts +40 -0
  206. package/src/timetravel.ts +297 -0
  207. package/src/tools/bash.ts +61 -0
  208. package/src/tools/context.ts +11 -0
  209. package/src/tools/defineTool.ts +138 -0
  210. package/src/tools/index.ts +1 -0
  211. package/src/tools/logToolCall.ts +54 -30
  212. package/src/unwrapZodType.ts +0 -13
  213. package/src/utils/errors.ts +172 -99
  214. package/src/utils/input-bounds.ts +333 -0
  215. package/src/utils/retry.ts +35 -18
  216. package/src/voice/effect.ts +71 -1
  217. package/src/voice/realtime.ts +456 -91
  218. package/src/zod-to-example.ts +15 -15
  219. package/src/zodToCreateTableSQL.ts +12 -21
  220. package/src/zodToTable.ts +12 -21
  221. package/docs/api/installation.mdx +0 -79
  222. package/docs/api/overview.mdx +0 -66
  223. package/docs/api/quickstart.mdx +0 -97
  224. package/docs/integrations/baml.mdx +0 -300
  225. package/src/baml-plugin.ts +0 -317
  226. package/src/cli/repo.ts +0 -565
  227. package/src/cli/templates/ai-review.tsx.template +0 -773
  228. package/src/cli/templates/lint-autofix.tsx.template +0 -1019
  229. package/src/cli/templates/pr-description.tsx.template +0 -743
  230. package/src/zodV3Compat.ts +0 -71
package/README.md CHANGED
@@ -221,10 +221,11 @@ Because the workflow re-renders after each task, you can branch with normal JSX:
221
221
  ## CLI
222
222
 
223
223
  ```bash
224
- smithers run workflow.tsx --input '{"description": "Fix bug"}'
225
- smithers resume workflow.tsx --run-id abc123
226
- smithers list workflow.tsx
227
- smithers approve workflow.tsx --run-id abc123 --node-id review
224
+ smithers up workflow.tsx --input '{"description": "Fix bug"}'
225
+ smithers up workflow.tsx --run-id abc123 --resume true
226
+ smithers ps
227
+ smithers workflow list
228
+ smithers approve abc123 --node review
228
229
  ```
229
230
 
230
231
  ## Hot Module Replacement
@@ -232,7 +233,7 @@ smithers approve workflow.tsx --run-id abc123 --node-id review
232
233
  Edit your workflow files while a run is executing. Smithers watches your source tree and hot-reloads changes on save — prompts, config, agent settings, and component structure — without restarting the process or losing run state.
233
234
 
234
235
  ```bash
235
- smithers run workflow.tsx --hot
236
+ smithers up workflow.tsx --hot
236
237
  ```
237
238
 
238
239
  In-flight tasks continue with their original code. Only newly scheduled tasks pick up the changes.