@chatcops/core 0.4.0 → 0.6.0

package/dist/protocol/v1.d.ts

@@ -0,0 +1,140 @@
+import type { JSONSchema, PageContext, ToolExecutor } from '../types.js';
+/**
+ * Version 1 of the stream between the widget and the server.
+ *
+ * The widget asks for it with `"protocol": 1` in the request body. A body
+ * field rather than a header, because servers before 0.6 only allow
+ * `Content-Type` in their CORS preflight. A server that doesn't know the field
+ * ignores it and answers in the old format, and the widget tells the two apart
+ * by the first part: v1 always starts with `start`.
+ *
+ * Every part is one SSE line, `data: <json>`. Clients ignore part types they
+ * don't know, so adding a part is not a version change; changing or removing
+ * one is.
+ */
+export declare const PROTOCOL_VERSION: 1;
+export type WireErrorCode = 'invalid_request' | 'session_required' | 'token_expired' | 'conversation_mismatch' | 'turnstile_failed' | 'origin_not_allowed' | 'conversation_busy' | 'payload_too_large' | 'rate_limited' | 'provider_unavailable' | 'provider_error' | 'tool_error' | 'budget_exceeded' | 'content_filtered' | 'internal_error' | 'timeout';
+export type WireFinishReason = 'stop' | 'length' | 'client-tool-calls' | 'approval-required' | 'handoff' | 'error' | 'aborted';
+export interface WireAgent {
+    name: string;
+    avatarUrl?: string;
+}
+export type WirePart = {
+    type: 'start';
+    protocol: typeof PROTOCOL_VERSION;
+    conversationId: string;
+    /** The id the server saves the reply under. */
+    messageId: string;
+    resumed?: boolean;
+    /** Optional server features the widget can turn on. */
+    capabilities?: {
+        session?: boolean;
+    };
+} | {
+    type: 'text-start';
+    id: string;
+} | {
+    type: 'text-delta';
+    id: string;
+    delta: string;
+} | {
+    type: 'text-end';
+    id: string;
+} | {
+    type: 'source';
+    sourceId: string;
+    url: string;
+    title?: string;
+    snippet?: string;
+} | {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    executor: ToolExecutor;
+    needsApproval?: boolean;
+    title?: string;
+} | {
+    type: 'tool-result';
+    toolCallId: string;
+    output?: unknown;
+    error?: string;
+} | {
+    type: 'lead-captured';
+    lead: Record<string, unknown>;
+} | {
+    type: 'handoff';
+    status: 'requested' | 'queued' | 'connected' | 'ended';
+    agent?: WireAgent;
+    pollAfterMs?: number;
+} | {
+    type: 'agent-message';
+    messageId: string;
+    text: string;
+    agent: WireAgent;
+    timestamp: number;
+} | {
+    type: 'suggestions';
+    items: string[];
+} | {
+    type: 'error';
+    code: WireErrorCode;
+    message?: string;
+    retryable: boolean;
+    retryAfterMs?: number;
+    scope?: 'conversation' | 'session' | 'ip' | 'global';
+} | {
+    type: 'finish';
+    reason: WireFinishReason;
+    /** Only sent when the server is configured to expose usage. */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    pendingToolCalls?: string[];
+    resumeToken?: string;
+};
+export type WirePartType = WirePart['type'];
+/** A tool the page offers, run in the browser (page tools). */
+export interface ClientToolManifest {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    needsApproval?: boolean;
+    title?: string;
+}
+export interface ChatRequestV1 {
+    protocol: typeof PROTOCOL_VERSION;
+    conversationId: string;
+    /** Absent when the request only sends tool results or approvals. */
+    message?: string;
+    messageId?: string;
+    /** `true` is the 0.5 form and regenerates the latest reply. */
+    regenerate?: boolean | {
+        assistantMessageId: string;
+    };
+    toolResults?: Array<{
+        toolCallId: string;
+        output?: unknown;
+        error?: string;
+    }>;
+    toolApprovals?: Array<{
+        toolCallId: string;
+        approved: boolean;
+        reason?: string;
+    }>;
+    resumeToken?: string;
+    clientTools?: ClientToolManifest[];
+    pageContext?: PageContext;
+    locale?: string;
+    userData?: Record<string, string>;
+}
+/** The JSON body of an error answered before the stream starts. */
+export interface WireErrorBody {
+    error: {
+        code: WireErrorCode;
+        message?: string;
+        retryAfterMs?: number;
+    };
+}
+//# sourceMappingURL=v1.d.ts.map

package/dist/protocol/v1.d.ts.map

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

package/dist/protocol/v1.js

@@ -0,0 +1,15 @@
+/**
+ * Version 1 of the stream between the widget and the server.
+ *
+ * The widget asks for it with `"protocol": 1` in the request body. A body
+ * field rather than a header, because servers before 0.6 only allow
+ * `Content-Type` in their CORS preflight. A server that doesn't know the field
+ * ignores it and answers in the old format, and the widget tells the two apart
+ * by the first part: v1 always starts with `start`.
+ *
+ * Every part is one SSE line, `data: <json>`. Clients ignore part types they
+ * don't know, so adding a part is not a version change; changing or removing
+ * one is.
+ */
+export const PROTOCOL_VERSION = 1;
+//# sourceMappingURL=v1.js.map

package/dist/protocol/v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.js","sourceRoot":"","sources":["../../src/protocol/v1.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC"}

package/dist/providers/base.d.ts

@@ -1,40 +1,29 @@
+import type { Logger } from '../logger.js';
 import type { Tool as GeminiTool } from '@google/genai';
-import type { ChatMessage, ProviderChatParams, ProviderConfig, ToolDefinition } from '../types.js';
-export interface AIProvider {
-    name: string;
-    chat(params: ProviderChatParams): AsyncGenerator<string>;
-    chatSync(params: ProviderChatParams): Promise<string>;
-}
+import type { ChatMessage, ProviderConfig, ToolDefinition } from '../types.js';
+import type { AIProvider } from './types.js';
+export type { AIProvider } from './types.js';
 /** Output token limit used when neither the server config nor the request sets one. */
 export declare const DEFAULT_MAX_TOKENS = 4096;
+/**
+ * True for a provider object, false for a provider config. A config never
+ * has functions, so an object with a `step` or `chat` function is a provider.
+ */
+export declare function isAIProvider(value: unknown): value is AIProvider;
 export declare function createProvider(config: ProviderConfig): Promise<AIProvider>;
 export declare function toProviderMessages(messages: ChatMessage[]): Array<{
     role: string;
     content: string;
 }>;
-export interface NormalizedMessage {
-    role: 'user' | 'assistant';
-    content: string;
-}
-/**
- * Turns stored messages into a history every provider accepts: it starts with
- * a user turn and alternates between user and assistant.
- *
- * - System messages and empty messages are dropped.
- * - Leading assistant turns are dropped (history trimming can leave one first).
- * - Consecutive turns with the same role are merged with a blank line, for
- *   example a user message saved before a provider call that then failed.
- */
-export declare function normalizeHistory(messages: ChatMessage[]): NormalizedMessage[];
+export { normalizeHistory, normalizeTurns, trimHistory, estimateTokens, type NormalizedMessage, type NormalizedTurn, type TurnPart, } from './history.js';
 /** Logs a configuration warning once per process. */
-export declare function warnOnce(key: string, message: string): void;
+export declare function warnOnce(logger: Logger, key: string, message: string): void;
 export declare function toClaudeTools(tools: ToolDefinition[]): {
     name: string;
     description: string;
     input_schema: {
         type: "object";
-        properties: Record<string, import("../types.js").ToolParameter>;
-        required: string[];
+        [key: string]: unknown;
     };
 }[];
 export declare function toOpenAITools(tools: ToolDefinition[]): {
@@ -42,11 +31,7 @@ export declare function toOpenAITools(tools: ToolDefinition[]): {
     function: {
         name: string;
         description: string;
-        parameters: {
-            type: "object";
-            properties: Record<string, import("../types.js").ToolParameter>;
-            required: string[];
-        };
+        parameters: import("../types.js").JSONSchema;
     };
 }[];
 export declare function toGeminiTools(tools: ToolDefinition[]): GeminiTool[];

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

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBhF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpG;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,iBAAiB,EAAE,CAiB7E;AAID,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3D;AAUD,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE;;;;;;;;IAMpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE;;;;;;;;;;;IASpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE,CAQnE"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAIhE;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBhF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpG;AAED,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC;AAItB,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE;;;kBAIb;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;IAEjF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE;;;;;;;IAapD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE,CAQnE"}

package/dist/providers/base.js

@@ -1,6 +1,21 @@
+import { toolInputSchema } from './schema.js';
+import { getProviderFactory } from './registry.js';
 /** Output token limit used when neither the server config nor the request sets one. */
 export const DEFAULT_MAX_TOKENS = 4096;
+/**
+ * True for a provider object, false for a provider config. A config never
+ * has functions, so an object with a `step` or `chat` function is a provider.
+ */
+export function isAIProvider(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.step === 'function' || typeof candidate.chat === 'function';
+}
 export async function createProvider(config) {
+    const factory = getProviderFactory(config.type);
+    if (factory)
+        return factory(config);
     switch (config.type) {
         case 'claude': {
             const { ClaudeProvider } = await import('./claude.js');
@@ -10,6 +25,10 @@ export async function createProvider(config) {
             const { OpenAIProvider } = await import('./openai.js');
             return new OpenAIProvider(config);
         }
+        case 'openai-compatible': {
+            const { OpenAIProvider } = await import('./openai.js');
+            return new OpenAIProvider(config, { compatible: true });
+        }
         case 'gemini': {
             const { GeminiProvider } = await import('./gemini.js');
             return new GeminiProvider(config);
@@ -23,72 +42,42 @@ export function toProviderMessages(messages) {
         .filter((m) => m.role !== 'system')
         .map((m) => ({ role: m.role, content: m.content }));
 }
-/**
- * Turns stored messages into a history every provider accepts: it starts with
- * a user turn and alternates between user and assistant.
- *
- * - System messages and empty messages are dropped.
- * - Leading assistant turns are dropped (history trimming can leave one first).
- * - Consecutive turns with the same role are merged with a blank line, for
- *   example a user message saved before a provider call that then failed.
- */
-export function normalizeHistory(messages) {
-    const normalized = [];
-    for (const message of messages) {
-        if (message.role !== 'user' && message.role !== 'assistant')
-            continue;
-        if (!message.content.trim())
-            continue;
-        if (normalized.length === 0 && message.role !== 'user')
-            continue;
-        const previous = normalized.at(-1);
-        if (previous && previous.role === message.role) {
-            previous.content += `\n\n${message.content}`;
-        }
-        else {
-            normalized.push({ role: message.role, content: message.content });
-        }
-    }
-    return normalized;
-}
+export { normalizeHistory, normalizeTurns, trimHistory, estimateTokens, } from './history.js';
 const warned = new Set();
 /** Logs a configuration warning once per process. */
-export function warnOnce(key, message) {
+export function warnOnce(logger, key, message) {
     if (warned.has(key))
         return;
     warned.add(key);
-    console.warn(`[chatcops] ${message}`);
-}
-function toJsonSchemaObject(tool) {
-    return {
-        type: 'object',
-        properties: tool.parameters,
-        required: tool.required,
-    };
+    logger.warn('config_warning', message, { key });
 }
 export function toClaudeTools(tools) {
     return tools.map((t) => ({
         name: t.name,
         description: t.description,
-        input_schema: toJsonSchemaObject(t),
+        input_schema: toolInputSchema(t),
     }));
 }
 export function toOpenAITools(tools) {
-    return tools.map((t) => ({
-        type: 'function',
-        function: {
-            name: t.name,
-            description: t.description,
-            parameters: toJsonSchemaObject(t),
-        },
-    }));
+    return tools.map((t) => {
+        const schema = toolInputSchema(t);
+        return {
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                // OpenAI rejects an object schema without `properties`.
+                parameters: 'properties' in schema ? schema : { ...schema, properties: {} },
+            },
+        };
+    });
 }
 export function toGeminiTools(tools) {
     return [{
             functionDeclarations: tools.map((t) => ({
                 name: t.name,
                 description: t.description,
-                parametersJsonSchema: toJsonSchemaObject(t),
+                parametersJsonSchema: toolInputSchema(t),
             })),
         }];
 }

package/dist/providers/base.js.map

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

package/dist/providers/claude.d.ts

@@ -1,5 +1,8 @@
-import type { ProviderConfig, ProviderChatParams } from '../types.js';
+import Anthropic from '@anthropic-ai/sdk';
+import type { ChatMessage, ProviderChatParams, ProviderConfig } from '../types.js';
 import type { AIProvider } from './base.js';
+import type { ProviderEvent, ProviderStepParams } from './types.js';
+import type { RetrievedChunk } from '../retrieval/types.js';
 interface ClaudeVersion {
     family: string;
     major: number;
@@ -9,20 +12,52 @@ interface ClaudeVersion {
 export declare function parseClaudeModel(model: string): ClaudeVersion | null;
 /** `output_config.effort` exists on Opus 4.5 and on every model from 4.6 on. */
 export declare function claudeSupportsEffort(model: string): boolean;
-/** Fable, Mythos, every 5.x model and Opus 4.7+ reject non-default `temperature`. */
+/**
+ * Fable, Mythos, every 5.x model and Opus 4.7+ reject non-default `temperature`.
+ * Since API version 2026-10-21 no Claude model takes it, so the provider no
+ * longer uses this; it stays exported for code that does.
+ */
 export declare function claudeRejectsTemperature(model: string): boolean;
+type MessageParam = Anthropic.Messages.MessageParam;
+/**
+ * Stored history as Claude messages. An assistant message with tool calls
+ * becomes the assistant turn with its `tool_use` blocks, then a user turn
+ * with the results, and so on for each step. Thinking blocks go back with
+ * their signatures, as Claude requires within a tool loop.
+ */
+export declare function toClaudeStepMessages(messages: ChatMessage[]): MessageParam[];
 export declare class ClaudeProvider implements AIProvider {
+    /** Retrieved chunks go to Claude as `search_result` blocks, and it cites them natively. */
+    readonly citations: "native";
     name: string;
     private client;
-    private model;
+    readonly model: string;
     private effort;
+    private promptCaching;
+    private readonly logger;
     constructor(config: ProviderConfig);
+    /**
+     * The system prompt, with a cache breakpoint after it. Claude caches tools
+     * and system together, in that order, so both are read from the cache on
+     * later requests. Per-request context goes after the breakpoint.
+     */
+    private system;
     private request;
-    /** Throws on stop reasons that mean the reply can't be used. */
-    private checkStopReason;
+    /** One model request: streams text and reasoning, then reports tool calls and why it stopped. */
+    step(params: ProviderStepParams): AsyncGenerator<ProviderEvent>;
+    /**
+     * A turn with tools run through `params.toolExecutor`, as text.
+     * @deprecated Use `runTurn()`, which also returns the reply's parts, status and usage.
+     */
     chat(params: ProviderChatParams): AsyncGenerator<string>;
+    /** @deprecated Use `runTurn()`. */
     chatSync(params: ProviderChatParams): Promise<string>;
-    private runTools;
 }
+/**
+ * Puts retrieved chunks before the visitor's latest message as `search_result`
+ * blocks, so Claude can cite them by index. Retrieved text travels as
+ * content, never in the system prompt. Tool results after it are left alone.
+ */
+export declare function withSearchResults(messages: MessageParam[], sources: RetrievedChunk[] | undefined): MessageParam[];
 export {};
 //# sourceMappingURL=claude.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/providers/claude.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAkB,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAW5C,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAIpE;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM/D;AA+CD,qBAAa,cAAe,YAAW,UAAU;IAC/C,IAAI,SAAY;IAChB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,EAAE,cAAc;IAclC,OAAO,CAAC,OAAO;IAqBf,gEAAgE;IAChE,OAAO,CAAC,eAAe;IAYhB,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC;IAgCzD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;YA0B7C,QAAQ;CAmBvB"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/providers/claude.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EACV,WAAW,EAEX,kBAAkB,EAClB,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM5C,OAAO,KAAK,EAAgB,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAIpE;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM/D;AAED,KAAK,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC;AAgDpD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,CA2C5E;AA0DD,qBAAa,cAAe,YAAW,UAAU;IAC/C,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAG,QAAQ,CAAU;IACvC,IAAI,SAAY;IAChB,OAAO,CAAC,MAAM,CAAY;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,cAAc;IAkBlC;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,OAAO;IAwBf,iGAAiG;IAC1F,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,aAAa,CAAC;IAsCtE;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC;IAIxD,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;CAGtD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,GAAG,YAAY,EAAE,CAiBjH"}