@wandoupeas/coding-forge 0.1.0

package/dist/core/harness-hints.d.ts

@@ -0,0 +1,43 @@
+import type { AgentPermissionProfile, Task, WorkspaceSuperpowersCapability, WorkspaceState } from '../types/index.js';
+export interface SuperpowersHints {
+    enabled: boolean;
+    requiredSkills: string[];
+    taskSkills: string[];
+    executionMode: 'subagent' | 'inline' | null;
+    suggestedWorkflow: string | null;
+    capabilities: WorkspaceSuperpowersCapability[];
+}
+export interface PermissionHints {
+    profile: AgentPermissionProfile;
+    canWriteWorkspace: boolean;
+    requiresApproval: boolean;
+    allowedActions: string[];
+    blockedActions: string[];
+}
+export interface ObservationSnapshot {
+    counts: {
+        readyTasks: number;
+        blockedTasks: number;
+        pendingReview: number;
+        unreadMessages: number;
+        knowledgeItems: number;
+        taskDeliverables: number;
+        relatedSessions: number;
+    };
+    readyTaskIds: string[];
+    blockedTaskIds: string[];
+    pendingReviewIds: string[];
+    workersWithUnread: string[];
+    mailbox: {
+        workerId: string | null;
+        unreadForWorker: number;
+    };
+}
+export declare function loadSuperpowersHints(basePath: string, task: Task): Promise<SuperpowersHints>;
+export declare function loadPermissionHints(basePath: string): Promise<PermissionHints>;
+export declare function buildObservationSnapshot(basePath: string, workspace: WorkspaceState, options?: {
+    taskId: string;
+    relatedSessionCount: number;
+    workerId?: string;
+}): Promise<ObservationSnapshot>;
+//# sourceMappingURL=harness-hints.d.ts.map

package/dist/core/harness-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-hints.d.ts","sourceRoot":"","sources":["../../src/core/harness-hints.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,sBAAsB,EACtB,IAAI,EACJ,8BAA8B,EAC9B,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC5C,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,8BAA8B,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,sBAAsB,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,gBAAgB,CAAC,CAsB3B;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAoCpF;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,cAAc,EACzB,OAAO,GAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAGxE,GACA,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}

package/dist/core/harness-hints.js

@@ -0,0 +1,162 @@
+import { existsSync } from 'fs';
+import { readdir } from 'fs/promises';
+import { join } from 'path';
+import { Mailbox } from './mailbox.js';
+import { loadSuperpowersRegistry } from './superpowers-registry.js';
+import { loadConfig } from '../utils/config.js';
+export async function loadSuperpowersHints(basePath, task) {
+    const registry = await loadSuperpowersRegistry(basePath);
+    const requiredSkills = registry.required;
+    const taskSkills = normalizeStringList(task.metadata?.skills);
+    const executionMode = normalizeExecutionMode(task.metadata?.execution) ??
+        registry.execution ??
+        null;
+    const enabled = task.metadata?.superpowers === true ||
+        taskSkills.length > 0 ||
+        requiredSkills.length > 0 ||
+        executionMode !== null;
+    return {
+        enabled,
+        requiredSkills,
+        taskSkills,
+        executionMode,
+        suggestedWorkflow: deriveSuggestedWorkflow(task, enabled, executionMode),
+        capabilities: registry.capabilities
+    };
+}
+export async function loadPermissionHints(basePath) {
+    let profile = 'workspace-write';
+    try {
+        const config = await loadConfig(basePath);
+        profile = config.agent?.permission_profile ?? profile;
+    }
+    catch {
+        // config 不存在时回退到默认 profile
+    }
+    switch (profile) {
+        case 'read-only':
+            return {
+                profile,
+                canWriteWorkspace: false,
+                requiresApproval: true,
+                allowedActions: ['read:workspace', 'inspect:state', 'review:deliverables'],
+                blockedActions: ['write:workspace', 'mutate:state', 'external:side-effects']
+            };
+        case 'approval-required':
+            return {
+                profile,
+                canWriteWorkspace: false,
+                requiresApproval: true,
+                allowedActions: ['read:workspace', 'plan:changes', 'propose:edits'],
+                blockedActions: ['apply:workspace-writes', 'destructive:actions', 'external:side-effects']
+            };
+        default:
+            return {
+                profile: 'workspace-write',
+                canWriteWorkspace: true,
+                requiresApproval: false,
+                allowedActions: ['read:workspace', 'write:workspace', 'mutate:state'],
+                blockedActions: ['external:side-effects']
+            };
+    }
+}
+export async function buildObservationSnapshot(basePath, workspace, options = {
+    taskId: '',
+    relatedSessionCount: 0
+}) {
+    const readyTasks = workspace.tasks.tasks
+        .filter((item) => item.status === 'ready')
+        .sort(sortTasksByPriority);
+    const blockedTasks = workspace.tasks.tasks
+        .filter((item) => item.status === 'blocked')
+        .sort(sortTasksByPriority);
+    const pendingReview = workspace.indexes.deliverables
+        .filter((item) => item.status === 'pending_review')
+        .sort((left, right) => left.taskId.localeCompare(right.taskId));
+    const unreadByWorker = await collectUnreadMailboxCounts(basePath);
+    const workersWithUnread = Object.entries(unreadByWorker)
+        .filter(([, count]) => count > 0)
+        .map(([workerId]) => workerId)
+        .sort();
+    const unreadMessages = Object.values(unreadByWorker).reduce((sum, count) => sum + count, 0);
+    return {
+        counts: {
+            readyTasks: readyTasks.length,
+            blockedTasks: blockedTasks.length,
+            pendingReview: pendingReview.length,
+            unreadMessages,
+            knowledgeItems: workspace.indexes.knowledge.length,
+            taskDeliverables: workspace.indexes.deliverables.filter((item) => item.taskId === options.taskId).length,
+            relatedSessions: options.relatedSessionCount
+        },
+        readyTaskIds: readyTasks.map((item) => item.id),
+        blockedTaskIds: blockedTasks.map((item) => item.id),
+        pendingReviewIds: pendingReview.map((item) => item.id),
+        workersWithUnread,
+        mailbox: {
+            workerId: options.workerId ?? null,
+            unreadForWorker: options.workerId !== undefined ? (unreadByWorker[options.workerId] ?? 0) : 0
+        }
+    };
+}
+function deriveSuggestedWorkflow(task, enabled, executionMode) {
+    if (!enabled) {
+        return null;
+    }
+    const normalized = `${task.title} ${task.description ?? ''}`.toLowerCase();
+    if (/(需求|分析|架构|设计|方案|research|discovery|spec|prd|architecture|design)/.test(normalized)) {
+        return 'brainstorming';
+    }
+    if (executionMode === 'subagent') {
+        return 'subagent-driven-development';
+    }
+    return 'writing-plans';
+}
+async function collectUnreadMailboxCounts(basePath) {
+    const counts = {};
+    const workerIds = await discoverMailboxWorkers(basePath);
+    for (const workerId of workerIds) {
+        const mailbox = new Mailbox(workerId, basePath);
+        await mailbox.init();
+        counts[workerId] = await mailbox.getUnreadCount();
+    }
+    return counts;
+}
+async function discoverMailboxWorkers(basePath) {
+    const workers = new Set();
+    try {
+        const config = await loadConfig(basePath);
+        for (const workerId of config.workers) {
+            workers.add(workerId);
+        }
+    }
+    catch {
+        // config 对 observation 不是强依赖
+    }
+    const mailboxRoot = join(basePath, '.webforge', 'mailboxes');
+    if (existsSync(mailboxRoot)) {
+        const entries = await readdir(mailboxRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.endsWith('.jsonl')) {
+                workers.add(entry.name.slice(0, -'.jsonl'.length));
+            }
+        }
+    }
+    return Array.from(workers).sort();
+}
+function normalizeExecutionMode(value) {
+    return value === 'subagent' || value === 'inline' ? value : null;
+}
+function normalizeStringList(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return Array.from(new Set(value.filter((item) => typeof item === 'string' && item.length > 0)));
+}
+function sortTasksByPriority(left, right) {
+    if (left.priority !== right.priority) {
+        return left.priority - right.priority;
+    }
+    return left.id.localeCompare(right.id);
+}
+//# sourceMappingURL=harness-hints.js.map

package/dist/core/harness-hints.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 执行日志系统
+ * 记录所有执行操作的日志
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: 'info' | 'success' | 'warning' | 'error';
+    message: string;
+    taskId?: string;
+    workerId?: string;
+    metadata?: Record<string, any>;
+}
+export interface ExecutionLog {
+    sessionId: string;
+    startTime: string;
+    endTime?: string;
+    command: string;
+    entries: LogEntry[];
+    stats: {
+        tasksCompleted: number;
+        tasksFailed: number;
+        deliverablesCreated: number;
+    };
+}
+export interface RuntimeObservationEventSummary {
+    timestamp: string;
+    message: string;
+    taskId: string | null;
+    workerId: string | null;
+    permissionProfile: string | null;
+    stage: string | null;
+    result: string | null;
+    reason: string | null;
+}
+export interface RuntimeObservationSummary {
+    sessionId: string;
+    startTime: string;
+    endTime?: string;
+    completed: number;
+    failed: number;
+    blocked: number;
+    deliverables: number;
+    lastEvent: string | null;
+    lastTaskId: string | null;
+    permissionProfile: string | null;
+    signals: {
+        readyTasks: number;
+        blockedTasks: number;
+        pendingReview: number;
+        unreadMessages: number;
+    } | null;
+    events: RuntimeObservationEventSummary[];
+    recentEvents: RuntimeObservationEventSummary[];
+}
+/**
+ * 日志管理器
+ */
+export declare class LogManager {
+    private sessionId;
+    private log;
+    private logPath;
+    private basePath;
+    constructor(command: string, basePath?: string, sessionId?: string);
+    /**
+     * 记录日志
+     */
+    addEntry(level: LogEntry['level'], message: string, options?: {
+        taskId?: string;
+        workerId?: string;
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    /**
+     * 记录任务完成
+     */
+    taskCompleted(): void;
+    /**
+     * 记录任务失败
+     */
+    taskFailed(): void;
+    /**
+     * 记录交付物创建
+     */
+    deliverableCreated(): void;
+    /**
+     * 结束会话
+     */
+    end(): Promise<void>;
+    /**
+     * 保存日志
+     */
+    private save;
+    getSessionId(): string;
+}
+/**
+ * 读取历史日志
+ */
+export declare function getExecutionLogs(basePath?: string): Promise<ExecutionLog[]>;
+/**
+ * 获取指定会话的日志
+ */
+export declare function getLog(sessionId: string, basePath?: string): Promise<ExecutionLog | null>;
+export declare function getLatestRuntimeObservation(basePath?: string): Promise<RuntimeObservationSummary | null>;
+export declare function getRuntimeObservation(sessionId: string, basePath?: string): Promise<RuntimeObservationSummary | null>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

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

package/dist/core/logger.js

@@ -0,0 +1,199 @@
+/**
+ * 执行日志系统
+ * 记录所有执行操作的日志
+ */
+import { writeFile, readFile } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { ensureDir } from '../utils/file.js';
+const LOGS_DIR = '.webforge/logs';
+/**
+ * 日志管理器
+ */
+export class LogManager {
+    sessionId;
+    log;
+    logPath;
+    basePath;
+    constructor(command, basePath = process.cwd(), sessionId) {
+        this.basePath = basePath;
+        this.sessionId = sessionId ?? `session-${Date.now()}`;
+        this.log = {
+            sessionId: this.sessionId,
+            startTime: new Date().toISOString(),
+            command,
+            entries: [],
+            stats: {
+                tasksCompleted: 0,
+                tasksFailed: 0,
+                deliverablesCreated: 0
+            }
+        };
+        this.logPath = join(this.basePath, LOGS_DIR, `${this.sessionId}.json`);
+    }
+    /**
+     * 记录日志
+     */
+    async addEntry(level, message, options) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...options
+        };
+        this.log.entries.push(entry);
+        // 实时写入文件
+        await this.save();
+    }
+    /**
+     * 记录任务完成
+     */
+    taskCompleted() {
+        this.log.stats.tasksCompleted++;
+    }
+    /**
+     * 记录任务失败
+     */
+    taskFailed() {
+        this.log.stats.tasksFailed++;
+    }
+    /**
+     * 记录交付物创建
+     */
+    deliverableCreated() {
+        this.log.stats.deliverablesCreated++;
+    }
+    /**
+     * 结束会话
+     */
+    async end() {
+        this.log.endTime = new Date().toISOString();
+        await this.save();
+    }
+    /**
+     * 保存日志
+     */
+    async save() {
+        await ensureDir(join(this.basePath, LOGS_DIR));
+        await writeFile(this.logPath, JSON.stringify(this.log, null, 2));
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+}
+/**
+ * 读取历史日志
+ */
+export async function getExecutionLogs(basePath = process.cwd()) {
+    const logsDir = join(basePath, LOGS_DIR);
+    if (!existsSync(logsDir)) {
+        return [];
+    }
+    const { readdir } = await import('fs/promises');
+    const files = await readdir(logsDir);
+    const logs = [];
+    for (const file of files) {
+        if (file.endsWith('.json')) {
+            try {
+                const content = await readFile(join(logsDir, file), 'utf-8');
+                logs.push(JSON.parse(content));
+            }
+            catch {
+                // 忽略损坏的日志文件
+            }
+        }
+    }
+    // 按时间倒序
+    return logs.sort((a, b) => new Date(b.startTime).getTime() - new Date(a.startTime).getTime());
+}
+/**
+ * 获取指定会话的日志
+ */
+export async function getLog(sessionId, basePath = process.cwd()) {
+    const logPath = join(basePath, LOGS_DIR, `${sessionId}.json`);
+    if (!existsSync(logPath)) {
+        return null;
+    }
+    try {
+        const content = await readFile(logPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export async function getLatestRuntimeObservation(basePath = process.cwd()) {
+    const logs = await getExecutionLogs(basePath);
+    const runtimeLog = logs.find((log) => log.command === 'runtime');
+    if (!runtimeLog) {
+        return null;
+    }
+    return summarizeRuntimeObservation(runtimeLog);
+}
+export async function getRuntimeObservation(sessionId, basePath = process.cwd()) {
+    const runtimeLog = await getLog(sessionId, basePath);
+    if (!runtimeLog || runtimeLog.command !== 'runtime') {
+        return null;
+    }
+    return summarizeRuntimeObservation(runtimeLog);
+}
+function summarizeRuntimeObservation(runtimeLog) {
+    const relevantEntries = runtimeLog.entries.filter((entry) => ['before_execute', 'after_execute', 'permission_blocked', 'runtime_completed'].includes(entry.message));
+    const events = relevantEntries.map((entry) => toRuntimeObservationEvent(entry));
+    const recentEvents = relevantEntries.slice(-3).map((entry) => toRuntimeObservationEvent(entry));
+    const lastEvent = recentEvents[recentEvents.length - 1] ?? null;
+    const completionEntry = [...relevantEntries].reverse().find((entry) => entry.message === 'runtime_completed') ?? null;
+    const latestTaskEntry = [...relevantEntries].reverse().find((entry) => entry.taskId !== undefined) ?? null;
+    const completionMetadata = asRecord(completionEntry?.metadata);
+    const observationMetadata = asRecord(latestTaskEntry?.metadata);
+    const observation = asRecord(observationMetadata?.observation);
+    return {
+        sessionId: runtimeLog.sessionId,
+        startTime: runtimeLog.startTime,
+        endTime: runtimeLog.endTime,
+        completed: getNumber(completionMetadata?.completed) ?? runtimeLog.stats.tasksCompleted,
+        failed: getNumber(completionMetadata?.failed) ?? runtimeLog.stats.tasksFailed,
+        blocked: getNumber(completionMetadata?.blocked) ?? 0,
+        deliverables: getNumber(completionMetadata?.deliverables) ?? runtimeLog.stats.deliverablesCreated,
+        lastEvent: lastEvent?.message ?? null,
+        lastTaskId: lastEvent?.taskId ?? latestTaskEntry?.taskId ?? null,
+        permissionProfile: lastEvent?.permissionProfile ?? getString(observationMetadata?.permissionProfile),
+        signals: observation
+            ? {
+                readyTasks: getNumber(observation.readyTaskIds?.length) ?? getNumber(observation.counts?.readyTasks) ?? 0,
+                blockedTasks: getNumber(observation.blockedTaskIds?.length) ?? getNumber(observation.counts?.blockedTasks) ?? 0,
+                pendingReview: getNumber(observation.pendingReviewIds?.length) ??
+                    getNumber(observation.counts?.pendingReview) ??
+                    0,
+                unreadMessages: getNumber(observation.counts?.unreadMessages) ?? 0
+            }
+            : null,
+        events,
+        recentEvents
+    };
+}
+function toRuntimeObservationEvent(entry) {
+    const metadata = asRecord(entry.metadata);
+    return {
+        timestamp: entry.timestamp,
+        message: entry.message,
+        taskId: entry.taskId ?? null,
+        workerId: entry.workerId ?? null,
+        permissionProfile: getString(metadata?.permissionProfile),
+        stage: getString(metadata?.stage),
+        result: getString(metadata?.result),
+        reason: getString(metadata?.reason)
+    };
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function getString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+function getNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/mailbox.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 邮箱系统核心模块
+ * 实现 Worker 间的异步消息通信
+ */
+import { Message, MessageType } from '../types/index.js';
+/**
+ * 邮箱管理器
+ */
+export declare class Mailbox {
+    private workerId;
+    private basePath;
+    private mailboxPath;
+    private statePath;
+    private mailboxLockPath;
+    constructor(workerId: string, basePath?: string);
+    /**
+     * 初始化邮箱
+     */
+    init(): Promise<void>;
+    /**
+     * 发送消息到指定 Worker
+     */
+    send(to: string, type: MessageType, content: string, options?: {
+        taskId?: string;
+        metadata?: Record<string, any>;
+    }): Promise<Message>;
+    /**
+     * 广播消息给所有 Worker
+     */
+    broadcast(type: MessageType, content: string, recipients: string[], options?: {
+        taskId?: string;
+        metadata?: Record<string, any>;
+    }): Promise<Message[]>;
+    /**
+     * 接收消息
+     */
+    receive(options?: {
+        limit?: number;
+        unreadOnly?: boolean;
+        markAsRead?: boolean;
+    }): Promise<Message[]>;
+    /**
+     * 等待特定类型的消息
+     */
+    waitFor(type: MessageType, options?: {
+        from?: string;
+        taskId?: string;
+        timeout?: number;
+    }): Promise<Message | null>;
+    /**
+     * 获取未读消息数量
+     */
+    getUnreadCount(): Promise<number>;
+    /**
+     * 清空邮箱
+     */
+    clear(): Promise<void>;
+    private loadMessages;
+    private appendMessage;
+    private markMessageIdsAsRead;
+    private loadReadState;
+    private saveReadState;
+    private generateMessageId;
+}
+/**
+ * 获取所有 Worker 的邮箱
+ */
+export declare function getAllMailboxes(workerIds: string[], basePath?: string): Promise<Mailbox[]>;
+//# sourceMappingURL=mailbox.d.ts.map

package/dist/core/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../src/core/mailbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAezD;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAS;gBAEpB,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAsB;IAQ9D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACG,IAAI,CACR,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GACA,OAAO,CAAC,OAAO,CAAC;IAsBnB;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GACA,OAAO,CAAC,OAAO,EAAE,CAAC;IAarB;;OAEG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkCtB;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAsC1B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YASd,YAAY;YAmBZ,aAAa;YAMb,oBAAoB;YAepB,aAAa;YAiBb,aAAa;IAI3B,OAAO,CAAC,iBAAiB;CAG1B;AASD;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,EAAE,CAAC,CAEpB"}