@llui/mcp 0.0.11 → 0.0.13

package/README.md

@@ -69,3 +69,49 @@ export default defineConfig({ plugins: [llui({ mcpPort: 5200 })] })
 | ------------------ | ------------------------------------------ |
 | `list_components`  | List all mounted component instances       |
 | `select_component` | Select a component for subsequent commands |
+
+### View and DOM
+
+| Tool                | Description                                                              |
+| ------------------- | ------------------------------------------------------------------------ |
+| `inspect_element`   | Rich report: tag, attrs, classes, data-\*, text, computed, box, bindings |
+| `get_rendered_html` | outerHTML of a selector (default = mount root), truncatable              |
+| `dom_diff`          | Compare expected HTML against rendered HTML                              |
+| `dispatch_event`    | Synthesize a browser event; returns Msgs produced + resulting state      |
+| `get_focus`         | Active element info: selector, tag, selection range                      |
+
+### Bindings and Scope
+
+| Tool                 | Description                                                    |
+| -------------------- | -------------------------------------------------------------- |
+| `force_rerender`     | Re-evaluate all bindings; returns indices that changed         |
+| `each_diff`          | Per-each-site add/remove/move/reuse per update                 |
+| `scope_tree`         | Scope hierarchy with kind (root/show/each/branch/child/portal) |
+| `disposer_log`       | Recent scope disposals with cause                              |
+| `list_dead_bindings` | Bindings that are dead or have never changed value             |
+| `binding_graph`      | state path -> binding indices (inverts compiler mask legend)   |
+
+### Effects
+
+| Tool              | Description                                                            |
+| ----------------- | ---------------------------------------------------------------------- |
+| `pending_effects` | Queued and in-flight effects                                           |
+| `effect_timeline` | Phased log: dispatched -> in-flight -> resolved/cancelled              |
+| `mock_effect`     | Register match->response mock; next matching effect resolves with mock |
+| `resolve_effect`  | Manually resolve a specific pending effect                             |
+
+### Time Travel and Utilities
+
+| Tool             | Description                                                    |
+| ---------------- | -------------------------------------------------------------- |
+| `step_back`      | Rewind N messages by replaying from init (pure mode default)   |
+| `coverage`       | Per-Msg variant fire counts + list of never-fired variants     |
+| `diff_state`     | Structured JSON diff between two state values                  |
+| `assert`         | Evaluate eq/neq/exists/gt/lt/in against a state path           |
+| `search_history` | Filter history by type, statePath change, effectType, or range |
+
+### Eval
+
+| Tool   | Description                                                           |
+| ------ | --------------------------------------------------------------------- |
+| `eval` | Arbitrary JS in page context; returns result + observability envelope |

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { LluiDebugAPI } from '@llui/dom';
+import { type ToolDefinition } from './tool-registry.js';
 /**
  * Walk up from `start` until we find a workspace root marker. Used by
  * both the MCP server (writing the active marker) and the Vite plugin
@@ -22,27 +23,21 @@ export declare function findWorkspaceRoot(start?: string): string;
  * when one runs from the repo root and the other from a subpackage.
  */
 export declare function mcpActiveFilePath(cwd?: string): string;
-interface McpToolDefinition {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: 'object';
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-}
-declare const TOOLS: McpToolDefinition[];
 export declare class LluiMcpServer {
-    /** Direct (same-process) debug API, used for tests or in-process bridging. */
-    private debugApi;
-    /** Bridge (WebSocket) state for out-of-process browser connection. */
-    private wsServer;
-    private browserWs;
-    private pending;
-    private bridgePort;
+    private readonly registry;
+    private readonly relay;
+    private readonly bridgePort;
+    private devUrl;
     constructor(bridgePort?: number);
     /** Connect to a debug API instance directly (for in-process usage). */
     connectDirect(api: LluiDebugAPI): void;
+    /**
+     * Set the dev-server URL that Phase 2's CDP fallback can navigate a
+     * Playwright browser to. Persisted into the active marker file so the
+     * Vite plugin (or other consumers) can rebroadcast it. If the bridge is
+     * already running, rewrites the marker so consumers see the update.
+     */
+    setDevUrl(url: string): void;
     /**
      * Start a WebSocket server on the configured bridge port. The browser-side
      * relay (injected by the Vite plugin in dev mode) connects here and forwards
@@ -52,15 +47,18 @@ export declare class LluiMcpServer {
     stopBridge(): void;
     private writeActiveFile;
     private removeActiveFile;
-    /** Invoke a debug API method — over the bridge if connected, else direct. */
-    private call;
     /** Get tool definitions for MCP handshake */
-    getTools(): McpToolDefinition[];
+    getTools(): ToolDefinition[];
     /** Handle an MCP tool call */
     handleToolCall(name: string, args: Record<string, unknown>): Promise<unknown>;
     /** Start the MCP server on stdin/stdout */
     start(): void;
     private handleRequest;
 }
-export { TOOLS as mcpToolDefinitions };
+/**
+ * Snapshot of all registered tool definitions. Kept as a named export for
+ * backward compatibility with downstream consumers that used to import the
+ * `TOOLS` array re-export under this alias.
+ */
+export declare const mcpToolDefinitions: ToolDefinition[];
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAO7C;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,CAgBvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAErE;AAID,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF;AAkBD,QAAA,MAAM,KAAK,EAAE,iBAAiB,EAgS7B,CAAA;AASD,qBAAa,aAAa;IACxB,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAA4B;IAC5C,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,UAAU,CAAQ;gBAEd,UAAU,SAAO;IAI7B,uEAAuE;IACvE,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAItC;;;;OAIG;IACH,WAAW,IAAI,IAAI;IA4BnB,UAAU,IAAI,IAAI;IASlB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,gBAAgB;IASxB,6EAA6E;YAC/D,IAAI;IAmBlB,6CAA6C;IAC7C,QAAQ,IAAI,iBAAiB,EAAE;IAI/B,8BAA8B;IACxB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAuInF,2CAA2C;IAC3C,KAAK,IAAI,IAAI;YAuBC,aAAa;CAsD5B;AAED,OAAO,EAAE,KAAK,IAAI,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAG7C,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAIxF;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,CAgBvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAErE;AAoBD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,MAAM,CAAsB;gBAExB,UAAU,SAAO;IAO7B,uEAAuE;IACvE,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAItC;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK5B;;;;OAIG;IACH,WAAW,IAAI,IAAI;IAQnB,UAAU,IAAI,IAAI;IAKlB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,gBAAgB;IASxB,6CAA6C;IAC7C,QAAQ,IAAI,cAAc,EAAE;IAI5B,8BAA8B;IACxB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAKnF,2CAA2C;IAC3C,KAAK,IAAI,IAAI;YAuBC,aAAa;CAsD5B;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAI3C,CAAA"}