@milaboratories/pl-mcp-server 2.0.0 → 2.1.0

package/README.md

@@ -0,0 +1,101 @@
+# Platforma MCP Server
+
+MCP (Model Context Protocol) server that enables AI assistants to interact with the Platforma Desktop App. It exposes tools for project management, block control, UI interaction, screenshot capture, and data queries through the standardized MCP interface.
+
+## Capabilities
+
+| Tool group         | What it does                                                     |
+| ------------------ | ---------------------------------------------------------------- |
+| **Connection**     | Connect/disconnect to a running Platforma backend server         |
+| **Projects**       | List, open, and manage projects                                  |
+| **Blocks**         | Add blocks, read block state, configure inputs/arguments         |
+| **UI interaction** | Click, type, scroll, and send keyboard events to the desktop app |
+| **Screenshots**    | Capture window screenshots (full composited or per-WebContents)  |
+| **Data query**     | Query PColumn data and result pool contents                      |
+| **Logs**           | Retrieve application logs                                        |
+| **Sandbox**        | Execute JavaScript in the app's renderer process                 |
+
+## How It Works
+
+The MCP server runs as a worker process inside the Platforma Desktop App (Electron). It communicates with the main process via IPC and exposes tools over the MCP protocol (stdio transport by default, HTTP also supported).
+
+```
+Claude Code  ──MCP──▶  pl-mcp-server (worker)  ──IPC──▶  Desktop App (main process)
+                                                           ├── Main window
+                                                           ├── Block view
+                                                           └── Modals
+```
+
+## Connecting From Claude Code
+
+1. **Start the Platforma Desktop App and enable MCP** — the MCP server feature marked as Alpha for now. To enable it open Settings, scroll down to the bottom, enable checkbox "Enable MCP Server". Then copy MCP Server URL.
+
+2. **Add the MCP server to Claude Code** by creating or editing `.claude/settings.json`:
+
+   ```json
+   {
+     "mcpServers": {
+       "pl": {
+         "type": "sse",
+         "url": "http://localhost:4200/mcp"
+       }
+     }
+   }
+   ```
+
+3. **Verify the connection** — run `/mcp` in Claude Code to see the `pl` server status. All tools will be available as `mcp__pl__*`.
+
+4. **Connect to the backend** — use `list_connections` to see already saved connections. You could easily reuse them. Or call `connect_to_server` directly with URL, username and password to create new connection.
+
+5. **Open a project** — use `open_project` to start working with a specific project.
+
+## Connecting From Claude Desktop App (Chat)
+
+Claude Desktop App uses stdio transport, so it cannot connect to the HTTP MCP endpoint directly. Use `mcp-remote` to bridge the two.
+
+1. **Enable MCP in the Platforma Desktop App** — same as step 1 above (Settings -> "Enable MCP Server"). Copy the MCP Server URL.
+
+2. **Edit Claude Desktop config** — open `~/Library/Application Support/Claude/claude_desktop_config.json` and add the `mcpServers` entry:
+
+   ```json
+   {
+     "mcpServers": {
+       "platforma": {
+         "command": "npx",
+         "args": ["-y", "mcp-remote", "http://127.0.0.1:4200/<your-session-id>/mcp"]
+       }
+     }
+   }
+   ```
+
+   Replace the URL with the actual MCP Server URL from the Platforma Desktop App settings.
+
+3. **Restart Claude Desktop App** — the Platforma tools will appear in your chat sessions. Follow the same workflow: `list_connections` -> `connect_to_server` -> `open_project`.
+
+## Skill
+
+There is a `mcp-desktop-testing` skill for Claude in ecosystem overlay. Should be found and used automatically if overlay enabled.
+
+## Coordinate System
+
+The desktop app uses Electron with potentially multiple WebContents layers. Screenshots are captured in **device pixels** (2x on Retina displays), while input events use **CSS pixels**.
+
+To click on an element visible in a screenshot: divide the screenshot pixel coordinates by the device pixel ratio (typically 2 on macOS Retina).
+
+## Development
+
+```bash
+# Build
+pnpm --filter @milaboratories/pl-mcp-server build
+
+# Run tests
+pnpm --filter @milaboratories/pl-mcp-server test
+
+# Pack for desktop app
+pnpm --filter @milaboratories/pl-mcp-server do-pack
+
+# Then reinstall in desktop app
+cd ../../platforma-desktop-app && pnpm install
+```
+
+After changes, rebuild the desktop app's worker package and restart the app to pick up the new server code.

package/dist/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":["StreamableHTTPServerTransport","McpServer"],"sources":["../src/server.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport { createServer, type IncomingMessage, type Server, type ServerResponse } from \"node:http\";\nimport { randomUUID } from \"node:crypto\";\nimport { type MiddleLayer, resourceIdToString } from \"@milaboratories/pl-middle-layer\";\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport type { ToolContext } from \"./tools/types\";\nimport { registerPingTool } from \"./tools/ping\";\nimport { registerConnectionTools } from \"./tools/connection\";\nimport { registerProjectTools } from \"./tools/projects\";\nimport { registerBlockTools } from \"./tools/blocks\";\nimport { registerBlockStateTools } from \"./tools/block-state\";\nimport { registerAwaitTools } from \"./tools/await\";\nimport { registerLogTools } from \"./tools/logs\";\nimport { registerDataQueryTools } from \"./tools/data-query\";\nimport { registerScreenshotTool } from \"./tools/screenshot\";\nimport { registerUIInteractionTools } from \"./tools/ui-interaction\";\n\nexport interface PlMcpServerCallbacks {\n  onProjectCreated?: (projectId: string) => void | Promise<void>;\n  onProjectOpened?: (projectId: string) => void | Promise<void>;\n  onProjectClosed?: (projectId: string) => void | Promise<void>;\n  onProjectDeleted?: (projectId: string) => void | Promise<void>;\n  /** Capture the current application window as a PNG screenshot. Returns base64-encoded PNG. */\n  captureScreenshot?: () => Promise<string>;\n  /** Send an input event to the application window. */\n  sendInputEvent?: (event: unknown) => Promise<void>;\n  /** Execute JavaScript in the renderer and return the result. */\n  executeJavaScript?: (code: string) => Promise<unknown>;\n  /** List available blocks from all configured registries. */\n  listAvailableBlocks?: (query?: string) => Promise<unknown[]>;\n  /** Navigate the desktop UI to show a specific block. */\n  selectBlock?: (projectId: string, blockId: string) => Promise<void>;\n  /** Read recent lines from the application log. */\n  readAppLog?: (lines: number, search?: string) => Promise<string>;\n  /** List saved server connections. */\n  listConnections?: () => Promise<ServerConnection[]>;\n  /** Connect to a server. */\n  connectToServer?: (\n    addr: string,\n    login: string,\n    password?: string,\n  ) => Promise<{ status: string; message: string }>;\n  /** Get current connection status. */\n  getConnectionStatus?: () => Promise<{\n    connected: boolean;\n    type?: string;\n    addr?: string;\n    login?: string;\n  }>;\n  /** Disconnect from current server. */\n  disconnect?: () => Promise<void>;\n  /** Get detailed info about a specific block package. */\n  getBlockInfo?: (\n    registryUrl: string,\n    organization: string,\n    name: string,\n    version: string,\n  ) => Promise<unknown>;\n}\n\nexport interface ServerConnection {\n  addr: string;\n  login: string;\n  coreVersion?: string;\n  lastConnected?: string;\n}\n\n/** Branded type for the MCP server URL secret path segment. */\nexport type McpSecret = Branded<string, \"McpSecret\">;\n\nexport interface PlMcpServerOptions {\n  /** MiddleLayer instance providing access to projects, blocks, etc. Optional — server can start without it. */\n  middleLayer?: MiddleLayer;\n  /** Port to listen on. */\n  port: number;\n  /** Secret path segment for URL security. */\n  secret: McpSecret;\n  /** Optional callbacks for project lifecycle events (e.g. to sync UI state). */\n  callbacks?: PlMcpServerCallbacks;\n}\n\nexport class PlMcpServer {\n  private ml: MiddleLayer | null;\n  private port: number;\n  private readonly secret: McpSecret;\n  private readonly callbacks: PlMcpServerCallbacks;\n  private httpServer: Server | undefined;\n  private readonly transports = new Map<string, StreamableHTTPServerTransport>();\n\n  constructor(options: PlMcpServerOptions) {\n    this.ml = options.middleLayer ?? null;\n    this.port = options.port;\n    this.secret = options.secret;\n    this.callbacks = options.callbacks ?? {};\n  }\n\n  /** Set or update the MiddleLayer instance (e.g. after connecting to a server). */\n  setMiddleLayer(ml: MiddleLayer | null | undefined) {\n    this.ml = ml ?? null;\n  }\n\n  get url(): string {\n    return `http://127.0.0.1:${this.port}/${this.secret}/mcp`;\n  }\n\n  async start(): Promise<void> {\n    if (this.httpServer) {\n      throw new Error(\"MCP server is already running\");\n    }\n\n    const expectedPath = `/${this.secret}/mcp`;\n\n    this.httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n      try {\n        // Origin validation — only allow localhost\n        if (req.headers.origin !== undefined) {\n          try {\n            const origin = new URL(req.headers.origin);\n            if (origin.hostname !== \"localhost\" && origin.hostname !== \"127.0.0.1\") {\n              res.writeHead(403, { \"Content-Type\": \"application/json\" });\n              res.end(JSON.stringify({ error: \"Forbidden\" }));\n              return;\n            }\n          } catch {\n            res.writeHead(403, { \"Content-Type\": \"application/json\" });\n            res.end(JSON.stringify({ error: \"Forbidden\" }));\n            return;\n          }\n        }\n\n        // Secret path check\n        if (req.url !== expectedPath) {\n          res.writeHead(404, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Not Found\" }));\n          return;\n        }\n\n        // Route to existing session transport\n        const sessionId = req.headers[\"mcp-session-id\"] as string | undefined;\n        if (sessionId && this.transports.has(sessionId)) {\n          await this.transports.get(sessionId)!.handleRequest(req, res);\n          return;\n        }\n\n        // New session — create transport and connect MCP server\n        const transport = new StreamableHTTPServerTransport({\n          sessionIdGenerator: () => randomUUID(),\n        });\n        transport.onclose = () => {\n          const sid = transport.sessionId;\n          if (sid) this.transports.delete(sid);\n        };\n\n        const server = this.createMcpServer();\n        await server.connect(transport);\n        await transport.handleRequest(req, res);\n\n        const sid = transport.sessionId;\n        if (sid) this.transports.set(sid, transport);\n      } catch {\n        if (!res.headersSent) {\n          res.writeHead(500, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Internal Server Error\" }));\n        }\n      }\n    });\n\n    const maxRetries = 10;\n    const requestHandler = this.httpServer.listeners(\"request\")[0] as (\n      req: IncomingMessage,\n      res: ServerResponse,\n    ) => void;\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      const server = this.httpServer;\n      try {\n        await new Promise<void>((resolve, reject) => {\n          server.listen(this.port, \"127.0.0.1\", () => resolve());\n          server.once(\"error\", reject);\n        });\n        // Read back the actual port (important when port is 0)\n        const addr = server.address();\n        if (addr && typeof addr === \"object\") {\n          this.port = addr.port;\n        }\n        return;\n      } catch (err: unknown) {\n        if (\n          err instanceof Error &&\n          \"code\" in err &&\n          err.code === \"EADDRINUSE\" &&\n          attempt < maxRetries - 1\n        ) {\n          server.removeAllListeners();\n          this.httpServer = createServer(requestHandler);\n          this.port++;\n          continue;\n        }\n        throw err;\n      }\n    }\n  }\n\n  async stop(): Promise<void> {\n    for (const transport of this.transports.values()) {\n      await transport.close();\n    }\n    this.transports.clear();\n\n    const server = this.httpServer;\n    if (server) {\n      await new Promise<void>((resolve, reject) => {\n        server.close((err) => (err ? reject(err) : resolve()));\n      });\n      this.httpServer = undefined;\n    }\n  }\n\n  private createMcpServer(): McpServer {\n    const sessionId = randomUUID().slice(0, 8);\n    const server = new McpServer({ name: \"pl\", version: \"0.1.0\" }, { capabilities: { tools: {} } });\n    this.registerTools(server, sessionId);\n    return server;\n  }\n\n  private registerTools(server: McpServer, sessionId: string): void {\n    const authorId = `mcp-${sessionId}`;\n    let localVersion = 0;\n    const ctx: ToolContext = {\n      getMl: () => this.ml,\n      requireMl: () => this.requireMl(),\n      resolveProject: (id) => this.resolveProject(id),\n      getOpenedProject: (id) => this.getOpenedProject(id),\n      callbacks: this.callbacks,\n      getAuthorMarker: () => ({ authorId, localVersion: ++localVersion }),\n    };\n    registerPingTool(server, ctx);\n    registerConnectionTools(server, ctx);\n    registerProjectTools(server, ctx);\n    registerBlockTools(server, ctx);\n    registerBlockStateTools(server, ctx);\n    registerAwaitTools(server, ctx);\n    registerLogTools(server, ctx);\n    registerDataQueryTools(server, ctx);\n    registerScreenshotTool(server, ctx);\n    registerUIInteractionTools(server, ctx);\n  }\n\n  /** Throws if MiddleLayer is not available (not connected to a server). */\n  private requireMl(): MiddleLayer {\n    if (!this.ml) throw new Error(\"Not connected to a server. Use connect_to_server first.\");\n    return this.ml;\n  }\n\n  /** Resolves a project from the list by its projectId (resourceIdToString format). */\n  private async resolveProject(projectId: string) {\n    const ml = this.requireMl();\n    await ml.projectList.refreshState();\n    const projects = await ml.projectList.awaitStableValue();\n    const entry = projects.find((p) => resourceIdToString(p.rid) === projectId);\n    if (!entry) throw new Error(`Project ${projectId} not found`);\n    return entry;\n  }\n\n  /** Gets an opened project by projectId. Resolves via project list → rid → getOpenedProject. */\n  private async getOpenedProject(projectId: string) {\n    const ml = this.requireMl();\n    const entry = await this.resolveProject(projectId);\n    return ml.getOpenedProject(entry.rid);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"server.cjs","names":["StreamableHTTPServerTransport","McpServer"],"sources":["../src/server.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport { createServer, type IncomingMessage, type Server, type ServerResponse } from \"node:http\";\nimport { randomUUID } from \"node:crypto\";\nimport { type MiddleLayer, resourceIdToString } from \"@milaboratories/pl-middle-layer\";\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport type { ToolContext } from \"./tools/types\";\nimport { registerPingTool } from \"./tools/ping\";\nimport { registerConnectionTools } from \"./tools/connection\";\nimport { registerProjectTools } from \"./tools/projects\";\nimport { registerBlockTools } from \"./tools/blocks\";\nimport { registerBlockStateTools } from \"./tools/block-state\";\nimport { registerAwaitTools } from \"./tools/await\";\nimport { registerLogTools } from \"./tools/logs\";\nimport { registerDataQueryTools } from \"./tools/data-query\";\nimport { registerScreenshotTool } from \"./tools/screenshot\";\nimport { registerUIInteractionTools } from \"./tools/ui-interaction\";\n\nexport interface PlMcpServerCallbacks {\n  onProjectCreated?: (projectId: string) => void | Promise<void>;\n  onProjectOpened?: (projectId: string) => void | Promise<void>;\n  onProjectClosed?: (projectId: string) => void | Promise<void>;\n  onProjectDeleted?: (projectId: string) => void | Promise<void>;\n  /** Capture the current application window as a PNG screenshot. Returns base64-encoded PNG. */\n  captureScreenshot?: () => Promise<string>;\n  /** Send an input event to the application window. */\n  sendInputEvent?: (event: unknown) => Promise<void>;\n  /**\n   * Execute JavaScript in a renderer and return the result.\n   * With no `target`, runs in the topmost webContents (usually the main app).\n   * With `target`, runs in the specified block's webview (where `window.platforma` is\n   * exposed) — the block must already be loaded (e.g. via `select_block`).\n   */\n  executeJavaScript?: (\n    code: string,\n    target?: { projectId: string; blockId: string },\n  ) => Promise<unknown>;\n  /** List available blocks from all configured registries. */\n  listAvailableBlocks?: (query?: string) => Promise<unknown[]>;\n  /** Navigate the desktop UI to show a specific block. */\n  selectBlock?: (projectId: string, blockId: string) => Promise<void>;\n  /** Read recent lines from the application log. */\n  readAppLog?: (lines: number, search?: string) => Promise<string>;\n  /** List saved server connections. */\n  listConnections?: () => Promise<ServerConnection[]>;\n  /** Connect to a server. */\n  connectToServer?: (\n    addr: string,\n    login: string,\n    password?: string,\n  ) => Promise<{ status: string; message: string }>;\n  /** Get current connection status. */\n  getConnectionStatus?: () => Promise<{\n    connected: boolean;\n    type?: string;\n    addr?: string;\n    login?: string;\n  }>;\n  /** Disconnect from current server. */\n  disconnect?: () => Promise<void>;\n  /** Get detailed info about a specific block package. */\n  getBlockInfo?: (\n    registryUrl: string,\n    organization: string,\n    name: string,\n    version: string,\n  ) => Promise<unknown>;\n}\n\nexport interface ServerConnection {\n  addr: string;\n  login: string;\n  coreVersion?: string;\n  lastConnected?: string;\n}\n\n/** Branded type for the MCP server URL secret path segment. */\nexport type McpSecret = Branded<string, \"McpSecret\">;\n\nexport interface PlMcpServerOptions {\n  /** MiddleLayer instance providing access to projects, blocks, etc. Optional — server can start without it. */\n  middleLayer?: MiddleLayer;\n  /** Port to listen on. */\n  port: number;\n  /** Secret path segment for URL security. */\n  secret: McpSecret;\n  /** Optional callbacks for project lifecycle events (e.g. to sync UI state). */\n  callbacks?: PlMcpServerCallbacks;\n}\n\nexport class PlMcpServer {\n  private ml: MiddleLayer | null;\n  private port: number;\n  private readonly secret: McpSecret;\n  private readonly callbacks: PlMcpServerCallbacks;\n  private httpServer: Server | undefined;\n  private readonly transports = new Map<string, StreamableHTTPServerTransport>();\n\n  constructor(options: PlMcpServerOptions) {\n    this.ml = options.middleLayer ?? null;\n    this.port = options.port;\n    this.secret = options.secret;\n    this.callbacks = options.callbacks ?? {};\n  }\n\n  /** Set or update the MiddleLayer instance (e.g. after connecting to a server). */\n  setMiddleLayer(ml: MiddleLayer | null | undefined) {\n    this.ml = ml ?? null;\n  }\n\n  get url(): string {\n    return `http://127.0.0.1:${this.port}/${this.secret}/mcp`;\n  }\n\n  async start(): Promise<void> {\n    if (this.httpServer) {\n      throw new Error(\"MCP server is already running\");\n    }\n\n    const expectedPath = `/${this.secret}/mcp`;\n\n    this.httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n      try {\n        // Origin validation — only allow localhost\n        if (req.headers.origin !== undefined) {\n          try {\n            const origin = new URL(req.headers.origin);\n            if (origin.hostname !== \"localhost\" && origin.hostname !== \"127.0.0.1\") {\n              res.writeHead(403, { \"Content-Type\": \"application/json\" });\n              res.end(JSON.stringify({ error: \"Forbidden\" }));\n              return;\n            }\n          } catch {\n            res.writeHead(403, { \"Content-Type\": \"application/json\" });\n            res.end(JSON.stringify({ error: \"Forbidden\" }));\n            return;\n          }\n        }\n\n        // Secret path check\n        if (req.url !== expectedPath) {\n          res.writeHead(404, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Not Found\" }));\n          return;\n        }\n\n        // Route to existing session transport\n        const sessionId = req.headers[\"mcp-session-id\"] as string | undefined;\n        if (sessionId && this.transports.has(sessionId)) {\n          await this.transports.get(sessionId)!.handleRequest(req, res);\n          return;\n        }\n\n        // New session — create transport and connect MCP server\n        const transport = new StreamableHTTPServerTransport({\n          sessionIdGenerator: () => randomUUID(),\n        });\n        transport.onclose = () => {\n          const sid = transport.sessionId;\n          if (sid) this.transports.delete(sid);\n        };\n\n        const server = this.createMcpServer();\n        await server.connect(transport);\n        await transport.handleRequest(req, res);\n\n        const sid = transport.sessionId;\n        if (sid) this.transports.set(sid, transport);\n      } catch {\n        if (!res.headersSent) {\n          res.writeHead(500, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Internal Server Error\" }));\n        }\n      }\n    });\n\n    const maxRetries = 10;\n    const requestHandler = this.httpServer.listeners(\"request\")[0] as (\n      req: IncomingMessage,\n      res: ServerResponse,\n    ) => void;\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      const server = this.httpServer;\n      try {\n        await new Promise<void>((resolve, reject) => {\n          server.listen(this.port, \"127.0.0.1\", () => resolve());\n          server.once(\"error\", reject);\n        });\n        // Read back the actual port (important when port is 0)\n        const addr = server.address();\n        if (addr && typeof addr === \"object\") {\n          this.port = addr.port;\n        }\n        return;\n      } catch (err: unknown) {\n        if (\n          err instanceof Error &&\n          \"code\" in err &&\n          err.code === \"EADDRINUSE\" &&\n          attempt < maxRetries - 1\n        ) {\n          server.removeAllListeners();\n          this.httpServer = createServer(requestHandler);\n          this.port++;\n          continue;\n        }\n        throw err;\n      }\n    }\n  }\n\n  async stop(): Promise<void> {\n    for (const transport of this.transports.values()) {\n      await transport.close();\n    }\n    this.transports.clear();\n\n    const server = this.httpServer;\n    if (server) {\n      await new Promise<void>((resolve, reject) => {\n        server.close((err) => (err ? reject(err) : resolve()));\n      });\n      this.httpServer = undefined;\n    }\n  }\n\n  private createMcpServer(): McpServer {\n    const sessionId = randomUUID().slice(0, 8);\n    const server = new McpServer({ name: \"pl\", version: \"0.1.0\" }, { capabilities: { tools: {} } });\n    this.registerTools(server, sessionId);\n    return server;\n  }\n\n  private registerTools(server: McpServer, sessionId: string): void {\n    const authorId = `mcp-${sessionId}`;\n    let localVersion = 0;\n    const ctx: ToolContext = {\n      getMl: () => this.ml,\n      requireMl: () => this.requireMl(),\n      resolveProject: (id) => this.resolveProject(id),\n      getOpenedProject: (id) => this.getOpenedProject(id),\n      callbacks: this.callbacks,\n      getAuthorMarker: () => ({ authorId, localVersion: ++localVersion }),\n    };\n    registerPingTool(server, ctx);\n    registerConnectionTools(server, ctx);\n    registerProjectTools(server, ctx);\n    registerBlockTools(server, ctx);\n    registerBlockStateTools(server, ctx);\n    registerAwaitTools(server, ctx);\n    registerLogTools(server, ctx);\n    registerDataQueryTools(server, ctx);\n    registerScreenshotTool(server, ctx);\n    registerUIInteractionTools(server, ctx);\n  }\n\n  /** Throws if MiddleLayer is not available (not connected to a server). */\n  private requireMl(): MiddleLayer {\n    if (!this.ml) throw new Error(\"Not connected to a server. Use connect_to_server first.\");\n    return this.ml;\n  }\n\n  /** Resolves a project from the list by its projectId (resourceIdToString format). */\n  private async resolveProject(projectId: string) {\n    const ml = this.requireMl();\n    await ml.projectList.refreshState();\n    const projects = await ml.projectList.awaitStableValue();\n    const entry = projects.find((p) => resourceIdToString(p.rid) === projectId);\n    if (!entry) throw new Error(`Project ${projectId} not found`);\n    return entry;\n  }\n\n  /** Gets an opened project by projectId. Resolves via project list → rid → getOpenedProject. */\n  private async getOpenedProject(projectId: string) {\n    const ml = this.requireMl();\n    const entry = await this.resolveProject(projectId);\n    return ml.getOpenedProject(entry.rid);\n  }\n}\n"],"mappings":"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"}

package/dist/server.d.ts

@@ -11,8 +11,16 @@ interface PlMcpServerCallbacks {
   captureScreenshot?: () => Promise<string>;
   /** Send an input event to the application window. */
   sendInputEvent?: (event: unknown) => Promise<void>;
-  /** Execute JavaScript in the renderer and return the result. */
-  executeJavaScript?: (code: string) => Promise<unknown>;
+  /**
+   * Execute JavaScript in a renderer and return the result.
+   * With no `target`, runs in the topmost webContents (usually the main app).
+   * With `target`, runs in the specified block's webview (where `window.platforma` is
+   * exposed) — the block must already be loaded (e.g. via `select_block`).
+   */
+  executeJavaScript?: (code: string, target?: {
+    projectId: string;
+    blockId: string;
+  }) => Promise<unknown>;
   /** List available blocks from all configured registries. */
   listAvailableBlocks?: (query?: string) => Promise<unknown[]>;
   /** Navigate the desktop UI to show a specific block. */

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","names":[],"sources":["../src/server.ts"],"mappings":";;;;UAkBiB,oBAAA;EACf,gBAAA,IAAoB,SAAA,oBAA6B,OAAA;EACjD,eAAA,IAAmB,SAAA,oBAA6B,OAAA;EAChD,eAAA,IAAmB,SAAA,oBAA6B,OAAA;EAChD,gBAAA,IAAoB,SAAA,oBAA6B,OAAA;EAHA;EAKjD,iBAAA,SAA0B,OAAA;EAHsB;EAKhD,cAAA,IAAkB,KAAA,cAAmB,OAAA;EAFX;EAI1B,iBAAA,IAAqB,IAAA,aAAiB,OAAA;EAAA;EAEtC,mBAAA,IAAuB,KAAA,cAAmB,OAAA;EAEY;EAAtD,WAAA,IAAe,SAAA,UAAmB,OAAA,aAAoB,OAAA;EAItB;EAFhC,UAAA,IAAc,KAAA,UAAe,MAAA,cAAoB,OAAA;EAQ5C;EANL,eAAA,SAAwB,OAAA,CAAQ,gBAAA;EAeb;EAbnB,eAAA,IACE,IAAA,UACA,KAAA,UACA,QAAA,cACG,OAAA;IAAU,MAAA;IAAgB,OAAA;EAAA;EAvBX;EAyBpB,mBAAA,SAA4B,OAAA;IAC1B,SAAA;IACA,IAAA;IACA,IAAA;IACA,KAAA;EAAA;EA3B8C;EA8BhD,UAAA,SAAmB,OAAA;EA7BC;EA+BpB,YAAA,IACE,WAAA,UACA,YAAA,UACA,IAAA,UACA,OAAA,aACG,OAAA;AAAA;AAAA,UAGU,gBAAA;EACf,IAAA;EACA,KAAA;EACA,WAAA;EACA,aAAA;AAAA;;KAIU,SAAA,GAAY,OAAA;AAAA,UAEP,kBAAA;EAzC2B;EA2C1C,WAAA,GAAc,WAAA;EAzCC;EA2Cf,IAAA;EA3CsD;EA6CtD,MAAA,EAAQ,SAAA;EA3CM;EA6Cd,SAAA,GAAY,oBAAA;AAAA;AAAA,cAGD,WAAA;EAAA,QACH,EAAA;EAAA,QACA,IAAA;EAAA,iBACS,MAAA;EAAA,iBACA,SAAA;EAAA,QACT,UAAA;EAAA,iBACS,UAAA;cAEL,OAAA,EAAS,kBAAA;EAhDN;EAwDf,cAAA,CAAe,EAAA,EAAI,WAAA;EAAA,IAIf,GAAA,CAAA;EAIE,KAAA,CAAA,GAAS,OAAA;EAiGT,IAAA,CAAA,GAAQ,OAAA;EAAA,QAeN,eAAA;EAAA,QAOA,aAAA;EAjLN;EAAA,QAyMM,SAAA;EAtMW;EAAA,QA4ML,cAAA;EAzMZ;EAAA,QAmNY,gBAAA;AAAA"}
+{"version":3,"file":"server.d.ts","names":[],"sources":["../src/server.ts"],"mappings":";;;;UAkBiB,oBAAA;EACf,gBAAA,IAAoB,SAAA,oBAA6B,OAAA;EACjD,eAAA,IAAmB,SAAA,oBAA6B,OAAA;EAChD,eAAA,IAAmB,SAAA,oBAA6B,OAAA;EAChD,gBAAA,IAAoB,SAAA,oBAA6B,OAAA;EAHA;EAKjD,iBAAA,SAA0B,OAAA;EAHsB;EAKhD,cAAA,IAAkB,KAAA,cAAmB,OAAA;EAFX;;;;;;EAS1B,iBAAA,IACE,IAAA,UACA,MAAA;IAAW,SAAA;IAAmB,OAAA;EAAA,MAC3B,OAAA;EAuBc;EArBnB,mBAAA,IAAuB,KAAA,cAAmB,OAAA;EA4B9B;EA1BZ,WAAA,IAAe,SAAA,UAAmB,OAAA,aAAoB,OAAA;EArBtD;EAuBA,UAAA,IAAc,KAAA,UAAe,MAAA,cAAoB,OAAA;EAvBA;EAyBjD,eAAA,SAAwB,OAAA,CAAQ,gBAAA;EAxBb;EA0BnB,eAAA,IACE,IAAA,UACA,KAAA,UACA,QAAA,cACG,OAAA;IAAU,MAAA;IAAgB,OAAA;EAAA;EA5B/B;EA8BA,mBAAA,SAA4B,OAAA;IAC1B,SAAA;IACA,IAAA;IACA,IAAA;IACA,KAAA;EAAA;EA9BmC;EAiCrC,UAAA,SAAmB,OAAA;EAzBjB;EA2BF,YAAA,IACE,WAAA,UACA,YAAA,UACA,IAAA,UACA,OAAA,aACG,OAAA;AAAA;AAAA,UAGU,gBAAA;EACf,IAAA;EACA,KAAA;EACA,WAAA;EACA,aAAA;AAAA;;KAIU,SAAA,GAAY,OAAA;AAAA,UAEP,kBAAA;EArCf;EAuCA,WAAA,GAAc,WAAA;EAvCe;EAyC7B,IAAA;EAvCA;EAyCA,MAAA,EAAQ,SAAA;EAzCwB;EA2ChC,SAAA,GAAY,oBAAA;AAAA;AAAA,cAGD,WAAA;EAAA,QACH,EAAA;EAAA,QACA,IAAA;EAAA,iBACS,MAAA;EAAA,iBACA,SAAA;EAAA,QACT,UAAA;EAAA,iBACS,UAAA;cAEL,OAAA,EAAS,kBAAA;EA5CnB;EAoDF,cAAA,CAAe,EAAA,EAAI,WAAA;EAAA,IAIf,GAAA,CAAA;EAIE,KAAA,CAAA,GAAS,OAAA;EAiGT,IAAA,CAAA,GAAQ,OAAA;EAAA,QAeN,eAAA;EAAA,QAOA,aAAA;EA1KN;EAAA,QAkMM,SAAA;EAhMN;EAAA,QAsMY,cAAA;EArMF;EAAA,QA+ME,gBAAA;AAAA"}

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../src/server.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport { createServer, type IncomingMessage, type Server, type ServerResponse } from \"node:http\";\nimport { randomUUID } from \"node:crypto\";\nimport { type MiddleLayer, resourceIdToString } from \"@milaboratories/pl-middle-layer\";\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport type { ToolContext } from \"./tools/types\";\nimport { registerPingTool } from \"./tools/ping\";\nimport { registerConnectionTools } from \"./tools/connection\";\nimport { registerProjectTools } from \"./tools/projects\";\nimport { registerBlockTools } from \"./tools/blocks\";\nimport { registerBlockStateTools } from \"./tools/block-state\";\nimport { registerAwaitTools } from \"./tools/await\";\nimport { registerLogTools } from \"./tools/logs\";\nimport { registerDataQueryTools } from \"./tools/data-query\";\nimport { registerScreenshotTool } from \"./tools/screenshot\";\nimport { registerUIInteractionTools } from \"./tools/ui-interaction\";\n\nexport interface PlMcpServerCallbacks {\n  onProjectCreated?: (projectId: string) => void | Promise<void>;\n  onProjectOpened?: (projectId: string) => void | Promise<void>;\n  onProjectClosed?: (projectId: string) => void | Promise<void>;\n  onProjectDeleted?: (projectId: string) => void | Promise<void>;\n  /** Capture the current application window as a PNG screenshot. Returns base64-encoded PNG. */\n  captureScreenshot?: () => Promise<string>;\n  /** Send an input event to the application window. */\n  sendInputEvent?: (event: unknown) => Promise<void>;\n  /** Execute JavaScript in the renderer and return the result. */\n  executeJavaScript?: (code: string) => Promise<unknown>;\n  /** List available blocks from all configured registries. */\n  listAvailableBlocks?: (query?: string) => Promise<unknown[]>;\n  /** Navigate the desktop UI to show a specific block. */\n  selectBlock?: (projectId: string, blockId: string) => Promise<void>;\n  /** Read recent lines from the application log. */\n  readAppLog?: (lines: number, search?: string) => Promise<string>;\n  /** List saved server connections. */\n  listConnections?: () => Promise<ServerConnection[]>;\n  /** Connect to a server. */\n  connectToServer?: (\n    addr: string,\n    login: string,\n    password?: string,\n  ) => Promise<{ status: string; message: string }>;\n  /** Get current connection status. */\n  getConnectionStatus?: () => Promise<{\n    connected: boolean;\n    type?: string;\n    addr?: string;\n    login?: string;\n  }>;\n  /** Disconnect from current server. */\n  disconnect?: () => Promise<void>;\n  /** Get detailed info about a specific block package. */\n  getBlockInfo?: (\n    registryUrl: string,\n    organization: string,\n    name: string,\n    version: string,\n  ) => Promise<unknown>;\n}\n\nexport interface ServerConnection {\n  addr: string;\n  login: string;\n  coreVersion?: string;\n  lastConnected?: string;\n}\n\n/** Branded type for the MCP server URL secret path segment. */\nexport type McpSecret = Branded<string, \"McpSecret\">;\n\nexport interface PlMcpServerOptions {\n  /** MiddleLayer instance providing access to projects, blocks, etc. Optional — server can start without it. */\n  middleLayer?: MiddleLayer;\n  /** Port to listen on. */\n  port: number;\n  /** Secret path segment for URL security. */\n  secret: McpSecret;\n  /** Optional callbacks for project lifecycle events (e.g. to sync UI state). */\n  callbacks?: PlMcpServerCallbacks;\n}\n\nexport class PlMcpServer {\n  private ml: MiddleLayer | null;\n  private port: number;\n  private readonly secret: McpSecret;\n  private readonly callbacks: PlMcpServerCallbacks;\n  private httpServer: Server | undefined;\n  private readonly transports = new Map<string, StreamableHTTPServerTransport>();\n\n  constructor(options: PlMcpServerOptions) {\n    this.ml = options.middleLayer ?? null;\n    this.port = options.port;\n    this.secret = options.secret;\n    this.callbacks = options.callbacks ?? {};\n  }\n\n  /** Set or update the MiddleLayer instance (e.g. after connecting to a server). */\n  setMiddleLayer(ml: MiddleLayer | null | undefined) {\n    this.ml = ml ?? null;\n  }\n\n  get url(): string {\n    return `http://127.0.0.1:${this.port}/${this.secret}/mcp`;\n  }\n\n  async start(): Promise<void> {\n    if (this.httpServer) {\n      throw new Error(\"MCP server is already running\");\n    }\n\n    const expectedPath = `/${this.secret}/mcp`;\n\n    this.httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n      try {\n        // Origin validation — only allow localhost\n        if (req.headers.origin !== undefined) {\n          try {\n            const origin = new URL(req.headers.origin);\n            if (origin.hostname !== \"localhost\" && origin.hostname !== \"127.0.0.1\") {\n              res.writeHead(403, { \"Content-Type\": \"application/json\" });\n              res.end(JSON.stringify({ error: \"Forbidden\" }));\n              return;\n            }\n          } catch {\n            res.writeHead(403, { \"Content-Type\": \"application/json\" });\n            res.end(JSON.stringify({ error: \"Forbidden\" }));\n            return;\n          }\n        }\n\n        // Secret path check\n        if (req.url !== expectedPath) {\n          res.writeHead(404, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Not Found\" }));\n          return;\n        }\n\n        // Route to existing session transport\n        const sessionId = req.headers[\"mcp-session-id\"] as string | undefined;\n        if (sessionId && this.transports.has(sessionId)) {\n          await this.transports.get(sessionId)!.handleRequest(req, res);\n          return;\n        }\n\n        // New session — create transport and connect MCP server\n        const transport = new StreamableHTTPServerTransport({\n          sessionIdGenerator: () => randomUUID(),\n        });\n        transport.onclose = () => {\n          const sid = transport.sessionId;\n          if (sid) this.transports.delete(sid);\n        };\n\n        const server = this.createMcpServer();\n        await server.connect(transport);\n        await transport.handleRequest(req, res);\n\n        const sid = transport.sessionId;\n        if (sid) this.transports.set(sid, transport);\n      } catch {\n        if (!res.headersSent) {\n          res.writeHead(500, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Internal Server Error\" }));\n        }\n      }\n    });\n\n    const maxRetries = 10;\n    const requestHandler = this.httpServer.listeners(\"request\")[0] as (\n      req: IncomingMessage,\n      res: ServerResponse,\n    ) => void;\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      const server = this.httpServer;\n      try {\n        await new Promise<void>((resolve, reject) => {\n          server.listen(this.port, \"127.0.0.1\", () => resolve());\n          server.once(\"error\", reject);\n        });\n        // Read back the actual port (important when port is 0)\n        const addr = server.address();\n        if (addr && typeof addr === \"object\") {\n          this.port = addr.port;\n        }\n        return;\n      } catch (err: unknown) {\n        if (\n          err instanceof Error &&\n          \"code\" in err &&\n          err.code === \"EADDRINUSE\" &&\n          attempt < maxRetries - 1\n        ) {\n          server.removeAllListeners();\n          this.httpServer = createServer(requestHandler);\n          this.port++;\n          continue;\n        }\n        throw err;\n      }\n    }\n  }\n\n  async stop(): Promise<void> {\n    for (const transport of this.transports.values()) {\n      await transport.close();\n    }\n    this.transports.clear();\n\n    const server = this.httpServer;\n    if (server) {\n      await new Promise<void>((resolve, reject) => {\n        server.close((err) => (err ? reject(err) : resolve()));\n      });\n      this.httpServer = undefined;\n    }\n  }\n\n  private createMcpServer(): McpServer {\n    const sessionId = randomUUID().slice(0, 8);\n    const server = new McpServer({ name: \"pl\", version: \"0.1.0\" }, { capabilities: { tools: {} } });\n    this.registerTools(server, sessionId);\n    return server;\n  }\n\n  private registerTools(server: McpServer, sessionId: string): void {\n    const authorId = `mcp-${sessionId}`;\n    let localVersion = 0;\n    const ctx: ToolContext = {\n      getMl: () => this.ml,\n      requireMl: () => this.requireMl(),\n      resolveProject: (id) => this.resolveProject(id),\n      getOpenedProject: (id) => this.getOpenedProject(id),\n      callbacks: this.callbacks,\n      getAuthorMarker: () => ({ authorId, localVersion: ++localVersion }),\n    };\n    registerPingTool(server, ctx);\n    registerConnectionTools(server, ctx);\n    registerProjectTools(server, ctx);\n    registerBlockTools(server, ctx);\n    registerBlockStateTools(server, ctx);\n    registerAwaitTools(server, ctx);\n    registerLogTools(server, ctx);\n    registerDataQueryTools(server, ctx);\n    registerScreenshotTool(server, ctx);\n    registerUIInteractionTools(server, ctx);\n  }\n\n  /** Throws if MiddleLayer is not available (not connected to a server). */\n  private requireMl(): MiddleLayer {\n    if (!this.ml) throw new Error(\"Not connected to a server. Use connect_to_server first.\");\n    return this.ml;\n  }\n\n  /** Resolves a project from the list by its projectId (resourceIdToString format). */\n  private async resolveProject(projectId: string) {\n    const ml = this.requireMl();\n    await ml.projectList.refreshState();\n    const projects = await ml.projectList.awaitStableValue();\n    const entry = projects.find((p) => resourceIdToString(p.rid) === projectId);\n    if (!entry) throw new Error(`Project ${projectId} not found`);\n    return entry;\n  }\n\n  /** Gets an opened project by projectId. Resolves via project list → rid → getOpenedProject. */\n  private async getOpenedProject(projectId: string) {\n    const ml = this.requireMl();\n    const entry = await this.resolveProject(projectId);\n    return ml.getOpenedProject(entry.rid);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"server.js","names":[],"sources":["../src/server.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport { createServer, type IncomingMessage, type Server, type ServerResponse } from \"node:http\";\nimport { randomUUID } from \"node:crypto\";\nimport { type MiddleLayer, resourceIdToString } from \"@milaboratories/pl-middle-layer\";\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport type { ToolContext } from \"./tools/types\";\nimport { registerPingTool } from \"./tools/ping\";\nimport { registerConnectionTools } from \"./tools/connection\";\nimport { registerProjectTools } from \"./tools/projects\";\nimport { registerBlockTools } from \"./tools/blocks\";\nimport { registerBlockStateTools } from \"./tools/block-state\";\nimport { registerAwaitTools } from \"./tools/await\";\nimport { registerLogTools } from \"./tools/logs\";\nimport { registerDataQueryTools } from \"./tools/data-query\";\nimport { registerScreenshotTool } from \"./tools/screenshot\";\nimport { registerUIInteractionTools } from \"./tools/ui-interaction\";\n\nexport interface PlMcpServerCallbacks {\n  onProjectCreated?: (projectId: string) => void | Promise<void>;\n  onProjectOpened?: (projectId: string) => void | Promise<void>;\n  onProjectClosed?: (projectId: string) => void | Promise<void>;\n  onProjectDeleted?: (projectId: string) => void | Promise<void>;\n  /** Capture the current application window as a PNG screenshot. Returns base64-encoded PNG. */\n  captureScreenshot?: () => Promise<string>;\n  /** Send an input event to the application window. */\n  sendInputEvent?: (event: unknown) => Promise<void>;\n  /**\n   * Execute JavaScript in a renderer and return the result.\n   * With no `target`, runs in the topmost webContents (usually the main app).\n   * With `target`, runs in the specified block's webview (where `window.platforma` is\n   * exposed) — the block must already be loaded (e.g. via `select_block`).\n   */\n  executeJavaScript?: (\n    code: string,\n    target?: { projectId: string; blockId: string },\n  ) => Promise<unknown>;\n  /** List available blocks from all configured registries. */\n  listAvailableBlocks?: (query?: string) => Promise<unknown[]>;\n  /** Navigate the desktop UI to show a specific block. */\n  selectBlock?: (projectId: string, blockId: string) => Promise<void>;\n  /** Read recent lines from the application log. */\n  readAppLog?: (lines: number, search?: string) => Promise<string>;\n  /** List saved server connections. */\n  listConnections?: () => Promise<ServerConnection[]>;\n  /** Connect to a server. */\n  connectToServer?: (\n    addr: string,\n    login: string,\n    password?: string,\n  ) => Promise<{ status: string; message: string }>;\n  /** Get current connection status. */\n  getConnectionStatus?: () => Promise<{\n    connected: boolean;\n    type?: string;\n    addr?: string;\n    login?: string;\n  }>;\n  /** Disconnect from current server. */\n  disconnect?: () => Promise<void>;\n  /** Get detailed info about a specific block package. */\n  getBlockInfo?: (\n    registryUrl: string,\n    organization: string,\n    name: string,\n    version: string,\n  ) => Promise<unknown>;\n}\n\nexport interface ServerConnection {\n  addr: string;\n  login: string;\n  coreVersion?: string;\n  lastConnected?: string;\n}\n\n/** Branded type for the MCP server URL secret path segment. */\nexport type McpSecret = Branded<string, \"McpSecret\">;\n\nexport interface PlMcpServerOptions {\n  /** MiddleLayer instance providing access to projects, blocks, etc. Optional — server can start without it. */\n  middleLayer?: MiddleLayer;\n  /** Port to listen on. */\n  port: number;\n  /** Secret path segment for URL security. */\n  secret: McpSecret;\n  /** Optional callbacks for project lifecycle events (e.g. to sync UI state). */\n  callbacks?: PlMcpServerCallbacks;\n}\n\nexport class PlMcpServer {\n  private ml: MiddleLayer | null;\n  private port: number;\n  private readonly secret: McpSecret;\n  private readonly callbacks: PlMcpServerCallbacks;\n  private httpServer: Server | undefined;\n  private readonly transports = new Map<string, StreamableHTTPServerTransport>();\n\n  constructor(options: PlMcpServerOptions) {\n    this.ml = options.middleLayer ?? null;\n    this.port = options.port;\n    this.secret = options.secret;\n    this.callbacks = options.callbacks ?? {};\n  }\n\n  /** Set or update the MiddleLayer instance (e.g. after connecting to a server). */\n  setMiddleLayer(ml: MiddleLayer | null | undefined) {\n    this.ml = ml ?? null;\n  }\n\n  get url(): string {\n    return `http://127.0.0.1:${this.port}/${this.secret}/mcp`;\n  }\n\n  async start(): Promise<void> {\n    if (this.httpServer) {\n      throw new Error(\"MCP server is already running\");\n    }\n\n    const expectedPath = `/${this.secret}/mcp`;\n\n    this.httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n      try {\n        // Origin validation — only allow localhost\n        if (req.headers.origin !== undefined) {\n          try {\n            const origin = new URL(req.headers.origin);\n            if (origin.hostname !== \"localhost\" && origin.hostname !== \"127.0.0.1\") {\n              res.writeHead(403, { \"Content-Type\": \"application/json\" });\n              res.end(JSON.stringify({ error: \"Forbidden\" }));\n              return;\n            }\n          } catch {\n            res.writeHead(403, { \"Content-Type\": \"application/json\" });\n            res.end(JSON.stringify({ error: \"Forbidden\" }));\n            return;\n          }\n        }\n\n        // Secret path check\n        if (req.url !== expectedPath) {\n          res.writeHead(404, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Not Found\" }));\n          return;\n        }\n\n        // Route to existing session transport\n        const sessionId = req.headers[\"mcp-session-id\"] as string | undefined;\n        if (sessionId && this.transports.has(sessionId)) {\n          await this.transports.get(sessionId)!.handleRequest(req, res);\n          return;\n        }\n\n        // New session — create transport and connect MCP server\n        const transport = new StreamableHTTPServerTransport({\n          sessionIdGenerator: () => randomUUID(),\n        });\n        transport.onclose = () => {\n          const sid = transport.sessionId;\n          if (sid) this.transports.delete(sid);\n        };\n\n        const server = this.createMcpServer();\n        await server.connect(transport);\n        await transport.handleRequest(req, res);\n\n        const sid = transport.sessionId;\n        if (sid) this.transports.set(sid, transport);\n      } catch {\n        if (!res.headersSent) {\n          res.writeHead(500, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Internal Server Error\" }));\n        }\n      }\n    });\n\n    const maxRetries = 10;\n    const requestHandler = this.httpServer.listeners(\"request\")[0] as (\n      req: IncomingMessage,\n      res: ServerResponse,\n    ) => void;\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      const server = this.httpServer;\n      try {\n        await new Promise<void>((resolve, reject) => {\n          server.listen(this.port, \"127.0.0.1\", () => resolve());\n          server.once(\"error\", reject);\n        });\n        // Read back the actual port (important when port is 0)\n        const addr = server.address();\n        if (addr && typeof addr === \"object\") {\n          this.port = addr.port;\n        }\n        return;\n      } catch (err: unknown) {\n        if (\n          err instanceof Error &&\n          \"code\" in err &&\n          err.code === \"EADDRINUSE\" &&\n          attempt < maxRetries - 1\n        ) {\n          server.removeAllListeners();\n          this.httpServer = createServer(requestHandler);\n          this.port++;\n          continue;\n        }\n        throw err;\n      }\n    }\n  }\n\n  async stop(): Promise<void> {\n    for (const transport of this.transports.values()) {\n      await transport.close();\n    }\n    this.transports.clear();\n\n    const server = this.httpServer;\n    if (server) {\n      await new Promise<void>((resolve, reject) => {\n        server.close((err) => (err ? reject(err) : resolve()));\n      });\n      this.httpServer = undefined;\n    }\n  }\n\n  private createMcpServer(): McpServer {\n    const sessionId = randomUUID().slice(0, 8);\n    const server = new McpServer({ name: \"pl\", version: \"0.1.0\" }, { capabilities: { tools: {} } });\n    this.registerTools(server, sessionId);\n    return server;\n  }\n\n  private registerTools(server: McpServer, sessionId: string): void {\n    const authorId = `mcp-${sessionId}`;\n    let localVersion = 0;\n    const ctx: ToolContext = {\n      getMl: () => this.ml,\n      requireMl: () => this.requireMl(),\n      resolveProject: (id) => this.resolveProject(id),\n      getOpenedProject: (id) => this.getOpenedProject(id),\n      callbacks: this.callbacks,\n      getAuthorMarker: () => ({ authorId, localVersion: ++localVersion }),\n    };\n    registerPingTool(server, ctx);\n    registerConnectionTools(server, ctx);\n    registerProjectTools(server, ctx);\n    registerBlockTools(server, ctx);\n    registerBlockStateTools(server, ctx);\n    registerAwaitTools(server, ctx);\n    registerLogTools(server, ctx);\n    registerDataQueryTools(server, ctx);\n    registerScreenshotTool(server, ctx);\n    registerUIInteractionTools(server, ctx);\n  }\n\n  /** Throws if MiddleLayer is not available (not connected to a server). */\n  private requireMl(): MiddleLayer {\n    if (!this.ml) throw new Error(\"Not connected to a server. Use connect_to_server first.\");\n    return this.ml;\n  }\n\n  /** Resolves a project from the list by its projectId (resourceIdToString format). */\n  private async resolveProject(projectId: string) {\n    const ml = this.requireMl();\n    await ml.projectList.refreshState();\n    const projects = await ml.projectList.awaitStableValue();\n    const entry = projects.find((p) => resourceIdToString(p.rid) === projectId);\n    if (!entry) throw new Error(`Project ${projectId} not found`);\n    return entry;\n  }\n\n  /** Gets an opened project by projectId. Resolves via project list → rid → getOpenedProject. */\n  private async getOpenedProject(projectId: string) {\n    const ml = this.requireMl();\n    const entry = await this.resolveProject(projectId);\n    return ml.getOpenedProject(entry.rid);\n  }\n}\n"],"mappings":"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"}

package/dist/tools/block-state.cjs

@@ -3,6 +3,7 @@ const require_tokens = require("./tokens.cjs");
 const require_sandbox = require("./sandbox.cjs");
 let zod = require("zod");
 let _platforma_sdk_model = require("@platforma-sdk/model");
+let _milaboratories_pl_errors = require("@milaboratories/pl-errors");
 //#region src/tools/block-state.ts
 function registerBlockStateTools(server, ctx) {
 	server.registerTool("get_project_overview", {
@@ -58,10 +59,17 @@ function registerBlockStateTools(server, ctx) {
 			data: zod.z.record(zod.z.unknown()).describe("Block data object")
 		}
 	}, async ({ projectId, blockId, data }) => {
-		await (await ctx.getOpenedProject(projectId)).mutateBlockStorage(blockId, {
-			operation: "update-block-data",
-			value: data
-		}, ctx.getAuthorMarker());
+		const project = await ctx.getOpenedProject(projectId);
+		const value = data.args ?? data;
+		try {
+			await project.mutateBlockStorage(blockId, {
+				operation: "update-block-data",
+				value
+			}, ctx.getAuthorMarker());
+		} catch (e) {
+			if (e instanceof _milaboratories_pl_errors.ModelAPIVersionMismatchError) await project.setBlockArgs(blockId, value, ctx.getAuthorMarker());
+			else throw e;
+		}
 		return require_types.textResult({ ok: true });
 	});
 }

package/dist/tools/block-state.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block-state.cjs","names":["z","errorResult","textResult","safeEval","summarizeOutputs"],"sources":["../../src/tools/block-state.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { deriveDataFromStorage } from \"@platforma-sdk/model\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { summarizeOutputs } from \"./tokens\";\nimport { safeEval } from \"./sandbox\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerBlockStateTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"get_project_overview\",\n    {\n      description:\n        \"Get project overview with all blocks and their statuses (calculationStatus, canRun, stale, errors, upstreams/downstreams)\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID (must be opened)\"),\n      },\n    },\n    async ({ projectId }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      const overview = await project.overview.getValue();\n      if (!overview) return errorResult(\"Project overview not available yet.\");\n      return textResult({\n        label: overview.meta.label,\n        blocks: overview.blocks.map((b) => ({\n          id: b.id,\n          title: b.title ?? b.label,\n          calculationStatus: b.calculationStatus,\n          canRun: b.canRun,\n          stale: b.stale,\n          inputsValid: b.inputsValid,\n          outputErrors: b.outputErrors,\n          upstreams: b.upstreams,\n          downstreams: b.downstreams,\n        })),\n      });\n    },\n  );\n\n  server.registerTool(\n    \"get_block_state\",\n    {\n      description:\n        \"Get block state. Returns block args (data) and a concise output summary with token estimates by default. \" +\n        \"Use `transform` to extract specific data server-side without loading full outputs into context.\\n\\n\" +\n        \"Default: returns `{ data, outputs: [{ key, ok, hasValue, tokensEstimate }] }`\\n\\n\" +\n        \"Transform examples:\\n\" +\n        \"- `outputs.logs?.value` — get one specific output value\\n\" +\n        \"- `data` — get only block args\\n\" +\n        \"- `({ preset: outputs.preset?.value, qc: outputs.qc?.value })` — get specific outputs\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID\"),\n        blockId: z.string().describe(\"Block ID\"),\n        transform: z\n          .string()\n          .optional()\n          .describe(\n            \"JS expression evaluated server-side against full block state. \" +\n              \"Available variables: `data` (block args), `outputs` (raw outputs object). \" +\n              \"Omit for default concise summary.\",\n          ),\n        transformTimeout: z\n          .number()\n          .optional()\n          .default(5000)\n          .describe(\"Timeout in ms for transform evaluation (default 5000).\"),\n      },\n    },\n    async ({ projectId, blockId, transform, transformTimeout }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      const state = await project.getBlockState(blockId).getValue();\n      const data = deriveDataFromStorage(state.blockStorage);\n      if (transform) {\n        try {\n          const result = await safeEval(\n            transform,\n            { data, outputs: state.outputs },\n            transformTimeout,\n          );\n          return textResult(result);\n        } catch (e: unknown) {\n          return errorResult(\n            `Transform failed: ${e instanceof Error ? e.message : String(e)}`,\n            \"Check your JS expression syntax. Available variables: data, outputs.\",\n          );\n        }\n      }\n      return textResult({\n        data,\n        outputs: summarizeOutputs(state.outputs as Record<string, unknown> | undefined),\n      });\n    },\n  );\n\n  server.registerTool(\n    \"set_block_data\",\n    {\n      description: \"Set the user-facing data of a block (triggers args derivation and staging)\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID\"),\n        blockId: z.string().describe(\"Block ID\"),\n        data: z.record(z.unknown()).describe(\"Block data object\"),\n      },\n    },\n    async ({ projectId, blockId, data }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      await project.mutateBlockStorage(\n        blockId,\n        { operation: \"update-block-data\", value: data },\n        ctx.getAuthorMarker(),\n      );\n      return textResult({ ok: true });\n    },\n  );\n}\n"],"mappings":";;;;;;AAQA,SAAgB,wBAAwB,QAAmB,KAAwB;AACjF,QAAO,aACL,wBACA;EACE,aACE;EACF,aAAa,EACX,WAAWA,IAAAA,EAAE,QAAQ,CAAC,SAAS,8BAA8B,EAC9D;EACF,EACD,OAAO,EAAE,gBAAgB;EAEvB,MAAM,WAAW,OADD,MAAM,IAAI,iBAAiB,UAAU,EACtB,SAAS,UAAU;AAClD,MAAI,CAAC,SAAU,QAAOC,cAAAA,YAAY,sCAAsC;AACxE,SAAOC,cAAAA,WAAW;GAChB,OAAO,SAAS,KAAK;GACrB,QAAQ,SAAS,OAAO,KAAK,OAAO;IAClC,IAAI,EAAE;IACN,OAAO,EAAE,SAAS,EAAE;IACpB,mBAAmB,EAAE;IACrB,QAAQ,EAAE;IACV,OAAO,EAAE;IACT,aAAa,EAAE;IACf,cAAc,EAAE;IAChB,WAAW,EAAE;IACb,aAAa,EAAE;IAChB,EAAE;GACJ,CAAC;GAEL;AAED,QAAO,aACL,mBACA;EACE,aACE;EAOF,aAAa;GACX,WAAWF,IAAAA,EAAE,QAAQ,CAAC,SAAS,aAAa;GAC5C,SAASA,IAAAA,EAAE,QAAQ,CAAC,SAAS,WAAW;GACxC,WAAWA,IAAAA,EACR,QAAQ,CACR,UAAU,CACV,SACC,4KAGD;GACH,kBAAkBA,IAAAA,EACf,QAAQ,CACR,UAAU,CACV,QAAQ,IAAK,CACb,SAAS,yDAAyD;GACtE;EACF,EACD,OAAO,EAAE,WAAW,SAAS,WAAW,uBAAuB;EAE7D,MAAM,QAAQ,OADE,MAAM,IAAI,iBAAiB,UAAU,EACzB,cAAc,QAAQ,CAAC,UAAU;EAC7D,MAAM,QAAA,GAAA,qBAAA,uBAA6B,MAAM,aAAa;AACtD,MAAI,UACF,KAAI;AAMF,UAAOE,cAAAA,WALQ,MAAMC,gBAAAA,SACnB,WACA;IAAE;IAAM,SAAS,MAAM;IAAS,EAChC,iBACD,CACwB;WAClB,GAAY;AACnB,UAAOF,cAAAA,YACL,qBAAqB,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE,IAC/D,uEACD;;AAGL,SAAOC,cAAAA,WAAW;GAChB;GACA,SAASE,eAAAA,iBAAiB,MAAM,QAA+C;GAChF,CAAC;GAEL;AAED,QAAO,aACL,kBACA;EACE,aAAa;EACb,aAAa;GACX,WAAWJ,IAAAA,EAAE,QAAQ,CAAC,SAAS,aAAa;GAC5C,SAASA,IAAAA,EAAE,QAAQ,CAAC,SAAS,WAAW;GACxC,MAAMA,IAAAA,EAAE,OAAOA,IAAAA,EAAE,SAAS,CAAC,CAAC,SAAS,oBAAoB;GAC1D;EACF,EACD,OAAO,EAAE,WAAW,SAAS,WAAW;AAEtC,SADgB,MAAM,IAAI,iBAAiB,UAAU,EACvC,mBACZ,SACA;GAAE,WAAW;GAAqB,OAAO;GAAM,EAC/C,IAAI,iBAAiB,CACtB;AACD,SAAOE,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC"}
+{"version":3,"file":"block-state.cjs","names":["z","errorResult","textResult","safeEval","summarizeOutputs","ModelAPIVersionMismatchError"],"sources":["../../src/tools/block-state.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { deriveDataFromStorage } from \"@platforma-sdk/model\";\nimport { ModelAPIVersionMismatchError } from \"@milaboratories/pl-errors\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { summarizeOutputs } from \"./tokens\";\nimport { safeEval } from \"./sandbox\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerBlockStateTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"get_project_overview\",\n    {\n      description:\n        \"Get project overview with all blocks and their statuses (calculationStatus, canRun, stale, errors, upstreams/downstreams)\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID (must be opened)\"),\n      },\n    },\n    async ({ projectId }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      const overview = await project.overview.getValue();\n      if (!overview) return errorResult(\"Project overview not available yet.\");\n      return textResult({\n        label: overview.meta.label,\n        blocks: overview.blocks.map((b) => ({\n          id: b.id,\n          title: b.title ?? b.label,\n          calculationStatus: b.calculationStatus,\n          canRun: b.canRun,\n          stale: b.stale,\n          inputsValid: b.inputsValid,\n          outputErrors: b.outputErrors,\n          upstreams: b.upstreams,\n          downstreams: b.downstreams,\n        })),\n      });\n    },\n  );\n\n  server.registerTool(\n    \"get_block_state\",\n    {\n      description:\n        \"Get block state. Returns block args (data) and a concise output summary with token estimates by default. \" +\n        \"Use `transform` to extract specific data server-side without loading full outputs into context.\\n\\n\" +\n        \"Default: returns `{ data, outputs: [{ key, ok, hasValue, tokensEstimate }] }`\\n\\n\" +\n        \"Transform examples:\\n\" +\n        \"- `outputs.logs?.value` — get one specific output value\\n\" +\n        \"- `data` — get only block args\\n\" +\n        \"- `({ preset: outputs.preset?.value, qc: outputs.qc?.value })` — get specific outputs\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID\"),\n        blockId: z.string().describe(\"Block ID\"),\n        transform: z\n          .string()\n          .optional()\n          .describe(\n            \"JS expression evaluated server-side against full block state. \" +\n              \"Available variables: `data` (block args), `outputs` (raw outputs object). \" +\n              \"Omit for default concise summary.\",\n          ),\n        transformTimeout: z\n          .number()\n          .optional()\n          .default(5000)\n          .describe(\"Timeout in ms for transform evaluation (default 5000).\"),\n      },\n    },\n    async ({ projectId, blockId, transform, transformTimeout }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      const state = await project.getBlockState(blockId).getValue();\n      const data = deriveDataFromStorage(state.blockStorage);\n      if (transform) {\n        try {\n          const result = await safeEval(\n            transform,\n            { data, outputs: state.outputs },\n            transformTimeout,\n          );\n          return textResult(result);\n        } catch (e: unknown) {\n          return errorResult(\n            `Transform failed: ${e instanceof Error ? e.message : String(e)}`,\n            \"Check your JS expression syntax. Available variables: data, outputs.\",\n          );\n        }\n      }\n      return textResult({\n        data,\n        outputs: summarizeOutputs(state.outputs as Record<string, unknown> | undefined),\n      });\n    },\n  );\n\n  server.registerTool(\n    \"set_block_data\",\n    {\n      description: \"Set the user-facing data of a block (triggers args derivation and staging)\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID\"),\n        blockId: z.string().describe(\"Block ID\"),\n        data: z.record(z.unknown()).describe(\"Block data object\"),\n      },\n    },\n    async ({ projectId, blockId, data }) => {\n      const project = await ctx.getOpenedProject(projectId);\n\n      // V1 state shape: { args, uiState } — callers may pass either the full state\n      // or just the args object. Unwrap once for both V2 and V1 paths.\n      const value = data.args ?? data;\n\n      // Try V2 (BlockModelV3 storage facade) first, fall back to V1 (legacy setBlockArgs).\n      try {\n        await project.mutateBlockStorage(\n          blockId,\n          { operation: \"update-block-data\", value },\n          ctx.getAuthorMarker(),\n        );\n      } catch (e: unknown) {\n        if (e instanceof ModelAPIVersionMismatchError) {\n          await project.setBlockArgs(blockId, value, ctx.getAuthorMarker());\n        } else {\n          throw e;\n        }\n      }\n      return textResult({ ok: true });\n    },\n  );\n}\n"],"mappings":";;;;;;;AASA,SAAgB,wBAAwB,QAAmB,KAAwB;AACjF,QAAO,aACL,wBACA;EACE,aACE;EACF,aAAa,EACX,WAAWA,IAAAA,EAAE,QAAQ,CAAC,SAAS,8BAA8B,EAC9D;EACF,EACD,OAAO,EAAE,gBAAgB;EAEvB,MAAM,WAAW,OADD,MAAM,IAAI,iBAAiB,UAAU,EACtB,SAAS,UAAU;AAClD,MAAI,CAAC,SAAU,QAAOC,cAAAA,YAAY,sCAAsC;AACxE,SAAOC,cAAAA,WAAW;GAChB,OAAO,SAAS,KAAK;GACrB,QAAQ,SAAS,OAAO,KAAK,OAAO;IAClC,IAAI,EAAE;IACN,OAAO,EAAE,SAAS,EAAE;IACpB,mBAAmB,EAAE;IACrB,QAAQ,EAAE;IACV,OAAO,EAAE;IACT,aAAa,EAAE;IACf,cAAc,EAAE;IAChB,WAAW,EAAE;IACb,aAAa,EAAE;IAChB,EAAE;GACJ,CAAC;GAEL;AAED,QAAO,aACL,mBACA;EACE,aACE;EAOF,aAAa;GACX,WAAWF,IAAAA,EAAE,QAAQ,CAAC,SAAS,aAAa;GAC5C,SAASA,IAAAA,EAAE,QAAQ,CAAC,SAAS,WAAW;GACxC,WAAWA,IAAAA,EACR,QAAQ,CACR,UAAU,CACV,SACC,4KAGD;GACH,kBAAkBA,IAAAA,EACf,QAAQ,CACR,UAAU,CACV,QAAQ,IAAK,CACb,SAAS,yDAAyD;GACtE;EACF,EACD,OAAO,EAAE,WAAW,SAAS,WAAW,uBAAuB;EAE7D,MAAM,QAAQ,OADE,MAAM,IAAI,iBAAiB,UAAU,EACzB,cAAc,QAAQ,CAAC,UAAU;EAC7D,MAAM,QAAA,GAAA,qBAAA,uBAA6B,MAAM,aAAa;AACtD,MAAI,UACF,KAAI;AAMF,UAAOE,cAAAA,WALQ,MAAMC,gBAAAA,SACnB,WACA;IAAE;IAAM,SAAS,MAAM;IAAS,EAChC,iBACD,CACwB;WAClB,GAAY;AACnB,UAAOF,cAAAA,YACL,qBAAqB,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE,IAC/D,uEACD;;AAGL,SAAOC,cAAAA,WAAW;GAChB;GACA,SAASE,eAAAA,iBAAiB,MAAM,QAA+C;GAChF,CAAC;GAEL;AAED,QAAO,aACL,kBACA;EACE,aAAa;EACb,aAAa;GACX,WAAWJ,IAAAA,EAAE,QAAQ,CAAC,SAAS,aAAa;GAC5C,SAASA,IAAAA,EAAE,QAAQ,CAAC,SAAS,WAAW;GACxC,MAAMA,IAAAA,EAAE,OAAOA,IAAAA,EAAE,SAAS,CAAC,CAAC,SAAS,oBAAoB;GAC1D;EACF,EACD,OAAO,EAAE,WAAW,SAAS,WAAW;EACtC,MAAM,UAAU,MAAM,IAAI,iBAAiB,UAAU;EAIrD,MAAM,QAAQ,KAAK,QAAQ;AAG3B,MAAI;AACF,SAAM,QAAQ,mBACZ,SACA;IAAE,WAAW;IAAqB;IAAO,EACzC,IAAI,iBAAiB,CACtB;WACM,GAAY;AACnB,OAAI,aAAaK,0BAAAA,6BACf,OAAM,QAAQ,aAAa,SAAS,OAAO,IAAI,iBAAiB,CAAC;OAEjE,OAAM;;AAGV,SAAOH,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC"}

package/dist/tools/block-state.js

@@ -3,6 +3,7 @@ import { summarizeOutputs } from "./tokens.js";
 import { safeEval } from "./sandbox.js";
 import { z } from "zod";
 import { deriveDataFromStorage } from "@platforma-sdk/model";
+import { ModelAPIVersionMismatchError } from "@milaboratories/pl-errors";
 //#region src/tools/block-state.ts
 function registerBlockStateTools(server, ctx) {
 	server.registerTool("get_project_overview", {
@@ -58,10 +59,17 @@ function registerBlockStateTools(server, ctx) {
 			data: z.record(z.unknown()).describe("Block data object")
 		}
 	}, async ({ projectId, blockId, data }) => {
-		await (await ctx.getOpenedProject(projectId)).mutateBlockStorage(blockId, {
-			operation: "update-block-data",
-			value: data
-		}, ctx.getAuthorMarker());
+		const project = await ctx.getOpenedProject(projectId);
+		const value = data.args ?? data;
+		try {
+			await project.mutateBlockStorage(blockId, {
+				operation: "update-block-data",
+				value
+			}, ctx.getAuthorMarker());
+		} catch (e) {
+			if (e instanceof ModelAPIVersionMismatchError) await project.setBlockArgs(blockId, value, ctx.getAuthorMarker());
+			else throw e;
+		}
 		return textResult({ ok: true });
 	});
 }

package/dist/tools/block-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"block-state.js","names":[],"sources":["../../src/tools/block-state.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { deriveDataFromStorage } from \"@platforma-sdk/model\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { summarizeOutputs } from \"./tokens\";\nimport { safeEval } from \"./sandbox\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerBlockStateTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"get_project_overview\",\n    {\n      description:\n        \"Get project overview with all blocks and their statuses (calculationStatus, canRun, stale, errors, upstreams/downstreams)\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID (must be opened)\"),\n      },\n    },\n    async ({ projectId }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      const overview = await project.overview.getValue();\n      if (!overview) return errorResult(\"Project overview not available yet.\");\n      return textResult({\n        label: overview.meta.label,\n        blocks: overview.blocks.map((b) => ({\n          id: b.id,\n          title: b.title ?? b.label,\n          calculationStatus: b.calculationStatus,\n          canRun: b.canRun,\n          stale: b.stale,\n          inputsValid: b.inputsValid,\n          outputErrors: b.outputErrors,\n          upstreams: b.upstreams,\n          downstreams: b.downstreams,\n        })),\n      });\n    },\n  );\n\n  server.registerTool(\n    \"get_block_state\",\n    {\n      description:\n        \"Get block state. Returns block args (data) and a concise output summary with token estimates by default. \" +\n        \"Use `transform` to extract specific data server-side without loading full outputs into context.\\n\\n\" +\n        \"Default: returns `{ data, outputs: [{ key, ok, hasValue, tokensEstimate }] }`\\n\\n\" +\n        \"Transform examples:\\n\" +\n        \"- `outputs.logs?.value` — get one specific output value\\n\" +\n        \"- `data` — get only block args\\n\" +\n        \"- `({ preset: outputs.preset?.value, qc: outputs.qc?.value })` — get specific outputs\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID\"),\n        blockId: z.string().describe(\"Block ID\"),\n        transform: z\n          .string()\n          .optional()\n          .describe(\n            \"JS expression evaluated server-side against full block state. \" +\n              \"Available variables: `data` (block args), `outputs` (raw outputs object). \" +\n              \"Omit for default concise summary.\",\n          ),\n        transformTimeout: z\n          .number()\n          .optional()\n          .default(5000)\n          .describe(\"Timeout in ms for transform evaluation (default 5000).\"),\n      },\n    },\n    async ({ projectId, blockId, transform, transformTimeout }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      const state = await project.getBlockState(blockId).getValue();\n      const data = deriveDataFromStorage(state.blockStorage);\n      if (transform) {\n        try {\n          const result = await safeEval(\n            transform,\n            { data, outputs: state.outputs },\n            transformTimeout,\n          );\n          return textResult(result);\n        } catch (e: unknown) {\n          return errorResult(\n            `Transform failed: ${e instanceof Error ? e.message : String(e)}`,\n            \"Check your JS expression syntax. Available variables: data, outputs.\",\n          );\n        }\n      }\n      return textResult({\n        data,\n        outputs: summarizeOutputs(state.outputs as Record<string, unknown> | undefined),\n      });\n    },\n  );\n\n  server.registerTool(\n    \"set_block_data\",\n    {\n      description: \"Set the user-facing data of a block (triggers args derivation and staging)\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID\"),\n        blockId: z.string().describe(\"Block ID\"),\n        data: z.record(z.unknown()).describe(\"Block data object\"),\n      },\n    },\n    async ({ projectId, blockId, data }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      await project.mutateBlockStorage(\n        blockId,\n        { operation: \"update-block-data\", value: data },\n        ctx.getAuthorMarker(),\n      );\n      return textResult({ ok: true });\n    },\n  );\n}\n"],"mappings":";;;;;;AAQA,SAAgB,wBAAwB,QAAmB,KAAwB;AACjF,QAAO,aACL,wBACA;EACE,aACE;EACF,aAAa,EACX,WAAW,EAAE,QAAQ,CAAC,SAAS,8BAA8B,EAC9D;EACF,EACD,OAAO,EAAE,gBAAgB;EAEvB,MAAM,WAAW,OADD,MAAM,IAAI,iBAAiB,UAAU,EACtB,SAAS,UAAU;AAClD,MAAI,CAAC,SAAU,QAAO,YAAY,sCAAsC;AACxE,SAAO,WAAW;GAChB,OAAO,SAAS,KAAK;GACrB,QAAQ,SAAS,OAAO,KAAK,OAAO;IAClC,IAAI,EAAE;IACN,OAAO,EAAE,SAAS,EAAE;IACpB,mBAAmB,EAAE;IACrB,QAAQ,EAAE;IACV,OAAO,EAAE;IACT,aAAa,EAAE;IACf,cAAc,EAAE;IAChB,WAAW,EAAE;IACb,aAAa,EAAE;IAChB,EAAE;GACJ,CAAC;GAEL;AAED,QAAO,aACL,mBACA;EACE,aACE;EAOF,aAAa;GACX,WAAW,EAAE,QAAQ,CAAC,SAAS,aAAa;GAC5C,SAAS,EAAE,QAAQ,CAAC,SAAS,WAAW;GACxC,WAAW,EACR,QAAQ,CACR,UAAU,CACV,SACC,4KAGD;GACH,kBAAkB,EACf,QAAQ,CACR,UAAU,CACV,QAAQ,IAAK,CACb,SAAS,yDAAyD;GACtE;EACF,EACD,OAAO,EAAE,WAAW,SAAS,WAAW,uBAAuB;EAE7D,MAAM,QAAQ,OADE,MAAM,IAAI,iBAAiB,UAAU,EACzB,cAAc,QAAQ,CAAC,UAAU;EAC7D,MAAM,OAAO,sBAAsB,MAAM,aAAa;AACtD,MAAI,UACF,KAAI;AAMF,UAAO,WALQ,MAAM,SACnB,WACA;IAAE;IAAM,SAAS,MAAM;IAAS,EAChC,iBACD,CACwB;WAClB,GAAY;AACnB,UAAO,YACL,qBAAqB,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE,IAC/D,uEACD;;AAGL,SAAO,WAAW;GAChB;GACA,SAAS,iBAAiB,MAAM,QAA+C;GAChF,CAAC;GAEL;AAED,QAAO,aACL,kBACA;EACE,aAAa;EACb,aAAa;GACX,WAAW,EAAE,QAAQ,CAAC,SAAS,aAAa;GAC5C,SAAS,EAAE,QAAQ,CAAC,SAAS,WAAW;GACxC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,SAAS,oBAAoB;GAC1D;EACF,EACD,OAAO,EAAE,WAAW,SAAS,WAAW;AAEtC,SADgB,MAAM,IAAI,iBAAiB,UAAU,EACvC,mBACZ,SACA;GAAE,WAAW;GAAqB,OAAO;GAAM,EAC/C,IAAI,iBAAiB,CACtB;AACD,SAAO,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC"}
+{"version":3,"file":"block-state.js","names":[],"sources":["../../src/tools/block-state.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { deriveDataFromStorage } from \"@platforma-sdk/model\";\nimport { ModelAPIVersionMismatchError } from \"@milaboratories/pl-errors\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { summarizeOutputs } from \"./tokens\";\nimport { safeEval } from \"./sandbox\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerBlockStateTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"get_project_overview\",\n    {\n      description:\n        \"Get project overview with all blocks and their statuses (calculationStatus, canRun, stale, errors, upstreams/downstreams)\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID (must be opened)\"),\n      },\n    },\n    async ({ projectId }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      const overview = await project.overview.getValue();\n      if (!overview) return errorResult(\"Project overview not available yet.\");\n      return textResult({\n        label: overview.meta.label,\n        blocks: overview.blocks.map((b) => ({\n          id: b.id,\n          title: b.title ?? b.label,\n          calculationStatus: b.calculationStatus,\n          canRun: b.canRun,\n          stale: b.stale,\n          inputsValid: b.inputsValid,\n          outputErrors: b.outputErrors,\n          upstreams: b.upstreams,\n          downstreams: b.downstreams,\n        })),\n      });\n    },\n  );\n\n  server.registerTool(\n    \"get_block_state\",\n    {\n      description:\n        \"Get block state. Returns block args (data) and a concise output summary with token estimates by default. \" +\n        \"Use `transform` to extract specific data server-side without loading full outputs into context.\\n\\n\" +\n        \"Default: returns `{ data, outputs: [{ key, ok, hasValue, tokensEstimate }] }`\\n\\n\" +\n        \"Transform examples:\\n\" +\n        \"- `outputs.logs?.value` — get one specific output value\\n\" +\n        \"- `data` — get only block args\\n\" +\n        \"- `({ preset: outputs.preset?.value, qc: outputs.qc?.value })` — get specific outputs\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID\"),\n        blockId: z.string().describe(\"Block ID\"),\n        transform: z\n          .string()\n          .optional()\n          .describe(\n            \"JS expression evaluated server-side against full block state. \" +\n              \"Available variables: `data` (block args), `outputs` (raw outputs object). \" +\n              \"Omit for default concise summary.\",\n          ),\n        transformTimeout: z\n          .number()\n          .optional()\n          .default(5000)\n          .describe(\"Timeout in ms for transform evaluation (default 5000).\"),\n      },\n    },\n    async ({ projectId, blockId, transform, transformTimeout }) => {\n      const project = await ctx.getOpenedProject(projectId);\n      const state = await project.getBlockState(blockId).getValue();\n      const data = deriveDataFromStorage(state.blockStorage);\n      if (transform) {\n        try {\n          const result = await safeEval(\n            transform,\n            { data, outputs: state.outputs },\n            transformTimeout,\n          );\n          return textResult(result);\n        } catch (e: unknown) {\n          return errorResult(\n            `Transform failed: ${e instanceof Error ? e.message : String(e)}`,\n            \"Check your JS expression syntax. Available variables: data, outputs.\",\n          );\n        }\n      }\n      return textResult({\n        data,\n        outputs: summarizeOutputs(state.outputs as Record<string, unknown> | undefined),\n      });\n    },\n  );\n\n  server.registerTool(\n    \"set_block_data\",\n    {\n      description: \"Set the user-facing data of a block (triggers args derivation and staging)\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID\"),\n        blockId: z.string().describe(\"Block ID\"),\n        data: z.record(z.unknown()).describe(\"Block data object\"),\n      },\n    },\n    async ({ projectId, blockId, data }) => {\n      const project = await ctx.getOpenedProject(projectId);\n\n      // V1 state shape: { args, uiState } — callers may pass either the full state\n      // or just the args object. Unwrap once for both V2 and V1 paths.\n      const value = data.args ?? data;\n\n      // Try V2 (BlockModelV3 storage facade) first, fall back to V1 (legacy setBlockArgs).\n      try {\n        await project.mutateBlockStorage(\n          blockId,\n          { operation: \"update-block-data\", value },\n          ctx.getAuthorMarker(),\n        );\n      } catch (e: unknown) {\n        if (e instanceof ModelAPIVersionMismatchError) {\n          await project.setBlockArgs(blockId, value, ctx.getAuthorMarker());\n        } else {\n          throw e;\n        }\n      }\n      return textResult({ ok: true });\n    },\n  );\n}\n"],"mappings":";;;;;;;AASA,SAAgB,wBAAwB,QAAmB,KAAwB;AACjF,QAAO,aACL,wBACA;EACE,aACE;EACF,aAAa,EACX,WAAW,EAAE,QAAQ,CAAC,SAAS,8BAA8B,EAC9D;EACF,EACD,OAAO,EAAE,gBAAgB;EAEvB,MAAM,WAAW,OADD,MAAM,IAAI,iBAAiB,UAAU,EACtB,SAAS,UAAU;AAClD,MAAI,CAAC,SAAU,QAAO,YAAY,sCAAsC;AACxE,SAAO,WAAW;GAChB,OAAO,SAAS,KAAK;GACrB,QAAQ,SAAS,OAAO,KAAK,OAAO;IAClC,IAAI,EAAE;IACN,OAAO,EAAE,SAAS,EAAE;IACpB,mBAAmB,EAAE;IACrB,QAAQ,EAAE;IACV,OAAO,EAAE;IACT,aAAa,EAAE;IACf,cAAc,EAAE;IAChB,WAAW,EAAE;IACb,aAAa,EAAE;IAChB,EAAE;GACJ,CAAC;GAEL;AAED,QAAO,aACL,mBACA;EACE,aACE;EAOF,aAAa;GACX,WAAW,EAAE,QAAQ,CAAC,SAAS,aAAa;GAC5C,SAAS,EAAE,QAAQ,CAAC,SAAS,WAAW;GACxC,WAAW,EACR,QAAQ,CACR,UAAU,CACV,SACC,4KAGD;GACH,kBAAkB,EACf,QAAQ,CACR,UAAU,CACV,QAAQ,IAAK,CACb,SAAS,yDAAyD;GACtE;EACF,EACD,OAAO,EAAE,WAAW,SAAS,WAAW,uBAAuB;EAE7D,MAAM,QAAQ,OADE,MAAM,IAAI,iBAAiB,UAAU,EACzB,cAAc,QAAQ,CAAC,UAAU;EAC7D,MAAM,OAAO,sBAAsB,MAAM,aAAa;AACtD,MAAI,UACF,KAAI;AAMF,UAAO,WALQ,MAAM,SACnB,WACA;IAAE;IAAM,SAAS,MAAM;IAAS,EAChC,iBACD,CACwB;WAClB,GAAY;AACnB,UAAO,YACL,qBAAqB,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE,IAC/D,uEACD;;AAGL,SAAO,WAAW;GAChB;GACA,SAAS,iBAAiB,MAAM,QAA+C;GAChF,CAAC;GAEL;AAED,QAAO,aACL,kBACA;EACE,aAAa;EACb,aAAa;GACX,WAAW,EAAE,QAAQ,CAAC,SAAS,aAAa;GAC5C,SAAS,EAAE,QAAQ,CAAC,SAAS,WAAW;GACxC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,SAAS,oBAAoB;GAC1D;EACF,EACD,OAAO,EAAE,WAAW,SAAS,WAAW;EACtC,MAAM,UAAU,MAAM,IAAI,iBAAiB,UAAU;EAIrD,MAAM,QAAQ,KAAK,QAAQ;AAG3B,MAAI;AACF,SAAM,QAAQ,mBACZ,SACA;IAAE,WAAW;IAAqB;IAAO,EACzC,IAAI,iBAAiB,CACtB;WACM,GAAY;AACnB,OAAI,aAAa,6BACf,OAAM,QAAQ,aAAa,SAAS,OAAO,IAAI,iBAAiB,CAAC;OAEjE,OAAM;;AAGV,SAAO,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC"}

package/dist/tools/ui-interaction.cjs

@@ -104,11 +104,20 @@ function registerUIInteractionTools(server, ctx) {
 		return require_types.textResult({ ok: true });
 	});
 	server.registerTool("execute_js", {
-		description: "Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.",
-		inputSchema: { code: zod.z.string().describe("JavaScript code to execute") }
-	}, async ({ code }) => {
+		description: "Execute JavaScript in a renderer and return the result. By default runs in the topmost webContents (main app / topmost modal). Pass projectId + blockId to run inside that block's webview, where `window.platforma` is exposed and the driverKit (e.g. `window.platforma.lsDriver.getLocalFileHandle`) is callable. The block must already be open — call `select_block` first if needed.",
+		inputSchema: {
+			code: zod.z.string().describe("JavaScript code to execute"),
+			projectId: zod.z.string().optional().describe("Target project ID. Must be paired with blockId."),
+			blockId: zod.z.string().optional().describe("Target block ID. When provided with projectId, JS runs in that block's webview (where `window.platforma` is available).")
+		}
+	}, async ({ code, projectId, blockId }) => {
 		if (!ctx.callbacks.executeJavaScript) return require_types.errorResult("JS execution is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
-		return require_types.textResult(await ctx.callbacks.executeJavaScript(code));
+		if (projectId === void 0 !== (blockId === void 0)) return require_types.errorResult("projectId and blockId must be provided together.", "Either pass both to target a specific block's webview, or pass neither to run in the topmost webContents.");
+		const target = projectId !== void 0 && blockId !== void 0 ? {
+			projectId,
+			blockId
+		} : void 0;
+		return require_types.textResult(await ctx.callbacks.executeJavaScript(code, target));
 	});
 }
 //#endregion

package/dist/tools/ui-interaction.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ui-interaction.cjs","names":["z","errorResult","textResult"],"sources":["../../src/tools/ui-interaction.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerUIInteractionTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"click\",\n    {\n      description:\n        \"Click at coordinates (x, y) in the application window. Use capture_screenshot to find element positions.\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate\"),\n        y: z.number().describe(\"Y coordinate\"),\n        doubleClick: z.boolean().optional().describe(\"Double click\"),\n      },\n    },\n    async ({ x, y, doubleClick }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const clickCount = doubleClick ? 2 : 1;\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseDown\",\n        x,\n        y,\n        button: \"left\",\n        clickCount,\n      });\n      await ctx.callbacks.sendInputEvent({ type: \"mouseUp\", x, y, button: \"left\", clickCount });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"type_text\",\n    {\n      description: \"Type text into the currently focused element\",\n      inputSchema: {\n        text: z.string().describe(\"Text to type\"),\n      },\n    },\n    async ({ text }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      for (const char of text) {\n        await ctx.callbacks.sendInputEvent({ type: \"keyDown\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"char\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"keyUp\", keyCode: char });\n      }\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"press_key\",\n    {\n      description: \"Press a keyboard key (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp, etc.)\",\n      inputSchema: {\n        key: z\n          .string()\n          .describe(\"Key name (e.g. 'Enter', 'Tab', 'Escape', 'Backspace', 'ArrowDown')\"),\n        modifiers: z\n          .array(z.enum([\"shift\", \"control\", \"alt\", \"meta\"]))\n          .optional()\n          .describe(\"Modifier keys to hold\"),\n      },\n    },\n    async ({ key, modifiers }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyDown\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyUp\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"scroll\",\n    {\n      description: \"Scroll the page at a given position\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate to scroll at\"),\n        y: z.number().describe(\"Y coordinate to scroll at\"),\n        deltaX: z.number().optional().default(0).describe(\"Horizontal scroll amount\"),\n        deltaY: z.number().describe(\"Vertical scroll amount (negative = up, positive = down)\"),\n      },\n    },\n    async ({ x, y, deltaX, deltaY }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseWheel\",\n        x,\n        y,\n        deltaX: deltaX ?? 0,\n        deltaY,\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"execute_js\",\n    {\n      description:\n        \"Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.\",\n      inputSchema: {\n        code: z.string().describe(\"JavaScript code to execute\"),\n      },\n    },\n    async ({ code }) => {\n      if (!ctx.callbacks.executeJavaScript) {\n        return errorResult(\n          \"JS execution is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const result = await ctx.callbacks.executeJavaScript(code);\n      return textResult(result);\n    },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"ui-interaction.cjs","names":["z","errorResult","textResult"],"sources":["../../src/tools/ui-interaction.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerUIInteractionTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"click\",\n    {\n      description:\n        \"Click at coordinates (x, y) in the application window. Use capture_screenshot to find element positions.\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate\"),\n        y: z.number().describe(\"Y coordinate\"),\n        doubleClick: z.boolean().optional().describe(\"Double click\"),\n      },\n    },\n    async ({ x, y, doubleClick }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const clickCount = doubleClick ? 2 : 1;\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseDown\",\n        x,\n        y,\n        button: \"left\",\n        clickCount,\n      });\n      await ctx.callbacks.sendInputEvent({ type: \"mouseUp\", x, y, button: \"left\", clickCount });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"type_text\",\n    {\n      description: \"Type text into the currently focused element\",\n      inputSchema: {\n        text: z.string().describe(\"Text to type\"),\n      },\n    },\n    async ({ text }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      for (const char of text) {\n        await ctx.callbacks.sendInputEvent({ type: \"keyDown\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"char\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"keyUp\", keyCode: char });\n      }\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"press_key\",\n    {\n      description: \"Press a keyboard key (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp, etc.)\",\n      inputSchema: {\n        key: z\n          .string()\n          .describe(\"Key name (e.g. 'Enter', 'Tab', 'Escape', 'Backspace', 'ArrowDown')\"),\n        modifiers: z\n          .array(z.enum([\"shift\", \"control\", \"alt\", \"meta\"]))\n          .optional()\n          .describe(\"Modifier keys to hold\"),\n      },\n    },\n    async ({ key, modifiers }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyDown\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyUp\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"scroll\",\n    {\n      description: \"Scroll the page at a given position\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate to scroll at\"),\n        y: z.number().describe(\"Y coordinate to scroll at\"),\n        deltaX: z.number().optional().default(0).describe(\"Horizontal scroll amount\"),\n        deltaY: z.number().describe(\"Vertical scroll amount (negative = up, positive = down)\"),\n      },\n    },\n    async ({ x, y, deltaX, deltaY }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseWheel\",\n        x,\n        y,\n        deltaX: deltaX ?? 0,\n        deltaY,\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"execute_js\",\n    {\n      description:\n        \"Execute JavaScript in a renderer and return the result. By default runs in the topmost webContents (main app / topmost modal). Pass projectId + blockId to run inside that block's webview, where `window.platforma` is exposed and the driverKit (e.g. `window.platforma.lsDriver.getLocalFileHandle`) is callable. The block must already be open — call `select_block` first if needed.\",\n      inputSchema: {\n        code: z.string().describe(\"JavaScript code to execute\"),\n        projectId: z\n          .string()\n          .optional()\n          .describe(\"Target project ID. Must be paired with blockId.\"),\n        blockId: z\n          .string()\n          .optional()\n          .describe(\n            \"Target block ID. When provided with projectId, JS runs in that block's webview (where `window.platforma` is available).\",\n          ),\n      },\n    },\n    async ({ code, projectId, blockId }) => {\n      if (!ctx.callbacks.executeJavaScript) {\n        return errorResult(\n          \"JS execution is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      if ((projectId === undefined) !== (blockId === undefined)) {\n        return errorResult(\n          \"projectId and blockId must be provided together.\",\n          \"Either pass both to target a specific block's webview, or pass neither to run in the topmost webContents.\",\n        );\n      }\n      const target =\n        projectId !== undefined && blockId !== undefined ? { projectId, blockId } : undefined;\n      const result = await ctx.callbacks.executeJavaScript(code, target);\n      return textResult(result);\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/tools/ui-interaction.js

@@ -104,11 +104,20 @@ function registerUIInteractionTools(server, ctx) {
 		return textResult({ ok: true });
 	});
 	server.registerTool("execute_js", {
-		description: "Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.",
-		inputSchema: { code: z.string().describe("JavaScript code to execute") }
-	}, async ({ code }) => {
+		description: "Execute JavaScript in a renderer and return the result. By default runs in the topmost webContents (main app / topmost modal). Pass projectId + blockId to run inside that block's webview, where `window.platforma` is exposed and the driverKit (e.g. `window.platforma.lsDriver.getLocalFileHandle`) is callable. The block must already be open — call `select_block` first if needed.",
+		inputSchema: {
+			code: z.string().describe("JavaScript code to execute"),
+			projectId: z.string().optional().describe("Target project ID. Must be paired with blockId."),
+			blockId: z.string().optional().describe("Target block ID. When provided with projectId, JS runs in that block's webview (where `window.platforma` is available).")
+		}
+	}, async ({ code, projectId, blockId }) => {
 		if (!ctx.callbacks.executeJavaScript) return errorResult("JS execution is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
-		return textResult(await ctx.callbacks.executeJavaScript(code));
+		if (projectId === void 0 !== (blockId === void 0)) return errorResult("projectId and blockId must be provided together.", "Either pass both to target a specific block's webview, or pass neither to run in the topmost webContents.");
+		const target = projectId !== void 0 && blockId !== void 0 ? {
+			projectId,
+			blockId
+		} : void 0;
+		return textResult(await ctx.callbacks.executeJavaScript(code, target));
 	});
 }
 //#endregion

package/dist/tools/ui-interaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-interaction.js","names":[],"sources":["../../src/tools/ui-interaction.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerUIInteractionTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"click\",\n    {\n      description:\n        \"Click at coordinates (x, y) in the application window. Use capture_screenshot to find element positions.\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate\"),\n        y: z.number().describe(\"Y coordinate\"),\n        doubleClick: z.boolean().optional().describe(\"Double click\"),\n      },\n    },\n    async ({ x, y, doubleClick }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const clickCount = doubleClick ? 2 : 1;\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseDown\",\n        x,\n        y,\n        button: \"left\",\n        clickCount,\n      });\n      await ctx.callbacks.sendInputEvent({ type: \"mouseUp\", x, y, button: \"left\", clickCount });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"type_text\",\n    {\n      description: \"Type text into the currently focused element\",\n      inputSchema: {\n        text: z.string().describe(\"Text to type\"),\n      },\n    },\n    async ({ text }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      for (const char of text) {\n        await ctx.callbacks.sendInputEvent({ type: \"keyDown\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"char\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"keyUp\", keyCode: char });\n      }\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"press_key\",\n    {\n      description: \"Press a keyboard key (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp, etc.)\",\n      inputSchema: {\n        key: z\n          .string()\n          .describe(\"Key name (e.g. 'Enter', 'Tab', 'Escape', 'Backspace', 'ArrowDown')\"),\n        modifiers: z\n          .array(z.enum([\"shift\", \"control\", \"alt\", \"meta\"]))\n          .optional()\n          .describe(\"Modifier keys to hold\"),\n      },\n    },\n    async ({ key, modifiers }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyDown\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyUp\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"scroll\",\n    {\n      description: \"Scroll the page at a given position\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate to scroll at\"),\n        y: z.number().describe(\"Y coordinate to scroll at\"),\n        deltaX: z.number().optional().default(0).describe(\"Horizontal scroll amount\"),\n        deltaY: z.number().describe(\"Vertical scroll amount (negative = up, positive = down)\"),\n      },\n    },\n    async ({ x, y, deltaX, deltaY }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseWheel\",\n        x,\n        y,\n        deltaX: deltaX ?? 0,\n        deltaY,\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"execute_js\",\n    {\n      description:\n        \"Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.\",\n      inputSchema: {\n        code: z.string().describe(\"JavaScript code to execute\"),\n      },\n    },\n    async ({ code }) => {\n      if (!ctx.callbacks.executeJavaScript) {\n        return errorResult(\n          \"JS execution is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const result = await ctx.callbacks.executeJavaScript(code);\n      return textResult(result);\n    },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"ui-interaction.js","names":[],"sources":["../../src/tools/ui-interaction.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerUIInteractionTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"click\",\n    {\n      description:\n        \"Click at coordinates (x, y) in the application window. Use capture_screenshot to find element positions.\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate\"),\n        y: z.number().describe(\"Y coordinate\"),\n        doubleClick: z.boolean().optional().describe(\"Double click\"),\n      },\n    },\n    async ({ x, y, doubleClick }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const clickCount = doubleClick ? 2 : 1;\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseDown\",\n        x,\n        y,\n        button: \"left\",\n        clickCount,\n      });\n      await ctx.callbacks.sendInputEvent({ type: \"mouseUp\", x, y, button: \"left\", clickCount });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"type_text\",\n    {\n      description: \"Type text into the currently focused element\",\n      inputSchema: {\n        text: z.string().describe(\"Text to type\"),\n      },\n    },\n    async ({ text }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      for (const char of text) {\n        await ctx.callbacks.sendInputEvent({ type: \"keyDown\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"char\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"keyUp\", keyCode: char });\n      }\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"press_key\",\n    {\n      description: \"Press a keyboard key (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp, etc.)\",\n      inputSchema: {\n        key: z\n          .string()\n          .describe(\"Key name (e.g. 'Enter', 'Tab', 'Escape', 'Backspace', 'ArrowDown')\"),\n        modifiers: z\n          .array(z.enum([\"shift\", \"control\", \"alt\", \"meta\"]))\n          .optional()\n          .describe(\"Modifier keys to hold\"),\n      },\n    },\n    async ({ key, modifiers }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyDown\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyUp\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"scroll\",\n    {\n      description: \"Scroll the page at a given position\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate to scroll at\"),\n        y: z.number().describe(\"Y coordinate to scroll at\"),\n        deltaX: z.number().optional().default(0).describe(\"Horizontal scroll amount\"),\n        deltaY: z.number().describe(\"Vertical scroll amount (negative = up, positive = down)\"),\n      },\n    },\n    async ({ x, y, deltaX, deltaY }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseWheel\",\n        x,\n        y,\n        deltaX: deltaX ?? 0,\n        deltaY,\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"execute_js\",\n    {\n      description:\n        \"Execute JavaScript in a renderer and return the result. By default runs in the topmost webContents (main app / topmost modal). Pass projectId + blockId to run inside that block's webview, where `window.platforma` is exposed and the driverKit (e.g. `window.platforma.lsDriver.getLocalFileHandle`) is callable. The block must already be open — call `select_block` first if needed.\",\n      inputSchema: {\n        code: z.string().describe(\"JavaScript code to execute\"),\n        projectId: z\n          .string()\n          .optional()\n          .describe(\"Target project ID. Must be paired with blockId.\"),\n        blockId: z\n          .string()\n          .optional()\n          .describe(\n            \"Target block ID. When provided with projectId, JS runs in that block's webview (where `window.platforma` is available).\",\n          ),\n      },\n    },\n    async ({ code, projectId, blockId }) => {\n      if (!ctx.callbacks.executeJavaScript) {\n        return errorResult(\n          \"JS execution is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      if ((projectId === undefined) !== (blockId === undefined)) {\n        return errorResult(\n          \"projectId and blockId must be provided together.\",\n          \"Either pass both to target a specific block's webview, or pass neither to run in the topmost webContents.\",\n        );\n      }\n      const target =\n        projectId !== undefined && blockId !== undefined ? { projectId, blockId } : undefined;\n      const result = await ctx.callbacks.executeJavaScript(code, target);\n      return textResult(result);\n    },\n  );\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-mcp-server",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "MCP server for Platforma Desktop",
   "keywords": [],
   "license": "UNLICENSED",
@@ -29,15 +29,16 @@
     "typescript": "~5.9.3",
     "vitest": "^4.1.3",
     "@milaboratories/build-configs": "2.0.0",
+    "@milaboratories/pl-errors": "1.2.8",
+    "@milaboratories/ts-configs": "1.2.3",
     "@milaboratories/pl-model-common": "1.31.2",
-    "@milaboratories/ts-builder": "1.3.1",
-    "@platforma-sdk/model": "1.65.0",
-    "@milaboratories/pl-middle-layer": "1.55.9",
-    "@milaboratories/ts-configs": "1.2.3"
+    "@milaboratories/ts-builder": "1.3.2",
+    "@milaboratories/pl-middle-layer": "1.55.13",
+    "@platforma-sdk/model": "1.65.4"
   },
   "peerDependencies": {
-    "@milaboratories/pl-middle-layer": ">=1.55.9",
-    "@platforma-sdk/model": ">=1.65.0"
+    "@milaboratories/pl-middle-layer": ">=1.55.13",
+    "@platforma-sdk/model": ">=1.65.4"
   },
   "engines": {
     "node": ">=22.0.0"

package/src/server.ts

@@ -25,8 +25,16 @@ export interface PlMcpServerCallbacks {
   captureScreenshot?: () => Promise<string>;
   /** Send an input event to the application window. */
   sendInputEvent?: (event: unknown) => Promise<void>;
-  /** Execute JavaScript in the renderer and return the result. */
-  executeJavaScript?: (code: string) => Promise<unknown>;
+  /**
+   * Execute JavaScript in a renderer and return the result.
+   * With no `target`, runs in the topmost webContents (usually the main app).
+   * With `target`, runs in the specified block's webview (where `window.platforma` is
+   * exposed) — the block must already be loaded (e.g. via `select_block`).
+   */
+  executeJavaScript?: (
+    code: string,
+    target?: { projectId: string; blockId: string },
+  ) => Promise<unknown>;
   /** List available blocks from all configured registries. */
   listAvailableBlocks?: (query?: string) => Promise<unknown[]>;
   /** Navigate the desktop UI to show a specific block. */

package/src/tools/block-state.ts

@@ -1,5 +1,6 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { deriveDataFromStorage } from "@platforma-sdk/model";
+import { ModelAPIVersionMismatchError } from "@milaboratories/pl-errors";
 import { z } from "zod";
 import type { ToolContext } from "./types";
 import { summarizeOutputs } from "./tokens";
@@ -104,11 +105,25 @@ export function registerBlockStateTools(server: McpServer, ctx: ToolContext): vo
     },
     async ({ projectId, blockId, data }) => {
       const project = await ctx.getOpenedProject(projectId);
-      await project.mutateBlockStorage(
-        blockId,
-        { operation: "update-block-data", value: data },
-        ctx.getAuthorMarker(),
-      );
+
+      // V1 state shape: { args, uiState } — callers may pass either the full state
+      // or just the args object. Unwrap once for both V2 and V1 paths.
+      const value = data.args ?? data;
+
+      // Try V2 (BlockModelV3 storage facade) first, fall back to V1 (legacy setBlockArgs).
+      try {
+        await project.mutateBlockStorage(
+          blockId,
+          { operation: "update-block-data", value },
+          ctx.getAuthorMarker(),
+        );
+      } catch (e: unknown) {
+        if (e instanceof ModelAPIVersionMismatchError) {
+          await project.setBlockArgs(blockId, value, ctx.getAuthorMarker());
+        } else {
+          throw e;
+        }
+      }
       return textResult({ ok: true });
     },
   );

package/src/tools/ui-interaction.ts

@@ -137,19 +137,37 @@ export function registerUIInteractionTools(server: McpServer, ctx: ToolContext):
     "execute_js",
     {
       description:
-        "Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.",
+        "Execute JavaScript in a renderer and return the result. By default runs in the topmost webContents (main app / topmost modal). Pass projectId + blockId to run inside that block's webview, where `window.platforma` is exposed and the driverKit (e.g. `window.platforma.lsDriver.getLocalFileHandle`) is callable. The block must already be open — call `select_block` first if needed.",
       inputSchema: {
         code: z.string().describe("JavaScript code to execute"),
+        projectId: z
+          .string()
+          .optional()
+          .describe("Target project ID. Must be paired with blockId."),
+        blockId: z
+          .string()
+          .optional()
+          .describe(
+            "Target block ID. When provided with projectId, JS runs in that block's webview (where `window.platforma` is available).",
+          ),
       },
     },
-    async ({ code }) => {
+    async ({ code, projectId, blockId }) => {
       if (!ctx.callbacks.executeJavaScript) {
         return errorResult(
           "JS execution is not available.",
           "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log",
         );
       }
-      const result = await ctx.callbacks.executeJavaScript(code);
+      if ((projectId === undefined) !== (blockId === undefined)) {
+        return errorResult(
+          "projectId and blockId must be provided together.",
+          "Either pass both to target a specific block's webview, or pass neither to run in the topmost webContents.",
+        );
+      }
+      const target =
+        projectId !== undefined && blockId !== undefined ? { projectId, blockId } : undefined;
+      const result = await ctx.callbacks.executeJavaScript(code, target);
       return textResult(result);
     },
   );