aws-runtime-bridge 1.0.0

package/dist/services/process-registry.d.ts

@@ -0,0 +1,208 @@
+/**
+ * 进程注册表服务
+ *
+ * 集中管理 Agent 进程生命周期状态，支持进程注册、追踪、状态管理和持久化
+ */
+/**
+ * 进程状态类型
+ */
+export type ProcessState = 'creating' | 'running' | 'stopping' | 'orphaned' | 'terminated' | 'unknown';
+/**
+ * 进程健康状态
+ */
+export interface HealthStatus {
+    cpu: number;
+    memoryMB: number;
+    status: string;
+}
+/**
+ * 进程记录接口
+ */
+export interface ProcessRecord {
+    agentId: string;
+    sessionId: string;
+    pid: number;
+    mode: 'pty' | 'sdk';
+    state: ProcessState;
+    workspacePath: string;
+    command: string;
+    createdAt: string;
+    lastHeartbeat?: string;
+    healthStatus?: HealthStatus;
+    orphanedAt?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 持久化会话输入（用于重建注册表）
+ */
+export interface PersistedSessionInput {
+    agentId: string;
+    sessionId: string;
+    pid?: number;
+    workspacePath?: string;
+    command?: string;
+    mode?: 'pty' | 'sdk';
+}
+/**
+ * 获取持久化注册表文件路径
+ *
+ * @returns 注册表文件路径
+ */
+export declare function getProcessRegistryFile(): string;
+/**
+ * 进程注册表类
+ *
+ * 管理所有 Agent 进程的生命周期状态，提供注册、查询、更新和持久化功能
+ */
+export declare class ProcessRegistry {
+    private static instance;
+    private readonly records;
+    private readonly pidToAgentId;
+    /**
+     * 私有构造函数，强制使用单例模式
+     */
+    private constructor();
+    /**
+     * 获取 ProcessRegistry 单例实例
+     *
+     * @returns ProcessRegistry 实例
+     */
+    static getInstance(): ProcessRegistry;
+    /**
+     * 持久化注册表状态到文件
+     */
+    private persist;
+    /**
+     * 注册新进程
+     *
+     * @param record - 进程记录（不包含 createdAt）
+     * @returns 是否注册成功
+     */
+    register(record: Omit<ProcessRecord, 'createdAt'>): Promise<void>;
+    /**
+     * 更新进程记录
+     *
+     * @param agentId - Agent ID
+     * @param updates - 要更新的字段
+     * @returns 是否更新成功
+     */
+    update(agentId: string, updates: Partial<ProcessRecord>): Promise<boolean>;
+    /**
+     * 通过 agentId 获取进程记录
+     *
+     * @param agentId - Agent ID
+     * @returns 进程记录或 undefined
+     */
+    get(agentId: string): ProcessRecord | undefined;
+    /**
+     * 通过 PID 获取进程记录
+     *
+     * @param pid - 进程 ID
+     * @returns 进程记录或 undefined
+     */
+    getByPid(pid: number): ProcessRecord | undefined;
+    /**
+     * 获取所有进程记录
+     *
+     * @returns 所有进程记录的数组
+     */
+    getAll(): ProcessRecord[];
+    /**
+     * 通过状态过滤进程记录
+     *
+     * @param state - 进程状态
+     * @returns 符合状态的进程记录数组
+     */
+    getByState(state: ProcessState): ProcessRecord[];
+    /**
+     * 检查进程是否被管理
+     *
+     * @param agentId - Agent ID
+     * @returns 是否被管理
+     */
+    isManaged(agentId: string): boolean;
+    /**
+     * 检查 PID 是否被管理
+     *
+     * @param pid - 进程 ID
+     * @returns 是否被管理
+     */
+    isManagedByPid(pid: number): boolean;
+    /**
+     * 标记进程为孤儿状态
+     *
+     * @param agentId - Agent ID
+     * @returns 是否标记成功
+     */
+    markOrphaned(agentId: string): Promise<boolean>;
+    /**
+     * 标记进程为终止状态
+     *
+     * @param agentId - Agent ID
+     * @returns 是否标记成功
+     */
+    markTerminated(agentId: string): Promise<boolean>;
+    /**
+     * 移除进程记录
+     *
+     * @param agentId - Agent ID
+     * @returns 是否移除成功
+     */
+    remove(agentId: string): Promise<boolean>;
+    /**
+     * 更新进程心跳时间
+     *
+     * @param agentId - Agent ID
+     * @returns 是否更新成功
+     */
+    updateHeartbeat(agentId: string): Promise<boolean>;
+    /**
+     * 更新进程健康状态
+     *
+     * @param agentId - Agent ID
+     * @param health - 健康状态
+     * @returns 是否更新成功
+     */
+    updateHealth(agentId: string, health: HealthStatus): Promise<boolean>;
+    /**
+     * 从持久化会话重建注册表
+     *
+     * @param sessions - 持久化会话数组
+     */
+    rebuildFromPersisted(sessions: PersistedSessionInput[]): Promise<void>;
+    /**
+     * 导出所有进程记录用于持久化
+     *
+     * @returns 所有进程记录的数组
+     */
+    exportState(): ProcessRecord[];
+    /**
+     * 获取进程数量统计
+     *
+     * @returns 各状态的进程数量
+     */
+    getStats(): Record<ProcessState | 'total', number>;
+    /**
+     * 清空所有进程记录
+     */
+    clear(): Promise<void>;
+}
+/**
+ * 获取 ProcessRegistry 单例实例的便捷函数
+ *
+ * @returns ProcessRegistry 实例
+ */
+export declare function getProcessRegistry(): ProcessRegistry;
+/**
+ * 加载持久化的进程注册表
+ *
+ * @returns 进程记录数组
+ */
+export declare function loadPersistedProcessRegistry(): Promise<ProcessRecord[]>;
+/**
+ * 保存进程注册表到持久化文件
+ *
+ * @param records - 进程记录数组
+ */
+export declare function savePersistedProcessRegistry(records: ProcessRecord[]): Promise<void>;
+//# sourceMappingURL=process-registry.d.ts.map

package/dist/services/process-registry.d.ts.map

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

package/dist/services/process-registry.js

@@ -0,0 +1,354 @@
+/**
+ * 进程注册表服务
+ *
+ * 集中管理 Agent 进程生命周期状态，支持进程注册、追踪、状态管理和持久化
+ */
+import os from 'node:os';
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { createLogger } from '../utils/logger.js';
+import { ensureDir } from '../utils/file-utils.js';
+const log = createLogger('process-registry');
+/**
+ * 获取持久化注册表文件路径
+ *
+ * @returns 注册表文件路径
+ */
+export function getProcessRegistryFile() {
+    return path.join(os.tmpdir(), 'agentswork-runtime-bridge', 'process-registry.json');
+}
+/**
+ * 进程注册表类
+ *
+ * 管理所有 Agent 进程的生命周期状态，提供注册、查询、更新和持久化功能
+ */
+export class ProcessRegistry {
+    /**
+     * 私有构造函数，强制使用单例模式
+     */
+    constructor() {
+        this.records = new Map();
+        this.pidToAgentId = new Map();
+    }
+    /**
+     * 获取 ProcessRegistry 单例实例
+     *
+     * @returns ProcessRegistry 实例
+     */
+    static getInstance() {
+        if (ProcessRegistry.instance === null) {
+            ProcessRegistry.instance = new ProcessRegistry();
+        }
+        return ProcessRegistry.instance;
+    }
+    /**
+     * 持久化注册表状态到文件
+     */
+    async persist() {
+        const filePath = getProcessRegistryFile();
+        try {
+            await ensureDir(path.dirname(filePath));
+            const records = Array.from(this.records.values());
+            await fs.writeFile(filePath, JSON.stringify(records, null, 2), 'utf-8');
+            log.debug(`[persist] 已持久化 ${records.length} 条进程记录`);
+        }
+        catch (error) {
+            log.error('[persist] 持久化失败:', error);
+        }
+    }
+    /**
+     * 注册新进程
+     *
+     * @param record - 进程记录（不包含 createdAt）
+     * @returns 是否注册成功
+     */
+    async register(record) {
+        const fullRecord = {
+            ...record,
+            createdAt: new Date().toISOString(),
+        };
+        // 如果已存在相同 agentId，先移除旧的映射
+        const existing = this.records.get(record.agentId);
+        if (existing) {
+            this.pidToAgentId.delete(existing.pid);
+        }
+        this.records.set(record.agentId, fullRecord);
+        this.pidToAgentId.set(record.pid, record.agentId);
+        log.info(`[register] 注册进程: agentId=${record.agentId}, pid=${record.pid}, mode=${record.mode}, state=${record.state}`);
+        await this.persist();
+    }
+    /**
+     * 更新进程记录
+     *
+     * @param agentId - Agent ID
+     * @param updates - 要更新的字段
+     * @returns 是否更新成功
+     */
+    async update(agentId, updates) {
+        const record = this.records.get(agentId);
+        if (!record) {
+            log.warn(`[update] 未找到进程: agentId=${agentId}`);
+            return false;
+        }
+        // 如果更新包含 pid，需要更新 pid 映射
+        if (updates.pid !== undefined && updates.pid !== record.pid) {
+            this.pidToAgentId.delete(record.pid);
+            this.pidToAgentId.set(updates.pid, agentId);
+        }
+        Object.assign(record, updates);
+        log.debug(`[update] 更新进程: agentId=${agentId}, updates=${JSON.stringify(updates)}`);
+        await this.persist();
+        return true;
+    }
+    /**
+     * 通过 agentId 获取进程记录
+     *
+     * @param agentId - Agent ID
+     * @returns 进程记录或 undefined
+     */
+    get(agentId) {
+        return this.records.get(agentId);
+    }
+    /**
+     * 通过 PID 获取进程记录
+     *
+     * @param pid - 进程 ID
+     * @returns 进程记录或 undefined
+     */
+    getByPid(pid) {
+        const agentId = this.pidToAgentId.get(pid);
+        if (!agentId) {
+            return undefined;
+        }
+        return this.records.get(agentId);
+    }
+    /**
+     * 获取所有进程记录
+     *
+     * @returns 所有进程记录的数组
+     */
+    getAll() {
+        return Array.from(this.records.values());
+    }
+    /**
+     * 通过状态过滤进程记录
+     *
+     * @param state - 进程状态
+     * @returns 符合状态的进程记录数组
+     */
+    getByState(state) {
+        return this.getAll().filter(record => record.state === state);
+    }
+    /**
+     * 检查进程是否被管理
+     *
+     * @param agentId - Agent ID
+     * @returns 是否被管理
+     */
+    isManaged(agentId) {
+        return this.records.has(agentId);
+    }
+    /**
+     * 检查 PID 是否被管理
+     *
+     * @param pid - 进程 ID
+     * @returns 是否被管理
+     */
+    isManagedByPid(pid) {
+        return this.pidToAgentId.has(pid);
+    }
+    /**
+     * 标记进程为孤儿状态
+     *
+     * @param agentId - Agent ID
+     * @returns 是否标记成功
+     */
+    async markOrphaned(agentId) {
+        const record = this.records.get(agentId);
+        if (!record) {
+            log.warn(`[markOrphaned] 未找到进程: agentId=${agentId}`);
+            return false;
+        }
+        record.state = 'orphaned';
+        record.orphanedAt = new Date().toISOString();
+        log.info(`[markOrphaned] 标记进程为孤儿: agentId=${agentId}, orphanedAt=${record.orphanedAt}`);
+        await this.persist();
+        return true;
+    }
+    /**
+     * 标记进程为终止状态
+     *
+     * @param agentId - Agent ID
+     * @returns 是否标记成功
+     */
+    async markTerminated(agentId) {
+        const record = this.records.get(agentId);
+        if (!record) {
+            log.warn(`[markTerminated] 未找到进程: agentId=${agentId}`);
+            return false;
+        }
+        record.state = 'terminated';
+        log.info(`[markTerminated] 标记进程为终止: agentId=${agentId}`);
+        await this.persist();
+        return true;
+    }
+    /**
+     * 移除进程记录
+     *
+     * @param agentId - Agent ID
+     * @returns 是否移除成功
+     */
+    async remove(agentId) {
+        const record = this.records.get(agentId);
+        if (!record) {
+            log.warn(`[remove] 未找到进程: agentId=${agentId}`);
+            return false;
+        }
+        this.records.delete(agentId);
+        this.pidToAgentId.delete(record.pid);
+        log.info(`[remove] 移除进程: agentId=${agentId}, pid=${record.pid}`);
+        await this.persist();
+        return true;
+    }
+    /**
+     * 更新进程心跳时间
+     *
+     * @param agentId - Agent ID
+     * @returns 是否更新成功
+     */
+    async updateHeartbeat(agentId) {
+        const record = this.records.get(agentId);
+        if (!record) {
+            log.warn(`[updateHeartbeat] 未找到进程: agentId=${agentId}`);
+            return false;
+        }
+        record.lastHeartbeat = new Date().toISOString();
+        log.debug(`[updateHeartbeat] 更新心跳: agentId=${agentId}, lastHeartbeat=${record.lastHeartbeat}`);
+        await this.persist();
+        return true;
+    }
+    /**
+     * 更新进程健康状态
+     *
+     * @param agentId - Agent ID
+     * @param health - 健康状态
+     * @returns 是否更新成功
+     */
+    async updateHealth(agentId, health) {
+        const record = this.records.get(agentId);
+        if (!record) {
+            log.warn(`[updateHealth] 未找到进程: agentId=${agentId}`);
+            return false;
+        }
+        record.healthStatus = health;
+        log.debug(`[updateHealth] 更新健康状态: agentId=${agentId}, health=${JSON.stringify(health)}`);
+        await this.persist();
+        return true;
+    }
+    /**
+     * 从持久化会话重建注册表
+     *
+     * @param sessions - 持久化会话数组
+     */
+    async rebuildFromPersisted(sessions) {
+        log.info(`[rebuildFromPersisted] 从 ${sessions.length} 个持久化会话重建注册表`);
+        this.records.clear();
+        this.pidToAgentId.clear();
+        for (const session of sessions) {
+            if (!session.pid) {
+                log.warn(`[rebuildFromPersisted] 跳过无 PID 的会话: agentId=${session.agentId}`);
+                continue;
+            }
+            const record = {
+                agentId: session.agentId,
+                sessionId: session.sessionId,
+                pid: session.pid,
+                mode: session.mode || 'sdk',
+                state: 'unknown', // 重建时状态未知，需要外部检测
+                workspacePath: session.workspacePath || '',
+                command: session.command || '',
+                createdAt: new Date().toISOString(),
+            };
+            this.records.set(record.agentId, record);
+            this.pidToAgentId.set(record.pid, record.agentId);
+            log.debug(`[rebuildFromPersisted] 重建进程记录: agentId=${record.agentId}, pid=${record.pid}`);
+        }
+        log.info(`[rebuildFromPersisted] 重建完成，共 ${this.records.size} 条记录`);
+        await this.persist();
+    }
+    /**
+     * 导出所有进程记录用于持久化
+     *
+     * @returns 所有进程记录的数组
+     */
+    exportState() {
+        return this.getAll();
+    }
+    /**
+     * 获取进程数量统计
+     *
+     * @returns 各状态的进程数量
+     */
+    getStats() {
+        const stats = {
+            creating: 0,
+            running: 0,
+            stopping: 0,
+            orphaned: 0,
+            terminated: 0,
+            unknown: 0,
+            total: this.records.size,
+        };
+        for (const record of this.records.values()) {
+            stats[record.state]++;
+        }
+        return stats;
+    }
+    /**
+     * 清空所有进程记录
+     */
+    async clear() {
+        const count = this.records.size;
+        this.records.clear();
+        this.pidToAgentId.clear();
+        log.info(`[clear] 清空所有进程记录: ${count} 条`);
+        await this.persist();
+    }
+}
+ProcessRegistry.instance = null;
+/**
+ * 获取 ProcessRegistry 单例实例的便捷函数
+ *
+ * @returns ProcessRegistry 实例
+ */
+export function getProcessRegistry() {
+    return ProcessRegistry.getInstance();
+}
+/**
+ * 加载持久化的进程注册表
+ *
+ * @returns 进程记录数组
+ */
+export async function loadPersistedProcessRegistry() {
+    const filePath = getProcessRegistryFile();
+    try {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        const records = JSON.parse(raw);
+        log.debug(`[loadPersistedProcessRegistry] 加载了 ${records.length} 条进程记录`);
+        return records;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 保存进程注册表到持久化文件
+ *
+ * @param records - 进程记录数组
+ */
+export async function savePersistedProcessRegistry(records) {
+    const filePath = getProcessRegistryFile();
+    await ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, JSON.stringify(records, null, 2), 'utf-8');
+    log.debug(`[savePersistedProcessRegistry] 保存了 ${records.length} 条进程记录`);
+}

package/dist/services/session-lookup.d.ts

@@ -0,0 +1,20 @@
+import type { PersistedSession } from '../types.js';
+type ActiveSessionSnapshot = {
+    sessionId: string;
+    workspacePath: string;
+    mode: 'pty' | 'sdk';
+};
+type PersistedSessionSnapshot = Pick<PersistedSession, 'sessionId' | 'workspacePath' | 'command' | 'status' | 'startedAt'> & {
+    mode?: 'pty';
+};
+/**
+ * 构建按 Agent 查询会话状态的统一响应。
+ *
+ * 主流程：
+ * 1. 活跃会话返回 hasActiveSession=true 且 isActive=true
+ * 2. 持久化可恢复会话返回 hasActiveSession=true 且 isActive=false
+ * 3. 无会话返回 false/false
+ */
+export declare function buildSessionLookupResponse(agentId: string, activeSession?: ActiveSessionSnapshot | null, persistedSession?: PersistedSessionSnapshot | null): Record<string, unknown>;
+export {};
+//# sourceMappingURL=session-lookup.d.ts.map

package/dist/services/session-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lookup.d.ts","sourceRoot":"","sources":["../../src/services/session-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;CACrB,CAAC;AAEF,KAAK,wBAAwB,GAAG,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC,GAAG;IAC3H,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,qBAAqB,GAAG,IAAI,EAC5C,gBAAgB,CAAC,EAAE,wBAAwB,GAAG,IAAI,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB"}

package/dist/services/session-lookup.js

@@ -0,0 +1,43 @@
+/**
+ * 构建按 Agent 查询会话状态的统一响应。
+ *
+ * 主流程：
+ * 1. 活跃会话返回 hasActiveSession=true 且 isActive=true
+ * 2. 持久化可恢复会话返回 hasActiveSession=true 且 isActive=false
+ * 3. 无会话返回 false/false
+ */
+export function buildSessionLookupResponse(agentId, activeSession, persistedSession) {
+    if (activeSession) {
+        return {
+            ok: true,
+            agentId,
+            sessionId: activeSession.sessionId,
+            workspacePath: activeSession.workspacePath,
+            status: 'running',
+            mode: activeSession.mode,
+            hasActiveSession: true,
+            isActive: true,
+        };
+    }
+    if (persistedSession) {
+        return {
+            ok: true,
+            agentId,
+            sessionId: persistedSession.sessionId,
+            workspacePath: persistedSession.workspacePath,
+            command: persistedSession.command,
+            status: persistedSession.status,
+            startedAt: persistedSession.startedAt,
+            mode: persistedSession.mode ?? 'pty',
+            hasActiveSession: true,
+            isActive: false,
+        };
+    }
+    return {
+        ok: true,
+        agentId,
+        status: 'none',
+        hasActiveSession: false,
+        isActive: false,
+    };
+}

package/dist/services/session-output.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 会话输出缓冲服务
+ *
+ * 管理终端会话的输出缓冲和刷新机制
+ */
+import type { Session } from '../types.js';
+/** 活跃会话存储 */
+export declare const sessions: Map<string, Session>;
+/**
+ * 发送状态更新到调度器
+ *
+ * @param agentId - Agent ID
+ * @param sessionId - 会话 ID
+ * @param status - 状态
+ * @param actionInfo - 可选的动作详情
+ */
+export declare function sendStatus(agentId: string, sessionId: string | null, status: string, actionInfo?: {
+    actionType?: string;
+    actionLabel?: string;
+    actionDetail?: string;
+}, usage?: {
+    inputTokens: number;
+    outputTokens: number;
+}): Promise<void | {
+    data: unknown;
+}>;
+/**
+ * 发送输出到调度器
+ *
+ * @param agentId - Agent ID
+ * @param output - 输出内容
+ * @param sessionId - 会话 ID
+ * @param seq - 序列号
+ */
+export declare function sendOutput(agentId: string, output: string, sessionId: string, seq: number): Promise<void>;
+/**
+ * 发送 AskUserQuestion 事件到调度器。
+ *
+ * @param agentId - Agent ID
+ * @param sessionId - SDK 会话 ID
+ * @param questions - 结构化问题列表
+ */
+export declare function sendQuestionRequest(agentId: string, sessionId: string, questions: unknown[]): Promise<void>;
+/**
+ * 调度输出刷新
+ *
+ * @param sessionId - 会话 ID
+ */
+export declare function scheduleOutputFlush(sessionId: string): void;
+/**
+ * 刷新会话输出
+ *
+ * @param sessionId - 会话 ID
+ */
+export declare function flushSessionOutput(sessionId: string): Promise<void>;
+//# sourceMappingURL=session-output.d.ts.map

package/dist/services/session-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-output.d.ts","sourceRoot":"","sources":["../../src/services/session-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,aAAa;AACb,eAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAa,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EACjF,KAAK,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,IAAI,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAqBnC;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAa3D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCzE"}