@superblocksteam/vite-plugin-file-sync 1.99.99-next.3 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ai-service/llm/context-v2/context-management.js

@@ -0,0 +1,207 @@
+/**
+ * Server-side context management configuration for Anthropic provider.
+ *
+ * Builds the `contextManagement` provider options for the `@ai-sdk/anthropic`
+ * SDK, enabling two server-side edit strategies:
+ *
+ * 1. `clear_tool_uses_20250919` -- removes old tool use/result pairs from
+ *    context when input tokens exceed a threshold, keeping recent ones and
+ *    excluding protected tools.
+ *
+ * 2. `compact_20260112` -- triggers server-side summarization when context
+ *    grows beyond a second threshold.
+ */
+import { getLogger } from "../../../util/logger.js";
+/**
+ * Input token threshold at which old tool use/result pairs are cleared.
+ *
+ * Set below the compact trigger so tool clearing happens first, reducing
+ * context size without losing conversational continuity. 100k tokens is
+ * roughly 60-70% of a typical 150k context window.
+ */
+export const CLEAR_TOOL_USES_TRIGGER_TOKENS = 100_000;
+/**
+ * Input token threshold at which server-side compaction (summarization) fires.
+ *
+ * Set higher than the clear trigger so compaction is a second line of defense.
+ * 150k tokens leaves headroom for the output budget in a 200k context window.
+ */
+export const COMPACT_TRIGGER_TOKENS = 150_000;
+/**
+ * Number of recent tool use/result pairs to keep when clearing.
+ *
+ * Keeping 6 recent tool uses preserves the most recent multi-step
+ * tool call chain (e.g., read -> edit -> verify pattern).
+ */
+export const KEEP_RECENT_TOOL_USES = 6;
+/**
+ * Minimum number of input tokens to clear when the clear trigger fires.
+ *
+ * Prevents trivial clears that would break prompt caching by forcing
+ * each clear to reclaim at least 10k tokens of context. Without this,
+ * the server might clear a single small tool result and immediately
+ * invalidate the cache prefix.
+ */
+export const CLEAR_AT_LEAST_TOKENS = 10_000;
+const MIN_CLEAR_TOOL_USES_TRIGGER_TOKENS = 30_000;
+const MIN_COMPACT_TRIGGER_TOKENS = 50_000;
+/**
+ * Choose the compaction strategy for a request from the
+ * `serverContextManagement.enabled` LD-flag field.
+ *
+ * Defaults to client-side: only an explicit `enabled === true` flips
+ * to server-side (Anthropic's `compact_20260112` /
+ * `clear_tool_uses_20250919`). `enabled === false`, `enabled ===
+ * undefined`, and missing-flag payloads all resolve to client-side
+ * (phase 1 + phase 2 LLM session summarization). Opt-in by design
+ * because the server-side path is newer, only validated on Anthropic
+ * variants of the SDK, and its behavior on long sessions depends on
+ * the in-memory trim that `ServerSideCompactionStrategy` performs on
+ * compaction-detected — easier to roll forward with explicit gating
+ * than to roll back from a default-on regression.
+ *
+ * Lives here (not in clark-fsm) so it can be unit-tested independently
+ * of the FSM's heavyweight construction.
+ */
+export function selectContextManagementStrategy(options) {
+    if (options.serverContextManagementEnabled === true) {
+        return {
+            type: "server",
+            ...(options.thresholds !== undefined && {
+                thresholds: options.thresholds,
+            }),
+        };
+    }
+    const { model, providerConfig } = options.summarizeModel();
+    return {
+        type: "client",
+        summarizationModel: model,
+        summarizationProviderConfig: providerConfig,
+    };
+}
+/**
+ * Bedrock beta feature flags required for context management.
+ *
+ * These are passed via `additionalModelRequestFields.anthropic_beta`
+ * in the Bedrock InvokeModel request body.
+ */
+export const BEDROCK_CONTEXT_MANAGEMENT_BETAS = [
+    "context-management-2025-06-27",
+    "compact-2026-01-12",
+];
+/**
+ * Builds the Anthropic `contextManagement` provider options.
+ *
+ * This class encapsulates the configuration for server-side context
+ * management edits -- tool-use clearing and compaction. The output
+ * is passed as `providerOptions.anthropic.contextManagement` in
+ * `streamText` calls for direct Anthropic, and translated to
+ * `additionalModelRequestFields.context_management` for Bedrock.
+ */
+export class ContextManagementConfig {
+    /**
+     * Build the context management configuration for `providerOptions.anthropic`.
+     *
+     * The `@ai-sdk/anthropic` provider handles beta header injection and
+     * camelCase-to-snake_case translation automatically.
+     *
+     * @param options - Optional overrides for exclude lists and thresholds
+     * @returns The `contextManagement` object for `providerOptions.anthropic`
+     */
+    static build(options) {
+        const edits = ContextManagementConfig.buildEdits(options);
+        return { edits };
+    }
+    /**
+     * Build the context management fields for `providerOptions.bedrock.additionalModelRequestFields`.
+     *
+     * Bedrock InvokeModel uses snake_case field names and requires explicit
+     * `anthropic_beta` array in the request body (not HTTP headers). This method
+     * returns the fields to merge into `additionalModelRequestFields`.
+     *
+     * @param options - Optional overrides for exclude lists and thresholds
+     * @returns Object with `context_management` and `anthropic_beta` for Bedrock
+     */
+    static buildForBedrock(options) {
+        const edits = ContextManagementConfig.buildEdits(options);
+        // Bedrock uses snake_case in the InvokeModel request body
+        const bedrockEdits = edits.map((edit) => {
+            if (edit.type === "clear_tool_uses_20250919") {
+                return {
+                    type: edit.type,
+                    trigger: edit.trigger,
+                    keep: edit.keep,
+                    clear_at_least: edit.clearAtLeast,
+                    clear_tool_inputs: edit.clearToolInputs,
+                    ...(edit.excludeTools && { exclude_tools: edit.excludeTools }),
+                };
+            }
+            // compact_20260112 fields are already snake_case compatible
+            return edit;
+        });
+        return {
+            context_management: { edits: bedrockEdits },
+            anthropic_beta: [...BEDROCK_CONTEXT_MANAGEMENT_BETAS],
+        };
+    }
+    /**
+     * Build the shared edit entries used by both Anthropic and Bedrock formats.
+     */
+    static buildEdits(options) {
+        const t = options?.thresholds;
+        const configuredClearToolUsesTriggerTokens = t?.clearToolUsesTriggerTokens ?? CLEAR_TOOL_USES_TRIGGER_TOKENS;
+        const configuredCompactTriggerTokens = t?.compactTriggerTokens ?? COMPACT_TRIGGER_TOKENS;
+        const clearToolUsesTriggerTokens = Math.max(configuredClearToolUsesTriggerTokens, MIN_CLEAR_TOOL_USES_TRIGGER_TOKENS);
+        const compactProviderMinimumTriggerTokens = Math.max(configuredCompactTriggerTokens, MIN_COMPACT_TRIGGER_TOKENS);
+        const compactTriggerTokens = Math.max(compactProviderMinimumTriggerTokens, clearToolUsesTriggerTokens + 1);
+        if (configuredClearToolUsesTriggerTokens !== clearToolUsesTriggerTokens ||
+            configuredCompactTriggerTokens !== compactProviderMinimumTriggerTokens) {
+            getLogger().warnStructured?.("Clamped server context management thresholds to provider minimums", {
+                clear_tool_uses_min_trigger_tokens: MIN_CLEAR_TOOL_USES_TRIGGER_TOKENS,
+                clear_tool_uses_effective_trigger_tokens: clearToolUsesTriggerTokens,
+                clear_tool_uses_trigger_tokens: configuredClearToolUsesTriggerTokens,
+                compact_effective_trigger_tokens: compactTriggerTokens,
+                compact_min_trigger_tokens: MIN_COMPACT_TRIGGER_TOKENS,
+                compact_trigger_tokens: configuredCompactTriggerTokens,
+                event: "server_context_management_threshold_clamped",
+            });
+        }
+        if (compactProviderMinimumTriggerTokens !== compactTriggerTokens) {
+            getLogger().warnStructured?.("Adjusted server context management thresholds to preserve clear-before-compact ordering", {
+                clear_tool_uses_effective_trigger_tokens: clearToolUsesTriggerTokens,
+                compact_effective_trigger_tokens: compactTriggerTokens,
+                compact_trigger_tokens: configuredCompactTriggerTokens,
+                event: "server_context_management_threshold_order_adjusted",
+            });
+        }
+        const excludeTools = options?.excludeTools && options.excludeTools.length > 0
+            ? [...options.excludeTools]
+            : undefined;
+        const clearToolUsesEdit = {
+            type: "clear_tool_uses_20250919",
+            trigger: {
+                type: "input_tokens",
+                value: clearToolUsesTriggerTokens,
+            },
+            keep: {
+                type: "tool_uses",
+                value: t?.keepRecentToolUses ?? KEEP_RECENT_TOOL_USES,
+            },
+            clearAtLeast: {
+                type: "input_tokens",
+                value: t?.clearAtLeastTokens ?? CLEAR_AT_LEAST_TOKENS,
+            },
+            clearToolInputs: false,
+            ...(excludeTools && { excludeTools }),
+        };
+        const compactEdit = {
+            type: "compact_20260112",
+            trigger: {
+                type: "input_tokens",
+                value: compactTriggerTokens,
+            },
+        };
+        return [clearToolUsesEdit, compactEdit];
+    }
+}
+//# sourceMappingURL=context-management.js.map

package/dist/ai-service/llm/context-v2/context-management.js.map

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

package/dist/ai-service/llm/context-v2/context-metrics.d.ts

@@ -0,0 +1,150 @@
+/** Where `ContextManagerV2.getOrCreateContext` found the conversation. */
+export declare const CONTEXT_LOAD_SOURCES: readonly ["cache", "event_log", "legacy", "new", "remote"];
+export type ContextLoadSource = (typeof CONTEXT_LOAD_SOURCES)[number];
+/** Which `ContextV2` write path requested the full-record persist. */
+export declare const CONTEXT_PERSIST_TRIGGERS: readonly ["attachments", "compaction", "replay", "response", "truncate", "turn_end"];
+export type ContextPersistTrigger = (typeof CONTEXT_PERSIST_TRIGGERS)[number];
+export declare const CONTEXT_LOAD_OUTCOMES: readonly ["created_empty", "missing_archive", "restore_failed", "success_empty", "success_non_empty"];
+export type ContextLoadOutcome = (typeof CONTEXT_LOAD_OUTCOMES)[number];
+/** Direction of the context snapshot file I/O being measured. */
+export declare const CONTEXT_FILE_OPERATIONS: readonly ["load", "persist"];
+type ContextFileOperation = (typeof CONTEXT_FILE_OPERATIONS)[number];
+export declare const CONTEXT_DOCUMENT_MODES: readonly ["inline", "reference"];
+type ContextDocumentMode = (typeof CONTEXT_DOCUMENT_MODES)[number];
+export declare const COMPACTION_PATHS: readonly ["client", "server"];
+export type CompactionPath = (typeof COMPACTION_PATHS)[number];
+/** Why a client-side compaction was skipped instead of running. */
+export declare const COMPACTION_SKIP_REASONS: readonly ["rearm_latch"];
+export type CompactionSkipReason = (typeof COMPACTION_SKIP_REASONS)[number];
+/**
+ * How a pre-flight oversize check ended (ENG-5282).
+ *
+ * This is the only compaction trigger that fires on a size estimate rather than
+ * provider-reported usage, and it is the fix for a wedge that was invisible in
+ * telemetry. Without its own outcome we cannot tell a pre-flight rescue from
+ * routine mid-conversation compaction after deploy, or tell whether it fired at
+ * all.
+ *
+ *  - `fit`: the payload was already under the threshold, so no pass ran. The
+ *    overwhelming majority, and the baseline the other four are read against.
+ *  - `compacted`: a pass ran and brought the payload under the threshold.
+ *  - `progressed`: a pass ran and left the payload over the compaction
+ *    threshold but under the provider input limit, so it was kept and sent.
+ *    Tool schemas are irreducible, so this is the expected outcome whenever
+ *    they alone push a compacted window back over the threshold. A rising
+ *    share here versus `compacted` means the threshold is unreachable for that
+ *    traffic, not that compaction is failing.
+ *  - `discarded`: a pass ran, left the payload still unsendable, and was thrown
+ *    away rather than persisted.
+ *  - `latched`: skipped because an earlier pass on this context already ended
+ *    over the threshold. A rising count here means one session repeatedly
+ *    arriving oversized.
+ *  - `skipped`: skipped because an earlier pass outlived its deadline and its
+ *    summarizer is still running. Only reachable after a strategy swap cleared
+ *    the latch, so it should stay near zero.
+ *  - `timed_out`: the pass outlived its deadline. The summarizer is still
+ *    running and billing in the background. A rising count means the deadline
+ *    is too short for the histories reaching it, not that the pipeline broke.
+ *  - `failed`: the pass threw.
+ */
+export declare const PREFLIGHT_COMPACTION_OUTCOMES: readonly ["compacted", "discarded", "failed", "fit", "latched", "progressed", "skipped", "timed_out"];
+export type PreflightCompactionOutcome = (typeof PREFLIGHT_COMPACTION_OUTCOMES)[number];
+export declare const SERVER_COMPACTION_STATUSES: readonly ["cancelled", "completed", "interrupted"];
+type ServerCompactionStatus = (typeof SERVER_COMPACTION_STATUSES)[number];
+/** Outcome of persisting a prompt's uploaded attachments into the context. */
+export declare const ATTACHMENT_PERSIST_STATUSES: readonly ["failure", "success"];
+type AttachmentPersistStatus = (typeof ATTACHMENT_PERSIST_STATUSES)[number];
+/**
+ * Final outcome of a checkpoint restore (version rollback). Low-cardinality so
+ * the rare failure branches are countable/alertable instead of only appearing
+ * as log lines:
+ *  - `restored`: context rolled back and the server chat truncated to match.
+ *  - `chat_truncate_failed`: context rolled back but the server chat truncation
+ *    failed after retries — context and chat diverge (needs attention).
+ *  - `aborted`: the event-log truncation threw; the rollback was not confirmed
+ *    (warm path: nothing was mutated; cold path: the archive was installed but
+ *    could not be truncated).
+ *  - `unhealed`: the snapshot could not be made consistent, so the rollback was
+ *    not applied and the chat was preserved.
+ *  - `no_checkpoint`: the cold (remote) restore found no checkpoint to install.
+ */
+export declare const CHECKPOINT_RESTORE_OUTCOMES: readonly ["aborted", "chat_truncate_failed", "no_checkpoint", "restored", "unhealed"];
+export type CheckpointRestoreOutcome = (typeof CHECKPOINT_RESTORE_OUTCOMES)[number];
+export interface ContextMetricIdentity {
+    applicationId?: string;
+    organizationId?: string;
+}
+export declare function recordContextLoad(input: {
+    source: ContextLoadSource;
+    durationMs: number;
+    identity?: ContextMetricIdentity;
+}): void;
+/**
+ * `identity` is accepted and discarded, like the sibling recorders: org and app
+ * belong in logs and traces, not in metric labels.
+ */
+export declare function recordPreflightCompaction(input: {
+    outcome: PreflightCompactionOutcome;
+    durationMs: number;
+    identity?: ContextMetricIdentity;
+}): void;
+export declare function recordContextPersist(input: {
+    trigger: ContextPersistTrigger;
+    durationMs: number;
+    identity?: ContextMetricIdentity;
+}): void;
+export declare function recordContextLoadOutcome(input: {
+    outcome: ContextLoadOutcome;
+    source: ContextLoadSource;
+}): void;
+export declare function recordContextRestoreEmptyCreated(): void;
+export declare function recordCheckpointRestore(outcome: CheckpointRestoreOutcome): void;
+export declare function recordContextFileBytes(input: {
+    operation: ContextFileOperation;
+    bytes: number;
+    identity?: ContextMetricIdentity;
+}): void;
+export declare function recordContextDocuments(input: {
+    added: number;
+    current: number;
+    dropped: number;
+    mode: ContextDocumentMode;
+}): void;
+export declare function recordAttachmentPersist(input: {
+    status: AttachmentPersistStatus;
+}): void;
+export declare function recordCompaction(input: {
+    durationMs?: number;
+    inputTokensAfter?: number;
+    inputTokensBefore?: number;
+    messagesAfter?: number;
+    messagesBefore?: number;
+    path: CompactionPath;
+    status: ServerCompactionStatus;
+} & ContextMetricIdentity): void;
+export declare function recordCompactionSkipped(input: {
+    reason: CompactionSkipReason;
+}): void;
+export declare function recordContextOccupancy(tokens: number, coreModel?: string): void;
+export declare function recordPromptContextHeadroom(input: {
+    coreModel?: string;
+    dedupeKey: string | undefined;
+    minHeadroomTokens?: number;
+    peakContextUsed?: number;
+}): void;
+export declare function recordTurnsSinceLastCompaction(turns: number): void;
+export declare function recordServerCompaction(input: {
+    status: ServerCompactionStatus;
+    durationMs?: number;
+    messagesBefore?: number;
+    messagesAfter?: number;
+    inputTokensBefore?: number;
+    inputTokensAfter?: number;
+} & ContextMetricIdentity): void;
+export declare function recordServerClearToolUses(input: {
+    clearedToolUses?: number;
+    clearedInputTokens?: number;
+} & ContextMetricIdentity): void;
+export declare function _resetClarkContextMetricsForTesting(): void;
+export {};
+//# sourceMappingURL=context-metrics.d.ts.map

package/dist/ai-service/llm/context-v2/context-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-metrics.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/llm/context-v2/context-metrics.ts"],"names":[],"mappings":"AA6EA,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,4DAMvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,sFAO3B,CAAC;AACX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,qBAAqB,uGAMxB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,8BAA+B,CAAC;AACpE,KAAK,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,eAAO,MAAM,sBAAsB,kCAAmC,CAAC;AACvE,KAAK,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,gBAAgB,+BAAgC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,0BAA2B,CAAC;AAChE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,6BAA6B,uGAShC,CAAC;AACX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,eAAO,MAAM,0BAA0B,oDAI7B,CAAC;AACX,KAAK,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,iCAAkC,CAAC;AAC3E,KAAK,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,uFAM9B,CAAC;AACX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAunBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,GAAG,IAAI,CAEP;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE,0BAA0B,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,GAAG,IAAI,CAEP;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,GAAG,IAAI,CAEP;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,iBAAiB,CAAC;CAC3B,GAAG,IAAI,CAEP;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAEN;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,GAAG,IAAI,CAEP;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,GAAG,IAAI,CAEP;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,MAAM,EAAE,uBAAuB,CAAC;CACjC,GAAG,IAAI,CAEP;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IACL,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,sBAAsB,CAAC;CAChC,GAAG,qBAAqB,GACxB,IAAI,CAON;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,IAAI,CAEP;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAEN;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,IAAI,CAUP;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAElE;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE;IACL,MAAM,EAAE,sBAAsB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,qBAAqB,GACxB,IAAI,CAON;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE;IACL,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,qBAAqB,GACxB,IAAI,CAON;AAED,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D"}