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

package/dist/browser-gate.js

@@ -0,0 +1,34 @@
+/**
+ * Availability gate for the `browser_*` capabilities.
+ *
+ * Driving a browser is a single-tenant capability wearing a multi-tenant
+ * server's clothes. The session is a process singleton — one page, shared by
+ * every caller in the process — so on a managed server two tenants' agents
+ * drive the same tab, and whatever the first one signed into is what the
+ * second one's `browser_view` reads. The extension transport is worse still:
+ * it drives one user's own Chrome, which a shared server would hand to
+ * anybody's run.
+ *
+ * Neither is a defect to fix behind a flag; both are what the surface is for.
+ * It belongs on a machine its user owns — a desktop app, a local server, a
+ * self-hosted install — so under the cloud profile the capabilities are left
+ * off every belt and refuse when reached by name.
+ *
+ * Same switch that prunes the node catalog: `NODETOOL_NODE_PROFILE=cloud`, or
+ * `NODETOOL_ENV=production` with the profile unset. The node catalog already
+ * agrees — `lib.browser` is not in `CLOUD_NODE_NAMESPACES`, so the Screenshot
+ * node is gone from the cloud product too. A self-hosted install of the same
+ * image sets `NODETOOL_NODE_PROFILE=full` and keeps both, as does every local
+ * install.
+ */
+import { CLOUD_PROFILE_ENV, NODE_ENV_VAR, isCloudProfileActive } from "@nodetool-ai/protocol";
+/** Whether the `browser_*` capabilities should be offered on this deployment. */
+export function isBrowserEnabled() {
+    return !isCloudProfileActive(process.env[CLOUD_PROFILE_ENV], process.env[NODE_ENV_VAR]);
+}
+/** What a `browser_*` capability answers where this deployment offers none. */
+export const BROWSER_DISABLED_ERROR = "Browser control is not available on this deployment. It drives one shared " +
+    "browser session per server process, so it is offered only where the " +
+    "machine belongs to its user — the desktop app, a local server, or a " +
+    "self-hosted install.";
+//# sourceMappingURL=browser-gate.js.map

package/dist/browser-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-gate.js","sourceRoot":"","sources":["../src/browser-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,iFAAiF;AACjF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,oBAAoB,CAC1B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAC9B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GACjC,4EAA4E;IAC5E,sEAAsE;IACtE,sEAAsE;IACtE,sBAAsB,CAAC"}

package/dist/capabilities/GamePublishRequest.d.ts

@@ -0,0 +1,14 @@
+import type { AnyGameDocument } from "@nodetool-ai/protocol";
+/** Publication requires the token paired with an explicitly supplied document. */
+export type PublishNativeGameRequest = {
+    readonly game_id: string;
+    readonly base_revision: string;
+    readonly message?: string;
+} & ({
+    readonly document: AnyGameDocument;
+    readonly base_updated_at: string;
+} | {
+    readonly document?: never;
+    readonly base_updated_at?: never;
+});
+//# sourceMappingURL=GamePublishRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GamePublishRequest.d.ts","sourceRoot":"","sources":["../../src/capabilities/GamePublishRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,kFAAkF;AAClF,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,CACA;IAAE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,CAClE,CAAC"}

package/dist/capabilities/GamePublishRequest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GamePublishRequest.js.map

package/dist/capabilities/GamePublishRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GamePublishRequest.js","sourceRoot":"","sources":["../../src/capabilities/GamePublishRequest.ts"],"names":[],"mappings":""}

package/dist/capabilities/adapters.d.ts

@@ -0,0 +1,27 @@
+/** Transitional adapters for consumers and implementations that still use Tool.
+ * Retire capabilityFromTool when the remaining Tool implementations become
+ * native capabilities. Never use it to re-adapt a native capability wrapper.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { Tool } from "../tools/base-tool.js";
+import type { CapabilityExport, CapabilityImpl, CapabilityRun, CapabilitySpec } from "./types.js";
+/**
+ * How a wrapped capability gets its run: either one run fixed for the tool's
+ * lifetime, or a factory the wrapper calls with the `ProcessingContext` the
+ * caller passed to `process()`.
+ */
+export type CapabilityRunSource = CapabilityRun | ((context: ProcessingContext) => CapabilityRun);
+/**
+ * Expose one capability as a `Tool`. The run is either supplied directly or
+ * built per call from the context the caller passes to `process()`.
+ */
+export declare function toolFromCapability(spec: CapabilitySpec, impl: CapabilityImpl, run: CapabilityRunSource): Tool;
+/**
+ * Wrap an existing `Tool` as a capability. The category is the registered
+ * spec's when the name is a capability, so `gateLegacyTools` decides exactly as
+ * `run.invoke` does for the same name; the classification map is consulted
+ * only for a `Tool` that is not a capability, where the map is the one place
+ * its class is declared.
+ */
+export declare function capabilityFromTool(tool: Tool): CapabilityExport;
+//# sourceMappingURL=adapters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/capabilities/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,CAAC,CAAC,OAAO,EAAE,iBAAiB,KAAK,aAAa,CAAC,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,mBAAmB,GACvB,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAmB/D"}

package/dist/capabilities/adapters.js

@@ -0,0 +1,39 @@
+/** Transitional adapters for consumers and implementations that still use Tool.
+ * Retire capabilityFromTool when the remaining Tool implementations become
+ * native capabilities. Never use it to re-adapt a native capability wrapper.
+ */
+import { capabilityCategoryFor } from "./registry.js";
+import { nativeCapabilityTool, toolFromLazyCapability } from "./lazy-tool.js";
+/**
+ * Expose one capability as a `Tool`. The run is either supplied directly or
+ * built per call from the context the caller passes to `process()`.
+ */
+export function toolFromCapability(spec, impl, run) {
+    return toolFromLazyCapability(spec, run, impl);
+}
+/**
+ * Wrap an existing `Tool` as a capability. The category is the registered
+ * spec's when the name is a capability, so `gateLegacyTools` decides exactly as
+ * `run.invoke` does for the same name; the classification map is consulted
+ * only for a `Tool` that is not a capability, where the map is the one place
+ * its class is declared.
+ */
+export function capabilityFromTool(tool) {
+    if (nativeCapabilityTool(tool)) {
+        throw new Error("Native capabilities must not pass through capabilityFromTool");
+    }
+    const spec = {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        category: capabilityCategoryFor(tool.name),
+        zodSchema: tool.schema,
+        needsToolCallId: tool.needsToolCallId,
+        userMessage: (args) => tool.userMessage(args)
+    };
+    return {
+        spec,
+        impl: (run, args) => tool.process(run.context, args)
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/capabilities/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/capabilities/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAiB9E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAoB,EACpB,IAAoB,EACpB,GAAwB;IAExB,OAAO,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAU;IAC3C,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAmB;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1C,SAAS,EAAE,IAAI,CAAC,MAAM;QACtB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;KAC9C,CAAC;IACF,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/capabilities/agent-activity.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What an agent loop inside a capability reports while it runs.
+ *
+ * A capability that drives `provider.generateLoop` answers with one value when
+ * the loop ends. A mini app waiting on that value showed a spinner for minutes.
+ * The reporter puts the loop's text and tool calls on the run's context as the
+ * standard processing messages (`chunk`, `tool_call_update`,
+ * `tool_result_update`), so every host that listens to the context shows the
+ * work while it happens: the script run route streams them, a workflow run
+ * forwards them.
+ */
+import type { ProcessingContext, ProviderStreamItem } from "@nodetool-ai/runtime";
+export interface AgentActivityReporter {
+    /** Report one provider stream item: a text chunk or a tool call announcement. */
+    event(item: ProviderStreamItem): void;
+    /** Report how one tool call settled. */
+    toolResult(call: {
+        id: string;
+        name: string;
+    }, result: unknown, isError: boolean): void;
+}
+/**
+ * A reporter that emits on `context`. `nodeId` names the loop in each message,
+ * so a host can tell two loops of one run apart.
+ */
+export declare function agentActivityReporter(context: ProcessingContext, nodeId: string): AgentActivityReporter;
+//# sourceMappingURL=agent-activity.d.ts.map

package/dist/capabilities/agent-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-activity.d.ts","sourceRoot":"","sources":["../../src/capabilities/agent-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAUlF,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,KAAK,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACtC,wCAAwC;IACxC,UAAU,CACR,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAClC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,GACf,IAAI,CAAC;CACT;AAkBD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,GACb,qBAAqB,CA4DvB"}

package/dist/capabilities/agent-activity.js

@@ -0,0 +1,103 @@
+/**
+ * What an agent loop inside a capability reports while it runs.
+ *
+ * A capability that drives `provider.generateLoop` answers with one value when
+ * the loop ends. A mini app waiting on that value showed a spinner for minutes.
+ * The reporter puts the loop's text and tool calls on the run's context as the
+ * standard processing messages (`chunk`, `tool_call_update`,
+ * `tool_result_update`), so every host that listens to the context shows the
+ * work while it happens: the script run route streams them, a workflow run
+ * forwards them.
+ */
+import { randomUUID } from "node:crypto";
+import { trace } from "@opentelemetry/api";
+import { getRunTraceScope, withRunTrace, recordTraceEvent, getProviderStreamTrace, stringifyTraceContent } from "@nodetool-ai/runtime";
+import { isChunk, isToolCall } from "@nodetool-ai/runtime";
+import { capabilitySpec } from "./registry.js";
+import { isString } from "../utils/type-guards.js";
+/** The longest tool result summary one message carries. */
+const RESULT_SUMMARY_CHARS = 400;
+const summarize = (result) => {
+    const text = isString(result) ? result : JSON.stringify(result) ?? "";
+    return text.length > RESULT_SUMMARY_CHARS
+        ? `${text.slice(0, RESULT_SUMMARY_CHARS)}…`
+        : text;
+};
+/** The label a person reads for one tool call: the capability's own message, or its name. */
+const callLabel = (name, args) => {
+    try {
+        return capabilitySpec(name)?.userMessage?.(args) ?? name;
+    }
+    catch {
+        return name;
+    }
+};
+/**
+ * A reporter that emits on `context`. `nodeId` names the loop in each message,
+ * so a host can tell two loops of one run apart.
+ */
+export function agentActivityReporter(context, nodeId) {
+    const createdScope = context.runTraceContext ?? getRunTraceScope();
+    const createdSpan = trace.getActiveSpan();
+    const activityId = randomUUID();
+    return {
+        event(item) {
+            const attribution = getProviderStreamTrace(item);
+            const scope = attribution?.scope ?? createdScope;
+            if (scope) {
+                const attributes = {
+                    "node.id": nodeId, "agent.activity_id": activityId, "log.source": "agent", "log.level": "info"
+                };
+                if (isChunk(item) && !item.thinking && item.content_type !== "audio") {
+                    attributes["log.message"] = item.content;
+                }
+                if (isToolCall(item)) {
+                    attributes["tool.name"] = item.name;
+                    attributes["tool.call_id"] = item.id;
+                }
+                withRunTrace(scope, () => recordTraceEvent("agent.activity", attributes, attribution?.span ?? createdSpan));
+            }
+            if (isToolCall(item)) {
+                context.emit({
+                    type: "tool_call_update",
+                    node_id: nodeId,
+                    tool_call_id: item.id,
+                    name: item.name,
+                    args: item.args ?? {},
+                    message: callLabel(item.name, item.args ?? {})
+                });
+                return;
+            }
+            if (isChunk(item) && !item.thinking && item.content_type !== "audio") {
+                if (item.content.length === 0)
+                    return;
+                context.emit({
+                    type: "chunk",
+                    node_id: nodeId,
+                    content: item.content,
+                    content_type: "text",
+                    done: false
+                });
+            }
+        },
+        toolResult(call, result, isError) {
+            const scope = context.runTraceContext ?? getRunTraceScope() ?? createdScope;
+            if (scope) {
+                withRunTrace(scope, () => recordTraceEvent("tool.result", {
+                    "node.id": nodeId, "agent.activity_id": activityId, "tool.name": call.name, "tool.call_id": call.id,
+                    "log.source": "agent", "log.level": isError ? "error" : "info",
+                    "tool.result": stringifyTraceContent(result).slice(0, RESULT_SUMMARY_CHARS)
+                }, trace.getActiveSpan() ?? createdSpan));
+            }
+            context.emit({
+                type: "tool_result_update",
+                node_id: nodeId,
+                tool_call_id: call.id,
+                name: call.name,
+                result: { summary: summarize(result) },
+                is_error: isError
+            });
+        }
+    };
+}
+//# sourceMappingURL=agent-activity.js.map

package/dist/capabilities/agent-activity.js.map

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

package/dist/capabilities/agentic-storyboard-finish.d.ts

@@ -0,0 +1,67 @@
+import type { StoryboardDocument, TimelineSequence } from "@nodetool-ai/models";
+import { type BaseProvider, type TurnBudget, type RunBudget } from "@nodetool-ai/runtime";
+import { type FinishStoryboardInput, type FinishedStoryboardDocument } from "@nodetool-ai/timeline";
+import type { CapabilityRun } from "./types.js";
+export interface FinishedCutRuntime {
+    readonly provider: BaseProvider;
+    readonly model: string;
+    readonly budget?: TurnBudget | RunBudget;
+}
+/**
+ * What one agentic pass authors. "layout" composes the static frame of every
+ * shot and may generate decoration; "finish" authors the motion.
+ */
+export interface FinishedCutOptions {
+    readonly phase?: "layout" | "finish";
+    /** The image model a layout pass generates backgrounds and decoration with. */
+    readonly imageModel?: {
+        readonly provider: string;
+        readonly id: string;
+    };
+}
+/** A generated image the layout pass added to a shot as a decorative element. */
+export interface StoryboardDecoration {
+    readonly shotId: string;
+    readonly element: {
+        id: string;
+        kind: "asset";
+        role: "decorative";
+        asset_id: string;
+        direction: string;
+        origin: "layout_agent";
+    };
+}
+export interface FinishedCutReview {
+    readonly round: number;
+    readonly passed: boolean;
+    readonly findings: readonly string[];
+    readonly summary: string;
+    readonly frameReviews?: readonly {
+        readonly timeMs: number;
+        readonly passed: boolean;
+        readonly findings: readonly string[];
+    }[];
+    readonly referenceFrames: readonly {
+        shotId: string;
+        fingerprint: string;
+        sha256: string;
+        timeMs: number;
+    }[];
+    readonly frames: readonly {
+        timeMs: number;
+        sha256: string;
+        width: number;
+        height: number;
+    }[];
+}
+/** A child authors only an in-memory draft. Existing CAS is the sole write. */
+export declare function finishStoryboardAgentically(run: CapabilityRun, input: FinishStoryboardInput, board: StoryboardDocument, sequence: TimelineSequence, scaffold: FinishedStoryboardDocument, runtime: FinishedCutRuntime, options?: FinishedCutOptions): Promise<{
+    document: FinishedStoryboardDocument;
+    reviews: FinishedCutReview[];
+    costUsd: number;
+    decorations: StoryboardDecoration[];
+    /** Layout only: every hard check passed, the visual review still has findings. */
+    needsReview?: boolean;
+    findings?: string[];
+}>;
+//# sourceMappingURL=agentic-storyboard-finish.d.ts.map

package/dist/capabilities/agentic-storyboard-finish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-storyboard-finish.d.ts","sourceRoot":"","sources":["../../src/capabilities/agentic-storyboard-finish.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAYL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAEhC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAmBhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC;QACd,IAAI,EAAE,YAAY,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,cAAc,CAAC;KACxB,CAAC;CACH;AAwBD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS;QAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;KACtC,EAAE,CAAC;IACJ,QAAQ,CAAC,eAAe,EAAE,SAAS;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;IACJ,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;CACL;AAiTD,+EAA+E;AAC/E,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,0BAA0B,EACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;IACT,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC,CAmuCD"}