marble-headed-mcp 0.1.7 → 0.1.9

package/dist/index.js

@@ -120,8 +120,8 @@ const TOOLS = [
         inputSchema: {
             type: 'object',
             properties: {
-                email: { type: 'string' },
-                password: { type: 'string' },
+                email: { type: 'string', description: 'Email for login (optional).' },
+                password: { type: 'string', description: 'Password for login (optional).' },
             },
             additionalProperties: false,
         },
@@ -132,7 +132,7 @@ const TOOLS = [
         inputSchema: {
             type: 'object',
             properties: {
-                browserSessionId: { type: 'number' },
+                browserSessionId: { type: 'number', description: 'Headed browser session id.' },
             },
             required: ['browserSessionId'],
             additionalProperties: false,
@@ -144,8 +144,8 @@ const TOOLS = [
         inputSchema: {
             type: 'object',
             properties: {
-                browserSessionId: { type: 'number' },
-                projectId: { type: ['number', 'string'] },
+                browserSessionId: { type: 'number', description: 'Headed browser session id.' },
+                projectId: { type: ['number', 'string'], description: 'Project id to open at /sims/{projectId}.' },
             },
             required: ['browserSessionId', 'projectId'],
             additionalProperties: false,
@@ -153,14 +153,15 @@ const TOOLS = [
     },
     {
         name: 'headed_send_msg',
-        description: 'Send a chat message in the headed session and capture screenshots (returns links).',
+        description: 'Send a chat message in the headed session and capture screenshots (returns links). Make sure that ONLY one project is running in this session, and that you’ve already called `workflow_end_to_end_project_generation` and `headed_navigate_to_project`. Supports waitForTutorStart.',
         inputSchema: {
             type: 'object',
             properties: {
-                browserSessionId: { type: 'number' },
-                waitDuration: { type: 'number' },
-                screenshotInterval: { type: 'number' },
-                msg: { type: 'string' },
+                browserSessionId: { type: 'number', description: 'Headed browser session id.' },
+                waitDuration: { type: 'number', description: 'How long to capture screenshots after start (ms). This should typically not be longer than 10s, especially if you’re using `waitForTutorStart`.' },
+                screenshotInterval: { type: 'number', description: 'Interval between screenshots (ms).' },
+                waitForTutorStart: { type: 'boolean', description: 'If true (default), wait up to 30s for streaming to start before capturing.' },
+                msg: { type: 'string', description: 'Chat message to send.' },
             },
             required: ['browserSessionId', 'waitDuration', 'screenshotInterval', 'msg'],
             additionalProperties: false,
@@ -168,13 +169,12 @@ const TOOLS = [
     },
     {
         name: 'screenshots_preview',
-        description: 'Render screenshots HTML (accepts screenshots/screenshotUrls array or full response body).',
+        description: 'Render screenshots HTML (accepts screenshotUrls array or full response body).',
         inputSchema: {
             type: 'object',
             properties: {
-                screenshots: { type: 'array', items: { type: 'string' } },
-                screenshotUrls: { type: 'array', items: { type: 'string' } },
-                response: { type: 'object' },
+                screenshotUrls: { type: 'array', items: { type: 'string' }, description: 'Array of screenshot URLs.' },
+                response: { type: 'object', description: 'Full response body from headed_send_msg.' },
             },
             additionalProperties: false,
         },
@@ -185,7 +185,7 @@ const TOOLS = [
         inputSchema: {
             type: 'object',
             properties: {
-                previewId: { type: 'string' },
+                previewId: { type: 'string', description: 'Preview id returned by headed_send_msg.' },
             },
             required: ['previewId'],
             additionalProperties: false,
@@ -193,29 +193,29 @@ const TOOLS = [
     },
     {
         name: 'workflow_end_to_end_project_generation',
-        description: 'Run the server-side end-to-end project workflow (features → provision → boilerplate).',
+        description: 'This action creates a Marble project, its features, and spins up the Google Cloud Run instance — hence the name “end-to-end”. If you are asked to “spin up projects”, this is a first step after starting the session. ',
         inputSchema: {
             type: 'object',
             properties: {
-                title: { type: 'string' },
-                description: { type: 'string' },
-                technologies: { type: 'array', items: { type: 'string' } },
-                language: { type: 'string' },
-                planId: { type: ['string', 'number'] },
-                personalizationNotes: { type: 'string' },
-                email: { type: 'string' },
-                user_id: { type: 'string' },
-                show_scaffold: { type: 'boolean' },
-                show_checkpoints: { type: 'boolean' },
-                show_walkthrough: { type: 'boolean' },
-                onboarding_completed: { type: 'boolean' },
-                target_skills: { type: 'array', items: { type: 'string' } },
-                project_setup_complete: { type: 'boolean' },
-                boilerplate_setup_complete: { type: 'boolean' },
-                plan_id: { type: ['string', 'number'] },
-                plan_project_id: { type: ['string', 'number'] },
-                posthogDistinctId: { type: 'string' },
-                workflowRunName: { type: 'string' },
+                title: { type: 'string', description: 'Project title.' },
+                description: { type: 'string', description: 'Project description prompt.' },
+                technologies: { type: 'array', items: { type: 'string' }, description: 'List of technologies to use.' },
+                language: { type: 'string', description: 'Primary language (optional).' },
+                planId: { type: ['string', 'number'], description: 'Plan id (optional).' },
+                personalizationNotes: { type: 'string', description: 'Personalization notes (optional).' },
+                email: { type: 'string', description: 'User email (optional).' },
+                user_id: { type: 'string', description: 'User id (optional).' },
+                show_scaffold: { type: 'boolean', description: 'Whether to generate scaffold.' },
+                show_checkpoints: { type: 'boolean', description: 'Whether to generate checkpoints.' },
+                show_walkthrough: { type: 'boolean', description: 'Whether to include walkthrough.' },
+                onboarding_completed: { type: 'boolean', description: 'Whether onboarding is completed.' },
+                target_skills: { type: 'array', items: { type: 'string' }, description: 'Target skills list.' },
+                project_setup_complete: { type: 'boolean', description: 'Project setup complete flag.' },
+                boilerplate_setup_complete: { type: 'boolean', description: 'Boilerplate setup complete flag.' },
+                plan_id: { type: ['string', 'number'], description: 'Plan id (legacy field).' },
+                plan_project_id: { type: ['string', 'number'], description: 'Plan project id (legacy field).' },
+                posthogDistinctId: { type: 'string', description: 'PostHog distinct id (optional).' },
+                workflowRunName: { type: 'string', description: 'Override workflow run name.' },
             },
             required: ['title', 'description', 'technologies'],
             additionalProperties: true,
@@ -227,7 +227,7 @@ const TOOLS = [
         inputSchema: {
             type: 'object',
             properties: {
-                projectId: { type: 'number' },
+                projectId: { type: 'number', description: 'Project id to complete.' },
             },
             required: ['projectId'],
             additionalProperties: false,
@@ -239,23 +239,23 @@ const TOOLS = [
         inputSchema: {
             type: 'object',
             properties: {
-                projectId: { type: 'number' },
-                timeStart: { type: 'string' },
-                timeEnd: { type: 'string' },
-                limit: { type: 'number' },
+                projectId: { type: 'number', description: 'Project id to fetch logs for.' },
+                timeStart: { type: 'string', description: 'Start timestamp (ISO). Optional.' },
+                timeEnd: { type: 'string', description: 'End timestamp (ISO). Optional.' },
+                limit: { type: 'number', description: 'Maximum number of log entries to return. A reasonable default is 1000.' },
             },
             required: ['projectId'],
             additionalProperties: false,
         },
     },
     {
-        name: 'save_image_base64',
+        name: 'save_image_url',
         description: 'Download an image URL to /tmp and return the file path.',
         inputSchema: {
             type: 'object',
             properties: {
-                url: { type: 'string' },
-                filename: { type: 'string' },
+                url: { type: 'string', description: 'Image URL to download.' },
+                filename: { type: 'string', description: 'Optional filename for /tmp output.' },
             },
             required: ['url'],
             additionalProperties: false,
@@ -292,11 +292,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return { content: [{ type: 'text', text: JSON.stringify(result.json || { status: result.status, body: result.text }, null, 2) }] };
             }
             case 'screenshots_preview': {
-                const payload = args?.screenshots
-                    ? { screenshots: args.screenshots }
-                    : args?.screenshotUrls
-                        ? { screenshotUrls: args.screenshotUrls }
-                        : args?.response || args;
+                const payload = args?.screenshotUrls
+                    ? { screenshotUrls: args.screenshotUrls }
+                    : args?.response || args;
                 const result = await postHeadedJson('/preview_screenshots', payload);
                 return { content: [{ type: 'text', text: JSON.stringify({ status: result.status, ok: result.ok, html: result.text }, null, 2) }] };
             }
@@ -369,7 +367,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
-            case 'save_image_base64': {
+            case 'save_image_url': {
                 const saveResult = await saveImageFromUrl({
                     url: args?.url,
                     filename: args?.filename,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marble-headed-mcp",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "MCP server for Marble headed automation endpoints",
   "main": "dist/index.js",
   "type": "module",