@thinkrun/cli 0.1.27

package/dist/src/session/cli-session-sync.js

@@ -0,0 +1,244 @@
+/**
+ * Opt-in CLI session persistence helpers.
+ *
+ * When a ThinkRun API key is configured, local-mode commands can
+ * optionally register a session document in the cloud activity feed so
+ * that screenshots and other actions appear in the UI alongside cloud
+ * and extension sessions.
+ *
+ * ALL exported functions are fire-and-forget — they never throw and
+ * never block the caller.  The sync is a best-effort side-channel; if
+ * the cloud API is unreachable the CLI continues to function normally.
+ *
+ * File written to disk: `~/.thinkrun/local-session-{tabId}.json`
+ * (same directory as working-location.json; THINKRUN_LOCK_DIR for
+ * test isolation).
+ */
+import { existsSync, writeFileSync, readFileSync, unlinkSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { config } from '../config/store.js';
+import { getCliSessionFilePath } from '../working-location.js';
+import { resolveAgentId } from './agent-identity.js';
+// ─── Abort signal helper ──────────────────────────────────────────────────────
+/**
+ * Create an AbortSignal that fires after `ms` milliseconds, backed by a timer
+ * that is `unref()`d so it does NOT keep a short-lived CLI process alive.
+ *
+ * `AbortSignal.timeout(ms)` internally creates a referenced timer; even when
+ * the caller fire-and-forgets the fetch, that timer prevents `thinkrun attach`
+ * (and similar commands) from exiting for up to `ms` milliseconds after the
+ * command otherwise completes.  Using an unref'd timer avoids that stall while
+ * preserving the network-timeout behaviour for long-running sessions.
+ */
+function unrefAbortSignal(ms) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), ms);
+    // unref() exists in Node.js and Bun — fall back gracefully in other runtimes.
+    if (typeof timer.unref === 'function')
+        timer.unref();
+    // Note: if the fetch settles before the timeout, the setTimeout callback still
+    // fires after `ms` and calls abort() on an already-settled signal.  This is
+    // harmless (aborting a settled signal is a no-op) and not a resource leak.
+    return controller.signal;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/** Return the API key and validated HTTPS apiUrl, or null if either is absent
+ *  or insecure (to prevent credential exfiltration to non-HTTPS endpoints). */
+function getApiCredentials() {
+    const apiKey = config.get('apiKey');
+    if (!apiKey)
+        return null;
+    const rawApiUrl = config.get('apiUrl') || 'https://api.thinkbrowse.io';
+    if (!rawApiUrl.startsWith('https://'))
+        return null;
+    return { apiKey, apiUrl: rawApiUrl };
+}
+// ─── File I/O ─────────────────────────────────────────────────────────────────
+/**
+ * Read the persisted cloud sessionId for a given local tabId.
+ * Returns undefined if no session file exists or it is malformed.
+ */
+export function readCliSessionId(tabId) {
+    try {
+        const filePath = getCliSessionFilePath(tabId);
+        if (!existsSync(filePath))
+            return undefined;
+        const data = JSON.parse(readFileSync(filePath, 'utf-8'));
+        return typeof data.sessionId === 'string' ? data.sessionId : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeCliSessionId(tabId, sessionId) {
+    try {
+        writeFileSync(getCliSessionFilePath(tabId), JSON.stringify({ sessionId, tabId }), 'utf-8');
+    }
+    catch { /* ignore — best-effort */ }
+}
+function deleteCliSessionFile(tabId) {
+    try {
+        unlinkSync(getCliSessionFilePath(tabId));
+    }
+    catch { /* ignore */ }
+}
+// ─── Async helpers (used in normal operation) ─────────────────────────────────
+/**
+ * Call POST /api/sessions/local-init to register a CLI session in the
+ * cloud activity feed.  Persists the returned sessionId to disk.
+ *
+ * @returns The sessionId on success, undefined on any failure.
+ */
+export async function initCliSession(tabId, fetchFn = globalThis.fetch) {
+    const creds = getApiCredentials();
+    if (!creds)
+        return undefined;
+    const { apiKey, apiUrl } = creds;
+    try {
+        const res = await fetchFn(`${apiUrl}/api/sessions/local-init`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
+            body: JSON.stringify({ source: 'cli', tabId, agentId: resolveAgentId() }),
+            signal: unrefAbortSignal(10_000),
+        });
+        if (!res.ok)
+            return undefined;
+        const body = (await res.json());
+        const sessionId = body?.data?.sessionId;
+        if (!sessionId)
+            return undefined;
+        writeCliSessionId(tabId, sessionId);
+        return sessionId;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Fire-and-forget: POST a browser action to the cloud session action log.
+ * Never throws, never blocks the caller.
+ *
+ * @param sessionId  The cloud session ID returned by initCliSession.
+ * @param type       Action type — must be in ALLOWED_ACTION_TYPES on the server.
+ * @param details    Arbitrary key-value pairs describing the action (url, selector, etc.)
+ * @param fetchFn    Injectable fetch for testing.
+ */
+export function syncBrowserAction(sessionId, type, details, fetchFn = globalThis.fetch) {
+    const creds = getApiCredentials();
+    if (!creds)
+        return;
+    const { apiKey, apiUrl } = creds;
+    // try/catch covers synchronous errors (e.g. JSON.stringify throws, or fetchFn
+    // throws synchronously before returning a Promise). The .catch covers async rejection.
+    try {
+        fetchFn(`${apiUrl}/api/sessions/${sessionId}/local-sync/action`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
+            body: JSON.stringify({ type, details }),
+            signal: unrefAbortSignal(10_000),
+        }).catch(() => { });
+    }
+    catch { /* swallow synchronous errors */ }
+}
+/**
+ * Fire-and-forget: POST a screenshot action to the cloud session.
+ * Never throws, never blocks the caller.
+ */
+export function syncScreenshotAction(sessionId, artifactBase64, artifactMimeType, caption, fetchFn = globalThis.fetch) {
+    const creds = getApiCredentials();
+    if (!creds)
+        return;
+    const { apiKey, apiUrl } = creds;
+    try {
+        fetchFn(`${apiUrl}/api/sessions/${sessionId}/local-sync/action`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
+            body: JSON.stringify({ type: 'screenshot', artifactBase64, artifactMimeType, caption }),
+            signal: unrefAbortSignal(15_000),
+        }).then((res) => {
+            if (!res.ok) {
+                console.debug(`[thinkrun] syncScreenshotAction: HTTP ${res.status} from server`);
+            }
+            res.body?.cancel().catch(() => { });
+        }).catch(() => { });
+    }
+    catch {
+        // fire-and-forget — synchronous fetch setup errors are intentionally swallowed
+    }
+}
+/**
+ * Fire-and-forget: PATCH /api/sessions/:sessionId/local-close, then
+ * clean up the persisted session file.
+ * Never throws, never blocks the caller.
+ *
+ * The session file is deleted BEFORE the HTTP call to prevent TOCTOU
+ * races with a concurrent closeCliSessionSync (e.g. Ctrl-C fires while
+ * stopSession is already in flight).
+ */
+export function closeCliSession(tabId, status, fetchFn = globalThis.fetch) {
+    const sessionId = readCliSessionId(tabId);
+    if (!sessionId)
+        return;
+    // Delete immediately — prevents a concurrent closeCliSessionSync from
+    // double-reading the same sessionId and issuing a second PATCH.
+    deleteCliSessionFile(tabId);
+    const creds = getApiCredentials();
+    if (!creds)
+        return;
+    const { apiKey, apiUrl } = creds;
+    fetchFn(`${apiUrl}/api/sessions/${sessionId}/local-close`, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
+        body: JSON.stringify({ status }),
+        signal: unrefAbortSignal(10_000),
+    }).catch(() => { });
+    // Session file already deleted above; no .finally cleanup needed.
+}
+/**
+ * Synchronous version of closeCliSession for use in process exit handlers
+ * where async operations are not guaranteed to run to completion.
+ *
+ * Uses `curl` via spawnSync (-K - to read config from stdin) so the HTTP
+ * request completes before the process exits and the API key never appears
+ * in `ps aux` / /proc/<pid>/cmdline.
+ *
+ * The session file is deleted BEFORE the HTTP request to prevent TOCTOU
+ * races with a concurrent async closeCliSession call.
+ *
+ * @param spawnFn — injectable for testing; defaults to node:child_process spawnSync
+ */
+export function closeCliSessionSync(tabId, status, spawnFn = spawnSync) {
+    const sessionId = readCliSessionId(tabId);
+    if (!sessionId)
+        return;
+    // Delete immediately — prevents TOCTOU with concurrent closeCliSession.
+    deleteCliSessionFile(tabId);
+    const creds = getApiCredentials();
+    if (!creds)
+        return;
+    const { apiKey, apiUrl } = creds;
+    // Sanitize apiKey for curl config interpolation:
+    //  - strip CR/LF (would terminate the header = "…" line prematurely)
+    //  - escape `\` and `"` (curl config format: `"` → `\"`, `\` → `\\`)
+    const safeKey = apiKey
+        .replace(/[\r\n]/g, '')
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"');
+    // Pass credentials via curl's -K - (config from stdin) so the API key
+    // is never an argument in the process list (not visible in `ps`).
+    const curlConfig = [
+        `header = "x-api-key: ${safeKey}"`,
+        'header = "Content-Type: application/json"',
+    ].join('\n') + '\n';
+    try {
+        spawnFn('curl', [
+            '-s',
+            '-X', 'PATCH',
+            '-K', '-',
+            '-d', JSON.stringify({ status }),
+            `${apiUrl}/api/sessions/${sessionId}/local-close`,
+        ], { input: curlConfig, timeout: 5_000 });
+    }
+    catch { /* ignore — best-effort */ }
+}
+//# sourceMappingURL=cli-session-sync.js.map

package/dist/src/session/cli-session-sync.js.map

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

package/dist/src/session/context.d.ts

@@ -0,0 +1,24 @@
+export interface LocalSessionContext {
+    mode: 'local';
+    tabId: string;
+    agentSessionId?: string;
+    controlSessionId?: string;
+    windowId?: number;
+    updatedAt?: string;
+    source: 'typed' | 'legacy';
+}
+export interface CloudSessionContext {
+    mode: 'cloud';
+    sessionId: string;
+    source: 'typed' | 'legacy';
+}
+export type SessionContext = LocalSessionContext | CloudSessionContext;
+export declare function hasMixedTypedSessionState(): boolean;
+export declare function getSessionContext(): SessionContext | undefined;
+export declare function getLocalSessionContext(): LocalSessionContext | undefined;
+export declare function getCloudSessionContext(): CloudSessionContext | undefined;
+export declare function setLocalSessionContext(tabId: string, agentSessionId?: string, windowId?: number): void;
+export declare function clearLocalSessionContext(): void;
+export declare function setCloudSessionContext(sessionId: string): void;
+export declare function clearCloudSessionContext(expectedSessionId?: string): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/session/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/session/context.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AA4FvE,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CA0C9D;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAGxE;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAGxE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAOtG;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAU/C;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED,wBAAgB,wBAAwB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAezE"}

package/dist/src/session/context.js

@@ -0,0 +1,165 @@
+import { config } from '../config/store.js';
+import { mixedSessionStateError } from './errors.js';
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { getAgentFilePath, resolveAgentId } from './agent-identity.js';
+import { randomUUID } from 'node:crypto';
+import { updateWorkingLocationControlSession } from '../working-location.js';
+function sanitizeFilePart(value) {
+    return value.replace(/[^a-zA-Z0-9._-]+/g, '_') || 'default';
+}
+function getPrivateLocalSessionStatePath() {
+    const lockDir = dirname(getAgentFilePath());
+    return join(lockDir, 'agent-sessions', `${sanitizeFilePart(resolveAgentId())}.json`);
+}
+function readPrivateLocalSessionState() {
+    try {
+        const path = getPrivateLocalSessionStatePath();
+        if (!existsSync(path))
+            return undefined;
+        const data = JSON.parse(readFileSync(path, 'utf-8'));
+        if (typeof data.tabId !== 'string' || data.tabId.length === 0)
+            return undefined;
+        if (typeof data.controlSessionId !== 'string' || data.controlSessionId.length === 0)
+            return undefined;
+        return {
+            tabId: data.tabId,
+            ...(typeof data.agentSessionId === 'string' ? { agentSessionId: data.agentSessionId } : {}),
+            controlSessionId: data.controlSessionId,
+            ...(typeof data.windowId === 'number' ? { windowId: data.windowId } : {}),
+            updatedAt: typeof data.updatedAt === 'string' ? data.updatedAt : new Date(0).toISOString(),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function writePrivateLocalSessionState(tabId, agentSessionId, controlSessionId, windowId) {
+    const path = getPrivateLocalSessionStatePath();
+    mkdirSync(dirname(path), { recursive: true });
+    const resolvedControlSessionId = controlSessionId ?? agentSessionId ?? `local_${randomUUID()}`;
+    const payload = {
+        tabId,
+        ...(agentSessionId ? { agentSessionId } : {}),
+        controlSessionId: resolvedControlSessionId,
+        ...(typeof windowId === 'number' ? { windowId } : {}),
+        updatedAt: new Date().toISOString(),
+    };
+    writeFileSync(path, JSON.stringify(payload), 'utf-8');
+    updateWorkingLocationControlSession(resolvedControlSessionId);
+}
+function clearPrivateLocalSessionState() {
+    try {
+        rmSync(getPrivateLocalSessionStatePath(), { force: true });
+    }
+    catch {
+        // best-effort
+    }
+}
+function isNumericId(value) {
+    return !!value && /^\d+$/.test(value);
+}
+function getLegacyContext() {
+    const activeSessionId = config.get('activeSessionId');
+    const agentSessionId = config.get('agentSessionId');
+    if (!activeSessionId)
+        return undefined;
+    if (isNumericId(activeSessionId)) {
+        return {
+            mode: 'local',
+            tabId: activeSessionId,
+            agentSessionId,
+            source: 'legacy',
+        };
+    }
+    return {
+        mode: 'cloud',
+        sessionId: activeSessionId,
+        source: 'legacy',
+    };
+}
+export function hasMixedTypedSessionState() {
+    return !!config.get('localTabId') && !!config.get('cloudSessionId');
+}
+export function getSessionContext() {
+    if (hasMixedTypedSessionState()) {
+        throw mixedSessionStateError();
+    }
+    const localTabId = config.get('localTabId');
+    const localAgentSessionId = config.get('localAgentSessionId');
+    const cloudSessionId = config.get('cloudSessionId');
+    const privateLocalState = readPrivateLocalSessionState();
+    if (localTabId) {
+        const privateAgentSessionId = privateLocalState?.tabId === localTabId
+            ? privateLocalState.agentSessionId
+            : undefined;
+        return {
+            mode: 'local',
+            tabId: localTabId,
+            ...(privateAgentSessionId || localAgentSessionId
+                ? { agentSessionId: privateAgentSessionId ?? localAgentSessionId }
+                : {}),
+            ...(privateLocalState?.tabId === localTabId && privateLocalState.controlSessionId
+                ? { controlSessionId: privateLocalState.controlSessionId }
+                : {}),
+            ...(privateLocalState?.tabId === localTabId && typeof privateLocalState.windowId === 'number'
+                ? { windowId: privateLocalState.windowId }
+                : {}),
+            ...(privateLocalState?.tabId === localTabId && typeof privateLocalState.updatedAt === 'string'
+                ? { updatedAt: privateLocalState.updatedAt }
+                : {}),
+            source: 'typed',
+        };
+    }
+    if (cloudSessionId) {
+        return {
+            mode: 'cloud',
+            sessionId: cloudSessionId,
+            source: 'typed',
+        };
+    }
+    return getLegacyContext();
+}
+export function getLocalSessionContext() {
+    const context = getSessionContext();
+    return context?.mode === 'local' ? context : undefined;
+}
+export function getCloudSessionContext() {
+    const context = getSessionContext();
+    return context?.mode === 'cloud' ? context : undefined;
+}
+export function setLocalSessionContext(tabId, agentSessionId, windowId) {
+    config.set('localTabId', tabId);
+    config.set('activeSessionId', tabId);
+    config.delete('cloudSessionId');
+    config.delete('localAgentSessionId');
+    config.delete('agentSessionId');
+    writePrivateLocalSessionState(tabId, agentSessionId, undefined, windowId);
+}
+export function clearLocalSessionContext() {
+    config.delete('localTabId');
+    config.delete('localAgentSessionId');
+    clearPrivateLocalSessionState();
+    if (isNumericId(config.get('activeSessionId'))) {
+        config.delete('activeSessionId');
+    }
+    config.delete('agentSessionId');
+}
+export function setCloudSessionContext(sessionId) {
+    clearLocalSessionContext();
+    config.set('cloudSessionId', sessionId);
+    config.set('activeSessionId', sessionId);
+}
+export function clearCloudSessionContext(expectedSessionId) {
+    const cloudSessionId = config.get('cloudSessionId');
+    const activeSessionId = config.get('activeSessionId');
+    if (!expectedSessionId || cloudSessionId === expectedSessionId) {
+        config.delete('cloudSessionId');
+    }
+    if (activeSessionId &&
+        !isNumericId(activeSessionId) &&
+        (!expectedSessionId || activeSessionId === expectedSessionId)) {
+        config.delete('activeSessionId');
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/src/session/context.js.map

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

package/dist/src/session/continuity.d.ts

@@ -0,0 +1,33 @@
+import type { WorkingLocation } from '../working-location.js';
+export declare const DEFAULT_CONTINUITY_STALE_LEASE_WINDOW_MS: number;
+export type LocalContinuityState = 'unbound' | 'same_controller_resumable' | 'same_controller_missing_runtime' | 'foreign_controller_live' | 'stale_reclaimable' | 'ambiguous_blocked';
+export type RuntimeSessionState = 'recognized' | 'missing' | 'unknown';
+export type TabIdentityState = 'verified' | 'mismatch' | 'unknown';
+export type LegacyStateStatus = 'current' | 'legacy_safe' | 'legacy_conflict';
+export interface ContinuityPersistedBinding {
+    tabId: string;
+    agentSessionId?: string;
+}
+export interface ContinuityEvidence {
+    currentAgentId: string;
+    persistedBinding?: ContinuityPersistedBinding | null;
+    workingLocation?: Pick<WorkingLocation, 'tabId' | 'agentId' | 'controlSessionId' | 'setAt'> | null;
+    lockOwner?: Pick<WorkingLocation, 'tabId' | 'agentId' | 'controlSessionId' | 'setAt'> | null;
+    runtimeSessionState: RuntimeSessionState;
+    ownerShellAlive?: boolean | null;
+    tabIdentityState?: TabIdentityState;
+    legacyStateStatus?: LegacyStateStatus;
+    staleLeaseWindowMs?: number;
+    now?: Date | string | number;
+}
+export interface ContinuityAssessment {
+    state: LocalContinuityState;
+    effectiveTabId: string | null;
+    sameController: boolean;
+    canRepairRuntime: boolean;
+    canReclaim: boolean;
+    reason: 'no_binding' | 'same_controller_live_runtime' | 'same_controller_runtime_missing' | 'runtime_status_unknown' | 'foreign_controller_live' | 'stale_lease_reclaimable' | 'tab_identity_mismatch' | 'legacy_state_conflict' | 'conflicting_controller_evidence' | 'missing_continuity_proof' | 'insufficient_stale_evidence';
+}
+export declare function isContinuityLeaseStale(setAt: Date | string | number | undefined, now?: Date | string | number, staleLeaseWindowMs?: number): boolean;
+export declare function assessLocalContinuity(evidence: ContinuityEvidence): ContinuityAssessment;
+//# sourceMappingURL=continuity.d.ts.map

package/dist/src/session/continuity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuity.d.ts","sourceRoot":"","sources":["../../../src/session/continuity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,eAAO,MAAM,wCAAwC,QAAqB,CAAC;AAE3E,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,2BAA2B,GAC3B,iCAAiC,GACjC,yBAAyB,GACzB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAE9E,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACrD,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,GAAG,kBAAkB,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;IACnG,SAAS,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,GAAG,kBAAkB,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7F,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EACF,YAAY,GACZ,8BAA8B,GAC9B,iCAAiC,GACjC,wBAAwB,GACxB,yBAAyB,GACzB,yBAAyB,GACzB,uBAAuB,GACvB,uBAAuB,GACvB,iCAAiC,GACjC,0BAA0B,GAC1B,6BAA6B,CAAC;CACnC;AAgBD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EACzC,GAAG,GAAE,IAAI,GAAG,MAAM,GAAG,MAAmB,EACxC,kBAAkB,GAAE,MAAiD,GACpE,OAAO,CAKT;AA6CD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,oBAAoB,CA6HxF"}