Skip to content

Add Paperclip backend option and gateway adapter#117

Draft
iamlukethedev wants to merge 2 commits into
mainfrom
cursor/-bc-9f84cf49-7daa-4bb7-92fe-333621d48e64-fef4
Draft

Add Paperclip backend option and gateway adapter#117
iamlukethedev wants to merge 2 commits into
mainfrom
cursor/-bc-9f84cf49-7daa-4bb7-92fe-333621d48e64-fef4

Conversation

@iamlukethedev

@iamlukethedev iamlukethedev commented Apr 10, 2026

Copy link
Copy Markdown
Owner

Summary

  • add paperclip as a first-class Studio/runtime adapter type across settings normalization, gateway connection handling, and runtime provider creation
  • add a dedicated Paperclip runtime provider and a new bundled WebSocket adapter at server/paperclip-gateway-adapter.js
  • expose Paperclip in connection UIs (connect screen, floating connection panel, office settings panel) with local preset URL defaults
  • document setup (README.md, docs/paperclip-gateway.md, cross-link from Hermes doc) and add npm run paperclip-adapter
  • add targeted unit coverage for adapter-type normalization/defaulting and gateway profile restore behavior
  • harden Paperclip adapter handshake flow by wrapping connect request handling in exception-safe logic so upstream setup failures return internal_error responses instead of dropping the socket

Scope notes

  • adapter currently supports core read/chat surfaces needed for office visibility (agents.list, sessions.*, chat.*, status, models.list, config/approvals shims)
  • unsupported write-heavy surfaces return explicit not_implemented responses for clear UI behavior

Testing

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

cursoragent and others added 2 commits April 10, 2026 15:28
Co-authored-by: Luke The Dev <iamlukethedev@users.noreply.github.com>
Co-authored-by: Luke The Dev <iamlukethedev@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants