im-hub-pro 0.2.29

package/dist/core/agent-cwd.test.js

@@ -0,0 +1,149 @@
+import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
+import { mkdtemp, readFile, writeFile, rm, access } from 'fs/promises';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { resolveAgentCwd, defaultAgentCwd, imhubWorkspacesRoot, ensureAgentWorkspace, bootstrapAgentWorkspaces, } from './agent-cwd.js';
+const FULL_IM_OPTS = { threadId: 'thread-A', platform: 'feishu', channelId: 'chan-1', userId: 'u1' };
+const NO_IM_OPTS = { model: 'sonnet' };
+describe('resolveAgentCwd', () => {
+    let tmpRoot;
+    let prevRoot;
+    let prevClaudeOverride;
+    let prevOpencodeOverride;
+    beforeEach(async () => {
+        tmpRoot = await mkdtemp(join(tmpdir(), 'imhub-cwdtest-'));
+        prevRoot = process.env.IMHUB_WORKSPACES_ROOT;
+        prevClaudeOverride = process.env.IMHUB_CLAUDE_CODE_CWD;
+        prevOpencodeOverride = process.env.IMHUB_OPENCODE_CWD;
+        process.env.IMHUB_WORKSPACES_ROOT = tmpRoot;
+        delete process.env.IMHUB_CLAUDE_CODE_CWD;
+        delete process.env.IMHUB_OPENCODE_CWD;
+    });
+    afterEach(async () => {
+        if (prevRoot === undefined)
+            delete process.env.IMHUB_WORKSPACES_ROOT;
+        else
+            process.env.IMHUB_WORKSPACES_ROOT = prevRoot;
+        if (prevClaudeOverride === undefined)
+            delete process.env.IMHUB_CLAUDE_CODE_CWD;
+        else
+            process.env.IMHUB_CLAUDE_CODE_CWD = prevClaudeOverride;
+        if (prevOpencodeOverride === undefined)
+            delete process.env.IMHUB_OPENCODE_CWD;
+        else
+            process.env.IMHUB_OPENCODE_CWD = prevOpencodeOverride;
+        await rm(tmpRoot, { recursive: true, force: true });
+    });
+    it('returns default workspace dir when full IM context is present', () => {
+        expect(resolveAgentCwd('claude-code', FULL_IM_OPTS)).toBe(join(tmpRoot, 'claude-code'));
+    });
+    it('returns undefined for non-IM call (web/scheduler), preserving inherited cwd', () => {
+        expect(resolveAgentCwd('claude-code', NO_IM_OPTS)).toBeUndefined();
+    });
+    it('returns undefined when only one of threadId/platform is set', () => {
+        expect(resolveAgentCwd('claude-code', { threadId: 't1' })).toBeUndefined();
+        expect(resolveAgentCwd('claude-code', { platform: 'feishu' })).toBeUndefined();
+    });
+    it('env override beats default IM dir', () => {
+        process.env.IMHUB_CLAUDE_CODE_CWD = '/srv/explicit';
+        expect(resolveAgentCwd('claude-code', FULL_IM_OPTS)).toBe('/srv/explicit');
+    });
+    it('env override also wins for non-IM calls (admin escape hatch)', () => {
+        process.env.IMHUB_CLAUDE_CODE_CWD = '/srv/explicit';
+        expect(resolveAgentCwd('claude-code', NO_IM_OPTS)).toBe('/srv/explicit');
+    });
+    it('env key respects per-agent naming (hyphen to underscore, uppercase)', () => {
+        process.env.IMHUB_OPENCODE_CWD = '/srv/oc';
+        expect(resolveAgentCwd('opencode', FULL_IM_OPTS)).toBe('/srv/oc');
+        expect(resolveAgentCwd('claude-code', FULL_IM_OPTS)).toBe(join(tmpRoot, 'claude-code'));
+    });
+    it('IMHUB_WORKSPACES_ROOT moves the default for every agent at once', () => {
+        expect(imhubWorkspacesRoot()).toBe(tmpRoot);
+        expect(defaultAgentCwd('claude-code')).toBe(join(tmpRoot, 'claude-code'));
+        expect(defaultAgentCwd('opencode')).toBe(join(tmpRoot, 'opencode'));
+    });
+});
+describe('ensureAgentWorkspace', () => {
+    let tmpRoot;
+    let prevRoot;
+    beforeEach(async () => {
+        tmpRoot = await mkdtemp(join(tmpdir(), 'imhub-cwdtest-'));
+        prevRoot = process.env.IMHUB_WORKSPACES_ROOT;
+        process.env.IMHUB_WORKSPACES_ROOT = tmpRoot;
+    });
+    afterEach(async () => {
+        if (prevRoot === undefined)
+            delete process.env.IMHUB_WORKSPACES_ROOT;
+        else
+            process.env.IMHUB_WORKSPACES_ROOT = prevRoot;
+        await rm(tmpRoot, { recursive: true, force: true });
+    });
+    it('creates the dir and seed file when missing', async () => {
+        const dir = await ensureAgentWorkspace('claude-code', { filename: 'CLAUDE.md', content: '# seed' });
+        expect(dir).toBe(join(tmpRoot, 'claude-code'));
+        expect(await readFile(join(dir, 'CLAUDE.md'), 'utf8')).toBe('# seed');
+    });
+    it('does NOT overwrite an existing seed file', async () => {
+        const dir = join(tmpRoot, 'claude-code');
+        await ensureAgentWorkspace('claude-code', { filename: 'CLAUDE.md', content: '# seed' });
+        await writeFile(join(dir, 'CLAUDE.md'), 'USER EDITED', 'utf8');
+        await ensureAgentWorkspace('claude-code', { filename: 'CLAUDE.md', content: '# new seed' });
+        expect(await readFile(join(dir, 'CLAUDE.md'), 'utf8')).toBe('USER EDITED');
+    });
+    it('is fully idempotent across many calls', async () => {
+        for (let i = 0; i < 5; i++) {
+            await ensureAgentWorkspace('opencode', { filename: 'AGENTS.md', content: '# x' });
+        }
+        expect(await readFile(join(tmpRoot, 'opencode', 'AGENTS.md'), 'utf8')).toBe('# x');
+    });
+    it('honors IMHUB_<AGENT>_CWD override and bootstraps THAT path instead', async () => {
+        const altDir = join(tmpRoot, 'custom-spot');
+        process.env.IMHUB_CLAUDE_CODE_CWD = altDir;
+        try {
+            const dir = await ensureAgentWorkspace('claude-code', { filename: 'CLAUDE.md', content: '# alt' });
+            expect(dir).toBe(altDir);
+            expect(await readFile(join(altDir, 'CLAUDE.md'), 'utf8')).toBe('# alt');
+            let defaultExists = false;
+            try {
+                await access(join(tmpRoot, 'claude-code'));
+                defaultExists = true;
+            }
+            catch { /* expected */ }
+            expect(defaultExists).toBe(false);
+        }
+        finally {
+            delete process.env.IMHUB_CLAUDE_CODE_CWD;
+        }
+    });
+});
+describe('bootstrapAgentWorkspaces', () => {
+    let tmpRoot;
+    let prevRoot;
+    beforeEach(async () => {
+        tmpRoot = await mkdtemp(join(tmpdir(), 'imhub-cwdtest-'));
+        prevRoot = process.env.IMHUB_WORKSPACES_ROOT;
+        process.env.IMHUB_WORKSPACES_ROOT = tmpRoot;
+    });
+    afterEach(async () => {
+        if (prevRoot === undefined)
+            delete process.env.IMHUB_WORKSPACES_ROOT;
+        else
+            process.env.IMHUB_WORKSPACES_ROOT = prevRoot;
+        await rm(tmpRoot, { recursive: true, force: true });
+    });
+    it('creates both built-in agent workspaces with their canonical seed files', async () => {
+        const result = await bootstrapAgentWorkspaces();
+        const byAgent = Object.fromEntries(result.map((r) => [r.agent, r.dir]));
+        expect(byAgent['claude-code']).toBe(join(tmpRoot, 'claude-code'));
+        expect(byAgent['opencode']).toBe(join(tmpRoot, 'opencode'));
+        expect(await readFile(join(tmpRoot, 'claude-code', 'CLAUDE.md'), 'utf8')).toContain('Claude Code');
+        expect(await readFile(join(tmpRoot, 'opencode', 'AGENTS.md'), 'utf8')).toContain('OpenCode');
+    });
+    it('safe to run twice and does not stomp user edits', async () => {
+        await bootstrapAgentWorkspaces();
+        await writeFile(join(tmpRoot, 'claude-code', 'CLAUDE.md'), 'USER', 'utf8');
+        await bootstrapAgentWorkspaces();
+        expect(await readFile(join(tmpRoot, 'claude-code', 'CLAUDE.md'), 'utf8')).toBe('USER');
+    });
+});
+//# sourceMappingURL=agent-cwd.test.js.map

package/dist/core/agent-cwd.test.js.map

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

package/dist/core/approval-bus.d.ts

@@ -0,0 +1,232 @@
+export interface RunContext {
+    threadId: string;
+    platform: string;
+    userId: string;
+    channelId: string;
+}
+/** Wire-format decision sent back to the sidecar. `autoAllowFurther` is
+ *  internal-only — `sendDecision` strips it before serializing. */
+export type Decision = {
+    behavior: 'allow';
+    updatedInput?: Record<string, unknown>;
+    autoAllowFurther?: boolean;
+} | {
+    behavior: 'deny';
+    message?: string;
+};
+export interface ApprovalNotification {
+    runId: string;
+    reqId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+    toolUseId: string;
+    ctx: RunContext;
+    /** Present iff this request matched a per-thread auto-allow rule. The
+     *  notifier should render a softer prompt ("⏱ 自动放行中, 5s 内回 n 可拒绝")
+     *  instead of the regular y/n one — the bus will allow on timer expiry,
+     *  unless the user actively denies first. */
+    autoAllow?: {
+        graceMs: number;
+    };
+}
+/** Notifier 只负责"通知 IM 推卡片/消息"。不要在这里返回决策；决策走 resolvePending。 */
+export type ApprovalNotifier = (n: ApprovalNotification) => Promise<void>;
+/** Snapshot returned by {@link ApprovalBus.resolvePending} so the router can
+ *  send the user a confirmation receipt ("✅ 已批准并启用自动放行 …" or
+ *  "❌ 已拒绝并撤销自动放行 …") without re-scanning bus internals. */
+export interface ResolvedInfo {
+    runId: string;
+    threadId: string;
+    platform: string;
+    toolName: string;
+    /** Same fingerprint the bus uses for the auto-allow rule key. */
+    fingerprint: string;
+    /** True iff the resolved pending had been created in auto-allow grace
+     *  mode — i.e. matched an existing rule. Lets the router distinguish
+     *  "user denied a normal prompt" from "user denied an auto-allow prompt
+     *  (which also revoked the rule)". */
+    wasAutoAllow: boolean;
+}
+/** Why an approval was resolved. Used by ResolutionListener consumers (e.g.
+ *  approval-router) to decide whether to edit a UI card to "expired" — only
+ *  non-`user` causes need cleanup, since the user-driven path (button click /
+ *  text reply) edits the card itself before the listener fires. */
+export type ResolutionCause = 'user' | 'timeout' | 'sidecar-disconnect' | 'run-terminated' | 'shutdown' | 'notifier-error';
+/** Fired exactly once per pending when it transitions from pending → resolved.
+ *  Mirrors the wire decision sent to sidecar/dispatch but adds context (cause,
+ *  threadId, platform) so listeners can route side-effects without scanning
+ *  bus internals. Synchronous; listener errors are logged + swallowed. */
+export interface ResolutionEvent {
+    reqId: string;
+    runId: string;
+    threadId: string;
+    platform: string;
+    toolName: string;
+    fingerprint: string;
+    decision: Decision;
+    wasAutoAllow: boolean;
+    cause: ResolutionCause;
+}
+export type ResolutionListener = (e: ResolutionEvent) => void;
+export interface ApprovalBusOptions {
+    approvalTimeoutMs?: number;
+    /** Window between sending the auto-allow notice and auto-resolving as
+     *  allow (when the user doesn't actively deny in the meantime). */
+    autoAllowGraceMs?: number;
+}
+export declare class ApprovalBus {
+    private server;
+    private socketPath;
+    private readonly approvalTimeoutMs;
+    private readonly autoAllowGraceMs;
+    private runContexts;
+    private pendingById;
+    private pendingByThread;
+    private connections;
+    private notifier;
+    private resolutionListener;
+    /** threadId → set of `${toolName}::${prefix}` keys the user has marked
+     *  as auto-allow within this conversation. Cleared by clearAutoAllowForThread
+     *  (called from session.resetConversation) and on stop(). */
+    private autoAllowByThread;
+    /**
+     * Lifetime counters surfaced via {@link getMetrics}. Help ops detect
+     * leaks (pending growing unbounded), spikes (totalRequests rate), and
+     * approval skew (deny:allow ratio). Reset on stop() so the gauge for a
+     * fresh process starts at zero.
+     */
+    private metricsSnapshot;
+    constructor(opts?: ApprovalBusOptions);
+    /** 注入"通知 IM 推送"的回调。messenger 层启动时调一次。 */
+    setNotifier(n: ApprovalNotifier | null): void;
+    /** Subscribe to resolution events. Replaces any previous listener.
+     *  approval-router uses this to keep its UI cards in sync with bus-side
+     *  cancellations (timeout / sidecar disconnect / run terminated). The
+     *  user-driven path (button or y/n text) already edits its own card; the
+     *  listener still fires there with cause='user' so consumers can dedup. */
+    setResolutionListener(l: ResolutionListener | null): void;
+    /** 启动 unix socket 服务。返回最终使用的 socket 路径。 */
+    start(socketPath?: string): Promise<string>;
+    stop(): Promise<void>;
+    registerRun(runId: string, ctx: RunContext): void;
+    /** 进程结束时调。pending 全 deny，runContext 清掉。 */
+    unregisterRun(runId: string): void;
+    hasPendingFor(threadId: string): boolean;
+    /** True iff a notifier has been installed (i.e. messenger layer has wired
+     *  the bus into IM). Callers that have a fallback path (e.g. the opencode
+     *  HTTP adapter) check this before registerSyntheticPending so they can
+     *  short-circuit when the bus is dormant — mostly relevant in tests and in
+     *  non-IM call paths (web, scheduler). */
+    hasNotifier(): boolean;
+    /**
+     * 由 messenger.onMessage 拦截层调用。把 thread 队列头部的 pending 用
+     * 给定决策 resolve 掉。返回被 resolve 的 pending 描述（platform / tool /
+     * fingerprint / 是否处于 auto-allow grace 模式）；router 用这些信息发回执。
+     * 没有 pending 时返回 null。
+     *
+     * Auto-allow side-effect: a user-initiated deny against a pending that
+     * was running in auto-allow mode revokes the matching rule (the user is
+     * signaling "stop auto-approving this"). Revocation is intentionally
+     * scoped to this user-path so sidecar disconnects / shutdown / run-
+     * terminated denies don't accidentally clear rules the user still wants.
+     */
+    resolvePending(threadId: string, decision: Decision): ResolvedInfo | null;
+    /** Drop every auto-allow rule registered for this thread. Called from
+     *  session.resetConversation so `/new` truly returns to "ask every time". */
+    clearAutoAllowForThread(threadId: string): void;
+    /** Test/diagnostic helper — current rule keys for a thread. */
+    getAutoAllowKeys(threadId: string): string[];
+    /** 测试用：当前 socket 路径。 */
+    getSocketPath(): string | null;
+    /**
+     * Operational metrics snapshot used by /api/metrics (M14). `pending` is
+     * a live count; the totals are lifetime counters that monotonically
+     * increase until stop(). The three result buckets (allowed / denied /
+     * timedOut) are mutually exclusive and sum to totalResolved — see
+     * cancelPending for the bucketing rule. Cheap to call — no allocations
+     * beyond the returned object.
+     */
+    getMetrics(): {
+        pending: number;
+        totalRequests: number;
+        totalResolved: number;
+        totalAllowed: number;
+        totalDenied: number;
+        totalTimedOut: number;
+    };
+    /**
+     * Snapshot of every currently-pending approval, sanitized for surface
+     * to the operator dashboard. Used by the web `/api/approvals` endpoint
+     * (and any future ops tooling). Returns a stable JSON shape — input
+     * is included verbatim so the UI can render the same preview the
+     * IM-side card would; sockets / dispatch closures / timer handles are
+     * intentionally omitted.
+     *
+     * Sorted oldest-first so the queue head is at index 0 (matches the
+     * head-of-thread queue semantics used by resolvePending).
+     */
+    listPending(): Array<{
+        reqId: string;
+        runId: string;
+        threadId: string;
+        platform: string;
+        toolName: string;
+        input: Record<string, unknown>;
+        fingerprint: string;
+        autoAllow: boolean;
+        registeredAt: number;
+        ageMs: number;
+    }>;
+    private handleConnection;
+    private handleLine;
+    private handleApproval;
+    /**
+     * Register an approval request that did NOT come from the unix-socket
+     * sidecar. Used by the opencode HTTP bridge (P2): SSE event from opencode
+     * → bridge calls this with a `dispatch` callback that POSTs the decision
+     * back to opencode's REST API.
+     *
+     * Behavior is identical to the socket path — same notifier, same timeout,
+     * same auto-allow rules — just the delivery channel differs. The
+     * `dispatch` is invoked with the final Decision exactly once, on:
+     *   - user reply via {@link resolvePending}
+     *   - timeout (deny in normal mode, allow in auto-allow mode)
+     *   - {@link unregisterRun} (deny: "run terminated")
+     *   - {@link stop} (deny: "approval-bus shutting down")
+     *
+     * dispatch errors are logged and swallowed — the bus must not crash on
+     * a misbehaving callback.
+     *
+     * Idempotent on duplicate reqId: returns silently without firing notify
+     * (matches the socket path's "duplicate reqId" handling, minus the wire
+     * deny since the synthetic caller has no socket to deny on).
+     *
+     * Throws synchronously only when the caller's bus state is invalid (no
+     * notifier installed). The caller should avoid registering the synthetic
+     * pending in that case and fall back to its own deny path.
+     */
+    registerSyntheticPending(input: {
+        runId: string;
+        reqId: string;
+        toolName: string;
+        input: Record<string, unknown>;
+        /** Optional — used by Claude's MCP path; defaults to '' for synthetic. */
+        toolUseId?: string;
+        ctx: RunContext;
+        dispatch: (decision: Decision) => void;
+    }): Promise<void>;
+    /**
+     * Shared register-and-notify pipeline used by both the socket path and the
+     * synthetic path. Builds the PendingApproval, wires the timer, fires the
+     * notifier, and ensures the timer is cleared if the notifier itself throws.
+     */
+    private _registerPending;
+    private cancelPending;
+    private addAutoAllowRule;
+    private removeAutoAllowRule;
+    private removePending;
+    private sendDecision;
+}
+/** 进程级单例。im-hub 启动时 await approvalBus.start() 一次。 */
+export declare const approvalBus: ApprovalBus;
+//# sourceMappingURL=approval-bus.d.ts.map

package/dist/core/approval-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-bus.d.ts","sourceRoot":"","sources":["../../src/core/approval-bus.ts"],"names":[],"mappings":"AA4DA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;mEACmE;AACnE,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACzF;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,UAAU,CAAA;IACf;;;iDAG6C;IAC7C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAChC;AAED,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzE;;2DAE2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAA;IACnB;;;0CAGsC;IACtC,YAAY,EAAE,OAAO,CAAA;CACtB;AAED;;;mEAGmE;AACnE,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,SAAS,GACT,oBAAoB,GACpB,gBAAgB,GAChB,UAAU,GACV,gBAAgB,CAAA;AAEpB;;;0EAG0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,EAAE,eAAe,KAAK,IAAI,CAAA;AAuC7D,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;uEACmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IAEzC,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,kBAAkB,CAAkC;IAC5D;;iEAE6D;IAC7D,OAAO,CAAC,iBAAiB,CAAiC;IAE1D;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAMtB;gBAEW,IAAI,GAAE,kBAAuB;IAKzC,yCAAyC;IACzC,WAAW,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAI7C;;;;+EAI2E;IAC3E,qBAAqB,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI;IAIzD,2CAA2C;IACrC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqC3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC3B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI;IAIjD,2CAA2C;IAC3C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASlC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;8CAI0C;IAC1C,WAAW,IAAI,OAAO;IAItB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI;IAoBzE;iFAC6E;IAC7E,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/C,+DAA+D;IAC/D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAI5C,wBAAwB;IACxB,aAAa,IAAI,MAAM,GAAG,IAAI;IAE9B;;;;;;;OAOG;IACH,UAAU,IAAI;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,aAAa,EAAE,MAAM,CAAA;QACrB,aAAa,EAAE,MAAM,CAAA;QACrB,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,aAAa,EAAE,MAAM,CAAA;KACtB;IAWD;;;;;;;;;;OAUG;IACH,WAAW,IAAI,KAAK,CAAC;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC9B,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,OAAO,CAAA;QAClB,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,MAAM,CAAA;KACd,CAAC;IAwBF,OAAO,CAAC,gBAAgB;YAsDV,UAAU;YAwBV,cAAc;IAsC5B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,wBAAwB,CAAC,KAAK,EAAE;QACpC,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC9B,0EAA0E;QAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,GAAG,EAAE,UAAU,CAAA;QACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAA;KACvC,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjB;;;;OAIG;YACW,gBAAgB;IAyE9B,OAAO,CAAC,aAAa;IAqFrB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,YAAY;CAerB;AAqCD,qDAAqD;AACrD,eAAO,MAAM,WAAW,aAAoB,CAAA"}