@errand-ai/paperclip-adapter
v0.3.8
Published
Paperclip adapter for errand task execution engine
Readme
@errand-ai/paperclip-adapter
A Paperclip adapter that delegates agent task execution to Errand AI — a containerised task execution engine with MCP tool access, multi-model support, and configurable task profiles.
How it works
When Paperclip dispatches a task to an agent configured with this adapter:
- The adapter creates an errand task via MCP (
new_task) with the prompt and selected profile - Logs are streamed back to Paperclip in real-time via SSE
- Task status is polled until completion, review, or timeout
- The result is returned to Paperclip as an
AdapterExecutionResult
Errand task profiles map to Paperclip's model selector — each profile bundles a model, system prompt, max turns, and tool configuration.
Installation
paperclipai plugin install @errand-ai/paperclip-adapterOr install directly via npm:
npm install @errand-ai/paperclip-adapterConfiguration
Once installed, configure the adapter in Paperclip's agent settings:
| Field | Description |
|-------|-------------|
| Errand URL | Base URL of your errand instance (e.g. https://errand.example.com) |
| API Key | MCP API key for authenticating with errand |
| Timeout | Maximum execution time in seconds (default: 600) |
The Model dropdown will automatically populate with errand's available task profiles.
Prerequisites
- A running errand instance
- An MCP API key configured on the errand instance
- The errand instance must have the
paperclip-integration-apienhancements deployed (for SSE log streaming with API key auth)
Development
npm install
npm run lint # type-check
npm test # run tests
npm run build # compile to dist/License
Apache-2.0
