llui-agent 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Franco Ponticelli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# llui-agent
+
+MCP bridge for the [LLui Agent Protocol](../../docs/superpowers/specs/2026-04-19-llui-agent-design.md). Install once into your LLM client; paste a `/llui-connect <url> <token>` into any Claude conversation to bind it to a running LLui app.
+
+## Install (Claude Desktop)
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or equivalent on your OS:
+
+```json
+{
+  "mcpServers": {
+    "llui": {
+      "command": "npx",
+      "args": ["-y", "llui-agent"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The 11 LLui tools (`llui_connect_session`, `llui_disconnect_session`, `describe_app`, `get_state`, `list_actions`, `send_message`, `get_confirm_result`, `wait_for_change`, `query_dom`, `describe_visible_content`, `describe_context`) and the `/llui-connect` prompt now appear in Claude.
+
+## Use
+
+Open any LLui app that's built with `@llui/agent/client`. Click "Connect with Claude" in the app. Copy the generated `/llui-connect <url> <token>` string into Claude. Claude will now talk to that specific app instance.
+
+Each Claude chat is bound to ONE LLui app at a time. To switch, run `/llui-disconnect` or start a new chat.
+
+## How it works
+
+1. Your LLui app mints a per-browser-session token and shows a `/llui-connect` string.
+2. You paste into Claude — the bridge records `{url, token}` for this chat.
+3. The bridge pings `POST {url}/describe` to validate and cache the app's schema.
+4. Subsequent Claude tool calls (`get_state`, `send_message`, etc.) forward to `{url}/<path>` with your token as a Bearer.
+5. Sensitive actions (`@requiresConfirm` in the app's code) route through a confirmation prompt that only the user can approve.

package/dist/binding.d.ts

@@ -0,0 +1,19 @@
+import type { LapDescribeResponse } from '@llui/agent/protocol';
+export type Binding = {
+    url: string;
+    token: string;
+    describe: LapDescribeResponse | null;
+};
+/**
+ * Per-MCP-session map. Keyed by the SDK's session id (one per Claude
+ * conversation). Spec §11.3.
+ */
+export declare class BindingMap {
+    private map;
+    set(sessionId: string, url: string, token: string): void;
+    get(sessionId: string): Binding | null;
+    setDescribe(sessionId: string, describe: LapDescribeResponse): void;
+    clear(sessionId: string): void;
+    has(sessionId: string): boolean;
+}
+//# sourceMappingURL=binding.d.ts.map

package/dist/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE/D,MAAM,MAAM,OAAO,GAAG;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAA;CACrC,CAAA;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAA6B;IAExC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAGxD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAGtC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAInE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAG9B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAGhC"}

package/dist/binding.js

@@ -0,0 +1,25 @@
+/**
+ * Per-MCP-session map. Keyed by the SDK's session id (one per Claude
+ * conversation). Spec §11.3.
+ */
+export class BindingMap {
+    map = new Map();
+    set(sessionId, url, token) {
+        this.map.set(sessionId, { url, token, describe: null });
+    }
+    get(sessionId) {
+        return this.map.get(sessionId) ?? null;
+    }
+    setDescribe(sessionId, describe) {
+        const b = this.map.get(sessionId);
+        if (b)
+            this.map.set(sessionId, { ...b, describe });
+    }
+    clear(sessionId) {
+        this.map.delete(sessionId);
+    }
+    has(sessionId) {
+        return this.map.has(sessionId);
+    }
+}
+//# sourceMappingURL=binding.js.map

package/dist/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,GAAG,GAAG,IAAI,GAAG,EAAmB,CAAA;IAExC,GAAG,CAAC,SAAiB,EAAE,GAAW,EAAE,KAAa;QAC/C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,CAAC;IACD,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAA;IACxC,CAAC;IACD,WAAW,CAAC,SAAiB,EAAE,QAA6B;QAC1D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACjC,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IACpD,CAAC;IACD,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC5B,CAAC;IACD,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;CACF","sourcesContent":["import type { LapDescribeResponse } from '@llui/agent/protocol'\n\nexport type Binding = {\n  url: string // LAP base path, e.g. \"https://app/agent/lap/v1\"\n  token: string\n  describe: LapDescribeResponse | null // cached describe_app response; populated on bind\n}\n\n/**\n * Per-MCP-session map. Keyed by the SDK's session id (one per Claude\n * conversation). Spec §11.3.\n */\nexport class BindingMap {\n  private map = new Map<string, Binding>()\n\n  set(sessionId: string, url: string, token: string): void {\n    this.map.set(sessionId, { url, token, describe: null })\n  }\n  get(sessionId: string): Binding | null {\n    return this.map.get(sessionId) ?? null\n  }\n  setDescribe(sessionId: string, describe: LapDescribeResponse): void {\n    const b = this.map.get(sessionId)\n    if (b) this.map.set(sessionId, { ...b, describe })\n  }\n  clear(sessionId: string): void {\n    this.map.delete(sessionId)\n  }\n  has(sessionId: string): boolean {\n    return this.map.has(sessionId)\n  }\n}\n"]}

package/dist/bridge.d.ts

@@ -0,0 +1,14 @@
+import { Server as McpServer } from '@modelcontextprotocol/sdk/server/index.js';
+import { BindingMap } from './binding.js';
+export type BridgeDeps = {
+    /** Injectable for tests. */
+    fetch?: typeof fetch;
+    /** MCP session ID for this client. In stdio mode there's one session; derive from the Server instance. */
+    sessionId: string;
+    /** Shared binding map (one BindingMap per process). */
+    bindings: BindingMap;
+    /** Package version — set from package.json at boot. */
+    version: string;
+};
+export declare function createBridgeServer(deps: BridgeDeps): McpServer;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,2CAA2C,CAAA;AAQ/E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAKzC,MAAM,MAAM,UAAU,GAAG;IACvB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,0GAA0G;IAC1G,SAAS,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,QAAQ,EAAE,UAAU,CAAA;IACpB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAwE9D"}

package/dist/bridge.js

@@ -0,0 +1,74 @@
+import { Server as McpServer } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { TOOLS, TOOL_TO_LAP_PATH } from './tools.js';
+import { BindingMap } from './binding.js';
+import { forwardLap } from './forwarder.js';
+import { registerPrompts } from './prompts.js';
+export function createBridgeServer(deps) {
+    const server = new McpServer({ name: 'llui-agent', version: deps.version }, { capabilities: { tools: {}, prompts: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOLS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: args = {} } = req.params;
+        if (name === 'llui_connect_session') {
+            const { url, token } = args;
+            if (typeof url !== 'string' || typeof token !== 'string') {
+                return errorResult('invalid: url and token required');
+            }
+            deps.bindings.set(deps.sessionId, url, token);
+            // Validate immediately by pinging /describe
+            const res = await forwardLap(url, token, '/describe', {}, { fetch: deps.fetch });
+            if (!res.ok) {
+                deps.bindings.clear(deps.sessionId);
+                return errorResult(`connect failed: ${JSON.stringify(res.error)}`);
+            }
+            const describe = res.body;
+            deps.bindings.setDescribe(deps.sessionId, describe);
+            return okResult({
+                appName: describe.name,
+                appVersion: describe.version,
+                status: 'connected',
+            });
+        }
+        if (name === 'llui_disconnect_session') {
+            deps.bindings.clear(deps.sessionId);
+            return okResult({ status: 'disconnected' });
+        }
+        // Forwarded tools
+        const binding = deps.bindings.get(deps.sessionId);
+        if (!binding) {
+            return errorResult('not bound — ask the user to run /llui-connect <url> <token> first');
+        }
+        // describe_app can serve from cache
+        if (name === 'describe_app' && binding.describe) {
+            return okResult(binding.describe);
+        }
+        const lapPath = TOOL_TO_LAP_PATH[name];
+        if (!lapPath)
+            return errorResult(`unknown tool: ${name}`);
+        const res = await forwardLap(binding.url, binding.token, lapPath, args, { fetch: deps.fetch });
+        if (!res.ok) {
+            return errorResult(`LAP ${lapPath} failed: status=${res.status} ${JSON.stringify(res.error)}`);
+        }
+        // Cache describe_app responses after the first call too
+        if (name === 'describe_app') {
+            deps.bindings.setDescribe(deps.sessionId, res.body);
+        }
+        return okResult(res.body);
+    });
+    registerPrompts(server);
+    return server;
+}
+function okResult(body) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(body) }],
+    };
+}
+function errorResult(msg) {
+    return {
+        content: [{ type: 'text', text: msg }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import { Server as McpServer } from '@modelcontextprotocol/sdk/server/index.js'\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n  type CallToolResult,\n  type ListToolsResult,\n} from '@modelcontextprotocol/sdk/types.js'\nimport { TOOLS, TOOL_TO_LAP_PATH } from './tools.js'\nimport { BindingMap } from './binding.js'\nimport { forwardLap } from './forwarder.js'\nimport type { LapDescribeResponse } from '@llui/agent/protocol'\nimport { registerPrompts } from './prompts.js'\n\nexport type BridgeDeps = {\n  /** Injectable for tests. */\n  fetch?: typeof fetch\n  /** MCP session ID for this client. In stdio mode there's one session; derive from the Server instance. */\n  sessionId: string\n  /** Shared binding map (one BindingMap per process). */\n  bindings: BindingMap\n  /** Package version — set from package.json at boot. */\n  version: string\n}\n\nexport function createBridgeServer(deps: BridgeDeps): McpServer {\n  const server = new McpServer(\n    { name: 'llui-agent', version: deps.version },\n    { capabilities: { tools: {}, prompts: {} } },\n  )\n\n  server.setRequestHandler(\n    ListToolsRequestSchema,\n    async (): Promise<ListToolsResult> => ({\n      tools: TOOLS,\n    }),\n  )\n\n  server.setRequestHandler(CallToolRequestSchema, async (req): Promise<CallToolResult> => {\n    const { name, arguments: args = {} } = req.params\n\n    if (name === 'llui_connect_session') {\n      const { url, token } = args as { url?: string; token?: string }\n      if (typeof url !== 'string' || typeof token !== 'string') {\n        return errorResult('invalid: url and token required')\n      }\n      deps.bindings.set(deps.sessionId, url, token)\n      // Validate immediately by pinging /describe\n      const res = await forwardLap(url, token, '/describe', {}, { fetch: deps.fetch })\n      if (!res.ok) {\n        deps.bindings.clear(deps.sessionId)\n        return errorResult(`connect failed: ${JSON.stringify(res.error)}`)\n      }\n      const describe = res.body as LapDescribeResponse\n      deps.bindings.setDescribe(deps.sessionId, describe)\n      return okResult({\n        appName: describe.name,\n        appVersion: describe.version,\n        status: 'connected',\n      })\n    }\n\n    if (name === 'llui_disconnect_session') {\n      deps.bindings.clear(deps.sessionId)\n      return okResult({ status: 'disconnected' })\n    }\n\n    // Forwarded tools\n    const binding = deps.bindings.get(deps.sessionId)\n    if (!binding) {\n      return errorResult('not bound — ask the user to run /llui-connect <url> <token> first')\n    }\n\n    // describe_app can serve from cache\n    if (name === 'describe_app' && binding.describe) {\n      return okResult(binding.describe)\n    }\n\n    const lapPath = TOOL_TO_LAP_PATH[name]\n    if (!lapPath) return errorResult(`unknown tool: ${name}`)\n\n    const res = await forwardLap(binding.url, binding.token, lapPath, args, { fetch: deps.fetch })\n    if (!res.ok) {\n      return errorResult(`LAP ${lapPath} failed: status=${res.status} ${JSON.stringify(res.error)}`)\n    }\n\n    // Cache describe_app responses after the first call too\n    if (name === 'describe_app') {\n      deps.bindings.setDescribe(deps.sessionId, res.body as LapDescribeResponse)\n    }\n\n    return okResult(res.body)\n  })\n\n  registerPrompts(server)\n\n  return server\n}\n\nfunction okResult(body: unknown): CallToolResult {\n  return {\n    content: [{ type: 'text', text: JSON.stringify(body) }],\n  }\n}\n\nfunction errorResult(msg: string): CallToolResult {\n  return {\n    content: [{ type: 'text', text: msg }],\n    isError: true,\n  }\n}\n"]}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createBridgeServer } from './bridge.js';
+import { BindingMap } from './binding.js';
+const PACKAGE_VERSION = (() => {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(resolve(here, '../package.json'), 'utf8'));
+        return typeof pkg.version === 'string' ? pkg.version : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+})();
+async function main() {
+    const bindings = new BindingMap();
+    // Stdio is one session per process. Use a fixed session id.
+    const sessionId = 'stdio';
+    const server = createBridgeServer({ sessionId, bindings, version: PACKAGE_VERSION });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('[llui-agent] fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAE5E,CAAA;QACD,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAC,EAAE,CAAA;AAEJ,KAAK,UAAU,IAAI;IACjB,MAAM,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAA;IACjC,4DAA4D;IAC5D,MAAM,SAAS,GAAG,OAAO,CAAA;IACzB,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAA;IACpF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAA;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA","sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { readFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { createBridgeServer } from './bridge.js'\nimport { BindingMap } from './binding.js'\n\nconst PACKAGE_VERSION = (() => {\n  try {\n    const here = dirname(fileURLToPath(import.meta.url))\n    const pkg = JSON.parse(readFileSync(resolve(here, '../package.json'), 'utf8')) as {\n      version?: string\n    }\n    return typeof pkg.version === 'string' ? pkg.version : 'unknown'\n  } catch {\n    return 'unknown'\n  }\n})()\n\nasync function main(): Promise<void> {\n  const bindings = new BindingMap()\n  // Stdio is one session per process. Use a fixed session id.\n  const sessionId = 'stdio'\n  const server = createBridgeServer({ sessionId, bindings, version: PACKAGE_VERSION })\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nmain().catch((err) => {\n  console.error('[llui-agent] fatal:', err)\n  process.exit(1)\n})\n"]}

package/dist/forwarder.d.ts

@@ -0,0 +1,18 @@
+export type ForwardResult = {
+    ok: true;
+    body: unknown;
+} | {
+    ok: false;
+    status: number;
+    error: unknown;
+};
+export type ForwardDeps = {
+    fetch?: typeof fetch;
+};
+/**
+ * POST {baseUrl}{path} with Authorization: Bearer {token}, JSON body.
+ * Returns a discriminated success/failure envelope.
+ * Spec §11.4.
+ */
+export declare function forwardLap(baseUrl: string, token: string, path: string, args: object, deps?: ForwardDeps): Promise<ForwardResult>;
+//# sourceMappingURL=forwarder.d.ts.map

package/dist/forwarder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarder.d.ts","sourceRoot":"","sources":["../src/forwarder.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,aAAa,CAAC,CAuBxB"}

package/dist/forwarder.js

@@ -0,0 +1,33 @@
+/**
+ * POST {baseUrl}{path} with Authorization: Bearer {token}, JSON body.
+ * Returns a discriminated success/failure envelope.
+ * Spec §11.4.
+ */
+export async function forwardLap(baseUrl, token, path, args, deps = {}) {
+    const doFetch = deps.fetch ?? fetch.bind(globalThis);
+    const url = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) + path : baseUrl + path;
+    try {
+        const res = await doFetch(url, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify(args),
+        });
+        let body = null;
+        try {
+            body = await res.json();
+        }
+        catch {
+            body = null;
+        }
+        if (!res.ok)
+            return { ok: false, status: res.status, error: body };
+        return { ok: true, body };
+    }
+    catch (e) {
+        return { ok: false, status: 0, error: { code: 'network', detail: String(e) } };
+    }
+}
+//# sourceMappingURL=forwarder.js.map

package/dist/forwarder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarder.js","sourceRoot":"","sources":["../src/forwarder.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,KAAa,EACb,IAAY,EACZ,IAAY,EACZ,OAAoB,EAAE;IAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAA;IAChF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,KAAK,EAAE;aACjC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAA;QACF,IAAI,IAAI,GAAY,IAAI,CAAA;QACxB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QAClE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC3B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IAChF,CAAC;AACH,CAAC","sourcesContent":["export type ForwardResult =\n  | { ok: true; body: unknown }\n  | { ok: false; status: number; error: unknown }\n\nexport type ForwardDeps = {\n  fetch?: typeof fetch\n}\n\n/**\n * POST {baseUrl}{path} with Authorization: Bearer {token}, JSON body.\n * Returns a discriminated success/failure envelope.\n * Spec §11.4.\n */\nexport async function forwardLap(\n  baseUrl: string,\n  token: string,\n  path: string,\n  args: object,\n  deps: ForwardDeps = {},\n): Promise<ForwardResult> {\n  const doFetch = deps.fetch ?? fetch.bind(globalThis)\n  const url = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) + path : baseUrl + path\n  try {\n    const res = await doFetch(url, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        authorization: `Bearer ${token}`,\n      },\n      body: JSON.stringify(args),\n    })\n    let body: unknown = null\n    try {\n      body = await res.json()\n    } catch {\n      body = null\n    }\n    if (!res.ok) return { ok: false, status: res.status, error: body }\n    return { ok: true, body }\n  } catch (e) {\n    return { ok: false, status: 0, error: { code: 'network', detail: String(e) } }\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// Intentionally empty — bridge is invoked via CLI, not imported as a library.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,CAAA","sourcesContent":["// Intentionally empty — bridge is invoked via CLI, not imported as a library.\nexport {}\n"]}

package/dist/prompts.d.ts

@@ -0,0 +1,3 @@
+import type { Server as McpServer } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,2CAA2C,CAAA;AAQpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuCvD"}

package/dist/prompts.js

@@ -0,0 +1,36 @@
+import { GetPromptRequestSchema, ListPromptsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+export function registerPrompts(server) {
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: [
+            {
+                name: 'llui-connect',
+                description: 'Bind this Claude conversation to an LLui app. Paste the URL and token the app showed you.',
+                arguments: [
+                    { name: 'url', description: 'LAP base URL', required: true },
+                    { name: 'token', description: 'Bearer token', required: true },
+                ],
+            },
+        ],
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+        if (req.params.name !== 'llui-connect') {
+            throw new Error(`unknown prompt: ${req.params.name}`);
+        }
+        const url = req.params.arguments?.['url'] ?? '';
+        const token = req.params.arguments?.['token'] ?? '';
+        return {
+            description: `Bind to LLui app at ${url}`,
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Please connect this conversation to the LLui app at ${url}. ` +
+                            `Call llui_connect_session with url=${JSON.stringify(url)} and token=${JSON.stringify(token)}.`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GAGzB,MAAM,oCAAoC,CAAA;AAE3C,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,iBAAiB,CACtB,wBAAwB,EACxB,KAAK,IAAgC,EAAE,CAAC,CAAC;QACvC,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,2FAA2F;gBAC7F,SAAS,EAAE;oBACT,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC5D,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC/D;aACF;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAA4B,EAAE;QACvF,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACvD,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;QACnD,OAAO;YACL,WAAW,EAAE,uBAAuB,GAAG,EAAE;YACzC,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,uDAAuD,GAAG,IAAI;4BAC9D,sCAAsC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;qBAClG;iBACF;aACF;SACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import type { Server as McpServer } from '@modelcontextprotocol/sdk/server/index.js'\nimport {\n  GetPromptRequestSchema,\n  ListPromptsRequestSchema,\n  type ListPromptsResult,\n  type GetPromptResult,\n} from '@modelcontextprotocol/sdk/types.js'\n\nexport function registerPrompts(server: McpServer): void {\n  server.setRequestHandler(\n    ListPromptsRequestSchema,\n    async (): Promise<ListPromptsResult> => ({\n      prompts: [\n        {\n          name: 'llui-connect',\n          description:\n            'Bind this Claude conversation to an LLui app. Paste the URL and token the app showed you.',\n          arguments: [\n            { name: 'url', description: 'LAP base URL', required: true },\n            { name: 'token', description: 'Bearer token', required: true },\n          ],\n        },\n      ],\n    }),\n  )\n\n  server.setRequestHandler(GetPromptRequestSchema, async (req): Promise<GetPromptResult> => {\n    if (req.params.name !== 'llui-connect') {\n      throw new Error(`unknown prompt: ${req.params.name}`)\n    }\n    const url = req.params.arguments?.['url'] ?? ''\n    const token = req.params.arguments?.['token'] ?? ''\n    return {\n      description: `Bind to LLui app at ${url}`,\n      messages: [\n        {\n          role: 'user',\n          content: {\n            type: 'text',\n            text:\n              `Please connect this conversation to the LLui app at ${url}. ` +\n              `Call llui_connect_session with url=${JSON.stringify(url)} and token=${JSON.stringify(token)}.`,\n          },\n        },\n      ],\n    }\n  })\n}\n"]}

package/dist/tools.d.ts

@@ -0,0 +1,14 @@
+import type { ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * The 10 MCP tools Claude sees:
+ *   2 meta-tools (bind/unbind) + 8 forwarded tools (1:1 with LAP endpoints).
+ *
+ * Spec §8.
+ */
+export declare const TOOLS: ListToolsResult['tools'];
+/**
+ * Mapping from tool name → LAP path for the forwarded subset.
+ * Meta-tools handled separately in bridge.ts.
+ */
+export declare const TOOL_TO_LAP_PATH: Record<string, string>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,eAAe,CAAC,OAAO,CAkH1C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUnD,CAAA"}

package/dist/tools.js

@@ -0,0 +1,129 @@
+/**
+ * The 10 MCP tools Claude sees:
+ *   2 meta-tools (bind/unbind) + 8 forwarded tools (1:1 with LAP endpoints).
+ *
+ * Spec §8.
+ */
+export const TOOLS = [
+    {
+        name: 'llui_connect_session',
+        description: 'Bind this Claude conversation to a specific LLui app. Call ONCE per chat when the user pastes /llui-connect <url> <token>. Subsequent LLui tool calls target the bound app.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'LAP base URL (e.g. https://app.example/agent/lap/v1)',
+                },
+                token: { type: 'string', description: 'Bearer token for LAP calls' },
+            },
+            required: ['url', 'token'],
+        },
+    },
+    {
+        name: 'llui_disconnect_session',
+        description: 'Clear the binding for this Claude conversation. Subsequent LLui tool calls will fail until rebind.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'describe_app',
+        description: "Return the bound app's name, version, state/message schemas, annotations, and static docs.",
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_state',
+        description: 'Return the current app state. Optional `path` (JSON-pointer) to narrow the slice.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Optional JSON-pointer, e.g. "/user/name"' },
+            },
+        },
+    },
+    {
+        name: 'list_actions',
+        description: 'Return the currently-affordable actions: visible UI bindings plus agent-affordable registry entries, filtered by annotation gates.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'send_message',
+        description: 'Dispatch a message to the app. Auto-proposes a user confirmation when the message variant is @requiresConfirm. Returns dispatched / pending-confirmation / rejected.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                msg: { type: 'object', description: 'The message to dispatch; must have a `type` string' },
+                reason: {
+                    type: 'string',
+                    description: 'User-facing rationale (required for confirm-gated variants)',
+                },
+                waitFor: { type: 'string', enum: ['idle', 'none'], description: 'default "idle"' },
+                timeoutMs: { type: 'number' },
+            },
+            required: ['msg'],
+        },
+    },
+    {
+        name: 'get_confirm_result',
+        description: 'Poll a pending-confirmation by confirmId. Returns confirmed / rejected / still-pending.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                confirmId: { type: 'string' },
+                timeoutMs: { type: 'number' },
+            },
+            required: ['confirmId'],
+        },
+    },
+    {
+        name: 'wait_for_change',
+        description: 'Long-poll for a state change. Returns changed / timeout.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'Optional JSON-pointer to narrow which state changes trigger resolution',
+                },
+                timeoutMs: { type: 'number' },
+            },
+        },
+    },
+    {
+        name: 'query_dom',
+        description: 'Read elements tagged with data-agent="<name>" in the rendered UI.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string' },
+                multiple: { type: 'boolean' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'describe_visible_content',
+        description: 'Return a structured outline of the currently-visible data-agent-tagged subtrees.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'describe_context',
+        description: 'Return the current per-state narrative docs (agentContext) — what the user is trying to do right now.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+];
+/**
+ * Mapping from tool name → LAP path for the forwarded subset.
+ * Meta-tools handled separately in bridge.ts.
+ */
+export const TOOL_TO_LAP_PATH = {
+    describe_app: '/describe',
+    get_state: '/state',
+    list_actions: '/actions',
+    send_message: '/message',
+    get_confirm_result: '/confirm-result',
+    wait_for_change: '/wait',
+    query_dom: '/query-dom',
+    describe_visible_content: '/describe-visible',
+    describe_context: '/context',
+};
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ListToolsResult } from '@modelcontextprotocol/sdk/types.js'\n\n/**\n * The 10 MCP tools Claude sees:\n *   2 meta-tools (bind/unbind) + 8 forwarded tools (1:1 with LAP endpoints).\n *\n * Spec §8.\n */\nexport const TOOLS: ListToolsResult['tools'] = [\n  {\n    name: 'llui_connect_session',\n    description:\n      'Bind this Claude conversation to a specific LLui app. Call ONCE per chat when the user pastes /llui-connect <url> <token>. Subsequent LLui tool calls target the bound app.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        url: {\n          type: 'string',\n          description: 'LAP base URL (e.g. https://app.example/agent/lap/v1)',\n        },\n        token: { type: 'string', description: 'Bearer token for LAP calls' },\n      },\n      required: ['url', 'token'],\n    },\n  },\n  {\n    name: 'llui_disconnect_session',\n    description:\n      'Clear the binding for this Claude conversation. Subsequent LLui tool calls will fail until rebind.',\n    inputSchema: { type: 'object', properties: {} },\n  },\n  {\n    name: 'describe_app',\n    description:\n      \"Return the bound app's name, version, state/message schemas, annotations, and static docs.\",\n    inputSchema: { type: 'object', properties: {} },\n  },\n  {\n    name: 'get_state',\n    description:\n      'Return the current app state. Optional `path` (JSON-pointer) to narrow the slice.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        path: { type: 'string', description: 'Optional JSON-pointer, e.g. \"/user/name\"' },\n      },\n    },\n  },\n  {\n    name: 'list_actions',\n    description:\n      'Return the currently-affordable actions: visible UI bindings plus agent-affordable registry entries, filtered by annotation gates.',\n    inputSchema: { type: 'object', properties: {} },\n  },\n  {\n    name: 'send_message',\n    description:\n      'Dispatch a message to the app. Auto-proposes a user confirmation when the message variant is @requiresConfirm. Returns dispatched / pending-confirmation / rejected.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        msg: { type: 'object', description: 'The message to dispatch; must have a `type` string' },\n        reason: {\n          type: 'string',\n          description: 'User-facing rationale (required for confirm-gated variants)',\n        },\n        waitFor: { type: 'string', enum: ['idle', 'none'], description: 'default \"idle\"' },\n        timeoutMs: { type: 'number' },\n      },\n      required: ['msg'],\n    },\n  },\n  {\n    name: 'get_confirm_result',\n    description:\n      'Poll a pending-confirmation by confirmId. Returns confirmed / rejected / still-pending.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        confirmId: { type: 'string' },\n        timeoutMs: { type: 'number' },\n      },\n      required: ['confirmId'],\n    },\n  },\n  {\n    name: 'wait_for_change',\n    description: 'Long-poll for a state change. Returns changed / timeout.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        path: {\n          type: 'string',\n          description: 'Optional JSON-pointer to narrow which state changes trigger resolution',\n        },\n        timeoutMs: { type: 'number' },\n      },\n    },\n  },\n  {\n    name: 'query_dom',\n    description: 'Read elements tagged with data-agent=\"<name>\" in the rendered UI.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        name: { type: 'string' },\n        multiple: { type: 'boolean' },\n      },\n      required: ['name'],\n    },\n  },\n  {\n    name: 'describe_visible_content',\n    description: 'Return a structured outline of the currently-visible data-agent-tagged subtrees.',\n    inputSchema: { type: 'object', properties: {} },\n  },\n  {\n    name: 'describe_context',\n    description:\n      'Return the current per-state narrative docs (agentContext) — what the user is trying to do right now.',\n    inputSchema: { type: 'object', properties: {} },\n  },\n]\n\n/**\n * Mapping from tool name → LAP path for the forwarded subset.\n * Meta-tools handled separately in bridge.ts.\n */\nexport const TOOL_TO_LAP_PATH: Record<string, string> = {\n  describe_app: '/describe',\n  get_state: '/state',\n  list_actions: '/actions',\n  send_message: '/message',\n  get_confirm_result: '/confirm-result',\n  wait_for_change: '/wait',\n  query_dom: '/query-dom',\n  describe_visible_content: '/describe-visible',\n  describe_context: '/context',\n}\n"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "llui-agent",
+  "version": "0.0.1",
+  "type": "module",
+  "bin": {
+    "llui-agent": "./dist/cli.js"
+  },
+  "exports": {
+    "./internal/bridge": {
+      "types": "./dist/bridge.d.ts",
+      "import": "./dist/bridge.js"
+    },
+    "./internal/binding": {
+      "types": "./dist/binding.d.ts",
+      "import": "./dist/binding.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@llui/agent": "0.0.29"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "description": "LLui Agent bridge — MCP server that translates Claude Desktop tool calls to LLui apps via LAP",
+  "keywords": [
+    "llui",
+    "agent",
+    "mcp",
+    "claude",
+    "bridge"
+  ],
+  "author": "Franco Ponticelli <franco.ponticelli@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fponticelli/llui.git",
+    "directory": "packages/agent-bridge"
+  },
+  "bugs": {
+    "url": "https://github.com/fponticelli/llui/issues"
+  },
+  "homepage": "https://github.com/fponticelli/llui/tree/main/packages/agent-bridge#readme",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}