@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/observability/subagentHealth.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Subagent Health Monitoring (GAP-SUBOBS-004).
+ *
+ * Monitors the liveness of delegated subagents via heartbeat tracking.
+ * Detects stale agents that have stopped reporting and surfaces health
+ * status for orchestration decision-making.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubagentHealthMonitor = void 0;
+const DEFAULT_STALE_THRESHOLD_MS = 60_000;
+/**
+ * Monitors subagent health via heartbeat registration and staleness checks.
+ */
+class SubagentHealthMonitor {
+    records = new Map();
+    staleThresholdMs;
+    constructor(options) {
+        this.staleThresholdMs = options?.staleThresholdMs ?? DEFAULT_STALE_THRESHOLD_MS;
+    }
+    /**
+     * Register a new subagent for health monitoring.
+     */
+    register(id) {
+        const now = new Date().toISOString();
+        const record = {
+            id,
+            status: "unknown",
+            lastHeartbeatAt: now,
+            registeredAt: now,
+            heartbeatCount: 0,
+        };
+        this.records.set(id, record);
+        return record;
+    }
+    /**
+     * Record a heartbeat from a subagent.
+     * Marks the agent as healthy if it was previously unknown or degraded.
+     */
+    heartbeat(id) {
+        const record = this.records.get(id);
+        if (!record)
+            return undefined;
+        record.lastHeartbeatAt = new Date().toISOString();
+        record.heartbeatCount += 1;
+        record.status = "healthy";
+        return record;
+    }
+    /**
+     * Check the health of a specific subagent at a given point in time.
+     * Updates the status based on elapsed time since last heartbeat.
+     */
+    checkHealth(id, now) {
+        const record = this.records.get(id);
+        if (!record)
+            return undefined;
+        const currentTime = now ?? Date.now();
+        const elapsed = currentTime - new Date(record.lastHeartbeatAt).getTime();
+        if (record.heartbeatCount === 0) {
+            record.status = "unknown";
+        }
+        else if (elapsed > this.staleThresholdMs) {
+            record.status = "stale";
+        }
+        else if (elapsed > this.staleThresholdMs / 2) {
+            record.status = "degraded";
+        }
+        else {
+            record.status = "healthy";
+        }
+        return record;
+    }
+    /**
+     * Get all subagents whose last heartbeat exceeds the stale threshold.
+     */
+    getStaleAgents(now) {
+        const currentTime = now ?? Date.now();
+        const stale = [];
+        for (const record of this.records.values()) {
+            const elapsed = currentTime - new Date(record.lastHeartbeatAt).getTime();
+            if (elapsed > this.staleThresholdMs && record.heartbeatCount > 0) {
+                record.status = "stale";
+                stale.push(record);
+            }
+        }
+        return stale;
+    }
+    /**
+     * Get a specific record by id.
+     */
+    get(id) {
+        return this.records.get(id);
+    }
+    /**
+     * Get all registered records.
+     */
+    getAll() {
+        return [...this.records.values()];
+    }
+    /**
+     * Unregister a subagent.
+     */
+    unregister(id) {
+        return this.records.delete(id);
+    }
+}
+exports.SubagentHealthMonitor = SubagentHealthMonitor;

package/dist/observability/subagentProgress.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Subagent Progress Tracking (GAP-SUBOBS-002).
+ *
+ * Tracks progress of delegated subagent tasks with status, timing,
+ * and token usage. Provides real-time visibility into what subagents
+ * are doing during orchestration.
+ */
+export type SubagentStatus = "pending" | "running" | "completed" | "failed";
+export interface SubagentProgressEntry {
+    /** Unique identifier for the subagent invocation. */
+    id: string;
+    /** Human-readable label or task description. */
+    label: string;
+    /** Current status. */
+    status: SubagentStatus;
+    /** When the subagent was started (ISO 8601). */
+    startedAt: string;
+    /** When the subagent completed or failed (ISO 8601), if finished. */
+    finishedAt: string | null;
+    /** Duration in milliseconds, or null if still running. */
+    durationMs: number | null;
+    /** Estimated tokens consumed so far. */
+    tokensUsed: number;
+    /** Optional progress message or detail. */
+    message?: string;
+}
+/**
+ * Tracks subagent progress for an orchestration session.
+ *
+ * Thread-safe for single-threaded Node.js event loop usage.
+ */
+export declare class SubagentProgressTracker {
+    private readonly entries;
+    /**
+     * Start tracking a new subagent invocation.
+     */
+    start(id: string, label: string): SubagentProgressEntry;
+    /**
+     * Update an existing subagent entry with partial data.
+     * Returns the updated entry, or undefined if the id is not found.
+     */
+    update(id: string, updates: Partial<Pick<SubagentProgressEntry, "status" | "tokensUsed" | "message">>): SubagentProgressEntry | undefined;
+    /**
+     * Get all tracked entries.
+     */
+    getAll(): SubagentProgressEntry[];
+    /**
+     * Get entries that are still running.
+     */
+    getActive(): SubagentProgressEntry[];
+    /**
+     * Get entries that have completed (successfully or with failure).
+     */
+    getCompleted(): SubagentProgressEntry[];
+    /**
+     * Get a specific entry by id.
+     */
+    get(id: string): SubagentProgressEntry | undefined;
+    /**
+     * Remove all tracked entries.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=subagentProgress.d.ts.map

package/dist/observability/subagentProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagentProgress.d.ts","sourceRoot":"","sources":["../../src/observability/subagentProgress.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IAEpE;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB;IAcvD;;;OAGG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC,GACjF,qBAAqB,GAAG,SAAS;IAqBpC;;OAEG;IACH,MAAM,IAAI,qBAAqB,EAAE;IAIjC;;OAEG;IACH,SAAS,IAAI,qBAAqB,EAAE;IAIpC;;OAEG;IACH,YAAY,IAAI,qBAAqB,EAAE;IAIvC;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAIlD;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/observability/subagentProgress.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Subagent Progress Tracking (GAP-SUBOBS-002).
+ *
+ * Tracks progress of delegated subagent tasks with status, timing,
+ * and token usage. Provides real-time visibility into what subagents
+ * are doing during orchestration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubagentProgressTracker = void 0;
+// ---------------------------------------------------------------------------
+// Tracker
+// ---------------------------------------------------------------------------
+/**
+ * Tracks subagent progress for an orchestration session.
+ *
+ * Thread-safe for single-threaded Node.js event loop usage.
+ */
+class SubagentProgressTracker {
+    entries = new Map();
+    /**
+     * Start tracking a new subagent invocation.
+     */
+    start(id, label) {
+        const entry = {
+            id,
+            label,
+            status: "running",
+            startedAt: new Date().toISOString(),
+            finishedAt: null,
+            durationMs: null,
+            tokensUsed: 0,
+        };
+        this.entries.set(id, entry);
+        return entry;
+    }
+    /**
+     * Update an existing subagent entry with partial data.
+     * Returns the updated entry, or undefined if the id is not found.
+     */
+    update(id, updates) {
+        const entry = this.entries.get(id);
+        if (!entry)
+            return undefined;
+        if (updates.status !== undefined) {
+            entry.status = updates.status;
+            if (updates.status === "completed" || updates.status === "failed") {
+                entry.finishedAt = new Date().toISOString();
+                entry.durationMs = new Date(entry.finishedAt).getTime() - new Date(entry.startedAt).getTime();
+            }
+        }
+        if (updates.tokensUsed !== undefined) {
+            entry.tokensUsed = updates.tokensUsed;
+        }
+        if (updates.message !== undefined) {
+            entry.message = updates.message;
+        }
+        return entry;
+    }
+    /**
+     * Get all tracked entries.
+     */
+    getAll() {
+        return [...this.entries.values()];
+    }
+    /**
+     * Get entries that are still running.
+     */
+    getActive() {
+        return this.getAll().filter((e) => e.status === "running" || e.status === "pending");
+    }
+    /**
+     * Get entries that have completed (successfully or with failure).
+     */
+    getCompleted() {
+        return this.getAll().filter((e) => e.status === "completed" || e.status === "failed");
+    }
+    /**
+     * Get a specific entry by id.
+     */
+    get(id) {
+        return this.entries.get(id);
+    }
+    /**
+     * Remove all tracked entries.
+     */
+    clear() {
+        this.entries.clear();
+    }
+}
+exports.SubagentProgressTracker = SubagentProgressTracker;

package/dist/observability/timeline.d.ts

@@ -0,0 +1,11 @@
+/**
+ * GAP-OBS-NEW-002: Phase Timeline Visualization.
+ *
+ * Synthesizes phase timeline data from journal events. Identifies planning,
+ * execution, verification, and completion phases with duration metrics.
+ */
+import { type JournalEvent } from "@a5c-ai/babysitter-sdk";
+import type { PhaseTimeline } from "./types";
+export declare function buildPhaseTimelineFromEvents(events: JournalEvent[]): PhaseTimeline;
+export declare function buildPhaseTimeline(runDir: string): Promise<PhaseTimeline>;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/observability/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/observability/timeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EACV,aAAa,EAKd,MAAM,SAAS,CAAC;AA2BjB,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,CA6HlF;AAoCD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAG/E"}

package/dist/observability/timeline.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * GAP-OBS-NEW-002: Phase Timeline Visualization.
+ *
+ * Synthesizes phase timeline data from journal events. Identifies planning,
+ * execution, verification, and completion phases with duration metrics.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPhaseTimelineFromEvents = buildPhaseTimelineFromEvents;
+exports.buildPhaseTimeline = buildPhaseTimeline;
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const VERIFICATION_TASK_IDS = new Set([
+    "typecheck",
+    "lint",
+    "run-tests",
+    "adversarial-review",
+]);
+function ms(a, b) {
+    return new Date(b).getTime() - new Date(a).getTime();
+}
+function makePhase(name, startedAt, endedAt) {
+    return {
+        name,
+        startedAt,
+        endedAt,
+        durationMs: endedAt ? ms(startedAt, endedAt) : null,
+    };
+}
+function isVerificationEvent(event) {
+    const taskId = event.data.taskId;
+    return taskId != null && VERIFICATION_TASK_IDS.has(taskId);
+}
+function buildPhaseTimelineFromEvents(events) {
+    if (events.length === 0) {
+        return {
+            phases: [],
+            milestones: [],
+            iterations: [],
+            currentPhase: "planning",
+            totalDurationMs: null,
+        };
+    }
+    const phases = [];
+    const milestones = [];
+    let currentPhase = "planning";
+    const firstEvent = events[0];
+    const lastEvent = events[events.length - 1];
+    // Find key transition points
+    const firstEffectReq = events.find((e) => e.type === "EFFECT_REQUESTED");
+    const runCompleted = events.find((e) => e.type === "RUN_COMPLETED");
+    const runFailed = events.find((e) => e.type === "RUN_FAILED");
+    // Find first verification event (typecheck/lint/test/review)
+    const firstVerificationReq = events.find((e) => e.type === "EFFECT_REQUESTED" && isVerificationEvent(e));
+    const lastVerificationResolved = [...events]
+        .reverse()
+        .find((e) => e.type === "EFFECT_RESOLVED" && isVerificationEvent(e));
+    // Phase 1: Planning — from RUN_CREATED to first EFFECT_REQUESTED
+    if (firstEvent.type === "RUN_CREATED") {
+        const planEnd = firstEffectReq?.recordedAt ?? null;
+        phases.push(makePhase("planning", firstEvent.recordedAt, planEnd));
+        if (planEnd) {
+            currentPhase = "execution";
+        }
+    }
+    // Phase 2: Execution — from first EFFECT_REQUESTED to verification start (or last resolved)
+    if (firstEffectReq) {
+        // Find the last non-verification EFFECT_RESOLVED as fallback execution end
+        const lastNonVerifResolved = [...events]
+            .reverse()
+            .find((e) => e.type === "EFFECT_RESOLVED" && !isVerificationEvent(e));
+        const execEnd = firstVerificationReq?.recordedAt
+            ?? runCompleted?.recordedAt
+            ?? runFailed?.recordedAt
+            ?? lastNonVerifResolved?.recordedAt
+            ?? null;
+        phases.push(makePhase("execution", firstEffectReq.recordedAt, execEnd));
+        currentPhase = execEnd ? (firstVerificationReq ? "verification" : "execution") : "execution";
+    }
+    // Phase 3: Verification — quality gates
+    if (firstVerificationReq) {
+        const verEnd = lastVerificationResolved?.recordedAt
+            ?? runCompleted?.recordedAt
+            ?? runFailed?.recordedAt
+            ?? null;
+        phases.push(makePhase("verification", firstVerificationReq.recordedAt, verEnd));
+        currentPhase = verEnd ? "completion" : "verification";
+    }
+    // Phase 4: Completion
+    if (runCompleted) {
+        phases.push(makePhase("completion", runCompleted.recordedAt, runCompleted.recordedAt));
+        currentPhase = "completed";
+    }
+    else if (runFailed) {
+        phases.push(makePhase("completion", runFailed.recordedAt, runFailed.recordedAt));
+        currentPhase = "failed";
+    }
+    // Extract milestones
+    for (const event of events) {
+        if (event.type === "EFFECT_RESOLVED" && event.data.kind === "breakpoint") {
+            milestones.push({
+                type: "breakpoint",
+                label: event.data.title ?? `Breakpoint ${event.data.effectId}`,
+                occurredAt: event.recordedAt,
+                data: event.data,
+            });
+        }
+        if (event.type === "EFFECT_RESOLVED" &&
+            (event.data.taskId === "adversarial-review")) {
+            milestones.push({
+                type: "quality-gate",
+                label: `Quality review: ${event.data.taskId}`,
+                occurredAt: event.recordedAt,
+                data: event.data,
+            });
+        }
+        if (event.type === "RUN_COMPLETED") {
+            milestones.push({
+                type: "run-completed",
+                label: "Run completed",
+                occurredAt: event.recordedAt,
+            });
+        }
+        if (event.type === "RUN_FAILED") {
+            milestones.push({
+                type: "run-failed",
+                label: "Run failed",
+                occurredAt: event.recordedAt,
+                data: event.data,
+            });
+        }
+    }
+    // Build iteration breakdowns
+    const iterations = buildIterations(events);
+    const totalDurationMs = events.length >= 2 ? ms(firstEvent.recordedAt, lastEvent.recordedAt) : null;
+    return {
+        phases,
+        milestones,
+        iterations,
+        currentPhase,
+        totalDurationMs,
+    };
+}
+function buildIterations(events) {
+    const iterationMap = new Map();
+    for (const event of events) {
+        const iter = event.data.iteration;
+        if (iter != null) {
+            let group = iterationMap.get(iter);
+            if (!group) {
+                group = [];
+                iterationMap.set(iter, group);
+            }
+            group.push(event);
+        }
+    }
+    const iterations = [];
+    for (const [iteration, iterEvents] of iterationMap) {
+        if (iterEvents.length === 0)
+            continue;
+        const first = iterEvents[0];
+        const last = iterEvents[iterEvents.length - 1];
+        const endedAt = last.type === "EFFECT_RESOLVED" ? last.recordedAt : null;
+        iterations.push({
+            iteration,
+            phases: [], // Per-iteration phase breakdown could be added later
+            startedAt: first.recordedAt,
+            endedAt,
+            durationMs: endedAt ? ms(first.recordedAt, endedAt) : null,
+        });
+    }
+    return iterations.sort((a, b) => a.iteration - b.iteration);
+}
+async function buildPhaseTimeline(runDir) {
+    const events = await (0, babysitter_sdk_1.loadJournal)(runDir);
+    return buildPhaseTimelineFromEvents(events);
+}

package/dist/observability/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Observability types.
+ *
+ * GAP-OBS-NEW-002: Phase Timeline types.
+ * GAP-STATE-008: Run Health Model types.
+ */
+export type RunHealthStatus = "healthy" | "degraded" | "stuck" | "failed";
+export interface RunHealthMetrics {
+    errorRate: number;
+    avgEffectLatencyMs: number;
+    pendingCount: number;
+    oldestPendingAgeMs: number;
+    iterationCount: number;
+    lastActivityAt: string | null;
+    totalEffects: number;
+    resolvedEffects: number;
+    failedEffects: number;
+}
+export interface RunHealthSnapshot {
+    status: RunHealthStatus;
+    metrics: RunHealthMetrics;
+    issues: string[];
+    computedAt: string;
+}
+export interface HealthConfig {
+    /** Threshold for detecting stuck runs (default: 300000ms = 5min). */
+    stuckThresholdMs: number;
+    /** Error rate above which run is 'degraded' (default: 0.3). */
+    degradedErrorRate: number;
+    /** Error rate above which run is 'failed' (default: 0.7). */
+    failedErrorRate: number;
+    /** Max age for pending effects before generating issue (default: 600000ms = 10min). */
+    maxPendingAge: number;
+}
+export type PhaseName = "planning" | "execution" | "verification" | "completion";
+export interface PhaseEntry {
+    name: PhaseName;
+    startedAt: string;
+    endedAt: string | null;
+    durationMs: number | null;
+}
+export interface Milestone {
+    type: "breakpoint" | "quality-gate" | "run-completed" | "run-failed";
+    label: string;
+    occurredAt: string;
+    data?: Record<string, unknown>;
+}
+export interface IterationTimeline {
+    iteration: number;
+    phases: PhaseEntry[];
+    startedAt: string;
+    endedAt: string | null;
+    durationMs: number | null;
+}
+export interface PhaseTimeline {
+    phases: PhaseEntry[];
+    milestones: Milestone[];
+    iterations: IterationTimeline[];
+    currentPhase: PhaseName | "completed" | "failed";
+    totalDurationMs: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/observability/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,YAAY,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACjD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}

package/dist/observability/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Observability types.
+ *
+ * GAP-OBS-NEW-002: Phase Timeline types.
+ * GAP-STATE-008: Run Health Model types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/observability/webhooks.d.ts

@@ -0,0 +1,68 @@
+/**
+ * GAP-OBS-NEW-001: Dashboard Webhook and Alert System.
+ *
+ * Webhook registration, event filtering, and alert evaluation
+ * for run health changes. Pure functions for registry management
+ * and alert level computation.
+ */
+import type { RunHealthSnapshot } from "./types";
+export type AlertLevel = "info" | "warn" | "critical";
+export type WebhookEventType = "run.health_changed" | "run.completed" | "run.failed" | "run.stuck" | "effect.pending_timeout";
+export interface WebhookRegistration {
+    id: string;
+    url: string;
+    events: WebhookEventType[];
+    runId?: string;
+    alertLevels?: AlertLevel[];
+    secret?: string;
+    createdAt: string;
+    enabled: boolean;
+}
+export interface WebhookEvent {
+    id: string;
+    type: WebhookEventType;
+    runId: string;
+    alertLevel: AlertLevel;
+    payload: Record<string, unknown>;
+    occurredAt: string;
+}
+export interface WebhookDeliveryResult {
+    webhookId: string;
+    success: boolean;
+    statusCode?: number;
+    error?: string;
+    deliveredAt: string;
+}
+export interface WebhookRegistry {
+    schemaVersion: string;
+    registrations: WebhookRegistration[];
+}
+export type WebhookRegistrationInput = Omit<WebhookRegistration, "id" | "createdAt">;
+export declare const WEBHOOK_SCHEMA_VERSION = "2026.01.webhooks-v1";
+/**
+ * Register a new webhook in the registry.
+ * Mutates the registry and returns the created registration.
+ */
+export declare function registerWebhook(registry: WebhookRegistry, input: WebhookRegistrationInput): WebhookRegistration;
+/**
+ * Remove a webhook by id. Throws if not found.
+ */
+export declare function unregisterWebhook(registry: WebhookRegistry, id: string): void;
+/**
+ * List webhooks, optionally filtered by runId.
+ */
+export declare function listWebhooks(registry: WebhookRegistry, runId?: string): WebhookRegistration[];
+/**
+ * Build a webhook event from a health snapshot.
+ */
+export declare function buildWebhookEvent(type: WebhookEventType, runId: string, snapshot: RunHealthSnapshot): WebhookEvent;
+/**
+ * Evaluate whether a health transition warrants an alert.
+ * Returns the alert level, or null if no alert is needed.
+ */
+export declare function evaluateAlertLevel(prev: RunHealthSnapshot | null, next: RunHealthSnapshot): AlertLevel | null;
+/**
+ * Filter registrations for a given event type and optional alert level.
+ */
+export declare function filterRegistrations(registrations: WebhookRegistration[], eventType: WebhookEventType, alertLevel?: AlertLevel): WebhookRegistration[];
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/observability/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/observability/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,SAAS,CAAC;AAMlE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GACxB,oBAAoB,GACpB,eAAe,GACf,YAAY,GACZ,WAAW,GACX,wBAAwB,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,mBAAmB,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC;AAMrF,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AA0B5D;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CAQrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EACzB,EAAE,EAAE,MAAM,GACT,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,eAAe,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,mBAAmB,EAAE,CAGvB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,iBAAiB,GAC1B,YAAY,CAad;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,GAAG,IAAI,EAC9B,IAAI,EAAE,iBAAiB,GACtB,UAAU,GAAG,IAAI,CAgBnB;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,mBAAmB,EAAE,EACpC,SAAS,EAAE,gBAAgB,EAC3B,UAAU,CAAC,EAAE,UAAU,GACtB,mBAAmB,EAAE,CASvB"}