@coralai/sps-cli 0.49.15 → 0.50.0

package/dist/services/CardService.js

@@ -0,0 +1,313 @@
+import { domainError } from '../shared/errors.js';
+import { err, ok } from '../shared/result.js';
+// 合法 state 白名单（和 Console PATCH 侧保持一致；Phase 3 归并到 shared）
+const ALLOWED_STATES = [
+    'Planning',
+    'Backlog',
+    'Todo',
+    'Inprogress',
+    'Review',
+    'QA',
+    'Done',
+    'Canceled',
+];
+export class CardService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 列出卡片（可选 state 过滤）。按 seq 倒序（新卡在前）。 */
+    async list(project, filter = {}) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        const backend = await this.backendOr404(project);
+        if (!backend.ok)
+            return backend;
+        const cards = filter.state
+            ? await backend.value.listByState(filter.state)
+            : await backend.value.listAll();
+        const summaries = cards
+            .map(toCardSummary)
+            .sort((a, b) => b.seq - a.seq);
+        return ok(summaries);
+    }
+    /** 获取单卡详情（含 body + checklist）。 */
+    async get(project, seq) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        if (!Number.isInteger(seq) || seq <= 0)
+            return err(invalidSeq());
+        const backend = await this.backendOr404(project);
+        if (!backend.ok)
+            return backend;
+        const card = await backend.value.getBySeq(String(seq));
+        if (!card)
+            return err(cardNotFound(seq));
+        return ok(toCardDetail(card));
+    }
+    /** 新建卡片。state 缺省 'Planning'。 */
+    async create(project, input) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        const title = input.title?.trim();
+        if (!title)
+            return err(invalidTitle());
+        const state = input.initialState ?? 'Planning';
+        if (!ALLOWED_STATES.includes(state))
+            return err(invalidState(state));
+        const backend = await this.backendOr404(project);
+        if (!backend.ok)
+            return backend;
+        let created;
+        try {
+            created = await backend.value.create(title, (input.description ?? '').trim(), state);
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CARD_CREATE_FAIL', '卡片创建失败', { cause }));
+        }
+        if (input.skills && input.skills.length > 0) {
+            try {
+                await backend.value.setSkills(created.seq, sanitizeSkills(input.skills));
+            }
+            catch {
+                /* skills 写失败不阻塞 create */
+            }
+        }
+        const summary = toCardSummary({
+            ...created,
+            skills: input.skills ?? [],
+        });
+        this.deps.events.emit({
+            type: 'card.created',
+            project,
+            seq: summary.seq,
+            card: created,
+            ts: this.deps.clock.now(),
+        });
+        return ok(summary);
+    }
+    /**
+     * 更新卡片 —— 任意字段子集。
+     * 字段相互独立应用，最后 emit 单次 card.updated + 如 state 变则额外 card.moved。
+     */
+    async update(project, seq, patch) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        if (!Number.isInteger(seq) || seq <= 0)
+            return err(invalidSeq());
+        if (Object.keys(patch).length === 0) {
+            return err(domainError('validation', 'PATCH_EMPTY', '没有字段可更新'));
+        }
+        if (patch.state !== undefined && !ALLOWED_STATES.includes(patch.state)) {
+            return err(invalidState(patch.state));
+        }
+        if (patch.title !== undefined && !patch.title.trim()) {
+            return err(invalidTitle());
+        }
+        if (patch.skills !== undefined && !Array.isArray(patch.skills)) {
+            return err(domainError('validation', 'SKILLS_NOT_ARRAY', 'skills 必须是数组'));
+        }
+        if (patch.labels !== undefined && !Array.isArray(patch.labels)) {
+            return err(domainError('validation', 'LABELS_NOT_ARRAY', 'labels 必须是数组'));
+        }
+        const backend = await this.backendOr404(project);
+        if (!backend.ok)
+            return backend;
+        const existing = await backend.value.getBySeq(String(seq));
+        if (!existing)
+            return err(cardNotFound(seq));
+        // 快照旧值 —— 后续 move 会改 backend 内部对象，existing.state 会被改；
+        // 提前取值避免事件判断依赖可变引用。
+        const oldState = existing.state;
+        const seqStr = String(seq);
+        try {
+            if (patch.title !== undefined)
+                await backend.value.setTitle(seqStr, patch.title);
+            if (patch.description !== undefined)
+                await backend.value.setDescription(seqStr, patch.description);
+            if (patch.skills !== undefined)
+                await backend.value.setSkills(seqStr, sanitizeSkills(patch.skills));
+            if (patch.labels !== undefined)
+                await backend.value.setLabels(seqStr, sanitizeLabels(patch.labels));
+            if (patch.state !== undefined && patch.state !== oldState) {
+                await backend.value.move(seqStr, patch.state);
+            }
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CARD_UPDATE_FAIL', '卡片更新失败', { cause }));
+        }
+        const fresh = await backend.value.getBySeq(seqStr);
+        if (!fresh)
+            return err(cardNotFound(seq));
+        const summary = toCardSummary(fresh);
+        const now = this.deps.clock.now();
+        this.deps.events.emit({
+            type: 'card.updated',
+            project,
+            seq,
+            patch,
+            ts: now,
+        });
+        if (patch.state !== undefined && patch.state !== oldState) {
+            this.deps.events.emit({
+                type: 'card.moved',
+                project,
+                seq,
+                from: oldState,
+                to: patch.state,
+                ts: now,
+            });
+        }
+        return ok(summary);
+    }
+    /** 仅状态变更（无其它字段）。等价于 update({state}) 但更语义化。 */
+    async move(project, seq, newState) {
+        return this.update(project, seq, { state: newState });
+    }
+    /** 删除卡片。Inprogress 拒绝（前置条件） */
+    async delete(project, seq) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        if (!Number.isInteger(seq) || seq <= 0)
+            return err(invalidSeq());
+        const backend = await this.backendOr404(project);
+        if (!backend.ok)
+            return backend;
+        const card = await backend.value.getBySeq(String(seq));
+        if (!card)
+            return err(cardNotFound(seq));
+        if (card.state === 'Inprogress') {
+            return err(domainError('precondition', 'CARD_IN_PROGRESS', '卡片正在运行，请先 kill worker 或移出 Inprogress', { details: { seq, state: card.state } }));
+        }
+        try {
+            await backend.value.delete(String(seq));
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CARD_DELETE_FAIL', '卡片删除失败', { cause }));
+        }
+        this.deps.events.emit({
+            type: 'card.deleted',
+            project,
+            seq,
+            ts: this.deps.clock.now(),
+        });
+        return ok(undefined);
+    }
+    /**
+     * 重置卡片 —— 清 frontmatter 运行字段（claimed_by / claimed_at / retry_count）
+     * 同时清掉系统 labels（`AI-PIPELINE`、`STARTED-<stage>`、`COMPLETED-<stage>`、`NEEDS-FIX`）
+     * 并移回初始态（Planning）。调用方负责先 kill 对应 worker。
+     */
+    async reset(project, seq) {
+        if (!isValidProject(project))
+            return err(invalidProject());
+        if (!Number.isInteger(seq) || seq <= 0)
+            return err(invalidSeq());
+        const backend = await this.backendOr404(project);
+        if (!backend.ok)
+            return backend;
+        const card = await backend.value.getBySeq(String(seq));
+        if (!card)
+            return err(cardNotFound(seq));
+        const oldState = card.state; // 同 update：snapshot 避免 move 后回读失真
+        const seqStr = String(seq);
+        try {
+            // 清 labels —— 只保留用户自定义（非系统 label）
+            const cleanLabels = (card.labels ?? []).filter((l) => l !== 'AI-PIPELINE' &&
+                l !== 'NEEDS-FIX' &&
+                l !== 'CLAIMED' &&
+                !l.startsWith('STARTED-') &&
+                !l.startsWith('COMPLETED-'));
+            await backend.value.setLabels(seqStr, cleanLabels);
+            await backend.value.releaseClaim(seqStr);
+            await backend.value.resetRetryCount(seqStr);
+            if (oldState !== 'Planning') {
+                await backend.value.move(seqStr, 'Planning');
+            }
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CARD_RESET_FAIL', '卡片重置失败', { cause }));
+        }
+        const fresh = await backend.value.getBySeq(seqStr);
+        if (!fresh)
+            return err(cardNotFound(seq));
+        const now = this.deps.clock.now();
+        this.deps.events.emit({
+            type: 'card.updated',
+            project,
+            seq,
+            patch: { state: 'Planning' },
+            ts: now,
+        });
+        if (oldState !== 'Planning') {
+            this.deps.events.emit({
+                type: 'card.moved',
+                project,
+                seq,
+                from: oldState,
+                to: 'Planning',
+                ts: now,
+            });
+        }
+        return ok(toCardSummary(fresh));
+    }
+    // ─── 内部 ─────────────────────────────────────────────────────────
+    async backendOr404(project) {
+        try {
+            return ok(await this.deps.backendFactory.for(project));
+        }
+        catch (cause) {
+            return err(domainError('not-found', 'PROJECT_NOT_FOUND', `项目 ${project} 不存在`, { cause, details: { project } }));
+        }
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────
+function toCardSummary(card) {
+    return {
+        seq: Number.parseInt(card.seq, 10),
+        title: card.title,
+        state: card.state,
+        skills: card.skills ?? [],
+        labels: card.labels ?? [],
+        branch: card.meta?.branch ?? null,
+        createdAt: card.meta?.createdAt ?? null,
+        updatedAt: card.meta?.updatedAt ?? null,
+    };
+}
+function toCardDetail(card) {
+    return {
+        ...toCardSummary(card),
+        body: card.desc ?? '',
+        checklist: card.checklist ?? { total: 0, done: 0, percent: 0, items: [] },
+        activeWorkerSlot: null, // 组合 WorkerService 时再填
+    };
+}
+function sanitizeSkills(skills) {
+    return [...new Set(skills.map((s) => String(s).trim()).filter(Boolean))];
+}
+function sanitizeLabels(labels) {
+    return [...new Set(labels.map((l) => String(l).trim()).filter(Boolean))];
+}
+function isValidProject(project) {
+    return typeof project === 'string' && /^[a-zA-Z0-9_-]+$/.test(project);
+}
+function invalidProject() {
+    return domainError('validation', 'INVALID_PROJECT_NAME', '项目名非法');
+}
+function invalidSeq() {
+    return domainError('validation', 'INVALID_SEQ', 'seq 必须是正整数');
+}
+function invalidTitle() {
+    return domainError('validation', 'INVALID_TITLE', '卡片标题不能为空');
+}
+function invalidState(state) {
+    return domainError('validation', 'INVALID_STATE', `state 非法：${state}`, {
+        details: { allowed: ALLOWED_STATES },
+    });
+}
+function cardNotFound(seq) {
+    return domainError('not-found', 'CARD_NOT_FOUND', `卡片 #${seq} 不存在`, {
+        details: { seq },
+    });
+}
+//# sourceMappingURL=CardService.js.map

package/dist/services/CardService.js.map

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

package/dist/services/ChatService.d.ts

@@ -0,0 +1,62 @@
+import type { Clock } from '../infra/clock.js';
+import type { FileSystem } from '../infra/filesystem.js';
+import type { DomainEventBus } from '../shared/domainEvents.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+export interface ChatMessage {
+    readonly id: string;
+    readonly role: 'user' | 'assistant' | 'system' | 'error';
+    readonly content: string;
+    readonly ts: string;
+    readonly blocks?: unknown[];
+}
+export interface ChatSession {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly lastMessageAt: string | null;
+    readonly title: string;
+    readonly project: string | null;
+    readonly messageCount: number;
+    readonly messages: ChatMessage[];
+}
+export interface ChatSessionSummary {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly lastMessageAt: string | null;
+    readonly title: string;
+    readonly project: string | null;
+    readonly messageCount: number;
+}
+export interface CreateSessionInput {
+    title?: string;
+    project?: string | null;
+}
+export interface ChatExecutor {
+    /** 停止会话对应的 daemon worker（Delete 时清理） */
+    stopSession(sessionId: string): Promise<void>;
+    /** 中断正在进行的 assistant turn */
+    cancelRun(sessionId: string): Promise<void>;
+}
+export interface ChatServiceDeps {
+    readonly fs: FileSystem;
+    readonly clock: Clock;
+    readonly events: DomainEventBus;
+    readonly executor?: ChatExecutor;
+}
+export declare class ChatService {
+    private readonly deps;
+    constructor(deps: ChatServiceDeps);
+    list(): Promise<Result<ChatSessionSummary[], DomainError>>;
+    create(input?: CreateSessionInput): Promise<Result<ChatSessionSummary, DomainError>>;
+    get(id: string): Promise<Result<ChatSession, DomainError>>;
+    /** 返回 since 之后的消息（供 SSE 重连补偿）。since 缺省返回全部。 */
+    getMessages(id: string, since?: string): Promise<Result<{
+        data: ChatMessage[];
+        total: number;
+    }, DomainError>>;
+    delete(id: string): Promise<Result<void, DomainError>>;
+    interrupt(id: string): Promise<Result<void, DomainError>>;
+    private sessionPath;
+    private summarize;
+}
+//# sourceMappingURL=ChatService.d.ts.map

package/dist/services/ChatService.d.ts.map

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

package/dist/services/ChatService.js

@@ -0,0 +1,157 @@
+/**
+ * @module        services/ChatService
+ * @description   Chat 会话 CRUD service
+ *
+ * @layer         services
+ *
+ * Phase 2 范围：
+ *   - session 生命周期（list / create / get / delete）
+ *   - messages diff 查询
+ *
+ * Phase 3 追加：
+ *   - sendMessage（走 daemon IPC + SSE 流式推送）—— 通过注入 ChatExecutor port
+ *
+ * 本 service 隐藏 chat session JSON 文件的存储细节，使用 FileSystem port。
+ */
+import { randomUUID } from 'node:crypto';
+import { resolve } from 'node:path';
+import { domainError } from '../shared/errors.js';
+import { err, ok } from '../shared/result.js';
+import { chatSessionsDir } from '../shared/runtimePaths.js';
+export class ChatService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async list() {
+        const dir = chatSessionsDir();
+        if (!this.deps.fs.exists(dir))
+            return ok([]);
+        let files;
+        try {
+            files = this.deps.fs.readDir(dir).filter((e) => e.isFile && e.name.endsWith('.json'));
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CHAT_LIST_FAIL', '会话列表读取失败', { cause }));
+        }
+        const summaries = [];
+        for (const entry of files) {
+            const path = resolve(dir, entry.name);
+            try {
+                const raw = this.deps.fs.readFile(path);
+                const session = JSON.parse(raw);
+                summaries.push(this.summarize(session));
+            }
+            catch {
+                /* 跳过坏 session */
+            }
+        }
+        summaries.sort((a, b) => {
+            const ta = a.lastMessageAt ?? a.createdAt;
+            const tb = b.lastMessageAt ?? b.createdAt;
+            return Date.parse(tb) - Date.parse(ta);
+        });
+        return ok(summaries);
+    }
+    async create(input = {}) {
+        const id = randomUUID();
+        const session = {
+            id,
+            createdAt: this.deps.clock.nowIso(),
+            lastMessageAt: null,
+            title: input.title?.trim() || '新对话',
+            project: input.project ?? null,
+            messageCount: 0,
+            messages: [],
+        };
+        try {
+            this.deps.fs.writeFileAtomic(this.sessionPath(id), JSON.stringify(session));
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CHAT_CREATE_FAIL', '会话创建失败', { cause }));
+        }
+        return ok(this.summarize(session));
+    }
+    async get(id) {
+        if (!isValidSessionId(id))
+            return err(invalidId());
+        const path = this.sessionPath(id);
+        if (!this.deps.fs.exists(path)) {
+            return err(domainError('not-found', 'CHAT_SESSION_NOT_FOUND', '会话不存在'));
+        }
+        try {
+            const raw = this.deps.fs.readFile(path);
+            return ok(JSON.parse(raw));
+        }
+        catch (cause) {
+            return err(domainError('internal', 'CHAT_READ_FAIL', '会话读取失败', { cause }));
+        }
+    }
+    /** 返回 since 之后的消息（供 SSE 重连补偿）。since 缺省返回全部。 */
+    async getMessages(id, since) {
+        const sessionR = await this.get(id);
+        if (!sessionR.ok)
+            return sessionR;
+        const session = sessionR.value;
+        const messages = since ? session.messages.filter((m) => m.ts > since) : session.messages;
+        return ok({ data: messages, total: session.messages.length });
+    }
+    async delete(id) {
+        if (!isValidSessionId(id))
+            return err(invalidId());
+        const path = this.sessionPath(id);
+        if (this.deps.fs.exists(path)) {
+            try {
+                this.deps.fs.unlink(path);
+            }
+            catch (cause) {
+                return err(domainError('internal', 'CHAT_DELETE_FAIL', '会话删除失败', { cause }));
+            }
+        }
+        // best effort 停止 daemon worker
+        if (this.deps.executor) {
+            try {
+                await this.deps.executor.stopSession(id);
+            }
+            catch {
+                /* 不阻塞删除 */
+            }
+        }
+        return ok(undefined);
+    }
+    async interrupt(id) {
+        if (!isValidSessionId(id))
+            return err(invalidId());
+        if (!this.deps.executor) {
+            return err(domainError('internal', 'EXECUTOR_MISSING', 'ChatExecutor 未注入'));
+        }
+        try {
+            await this.deps.executor.cancelRun(id);
+        }
+        catch (cause) {
+            return err(domainError('external', 'CHAT_CANCEL_FAIL', '中断会话失败', { cause }));
+        }
+        return ok(undefined);
+    }
+    // ─── helpers ──────────────────────────────────────────────────────
+    sessionPath(id) {
+        return resolve(chatSessionsDir(), `${id}.json`);
+    }
+    summarize(s) {
+        return {
+            id: s.id,
+            createdAt: s.createdAt,
+            lastMessageAt: s.lastMessageAt,
+            title: s.title,
+            project: s.project,
+            messageCount: s.messageCount,
+        };
+    }
+}
+function isValidSessionId(id) {
+    return typeof id === 'string' && /^[a-zA-Z0-9-]+$/.test(id);
+}
+function invalidId() {
+    return domainError('validation', 'INVALID_SESSION_ID', 'session id 非法');
+}
+//# sourceMappingURL=ChatService.js.map

package/dist/services/ChatService.js.map

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

package/dist/services/LogService.d.ts

@@ -0,0 +1,46 @@
+import type { FileSystem } from '../infra/filesystem.js';
+import { type DomainError } from '../shared/errors.js';
+import { type Result } from '../shared/result.js';
+export interface LogLine {
+    readonly ts: string | null;
+    readonly worker: number | null;
+    readonly level: 'debug' | 'info' | 'warn' | 'error' | 'trace';
+    readonly msg: string;
+    readonly raw: string;
+    readonly project?: string;
+}
+export interface LogQueryOpts {
+    project: string;
+    worker?: number;
+    limit?: number;
+    /** ISO datetime string —— 只返时间 >= since 的行 */
+    since?: string;
+}
+export interface LogQueryResult {
+    readonly data: LogLine[];
+    readonly file: string | null;
+    readonly files: string[];
+}
+export interface AggregateOpts {
+    worker?: number;
+    limit?: number;
+    since?: string;
+}
+export interface AggregateResult {
+    readonly data: LogLine[];
+    readonly files: string[];
+}
+export interface LogServiceDeps {
+    readonly fs: FileSystem;
+}
+export declare class LogService {
+    private readonly deps;
+    constructor(deps: LogServiceDeps);
+    /** 单项目 tail。 */
+    tail(opts: LogQueryOpts): Promise<Result<LogQueryResult, DomainError>>;
+    /** 跨项目聚合 tail。 */
+    aggregate(opts?: AggregateOpts): Promise<Result<AggregateResult, DomainError>>;
+    private findLogFiles;
+}
+export declare function parseLogLine(raw: string): LogLine;
+//# sourceMappingURL=LogService.d.ts.map

package/dist/services/LogService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogService.d.ts","sourceRoot":"","sources":["../../src/services/LogService.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAK3D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;CACzB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,cAAc;IAEjD,gBAAgB;IACV,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAoB5E,kBAAkB;IACZ,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IA2CxF,OAAO,CAAC,YAAY;CAwBrB;AA4BD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAsBjD"}