@agentick/core 0.0.1

package/dist/model/model-hooks.js

@@ -0,0 +1,24 @@
+import { BaseHookRegistry } from "../hooks/base-hook-registry";
+/**
+ * Model-specific hook registry.
+ * Uses BaseHookRegistry to reduce code duplication.
+ *
+ * Note: Global hooks via configureEngine() have been deprecated.
+ * Use Agentick.use() for middleware registration instead.
+ */
+export class ModelHookRegistry extends BaseHookRegistry {
+    getAllHookNames() {
+        return ["fromEngineState", "generate", "stream", "toEngineState"];
+    }
+    /**
+     * Get all middleware for a model hook.
+     * Returns instance-specific hooks only.
+     *
+     * Note: Global hooks via configureEngine() have been deprecated.
+     * Use Agentick.use() for middleware registration instead.
+     */
+    getMiddleware(hookName) {
+        return this.registry.getMiddleware(hookName, () => []);
+    }
+}
+//# sourceMappingURL=model-hooks.js.map

package/dist/model/model-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-hooks.js","sourceRoot":"","sources":["../../src/model/model-hooks.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AA6C/D;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAItC;IACW,eAAe;QACvB,OAAO,CAAC,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAU,CAAC;IAC7E,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAA0B,QAAW;QAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAChC,QAAQ,EACR,GAAG,EAAE,CAAC,EAAE,CACT,CAAC;IACJ,CAAC;CACF"}

package/dist/model/model.d.ts

@@ -0,0 +1,302 @@
+/**
+ * Model System
+ *
+ * EngineModel is the primary interface for models in the engine.
+ * Use createAdapter() from ./adapter.ts to create model adapters.
+ */
+import type { Procedure } from "@agentick/kernel";
+import type { ModelInput as BaseModelInput, ModelOutput as BaseModelOutput, ModelConfig as BaseModelConfig, ModelToolReference as BaseModelToolReference } from "@agentick/shared/models";
+import type { StreamEvent } from "@agentick/shared/streaming";
+import type { Message } from "@agentick/shared/messages";
+import type { COMInput, TokenEstimator } from "../com/types";
+import type { EngineResponse } from "../engine/engine-response";
+import type { EventBlock, TextBlock, ContentBlock } from "@agentick/shared";
+import type { LibraryGenerationOptions, ProviderGenerationOptions, DelimiterConfig, EventBlockDelimiters } from "../types";
+import type { ExecutableTool, ToolDefinition, ToolMetadata } from "../tool/tool";
+export type { BaseModelToolReference, BaseModelConfig, BaseModelInput, BaseModelOutput };
+/**
+ * EngineModel is the primary interface for models.
+ * All models (created via createAdapter) conform to this interface.
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@agentick/core/model';
+ *
+ * const model = createAdapter({
+ *   metadata: { id: 'my-model', provider: 'my-provider', capabilities: [] },
+ *   prepareInput: (input) => ({ ... }),
+ *   mapChunk: (chunk) => ({ type: 'text', delta: chunk.text }),
+ *   execute: (input) => provider.generate(input),
+ *   executeStream: (input) => provider.stream(input),
+ * });
+ * ```
+ */
+export interface EngineModel<TModelInput = ModelInput, TModelOutput = ModelOutput> {
+    /** Model metadata (id, description, capabilities, etc.) */
+    metadata: ModelMetadata;
+    /** Generate a response (non-streaming) */
+    generate: Procedure<(input: TModelInput) => Promise<TModelOutput>>;
+    /** Generate a streaming response */
+    stream?: Procedure<(input: TModelInput) => AsyncIterable<StreamEvent>>;
+    /** Convert engine state (COMInput) to model input */
+    fromEngineState?: (input: COMInput) => Promise<TModelInput>;
+    /** Convert model output to engine response */
+    toEngineState?: (output: TModelOutput) => Promise<EngineResponse>;
+    /** Aggregate stream events into final output */
+    processStream?: (events: StreamEvent[]) => Promise<TModelOutput>;
+    /** Transform model input to provider-specific format (for DevTools visibility) */
+    getProviderInput?: (input: TModelInput) => Promise<unknown>;
+}
+/**
+ * Type guard: checks if value is an EngineModel.
+ */
+export declare function isEngineModel(value: any): value is EngineModel;
+/**
+ * Unified message transformation configuration.
+ * Handles both event and ephemeral content transformation.
+ */
+export interface MessageTransformationConfig {
+    /**
+     * Preferred renderer for content formatting.
+     * Can be:
+     * - String: Static renderer type ('markdown' | 'xml')
+     * - Function: Dynamic renderer selection based on model ID
+     *
+     * @example
+     * preferredRenderer: 'markdown'
+     *
+     * @example
+     * preferredRenderer: (modelId: string) => {
+     *   if (modelId.includes('claude')) return 'markdown';
+     *   if (modelId.includes('gpt-4')) return 'markdown';
+     *   return 'markdown'; // default
+     * }
+     */
+    preferredRenderer?: "markdown" | "xml" | ((modelId: string, provider?: string) => "markdown" | "xml");
+    /**
+     * Role mapping for transformed messages.
+     * Controls how event/ephemeral messages are converted to model-understandable roles.
+     */
+    roleMapping?: {
+        /**
+         * Role to use for event messages.
+         * - 'user': Most compatible, treat as user context
+         * - 'developer': Use developer role (Claude, newer OpenAI)
+         * - 'event': Keep as event (adapter handles model-specific mapping)
+         * - 'system': Treat as system context
+         */
+        event?: "user" | "developer" | "event" | "system";
+        /**
+         * Role to use for ephemeral messages.
+         * - 'user': Most compatible
+         * - 'developer': Use developer role (Claude, newer OpenAI)
+         * - 'system': Treat as system context
+         */
+        ephemeral?: "user" | "developer" | "system";
+    };
+    /**
+     * Delimiter configuration for transformed content.
+     * When useDelimiters is true, content is wrapped with delimiters.
+     */
+    delimiters?: {
+        /** Delimiter for event content */
+        event?: DelimiterConfig | EventBlockDelimiters;
+        /** Delimiter for ephemeral content */
+        ephemeral?: DelimiterConfig;
+        /** Global toggle for delimiter usage */
+        useDelimiters?: boolean;
+    };
+    /**
+     * Custom formatter for full control over event block transformation.
+     * When provided, overrides delimiter-based formatting.
+     */
+    formatBlock?: (block: EventBlock | TextBlock) => ContentBlock[];
+    /**
+     * Position for ephemeral content in the message list (CSS-inspired).
+     * - 'flow': Keep in declaration order (default)
+     * - 'start': Move to beginning (after system)
+     * - 'end': Move to end
+     * - 'before-user': Move to just before last user message
+     * - 'after-system': Move to just after system messages
+     */
+    ephemeralPosition?: "flow" | "start" | "end" | "before-user" | "after-system";
+}
+export interface ModelCapabilities {
+    stream?: boolean;
+    toolCalls?: boolean;
+    provider?: string;
+    /**
+     * Message transformation configuration.
+     * Can be:
+     * - Static config object
+     * - Function that returns config based on model ID
+     *
+     * @example
+     * messageTransformation: {
+     *   preferredRenderer: 'markdown',
+     *   roleMapping: { event: 'user', ephemeral: 'user' }
+     * }
+     *
+     * @example
+     * messageTransformation: (modelId: string, provider?: string) => ({
+     *   preferredRenderer: modelId.includes('claude') ? 'markdown' : 'markdown',
+     *   roleMapping: {
+     *     event: provider === 'anthropic' ? 'developer' : 'user',
+     *     ephemeral: provider === 'anthropic' ? 'developer' : 'user'
+     *   }
+     * })
+     */
+    messageTransformation?: MessageTransformationConfig | ((modelId: string, provider?: string) => MessageTransformationConfig);
+}
+/**
+ * Model operations supported by adapters.
+ *
+ * Used by the Model component's `operation` prop to specify which
+ * model method to invoke during execution.
+ *
+ * Core operations (available on all language models):
+ * - 'generate': Non-streaming text generation (default)
+ * - 'stream': Streaming text generation
+ *
+ * Extended operations (adapter-specific, may require specific model types):
+ * - 'generateObject': Structured output generation
+ * - 'streamObject': Streaming structured output
+ * - 'generateImage': Image generation
+ * - 'editImage': Image editing
+ * - 'embed': Generate embeddings
+ * - 'countTokens': Token counting
+ * - 'transcribe': Audio to text
+ * - 'speak': Text to audio
+ */
+export type ModelOperation = "generate" | "stream" | "generateObject" | "streamObject" | "generateImage" | "editImage" | "embed" | "countTokens" | "transcribe" | "speak" | (string & {});
+export interface ModelMetadata {
+    id: string;
+    model?: string;
+    description?: string;
+    version?: string;
+    provider?: string;
+    type?: "language" | "image" | "embedding" | "vision";
+    capabilities: ModelCapabilities[];
+    /** Context window size in tokens (adapter-provided takes precedence over catalog) */
+    contextWindow?: number;
+    /** Maximum output tokens per response */
+    maxOutputTokens?: number;
+    /** Whether the model supports vision/image input */
+    supportsVision?: boolean;
+    /** Whether the model supports tool/function calling */
+    supportsToolUse?: boolean;
+    /** Whether this is a reasoning model (extended thinking) */
+    isReasoningModel?: boolean;
+    /** Token estimator function (e.g., tiktoken). If provided, used instead of default char/4 heuristic. */
+    tokenEstimator?: TokenEstimator;
+}
+/**
+ * Model input (normalized across all providers)
+ *
+ * Extends the base ModelInput from @agentick/shared with backend-specific fields.
+ */
+export interface ModelInput extends BaseModelInput {
+    /**
+     * Provider-specific generation options.
+     * Used for model generation/streaming calls and other operations.
+     * Each adapter can extend this type using module augmentation.
+     */
+    providerOptions?: ProviderGenerationOptions;
+    /**
+     * Adapter-specific options (keyed by library: ai-sdk, langchain, llamaindex, etc.).
+     * Used to pass library-specific configuration that isn't provider-specific.
+     * Each adapter package extends LibraryGenerationOptions via module augmentation.
+     *
+     * Note: If an adapter has its own providerOptions concept, provide them here
+     * under the adapter key. The adapter will merge them with ModelInput.providerOptions.
+     */
+    libraryOptions?: LibraryGenerationOptions;
+    /**
+     * Message transformation configuration.
+     * Controls how event and ephemeral messages are transformed for the model.
+     * Can be set per-request to override model-level defaults.
+     *
+     * @see MessageTransformationConfig
+     */
+    messageTransformation?: Partial<MessageTransformationConfig>;
+    /**
+     * Engine-level metadata
+     */
+    engineMetadata?: Record<string, unknown>;
+    /**
+     * Engine-level sections
+     */
+    engineSections?: Array<{
+        id: string;
+        title?: string;
+        content?: any;
+        visibility?: string;
+        audience?: "model" | "human" | "system";
+        ttlMs?: number;
+        ttlTicks?: number;
+    }>;
+    /**
+     * Cached content reference
+     */
+    cacheId?: string;
+}
+/**
+ * Model output (normalized across all providers)
+ *
+ * Extends the base ModelOutput from @agentick/shared with backend-specific fields.
+ */
+export interface ModelOutput extends BaseModelOutput {
+    /**
+     * Cache ID if content was cached
+     */
+    cacheId?: string;
+    /**
+     * Raw provider response
+     */
+    raw: any;
+}
+export type ModelToolReference = BaseModelToolReference | ToolDefinition | ToolMetadata | ExecutableTool;
+export interface NormalizedModelTool {
+    id: string;
+    metadata: ToolMetadata;
+}
+/**
+ * Normalized model input (after message normalization)
+ */
+export interface NormalizedModelInput extends Omit<ModelInput, "messages" | "tools"> {
+    messages: Message[];
+    model: string;
+    tools: NormalizedModelTool[];
+}
+/**
+ * Model operations interface
+ */
+export interface ModelOperations {
+    /**
+     * Generate completion (non-streaming)
+     */
+    generate: Procedure<(input: ModelInput) => ModelOutput>;
+    /**
+     * Generate completion (streaming)
+     */
+    stream: Procedure<(input: ModelInput) => AsyncIterable<StreamEvent>>;
+}
+/**
+ * Model configuration
+ *
+ * Extends the base ModelConfig from @agentick/shared with backend-specific fields.
+ */
+export interface ModelConfig extends BaseModelConfig {
+    /**
+     * Provider-specific generation options.
+     * Used for model generation/streaming calls and other operations.
+     */
+    providerOptions?: Record<string, any>;
+    /**
+     * Message transformation configuration.
+     * Controls how event and ephemeral messages are transformed for the model.
+     * @see MessageTransformationConfig
+     */
+    messageTransformation?: Partial<MessageTransformationConfig>;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model/model.d.ts.map

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

package/dist/model/model.js

@@ -0,0 +1,20 @@
+/**
+ * Model System
+ *
+ * EngineModel is the primary interface for models in the engine.
+ * Use createAdapter() from ./adapter.ts to create model adapters.
+ */
+// ============================================================================
+// Utilities
+// ============================================================================
+/**
+ * Type guard: checks if value is an EngineModel.
+ */
+export function isEngineModel(value) {
+    return (value &&
+        typeof value === "object" &&
+        "metadata" in value &&
+        "generate" in value &&
+        typeof value.generate === "function");
+}
+//# sourceMappingURL=model.js.map

package/dist/model/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/model/model.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoEH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAU;IACtC,OAAO,CACL,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,UAAU,IAAI,KAAK;QACnB,UAAU,IAAI,KAAK;QACnB,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,CACrC,CAAC;AACJ,CAAC"}

package/dist/model/simple-adapter.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Simple Adapter - Minimal API for creating model adapters
+ *
+ * This provides the simplest possible API for creating adapters.
+ * Adapters only need to implement:
+ * 1. prepareInput - convert engine input to provider format
+ * 2. mapChunk - convert provider chunk to AdapterDelta
+ * 3. execute/executeStream - call the provider
+ *
+ * The framework handles everything else (accumulation, events, etc.).
+ *
+ * @module tentickle/model/simple-adapter
+ */
+import type { COMInput } from "../com/types";
+import type { EngineResponse } from "../engine/engine-response";
+import type { EngineModel, ModelInput, ModelOutput, ModelMetadata } from "./model";
+import { type AdapterDelta, type ChunkMapping } from "./stream-accumulator";
+/**
+ * Options for createSimpleAdapter.
+ *
+ * This is the minimal interface for creating an adapter. Compare to the
+ * full createModel API which requires implementing transformers.processChunk,
+ * transformers.processOutput, transformers.processStream, etc.
+ *
+ * @example
+ * ```typescript
+ * const model = createSimpleAdapter({
+ *   metadata: { id: 'openai:gpt-4', provider: 'openai', capabilities: [{ stream: true, toolCalls: true }] },
+ *
+ *   prepareInput: (input) => ({
+ *     model: 'gpt-4',
+ *     messages: input.messages.map(toOpenAIMessage),
+ *     tools: input.tools?.map(toOpenAITool),
+ *   }),
+ *
+ *   mapChunk: (chunk) => {
+ *     if (chunk.choices?.[0]?.delta?.content) {
+ *       return { type: 'text', delta: chunk.choices[0].delta.content };
+ *     }
+ *     return null;
+ *   },
+ *
+ *   execute: async (input) => openai.chat.completions.create(input),
+ *   executeStream: (input) => openai.chat.completions.create({ ...input, stream: true }),
+ * });
+ * ```
+ */
+export interface SimpleAdapterOptions<TProviderInput, TProviderOutput, TChunk> {
+    /** Model metadata */
+    metadata: ModelMetadata;
+    /**
+     * Convert engine ModelInput to provider-specific input format.
+     * This is the only complex transformation you need to implement.
+     */
+    prepareInput: (input: ModelInput) => TProviderInput | Promise<TProviderInput>;
+    /**
+     * Map a provider stream chunk to an AdapterDelta.
+     * Return null to skip/ignore the chunk.
+     *
+     * This replaces the 200+ line switch statement in typical adapters.
+     *
+     * @example
+     * ```typescript
+     * mapChunk: (chunk) => {
+     *   if (chunk.type === 'text-delta') return { type: 'text', delta: chunk.text };
+     *   if (chunk.type === 'tool-call') return { type: 'tool_call', id: chunk.id, name: chunk.name, input: chunk.args };
+     *   if (chunk.type === 'finish') return { type: 'message_end', stopReason: StopReason.STOP };
+     *   return null;
+     * }
+     * ```
+     */
+    mapChunk: (chunk: TChunk) => AdapterDelta | null;
+    /**
+     * Execute non-streaming generation.
+     */
+    execute: (input: TProviderInput) => Promise<TProviderOutput>;
+    /**
+     * Execute streaming generation.
+     * Returns an async iterable of provider chunks.
+     */
+    executeStream?: (input: TProviderInput) => AsyncIterable<TChunk>;
+    /**
+     * Convert non-streaming provider output to ModelOutput.
+     * Optional - if not provided, streaming will be used and accumulated.
+     */
+    processOutput?: (output: TProviderOutput) => ModelOutput | Promise<ModelOutput>;
+    /**
+     * Custom fromEngineState (optional).
+     * Converts COMInput to ModelInput before prepareInput.
+     * Most adapters don't need this - the default handles standard transformations.
+     */
+    fromEngineState?: (input: COMInput) => ModelInput | Promise<ModelInput>;
+    /**
+     * Custom toEngineState (optional).
+     * Converts ModelOutput to EngineResponse.
+     * Most adapters don't need this - the default handles standard transformations.
+     */
+    toEngineState?: (output: ModelOutput) => EngineResponse | Promise<EngineResponse>;
+}
+/**
+ * Declarative options using ChunkMapping instead of mapChunk function.
+ */
+export interface DeclarativeAdapterOptions<TProviderInput, TProviderOutput, TChunk> extends Omit<SimpleAdapterOptions<TProviderInput, TProviderOutput, TChunk>, "mapChunk"> {
+    /**
+     * Declarative chunk mapping.
+     * Alternative to mapChunk for simple cases.
+     */
+    chunkMapping: ChunkMapping<TChunk>;
+}
+/**
+ * Create an adapter with the simplest possible API.
+ *
+ * This wraps createLanguageModel with sensible defaults:
+ * - Uses StreamAccumulator for stream handling (no manual accumulation)
+ * - Uses default fromEngineState/toEngineState (standard transformations)
+ * - Automatically generates StreamEvents from AdapterDeltas
+ *
+ * @example
+ * ```typescript
+ * import { createSimpleAdapter, StopReason } from '@tentickle/core/model';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * const model = createSimpleAdapter({
+ *   metadata: {
+ *     id: 'ai-sdk:gpt-4',
+ *     provider: 'ai-sdk',
+ *     capabilities: [{ stream: true, toolCalls: true }],
+ *   },
+ *
+ *   prepareInput: (input) => ({
+ *     model: openai('gpt-4'),
+ *     messages: toAiSdkMessages(input.messages),
+ *     tools: convertToolsToToolSet(input.tools),
+ *   }),
+ *
+ *   mapChunk: (chunk) => {
+ *     switch (chunk.type) {
+ *       case 'text-delta': return { type: 'text', delta: chunk.text };
+ *       case 'reasoning-delta': return { type: 'reasoning', delta: chunk.text };
+ *       case 'tool-call': return { type: 'tool_call', id: chunk.toolCallId, name: chunk.toolName, input: chunk.args };
+ *       case 'finish': return { type: 'message_end', stopReason: StopReason.STOP, usage: chunk.totalUsage };
+ *       default: return null;
+ *     }
+ *   },
+ *
+ *   execute: (input) => generateText(input),
+ *   executeStream: (input) => streamText(input).fullStream,
+ * });
+ * ```
+ */
+export declare function createSimpleAdapter<TProviderInput, TProviderOutput, TChunk>(options: SimpleAdapterOptions<TProviderInput, TProviderOutput, TChunk>): EngineModel<ModelInput, ModelOutput>;
+/**
+ * Create an adapter using declarative chunk mapping.
+ *
+ * This is even simpler than createSimpleAdapter for cases where
+ * chunk mapping can be expressed declaratively.
+ *
+ * @example
+ * ```typescript
+ * const model = createDeclarativeAdapter({
+ *   metadata: { id: 'my-model', ... },
+ *   prepareInput: (input) => ({ ... }),
+ *   execute: (input) => provider.call(input),
+ *   executeStream: (input) => provider.stream(input),
+ *   chunkMapping: {
+ *     text: { type: 'text-delta', extract: (c) => c.text },
+ *     toolCall: { type: 'tool-call', extract: (c) => ({ id: c.id, name: c.name, input: c.args }) },
+ *     messageEnd: { type: 'finish', extract: (c) => ({ stopReason: StopReason.STOP }) },
+ *   },
+ * });
+ * ```
+ */
+export declare function createDeclarativeAdapter<TProviderInput, TProviderOutput, TChunk extends {
+    type: string;
+}>(options: DeclarativeAdapterOptions<TProviderInput, TProviderOutput, TChunk>): EngineModel<ModelInput, ModelOutput>;
+//# sourceMappingURL=simple-adapter.d.ts.map

package/dist/model/simple-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-adapter.d.ts","sourceRoot":"","sources":["../../src/model/simple-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEnF,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EAElB,MAAM,sBAAsB,CAAC;AAQ9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,oBAAoB,CAAC,cAAc,EAAE,eAAe,EAAE,MAAM;IAC3E,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IAExB;;;OAGG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE9E;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;IAEjD;;OAEG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAE7D;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC;IAEjE;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEhF;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAExE;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,cAAc,EAAE,eAAe,EAAE,MAAM,CAAE,SAAQ,IAAI,CAC9F,oBAAoB,CAAC,cAAc,EAAE,eAAe,EAAE,MAAM,CAAC,EAC7D,UAAU,CACX;IACC;;;OAGG;IACH,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;CACpC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,eAAe,EAAE,MAAM,EACzE,OAAO,EAAE,oBAAoB,CAAC,cAAc,EAAE,eAAe,EAAE,MAAM,CAAC,GACrE,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAwGtC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EACd,eAAe,EACf,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAE/B,OAAO,EAAE,yBAAyB,CAAC,cAAc,EAAE,eAAe,EAAE,MAAM,CAAC,GAC1E,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAQtC"}