trellis 3.2.2 → 3.2.4

package/dist/gateway-serve-CM5EAZ52.js

@@ -0,0 +1,113 @@
+import {
+  corsPreflightResponse,
+  discoveryMcpGateway,
+  mcpServiceDocument,
+  oauthAuthorizationServerMetadata,
+  oauthProtectedResourceMetadata,
+  withCors
+} from "./chunk-B2EJSYNW.js";
+import "./chunk-OA7HD3UA.js";
+import "./chunk-SXYFXZKZ.js";
+import "./chunk-UZRUP7QW.js";
+import "./chunk-JA7AIHRK.js";
+import "./chunk-2ESYSVXG.js";
+
+// src/mcp/gateway-serve.ts
+async function createGatewayFetchHandler(opts = {}) {
+  const configDir = opts.configDir ?? ".";
+  const discoveryCtx = { configDir };
+  return async (req) => {
+    if (req.method === "OPTIONS") {
+      return corsPreflightResponse(req);
+    }
+    const url = new URL(req.url);
+    const path = url.pathname.replace(/\/$/, "") || "/";
+    const origin = opts.publicUrl?.replace(/\/$/, "") || `${url.protocol}//${url.host}`;
+    const respond = (res) => withCors(req, res);
+    if (path === "/health") {
+      return respond(
+        new Response(
+          JSON.stringify({
+            status: "ok",
+            service: "trellis-mcp-gateway",
+            mcp: "/mcp",
+            gateway: "/gateway/mcp"
+          }),
+          { headers: { "Content-Type": "application/json" } }
+        )
+      );
+    }
+    if (path === "/.well-known/oauth-protected-resource") {
+      return respond(
+        new Response(JSON.stringify(oauthProtectedResourceMetadata(origin)), {
+          headers: { "Content-Type": "application/json" }
+        })
+      );
+    }
+    if (path === "/.well-known/oauth-authorization-server") {
+      return respond(
+        new Response(JSON.stringify(oauthAuthorizationServerMetadata(origin)), {
+          headers: { "Content-Type": "application/json" }
+        })
+      );
+    }
+    if (path === "/mcp" || path === "/gateway/mcp") {
+      const res = await discoveryMcpGateway.handle(req, {
+        ...discoveryCtx,
+        origin,
+        gatewayPublicUrl: origin
+      });
+      return respond(res);
+    }
+    if (path === "/") {
+      return respond(
+        new Response(JSON.stringify(mcpServiceDocument(origin, {})), {
+          headers: { "Content-Type": "application/json" }
+        })
+      );
+    }
+    return respond(
+      new Response(JSON.stringify({ error: "Not Found" }), {
+        status: 404,
+        headers: { "Content-Type": "application/json" }
+      })
+    );
+  };
+}
+async function startGatewayServer(opts = {}) {
+  const port = opts.port ?? 3940;
+  const fetch = await createGatewayFetchHandler(opts);
+  if (typeof globalThis.Bun !== "undefined") {
+    const server2 = globalThis.Bun.serve({
+      port,
+      hostname: opts.hostname ?? "0.0.0.0",
+      fetch
+    });
+    return {
+      port: server2.port ?? port,
+      stop: () => server2.stop(true)
+    };
+  }
+  const { startNodeServer } = await import("./server/node-adapter.js");
+  const server = await startNodeServer({
+    port,
+    hostname: opts.hostname,
+    fetch,
+    websocket: {
+      open() {
+      },
+      message() {
+      },
+      close() {
+      }
+    }
+  });
+  return {
+    port: server.port,
+    stop: () => server.stop(true)
+  };
+}
+export {
+  createGatewayFetchHandler,
+  startGatewayServer
+};

package/dist/import-AJLYHFIA.js

@@ -0,0 +1,10 @@
+import {
+  importFile,
+  importRecords
+} from "./chunk-WMERMSWI.js";
+import "./chunk-G3XIHPSQ.js";
+import "./chunk-2ESYSVXG.js";
+export {
+  importFile,
+  importRecords
+};

package/dist/index.js

@@ -1,4 +1,4 @@
-import "./chunk-S6GBJ2ZB.js";
+import "./chunk-OKNASCZY.js";
 import {
   FileWatcher,
   Ingestion,
@@ -11,19 +11,19 @@ import {
   loadProfile,
   saveProfile,
   writeAgentScaffold
-} from "./chunk-L5N5PR2S.js";
-import "./chunk-GU374KWZ.js";
+} from "./chunk-N3R74ZSR.js";
+import "./chunk-NLFRRGX6.js";
 import {
   SqliteKernelBackend
-} from "./chunk-XMQ7G77X.js";
+} from "./chunk-OB4CMMX6.js";
 import {
   TrellisKernel
-} from "./chunk-KQ4A2D2P.js";
+} from "./chunk-V4YCJDYL.js";
 import "./chunk-6CTA6MCE.js";
-import "./chunk-4XIVMVHC.js";
+import "./chunk-G3XIHPSQ.js";
 import {
   VcsMiddleware
-} from "./chunk-FWRS4CSC.js";
+} from "./chunk-KQG6ZYXP.js";
 import {
   IdbOpLog
 } from "./chunk-MPXUVGT3.js";
@@ -80,7 +80,7 @@ import {
   unblockIssue,
   updateIssue,
   updateLaneHead
-} from "./chunk-VBYUTRXX.js";
+} from "./chunk-IJNC25UD.js";
 import {
   DEFAULT_CONFIG,
   branchEntityId,
@@ -92,15 +92,15 @@ import {
   issueEntityId,
   laneEntityId,
   milestoneEntityId
-} from "./chunk-N6MYZT4O.js";
+} from "./chunk-547FZFKO.js";
 import {
   createVcsOp,
   hashVcsOp,
   isVcsOp,
   isVcsOpKind,
   verifyVcsOpHash
-} from "./chunk-GLM4HGN4.js";
-import "./chunk-KFQGP6VL.js";
+} from "./chunk-GRWQPKYK.js";
+import "./chunk-2ESYSVXG.js";
 
 // src/index.ts
 init_engine();

package/dist/launch-explorer-FVX6ZABW.js

@@ -0,0 +1,95 @@
+import "./chunk-2ESYSVXG.js";
+
+// src/ui/launch-explorer.ts
+import { existsSync } from "node:fs";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+var MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+function resolveExplorerAppDir() {
+  const candidates = [
+    path.resolve(MODULE_DIR, "../../demo/realtime-app"),
+    path.resolve(process.cwd(), "demo/realtime-app")
+  ];
+  for (const dir of candidates) {
+    if (existsSync(path.join(dir, "package.json"))) return dir;
+  }
+  throw new Error(
+    "Realtime explorer app not found at demo/realtime-app.\nRun: node scripts/sync-realtime-app.mjs"
+  );
+}
+function which(cmd) {
+  return process.platform === "win32" ? `${cmd}.cmd` : cmd;
+}
+async function launchRealtimeExplorer(opts) {
+  const appDir = resolveExplorerAppDir();
+  const appPort = opts.appPort ?? 4e3;
+  const trellisPort = opts.trellisPort ?? 3920;
+  if (!existsSync(path.join(appDir, "node_modules"))) {
+    console.log("Installing explorer dependencies (pnpm)\u2026");
+    await runCmd(which("pnpm"), ["install"], { cwd: appDir });
+  } else {
+    await runCmd(which("node"), ["scripts/ensure-trellis-build.mjs"], {
+      cwd: appDir
+    });
+  }
+  const env = {
+    ...process.env,
+    TRELLIS_PORT: String(trellisPort),
+    TRELLIS_REPO_ROOT: opts.rootPath
+  };
+  const child = spawn(which("pnpm"), ["run", "dev:all"], {
+    cwd: appDir,
+    env,
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+  const stop = () => {
+    if (!child.killed) child.kill("SIGTERM");
+  };
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    child.on("error", (err) => {
+      if (!settled) {
+        settled = true;
+        reject(err);
+      }
+    });
+    child.on("exit", (code) => {
+      if (settled) return;
+      if (code != null && code !== 0) {
+        settled = true;
+        reject(new Error(`Explorer exited with code ${code}`));
+      }
+    });
+    setTimeout(() => {
+      if (settled) return;
+      settled = true;
+      resolve({
+        appPort,
+        trellisPort,
+        appUrl: `http://localhost:${appPort}`,
+        trellisUrl: `http://localhost:${trellisPort}`,
+        stop
+      });
+    }, 2e3);
+  });
+}
+function runCmd(cmd, args, opts) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, {
+      cwd: opts.cwd,
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`${cmd} exited with ${code}`));
+    });
+  });
+}
+export {
+  launchRealtimeExplorer,
+  resolveExplorerAppDir
+};

package/dist/links/index.js

@@ -23,8 +23,8 @@ import {
   resolveRef,
   resolveRefs,
   updateFileInIndex
-} from "../chunk-VDAKEOML.js";
-import "../chunk-KFQGP6VL.js";
+} from "../chunk-J6OUIION.js";
+import "../chunk-2ESYSVXG.js";
 init_links();
 export {
   StaleRefRegistry,

package/dist/mcp/bridge.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Trellis Room MCP bridge — stdio proxy to a remote Streamable HTTP room.
+ *
+ * For MCP clients that only support stdio (Claude Desktop, older configs):
+ *
+ *   npx trellis mcp bridge --room https://my-room.sprites.app
+ *
+ * @module trellis/mcp
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export interface RoomMcpBridgeOptions {
+    /** Room base URL or full `/mcp` URL. Falls back to `.trellis-db.json`. */
+    room?: string;
+    /** API key. Falls back to `.trellis-db.json`. */
+    apiKey?: string;
+    /** Directory containing `.trellis-db.json`. */
+    configDir?: string;
+    /** Default tenant for all tool calls (e.g. embed-design-review). */
+    tenant?: string;
+    /** Playground `?room=` slug → tenant `embed-{slug}`. */
+    playgroundRoom?: string;
+    /** Suppress stderr startup line (for harness / IDE configs). */
+    quiet?: boolean;
+}
+export interface ResolvedRoomMcpBridgeConfig {
+    url: string;
+    apiKey?: string;
+    tenantId?: string | null;
+}
+/** Normalize a room base URL to the Streamable HTTP MCP endpoint. */
+export declare function resolveRoomMcpUrl(baseUrl: string): string;
+/** Resolve room URL + API key from CLI flags or `.trellis-db.json`. */
+export declare function resolveBridgeConfig(opts: RoomMcpBridgeOptions): ResolvedRoomMcpBridgeConfig;
+/** Connect an MCP client to a remote Trellis room. */
+export declare function connectRemoteRoomClient(config: ResolvedRoomMcpBridgeConfig): Promise<{
+    client: Client;
+    transport: StreamableHTTPClientTransport;
+}>;
+/** Local MCP server that forwards tool calls to a remote room client. */
+export declare function createRoomMcpProxyServer(remote: Client): Server;
+/** Run stdio MCP bridge until stdin closes or the process is interrupted. */
+export declare function runRoomMcpBridge(opts: RoomMcpBridgeOptions): Promise<void>;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/mcp/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/mcp/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAYnE,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,oBAAoB,GACzB,2BAA2B,CA2C7B;AAED,sDAAsD;AACtD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,6BAA6B,CAAA;CAAE,CAAC,CAoBvE;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAa/D;AAED,6EAA6E;AAC7E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BhF"}

package/dist/mcp/discovery.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MCP discovery tools — list/get/connect registered Trellis rooms.
+ *
+ * Mounted at `/gateway/mcp` on room servers and on `trellis mcp gateway serve`.
+ *
+ * @module trellis/mcp
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type RoomRegistryOptions } from './room-registry.js';
+export interface DiscoveryMcpContext extends RoomRegistryOptions {
+    /** Request origin for OAuth metadata hints (e.g. https://room.sprites.app). */
+    origin?: string;
+}
+export declare function createDiscoveryMcpServer(ctx?: DiscoveryMcpContext): McpServer;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/mcp/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/mcp/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,mBAAwB,GAAG,SAAS,CAmLjF"}

package/dist/mcp/gateway-config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `.trellis-mcp-gateway.json` — local config for a deployed discovery gateway.
+ *
+ * @module trellis/mcp
+ */
+export declare const GATEWAY_CONFIG_FILE = ".trellis-mcp-gateway.json";
+export interface McpGatewayConfig {
+    /** Sprites URL (API origin). */
+    url: string;
+    /** Public URL agents use (e.g. https://mcp.trellis.computer). */
+    publicUrl: string;
+    spriteName: string;
+    deployedAt: string;
+    port?: number;
+}
+export declare function gatewayConfigPath(dir?: string): string;
+export declare function hasGatewayConfig(dir?: string): boolean;
+export declare function readGatewayConfig(dir?: string): McpGatewayConfig | null;
+export declare function writeGatewayConfig(config: McpGatewayConfig, dir?: string): void;
+//# sourceMappingURL=gateway-config.d.ts.map

package/dist/mcp/gateway-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-config.d.ts","sourceRoot":"","sources":["../../src/mcp/gateway-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,GAAG,SAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,SAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,SAAM,GAAG,gBAAgB,GAAG,IAAI,CAQpE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,SAAM,GAAG,IAAI,CAM5E"}

package/dist/mcp/gateway-serve.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Standalone MCP discovery gateway HTTP server.
+ *
+ * `trellis mcp gateway serve` — discovery tools without a full room kernel.
+ *
+ * @module trellis/mcp
+ */
+export interface GatewayServeOptions {
+    port?: number;
+    hostname?: string;
+    configDir?: string;
+    publicUrl?: string;
+}
+export declare function createGatewayFetchHandler(opts?: GatewayServeOptions): Promise<(req: Request) => Promise<Response>>;
+export declare function startGatewayServer(opts?: GatewayServeOptions): Promise<{
+    port: number;
+    stop: () => void;
+}>;
+//# sourceMappingURL=gateway-serve.d.ts.map

package/dist/mcp/gateway-serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-serve.d.ts","sourceRoot":"","sources":["../../src/mcp/gateway-serve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,CAuE9C;AAED,wBAAsB,kBAAkB,CACtC,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CA+B7C"}

package/dist/mcp/gateway-serve.js

@@ -0,0 +1,119 @@
+import {
+  corsPreflightResponse,
+  discoveryMcpGateway,
+  mcpServiceDocument,
+  oauthAuthorizationServerMetadata,
+  oauthProtectedResourceMetadata,
+  withCors
+} from "../chunk-53PDCTJ3.js";
+import "../chunk-CMSFD6OV.js";
+import "../chunk-GCQF75T4.js";
+import "../chunk-YC5I32PS.js";
+import "../chunk-UZRUP7QW.js";
+import "../chunk-JA7AIHRK.js";
+import "../chunk-SZ3VAB5P.js";
+import "../chunk-OB4CMMX6.js";
+import "../chunk-V4YCJDYL.js";
+import "../chunk-6CTA6MCE.js";
+import "../chunk-G3XIHPSQ.js";
+import "../chunk-2ESYSVXG.js";
+
+// src/mcp/gateway-serve.ts
+async function createGatewayFetchHandler(opts = {}) {
+  const configDir = opts.configDir ?? ".";
+  const discoveryCtx = { configDir };
+  return async (req) => {
+    if (req.method === "OPTIONS") {
+      return corsPreflightResponse(req);
+    }
+    const url = new URL(req.url);
+    const path = url.pathname.replace(/\/$/, "") || "/";
+    const origin = opts.publicUrl?.replace(/\/$/, "") || `${url.protocol}//${url.host}`;
+    const respond = (res) => withCors(req, res);
+    if (path === "/health") {
+      return respond(
+        new Response(
+          JSON.stringify({
+            status: "ok",
+            service: "trellis-mcp-gateway",
+            mcp: "/mcp",
+            gateway: "/gateway/mcp"
+          }),
+          { headers: { "Content-Type": "application/json" } }
+        )
+      );
+    }
+    if (path === "/.well-known/oauth-protected-resource") {
+      return respond(
+        new Response(JSON.stringify(oauthProtectedResourceMetadata(origin)), {
+          headers: { "Content-Type": "application/json" }
+        })
+      );
+    }
+    if (path === "/.well-known/oauth-authorization-server") {
+      return respond(
+        new Response(JSON.stringify(oauthAuthorizationServerMetadata(origin)), {
+          headers: { "Content-Type": "application/json" }
+        })
+      );
+    }
+    if (path === "/mcp" || path === "/gateway/mcp") {
+      const res = await discoveryMcpGateway.handle(req, {
+        ...discoveryCtx,
+        origin,
+        gatewayPublicUrl: origin
+      });
+      return respond(res);
+    }
+    if (path === "/") {
+      return respond(
+        new Response(JSON.stringify(mcpServiceDocument(origin, {})), {
+          headers: { "Content-Type": "application/json" }
+        })
+      );
+    }
+    return respond(
+      new Response(JSON.stringify({ error: "Not Found" }), {
+        status: 404,
+        headers: { "Content-Type": "application/json" }
+      })
+    );
+  };
+}
+async function startGatewayServer(opts = {}) {
+  const port = opts.port ?? 3940;
+  const fetch = await createGatewayFetchHandler(opts);
+  if (typeof globalThis.Bun !== "undefined") {
+    const server2 = globalThis.Bun.serve({
+      port,
+      hostname: opts.hostname ?? "0.0.0.0",
+      fetch
+    });
+    return {
+      port: server2.port ?? port,
+      stop: () => server2.stop(true)
+    };
+  }
+  const { startNodeServer } = await import("../server/node-adapter.js");
+  const server = await startNodeServer({
+    port,
+    hostname: opts.hostname,
+    fetch,
+    websocket: {
+      open() {
+      },
+      message() {
+      },
+      close() {
+      }
+    }
+  });
+  return {
+    port: server.port,
+    stop: () => server.stop(true)
+  };
+}
+export {
+  createGatewayFetchHandler,
+  startGatewayServer
+};

package/dist/mcp/graph-summary.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Compact graph summary for room MCP — token-efficient agent orientation.
+ *
+ * Mirrors trellis-client GET /api/graph/summary shape for skill portability.
+ *
+ * @module trellis/mcp
+ */
+import type { TrellisKernel } from '../core/kernel/trellis-kernel.js';
+export interface RoomGraphSummaryOptions {
+    limit?: number;
+}
+export interface RoomGraphSummary {
+    health: {
+        status: 'ok';
+        factCount: number;
+        linkCount: number;
+        entityCount: number;
+        ops: number;
+        tenantId: string | null;
+    };
+    entityTypes: Array<{
+        type: string;
+        count: number;
+    }>;
+    ontologies: {
+        total: number;
+        system: string[];
+        user: string[];
+    };
+    topAttributes: Array<{
+        attribute: string;
+        distinctCount: number;
+        cardinality: 'one' | 'many';
+    }>;
+    links: {
+        total: number;
+        relations: string[];
+    };
+    recentMutations: Array<{
+        kind: string;
+        agentId: string;
+        timestamp: string;
+        entityId?: string;
+    }>;
+}
+export declare function buildRoomGraphSummary(kernel: TrellisKernel, tenantId: string | null, opts?: RoomGraphSummaryOptions): RoomGraphSummary;
+//# sourceMappingURL=graph-summary.d.ts.map

package/dist/mcp/graph-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-summary.d.ts","sourceRoot":"","sources":["../../src/mcp/graph-summary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QACN,MAAM,EAAE,IAAI,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,aAAa,EAAE,KAAK,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;KAC7B,CAAC,CAAC;IACH,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9C,eAAe,EAAE,KAAK,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAID,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,IAAI,GAAE,uBAA4B,GACjC,gBAAgB,CAgFlB"}

package/dist/mcp/room-audit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Room MCP audit — Decision entities for agent write attribution.
+ *
+ * @module trellis/mcp
+ */
+import type { MiddlewareContext } from '../core/kernel/middleware.js';
+import type { TrellisKernel } from '../core/kernel/trellis-kernel.js';
+/**
+ * Persist a Decision entity for an MCP write (fire-and-forget safe).
+ */
+export declare function recordRoomMcpAudit(kernel: TrellisKernel, agentId: string, toolName: string, params: Record<string, unknown>, resultText: string, wctx: Partial<MiddlewareContext>, relatedEntities?: string[]): Promise<string | null>;
+/** Schedule audit without blocking the tool response. */
+export declare function scheduleRoomMcpAudit(kernelPromise: Promise<TrellisKernel>, agentId: string, toolName: string, params: Record<string, unknown>, resultText: string, wctx: Partial<MiddlewareContext>, relatedEntities?: string[]): void;
+//# sourceMappingURL=room-audit.d.ts.map

package/dist/mcp/room-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-audit.d.ts","sourceRoot":"","sources":["../../src/mcp/room-audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAkBtE;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAChC,eAAe,GAAE,MAAM,EAAO,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BxB;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAChC,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,IAAI,CAYN"}

package/dist/mcp/room-helpers.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared helpers for room MCP tools — lanes, rate limits, write context.
+ *
+ * @module trellis/mcp
+ */
+import type { MiddlewareContext } from '../core/kernel/middleware.js';
+import type { AuthContext } from '../server/auth.js';
+import { type UsageMeter } from '../server/usage-meter.js';
+/** Normalize lane / agent attribution for draft writes. */
+export declare function resolveWriteAgentId(lane: string | undefined, auth: AuthContext, headerLane?: string | null): string;
+export declare function writeContext(lane: string | undefined, auth: AuthContext, headerLane?: string | null): Partial<MiddlewareContext>;
+export declare function assertMcpBudget(meter: UsageMeter | null, tenantId: string | null): void;
+export declare function playgroundRoomToTenant(slug: string): string;
+export interface ResolveMcpTenantOptions {
+    /** Session default from `?tenantId=` on the MCP HTTP URL or auth JWT. */
+    defaultTenantId?: string | null;
+    /** `X-Trellis-Tenant` header on the MCP request. */
+    headerTenant?: string | null;
+    /** Per-tool explicit tenant id. */
+    toolTenantId?: string;
+    /** Playground `?room=` slug → `embed-{slug}`. */
+    roomSlug?: string;
+}
+/**
+ * Resolve effective tenant for a room MCP tool call.
+ * Priority: tool `tenantId` → tool `room` → header → URL/auth default → null (showcase).
+ */
+export declare function resolveMcpTenantId(opts: ResolveMcpTenantOptions): string | null;
+export declare function handleMcpError(err: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+} | null;
+/** Stable CollectionMeta id used by Playground (`collectionMeta:<slug>`). */
+export declare const COLLECTION_META_PREFIX: "collectionMeta:";
+export declare function collectionMetaIdFromSlug(slug: string): string;
+export declare function resolveCollectionId(opts: {
+    collectionSlug?: string;
+    collectionId?: string;
+}): string;
+export declare function collectionSlugFromMetaId(collectionId: string): string | null;
+//# sourceMappingURL=room-helpers.d.ts.map

package/dist/mcp/room-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-helpers.d.ts","sourceRoot":"","sources":["../../src/mcp/room-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAElC,2DAA2D;AAC3D,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,CAYR;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAI5B;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,IAAI,CAGN;AAKD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,uBAAuB,GAC5B,MAAM,GAAG,IAAI,CAWf;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO;;;;;SAK1C;AAED,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,EAAG,iBAA0B,CAAC;AAEjE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAQT;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5E"}