mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-06 10:48:12 +02:00
a8d32e5e61
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work > - Agent work runs in sandboxes that provider plugins supply > - Operators can choose a provider to run agent work > - CreateOS adds another provider with workspace-preserving pause and resume > - This pull request adds a CreateOS provider plugin > - The benefit is that operators can preserve a workspace between runs without keeping its compute active ## Linked Issues or Issue Description Refs #13203 and the earlier closed #13096. This continues the CreateOS contribution from @bhautikchudasama and @ashwaq06. The branch preserves the original implementation commit. Thank you to both contributors. When squash-merging, preserve the original author's credit in the squash commit body: ```text Co-Authored-By: bhautikchudasama <BhautikChudasama@users.noreply.github.com> ``` The original fork rejects maintainer pushes. This branch includes the merge-conflict resolution and review fixes. The request is described below using `adapter_request.yml`. **Agent or provider** CreateOS sandbox API (https://api.sb.createos.sh). **Why this adapter is useful** CreateOS can pause a sandbox and resume it by ID. The workspace survives the pause. This adds a reusable-lease option to the existing sandbox provider system. **How the agent is invoked** Build and install the local plugin as described in its README. Open Instance Settings, then Environments. Select the `createos` driver. Supply an API key and shape. The driver then supplies sandbox leases for agent runs. **Are you willing to implement it?** Yes. This pull request is the implementation. ## What Changed - Adds the `createos` sandbox provider under `packages/plugins/sandbox-providers/createos`. - Calls the CreateOS HTTP API directly. The package adds no vendor SDK. - Implements the environment lifecycle hooks, incremental process output, and binary workspace sync. - Registers the optional bundled provider and its trusted host credential fallback. The fallback is limited to the official API origin; custom endpoints require an explicit key. - Lists the package in the release manifest with `publishFromCi: false` until its first npm publish is bootstrapped. - Waits through delayed pause/resume state updates without duplicate action requests. - Cancels queued API requests promptly while preserving request spacing. - Uses direct CLI invocation in the setup guide so paths and IDs are passed without an extra shell expansion. - Includes current master and retains its existing Git-subfolder containment fix. ## Demo Fresh setup and a run against a CreateOS sandbox. https://github.com/user-attachments/assets/e71b9e06-c006-4fb9-b847-52dfd68f6110 https://github.com/user-attachments/assets/43b5ac75-66bd-4f76-8563-67e4c7759084 ## Verification All 25 jobs in [CI run 34884260542](https://github.com/paperclipai/paperclip/actions/runs/34884260542) passed at commit `f8d0997677024b784fdadf9d44a84c01cb4e813c`, including typecheck, build, native runner verification, server and workspace tests, browser tests, and the canary release dry run. Greptile reviewed the same commit at 5/5 with no unresolved review threads. GitHub reports no merge conflicts. The remaining merge gate is code-owner approval for the new `package.json`, as required by `.github/CODEOWNERS` and the `master` ruleset. Reviewers have been requested automatically. Local checks passed: - Provider: `pnpm typecheck`, `pnpm test` (52 passed, one live smoke skipped), and `pnpm build`. - Host: focused credential and bundled-plugin tests (17 passed), plus CLI invocation safety (39 passed). - Release: package manifest check and release policy tests (18 passed). The full local `pnpm test:run` attempt caught the README command issue; its focused rerun now passes. The full local run stopped after its general-server group: 7,804 tests passed, with unrelated embedded PostgreSQL startup failures and 10 failures in unchanged runtime-skill-cache tests (`EACCES` on directory rename on macOS). It did not reach the later test groups. Local `pnpm -r typecheck` and `pnpm build` reach the runner package and stop because this machine has no Rust/Cargo installation. The corresponding CI checks passed on provisioned runners, as linked above. The live CreateOS smoke requires explicit provider credentials and was not run during this review. It is available with `CREATEOS_LIVE_TEST=1 pnpm test` in the provider directory. The author supplied the demo links above. ## Risks The provider is opt-in and is not installed by default. It is available through a local-path install or explicit image inclusion. npm publication remains disabled until a maintainer bootstraps the package and enables publishing. Sandbox creation has no idempotency key. An ambiguous create response can leave a resource that requires provider-account inspection. Process tracking is in memory; durable lease recovery belongs to the host. The provider does not advertise guaranteed expiry, interactive login, snapshots, duplex channels, or ingress. Live native-runner qualification remains outside this PR's tested claims. ## Model Used Original provider implementation: human-authored by @bhautikchudasama, as reported in #13203. The original description reports Claude Opus 5 assistance. Review and follow-up fixes: OpenAI GPT-6 via Codex, with code review, editing, and tool execution. The precise runtime model variant and context-window size are not exposed in this session. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass (focused checks; full-suite environment limits documented above) - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [x] All Paperclip CI gates are green - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: bhautikchudasama <bhautikrchudasama@gmail.com> Co-authored-by: Paperclip <noreply@paperclip.ing>
173 lines
4.1 KiB
JSON
173 lines
4.1 KiB
JSON
[
|
|
{
|
|
"dir": "packages/adapter-utils",
|
|
"name": "@paperclipai/adapter-utils",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/claude-local",
|
|
"name": "@paperclipai/adapter-claude-local",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/codex-local",
|
|
"name": "@paperclipai/adapter-codex-local",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/cursor-cloud",
|
|
"name": "@paperclipai/adapter-cursor-cloud",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/cursor-local",
|
|
"name": "@paperclipai/adapter-cursor-local",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/gemini-local",
|
|
"name": "@paperclipai/adapter-gemini-local",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/grok-local",
|
|
"name": "@paperclipai/adapter-grok-local",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/hermes",
|
|
"name": "@paperclipai/hermes-paperclip-adapter",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/hermes-gateway",
|
|
"name": "@paperclipai/adapter-hermes-gateway",
|
|
"publishFromCi": false
|
|
},
|
|
{
|
|
"dir": "packages/adapters/kimi-local",
|
|
"name": "@paperclipai/adapter-kimi-local",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/opencode-local",
|
|
"name": "@paperclipai/adapter-opencode-local",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/pi-local",
|
|
"name": "@paperclipai/adapter-pi-local",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/adapters/openclaw-gateway",
|
|
"name": "@paperclipai/adapter-openclaw-gateway",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/shared",
|
|
"name": "@paperclipai/shared",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/skills-catalog",
|
|
"name": "@paperclipai/skills-catalog",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/teams-catalog",
|
|
"name": "@paperclipai/teams-catalog",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/db",
|
|
"name": "@paperclipai/db",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sdk",
|
|
"name": "@paperclipai/plugin-sdk",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/plugin-workspace-diff",
|
|
"name": "@paperclipai/plugin-workspace-diff",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "server",
|
|
"name": "@paperclipai/server",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "cli",
|
|
"name": "paperclipai",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/mcp-server",
|
|
"name": "@paperclipai/mcp-server",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/google-sheets-mcp-server",
|
|
"name": "@paperclipai/google-sheets-mcp-server",
|
|
"publishFromCi": false
|
|
},
|
|
{
|
|
"dir": "packages/kv-demo-mcp-server",
|
|
"name": "@paperclipai/kv-demo-mcp-server",
|
|
"publishFromCi": false
|
|
},
|
|
{
|
|
"dir": "packages/plugins/create-paperclip-plugin",
|
|
"name": "@paperclipai/create-paperclip-plugin",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sandbox-providers/cloudflare",
|
|
"name": "@paperclipai/plugin-cloudflare-sandbox",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sandbox-providers/createos",
|
|
"name": "@paperclipai/plugin-createos",
|
|
"publishFromCi": false
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sandbox-providers/daytona",
|
|
"name": "@paperclipai/plugin-daytona",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sandbox-providers/exe-dev",
|
|
"name": "@paperclipai/plugin-exe-dev",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sandbox-providers/e2b",
|
|
"name": "@paperclipai/plugin-e2b",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sandbox-providers/modal",
|
|
"name": "@paperclipai/plugin-modal",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sandbox-providers/kubernetes",
|
|
"name": "@paperclipai/plugin-kubernetes",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "packages/plugins/sandbox-providers/novita",
|
|
"name": "@paperclipai/plugin-novita-sandbox",
|
|
"publishFromCi": true
|
|
},
|
|
{
|
|
"dir": "ui",
|
|
"name": "@paperclipai/ui",
|
|
"publishFromCi": true
|
|
}
|
|
]
|