feat(FN-2262): merge fusion/fn-2262 (auto-resolved)

- feat(FN-2262): document Paperclip runtime configuration and constraints
- docs(FN-2261): update README with implementation details
- feat(FN-2261): add paperclip runtime resolution compatibility tests
- feat(FN-2261): add runtime adapter and registration tests
- feat(FN-2261): integrate adapter into plugin entrypoint
- feat(FN-2261): implement PaperclipRuntimeAdapter
- fix(FN-2261): remove pi-coding-agent re-exports from types.ts
- feat(FN-2261): define runtime types for Paperclip plugin
- feat(FN-2260): merge fusion/fn-2260

docs/getting-started.md

@@ -20,6 +20,30 @@ npm i -g @mariozechner/pi-coding-agent
 pi
 ```
 
+### Optional: Install the Paperclip Runtime Plugin
+
+The Paperclip Runtime Plugin (`fusion-plugin-paperclip-runtime`) provides an alternative runtime adapter for AI agents. It wraps the same `pi` backend but registers as a discoverable plugin runtime, enabling runtime selection at the agent level.
+
+To install the plugin:
+
+```bash
+fn plugin add ./plugins/fusion-plugin-paperclip-runtime
+```
+
+After installation, select the Paperclip runtime for an agent by setting `runtimeHint` in the agent's `runtimeConfig`:
+
+```json
+{
+  "name": "Paperclip Executor",
+  "role": "executor",
+  "runtimeConfig": {
+    "runtimeHint": "paperclip"
+  }
+}
+```
+
+For details on runtime selection, fallback behavior, and constraints, see the [Paperclip Runtime Plugin documentation](../plugins/fusion-plugin-paperclip-runtime/README.md).
+
 ## Install Fusion
 
 Install the published CLI package globally: