@orkestrel/workflow 0.0.1 → 0.0.3

package/README.md

@@ -2,10 +2,13 @@
 
 A typed workflow engine for the `@orkestrel` line — a serializable
 `Workflow → Phase → Task` tree that a UI or an LLM authors as pure JSON, and
-a thin `WorkflowRunner` executes by COMPOSING the shipped substrate (a
+a PURE `WorkflowRunner` engine executes by COMPOSING the shipped substrate (a
 per-phase `Runner`, `Abort`, `Timeout`, `Budget`, and a cooperative
 cross-environment `Scheduler`) rather than re-implementing its own
-concurrency / retry / abort machinery.
+concurrency / retry / abort machinery. Each task's `run` is a plain
+behavior-name string resolved once into a `handler`; wiring a task to a tool
+or an agent is an opt-in adapter shipped by the separate `@orkestrel/tool`
+package, composed into the caller's own `functions` registry.
 
 ## Install
 
@@ -23,13 +26,21 @@ npm install @orkestrel/workflow
 ## Status
 
 Pre-release (`0.0.1`): the definition contract, the live entity tree, the
-thin runner (with the `function` / `tool` / `agent` task forms and the
-depth/cycle-bounded agent-native recursion), the durable `WorkflowStore`
+pure-engine runner (a `run`-string / `handler` model — the opt-in tool/agent
+adapters and the depth/cycle-bounded agent-native recursion now ship in the
+separate `@orkestrel/tool` package), the durable `WorkflowStore`
 (in-memory + driver-pluggable), and the cooperative `Scheduler` (the
 cross-environment default plus the browser and Node environment backends)
 are all implemented and tested, but the public API is still unstable and
-may change without notice. See [guides/src/workflow.md](./guides/src/workflow.md)
-for the full documented surface.
+may change without notice. The live tree also supports runtime-only
+`pause` / `resume` / `wait` (at both the workflow and phase tiers) plus a
+gated `add` / `remove` / `move` / `update` structural-mutation API
+(pending-suffix positions, append-only on a running phase), a hard
+`destroy` teardown alongside the runner's existing graceful `stop`, and a
+`WorkflowRunnerInterface.execute` overload that drives an already-built,
+caller-owned live tree instead of only building one from a definition. See
+[guides/src/workflow.md](./guides/src/workflow.md) for the full documented
+surface.
 
 ## Package