@cerebriline/llms 0.0.0-stage → 4.100.240

package/dist/providers/config.d.ts

@@ -0,0 +1,521 @@
+/**
+ * Provider Configuration Types
+ *
+ * Unified configuration interface for all providers.
+ * This replaces the per-provider config chaos with a single structure.
+ */
+import type { BasicLogger, ExtensionContext, ReasoningEffort, ReasoningHistorySetting } from "@cerebriline/shared";
+import type { ModelInfo, ProviderClient } from "../catalog/types";
+import { BUILT_IN_PROVIDER, BUILT_IN_PROVIDER_IDS, type BuiltInProviderId, isBuiltInProviderId, normalizeProviderId } from "./ids";
+export { BUILT_IN_PROVIDER, BUILT_IN_PROVIDER_IDS, type BuiltInProviderId, isBuiltInProviderId, normalizeProviderId, };
+/**
+ * All supported provider IDs (built-in + custom)
+ *
+ * Custom provider IDs can be registered via `registerHandler()` or `registerAsyncHandler()`.
+ * Any string is accepted to allow for custom handlers that extend BaseHandler.
+ */
+export type ProviderId = BuiltInProviderId | (string & {});
+/**
+ * Provider categories based on underlying SDK/protocol
+ */
+export type ProviderCategory = "anthropic" | "openai" | "openai-compat" | "openai-responses" | "gemini" | "bedrock" | "custom";
+/**
+ * Capabilities that a provider/model may support
+ */
+export type ProviderCapability = "reasoning" | "prompt-cache" | "streaming" | "tools" | "vision" | "computer-use" | "oauth";
+/**
+ * Authentication configuration
+ */
+export interface AuthConfig {
+    /** API key (most common) */
+    apiKey?: string;
+    /** OAuth access token */
+    accessToken?: string;
+    /** Refresh token for OAuth */
+    refreshToken?: string;
+    /** Account ID (for account-based auth) */
+    accountId?: string;
+    /** OAuth callback path (e.g., for Qwen Code) */
+    oauthPath?: string;
+}
+/**
+ * Endpoint configuration
+ */
+export interface EndpointConfig {
+    /** Base URL for the API */
+    baseUrl?: string;
+    /** Custom headers to include */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeoutMs?: number;
+    /**
+     * Custom `fetch` implementation used by the AI gateway providers when
+     * issuing requests. When supplied, it is forwarded to
+     * `GatewayProviderSettings.fetch` (and as a top-level fallback on
+     * `GatewayConfig.fetch`) so hosts can inject custom HTTP behavior such
+     * as proxies, retries, tracing, or test doubles.
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * Model configuration
+ */
+export interface ModelConfig {
+    /** Model identifier */
+    modelId: string;
+    /** Pre-fetched model info (optional - will use defaults if not provided) */
+    modelInfo?: ModelInfo;
+    /** Known models for this provider with their info */
+    knownModels?: Record<string, ModelInfo>;
+}
+/**
+ * Token limits configuration
+ */
+export interface TokenConfig {
+    /** Maximum input tokens (overrides model default) */
+    maxInputTokens?: number;
+    /** Maximum output tokens (overrides model default) */
+    maxOutputTokens?: number;
+    /**
+     * The per-turn cap to synthesize when no explicit one is requested.
+     *
+     * Distinct from {@link maxOutputTokens}, which is the user's own ceiling and
+     * goes on the wire as the request's cap. This is what the session resolved
+     * for itself -- a share of the window, or the Output Budget setting -- and
+     * is the figure its system prompt quotes. Carried separately so the number
+     * in the prompt and the number on the wire are the same one.
+     */
+    defaultMaxOutputTokens?: number;
+    /** Sampling temperature (overrides model default) */
+    temperature?: number;
+    /**
+     * Marks a config the machinery uses for its own calls -- summarising,
+     * condensing, titling -- rather than for the conversation.
+     *
+     * Carried through to `GatewayStreamRequest.auxiliary`, where it keeps the
+     * call from writing itself into the process-wide record of "the last
+     * request" that the next compaction pass reads.
+     */
+    auxiliary?: boolean;
+}
+/**
+ * Reasoning/thinking model configuration
+ */
+export interface ReasoningConfig {
+    /** Reasoning effort level */
+    reasoningEffort?: ReasoningEffort;
+    /** Extended thinking budget in tokens */
+    thinkingBudgetTokens?: number;
+    /** Enable thinking with provider/model defaults when supported */
+    thinking?: boolean;
+    /**
+     * How much prior assistant reasoning to send back, or `auto` to decide it
+     * per model from a measured capability. Unset means `auto`.
+     */
+    reasoningHistory?: ReasoningHistorySetting;
+    /**
+     * Whether `auto` may inline prior reasoning into content when the endpoint's
+     * template renders none of the reasoning field. Unset means on.
+     */
+    reasoningInline?: boolean;
+}
+/**
+ * Region configuration (shared across cloud providers)
+ */
+export interface RegionConfig {
+    /** Cloud region (AWS, GCP, Azure, or provider-specific like Qwen's china/international) */
+    region?: string;
+    /** API line for region-specific routing (e.g., "china" | "international" for Qwen) */
+    apiLine?: "china" | "international";
+    /** Use cross-region inference (Bedrock) */
+    useCrossRegionInference?: boolean;
+    /** Use global inference (Bedrock) */
+    useGlobalInference?: boolean;
+}
+/**
+ * AWS-specific configuration (for Bedrock)
+ */
+export interface AwsConfig {
+    accessKey?: string;
+    secretKey?: string;
+    sessionToken?: string;
+    authentication?: "iam" | "api-key" | "apikey" | "profile";
+    profile?: string;
+    usePromptCache?: boolean;
+    endpoint?: string;
+    customModelBaseId?: string;
+}
+/**
+ * Google Cloud configuration (for Vertex AI)
+ */
+export interface GcpConfig {
+    projectId?: string;
+    region?: string;
+}
+/**
+ * Azure configuration (for Azure OpenAI)
+ */
+export interface AzureConfig {
+    apiVersion?: string;
+    useIdentity?: boolean;
+}
+/**
+ * SAP AI Core configuration
+ */
+export interface SapConfig {
+    clientId?: string;
+    clientSecret?: string;
+    tokenUrl?: string;
+    resourceGroup?: string;
+    deploymentId?: string;
+    useOrchestrationMode?: boolean;
+    api?: "orchestration" | "foundation-models";
+    defaultSettings?: Record<string, unknown>;
+}
+/**
+ * OCA (Oracle Cloud AI) configuration
+ */
+export interface OcaConfig {
+    mode?: "internal" | "external";
+    usePromptCache?: boolean;
+}
+/**
+ * Codex CLI provider options
+ */
+export interface CodexConfig {
+    defaultSettings?: Record<string, unknown>;
+    modelSettings?: Record<string, unknown>;
+}
+/**
+ * Claude Code provider options
+ */
+export interface ClaudeCodeConfig {
+    [key: string]: unknown;
+}
+/**
+ * OpenCode provider options
+ */
+export interface OpenCodeConfig {
+    hostname?: string;
+    port?: number;
+    autoStartServer?: boolean;
+    serverTimeout?: number;
+    defaultSettings?: Record<string, unknown>;
+    modelSettings?: Record<string, unknown>;
+}
+/**
+ * Cloud provider configurations (grouped)
+ */
+export interface CloudConfig {
+    /** AWS/Bedrock options */
+    aws?: AwsConfig;
+    /** Google Cloud/Vertex options */
+    gcp?: GcpConfig;
+    /** Azure options */
+    azure?: AzureConfig;
+    /** SAP AI Core options */
+    sap?: SapConfig;
+    /** OCA options */
+    oca?: OcaConfig;
+}
+/**
+ * Sampling parameters passed through to a provider that exposes them.
+ *
+ * Every field is optional and nothing is defaulted: an unset field is one the
+ * request does not mention, which leaves whatever the model was built with in
+ * force. That matters for local models, where the Modelfile is where a
+ * validated sampler lives and a client that always sends a full set would
+ * silently overwrite it.
+ *
+ * The names are Ollama's own (`/api/chat` `options`), because this exists to
+ * carry them and inventing neutral synonyms would only make the mapping
+ * lossy. Providers that do not understand a field ignore the whole bag.
+ */
+export interface ProviderSamplingOptions {
+    temperature?: number;
+    topK?: number;
+    topP?: number;
+    minP?: number;
+    typicalP?: number;
+    repeatLastN?: number;
+    repeatPenalty?: number;
+    presencePenalty?: number;
+    frequencyPenalty?: number;
+    seed?: number;
+    numPredict?: number;
+    numKeep?: number;
+    /**
+     * How many model layers to put on the GPU. Ollama's `num_gpu`.
+     *
+     * Its own estimator decides this by default and is conservative: it has been
+     * measured refusing layers that fit, dropping a model to CPU without saying
+     * so. -1 leaves the decision to it; a number large enough to cover the model
+     * (99 is the usual idiom) means "all of them".
+     */
+    numGpu?: number;
+    stop?: string[];
+    /**
+     * Bound on how many tokens the model may spend inside a thinking block,
+     * as a token count or an effort level. Ollama's `think_budget`.
+     */
+    thinkBudget?: string;
+    /**
+     * Text written into the thinking block just before the closing tag is
+     * forced, so the model reads that it has to answer now. Ollama's
+     * `think_budget_message`.
+     */
+    thinkBudgetMessage?: string;
+}
+/**
+ * Provider-specific options that don't fit other categories
+ */
+export interface ProviderOptions {
+    /** OpenRouter provider sorting preference */
+    openRouterProviderSorting?: string;
+    /** Runtime model catalog refresh configuration */
+    modelCatalog?: ModelCatalogConfig;
+    /** Sampling parameters for providers that accept them per request. */
+    sampling?: ProviderSamplingOptions;
+    /** opencoti's PolyKV control plane. Inert for every other provider. */
+    polykv?: PolykvOptions;
+    /**
+     * The engine session requests built from this config run in (opencoti).
+     *
+     * On the config rather than only on an agent because some requests are
+     * built from a config alone -- the compaction summarizer is one. Without it
+     * each summary call arrived with no session, which the engine admits as a
+     * per-request allocation of the model's whole window: two or three extra
+     * sessions for every compaction, on the server the agents were queued on.
+     */
+    engineSessionId?: string;
+    /** Attach those requests to a PolyKV pool tree; see `polykv-swarm.ts`. */
+    polykvWorker?: {
+        group: string;
+        layers: number;
+        /** Attach to the agent's existing tree without building anything. */
+        attachOnly?: boolean;
+        /**
+         * Build the tree in this session's window -- the lead's own -- instead
+         * of an owner opened for the swarm: priority 0, PLANS §9g.
+         */
+        owner?: string;
+    };
+    /**
+     * One exact-size booking for the requests built from this config
+     * (opencoti), instead of whatever the session's window rules would ask.
+     *
+     * Set by compaction for the calls it makes outside the conversation's own
+     * booking -- a critic on a pool nobody owns, the synthesizer, the
+     * retrospective -- so each books the cells it can use and no more. Without
+     * it such a call is a per-request admission, which on this engine asks for
+     * `session_ctx_max`: a quarter of 8244 for a two-thousand-token answer.
+     *
+     * Transient: the grant it gets back is not recorded as the session's
+     * window, so the resume rule and the compaction trigger never size a
+     * conversation against a number that described one summary call.
+     */
+    polykvBooking?: {
+        numCtx: number;
+    };
+    /**
+     * `false`: never attach these requests to the lead tree, even when their
+     * system turn carries environment spans. A compaction critic continues the
+     * lead's prompt under a session of its own; the lead tree would hand it
+     * the lead's sub-pool, which is not the pool it was asked to attach to.
+     */
+    polykvLeadPool?: boolean;
+    /** Which tools this configuration withholds from its sessions. */
+    tools?: ToolSelectionOptions;
+    /**
+     * "Agent window" (opencoti): the floor a delegated agent's session accepts,
+     * as a share between the minimum one turn needs (0) and the node's window
+     * (100). Set by the host on an agent node's connection; inert elsewhere.
+     * See `opencoti-agent-window.ts`.
+     */
+    agentWindow?: {
+        sharePercent?: number;
+    };
+}
+/**
+ * The tools a configuration leaves out.
+ *
+ * A deny list, because the tool set grows: an allow list written today would
+ * withhold every tool added after it from every configuration that already
+ * exists, and the symptom would be a model that never calls a tool nobody
+ * remembers switching off.
+ *
+ * Names are the registered tool names, so an MCP tool appears under the name
+ * it was registered with rather than under `server__tool` -- the two differ
+ * whenever the transform had to rewrite or truncate the pair.
+ *
+ * Why a configuration and not a global setting: the reason to drop a tool is
+ * the window it has to fit in. The tool schemas are a fixed price paid before
+ * a single message exists -- measured at 21,000-24,000 tokens of a
+ * 65,536-token window -- so a profile pointed at a small local model and one
+ * pointed at a 400k cloud model want opposite answers, and only the profile
+ * knows which is which.
+ */
+export interface ToolSelectionOptions {
+    disabled?: string[];
+    /** Whether an oversized file-read window is refused. Absent means on. */
+    readLimitEnabled?: boolean;
+    /** The refusal threshold in characters. Absent means the built-in default. */
+    readLimitChars?: number;
+}
+/**
+ * How this session uses opencoti's KV pool tree, and what it asks the engine to
+ * enforce on its behalf.
+ *
+ * Shaped to match `PolykvSettingsSchema` in `@cerebriline/core` field for field, so a
+ * value typed into the settings panel reaches the vendor without a translation
+ * step that could drop one.
+ */
+export interface PolykvOptions {
+    enabled?: boolean;
+    pinPrefix?: boolean;
+    ephemeral?: boolean;
+    compactionPressureThreshold?: number;
+    targetTpsPerSession?: number;
+    mode?: "advisory" | "enforced";
+    onSaturation?: "reject" | "warn";
+    guaranteeMinSessions?: number;
+    settleTokens?: number;
+    settleMaxMs?: number;
+    prefillMaxSlots?: number;
+    overcommit?: boolean;
+    /**
+     * Whether the model may fan a task out across a swarm of workers sharing
+     * this session's prefix.
+     *
+     * Off by default, and deliberately: a swarm spends several agents' worth of
+     * tokens on one turn, and that is a decision worth making once rather than
+     * discovering in a bill.
+     */
+    swarm?: boolean;
+    maxRetryAfterMs?: number;
+    /**
+     * Book a guaranteed context window, and accept a smaller one down to
+     * `contextFloor`.
+     *
+     * **Off by default, and the default is the conservative one.** Asking for a
+     * window changes what a busy server does with the request: from serving it
+     * best-effort to refusing it at admission. That is a decision to make, not
+     * one to take on someone's behalf -- so with this off nothing is booked and
+     * the engine decides, exactly as before.
+     *
+     * On, the window asked for is the model's configured context size and the
+     * server grants the largest that fits in `[contextFloor, window]`.
+     */
+    dynamicContextSize?: boolean;
+    /**
+     * The smallest window still worth connecting with.
+     *
+     * Below it, a connection is worse than none: the conversation would open
+     * and immediately be unable to hold enough to be useful. With no floor set
+     * the ask is all-or-nothing, which is the honest reading of "I did not say
+     * what smaller would be acceptable".
+     */
+    contextFloor?: number;
+    /**
+     * Compaction runs as a continuation of the session: the summary is written
+     * in the session's own context, the reviewers continue from it, and the
+     * session's cells are given back before the replay is joined.
+     *
+     * **On by default** wherever the engine advertises what it needs; `false`
+     * turns it off and compaction re-sends the transcript as text, as before.
+     */
+    continuationCompaction?: boolean;
+}
+/**
+ * Runtime model catalog refresh options
+ */
+export interface ModelCatalogConfig {
+    /** Fetch latest catalog at handler initialization */
+    loadLatestOnInit?: boolean;
+    /** Fetch provider-private models when auth is available */
+    loadPrivateOnAuth?: boolean;
+    /** Catalog endpoint URL */
+    url?: string;
+    /** Cache TTL for live catalog in milliseconds */
+    cacheTtlMs?: number;
+    /** Throw when live catalog refresh fails */
+    failOnError?: boolean;
+}
+/**
+ * Unified provider configuration interface
+ *
+ * This is the single configuration interface that clients provide.
+ * All provider-specific options are grouped into logical sub-interfaces.
+ */
+export interface ProviderConfig extends AuthConfig, EndpointConfig, ModelConfig, TokenConfig, ReasoningConfig, RegionConfig, CloudConfig, ProviderOptions {
+    /** Client type - determines which handler to use - OpenAI-Compatible deafult */
+    clientType?: ProviderClient;
+    /** Provider ID */
+    providerId: ProviderId;
+    /**
+     * Optional built-in provider family to use for handler routing.
+     *
+     * This lets clients expose a custom provider ID and model catalog while
+     * reusing the runtime behavior of a built-in provider implementation.
+     */
+    routingProviderId?: ProviderId;
+    /** Capabilities this provider/model supports */
+    capabilities?: ProviderCapability[];
+    /** Task/session ID for telemetry */
+    taskId?: string;
+    /** AbortSignal for cancelling requests */
+    abortSignal?: AbortSignal;
+    /** Optional runtime logger for provider-level diagnostics */
+    logger?: BasicLogger;
+    /**
+     * Ambient runtime context: user identity, client surface, workspace info,
+     * logger, and telemetry service. Prefer reading logger and telemetry from
+     * here when available; the top-level logger field is kept for compatibility.
+     */
+    extensionContext?: ExtensionContext;
+    /** Codex CLI-specific options */
+    codex?: CodexConfig;
+    /** Claude Code-specific options */
+    claudeCode?: ClaudeCodeConfig;
+    /** OpenCode-specific options */
+    opencode?: OpenCodeConfig;
+}
+/**
+ * Simplified configuration for common use cases
+ */
+export interface SimpleProviderConfig {
+    providerId: ProviderId;
+    clientType: ProviderClient;
+    apiKey: string;
+    modelId: string;
+    baseUrl?: string;
+}
+/**
+ * Create a full ProviderConfig from a simple config
+ */
+export declare function createConfig(simple: SimpleProviderConfig): ProviderConfig;
+/**
+ * Check if a provider config has a specific capability
+ */
+export declare function hasCapability(config: ProviderConfig, capability: ProviderCapability): boolean;
+/**
+ * Check if provider supports reasoning/thinking
+ */
+export declare function supportsReasoning(config: ProviderConfig): boolean;
+/**
+ * Check if provider supports prompt caching
+ */
+export declare function supportsPromptCache(config: ProviderConfig): boolean;
+/**
+ * Resolve the provider ID used for handler selection and built-in behavior.
+ */
+export declare function resolveRoutingProviderId(config: Pick<ProviderConfig, "providerId" | "routingProviderId">): string;
+/**
+ * @deprecated Use ProviderConfig directly - all fields are now unified
+ */
+export type ProviderSpecificConfig = Pick<ProviderConfig, "aws" | "gcp" | "azure" | "sap" | "oca" | "maxInputTokens" | "apiLine" | "oauthPath" | "openRouterProviderSorting">;
+/**
+ * @deprecated Use ProviderConfig directly
+ */
+export type ProviderDefaultsConfig = Pick<ProviderConfig, "baseUrl" | "modelId" | "knownModels" | "headers" | "capabilities">;
+//# sourceMappingURL=config.d.ts.map

package/dist/providers/config.d.ts.map

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

package/dist/providers/error-classification.d.ts

@@ -0,0 +1,23 @@
+import { type ProviderErrorClass, type ToolCallRejection } from "@cerebriline/shared";
+/**
+ * Classify a raw provider error (or an already-flattened error message) into
+ * a {@link ProviderErrorClass}. Call this where the structured error object
+ * is still available — `extractErrorMessage` discards the structure this
+ * classification relies on.
+ *
+ * Typed AI SDK error instances are classified first via their typed fields;
+ * everything else — including plain JSON payloads that only *look* like AI
+ * SDK errors — goes through the conservative structural walk.
+ */
+export declare function classifyProviderError(error: unknown): ProviderErrorClass;
+/**
+ * The engine's account of a tool call it rejected, if the error carries one.
+ *
+ * Looks for opencoti's `{type: "tool_call_rejected", reason, key?, tool?}`
+ * anywhere in the error: on the object itself, under `error`, in an HTTP
+ * response body, or JSON-encoded in a message string (a streamed SSE `error`
+ * event arrives that way). `undefined` when there is none. The rejection is
+ * still classified from its message; only the specific wording is lost.
+ */
+export declare function extractToolCallRejection(error: unknown): ToolCallRejection | undefined;
+//# sourceMappingURL=error-classification.d.ts.map

package/dist/providers/error-classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.d.ts","sourceRoot":"","sources":["../../src/providers/error-classification.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACtB,MAAM,eAAe,CAAC;AAmcvB;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAqBxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,OAAO,GACZ,iBAAiB,GAAG,SAAS,CAE/B"}

package/dist/providers/errors.d.ts

@@ -0,0 +1,33 @@
+export declare const CLINE_NOT_SUBSCRIBED_RESPONSE_MESSAGE = "the user is not subscribed to required model plan";
+export declare const CLINE_ORG_INDIVIDUAL_INFERENCE_SUBSCRIPTION_RESPONSE_MESSAGE = "organization accounts cannot use individual model inference subscriptions";
+export declare function getClinePassSubscriptionUrl(): string;
+export declare function getClineNotSubscribedMessage(): string;
+export declare class ClineNotSubscribedError extends Error {
+    readonly providerId?: string;
+    constructor(providerId?: string);
+}
+export declare function getClineOrgIndividualInferenceSubscriptionMessage(): string;
+export declare class ClineOrgIndividualInferenceSubscriptionError extends Error {
+    readonly providerId?: string;
+    constructor(providerId?: string);
+}
+export declare class ClinePassLimitError extends Error {
+    readonly providerId?: string;
+    constructor(message: string, providerId?: string);
+}
+export declare class ClineFreeModelLimitError extends Error {
+    readonly providerId?: string;
+    constructor(message: string, providerId?: string);
+}
+export declare function isClineNotSubscribedError(error: unknown): error is ClineNotSubscribedError;
+export declare function isClineOrgIndividualInferenceSubscriptionError(error: unknown): error is ClineOrgIndividualInferenceSubscriptionError;
+export declare function isClinePassLimitError(error: unknown): error is ClinePassLimitError;
+export declare function isClineFreeModelLimitError(error: unknown): error is ClineFreeModelLimitError;
+export declare function isClineNotSubscribedMessage(text: string): boolean;
+export declare function isClineOrgIndividualInferenceSubscriptionMessage(text: string): boolean;
+export declare function isClinePassLimitMessage(text: string): boolean;
+export declare function extractClinePassLimitMessage(text: string): string | undefined;
+export declare function isClineFreeModelLimitMessage(text: string): boolean;
+export declare function isClineModelNotFoundMessage(text: string): boolean;
+export declare function extractClineFreeModelLimitResetTime(text: string): string | undefined;
+//# sourceMappingURL=errors.d.ts.map

package/dist/providers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/providers/errors.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qCAAqC,sDACE,CAAC;AAGrD,eAAO,MAAM,4DAA4D,8EACG,CAAC;AA+B7E,wBAAgB,2BAA2B,IAAI,MAAM,CAKpD;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,UAAU,CAAC,EAAE,MAAM;CAK/B;AAED,wBAAgB,iDAAiD,IAAI,MAAM,CAE1E;AAED,qBAAa,4CAA6C,SAAQ,KAAK;IACtE,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,UAAU,CAAC,EAAE,MAAM;CAK/B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKhD;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAClD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKhD;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,uBAAuB,CAElC;AAED,wBAAgB,8CAA8C,CAC7D,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,4CAA4C,CAEvD;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,mBAAmB,CAE9B;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,wBAAwB,CAEnC;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMjE;AAED,wBAAgB,gDAAgD,CAC/D,IAAI,EAAE,MAAM,GACV,OAAO,CAIT;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,mCAAmC,CAClD,IAAI,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAWpB"}