@united-workforce/cli 0.6.1 → 0.8.1

package/README.md

@@ -4,7 +4,7 @@
 
 ## Overview
 
-Layer 4 entry point for the workflow engine. The `uwf` binary orchestrates one step per invocation: load thread head from `threads.yaml`, run the moderator, spawn the configured agent CLI, run extract, append a CAS step node, and update the head pointer (or archive when `$END`).
+Layer 4 entry point for the workflow engine. The `uwf` binary orchestrates one step per invocation: load the thread head, run the moderator, dispatch the role to the configured agent **over the Sumeru HTTP API via the broker** (`broker.send()`), run frontmatter extraction on the agent's reply, append a CAS step node, and update the head pointer (or archive when `$END`). Agents are no longer spawned as CLI subprocesses — `~/.uwf/config.yaml` declares an `agents` map keyed by alias, where each entry resolves to a `{host, gateway}` Sumeru endpoint that the broker contacts directly.
 
 ### Four-Layer Architecture
 
@@ -16,11 +16,11 @@ workflow → thread → step → turn
 - **Workflow** (layer 1): YAML template with roles and routing graph
 - **Thread** (layer 2): Single workflow execution instance
 - **Step** (layer 3): One moderator→agent→extract cycle
-- **Turn** (layer 4): Agent-internal interactions (use `step show` or CAS to inspect)
+- **Turn** (layer 4): Agent-internal interactions (use `step turns` to see the whole-thread turn panorama — every step's turns, with the in-flight step marked 进行中 — or `step show` / CAS to inspect)
 
 This package has no library `src/index.ts` — it is consumed as a CLI binary only.
 
-**Dependencies:** `@ocas/core`, `@ocas/fs`, `@united-workforce/util-agent`, `@united-workforce/protocol`, `@united-workforce/util`, `commander`, `dotenv`, `mustache`, `yaml`
+**Dependencies:** `@ocas/core`, `@ocas/cli-kit`, `@ocas/fs`, `@united-workforce/util-agent`, `@united-workforce/protocol`, `@united-workforce/util`, `dotenv`, `mustache`, `yaml`
 
 ## Installation
 
@@ -63,13 +63,35 @@ The `json` and `yaml` envelopes carry the schema hash on the `type` field so con
 | `uwf thread start <workflow> -p <prompt>` | Create a thread without executing |
 | `uwf thread exec <thread-id> [--agent <cmd>] [-c <count>] [--background]` | Execute one or more moderator→agent→extract cycles |
 | `uwf thread show <thread-id>` | Show thread head pointer |
-| `uwf thread list [--status <status>] [--all] [--after <date>] [--before <date>] [--skip <n>] [--take <n>]` | List threads (defaults to active: idle + running). Use `--all` to include end/cancelled/suspended, or `--status` to filter explicitly (idle, running, suspended, end, cancelled, active, or comma-separated). Supports time range and pagination. |
+| `uwf thread list [--status <status>] [--all] [--after <date>] [--before <date>] [--limit <n>] [--offset <m>]` | List threads (defaults to active: idle + running). Use `--all` to include end/cancelled/suspended, or `--status` to filter explicitly (idle, running, suspended, end, cancelled, active, or comma-separated). Supports time range and pagination (`--limit`/`--offset`; `--take`/`--skip` are accepted as aliases). |
 | `uwf thread read <thread-id> [--quota N] [--before <hash>] [--start]` | Render thread as readable markdown |
 
 `thread read`, `step list`, and `step show` work on both active and ended threads.
 | `uwf thread stop <thread-id>` | Stop background execution (keep thread active) |
+| `uwf thread resume <thread-id> [-p <text>] [--agent <cmd>]` | Resume a suspended thread and re-run the suspended role |
+| `uwf thread poke <thread-id> -p <text> [--agent <cmd>] [-c <count>]` | Re-run the head step's agent with a supplementary prompt (replaces head step) |
 | `uwf thread cancel <thread-id>` | Cancel thread (stop + archive to history) |
 
+### Suspend / Resume
+
+A thread enters `suspended` status from **two sources**, both landing at the same `$status: "$SUSPEND"` exit:
+
+1. **Voluntary** — an agent emits `$status: "$SUSPEND"` in its frontmatter (it hits a token budget, needs human input, etc.).
+2. **Timeout checkpoint** — the agent's `send` exceeds the adapter timeout. Instead of killing the step as an error, the broker reports a `kind: "suspended"` result and the step is written as a `$SUSPEND` node carrying the timeout `reason` (and the `nativeId` needed to resume). A timeout is a **checkpoint, not a death** — work already produced is preserved and the thread can be continued.
+
+A suspended thread **cannot be advanced with `exec`** — `exec` detects the suspended head and returns immediately without running any agent.
+
+To continue a suspended thread, use `resume`:
+
+```bash
+uwf thread resume <thread-id>                    # resume with workflow's default prompt
+uwf thread resume <thread-id> -p "version 1.2.0" # resume with supplementary context
+```
+
+`resume` issues a **fresh `send`** on the same cached `(threadId, role)` session; the underlying agent adapter resumes by its native session id (`--resume <nativeId>`), so the agent continues from its own history rather than starting over. For a timeout-suspended thread, `-p` supplies a short continuation prompt (e.g. `"continue"`) — the original prompt is not re-sent.
+
+> ⚠️ `exec` does not advance suspended threads — you **must** use `resume` to provide context and continue.
+
 Examples:
 
 ```bash
@@ -82,7 +104,8 @@ uwf thread list --all
 uwf thread list --status running
 uwf thread list --status active
 uwf thread list --status idle,end
-uwf thread list --after 7d --take 10
+uwf thread list --after 7d --limit 10
+uwf thread list --limit 5 --offset 10
 uwf thread read 01ARZ3NDEKTSV4RRFFQ69G5FAV --quota 8000
 uwf thread stop 01ARZ3NDEKTSV4RRFFQ69G5FAV
 ```
@@ -94,6 +117,7 @@ uwf thread stop 01ARZ3NDEKTSV4RRFFQ69G5FAV
 | `uwf step list <thread-id>` | List all steps in a thread chronologically |
 | `uwf step show <step-hash>` | Show step metadata and frontmatter |
 | `uwf step read <step-hash> [--quota <chars>]` | Read a step's turns as human-readable markdown |
+| `uwf step turns <thread-id> [--role <r>] [--live] [--limit <n>] [--offset <m>]` | Show **all** turns across a thread's steps (whole-chain panorama): each completed step from its `detail.turns` (`✓`), the in-flight step from its active var (`🔄 进行中`) |
 | `uwf step fork <step-hash>` | Fork a thread from a specific step |
 | `uwf step ask <step-hash> -p <prompt> [--agent <cmd>] [--no-fork]` | Ask a follow-up question to a historical step's agent (read-only; no thread mutation) |
 
@@ -103,11 +127,29 @@ Examples:
 uwf step list 01ARZ3NDEKTSV4RRFFQ69G5FAV
 uwf step show 32GCDE899RRQ3
 uwf step read 32GCDE899RRQ3 --quota 2000
+uwf step turns 01ARZ3NDEKTSV4RRFFQ69G5FAV                    # whole-thread panorama
+uwf step turns 01ARZ3NDEKTSV4RRFFQ69G5FAV --role coder       # filter to one role's steps
+uwf step turns 01ARZ3NDEKTSV4RRFFQ69G5FAV --limit 20 --offset 40   # paginate the flat sequence
+uwf step turns 01ARZ3NDEKTSV4RRFFQ69G5FAV --role coder --live      # follow the in-flight step
 uwf step fork 32GCDE899RRQ3
 uwf step ask 32GCDE899RRQ3 -p "Why did you choose this approach?"
 uwf step ask 32GCDE899RRQ3 -p "Summarise the key findings" --no-fork
 ```
 
+`step turns` is the turn-layer (layer 4) query keyed by `<thread-id>`. Unlike
+`step read` — which renders a *single* completed step's `detail.turns` by step
+hash, quota-bounded — `step turns` renders the **whole-thread turn panorama**: it
+walks the entire thread chain and shows **every** step's turns in chronological
+order, each turn attributed to its owning role/step. Completed steps are read from
+their immutable `detail.turns` and marked `✓`; the in-flight step is read live from
+its `@uwf/active-turns/<thread-id>/<role>` var and marked `🔄 进行中`. **All turns
+show by default** (no truncation); `--limit`/`--offset` paginate the flattened
+cross-step turn sequence. `--role <r>` filters the panorama to one role's steps
+across the whole chain (e.g. on a multi-step thread whose head is a different role,
+`--role developer` still returns the developer step's turns). With `--live` it polls
+the SQLite-backed active var (not SSE) and prints each new turn as it arrives,
+exiting when the in-flight step completes.
+
 ### Workflow (Layer 1: Templates)
 
 | Command | Description |
@@ -159,6 +201,79 @@ Engine config: `~/.uwf/config.yaml` (LLM-free — only `agents`, `defaultAgent`,
 
 ## Migration Guide
 
+### Breaking Changes (Phase 3 / #380) — broker integration & `{host, gateway}` agents
+
+Phase 3 of the broker rollout removes the legacy `spawnAgent` /
+`executeAgentCommand` / last-stdout-line JSON path from `uwf thread exec`.
+The CLI now calls `broker.send({ threadId, role, prompt })` against the
+Sumeru HTTP API and runs frontmatter extraction on the broker's
+`result.output`. The CLI itself never starts an agent process.
+
+This is a breaking 0.x change to `~/.uwf/config.yaml`:
+
+| Old (`{command, args}`) | New (`{host, gateway}`) |
+|-------------------------|-------------------------|
+| `agents.<alias>.command` | `agents.<alias>.host` |
+| `agents.<alias>.args` | `agents.<alias>.gateway` |
+
+Rewrite each agent entry. Before:
+
+```yaml
+agents:
+  hermes:
+    command: uwf-hermes
+    args: ["--verbose"]
+  claude-code:
+    command: uwf-claude-code
+    args: []
+defaultAgent: hermes
+agentOverrides: {}
+```
+
+After:
+
+```yaml
+agents:
+  hermes:
+    host: http://127.0.0.1:7900
+    gateway: hermes
+  claude-code:
+    host: http://127.0.0.1:7900
+    gateway: claude-code
+defaultAgent: hermes
+agentOverrides: {}
+```
+
+The engine config validator (`normalizeAgents` in
+`@united-workforce/util-agent`) now rejects any entry that still carries
+`command` or `args` with a clear migration error. `uwf config set
+agents.<alias>.command ...` is likewise rejected.
+
+#### `--agent` override
+
+`uwf thread exec --agent <value>` now accepts two shapes:
+
+- An alias declared in `agents.*` (e.g. `--agent hermes`).
+- An inline `"<host> <gateway>"` pair (e.g.
+  `--agent "http://127.0.0.1:7900 claude-code"`).
+
+The legacy bare command override (`--agent uwf-hermes`) is removed.
+
+#### `step ask` / `step fork` deferred to Phase 4
+
+`uwf step ask` and `uwf step fork` are temporarily disabled in this
+phase. Invoking them returns a clear "not yet supported in Phase 3"
+error rather than silently using the legacy spawn path. Both will be
+restored in Phase 4 once the broker exposes the per-step session
+replay APIs they require.
+
+#### Multi-step session reuse & resume
+
+The broker rows the `(threadId, role) → sessionId` mapping in its
+SQLite session store. Subsequent steps for the same role on the same
+thread reuse the cached Sumeru session. `uwf thread resume` reuses the
+same cached session — no new Sumeru session is created on resume.
+
 ### Breaking Changes (v0.5 → v0.6) — output envelope
 
 `uwf` now emits an ocas envelope (`{ type, value }`) for `--format json` and `--format yaml`, and the default format changed from `json` to `text`.

package/dist/.build-fingerprint

@@ -1 +1 @@
-8f6475d4155e0628083a10a7c1b3bc83482b887cdcfd2a704a00492f70553d87
+{"hash":"5705b01e563b540d0df2cfb3d50a0ddab22afcd05b62b89bded9a14c0b14e27a","outputs":["__tests__/agent-resolution-llm-free.test.d.ts","__tests__/agent-resolution-llm-free.test.d.ts.map","__tests__/agent-resolution-llm-free.test.js","__tests__/agent-resolution-llm-free.test.js.map","__tests__/broker-prompt.test.d.ts","__tests__/broker-prompt.test.d.ts.map","__tests__/broker-prompt.test.js","__tests__/broker-prompt.test.js.map","__tests__/broker-step-active-turns.test.d.ts","__tests__/broker-step-active-turns.test.d.ts.map","__tests__/broker-step-active-turns.test.js","__tests__/broker-step-active-turns.test.js.map","__tests__/broker-step-turn-chain-phase2.test.d.ts","__tests__/broker-step-turn-chain-phase2.test.d.ts.map","__tests__/broker-step-turn-chain-phase2.test.js","__tests__/broker-step-turn-chain-phase2.test.js.map","__tests__/build-step-entry.test.d.ts","__tests__/build-step-entry.test.d.ts.map","__tests__/build-step-entry.test.js","__tests__/build-step-entry.test.js.map","__tests__/clear-thread-failed-attempts.test.d.ts","__tests__/clear-thread-failed-attempts.test.d.ts.map","__tests__/clear-thread-failed-attempts.test.js","__tests__/clear-thread-failed-attempts.test.js.map","__tests__/concurrency.test.d.ts","__tests__/concurrency.test.d.ts.map","__tests__/concurrency.test.js","__tests__/concurrency.test.js.map","__tests__/config-text-renderer.test.d.ts","__tests__/config-text-renderer.test.d.ts.map","__tests__/config-text-renderer.test.js","__tests__/config-text-renderer.test.js.map","__tests__/config.test.d.ts","__tests__/config.test.d.ts.map","__tests__/config.test.js","__tests__/config.test.js.map","__tests__/current-role.test.d.ts","__tests__/current-role.test.d.ts.map","__tests__/current-role.test.js","__tests__/current-role.test.js.map","__tests__/e2e-broker-step-suspend.test.d.ts","__tests__/e2e-broker-step-suspend.test.d.ts.map","__tests__/e2e-broker-step-suspend.test.js","__tests__/e2e-broker-step-suspend.test.js.map","__tests__/e2e-broker-step.test.d.ts","__tests__/e2e-broker-step.test.d.ts.map","__tests__/e2e-broker-step.test.js","__tests__/e2e-broker-step.test.js.map","__tests__/e2e-mock-agent.test.d.ts","__tests__/e2e-mock-agent.test.d.ts.map","__tests__/e2e-mock-agent.test.js","__tests__/e2e-mock-agent.test.js.map","__tests__/e2e-thread-resume-timeout-suspend.test.d.ts","__tests__/e2e-thread-resume-timeout-suspend.test.d.ts.map","__tests__/e2e-thread-resume-timeout-suspend.test.js","__tests__/e2e-thread-resume-timeout-suspend.test.js.map","__tests__/format-text-default.test.d.ts","__tests__/format-text-default.test.d.ts.map","__tests__/format-text-default.test.js","__tests__/format-text-default.test.js.map","__tests__/format-text-registry.test.d.ts","__tests__/format-text-registry.test.d.ts.map","__tests__/format-text-registry.test.js","__tests__/format-text-registry.test.js.map","__tests__/include-tag.test.d.ts","__tests__/include-tag.test.d.ts.map","__tests__/include-tag.test.js","__tests__/include-tag.test.js.map","__tests__/issue-180-workflow-ref-removed.test.d.ts","__tests__/issue-180-workflow-ref-removed.test.d.ts.map","__tests__/issue-180-workflow-ref-removed.test.js","__tests__/issue-180-workflow-ref-removed.test.js.map","__tests__/log-tag-validity.test.d.ts","__tests__/log-tag-validity.test.d.ts.map","__tests__/log-tag-validity.test.js","__tests__/log-tag-validity.test.js.map","__tests__/log-text-renderer.test.d.ts","__tests__/log-text-renderer.test.d.ts.map","__tests__/log-text-renderer.test.js","__tests__/log-text-renderer.test.js.map","__tests__/log.test.d.ts","__tests__/log.test.d.ts.map","__tests__/log.test.js","__tests__/log.test.js.map","__tests__/moderator-evaluate.test.d.ts","__tests__/moderator-evaluate.test.d.ts.map","__tests__/moderator-evaluate.test.js","__tests__/moderator-evaluate.test.js.map","__tests__/output-mapper-thread-list-startedat.test.d.ts","__tests__/output-mapper-thread-list-startedat.test.d.ts.map","__tests__/output-mapper-thread-list-startedat.test.js","__tests__/output-mapper-thread-list-startedat.test.js.map","__tests__/output-mapper-workflow-add.test.d.ts","__tests__/output-mapper-workflow-add.test.d.ts.map","__tests__/output-mapper-workflow-add.test.js","__tests__/output-mapper-workflow-add.test.js.map","__tests__/pid-recycling.test.d.ts","__tests__/pid-recycling.test.d.ts.map","__tests__/pid-recycling.test.js","__tests__/pid-recycling.test.js.map","__tests__/preload.d.ts","__tests__/preload.d.ts.map","__tests__/preload.js","__tests__/preload.js.map","__tests__/prompt.test.d.ts","__tests__/prompt.test.d.ts.map","__tests__/prompt.test.js","__tests__/prompt.test.js.map","__tests__/resolve-head-hash.test.d.ts","__tests__/resolve-head-hash.test.d.ts.map","__tests__/resolve-head-hash.test.js","__tests__/resolve-head-hash.test.js.map","__tests__/setup-agent-discovery.test.d.ts","__tests__/setup-agent-discovery.test.d.ts.map","__tests__/setup-agent-discovery.test.js","__tests__/setup-agent-discovery.test.js.map","__tests__/setup-complexity.test.d.ts","__tests__/setup-complexity.test.d.ts.map","__tests__/setup-complexity.test.js","__tests__/setup-complexity.test.js.map","__tests__/setup-no-llm.test.d.ts","__tests__/setup-no-llm.test.d.ts.map","__tests__/setup-no-llm.test.js","__tests__/setup-no-llm.test.js.map","__tests__/solve-issue-tea-worktree.test.d.ts","__tests__/solve-issue-tea-worktree.test.d.ts.map","__tests__/solve-issue-tea-worktree.test.js","__tests__/solve-issue-tea-worktree.test.js.map","__tests__/step-ask.test.d.ts","__tests__/step-ask.test.d.ts.map","__tests__/step-ask.test.js","__tests__/step-ask.test.js.map","__tests__/step-read.test.d.ts","__tests__/step-read.test.d.ts.map","__tests__/step-read.test.js","__tests__/step-read.test.js.map","__tests__/step-show-json.test.d.ts","__tests__/step-show-json.test.d.ts.map","__tests__/step-show-json.test.js","__tests__/step-show-json.test.js.map","__tests__/step-show-text.test.d.ts","__tests__/step-show-text.test.d.ts.map","__tests__/step-show-text.test.js","__tests__/step-show-text.test.js.map","__tests__/step-timing.test.d.ts","__tests__/step-timing.test.d.ts.map","__tests__/step-timing.test.js","__tests__/step-timing.test.js.map","__tests__/step-turns-cli-subprocess.test.d.ts","__tests__/step-turns-cli-subprocess.test.d.ts.map","__tests__/step-turns-cli-subprocess.test.js","__tests__/step-turns-cli-subprocess.test.js.map","__tests__/step-turns-panorama-phase3.test.d.ts","__tests__/step-turns-panorama-phase3.test.d.ts.map","__tests__/step-turns-panorama-phase3.test.js","__tests__/step-turns-panorama-phase3.test.js.map","__tests__/step-turns.test.d.ts","__tests__/step-turns.test.d.ts.map","__tests__/step-turns.test.js","__tests__/step-turns.test.js.map","__tests__/store-global-cas.test.d.ts","__tests__/store-global-cas.test.d.ts.map","__tests__/store-global-cas.test.js","__tests__/store-global-cas.test.js.map","__tests__/store-storage-root.test.d.ts","__tests__/store-storage-root.test.d.ts.map","__tests__/store-storage-root.test.js","__tests__/store-storage-root.test.js.map","__tests__/store-turn-chain.test.d.ts","__tests__/store-turn-chain.test.d.ts.map","__tests__/store-turn-chain.test.js","__tests__/store-turn-chain.test.js.map","__tests__/store-unified-threads.test.d.ts","__tests__/store-unified-threads.test.d.ts.map","__tests__/store-unified-threads.test.js","__tests__/store-unified-threads.test.js.map","__tests__/thread-agent-failure-suspended.test.d.ts","__tests__/thread-agent-failure-suspended.test.d.ts.map","__tests__/thread-agent-failure-suspended.test.js","__tests__/thread-agent-failure-suspended.test.js.map","__tests__/thread-cancel-status.test.d.ts","__tests__/thread-cancel-status.test.d.ts.map","__tests__/thread-cancel-status.test.js","__tests__/thread-cancel-status.test.js.map","__tests__/thread-cancel-text-renderer.test.d.ts","__tests__/thread-cancel-text-renderer.test.d.ts.map","__tests__/thread-cancel-text-renderer.test.js","__tests__/thread-cancel-text-renderer.test.js.map","__tests__/thread-join.test.d.ts","__tests__/thread-join.test.d.ts.map","__tests__/thread-join.test.js","__tests__/thread-join.test.js.map","__tests__/thread-list-filters.test.d.ts","__tests__/thread-list-filters.test.d.ts.map","__tests__/thread-list-filters.test.js","__tests__/thread-list-filters.test.js.map","__tests__/thread-list-limit-offset.test.d.ts","__tests__/thread-list-limit-offset.test.d.ts.map","__tests__/thread-list-limit-offset.test.js","__tests__/thread-list-limit-offset.test.js.map","__tests__/thread-list-template-ms-date.test.d.ts","__tests__/thread-list-template-ms-date.test.d.ts.map","__tests__/thread-list-template-ms-date.test.js","__tests__/thread-list-template-ms-date.test.js.map","__tests__/thread-list-workflow-corrupt.test.d.ts","__tests__/thread-list-workflow-corrupt.test.d.ts.map","__tests__/thread-list-workflow-corrupt.test.js","__tests__/thread-list-workflow-corrupt.test.js.map","__tests__/thread-location.test.d.ts","__tests__/thread-location.test.d.ts.map","__tests__/thread-location.test.js","__tests__/thread-location.test.js.map","__tests__/thread-poke.test.d.ts","__tests__/thread-poke.test.d.ts.map","__tests__/thread-poke.test.js","__tests__/thread-poke.test.js.map","__tests__/thread-read-quota.test.d.ts","__tests__/thread-read-quota.test.d.ts.map","__tests__/thread-read-quota.test.js","__tests__/thread-read-quota.test.js.map","__tests__/thread-read-xml-tags.test.d.ts","__tests__/thread-read-xml-tags.test.d.ts.map","__tests__/thread-read-xml-tags.test.js","__tests__/thread-read-xml-tags.test.js.map","__tests__/thread-resume.test.d.ts","__tests__/thread-resume.test.d.ts.map","__tests__/thread-resume.test.js","__tests__/thread-resume.test.js.map","__tests__/thread-show-status.test.d.ts","__tests__/thread-show-status.test.d.ts.map","__tests__/thread-show-status.test.js","__tests__/thread-show-status.test.js.map","__tests__/thread-start-cwd-cli.test.d.ts","__tests__/thread-start-cwd-cli.test.d.ts.map","__tests__/thread-start-cwd-cli.test.js","__tests__/thread-start-cwd-cli.test.js.map","__tests__/thread-step-count.test.d.ts","__tests__/thread-step-count.test.d.ts.map","__tests__/thread-step-count.test.js","__tests__/thread-step-count.test.js.map","__tests__/thread-stop-text-renderer.test.d.ts","__tests__/thread-stop-text-renderer.test.d.ts.map","__tests__/thread-stop-text-renderer.test.js","__tests__/thread-stop-text-renderer.test.js.map","__tests__/thread-suspend-step.test.d.ts","__tests__/thread-suspend-step.test.d.ts.map","__tests__/thread-suspend-step.test.js","__tests__/thread-suspend-step.test.js.map","__tests__/thread-suspended-display.test.d.ts","__tests__/thread-suspended-display.test.d.ts.map","__tests__/thread-suspended-display.test.js","__tests__/thread-suspended-display.test.js.map","__tests__/thread-test-helpers.d.ts","__tests__/thread-test-helpers.d.ts.map","__tests__/thread-test-helpers.js","__tests__/thread-test-helpers.js.map","__tests__/thread.test.d.ts","__tests__/thread.test.d.ts.map","__tests__/thread.test.js","__tests__/thread.test.js.map","__tests__/validate-semantic.test.d.ts","__tests__/validate-semantic.test.d.ts.map","__tests__/validate-semantic.test.js","__tests__/validate-semantic.test.js.map","__tests__/workflow-list-recursive.test.d.ts","__tests__/workflow-list-recursive.test.d.ts.map","__tests__/workflow-list-recursive.test.js","__tests__/workflow-list-recursive.test.js.map","__tests__/workflow-paths.test.d.ts","__tests__/workflow-paths.test.d.ts.map","__tests__/workflow-paths.test.js","__tests__/workflow-paths.test.js.map","__tests__/workflow-resolution.test.d.ts","__tests__/workflow-resolution.test.d.ts.map","__tests__/workflow-resolution.test.js","__tests__/workflow-resolution.test.js.map","__tests__/workflow-show-resolution.test.d.ts","__tests__/workflow-show-resolution.test.d.ts.map","__tests__/workflow-show-resolution.test.js","__tests__/workflow-show-resolution.test.js.map","__tests__/workflow-validate.test.d.ts","__tests__/workflow-validate.test.d.ts.map","__tests__/workflow-validate.test.js","__tests__/workflow-validate.test.js.map","__tests__/write-envelope.test.d.ts","__tests__/write-envelope.test.d.ts.map","__tests__/write-envelope.test.js","__tests__/write-envelope.test.js.map","background/background.d.ts","background/background.d.ts.map","background/background.js","background/background.js.map","background/index.d.ts","background/index.d.ts.map","background/index.js","background/index.js.map","background/types.d.ts","background/types.d.ts.map","background/types.js","background/types.js.map","cli.d.ts","cli.d.ts.map","cli.js","cli.js.map","commands/broker-step.d.ts","commands/broker-step.d.ts.map","commands/broker-step.js","commands/broker-step.js.map","commands/config.d.ts","commands/config.d.ts.map","commands/config.js","commands/config.js.map","commands/log.d.ts","commands/log.d.ts.map","commands/log.js","commands/log.js.map","commands/prompt.d.ts","commands/prompt.d.ts.map","commands/prompt.js","commands/prompt.js.map","commands/setup.d.ts","commands/setup.d.ts.map","commands/setup.js","commands/setup.js.map","commands/shared.d.ts","commands/shared.d.ts.map","commands/shared.js","commands/shared.js.map","commands/step.d.ts","commands/step.d.ts.map","commands/step.js","commands/step.js.map","commands/thread-time-parser.d.ts","commands/thread-time-parser.d.ts.map","commands/thread-time-parser.js","commands/thread-time-parser.js.map","commands/thread.d.ts","commands/thread.d.ts.map","commands/thread.js","commands/thread.js.map","commands/workflow.d.ts","commands/workflow.d.ts.map","commands/workflow.js","commands/workflow.js.map","concurrency/concurrency.d.ts","concurrency/concurrency.d.ts.map","concurrency/concurrency.js","concurrency/concurrency.js.map","concurrency/index.d.ts","concurrency/index.d.ts.map","concurrency/index.js","concurrency/index.js.map","concurrency/types.d.ts","concurrency/types.d.ts.map","concurrency/types.js","concurrency/types.js.map","format.d.ts","format.d.ts.map","format.js","format.js.map","include.d.ts","include.d.ts.map","include.js","include.js.map","moderator/__tests__/evaluate.test.d.ts","moderator/__tests__/evaluate.test.d.ts.map","moderator/__tests__/evaluate.test.js","moderator/__tests__/evaluate.test.js.map","moderator/evaluate.d.ts","moderator/evaluate.d.ts.map","moderator/evaluate.js","moderator/evaluate.js.map","moderator/index.d.ts","moderator/index.d.ts.map","moderator/index.js","moderator/index.js.map","moderator/types.d.ts","moderator/types.d.ts.map","moderator/types.js","moderator/types.js.map","output-mappers.d.ts","output-mappers.d.ts.map","output-mappers.js","output-mappers.js.map","schemas.d.ts","schemas.d.ts.map","schemas.js","schemas.js.map","store.d.ts","store.d.ts.map","store.js","store.js.map","text-renderers.d.ts","text-renderers.d.ts.map","text-renderers.js","text-renderers.js.map","validate-semantic.d.ts","validate-semantic.d.ts.map","validate-semantic.js","validate-semantic.js.map","validate.d.ts","validate.d.ts.map","validate.js","validate.js.map"]}

package/dist/__tests__/agent-resolution-llm-free.test.js

@@ -11,20 +11,27 @@ describe("agent resolution works without LLM fields in config.yaml (issue #143)"
     });
     test("loadWorkflowConfig succeeds on a minimal engine-only config", async () => {
         tempDir = mkdtempSync(join(tmpdir(), "uwf-engine-cfg-"));
-        writeFileSync(join(tempDir, "config.yaml"), "agents:\n  hermes: { command: uwf-hermes, args: [] }\ndefaultAgent: hermes\n", "utf8");
+        writeFileSync(join(tempDir, "config.yaml"), "agents:\n  hermes: { host: 'http://127.0.0.1:7900', gateway: hermes }\ndefaultAgent: hermes\n", "utf8");
         const cfg = await loadWorkflowConfig(tempDir);
         expect(cfg.defaultAgent).toBe("hermes");
         expect(cfg.agents.hermes).toBeDefined();
+        expect(cfg.agents.hermes.host).toBe("http://127.0.0.1:7900");
+        expect(cfg.agents.hermes.gateway).toBe("hermes");
         expect(cfg.agentOverrides).toBeNull();
     });
     test("loadWorkflowConfig ignores legacy provider/model fields", async () => {
         tempDir = mkdtempSync(join(tmpdir(), "uwf-engine-cfg-"));
-        writeFileSync(join(tempDir, "config.yaml"), "providers:\n  openai: { baseUrl: x, apiKey: y }\nmodels:\n  default: { provider: openai, name: gpt-4o }\ndefaultModel: default\nagents:\n  hermes: { command: uwf-hermes, args: [] }\ndefaultAgent: hermes\n", "utf8");
+        writeFileSync(join(tempDir, "config.yaml"), "providers:\n  openai: { baseUrl: x, apiKey: y }\nmodels:\n  default: { provider: openai, name: gpt-4o }\ndefaultModel: default\nagents:\n  hermes: { host: 'http://127.0.0.1:7900', gateway: hermes }\ndefaultAgent: hermes\n", "utf8");
         const cfg = (await loadWorkflowConfig(tempDir));
         expect(cfg.defaultAgent).toBe("hermes");
         expect(cfg.providers).toBeUndefined();
         expect(cfg.models).toBeUndefined();
         expect(cfg.defaultModel).toBeUndefined();
     });
+    test("loadWorkflowConfig rejects legacy {command, args} agent shape", async () => {
+        tempDir = mkdtempSync(join(tmpdir(), "uwf-engine-cfg-"));
+        writeFileSync(join(tempDir, "config.yaml"), "agents:\n  hermes: { command: uwf-hermes, args: [] }\ndefaultAgent: hermes\n", "utf8");
+        await expect(loadWorkflowConfig(tempDir)).rejects.toThrow(/legacy \{command, args\} fields/);
+    });
 });
 //# sourceMappingURL=agent-resolution-llm-free.test.js.map

package/dist/__tests__/agent-resolution-llm-free.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-resolution-llm-free.test.js","sourceRoot":"","sources":["../../src/__tests__/agent-resolution-llm-free.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE3D,QAAQ,CAAC,uEAAuE,EAAE,GAAG,EAAE;IACrF,IAAI,OAAe,CAAC;IACpB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO;YAAE,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC7E,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACzD,aAAa,CACX,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAC5B,8EAA8E,EAC9E,MAAM,CACP,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACzE,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACzD,aAAa,CACX,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAC5B,8MAA8M,EAC9M,MAAM,CACP,CAAC;QACF,MAAM,GAAG,GAAG,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAA4B,CAAC;QAC3E,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"agent-resolution-llm-free.test.js","sourceRoot":"","sources":["../../src/__tests__/agent-resolution-llm-free.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE3D,QAAQ,CAAC,uEAAuE,EAAE,GAAG,EAAE;IACrF,IAAI,OAAe,CAAC;IACpB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO;YAAE,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC7E,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACzD,aAAa,CACX,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAC5B,+FAA+F,EAC/F,MAAM,CACP,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACzE,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACzD,aAAa,CACX,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAC5B,+NAA+N,EAC/N,MAAM,CACP,CAAC;QACF,MAAM,GAAG,GAAG,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAA4B,CAAC;QAC3E,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC/E,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACzD,aAAa,CACX,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAC5B,8EAA8E,EAC9E,MAAM,CACP,CAAC;QACF,MAAM,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/broker-prompt.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unit tests for `assembleBrokerPrompt` (#387).
+ *
+ * Verifies the broker path assembles the same five-part prompt the legacy
+ * spawned-agent path produced: output-format instruction, thread progress,
+ * role prompt (goal/procedure/output), task prompt, and the
+ * continuation/edge-prompt context (branching on first visit vs re-entry).
+ */
+export {};
+//# sourceMappingURL=broker-prompt.test.d.ts.map

package/dist/__tests__/broker-prompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-prompt.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/broker-prompt.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/broker-prompt.test.js

@@ -0,0 +1,129 @@
+/**
+ * Unit tests for `assembleBrokerPrompt` (#387).
+ *
+ * Verifies the broker path assembles the same five-part prompt the legacy
+ * spawned-agent path produced: output-format instruction, thread progress,
+ * role prompt (goal/procedure/output), task prompt, and the
+ * continuation/edge-prompt context (branching on first visit vs re-entry).
+ */
+import { describe, expect, test } from "vitest";
+import { assembleBrokerPrompt } from "../commands/broker-step.js";
+const THREAD_ID = "06FCBROKERPROMPTTEST000001";
+const OUTPUT_FORMAT_INSTRUCTION = "## Deliverable Format\n\nemit YAML frontmatter";
+function buildWorkflow() {
+    return {
+        version: 1,
+        name: "review-flow",
+        description: "two-role review flow",
+        roles: {
+            developer: {
+                description: "writes code",
+                goal: "implement the requested behavior",
+                capabilities: ["coding"],
+                procedure: "follow the spec and write tests",
+                output: "a patch plus a short summary",
+                frontmatter: "schema_developer",
+            },
+            reviewer: {
+                description: "reviews code",
+                goal: "review the implementation",
+                capabilities: [],
+                procedure: "check the diff carefully",
+                output: "approve or reject",
+                frontmatter: "schema_reviewer",
+            },
+        },
+        graph: {},
+    };
+}
+function stepContext(role, content, output) {
+    return {
+        role,
+        output,
+        detail: "detail_ref",
+        agent: "test-agent",
+        edgePrompt: "",
+        startedAtMs: 0,
+        completedAtMs: 1,
+        cwd: "",
+        assembledPrompt: null,
+        usage: null,
+        previousAttempts: null,
+        content,
+    };
+}
+describe("assembleBrokerPrompt", () => {
+    test("first visit with no prior steps embeds role prompt, task, and edge prompt", () => {
+        const prompt = assembleBrokerPrompt({
+            workflow: buildWorkflow(),
+            role: "developer",
+            threadId: THREAD_ID,
+            startPrompt: "Build the login form",
+            steps: [],
+            edgePrompt: "Implement the behavior defined in the spec files",
+            outputFormatInstruction: OUTPUT_FORMAT_INSTRUCTION,
+        });
+        // 1. output-format instruction
+        expect(prompt).toContain("## Deliverable Format");
+        // 2. thread progress
+        expect(prompt).toContain("## Thread Progress");
+        expect(prompt).toContain("This is the first step of the thread");
+        // 3. role prompt (goal + procedure + output)
+        expect(prompt).toContain("## Goal");
+        expect(prompt).toContain("implement the requested behavior");
+        expect(prompt).toContain("## Procedure");
+        expect(prompt).toContain("follow the spec and write tests");
+        expect(prompt).toContain("## Output");
+        expect(prompt).toContain("a patch plus a short summary");
+        // 4. task prompt
+        expect(prompt).toContain("## Task");
+        expect(prompt).toContain("Build the login form");
+        // 5. edge prompt (no prior steps → "Current Instruction")
+        expect(prompt).toContain("## Current Instruction");
+        expect(prompt).toContain("Implement the behavior defined in the spec files");
+    });
+    test("first visit with prior steps includes step content as continuation context", () => {
+        const steps = [
+            stepContext("planner", "Here is the detailed plan for the feature.", { $status: "done" }),
+        ];
+        const prompt = assembleBrokerPrompt({
+            workflow: buildWorkflow(),
+            role: "developer",
+            threadId: THREAD_ID,
+            startPrompt: "Build the login form",
+            steps,
+            edgePrompt: "Implement the plan",
+            outputFormatInstruction: OUTPUT_FORMAT_INSTRUCTION,
+        });
+        // Developer has not spoken yet → first visit, prior steps shown WITH content.
+        expect(prompt).toContain("## What Happened Since Your Last Turn");
+        expect(prompt).toContain("Here is the detailed plan for the feature.");
+        expect(prompt).toContain("## Moderator Instruction");
+        expect(prompt).toContain("Implement the plan");
+        // Thread progress reflects the prior step.
+        expect(prompt).toContain("Thread step 2");
+    });
+    test("re-entry shows only steps since last visit (meta-only continuation)", () => {
+        const steps = [
+            stepContext("developer", "My first implementation attempt.", { $status: "done" }),
+            stepContext("reviewer", "Please fix the validation logic.", { $status: "reject" }),
+        ];
+        const prompt = assembleBrokerPrompt({
+            workflow: buildWorkflow(),
+            role: "developer",
+            threadId: THREAD_ID,
+            startPrompt: "Build the login form",
+            steps,
+            edgePrompt: "Address the reviewer feedback",
+            outputFormatInstruction: OUTPUT_FORMAT_INSTRUCTION,
+        });
+        // Re-entry: continuation lists the reviewer step since the last developer turn.
+        expect(prompt).toContain("## What Happened Since Your Last Turn");
+        expect(prompt).toContain("reviewer");
+        expect(prompt).toContain("## Moderator Instruction");
+        expect(prompt).toContain("Address the reviewer feedback");
+        // Meta-only re-entry omits raw step content from before the last visit.
+        expect(prompt).not.toContain("My first implementation attempt.");
+    });
+});
+//# sourceMappingURL=broker-prompt.test.js.map

package/dist/__tests__/broker-prompt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-prompt.test.js","sourceRoot":"","sources":["../../src/__tests__/broker-prompt.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/broker-step-active-turns.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Phase 2 (#398 + #419) — realtime turn persistence in `executeBrokerStep`.
+ *
+ * Updated for Phase 2 (#419):
+ *   - Turns are now written with `prev`+`owner` chain instead of accumulating in
+ *     `@uwf/active-turns/<tid>/<role>` array var
+ *   - Detail node no longer contains `turns` array — use `turnsOfStep()` to retrieve
+ *   - Thread-keyed active vars (`@uwf/active-step/<tid>`, `@uwf/active-turn-head/<tid>`)
+ *
+ * Covers the acceptance steps:
+ *   Step 1 — broker-step's `onTurn` writes each turn with `prev`+`owner` chain;
+ *            the turn chain grows 1→2→3.
+ *   Step 2 — on completion, detail has `turnCount===3` (no `turns` array);
+ *            turns are accessible via `turnsOfStep()`.
+ *   Step 3 — a crash-rerun is a fresh attempt: new step-start isolates old turns
+ *            via different `owner` reference.
+ *   Step 4 — cross-process visibility: thread-keyed turn head var is observable.
+ */
+export {};
+//# sourceMappingURL=broker-step-active-turns.test.d.ts.map

package/dist/__tests__/broker-step-active-turns.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-step-active-turns.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/broker-step-active-turns.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}