@efectoapp/mcp-studio 0.1.0

package/dist/tools/session.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Studio Session Tools
+ *
+ * Manages the lifecycle of a Studio session. The MCP process holds
+ * the active session ID in memory so agents don't have to pass it around.
+ *
+ * - create_session: Create a new session, store internally, return URL
+ * - session_status: Check browser connection + pending calls
+ * - close_session: Close session, clear internal state
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionTools = void 0;
+exports.getActiveSessionId = getActiveSessionId;
+exports.handleSessionTool = handleSessionTool;
+// Base URL for Efecto API
+const API_BASE = process.env.EFECTO_API_URL || 'https://efecto.app';
+// ---------------------------------------------------------------------------
+// Internal session state — held in-process
+// ---------------------------------------------------------------------------
+let currentSessionId = null;
+/** Get the active session ID (used by studio tools) */
+function getActiveSessionId() {
+    return currentSessionId;
+}
+// ---------------------------------------------------------------------------
+// Tool Definitions
+// ---------------------------------------------------------------------------
+exports.sessionTools = [
+    {
+        name: 'create_session',
+        description: 'Create a new Studio session. Returns a URL the user should open in their browser. ' +
+            'Once open, you can use any Studio design tool — they execute in real-time. ' +
+            'Only one session is active at a time; creating a new session replaces the previous one.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                label: {
+                    type: 'string',
+                    description: 'Human-readable label for the session (e.g. "Landing page design")',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'session_status',
+        description: 'Check the status of the active Studio session — whether the browser is connected, ' +
+            'pending calls, etc. If no session is active, returns an error.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionId: {
+                    type: 'string',
+                    description: 'Optional session ID to check (defaults to active session)',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'close_session',
+        description: 'Close the active Studio session. Disconnects the browser and cleans up resources.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionId: {
+                    type: 'string',
+                    description: 'Optional session ID to close (defaults to active session)',
+                },
+            },
+            required: [],
+        },
+    },
+];
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+async function handleSessionTool(name, args) {
+    const params = args || {};
+    switch (name) {
+        // -----------------------------------------------------------------------
+        // create_session
+        // -----------------------------------------------------------------------
+        case 'create_session': {
+            const body = {};
+            if (typeof params.label === 'string') {
+                body.label = params.label;
+            }
+            try {
+                const response = await fetch(`${API_BASE}/api/v1/studio/sessions`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(body),
+                });
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: `API error: ${response.status}`,
+                                    details: errorText,
+                                }, null, 2),
+                            }],
+                    };
+                }
+                const data = await response.json();
+                // Store the session ID internally
+                currentSessionId = data.sessionId;
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                sessionId: data.sessionId,
+                                studioUrl: data.studioUrl,
+                                expiresAt: data.expiresAt,
+                                message: `Studio session created! Ask the user to open this URL in their browser:\n\n` +
+                                    `  ${data.studioUrl}\n\n` +
+                                    `Once the browser is connected, use any design tool directly — no session ID needed.`,
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'Failed to create session',
+                                details: error instanceof Error ? error.message : String(error),
+                            }, null, 2),
+                        }],
+                };
+            }
+        }
+        // -----------------------------------------------------------------------
+        // session_status
+        // -----------------------------------------------------------------------
+        case 'session_status': {
+            const sessionId = (typeof params.sessionId === 'string' && params.sessionId)
+                ? params.sessionId
+                : currentSessionId;
+            if (!sessionId) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'No active session. Call create_session first.',
+                            }, null, 2),
+                        }],
+                };
+            }
+            try {
+                const response = await fetch(`${API_BASE}/api/v1/studio/sessions/${sessionId}`);
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: `API error: ${response.status}`,
+                                    details: errorText,
+                                }, null, 2),
+                            }],
+                    };
+                }
+                const data = await response.json();
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                sessionId: data.session.id,
+                                browserConnected: data.session.browserConnected,
+                                label: data.session.label,
+                                pendingCalls: data.pendingCalls,
+                                completedCalls: data.completedCalls,
+                                expiresAt: new Date(data.session.expiresAt).toISOString(),
+                                message: data.session.browserConnected
+                                    ? 'Browser is connected and ready. Use any design tool directly.'
+                                    : 'Browser is not connected. Ask the user to open the Studio URL.',
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'Failed to get session status',
+                                details: error instanceof Error ? error.message : String(error),
+                            }, null, 2),
+                        }],
+                };
+            }
+        }
+        // -----------------------------------------------------------------------
+        // close_session
+        // -----------------------------------------------------------------------
+        case 'close_session': {
+            const sessionId = (typeof params.sessionId === 'string' && params.sessionId)
+                ? params.sessionId
+                : currentSessionId;
+            if (!sessionId) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'No active session. Nothing to close.',
+                            }, null, 2),
+                        }],
+                };
+            }
+            try {
+                const response = await fetch(`${API_BASE}/api/v1/studio/sessions/${sessionId}`, {
+                    method: 'DELETE',
+                });
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: `API error: ${response.status}`,
+                                    details: errorText,
+                                }, null, 2),
+                            }],
+                    };
+                }
+                // Clear internal state
+                if (currentSessionId === sessionId) {
+                    currentSessionId = null;
+                }
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                message: 'Studio session closed successfully.',
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'Failed to close session',
+                                details: error instanceof Error ? error.message : String(error),
+                            }, null, 2),
+                        }],
+                };
+            }
+        }
+        default:
+            return {
+                content: [{ type: 'text', text: `Unknown session tool: ${name}` }],
+            };
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"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"}

package/dist/tools/studio.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Studio Design Tools — First-Class MCP Tools
+ *
+ * Every Studio AI tool is exposed as its own MCP tool with a full schema.
+ * No more proxy pattern — agents call tools directly.
+ *
+ * The active session ID is auto-resolved from the session module.
+ * Each tool also accepts an optional `sessionId` override for multi-session use.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const studioTools: Tool[];
+export declare function handleStudioTool(name: string, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=studio.d.ts.map

package/dist/tools/studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../src/tools/studio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAuH9D,eAAO,MAAM,WAAW,EAAE,IAAI,EAgf7B,CAAA;AAuDD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAgB7D"}