@pinepaper.studio/mcp-server 1.0.0

package/dist/__tests__/fixtures/mock-relations.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Mock Relations for Testing
+ */
+export declare const mockOrbitsRelation: {
+    sourceId: string;
+    targetId: string;
+    relationType: "orbits";
+    params: {
+        radius: number;
+        speed: number;
+        direction: "counterclockwise";
+        phase: number;
+    };
+};
+export declare const mockFollowsRelation: {
+    sourceId: string;
+    targetId: string;
+    relationType: "follows";
+    params: {
+        offset: [number, number];
+        smoothing: number;
+        delay: number;
+    };
+};
+export declare const mockAttachedToRelation: {
+    sourceId: string;
+    targetId: string;
+    relationType: "attached_to";
+    params: {
+        offset: [number, number];
+        inherit_rotation: boolean;
+    };
+};
+export declare const mockMaintainsDistanceRelation: {
+    sourceId: string;
+    targetId: string;
+    relationType: "maintains_distance";
+    params: {
+        distance: number;
+        strength: number;
+    };
+};
+export declare const mockPointsAtRelation: {
+    sourceId: string;
+    targetId: string;
+    relationType: "points_at";
+    params: {
+        offset_angle: number;
+        smoothing: number;
+    };
+};
+export declare const mockMirrorsRelation: {
+    sourceId: string;
+    targetId: string;
+    relationType: "mirrors";
+    params: {
+        axis: "vertical";
+        center: [number, number];
+    };
+};
+export declare const mockParallaxRelation: {
+    sourceId: string;
+    targetId: string;
+    relationType: "parallax";
+    params: {
+        depth: number;
+        origin: [number, number];
+    };
+};
+export declare const mockBoundsToRelation: {
+    sourceId: string;
+    targetId: string;
+    relationType: "bounds_to";
+    params: {
+        padding: number;
+        bounce: boolean;
+    };
+};
+export declare const allMockRelations: ({
+    sourceId: string;
+    targetId: string;
+    relationType: "orbits";
+    params: {
+        radius: number;
+        speed: number;
+        direction: "counterclockwise";
+        phase: number;
+    };
+} | {
+    sourceId: string;
+    targetId: string;
+    relationType: "follows";
+    params: {
+        offset: [number, number];
+        smoothing: number;
+        delay: number;
+    };
+} | {
+    sourceId: string;
+    targetId: string;
+    relationType: "attached_to";
+    params: {
+        offset: [number, number];
+        inherit_rotation: boolean;
+    };
+} | {
+    sourceId: string;
+    targetId: string;
+    relationType: "maintains_distance";
+    params: {
+        distance: number;
+        strength: number;
+    };
+} | {
+    sourceId: string;
+    targetId: string;
+    relationType: "points_at";
+    params: {
+        offset_angle: number;
+        smoothing: number;
+    };
+} | {
+    sourceId: string;
+    targetId: string;
+    relationType: "mirrors";
+    params: {
+        axis: "vertical";
+        center: [number, number];
+    };
+} | {
+    sourceId: string;
+    targetId: string;
+    relationType: "parallax";
+    params: {
+        depth: number;
+        origin: [number, number];
+    };
+} | {
+    sourceId: string;
+    targetId: string;
+    relationType: "bounds_to";
+    params: {
+        padding: number;
+        bounce: boolean;
+    };
+})[];
+//# sourceMappingURL=mock-relations.d.ts.map

package/dist/__tests__/fixtures/mock-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-relations.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/mock-relations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;CAU9B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;gBAKR,CAAC,MAAM,EAAE,MAAM,CAAC;;;;CAIvC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;gBAKX,CAAC,MAAM,EAAE,MAAM,CAAC;;;CAGvC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;CAQzC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;CAQhC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;gBAMN,CAAC,MAAM,EAAE,MAAM,CAAC;;CAEzC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;gBAMP,CAAC,MAAM,EAAE,MAAM,CAAC;;CAEzC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;CAQhC,CAAC;AAGF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;gBAnEL,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;gBAWhB,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;gBA+Bd,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;gBAUhB,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;IAwBzC,CAAC"}

package/dist/__tests__/fixtures/mock-relations.js

@@ -0,0 +1,90 @@
+/**
+ * Mock Relations for Testing
+ */
+export const mockOrbitsRelation = {
+    sourceId: 'item_2',
+    targetId: 'item_1',
+    relationType: 'orbits',
+    params: {
+        radius: 150,
+        speed: 0.5,
+        direction: 'counterclockwise',
+        phase: 0,
+    },
+};
+export const mockFollowsRelation = {
+    sourceId: 'item_3',
+    targetId: 'item_1',
+    relationType: 'follows',
+    params: {
+        offset: [0, -50],
+        smoothing: 0.1,
+        delay: 0.2,
+    },
+};
+export const mockAttachedToRelation = {
+    sourceId: 'label_1',
+    targetId: 'item_1',
+    relationType: 'attached_to',
+    params: {
+        offset: [0, -70],
+        inherit_rotation: false,
+    },
+};
+export const mockMaintainsDistanceRelation = {
+    sourceId: 'item_4',
+    targetId: 'item_1',
+    relationType: 'maintains_distance',
+    params: {
+        distance: 200,
+        strength: 0.8,
+    },
+};
+export const mockPointsAtRelation = {
+    sourceId: 'arrow_1',
+    targetId: 'target_1',
+    relationType: 'points_at',
+    params: {
+        offset_angle: 0,
+        smoothing: 0.2,
+    },
+};
+export const mockMirrorsRelation = {
+    sourceId: 'reflection_1',
+    targetId: 'original_1',
+    relationType: 'mirrors',
+    params: {
+        axis: 'vertical',
+        center: [400, 300],
+    },
+};
+export const mockParallaxRelation = {
+    sourceId: 'bg_element',
+    targetId: 'camera',
+    relationType: 'parallax',
+    params: {
+        depth: 0.5,
+        origin: [400, 300],
+    },
+};
+export const mockBoundsToRelation = {
+    sourceId: 'player',
+    targetId: 'arena',
+    relationType: 'bounds_to',
+    params: {
+        padding: 20,
+        bounce: true,
+    },
+};
+// Collection of all mock relations
+export const allMockRelations = [
+    mockOrbitsRelation,
+    mockFollowsRelation,
+    mockAttachedToRelation,
+    mockMaintainsDistanceRelation,
+    mockPointsAtRelation,
+    mockMirrorsRelation,
+    mockParallaxRelation,
+    mockBoundsToRelation,
+];
+//# sourceMappingURL=mock-relations.js.map

package/dist/__tests__/fixtures/mock-relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-relations.js","sourceRoot":"","sources":["../../../src/__tests__/fixtures/mock-relations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,QAAQ;IAClB,YAAY,EAAE,QAAiB;IAC/B,MAAM,EAAE;QACN,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,SAAS,EAAE,kBAA2B;QACtC,KAAK,EAAE,CAAC;KACT;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,QAAQ;IAClB,YAAY,EAAE,SAAkB;IAChC,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAqB;QACpC,SAAS,EAAE,GAAG;QACd,KAAK,EAAE,GAAG;KACX;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,QAAQ;IAClB,YAAY,EAAE,aAAsB;IACpC,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAqB;QACpC,gBAAgB,EAAE,KAAK;KACxB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,QAAQ;IAClB,YAAY,EAAE,oBAA6B;IAC3C,MAAM,EAAE;QACN,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE,GAAG;KACd;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,WAAoB;IAClC,MAAM,EAAE;QACN,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,GAAG;KACf;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,YAAY;IACtB,YAAY,EAAE,SAAkB;IAChC,MAAM,EAAE;QACN,IAAI,EAAE,UAAmB;QACzB,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAqB;KACvC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,QAAQ;IAClB,YAAY,EAAE,UAAmB;IACjC,MAAM,EAAE;QACN,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAqB;KACvC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,OAAO;IACjB,YAAY,EAAE,WAAoB;IAClC,MAAM,EAAE;QACN,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,IAAI;KACb;CACF,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,kBAAkB;IAClB,mBAAmB;IACnB,sBAAsB;IACtB,6BAA6B;IAC7B,oBAAoB;IACpB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;CACrB,CAAC"}

package/dist/browser/bridge.d.ts

@@ -0,0 +1,127 @@
+/**
+ * PinePaper Browser Bridge
+ *
+ * postMessage interface for communication between PinePaper Studio (iframe/window)
+ * and the MCP server or external clients.
+ *
+ * This bridge enables:
+ * 1. Direct browser-to-PinePaper communication (no MCP required)
+ * 2. MCP server to PinePaper communication via postMessage relay
+ * 3. Cross-origin iframe communication for embedded PinePaper
+ */
+export interface BridgeMessage {
+    type: 'mcp-request' | 'mcp-response' | 'execute-code' | 'code-result' | 'ping' | 'pong';
+    id: string;
+    payload: unknown;
+    source: 'mcp-bridge' | 'pinepaper-studio';
+}
+export interface BridgeConfig {
+    targetOrigin: string;
+    targetWindow?: Window;
+    timeout?: number;
+    onReady?: () => void;
+    onError?: (error: Error) => void;
+}
+export interface PendingRequest {
+    resolve: (value: unknown) => void;
+    reject: (error: Error) => void;
+    timeout: ReturnType<typeof setTimeout>;
+}
+/**
+ * PinePaper Browser Bridge
+ *
+ * Provides a postMessage-based interface for communicating with PinePaper Studio.
+ * Can be used standalone in the browser or integrated with an MCP server.
+ */
+export declare class PinePaperBridge {
+    private config;
+    private pendingRequests;
+    private isReady;
+    private readyPromise;
+    private readyResolve;
+    private messageHandler;
+    constructor(config: BridgeConfig);
+    /**
+     * Wait for the bridge to be ready
+     */
+    waitForReady(): Promise<void>;
+    /**
+     * Check if bridge is connected
+     */
+    get connected(): boolean;
+    /**
+     * Send a ping to establish connection
+     */
+    private ping;
+    /**
+     * Handle incoming messages
+     */
+    private handleMessage;
+    /**
+     * Handle pong response (connection established)
+     */
+    private handlePong;
+    /**
+     * Handle response messages
+     */
+    private handleResponse;
+    /**
+     * Send a message to PinePaper Studio
+     */
+    private postMessage;
+    /**
+     * Generate unique message ID
+     */
+    private generateId;
+    /**
+     * Execute code in PinePaper Studio
+     */
+    executeCode(code: string): Promise<unknown>;
+    /**
+     * Send an MCP tool request to PinePaper Studio
+     */
+    sendToolRequest(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+/**
+ * Message handler for PinePaper Studio side
+ *
+ * Install this in PinePaper Studio to handle incoming bridge messages.
+ */
+export declare class PinePaperStudioHandler {
+    private allowedOrigins;
+    private messageHandler;
+    constructor(allowedOrigins?: string[]);
+    /**
+     * Handle incoming messages
+     */
+    private handleMessage;
+    /**
+     * Handle ping message
+     */
+    private handlePing;
+    /**
+     * Handle code execution request
+     */
+    private handleExecuteCode;
+    /**
+     * Handle MCP tool request
+     */
+    private handleMCPRequest;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+/**
+ * Create a bridge to communicate with PinePaper Studio
+ */
+export declare function createBridge(config: BridgeConfig): PinePaperBridge;
+/**
+ * Create a handler for PinePaper Studio side
+ */
+export declare function createStudioHandler(allowedOrigins?: string[]): PinePaperStudioHandler;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/browser/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/browser/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,cAAc,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;IACxF,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACxC;AAMD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAgC;gBAE1C,MAAM,EAAE,YAAY;IAqBhC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;IASZ;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBjD;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBxF;;OAEG;IACH,OAAO,IAAI,IAAI;CAUhB;AAMD;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,cAAc,CAAgC;gBAE1C,cAAc,GAAE,MAAM,EAAU;IAM5C;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;YACW,iBAAiB;IAqC/B;;OAEG;YACW,gBAAgB;IAwC9B;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAElE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAErF"}

package/dist/browser/bridge.js

@@ -0,0 +1,320 @@
+/**
+ * PinePaper Browser Bridge
+ *
+ * postMessage interface for communication between PinePaper Studio (iframe/window)
+ * and the MCP server or external clients.
+ *
+ * This bridge enables:
+ * 1. Direct browser-to-PinePaper communication (no MCP required)
+ * 2. MCP server to PinePaper communication via postMessage relay
+ * 3. Cross-origin iframe communication for embedded PinePaper
+ */
+// =============================================================================
+// BROWSER BRIDGE CLASS
+// =============================================================================
+/**
+ * PinePaper Browser Bridge
+ *
+ * Provides a postMessage-based interface for communicating with PinePaper Studio.
+ * Can be used standalone in the browser or integrated with an MCP server.
+ */
+export class PinePaperBridge {
+    config;
+    pendingRequests = new Map();
+    isReady = false;
+    readyPromise;
+    readyResolve;
+    messageHandler;
+    constructor(config) {
+        this.config = {
+            targetWindow: window.parent,
+            timeout: 30000,
+            onReady: () => { },
+            onError: () => { },
+            ...config,
+        };
+        this.readyPromise = new Promise((resolve) => {
+            this.readyResolve = resolve;
+        });
+        // Bind message handler
+        this.messageHandler = this.handleMessage.bind(this);
+        window.addEventListener('message', this.messageHandler);
+        // Send initial ping
+        this.ping();
+    }
+    /**
+     * Wait for the bridge to be ready
+     */
+    async waitForReady() {
+        return this.readyPromise;
+    }
+    /**
+     * Check if bridge is connected
+     */
+    get connected() {
+        return this.isReady;
+    }
+    /**
+     * Send a ping to establish connection
+     */
+    ping() {
+        this.postMessage({
+            type: 'ping',
+            id: this.generateId(),
+            payload: { timestamp: Date.now() },
+            source: 'mcp-bridge',
+        });
+    }
+    /**
+     * Handle incoming messages
+     */
+    handleMessage(event) {
+        // Validate origin
+        if (this.config.targetOrigin !== '*' && event.origin !== this.config.targetOrigin) {
+            return;
+        }
+        const message = event.data;
+        if (!message || !message.type || message.source === 'mcp-bridge') {
+            return;
+        }
+        switch (message.type) {
+            case 'pong':
+                this.handlePong();
+                break;
+            case 'mcp-response':
+            case 'code-result':
+                this.handleResponse(message);
+                break;
+            default:
+                // Ignore unknown message types
+                break;
+        }
+    }
+    /**
+     * Handle pong response (connection established)
+     */
+    handlePong() {
+        if (!this.isReady) {
+            this.isReady = true;
+            this.readyResolve();
+            this.config.onReady();
+        }
+    }
+    /**
+     * Handle response messages
+     */
+    handleResponse(message) {
+        const pending = this.pendingRequests.get(message.id);
+        if (!pending) {
+            return;
+        }
+        clearTimeout(pending.timeout);
+        this.pendingRequests.delete(message.id);
+        const payload = message.payload;
+        if (payload.error) {
+            pending.reject(new Error(payload.error));
+        }
+        else {
+            pending.resolve(payload.result);
+        }
+    }
+    /**
+     * Send a message to PinePaper Studio
+     */
+    postMessage(message) {
+        this.config.targetWindow.postMessage(message, this.config.targetOrigin);
+    }
+    /**
+     * Generate unique message ID
+     */
+    generateId() {
+        return `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Execute code in PinePaper Studio
+     */
+    async executeCode(code) {
+        if (!this.isReady) {
+            await this.waitForReady();
+        }
+        const id = this.generateId();
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error('Request timeout'));
+            }, this.config.timeout);
+            this.pendingRequests.set(id, { resolve, reject, timeout });
+            this.postMessage({
+                type: 'execute-code',
+                id,
+                payload: { code },
+                source: 'mcp-bridge',
+            });
+        });
+    }
+    /**
+     * Send an MCP tool request to PinePaper Studio
+     */
+    async sendToolRequest(toolName, args) {
+        if (!this.isReady) {
+            await this.waitForReady();
+        }
+        const id = this.generateId();
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error('Request timeout'));
+            }, this.config.timeout);
+            this.pendingRequests.set(id, { resolve, reject, timeout });
+            this.postMessage({
+                type: 'mcp-request',
+                id,
+                payload: { tool: toolName, arguments: args },
+                source: 'mcp-bridge',
+            });
+        });
+    }
+    /**
+     * Clean up resources
+     */
+    destroy() {
+        window.removeEventListener('message', this.messageHandler);
+        // Cancel all pending requests
+        for (const [id, pending] of this.pendingRequests) {
+            clearTimeout(pending.timeout);
+            pending.reject(new Error('Bridge destroyed'));
+            this.pendingRequests.delete(id);
+        }
+    }
+}
+// =============================================================================
+// PINEPAPER STUDIO HANDLER (runs inside PinePaper)
+// =============================================================================
+/**
+ * Message handler for PinePaper Studio side
+ *
+ * Install this in PinePaper Studio to handle incoming bridge messages.
+ */
+export class PinePaperStudioHandler {
+    allowedOrigins;
+    messageHandler;
+    constructor(allowedOrigins = ['*']) {
+        this.allowedOrigins = allowedOrigins;
+        this.messageHandler = this.handleMessage.bind(this);
+        window.addEventListener('message', this.messageHandler);
+    }
+    /**
+     * Handle incoming messages
+     */
+    handleMessage(event) {
+        // Validate origin
+        if (!this.allowedOrigins.includes('*') &&
+            !this.allowedOrigins.includes(event.origin)) {
+            return;
+        }
+        const message = event.data;
+        if (!message || !message.type || message.source !== 'mcp-bridge') {
+            return;
+        }
+        switch (message.type) {
+            case 'ping':
+                this.handlePing(event.source, event.origin);
+                break;
+            case 'execute-code':
+                this.handleExecuteCode(message, event.source, event.origin);
+                break;
+            case 'mcp-request':
+                this.handleMCPRequest(message, event.source, event.origin);
+                break;
+        }
+    }
+    /**
+     * Handle ping message
+     */
+    handlePing(source, origin) {
+        source.postMessage({
+            type: 'pong',
+            id: `pong_${Date.now()}`,
+            payload: { timestamp: Date.now() },
+            source: 'pinepaper-studio',
+        }, origin);
+    }
+    /**
+     * Handle code execution request
+     */
+    async handleExecuteCode(message, source, origin) {
+        const { code } = message.payload;
+        try {
+            // Execute the code in PinePaper context
+            // eslint-disable-next-line no-eval
+            const result = await eval(`(async () => { ${code} })()`);
+            source.postMessage({
+                type: 'code-result',
+                id: message.id,
+                payload: { success: true, result },
+                source: 'pinepaper-studio',
+            }, origin);
+        }
+        catch (error) {
+            source.postMessage({
+                type: 'code-result',
+                id: message.id,
+                payload: {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                },
+                source: 'pinepaper-studio',
+            }, origin);
+        }
+    }
+    /**
+     * Handle MCP tool request
+     */
+    async handleMCPRequest(message, source, origin) {
+        const { tool, arguments: args } = message.payload;
+        try {
+            // Import and use the handler
+            const { handleToolCall } = await import('../tools/handlers.js');
+            const result = await handleToolCall(tool, args);
+            source.postMessage({
+                type: 'mcp-response',
+                id: message.id,
+                payload: { success: true, result },
+                source: 'pinepaper-studio',
+            }, origin);
+        }
+        catch (error) {
+            source.postMessage({
+                type: 'mcp-response',
+                id: message.id,
+                payload: {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                },
+                source: 'pinepaper-studio',
+            }, origin);
+        }
+    }
+    /**
+     * Clean up resources
+     */
+    destroy() {
+        window.removeEventListener('message', this.messageHandler);
+    }
+}
+// =============================================================================
+// FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Create a bridge to communicate with PinePaper Studio
+ */
+export function createBridge(config) {
+    return new PinePaperBridge(config);
+}
+/**
+ * Create a handler for PinePaper Studio side
+ */
+export function createStudioHandler(allowedOrigins) {
+    return new PinePaperStudioHandler(allowedOrigins);
+}
+//# sourceMappingURL=bridge.js.map