mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-29 23:38:55 +00:00
bb46b79d3c
* refactor: extract agent core package Introduce packages/agent-core as the OpenClaw-owned home for reusable agent loop, harness, session, prompt, and runtime dependency contracts. * refactor: extract shared llm runtime Move provider model registries, stream wrappers, OAuth helpers, and LLM utilities into src/llm with plugin-sdk barrels instead of depending on the old embedded runtime layout. * refactor: remove pi runtime internals Rename remaining Pi-shaped agent surfaces to OpenClaw agent runtime names, delete obsolete Pi docs and package graph checks, and add the third-party notice for incorporated code. * refactor: tighten agent session runtime Make agent-core/runtime dependencies explicit, consolidate compaction and session transcript helpers, and move model/session helpers behind OpenClaw-owned contracts. * refactor: remove static model and pi auth paths Drop static model catalogs and Pi auth bridges, move model/provider facts to manifest-owned runtime contracts, and harden internal embedded-agent utilities. * refactor: remove legacy provider compat paths * docs: remove agent parity notes * fix: skip provider wildcard metadata parsing * refactor: share session extension sdk loading * refactor: inline acpx proxy error formatter * refactor: fold edit recovery into edit tool * fix: accept extension batch separator * test: align startup provider plugin expectations * fix: restore provider-scoped release discovery * test: align static asset packaging expectations * fix: run static provider catalogs during scoped discovery * fix: add provider entry catalogs for scoped live discovery * fix: load lightweight provider catalog entries * fix: refresh provider-scoped plugin metadata * fix: keep provider catalog entries on release live path * fix: keep static manifest models in release live checks * fix: harden release model discovery * fix: reduce OpenAI live cache probe reasoning * fix: disable OpenAI cache probe reasoning * ci: extend OpenAI gateway live timeout * fix: extend live gateway model budget * fix: stabilize release validation regressions * fix: honor provider aliases in model rows * fix: stabilize release validation lanes * fix: stabilize release memory qa * ci: stabilize release validation lanes * ci: prefer ipv4 for live docker node calls * fix: restore shared tool-call stream wrapper * ci: remove legacy pi test shard alias * fix: clean up embedded agent test drift * fix: stabilize runtime alias status * fix: clean up embedded agent ci drift * fix: restore release ci invariants * fix: clean up post-rebase runtime drift * fix: restore release ci checks * fix: restore release ci after rebase * fix: remove stale pi runtime path * test: align compaction runtime expectations * test: update plugin prerelease expectations * fix: handle claude live tool approvals * fix: stabilize release validation gates * fix: finish agent runtime import * test: finish post-rebase agent runtime mocks * fix: keep codex compaction native * fix: stabilize codex app-server hook tests * test: isolate codex diagnostic active run * test: remove codex diagnostic completion race # Conflicts: # extensions/codex/src/app-server/run-attempt.test.ts * ci: fix full release manifest performance run id * refactor: narrow llm plugin sdk boundary * chore: drop generated google boundary stamps * fix: repair rebase fallout * fix: clean up rebased runtime references * fix: decode codex jwt payloads as base64url * fix: preserve shipped pi runtime alias * fix: add scoped sdk virtual modules * fix: decode llm codex oauth jwt as base64url * fix: avoid stale vertex adc negative cache * fix: harden tool arg decoding and codeql path * fix: keep vertex adc negative checks live * refactor: consolidate codex jwt and edit helpers * fix: await codex oauth node runtime imports * fix: preserve sdk tool and notice contracts * fix: preserve shipped compat config boundaries * fix: align codex oauth callback host * fix: terminate agent-core loop streams on failure * fix: keep codex oauth callback alive during fallback * ci: include session tools in critical codeql scans * fix: keep Cloudflare Anthropic provider auth header * docs: redirect legacy pi runtime pages * fix: honor bundled web provider compat discovery * fix: protect session output spill files * fix: keep legacy agent dir env blocked * fix: contain auto-discovered skill symlinks * fix: harden agent core sdk proxy surfaces * fix: restore approval reaction sdk compat * fix: keep live docker runs bounded * fix: keep codex oauth redirect host aligned * fix: resolve post-rebase agent runtime drift * fix: redact anthropic oauth parse failures * fix: preserve responses strict tool shaping * fix: repair agent runtime rebase cleanup * docs: redirect retired parity pages * fix: bound auto-discovered resources to roots * fix: repair post-rebase agent test drift * fix: preserve bundled provider allowlist migration * fix: preserve manifest-owned provider aliases * fix: declare photon image dependency * fix: keep provider headers out of proxy body * fix: preserve shipped env aliases * fix: refresh control ui i18n generated state * fix: quote read fallback paths * fix: preview edits through configured backend * test: satisfy core test typecheck * fix: preserve ZAI usage auth fallback * test: repair codex diagnostic test * fix: repair agent runtime rebase drift * test: finish embedded runner import rename * fix: repair agent runtime rebase integrations * test: align compaction oauth fallback expectations * fix: allow sdk-auth session models * fix: update doctor tool schema import * fix: preserve bedrock plugin region * fix: stream harmony-like prose immediately * ci: include session runtime in codeql shards * fix: repair latest rebase integrations * fix: honor explicit codex websocket transport * fix: keep openai-compatible credentials provider-scoped * fix: refresh sdk api baseline after rebase * fix: route cli runtime aliases through openclaw harness * test: rename stale harness mock expectation * test: rename embedded agent overflow calls * test: clean embedded auth test wording * test: use openclaw stream types in deepinfra cache test * fix: refresh sdk api baseline on latest main * fix: honor bundled discovery compat allowlists * fix: refresh sdk api baseline after latest rebase * fix: remove stale rebase imports * test: rename stale model catalog mock * test: mock renamed doctor runtime modules * fix: map canonical kimi env auth * fix: use internal model registry in bench script * fix: migrate deepinfra provider catalog entry * fix: enforce builtin tool suppression * fix: route compaction auth and proxy payloads safely * refactor: prune unused llm registry leftovers * test: update codex hooks session import * test: fix model picker ci coverage * test: align model picker auth mock types
91 lines
4.4 KiB
Markdown
91 lines
4.4 KiB
Markdown
---
|
|
summary: "How active-run steering queues messages at runtime boundaries"
|
|
read_when:
|
|
- Explaining how steer behaves while an agent is using tools
|
|
- Changing active-run queue behavior or runtime steering integration
|
|
- Comparing steering with followup, collect, and interrupt queue modes
|
|
title: "Steering queue"
|
|
---
|
|
|
|
When a normal prompt arrives while a session run is already streaming, OpenClaw
|
|
tries to send that prompt into the active runtime by default when the queue mode
|
|
is `steer`. No config entry and no queue directive are required for that default
|
|
behavior. OpenClaw and the native Codex app-server harness implement the delivery
|
|
details differently.
|
|
|
|
## Runtime boundary
|
|
|
|
Steering does not interrupt a tool call that is already running. OpenClaw checks for
|
|
queued steering messages at model boundaries:
|
|
|
|
1. The assistant asks for tool calls.
|
|
2. OpenClaw executes the current assistant message's tool-call batch.
|
|
3. OpenClaw emits the turn end event.
|
|
4. OpenClaw drains queued steering messages.
|
|
5. OpenClaw appends those messages as user messages before the next LLM call.
|
|
|
|
This keeps tool results paired with the assistant message that requested them,
|
|
then lets the next model call see the latest user input.
|
|
|
|
The native Codex app-server harness exposes `turn/steer` instead of OpenClaw runtime's
|
|
internal steering queue. OpenClaw batches queued prompts for the configured
|
|
quiet window, then sends a single `turn/steer` request with all collected user
|
|
input in arrival order.
|
|
|
|
Codex review and manual compaction turns reject same-turn steering. When a
|
|
runtime cannot accept steering in `steer` mode, OpenClaw waits for the active
|
|
run to finish before starting the prompt.
|
|
|
|
This page explains queue-mode steering for normal inbound messages when the mode
|
|
is `steer`. If the mode is `followup` or `collect`, normal messages do not enter
|
|
this steering path; they wait until the active run finishes. For the explicit
|
|
`/steer <message>` command, see [Steer](/tools/steer).
|
|
|
|
## Modes
|
|
|
|
| Mode | Active-run behavior | Later behavior |
|
|
| ----------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------- |
|
|
| `steer` | Steers the prompt into the active runtime when it can. | Waits for the active run to finish if steering is unavailable. |
|
|
| `followup` | Does not steer. | Runs queued messages later after the active run ends. |
|
|
| `collect` | Does not steer. | Coalesces compatible queued messages into one later turn after the debounce window. |
|
|
| `interrupt` | Aborts the active run instead of steering it. | Starts the newest message after aborting. |
|
|
|
|
## Burst example
|
|
|
|
If four users send messages while the agent is executing a tool call:
|
|
|
|
- With default behavior, the active runtime receives all four messages in
|
|
arrival order before its next model decision. OpenClaw drains them at the next model
|
|
boundary; Codex receives them as one batched `turn/steer`.
|
|
- With `/queue collect`, OpenClaw does not steer. It waits until the active run
|
|
ends, then creates a followup turn with compatible queued messages after the
|
|
debounce window.
|
|
- With `/queue interrupt`, OpenClaw aborts the active run and starts the newest
|
|
message instead of steering.
|
|
|
|
## Scope
|
|
|
|
Steering always targets the current active session run. It does not create a new
|
|
session, change the active run's tool policy, or split messages by sender. In
|
|
multi-user channels, inbound prompts already include sender and route context, so
|
|
the next model call can see who sent each message.
|
|
|
|
Use `followup` or `collect` when you want messages to queue by default instead
|
|
of steering the active run. Use `interrupt` when the newest prompt should
|
|
replace the active run.
|
|
|
|
## Debounce
|
|
|
|
`messages.queue.debounceMs` applies to queued `followup` and `collect` delivery.
|
|
In `steer` mode with the native Codex harness, it also sets the quiet window
|
|
before sending batched `turn/steer`. For OpenClaw, active steering itself does not use
|
|
the debounce timer because OpenClaw naturally batches messages until the next model
|
|
boundary.
|
|
|
|
## Related
|
|
|
|
- [Command queue](/concepts/queue)
|
|
- [Steer](/tools/steer)
|
|
- [Messages](/concepts/messages)
|
|
- [Agent loop](/concepts/agent-loop)
|