mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-26 18:31:34 +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>
49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
# Plugin Orchestration Smoke Example
|
|
|
|
This first-party example validates the orchestration-grade plugin host surface.
|
|
It is intentionally small and exists as an acceptance fixture rather than a
|
|
product plugin.
|
|
|
|
## What it exercises
|
|
|
|
- `apiRoutes` under `/api/plugins/:pluginId/api/*`
|
|
- restricted database migrations and runtime `ctx.db`
|
|
- plugin-owned rows joined to `public.issues`
|
|
- plugin-created child issues with namespaced origin metadata
|
|
- billing codes, workspace inheritance, blocker relations, documents, wakeups,
|
|
and orchestration summaries
|
|
- issue detail and settings UI slots that surface route, capability, namespace,
|
|
and smoke status
|
|
|
|
## Development
|
|
|
|
```bash
|
|
pnpm install
|
|
pnpm typecheck
|
|
pnpm test
|
|
pnpm build
|
|
```
|
|
|
|
## Install Into Paperclip
|
|
|
|
Use an absolute local path during development:
|
|
|
|
```bash
|
|
curl -X POST http://127.0.0.1:3100/api/plugins/install \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"packageName":"/absolute/path/to/paperclip/packages/plugins/examples/plugin-orchestration-smoke-example","isLocalPath":true}'
|
|
```
|
|
|
|
## Scoped Route Smoke
|
|
|
|
After the plugin is ready, run the scoped route against an existing issue:
|
|
|
|
```bash
|
|
curl -X POST http://127.0.0.1:3100/api/plugins/paperclipai.plugin-orchestration-smoke-example/api/issues/<issue-id>/smoke \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"assigneeAgentId":"<agent-id>"}'
|
|
```
|
|
|
|
The route returns the generated child issue, resolved blocker, billing code,
|
|
subtree ids, and wakeup result.
|