@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/capabilities/finish-storyboard.js

@@ -0,0 +1,278 @@
+import { createHash } from "node:crypto";
+import { measureStoryboardAssetSizes, measureStoryboardSources } from "./storyboard-measured-sources.js";
+import { isRecord } from "@nodetool-ai/protocol";
+import { budgetFromContext } from "@nodetool-ai/runtime";
+import { finishStoryboardSpec, layoutStoryboardSpec, previewStoryboardDesignSpec } from "./storyboards.specs.js";
+const isModelRef = (value) => isRecord(value) && typeof value["provider"] === "string" && !!value["provider"].trim() && typeof value["id"] === "string" && !!value["id"].trim();
+/**
+ * "preview" returns the deterministic design in memory. "finish" saves the cut,
+ * agentic or not. "layout" saves an agent-composed static layout, which a
+ * later finish keeps while it authors the motion.
+ */
+async function materializeAuthorizedStoryboard(run, params, mode) {
+    const previewOnly = mode === "preview";
+    const strategy = mode === "layout" ? "agentic" : params["strategy"] ?? "deterministic";
+    if (strategy !== "deterministic" && strategy !== "agentic") {
+        return { error: "Unsupported finishing strategy." };
+    }
+    const explicitModel = params["model"];
+    if (explicitModel !== undefined && !isModelRef(explicitModel)) {
+        return { error: "Finishing model must have a non-empty provider and id." };
+    }
+    const imageModel = params["imageModel"];
+    if (imageModel !== undefined && !isModelRef(imageModel)) {
+        return { error: "Image model must have a non-empty provider and id." };
+    }
+    if (strategy === "agentic" && !explicitModel && !run.subAgent) {
+        return { error: "Agentic finishing requires an explicit model reference or the session's provider and model." };
+    }
+    const signal = run.signal ?? run.context.signal;
+    signal?.throwIfAborted();
+    const userId = run.context.userId;
+    if (!userId)
+        return { error: "No user is bound to this session." };
+    const { findFinishResourceIds, Storyboard, TimelineSequence, Asset, entityFromAsset, commitFinishedStoryboard } = await import("@nodetool-ai/models");
+    const { materializeStoryboard, stableSerialize, activeStoryboardGraphics, shotSources, resolveShotSource, validateStoryboardSemantics, frameSizeForAspect, makeSequence } = await import("@nodetool-ai/timeline");
+    const { resolveEffectiveProductionRequirement } = await import("@nodetool-ai/protocol");
+    const boardId = String(params["storyboardId"] ?? "");
+    const boardRows = await findFinishResourceIds("storyboard", boardId, userId, run.projectId);
+    if (boardRows.length !== 1)
+        return { error: boardRows.length ? "Storyboard prefix is ambiguous." : "Storyboard was not found." };
+    const board = await Storyboard.findById(boardRows[0]);
+    if (!board)
+        return { error: "Storyboard was not found." };
+    if (run.projectId && run.projectId !== board.project_id)
+        return { error: "Storyboard was not found in this project." };
+    if (board.revision !== params["expectedStoryboardRevision"])
+        return { error: "Storyboard revision conflict." };
+    const doc = board.toDocument();
+    let shots = structuredClone(doc.shots).map((shot) => ({ ...shot, production: resolveEffectiveProductionRequirement(undefined, shot.production) }));
+    const assets = new Set();
+    const assetContentTypes = new Map();
+    const entities = new Set();
+    const resolveAssetId = async (id) => {
+        const matches = await findFinishResourceIds("asset", id, userId);
+        if (matches.length !== 1)
+            throw new Error(matches.length ? `Asset prefix ${id} is ambiguous.` : `Asset ${id} is unavailable.`);
+        return matches[0];
+    };
+    const sources = shotSources(shots, { requireRendered: false });
+    try {
+        for (const shot of shots) {
+            for (const protection of shot.production?.protected_inputs ?? []) {
+                if (protection.asset_id)
+                    protection.asset_id = await resolveAssetId(protection.asset_id);
+                if (protection.entity_id)
+                    protection.entity_id = await resolveAssetId(protection.entity_id);
+            }
+            for (const element of activeStoryboardGraphics(shot)) {
+                if (element.asset_id)
+                    element.asset_id = await resolveAssetId(element.asset_id);
+                if (element.entity_id)
+                    element.entity_id = await resolveAssetId(element.entity_id);
+            }
+            const source = resolveShotSource(shot, undefined, sources.get(shot.id)?.assetId);
+            if (source && source.kind !== "graphics") {
+                const canonical = await resolveAssetId(source.assetId);
+                if (source.kind === "still" && shot.keyframe)
+                    shot.keyframe.asset_id = canonical;
+                if (source.kind === "video" && shot.clip)
+                    shot.clip.asset_id = canonical;
+                source.assetId = canonical;
+            }
+            const selectedAssetId = source && source.kind !== "graphics" ? source.assetId : undefined;
+            const protectionsById = new Map((shot.production?.protected_inputs ?? []).map((input) => [input.id, input]));
+            const imageIds = new Set((shot.production?.protected_inputs ?? []).filter((input) => ["product", "logo"].includes(input.kind)).map((input) => input.asset_id));
+            if (source?.kind === "still") {
+                imageIds.add(source.assetId);
+            }
+            for (const element of activeStoryboardGraphics(shot)) {
+                if (element.kind === "asset") {
+                    imageIds.add(element.asset_id);
+                    if (element.protected_input_id) {
+                        imageIds.add(protectionsById.get(element.protected_input_id)?.asset_id);
+                    }
+                }
+            }
+            const refs = [selectedAssetId, ...(shot.production?.protected_inputs ?? []).map((input) => input.asset_id), ...(activeStoryboardGraphics(shot)).map((element) => element.asset_id)];
+            for (const id of refs) {
+                if (!id) {
+                    continue;
+                }
+                let contentType = assetContentTypes.get(id);
+                if (!contentType) {
+                    const asset = await Asset.get(id);
+                    if (asset?.user_id !== userId) {
+                        return { error: `Asset ${id} is unavailable.` };
+                    }
+                    contentType = asset.content_type;
+                    assets.add(id);
+                    assetContentTypes.set(id, contentType);
+                }
+                if (imageIds.has(id) && !contentType.startsWith("image/")) {
+                    return { error: `Asset ${id} must be an image for this editable graphics/still layer.` };
+                }
+                if (source?.kind === "video" && selectedAssetId === id && !contentType.startsWith("video/")) {
+                    return { error: `Asset ${id} must be a video for this selected shot source.` };
+                }
+            }
+            for (const element of activeStoryboardGraphics(shot)) {
+                const protection = element.protected_input_id ? shot.production?.protected_inputs?.find((input) => input.id === element.protected_input_id) : undefined;
+                const entityId = element.entity_id ?? protection?.entity_id;
+                if (!entityId)
+                    continue;
+                const row = await Asset.get(entityId);
+                const entity = row?.user_id === userId ? entityFromAsset(row) : null;
+                if (!entity)
+                    return { error: `Entity ${entityId} is unavailable or is not an entity.` };
+                const rawReferenceId = entity.reference_images?.[0]?.asset_id;
+                const referenceId = rawReferenceId ? await resolveAssetId(rawReferenceId) : undefined;
+                if (!referenceId)
+                    return { error: `Entity ${entityId} has no reference image.` };
+                const reference = await Asset.get(referenceId);
+                if (reference?.user_id !== userId || !reference.content_type.startsWith("image/"))
+                    return { error: `Entity reference image ${referenceId} is unavailable.` };
+                entities.add(entityId);
+                assets.add(referenceId);
+                if (element.kind === "asset" && !element.asset_id)
+                    element.asset_id = referenceId;
+                if (protection && !protection.asset_id && ["product", "logo", "source_asset"].includes(protection.kind))
+                    protection.asset_id = referenceId;
+            }
+        }
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+    const semanticErrors = validateStoryboardSemantics(shots, doc.screenplay, { assetIds: assets, entityIds: entities });
+    if (semanticErrors.length)
+        return { error: "Storyboard cannot be finished.", validation: semanticErrors };
+    const requestedTimelineId = previewOnly ? undefined : params["timelineId"] ?? board.timeline_id;
+    let timeline;
+    if (requestedTimelineId) {
+        const id = String(requestedTimelineId);
+        const rows = await findFinishResourceIds("timeline", id, userId, board.project_id);
+        if (rows.length !== 1)
+            return { error: rows.length ? "Timeline prefix is ambiguous." : "Timeline was not found in this project." };
+        timeline = await TimelineSequence.findById(rows[0]) ?? undefined;
+        if (!timeline)
+            return { error: "Timeline was not found." };
+        if (timeline.revision !== params["expectedTimelineRevision"])
+            return { error: "Timeline revision conflict. Supply expectedTimelineRevision for an existing result." };
+    }
+    else if (params["expectedTimelineRevision"] !== undefined)
+        return { error: "expectedTimelineRevision requires an existing timeline." };
+    let script;
+    let linkedScriptFingerprint = "";
+    if (doc.screenplay?.script_id) {
+        const { Script } = await import("@nodetool-ai/models");
+        const row = await Script.findById(doc.screenplay.script_id);
+        if (!row || row.user_id !== userId) {
+            return { error: "Linked script is unavailable." };
+        }
+        const scriptDoc = row.toDocument();
+        script = { scriptId: row.id, cast: scriptDoc.cast, sections: scriptDoc.sections };
+        linkedScriptFingerprint = createHash("sha256").update(stableSerialize(script)).digest("hex");
+        if (!previewOnly && params["expectedLinkedScriptFingerprint"] !== linkedScriptFingerprint) {
+            return { error: "Linked script changed or has not been reviewed. Refresh the design preview before finishing." };
+        }
+        for (const section of script.sections) {
+            for (const line of section.lines) {
+                const take = line.takes.find((value) => value.id === line.currentTakeId);
+                if (!take) {
+                    continue;
+                }
+                const asset = await Asset.get(take.assetId);
+                if (!asset || asset.user_id !== userId || !asset.content_type.startsWith("audio/")) {
+                    return { error: "Linked script audio is unavailable." };
+                }
+            }
+        }
+    }
+    shots = await measureStoryboardSources(shots, run.context, signal);
+    const assetSizes = await measureStoryboardAssetSizes(shots, run.context, signal);
+    const size = frameSizeForAspect(doc.aspectRatio ?? "9:16");
+    const result = materializeStoryboard({ boardId: board.id, shots, script, assetSizes, width: timeline?.width ?? size.width, height: timeline?.height ?? size.height, motionDesign: doc.screenplay?.motion_design, current: timeline ? JSON.parse(timeline.document) : undefined });
+    if (result.validation.length)
+        return { error: `Produced Timeline violates production requirements: ${result.validation.map((issue) => issue.message).join(" ")}`, validation: result.validation };
+    const { validateTimelineSequence } = await import("@nodetool-ai/execution/timeline-debug");
+    const structural = validateTimelineSequence(result.document, { fps: timeline?.fps ?? 30, width: timeline?.width ?? size.width, height: timeline?.height ?? size.height });
+    if (!structural.ok)
+        return { error: "Produced Timeline is structurally invalid.", validation: structural };
+    if (previewOnly) {
+        return { timeline: { type: "timeline", data: makeSequence({ ...result.document, id: board.id, projectId: board.project_id, name: `Design preview: ${board.name}`, width: size.width, height: size.height, fps: 30, durationMs: result.durationMs }) }, storyboardRevision: board.revision, linkedScriptFingerprint, validation: [] };
+    }
+    try {
+        let document = result.document;
+        let reviews;
+        let costUsd;
+        let decorations = [];
+        let findings;
+        if (strategy === "agentic") {
+            const { finishStoryboardAgentically } = await import("./agentic-storyboard-finish.js");
+            const runtime = isModelRef(explicitModel)
+                ? { provider: await run.context.getProvider(explicitModel.provider), model: explicitModel.id, budget: run.budget ?? budgetFromContext(run.context) }
+                : run.subAgent;
+            if (!runtime) {
+                return { error: "No finishing model is bound to this run." };
+            }
+            const candidate = await finishStoryboardAgentically(run, { boardId: board.id, shots, script, assetSizes, width: timeline?.width ?? size.width, height: timeline?.height ?? size.height, motionDesign: doc.screenplay?.motion_design, current: timeline?.toDocument() }, doc, timeline ?? new TimelineSequence({ user_id: userId, project_id: board.project_id, name: board.name, width: size.width, height: size.height, duration_ms: result.durationMs, document: JSON.stringify(result.document) }), result.document, runtime, { phase: mode === "layout" ? "layout" : "finish", ...(imageModel !== undefined && { imageModel }) });
+            document = candidate.document;
+            reviews = candidate.reviews;
+            costUsd = candidate.costUsd;
+            decorations = candidate.decorations;
+            if (candidate.needsReview) {
+                findings = candidate.findings ?? [];
+            }
+        }
+        signal?.throwIfAborted();
+        run.context.signal?.throwIfAborted();
+        if (script) {
+            const { Script } = await import("@nodetool-ai/models");
+            const latest = await Script.findById(script.scriptId);
+            const latestDoc = latest?.toDocument();
+            const latestFingerprint = latestDoc ? createHash("sha256").update(stableSerialize({ scriptId: script.scriptId, cast: latestDoc.cast, sections: latestDoc.sections })).digest("hex") : "";
+            if (latest?.user_id !== userId || latestFingerprint !== linkedScriptFingerprint) {
+                return { error: "Linked script changed during finishing. Refresh the design preview before finishing again." };
+            }
+        }
+        // Generated decoration is new source media, so the board names it too.
+        // The next finish materializes it like any other element.
+        let boardDocument;
+        if (decorations.length) {
+            const stored = JSON.parse(board.document);
+            const storedShots = isRecord(stored) && Array.isArray(stored["shots"]) ? stored["shots"] : [];
+            for (const decoration of decorations) {
+                const shot = storedShots.find((value) => isRecord(value) && value["id"] === decoration.shotId);
+                if (!isRecord(shot)) {
+                    return { error: `Shot ${decoration.shotId} disappeared before the layout was saved.` };
+                }
+                const graphics = isRecord(shot["graphics"]) ? shot["graphics"] : (shot["graphics"] = { mode: "graphics_first", elements: [] });
+                const elements = Array.isArray(graphics["elements"]) ? graphics["elements"] : (graphics["elements"] = []);
+                elements.push(decoration.element);
+            }
+            boardDocument = JSON.stringify(stored);
+        }
+        const saved = await commitFinishedStoryboard({ board, timeline, document, width: timeline?.width ?? size.width, height: timeline?.height ?? size.height, durationMs: result.durationMs, ...(boardDocument !== undefined && { boardDocument }) });
+        if (mode === "layout") {
+            return { status: findings ? "needs_review" : "laid_out", ...(findings && { findings }), reviews: reviews ?? [], decorations: decorations.length, timelineId: saved.timeline.id, timelineRevision: saved.timeline.revision, storyboardRevision: saved.board.revision, linkedScriptFingerprint, timeline: { type: "timeline", id: saved.timeline.id }, validation: [], ...(costUsd !== undefined && { costUsd }) };
+        }
+        return { status: strategy === "agentic" ? "reviewed_finished" : "unreviewed_draft", reviewed: strategy === "agentic", reviews: reviews ?? [], timelineId: saved.timeline.id, timelineRevision: saved.timeline.revision, storyboardRevision: saved.board.revision, validation: [], ...(costUsd !== undefined && { costUsd }) };
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+export const finishStoryboard = {
+    spec: finishStoryboardSpec,
+    impl: (run, params) => materializeAuthorizedStoryboard(run, params, "finish")
+};
+export const layoutStoryboard = {
+    spec: layoutStoryboardSpec,
+    impl: (run, params) => materializeAuthorizedStoryboard(run, params, "layout")
+};
+export const previewStoryboardDesign = {
+    spec: previewStoryboardDesignSpec,
+    impl: (run, params) => materializeAuthorizedStoryboard(run, params, "preview")
+};
+//# sourceMappingURL=finish-storyboard.js.map

package/dist/capabilities/finish-storyboard.js.map

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

package/dist/capabilities/flow.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The `flow` capability module — running a registry node from guest code.
+ *
+ * The public "native flow" surface is a typed sandbox pack the guest imports;
+ * this is the host half it lands on. Four capabilities, and nothing else,
+ * cross the boundary:
+ *
+ *   invoke_node       — run a node, return its outputs
+ *   open_node_stream  — start a node, read its output item by item
+ *   take_node_stream  — one item, or {done: true}
+ *   close_node_stream — end it early and run the node's cleanup
+ *
+ * Streaming is cursor-shaped because an async iterable cannot cross the
+ * boundary: only plain data can, so the host holds the iterator and the guest
+ * pulls one item per call.
+ *
+ * Execution is the DSL's own native-flow backend (`@nodetool-ai/dsl/flow`) —
+ * registry resolve, `process()`/`genProcess()`/`run()`, the same fold the
+ * runner applies to terminal outputs. It runs on the **invoking** run's
+ * `ProcessingContext`, so cost, secrets and storage belong to the run that
+ * asked, not to a fresh flow of its own.
+ *
+ * That package is loaded through `importHidden`. A static import would close a
+ * workspace cycle — `@nodetool-ai/dsl` → `base-nodes` → `code-nodes` →
+ * `@nodetool-ai/agents` — which the topological build cannot order. The hidden
+ * import keeps the edge out of the package graph and out of every bundler's
+ * static analysis; a host that cannot resolve the specifier reports that
+ * instead of failing on an unresolved module.
+ *
+ * A Code node body can invoke a flow containing another Code node, so the
+ * depth gate is not optional: `enterFlowInvoke` mirrors `enterJsScript`.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { CapabilityExport, CapabilityModule, CapabilityRun } from "./types.js";
+export { MAX_FLOW_INVOKE_DEPTH, MAX_OPEN_NODE_STREAMS } from "./flow.specs.js";
+/** Context variable carrying how many node invocations deep this run is. */
+export declare const FLOW_INVOKE_DEPTH_KEY = "__flow_invoke_depth";
+/** Context variable carrying the node types already on the call chain. */
+export declare const FLOW_INVOKE_CHAIN_KEY = "__flow_invoke_chain";
+/** One `outputs.emit(slot, value)` from a streaming-input node. */
+interface StreamEmission {
+    slot: string;
+    value: unknown;
+}
+/** What a node call yields: one output record, or one emission. */
+type StreamItem = Record<string, unknown> | StreamEmission;
+/** A flow handle. Only its lifetime matters here. */
+interface FlowHandle {
+    close(): Promise<void>;
+}
+/**
+ * The slice of `@nodetool-ai/dsl/flow` this module uses, written out rather
+ * than imported as a type: a `typeof import(...)` is still an import, and the
+ * point of the hidden load is that no reference to the package survives.
+ */
+interface FlowBackend {
+    createFlowForContext(context: ProcessingContext): Promise<FlowHandle>;
+    invoke(nodeType: string, inputs: Record<string, unknown>, opts?: {
+        flow?: FlowHandle;
+    }): Promise<Record<string, unknown>>;
+    invokeStream(nodeType: string, inputs: Record<string, unknown>, opts?: {
+        flow?: FlowHandle;
+    }): AsyncGenerator<StreamItem>;
+}
+/** Test seam: pin the backend (or `null` to restore the real load). */
+export declare function setFlowBackend(backend: FlowBackend | null): void;
+interface FlowDepthGate {
+    ok: boolean;
+    refusal?: Record<string, unknown>;
+    childContext?: ProcessingContext;
+}
+/**
+ * Enter one node invocation: refuse past the depth cap, else return a context
+ * copy carrying the deeper chain. The same gate `enterJsScript` applies, over
+ * this feature's own two keys — a node can be a Code node, whose body can
+ * invoke another node, so without it the recursion has no floor.
+ *
+ * Unlike a script chain, a repeated node type is not a cycle: invoking
+ * `nodetool.text.Concat` twice at different depths is ordinary work. Depth is
+ * what bounds this, and the chain rides along so a refusal can say where it
+ * came from.
+ */
+export declare function enterFlowInvoke(context: ProcessingContext, nodeType: string, maxDepth?: number): FlowDepthGate;
+/** Close every stream this run holds. Called when the run is cancelled. */
+export declare function closeAllStreams(run: CapabilityRun): Promise<void>;
+declare const invokeNode: CapabilityExport;
+declare const openNodeStream: CapabilityExport;
+declare const takeNodeStream: CapabilityExport;
+declare const closeNodeStream: CapabilityExport;
+export declare const FLOW_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { invokeNode, openNodeStream, takeNodeStream, closeNodeStream };
+//# sourceMappingURL=flow.d.ts.map

package/dist/capabilities/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/capabilities/flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAWpB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAE3D,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAM3D,mEAAmE;AACnE,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,mEAAmE;AACnE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC;AAE3D,qDAAqD;AACrD,UAAU,UAAU;IAClB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,UAAU,WAAW;IACnB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtE,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAA;KAAE,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAA;KAAE,GAC3B,cAAc,CAAC,UAAU,CAAC,CAAC;CAC/B;AAWD,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAEhE;AAiBD,UAAU,aAAa;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAA8B,GACvC,aAAa,CAwBf;AAqDD,2EAA2E;AAC3E,wBAAsB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;AA2DD,QAAA,MAAM,UAAU,EAAE,gBAiBjB,CAAC;AAEF,QAAA,MAAM,cAAc,EAAE,gBAgCrB,CAAC;AAEF,QAAA,MAAM,cAAc,EAAE,gBA0CrB,CAAC;AAEF,QAAA,MAAM,eAAe,EAAE,gBAYtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,SAAS,gBAAgB,EAKxD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC"}