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

plugins/fusion-plugin-paperclip-runtime/src/__tests__/index.test.ts

@@ -52,13 +52,9 @@ describe("paperclip-runtime plugin", () => {
 
   describe("runtime factory invocation", () => {
     beforeEach(() => {
-      // Mock @fusion/engine for createFnAgent
-      vi.mock("@fusion/engine", () => ({
+      vi.mock("../../../../packages/engine/src/pi.js", () => ({
         createFnAgent: vi.fn().mockResolvedValue({ session: {} }),
         promptWithFallback: vi.fn(),
-      }));
-      // Mock describeModel
-      vi.mock("../../engine/src/pi.js", () => ({
         describeModel: vi.fn().mockReturnValue("mock/model"),
       }));
     });
@@ -73,7 +69,7 @@ describe("paperclip-runtime plugin", () => {
     });
 
     it("should return an adapter with correct id and name", async () => {
-      const runtime = await plugin.runtime!.factory({} as any);
+      const runtime = (await plugin.runtime!.factory({} as any)) as PaperclipRuntimeAdapter;
       expect(runtime.id).toBe("paperclip");
       expect(runtime.name).toBe("Paperclip Runtime");
     });

plugins/fusion-plugin-paperclip-runtime/src/__tests__/runtime-adapter.test.ts

@@ -9,18 +9,12 @@ import { PaperclipRuntimeAdapter } from "../runtime-adapter.js";
 
 // ── Mock Modules ────────────────────────────────────────────────────────────────
 
-// Mock @fusion/engine for createFnAgent and promptWithFallback
 const mockCreateFnAgent = vi.fn();
 const mockPromptWithFallback = vi.fn();
 
-vi.mock("@fusion/engine", () => ({
+vi.mock("../../../../packages/engine/src/pi.js", () => ({
   createFnAgent: mockCreateFnAgent,
   promptWithFallback: mockPromptWithFallback,
-}));
-
-// Mock the relative import of describeModel from pi.ts
-// This uses require() in the adapter, so we mock the entire module
-vi.mock("../../engine/src/pi.js", () => ({
   describeModel: vi.fn().mockReturnValue("mock/anthropic-claude"),
 }));
 
@@ -169,7 +163,7 @@ describe("PaperclipRuntimeAdapter", () => {
   describe("describeModel", () => {
     it("should return model description from pi describeModel", () => {
       // eslint-disable-next-line @typescript-eslint/no-require-imports
-      const { describeModel } = require("../../engine/src/pi.js");
+      const { describeModel } = require("../../../../packages/engine/src/pi.js");
 
       const mockSession = { model: { provider: "anthropic", id: "claude-sonnet-4-5" } };
       const result = adapter.describeModel(mockSession as any);