@ontrails/mcp 1.0.0-beta.4 → 1.0.0-beta.41

package/src/surface.ts

@@ -0,0 +1,295 @@
+/**
+ * Surface helpers for exposing a topo over MCP.
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import {
+  CallToolRequestSchema,
+  ErrorCode,
+  ListResourcesRequestSchema,
+  ListToolsRequestSchema,
+  McpError,
+  ReadResourceRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+import type {
+  BaseSurfaceOptions,
+  Layer,
+  OverlayEnvelopeLike,
+  ResourceOverrideMap,
+  Topo,
+  TrailContextInit,
+} from '@ontrails/core';
+
+import type {
+  McpSurfaceTrailheadMap,
+  McpToolDefinition,
+  ResolveMcpPermit,
+} from './build.js';
+import { deriveMcpTools } from './build.js';
+import { buildMcpResources } from './resources.js';
+import type { BuiltMcpResources, McpResourcesConfig } from './resources.js';
+import { connectStdio } from './stdio.js';
+
+// ---------------------------------------------------------------------------
+// Options
+// ---------------------------------------------------------------------------
+
+export interface CreateServerOptions extends BaseSurfaceOptions {
+  readonly createContext?:
+    | (() => TrailContextInit | Promise<TrailContextInit>)
+    | undefined;
+  readonly description?: string | undefined;
+  /**
+   * App-authored overlay envelopes (the same collection compile embeds in
+   * `trails.lock`). The `surfaces` overlay's `mcp` bindings are the authored,
+   * lockable default: list bindings become grouped trailhead tools and scalar
+   * bindings become tool synonyms.
+   */
+  readonly overlays?: readonly OverlayEnvelopeLike[] | undefined;
+  /**
+   * Call-site trailhead map. Override-in-context by design: when both this
+   * map and overlay `mcp` list bindings are present, the call-site map wins
+   * at runtime.
+   */
+  readonly trailheads?: McpSurfaceTrailheadMap | undefined;
+  readonly layers?: readonly Layer[] | undefined;
+  readonly mcpResources?: McpResourcesConfig | false | undefined;
+  readonly name?: string | undefined;
+  readonly resources?: ResourceOverrideMap | undefined;
+  readonly resolvePermit?: ResolveMcpPermit | undefined;
+  readonly version?: string | undefined;
+}
+
+export interface SurfaceMcpResult {
+  readonly close: () => Promise<void>;
+}
+
+// ---------------------------------------------------------------------------
+// Internal: create MCP server with tool handlers
+// ---------------------------------------------------------------------------
+
+/**
+ * Create an MCP Server instance and register all tools.
+ *
+ * When provided, `info.description` is forwarded to the MCP SDK as the
+ * server's `instructions` field — the SDK's documented channel for
+ * "optional instructions describing how to use the server and its features."
+ */
+const createMcpServer = (
+  tools: McpToolDefinition[],
+  info: {
+    readonly name: string;
+    readonly version: string;
+    readonly description?: string | undefined;
+  },
+  mcpResources?: BuiltMcpResources | undefined
+): Server => {
+  const server = new Server(
+    { name: info.name, version: info.version },
+    {
+      capabilities: {
+        ...(mcpResources === undefined ? {} : { resources: {} }),
+        tools: {},
+      },
+      ...(info.description === undefined
+        ? {}
+        : { instructions: info.description }),
+    }
+  );
+
+  // Build a lookup map for tool dispatch
+  const toolMap = new Map<string, McpToolDefinition>();
+  for (const tool of tools) {
+    toolMap.set(tool.name, tool);
+  }
+
+  // Register tools/list handler
+  // oxlint-disable-next-line require-await -- MCP SDK requires async handler
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: tools.map((t) => ({
+      _meta: t._meta,
+      annotations: t.annotations,
+      description: t.description,
+      inputSchema: t.inputSchema,
+      name: t.name,
+      outputSchema: t.outputSchema,
+    })),
+  }));
+
+  // Register tools/call handler
+  server.setRequestHandler(
+    CallToolRequestSchema,
+    async (request, requestExtra) => {
+      const tool = toolMap.get(request.params.name);
+      if (tool === undefined) {
+        return {
+          content: [
+            {
+              text: `Unknown tool: ${request.params.name}`,
+              type: 'text' as const,
+            },
+          ],
+          isError: true,
+        } as Record<string, unknown>;
+      }
+
+      const args = (request.params.arguments ?? {}) as Record<string, unknown>;
+      const progressToken = request.params._meta?.progressToken;
+      const { authInfo } = requestExtra as {
+        readonly authInfo?:
+          | {
+              readonly accessToken?: string | undefined;
+              readonly sessionId?: string | undefined;
+              readonly token?: string | undefined;
+            }
+          | undefined;
+      };
+      const authorizationToken = authInfo?.accessToken ?? authInfo?.token;
+
+      const sendProgress =
+        progressToken === undefined
+          ? undefined
+          : async (current: number, total: number) => {
+              await server.notification({
+                method: 'notifications/progress',
+                params: {
+                  progress: current,
+                  progressToken,
+                  total,
+                },
+              });
+            };
+
+      const extra = {
+        abortSignal: requestExtra.signal,
+        ...(authorizationToken === undefined
+          ? {}
+          : { authorization: `Bearer ${authorizationToken}` }),
+        progressToken,
+        sendProgress,
+        ...(authInfo?.sessionId === undefined
+          ? {}
+          : { sessionId: authInfo.sessionId }),
+      };
+
+      const result = await tool.handler(args, extra);
+      // Spread to satisfy MCP SDK's index-signature requirement
+      return { ...result } as Record<string, unknown>;
+    }
+  );
+
+  if (mcpResources !== undefined) {
+    // oxlint-disable-next-line require-await -- MCP SDK requires async handler
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+      resources: mcpResources.list.map((resource) => ({
+        description: resource.description,
+        mimeType: resource.mimeType,
+        name: resource.name,
+        uri: resource.uri,
+      })),
+    }));
+
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+      const content = mcpResources.read(request.params.uri);
+      if (content === undefined) {
+        throw new McpError(
+          ErrorCode.InvalidParams,
+          `Resource ${request.params.uri} not found`
+        );
+      }
+      return {
+        contents: [content],
+      };
+    });
+  }
+
+  return server;
+};
+
+// ---------------------------------------------------------------------------
+// createServer
+// ---------------------------------------------------------------------------
+
+/**
+ * Build MCP tools from a topo and create an MCP server.
+ *
+ * @remarks This is a host materialization boundary. Derivation failures are
+ * thrown for server bootstrap code after `deriveMcpTools` has already
+ * represented the framework error as a Result.
+ *
+ * @example
+ * ```ts
+ * import { connectStdio, createServer } from '@ontrails/mcp';
+ *
+ * const server = createServer(graph, { name: 'demo' });
+ * await connectStdio(server);
+ * ```
+ */
+export const createServer = (
+  graph: Topo,
+  options: CreateServerOptions = {}
+): Server => {
+  const toolsResult = deriveMcpTools(graph, {
+    configValues: options.configValues,
+    createContext: options.createContext,
+    exclude: options.exclude,
+    include: options.include,
+    intent: options.intent,
+    layers: options.layers,
+    overlays: options.overlays,
+    resolvePermit: options.resolvePermit,
+    resources: options.resources,
+    trailheads: options.trailheads,
+    validate: options.validate,
+  });
+
+  if (toolsResult.isErr()) {
+    throw toolsResult.error;
+  }
+
+  const mcpResources =
+    options.mcpResources === false
+      ? undefined
+      : buildMcpResources(graph, toolsResult.value, options.mcpResources);
+
+  return createMcpServer(
+    toolsResult.value,
+    {
+      description: options.description ?? graph.description,
+      name: options.name ?? graph.name,
+      version: options.version ?? graph.version ?? '0.1.0',
+    },
+    mcpResources
+  );
+};
+
+// ---------------------------------------------------------------------------
+// surface
+// ---------------------------------------------------------------------------
+
+/**
+ * Build MCP tools from a topo, create a server, and connect via stdio.
+ *
+ * @remarks Opens the MCP server on stdio. For custom transports, use
+ * `createServer(graph)` with `connectStdio` or your own adapter.
+ *
+ * @example
+ * ```ts
+ * import { surface } from '@ontrails/mcp';
+ *
+ * await surface(graph, { name: 'demo' });
+ * ```
+ */
+export const surface = async (
+  graph: Topo,
+  options: CreateServerOptions = {}
+): Promise<SurfaceMcpResult> => {
+  const server = createServer(graph, options);
+  await connectStdio(server);
+
+  return {
+    close: async () => {
+      await server.close();
+    },
+  };
+};

package/src/tool-name.ts

@@ -1,10 +1,13 @@
 /**
  * Derive MCP-safe tool names from app name + trail ID.
  *
- * MCP tool names must be [a-z0-9_]+. We prefix with the app name,
- * replace dots and hyphens with underscores, and lowercase everything.
+ * The derivation itself lives in `@ontrails/core` (`deriveMcpToolName`) so
+ * governance readers such as Warden's `surface-overlay-coherence` rule check
+ * collisions against the exact projection the MCP surface renders.
  */
 
+import { deriveMcpToolName } from '@ontrails/core';
+
 /**
  * Convert app name + trail ID to an MCP-safe tool name.
  *
@@ -12,8 +15,4 @@
  * deriveToolName("myapp", "entity.show") // "myapp_entity_show"
  * deriveToolName("dispatch", "patch.search") // "dispatch_patch_search"
  */
-export const deriveToolName = (appName: string, trailId: string): string => {
-  const prefix = appName.toLowerCase().replaceAll(/[.-]/g, '_');
-  const suffix = trailId.toLowerCase().replaceAll(/[.-]/g, '_');
-  return `${prefix}_${suffix}`;
-};
+export const deriveToolName = deriveMcpToolName;

package/.turbo/turbo-build.log

@@ -1 +0,0 @@
-$ tsc -b

package/.turbo/turbo-lint.log

@@ -1,3 +0,0 @@
-$ oxlint ./src
-Found 0 warnings and 0 errors.
-Finished in 23ms on 12 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -1 +0,0 @@
-$ tsc --noEmit

package/dist/annotations.d.ts

@@ -1,19 +0,0 @@
-/**
- * Derive MCP tool annotations from trail spec fields.
- */
-import type { Trail } from '@ontrails/core';
-export interface McpAnnotations {
-    readonly readOnlyHint?: boolean | undefined;
-    readonly destructiveHint?: boolean | undefined;
-    readonly idempotentHint?: boolean | undefined;
-    readonly openWorldHint?: boolean | undefined;
-    readonly title?: string | undefined;
-}
-/**
- * Map trail spec fields to MCP tool annotations.
- *
- * Only sets hints that are explicitly declared on the trail.
- * Omitted hints let the MCP SDK use its defaults.
- */
-export declare const deriveAnnotations: (trail: Pick<Trail<unknown, unknown>, "intent" | "idempotent" | "description">) => McpAnnotations;
-//# sourceMappingURL=annotations.d.ts.map

package/dist/annotations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAU,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAMpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAMD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,aAAa,CAAC,KAC5E,cAoBF,CAAC"}

package/dist/annotations.js

@@ -1,31 +0,0 @@
-/**
- * Derive MCP tool annotations from trail spec fields.
- */
-// ---------------------------------------------------------------------------
-// Derivation
-// ---------------------------------------------------------------------------
-/**
- * Map trail spec fields to MCP tool annotations.
- *
- * Only sets hints that are explicitly declared on the trail.
- * Omitted hints let the MCP SDK use its defaults.
- */
-export const deriveAnnotations = (trail) => {
-    const annotations = {};
-    const intentToHint = {
-        destroy: 'destructiveHint',
-        read: 'readOnlyHint',
-    };
-    const hint = intentToHint[trail.intent];
-    if (hint) {
-        annotations[hint] = true;
-    }
-    if (trail.idempotent === true) {
-        annotations['idempotentHint'] = true;
-    }
-    if (trail.description !== undefined) {
-        annotations['title'] = trail.description;
-    }
-    return annotations;
-};
-//# sourceMappingURL=annotations.js.map

package/dist/annotations.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../src/annotations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAA6E,EAC7D,EAAE;IAClB,MAAM,WAAW,GAA4B,EAAE,CAAC;IAEhD,MAAM,YAAY,GAAoC;QACpD,OAAO,EAAE,iBAAiB;QAC1B,IAAI,EAAE,cAAc;KACrB,CAAC;IAEF,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,IAAI,EAAE,CAAC;QACT,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC9B,WAAW,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,WAAW,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,OAAO,WAA6B,CAAC;AACvC,CAAC,CAAC"}

package/dist/blaze.d.ts

@@ -1,36 +0,0 @@
-/**
- * blaze() -- the one-liner MCP server launcher.
- *
- * Three lines to expose trails as MCP tools:
- *
- * ```ts
- * const app = topo("myapp", entity);
- * await blaze(app);
- * ```
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import type { Layer, Topo, TrailContext } from '@ontrails/core';
-import type { McpToolDefinition } from './build.js';
-export interface BlazeMcpOptions {
-    readonly createContext?: (() => TrailContext | Promise<TrailContext>) | undefined;
-    readonly excludeTrails?: readonly string[] | undefined;
-    readonly includeTrails?: readonly string[] | undefined;
-    readonly layers?: readonly Layer[] | undefined;
-    readonly serverInfo?: {
-        readonly name?: string | undefined;
-        readonly version?: string | undefined;
-    } | undefined;
-    readonly transport?: 'stdio' | undefined;
-}
-/**
- * Create an MCP Server instance and register all tools.
- */
-export declare const createMcpServer: (tools: McpToolDefinition[], info: {
-    readonly name: string;
-    readonly version: string;
-}) => Server;
-/**
- * Build MCP tools from an App, create a server, and connect via stdio.
- */
-export declare const blaze: (app: Topo, options?: BlazeMcpOptions) => Promise<void>;
-//# sourceMappingURL=blaze.d.ts.map

package/dist/blaze.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"blaze.d.ts","sourceRoot":"","sources":["../src/blaze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,GAC5C,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAChB;QACE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACvC,GACD,SAAS,CAAC;IACd,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1C;AAMD;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,iBAAiB,EAAE,EAC1B,MAAM;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACxD,MAmEF,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,KAAK,GAChB,KAAK,IAAI,EACT,UAAS,eAAoB,KAC5B,OAAO,CAAC,IAAI,CAcd,CAAC"}

package/dist/blaze.js

@@ -1,96 +0,0 @@
-/**
- * blaze() -- the one-liner MCP server launcher.
- *
- * Three lines to expose trails as MCP tools:
- *
- * ```ts
- * const app = topo("myapp", entity);
- * await blaze(app);
- * ```
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { buildMcpTools } from './build.js';
-import { connectStdio } from './stdio.js';
-// ---------------------------------------------------------------------------
-// Internal: create MCP server with tool handlers
-// ---------------------------------------------------------------------------
-/**
- * Create an MCP Server instance and register all tools.
- */
-export const createMcpServer = (tools, info) => {
-    const server = new Server({ name: info.name, version: info.version }, { capabilities: { tools: {} } });
-    // Build a lookup map for tool dispatch
-    const toolMap = new Map();
-    for (const tool of tools) {
-        toolMap.set(tool.name, tool);
-    }
-    // Register tools/list handler
-    // oxlint-disable-next-line require-await -- MCP SDK requires async handler
-    server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: tools.map((t) => ({
-            annotations: t.annotations,
-            description: t.description,
-            inputSchema: t.inputSchema,
-            name: t.name,
-        })),
-    }));
-    // Register tools/call handler
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        const tool = toolMap.get(request.params.name);
-        if (tool === undefined) {
-            return {
-                content: [
-                    {
-                        text: `Unknown tool: ${request.params.name}`,
-                        type: 'text',
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const args = (request.params.arguments ?? {});
-        const progressToken = request.params._meta?.progressToken;
-        const sendProgress = progressToken === undefined
-            ? undefined
-            : async (current, total) => {
-                await server.notification({
-                    method: 'notifications/progress',
-                    params: {
-                        progress: current,
-                        progressToken: progressToken,
-                        total,
-                    },
-                });
-            };
-        const extra = {
-            progressToken,
-            sendProgress,
-            signal: undefined,
-        };
-        const result = await tool.handler(args, extra);
-        // Spread to satisfy MCP SDK's index-signature requirement
-        return { ...result };
-    });
-    return server;
-};
-// ---------------------------------------------------------------------------
-// blaze
-// ---------------------------------------------------------------------------
-/**
- * Build MCP tools from an App, create a server, and connect via stdio.
- */
-export const blaze = async (app, options = {}) => {
-    const tools = buildMcpTools(app, {
-        createContext: options.createContext,
-        excludeTrails: options.excludeTrails,
-        includeTrails: options.includeTrails,
-        layers: options.layers,
-    });
-    const server = createMcpServer(tools, {
-        name: options.serverInfo?.name ?? app.name,
-        version: options.serverInfo?.version ?? '0.1.0',
-    });
-    await connectStdio(server);
-};
-//# sourceMappingURL=blaze.js.map

package/dist/blaze.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"blaze.js","sourceRoot":"","sources":["../src/blaze.ts"],"names":[],"mappings":"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"}

package/dist/build.d.ts

@@ -1,40 +0,0 @@
-/**
- * Build MCP tool definitions from a Trails App.
- *
- * Iterates the topo, generates McpToolDefinition[] with handlers that
- * validate input, compose layers, execute the implementation, and map
- * Results to MCP responses.
- */
-import type { Layer, Topo, TrailContext } from '@ontrails/core';
-import type { McpAnnotations } from './annotations.js';
-export interface BuildMcpToolsOptions {
-    readonly createContext?: (() => TrailContext | Promise<TrailContext>) | undefined;
-    readonly excludeTrails?: readonly string[] | undefined;
-    readonly includeTrails?: readonly string[] | undefined;
-    readonly layers?: readonly Layer[] | undefined;
-}
-export interface McpToolDefinition {
-    readonly annotations: McpAnnotations | undefined;
-    readonly description: string | undefined;
-    readonly handler: (args: Record<string, unknown>, extra: McpExtra) => Promise<McpToolResult>;
-    readonly inputSchema: Record<string, unknown>;
-    readonly name: string;
-}
-export interface McpExtra {
-    readonly progressToken?: string | number | undefined;
-    readonly sendProgress?: ((current: number, total: number) => Promise<void>) | undefined;
-    readonly signal?: AbortSignal | undefined;
-}
-export interface McpToolResult {
-    readonly content: readonly McpContent[];
-    readonly isError?: boolean | undefined;
-}
-export interface McpContent {
-    readonly data?: string | undefined;
-    readonly mimeType?: string | undefined;
-    readonly text?: string | undefined;
-    readonly type: 'text' | 'image' | 'resource';
-    readonly uri?: string | undefined;
-}
-export declare const buildMcpTools: (app: Topo, options?: BuildMcpToolsOptions) => McpToolDefinition[];
-//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAW,KAAK,EAAE,IAAI,EAAS,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASvD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,GAC5C,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,QAAQ,KACZ,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAClB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GACnD,SAAS,CAAC;IACd,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAsSD,eAAO,MAAM,aAAa,GACxB,KAAK,IAAI,EACT,UAAS,oBAAyB,KACjC,iBAAiB,EAUnB,CAAC"}