Creator App Tests / PR Spam Gate (push) Skipped
Frontend Tests / PR Spam Gate (push) Skipped
NPM Format (website & console) / PR Spam Gate (push) Skipped
Pre-commit Checks / PR Spam Gate (push) Skipped
QwenPaw Creator Plugin Release / check-version (push) Canceled after 0s
QwenPaw Creator Plugin Release / upload-oss (push) Canceled after 0s
Tests / PR Spam Gate (push) Skipped
CodeQL / CodeQL (python) (push) Canceled after 0s
CodeQL / CodeQL (typescript) (push) Canceled after 0s
Creator App Tests / Creator Backend Tests (push) Canceled after 0s
Creator App Tests / Creator UI Build & Tests (push) Canceled after 0s
E2E Smoke Tests / Playwright UI Smoke (push) Canceled after 0s
Frontend Tests / Detect console changes (push) Canceled after 0s
NPM Format (website & console) / website format check (push) Canceled after 0s
NPM Format (website & console) / console format check (push) Canceled after 0s
Pre-commit Checks / Pre-commit (push) Canceled after 0s
QwenPaw Data Plugin Release / check-version (push) Canceled after 0s
Tests / Detect code changes (push) Canceled after 0s
Frontend Tests / Vitest Unit Tests (push) Canceled after 0s
Frontend Tests / Frontend Summary (push) Canceled after 0s
QwenPaw Data Plugin Release / upload-oss (push) Canceled after 0s
Tests / Maintainer Approval (push) Canceled after 0s
Tests / Unit Tests - py3.11 - macos-latest (push) Canceled after 0s
Tests / Unit Tests - py3.11 - ubuntu-latest (push) Canceled after 0s
Tests / Unit Tests - py3.13 - ubuntu-latest (push) Canceled after 0s
Tests / Unit Tests - py3.11 - windows-latest (push) Canceled after 0s
Tests / Contract Tests - py3.11 - macos-latest (push) Canceled after 0s
Tests / Contract Tests - py3.11 - ubuntu-latest (push) Canceled after 0s
Tests / Contract Tests - py3.13 - ubuntu-latest (push) Canceled after 0s
Tests / Contract Tests - py3.11 - windows-latest (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - macos-latest - p0 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - macos-latest - p1 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - macos-latest - p2 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - ubuntu-latest - fallback (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - ubuntu-latest - p0 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - ubuntu-latest - p1 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - ubuntu-latest - p2 (push) Canceled after 0s
Tests / Integrated Tests - py3.13 - ubuntu-latest - p0 (push) Canceled after 0s
Tests / Integrated Tests - py3.13 - ubuntu-latest - p1 (push) Canceled after 0s
Tests / Integrated Tests - py3.13 - ubuntu-latest - p2 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - windows-latest - p0 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - windows-latest - p1 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - windows-latest - p2 (push) Canceled after 0s
Tests / Coverage Report (push) Canceled after 0s
Tests / Test Summary (push) Canceled after 0s
58 lines
2.0 KiB
Markdown
58 lines
2.0 KiB
Markdown
# Middleware Demo Plugins
|
|
|
|
Two example plugins demonstrating `PluginApi.register_middleware()` — the
|
|
plugin-based mechanism for injecting AgentScope `MiddlewareBase` instances
|
|
into the agent's reasoning loop.
|
|
|
|
## Included Demos
|
|
|
|
| Plugin | Hook | Behavior |
|
|
|--------|------|----------|
|
|
| `tracing-middleware` | `on_acting` | Logs every tool call (name, duration) to a file. Conditionally activated only when `QWENPAW_TRACE` env var is set. |
|
|
| `thinking-log-middleware` | `on_reasoning` | Prints model reasoning stream events to stdout (`[THINKING]` for chain-of-thought, `[TEXT]` for text responses). Always active. |
|
|
|
|
## Installation
|
|
|
|
These plugins are **not** auto-loaded. Install them explicitly:
|
|
|
|
```bash
|
|
# While QwenPaw is running (hot-load, no restart needed):
|
|
qwenpaw plugin install plugins/middleware-demo/tracing-middleware
|
|
qwenpaw plugin install plugins/middleware-demo/thinking-log-middleware
|
|
|
|
# Or when QwenPaw is stopped (loaded on next start):
|
|
qwenpaw plugin install plugins/middleware-demo/tracing-middleware
|
|
qwenpaw plugin install plugins/middleware-demo/thinking-log-middleware
|
|
```
|
|
|
|
## Uninstall
|
|
|
|
```bash
|
|
qwenpaw plugin uninstall middleware-demo-tracing
|
|
qwenpaw plugin uninstall middleware-demo-thinking-log
|
|
```
|
|
|
|
## How It Works
|
|
|
|
Each plugin registers a **middleware factory** via `api.register_middleware(factory, priority=N)`.
|
|
|
|
The factory is called once per request during agent assembly:
|
|
|
|
```python
|
|
def my_factory(ctx, agent_config):
|
|
# ctx: HookContext (session_id, agent_id, workspace_dir, ...)
|
|
# agent_config: AgentProfileConfig
|
|
#
|
|
# Return a MiddlewareBase instance to activate, or None to skip.
|
|
return MyMiddleware()
|
|
```
|
|
|
|
The returned middleware wraps the agent's inner reasoning loop using the
|
|
standard AgentScope 2.0 onion model (`on_reply`, `on_reasoning`, `on_acting`).
|
|
|
|
## Priority
|
|
|
|
Lower priority values run as the outermost layer (execute first on the way
|
|
in, last on the way out). The built-in middlewares use implicit ordering;
|
|
plugin middlewares append after them sorted by priority.
|