@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/runtime/diagnostics/types.d.ts

@@ -0,0 +1,533 @@
+/**
+ * Diagnostics system types — shared across all diagnostic panel data providers.
+ *
+ * These types are purely data-oriented. No UI rendering logic lives here.
+ * All entries are immutable snapshots produced at the time of capture.
+ */
+import type { HealthStatus, HealthDomain } from '../health/types.js';
+/** Default maximum number of entries retained in a bounded diagnostic buffer. */
+export declare const DEFAULT_BUFFER_LIMIT = 500;
+/**
+ * Filter applied to diagnostic entry queries.
+ * All fields are optional; omitting a field means "do not filter on this dimension".
+ */
+export interface DiagnosticFilter {
+    /** Restrict to entries whose domain matches one of these values. */
+    readonly domains?: readonly string[];
+    /** Restrict to entries at or above this severity level. */
+    readonly level?: DiagnosticLevel;
+    /** Restrict to entries at or after this epoch ms timestamp (inclusive). */
+    readonly since?: number;
+    /** Restrict to entries at or before this epoch ms timestamp (inclusive). */
+    readonly until?: number;
+    /** Restrict to entries whose traceId matches. */
+    readonly traceId?: string;
+    /** Restrict to entries whose sessionId matches. */
+    readonly sessionId?: string;
+    /** Restrict to entries whose turnId matches. */
+    readonly turnId?: string;
+    /** Restrict to entries whose taskId matches. */
+    readonly taskId?: string;
+    /** Maximum number of entries to return (most recent first). */
+    readonly limit?: number;
+}
+/** Severity level for diagnostic entries. */
+export type DiagnosticLevel = 'debug' | 'info' | 'warn' | 'error';
+/** Phase of a single tool call in its execution timeline. */
+export type ToolCallPhase = 'received' | 'validated' | 'prehooked' | 'permissioned' | 'executing' | 'mapped' | 'posthooked' | 'succeeded' | 'failed' | 'cancelled';
+/** Permission outcome attached to a tool call. */
+export interface ToolCallPermission {
+    /** Whether the permission check approved the call. */
+    approved: boolean;
+}
+/**
+ * Immutable diagnostic entry for a single tool call.
+ * Aggregates all lifecycle phases into a single record.
+ */
+export interface ToolCallEntry {
+    /** Unique call identifier from the event payload. */
+    readonly callId: string;
+    /** Turn this tool call belongs to. */
+    readonly turnId: string;
+    /** Tool name. */
+    readonly tool: string;
+    /** Arguments passed to the tool (captured at TOOL_RECEIVED). */
+    readonly args: Record<string, unknown>;
+    /** Current phase in the tool call lifecycle. */
+    readonly phase: ToolCallPhase;
+    /** Epoch ms when the call was first observed (TOOL_RECEIVED). */
+    readonly receivedAt: number;
+    /** Epoch ms when the call completed (succeeded/failed/cancelled). */
+    readonly completedAt?: number;
+    /** Duration in ms (populated on terminal phases). */
+    readonly durationMs?: number;
+    /** Error message (populated when phase === 'failed'). */
+    readonly error?: string;
+    /** Cancellation reason (populated when phase === 'cancelled'). */
+    readonly cancelReason?: string;
+    /** Permission result (populated when permission check completes). */
+    readonly permission?: ToolCallPermission;
+    /** Trace identifier from the originating envelope. */
+    readonly traceId: string;
+    /** Session identifier from the originating envelope. */
+    readonly sessionId: string;
+}
+/** Current state of an agent in the diagnostic view. */
+export type AgentDiagnosticState = 'spawning' | 'running' | 'awaiting_message' | 'awaiting_tool' | 'finalizing' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Immutable diagnostic entry for a single agent instance.
+ */
+export interface AgentEntry {
+    /** Unique agent identifier. */
+    readonly agentId: string;
+    /** Associated task identifier (if any). */
+    readonly taskId?: string;
+    /** Brief task description (captured at AGENT_SPAWNING). */
+    readonly task: string;
+    /** Current agent state. */
+    readonly state: AgentDiagnosticState;
+    /** Epoch ms when the agent was first observed (AGENT_SPAWNING). */
+    readonly spawnedAt: number;
+    /** Epoch ms when the agent reached a terminal state. */
+    readonly completedAt?: number;
+    /** Duration in ms (populated on terminal states). */
+    readonly durationMs?: number;
+    /** Error message (populated when state === 'failed'). */
+    readonly error?: string;
+    /** Tool call that is currently blocking this agent (AGENT_AWAITING_TOOL). */
+    readonly blockedOnCallId?: string;
+    /** Tool name the agent is blocked on. */
+    readonly blockedOnTool?: string;
+    /** Trace identifier from the originating envelope. */
+    readonly traceId: string;
+    /** Session identifier from the originating envelope. */
+    readonly sessionId: string;
+}
+/**
+ * Immutable diagnostic entry for a runtime task.
+ */
+export interface TaskEntry {
+    /** Unique task identifier. */
+    readonly taskId: string;
+    /** Owning agent identifier (if any). */
+    readonly agentId?: string;
+    /** Human-readable task description. */
+    readonly description: string;
+    /** Task priority at creation time. */
+    readonly priority: number;
+    /** Current task state. */
+    readonly state: 'created' | 'running' | 'blocked' | 'progressing' | 'completed' | 'failed' | 'cancelled';
+    /** Epoch ms when the task was first observed (TASK_CREATED). */
+    readonly createdAt: number;
+    /** Epoch ms when the task reached a terminal state. */
+    readonly completedAt?: number;
+    /** Duration in ms (populated on terminal states). */
+    readonly durationMs?: number;
+    /** Progress value 0–100 (populated on TASK_PROGRESS). */
+    readonly progress?: number;
+    /** Latest progress message. */
+    readonly progressMessage?: string;
+    /** Reason the task is blocked (populated on TASK_BLOCKED). */
+    readonly blockReason?: string;
+    /** Error message (populated when state === 'failed'). */
+    readonly error?: string;
+    /** Trace identifier from the originating envelope. */
+    readonly traceId: string;
+    /** Session identifier from the originating envelope. */
+    readonly sessionId: string;
+}
+/**
+ * Immutable entry in the event timeline.
+ * Captures the full envelope context alongside the event type.
+ */
+export interface EventEntry {
+    /** Unique monotonically increasing sequence number within this session. */
+    readonly seq: number;
+    /** Event type discriminant string. */
+    readonly type: string;
+    /** Domain this event belongs to. */
+    readonly domain: string;
+    /** Epoch ms when the event was emitted. */
+    readonly ts: number;
+    /** Distributed trace identifier. */
+    readonly traceId: string;
+    /** Session identifier. */
+    readonly sessionId: string;
+    /** Turn identifier (if scoped to a turn). */
+    readonly turnId?: string;
+    /** Agent identifier (if scoped to an agent). */
+    readonly agentId?: string;
+    /** Task identifier (if scoped to a task). */
+    readonly taskId?: string;
+    /** Source module or component that emitted the event. */
+    readonly source: string;
+    /** Condensed summary of the payload (key fields only, not full payload). */
+    readonly summary: string;
+}
+/**
+ * Domain state entry in the runtime state snapshot.
+ * Each entry captures a single domain's serialized state.
+ */
+export interface DomainStateEntry {
+    /** Domain name. */
+    readonly domain: string;
+    /** Revision counter at time of snapshot. */
+    readonly revision: number;
+    /** Epoch ms of last update. */
+    readonly lastUpdatedAt: number;
+    /** Serialized state as a plain object (JSON-safe). */
+    readonly state: Record<string, unknown>;
+}
+/**
+ * Full runtime state snapshot for the state inspector panel.
+ */
+export interface RuntimeStateSnapshot {
+    /** Epoch ms when this snapshot was taken. */
+    readonly capturedAt: number;
+    /** All domain state entries. */
+    readonly domains: readonly DomainStateEntry[];
+}
+/**
+ * Gate status for a single SLO metric.
+ * - `ok`: current p95 is within the target threshold.
+ * - `warn`: current p95 is within 20% above threshold (approaching violation).
+ * - `violated`: current p95 exceeds the threshold.
+ * - `no_data`: no samples have been collected yet.
+ */
+export type SloGateStatus = 'ok' | 'warn' | 'violated' | 'no_data';
+/**
+ * A single SLO metric row for display in the health dashboard.
+ */
+export interface SloRow {
+    /** Metric key (e.g. 'slo.turn_start.p95'). */
+    readonly metric: string;
+    /** Human-readable name for the metric. */
+    readonly name: string;
+    /** Current p95 value in milliseconds. */
+    readonly p95Ms: number;
+    /** SLO target threshold in milliseconds. */
+    readonly targetMs: number;
+    /** Number of samples in the rolling window. */
+    readonly sampleCount: number;
+    /** Gate status derived from p95 vs target. */
+    readonly status: SloGateStatus;
+}
+/**
+ * Per-domain health summary for the health dashboard panel.
+ */
+export interface DomainHealthSummary {
+    /** Domain name. */
+    readonly domain: HealthDomain;
+    /** Current health status. */
+    readonly status: HealthStatus;
+    /** Epoch ms of last transition. */
+    readonly lastTransitionAt: number;
+    /** Reduced capabilities when degraded. */
+    readonly degradedCapabilities: readonly string[];
+    /** Failure reason if applicable. */
+    readonly failureReason?: string;
+    /** Number of recovery attempts made. */
+    readonly recoveryAttempts: number;
+}
+/**
+ * A single remediation action surface in the health dashboard.
+ * Maps to a playbook that provides resolution steps for a cascade failure.
+ */
+export interface RemediationAction {
+    /** Playbook ID (matches Playbook.id). */
+    readonly playbookId: string;
+    /** Human-readable name of the playbook. */
+    readonly playbookName: string;
+    /** The cascade rule ID that triggered the need for this remediation. */
+    readonly ruleId: string;
+    /** Source domain that triggered the cascade. */
+    readonly sourceDomain: HealthDomain;
+    /** Severity tier of the triggering cascade. */
+    readonly severity: string;
+}
+/**
+ * Aggregated health dashboard data for rendering.
+ */
+export interface HealthDashboardData {
+    /** Overall system health status. */
+    readonly overall: HealthStatus;
+    /** Per-domain health summaries. */
+    readonly domains: readonly DomainHealthSummary[];
+    /** Domains currently degraded. */
+    readonly degradedDomains: readonly HealthDomain[];
+    /** Domains currently failed. */
+    readonly failedDomains: readonly HealthDomain[];
+    /** Epoch ms of the last health update. */
+    readonly lastUpdatedAt: number;
+    /** SLO metric status rows. Empty when no SloCollector is attached. */
+    readonly sloRows: readonly SloRow[];
+    /**
+     * Actionable remediation steps derived from active cascade results.
+     * Empty when no cascades are pending or no playbook mappings exist.
+     */
+    readonly remediationActions: readonly RemediationAction[];
+}
+/**
+ * Configuration for a single diagnostic panel data provider.
+ */
+export interface PanelConfig {
+    /** Maximum number of entries retained in the buffer. */
+    readonly bufferLimit: number;
+}
+/**
+ * Default panel configuration used when none is provided.
+ */
+export declare const DEFAULT_PANEL_CONFIG: PanelConfig;
+/**
+ * Severity of a single tool contract violation.
+ * Mirrors ContractViolationSeverity from the contract-verifier module.
+ */
+export type ContractViolationSeverity = 'error' | 'warn';
+/**
+ * A single contract check failure or warning for a registered tool.
+ */
+export interface ToolContractViolation {
+    /** Which of the 5 contract dimensions this violation belongs to. */
+    readonly dimension: 'schema' | 'timeout-cancellation' | 'permission-class' | 'output-policy' | 'idempotency';
+    /** Severity of the violation. */
+    readonly severity: ContractViolationSeverity;
+    /** Human-readable explanation of what is wrong. */
+    readonly message: string;
+    /** Optional hint for how to fix the violation. */
+    readonly hint?: string;
+}
+/**
+ * Immutable diagnostic entry for a single tool's contract verification result.
+ */
+export interface ToolContractEntry {
+    /** Tool name. */
+    readonly toolName: string;
+    /** Whether the tool passed all required (error-level) checks. */
+    readonly passed: boolean;
+    /** All violations found. May include warnings even when passed. */
+    readonly violations: readonly ToolContractViolation[];
+    /** Unix timestamp (ms) when this result was produced. */
+    readonly verifiedAt: number;
+    /** Whether this tool implements the PhasedTool interface. */
+    readonly isPhasedTool: boolean;
+}
+/**
+ * Diagnostic entry capturing a protocol version negotiation event.
+ *
+ * Produced each time a handshake completes (success or failure) so the
+ * transport panel can show the negotiated version, downgrade reason, and
+ * any incompatibility codes.
+ */
+export interface TransportNegotiationEntry {
+    /** Unique connection ID (local tracking ID). */
+    readonly connectionId: string;
+    /** Remote endpoint URL or address. */
+    readonly endpoint: string;
+    /** Whether the negotiation resulted in a usable session. */
+    readonly success: boolean;
+    /**
+     * Negotiated protocol version label (e.g. "1.2.0").
+     * Populated on success; undefined on failure.
+     */
+    readonly negotiatedVersion?: string;
+    /** Whether the local side downgraded to match the peer. */
+    readonly downgraded: boolean;
+    /** Reason for downgrade (undefined when no downgrade). */
+    readonly downgradeReason?: string;
+    /** The version label this side offered. */
+    readonly offeredVersion: string;
+    /** The version label the remote peer advertised. */
+    readonly peerVersion: string;
+    /**
+     * Structured incompatibility code when success=false due to version mismatch.
+     * Absent for auth/network failures.
+     */
+    readonly incompatibilityCode?: 'major_version_mismatch' | 'peer_version_too_old' | 'peer_version_unsupported';
+    /** Human-readable incompatibility explanation. */
+    readonly incompatibilityReason?: string;
+    /** Epoch ms when the negotiation completed. */
+    readonly negotiatedAt: number;
+}
+/**
+ * Delivery outcome taxonomy for integration channel diagnostics.
+ * Mirrors DeliveryOutcome from src/integrations/delivery.ts.
+ */
+export type DeliveryOutcomeDiag = 'delivered' | 'retrying' | 'dead_letter';
+/**
+ * A single dead-letter entry in the integration diagnostics panel.
+ * Snapshot-safe; no live references.
+ */
+export interface DeadLetterDiagEntry {
+    /** Unique entry identifier. */
+    readonly id: string;
+    /** Integration channel (e.g. "slack", "discord", "webhook"). */
+    readonly channel: string;
+    /** Event name that triggered the delivery. */
+    readonly event: string;
+    /** Message payload (truncated to 200 chars for display). */
+    readonly payloadPreview: string;
+    /** Epoch ms when the entry moved to the DLQ. */
+    readonly deadAt: number;
+    /** Number of delivery attempts made. */
+    readonly attempts: number;
+    /** Final error message. */
+    readonly finalError: string;
+    /** Whether this was a terminal failure (vs exhausted retries). */
+    readonly terminal: boolean;
+}
+/**
+ * Per-channel delivery metrics for the diagnostics panel.
+ */
+export interface DeliveryChannelMetrics {
+    /** Integration channel identifier. */
+    readonly channel: string;
+    /** Total delivery attempts. */
+    readonly totalAttempts: number;
+    /** Successfully delivered messages. */
+    readonly delivered: number;
+    /** Messages currently queued for retry. */
+    readonly retrying: number;
+    /** Messages moved to the dead-letter queue. */
+    readonly deadLettered: number;
+    /** Current DLQ size. */
+    readonly dlqSize: number;
+    /** Whether SLO enforcement is active. */
+    readonly sloEnforced: boolean;
+}
+/**
+ * Integration delivery diagnostics snapshot for the diagnostics panel.
+ */
+export interface IntegrationDeliveryDiagnostics {
+    /** Per-channel metrics. */
+    readonly channels: readonly DeliveryChannelMetrics[];
+    /** Dead-letter entries across all channels (most recent first, capped at 100). */
+    readonly dlqEntries: readonly DeadLetterDiagEntry[];
+    /** Epoch ms of this snapshot. */
+    readonly capturedAt: number;
+}
+import type { PanelThrottleStatus, PanelHealthStatus } from '../perf/panel-contracts.js';
+/**
+ * Diagnostic snapshot for a single panel's resource usage and health.
+ */
+export interface PanelResourceEntry {
+    /** Panel id. */
+    readonly panelId: string;
+    /** Current throttle status. */
+    readonly throttleStatus: PanelThrottleStatus;
+    /** Current health status. */
+    readonly healthStatus: PanelHealthStatus;
+    /** p95 render duration in ms over the last measurement window. */
+    readonly renderP95Ms: number;
+    /** Maximum contract render budget in ms. */
+    readonly maxRenderMs: number;
+    /** Renders observed in the current measurement window. */
+    readonly rendersInWindow: number;
+    /** Contracted max updates per second. */
+    readonly maxUpdatesPerSecond: number;
+    /** Number of consecutive budget violations. */
+    readonly consecutiveViolations: number;
+    /** Total renders suppressed since monitor start. */
+    readonly totalSuppressed: number;
+    /** Total renders permitted since monitor start. */
+    readonly totalPermitted: number;
+    /** Epoch ms of the last permitted render. */
+    readonly lastRenderAt: number;
+    /** Epoch ms when next render is permitted (0 = unrestricted). */
+    readonly nextAllowedAt: number;
+}
+/**
+ * Full snapshot of panel resource health for the diagnostics panel.
+ */
+export interface PanelResourceSnapshot {
+    /** All tracked panel entries, sorted: overloaded > warning > healthy. */
+    readonly panels: readonly PanelResourceEntry[];
+    /** Count of panels currently in 'overloaded' health status. */
+    readonly overloadedCount: number;
+    /** Count of panels currently in 'warning' health status. */
+    readonly warningCount: number;
+    /** Count of panels currently in 'healthy' health status. */
+    readonly healthyCount: number;
+    /** Total renders suppressed across all panels since monitor start. */
+    readonly totalSuppressed: number;
+    /** Epoch ms when this snapshot was captured. */
+    readonly capturedAt: number;
+}
+/**
+ * Outcome of a token scope audit check.
+ * Mirrors TokenScopeAuditResult from src/security/token-audit.ts.
+ */
+export type TokenScopeAuditOutcome = 'ok' | 'violation';
+/**
+ * Outcome of a token rotation audit check.
+ * Mirrors TokenRotationAuditResult from src/security/token-audit.ts.
+ */
+export type TokenRotationAuditOutcome = 'ok' | 'warning' | 'overdue';
+/**
+ * Diagnostics entry for a single audited API token.
+ * Snapshot-safe; contains no secret values.
+ */
+export interface TokenAuditDiagEntry {
+    /** Stable token identifier (not the secret value). */
+    readonly tokenId: string;
+    /** Human-readable label (e.g. 'OPENAI_API_KEY'). */
+    readonly label: string;
+    /** Scope audit outcome. */
+    readonly scopeOutcome: TokenScopeAuditOutcome;
+    /** Scopes present on the token beyond the policy's allowedScopes. */
+    readonly excessScopes: readonly string[];
+    /** Policy ID this token was evaluated against. */
+    readonly policyId: string;
+    /** Rotation audit outcome. */
+    readonly rotationOutcome: TokenRotationAuditOutcome;
+    /** How old the token is in ms. */
+    readonly ageMs: number;
+    /** Configured rotation cadence in ms. */
+    readonly cadenceMs: number;
+    /** Ms remaining until rotation is due (negative = overdue). */
+    readonly msUntilDue: number;
+    /** Whether this token is blocked in managed mode. */
+    readonly blocked: boolean;
+}
+/**
+ * Full token audit diagnostics snapshot for the security panel.
+ */
+export interface TokenAuditDiagnostics {
+    /** Whether the auditor is operating in managed mode. */
+    readonly managed: boolean;
+    /** All audited token entries. */
+    readonly entries: readonly TokenAuditDiagEntry[];
+    /** IDs of tokens blocked in managed mode. */
+    readonly blocked: readonly string[];
+    /** IDs of tokens with scope violations. */
+    readonly scopeViolations: readonly string[];
+    /** IDs of tokens with rotation warnings. */
+    readonly rotationWarnings: readonly string[];
+    /** IDs of tokens with overdue rotation. */
+    readonly rotationOverdue: readonly string[];
+    /** Epoch ms when this audit was captured. */
+    readonly capturedAt: number;
+}
+/**
+ * Apply a DiagnosticFilter to an array of entries.
+ * Entries must have at minimum: `sessionId`, `traceId`, and a timestamp field.
+ * The `timestampField` parameter names the property used for time range checks.
+ *
+ * @param entries - Source array (most recent last).
+ * @param filter - Filter to apply.
+ * @param getTimestamp - Accessor for the entry's primary timestamp.
+ * @returns Filtered array, most recent first, capped at filter.limit.
+ */
+export declare function applyFilter<T extends {
+    sessionId: string;
+    traceId: string;
+}>(entries: readonly T[], filter: DiagnosticFilter | undefined, getTimestamp: (entry: T) => number): T[];
+/**
+ * Append an entry to a bounded buffer, discarding the oldest entry when
+ * the limit is exceeded.
+ *
+ * @param buffer - Mutable buffer array (oldest first).
+ * @param entry - Entry to append.
+ * @param limit - Maximum buffer size.
+ */
+export declare function appendBounded<T>(buffer: T[], entry: T, limit: number): void;
+//# sourceMappingURL=types.d.ts.map

package/dist/platform/runtime/diagnostics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/diagnostics/types.ts"],"names":[],"mappings":"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"}

package/dist/platform/runtime/diagnostics/types.js

@@ -0,0 +1,58 @@
+// ── Buffer defaults ───────────────────────────────────────────────────────────
+/** Default maximum number of entries retained in a bounded diagnostic buffer. */
+export const DEFAULT_BUFFER_LIMIT = 500;
+/**
+ * Default panel configuration used when none is provided.
+ */
+export const DEFAULT_PANEL_CONFIG = {
+    bufferLimit: DEFAULT_BUFFER_LIMIT,
+};
+// ── Utility ───────────────────────────────────────────────────────────────────
+/**
+ * Apply a DiagnosticFilter to an array of entries.
+ * Entries must have at minimum: `sessionId`, `traceId`, and a timestamp field.
+ * The `timestampField` parameter names the property used for time range checks.
+ *
+ * @param entries - Source array (most recent last).
+ * @param filter - Filter to apply.
+ * @param getTimestamp - Accessor for the entry's primary timestamp.
+ * @returns Filtered array, most recent first, capped at filter.limit.
+ */
+export function applyFilter(entries, filter, getTimestamp) {
+    if (!filter) {
+        return [...entries].reverse();
+    }
+    let result = [...entries];
+    if (filter.sessionId !== undefined) {
+        result = result.filter((e) => e.sessionId === filter.sessionId);
+    }
+    if (filter.traceId !== undefined) {
+        result = result.filter((e) => e.traceId === filter.traceId);
+    }
+    if (filter.since !== undefined) {
+        const since = filter.since;
+        result = result.filter((e) => getTimestamp(e) >= since);
+    }
+    if (filter.until !== undefined) {
+        const until = filter.until;
+        result = result.filter((e) => getTimestamp(e) <= until);
+    }
+    // Most recent first
+    result.reverse();
+    const limit = filter.limit ?? DEFAULT_BUFFER_LIMIT;
+    return result.slice(0, limit);
+}
+/**
+ * Append an entry to a bounded buffer, discarding the oldest entry when
+ * the limit is exceeded.
+ *
+ * @param buffer - Mutable buffer array (oldest first).
+ * @param entry - Entry to append.
+ * @param limit - Maximum buffer size.
+ */
+export function appendBounded(buffer, entry, limit) {
+    buffer.push(entry);
+    if (buffer.length > limit) {
+        buffer.shift();
+    }
+}

package/dist/platform/runtime/eval/baseline.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Evaluation Harness — Baseline persistence.
+ *
+ * Provides load/save/capture utilities for EvalBaseline records.
+ * Baselines are stored as JSON files on disk and loaded by the CI gate.
+ *
+ * File format: a single JSON object matching the EvalBaseline type.
+ */
+import type { EvalBaseline, EvalSuiteResult } from './types.js';
+/**
+ * Capture a baseline snapshot from a set of suite results.
+ *
+ * @param label - Human-readable label (e.g. 'main', 'v0.12.0').
+ * @param suiteResults - One or more suite results to capture.
+ * @returns A new EvalBaseline.
+ */
+export declare function captureBaseline(label: string, suiteResults: EvalSuiteResult[]): EvalBaseline;
+/**
+ * Serialise a baseline to a JSON string.
+ */
+export declare function serialiseBaseline(baseline: EvalBaseline): string;
+/**
+ * Deserialise a baseline from a JSON string.
+ * Throws if the payload is not a valid EvalBaseline shape.
+ */
+export declare function deserialiseBaseline(json: string): EvalBaseline;
+/**
+ * Write a baseline to a file path.
+ * Uses Bun.write for efficient file I/O.
+ */
+export declare function writeBaseline(filePath: string, baseline: EvalBaseline, projectRoot: string): Promise<void>;
+/**
+ * Load a baseline from a file path.
+ * Returns undefined if the file does not exist.
+ */
+export declare function loadBaseline(filePath: string, projectRoot: string): Promise<EvalBaseline | undefined>;
+/**
+ * Format a comparison summary between a baseline and a fresh suite result.
+ */
+export declare function formatBaselineComparison(baseline: EvalBaseline, fresh: EvalSuiteResult): string;
+//# sourceMappingURL=baseline.d.ts.map

package/dist/platform/runtime/eval/baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/eval/baseline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAwB,MAAM,YAAY,CAAC;AActF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,eAAe,EAAE,GAC9B,YAAY,CAmBd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAY9D;AAID;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhH;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAM3G;AAID;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,eAAe,GACrB,MAAM,CA6CR"}