@pellux/goodvibes-sdk 0.18.3 → 0.18.12

package/dist/_internal/platform/runtime/forensics/registry.d.ts

@@ -0,0 +1,89 @@
+/**
+ * ForensicsRegistry — in-memory store for FailureReport objects.
+ *
+ * Maintains a bounded circular buffer of reports (newest last), keyed by
+ * report ID for O(1) lookup. Supports `latest()`, `getById()`, raw report
+ * export, and incident bundle export for the /forensics command subcommands.
+ */
+import type { FailureReport, ForensicsBundle } from './types.js';
+export interface ReplaySnapshotInput {
+    readonly status: string;
+    readonly runId: string | null;
+    readonly currentRev: number;
+    readonly totalRevisions: number;
+    readonly mismatches: ReadonlyArray<{
+        readonly rev: number;
+        readonly kind: string;
+        readonly description: string;
+        readonly eventName?: string;
+        readonly ownerDomain?: string;
+        readonly failureMode?: string;
+        readonly relatedTurnId?: string;
+    }>;
+    readonly turnSummaries: ReadonlyArray<{
+        readonly turnId: string;
+        readonly outcome: 'completed' | 'failed' | 'cancelled';
+        readonly terminalEvent: 'PREFLIGHT_FAIL' | 'TURN_COMPLETED' | 'TURN_ERROR' | 'TURN_CANCEL';
+        readonly startedRev?: number;
+        readonly terminalRev: number;
+        readonly stopReason?: string;
+        readonly message?: string;
+    }>;
+}
+/** Default maximum number of failure reports retained in memory. */
+export declare const DEFAULT_REGISTRY_LIMIT = 100;
+export declare class ForensicsRegistry {
+    private readonly _reports;
+    private readonly _byId;
+    private readonly _limit;
+    private readonly _subscribers;
+    constructor(limit?: number);
+    /**
+     * Push a new failure report into the registry.
+     * If the buffer is full, the oldest entry is evicted.
+     */
+    push(report: FailureReport): void;
+    /**
+     * Return the most recently generated report, or undefined if none exist.
+     */
+    latest(): FailureReport | undefined;
+    /**
+     * Return a report by its short ID, or undefined if not found.
+     */
+    getById(id: string): FailureReport | undefined;
+    /**
+     * Return all reports, newest first.
+     */
+    getAll(): FailureReport[];
+    /**
+     * Return the count of retained reports.
+     */
+    count(): number;
+    /**
+     * Serialize a report to a pretty-printed JSON string.
+     * Returns undefined if the report ID is not found.
+     */
+    exportAsJson(id: string): string | undefined;
+    /**
+     * Build a richer incident bundle for export, including derived evidence and
+     * optional replay state when available.
+     */
+    buildBundle(id: string, options?: {
+        replaySnapshot?: ReplaySnapshotInput;
+    }): ForensicsBundle | undefined;
+    /**
+     * Serialize an incident bundle to pretty-printed JSON.
+     * Returns undefined if the report ID is not found.
+     */
+    exportBundleAsJson(id: string, options?: {
+        replaySnapshot?: ReplaySnapshotInput;
+    }): string | undefined;
+    /**
+     * Subscribe to registry changes. Returns an unsubscribe function.
+     */
+    subscribe(callback: () => void): () => void;
+    private _notify;
+    private _buildReplayEvidence;
+    private _countBy;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/_internal/platform/runtime/forensics/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/forensics/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAIhB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC,CAAC;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QACvD,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,YAAY,GAAG,aAAa,CAAC;QAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAEnC,KAAK,GAAE,MAA+B;IAIzD;;;OAGG;IACI,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAWxC;;OAEG;IACI,MAAM,IAAI,aAAa,GAAG,SAAS;IAI1C;;OAEG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIrD;;OAEG;IACI,MAAM,IAAI,aAAa,EAAE;IAIhC;;OAEG;IACI,KAAK,IAAI,MAAM;IAItB;;;OAGG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMnD;;;OAGG;IACI,WAAW,CAChB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,mBAAmB,CAAA;KAAO,GACrD,eAAe,GAAG,SAAS;IAmC9B;;;OAGG;IACI,kBAAkB,CACvB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,mBAAmB,CAAA;KAAO,GACrD,MAAM,GAAG,SAAS;IAMrB;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKlD,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,oBAAoB;IAqE5B,OAAO,CAAC,QAAQ;CAQjB"}

package/dist/_internal/platform/runtime/forensics/registry.js

@@ -0,0 +1,191 @@
+/** Default maximum number of failure reports retained in memory. */
+export const DEFAULT_REGISTRY_LIMIT = 100;
+export class ForensicsRegistry {
+    _reports = [];
+    _byId = new Map();
+    _limit;
+    _subscribers = new Set();
+    constructor(limit = DEFAULT_REGISTRY_LIMIT) {
+        this._limit = limit;
+    }
+    /**
+     * Push a new failure report into the registry.
+     * If the buffer is full, the oldest entry is evicted.
+     */
+    push(report) {
+        // Evict oldest if at capacity
+        if (this._reports.length >= this._limit) {
+            const evicted = this._reports.shift();
+            if (evicted)
+                this._byId.delete(evicted.id);
+        }
+        this._reports.push(report);
+        this._byId.set(report.id, report);
+        this._notify();
+    }
+    /**
+     * Return the most recently generated report, or undefined if none exist.
+     */
+    latest() {
+        return this._reports.at(-1);
+    }
+    /**
+     * Return a report by its short ID, or undefined if not found.
+     */
+    getById(id) {
+        return this._byId.get(id);
+    }
+    /**
+     * Return all reports, newest first.
+     */
+    getAll() {
+        return [...this._reports].reverse();
+    }
+    /**
+     * Return the count of retained reports.
+     */
+    count() {
+        return this._reports.length;
+    }
+    /**
+     * Serialize a report to a pretty-printed JSON string.
+     * Returns undefined if the report ID is not found.
+     */
+    exportAsJson(id) {
+        const report = this._byId.get(id);
+        if (!report)
+            return undefined;
+        return JSON.stringify(report, null, 2);
+    }
+    /**
+     * Build a richer incident bundle for export, including derived evidence and
+     * optional replay state when available.
+     */
+    buildBundle(id, options = {}) {
+        const report = this._byId.get(id);
+        if (!report)
+            return undefined;
+        const rootCause = report.causalChain.find((entry) => entry.isRootCause)?.description;
+        const terminalPhase = report.phaseLedger.at(-1);
+        return {
+            schemaVersion: 'v1',
+            exportedAt: Date.now(),
+            report,
+            evidence: {
+                rootCause,
+                terminalPhase: terminalPhase?.phase,
+                terminalOutcome: terminalPhase?.outcome,
+                phaseCount: report.phaseLedger.length,
+                causalCount: report.causalChain.length,
+                cascadeCount: report.cascadeEvents.length,
+                permissionDecisionCount: report.permissionEvidence.length,
+                deniedPermissionCount: report.permissionEvidence.filter((entry) => entry.approved === false).length,
+                budgetBreachCount: report.budgetBreaches.length,
+                slowPhases: report.phaseTimings
+                    .filter((phase) => (phase.durationMs ?? 0) >= 1_000)
+                    .map((phase) => phase.phase),
+                jumpLinkCount: report.jumpLinks.length,
+                relatedIds: {
+                    turnId: report.turnId,
+                    taskId: report.taskId,
+                    agentId: report.agentId,
+                },
+            },
+            replay: this._buildReplayEvidence(report, options.replaySnapshot),
+        };
+    }
+    /**
+     * Serialize an incident bundle to pretty-printed JSON.
+     * Returns undefined if the report ID is not found.
+     */
+    exportBundleAsJson(id, options = {}) {
+        const bundle = this.buildBundle(id, options);
+        if (!bundle)
+            return undefined;
+        return JSON.stringify(bundle, null, 2);
+    }
+    /**
+     * Subscribe to registry changes. Returns an unsubscribe function.
+     */
+    subscribe(callback) {
+        this._subscribers.add(callback);
+        return () => { this._subscribers.delete(callback); };
+    }
+    _notify() {
+        for (const cb of this._subscribers) {
+            try {
+                cb();
+            }
+            catch { /* non-fatal — subscriber errors must not affect the registry */ }
+        }
+    }
+    _buildReplayEvidence(report, snapshot) {
+        if (!snapshot) {
+            return {
+                status: 'unavailable',
+                mismatchCount: 0,
+                mismatches: [],
+                relatedMismatches: [],
+                mismatchBreakdown: { byKind: {}, byFailureMode: {}, byOwnerDomain: {} },
+                turnSummaries: [],
+            };
+        }
+        if (snapshot.status === 'idle' || !snapshot.runId) {
+            return {
+                status: 'not_loaded',
+                mismatchCount: 0,
+                mismatches: [],
+                relatedMismatches: [],
+                mismatchBreakdown: { byKind: {}, byFailureMode: {}, byOwnerDomain: {} },
+                turnSummaries: [],
+            };
+        }
+        const mismatches = snapshot.mismatches.map((mismatch) => ({
+            rev: mismatch.rev,
+            kind: mismatch.kind,
+            description: mismatch.description,
+            eventName: mismatch.eventName,
+            ownerDomain: mismatch.ownerDomain,
+            failureMode: mismatch.failureMode,
+            relatedTurnId: mismatch.relatedTurnId,
+        }));
+        const turnSummaries = snapshot.turnSummaries.map((summary) => ({
+            turnId: summary.turnId,
+            outcome: summary.outcome,
+            terminalEvent: summary.terminalEvent,
+            startedRev: summary.startedRev,
+            terminalRev: summary.terminalRev,
+            stopReason: summary.stopReason,
+            message: summary.message,
+        }));
+        const relatedMismatches = report.turnId
+            ? mismatches.filter((mismatch) => mismatch.relatedTurnId === report.turnId)
+            : [];
+        return {
+            status: 'available',
+            runId: snapshot.runId,
+            currentRev: snapshot.currentRev,
+            totalRevisions: snapshot.totalRevisions,
+            mismatchCount: mismatches.length,
+            mismatches,
+            relatedMismatches,
+            mismatchBreakdown: {
+                byKind: this._countBy(mismatches, (mismatch) => mismatch.kind),
+                byFailureMode: this._countBy(mismatches, (mismatch) => mismatch.failureMode ?? 'unknown'),
+                byOwnerDomain: this._countBy(mismatches, (mismatch) => mismatch.ownerDomain ?? 'unknown'),
+            },
+            turnSummaries,
+            matchingTurnSummary: report.turnId
+                ? turnSummaries.find((summary) => summary.turnId === report.turnId)
+                : undefined,
+        };
+    }
+    _countBy(items, key) {
+        const counts = {};
+        for (const item of items) {
+            const label = key(item);
+            counts[label] = (counts[label] ?? 0) + 1;
+        }
+        return counts;
+    }
+}

package/dist/_internal/platform/runtime/forensics/types.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Failure Forensics types — core data model for automatic failure reports.
+ *
+ * A FailureReport is generated automatically whenever a task or turn reaches
+ * a terminal failure state. It captures the causal chain derived from phase
+ * timings, cascade events, and stop reasons so failures can be classified
+ * without manual log spelunking.
+ */
+/**
+ * Broad failure category used as the primary classification label.
+ * Designed for machine-readable filtering and auto-triage.
+ */
+export type FailureClass = 'llm_error' | 'tool_failure' | 'permission_denied' | 'cascade_failure' | 'turn_timeout' | 'cancelled' | 'max_tokens' | 'compaction_error' | 'unknown';
+/**
+ * Timing record for a single named phase within a turn or task.
+ * Used to reconstruct execution timelines in the forensics panel.
+ */
+export interface PhaseTimingEntry {
+    /** Phase name (e.g. 'PREFLIGHT', 'STREAM', 'TOOL_BATCH', 'POST_HOOKS'). */
+    readonly phase: string;
+    /** Epoch ms when the phase started. */
+    readonly startedAt: number;
+    /** Epoch ms when the phase ended (undefined if still in progress at report time). */
+    readonly endedAt?: number;
+    /** Duration in ms (undefined if still in progress). */
+    readonly durationMs?: number;
+    /** Whether this phase completed successfully. */
+    readonly success: boolean;
+    /** Error message if the phase failed. */
+    readonly error?: string;
+}
+export type PhaseLedgerOutcome = 'in_progress' | 'succeeded' | 'failed' | 'cancelled';
+export interface PhaseLedgerEntry {
+    readonly seq: number;
+    readonly domain: 'turn' | 'task';
+    readonly phase: string;
+    readonly enterEventType: string;
+    readonly enteredAt: number;
+    readonly exitEventType?: string;
+    readonly exitedAt?: number;
+    readonly durationMs?: number;
+    readonly outcome: PhaseLedgerOutcome;
+    readonly error?: string;
+}
+/**
+ * A single link in the failure's causal chain.
+ * Ordered from root cause to terminal state.
+ */
+export interface CausalChainEntry {
+    /** Monotonic sequence within this report. */
+    readonly seq: number;
+    /** Epoch ms when this causal event occurred. */
+    readonly ts: number;
+    /** Human-readable description of this causal event. */
+    readonly description: string;
+    /** Event type that produced this link (from the event bus). */
+    readonly sourceEventType: string;
+    /** Optional structured context (tool name, error code, domain, etc.). */
+    readonly context?: Readonly<Record<string, string | number | boolean>>;
+    /** Whether this link is the diagnosed root cause. */
+    readonly isRootCause: boolean;
+}
+/**
+ * A navigable reference linking a forensics report to a related panel or action.
+ * Host surfaces render these as actionable jump targets.
+ */
+export interface ForensicsJumpLink {
+    /**
+     * Label displayed in the panel (e.g. 'Replay turn', 'Open health dashboard',
+     * 'View task in ops-control').
+     */
+    readonly label: string;
+    /**
+     * Destination kind determines how the consuming host navigates.
+     * - 'panel': open a named panel
+     * - 'command': execute a slash command
+     */
+    readonly kind: 'panel' | 'command';
+    /** Panel ID or slash command string (without leading slash). */
+    readonly target: string;
+    /** Optional arguments (e.g. task ID or turn ID to pre-select). */
+    readonly args?: string;
+}
+/**
+ * Complete failure forensics report.
+ * Generated automatically on terminal failure states.
+ */
+export interface FailureReport {
+    /** Unique report identifier (short hex, derived from trace ID). */
+    readonly id: string;
+    /** Full trace ID of the originating event envelope. */
+    readonly traceId: string;
+    /** Session ID where the failure occurred. */
+    readonly sessionId: string;
+    /** Epoch ms when the report was generated. */
+    readonly generatedAt: number;
+    /** Auto-classified failure category. */
+    readonly classification: FailureClass;
+    /** Human-readable summary of the failure for the panel header. */
+    readonly summary: string;
+    /** Stop reason from the LLM provider (if applicable). */
+    readonly stopReason?: string;
+    /** Terminal error message (most specific error available). */
+    readonly errorMessage?: string;
+    /** Task ID if this is a task failure. */
+    readonly taskId?: string;
+    /** Turn ID if this is a turn failure. */
+    readonly turnId?: string;
+    /** Agent ID if this failure was associated with a specific agent. */
+    readonly agentId?: string;
+    /** Ordered phase timings from the originating turn or task execution. */
+    readonly phaseTimings: readonly PhaseTimingEntry[];
+    /** Ordered phase transition ledger for explicit runtime reconstruction. */
+    readonly phaseLedger: readonly PhaseLedgerEntry[];
+    /** Causal chain from root cause to terminal state (root cause first). */
+    readonly causalChain: readonly CausalChainEntry[];
+    /** Cascade events that contributed to or were triggered by this failure. */
+    readonly cascadeEvents: readonly CausalChainEntry[];
+    /** Permission request and decision evidence correlated to this failure. */
+    readonly permissionEvidence: readonly PermissionEvidenceEntry[];
+    /** Tool budget and timeout breaches correlated to this failure. */
+    readonly budgetBreaches: readonly BudgetBreachEvidence[];
+    /** Jump links to replay and related diagnostics. */
+    readonly jumpLinks: readonly ForensicsJumpLink[];
+}
+export interface PermissionEvidenceEntry {
+    readonly callId: string;
+    readonly tool: string;
+    readonly requestedAt?: number;
+    readonly decidedAt?: number;
+    readonly durationMs?: number;
+    readonly approved?: boolean;
+    readonly source?: string;
+    readonly reasonCode?: string;
+    readonly classification?: string;
+    readonly riskLevel?: string;
+    readonly summary?: string;
+}
+export interface BudgetBreachEvidence {
+    readonly callId: string;
+    readonly tool: string;
+    readonly eventType: 'BUDGET_EXCEEDED_MS' | 'BUDGET_EXCEEDED_TOKENS' | 'BUDGET_EXCEEDED_COST';
+    readonly phase: string;
+    readonly ts: number;
+    readonly meta: Readonly<Record<string, number>>;
+}
+export interface ForensicsReplayMismatchEvidence {
+    readonly rev: number;
+    readonly kind: string;
+    readonly description: string;
+    readonly eventName?: string;
+    readonly ownerDomain?: string;
+    readonly failureMode?: string;
+    readonly relatedTurnId?: string;
+}
+export interface ForensicsReplayTurnEvidence {
+    readonly turnId: string;
+    readonly outcome: 'completed' | 'failed' | 'cancelled';
+    readonly terminalEvent: 'PREFLIGHT_FAIL' | 'TURN_COMPLETED' | 'TURN_ERROR' | 'TURN_CANCEL';
+    readonly startedRev?: number;
+    readonly terminalRev: number;
+    readonly stopReason?: string;
+    readonly message?: string;
+}
+export interface ForensicsReplayEvidence {
+    readonly status: 'unavailable' | 'not_loaded' | 'available';
+    readonly runId?: string;
+    readonly currentRev?: number;
+    readonly totalRevisions?: number;
+    readonly mismatchCount: number;
+    readonly mismatches: readonly ForensicsReplayMismatchEvidence[];
+    readonly relatedMismatches: readonly ForensicsReplayMismatchEvidence[];
+    readonly mismatchBreakdown: {
+        readonly byKind: Readonly<Record<string, number>>;
+        readonly byFailureMode: Readonly<Record<string, number>>;
+        readonly byOwnerDomain: Readonly<Record<string, number>>;
+    };
+    readonly turnSummaries: readonly ForensicsReplayTurnEvidence[];
+    readonly matchingTurnSummary?: ForensicsReplayTurnEvidence;
+}
+export interface ForensicsEvidenceSummary {
+    readonly rootCause?: string;
+    readonly terminalPhase?: string;
+    readonly terminalOutcome?: PhaseLedgerOutcome;
+    readonly phaseCount: number;
+    readonly causalCount: number;
+    readonly cascadeCount: number;
+    readonly permissionDecisionCount: number;
+    readonly deniedPermissionCount: number;
+    readonly budgetBreachCount: number;
+    readonly slowPhases: readonly string[];
+    readonly jumpLinkCount: number;
+    readonly relatedIds: {
+        readonly turnId?: string;
+        readonly taskId?: string;
+        readonly agentId?: string;
+    };
+}
+export interface ForensicsBundle {
+    readonly schemaVersion: 'v1';
+    readonly exportedAt: number;
+    readonly report: FailureReport;
+    readonly evidence: ForensicsEvidenceSummary;
+    readonly replay: ForensicsReplayEvidence;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/_internal/platform/runtime/forensics/types.d.ts.map

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

package/dist/_internal/platform/runtime/forensics/types.js

@@ -0,0 +1,9 @@
+/**
+ * Failure Forensics types — core data model for automatic failure reports.
+ *
+ * A FailureReport is generated automatically whenever a task or turn reaches
+ * a terminal failure state. It captures the causal chain derived from phase
+ * timings, cascade events, and stop reasons so failures can be classified
+ * without manual log spelunking.
+ */
+export {};

package/dist/_internal/platform/runtime/health/aggregator.d.ts

@@ -0,0 +1,57 @@
+/**
+ * RuntimeHealthAggregator — tracks health status for all runtime domains and
+ * derives composite system health. Consumers subscribe to health changes or
+ * query current health state.
+ */
+import type { HealthDomain, HealthStatus, DomainHealth, CompositeHealth } from './types.js';
+/**
+ * Tracks per-domain health and derives composite system health.
+ * All domains are initialized as 'unknown' at construction time.
+ * Subscribers are notified synchronously on any health change.
+ */
+export declare class RuntimeHealthAggregator {
+    private readonly domainHealth;
+    private readonly subscribers;
+    private readonly clock;
+    /**
+     * @param clock - Optional injectable clock function (default: Date.now).
+     *   Useful in tests to control time without real clock dependencies.
+     */
+    constructor(clock?: () => number);
+    /**
+     * Update a domain's health status and optionally override specific fields.
+     * Notifies all subscribers if the status actually changed.
+     */
+    updateDomainHealth(domain: HealthDomain, status: HealthStatus, details?: Partial<Omit<DomainHealth, 'domain' | 'status' | 'lastTransitionAt'>>): void;
+    /**
+     * Get the current health record for a specific domain.
+     * Always returns a record (domains are pre-initialized as 'unknown').
+     */
+    getDomainHealth(domain: HealthDomain): DomainHealth;
+    /**
+     * Get composite system health derived from all domain states.
+     * Overall: 'failed' if any domain failed, 'degraded' if any degraded, 'healthy' otherwise.
+     * Domains still 'unknown' do not contribute to 'degraded' or 'failed'.
+     */
+    getCompositeHealth(): CompositeHealth;
+    /**
+     * Check whether a domain is allowed to execute an operation.
+     * A domain is blocked if it is 'failed' or 'degraded' and the optional operation
+     * matches one of the degradedCapabilities for that domain.
+     */
+    canExecute(domain: HealthDomain, operation?: string): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * Subscribe to composite health changes.
+     * The callback is invoked synchronously after every domain health update.
+     * Returns an unsubscribe function.
+     */
+    subscribe(callback: (health: CompositeHealth) => void): () => void;
+    /** Derive overall health status from all domain states */
+    private deriveOverallHealth;
+    /** Notify all subscribers with current composite health */
+    private notifySubscribers;
+}
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/_internal/platform/runtime/health/aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/health/aggregator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAC;AA4BpB;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC;;;OAGG;gBACS,KAAK,GAAE,MAAM,MAAiB;IAiB1C;;;OAGG;IACH,kBAAkB,CAChB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,QAAQ,GAAG,kBAAkB,CAAC,CAAC,GAC9E,IAAI;IA8BP;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY;IAenD;;;;OAIG;IACH,kBAAkB,IAAI,eAAe;IAoBrC;;;;OAIG;IACH,UAAU,CACR,MAAM,EAAE,YAAY,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAuBxC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlE,0DAA0D;IAC1D,OAAO,CAAC,mBAAmB;IAe3B,2DAA2D;IAC3D,OAAO,CAAC,iBAAiB;CAM1B"}