Actors and Adapters
Register actors and connect them to the system through adapters.
Overview
An actor is anyone who participates — a person, an AI agent, or an automated service. An adapter is how the system reaches the actor — a CLI process, an API endpoint, or a webhook.
Register an Actor
spl actor register did:sync:agent:reviewer --display-name ReviewerView all registered actors:
spl actor listDID DISPLAY CATEGORY STATUS TRUST
did:sync:user:alice alice user active code: 0.47
did:sync:agent:dev Dev agent active code: 0.30
did:sync:agent:reviewer Reviewer agent active —Actor Categories
| Category | Purpose | Examples |
|---|---|---|
user | Human participant | Team members |
agent | AI-powered actor | Development agents, review bots |
sa | Service account | CI pipelines, monitoring |
system | Engine component | Internal system actors |
Bind an Adapter
Adapters connect actors to the system. Register one:
spl adapter add did:sync:agent:dev \
--family cli \
--binary claude \
--timeout 600Adapter families:
| Family | How It Works | Use Case |
|---|---|---|
cli | Spawns a CLI process | AI agents (Claude Code, Codex CLI, OpenCode, Pi, etc.) |
proxy | HTTP API call | Remote services, webhooks |
View Adapters
spl adapter listSet Your Identity
Switch the active actor for your session:
spl actor use aliceThis updates your local configuration. All subsequent commands are attributed to the selected actor.
Trust Profiles
Each actor accumulates trust per domain:
spl actor show devActor: Dev
DID: did:sync:agent:dev
Category: agent
Status: active
Trust Profile:
code 0.299 (5/5) ADAPTTrust grows from approved work. The domain, success count, total observations, and current zone are visible.
Export and Import
Move an actor's profile between instances:
# Export (includes identity, trust, memories)
spl actor export dev > dev-bundle.json
# Import on another instance (trust is discounted for safety)
spl actor import dev-bundle.json --trust-discount 0.5What's Next
- Routing rules — control how work flows to actors
- Task management — assign and track work
- Actors concept — identity model in depth
Orchestration Patterns
The six canonical multi-step patterns — single_shot, verify, waterfall, retry_on_low_confidence, escalate, ensemble_with_audit — and how to compose them via nested queries when nothing fits.
Agent Integration
Connect AI agents to Syncropel — dispatch work, track outcomes, and build trust.