@toolgrain/mcp 0.0.0-stage → 0.1.0

package/dist/tools/content.d.ts

@@ -0,0 +1,181 @@
+import { z } from "zod";
+export declare const contentBlock: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    annotations: z.ZodOptional<z.ZodObject<{
+        audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+        lastModified: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    annotations: z.ZodOptional<z.ZodObject<{
+        audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+        lastModified: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"image">;
+    data: z.ZodString;
+    mimeType: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    annotations: z.ZodOptional<z.ZodObject<{
+        audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+        lastModified: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"audio">;
+    data: z.ZodString;
+    mimeType: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    annotations: z.ZodOptional<z.ZodObject<{
+        audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+        lastModified: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"resource_link">;
+    uri: z.ZodString;
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        theme: z.ZodOptional<z.ZodEnum<{
+            dark: "dark";
+            light: "light";
+        }>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>, z.ZodObject<{
+    annotations: z.ZodOptional<z.ZodObject<{
+        audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+        lastModified: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"resource">;
+    resource: z.ZodUnion<readonly [z.ZodObject<{
+        uri: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        text: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        uri: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        blob: z.ZodString;
+    }, z.core.$loose>]>;
+}, z.core.$loose>], "type">;
+export declare const explicitResult: z.ZodObject<{
+    content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        annotations: z.ZodOptional<z.ZodObject<{
+            audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                assistant: "assistant";
+                user: "user";
+            }>>>;
+            priority: z.ZodOptional<z.ZodNumber>;
+            lastModified: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        annotations: z.ZodOptional<z.ZodObject<{
+            audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                assistant: "assistant";
+                user: "user";
+            }>>>;
+            priority: z.ZodOptional<z.ZodNumber>;
+            lastModified: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"image">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        annotations: z.ZodOptional<z.ZodObject<{
+            audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                assistant: "assistant";
+                user: "user";
+            }>>>;
+            priority: z.ZodOptional<z.ZodNumber>;
+            lastModified: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"audio">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        annotations: z.ZodOptional<z.ZodObject<{
+            audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                assistant: "assistant";
+                user: "user";
+            }>>>;
+            priority: z.ZodOptional<z.ZodNumber>;
+            lastModified: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"resource_link">;
+        uri: z.ZodString;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            src: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            theme: z.ZodOptional<z.ZodEnum<{
+                dark: "dark";
+                light: "light";
+            }>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>, z.ZodObject<{
+        annotations: z.ZodOptional<z.ZodObject<{
+            audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                assistant: "assistant";
+                user: "user";
+            }>>>;
+            priority: z.ZodOptional<z.ZodNumber>;
+            lastModified: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"resource">;
+        resource: z.ZodUnion<readonly [z.ZodObject<{
+            uri: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            text: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            uri: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            blob: z.ZodString;
+        }, z.core.$loose>]>;
+    }, z.core.$loose>], "type">>;
+    structuredContent: z.ZodOptional<z.ZodUnknown>;
+    isError: z.ZodOptional<z.ZodBoolean>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+//# sourceMappingURL=content.d.ts.map

package/dist/tools/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/tools/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA6BvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKzB,CAAC"}

package/dist/tools/content.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { icon } from "../protocol/icon.js";
+import { object } from "../protocol/messages.js";
+const annotations = z.looseObject({
+    audience: z.array(z.enum(["user", "assistant"])).optional(),
+    priority: z.number().min(0).max(1).optional(),
+    lastModified: z.string().optional(),
+});
+const common = z.looseObject({
+    annotations: annotations.optional(),
+    _meta: object.optional(),
+});
+const resourceContents = z.looseObject({
+    uri: z.string(),
+    mimeType: z.string().optional(),
+    _meta: object.optional(),
+});
+export const contentBlock = z.discriminatedUnion("type", [
+    common.extend({ type: z.literal("text"), text: z.string() }),
+    common.extend({
+        type: z.literal("image"),
+        data: z.string(),
+        mimeType: z.string(),
+    }),
+    common.extend({
+        type: z.literal("audio"),
+        data: z.string(),
+        mimeType: z.string(),
+    }),
+    common.extend({
+        type: z.literal("resource_link"),
+        uri: z.string(),
+        name: z.string(),
+        title: z.string().optional(),
+        description: z.string().optional(),
+        mimeType: z.string().optional(),
+        size: z.number().optional(),
+        icons: z.array(icon).optional(),
+    }),
+    common.extend({
+        type: z.literal("resource"),
+        resource: z.union([
+            resourceContents.extend({ text: z.string() }),
+            resourceContents.extend({ blob: z.string() }),
+        ]),
+    }),
+]);
+export const explicitResult = z.strictObject({
+    content: z.array(contentBlock),
+    structuredContent: z.unknown().optional(),
+    isError: z.boolean().optional(),
+    _meta: object.optional(),
+});
+//# sourceMappingURL=content.js.map

package/dist/tools/content.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,36 @@
+import { type ClientCapabilities, type Implementation, type RequestId, type SupportedProtocolVersion } from "@toolgrain/protocol";
+import type { ClientCapabilities as LegacyClientCapabilities, Implementation as LegacyImplementation } from "@toolgrain/protocol/2025-06-18";
+import type { AuthIdentity } from "../auth/types.js";
+import type { RegisteredContextProvider } from "../context/definition.js";
+import { type ContextRegistry } from "../context/registry.js";
+import type { DeepReadonly } from "./json-value.js";
+/** What the client reported about itself; unverified, so not a basis for security decisions. */
+export interface ToolClient {
+    readonly info?: DeepReadonly<Implementation | LegacyImplementation>;
+    readonly capabilities?: DeepReadonly<ClientCapabilities | LegacyClientCapabilities>;
+}
+export interface ToolRequest {
+    readonly id: RequestId;
+    readonly protocolVersion: SupportedProtocolVersion;
+    /** Absent when the era and transport carry no client information, such as legacy HTTP. */
+    readonly client?: ToolClient;
+    /** A deeply frozen copy of the request's `_meta`; empty when the request carried none. */
+    readonly meta: Readonly<Record<string, unknown>>;
+}
+export interface ToolContext {
+    /** Aborts when the client cancels or disconnects, or the transport or server closes. */
+    readonly signal: AbortSignal;
+    readonly request: ToolRequest;
+}
+export interface ToolContextOptions {
+    signal?: AbortSignal;
+    request?: Partial<ToolRequest>;
+    context?: readonly RegisteredContextProvider[];
+}
+/** Build a context for calling a definition's `execute` directly, for example in tests. */
+export declare function toolContext(options?: ToolContextOptions): ToolContext;
+/** Each request gets its own deeply frozen copies, so handlers cannot affect one another. */
+export declare function createToolContext(signal: AbortSignal, { client, ...request }: ToolRequest, auth?: AuthIdentity, providers?: ContextRegistry): ToolContext;
+/** Omit absent fields so the client matches its optional-property types. */
+export declare function toolClient(info: ToolClient["info"], capabilities: ToolClient["capabilities"]): ToolClient;
+//# sourceMappingURL=context.d.ts.map

package/dist/tools/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EAEnB,KAAK,SAAS,EACd,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,kBAAkB,IAAI,wBAAwB,EAC9C,cAAc,IAAI,oBAAoB,EACvC,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,gGAAgG;AAChG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,cAAc,GAAG,oBAAoB,CAAC,CAAC;IACpE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAClC,kBAAkB,GAAG,wBAAwB,CAC9C,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAC;IACnD,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,WAAW;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAChD;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAmBzE;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,WAAW,EACnC,IAAI,CAAC,EAAE,YAAY,EACnB,SAAS,GAAE,eAAyC,GACnD,WAAW,CAiBb;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EACxB,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,GACvC,UAAU,CAKZ"}

package/dist/tools/context.js

@@ -0,0 +1,50 @@
+import { PROTOCOL_VERSION, } from "@toolgrain/protocol";
+import { attachAuth } from "../auth/context.js";
+import { createContextRegistry, } from "../context/registry.js";
+import { createContextScope } from "../context/scope.js";
+/** Build a context for calling a definition's `execute` directly, for example in tests. */
+export function toolContext(options = {}) {
+    // Default each field separately so an explicit undefined cannot replace a default.
+    const { id = 0, protocolVersion = PROTOCOL_VERSION, client, meta = {}, } = options.request ?? {};
+    return createToolContext(options.signal ?? new AbortController().signal, {
+        id,
+        protocolVersion,
+        ...(client === undefined ? {} : { client }),
+        meta,
+    }, undefined, createContextRegistry(options.context));
+}
+/** Each request gets its own deeply frozen copies, so handlers cannot affect one another. */
+export function createToolContext(signal, { client, ...request }, auth, providers = createContextRegistry()) {
+    const ctx = attachAuth({
+        signal,
+        request: Object.freeze({
+            ...request,
+            ...(client === undefined
+                ? {}
+                : {
+                    client: frozenCopy(toolClient(client.info, client.capabilities)),
+                }),
+            meta: frozenCopy(request.meta),
+        }),
+    }, auth);
+    return createContextScope(ctx, providers);
+}
+/** Omit absent fields so the client matches its optional-property types. */
+export function toolClient(info, capabilities) {
+    return {
+        ...(info === undefined ? {} : { info }),
+        ...(capabilities === undefined ? {} : { capabilities }),
+    };
+}
+function frozenCopy(value) {
+    return deepFreeze(structuredClone(value));
+}
+function deepFreeze(value) {
+    if (typeof value === "object" && value !== null) {
+        Object.freeze(value);
+        for (const child of Object.values(value))
+            deepFreeze(child);
+    }
+    return value;
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,gBAAgB,GAGjB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAEL,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAgCzD,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,OAAO,GAAuB,EAAE;IAC1D,mFAAmF;IACnF,MAAM,EACJ,EAAE,GAAG,CAAC,EACN,eAAe,GAAG,gBAAgB,EAClC,MAAM,EACN,IAAI,GAAG,EAAE,GACV,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IAC1B,OAAO,iBAAiB,CACtB,OAAO,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM,EAC9C;QACE,EAAE;QACF,eAAe;QACf,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,IAAI;KACL,EACD,SAAS,EACT,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,iBAAiB,CAC/B,MAAmB,EACnB,EAAE,MAAM,EAAE,GAAG,OAAO,EAAe,EACnC,IAAmB,EACnB,SAAS,GAAoB,qBAAqB,EAAE;IAEpD,MAAM,GAAG,GAAG,UAAU,CACpB;QACE,MAAM;QACN,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,GAAG,OAAO;YACV,GAAG,CAAC,MAAM,KAAK,SAAS;gBACtB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;iBACjE,CAAC;YACN,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;SAC/B,CAAC;KACH,EACD,IAAI,CACL,CAAC;IACF,OAAO,kBAAkB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CACxB,IAAwB,EACxB,YAAwC;IAExC,OAAO;QACL,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,OAAO,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tools/definition.d.ts

@@ -0,0 +1,55 @@
+import type { Tool as ProtocolTool } from "@toolgrain/protocol";
+import type * as core from "zod/v4/core";
+import type { ToolContext } from "./context.js";
+import type { DeepReadonly, IsJsonCompatible, JsonCompatible } from "./json-value.js";
+import type { McpErrorResult, McpResult, McpStructuredResult } from "./rich-result.js";
+export declare const TOOL_METADATA_KEYS: readonly ["title", "description", "annotations", "icons", "_meta"];
+export type ToolMetadata = DeepReadonly<Pick<ProtocolTool, (typeof TOOL_METADATA_KEYS)[number]>>;
+export interface ToolDefinition<Schema extends core.$ZodType, Result, Output extends core.$ZodType = never> extends ToolMetadata {
+    readonly input: Schema;
+    readonly output?: Output;
+    /** Raw handler; server invocation performs validation and result conversion. */
+    readonly execute: (input: core.output<Schema>, ctx: ToolContext) => Result;
+}
+/** Internal erased type for heterogeneous, schema-checked registrations. */
+export declare abstract class RegisteredTool {
+    abstract readonly input: core.$ZodType;
+    abstract readonly output?: core.$ZodType;
+    abstract readonly execute: (input: never, ctx: ToolContext) => unknown;
+    abstract readonly title?: string;
+    abstract readonly description?: string;
+    abstract readonly annotations?: NonNullable<ToolMetadata["annotations"]>;
+    abstract readonly icons?: NonNullable<ToolMetadata["icons"]>;
+    abstract readonly _meta?: NonNullable<ToolMetadata["_meta"]>;
+    /**
+     * Structural brand shared by package copies. Object spreads drop prototype
+     * methods, so modified spreads must pass through tool() again.
+     */
+    "~toolgrain"(): "tool@1";
+}
+/** Recognize definitions created by any compatible copy of this package. */
+export declare function isRegisteredTool(value: unknown): value is RegisteredTool;
+export declare class Tool<Schema extends core.$ZodType, Result, Output extends core.$ZodType = core.$ZodType> extends RegisteredTool {
+    readonly input: Schema;
+    readonly output?: Output;
+    readonly execute: (input: core.output<Schema>, ctx: ToolContext) => Result;
+    readonly title?: string;
+    readonly description?: string;
+    readonly annotations?: NonNullable<ToolMetadata["annotations"]>;
+    readonly icons?: NonNullable<ToolMetadata["icons"]>;
+    readonly _meta?: NonNullable<ToolMetadata["_meta"]>;
+    constructor(definition: ToolDefinition<Schema, Result, core.$ZodType>);
+}
+type OutputResult<Output extends core.$ZodType> = core.input<Output> | McpStructuredResult<core.input<Output>> | McpErrorResult<core.input<Output>>;
+type JsonSafeOutput<Result> = Result extends PromiseLike<infer Resolved> ? PromiseLike<JsonSafeOutput<Resolved>> : Result extends McpResult<infer Structured> ? IsJsonCompatible<Structured> extends true ? Result : never : JsonCompatible<Result>;
+type ToolDefinitionWithoutOutput<Schema extends core.$ZodType, Result> = Omit<ToolDefinition<Schema, Result>, "execute"> & {
+    readonly execute: (input: core.output<Schema>, ctx: ToolContext) => Result & JsonSafeOutput<Result>;
+};
+export declare function tool<Schema extends core.$ZodType, Output extends core.$ZodType, Result extends OutputResult<NoInfer<Output>> | PromiseLike<OutputResult<NoInfer<Output>>>>(definition: ToolDefinition<Schema, Result, Output> & {
+    readonly output: Output;
+}): Tool<Schema, Result, Output> & {
+    readonly output: Output;
+};
+export declare function tool<Schema extends core.$ZodType, Result>(definition: ToolDefinitionWithoutOutput<Schema, Result>): Tool<Schema, Result, never>;
+export {};
+//# sourceMappingURL=definition.d.ts.map

package/dist/tools/definition.d.ts.map

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

package/dist/tools/definition.js

@@ -0,0 +1,44 @@
+export const TOOL_METADATA_KEYS = [
+    "title",
+    "description",
+    "annotations",
+    "icons",
+    "_meta",
+];
+// Registered symbols let duplicate package copies recognize each other's tools.
+const TOOL_BRAND = Symbol.for("@toolgrain/mcp/tool@1");
+/** Internal erased type for heterogeneous, schema-checked registrations. */
+export class RegisteredTool {
+    /**
+     * Structural brand shared by package copies. Object spreads drop prototype
+     * methods, so modified spreads must pass through tool() again.
+     */
+    "~toolgrain"() {
+        return "tool@1";
+    }
+}
+Object.defineProperty(RegisteredTool.prototype, TOOL_BRAND, { value: true });
+/** Recognize definitions created by any compatible copy of this package. */
+export function isRegisteredTool(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[TOOL_BRAND] === true);
+}
+export class Tool extends RegisteredTool {
+    constructor(definition) {
+        super();
+        this.input = definition.input;
+        this.execute = definition.execute;
+        for (const key of ["output", ...TOOL_METADATA_KEYS]) {
+            const value = definition[key];
+            if (value !== undefined)
+                Object.defineProperty(this, key, { value, enumerable: true });
+        }
+        Object.freeze(this);
+    }
+}
+/** Define a reusable MCP tool. Its execute property remains the raw handler. */
+export function tool(definition) {
+    return new Tool(definition);
+}
+//# sourceMappingURL=definition.js.map

package/dist/tools/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/tools/definition.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,aAAa;IACb,aAAa;IACb,OAAO;IACP,OAAO;CACC,CAAC;AAiBX,gFAAgF;AAChF,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAEvD,4EAA4E;AAC5E,MAAM,OAAgB,cAAc;IAUlC;;;OAGG;IACH,YAAY;QACV,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AACD,MAAM,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAE7E,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAoC,CAAC,UAAU,CAAC,KAAK,IAAI,CAC3D,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,IAIX,SAAQ,cAAc;IAatB,YAAY,UAAyD;QACnE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,kBAAkB,CAAU,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS;gBACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF;AAwCD,gFAAgF;AAChF,MAAM,UAAU,IAAI,CAClB,UAAyD;IAEzD,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;AAC9B,CAAC"}

package/dist/tools/errors.d.ts

@@ -0,0 +1,11 @@
+import type * as core from "zod/v4/core";
+export declare class UnknownToolError extends Error {
+    readonly toolName: string;
+    constructor(toolName: string);
+}
+export declare class ToolInputError extends Error {
+    readonly toolName: string;
+    readonly issues: core.$ZodError["issues"];
+    constructor(toolName: string, cause: core.$ZodError);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/tools/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AAEzC,qBAAa,gBAAiB,SAAQ,KAAK;aACb,QAAQ,EAAE,MAAM;IAA5C,YAA4B,QAAQ,EAAE,MAAM,EAG3C;CACF;AAED,qBAAa,cAAe,SAAQ,KAAK;aAIrB,QAAQ,EAAE,MAAM;IAHlC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1C,YACkB,QAAQ,EAAE,MAAM,EAChC,KAAK,EAAE,IAAI,CAAC,SAAS,EAKtB;CACF"}

package/dist/tools/errors.js

@@ -0,0 +1,19 @@
+export class UnknownToolError extends Error {
+    toolName;
+    constructor(toolName) {
+        super(`Unknown tool: ${toolName}`);
+        this.toolName = toolName;
+        this.name = "UnknownToolError";
+    }
+}
+export class ToolInputError extends Error {
+    toolName;
+    issues;
+    constructor(toolName, cause) {
+        super(`Invalid input for tool: ${toolName}`, { cause });
+        this.toolName = toolName;
+        this.name = "ToolInputError";
+        this.issues = cause.issues;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/tools/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACb,QAAQ;IAApC,YAA4B,QAAgB;QAC1C,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;wBADT,QAAQ;QAElC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAIrB,QAAQ;IAHjB,MAAM,CAA2B;IAE1C,YACkB,QAAgB,EAChC,KAAqB;QAErB,KAAK,CAAC,2BAA2B,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;wBAHxC,QAAQ;QAIxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;CACF"}

package/dist/tools/json-value.d.ts

@@ -0,0 +1,15 @@
+import type { JSONValue } from "@toolgrain/protocol";
+/** Readonly authoring views of protocol data; wire types remain unchanged. */
+export type DeepReadonly<T> = T extends readonly (infer Item)[] ? readonly DeepReadonly<Item>[] : T extends object ? {
+    readonly [Key in keyof T]: DeepReadonly<T[Key]>;
+} : T;
+export type JsonCompatible<Value> = Value extends string | number | boolean | null ? Value : Value extends (...args: never[]) => unknown ? never : Value extends readonly (infer Item)[] ? readonly JsonCompatible<Item>[] : Value extends object ? {
+    [Key in keyof Value]: JsonCompatible<Value[Key]>;
+} : never;
+export type IsJsonCompatible<Value> = [Value] extends [JsonCompatible<Value>] ? true : false;
+export interface AssertJSONOptions {
+    /** Treat undefined object properties as absent, matching JSON serialization. */
+    readonly omitUndefined?: boolean;
+}
+export declare function assertJSON(value: unknown, options?: AssertJSONOptions, ancestors?: Set<object>): asserts value is JSONValue;
+//# sourceMappingURL=json-value.d.ts.map

package/dist/tools/json-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-value.d.ts","sourceRoot":"","sources":["../../src/tools/json-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,8EAA8E;AAC9E,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GAC3D,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GAC7B,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAAE,GACnD,CAAC,CAAC;AAER,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,KAAK,SACrC,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,KAAK,GACL,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GACzC,KAAK,GACL,KAAK,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GACnC,SAAS,cAAc,CAAC,IAAI,CAAC,EAAE,GAC/B,KAAK,SAAS,MAAM,GAClB;KAAG,GAAG,IAAI,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;CAAE,GACpD,KAAK,CAAC;AAEhB,MAAM,MAAM,gBAAgB,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GACzE,IAAI,GACJ,KAAK,CAAC;AAEV,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,iBAAsB,EAC/B,SAAS,cAAoB,GAC5B,OAAO,CAAC,KAAK,IAAI,SAAS,CA4C5B"}

package/dist/tools/json-value.js

@@ -0,0 +1,42 @@
+export function assertJSON(value, options = {}, ancestors = new Set()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return;
+    if (typeof value === "number" && Number.isFinite(value))
+        return;
+    if (typeof value !== "object" || value === null)
+        throw new Error("Tool output must be a JSON value");
+    if (ancestors.has(value))
+        throw new Error("Tool output contains a cycle");
+    const prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) &&
+        prototype !== Object.prototype &&
+        prototype !== null)
+        throw new Error("Tool output contains a non-JSON object instance");
+    ancestors.add(value);
+    try {
+        const keys = Reflect.ownKeys(value);
+        for (const key of keys) {
+            if (Array.isArray(value) && key === "length")
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (typeof key !== "string" ||
+                !descriptor?.enumerable ||
+                !("value" in descriptor))
+                throw new Error("Tool output contains a non-JSON property");
+            if (Array.isArray(value) &&
+                (!/^(0|[1-9]\d*)$/.test(key) || Number(key) >= value.length))
+                throw new Error("Tool output contains a non-JSON array property");
+            if (options.omitUndefined &&
+                !Array.isArray(value) &&
+                descriptor.value === undefined)
+                continue;
+            assertJSON(descriptor.value, options, ancestors);
+        }
+        if (Array.isArray(value) && keys.length !== value.length + 1)
+            throw new Error("Tool output contains a sparse array");
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+//# sourceMappingURL=json-value.js.map

package/dist/tools/json-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-value.js","sourceRoot":"","sources":["../../src/tools/json-value.ts"],"names":[],"mappings":"AAgCA,MAAM,UAAU,UAAU,CACxB,KAAc,EACd,OAAO,GAAsB,EAAE,EAC/B,SAAS,GAAG,IAAI,GAAG,EAAU;IAE7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAC3E,OAAO;IACT,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAC7C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,SAAS,KAAK,MAAM,CAAC,SAAS;QAC9B,SAAS,KAAK,IAAI;QAElB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,QAAQ;gBAAE,SAAS;YACvD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/D,IACE,OAAO,GAAG,KAAK,QAAQ;gBACvB,CAAC,UAAU,EAAE,UAAU;gBACvB,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC;gBAExB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC9D,IACE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACpB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC;gBAE5D,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,IACE,OAAO,CAAC,aAAa;gBACrB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACrB,UAAU,CAAC,KAAK,KAAK,SAAS;gBAE9B,SAAS;YACX,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC3D,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/tools/name.d.ts

@@ -0,0 +1,6 @@
+export declare class ToolNameError extends Error {
+    readonly toolName: string;
+    constructor(toolName: string);
+}
+export declare function validateToolName(name: string): void;
+//# sourceMappingURL=name.d.ts.map

package/dist/tools/name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../src/tools/name.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;aACV,QAAQ,EAAE,MAAM;IAA5C,YAA4B,QAAQ,EAAE,MAAM,EAK3C;CACF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGnD"}

package/dist/tools/name.js

@@ -0,0 +1,13 @@
+export class ToolNameError extends Error {
+    toolName;
+    constructor(toolName) {
+        super(`Invalid MCP tool name: ${JSON.stringify(toolName)}. Use 1–128 ASCII letters, digits, underscores, hyphens, or dots.`);
+        this.toolName = toolName;
+        this.name = "ToolNameError";
+    }
+}
+export function validateToolName(name) {
+    if (name.length < 1 || name.length > 128 || /[^A-Za-z0-9_.-]/.test(name))
+        throw new ToolNameError(name);
+}
+//# sourceMappingURL=name.js.map

package/dist/tools/name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.js","sourceRoot":"","sources":["../../src/tools/name.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACV,QAAQ;IAApC,YAA4B,QAAgB;QAC1C,KAAK,CACH,0BAA0B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,mEAAmE,CACtH,CAAC;wBAHwB,QAAQ;QAIlC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QACtE,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,14 @@
+import type { ToolContext } from "./context.js";
+import { type RegisteredTool, type ToolMetadata } from "./definition.js";
+export type ToolMap = Record<string, RegisteredTool>;
+export interface ToolEntry extends ToolMetadata {
+    name: string;
+    input: RegisteredTool["input"];
+    output?: NonNullable<RegisteredTool["output"]>;
+}
+export interface Registry {
+    list(): ToolEntry[];
+    execute(name: string, input: unknown, ctx: ToolContext): Promise<unknown>;
+}
+export declare function createRegistry(tools: ToolMap): Registry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAErD,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,IAAI,SAAS,EAAE,CAAC;IACpB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CA6BvD"}