@opensearch-project/agent-health 0.3.0 → 0.5.2

package/lib/dist/lib/debug.js

@@ -0,0 +1,132 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Simple Debug Utility
+ *
+ * Single source of truth: agent-health.config.json on server
+ *
+ * Server: Reads/writes agent-health.config.json
+ * Browser: Uses localStorage cache (synced via Settings page API calls)
+ */
+import fs from 'fs';
+import path from 'path';
+const isBrowser = typeof window !== 'undefined';
+// Config v2: debug lives in the project runtime state file
+// (<cwd>/.agent-health/state.json). In code-first mode (an
+// agent-health.config.ts is present) it is in-memory only (DEBUG env still honored).
+// Kept fs/path-only here because this module is isomorphic (browser + server);
+// statePaths.ts is server-only.
+const STATE_DIR = '.agent-health';
+const STATE_FILE = 'state.json';
+const AUTHORED_CONFIG_NAMES = ['agent-health.config.ts', 'agent-health.config.js', 'agent-health.config.mjs'];
+function debugIsCodeFirst() {
+    // Mirror statePaths.isCodeFirstMode: an authored config at project OR user
+    // scope (~/.agent-health/) means code-first. os.homedir() is avoided so this
+    // isomorphic module stays browser-safe; this path only runs server-side.
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return AUTHORED_CONFIG_NAMES.some((n) => fs.existsSync(path.join(process.cwd(), n)) ||
+        (!!home && fs.existsSync(path.join(home, STATE_DIR, n))));
+}
+function debugStatePath() {
+    return path.join(process.cwd(), STATE_DIR, STATE_FILE);
+}
+// Server-side: persist debug state in the runtime state file
+let serverDebugEnabled = false;
+// Initialize server debug state from the state file (ui-first) or env var
+if (!isBrowser) {
+    try {
+        const statePath = debugStatePath();
+        if (!debugIsCodeFirst() && fs.existsSync(statePath)) {
+            const config = JSON.parse(fs.readFileSync(statePath, 'utf-8')) || {};
+            serverDebugEnabled = config.debug === true;
+        }
+        else if (process.env?.DEBUG === 'true') {
+            serverDebugEnabled = true;
+        }
+    }
+    catch (err) {
+        // Ignore read errors, fall back to env var
+        if (process.env?.DEBUG === 'true') {
+            serverDebugEnabled = true;
+        }
+    }
+}
+/**
+ * Check if debug mode is enabled
+ * Server: reads from memory (loaded from agent-health.config.json)
+ * Browser: reads from localStorage cache (synced by Settings page)
+ */
+export function isDebugEnabled() {
+    if (isBrowser) {
+        try {
+            return localStorage.getItem('agenteval_debug') === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+    return serverDebugEnabled;
+}
+/**
+ * Set debug state
+ * Server: updates memory + persists to agent-health.config.json
+ * Browser: updates localStorage cache (Settings page also calls /api/debug)
+ */
+export function setDebugEnabled(enabled) {
+    if (isBrowser) {
+        try {
+            localStorage.setItem('agenteval_debug', String(enabled));
+        }
+        catch {
+            // Ignore errors (e.g. private browsing)
+        }
+        return;
+    }
+    // Server-side: update memory + persist to the runtime state file
+    serverDebugEnabled = enabled;
+    // Code-first mode: the state file is ignored; keep debug in-memory only.
+    if (debugIsCodeFirst()) {
+        console.info(`[Debug] code-first mode (agent-health.config.ts present): debug ${enabled ? 'enabled' : 'disabled'} in-memory only (not persisted)`);
+        return;
+    }
+    try {
+        const dir = path.join(process.cwd(), STATE_DIR);
+        const statePath = debugStatePath();
+        let config = {};
+        if (fs.existsSync(statePath)) {
+            const parsed = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+            if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                console.warn(`[Debug] State file contains non-object content, skipping write to avoid clobber`);
+                return;
+            }
+            config = parsed;
+        }
+        config.debug = enabled;
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(statePath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        console.info(`[Debug] Debug mode ${enabled ? 'enabled' : 'disabled'}, persisted to ${STATE_DIR}/${STATE_FILE}`);
+    }
+    catch (err) {
+        console.warn(`[Debug] Failed to persist debug state:`, err);
+    }
+}
+/**
+ * Debug log - only shown when debug mode is enabled
+ * Use for verbose/detailed logs that are noisy in normal operation
+ */
+export function debug(module, ...args) {
+    if (isDebugEnabled()) {
+        console.debug(`[${module}]`, ...args);
+    }
+}
+/**
+ * Standard log levels - always available, use appropriately:
+ * - console.error() - errors
+ * - console.warn() - warnings
+ * - console.info() - important milestones (connection established, eval complete)
+ * - console.log() - normal operational logs
+ * - debug() - verbose details (raw data, classifications, etc.)
+ */
+//# sourceMappingURL=debug.js.map

package/lib/dist/lib/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../debug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC;AAEhD,2DAA2D;AAC3D,2DAA2D;AAC3D,qFAAqF;AACrF,+EAA+E;AAC/E,gCAAgC;AAChC,MAAM,SAAS,GAAG,eAAe,CAAC;AAClC,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,qBAAqB,GAAG,CAAC,wBAAwB,EAAE,wBAAwB,EAAE,yBAAyB,CAAC,CAAC;AAE9G,SAAS,gBAAgB;IACvB,2EAA2E;IAC3E,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/D,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CACzD,CAAC;AACJ,CAAC;AACD,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED,6DAA6D;AAC7D,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B,0EAA0E;AAC1E,IAAI,CAAC,SAAS,EAAE,CAAC;IACf,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACrE,kBAAkB,GAAG,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;QAC7C,CAAC;aAAM,IAAI,OAAO,CAAC,GAAG,EAAE,KAAK,KAAK,MAAM,EAAE,CAAC;YACzC,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2CAA2C;QAC3C,IAAI,OAAO,CAAC,GAAG,EAAE,KAAK,KAAK,MAAM,EAAE,CAAC;YAClC,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,MAAM,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;QACD,OAAO;IACT,CAAC;IAED,iEAAiE;IACjE,kBAAkB,GAAG,OAAO,CAAC;IAE7B,yEAAyE;IACzE,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,mEAAmE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,iCAAiC,CAAC,CAAC;QACnJ,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;QAEnC,IAAI,MAAM,GAAQ,EAAE,CAAC;QACrB,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/D,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3E,OAAO,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;gBAChG,OAAO;YACT,CAAC;YACD,MAAM,GAAG,MAAM,CAAC;QAClB,CAAC;QAED,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;QAEvB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,kBAAkB,SAAS,IAAI,UAAU,EAAE,CAAC,CAAC;IAClH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,GAAG,IAAe;IACtD,IAAI,cAAc,EAAE,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG"}

package/lib/dist/lib/diagnostics.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Startup-diagnostic gating.
+ *
+ * Informational startup lines (`[Connectors] … registered`, `[Config] …`) are
+ * useful in interactive use and in the long-running server's own log stream,
+ * but they MUST NOT corrupt machine-readable CLI output. `console.log` writes
+ * to stdout, which is exactly the channel `agent-health list … --output json`
+ * needs to keep clean for `| jq` / `python -m json.tool`.
+ *
+ * `canLogStartupDiagnosticsToStdout()` decides whether those lines may go to
+ * stdout. It returns false (suppress) when the current invocation is a CLI
+ * command whose stdout is being consumed by a machine:
+ *   - `--output json` / `-o json` / `--output=json` was requested, or
+ *   - `--quiet` / `-q`, or
+ *   - stdout is not an interactive TTY (piped to `| jq`, redirected to a file).
+ *
+ * The long-running server is exempt: its stdout IS its log stream (often a
+ * non-TTY pipe under a process manager / tunnel), so its startup diagnostics
+ * always pass through.
+ */
+export declare function canLogStartupDiagnosticsToStdout(): boolean;
+/**
+ * Convenience: emit an informational startup diagnostic to stdout, but only
+ * when it won't corrupt machine-readable output (see
+ * `canLogStartupDiagnosticsToStdout`). A no-op otherwise.
+ */
+export declare function logStartupDiagnostic(...args: unknown[]): void;
+//# sourceMappingURL=diagnostics.d.ts.map

package/lib/dist/lib/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../diagnostics.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gCAAgC,IAAI,OAAO,CAoB1D;AAUD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAK7D"}

package/lib/dist/lib/diagnostics.js

@@ -0,0 +1,65 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Startup-diagnostic gating.
+ *
+ * Informational startup lines (`[Connectors] … registered`, `[Config] …`) are
+ * useful in interactive use and in the long-running server's own log stream,
+ * but they MUST NOT corrupt machine-readable CLI output. `console.log` writes
+ * to stdout, which is exactly the channel `agent-health list … --output json`
+ * needs to keep clean for `| jq` / `python -m json.tool`.
+ *
+ * `canLogStartupDiagnosticsToStdout()` decides whether those lines may go to
+ * stdout. It returns false (suppress) when the current invocation is a CLI
+ * command whose stdout is being consumed by a machine:
+ *   - `--output json` / `-o json` / `--output=json` was requested, or
+ *   - `--quiet` / `-q`, or
+ *   - stdout is not an interactive TTY (piped to `| jq`, redirected to a file).
+ *
+ * The long-running server is exempt: its stdout IS its log stream (often a
+ * non-TTY pipe under a process manager / tunnel), so its startup diagnostics
+ * always pass through.
+ */
+export function canLogStartupDiagnosticsToStdout() {
+    // Server process: stdout is its own log stream, not the CLI's data channel.
+    if (isServerProcess())
+        return true;
+    const args = process.argv.slice(2);
+    // Explicit quiet.
+    if (args.includes('--quiet') || args.includes('-q'))
+        return false;
+    // Structured output requested (the documented breakage: list … --output json).
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if ((a === '--output' || a === '-o') && /^json$/i.test(args[i + 1] ?? ''))
+            return false;
+        if (/^--output=json$/i.test(a))
+            return false;
+    }
+    // Piped or redirected stdout (| jq, > file): keep it machine-clean.
+    if (process.stdout.isTTY !== true)
+        return false;
+    return true;
+}
+function isServerProcess() {
+    if (process.env.AGENT_HEALTH_SERVER === '1')
+        return true;
+    const entry = process.argv[1] ?? '';
+    // server/dist/index.js (built) or server.ts / server/index.ts (tsx dev).
+    return /(?:^|[/\\])server[/\\](?:dist[/\\])?index\.(?:js|ts)$/.test(entry)
+        || /(?:^|[/\\])server\.ts$/.test(entry);
+}
+/**
+ * Convenience: emit an informational startup diagnostic to stdout, but only
+ * when it won't corrupt machine-readable output (see
+ * `canLogStartupDiagnosticsToStdout`). A no-op otherwise.
+ */
+export function logStartupDiagnostic(...args) {
+    if (canLogStartupDiagnosticsToStdout()) {
+        // eslint-disable-next-line no-console
+        console.log(...args);
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/lib/dist/lib/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../diagnostics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gCAAgC;IAC9C,4EAA4E;IAC5E,IAAI,eAAe,EAAE;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,kBAAkB;IAClB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAElE,+EAA+E;IAC/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QACxF,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC/C,CAAC;IAED,oEAAoE;IACpE,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEhD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,yEAAyE;IACzE,OAAO,uDAAuD,CAAC,IAAI,CAAC,KAAK,CAAC;WACrE,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAG,IAAe;IACrD,IAAI,gCAAgC,EAAE,EAAE,CAAC;QACvC,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/lib/dist/lib/envCompat.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Read an env var, preferring `newName`, falling back to `oldName`.
+ * Returns `undefined` when neither is set.
+ *
+ * On first use of the old name in the current process, prints a one-time
+ * deprecation warning to stderr.
+ */
+export declare function readEnv(newName: string, oldName: string): string | undefined;
+/**
+ * Whether the old name is currently set (regardless of the new name).
+ * Useful for tests that exercise deprecation paths without triggering reads.
+ */
+export declare function isLegacyEnvSet(oldName: string): boolean;
+/**
+ * Emit a one-time deprecation warning for an old env var name.
+ * Subsequent calls for the same `oldName` are no-ops.
+ *
+ * Suppressed when AH_QUIET_DEPRECATIONS=1 (also accepts the old prefix
+ * AGENT_HEALTH_QUIET_DEPRECATIONS=1) so tests and CI can stay quiet.
+ */
+export declare function warnDeprecated(oldName: string, newName: string): void;
+/**
+ * TEST-ONLY: reset the warned set so a single test process can exercise
+ * multiple deprecation paths without one suppressing the next.
+ */
+export declare function _resetDeprecationCacheForTests(): void;
+//# sourceMappingURL=envCompat.d.ts.map

package/lib/dist/lib/envCompat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envCompat.d.ts","sourceRoot":"","sources":["../../envCompat.ts"],"names":[],"mappings":"AAuBA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW5E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAiBrE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/lib/dist/lib/envCompat.js

@@ -0,0 +1,73 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Environment Variable Compatibility Layer
+ *
+ * Soft-deprecation helper for the `AGENT_HEALTH_*` → `AH_*` env var rename.
+ *
+ * Read sites should prefer the new `AH_*` name but fall back to the old
+ * `AGENT_HEALTH_*` name for one release. Old names emit a one-time
+ * deprecation warning per process.
+ *
+ * Example:
+ *
+ *   const port = readEnv('AH_PORT', 'AGENT_HEALTH_PORT');
+ *
+ * The old name is scheduled for removal in a future major release.
+ */
+const warned = new Set();
+/**
+ * Read an env var, preferring `newName`, falling back to `oldName`.
+ * Returns `undefined` when neither is set.
+ *
+ * On first use of the old name in the current process, prints a one-time
+ * deprecation warning to stderr.
+ */
+export function readEnv(newName, oldName) {
+    const newVal = process.env[newName];
+    if (newVal !== undefined)
+        return newVal;
+    const oldVal = process.env[oldName];
+    if (oldVal !== undefined) {
+        warnDeprecated(oldName, newName);
+        return oldVal;
+    }
+    return undefined;
+}
+/**
+ * Whether the old name is currently set (regardless of the new name).
+ * Useful for tests that exercise deprecation paths without triggering reads.
+ */
+export function isLegacyEnvSet(oldName) {
+    return process.env[oldName] !== undefined;
+}
+/**
+ * Emit a one-time deprecation warning for an old env var name.
+ * Subsequent calls for the same `oldName` are no-ops.
+ *
+ * Suppressed when AH_QUIET_DEPRECATIONS=1 (also accepts the old prefix
+ * AGENT_HEALTH_QUIET_DEPRECATIONS=1) so tests and CI can stay quiet.
+ */
+export function warnDeprecated(oldName, newName) {
+    if (warned.has(oldName))
+        return;
+    warned.add(oldName);
+    if (process.env.AH_QUIET_DEPRECATIONS === '1' ||
+        process.env.AGENT_HEALTH_QUIET_DEPRECATIONS === '1') {
+        return;
+    }
+    // Use console.warn so this surfaces in normal stderr but doesn't crash
+    // structured-logging consumers. Prefix matches the rest of the codebase.
+    console.warn(`[agent-health] Deprecated env var ${oldName} is set; please rename it to ${newName}. ` +
+        `The old name will be removed in a future release.`);
+}
+/**
+ * TEST-ONLY: reset the warned set so a single test process can exercise
+ * multiple deprecation paths without one suppressing the next.
+ */
+export function _resetDeprecationCacheForTests() {
+    warned.clear();
+}
+//# sourceMappingURL=envCompat.js.map

package/lib/dist/lib/envCompat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envCompat.js","sourceRoot":"","sources":["../../envCompat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,OAAe;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,OAAe;IAC7D,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAChC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEpB,IACE,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG;QACzC,OAAO,CAAC,GAAG,CAAC,+BAA+B,KAAK,GAAG,EACnD,CAAC;QACD,OAAO;IACT,CAAC;IAED,uEAAuE;IACvE,yEAAyE;IACzE,OAAO,CAAC,IAAI,CACV,qCAAqC,OAAO,gCAAgC,OAAO,IAAI;QACvF,mDAAmD,CACpD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B;IAC5C,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC"}

package/lib/dist/lib/findPackageRoot.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Walk up from `startDir` looking for the agent-health package root.
+ *
+ * @throws if no package.json is found within `maxLevels` parents.
+ */
+export declare function findPackageRootFrom(startDir: string, maxLevels?: number): string;
+//# sourceMappingURL=findPackageRoot.d.ts.map

package/lib/dist/lib/findPackageRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPackageRoot.d.ts","sourceRoot":"","sources":["../../findPackageRoot.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAA2B,GACrC,MAAM,CA6BR"}

package/lib/dist/lib/findPackageRoot.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Pure helper to locate the agent-health package root from any starting
+ * directory.
+ *
+ * Kept in its own file (no `import.meta.url`) so it can be unit-tested with
+ * ts-jest's CommonJS loader without needing module mocks.
+ *
+ * The walk preferentially anchors on the agent-health package.json (matched
+ * by `name`) so we don't stop at a parent monorepo root or a wrapper
+ * package.json. If no matching package.json is found within `maxLevels`
+ * (e.g., the user has forked and renamed the package), we fall back to the
+ * nearest package.json on the path — best-effort.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+const PACKAGE_NAME = '@opensearch-project/agent-health';
+const DEFAULT_MAX_LEVELS = 6;
+/**
+ * Walk up from `startDir` looking for the agent-health package root.
+ *
+ * @throws if no package.json is found within `maxLevels` parents.
+ */
+export function findPackageRootFrom(startDir, maxLevels = DEFAULT_MAX_LEVELS) {
+    // First pass: prefer a package.json with the canonical agent-health name.
+    let dir = resolve(startDir);
+    let firstPkgRoot = null;
+    for (let i = 0; i <= maxLevels; i++) {
+        const pkgPath = join(dir, 'package.json');
+        if (existsSync(pkgPath)) {
+            if (firstPkgRoot === null)
+                firstPkgRoot = dir;
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+                if (pkg && pkg.name === PACKAGE_NAME)
+                    return dir;
+            }
+            catch {
+                /* unreadable / unparseable package.json — keep walking */
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fallback: nearest package.json regardless of name. Covers forks that
+    // rename the package and unusual local layouts.
+    if (firstPkgRoot !== null)
+        return firstPkgRoot;
+    throw new Error(`Could not locate package root for ${PACKAGE_NAME} from ${startDir} ` +
+        `within ${maxLevels} parent directories`);
+}
+//# sourceMappingURL=findPackageRoot.js.map

package/lib/dist/lib/findPackageRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPackageRoot.js","sourceRoot":"","sources":["../../findPackageRoot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE9C,MAAM,YAAY,GAAG,kCAAkC,CAAC;AACxD,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,YAAoB,kBAAkB;IAEtC,0EAA0E;IAC1E,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,YAAY,GAAkB,IAAI,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC1C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,YAAY,KAAK,IAAI;gBAAE,YAAY,GAAG,GAAG,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;gBACtD,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;oBAAE,OAAO,GAAG,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;YAC5D,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,uEAAuE;IACvE,gDAAgD;IAChD,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAE/C,MAAM,IAAI,KAAK,CACb,qCAAqC,YAAY,SAAS,QAAQ,GAAG;QACrE,UAAU,SAAS,qBAAqB,CACzC,CAAC;AACJ,CAAC"}

package/lib/dist/lib/hooks.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Agent Lifecycle Hook Utilities
+ * Executes user-defined hooks from agent-health.config.ts
+ */
+import type { AgentHooks, BeforeRequestContext, AfterResponseContext, BuildTrajectoryContext, TrajectoryStep } from '../types/index.js';
+/**
+ * Execute the beforeRequest hook if defined on the agent.
+ *
+ * - Returns the original context unchanged if no hook is defined
+ * - Validates the hook return value has required fields
+ * - Wraps errors with a descriptive message including the agent key
+ */
+export declare function executeBeforeRequestHook(hooks: AgentHooks | undefined, context: BeforeRequestContext, agentKey: string): Promise<BeforeRequestContext>;
+/**
+ * Execute the afterResponse hook if defined on the agent.
+ *
+ * Use this hook to extract custom runId formats from agent responses
+ * (e.g., PER agent's memory_id).
+ *
+ * - Returns the original context unchanged if no hook is defined
+ * - Validates the hook return value has required fields
+ * - Wraps errors with a descriptive message including the agent key
+ */
+export declare function executeAfterResponseHook(hooks: AgentHooks | undefined, context: AfterResponseContext, agentKey: string): Promise<AfterResponseContext>;
+/**
+ * Execute the buildTrajectory hook if defined on the agent.
+ *
+ * Use this hook to customize trajectory extraction from OTEL traces
+ * for agents with custom span formats.
+ *
+ * - Returns null if no hook is defined
+ * - Validates the hook return value is an array
+ * - Wraps errors with a descriptive message including the agent key
+ */
+export declare function executeBuildTrajectoryHook(hooks: AgentHooks | undefined, context: BuildTrajectoryContext, agentKey: string): Promise<TrajectoryStep[] | null>;
+//# sourceMappingURL=hooks.d.ts.map

package/lib/dist/lib/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../hooks.ts"],"names":[],"mappings":"AAKA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9H;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CA6B/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAoC/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAkBlC"}

package/lib/dist/lib/hooks.js

@@ -0,0 +1,112 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debug } from '../lib/debug.js';
+/**
+ * Execute the beforeRequest hook if defined on the agent.
+ *
+ * - Returns the original context unchanged if no hook is defined
+ * - Validates the hook return value has required fields
+ * - Wraps errors with a descriptive message including the agent key
+ */
+export async function executeBeforeRequestHook(hooks, context, agentKey) {
+    if (!hooks?.beforeRequest) {
+        return context;
+    }
+    debug('Hooks', `Executing beforeRequest hook for agent "${agentKey}"`);
+    try {
+        const result = await hooks.beforeRequest(context);
+        // Validate hook return value
+        if (!result || typeof result !== 'object') {
+            throw new Error('beforeRequest hook must return an object with endpoint, payload, and headers');
+        }
+        if (typeof result.endpoint !== 'string') {
+            throw new Error('beforeRequest hook must return an object with a string "endpoint" field');
+        }
+        if (!('payload' in result)) {
+            throw new Error('beforeRequest hook must return an object with a "payload" field');
+        }
+        if (!result.headers || typeof result.headers !== 'object') {
+            throw new Error('beforeRequest hook must return an object with an object "headers" field');
+        }
+        debug('Hooks', `beforeRequest hook for "${agentKey}" completed, endpoint:`, result.endpoint);
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`beforeRequest hook failed for agent "${agentKey}": ${message}`);
+    }
+}
+/**
+ * Execute the afterResponse hook if defined on the agent.
+ *
+ * Use this hook to extract custom runId formats from agent responses
+ * (e.g., PER agent's memory_id).
+ *
+ * - Returns the original context unchanged if no hook is defined
+ * - Validates the hook return value has required fields
+ * - Wraps errors with a descriptive message including the agent key
+ */
+export async function executeAfterResponseHook(hooks, context, agentKey) {
+    if (!hooks?.afterResponse) {
+        return context;
+    }
+    debug('Hooks', `Executing afterResponse hook for agent "${agentKey}"`, {
+        hasResponse: !!context.response && Object.keys(context.response).length > 0,
+        trajectorySteps: context.trajectory.length,
+        runId: context.runId,
+        rawEventsCount: context.rawEvents?.length ?? 0,
+        hasMetadata: !!context.metadata,
+    });
+    try {
+        const result = await hooks.afterResponse(context);
+        // Validate hook return value
+        if (!result || typeof result !== 'object') {
+            throw new Error('afterResponse hook must return an object with response, trajectory, and optional runId');
+        }
+        if (!('response' in result)) {
+            throw new Error('afterResponse hook must return an object with a "response" field');
+        }
+        if (!Array.isArray(result.trajectory)) {
+            throw new Error('afterResponse hook must return an object with a "trajectory" array field');
+        }
+        debug('Hooks', `afterResponse hook for "${agentKey}" completed`, {
+            runId: result.runId,
+            trajectorySteps: result.trajectory.length,
+        });
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`afterResponse hook failed for agent "${agentKey}": ${message}`);
+    }
+}
+/**
+ * Execute the buildTrajectory hook if defined on the agent.
+ *
+ * Use this hook to customize trajectory extraction from OTEL traces
+ * for agents with custom span formats.
+ *
+ * - Returns null if no hook is defined
+ * - Validates the hook return value is an array
+ * - Wraps errors with a descriptive message including the agent key
+ */
+export async function executeBuildTrajectoryHook(hooks, context, agentKey) {
+    if (!hooks?.buildTrajectory) {
+        return null;
+    }
+    try {
+        const result = await hooks.buildTrajectory(context);
+        // Validate hook return value
+        if (result !== null && !Array.isArray(result)) {
+            throw new Error('buildTrajectory hook must return an array of TrajectoryStep objects or null');
+        }
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`buildTrajectory hook failed for agent "${agentKey}": ${message}`);
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/lib/dist/lib/hooks.js.map

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

package/lib/dist/lib/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Public API for @opensearch-project/agent-health
+ *
+ * Users can import from this module in their agent-health.config.ts files:
+ *
+ * @example
+ * ```typescript
+ * import { defineConfig, RESTConnector } from '@opensearch-project/agent-health';
+ *
+ * export default defineConfig({
+ *   agents: [
+ *     {
+ *       key: 'my-agent',
+ *       name: 'My Agent',
+ *       endpoint: 'https://api.example.com/chat',
+ *       connectorType: 'rest',
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+export { defineConfig } from './config/defineConfig.js';
+export type { UserConfig, UserAgentConfig, UserModelConfig, ResolvedConfig, ReporterConfig, JudgeConfig, } from './config/types.js';
+export type { BeforeRequestContext, AgentHooks, JudgeContext, JudgeResult, BuildTrajectoryContext, } from '../types/index.js';
+export type { Span, TrajectoryStep } from '../types/index.js';
+export { fetchTracesByRunIds as fetchTraces } from '../services/traces/index.js';
+export type { AgentConnector, ConnectorProtocol, ConnectorAuth, ConnectorRequest, ConnectorResponse, } from '../services/connectors/types.js';
+export { BaseConnector } from '../services/connectors/base/BaseConnector.js';
+export { AGUIStreamingConnector } from '../services/connectors/agui/AGUIStreamingConnector.js';
+export { RESTConnector } from '../services/connectors/rest/RESTConnector.js';
+export { SubprocessConnector } from '../services/connectors/subprocess/SubprocessConnector.js';
+export { ClaudeCodeConnector } from '../services/connectors/claude-code/ClaudeCodeConnector.js';
+export { MockConnector } from '../services/connectors/mock/MockConnector.js';
+export { connectorRegistry, registerConnector } from '../services/connectors/registry.js';
+export type { ConnectorRegistry } from '../services/connectors/types.js';
+export { test, describe, beforeAll, afterAll, beforeEach, afterEach, judge } from './testCases/index.js';
+export type { TestOptions, CodeTestCase, EvalResult, TestFixtures, TestInfo, HookKind, HookFn, RegisteredHook, } from './testCases/types.js';
+export type { AgentFixture, AgentRunOptions } from './testCases/index.js';
+export type { Verdict, JudgeVerdict, JudgeRole, JudgeFn } from './testCases/index.js';
+export { defineEvaluator, evaluate } from './testCases/index.js';
+export type { EvaluatorContext, EvaluatorResult, EvaluatorFn, EvaluateFn } from './testCases/index.js';
+export { expect } from './matchers/index.js';
+export type { TracesAccessor, MatcherResult, MatcherMethod } from './matchers/index.js';
+export { source, workflow, FeedbackLedger, consolidate, mapPool } from './workflow/index.js';
+export { profileSpans, buildAgentEditsPrompt, parseAgentEdits, deriveAgentEdits, } from './workflow/index.js';
+export type { WorkItem, SourceFetchFn, SourceHandle, AgentRunResult, StagedItem, Cluster, WritesMode, RunAgentOptions, WorkflowConfig, PRRequest, LedgerEntry, PoolStats, Workflow, WorkflowContext, WorkflowRunOptions, WorkflowResult, ForEachOptions, SessionProfile, AgentEdit, ReasonFn, } from './workflow/index.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,YAAY,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,IAAI,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGjF,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAG7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0DAA0D,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAG1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAUzE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AACzG,YAAY,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAOvG,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOxF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,OAAO,EACP,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,SAAS,EACT,QAAQ,GACT,MAAM,qBAAqB,CAAC"}