mozi-bot 1.0.0

package/dist/agents/failover-error.js

@@ -0,0 +1,171 @@
+/**
+ * 故障转移错误类型
+ */
+/** 故障转移错误 */
+export class FailoverError extends Error {
+    reason;
+    provider;
+    model;
+    status;
+    code;
+    constructor(message, params) {
+        super(message, { cause: params.cause });
+        this.name = "FailoverError";
+        this.reason = params.reason;
+        this.provider = params.provider;
+        this.model = params.model;
+        this.status = params.status;
+        this.code = params.code;
+    }
+}
+/** 检查是否为故障转移错误 */
+export function isFailoverError(err) {
+    return err instanceof FailoverError;
+}
+/** 超时相关的错误提示 */
+const TIMEOUT_HINT_RE = /timeout|timed out|deadline exceeded|context deadline exceeded/i;
+const ABORT_TIMEOUT_RE = /request was aborted|request aborted/i;
+/** 检查是否为超时错误 */
+export function isTimeoutError(err) {
+    if (!err || typeof err !== "object")
+        return false;
+    const name = err.name ?? "";
+    if (name === "TimeoutError")
+        return true;
+    const message = err.message ?? "";
+    if (TIMEOUT_HINT_RE.test(message))
+        return true;
+    if (name === "AbortError" && ABORT_TIMEOUT_RE.test(message))
+        return true;
+    const cause = err.cause;
+    if (cause && isTimeoutError(cause))
+        return true;
+    return false;
+}
+/** 获取错误状态码 */
+function getStatusCode(err) {
+    if (!err || typeof err !== "object")
+        return undefined;
+    const status = err.status ??
+        err.statusCode;
+    if (typeof status === "number")
+        return status;
+    if (typeof status === "string" && /^\d+$/.test(status))
+        return Number(status);
+    return undefined;
+}
+/** 获取错误代码 */
+function getErrorCode(err) {
+    if (!err || typeof err !== "object")
+        return undefined;
+    const code = err.code;
+    return typeof code === "string" ? code : undefined;
+}
+/** 获取错误消息 */
+function getErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === "string")
+        return err;
+    if (err && typeof err === "object") {
+        const message = err.message;
+        if (typeof message === "string")
+            return message;
+    }
+    return String(err);
+}
+/** 从错误消息分类故障原因 */
+function classifyFailoverReason(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes("billing") || lower.includes("quota") || lower.includes("insufficient")) {
+        return "billing";
+    }
+    if (lower.includes("rate limit") || lower.includes("too many requests")) {
+        return "rate_limit";
+    }
+    if (lower.includes("unauthorized") || lower.includes("invalid api key") || lower.includes("authentication")) {
+        return "auth";
+    }
+    if (lower.includes("timeout") || lower.includes("timed out")) {
+        return "timeout";
+    }
+    if (lower.includes("bad request") || lower.includes("invalid")) {
+        return "format";
+    }
+    if (lower.includes("unavailable") || lower.includes("overloaded")) {
+        return "unavailable";
+    }
+    return null;
+}
+/** 从错误推断故障原因 */
+export function resolveFailoverReasonFromError(err) {
+    if (isFailoverError(err))
+        return err.reason;
+    const status = getStatusCode(err);
+    if (status === 402)
+        return "billing";
+    if (status === 429)
+        return "rate_limit";
+    if (status === 401 || status === 403)
+        return "auth";
+    if (status === 408)
+        return "timeout";
+    if (status === 400)
+        return "format";
+    if (status === 503)
+        return "unavailable";
+    const code = getErrorCode(err)?.toUpperCase() ?? "";
+    if (["ETIMEDOUT", "ESOCKETTIMEDOUT", "ECONNRESET", "ECONNABORTED"].includes(code)) {
+        return "timeout";
+    }
+    if (isTimeoutError(err))
+        return "timeout";
+    const message = getErrorMessage(err);
+    return classifyFailoverReason(message);
+}
+/** 描述故障转移错误 */
+export function describeFailoverError(err) {
+    if (isFailoverError(err)) {
+        return {
+            message: err.message,
+            reason: err.reason,
+            status: err.status,
+            code: err.code,
+        };
+    }
+    return {
+        message: getErrorMessage(err),
+        reason: resolveFailoverReasonFromError(err) ?? undefined,
+        status: getStatusCode(err),
+        code: getErrorCode(err),
+    };
+}
+/** 将普通错误转换为故障转移错误 */
+export function coerceToFailoverError(err, context) {
+    if (isFailoverError(err))
+        return err;
+    const reason = resolveFailoverReasonFromError(err);
+    if (!reason)
+        return null;
+    return new FailoverError(getErrorMessage(err), {
+        reason,
+        provider: context?.provider,
+        model: context?.model,
+        status: getStatusCode(err),
+        code: getErrorCode(err),
+        cause: err instanceof Error ? err : undefined,
+    });
+}
+/** 根据原因获取建议的状态码 */
+export function resolveFailoverStatus(reason) {
+    switch (reason) {
+        case "billing": return 402;
+        case "rate_limit": return 429;
+        case "auth": return 401;
+        case "timeout": return 408;
+        case "format": return 400;
+        case "unavailable": return 503;
+        default: return undefined;
+    }
+}
+//# sourceMappingURL=failover-error.js.map

package/dist/agents/failover-error.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Agent 模块导出
+ */
+export * from "./agent.js";
+export * from "./compaction.js";
+export * from "./failover-error.js";
+export * from "./model-fallback.js";
+export * from "./system-prompt.js";
+export * from "./session-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,10 @@
+/**
+ * Agent 模块导出
+ */
+export * from "./agent.js";
+export * from "./compaction.js";
+export * from "./failover-error.js";
+export * from "./model-fallback.js";
+export * from "./system-prompt.js";
+export * from "./session-store.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/agents/model-fallback.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 模型故障转移系统
+ */
+import type { ProviderId, MoziConfig } from "../types/index.js";
+import { type FailoverReason } from "./failover-error.js";
+/** 故障尝试记录 */
+export interface FallbackAttempt {
+    provider: string;
+    model: string;
+    error: string;
+    reason?: FailoverReason;
+    status?: number;
+    code?: string;
+}
+/** 检查是否在冷却中 */
+export declare function isInCooldown(provider: string, model?: string): boolean;
+/** 设置冷却 */
+export declare function setCooldown(provider: string, reason: FailoverReason, model?: string): void;
+/** 清除冷却 */
+export declare function clearCooldown(provider: string, model?: string): void;
+/** 清除所有冷却 */
+export declare function clearAllCooldowns(): void;
+/** 带模型故障转移执行 */
+export declare function runWithModelFallback<T>(params: {
+    config?: MoziConfig;
+    provider: ProviderId;
+    model: string;
+    fallbacks?: Array<{
+        provider: ProviderId;
+        model: string;
+    }>;
+    run: (provider: ProviderId, model: string) => Promise<T>;
+    onError?: (attempt: {
+        provider: string;
+        model: string;
+        error: unknown;
+        attempt: number;
+        total: number;
+    }) => void | Promise<void>;
+    retryDelay?: number;
+    maxRetries?: number;
+}): Promise<{
+    result: T;
+    provider: ProviderId;
+    model: string;
+    attempts: FallbackAttempt[];
+}>;
+/** 简化的重试执行 */
+export declare function runWithRetry<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    retryDelay?: number;
+    onError?: (error: unknown, attempt: number) => void;
+}): Promise<T>;
+//# sourceMappingURL=model-fallback.d.ts.map

package/dist/agents/model-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-fallback.d.ts","sourceRoot":"","sources":["../../src/agents/model-fallback.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAY7B,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAqBD,eAAe;AACf,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAStE;AAED,WAAW;AACX,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAO1F;AAED,WAAW;AACX,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAGpE;AAED,aAAa;AACb,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAoED,gBAAgB;AAChB,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE;IACpD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,GAAG,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC,CAkHD;AAED,cAAc;AACd,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD,GACA,OAAO,CAAC,CAAC,CAAC,CAsBZ"}

package/dist/agents/model-fallback.js

@@ -0,0 +1,227 @@
+/**
+ * 模型故障转移系统
+ */
+import { getProvider, getAllProviders } from "../providers/index.js";
+import { isFailoverError, coerceToFailoverError, describeFailoverError, isTimeoutError, } from "./failover-error.js";
+import { getChildLogger } from "../utils/logger.js";
+import { delay } from "../utils/index.js";
+const logger = getChildLogger("failover");
+/** 冷却时间记录 */
+const cooldownMap = new Map();
+/** 冷却时间 (毫秒) */
+const COOLDOWN_DURATION = {
+    billing: 3600000, // 1 小时
+    rate_limit: 60000, // 1 分钟
+    auth: 300000, // 5 分钟
+    timeout: 30000, // 30 秒
+    format: 0, // 不冷却
+    unavailable: 60000, // 1 分钟
+    unknown: 10000, // 10 秒
+};
+/** 获取冷却键 */
+function getCooldownKey(provider, model) {
+    return model ? `${provider}:${model}` : provider;
+}
+/** 检查是否在冷却中 */
+export function isInCooldown(provider, model) {
+    const key = getCooldownKey(provider, model);
+    const until = cooldownMap.get(key);
+    if (!until)
+        return false;
+    if (Date.now() >= until) {
+        cooldownMap.delete(key);
+        return false;
+    }
+    return true;
+}
+/** 设置冷却 */
+export function setCooldown(provider, reason, model) {
+    const duration = COOLDOWN_DURATION[reason] ?? COOLDOWN_DURATION.unknown;
+    if (duration <= 0)
+        return;
+    const key = getCooldownKey(provider, model);
+    cooldownMap.set(key, Date.now() + duration);
+    logger.debug({ provider, model, reason, durationMs: duration }, "Set cooldown");
+}
+/** 清除冷却 */
+export function clearCooldown(provider, model) {
+    const key = getCooldownKey(provider, model);
+    cooldownMap.delete(key);
+}
+/** 清除所有冷却 */
+export function clearAllCooldowns() {
+    cooldownMap.clear();
+}
+/** 检查是否为中止错误 (不应重试) */
+function isAbortError(err) {
+    if (!err || typeof err !== "object")
+        return false;
+    if (isFailoverError(err))
+        return false;
+    const name = err.name ?? "";
+    return name === "AbortError";
+}
+/** 检查是否应该重新抛出中止错误 */
+function shouldRethrowAbort(err) {
+    return isAbortError(err) && !isTimeoutError(err);
+}
+/** 解析故障转移候选列表 */
+function resolveFallbackCandidates(params) {
+    const candidates = [];
+    const seen = new Set();
+    const addCandidate = (provider, model) => {
+        const key = `${provider}:${model}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        // 检查提供商是否可用
+        if (!getProvider(provider))
+            return;
+        candidates.push({ provider, model });
+    };
+    // 首选
+    addCandidate(params.provider, params.model);
+    // 指定的回退列表
+    if (params.fallbacks) {
+        for (const fb of params.fallbacks) {
+            addCandidate(fb.provider, fb.model);
+        }
+    }
+    // 默认回退: 同提供商的其他模型
+    const primaryProvider = getProvider(params.provider);
+    if (primaryProvider) {
+        for (const modelDef of primaryProvider.getModels()) {
+            if (modelDef.id !== params.model) {
+                addCandidate(params.provider, modelDef.id);
+            }
+        }
+    }
+    // 默认回退: 其他提供商
+    const otherProviders = getAllProviders().filter((p) => p.id !== params.provider);
+    for (const provider of otherProviders) {
+        const firstModel = provider.getModels()[0];
+        if (firstModel) {
+            addCandidate(provider.id, firstModel.id);
+        }
+    }
+    return candidates;
+}
+/** 带模型故障转移执行 */
+export async function runWithModelFallback(params) {
+    const candidates = resolveFallbackCandidates({
+        config: params.config,
+        provider: params.provider,
+        model: params.model,
+        fallbacks: params.fallbacks,
+    });
+    if (candidates.length === 0) {
+        throw new Error(`No available providers for ${params.provider}/${params.model}`);
+    }
+    const attempts = [];
+    let lastError;
+    const retryDelay = params.retryDelay ?? 1000;
+    const maxRetries = params.maxRetries ?? 1;
+    for (let i = 0; i < candidates.length; i++) {
+        const candidate = candidates[i];
+        // 检查冷却
+        if (isInCooldown(candidate.provider, candidate.model)) {
+            logger.debug({ ...candidate }, "Skipping candidate in cooldown");
+            attempts.push({
+                provider: candidate.provider,
+                model: candidate.model,
+                error: "Provider is in cooldown",
+                reason: "rate_limit",
+            });
+            continue;
+        }
+        // 重试循环
+        for (let retry = 0; retry <= maxRetries; retry++) {
+            try {
+                logger.debug({ ...candidate, attempt: i + 1, retry }, "Trying candidate");
+                const result = await params.run(candidate.provider, candidate.model);
+                return {
+                    result,
+                    provider: candidate.provider,
+                    model: candidate.model,
+                    attempts,
+                };
+            }
+            catch (err) {
+                // 检查是否应该重新抛出
+                if (shouldRethrowAbort(err))
+                    throw err;
+                // 转换为故障转移错误
+                const failoverErr = coerceToFailoverError(err, {
+                    provider: candidate.provider,
+                    model: candidate.model,
+                });
+                if (!failoverErr && !isFailoverError(err)) {
+                    // 不是可恢复的错误
+                    throw err;
+                }
+                lastError = failoverErr ?? err;
+                const described = describeFailoverError(lastError);
+                // 记录尝试
+                if (retry === maxRetries) {
+                    attempts.push({
+                        provider: candidate.provider,
+                        model: candidate.model,
+                        error: described.message,
+                        reason: described.reason,
+                        status: described.status,
+                        code: described.code,
+                    });
+                }
+                // 设置冷却
+                if (described.reason) {
+                    setCooldown(candidate.provider, described.reason, candidate.model);
+                }
+                // 通知错误
+                await params.onError?.({
+                    provider: candidate.provider,
+                    model: candidate.model,
+                    error: lastError,
+                    attempt: i + 1,
+                    total: candidates.length,
+                });
+                logger.warn({ ...candidate, error: described.message, reason: described.reason, retry }, "Candidate failed");
+                // 重试延迟
+                if (retry < maxRetries) {
+                    await delay(retryDelay * (retry + 1));
+                }
+            }
+        }
+    }
+    // 所有候选都失败
+    if (attempts.length <= 1 && lastError) {
+        throw lastError;
+    }
+    const summary = attempts
+        .map((a) => `${a.provider}/${a.model}: ${a.error}${a.reason ? ` (${a.reason})` : ""}`)
+        .join(" | ");
+    throw new Error(`All models failed (${attempts.length}): ${summary}`, {
+        cause: lastError instanceof Error ? lastError : undefined,
+    });
+}
+/** 简化的重试执行 */
+export async function runWithRetry(fn, options) {
+    const maxRetries = options?.maxRetries ?? 3;
+    const retryDelay = options?.retryDelay ?? 1000;
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (shouldRethrowAbort(err))
+                throw err;
+            lastError = err;
+            options?.onError?.(err, attempt);
+            if (attempt < maxRetries) {
+                await delay(retryDelay * attempt);
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=model-fallback.js.map

package/dist/agents/model-fallback.js.map

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

package/dist/agents/session-store.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 会话存储 - 支持内存和文件系统持久化
+ */
+import type { ChatMessage, SessionStoreConfig } from "../types/index.js";
+/** 会话数据 */
+export interface SessionData {
+    messages: ChatMessage[];
+    summary?: string;
+    lastUpdate: number;
+    totalTokensUsed: number;
+    metadata?: Record<string, unknown>;
+}
+/** 会话存储接口 */
+export interface SessionStore {
+    get(key: string): SessionData | undefined;
+    set(key: string, data: SessionData): void;
+    delete(key: string): boolean;
+    has(key: string): boolean;
+    keys(): string[];
+    clear(): void;
+}
+export declare class MemorySessionStore implements SessionStore {
+    private store;
+    private ttlMs;
+    constructor(ttlMs?: number);
+    get(key: string): SessionData | undefined;
+    set(key: string, data: SessionData): void;
+    delete(key: string): boolean;
+    has(key: string): boolean;
+    keys(): string[];
+    clear(): void;
+    private cleanup;
+}
+export declare class FileSessionStore implements SessionStore {
+    private directory;
+    private ttlMs;
+    private cache;
+    private cacheMaxAge;
+    constructor(directory?: string, ttlMs?: number);
+    private ensureDirectory;
+    private keyToFilename;
+    get(key: string): SessionData | undefined;
+    set(key: string, data: SessionData): void;
+    delete(key: string): boolean;
+    private deleteFile;
+    has(key: string): boolean;
+    keys(): string[];
+    clear(): void;
+    private cleanup;
+}
+/** 创建会话存储 */
+export declare function createSessionStore(config?: SessionStoreConfig): SessionStore;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/agents/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/agents/session-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKzE,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,KAAK,IAAI,IAAI,CAAC;CACf;AAID,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,SAAW;IAM5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IASzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IAIzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,IAAI,IAAI,MAAM,EAAE;IAKhB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,OAAO;CAQhB;AAiBD,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAA8D;IAC3E,OAAO,CAAC,WAAW,CAAU;gBAEjB,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,SAAW;IAShD,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,aAAa;IAMrB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAmCzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IA0BzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK5B,OAAO,CAAC,UAAU;IAalB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,IAAI,IAAI,MAAM,EAAE;IAWhB,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,OAAO;CA6BhB;AAID,aAAa;AACb,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAS5E"}