@opensearch-project/agent-health 0.4.0 → 0.6.0

package/lib/dist/lib/packagePaths.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Absolute path to the agent-health package root, computed once per process.
+ *
+ * Works in three runtime contexts:
+ *  - Production (`node_modules/@opensearch-project/agent-health/...`)
+ *  - Local dev from a checkout (`<repo>/...`)
+ *  - Bundled output from esbuild (`<root>/server/dist/...`)
+ *
+ * @throws if the package root cannot be located.
+ */
+export declare function getPackageRoot(): string;
+/**
+ * Resolve a path inside `<package_root>/docs/skills/`.
+ *
+ * @param fileName  Defaults to `AGENT_HEALTH.md` for the top-level skill.
+ */
+export declare function getSkillPath(fileName?: string): string;
+/**
+ * Resolve the bundled pi-package directory shipped alongside the
+ * Observio sample agent. Used by the Pi judge service.
+ */
+export declare function getPiPackagePath(): string;
+/**
+ * TEST-ONLY: reset the cached root. Exported so unit tests for the
+ * resolver itself (or downstream services) can re-evaluate without
+ * spawning a fresh process.
+ */
+export declare function _resetPackageRootCacheForTests(): void;
+//# sourceMappingURL=packagePaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packagePaths.d.ts","sourceRoot":"","sources":["../../packagePaths.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/lib/dist/lib/packagePaths.js

@@ -0,0 +1,63 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Package asset path resolution.
+ *
+ * Resolves the location of files that ship inside the agent-health package
+ * (skill markdown files, the bundled pi-package, etc.) regardless of the
+ * caller's working directory. This unblocks running agent-health from a
+ * directory other than the repo root (e.g., from inside the user's own
+ * agent project).
+ *
+ * Anchors on `import.meta.url` of THIS module, then walks upwards looking
+ * for the agent-health package's own `package.json`. The pure walking
+ * logic lives in `findPackageRoot.ts` so it can be unit-tested under
+ * Jest's CommonJS loader (which doesn't support `import.meta.url`).
+ */
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { findPackageRootFrom } from './findPackageRoot.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let cachedRoot = null;
+/**
+ * Absolute path to the agent-health package root, computed once per process.
+ *
+ * Works in three runtime contexts:
+ *  - Production (`node_modules/@opensearch-project/agent-health/...`)
+ *  - Local dev from a checkout (`<repo>/...`)
+ *  - Bundled output from esbuild (`<root>/server/dist/...`)
+ *
+ * @throws if the package root cannot be located.
+ */
+export function getPackageRoot() {
+    if (cachedRoot)
+        return cachedRoot;
+    cachedRoot = findPackageRootFrom(__dirname);
+    return cachedRoot;
+}
+/**
+ * Resolve a path inside `<package_root>/docs/skills/`.
+ *
+ * @param fileName  Defaults to `AGENT_HEALTH.md` for the top-level skill.
+ */
+export function getSkillPath(fileName = 'AGENT_HEALTH.md') {
+    return join(getPackageRoot(), 'docs', 'skills', fileName);
+}
+/**
+ * Resolve the bundled pi-package directory shipped alongside the
+ * Observio sample agent. Used by the Pi judge service.
+ */
+export function getPiPackagePath() {
+    return join(getPackageRoot(), 'observio-sample-agent', 'pi-package');
+}
+/**
+ * TEST-ONLY: reset the cached root. Exported so unit tests for the
+ * resolver itself (or downstream services) can re-evaluate without
+ * spawning a fresh process.
+ */
+export function _resetPackageRootCacheForTests() {
+    cachedRoot = null;
+}
+//# sourceMappingURL=packagePaths.js.map

package/lib/dist/lib/packagePaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packagePaths.js","sourceRoot":"","sources":["../../packagePaths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,iBAAiB;IAC/D,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,uBAAuB,EAAE,YAAY,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B;IAC5C,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC"}

package/lib/dist/lib/performance.d.ts

@@ -0,0 +1,51 @@
+interface PerformanceMetric {
+    name: string;
+    duration: number;
+    timestamp: number;
+}
+/**
+ * Start a performance measurement
+ */
+export declare function startMeasure(name: string): void;
+/**
+ * End a performance measurement and log the duration
+ */
+export declare function endMeasure(name: string, logToConsole?: boolean): number | null;
+/**
+ * Measure a synchronous function
+ */
+export declare function measureSync<T>(name: string, fn: () => T, logToConsole?: boolean): T;
+/**
+ * Measure an async function
+ */
+export declare function measureAsync<T>(name: string, fn: () => Promise<T>, logToConsole?: boolean): Promise<T>;
+/**
+ * Get all recorded metrics
+ */
+export declare function getMetrics(): PerformanceMetric[];
+/**
+ * Get metrics for a specific measurement name
+ */
+export declare function getMetricsByName(name: string): PerformanceMetric[];
+/**
+ * Get average duration for a metric
+ */
+export declare function getAverageDuration(name: string): number | null;
+/**
+ * Clear all metrics
+ */
+export declare function clearMetrics(): void;
+/**
+ * Log a summary of all metrics
+ */
+export declare function logSummary(): void;
+/**
+ * Enable performance monitoring
+ */
+export declare function enable(): void;
+/**
+ * Disable performance monitoring
+ */
+export declare function disable(): void;
+export {};
+//# sourceMappingURL=performance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../performance.ts"],"names":[],"mappings":"AAiBA,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,MAAM,GAAG,IAAI,CA2B3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,YAAY,UAAO,GAAG,CAAC,CAShF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,YAAY,UAAO,GAClB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,iBAAiB,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAElE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CA+BjC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,IAAI,CAO7B;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAO9B"}

package/lib/dist/lib/performance.js

@@ -0,0 +1,159 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// In-memory storage for performance marks and metrics
+const marks = new Map();
+const metrics = [];
+// Performance monitoring enabled in development or when DEBUG=true
+const isEnabled = () => {
+    if (typeof window !== 'undefined') {
+        return localStorage.getItem('DEBUG_PERFORMANCE') === 'true' ||
+            process.env.NODE_ENV === 'development';
+    }
+    return process.env.DEBUG_PERFORMANCE === 'true' ||
+        process.env.NODE_ENV === 'development';
+};
+/**
+ * Start a performance measurement
+ */
+export function startMeasure(name) {
+    if (!isEnabled())
+        return;
+    marks.set(name, {
+        name,
+        startTime: performance.now(),
+    });
+}
+/**
+ * End a performance measurement and log the duration
+ */
+export function endMeasure(name, logToConsole = true) {
+    if (!isEnabled())
+        return null;
+    const mark = marks.get(name);
+    if (!mark) {
+        console.warn(`[Performance] No start mark found for: ${name}`);
+        return null;
+    }
+    const duration = performance.now() - mark.startTime;
+    const metric = {
+        name,
+        duration,
+        timestamp: Date.now(),
+    };
+    metrics.push(metric);
+    marks.delete(name);
+    if (logToConsole) {
+        const color = duration < 50 ? '🟢' : duration < 200 ? '🟡' : '🔴';
+        console.log(`[Performance] ${color} ${name}: ${duration.toFixed(2)}ms`);
+    }
+    return duration;
+}
+/**
+ * Measure a synchronous function
+ */
+export function measureSync(name, fn, logToConsole = true) {
+    if (!isEnabled())
+        return fn();
+    startMeasure(name);
+    try {
+        return fn();
+    }
+    finally {
+        endMeasure(name, logToConsole);
+    }
+}
+/**
+ * Measure an async function
+ */
+export async function measureAsync(name, fn, logToConsole = true) {
+    if (!isEnabled())
+        return fn();
+    startMeasure(name);
+    try {
+        return await fn();
+    }
+    finally {
+        endMeasure(name, logToConsole);
+    }
+}
+/**
+ * Get all recorded metrics
+ */
+export function getMetrics() {
+    return [...metrics];
+}
+/**
+ * Get metrics for a specific measurement name
+ */
+export function getMetricsByName(name) {
+    return metrics.filter(m => m.name === name);
+}
+/**
+ * Get average duration for a metric
+ */
+export function getAverageDuration(name) {
+    const metricsForName = getMetricsByName(name);
+    if (metricsForName.length === 0)
+        return null;
+    const sum = metricsForName.reduce((acc, m) => acc + m.duration, 0);
+    return sum / metricsForName.length;
+}
+/**
+ * Clear all metrics
+ */
+export function clearMetrics() {
+    metrics.length = 0;
+    marks.clear();
+}
+/**
+ * Log a summary of all metrics
+ */
+export function logSummary() {
+    if (!isEnabled() || metrics.length === 0)
+        return;
+    console.group('📊 Performance Summary');
+    // Group metrics by name
+    const grouped = new Map();
+    metrics.forEach(m => {
+        if (!grouped.has(m.name)) {
+            grouped.set(m.name, []);
+        }
+        grouped.get(m.name).push(m);
+    });
+    // Calculate stats for each metric
+    grouped.forEach((metricsForName, name) => {
+        const durations = metricsForName.map(m => m.duration);
+        const avg = durations.reduce((a, b) => a + b, 0) / durations.length;
+        const min = Math.min(...durations);
+        const max = Math.max(...durations);
+        console.log(`${name}:`, `avg=${avg.toFixed(2)}ms`, `min=${min.toFixed(2)}ms`, `max=${max.toFixed(2)}ms`, `count=${metricsForName.length}`);
+    });
+    console.groupEnd();
+}
+/**
+ * Enable performance monitoring
+ */
+export function enable() {
+    if (typeof window !== 'undefined') {
+        localStorage.setItem('DEBUG_PERFORMANCE', 'true');
+    }
+    else {
+        process.env.DEBUG_PERFORMANCE = 'true';
+    }
+    console.log('✅ Performance monitoring enabled');
+}
+/**
+ * Disable performance monitoring
+ */
+export function disable() {
+    if (typeof window !== 'undefined') {
+        localStorage.removeItem('DEBUG_PERFORMANCE');
+    }
+    else {
+        delete process.env.DEBUG_PERFORMANCE;
+    }
+    console.log('❌ Performance monitoring disabled');
+}
+//# sourceMappingURL=performance.js.map

package/lib/dist/lib/performance.js.map

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

package/lib/dist/lib/portConfig.d.ts

@@ -0,0 +1,29 @@
+export declare const DEFAULT_BACKEND_PORT = 4001;
+export declare const DEFAULT_DEV_PORT = 4000;
+/**
+ * Resolve the backend server port from AH_PORT env var (legacy: AGENT_HEALTH_PORT).
+ */
+export declare function resolveBackendPort(): number;
+/**
+ * Resolve the frontend dev server port from AH_DEV_PORT env var (legacy: AGENT_HEALTH_DEV_PORT).
+ */
+export declare function resolveDevPort(): number;
+/**
+ * Whether the backend port was *explicitly* configured (AH_PORT /
+ * AGENT_HEALTH_PORT set) vs. silently defaulted to {@link DEFAULT_BACKEND_PORT}.
+ *
+ * Callers that dial the backend over HTTP (e.g. the SDK `judge()` matcher
+ * run outside the server lifecycle) use this to warn before defaulting to
+ * 4001 — where a foreign instance (a live demo, another checkout) may be
+ * listening. See AGENTS.md → server lifecycle.
+ *
+ * Only a value that parses to a valid integer counts as explicit — a
+ * garbage `AH_PORT=abc` silently falls back to the default in
+ * {@link resolveBackendPort}, so the warn-once must still fire for it.
+ */
+export declare function isBackendPortExplicit(): boolean;
+/**
+ * Get the full backend URL (http://localhost:<port>).
+ */
+export declare function getBackendUrl(): string;
+//# sourceMappingURL=portConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portConfig.d.ts","sourceRoot":"","sources":["../../portConfig.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAO3C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/lib/dist/lib/portConfig.js

@@ -0,0 +1,64 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Port Configuration - Single source of truth for all port settings.
+ *
+ * Backend port: AH_PORT (default 4001)
+ * Frontend dev port: AH_DEV_PORT (default 4000)
+ *
+ * The legacy names AGENT_HEALTH_PORT and AGENT_HEALTH_DEV_PORT are still
+ * accepted for one release with a deprecation warning.
+ */
+import { readEnv } from './envCompat.js';
+export const DEFAULT_BACKEND_PORT = 4001;
+export const DEFAULT_DEV_PORT = 4000;
+/**
+ * Resolve the backend server port from AH_PORT env var (legacy: AGENT_HEALTH_PORT).
+ */
+export function resolveBackendPort() {
+    const port = readEnv('AH_PORT', 'AGENT_HEALTH_PORT');
+    if (port) {
+        const parsed = parseInt(port, 10);
+        if (!isNaN(parsed))
+            return parsed;
+    }
+    return DEFAULT_BACKEND_PORT;
+}
+/**
+ * Resolve the frontend dev server port from AH_DEV_PORT env var (legacy: AGENT_HEALTH_DEV_PORT).
+ */
+export function resolveDevPort() {
+    const port = readEnv('AH_DEV_PORT', 'AGENT_HEALTH_DEV_PORT');
+    if (port) {
+        const parsed = parseInt(port, 10);
+        if (!isNaN(parsed))
+            return parsed;
+    }
+    return DEFAULT_DEV_PORT;
+}
+/**
+ * Whether the backend port was *explicitly* configured (AH_PORT /
+ * AGENT_HEALTH_PORT set) vs. silently defaulted to {@link DEFAULT_BACKEND_PORT}.
+ *
+ * Callers that dial the backend over HTTP (e.g. the SDK `judge()` matcher
+ * run outside the server lifecycle) use this to warn before defaulting to
+ * 4001 — where a foreign instance (a live demo, another checkout) may be
+ * listening. See AGENTS.md → server lifecycle.
+ *
+ * Only a value that parses to a valid integer counts as explicit — a
+ * garbage `AH_PORT=abc` silently falls back to the default in
+ * {@link resolveBackendPort}, so the warn-once must still fire for it.
+ */
+export function isBackendPortExplicit() {
+    const port = readEnv('AH_PORT', 'AGENT_HEALTH_PORT');
+    return !!port && !isNaN(parseInt(port, 10));
+}
+/**
+ * Get the full backend URL (http://localhost:<port>).
+ */
+export function getBackendUrl() {
+    return `http://localhost:${resolveBackendPort()}`;
+}
+//# sourceMappingURL=portConfig.js.map

package/lib/dist/lib/portConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portConfig.js","sourceRoot":"","sources":["../../portConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACrD,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;IACpC,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC;IAC7D,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;IACpC,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,oBAAoB,kBAAkB,EAAE,EAAE,CAAC;AACpD,CAAC"}

package/lib/dist/lib/preferences.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Cross-page user preferences.
+ *
+ * Each entry below is a single localStorage key (under the
+ * `agent-health:` prefix) shared by every page that exposes the
+ * corresponding control, so e.g. picking "30d" on the Eval Runs page is
+ * also reflected on Benchmarks and Test Cases.
+ *
+ * Storage layout is intentionally a flat, JSON-serialisable key/value
+ * map: each preference is its own localStorage entry. That keeps the
+ * format portable so prefs can be exported, copied across environments,
+ * or backed up to a server store later without rewriting call sites.
+ *
+ * Helpers `getPreferencesSnapshot()` / `applyPreferencesSnapshot()`
+ * below give a single-call dump and restore for that bundle, which is
+ * the natural shape to send over the network.
+ */
+/** Stable, user-facing namespace for all cross-page preferences. */
+export declare const PREFS_KEYS: {
+    /** Run-config: agent the user wants to RUN (QuickRunModal, NewRunPage). */
+    readonly agentKey: "prefs:agentKey";
+    /** Run-config: model the user wants to RUN (QuickRunModal, NewRunPage). */
+    readonly modelId: "prefs:modelId";
+    /** Time-range filter, shared by evaluation list pages and Agent Traces. */
+    readonly timeRange: "prefs:timeRange";
+    /** Agent filter dropdown shared by Benchmarks and Eval Runs. Defaults to `'all'`. */
+    readonly agentFilter: "prefs:agentFilter";
+    /** Benchmark filter dropdown shared by Test Cases (and any future page). */
+    readonly benchmarkFilter: "prefs:benchmarkFilter";
+    /** Flat / grouped view mode shared by list pages. */
+    readonly viewMode: "prefs:viewMode";
+};
+/** Possible string values for {@link PREFS_KEYS.timeRange}. */
+export type SharedTimeRange = '1h' | '6h' | '1d' | '7d' | '30d' | 'all';
+/**
+ * Convert a {@link SharedTimeRange} to a "minutes ago" cutoff suitable
+ * for the AgentTraces query. `'all'` is mapped to a very large window
+ * (90d) so that there's always *some* finite cutoff sent to the server.
+ */
+export declare function sharedTimeRangeToMinutes(range: SharedTimeRange): number;
+/**
+ * Return a portable snapshot of every cross-page preference currently
+ * stored in localStorage. Keys are the unprefixed identifiers (e.g.
+ * `'prefs:timeRange'`) and values are already JSON-decoded.
+ *
+ * Use this to copy a user's preferences to clipboard, persist them
+ * server-side, or assert against them in tests.
+ */
+export declare function getPreferencesSnapshot(): Record<string, unknown>;
+/**
+ * Apply a snapshot produced by {@link getPreferencesSnapshot}.
+ * Unknown keys are ignored so the snapshot format stays forward-
+ * compatible with future preferences. Pass an empty object to clear
+ * every preference (sets nothing — call {@link clearPreferences} for
+ * an explicit reset).
+ */
+export declare function applyPreferencesSnapshot(snapshot: Record<string, unknown>): void;
+/**
+ * Remove every preference from localStorage. Useful for "Reset
+ * preferences" buttons and tests.
+ */
+export declare function clearPreferences(): void;
+//# sourceMappingURL=preferences.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../preferences.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AAEH,oEAAoE;AACpE,eAAO,MAAM,UAAU;IACrB,2EAA2E;;IAE3E,2EAA2E;;IAE3E,2EAA2E;;IAE3E,qFAAqF;;IAErF,4EAA4E;;IAE5E,qDAAqD;;CAE7C,CAAC;AAEX,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CASvE;AAID;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAchE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWhF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CASvC"}

package/lib/dist/lib/preferences.js

@@ -0,0 +1,117 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Cross-page user preferences.
+ *
+ * Each entry below is a single localStorage key (under the
+ * `agent-health:` prefix) shared by every page that exposes the
+ * corresponding control, so e.g. picking "30d" on the Eval Runs page is
+ * also reflected on Benchmarks and Test Cases.
+ *
+ * Storage layout is intentionally a flat, JSON-serialisable key/value
+ * map: each preference is its own localStorage entry. That keeps the
+ * format portable so prefs can be exported, copied across environments,
+ * or backed up to a server store later without rewriting call sites.
+ *
+ * Helpers `getPreferencesSnapshot()` / `applyPreferencesSnapshot()`
+ * below give a single-call dump and restore for that bundle, which is
+ * the natural shape to send over the network.
+ */
+/** Stable, user-facing namespace for all cross-page preferences. */
+export const PREFS_KEYS = {
+    /** Run-config: agent the user wants to RUN (QuickRunModal, NewRunPage). */
+    agentKey: 'prefs:agentKey',
+    /** Run-config: model the user wants to RUN (QuickRunModal, NewRunPage). */
+    modelId: 'prefs:modelId',
+    /** Time-range filter, shared by evaluation list pages and Agent Traces. */
+    timeRange: 'prefs:timeRange',
+    /** Agent filter dropdown shared by Benchmarks and Eval Runs. Defaults to `'all'`. */
+    agentFilter: 'prefs:agentFilter',
+    /** Benchmark filter dropdown shared by Test Cases (and any future page). */
+    benchmarkFilter: 'prefs:benchmarkFilter',
+    /** Flat / grouped view mode shared by list pages. */
+    viewMode: 'prefs:viewMode',
+};
+/**
+ * Convert a {@link SharedTimeRange} to a "minutes ago" cutoff suitable
+ * for the AgentTraces query. `'all'` is mapped to a very large window
+ * (90d) so that there's always *some* finite cutoff sent to the server.
+ */
+export function sharedTimeRangeToMinutes(range) {
+    switch (range) {
+        case '1h': return 60;
+        case '6h': return 360;
+        case '1d': return 1440;
+        case '7d': return 10080;
+        case '30d': return 43200;
+        case 'all': return 60 * 24 * 90; // 90 days as a practical "all"
+    }
+}
+const STORAGE_PREFIX = 'agent-health:';
+/**
+ * Return a portable snapshot of every cross-page preference currently
+ * stored in localStorage. Keys are the unprefixed identifiers (e.g.
+ * `'prefs:timeRange'`) and values are already JSON-decoded.
+ *
+ * Use this to copy a user's preferences to clipboard, persist them
+ * server-side, or assert against them in tests.
+ */
+export function getPreferencesSnapshot() {
+    if (typeof window === 'undefined')
+        return {};
+    const out = {};
+    for (const key of Object.values(PREFS_KEYS)) {
+        try {
+            const raw = localStorage.getItem(STORAGE_PREFIX + key);
+            if (raw === null)
+                continue;
+            out[key] = JSON.parse(raw);
+        }
+        catch {
+            // Skip entries we can't decode; the caller will treat them as
+            // missing and the corresponding page will fall back to its default.
+        }
+    }
+    return out;
+}
+/**
+ * Apply a snapshot produced by {@link getPreferencesSnapshot}.
+ * Unknown keys are ignored so the snapshot format stays forward-
+ * compatible with future preferences. Pass an empty object to clear
+ * every preference (sets nothing — call {@link clearPreferences} for
+ * an explicit reset).
+ */
+export function applyPreferencesSnapshot(snapshot) {
+    if (typeof window === 'undefined')
+        return;
+    const known = new Set(Object.values(PREFS_KEYS));
+    for (const [key, value] of Object.entries(snapshot)) {
+        if (!known.has(key))
+            continue;
+        try {
+            localStorage.setItem(STORAGE_PREFIX + key, JSON.stringify(value));
+        }
+        catch {
+            // Quota / storage disabled — ignore.
+        }
+    }
+}
+/**
+ * Remove every preference from localStorage. Useful for "Reset
+ * preferences" buttons and tests.
+ */
+export function clearPreferences() {
+    if (typeof window === 'undefined')
+        return;
+    for (const key of Object.values(PREFS_KEYS)) {
+        try {
+            localStorage.removeItem(STORAGE_PREFIX + key);
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=preferences.js.map

package/lib/dist/lib/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../preferences.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2EAA2E;IAC3E,QAAQ,EAAE,gBAAgB;IAC1B,2EAA2E;IAC3E,OAAO,EAAE,eAAe;IACxB,2EAA2E;IAC3E,SAAS,EAAE,iBAAiB;IAC5B,qFAAqF;IACrF,WAAW,EAAE,mBAAmB;IAChC,4EAA4E;IAC5E,eAAe,EAAE,uBAAuB;IACxC,qDAAqD;IACrD,QAAQ,EAAE,gBAAgB;CAClB,CAAC;AAKX;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAsB;IAC7D,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC;QACtB,KAAK,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC;QACxB,KAAK,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC;QACzB,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,+BAA+B;IAClE,CAAC;AACH,CAAC;AAED,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAC7C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC;YACvD,IAAI,GAAG,KAAK,IAAI;gBAAE,SAAS;YAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;YAC9D,oEAAoE;QACtE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAiC;IACxE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC9B,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,cAAc,GAAG,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,YAAY,CAAC,UAAU,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/dist/lib/resolveAgentModel.d.ts

@@ -0,0 +1,22 @@
+import type { AgentConfig } from '../types/index.js';
+/**
+ * Resolve the LLM an agent runs on.
+ *
+ * The agent's model is owned by the agent's OWN config (`agent-health.config.ts`),
+ * NOT a user-facing "agent model" selector. There is intentionally no run-level
+ * or UI/CLI way to override it — picking a model separately from the agent is a
+ * leaky abstraction (subprocess agents like Claude Code / pi ignore it and run
+ * on whatever their connector is configured with). Claude-like agents that DO
+ * accept a model take it via their connector config.
+ *
+ * Resolution order (all from the agent's `connectorConfig`):
+ *   1. `connectorConfig.model`              — pi / streaming / openai-compatible
+ *   2. `connectorConfig.env.ANTHROPIC_MODEL` — claude-code
+ *   3. `connectorConfig.args` `--model <id>` — any subprocess agent passing a flag
+ *
+ * `fallback` exists only for backward compatibility with runs/agents created
+ * before the agent-model concept was removed (where the run carried a
+ * user-selected `modelId`). New code should not rely on it.
+ */
+export declare function resolveAgentModel(agent: AgentConfig | undefined | null, fallback?: string): string;
+//# sourceMappingURL=resolveAgentModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAgentModel.d.ts","sourceRoot":"","sources":["../../resolveAgentModel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,EACrC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAWR"}