smithers-orchestrator 0.14.1 → 0.15.0

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