@opensearch-project/agent-health 0.3.0 → 0.5.2

package/lib/dist/lib/utils.js

@@ -0,0 +1,232 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+import { DEFAULT_CONFIG } from "../lib/constants.js";
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+// ==================== Label Styling ====================
+// Special colors for difficulty labels only
+// Light mode: subtle backgrounds with darker text
+// Dark mode: darker backgrounds with lighter text
+const DIFFICULTY_LABEL_COLORS = {
+    'difficulty:Easy': 'bg-blue-100 text-blue-800 border-blue-300 dark:bg-blue-900/30 dark:text-opensearch-blue dark:border-blue-800',
+    'difficulty:Medium': 'bg-amber-100 text-amber-800 border-amber-300 dark:bg-yellow-900/30 dark:text-yellow-400 dark:border-yellow-800',
+    'difficulty:Hard': 'bg-red-100 text-red-800 border-red-300 dark:bg-red-900/30 dark:text-red-400 dark:border-red-800',
+};
+// Generic label color palette (used for all other labels, hash-based)
+// OpenSearch UI inspired colors for light mode
+const LABEL_COLOR_PALETTE = [
+    'bg-blue-100 text-blue-800 border-blue-300 dark:bg-blue-900/20 dark:text-blue-300 dark:border-blue-700',
+    'bg-purple-100 text-purple-800 border-purple-300 dark:bg-purple-900/30 dark:text-purple-400 dark:border-purple-800',
+    'bg-cyan-100 text-cyan-800 border-cyan-300 dark:bg-cyan-900/30 dark:text-cyan-400 dark:border-cyan-800',
+    'bg-pink-100 text-pink-800 border-pink-300 dark:bg-pink-900/30 dark:text-pink-400 dark:border-pink-800',
+    'bg-orange-100 text-orange-800 border-orange-300 dark:bg-orange-900/30 dark:text-orange-400 dark:border-orange-800',
+    'bg-teal-100 text-teal-800 border-teal-300 dark:bg-teal-900/30 dark:text-teal-400 dark:border-teal-800',
+    'bg-indigo-100 text-indigo-800 border-indigo-300 dark:bg-indigo-900/30 dark:text-indigo-400 dark:border-indigo-800',
+    'bg-gray-100 text-gray-800 border-gray-300 dark:bg-muted dark:text-muted-foreground dark:border-border',
+];
+/**
+ * Returns Tailwind classes for styling label badges
+ * Only difficulty:Easy/Medium/Hard get special colors; all others use hash-based palette
+ */
+export const getLabelColor = (label) => {
+    // Check exact match for difficulty labels
+    if (DIFFICULTY_LABEL_COLORS[label]) {
+        return DIFFICULTY_LABEL_COLORS[label];
+    }
+    // All other labels use hash-based color assignment for consistency
+    const hash = label.split('').reduce((acc, char) => acc + char.charCodeAt(0), 0);
+    return LABEL_COLOR_PALETTE[hash % LABEL_COLOR_PALETTE.length];
+};
+// Mapping from difficulty value to full label for backward compat
+const DIFFICULTY_VALUE_COLORS = {
+    'Easy': 'bg-blue-100 text-blue-800 border-blue-300 dark:bg-blue-900/30 dark:text-opensearch-blue dark:border-blue-800',
+    'Medium': 'bg-amber-100 text-amber-800 border-amber-300 dark:bg-yellow-900/30 dark:text-yellow-400 dark:border-yellow-800',
+    'Hard': 'bg-red-100 text-red-800 border-red-300 dark:bg-red-900/30 dark:text-red-400 dark:border-red-800',
+};
+/**
+ * Returns Tailwind classes for styling difficulty badges
+ * @deprecated Use getLabelColor with difficulty: prefixed labels instead
+ */
+export const getDifficultyColor = (difficulty) => {
+    return DIFFICULTY_VALUE_COLORS[difficulty] || DIFFICULTY_VALUE_COLORS['Medium'];
+};
+// ==================== Date Formatting ====================
+/**
+ * Formats a timestamp string to a localized date string
+ * @param timestamp - ISO timestamp string
+ * @param variant - 'date' (date only), 'datetime' (default, with time), 'detailed' (with seconds)
+ */
+export const formatDate = (timestamp, variant = 'datetime') => {
+    const date = new Date(timestamp);
+    const options = {
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric',
+    };
+    if (variant === 'datetime' || variant === 'detailed') {
+        options.hour = '2-digit';
+        options.minute = '2-digit';
+    }
+    if (variant === 'detailed') {
+        options.second = '2-digit';
+    }
+    return date.toLocaleString('en-US', options);
+};
+/**
+ * Formats a timestamp to relative time (e.g., "5m ago", "2h ago")
+ * Falls back to formatDate for timestamps older than 7 days
+ */
+export const formatRelativeTime = (timestamp) => {
+    const date = new Date(timestamp);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffMins = Math.floor(diffMs / 60000);
+    const diffHours = Math.floor(diffMs / 3600000);
+    const diffDays = Math.floor(diffMs / 86400000);
+    if (diffMins < 1)
+        return 'Just now';
+    if (diffMins < 60)
+        return `${diffMins}m ago`;
+    if (diffHours < 24)
+        return `${diffHours}h ago`;
+    if (diffDays < 7)
+        return `${diffDays}d ago`;
+    return formatDate(timestamp);
+};
+// ==================== Model Utilities ====================
+/**
+ * Gets the display name for a model ID from config
+ */
+export const getModelName = (modelId) => {
+    const model = DEFAULT_CONFIG.models[modelId];
+    return model?.display_name || modelId;
+};
+// ==================== Run Utilities ====================
+/**
+ * Returns a short, stable suffix for a TestCaseRun id, suitable for embedding
+ * in an auto-generated run name. Run ids are shaped
+ * `report-<timestamp>-<random>` (file adapter) or arbitrary keys (OpenSearch),
+ * so we take the trailing 6 characters which gives a recognizable yet compact
+ * label without exposing the full id. Falls back to the full id for very short
+ * ids (e.g. legacy data).
+ */
+export const getRunShortId = (runId) => {
+    if (!runId)
+        return '';
+    return runId.length > 6 ? runId.slice(-6) : runId;
+};
+/**
+ * Resolves the display name for a TestCaseRun.
+ *
+ * Prefers the persisted `name` field (set from the run config dialog or
+ * auto-generated server-side). Falls back to `Run <short-id>` for older
+ * runs that pre-date the field, so every row in the runs list has a
+ * recognizable label instead of a raw id slice.
+ */
+export const getRunDisplayName = (run) => {
+    if (run.name && run.name.trim())
+        return run.name.trim();
+    return `Run ${getRunShortId(run.id)}`;
+};
+/**
+ * Computes a single "overall score" percentage to display next to a run in
+ * a list, from whatever metrics that run happens to carry.
+ *
+ * Why this is non-trivial:
+ *   - Only the *RCA Default* system evaluator emits a metric named `accuracy`.
+ *     Other system evaluators (Factuality, Tool Use, Reasoning, Safety) and
+ *     any custom evaluator emit completely different metric names like
+ *     `tool_selection_accuracy`, `reasoning_coherence`, `bias_detection`, etc.
+ *   - The runs list used to hardcode `run.metrics?.accuracy ?? 0`, which made
+ *     every non-RCA run display `0%` even when the judge had passed it.
+ *
+ * The fix is to take the **arithmetic mean of all populated numeric metrics**
+ * on the run. This works for any evaluator without having to look up its
+ * `scoringConfig`, gives a reasonable summary number, and degrades to `null`
+ * (rendered as `—`) when no metrics are present — the only honest answer
+ * for runs whose judge call hasn't completed or which were never scored.
+ *
+ * Returns `null` when there are no numeric metrics; otherwise an integer
+ * percentage rounded to the nearest whole number.
+ */
+export const getRunOverallScore = (metrics) => {
+    if (!metrics)
+        return null;
+    const values = [];
+    for (const v of Object.values(metrics)) {
+        if (typeof v === 'number' && Number.isFinite(v))
+            values.push(v);
+    }
+    if (values.length === 0)
+        return null;
+    const sum = values.reduce((a, b) => a + b, 0);
+    return Math.round(sum / values.length);
+};
+// ==================== Status Colors ====================
+/**
+ * Returns theme-aware Tailwind classes for pass rate badges
+ * Light mode: More saturated backgrounds with darker text for better visibility
+ * Dark mode: Lighter text on dark backgrounds
+ */
+export const getPassRateColor = (passRate) => {
+    if (passRate >= 80) {
+        // Success/Pass - Green with more saturated background
+        return 'bg-green-100 text-green-800 border-green-300 dark:bg-green-900/30 dark:text-green-400 dark:border-green-800';
+    }
+    else if (passRate >= 50) {
+        // Warning - Amber with more saturated background
+        return 'bg-amber-100 text-amber-800 border-amber-300 dark:bg-amber-900/30 dark:text-amber-400 dark:border-amber-800';
+    }
+    else {
+        // Danger/Fail - Red with more saturated background
+        return 'bg-red-100 text-red-800 border-red-300 dark:bg-red-900/30 dark:text-red-400 dark:border-red-800';
+    }
+};
+/**
+ * Returns theme-aware Tailwind classes for status indicators
+ * Used for success/error/warning/info states
+ * Light mode: More saturated backgrounds (100 shade) for better visibility
+ * Dark mode: Semi-transparent darker backgrounds with lighter text
+ */
+export const getStatusColor = (status) => {
+    const colors = {
+        success: 'bg-green-100 text-green-800 border-green-300 dark:bg-green-900/30 dark:text-green-400 dark:border-green-800',
+        error: 'bg-red-100 text-red-800 border-red-300 dark:bg-red-900/30 dark:text-red-400 dark:border-red-800',
+        warning: 'bg-amber-100 text-amber-800 border-amber-300 dark:bg-amber-900/30 dark:text-amber-400 dark:border-amber-800',
+        info: 'bg-blue-100 text-blue-800 border-blue-300 dark:bg-blue-900/30 dark:text-blue-400 dark:border-blue-800',
+        neutral: 'bg-gray-100 text-gray-800 border-gray-300 dark:bg-gray-800/30 dark:text-gray-400 dark:border-gray-700',
+    };
+    return colors[status];
+};
+/**
+ * Returns theme-aware text color classes for metrics
+ * Used for displaying metric values in stats cards
+ * Light mode: Darker colors for WCAG AA compliance (4.5:1 contrast ratio)
+ * Dark mode: Lighter colors for visibility on dark backgrounds
+ */
+export const getMetricTextColor = (type) => {
+    const colors = {
+        primary: 'text-blue-700 dark:text-blue-400',
+        success: 'text-green-700 dark:text-green-400',
+        error: 'text-red-700 dark:text-red-400',
+        warning: 'text-amber-700 dark:text-amber-400',
+        info: 'text-purple-700 dark:text-purple-400',
+        secondary: 'text-cyan-700 dark:text-cyan-400',
+    };
+    return colors[type];
+};
+// ==================== Text Utilities ====================
+/**
+ * Truncates text to a specified length with ellipsis
+ */
+export const truncate = (text, length) => {
+    if (text.length <= length)
+        return text;
+    return text.substring(0, length).trim() + '...';
+};
+//# sourceMappingURL=utils.js.map

package/lib/dist/lib/utils.js.map

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

package/lib/dist/lib/workflow/consolidate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * consolidate() — cluster staged fixes by signature so a run raises ONE PR per
+ * fix-class instead of one per ticket.
+ *
+ * This is intentionally conservative: it groups only on an exact signature
+ * match. Loose clustering risks merging two genuinely-different bugs into one
+ * confused PR, so the default bias is split-not-merge. Swap in an embedding /
+ * correlation backend later without changing the workflow surface.
+ */
+import type { Cluster, StagedItem } from './types.js';
+export declare function consolidate(staged: StagedItem[]): Promise<Cluster[]>;
+//# sourceMappingURL=consolidate.d.ts.map

package/lib/dist/lib/workflow/consolidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.d.ts","sourceRoot":"","sources":["../../../workflow/consolidate.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAsB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA8B1E"}

package/lib/dist/lib/workflow/consolidate.js

@@ -0,0 +1,33 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export async function consolidate(staged) {
+    const bySignature = new Map();
+    for (const s of staged) {
+        const key = s.signature || 'unknown';
+        const bucket = bySignature.get(key) ?? [];
+        bucket.push(s);
+        bySignature.set(key, bucket);
+    }
+    const clusters = [];
+    for (const [signature, items] of bySignature) {
+        const tickets = items.map((i) => i.item);
+        const traceIds = [...new Set(items.flatMap((i) => i.run.traceIds))];
+        clusters.push({
+            label: signature,
+            signature,
+            items,
+            tickets,
+            traceIds,
+            fix: {
+                summary: `Candidate fix for "${signature}" derived from ${tickets.length} ` +
+                    `ticket(s): ${tickets.map((t) => t.id).join(', ')}.`,
+            },
+        });
+    }
+    // Largest clusters first — the highest-leverage fixes surface at the top.
+    clusters.sort((a, b) => b.items.length - a.items.length);
+    return clusters;
+}
+//# sourceMappingURL=consolidate.js.map

package/lib/dist/lib/workflow/consolidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.js","sourceRoot":"","sources":["../../../workflow/consolidate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB;IACpD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAwB,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC;QACrC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACpE,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,SAAS;YAChB,SAAS;YACT,KAAK;YACL,OAAO;YACP,QAAQ;YACR,GAAG,EAAE;gBACH,OAAO,EACL,sBAAsB,SAAS,kBAAkB,OAAO,CAAC,MAAM,GAAG;oBAClE,cAAc,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACvD;SACF,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,13 @@
+/** Workflow SDK public surface. */
+export { source, getSource, listSources, clearSources } from './source.js';
+export { workflow } from './workflow.js';
+export { FeedbackLedger } from './ledger.js';
+export { consolidate } from './consolidate.js';
+export { mapPool } from './pool.js';
+export { profileSpans, buildAgentEditsPrompt, parseAgentEdits, deriveAgentEdits, defaultReason, } from './stepB.js';
+export type { WorkItem, SourceFetchFn, SourceHandle, AgentRunResult, StagedItem, Cluster, WritesMode, RunAgentOptions, WorkflowConfig, PRRequest, } from './types.js';
+export type { LedgerEntry } from './ledger.js';
+export type { PoolStats } from './pool.js';
+export type { SessionProfile, AgentEdit, ReasonFn } from './stepB.js';
+export type { Workflow, WorkflowContext, WorkflowRunOptions, WorkflowResult, ForEachOptions, } from './workflow.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../workflow/index.ts"],"names":[],"mappings":"AAKA,mCAAmC;AAEnC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,OAAO,EACP,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EACV,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC"}

package/lib/dist/lib/workflow/index.js

@@ -0,0 +1,12 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** Workflow SDK public surface. */
+export { source, getSource, listSources, clearSources } from './source.js';
+export { workflow } from './workflow.js';
+export { FeedbackLedger } from './ledger.js';
+export { consolidate } from './consolidate.js';
+export { mapPool } from './pool.js';
+export { profileSpans, buildAgentEditsPrompt, parseAgentEdits, deriveAgentEdits, defaultReason, } from './stepB.js';
+//# sourceMappingURL=index.js.map

package/lib/dist/lib/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../workflow/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mCAAmC;AAEnC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/lib/dist/lib/workflow/ledger.d.ts

@@ -0,0 +1,30 @@
+/**
+ * FeedbackLedger — cumulative, append-only human steering for one workflow run.
+ *
+ * This is the upgrade over a single-shot `--feedback` flag: a correction given
+ * on ticket #3 is appended here and injected into the agent's context for
+ * tickets #4..#N (steering compounds), and the whole ledger is embedded into
+ * the consolidated PR bodies as rationale.
+ */
+export interface LedgerEntry {
+    at: string;
+    text: string;
+    ticketId?: string;
+    source: 'human' | 'signal' | 'system';
+}
+export declare class FeedbackLedger {
+    private entries;
+    /** Append a correction. Defaults to a human-sourced entry. */
+    append(text: string, opts?: {
+        ticketId?: string;
+        source?: LedgerEntry['source'];
+    }): void;
+    all(): readonly LedgerEntry[];
+    get size(): number;
+    /**
+     * Rendered block — injected into each subsequent agent run as context and
+     * embedded into PR bodies. Empty string when there's nothing to say.
+     */
+    render(): string;
+}
+//# sourceMappingURL=ledger.d.ts.map

package/lib/dist/lib/workflow/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../../workflow/ledger.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACvC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAqB;IAEpC,8DAA8D;IAC9D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;KAAO,GAAG,IAAI;IAW5F,GAAG,IAAI,SAAS,WAAW,EAAE;IAI7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,MAAM,IAAI,MAAM;CAQjB"}

package/lib/dist/lib/workflow/ledger.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export class FeedbackLedger {
+    constructor() {
+        this.entries = [];
+    }
+    /** Append a correction. Defaults to a human-sourced entry. */
+    append(text, opts = {}) {
+        const trimmed = text?.trim();
+        if (!trimmed)
+            return;
+        this.entries.push({
+            at: new Date().toISOString(),
+            text: trimmed,
+            ticketId: opts.ticketId,
+            source: opts.source ?? 'human',
+        });
+    }
+    all() {
+        return this.entries;
+    }
+    get size() {
+        return this.entries.length;
+    }
+    /**
+     * Rendered block — injected into each subsequent agent run as context and
+     * embedded into PR bodies. Empty string when there's nothing to say.
+     */
+    render() {
+        if (this.entries.length === 0)
+            return '';
+        const lines = this.entries.map((e, i) => {
+            const tag = e.ticketId ? `[${e.ticketId}] ` : '';
+            return `${i + 1}. ${tag}${e.text}`;
+        });
+        return ['## Cumulative feedback (steers this run)', ...lines].join('\n');
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/lib/dist/lib/workflow/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../../workflow/ledger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,OAAO,cAAc;IAA3B;QACU,YAAO,GAAkB,EAAE,CAAC;IAkCtC,CAAC;IAhCC,8DAA8D;IAC9D,MAAM,CAAC,IAAY,EAAE,OAA8D,EAAE;QACnF,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,0CAA0C,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/lib/dist/lib/workflow/pool.d.ts

@@ -0,0 +1,13 @@
+/**
+ * mapPool — run an async fn over items with bounded concurrency.
+ *
+ * The concurrency cap is the workflow's primary cost + blast-radius control:
+ * in `new` mode it bounds how many live agent investigations run at once.
+ * Returns results in input order; rejects on the first error.
+ */
+export interface PoolStats {
+    /** Highest number of simultaneously-active tasks observed. */
+    peakConcurrency: number;
+}
+export declare function mapPool<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>, stats?: PoolStats): Promise<R[]>;
+//# sourceMappingURL=pool.d.ts.map

package/lib/dist/lib/workflow/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../workflow/pool.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AAEH,MAAM,WAAW,SAAS;IACxB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,CAAC,EAChC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,KAAK,CAAC,EAAE,SAAS,GAChB,OAAO,CAAC,CAAC,EAAE,CAAC,CAoCd"}

package/lib/dist/lib/workflow/pool.js

@@ -0,0 +1,44 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export async function mapPool(items, limit, fn, stats) {
+    // Guard non-finite / non-positive limits (e.g. NaN from a bad CLI parse) so the
+    // scheduler can never deadlock by never starting any task.
+    const max = Number.isFinite(limit) && limit >= 1 ? Math.floor(limit) : 1;
+    const results = new Array(items.length);
+    let next = 0;
+    let active = 0;
+    let settled = 0;
+    let rejected = false;
+    return new Promise((resolve, reject) => {
+        if (items.length === 0)
+            return resolve(results);
+        const pump = () => {
+            if (rejected)
+                return;
+            while (active < max && next < items.length) {
+                const i = next++;
+                active++;
+                if (stats)
+                    stats.peakConcurrency = Math.max(stats.peakConcurrency, active);
+                Promise.resolve(fn(items[i], i))
+                    .then((r) => {
+                    results[i] = r;
+                    active--;
+                    settled++;
+                    if (settled === items.length)
+                        resolve(results);
+                    else
+                        pump();
+                })
+                    .catch((err) => {
+                    rejected = true;
+                    reject(err);
+                });
+            }
+        };
+        pump();
+    });
+}
+//# sourceMappingURL=pool.js.map

package/lib/dist/lib/workflow/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../../workflow/pool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,KAAmB,EACnB,KAAa,EACb,EAA0C,EAC1C,KAAiB;IAEjB,gFAAgF;IAChF,2DAA2D;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO,IAAI,OAAO,CAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;QAEhD,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,IAAI,QAAQ;gBAAE,OAAO;YACrB,OAAO,MAAM,GAAG,GAAG,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBACjB,MAAM,EAAE,CAAC;gBACT,IAAI,KAAK;oBAAE,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;gBAC3E,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;qBAC7B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACV,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBACf,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,CAAC;oBACV,IAAI,OAAO,KAAK,KAAK,CAAC,MAAM;wBAAE,OAAO,CAAC,OAAO,CAAC,CAAC;;wBAC1C,IAAI,EAAE,CAAC;gBACd,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACb,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC,CAAC,CAAC;YACP,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/dist/lib/workflow/source.d.ts

@@ -0,0 +1,22 @@
+/**
+ * source() — register a work source from a plain .ts file. No interface to
+ * implement: the fetch fn returns duck-typed { id, prompt, meta } objects.
+ * Mirrors the test() registrar so source files feel like eval files.
+ *
+ * @example
+ * ```ts
+ * export const queue = source('dp-oncall-queue', async ({ since }) => {
+ *   const tickets = await sim.queryFolder(MY_FOLDER, { since, open: true });
+ *   return tickets.map(t => ({ id: t.id, prompt: t.url, meta: { cti: t.cti } }));
+ * });
+ * ```
+ */
+import type { SourceFetchFn, SourceHandle } from './types.js';
+export declare function source(name: string, fetch: SourceFetchFn): SourceHandle;
+/** Look up a registered source by name (used by the workflow runtime / loaders). */
+export declare function getSource(name: string): SourceHandle | undefined;
+/** List registered source names. */
+export declare function listSources(): string[];
+/** Test seam — drop all registrations. */
+export declare function clearSources(): void;
+//# sourceMappingURL=source.d.ts.map

package/lib/dist/lib/workflow/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../workflow/source.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI9D,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,YAAY,CAUvE;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED,oCAAoC;AACpC,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/lib/dist/lib/workflow/source.js

@@ -0,0 +1,29 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const registry = new Map();
+export function source(name, fetch) {
+    if (!name || typeof name !== 'string') {
+        throw new Error('source(name, fetch): name must be a non-empty string');
+    }
+    if (typeof fetch !== 'function') {
+        throw new Error(`source('${name}', fetch): fetch must be a function`);
+    }
+    const handle = { name, fetch };
+    registry.set(name, handle);
+    return handle;
+}
+/** Look up a registered source by name (used by the workflow runtime / loaders). */
+export function getSource(name) {
+    return registry.get(name);
+}
+/** List registered source names. */
+export function listSources() {
+    return [...registry.keys()];
+}
+/** Test seam — drop all registrations. */
+export function clearSources() {
+    registry.clear();
+}
+//# sourceMappingURL=source.js.map

package/lib/dist/lib/workflow/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../workflow/source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEjD,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,KAAoB;IACvD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,qCAAqC,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,GAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,YAAY;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/lib/dist/lib/workflow/stepB.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Step B — improve-the-agent from its own guided sessions.
+ *
+ * This is the successor half of the workflow that builds on the agent-profiling
+ * primitives (#267): profile a session's traces against an evaluator rubric,
+ * fold in the cumulative FeedbackLedger, and derive concrete edits to the
+ * agent's OWN repo (prompt / skills / SOPs) — terminating in an improvement PR.
+ *
+ * The reasoning node (`deriveAgentEdits`) is the only stochastic part; the
+ * profiling is deterministic (reuses `spansToTrajectory` + `scanSessionSignals`
+ * from #267). Both the span source and the reasoner are injectable seams so the
+ * core is unit-testable without a live server or a real `claude` process.
+ */
+import type { Span, TrajectoryStep } from '../../types/index.js';
+import { type SessionSignal } from '../../services/traces/spansToTrajectory.js';
+import type { FeedbackLedger } from './ledger.js';
+/** A profiled session — the deterministic half of Step B. */
+export interface SessionProfile {
+    sessionId: string;
+    serviceName?: string;
+    trajectory: TrajectoryStep[];
+    signals: SessionSignal[];
+    evaluator?: {
+        id: string;
+        systemPrompt?: string;
+    };
+    traceIds: string[];
+}
+/** A single proposed edit to the agent's repo. */
+export interface AgentEdit {
+    file: string;
+    change: string;
+    why: string;
+    priority: 'high' | 'medium' | 'low';
+    evidence?: string[];
+}
+/** Reasoner seam: prompt → raw model text. Default spawns `claude -p`. */
+export type ReasonFn = (prompt: string) => Promise<string>;
+/**
+ * Profile a session from its spans — deterministic, reuses #267 primitives.
+ * Pass `spans` directly (unit-testable) or resolve them via a seam upstream.
+ */
+export declare function profileSpans(sessionId: string, spans: Span[], opts?: {
+    serviceName?: string;
+    evaluator?: {
+        id: string;
+        systemPrompt?: string;
+    };
+}): SessionProfile;
+/**
+ * Build the reasoner prompt from profiles + the cumulative ledger. Pure, so the
+ * exact instruction surface is unit-testable and reviewable.
+ */
+export declare function buildAgentEditsPrompt(profiles: SessionProfile[], opts?: {
+    repo?: string;
+    ledger?: FeedbackLedger;
+}): string;
+/** Default reasoner: spawn `claude -p <prompt>` and return stdout. */
+export declare const defaultReason: ReasonFn;
+/** Parse the reasoner output into AgentEdits (tolerant of fenced JSON). */
+export declare function parseAgentEdits(raw: string): AgentEdit[];
+/**
+ * Derive concrete agent-repo edits from session profiles + the cumulative
+ * ledger. `reason` is injectable (defaults to `claude -p`).
+ */
+export declare function deriveAgentEdits(profiles: SessionProfile[], opts?: {
+    repo?: string;
+    ledger?: FeedbackLedger;
+    reason?: ReasonFn;
+}): Promise<AgentEdit[]>;
+//# sourceMappingURL=stepB.d.ts.map

package/lib/dist/lib/workflow/stepB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepB.d.ts","sourceRoot":"","sources":["../../../workflow/stepB.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACnH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAO,GACrF,cAAc,CAYhB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,GACpD,MAAM,CAwBR;AAED,sEAAsE;AACtE,eAAO,MAAM,aAAa,EAAE,QAW3B,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAqBxD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;CAAO,GACvE,OAAO,CAAC,SAAS,EAAE,CAAC,CAMtB"}