mirror of https://github.com/openclaw/openclaw.git
docs(plugins): add execution spine contract, health schema, handoff packet, retry/dead-letter policy
This commit is contained in:
parent
14137bef22
commit
59bfbb0c55
|
|
@ -0,0 +1,12 @@
|
|||
# Plugin Execution Spine Contract (v1)
|
||||
|
||||
## Flow
|
||||
`propose -> approve(if risky) -> execute -> verify`
|
||||
|
||||
## ACK-first
|
||||
Actionable requests SHOULD emit immediate ACK before long-running work.
|
||||
|
||||
## Goals
|
||||
- Lean core, stronger plugins
|
||||
- Predictable safety behavior
|
||||
- Auditable execution trail
|
||||
|
|
@ -0,0 +1,13 @@
|
|||
# Resumable Handoff Packet (v1)
|
||||
|
||||
## Purpose
|
||||
Allow model/agent/plugin swap mid-run without continuity loss.
|
||||
|
||||
## Core fields
|
||||
- `runId`
|
||||
- `goalId`
|
||||
- `currentStep`
|
||||
- `acceptance`
|
||||
- `artifacts[]`
|
||||
- `status`
|
||||
- `updatedAt`
|
||||
|
|
@ -0,0 +1,12 @@
|
|||
# Plugin Health Schema (v1)
|
||||
|
||||
## Status enum
|
||||
- `healthy`
|
||||
- `degraded`
|
||||
- `blocked`
|
||||
|
||||
## Required fields
|
||||
- `status`
|
||||
- `lastError` (nullable)
|
||||
- `nextAction` (nullable)
|
||||
- `updatedAt`
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
# Retry + Dead-letter Policy (v1)
|
||||
|
||||
## Retry
|
||||
- Bounded retries only (no infinite loops)
|
||||
- Explicit retry count + backoff
|
||||
|
||||
## Dead-letter
|
||||
- Failed items after max retries move to dead-letter queue
|
||||
- Must include failure reason + next operator action
|
||||
Loading…
Reference in New Issue