Skip to content

feat(paperclip): replace library with Paperclip plugin (v0.2.0)#934

Merged
nicoloboschi merged 3 commits into
mainfrom
feat/paperclip-plugin-replace
Apr 15, 2026
Merged

feat(paperclip): replace library with Paperclip plugin (v0.2.0)#934
nicoloboschi merged 3 commits into
mainfrom
feat/paperclip-plugin-replace

Conversation

@benfrank241

Copy link
Copy Markdown
Member

Summary

  • Replaces the `@vectorize-io/hindsight-paperclip` npm library with a proper Paperclip plugin
  • Works with all adapter types (Claude, Codex, Cursor, HTTP, Process) via the event system — no code changes required by operators
  • Install once: `pnpm paperclipai plugin install @vectorize-io/hindsight-paperclip`

What Changed

Before After
npm library — developers manually call `recall()`/`retain()` Paperclip plugin — hooks fire automatically
HTTP adapter agents only All adapter types
Requires code changes per agent Install once, covers all agents

Hooks

Trigger Action
`agent.run.started` Recalls relevant memories, caches in plugin state
`agent.run.finished` Auto-retains agent output with `runId` as document ID
`hindsight_recall` tool Mid-run memory query (returns cache or live recall)
`hindsight_retain` tool Mid-run memory store
`onValidateConfig` Live connectivity check on save

Test plan

  • 15 unit tests passing (`npm test`)
  • Build passes (`npm run build`)
  • Manual: install plugin in a local Paperclip instance and verify recall/retain fire

Closes #918

Replaces the @vectorize-io/hindsight-paperclip npm library with a proper
Paperclip plugin. Works with all adapter types (Claude, Codex, Cursor, HTTP,
Process) via the event system — no code changes required by operators.

- Auto-recalls on agent.run.started, auto-retains on agent.run.finished
- hindsight_recall and hindsight_retain agent tools for mid-run access
- onValidateConfig with live connectivity check
- 15 tests passing

@nicoloboschi nicoloboschi left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@nicoloboschi nicoloboschi merged commit c571fac into main Apr 15, 2026
45 checks passed
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