lensmcp 1.0.0 → 1.2.0

package/bundled/main.js

@@ -12,7 +12,7 @@ function __decorate(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 
-// servers/lensai-mcp/dist/main.js
+// servers/lensmcp-mcp/dist/main.js
 import "reflect-metadata";
 import { FrontMcp, FrontMcpInstance, LogLevel } from "@frontmcp/sdk";
 
@@ -15922,11 +15922,11 @@ var AgentSessionSchema = ResourceEnvelopeSchema.extend({
 });
 
 // libs/protocol-types/dist/lib/tokens.js
-var SessionToken = /* @__PURE__ */ Symbol.for("@lensai/session/Session");
-var EventBusToken = /* @__PURE__ */ Symbol.for("@lensai/core/EventBus");
-var GraphStoreToken = /* @__PURE__ */ Symbol.for("@lensai/core/GraphStore");
-var ResourceStoreToken = /* @__PURE__ */ Symbol.for("@lensai/core/ResourceStore");
-var StorageToken = /* @__PURE__ */ Symbol.for("@lensai/storage/Storage");
+var SessionToken = /* @__PURE__ */ Symbol.for("@lensmcp/session/Session");
+var EventBusToken = /* @__PURE__ */ Symbol.for("@lensmcp/core/EventBus");
+var GraphStoreToken = /* @__PURE__ */ Symbol.for("@lensmcp/core/GraphStore");
+var ResourceStoreToken = /* @__PURE__ */ Symbol.for("@lensmcp/core/ResourceStore");
+var StorageToken = /* @__PURE__ */ Symbol.for("@lensmcp/storage/Storage");
 
 // libs/session/dist/lib/providers.js
 var activeSession;
@@ -15935,21 +15935,21 @@ function setActiveSession(session2) {
 }
 function requireSession() {
   if (!activeSession) {
-    throw new Error("No LensAI session is active. Did you call bootstrapLensai() before the FrontMCP container started?");
+    throw new Error("No LensMCP session is active. Did you call bootstrapLensmcp() before the FrontMCP container started?");
   }
   return activeSession;
 }
 var SessionProvider = AsyncProvider({
   provide: SessionToken,
-  name: "LensaiSession",
-  description: "The active LensAI Session instance.",
+  name: "LensmcpSession",
+  description: "The active LensMCP Session instance.",
   scope: ProviderScope.GLOBAL,
   inject: () => [],
   useFactory: () => requireSession()
 });
 var EventBusProvider = AsyncProvider({
   provide: EventBusToken,
-  name: "LensaiEventBus",
+  name: "LensmcpEventBus",
   description: "The session's normalised event bus.",
   scope: ProviderScope.GLOBAL,
   inject: () => [],
@@ -15957,7 +15957,7 @@ var EventBusProvider = AsyncProvider({
 });
 var GraphStoreProvider = AsyncProvider({
   provide: GraphStoreToken,
-  name: "LensaiGraphStore",
+  name: "LensmcpGraphStore",
   description: "The typed multi-axis trace graph.",
   scope: ProviderScope.GLOBAL,
   inject: () => [],
@@ -15965,7 +15965,7 @@ var GraphStoreProvider = AsyncProvider({
 });
 var ResourceStoreProvider = AsyncProvider({
   provide: ResourceStoreToken,
-  name: "LensaiResourceStore",
+  name: "LensmcpResourceStore",
   description: "Registry of agent-readable MCP resources.",
   scope: ProviderScope.GLOBAL,
   inject: () => [],
@@ -15973,13 +15973,13 @@ var ResourceStoreProvider = AsyncProvider({
 });
 var StorageProvider = AsyncProvider({
   provide: StorageToken,
-  name: "LensaiStorage",
+  name: "LensmcpStorage",
   description: "Hot-tier storage backend (in-memory ring buffer by default).",
   scope: ProviderScope.GLOBAL,
   inject: () => [],
   useFactory: () => requireSession().storage
 });
-var lensaiProviderArray = [
+var lensmcpProviderArray = [
   SessionProvider,
   EventBusProvider,
   GraphStoreProvider,
@@ -15988,11 +15988,11 @@ var lensaiProviderArray = [
 ];
 
 // libs/session/dist/lib/bootstrap.js
-function bootstrapLensai(opts = {}) {
+function bootstrapLensmcp(opts = {}) {
   const session2 = new Session(opts);
   session2.start();
   setActiveSession(session2);
-  return { session: session2, providers: lensaiProviderArray };
+  return { session: session2, providers: lensmcpProviderArray };
 }
 
 // libs/session/dist/lib/collectors/tsc-collector.js
@@ -16060,9 +16060,9 @@ function createUdsServer(opts) {
 
 // libs/session/dist/lib/ingest.js
 function startEventIngest(opts) {
-  const eventFile = opts.eventFile ?? process.env["LENSAI_EVENT_FILE"];
-  const socketPath = opts.socketPath ?? process.env["LENSAI_IPC_SOCKET"];
-  const udsPath = opts.udsPath ?? process.env["LENSAI_UDS"];
+  const eventFile = opts.eventFile ?? process.env["LENSMCP_EVENT_FILE"];
+  const socketPath = opts.socketPath ?? process.env["LENSMCP_IPC_SOCKET"];
+  const udsPath = opts.udsPath ?? process.env["LENSMCP_UDS"];
   const onError = opts.onError ?? (() => void 0);
   let published = 0;
   const publish = (line) => {
@@ -16094,7 +16094,7 @@ function startEventIngest(opts) {
     let position = 0;
     let carry = "";
     let skipPartialFirstLine = false;
-    const replayBytes = opts.replayBytes ?? Number(process.env["LENSAI_REPLAY_BYTES"] ?? 4 * 1024 * 1024);
+    const replayBytes = opts.replayBytes ?? Number(process.env["LENSMCP_REPLAY_BYTES"] ?? 4 * 1024 * 1024);
     if (existsSync2(eventFile)) {
       try {
         const size = statSync(eventFile).size;
@@ -16228,7 +16228,7 @@ function loadWorkspaceThresholds(cwd = process.cwd()) {
     return resolveThresholds();
   try {
     const nx = JSON.parse(readFileSync(nxPath, "utf8"));
-    return resolveThresholds(nx.lensai?.thresholds);
+    return resolveThresholds(nx.lensmcp?.thresholds);
   } catch {
     return resolveThresholds();
   }
@@ -17970,7 +17970,7 @@ VisualRulesResource = __decorate([
     name: "visual-rules",
     uri: "visual://rules",
     mimeType: "application/json",
-    description: "All registered visual rules (builtins + lensai.rules.json + visual.register_rule)."
+    description: "All registered visual rules (builtins + lensmcp.rules.json + visual.register_rule)."
   })
 ], VisualRulesResource);
 var rules_resource_default = VisualRulesResource;
@@ -17988,7 +17988,7 @@ VisualTokensResource = __decorate([
     name: "visual-tokens",
     uri: "visual://tokens",
     mimeType: "application/json",
-    description: "Resolved design tokens from lensai.tokens.json."
+    description: "Resolved design tokens from lensmcp.tokens.json."
   })
 ], VisualTokensResource);
 var tokens_resource_default = VisualTokensResource;
@@ -18356,7 +18356,7 @@ ReactPagesCurrentResource = __decorate([
     name: "react-pages-current",
     uri: "react://pages/current",
     mimeType: "application/json",
-    description: "The most recently active React page (from <LensaiRoot>)."
+    description: "The most recently active React page (from <LensmcpRoot>)."
   })
 ], ReactPagesCurrentResource);
 var pages_current_resource_default = ReactPagesCurrentResource;
@@ -18789,7 +18789,7 @@ ValtioStoresResource = __decorate([
     name: "valtio-stores",
     uri: "valtio://stores",
     mimeType: "application/json",
-    description: "Registered Valtio stores (created via lensai-wrapped proxy())."
+    description: "Registered Valtio stores (created via lensmcp-wrapped proxy())."
   })
 ], ValtioStoresResource);
 var stores_resource_default = ValtioStoresResource;
@@ -19684,9 +19684,9 @@ function toOwnerView(o) {
   };
 }
 
-// servers/lensai-mcp/dist/bootstrap.js
+// servers/lensmcp-mcp/dist/bootstrap.js
 function createLensSession() {
-  const { session: session2, providers: providers2 } = bootstrapLensai();
+  const { session: session2, providers: providers2 } = bootstrapLensmcp();
   const thresholds = loadWorkspaceThresholds();
   installBuildReducer({ bus: session2.bus, resources: session2.resources });
   installLintReducer({ bus: session2.bus, resources: session2.resources });
@@ -19750,10 +19750,10 @@ function createLensSession() {
   });
   const ingest = startEventIngest({
     bus: session2.bus,
-    onError: (err) => console.error("[lensai] ingest error:", err)
+    onError: (err) => console.error("[lensmcp] ingest error:", err)
   });
   if (ingest.mode !== "none") {
-    console.error(`[lensai] event ingest active (mode=${ingest.mode})`);
+    console.error(`[lensmcp] event ingest active (mode=${ingest.mode})`);
   }
   session2.onShutdown({ name: "event-ingest", stop: () => ingest.stop() });
   return { session: session2, providers: providers2, ingest };
@@ -19764,7 +19764,7 @@ import { App as App17 } from "@frontmcp/sdk";
 
 // apps/meta/dist/tools/session.tool.js
 import { Tool as Tool22, ToolContext as ToolContext22 } from "@frontmcp/sdk";
-var LensaiSessionTool = class LensaiSessionTool2 extends ToolContext22 {
+var LensmcpSessionTool = class LensmcpSessionTool2 extends ToolContext22 {
   async execute() {
     const session2 = this.get(SessionToken);
     const resources = this.get(ResourceStoreToken);
@@ -19774,7 +19774,7 @@ var LensaiSessionTool = class LensaiSessionTool2 extends ToolContext22 {
       updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
       sessionId: session2.id,
       supportedResources: resources.list(),
-      supportedTools: ["lensai.session", "observe.current_status"],
+      supportedTools: ["lensmcp.session", "observe.current_status"],
       supportedJobs: [],
       supportedChannels: [],
       subscribedByDefault: ["agent://current-status"],
@@ -19784,29 +19784,29 @@ var LensaiSessionTool = class LensaiSessionTool2 extends ToolContext22 {
         node: process.version
       },
       project: {
-        name: "lensai"
+        name: "lensmcp"
       }
     };
   }
 };
-LensaiSessionTool = __decorate([
+LensmcpSessionTool = __decorate([
   Tool22({
-    name: "lensai.session",
-    description: "Returns the LensAI session bootstrap response (schema version, supported resources/tools, transport info, host info).",
+    name: "lensmcp.session",
+    description: "Returns the LensMCP session bootstrap response (schema version, supported resources/tools, transport info, host info).",
     inputSchema: {}
   })
-], LensaiSessionTool);
-var session_tool_default = LensaiSessionTool;
+], LensmcpSessionTool);
+var session_tool_default = LensmcpSessionTool;
 
 // apps/meta/dist/skills/lens.skill.js
 import { Skill } from "@frontmcp/sdk";
-var UsingLensaiSkill = class UsingLensaiSkill2 {
+var UsingLensmcpSkill = class UsingLensmcpSkill2 {
 };
-UsingLensaiSkill = __decorate([
+UsingLensmcpSkill = __decorate([
   Skill({
-    name: "using-lensai",
-    description: "Drive the LensAI lens to observe a running Vite+React+NestJS app: the install\u2192agent-dev\u2192read loop, which resource/tool answers which question, and how to trace a user action across the stack.",
-    tags: ["lensai", "observability", "debugging", "how-to"],
+    name: "using-lensmcp",
+    description: "Drive the LensMCP lens to observe a running Vite+React+NestJS app: the install\u2192agent-dev\u2192read loop, which resource/tool answers which question, and how to trace a user action across the stack.",
+    tags: ["lensmcp", "observability", "debugging", "how-to"],
     priority: 100,
     toolValidation: "ignore",
     tools: [
@@ -19826,9 +19826,9 @@ UsingLensaiSkill = __decorate([
         expectedOutcome: "Call graph.explain_rerender for the component, then graph.trace_from_origin from the click flow."
       }
     ],
-    instructions: `# Using LensAI
+    instructions: `# Using LensMCP
 
-LensAI is an MCP server that gives you **deterministic observability into a
+LensMCP is an MCP server that gives you **deterministic observability into a
 running Vite + React + NestJS app**. Reach for it after you change code, to
 see what the running app actually did \u2014 not to read source. It is **zero
 config**: no app-code edits are required; the lens is wired in at the build
@@ -19836,21 +19836,21 @@ and bootstrap layer.
 
 ## The loop
 
-1. **Install once** (per workspace): \`npx -y lensai install\` \u2014 registers
+1. **Install once** (per workspace): \`npx -y lensmcp install\` \u2014 registers
    the plugin + this MCP server in the workspace .mcp.json. Then
-   \`nx g @lensai/nx-plugin:setup-vite <web>\` and \`:setup-nest <api>\` wire each
-   project (rewrites main.ts \u2192 createLensaiNestApp; adds the Vite plugin).
+   \`nx g @lensmcp/nx-plugin:setup-vite <web>\` and \`:setup-nest <api>\` wire each
+   project (rewrites main.ts \u2192 createLensmcpNestApp; adds the Vite plugin).
 2. **Run** with capture: \`nx run <project>:agent-dev\` \u2014 starts the app and
    auto-captures backend spans, React renders, Valtio state, browser console/
    network, and (when a dev URL is set) real Chrome DOM/visual snapshots.
 3. **Read** the resources / call the tools below to answer your question.
-4. **If resources look empty**, run \`npx lensai doctor --json\` first \u2014 it
+4. **If resources look empty**, run \`npx lensmcp doctor --json\` first \u2014 it
    reports Node, plugin registration, .mcp.json, per-project wiring, and
    agent-dev targets, each with a fix hint.
 
 Resources are **live snapshots** of the running app; re-read them after you
 act. Thresholds (when a signal fires) are tunable in
-\`nx.json#lensai.thresholds\` (dbInLoop, nPlusOne, renderStorm, slowRouteMs,
+\`nx.json#lensmcp.thresholds\` (dbInLoop, nPlusOne, renderStorm, slowRouteMs,
 slowRenderMs).
 
 ## Decision map \u2014 question \u2192 where to look
@@ -19891,7 +19891,7 @@ slowRenderMs).
 ## Trace a user action across the whole stack
 
 A user interaction (onClick/onSubmit/onChange) is auto-wrapped so it starts a
-**flow**: the browser stamps \`x-lensai-flow-id\` on outgoing fetches, and the
+**flow**: the browser stamps \`x-lensmcp-flow-id\` on outgoing fetches, and the
 backend stamps the same flowId on its spans. So you can ask "what did this
 click cause?":
 
@@ -19912,18 +19912,18 @@ click cause?":
 - \`events://recent\` is the raw firehose \u2014 use it only when a specific
   resource doesn't exist for what you need.`
   })
-], UsingLensaiSkill);
+], UsingLensmcpSkill);
 
 // apps/meta/dist/meta.app.js
 var MetaApp = class MetaApp2 {
 };
 MetaApp = __decorate([
   App17({
-    id: "lensai",
-    name: "LensAI Meta",
-    description: 'Session, health, and config tools, plus the "how to use LensAI" skill.',
+    id: "lensmcp",
+    name: "LensMCP Meta",
+    description: 'Session, health, and config tools, plus the "how to use LensMCP" skill.',
     tools: [session_tool_default],
-    skills: [UsingLensaiSkill]
+    skills: [UsingLensmcpSkill]
   })
 ], MetaApp);
 
@@ -19989,8 +19989,8 @@ import { Job, JobContext, z as z23 } from "@frontmcp/sdk";
 var VerifyFixJob = class VerifyFixJob2 extends JobContext {
   async execute(input) {
     const startedAt = Date.now();
-    const projectName = input.project ?? process.env["LENSAI_VERIFY_PROJECT"] ?? "example-web";
-    const cwd = resolve(input.cwd ?? process.env["LENSAI_WORKSPACE_ROOT"] ?? process.cwd());
+    const projectName = input.project ?? process.env["LENSMCP_VERIFY_PROJECT"] ?? "example-web";
+    const cwd = resolve(input.cwd ?? process.env["LENSMCP_WORKSPACE_ROOT"] ?? process.cwd());
     const workspaceRoot = findNxWorkspaceRoot(cwd);
     if (!workspaceRoot) {
       this.log(`No nx.json found above ${cwd}`);
@@ -20050,7 +20050,7 @@ var VerifyFixJob = class VerifyFixJob2 extends JobContext {
         reportPath: null
       };
     }
-    const reportPath = join2(workspaceRoot, ".lensai", "verifications", "latest.json");
+    const reportPath = join2(workspaceRoot, ".lensmcp", "verifications", "latest.json");
     let onDisk;
     if (existsSync4(reportPath)) {
       try {
@@ -20074,8 +20074,8 @@ VerifyFixJob = __decorate([
     name: "observe.verify_fix",
     description: "Run the deterministic verification loop (typecheck \u2192 lint \u2192 build) for a host project. Returns a per-stage report; suggested next read on failure is the relevant *://errors resource.",
     inputSchema: {
-      project: z23.string().describe('Nx project name in the host workspace to verify. Defaults to LENSAI_VERIFY_PROJECT or "example-web".').optional(),
-      cwd: z23.string().describe("Override the host workspace root. Defaults to LENSAI_WORKSPACE_ROOT or process.cwd().").optional(),
+      project: z23.string().describe('Nx project name in the host workspace to verify. Defaults to LENSMCP_VERIFY_PROJECT or "example-web".').optional(),
+      cwd: z23.string().describe("Override the host workspace root. Defaults to LENSMCP_WORKSPACE_ROOT or process.cwd().").optional(),
       timeoutMs: z23.number().int().positive().default(5 * 6e4).describe("How long to wait for the verify pipeline before declaring it stuck.")
     },
     outputSchema: {
@@ -20232,9 +20232,9 @@ RenderApp = __decorate([
   })
 ], RenderApp);
 
-// servers/lensai-mcp/dist/main.js
+// servers/lensmcp-mcp/dist/main.js
 var { session, providers } = createLensSession();
-var transport = process.env["LENSAI_TRANSPORT"] ?? "stdio";
+var transport = process.env["LENSMCP_TRANSPORT"] ?? "stdio";
 var apps = [
   MetaApp,
   AgentApp,
@@ -20258,28 +20258,28 @@ var apps = [
   MemoryApp
 ];
 var serverConfig = {
-  info: { name: "LensAI MCP", version: "1.0.0" },
+  info: { name: "LensMCP MCP", version: "1.0.0" },
   apps,
   providers: [...providers]
 };
-var LensaiMcpServer = class LensaiMcpServer2 {
+var LensmcpMcpServer = class LensmcpMcpServer2 {
 };
-LensaiMcpServer = __decorate([
+LensmcpMcpServer = __decorate([
   FrontMcp({ ...serverConfig, serve: false })
-], LensaiMcpServer);
-var main_default = LensaiMcpServer;
+], LensmcpMcpServer);
+var main_default = LensmcpMcpServer;
 if (transport === "stdio") {
   FrontMcpInstance.runStdio({
     ...serverConfig,
     logging: { level: LogLevel.Warn }
   }).catch((err) => {
-    process.stderr.write(`[lensai] runStdio failed: ${err instanceof Error ? err.stack ?? err.message : String(err)}
+    process.stderr.write(`[lensmcp] runStdio failed: ${err instanceof Error ? err.stack ?? err.message : String(err)}
 `);
     process.exit(1);
   });
 } else {
-  const entryPath = process.env["LENSAI_HTTP_PATH"] ?? "/mcp";
-  const http = transport === "socket" ? { socketPath: process.env["LENSAI_SOCKET_PATH"] ?? "/tmp/lensai-mcp.sock", entryPath } : { port: Number(process.env["LENSAI_PORT"] ?? 3e3), entryPath };
+  const entryPath = process.env["LENSMCP_HTTP_PATH"] ?? "/mcp";
+  const http = transport === "socket" ? { socketPath: process.env["LENSMCP_SOCKET_PATH"] ?? "/tmp/lensmcp-mcp.sock", entryPath } : { port: Number(process.env["LENSMCP_PORT"] ?? 3e3), entryPath };
   void FrontMcpInstance.bootstrap({
     ...serverConfig,
     logging: { level: LogLevel.Info },

package/lib/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAmCD,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAgChE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gEAAgE;IAChE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AA0CD,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAkChE"}

package/lib/cli.js

@@ -16,6 +16,13 @@ Commands:
                        Serve a live web view of the lens (flows, signals,
                        stories, status) on --port (default 4321). Reads the
                        same .lensmcp/events.jsonl your agent-dev producers write.
+  bridge [--cwd <dir>] [--host <h>] [--port <n>]
+                       Run the standalone browser-event bridge for hosts with
+                       no LensMCP build plugin (webpack, Next.js, no build).
+                       Listens on ws://--host:--port (default 127.0.0.1:5747)
+                       and forwards @lensmcp/client-runtime envelopes into the
+                       same .lensmcp/events.jsonl the MCP server tails. Point
+                       your app at it with: import '@lensmcp/client-runtime/auto'
   install [--cwd <dir>] [--skip-format] [--register-host-config <mode>]
                        Install LensMCP into the host Nx workspace at --cwd
                        (current directory by default). Delegates to
@@ -51,6 +58,8 @@ export async function runCli(ctx) {
             return runMcp(ctx, rest, out, err);
         case 'dashboard':
             return runDashboard(ctx, rest, out, err);
+        case 'bridge':
+            return runBridge(ctx, rest, out, err);
         case 'install':
             return runInstall(ctx, rest, out, err);
         case 'doctor':
@@ -133,6 +142,43 @@ function runDashboard(ctx, args, out, err) {
     });
     return { exitCode: result.status ?? 1 };
 }
+function runBridge(ctx, args, out, err) {
+    const opts = parseFlags(args, { string: ['--cwd', '--host', '--port'] });
+    const cwd = resolve(stringFlag(opts.flags['--cwd']) ?? ctx.cwd);
+    const host = stringFlag(opts.flags['--host']) ?? ctx.env?.['LENSMCP_WS_HOST'] ?? process.env['LENSMCP_WS_HOST'];
+    const port = stringFlag(opts.flags['--port']) ?? ctx.env?.['LENSMCP_WS_PORT'] ?? process.env['LENSMCP_WS_PORT'];
+    const binPath = findBridgeBundle(cwd);
+    if (!binPath) {
+        err('Could not locate the lensmcp bridge bundle.\n' +
+            'Looked in (in order):\n' +
+            '  • <cli-package>/bundled/bridge.js          (published bin)\n' +
+            '  • <workspace>/libs/bridge/dist/main.js     (dev build)\n' +
+            'For dev: `yarn nx build @lensmcp/bridge`.');
+        return { exitCode: 1 };
+    }
+    ensureLensmcpDir(cwd);
+    // Forward browser envelopes into the same JSONL the MCP server ingests, so
+    // the bridge sidecar and `lensmcp mcp` rendezvous with zero extra config.
+    const eventFile = ctx.env?.['LENSMCP_EVENT_FILE'] ??
+        process.env['LENSMCP_EVENT_FILE'] ??
+        join(cwd, '.lensmcp', 'events.jsonl');
+    const childEnv = {
+        ...process.env,
+        ...(ctx.env ?? {}),
+        LENSMCP_EVENT_FILE: eventFile,
+    };
+    if (host)
+        childEnv['LENSMCP_WS_HOST'] = host;
+    if (port)
+        childEnv['LENSMCP_WS_PORT'] = port;
+    out(`lensmcp bridge → ws://${host ?? '127.0.0.1'}:${port ?? '5747'}  (forwarding to ${eventFile})`);
+    const result = spawnSync(process.execPath, [binPath], {
+        cwd,
+        stdio: 'inherit',
+        env: childEnv,
+    });
+    return { exitCode: result.status ?? 1 };
+}
 function runInstall(ctx, args, out, err) {
     const opts = parseFlags(args, {
         string: ['--cwd', '--register-host-config'],
@@ -423,6 +469,27 @@ function findServerBundle(cwd, file) {
     }
     return undefined;
 }
+/** Resolve the standalone bridge runner: the published `bundled/bridge.js`
+ *  first, then the workspace dev build (`libs/bridge/dist/main.js`, walking up). */
+function findBridgeBundle(cwd) {
+    // 1. Bundled inside the published lensmcp (ship step).
+    const here = dirname(fileURLToPath(import.meta.url));
+    const bundled = resolve(here, '..', '..', 'bundled', 'bridge.js');
+    if (existsSync(bundled))
+        return bundled;
+    // 2. Dev build in the workspace (walk up from cwd).
+    let dir = cwd;
+    for (let i = 0; i < 5; i++) {
+        const candidate = join(dir, 'libs', 'bridge', 'dist', 'main.js');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}
 function findNxBinary(cwd) {
     let dir = cwd;
     for (let i = 0; i < 5; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lensmcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",