@dexto/core 1.2.6 → 1.4.0

package/dist/approval/schemas.js

@@ -1,13 +1,25 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { z } from "zod";
 import { ApprovalType, ApprovalStatus, DenialReason } from "./types.js";
+import { isValidDisplayData } from "../tools/display-types.js";
+const JsonSchema7Schema = z.record(z.unknown());
 const ApprovalTypeSchema = z.nativeEnum(ApprovalType);
 const ApprovalStatusSchema = z.nativeEnum(ApprovalStatus);
 const DenialReasonSchema = z.nativeEnum(DenialReason);
+const ToolDisplayDataSchema = z.custom((val) => isValidDisplayData(val), {
+  message: "Invalid ToolDisplayData"
+});
 const ToolConfirmationMetadataSchema = z.object({
   toolName: z.string().describe("Name of the tool to confirm"),
+  toolCallId: z.string().describe("Unique tool call ID for tracking parallel tool calls"),
   args: z.record(z.unknown()).describe("Arguments for the tool"),
-  description: z.string().optional().describe("Description of the tool")
+  description: z.string().optional().describe("Description of the tool"),
+  displayPreview: ToolDisplayDataSchema.optional().describe(
+    "Preview display data for approval UI (e.g., diff preview)"
+  ),
+  suggestedPatterns: z.array(z.string()).optional().describe(
+    'Suggested patterns for session approval (for bash commands). E.g., ["git push *", "git *"] for command "git push origin main"'
+  )
 }).strict().describe("Tool confirmation metadata");
 const CommandConfirmationMetadataSchema = z.object({
   toolName: z.string().describe("Name of the tool executing the command"),
@@ -15,7 +27,7 @@ const CommandConfirmationMetadataSchema = z.object({
   originalCommand: z.string().optional().describe("The original command before normalization")
 }).strict().describe("Command confirmation metadata");
 const ElicitationMetadataSchema = z.object({
-  schema: z.record(z.unknown()).describe("JSON Schema for the form"),
+  schema: JsonSchema7Schema.describe("JSON Schema for the form"),
   prompt: z.string().describe("Prompt to show the user"),
   serverName: z.string().describe("MCP server requesting input"),
   context: z.record(z.unknown()).optional().describe("Additional context")
@@ -25,7 +37,7 @@ const BaseApprovalRequestSchema = z.object({
   approvalId: z.string().uuid().describe("Unique approval identifier"),
   type: ApprovalTypeSchema.describe("Type of approval"),
   sessionId: z.string().optional().describe("Session identifier"),
-  timeout: z.number().int().positive().describe("Timeout in milliseconds"),
+  timeout: z.number().int().positive().optional().describe("Timeout in milliseconds (optional - no timeout if not specified)"),
   timestamp: z.date().describe("When the request was created")
 }).describe("Base approval request");
 const ToolConfirmationRequestSchema = BaseApprovalRequestSchema.extend({
@@ -51,7 +63,10 @@ const ApprovalRequestSchema = z.discriminatedUnion("type", [
   CustomApprovalRequestSchema
 ]);
 const ToolConfirmationResponseDataSchema = z.object({
-  rememberChoice: z.boolean().optional().describe("Remember this choice")
+  rememberChoice: z.boolean().optional().describe("Remember this tool for the session (approves ALL uses of this tool)"),
+  rememberPattern: z.string().optional().describe(
+    'Remember a command pattern for bash commands (e.g., "git *"). Only applicable for bash_exec tool approvals.'
+  )
 }).strict().describe("Tool confirmation response data");
 const CommandConfirmationResponseDataSchema = z.object({
   // Command confirmations don't have remember choice - they're per-command
@@ -92,7 +107,7 @@ const ApprovalResponseSchema = z.union([
 const ApprovalRequestDetailsSchema = z.object({
   type: ApprovalTypeSchema,
   sessionId: z.string().optional(),
-  timeout: z.number().int().positive(),
+  timeout: z.number().int().positive().optional().describe("Timeout in milliseconds (optional - no timeout if not specified)"),
   metadata: z.union([
     ToolConfirmationMetadataSchema,
     CommandConfirmationMetadataSchema,

package/dist/approval/types.d.ts

@@ -214,5 +214,11 @@ export interface ApprovalHandler {
      * @remarks Not all handlers track pending requests (e.g., auto-approve handlers)
      */
     getPending?(): string[];
+    /**
+     * Get full pending approval requests (optional)
+     * @returns Array of pending approval requests
+     * @remarks Not all handlers track pending requests (e.g., auto-approve handlers)
+     */
+    getPendingRequests?(): ApprovalRequest[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/approval/types.d.ts.map

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

package/dist/approval/types.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 var ApprovalType = /* @__PURE__ */ ((ApprovalType2) => {
   ApprovalType2["TOOL_CONFIRMATION"] = "tool_confirmation";
   ApprovalType2["COMMAND_CONFIRMATION"] = "command_confirmation";

package/dist/{chunk-C6A6W6XS.js → chunk-PTJYTZNU.js}

@@ -45,9 +45,52 @@ var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use
 var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
 var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
+    var dispose, inner;
+    if (async) dispose = value[__knownSymbol("asyncDispose")];
+    if (dispose === void 0) {
+      dispose = value[__knownSymbol("dispose")];
+      if (async) inner = dispose;
+    }
+    if (typeof dispose !== "function") __typeError("Object not disposable");
+    if (inner) dispose = function() {
+      try {
+        inner.call(this);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    };
+    stack.push([async, dispose, value]);
+  } else if (async) {
+    stack.push([async]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  };
+  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
+  var next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError) throw error;
+  };
+  return next();
+};
 
 export {
   __decoratorStart,
   __runInitializers,
-  __decorateElement
+  __decorateElement,
+  __using,
+  __callDispose
 };

package/dist/{llm/tokenizer/factory.cjs → context/compression/overflow.cjs}

@@ -16,29 +16,28 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var factory_exports = {};
-__export(factory_exports, {
-  createTokenizer: () => createTokenizer
+var overflow_exports = {};
+__export(overflow_exports, {
+  getCompressionTarget: () => getCompressionTarget,
+  isOverflow: () => isOverflow
 });
-module.exports = __toCommonJS(factory_exports);
-var import_openai = require("./openai.js");
-var import_anthropic = require("./anthropic.js");
-var import_google = require("./google.js");
-var import_default = require("./default.js");
-function createTokenizer(provider, model, logger) {
-  switch (provider) {
-    case "openai":
-      return new import_openai.OpenAITokenizer(model, logger);
-    case "anthropic":
-      return new import_anthropic.AnthropicTokenizer();
-    case "google":
-      return new import_google.GoogleTokenizer(model);
-    // Add cases for other providers here
-    default:
-      return new import_default.DefaultTokenizer();
-  }
+module.exports = __toCommonJS(overflow_exports);
+const DEFAULT_OUTPUT_BUFFER = 16e3;
+function isOverflow(tokens, modelLimits) {
+  const { contextWindow, maxOutput } = modelLimits;
+  const outputBuffer = Math.min(maxOutput, DEFAULT_OUTPUT_BUFFER);
+  const usableTokens = contextWindow - outputBuffer;
+  const inputTokens = tokens.inputTokens ?? 0;
+  return inputTokens > usableTokens;
+}
+function getCompressionTarget(modelLimits, targetPercentage = 0.7) {
+  const { contextWindow, maxOutput } = modelLimits;
+  const outputBuffer = Math.min(maxOutput, DEFAULT_OUTPUT_BUFFER);
+  const usableTokens = contextWindow - outputBuffer;
+  return Math.floor(usableTokens * targetPercentage);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createTokenizer
+  getCompressionTarget,
+  isOverflow
 });

package/dist/context/compression/overflow.d.ts

@@ -0,0 +1,33 @@
+import type { TokenUsage } from '../../llm/types.js';
+/**
+ * Model limits configuration for overflow detection.
+ * These limits define the context window boundaries.
+ */
+export interface ModelLimits {
+    /** Maximum context window size in tokens */
+    contextWindow: number;
+    /** Maximum output tokens the model can generate */
+    maxOutput: number;
+}
+/**
+ * Determines if the context has overflowed based on actual token usage from the API.
+ *
+ * Overflow is detected when:
+ * used tokens > (contextWindow - outputBuffer)
+ *
+ * The outputBuffer ensures we always have room for the model's response.
+ *
+ * @param tokens The actual token usage from the last LLM API call
+ * @param modelLimits The model's context window and output limits
+ * @returns true if context has overflowed and compression is needed
+ */
+export declare function isOverflow(tokens: TokenUsage, modelLimits: ModelLimits): boolean;
+/**
+ * Calculate the compression target - how many tokens we need to reduce to.
+ *
+ * @param modelLimits The model's context window and output limits
+ * @param targetPercentage What percentage of usable context to target (default 70%)
+ * @returns The target token count after compression
+ */
+export declare function getCompressionTarget(modelLimits: ModelLimits, targetPercentage?: number): number;
+//# sourceMappingURL=overflow.d.ts.map

package/dist/context/compression/overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow.d.ts","sourceRoot":"","sources":["../../../src/context/compression/overflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACrB;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAYhF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,WAAW,EACxB,gBAAgB,GAAE,MAAY,GAC/B,MAAM,CAMR"}

package/dist/context/compression/overflow.js

@@ -0,0 +1,19 @@
+import "../../chunk-PTJYTZNU.js";
+const DEFAULT_OUTPUT_BUFFER = 16e3;
+function isOverflow(tokens, modelLimits) {
+  const { contextWindow, maxOutput } = modelLimits;
+  const outputBuffer = Math.min(maxOutput, DEFAULT_OUTPUT_BUFFER);
+  const usableTokens = contextWindow - outputBuffer;
+  const inputTokens = tokens.inputTokens ?? 0;
+  return inputTokens > usableTokens;
+}
+function getCompressionTarget(modelLimits, targetPercentage = 0.7) {
+  const { contextWindow, maxOutput } = modelLimits;
+  const outputBuffer = Math.min(maxOutput, DEFAULT_OUTPUT_BUFFER);
+  const usableTokens = contextWindow - outputBuffer;
+  return Math.floor(usableTokens * targetPercentage);
+}
+export {
+  getCompressionTarget,
+  isOverflow
+};

package/dist/context/compression/reactive-overflow.cjs

@@ -0,0 +1,201 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var reactive_overflow_exports = {};
+__export(reactive_overflow_exports, {
+  ReactiveOverflowStrategy: () => ReactiveOverflowStrategy
+});
+module.exports = __toCommonJS(reactive_overflow_exports);
+var import_ai = require("ai");
+var import_types = require("../types.js");
+const DEFAULT_OPTIONS = {
+  preserveLastNTurns: 2,
+  maxSummaryTokens: 2e3,
+  summaryPrompt: `You are a conversation summarizer. Summarize the following conversation history concisely, focusing on:
+- What tasks were attempted and their outcomes
+- Current state and context the assistant needs to remember
+- Any important decisions or information discovered
+- What the user was trying to accomplish
+
+Be concise but preserve essential context. Output only the summary, no preamble.
+
+Conversation:
+{conversation}`
+};
+class ReactiveOverflowStrategy {
+  name = "reactive-overflow";
+  model;
+  options;
+  logger;
+  constructor(model, options = {}, logger) {
+    this.model = model;
+    this.options = { ...DEFAULT_OPTIONS, ...options };
+    this.logger = logger;
+  }
+  /**
+   * Generate a summary message for the old portion of history.
+   *
+   * IMPORTANT: This does NOT replace history. It returns a summary message
+   * that the caller should ADD to history via contextManager.addMessage().
+   * Read-time filtering (filterCompacted) will then exclude pre-summary
+   * messages when formatting for LLM.
+   *
+   * @param history The full conversation history
+   * @returns Array with single summary message to add, or empty if nothing to summarize
+   */
+  async compress(history) {
+    if (history.length <= 2) {
+      this.logger.debug("ReactiveOverflowStrategy: History too short, skipping compression");
+      return [];
+    }
+    const { toSummarize, toKeep } = this.splitHistory(history);
+    if (toSummarize.length === 0) {
+      this.logger.debug("ReactiveOverflowStrategy: No messages to summarize");
+      return [];
+    }
+    this.logger.info(
+      `ReactiveOverflowStrategy: Summarizing ${toSummarize.length} messages, keeping ${toKeep.length}`
+    );
+    const summary = await this.generateSummary(toSummarize);
+    const summaryMessage = {
+      role: "assistant",
+      content: [{ type: "text", text: summary }],
+      timestamp: Date.now(),
+      metadata: {
+        isSummary: true,
+        summarizedAt: Date.now(),
+        summarizedMessageCount: toSummarize.length,
+        originalFirstTimestamp: toSummarize[0]?.timestamp,
+        originalLastTimestamp: toSummarize[toSummarize.length - 1]?.timestamp
+      }
+    };
+    return [summaryMessage];
+  }
+  /**
+   * Split history into messages to summarize and messages to keep.
+   * Keeps the last N turns (user + assistant pairs) intact.
+   */
+  splitHistory(history) {
+    const turnsToKeep = this.options.preserveLastNTurns;
+    const userMessageIndices = [];
+    for (let i = history.length - 1; i >= 0; i--) {
+      if (history[i]?.role === "user") {
+        userMessageIndices.unshift(i);
+        if (userMessageIndices.length >= turnsToKeep) {
+          break;
+        }
+      }
+    }
+    if (userMessageIndices.length > 0) {
+      const splitIndex = userMessageIndices[0];
+      if (splitIndex !== void 0) {
+        if (splitIndex === 0) {
+          return {
+            toSummarize: [],
+            toKeep: history
+          };
+        }
+        return {
+          toSummarize: history.slice(0, splitIndex),
+          toKeep: history.slice(splitIndex)
+        };
+      }
+    }
+    const keepCount = Math.min(4, history.length);
+    return {
+      toSummarize: history.slice(0, -keepCount),
+      toKeep: history.slice(-keepCount)
+    };
+  }
+  /**
+   * Generate an LLM summary of the messages.
+   */
+  async generateSummary(messages) {
+    const formattedConversation = this.formatMessagesForSummary(messages);
+    const prompt = this.options.summaryPrompt.replace("{conversation}", formattedConversation);
+    try {
+      const result = await (0, import_ai.generateText)({
+        model: this.model,
+        prompt,
+        maxOutputTokens: this.options.maxSummaryTokens
+      });
+      return `[Previous conversation summary]
+${result.text}`;
+    } catch (error) {
+      this.logger.error("ReactiveOverflowStrategy: Failed to generate summary", { error });
+      return this.createFallbackSummary(messages);
+    }
+  }
+  /**
+   * Format messages for the summary prompt.
+   */
+  formatMessagesForSummary(messages) {
+    return messages.map((msg) => {
+      const role = msg.role.toUpperCase();
+      let content;
+      if (typeof msg.content === "string") {
+        content = msg.content;
+      } else if (Array.isArray(msg.content)) {
+        content = msg.content.filter(
+          (part) => part.type === "text"
+        ).map((part) => part.text).join("\n");
+      } else {
+        content = "[no content]";
+      }
+      if (content.length > 2e3) {
+        content = content.slice(0, 2e3) + "... [truncated]";
+      }
+      if ((0, import_types.isAssistantMessage)(msg) && msg.toolCalls && msg.toolCalls.length > 0) {
+        const toolNames = msg.toolCalls.map((tc) => tc.function.name).join(", ");
+        content += `
+[Used tools: ${toolNames}]`;
+      }
+      if ((0, import_types.isToolMessage)(msg)) {
+        return `TOOL (${msg.name}): ${content.slice(0, 500)}${content.length > 500 ? "..." : ""}`;
+      }
+      return `${role}: ${content}`;
+    }).join("\n\n");
+  }
+  /**
+   * Create a fallback summary if LLM call fails.
+   */
+  createFallbackSummary(messages) {
+    const userMessages = messages.filter((m) => m.role === "user");
+    const assistantWithTools = messages.filter(
+      (m) => (0, import_types.isAssistantMessage)(m) && !!m.toolCalls && m.toolCalls.length > 0
+    );
+    const userTopics = userMessages.slice(-3).map((m) => {
+      const text = typeof m.content === "string" ? m.content : Array.isArray(m.content) ? m.content.filter(
+        (p) => p.type === "text"
+      ).map((p) => p.text).join(" ") : "";
+      return text.slice(0, 100);
+    }).join("; ");
+    const toolsUsed = [
+      ...new Set(
+        assistantWithTools.flatMap((m) => m.toolCalls.map((tc) => tc.function.name))
+      )
+    ].join(", ");
+    return `[Previous conversation summary - fallback]
+User discussed: ${userTopics || "various topics"}
+Tools used: ${toolsUsed || "none"}`;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ReactiveOverflowStrategy
+});

package/dist/context/compression/reactive-overflow.d.ts

@@ -0,0 +1,81 @@
+import { type LanguageModel } from 'ai';
+import type { ICompressionStrategy } from './types.js';
+import type { InternalMessage } from '../types.js';
+import type { IDextoLogger } from '../../logger/v2/types.js';
+/**
+ * Configuration options for ReactiveOverflowStrategy.
+ */
+export interface ReactiveOverflowOptions {
+    /**
+     * Number of recent turns to preserve (not summarize).
+     * A "turn" is a user message + assistant response pair.
+     * Default: 2
+     */
+    preserveLastNTurns?: number;
+    /**
+     * Maximum tokens for the summary output.
+     * Default: 2000
+     */
+    maxSummaryTokens?: number;
+    /**
+     * Custom summary prompt template.
+     * Use {conversation} as placeholder for formatted messages.
+     */
+    summaryPrompt?: string;
+}
+/**
+ * ReactiveOverflowStrategy implements reactive compression.
+ *
+ * Key behaviors:
+ * - Triggers on overflow (after actual tokens exceed context limit)
+ * - Uses LLM to generate intelligent summary of older messages
+ * - Returns summary message to ADD to history (not replace)
+ * - Read-time filtering via filterCompacted() excludes pre-summary messages
+ *
+ * This strategy is designed to work with TurnExecutor's main loop:
+ * 1. After each step, check if overflow occurred
+ * 2. If yes, generate summary and ADD it to history
+ * 3. filterCompacted() in getFormattedMessages() excludes old messages
+ * 4. Continue with fresh context (summary + recent messages)
+ *
+ * NOTE: This does NOT replace history. The summary message is ADDED,
+ * and filterCompacted() handles excluding old messages at read-time.
+ * This preserves full history for audit/recovery purposes.
+ */
+export declare class ReactiveOverflowStrategy implements ICompressionStrategy {
+    readonly name = "reactive-overflow";
+    private readonly model;
+    private readonly options;
+    private readonly logger;
+    constructor(model: LanguageModel, options: ReactiveOverflowOptions | undefined, logger: IDextoLogger);
+    /**
+     * Generate a summary message for the old portion of history.
+     *
+     * IMPORTANT: This does NOT replace history. It returns a summary message
+     * that the caller should ADD to history via contextManager.addMessage().
+     * Read-time filtering (filterCompacted) will then exclude pre-summary
+     * messages when formatting for LLM.
+     *
+     * @param history The full conversation history
+     * @returns Array with single summary message to add, or empty if nothing to summarize
+     */
+    compress(history: readonly InternalMessage[]): Promise<InternalMessage[]>;
+    /**
+     * Split history into messages to summarize and messages to keep.
+     * Keeps the last N turns (user + assistant pairs) intact.
+     */
+    private splitHistory;
+    /**
+     * Generate an LLM summary of the messages.
+     */
+    private generateSummary;
+    /**
+     * Format messages for the summary prompt.
+     */
+    private formatMessagesForSummary;
+    /**
+     * Create a fallback summary if LLM call fails.
+     */
+    private createFallbackSummary;
+}
+//# sourceMappingURL=reactive-overflow.d.ts.map

package/dist/context/compression/reactive-overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-overflow.d.ts","sourceRoot":"","sources":["../../../src/context/compression/reactive-overflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,wBAAyB,YAAW,oBAAoB;IACjE,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,uBAAuB,YAAK,EAAE,MAAM,EAAE,YAAY;IAM7F;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0C/E;;;OAGG;IACH,OAAO,CAAC,YAAY;IA2CpB;;OAEG;YACW,eAAe;IAmB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2ChC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAiChC"}