@uvl000/claude-trace 3.0.13-workflowexp.1

package/dist/config/claude-config-overlay.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @file Persistent Claude Code config overlay for reverse-proxy interception.
+ *
+ * When the user's `~/.claude/settings.json` defines its own `ANTHROPIC_BASE_URL`,
+ * setting the env var alone is insufficient — Claude Code prefers settings over env.
+ * This module builds a writable overlay at `~/.claude-trace/claude-config-overlay/`
+ * that symlinks all config entries except `settings.json`, which is rewritten to
+ * strip `ANTHROPIC_BASE_URL` so the trace runner's proxy URL takes effect.
+ */
+/** Result of syncing source config entries into the overlay directory. */
+export interface OverlaySyncResult {
+    /** Entry names successfully linked into the overlay. */
+    linked: string[];
+    /** Entries that could not be linked, with error reasons. */
+    skipped: Array<{
+        entry: string;
+        reason: string;
+    }>;
+}
+/**
+ * Returns the persistent overlay directory path for Claude Code config.
+ *
+ * @returns Absolute path under `~/.claude-trace/claude-config-overlay/`.
+ */
+export declare function getClaudeConfigOverlayDir(): string;
+/**
+ * Returns true when `dir` is the canonical persistent overlay directory.
+ *
+ * Used to avoid deleting or recreating an overlay that is already in use.
+ *
+ * @param dir - Directory path to check, or `null`.
+ */
+export declare function isPersistentOverlayDir(dir: string | null): boolean;
+/**
+ * Resolves the user's real Claude Code config directory.
+ *
+ * @param env - Environment map; defaults to `process.env`.
+ * @returns `CLAUDE_CONFIG_DIR` if set, otherwise `~/.claude`.
+ */
+export declare function resolveUserClaudeConfigDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * Builds or refreshes the Claude config overlay by symlinking source entries.
+ *
+ * All entries from `sourceConfigDir` are linked except `settings.json`, which
+ * is handled separately by {@link writeOverlaySettings}. Home-level state files
+ * are also linked when present.
+ *
+ * @param sourceConfigDir - User's real Claude config directory (`~/.claude`).
+ * @param overlayDir - Writable overlay directory to populate.
+ * @param homeDir - User home directory for `.claude.json` / `.credentials.json`.
+ * @returns Summary of linked and skipped entries.
+ */
+export declare function syncClaudeConfigOverlay(sourceConfigDir: string, overlayDir: string, homeDir: string): OverlaySyncResult;
+/**
+ * Writes a modified `settings.json` into the overlay, stripping `ANTHROPIC_BASE_URL`.
+ *
+ * Claude Code reads `settings.json` env overrides with higher priority than process
+ * environment variables. Removing `ANTHROPIC_BASE_URL` from settings ensures the
+ * trace runner's `ANTHROPIC_BASE_URL=http://127.0.0.1:{port}` proxy URL wins.
+ *
+ * @param sourceSettingsPath - Path to the user's original `settings.json`.
+ * @param overlayDir - Overlay directory to write the modified settings into.
+ * @returns Paths needed to spawn Claude with `CLAUDE_CONFIG_DIR` pointing at the overlay.
+ */
+export declare function writeOverlaySettings(sourceSettingsPath: string, overlayDir: string): {
+    overlayDir: string;
+    spawnClaudeConfigDir: string;
+};
+//# sourceMappingURL=claude-config-overlay.d.ts.map

package/dist/config/claude-config-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-config-overlay.d.ts","sourceRoot":"","sources":["../../src/config/claude-config-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IACjC,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKlE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEvF;AAwGD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACtC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACb,iBAAiB,CAuBnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CACnC,kBAAkB,EAAE,MAAM,EAC1B,UAAU,EAAE,MAAM,GAChB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,CAiBtD"}

package/dist/config/claude-config-overlay.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * @file Persistent Claude Code config overlay for reverse-proxy interception.
+ *
+ * When the user's `~/.claude/settings.json` defines its own `ANTHROPIC_BASE_URL`,
+ * setting the env var alone is insufficient — Claude Code prefers settings over env.
+ * This module builds a writable overlay at `~/.claude-trace/claude-config-overlay/`
+ * that symlinks all config entries except `settings.json`, which is rewritten to
+ * strip `ANTHROPIC_BASE_URL` so the trace runner's proxy URL takes effect.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClaudeConfigOverlayDir = getClaudeConfigOverlayDir;
+exports.isPersistentOverlayDir = isPersistentOverlayDir;
+exports.resolveUserClaudeConfigDir = resolveUserClaudeConfigDir;
+exports.syncClaudeConfigOverlay = syncClaudeConfigOverlay;
+exports.writeOverlaySettings = writeOverlaySettings;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/** Filename of Claude Code's primary settings file within the config directory. */
+const SETTINGS_FILE = "settings.json";
+/**
+ * Returns the persistent overlay directory path for Claude Code config.
+ *
+ * @returns Absolute path under `~/.claude-trace/claude-config-overlay/`.
+ */
+function getClaudeConfigOverlayDir() {
+    return path.join(os.homedir(), ".claude-trace", "claude-config-overlay");
+}
+/**
+ * Returns true when `dir` is the canonical persistent overlay directory.
+ *
+ * Used to avoid deleting or recreating an overlay that is already in use.
+ *
+ * @param dir - Directory path to check, or `null`.
+ */
+function isPersistentOverlayDir(dir) {
+    if (!dir) {
+        return false;
+    }
+    return path.resolve(dir) === path.resolve(getClaudeConfigOverlayDir());
+}
+/**
+ * Resolves the user's real Claude Code config directory.
+ *
+ * @param env - Environment map; defaults to `process.env`.
+ * @returns `CLAUDE_CONFIG_DIR` if set, otherwise `~/.claude`.
+ */
+function resolveUserClaudeConfigDir(env = process.env) {
+    return env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude");
+}
+/**
+ * Creates a directory symlink (junction on Windows, dir symlink elsewhere).
+ *
+ * @param sourcePath - Existing directory to link from.
+ * @param overlayPath - Destination path inside the overlay.
+ */
+function linkDirectory(sourcePath, overlayPath) {
+    const absoluteSource = path.resolve(sourcePath);
+    if (process.platform === "win32") {
+        // Junctions work without admin privileges on Windows for directories.
+        fs.symlinkSync(absoluteSource, overlayPath, "junction");
+        return;
+    }
+    fs.symlinkSync(absoluteSource, overlayPath, "dir");
+}
+/**
+ * Symlinks a file into the overlay, falling back to a plain copy on failure.
+ *
+ * Symlink creation may fail on Windows without Developer Mode; copy preserves behavior.
+ *
+ * @param sourcePath - Existing file in the user's real config directory.
+ * @param overlayPath - Destination path inside the overlay.
+ */
+function linkOrCopyFile(sourcePath, overlayPath) {
+    try {
+        if (process.platform === "win32") {
+            fs.symlinkSync(path.resolve(sourcePath), overlayPath, "file");
+        }
+        else {
+            fs.symlinkSync(sourcePath, overlayPath, "file");
+        }
+    }
+    catch {
+        fs.copyFileSync(sourcePath, overlayPath);
+    }
+}
+/**
+ * Links a single source entry (file or directory) into the overlay if not present.
+ *
+ * Skips silently when the overlay entry already exists to preserve idempotency.
+ *
+ * @param sourcePath - Path to the source file or directory.
+ * @param overlayPath - Corresponding path inside the overlay directory.
+ */
+function linkEntry(sourcePath, overlayPath) {
+    if (fs.existsSync(overlayPath)) {
+        return;
+    }
+    const stat = fs.lstatSync(sourcePath);
+    if (stat.isDirectory()) {
+        linkDirectory(sourcePath, overlayPath);
+        return;
+    }
+    linkOrCopyFile(sourcePath, overlayPath);
+}
+/**
+ * Attempts to link one entry and records success or failure in `result`.
+ *
+ * Missing source files are ignored (not an error — optional config entries).
+ *
+ * @param entryLabel - Human-readable name recorded in the sync result.
+ * @param sourcePath - Source file or directory path.
+ * @param overlayPath - Destination path inside the overlay.
+ * @param result - Mutable sync result accumulator.
+ */
+function tryLinkEntryWithResult(entryLabel, sourcePath, overlayPath, result) {
+    if (!fs.existsSync(sourcePath)) {
+        return;
+    }
+    try {
+        linkEntry(sourcePath, overlayPath);
+        result.linked.push(entryLabel);
+    }
+    catch (error) {
+        const err = error;
+        result.skipped.push({ entry: entryLabel, reason: err.message });
+    }
+}
+/**
+ * Links Claude home-level state files that live outside the config directory.
+ *
+ * These files (`.claude.json`, `.credentials.json`) are required for auth and
+ * session state but are not inside `~/.claude/`.
+ *
+ * @param overlayDir - Overlay directory receiving the links.
+ * @param homeDir - User home directory containing the state files.
+ * @param result - Mutable sync result accumulator.
+ */
+function linkHomeStateFiles(overlayDir, homeDir, result) {
+    for (const fileName of [".claude.json", ".credentials.json"]) {
+        tryLinkEntryWithResult(fileName, path.join(homeDir, fileName), path.join(overlayDir, fileName), result);
+    }
+}
+/**
+ * Builds or refreshes the Claude config overlay by symlinking source entries.
+ *
+ * All entries from `sourceConfigDir` are linked except `settings.json`, which
+ * is handled separately by {@link writeOverlaySettings}. Home-level state files
+ * are also linked when present.
+ *
+ * @param sourceConfigDir - User's real Claude config directory (`~/.claude`).
+ * @param overlayDir - Writable overlay directory to populate.
+ * @param homeDir - User home directory for `.claude.json` / `.credentials.json`.
+ * @returns Summary of linked and skipped entries.
+ */
+function syncClaudeConfigOverlay(sourceConfigDir, overlayDir, homeDir) {
+    const result = { linked: [], skipped: [] };
+    fs.mkdirSync(overlayDir, { recursive: true });
+    if (fs.existsSync(sourceConfigDir)) {
+        for (const entry of fs.readdirSync(sourceConfigDir)) {
+            // settings.json is rewritten separately to remove ANTHROPIC_BASE_URL.
+            if (entry === SETTINGS_FILE) {
+                continue;
+            }
+            tryLinkEntryWithResult(entry, path.join(sourceConfigDir, entry), path.join(overlayDir, entry), result);
+        }
+    }
+    linkHomeStateFiles(overlayDir, homeDir, result);
+    return result;
+}
+/**
+ * Writes a modified `settings.json` into the overlay, stripping `ANTHROPIC_BASE_URL`.
+ *
+ * Claude Code reads `settings.json` env overrides with higher priority than process
+ * environment variables. Removing `ANTHROPIC_BASE_URL` from settings ensures the
+ * trace runner's `ANTHROPIC_BASE_URL=http://127.0.0.1:{port}` proxy URL wins.
+ *
+ * @param sourceSettingsPath - Path to the user's original `settings.json`.
+ * @param overlayDir - Overlay directory to write the modified settings into.
+ * @returns Paths needed to spawn Claude with `CLAUDE_CONFIG_DIR` pointing at the overlay.
+ */
+function writeOverlaySettings(sourceSettingsPath, overlayDir) {
+    const settings = JSON.parse(fs.readFileSync(sourceSettingsPath, "utf-8"));
+    if (settings.env?.ANTHROPIC_BASE_URL) {
+        const { ANTHROPIC_BASE_URL: _removed, ...restEnv } = settings.env;
+        settings.env = restEnv;
+    }
+    fs.mkdirSync(overlayDir, { recursive: true });
+    fs.writeFileSync(path.join(overlayDir, SETTINGS_FILE), JSON.stringify(settings, null, 2));
+    return {
+        overlayDir,
+        spawnClaudeConfigDir: overlayDir,
+    };
+}
+//# sourceMappingURL=claude-config-overlay.js.map

package/dist/config/claude-config-overlay.js.map

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

package/dist/config/codex-config-overlay.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @file Persistent Codex CLI config overlay for reverse-proxy interception.
+ *
+ * Codex reads API base URLs from `$CODEX_HOME/config.toml` and optional profile
+ * files (`*.config.toml`). This module builds a writable overlay at
+ * `~/.claude-trace/codex-config-overlay/` that rewrites all base URLs to the local
+ * trace proxy while symlinking auth and other non-config files from the real
+ * `$CODEX_HOME`. WebSocket support is disabled in custom providers for MVP logging.
+ */
+import type { OverlaySyncResult } from "./claude-config-overlay";
+/**
+ * Built-in Codex provider ids whose base URLs are managed by Codex itself.
+ * Custom providers in `model_providers` are rewritten; these are skipped.
+ */
+declare const RESERVED_BUILTIN_PROVIDERS: Set<string>;
+/** Parsed shape of Codex `config.toml` relevant to proxy rewriting. */
+export interface CodexConfig {
+    /** Default model identifier. */
+    model?: string;
+    /** Active model provider id. */
+    model_provider?: string;
+    /** OpenAI API key auth base URL (typically `/v1/responses`). */
+    openai_base_url?: string;
+    /** ChatGPT OAuth base URL (typically `/backend-api/codex/responses`). */
+    chatgpt_base_url?: string;
+    /** User-defined custom model providers keyed by provider id. */
+    model_providers?: Record<string, CodexModelProvider>;
+    /** Additional TOML keys preserved through parse/stringify round-trips. */
+    [key: string]: unknown;
+}
+/** Parsed shape of Codex `auth.json` fields used for proxy routing. */
+export interface CodexAuth {
+    /** Active auth mode when present (e.g. `"chatgpt"` for ChatGPT OAuth). */
+    auth_mode?: string;
+    /** OpenAI API key when using API-key auth; `null` under ChatGPT OAuth. */
+    OPENAI_API_KEY?: string | null;
+    /** Additional auth file keys preserved through parse round-trips. */
+    [key: string]: unknown;
+}
+/** A custom model provider entry within `model_providers`. */
+export interface CodexModelProvider {
+    /** Human-readable provider name. */
+    name?: string;
+    /** Upstream API base URL for this provider. */
+    base_url?: string;
+    /** Wire protocol identifier (e.g. OpenAI-compatible). */
+    wire_api?: string;
+    /** Whether the provider supports WebSocket streaming. */
+    supports_websockets?: boolean;
+    /** Additional provider-specific TOML keys. */
+    [key: string]: unknown;
+}
+/**
+ * Returns the persistent overlay directory path for Codex config.
+ *
+ * @returns Absolute path under `~/.claude-trace/codex-config-overlay/`.
+ */
+export declare function getCodexConfigOverlayDir(): string;
+/**
+ * Returns true when `dir` is the canonical persistent Codex overlay directory.
+ *
+ * @param dir - Directory path to check, or `null`.
+ */
+export declare function isPersistentCodexOverlayDir(dir: string | null): boolean;
+/**
+ * Resolves the user's real Codex home directory.
+ *
+ * @param env - Environment map; defaults to `process.env`.
+ * @returns `CODEX_HOME` if set, otherwise `~/.codex`.
+ */
+export declare function resolveUserCodexHome(env?: NodeJS.ProcessEnv): string;
+/**
+ * Returns the path to `config.toml` if it exists, otherwise `null`.
+ *
+ * @param codexHome - Codex home directory; defaults to {@link resolveUserCodexHome}.
+ */
+export declare function resolveCodexConfigPath(codexHome?: string): string | null;
+/**
+ * Reads and parses Codex `config.toml`, returning an empty object on missing/error.
+ *
+ * @param codexHome - Codex home directory; defaults to {@link resolveUserCodexHome}.
+ */
+export declare function readCodexConfig(codexHome?: string): CodexConfig;
+/**
+ * Reads and parses Codex `auth.json`, returning `null` when missing or invalid.
+ *
+ * @param codexHome - Codex home directory; defaults to {@link resolveUserCodexHome}.
+ */
+export declare function readCodexAuth(codexHome?: string): CodexAuth | null;
+/**
+ * Returns true when `auth.json` explicitly selects ChatGPT OAuth.
+ *
+ * Only checks the `auth_mode` field when it is present; older auth files
+ * without `auth_mode` fall through to {@link hasChatGptAuth} heuristics.
+ *
+ * @param codexHome - Codex home directory; defaults to {@link resolveUserCodexHome}.
+ */
+export declare function isChatGptAuthMode(codexHome?: string): boolean;
+/**
+ * Detects whether the user has ChatGPT OAuth credentials (vs OpenAI API key auth).
+ *
+ * Prefers an explicit `auth_mode: "chatgpt"` in `auth.json`. When `auth_mode` is
+ * absent, falls back to a legacy content heuristic for older Codex installs.
+ *
+ * @param codexHome - Codex home directory; defaults to {@link resolveUserCodexHome}.
+ */
+export declare function hasChatGptAuth(codexHome?: string): boolean;
+/**
+ * Builds or refreshes the Codex config overlay.
+ *
+ * 1. Rewrites main `config.toml` and all `*.config.toml` profiles with proxy URLs.
+ * 2. Symlinks remaining `$CODEX_HOME` entries (auth, sessions, etc.) into the overlay.
+ *
+ * @param sourceHome - User's real `$CODEX_HOME` directory.
+ * @param overlayDir - Writable overlay directory to populate.
+ * @param proxyUrl - Local trace proxy base URL (e.g. `http://127.0.0.1:PORT`).
+ * @returns Summary of linked and skipped non-config entries.
+ */
+export declare function syncCodexConfigOverlay(sourceHome: string, overlayDir: string, proxyUrl: string): OverlaySyncResult;
+/** Built-in Codex provider ids excluded from proxy URL rewriting. */
+export { RESERVED_BUILTIN_PROVIDERS };
+//# sourceMappingURL=codex-config-overlay.d.ts.map

package/dist/config/codex-config-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-config-overlay.d.ts","sourceRoot":"","sources":["../../src/config/codex-config-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKjE;;;GAGG;AACH,QAAA,MAAM,0BAA0B,aAA4C,CAAC;AAE7E,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC3B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACrD,0EAA0E;IAC1E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qEAAqE;IACrE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IAClC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,8CAA8C;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAiFD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAW/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAYlE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAuB1D;AA+ED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACd,iBAAiB,CA0BnB;AAED,qEAAqE;AACrE,OAAO,EAAE,0BAA0B,EAAE,CAAC"}