docs(plugins): refresh bundled plugin runtime docs

This commit is contained in:
Peter Steinberger
2026-03-29 09:09:56 +01:00
parent caeeecf399
commit 341e617c84
37 changed files with 245 additions and 280 deletions

View File

@@ -88,7 +88,7 @@ src/agents/
├── pi-tools.types.ts # AnyAgentTool type alias
├── pi-tool-definition-adapter.ts # AgentTool -> ToolDefinition adapter
├── pi-settings.ts # Settings overrides
├── pi-extensions/ # Custom pi extensions
├── pi-hooks/ # Custom pi hooks
│ ├── compaction-safeguard.ts # Safeguard extension
│ ├── compaction-safeguard-runtime.ts
│ ├── context-pruning.ts # Cache-TTL context pruning extension
@@ -132,10 +132,10 @@ src/agents/
Channel-specific message action runtimes now live in the plugin-owned extension
directories instead of under `src/agents/tools`, for example:
- `extensions/discord/src/actions/runtime*.ts`
- `extensions/slack/src/action-runtime.ts`
- `extensions/telegram/src/action-runtime.ts`
- `extensions/whatsapp/src/action-runtime.ts`
- the Discord plugin action runtime files
- the Slack plugin action runtime file
- the Telegram plugin action runtime file
- the WhatsApp plugin action runtime file
## Core Integration Flow
@@ -390,7 +390,7 @@ OpenClaw loads custom pi extensions for specialized behavior:
### Compaction Safeguard
`src/agents/pi-extensions/compaction-safeguard.ts` adds guardrails to compaction, including adaptive token budgeting plus tool failure and file operation summaries:
`src/agents/pi-hooks/compaction-safeguard.ts` adds guardrails to compaction, including adaptive token budgeting plus tool failure and file operation summaries:
```typescript
if (resolveCompactionMode(params.cfg) === "safeguard") {
@@ -401,7 +401,7 @@ if (resolveCompactionMode(params.cfg) === "safeguard") {
### Context Pruning
`src/agents/pi-extensions/context-pruning.ts` implements cache-TTL based context pruning:
`src/agents/pi-hooks/context-pruning.ts` implements cache-TTL based context pruning:
```typescript
if (cfg?.agents?.defaults?.contextPruning?.mode === "cache-ttl") {
@@ -558,7 +558,7 @@ Pi integration coverage spans these suites:
- `src/agents/pi-tools*.test.ts`
- `src/agents/pi-tool-definition-adapter*.test.ts`
- `src/agents/pi-settings.test.ts`
- `src/agents/pi-extensions/**/*.test.ts`
- `src/agents/pi-hooks/**/*.test.ts`
Live/opt-in: