mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-26 10:26:26 +01:00
Harold KimandPaperclip
98df214917
When reusing a Codex sandbox, the workspace-restore step now performs an auth-merge check before adopting the sandbox's auth.json. The merge fails closed when: - host or sandbox Codex auth is unusable (missing token or account) - the subscription payload shapes differ between host and sandbox - subscription account identities do not match Additional hardening: node absence on PATH during the embedded decision script now exits non-zero instead of silently falling through. Co-change comments link parseAuth (the embedded script) to hasUsableAuthPayload (codex-home.ts) so a future auth-format change cannot silently diverge between the two implementations. Co-Authored-By: Paperclip <noreply@paperclip.ing>
52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
---
|
|
title: HTTP Adapter
|
|
summary: HTTP webhook adapter
|
|
---
|
|
|
|
The `http` adapter sends a webhook request to an external agent service. The agent runs externally and Paperclip just triggers it.
|
|
|
|
## When to Use
|
|
|
|
- Agent runs as an external service (cloud function, dedicated server)
|
|
- Fire-and-forget invocation model
|
|
- Integration with third-party agent platforms
|
|
|
|
## When Not to Use
|
|
|
|
- If the agent runs locally on the same machine (use `process`, `claude_local`, or `codex_local`)
|
|
- If you need stdout capture and real-time run viewing
|
|
|
|
## Configuration
|
|
|
|
| Field | Type | Required | Description |
|
|
|-------|------|----------|-------------|
|
|
| `url` | string | Yes | Webhook URL to POST to |
|
|
| `headers` | object | No | Additional HTTP headers |
|
|
| `timeoutSec` | number | No | Request timeout |
|
|
|
|
## How It Works
|
|
|
|
1. Paperclip sends a POST request to the configured URL
|
|
2. The request body includes the execution context (agent ID, task info, wake reason)
|
|
3. The external agent processes the request and calls back to the Paperclip API
|
|
4. Response from the webhook is captured as the run result
|
|
|
|
## Request Body
|
|
|
|
The webhook receives a JSON payload with:
|
|
|
|
```json
|
|
{
|
|
"runId": "...",
|
|
"agentId": "...",
|
|
"companyId": "...",
|
|
"context": {
|
|
"taskId": "...",
|
|
"wakeReason": "...",
|
|
"commentId": "..."
|
|
}
|
|
}
|
|
```
|
|
|
|
The external agent uses `PAPERCLIP_API_URL` and an API key to call back to Paperclip.
|