@forumone/throughline 1.9.1 → 2.0.0-next-a30f5dd

package/dist/authoring/tools.js

@@ -0,0 +1,351 @@
+import { z } from 'zod';
+import { deniedEnvelope } from '../mcp/envelope.js';
+import { withMeta } from '../mcp/meta.js';
+import { formatZodIssues } from '../utils/zod-issues.js';
+import { editBlocksInput } from '../content/blocks.js';
+import { AUTHORING_TOOLS } from './descriptors.js';
+const PUBLISHER_ROLES = ['admin', 'editor'];
+export function defaultCanPublish(ctx) {
+    return Boolean(ctx.user?.roles.some((role) => PUBLISHER_ROLES.includes(role)));
+}
+/** Calls a module tool's handler, parsing the input against its own schema. */
+export async function delegate(inner, name, input, ctx) {
+    const tool = inner.definition(name);
+    if (!tool)
+        return { error: `This site does not offer that (${name} is off).` };
+    const parsed = tool.inputSchema.safeParse(withoutUndefined(input));
+    if (!parsed.success)
+        return { error: `Invalid input: ${formatZodIssues(parsed.error)}` };
+    return (await tool.handler(parsed.data, ctx));
+}
+function withoutUndefined(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
+}
+const id = z
+    .union([z.string(), z.number()])
+    .describe('The document id, as `find` or `get` gives it.');
+/* ------------------------------------------------------------------------ */
+function findTool(deps) {
+    const inputSchema = z.object({
+        query: z
+            .string()
+            .optional()
+            .describe('Words to match against titles (and slugs). Optional with `collection`, `kind` or `mine`.'),
+        collection: z
+            .string()
+            .optional()
+            .describe(`One content type to search, by slug: ${deps.contentTypes.join(', ')}. Without it, every content type is searched.`),
+        kind: z
+            .string()
+            .optional()
+            .describe(deps.kinds.length > 0
+            ? `Something to link or attach rather than a page: ${deps.kinds.join(', ')}.`
+            : 'Not available on this site.'),
+        where: z
+            .record(z.string(), z.union([z.string(), z.number(), z.boolean()]))
+            .optional()
+            .describe('With `kind`: exact values to filter on, by field, where the kind allows it.'),
+        mine: z.boolean().optional().describe('Your own unpublished drafts and scheduled publishes.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe('At most this many results. Default 10.'),
+    });
+    return {
+        ...AUTHORING_TOOLS.find,
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (input.kind) {
+                return delegate(deps.inner, 'find_related', { kind: input.kind, query: input.query, where: input.where, limit: input.limit }, ctx);
+            }
+            if (input.mine)
+                return delegate(deps.inner, 'list_my_work', {}, ctx);
+            if (input.collection) {
+                return delegate(deps.inner, 'find_documents', { collection: input.collection, query: input.query, limit: input.limit }, ctx);
+            }
+            if (!input.query) {
+                return { error: 'Give a `query`, or one of `collection`, `kind` or `mine`.' };
+            }
+            if (deps.inner.definition('search_content')) {
+                return delegate(deps.inner, 'search_content', { query: input.query, perCollection: input.limit }, ctx);
+            }
+            // No palette on this site: the content types one at a time.
+            const results = [];
+            for (const collection of deps.contentTypes) {
+                const found = await delegate(deps.inner, 'find_documents', { collection, query: input.query, limit: input.limit ?? 5 }, ctx);
+                if ('error' in found)
+                    return found;
+                for (const row of found['results'] ?? [])
+                    results.push({ collection, ...row });
+            }
+            return { query: input.query, results };
+        },
+    };
+}
+function getTool(deps) {
+    const inputSchema = z.object({
+        collection: z
+            .string()
+            .optional()
+            .describe(`The content type, by slug: ${deps.contentTypes.join(', ')}.`),
+        id: id.optional(),
+        draft: z
+            .boolean()
+            .optional()
+            .describe('With `id`: the latest draft (default) or, false, what is published.'),
+        versions: z
+            .boolean()
+            .optional()
+            .describe('With `id`: also list its ten most recent versions, for `publish` with action "rollback".'),
+    });
+    return {
+        ...AUTHORING_TOOLS.get,
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!input.collection) {
+                return {
+                    contentTypes: deps.contentTypes,
+                    kinds: deps.kinds,
+                    next: 'Call get with a collection to see what you can write to it.',
+                };
+            }
+            if (input.id === undefined) {
+                return delegate(deps.inner, 'describe_content_type', { collection: input.collection }, ctx);
+            }
+            const doc = await delegate(deps.inner, 'get_document', { collection: input.collection, id: input.id, draft: input.draft }, ctx);
+            if ('error' in doc || !input.versions)
+                return doc;
+            return {
+                ...doc,
+                versions: await recentVersions(deps.payload, input.collection, input.id, ctx),
+            };
+        },
+    };
+}
+/** The document's recent versions, as the caller may read them. */
+async function recentVersions(payload, collection, parent, ctx) {
+    const found = await payload.findVersions({
+        collection: collection,
+        where: { parent: { equals: parent } },
+        sort: '-updatedAt',
+        limit: 10,
+        depth: 0,
+        overrideAccess: false,
+        ...(ctx.user ? { user: ctx.user } : {}),
+    });
+    return found.docs.map((version) => {
+        const v = version;
+        return {
+            versionId: String(v['id']),
+            updatedAt: v['updatedAt'],
+            status: v.version?.['_status'] ?? null,
+            ...(v['autosave'] ? { autosave: true } : {}),
+        };
+    });
+}
+function saveDraftTool(deps) {
+    const inputSchema = withMeta({
+        collection: z.string().describe(`The content type, by slug: ${deps.contentTypes.join(', ')}.`),
+        id: id.optional().describe('The document to change. Omit to create a new one.'),
+        data: z
+            .record(z.string(), z.unknown())
+            .describe('The fields to set, by name, as `get` with only `collection` lists them. When changing, only the fields to change.'),
+    });
+    return {
+        ...AUTHORING_TOOLS.saveDraft,
+        inputSchema,
+        handler: async (input, ctx) => input.id === undefined
+            ? delegate(deps.inner, 'create_draft', { collection: input.collection, data: input.data, _meta: input._meta }, ctx)
+            : delegate(deps.inner, 'update_draft', { collection: input.collection, id: input.id, patch: input.data, _meta: input._meta }, ctx),
+    };
+}
+function editBlocksTool(deps) {
+    // The content module's own schema, so the two cannot disagree about what validates.
+    return {
+        ...AUTHORING_TOOLS.editBlocks,
+        inputSchema: editBlocksInput,
+        handler: (input, ctx) => delegate(deps.inner, 'edit_blocks', input, ctx),
+    };
+}
+function checkTool(deps) {
+    const inputSchema = z.object({
+        collection: z.string().describe('The content type, by slug.'),
+        id,
+    });
+    return {
+        ...AUTHORING_TOOLS.check,
+        inputSchema,
+        handler: (input, ctx) => delegate(deps.inner, 'get_publish_status', { collection: input.collection, id: String(input.id) }, ctx),
+    };
+}
+const LIVE_ACTIONS = new Set(['now', 'schedule', 'unpublish', 'rollback']);
+function publishTool(deps) {
+    const canPublish = deps.canPublish ?? defaultCanPublish;
+    const groups = deps.approverGroups.map((group) => group.slug);
+    const approval = z
+        .object({
+        changesSummary: z
+            .string()
+            .min(20)
+            .describe('What changed and why, for the approvers. At least 20 characters.'),
+        approverGroups: z
+            .array(z.string())
+            .min(1)
+            .describe(groups.length > 0
+            ? `Who should approve: one or more of ${groups.join(', ')}.`
+            : 'Approvals are off on this site.'),
+        reason: z.string().optional().describe('Why it needs approving now, if there is a deadline.'),
+    })
+        .describe('For "request_approval", or for "now" on a document that needs approval: who to ask, and what to tell them.');
+    const inputSchema = withMeta({
+        collection: z.string().describe('The content type, by slug.'),
+        id,
+        action: z
+            .enum(['now', 'schedule', 'unpublish', 'rollback', 'request_approval'])
+            .describe('What to do. See the tool description.'),
+        at: z
+            .string()
+            .datetime({ offset: true })
+            .optional()
+            .describe('For "schedule": when, as an ISO 8601 date and time with an offset, e.g. 2026-11-02T09:00:00-05:00.'),
+        versionId: z
+            .union([z.string(), z.number()])
+            .optional()
+            .describe('For "rollback": the version to restore, from `get` with `versions`.'),
+        approval: approval.optional(),
+    });
+    return {
+        ...AUTHORING_TOOLS.publish,
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!ctx.user)
+                return deniedEnvelope('Publishing needs a signed-in person behind the key.');
+            if (LIVE_ACTIONS.has(input.action) && !canPublish(ctx)) {
+                return deniedEnvelope(`Taking something live needs an editor or an admin, and ${ctx.user.name ?? ctx.user.email} is ${ctx.user.roles.join(', ') || 'neither'}. ` +
+                    'Use action "request_approval" to ask someone who can.');
+            }
+            const target = { collection: input.collection, id: String(input.id), _meta: input._meta };
+            const requestApproval = (a) => delegate(deps.inner, 'request_approval', {
+                ...target,
+                changesSummary: a.changesSummary,
+                approverGroups: a.approverGroups,
+                requestReason: a.reason,
+            }, ctx);
+            switch (input.action) {
+                case 'now': {
+                    const outcome = await delegate(deps.inner, 'publish', target, ctx);
+                    if (outcome['code'] !== 'approval-required')
+                        return outcome;
+                    if (input.approval) {
+                        return {
+                            published: false,
+                            approvalRequired: true,
+                            approvalRequest: await requestApproval(input.approval),
+                        };
+                    }
+                    return {
+                        ...outcome,
+                        approvalRequired: true,
+                        next: 'This needs approval before it can go live. Ask the person who should approve it, then call publish with action "request_approval" and ' +
+                            `approval: { changesSummary, approverGroups${groups.length > 0 ? ` (one or more of ${groups.join(', ')})` : ''} }.`,
+                    };
+                }
+                case 'schedule':
+                    if (!input.at)
+                        return { error: 'Scheduling needs `at`: when to publish.' };
+                    return delegate(deps.inner, 'schedule_publish', { ...target, publishAt: input.at }, ctx);
+                case 'unpublish':
+                    return delegate(deps.inner, 'unpublish', target, ctx);
+                case 'rollback':
+                    if (!input.versionId)
+                        return { error: 'A rollback needs `versionId`. `get` with `versions` lists them.' };
+                    return delegate(deps.inner, 'rollback', { ...target, versionId: String(input.versionId) }, ctx);
+                case 'request_approval':
+                    if (!input.approval)
+                        return { error: 'A request needs `approval`: { changesSummary, approverGroups }.' };
+                    return requestApproval(input.approval);
+            }
+        },
+    };
+}
+function designGuideTool(deps) {
+    const inputSchema = z.object({
+        intent: z
+            .string()
+            .min(5)
+            .optional()
+            .describe('What the person wants a section or page to do, in their words. Returns the components that suit it, ranked.'),
+        existingBlocks: z
+            .array(z.string())
+            .optional()
+            .describe('With `intent`: the block types already on the page, so suggestions that would clash are flagged.'),
+        component: z.string().optional().describe('A component by name, for its full contract.'),
+        recipes: z
+            .boolean()
+            .optional()
+            .describe('The primitives and inline components a composed section may be built from.'),
+        category: z
+            .string()
+            .optional()
+            .describe('With none of the others: list only this category, e.g. "hero", "cta".'),
+    });
+    return {
+        ...AUTHORING_TOOLS.designGuide,
+        inputSchema,
+        handler: (input, ctx) => {
+            if (input.component)
+                return delegate(deps.inner, 'get_contract', { name: input.component }, ctx);
+            if (input.intent) {
+                return delegate(deps.inner, 'suggest_for_intent', {
+                    intent: input.intent,
+                    ...(input.existingBlocks ? { context: { existingBlocks: input.existingBlocks } } : {}),
+                }, ctx);
+            }
+            if (input.recipes)
+                return delegate(deps.inner, 'get_recipe_vocabulary', {}, ctx);
+            return delegate(deps.inner, 'list_components', { category: input.category }, ctx);
+        },
+    };
+}
+function composeSectionTool(deps) {
+    const inputSchema = withMeta({
+        contract: z
+            .record(z.string(), z.unknown())
+            .describe("The section's contract: its name, intent and content fields."),
+        tree: z
+            .record(z.string(), z.unknown())
+            .describe("What it renders: primitives and inline components, binding their content to the contract's fields."),
+        save: z
+            .boolean()
+            .optional()
+            .describe('Save it as a draft recipe once it passes. Default: only check it.'),
+        id: z
+            .union([z.string(), z.number()])
+            .optional()
+            .describe('With `save`: the draft recipe to replace.'),
+    });
+    return {
+        ...AUTHORING_TOOLS.composeSection,
+        inputSchema,
+        handler: (input, ctx) => input.save
+            ? delegate(deps.inner, 'save_recipe', { contract: input.contract, tree: input.tree, id: input.id, _meta: input._meta }, ctx)
+            : delegate(deps.inner, 'validate_recipe', { contract: input.contract, tree: input.tree, _meta: input._meta }, ctx),
+    };
+}
+/** The eight, in the order a client lists them. */
+export function createAuthoringTools(deps) {
+    return [
+        findTool(deps),
+        getTool(deps),
+        saveDraftTool(deps),
+        editBlocksTool(deps),
+        checkTool(deps),
+        publishTool(deps),
+        designGuideTool(deps),
+        composeSectionTool(deps),
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/authoring/tools.js.map

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

package/dist/content/blocks.d.ts

@@ -20,6 +20,10 @@ export declare const CONTENT_BLOCK_TOOLS: {
         readonly name: "remove_block";
         readonly description: "Removes one block from a draft's blocks field, by its id. Checked against the composition rules, since a block may be another's required sibling.";
     };
+    readonly editBlocks: {
+        readonly name: "edit_blocks";
+        readonly description: "Changes the blocks in one blocks field of a draft (`layout`, or e.g. `approach.blocks`): insert, update, move and remove, as a list applied in order and saved together. Each new or changed block is checked against what the field accepts and its own validation, and the result against the composition rules, before anything is saved. Block ids come from get. To replace the whole field, use save_draft.";
+    };
 };
 export declare const CONTENT_BLOCK_TOOL_DESCRIPTORS: readonly McpToolDescriptor[];
 type BlocksField = Extract<Field, {
@@ -225,6 +229,158 @@ export declare function createInsertBlockTool(deps: ContentWriteDeps): McpToolDe
 export declare function createUpdateBlockTool(deps: ContentWriteDeps): McpToolDefinition<typeof updateInput>;
 export declare function createMoveBlockTool(deps: ContentWriteDeps): McpToolDefinition<typeof moveInput>;
 export declare function createRemoveBlockTool(deps: ContentWriteDeps): McpToolDefinition<typeof removeInput>;
+export declare const editBlocksInput: z.ZodObject<{
+    operations: z.ZodArray<z.ZodDiscriminatedUnion<"op", [z.ZodObject<{
+        after: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+        op: z.ZodLiteral<"insert">;
+        block: z.ZodObject<{
+            blockType: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            blockType: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            blockType: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>;
+    }, "strip", z.ZodTypeAny, {
+        block: {
+            blockType: string;
+        } & {
+            [k: string]: unknown;
+        };
+        op: "insert";
+        position?: "start" | "end" | undefined;
+        after?: string | undefined;
+    }, {
+        block: {
+            blockType: string;
+        } & {
+            [k: string]: unknown;
+        };
+        op: "insert";
+        position?: "start" | "end" | undefined;
+        after?: string | undefined;
+    }>, z.ZodObject<{
+        op: z.ZodLiteral<"update">;
+        blockId: z.ZodString;
+        patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        patch: Record<string, unknown>;
+        blockId: string;
+        op: "update";
+    }, {
+        patch: Record<string, unknown>;
+        blockId: string;
+        op: "update";
+    }>, z.ZodObject<{
+        after: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+        op: z.ZodLiteral<"move">;
+        blockId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        blockId: string;
+        op: "move";
+        position?: "start" | "end" | undefined;
+        after?: string | undefined;
+    }, {
+        blockId: string;
+        op: "move";
+        position?: "start" | "end" | undefined;
+        after?: string | undefined;
+    }>, z.ZodObject<{
+        op: z.ZodLiteral<"remove">;
+        blockId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        blockId: string;
+        op: "remove";
+    }, {
+        blockId: string;
+        op: "remove";
+    }>]>, "many">;
+    collection: z.ZodString;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    field: z.ZodString;
+} & {
+    _meta: z.ZodOptional<z.ZodObject<{
+        userPrompt: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+        changesSummary: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }, {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    id: string | number;
+    field: string;
+    operations: ({
+        block: {
+            blockType: string;
+        } & {
+            [k: string]: unknown;
+        };
+        op: "insert";
+        position?: "start" | "end" | undefined;
+        after?: string | undefined;
+    } | {
+        patch: Record<string, unknown>;
+        blockId: string;
+        op: "update";
+    } | {
+        blockId: string;
+        op: "move";
+        position?: "start" | "end" | undefined;
+        after?: string | undefined;
+    } | {
+        blockId: string;
+        op: "remove";
+    })[];
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+}, {
+    collection: string;
+    id: string | number;
+    field: string;
+    operations: ({
+        block: {
+            blockType: string;
+        } & {
+            [k: string]: unknown;
+        };
+        op: "insert";
+        position?: "start" | "end" | undefined;
+        after?: string | undefined;
+    } | {
+        patch: Record<string, unknown>;
+        blockId: string;
+        op: "update";
+    } | {
+        blockId: string;
+        op: "move";
+        position?: "start" | "end" | undefined;
+        after?: string | undefined;
+    } | {
+        blockId: string;
+        op: "remove";
+    })[];
+    _meta?: {
+        reasoning?: string | undefined;
+        changesSummary?: string | undefined;
+        userPrompt?: string | undefined;
+    } | undefined;
+}>;
+/**
+ * Several block operations on one field, checked and saved as one: the four
+ * single-block tools, as a list. forumone-2026#830.
+ */
+export declare function createEditBlocksTool(deps: ContentWriteDeps): McpToolDefinition<typeof editBlocksInput>;
 export declare function createContentBlockTools(deps: ContentWriteDeps): McpToolDefinition[];
 export {};
 //# sourceMappingURL=blocks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/content/blocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAyB,KAAK,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAY5D,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAe3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAqBsB,CAAA;AAEtD,eAAO,MAAM,8BAA8B,EAAE,SAAS,iBAAiB,EACnC,CAAA;AAEpC,KAAK,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAErD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAWlF;AAqBD,yEAAyE;AACzE,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAyBD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOf,CAAA;AACF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIf,CAAA;AACF,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIb,CAAA;AACF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGf,CAAA;AAmHF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAmBnG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CA2BnG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAqB/F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAgBnG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,EAAE,CAOnF"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/content/blocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAyB,KAAK,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAM5D,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAe3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;CA0BsB,CAAA;AAEtD,eAAO,MAAM,8BAA8B,EAAE,SAAS,iBAAiB,EACnC,CAAA;AAEpC,KAAK,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAErD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAWlF;AAqBD,yEAAyE;AACzE,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AA4BD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOf,CAAA;AACF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIf,CAAA;AACF,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIb,CAAA;AACF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGf,CAAA;AA4NF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,gBAAgB,GACrB,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAUvC;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,gBAAgB,GACrB,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAUvC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAU/F;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,gBAAgB,GACrB,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAUvC;AA6BD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS1B,CAAA;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,GACrB,iBAAiB,CAAC,OAAO,eAAe,CAAC,CAyB3C;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,EAAE,CAQnF"}