@mcp-web/types 0.1.0

package/dist/mcp.d.ts

@@ -0,0 +1,60 @@
+import type { ListPromptsResult, ListResourcesResult, ListToolsResult } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+export declare const McpRequestMetaParamsSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    queryId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type McpRequestMetaParams = z.infer<typeof McpRequestMetaParamsSchema>;
+export interface AvailableSession {
+    session_id: string;
+    session_name: string | undefined;
+    origin: string;
+    page_title: string | undefined;
+    connected_at: string;
+    last_activity: string;
+    available_tools: string[];
+}
+/**
+ * Fatal error with no recoverable data.
+ * These should be thrown/sent as JSON-RPC errors.
+ */
+export interface FatalError {
+    error: string;
+    error_message: string;
+    error_is_fatal: true;
+    error_details?: string;
+}
+/**
+ * Recoverable error with partial data.
+ * These should be returned in the JSON-RPC result with isError: true.
+ * Includes [key: string]: unknown for context like available_sessions.
+ */
+export interface RecoverableError {
+    isError: true;
+    error: string;
+    error_message: string;
+    error_is_fatal: false;
+    [key: string]: unknown;
+}
+/**
+ * List tools result with recoverable error and session context.
+ */
+export type ErroredListToolsResult = ListToolsResult & RecoverableError & {
+    available_sessions: AvailableSession[];
+};
+/**
+ * List resources result with recoverable error and session context.
+ */
+export type ErroredListResourcesResult = ListResourcesResult & RecoverableError & {
+    available_sessions: AvailableSession[];
+};
+/**
+ * List prompts result with recoverable error and session context.
+ */
+export type ErroredListPromptsResult = ListPromptsResult & RecoverableError & {
+    available_sessions: AvailableSession[];
+};
+export declare function isErroredListToolsResult(result: ListToolsResult | ErroredListToolsResult): result is ErroredListToolsResult;
+export declare function isErroredListResourcesResult(result: ListResourcesResult | ErroredListResourcesResult): result is ErroredListResourcesResult;
+export declare function isErroredListPromptsResult(result: ListPromptsResult | ErroredListPromptsResult): result is ErroredListPromptsResult;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,IAAI,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,KAAK,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,gBAAgB,GAAG;IACxE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,GAAG,gBAAgB,GAAG;IAChF,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG;IAC5E,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;CACxC,CAAC;AASF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,sBAAsB,GAAG,MAAM,IAAI,sBAAsB,CAE3H;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,mBAAmB,GAAG,0BAA0B,GAAG,MAAM,IAAI,0BAA0B,CAE3I;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,wBAAwB,GAAG,MAAM,IAAI,wBAAwB,CAEnI"}

package/dist/mcp.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export const McpRequestMetaParamsSchema = z.object({
+    sessionId: z.string().optional(),
+    queryId: z.string().optional(),
+});
+/**
+ * Type guard to check if a list result is an errored result.
+ */
+function hasIsError(result) {
+    return 'isError' in result && result.isError === true;
+}
+export function isErroredListToolsResult(result) {
+    return hasIsError(result);
+}
+export function isErroredListResourcesResult(result) {
+    return hasIsError(result);
+}
+export function isErroredListPromptsResult(result) {
+    return hasIsError(result);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AA2DH;;GAEG;AACH,SAAS,UAAU,CAAC,MAAkJ;IACpK,OAAO,SAAS,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAgD;IACvF,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAwD;IACnG,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAoD;IAC7F,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+export declare const ProcessedContextItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodUnknown;
+    schema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        tool: "tool";
+        ephemeral: "ephemeral";
+    }>;
+}, z.core.$strip>;
+export declare const QuerySchema: z.ZodObject<{
+    uuid: z.ZodString;
+    prompt: z.ZodString;
+    context: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodUnknown;
+        schema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<{
+            tool: "tool";
+            ephemeral: "ephemeral";
+        }>;
+    }, z.core.$strip>>;
+    responseTool: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        inputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+        outputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    }, z.core.$strip>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        inputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+        outputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    }, z.core.$strip>>>;
+    restrictTools: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Wire-format query message schemas.
+ *
+ * These schemas represent messages sent over WebSocket between the bridge server and frontends.
+ * They are used for:
+ * - Bridge <-> Web communication (WebSocket messages)
+ * - Agent <-> Bridge communication (HTTP endpoints for progress/complete)
+ *
+ * Note: The web package (@mcp-web/core) has similar but slightly different schemas optimized
+ * for client-side consumption. These wire-format schemas are the source of truth for network
+ * communication.
+ */
+export declare const QueryMessageSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    prompt: z.ZodString;
+    context: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodUnknown;
+        schema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<{
+            tool: "tool";
+            ephemeral: "ephemeral";
+        }>;
+    }, z.core.$strip>>;
+    responseTool: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        inputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+        outputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    }, z.core.$strip>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        inputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+        outputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    }, z.core.$strip>>>;
+    restrictTools: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodDefault<z.ZodLiteral<"query">>;
+}, z.core.$strip>;
+export declare const QueryAcceptedMessageSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"query_accepted">>;
+    uuid: z.ZodString;
+}, z.core.$strip>;
+export declare const QueryProgressMessageSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"query_progress">>;
+    uuid: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const QueryCompleteBaseMessageSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"query_complete">>;
+    uuid: z.ZodString;
+}, z.core.$strip>;
+export declare const QueryCompleteClientMessageSchema: z.ZodObject<{
+    message: z.ZodString;
+    type: z.ZodDefault<z.ZodLiteral<"query_complete">>;
+    uuid: z.ZodString;
+}, z.core.$strip>;
+export declare const QueryCompleteBridgeMessageSchema: z.ZodObject<{
+    message: z.ZodOptional<z.ZodString>;
+    toolCalls: z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        arguments: z.ZodUnknown;
+        result: z.ZodUnknown;
+    }, z.core.$strip>>;
+    type: z.ZodDefault<z.ZodLiteral<"query_complete">>;
+    uuid: z.ZodString;
+}, z.core.$strip>;
+export declare const QueryFailureMessageSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"query_failure">>;
+    uuid: z.ZodString;
+    error: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const QueryCancelMessageSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"query_cancel">>;
+    uuid: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProcessedContextItem = z.infer<typeof ProcessedContextItemSchema>;
+export type Query = z.infer<typeof QuerySchema>;
+export type QueryMessage = z.output<typeof QueryMessageSchema>;
+export type QueryAcceptedMessage = z.output<typeof QueryAcceptedMessageSchema>;
+export type QueryProgressMessage = z.output<typeof QueryProgressMessageSchema>;
+export type QueryCompleteClientMessage = z.output<typeof QueryCompleteClientMessageSchema>;
+export type QueryCompleteBridgeMessage = z.output<typeof QueryCompleteBridgeMessageSchema>;
+export type QueryFailureMessage = z.output<typeof QueryFailureMessageSchema>;
+export type QueryCancelMessage = z.output<typeof QueryCancelMessageSchema>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,0BAA0B;;;;;;;;;iBAMrC,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOtB,CAAC;AAEH;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;iBAGzC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;iBAG3C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;iBAQ3C,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAC;AAGH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC/D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC/E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC/E,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC3F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC3F,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC7E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/query.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { ToolMetadataJsonSchema } from './tools.js';
+export const ProcessedContextItemSchema = z.object({
+    name: z.string(),
+    value: z.unknown(),
+    schema: z.custom().optional(),
+    description: z.string().optional(),
+    type: z.enum(['tool', 'ephemeral']),
+});
+export const QuerySchema = z.object({
+    uuid: z.string(),
+    prompt: z.string(),
+    context: z.array(ProcessedContextItemSchema),
+    responseTool: ToolMetadataJsonSchema.optional(),
+    tools: z.array(ToolMetadataJsonSchema).optional(),
+    restrictTools: z.boolean().optional()
+});
+/**
+ * Wire-format query message schemas.
+ *
+ * These schemas represent messages sent over WebSocket between the bridge server and frontends.
+ * They are used for:
+ * - Bridge <-> Web communication (WebSocket messages)
+ * - Agent <-> Bridge communication (HTTP endpoints for progress/complete)
+ *
+ * Note: The web package (@mcp-web/core) has similar but slightly different schemas optimized
+ * for client-side consumption. These wire-format schemas are the source of truth for network
+ * communication.
+ */
+export const QueryMessageSchema = z.object({
+    type: z.literal('query').default('query'),
+    ...QuerySchema.shape
+});
+export const QueryAcceptedMessageSchema = z.object({
+    type: z.literal('query_accepted').default('query_accepted'),
+    uuid: z.string()
+});
+export const QueryProgressMessageSchema = z.object({
+    type: z.literal('query_progress').default('query_progress'),
+    uuid: z.string(),
+    message: z.string(),
+});
+export const QueryCompleteBaseMessageSchema = z.object({
+    type: z.literal('query_complete').default('query_complete'),
+    uuid: z.string(),
+});
+export const QueryCompleteClientMessageSchema = z.object({
+    ...QueryCompleteBaseMessageSchema.shape,
+    message: z.string(),
+});
+export const QueryCompleteBridgeMessageSchema = z.object({
+    ...QueryCompleteBaseMessageSchema.shape,
+    message: z.string().optional(),
+    toolCalls: z.array(z.object({
+        tool: z.string(),
+        arguments: z.unknown(),
+        result: z.unknown()
+    })),
+});
+export const QueryFailureMessageSchema = z.object({
+    type: z.literal('query_failure').default('query_failure'),
+    uuid: z.string().describe('The query UUID'),
+    error: z.string().describe('The error code'),
+    reason: z.string().optional().describe('The reason for the failure'),
+});
+export const QueryCancelMessageSchema = z.object({
+    type: z.literal('query_cancel').default('query_cancel'),
+    uuid: z.string().describe('The query UUID to cancel'),
+    reason: z.string().optional().describe('The reason for the cancellation'),
+});
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

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

package/dist/resources.d.ts

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+/**
+ * Re-export MCP SDK's standard Resource type for convenience.
+ *
+ * This is the wire protocol type used for resource definitions in MCP communication.
+ */
+export type { Resource, ListResourcesResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Handler function for reading a resource.
+ * Returns the resource content as a string or binary data.
+ */
+export type ResourceReadHandler = () => string | Uint8Array | Promise<string> | Promise<Uint8Array>;
+/**
+ * Zod schema for resource definition validation.
+ */
+export declare const ResourceDefinitionSchema: z.ZodObject<{
+    uri: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    handler: z.ZodCustom<ResourceReadHandler, ResourceReadHandler>;
+}, z.core.$strip>;
+/**
+ * Resource definition for client-side use with handler.
+ *
+ * This is the primary type used when registering resources with MCPWeb.
+ */
+export interface ResourceDefinition {
+    /** Unique URI for the resource (e.g., "ui://app-name/resource.html") */
+    uri: string;
+    /** Human-readable name for the resource */
+    name: string;
+    /** Description of the resource (shown to AI) */
+    description?: string;
+    /** MIME type of the resource content */
+    mimeType?: string;
+    /** Handler function that returns the resource content */
+    handler: ResourceReadHandler;
+}
+/**
+ * Resource metadata without handler, for wire protocol transmission.
+ */
+export declare const ResourceMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    uri: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Resource metadata type (serializable, no handler) */
+export type ResourceMetadata = z.infer<typeof ResourceMetadataSchema>;
+/**
+ * Message sent from frontend to bridge to register a resource.
+ */
+export interface RegisterResourceMessage {
+    type: 'register-resource';
+    resource: ResourceMetadata;
+}
+/**
+ * Zod schema for register resource message validation.
+ */
+export declare const RegisterResourceMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"register-resource">;
+    resource: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        uri: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Message sent from bridge to frontend to request resource content.
+ */
+export interface ResourceReadMessage {
+    type: 'resource-read';
+    requestId: string;
+    uri: string;
+}
+/**
+ * Zod schema for resource read message validation.
+ */
+export declare const ResourceReadMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"resource-read">;
+    requestId: z.ZodString;
+    uri: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Message sent from frontend to bridge with resource content.
+ */
+export interface ResourceResponseMessage {
+    type: 'resource-response';
+    requestId: string;
+    content?: string;
+    blob?: string;
+    mimeType: string;
+    error?: string;
+}
+/**
+ * Zod schema for resource response message validation.
+ */
+export declare const ResourceResponseMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"resource-response">;
+    requestId: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    blob: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAExF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAC9B,MAAM,GACN,UAAU,GACV,OAAO,CAAC,MAAM,CAAC,GACf,OAAO,CAAC,UAAU,CAAC,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;iBAcnC,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAAmD,CAAC;AAEvF,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;iBAGxC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;iBAOxC,CAAC"}

package/dist/resources.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+/**
+ * Zod schema for resource definition validation.
+ */
+export const ResourceDefinitionSchema = z.object({
+    /** Unique URI for the resource (e.g., "ui://app-name/resource.html") */
+    uri: z.string().min(1, 'Resource URI is required'),
+    /** Human-readable name for the resource */
+    name: z.string().min(1, 'Resource name is required'),
+    /** Description of the resource (shown to AI) */
+    description: z.string().optional(),
+    /** MIME type of the resource content (defaults to text/html) */
+    mimeType: z.string().optional(),
+    /** Handler function that returns the resource content */
+    handler: z.custom((val) => typeof val === 'function', { message: 'Handler must be a function' }),
+});
+/**
+ * Resource metadata without handler, for wire protocol transmission.
+ */
+export const ResourceMetadataSchema = ResourceDefinitionSchema.omit({ handler: true });
+/**
+ * Zod schema for register resource message validation.
+ */
+export const RegisterResourceMessageSchema = z.object({
+    type: z.literal('register-resource'),
+    resource: ResourceMetadataSchema,
+});
+/**
+ * Zod schema for resource read message validation.
+ */
+export const ResourceReadMessageSchema = z.object({
+    type: z.literal('resource-read'),
+    requestId: z.string(),
+    uri: z.string(),
+});
+/**
+ * Zod schema for resource response message validation.
+ */
+export const ResourceResponseMessageSchema = z.object({
+    type: z.literal('resource-response'),
+    requestId: z.string(),
+    content: z.string().optional(),
+    blob: z.string().optional(),
+    mimeType: z.string(),
+    error: z.string().optional(),
+});
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,wEAAwE;IACxE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;IAClD,2CAA2C;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IACpD,gDAAgD;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,gEAAgE;IAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,yDAAyD;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,CACf,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,UAAU,EAClC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAC1C;CACF,CAAC,CAAC;AAoBH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAiBvF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACpC,QAAQ,EAAE,sBAAsB;CACjC,CAAC,CAAC;AAWH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAcH;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+/**
+ * Re-export MCP SDK's standard Tool type for convenience.
+ *
+ * This is the wire protocol type used for tool definitions in MCP communication.
+ * It differs from `ToolDefinition` which includes additional client-side
+ * properties like `handler` and `outputSchema` not in the MCP wire protocol.
+ */
+export type { ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+/** Schema for tool definitions with Zod schemas */
+export declare const ToolDefinitionZodSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    handler: z.ZodCustom<(...args: any[]) => any | Promise<any>, (...args: any[]) => any | Promise<any>>;
+    inputSchema: z.ZodOptional<z.ZodCustom<z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>>>;
+    outputSchema: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+}, z.core.$strip>;
+/** Tool definition type for tools with Zod schemas (inferred from schema) */
+export type ToolDefinitionZod = z.infer<typeof ToolDefinitionZodSchema>;
+/** Schema for tool definitions with JSON Schema */
+export declare const ToolDefinitionJsonSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    handler: z.ZodCustom<(...args: any[]) => any | Promise<any>, (...args: any[]) => any | Promise<any>>;
+    inputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    outputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+}, z.core.$strip>;
+/** Runtime validation schema that accepts either Zod or JSON Schema */
+export declare const ToolDefinitionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    handler: z.ZodCustom<(...args: any[]) => any | Promise<any>, (...args: any[]) => any | Promise<any>>;
+    inputSchema: z.ZodOptional<z.ZodCustom<z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>>>;
+    outputSchema: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    handler: z.ZodCustom<(...args: any[]) => any | Promise<any>, (...args: any[]) => any | Promise<any>>;
+    inputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    outputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+}, z.core.$strip>]>;
+/**
+ * Tool definition for client-side use with handler and optional schemas.
+ *
+ * This is the primary type used when registering tools with MCPWeb.
+ * Supports both Zod schemas (recommended) and JSON schemas.
+ */
+export interface ToolDefinition {
+    /** Unique name for the tool. */
+    name: string;
+    /** Description of what the tool does (shown to AI). */
+    description: string;
+    /** Function that executes the tool logic. */
+    handler: (input?: any) => any | Promise<any>;
+    /** Input parameter schema (Zod or JSON Schema). */
+    inputSchema?: z.ZodObject | Record<string, unknown>;
+    /** Output value schema (Zod or JSON Schema). */
+    outputSchema?: z.ZodType | Record<string, unknown>;
+    /**
+     * Tool metadata, forwarded to the MCP `tools/list` response.
+     * Used for MCP Apps to declare `_meta.ui.resourceUri`.
+     */
+    _meta?: Record<string, unknown>;
+}
+/**
+ * Tool metadata without handler, for wire protocol transmission.
+ * Schemas must be JSON Schema (not Zod) to be serializable.
+ */
+export declare const ToolMetadataZodSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodOptional<z.ZodCustom<z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>>>;
+    outputSchema: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+}, z.core.$strip>;
+/** Tool metadata type with Zod schemas. */
+export type ToolMetadataZod = z.infer<typeof ToolMetadataJsonSchema>;
+/** Tool metadata schema with JSON Schema format. */
+export declare const ToolMetadataJsonSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    outputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+}, z.core.$strip>;
+/** Tool metadata type with JSON schemas. */
+export type ToolMetadataJson = z.infer<typeof ToolMetadataJsonSchema>;
+/** Combined tool metadata schema accepting either format. */
+export declare const ToolMetadataSchema: z.ZodUnion<readonly [z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodOptional<z.ZodCustom<z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>>>;
+    outputSchema: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+    outputSchema: z.ZodOptional<z.ZodCustom<z.core.JSONSchema.JSONSchema, z.core.JSONSchema.JSONSchema>>;
+}, z.core.$strip>]>;
+/** Tool metadata type (either Zod or JSON Schema format). */
+export type ToolMetadata = z.infer<typeof ToolMetadataSchema>;
+/**
+ * Internal processed tool definition with both Zod and JSON schemas.
+ * @internal Used by MCPWeb for tool registration and validation.
+ */
+export type ProcessedToolDefinition = ToolDefinition & {
+    /** Zod schema for input validation (if using Zod). */
+    inputZodSchema?: z.ZodObject;
+    /** Zod schema for output validation (if using Zod). */
+    outputZodSchema?: z.ZodType;
+    /** JSON Schema for input (always available after processing). */
+    inputJsonSchema?: z.core.JSONSchema.JSONSchema;
+    /** JSON Schema for output (always available after processing). */
+    outputJsonSchema?: z.core.JSONSchema.JSONSchema;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAsChF,mDAAmD;AACnD,eAAO,MAAM,uBAAuB;;;mCAPN,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAA5B,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;;;iBAYxD,CAAC;AAEH,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,mDAAmD;AACnD,eAAO,MAAM,wBAAwB;;;mCAlBP,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAA5B,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;;;iBAuBxD,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,oBAAoB;;;mCA1BH,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAA5B,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;;;;;;mCAA5B,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAA5B,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;;;mBA0BsC,CAAC;AAEjG;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAE7C,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,mDAAmD;IACnD,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;iBAAkD,CAAC;AAErF,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAErE,oDAAoD;AACpD,eAAO,MAAM,sBAAsB;;;;;iBAAmD,CAAC;AAEvF,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB;;;;;;;;;;mBAA2D,CAAC;AAE3F,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,sDAAsD;IACtD,cAAc,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;IAC7B,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IAC5B,iEAAiE;IACjE,eAAe,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;IAC/C,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;CACjD,CAAA"}

package/dist/tools.js

@@ -0,0 +1,55 @@
+import { Ajv } from 'ajv';
+import { z } from 'zod';
+const ajv = new Ajv({ strict: false });
+const validateJsonSchema = (schema) => {
+    // Check if it's a JSON Schema
+    if (schema && typeof schema === 'object') {
+        // Allow schemas with explicit $schema to validate against their declared version
+        if ('$schema' in schema && schema.$schema) {
+            return ajv.validateSchema(schema);
+        }
+        // Default to Draft 7 for schemas without $schema
+        const schemaWithDraft = {
+            $schema: 'http://json-schema.org/draft-07/schema#',
+            ...schema
+        };
+        return ajv.validateSchema(schemaWithDraft);
+    }
+    return false;
+};
+/** Base schema for all tool definitions with common fields */
+const ToolDefinitionBaseSchema = z.object({
+    /** The name of the tool. */
+    name: z.string().min(1, 'Tool name is required'),
+    /** The description of the tool. */
+    description: z.string().min(1, 'Tool description is required'),
+    /** The function that handles the tool execution. */
+    // biome-ignore lint/suspicious/noExplicitAny: Can literally be anything
+    handler: z.custom((val) => typeof val === 'function', { message: "Handler must be a function" }),
+});
+/** Schema for tool definitions with Zod schemas */
+export const ToolDefinitionZodSchema = ToolDefinitionBaseSchema.extend({
+    /** The input schema for the tool (Zod object schema). */
+    inputSchema: z.instanceof(z.ZodObject).optional(),
+    /** The output schema for the tool (any Zod schema type). */
+    outputSchema: z.instanceof(z.ZodType).optional()
+});
+/** Schema for tool definitions with JSON Schema */
+export const ToolDefinitionJsonSchema = ToolDefinitionBaseSchema.extend({
+    /** The input schema for the tool (JSON Schema). */
+    inputSchema: z.custom(validateJsonSchema, { message: "Must be valid JSON Schema Draft 7" }).optional(),
+    /** The output schema for the tool (JSON Schema). */
+    outputSchema: z.custom(validateJsonSchema, { message: "Must be valid JSON Schema Draft 7" }).optional()
+});
+/** Runtime validation schema that accepts either Zod or JSON Schema */
+export const ToolDefinitionSchema = z.union([ToolDefinitionZodSchema, ToolDefinitionJsonSchema]);
+/**
+ * Tool metadata without handler, for wire protocol transmission.
+ * Schemas must be JSON Schema (not Zod) to be serializable.
+ */
+export const ToolMetadataZodSchema = ToolDefinitionZodSchema.omit({ handler: true });
+/** Tool metadata schema with JSON Schema format. */
+export const ToolMetadataJsonSchema = ToolDefinitionJsonSchema.omit({ handler: true });
+/** Combined tool metadata schema accepting either format. */
+export const ToolMetadataSchema = z.union([ToolMetadataZodSchema, ToolMetadataJsonSchema]);
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAkB,MAAM,KAAK,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAEvC,MAAM,kBAAkB,GAAG,CAAC,MAAe,EAA0C,EAAE;IACrF,8BAA8B;IAC9B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,iFAAiF;QACjF,IAAI,SAAS,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1C,OAAO,GAAG,CAAC,cAAc,CAAC,MAAmB,CAAY,CAAC;QAC5D,CAAC;QAED,iDAAiD;QACjD,MAAM,eAAe,GAAG;YACtB,OAAO,EAAE,yCAAyC;YAClD,GAAG,MAAM;SACV,CAAC;QAEF,OAAO,GAAG,CAAC,cAAc,CAAC,eAA4B,CAAY,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,4BAA4B;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IAChD,mCAAmC;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC;IAC9D,oDAAoD;IACpD,wEAAwE;IACxE,OAAO,EAAE,CAAC,CAAC,MAAM,CACf,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,UAAU,EAClC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAC1C;CACF,CAAC,CAAC;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC,MAAM,CAAC;IACrE,yDAAyD;IACzD,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;IACjD,4DAA4D;IAC5D,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAKH,mDAAmD;AACnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC,MAAM,CAAC;IACtE,mDAAmD;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,CAA+B,kBAAkB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpI,oDAAoD;IACpD,YAAY,EAAE,CAAC,CAAC,MAAM,CAA+B,kBAAkB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtI,CAAC,CAAC;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,uBAAuB,EAAE,wBAAwB,CAAC,CAAC,CAAC;AA2BjG;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAKrF,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAKvF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,qBAAqB,EAAE,sBAAsB,CAAC,CAAC,CAAC"}