@opensearch-project/agent-health 0.3.0 → 0.5.2

package/lib/dist/lib/matchers/traces.js

@@ -0,0 +1,116 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Empty accessor — silent zeros. Used when the agent opted out of traces
+ * (`useTraces: false`). Reading any accessor returns `0` / `[]` so user
+ * matchers in opt-out scenarios don't throw.
+ */
+export function emptyTracesAccessor() {
+    return {
+        totalTokens: 0,
+        totalCost: 0,
+        toolCalls: [],
+        spanDuration: () => 0,
+        spans: [],
+    };
+}
+/**
+ * Loud-failure accessor — every read throws. Used when the agent opted
+ * in to traces (`useTraces: true`) but spans were not retrievable. This
+ * turns the silent false-pass described in issue #230 into an actionable
+ * error, e.g.:
+ *
+ *   Error: traces fixture unavailable: no spans found for runId=…
+ *
+ * Construction never throws — only attribute / method access does.
+ */
+export function unavailableTracesAccessor(reason) {
+    const fail = () => {
+        throw new Error(`traces fixture unavailable: ${reason}`);
+    };
+    return {
+        get totalTokens() { return fail(); },
+        get totalCost() { return fail(); },
+        get toolCalls() { return fail(); },
+        get spans() { return fail(); },
+        spanDuration(_name) { return fail(); },
+    };
+}
+/** Build a TracesAccessor from a flat list of spans. */
+export function buildTracesAccessor(spans) {
+    let totalTokens = 0;
+    let totalCost = 0;
+    const toolCalls = [];
+    for (const span of spans) {
+        const attrs = span.attributes ?? {};
+        const promptTokens = pickNumber(attrs, [
+            'gen_ai.usage.prompt_tokens',
+            'gen_ai.usage.input_tokens',
+            'llm.usage.prompt_tokens',
+        ]);
+        const completionTokens = pickNumber(attrs, [
+            'gen_ai.usage.completion_tokens',
+            'gen_ai.usage.output_tokens',
+            'llm.usage.completion_tokens',
+        ]);
+        if (promptTokens)
+            totalTokens += promptTokens;
+        if (completionTokens)
+            totalTokens += completionTokens;
+        const cost = pickNumber(attrs, [
+            'gen_ai.usage.cost_usd',
+            'gen_ai.usage.cost',
+            'llm.usage.cost_usd',
+        ]);
+        if (cost)
+            totalCost += cost;
+        // Tool spans
+        const toolName = pickString(attrs, ['gen_ai.tool.name', 'llm.tool.name']);
+        if (toolName) {
+            toolCalls.push({ name: toolName, durationMs: spanDurationMs(span) });
+        }
+    }
+    return {
+        totalTokens,
+        totalCost,
+        toolCalls,
+        spanDuration(name) {
+            const hit = spans.find(s => s.name === name);
+            return hit ? spanDurationMs(hit) : 0;
+        },
+        spans,
+    };
+}
+function spanDurationMs(span) {
+    const start = span.startTimeUnixNano ?? span.startTime;
+    const end = span.endTimeUnixNano ?? span.endTime;
+    if (typeof start === 'number' && typeof end === 'number') {
+        // Heuristic: nanosecond timestamps when 13+ digits, else ms
+        const factor = Math.abs(start) > 1e15 ? 1e6 : 1;
+        return Math.max(0, Math.round((end - start) / factor));
+    }
+    if (typeof span.durationMs === 'number')
+        return span.durationMs;
+    return 0;
+}
+function pickNumber(attrs, keys) {
+    for (const k of keys) {
+        const v = attrs[k];
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+        if (typeof v === 'string' && v.trim() !== '' && Number.isFinite(Number(v)))
+            return Number(v);
+    }
+    return undefined;
+}
+function pickString(attrs, keys) {
+    for (const k of keys) {
+        const v = attrs[k];
+        if (typeof v === 'string' && v.length > 0)
+            return v;
+    }
+    return undefined;
+}
+//# sourceMappingURL=traces.js.map

package/lib/dist/lib/matchers/traces.js.map

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

package/lib/dist/lib/matchers/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Per-matcher result types.
+ *
+ * Each call into `expect(...).to.X(...)`, `judge(...)`, or a traces helper
+ * produces one MatcherResult. The runner collects them per test case and
+ * persists them on TestCaseRun so the UI can show a breakdown like
+ *
+ *   ✅ to contain 'root cause'           [code-assertion]
+ *   ❌ to be lessThan 30000               [code-assertion]   actual: 47320
+ *   ✅ identifies failing dependency     [llm-judge]   score: 0.85
+ *   ✅ traces.totalTokens < 10000        [traces]
+ */
+export type MatcherMethod = 'code-assertion' | 'llm-judge' | 'traces' | 'evaluator';
+export interface MatcherResult {
+    /** Human-readable description, e.g. "to contain 'root cause'". */
+    description: string;
+    /** Whether this matcher passed. */
+    pass: boolean;
+    /** Family the matcher belongs to. */
+    method: MatcherMethod;
+    /**
+     * Whether this signal gates the test verdict. `gate` (default) means a
+     * failing result fails the test; `observe` means the result is recorded
+     * for score/insights only and never fails the test (RFC 004 §4.8).
+     * `code-assertion` and `traces` matchers are always gates; `llm-judge`
+     * entries are `gate` for `judge()` and `observe` for `judge.observe()`.
+     */
+    role?: 'gate' | 'observe';
+    /**
+     * True when the matcher could not be evaluated at all (e.g. the judge
+     * endpoint errored) — distinct from a clean `pass: false`. Errored
+     * signals are excluded from pass-rate aggregation (status `errored`).
+     */
+    errored?: boolean;
+    /** Wall-clock time spent evaluating this matcher (ms). */
+    durationMs?: number;
+    /** The actual value as seen by the matcher (best-effort). */
+    actual?: unknown;
+    /** The expected value as configured by the user (best-effort). */
+    expected?: unknown;
+    /** Failure message from the chai assertion when pass is false. */
+    errorMessage?: string;
+    /** Confidence score on the [0, 1] interval, when available. */
+    score?: number;
+    /** Free-form judge reasoning, when available. */
+    reasoning?: string;
+    /** Model used by the judge for this matcher. */
+    model?: string;
+    /**
+     * Actionable suggestions produced by the judge when the verdict is
+     * `pass: false` (or, for the auto-judge path, when accuracy < 100).
+     * Same shape as the report-level field; carried per-call here so
+     * SDK multi-judge runs preserve per-claim feedback.
+     */
+    improvementStrategies?: Array<{
+        category: string;
+        issue: string;
+        recommendation: string;
+        priority: 'high' | 'medium' | 'low';
+    }>;
+    /**
+     * Full judge metric breakdown when the judge produces multiple
+     * dimensions. `score` (above) is the headline value (typically
+     * `accuracy / 100`); this object exposes the rest. All keys are
+     * optional because the judge only emits them when applicable.
+     */
+    judgeMetrics?: {
+        accuracy?: number;
+        faithfulness?: number;
+        latency_score?: number;
+        trajectory_alignment_score?: number;
+        [k: string]: number | undefined;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/dist/lib/matchers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../matchers/types.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,aAAa,CAAC;IACtB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IASf;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;KACrC,CAAC,CAAC;IAEH;;;;;OAKG;IACH,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,0BAA0B,CAAC,EAAE,MAAM,CAAC;QACpC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACjC,CAAC;CACH"}

package/lib/dist/lib/matchers/types.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/dist/lib/matchers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../matchers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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"}