Paperclip Plugin Development

Build Paperclip plugins based on the actual SDK source code, validator source code, and examples. Follows lessons learned from real publishing failures.

SDK Version

@paperclipai/plugin-sdk is published on npm under calver (YYYY.MDD.patch), with a canary dist-tag for prereleases. Before starting work, run npm view @paperclipai/plugin-sdk version dist-tags exports --json, inspect the installed package exports, and pin the selected release in the project. Do not copy a remembered SDK version or entry-point list.

Critical Lessons — Read First

These mistakes have cost real time. Do not repeat them.

1. files field in package.json is REQUIRED

npm uses .gitignore to exclude files. Since dist/ is gitignored, built output will be absent unless explicitly declared: