@zhin.js/agent 0.3.1 → 1.0.2

package/lib/collaboration/init-observe-hook.js

@@ -0,0 +1,190 @@
+/**
+ * InitObservationHook — waiting 态 endpoint 被动记录 master @ 事件。
+ *
+ * 在 init 向导阶段，所有 collaboration.enabled 的 endpoint 观测入站消息：
+ * 若消息含 at segment 且指向已注册的系统 Bot → 写 init_observation。
+ * Planner 在 advance 时读取 observations 推进步骤。
+ */
+import { getSceneIdentityService } from './scene-identity-service.js';
+import { advanceWizardStep } from './init-wizard-service.js';
+import { isAssignableWizardRole } from './collaboration-db-model.js';
+/**
+ * 从 at 消息段提取平台 id（兼容 qq / user_id / id）。
+ */
+export function atSegmentPlatformId(data) {
+    if (!data)
+        return undefined;
+    for (const key of ['qq', 'user_id', 'id']) {
+        const value = data[key];
+        if (value != null && String(value).trim() !== '') {
+            return String(value);
+        }
+    }
+    return undefined;
+}
+/**
+ * 提取消息中 at segment 的 target id 列表。
+ */
+export function extractAtTargets(message) {
+    const targets = [];
+    for (const el of message.$content ?? []) {
+        if (el.type !== 'at')
+            continue;
+        const id = atSegmentPlatformId(el.data);
+        if (id)
+            targets.push(id);
+    }
+    return targets;
+}
+/**
+ * 判断当前 endpoint 是否是已注册的系统 Bot。
+ */
+export function isRegisteredEndpoint(root, platformId) {
+    for (const adapterName of root.adapters) {
+        const name = String(adapterName);
+        try {
+            const adapter = root.inject(name);
+            if (!adapter?.endpoints)
+                continue;
+            for (const [epId, ep] of adapter.endpoints) {
+                const ids = new Set([epId]);
+                if (ep.$config?.name)
+                    ids.add(String(ep.$config.name));
+                if (ep.$config?.appid)
+                    ids.add(String(ep.$config.appid));
+                if (ep.$platformUserId)
+                    ids.add(String(ep.$platformUserId));
+                if (ids.has(platformId)) {
+                    return { adapter: name, endpointId: epId };
+                }
+            }
+        }
+        catch {
+            // adapter not ready
+        }
+    }
+    return undefined;
+}
+/**
+ * 列出所有已注册的系统 Bot 的 (platformId → adapter, endpointId) 映射。
+ */
+export function buildRegisteredEndpointMap(root) {
+    const map = new Map();
+    for (const adapterName of root.adapters) {
+        const name = String(adapterName);
+        try {
+            const adapter = root.inject(name);
+            if (!adapter?.endpoints)
+                continue;
+            for (const [epId, ep] of adapter.endpoints) {
+                const ref = { adapter: name, endpointId: epId };
+                map.set(epId, ref);
+                if (ep.$config?.name)
+                    map.set(String(ep.$config.name), ref);
+                if (ep.$config?.appid)
+                    map.set(String(ep.$config.appid), ref);
+                if (ep.$platformUserId)
+                    map.set(String(ep.$platformUserId), ref);
+            }
+        }
+        catch {
+            // adapter not ready
+        }
+    }
+    return map;
+}
+/** Planner 对同一入站消息只推进一次（防并发双跳步）。 */
+const plannerAdvanceByMessage = new Map();
+/**
+ * init 向导收集阶段入站门控：
+ * - 非 Planner bot：只 stash，不搭话（block）
+ * - Planner：@ 分配角色后回复下一步 prompt（block）
+ * - /collab 命令：放行给 command 分支（continue）
+ */
+export async function handleInitWizardInboundGate(message, endpointId, root) {
+    const adapter = String(message.$adapter ?? '');
+    const sceneId = String(message.$channel?.id ?? '');
+    if (!adapter || !sceneId)
+        return { action: 'continue' };
+    const sceneSvc = getSceneIdentityService();
+    const session = await sceneSvc.findActiveInitSessionForInbound(adapter, sceneId);
+    if (!session)
+        return { action: 'continue' };
+    const text = (message.$content ?? [])
+        .map((seg) => (seg.type === 'text' ? String(seg.data?.text ?? '') : ''))
+        .join('')
+        .trim();
+    if (text.startsWith('/collab'))
+        return { action: 'continue' };
+    const isPlanner = endpointId === session.plannerEndpointId;
+    const result = await observeAtForInitWizard(message, endpointId, root);
+    if (isPlanner && result.advanceResult && message.$reply) {
+        await message.$reply(result.advanceResult.nextPrompt);
+        return { action: 'block', replied: true };
+    }
+    if (result.observed || !isPlanner) {
+        return { action: 'block' };
+    }
+    return { action: 'continue' };
+}
+/**
+ * 入站消息观测：若当前有 active init session 且消息含 @ 到系统 Bot → 写 observation。
+ *
+ * 由 Planner endpoint 调用 advanceWizardStep 推进步骤；
+ * 非 Planner endpoint 仅记录 observation。
+ */
+export async function observeAtForInitWizard(message, endpointId, root) {
+    const adapter = String(message.$adapter ?? '');
+    const sceneId = String(message.$channel?.id ?? '');
+    if (!adapter || !sceneId)
+        return { observed: false };
+    const sceneSvc = getSceneIdentityService();
+    const session = await sceneSvc.findActiveInitSessionForInbound(adapter, sceneId);
+    if (!session)
+        return { observed: false };
+    const atTargets = extractAtTargets(message);
+    if (atTargets.length === 0)
+        return { observed: false };
+    const registeredMap = buildRegisteredEndpointMap(root);
+    let roleAssigneeMatched = false;
+    let matchedAny = false;
+    const currentStep = (session.wizardStep || 'researcher');
+    if (!isAssignableWizardRole(currentStep)) {
+        return { observed: false };
+    }
+    for (const target of atTargets) {
+        const resolved = registeredMap.get(target);
+        if (!resolved)
+            continue;
+        if (resolved.endpointId === session.plannerEndpointId)
+            continue;
+        await sceneSvc.addObservation({
+            sessionId: session.id,
+            observerEndpointId: endpointId,
+            observerAdapter: adapter,
+            observerSceneId: sceneId,
+            atTargetPlatformId: target,
+            wizardStep: currentStep,
+        });
+        matchedAny = true;
+        roleAssigneeMatched = true;
+    }
+    if (!matchedAny)
+        return { observed: false };
+    if (endpointId === session.plannerEndpointId && roleAssigneeMatched) {
+        const messageId = String(message.$id ?? '');
+        if (messageId && plannerAdvanceByMessage.get(session.id) === messageId) {
+            return { observed: true };
+        }
+        const result = await advanceWizardStep(session, currentStep);
+        if (result.advanced && messageId) {
+            plannerAdvanceByMessage.set(session.id, messageId);
+        }
+        if (result.advanced) {
+            return { observed: true, advanceResult: result };
+        }
+        return { observed: true };
+    }
+    return { observed: true };
+}
+//# sourceMappingURL=init-observe-hook.js.map

package/lib/collaboration/init-observe-hook.js.map

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

package/lib/collaboration/init-wizard-service.d.ts

@@ -0,0 +1,57 @@
+/**
+ * InitWizardService — 程序化向导状态机。
+ *
+ * 流程（两阶段）：
+ * 1. 收集阶段：/collab init @Planner → prompt 逐步 @ 各角色 → 各 bot stash observation
+ * 2. 提交阶段：/collab inited @Planner → 汇聚 stash → 一次性创建 Cell
+ */
+import type { CollaborationScene } from './types.js';
+import { type WizardStep } from './collaboration-db-model.js';
+import { type InitSessionRecord } from './scene-identity-service.js';
+export declare function getWizardPrompt(step: WizardStep): string;
+export interface StartWizardInput {
+    plannerEndpointId: string;
+    plannerAdapter: string;
+    plannerSceneId: string;
+}
+export interface StartWizardResult {
+    ok: boolean;
+    sessionId?: string;
+    prompt?: string;
+    error?: string;
+}
+/**
+ * 启动 init 向导：创建 init_session，返回第一步提问。
+ */
+export declare function startInitWizard(input: StartWizardInput): Promise<StartWizardResult>;
+/**
+ * 向导步骤推进：master @ 到某 bot → 记录 observation → CAS 推进一步。
+ */
+export declare function advanceWizardStep(session: InitSessionRecord, expectedStep?: WizardStep): Promise<{
+    nextPrompt: string;
+    done: boolean;
+    advanced: boolean;
+}>;
+export interface AggregateResult {
+    ok: boolean;
+    scene?: CollaborationScene;
+    warnings: string[];
+    sceneCount: number;
+    memberCount: number;
+    channelCount: number;
+}
+/**
+ * /collab inited — Planner 汇聚 stash → 一次性创建协作群（Cell + alias + channels）。
+ */
+export declare function aggregateAndActivate(session: InitSessionRecord, registeredEndpoints: Map<string, {
+    adapter: string;
+    endpointId: string;
+}>, plannerPrimary: string): Promise<AggregateResult>;
+/**
+ * 取消进行中的 init 向导。
+ */
+export declare function cancelInitWizard(adapter: string, sceneId: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=init-wizard-service.d.ts.map

package/lib/collaboration/init-wizard-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-wizard-service.d.ts","sourceRoot":"","sources":["../../src/collaboration/init-wizard-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,YAAY,CAAC;AACnE,OAAO,EAAwC,KAAK,UAAU,EAA6B,MAAM,6BAA6B,CAAC;AAC/H,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAsB9F,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAExD;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiCzF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,YAAY,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAoCnE;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,EACzE,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC,CA4F1B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ1C"}

package/lib/collaboration/init-wizard-service.js

@@ -0,0 +1,188 @@
+/**
+ * InitWizardService — 程序化向导状态机。
+ *
+ * 流程（两阶段）：
+ * 1. 收集阶段：/collab init @Planner → prompt 逐步 @ 各角色 → 各 bot stash observation
+ * 2. 提交阶段：/collab inited @Planner → 汇聚 stash → 一次性创建 Cell
+ */
+import { isAssignableWizardRole } from './collaboration-db-model.js';
+import { getSceneIdentityService } from './scene-identity-service.js';
+import { getCollaborationSceneService } from './scene-service.js';
+import { rebootstrapEndpointRuntimes } from './bootstrap-agent-runtimes.js';
+import { defaultCellId } from './collaboration-commands.js';
+const WIZARD_PROMPTS = {
+    researcher: '协作群初始化：请 @ 调研员（Researcher）Bot',
+    evaluator: '请 @ 评估员（Evaluator）Bot',
+    executor: '请 @ 执行员（Executor）Bot',
+    reviewer: '请 @ 评审员（Reviewer）Bot',
+    done: '角色选完后请发送 /collab inited @我',
+};
+const ASSIGNABLE_STEPS = ['researcher', 'evaluator', 'executor', 'reviewer'];
+function nextWizardStep(current) {
+    if (!isAssignableWizardRole(current))
+        return 'done';
+    const idx = ASSIGNABLE_STEPS.indexOf(current);
+    if (idx < 0 || idx >= ASSIGNABLE_STEPS.length - 1)
+        return 'done';
+    return ASSIGNABLE_STEPS[idx + 1];
+}
+export function getWizardPrompt(step) {
+    return WIZARD_PROMPTS[step] ?? WIZARD_PROMPTS.done;
+}
+/**
+ * 启动 init 向导：创建 init_session，返回第一步提问。
+ */
+export async function startInitWizard(input) {
+    const svc = getSceneIdentityService();
+    const existing = await svc.getActiveInitSession(input.plannerAdapter, input.plannerSceneId);
+    if (existing) {
+        const step = (existing.wizardStep || 'researcher');
+        return {
+            ok: true,
+            sessionId: existing.id,
+            prompt: `⚠️ 已有进行中的 init 向导（步骤：${step}）。\n${getWizardPrompt(step)}\n如需重来请先 /collab init-cancel`,
+        };
+    }
+    const sessionId = `init-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    const logicalSceneId = defaultCellId(input.plannerAdapter, input.plannerSceneId);
+    await svc.createInitSession({
+        id: sessionId,
+        logicalSceneId,
+        plannerEndpointId: input.plannerEndpointId,
+        plannerAdapter: input.plannerAdapter,
+        plannerSceneId: input.plannerSceneId,
+    });
+    const firstStep = 'researcher';
+    return {
+        ok: true,
+        sessionId,
+        prompt: getWizardPrompt(firstStep),
+    };
+}
+/**
+ * 向导步骤推进：master @ 到某 bot → 记录 observation → CAS 推进一步。
+ */
+export async function advanceWizardStep(session, expectedStep) {
+    const current = (session.wizardStep || 'researcher');
+    if (expectedStep && expectedStep !== current) {
+        return {
+            nextPrompt: getWizardPrompt(current),
+            done: current === 'done',
+            advanced: false,
+        };
+    }
+    const next = nextWizardStep(current);
+    const svc = getSceneIdentityService();
+    const ok = await svc.advanceInitSessionStepIf(session.id, current, next);
+    if (!ok) {
+        const fresh = (await svc.getInitSession(session.id)) ?? session;
+        const step = (fresh.wizardStep || current);
+        return {
+            nextPrompt: getWizardPrompt(step),
+            done: step === 'done',
+            advanced: false,
+        };
+    }
+    if (next === 'done') {
+        return {
+            nextPrompt: getWizardPrompt('done'),
+            done: true,
+            advanced: true,
+        };
+    }
+    return {
+        nextPrompt: getWizardPrompt(next),
+        done: false,
+        advanced: true,
+    };
+}
+/**
+ * /collab inited — Planner 汇聚 stash → 一次性创建协作群（Cell + alias + channels）。
+ */
+export async function aggregateAndActivate(session, registeredEndpoints, plannerPrimary) {
+    const sceneSvc = getSceneIdentityService();
+    const cellSvc = getCollaborationSceneService();
+    const warnings = [];
+    await sceneSvc.updateInitSessionStatus(session.id, 'aggregating');
+    const logicalSceneId = session.logicalSceneId || defaultCellId(session.plannerAdapter, session.plannerSceneId);
+    const observations = await sceneSvc.listObservations(session.id);
+    const plan = sceneSvc.planInitFromObservations(logicalSceneId, observations, registeredEndpoints, { plannerEndpointId: session.plannerEndpointId });
+    const plannerSceneAlias = {
+        logicalSceneId,
+        adapter: session.plannerAdapter,
+        sceneId: session.plannerSceneId,
+    };
+    const sceneAliasDedup = new Map();
+    sceneAliasDedup.set(`${plannerSceneAlias.adapter}:${plannerSceneAlias.sceneId}`, plannerSceneAlias);
+    for (const alias of plan.sceneAliases) {
+        sceneAliasDedup.set(`${alias.adapter}:${alias.sceneId}`, alias);
+    }
+    const plannerChannels = [...sceneAliasDedup.values()].map((alias) => ({
+        logicalSceneId,
+        endpointId: session.plannerEndpointId,
+        pipelineRole: 'planner',
+        adapter: alias.adapter,
+        sceneId: alias.sceneId,
+        botId: session.plannerEndpointId,
+    }));
+    const allChannels = [...plannerChannels, ...plan.channels];
+    await sceneSvc.commitInitPlan({
+        logicalSceneId,
+        sceneAliases: [...sceneAliasDedup.values()],
+        channels: allChannels,
+    });
+    const memberInputs = [
+        {
+            endpointId: session.plannerEndpointId,
+            primary: plannerPrimary || 'planner',
+            pipelineRole: 'planner',
+            adapter: session.plannerAdapter,
+        },
+        ...plan.members.map((m) => ({
+            endpointId: m.endpointId,
+            primary: m.pipelineRole,
+            pipelineRole: m.pipelineRole,
+            adapter: m.adapter,
+        })),
+    ];
+    const deduped = new Map();
+    for (const m of memberInputs) {
+        if (!deduped.has(m.endpointId)) {
+            deduped.set(m.endpointId, m);
+        }
+    }
+    const missingRoles = ASSIGNABLE_STEPS.filter((role) => ![...deduped.values()].some((m) => m.pipelineRole === role));
+    if (missingRoles.length > 0) {
+        warnings.push(`缺少角色：${missingRoles.join(', ')}（可稍后用 /collab bind 补充）`);
+    }
+    const cell = await cellSvc.upsertScene({
+        id: logicalSceneId,
+        adapter: session.plannerAdapter,
+        sceneId: session.plannerSceneId,
+        goal: '多 Agent 协作群',
+        members: [...deduped.values()],
+    });
+    await sceneSvc.updateInitSessionStatus(session.id, 'active', logicalSceneId);
+    await rebootstrapEndpointRuntimes();
+    return {
+        ok: true,
+        scene: cell,
+        warnings,
+        sceneCount: sceneAliasDedup.size,
+        memberCount: deduped.size,
+        channelCount: allChannels.length,
+    };
+}
+/**
+ * 取消进行中的 init 向导。
+ */
+export async function cancelInitWizard(adapter, sceneId) {
+    const svc = getSceneIdentityService();
+    const session = await svc.getActiveInitSession(adapter, sceneId);
+    if (!session) {
+        return { ok: false, error: '当前群没有进行中的 init 向导。' };
+    }
+    await svc.updateInitSessionStatus(session.id, 'cancelled');
+    return { ok: true };
+}
+//# sourceMappingURL=init-wizard-service.js.map

package/lib/collaboration/init-wizard-service.js.map

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

package/lib/collaboration/outbound-resolver.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 协作出站 SSOT — parse → planner role strategy → JSON 失败兜底 → delivery 扩展。
+ */
+import type { OutputElement } from '@zhin.js/ai';
+import { type Message, type MessageElement } from '@zhin.js/core';
+import type { CollaborationScene } from './types.js';
+import { type GroupMessageAdapterView } from './group-message.js';
+export interface OutboundBatchMeta {
+    fallback?: string;
+    peerTriggerExpected: boolean;
+}
+export interface ResolveOutboundBatchesInput {
+    message: Message;
+    elements: OutputElement[];
+    inboundContent?: string;
+    cell?: CollaborationScene;
+    endpointId: string;
+    adapterView?: GroupMessageAdapterView;
+    selfMember?: CollaborationScene['members'][number];
+    warn?: (message: string) => void;
+    root?: import('@zhin.js/core').Plugin;
+}
+export interface ResolveOutboundBatchesResult {
+    batches: MessageElement[][];
+    batchMeta: OutboundBatchMeta[];
+    primaryFallback?: string;
+}
+/** 剥离正文中的假 @token，避免 JSON 解析失败时误触发 peer。 */
+export declare function stripFakeAtTokens(text: string): string;
+/** 批次是否为对 peer 的真实 @ 委派。 */
+export declare function isPlannerDelegateBatch(batch: MessageElement[], cell: CollaborationScene, selfEndpointId: string, adapter?: GroupMessageAdapterView): boolean;
+/** Planner 出站 role strategy：拆分委派 @、剥离 self 假 @，不删除真实委派 batch。 */
+export declare function normalizePlannerOutboundBatches(batches: MessageElement[][], cell: CollaborationScene, selfEndpointId: string, adapter: GroupMessageAdapterView): MessageElement[][];
+export declare function resolveOutboundBatches(input: ResolveOutboundBatchesInput): Promise<ResolveOutboundBatchesResult>;
+//# sourceMappingURL=outbound-resolver.d.ts.map

package/lib/collaboration/outbound-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-resolver.d.ts","sourceRoot":"","sources":["../../src/collaboration/outbound-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,YAAY,CAAC;AAEnE,OAAO,EAA2D,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAS3H,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,UAAU,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,eAAe,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC;IAC5B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD;AAcD,4BAA4B;AAC5B,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,IAAI,EAAE,kBAAkB,EACxB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAOT;AAmGD,iEAAiE;AACjE,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,EAAE,EAAE,EAC3B,IAAI,EAAE,kBAAkB,EACxB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,EAAE,EAAE,CAgBpB;AAeD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAyDvC"}