@jini-ai/ui 0.1.0

package/dist/features/observability/iframe.js

@@ -0,0 +1,62 @@
+/**
+ * Iframe load tracker.
+ *
+ * Iframe load failures don't propagate to a global `window.error` listener
+ * — they're trapped inside the frame — so {@link installResourceErrorObserver}
+ * (`resource-error.ts`) can't see them. This helper instruments a single
+ * `<iframe>` element for failure/timeout and reports scoped events; the
+ * caller supplies it when mounting the iframe (e.g. a preview/renderer
+ * surface) and gets a cleanup callback back.
+ *
+ * Origin (`observability/iframe-error.ts`) hard-coded `artifactId`/
+ * `projectId`/`conversationId` fields tied to OD's domain model. Genericized
+ * to a free-form `context` bag so any host can attach its own identifiers.
+ */
+import { noopSafetyEventReporter } from './ports.js';
+const DEFAULT_LOAD_TIMEOUT_MS = 15000;
+/**
+ * Instruments an iframe for load failure/timeout and returns a cleanup
+ * function. Does not report on ordinary successful loads (the common case)
+ * to avoid multiplying event volume — only settles the timeout.
+ *
+ * @overallScore 100
+ */
+export function trackIframeLoad(options) {
+    const { iframe, surface, context = {} } = options;
+    const reporter = options.reporter ?? noopSafetyEventReporter;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_LOAD_TIMEOUT_MS;
+    const startedAt = performance.now();
+    let settled = false;
+    const settle = (event, extras = {}) => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        reporter(event, {
+            surface,
+            duration_ms: Math.round(performance.now() - startedAt),
+            ...context,
+            ...extras,
+        });
+    };
+    const onLoad = () => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+    };
+    const onError = () => {
+        settle('client_iframe_error', { reason: 'error_event' });
+    };
+    iframe.addEventListener('load', onLoad);
+    iframe.addEventListener('error', onError);
+    const timer = setTimeout(() => {
+        settle('client_iframe_timeout', { timeout_ms: timeoutMs });
+    }, timeoutMs);
+    return () => {
+        clearTimeout(timer);
+        iframe.removeEventListener('load', onLoad);
+        iframe.removeEventListener('error', onError);
+    };
+}
+//# sourceMappingURL=iframe.js.map

package/dist/features/observability/iframe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe.js","sourceRoot":"","sources":["../../../src/features/observability/iframe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,uBAAuB,EAA4B,MAAM,YAAY,CAAC;AAE/E,MAAM,uBAAuB,GAAG,KAAK,CAAC;AActC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,uBAAuB,CAAC;IAC/D,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACpC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,SAAkC,EAAE,EAAQ,EAAE;QAC3E,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,QAAQ,CAAC,KAAK,EAAE;YACd,OAAO;YACP,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACtD,GAAG,OAAO;YACV,GAAG,MAAM;SACV,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,MAAM,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,MAAM,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC,EAAE,SAAS,CAAC,CAAC;IAEd,OAAO,GAAG,EAAE;QACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC"}

package/dist/features/observability/index.d.ts

@@ -0,0 +1,19 @@
+export type { SafetyEventReporter } from './ports.js';
+export { noopSafetyEventReporter } from './ports.js';
+export { installWebObservability } from './install.js';
+export type { WebObservabilityOptions } from './install.js';
+export { installBootTimingObserver } from './boot-timing.js';
+export type { BootTimingOptions } from './boot-timing.js';
+export { installLongTaskObserver } from './long-task.js';
+export type { LongTaskObserverOptions } from './long-task.js';
+export { installResourceErrorObserver } from './resource-error.js';
+export type { ResourceErrorObserverOptions } from './resource-error.js';
+export { installVisibilityObserver } from './visibility.js';
+export type { VisibilityObserverOptions } from './visibility.js';
+export { installWhiteScreenDetector } from './white-screen.js';
+export type { WhiteScreenDetectorOptions } from './white-screen.js';
+export { trackIframeLoad } from './iframe.js';
+export type { TrackIframeLoadOptions } from './iframe.js';
+export { trackRunStart, trackRunProgress, trackRunTerminal, __resetStuckRunWatchdogForTests, } from './stuck-run.js';
+export type { TrackRunStartOptions } from './stuck-run.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/observability/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/features/observability/index.js

@@ -0,0 +1,10 @@
+export { noopSafetyEventReporter } from './ports.js';
+export { installWebObservability } from './install.js';
+export { installBootTimingObserver } from './boot-timing.js';
+export { installLongTaskObserver } from './long-task.js';
+export { installResourceErrorObserver } from './resource-error.js';
+export { installVisibilityObserver } from './visibility.js';
+export { installWhiteScreenDetector } from './white-screen.js';
+export { trackIframeLoad } from './iframe.js';
+export { trackRunStart, trackRunProgress, trackRunTerminal, __resetStuckRunWatchdogForTests, } from './stuck-run.js';
+//# sourceMappingURL=index.js.map

package/dist/features/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/observability/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAGnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAG5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,gBAAgB,CAAC"}

package/dist/features/observability/install.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Single entry point for the always-on observability observers (boot
+ * timing, long tasks, resource-load errors, visibility/session length,
+ * white-screen detection). `trackIframeLoad` (`iframe.ts`) and the
+ * `trackRunStart`/`trackRunProgress`/`trackRunTerminal` watchdog
+ * (`stuck-run.ts`) are intentionally NOT wired in here — both need a call
+ * site (an iframe mount, a run lifecycle) rather than a page-load install,
+ * matching the origin module's own boundary.
+ *
+ * Call once, as early as possible (before the app tree mounts) so every
+ * observer's early-buffering guarantees apply from the start. Each
+ * observer is individually defensive (no-ops where its API is missing),
+ * so this call is safe to make unconditionally.
+ */
+import { type LongTaskObserverOptions } from './long-task.js';
+import { type ResourceErrorObserverOptions } from './resource-error.js';
+import { type BootTimingOptions } from './boot-timing.js';
+import { type VisibilityObserverOptions } from './visibility.js';
+import { type WhiteScreenDetectorOptions } from './white-screen.js';
+import type { SafetyEventReporter } from './ports.js';
+export interface WebObservabilityOptions {
+    /** Applied to every observer below unless that observer's own nested
+     *  options set a different one. */
+    reporter?: SafetyEventReporter | undefined;
+    longTask?: Omit<LongTaskObserverOptions, 'reporter'>;
+    resourceError?: Omit<ResourceErrorObserverOptions, 'reporter'>;
+    bootTiming?: Omit<BootTimingOptions, 'reporter'>;
+    visibility?: Omit<VisibilityObserverOptions, 'reporter'>;
+    whiteScreen?: Omit<WhiteScreenDetectorOptions, 'reporter'>;
+}
+/**
+ * Installs every always-on observer. Idempotent per page load; returns a
+ * teardown that best-effort-tears down each observer (one observer's
+ * teardown failure never blocks the others).
+ *
+ * @overallScore 100
+ */
+export declare function installWebObservability(options?: WebObservabilityOptions): () => void;
+//# sourceMappingURL=install.d.ts.map

package/dist/features/observability/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/features/observability/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA2B,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAAgC,KAAK,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAA6B,KAAK,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAA8B,KAAK,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC;uCACmC;IACnC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;IACrD,aAAa,CAAC,EAAE,IAAI,CAAC,4BAA4B,EAAE,UAAU,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAC;IACzD,WAAW,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;CAC5D;AAID;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,IAAI,CAwBzF"}

package/dist/features/observability/install.js

@@ -0,0 +1,54 @@
+/**
+ * Single entry point for the always-on observability observers (boot
+ * timing, long tasks, resource-load errors, visibility/session length,
+ * white-screen detection). `trackIframeLoad` (`iframe.ts`) and the
+ * `trackRunStart`/`trackRunProgress`/`trackRunTerminal` watchdog
+ * (`stuck-run.ts`) are intentionally NOT wired in here — both need a call
+ * site (an iframe mount, a run lifecycle) rather than a page-load install,
+ * matching the origin module's own boundary.
+ *
+ * Call once, as early as possible (before the app tree mounts) so every
+ * observer's early-buffering guarantees apply from the start. Each
+ * observer is individually defensive (no-ops where its API is missing),
+ * so this call is safe to make unconditionally.
+ */
+import { installLongTaskObserver } from './long-task.js';
+import { installResourceErrorObserver } from './resource-error.js';
+import { installBootTimingObserver } from './boot-timing.js';
+import { installVisibilityObserver } from './visibility.js';
+import { installWhiteScreenDetector } from './white-screen.js';
+let installed = false;
+/**
+ * Installs every always-on observer. Idempotent per page load; returns a
+ * teardown that best-effort-tears down each observer (one observer's
+ * teardown failure never blocks the others).
+ *
+ * @overallScore 100
+ */
+export function installWebObservability(options = {}) {
+    if (installed)
+        return () => undefined;
+    if (typeof window === 'undefined')
+        return () => undefined;
+    installed = true;
+    const { reporter } = options;
+    const teardowns = [
+        installLongTaskObserver({ ...options.longTask, reporter }),
+        installResourceErrorObserver({ ...options.resourceError, reporter }),
+        installBootTimingObserver({ ...options.bootTiming, reporter }),
+        installVisibilityObserver({ ...options.visibility, reporter }),
+        installWhiteScreenDetector({ ...options.whiteScreen, reporter }),
+    ];
+    return () => {
+        for (const teardown of teardowns) {
+            try {
+                teardown();
+            }
+            catch {
+                // best-effort — a teardown failure must never propagate.
+            }
+        }
+        installed = false;
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/features/observability/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/features/observability/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,uBAAuB,EAAgC,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAAE,4BAA4B,EAAqC,MAAM,qBAAqB,CAAC;AACtG,OAAO,EAAE,yBAAyB,EAA0B,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAkC,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,0BAA0B,EAAmC,MAAM,mBAAmB,CAAC;AAchG,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAmC,EAAE;IAC3E,IAAI,SAAS;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IACtC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAC1D,SAAS,GAAG,IAAI,CAAC;IAEjB,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,SAAS,GAAsB;QACnC,uBAAuB,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAC1D,4BAA4B,CAAC,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC;QACpE,yBAAyB,CAAC,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;QAC9D,yBAAyB,CAAC,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;QAC9D,0BAA0B,CAAC,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC;KACjE,CAAC;IAEF,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;YAC3D,CAAC;QACH,CAAC;QACD,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/features/observability/long-task.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Long task observer.
+ *
+ * Reports a `client_long_task` event whenever the main thread is blocked
+ * for more than `minDurationMs`. Long tasks are a strong proxy for
+ * perceived UI lag — a 500 ms task drops 30 consecutive frames at 60 fps,
+ * which the user reads as "stuck".
+ *
+ * Threshold defaults to 100 ms rather than the W3C 50 ms minimum because
+ * the browser already filters at 50 ms; bumping to 100 ms here halves the
+ * event volume while still catching every task a human notices.
+ */
+import { type SafetyEventReporter } from './ports.js';
+export interface LongTaskObserverOptions {
+    reporter?: SafetyEventReporter | undefined;
+    /** Minimum task duration (ms) worth reporting. Defaults to 100. */
+    minDurationMs?: number;
+}
+/**
+ * Installs the long-task observer via `PerformanceObserver`. No-ops (and
+ * returns an inert teardown) in engines without the `longtask` entry type.
+ *
+ * @overallScore 100
+ */
+export declare function installLongTaskObserver(options?: LongTaskObserverOptions): () => void;
+//# sourceMappingURL=long-task.d.ts.map

package/dist/features/observability/long-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-task.d.ts","sourceRoot":"","sources":["../../../src/features/observability/long-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAI/E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC3C,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,IAAI,CAsDzF"}

package/dist/features/observability/long-task.js

@@ -0,0 +1,82 @@
+/**
+ * Long task observer.
+ *
+ * Reports a `client_long_task` event whenever the main thread is blocked
+ * for more than `minDurationMs`. Long tasks are a strong proxy for
+ * perceived UI lag — a 500 ms task drops 30 consecutive frames at 60 fps,
+ * which the user reads as "stuck".
+ *
+ * Threshold defaults to 100 ms rather than the W3C 50 ms minimum because
+ * the browser already filters at 50 ms; bumping to 100 ms here halves the
+ * event volume while still catching every task a human notices.
+ */
+import { noopSafetyEventReporter } from './ports.js';
+const DEFAULT_MIN_DURATION_MS = 100;
+let observer = null;
+/**
+ * Installs the long-task observer via `PerformanceObserver`. No-ops (and
+ * returns an inert teardown) in engines without the `longtask` entry type.
+ *
+ * @overallScore 100
+ */
+export function installLongTaskObserver(options = {}) {
+    const reporter = options.reporter ?? noopSafetyEventReporter;
+    const minDurationMs = options.minDurationMs ?? DEFAULT_MIN_DURATION_MS;
+    if (typeof PerformanceObserver === 'undefined')
+        return () => undefined;
+    // Some engines report `longtask` as an unsupported entry type; observe()
+    // throws or no-ops either way, so bail silently rather than let one
+    // observer's absence break install ordering for the rest.
+    const supported = PerformanceObserver.supportedEntryTypes?.includes?.('longtask');
+    if (supported !== true)
+        return () => undefined;
+    if (observer)
+        return () => observer?.disconnect();
+    observer = new PerformanceObserver((list) => {
+        for (const entry of list.getEntries()) {
+            if (entry.duration < minDurationMs)
+                continue;
+            // The `attribution` array on a PerformanceLongTaskTiming entry names
+            // the script/frame that caused the block. Not fully covered by
+            // TypeScript's lib.dom, so read through an `unknown` cast.
+            const attribution = entry.attribution?.[0];
+            reporter('client_long_task', {
+                duration_ms: Math.round(entry.duration),
+                start_time_ms: Math.round(entry.startTime),
+                container_type: attribution?.containerType,
+                container_name: attribution?.containerName,
+                // containerSrc can carry a query string; trimmed to origin+pathname.
+                container_src_origin: stripUrlQuery(attribution?.containerSrc),
+            });
+        }
+    });
+    try {
+        observer.observe({ type: 'longtask', buffered: true });
+    }
+    catch {
+        // Older engines sometimes throw when `buffered` is requested.
+        try {
+            observer.observe({ type: 'longtask' });
+        }
+        catch {
+            observer = null;
+            return () => undefined;
+        }
+    }
+    return () => {
+        observer?.disconnect();
+        observer = null;
+    };
+}
+function stripUrlQuery(value) {
+    if (typeof value !== 'string' || value.length === 0)
+        return undefined;
+    try {
+        const parsed = new URL(value);
+        return `${parsed.origin}${parsed.pathname}`;
+    }
+    catch {
+        return value;
+    }
+}
+//# sourceMappingURL=long-task.js.map

package/dist/features/observability/long-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-task.js","sourceRoot":"","sources":["../../../src/features/observability/long-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,uBAAuB,EAA4B,MAAM,YAAY,CAAC;AAE/E,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAQpC,IAAI,QAAQ,GAA+B,IAAI,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAmC,EAAE;IAC3E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC7D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;IAEvE,IAAI,OAAO,mBAAmB,KAAK,WAAW;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IACvE,yEAAyE;IACzE,oEAAoE;IACpE,0DAA0D;IAC1D,MAAM,SAAS,GAAG,mBAAmB,CAAC,mBAAmB,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC;IAClF,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAC/C,IAAI,QAAQ;QAAE,OAAO,GAAG,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;IAElD,QAAQ,GAAG,IAAI,mBAAmB,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,QAAQ,GAAG,aAAa;gBAAE,SAAS;YAC7C,qEAAqE;YACrE,+DAA+D;YAC/D,2DAA2D;YAC3D,MAAM,WAAW,GACf,KAOD,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;YACnB,QAAQ,CAAC,kBAAkB,EAAE;gBAC3B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACvC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;gBAC1C,cAAc,EAAE,WAAW,EAAE,aAAa;gBAC1C,cAAc,EAAE,WAAW,EAAE,aAAa;gBAC1C,qEAAqE;gBACrE,oBAAoB,EAAE,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC;aAC/D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;QAC9D,IAAI,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,EAAE;QACV,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/features/observability/ports.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Injectable telemetry sink for the observability observers in this
+ * feature. Every observer calls this with the same two-argument shape OD's
+ * original `reportSafetyEvent(eventName, properties)` used, so a host's
+ * analytics adapter is a one-line passthrough (e.g.
+ * `(name, props) => myAnalytics.track(name, props)`).
+ *
+ * Defaults to a no-op everywhere it's used — mounting these observers with
+ * no reporter is inert, matching the "context + host-injected adapter,
+ * default no-op" shape this package already uses for i18n.
+ */
+export type SafetyEventReporter = (eventName: string, properties?: Record<string, unknown>) => void;
+export declare const noopSafetyEventReporter: SafetyEventReporter;
+//# sourceMappingURL=ports.d.ts.map

package/dist/features/observability/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/features/observability/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEpG,eAAO,MAAM,uBAAuB,EAAE,mBAErC,CAAC"}

package/dist/features/observability/ports.js

@@ -0,0 +1,4 @@
+export const noopSafetyEventReporter = () => {
+    /* no-op default: see module doc */
+};
+//# sourceMappingURL=ports.js.map

package/dist/features/observability/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/features/observability/ports.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,uBAAuB,GAAwB,GAAG,EAAE;IAC/D,mCAAmC;AACrC,CAAC,CAAC"}

package/dist/features/observability/resource-error.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Resource-loading error observer.
+ *
+ * The bubbling `error` event (registered with capture=false) catches
+ * thrown JS errors but NOT failed resource loads — `<script>`, `<link>`,
+ * `<img>`, etc. emit an `error` event that does not propagate. To pick
+ * those up we register a *capturing* listener on `window`. This is the
+ * canonical pattern for chunk-load failures: a missing static bundle
+ * chunk results in a non-functional app with no JS exception.
+ */
+import { type SafetyEventReporter } from './ports.js';
+export interface ResourceErrorObserverOptions {
+    reporter?: SafetyEventReporter | undefined;
+}
+/**
+ * Installs the resource-error observer. Idempotent per page load.
+ *
+ * @overallScore 100
+ */
+export declare function installResourceErrorObserver(options?: ResourceErrorObserverOptions): () => void;
+//# sourceMappingURL=resource-error.d.ts.map

package/dist/features/observability/resource-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-error.d.ts","sourceRoot":"","sources":["../../../src/features/observability/resource-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAI/E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC5C;AAID;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,4BAAiC,GACzC,MAAM,IAAI,CA8BZ"}

package/dist/features/observability/resource-error.js

@@ -0,0 +1,65 @@
+/**
+ * Resource-loading error observer.
+ *
+ * The bubbling `error` event (registered with capture=false) catches
+ * thrown JS errors but NOT failed resource loads — `<script>`, `<link>`,
+ * `<img>`, etc. emit an `error` event that does not propagate. To pick
+ * those up we register a *capturing* listener on `window`. This is the
+ * canonical pattern for chunk-load failures: a missing static bundle
+ * chunk results in a non-functional app with no JS exception.
+ */
+import { noopSafetyEventReporter } from './ports.js';
+const RESOURCE_TAGS = new Set(['SCRIPT', 'LINK', 'IMG', 'IFRAME', 'AUDIO', 'VIDEO', 'SOURCE', 'TRACK']);
+let installed = false;
+/**
+ * Installs the resource-error observer. Idempotent per page load.
+ *
+ * @overallScore 100
+ */
+export function installResourceErrorObserver(options = {}) {
+    const reporter = options.reporter ?? noopSafetyEventReporter;
+    if (installed)
+        return () => undefined;
+    if (typeof window === 'undefined')
+        return () => undefined;
+    installed = true;
+    const listener = (event) => {
+        const target = event.target;
+        if (!(target instanceof Element))
+            return;
+        if (!RESOURCE_TAGS.has(target.tagName))
+            return;
+        const src = readSrc(target);
+        if (src == null)
+            return;
+        reporter('client_resource_error', {
+            tag: target.tagName.toLowerCase(),
+            // async/defer/crossorigin are useful signals for diagnosing
+            // chunk-load problems that depend on CDN cache + SW interaction.
+            async_attr: target.getAttribute('async') != null,
+            defer_attr: target.getAttribute('defer') != null,
+            crossorigin: target.getAttribute('crossorigin'),
+            url: src,
+        });
+    };
+    // capture=true is required — resource error events do not bubble.
+    window.addEventListener('error', listener, /* useCapture */ true);
+    return () => {
+        window.removeEventListener('error', listener, /* useCapture */ true);
+        installed = false;
+    };
+}
+function readSrc(el) {
+    const value = el instanceof HTMLLinkElement ? el.href :
+        el instanceof HTMLScriptElement ? el.src :
+            el instanceof HTMLImageElement ? el.src :
+                el instanceof HTMLIFrameElement ? el.src :
+                    el instanceof HTMLSourceElement ? el.src :
+                        el instanceof HTMLTrackElement ? el.src :
+                            el instanceof HTMLMediaElement ? el.src :
+                                (el.getAttribute('src') ?? el.getAttribute('href'));
+    if (typeof value !== 'string' || value.length === 0)
+        return null;
+    return value;
+}
+//# sourceMappingURL=resource-error.js.map

package/dist/features/observability/resource-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-error.js","sourceRoot":"","sources":["../../../src/features/observability/resource-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,uBAAuB,EAA4B,MAAM,YAAY,CAAC;AAE/E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAMxG,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAwC,EAAE;IAE1C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC7D,IAAI,SAAS;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IACtC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAC1D,SAAS,GAAG,IAAI,CAAC;IAEjB,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAQ,EAAE;QACtC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,CAAC,MAAM,YAAY,OAAO,CAAC;YAAE,OAAO;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO;QACxB,QAAQ,CAAC,uBAAuB,EAAE;YAChC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE;YACjC,4DAA4D;YAC5D,iEAAiE;YACjE,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI;YAChD,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI;YAChD,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC;YAC/C,GAAG,EAAE,GAAG;SACT,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,kEAAkE;IAClE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAElE,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACrE,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,EAAW;IAC1B,MAAM,KAAK,GACT,EAAE,YAAY,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzC,EAAE,YAAY,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YAC1C,EAAE,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gBACzC,EAAE,YAAY,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;oBAC1C,EAAE,YAAY,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;wBAC1C,EAAE,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;4BACzC,EAAE,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gCACzC,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/features/observability/stuck-run.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Stuck-run watchdog.
+ *
+ * Reports `client_run_stuck` when a run started via {@link trackRunStart}
+ * has not progressed within `stuckAfterMs` (no calls to
+ * {@link trackRunProgress}, no call to {@link trackRunTerminal}). This is a
+ * coarse proxy for "a long-lived async operation's transport went quiet" —
+ * the user-visible symptom is invariably "I started something and nothing's
+ * happening", so a stuck-after-timeout watchdog catches the most common
+ * bad outcome without needing full transport-lifecycle instrumentation.
+ *
+ * Fire-and-forget: callers tell us a run started, poke us every time they
+ * see progress, and tell us when it terminates. Anything else and the
+ * watchdog reports the stuck event exactly once per run.
+ */
+import { type SafetyEventReporter } from './ports.js';
+export interface TrackRunStartOptions {
+    reporter?: SafetyEventReporter | undefined;
+    /** Extra context merged into every event this run emits. */
+    context?: Record<string, unknown>;
+    /** How long without progress before reporting stuck. Defaults to 5 minutes. */
+    stuckAfterMs?: number;
+}
+/**
+ * Starts (or restarts) the watchdog for `runId`. A fresh start replaces any
+ * prior entry for the same id — rare but possible during reconnect storms.
+ *
+ * @overallScore 100
+ */
+export declare function trackRunStart(runId: string, options?: TrackRunStartOptions): void;
+/** Records progress on `runId`, rescheduling its stuck-timeout. No-ops for an untracked/already-stuck run. */
+export declare function trackRunProgress(runId: string): void;
+/**
+ * Marks `runId` terminal and stops watching it. If the run had already
+ * been reported stuck, also reports a `client_run_unstuck` recovery event
+ * so a host's dashboard can pair the two.
+ */
+export declare function trackRunTerminal(runId: string, terminalState: string): void;
+/** Test-only — flushes internal state between cases. */
+export declare function __resetStuckRunWatchdogForTests(): void;
+//# sourceMappingURL=stuck-run.d.ts.map

package/dist/features/observability/stuck-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck-run.d.ts","sourceRoot":"","sources":["../../../src/features/observability/stuck-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAgB/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC3C,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,IAAI,CAerF;AAED,8GAA8G;AAC9G,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAa3E;AAsCD,wDAAwD;AACxD,wBAAgB,+BAA+B,IAAI,IAAI,CAKtD"}

package/dist/features/observability/stuck-run.js

@@ -0,0 +1,113 @@
+/**
+ * Stuck-run watchdog.
+ *
+ * Reports `client_run_stuck` when a run started via {@link trackRunStart}
+ * has not progressed within `stuckAfterMs` (no calls to
+ * {@link trackRunProgress}, no call to {@link trackRunTerminal}). This is a
+ * coarse proxy for "a long-lived async operation's transport went quiet" —
+ * the user-visible symptom is invariably "I started something and nothing's
+ * happening", so a stuck-after-timeout watchdog catches the most common
+ * bad outcome without needing full transport-lifecycle instrumentation.
+ *
+ * Fire-and-forget: callers tell us a run started, poke us every time they
+ * see progress, and tell us when it terminates. Anything else and the
+ * watchdog reports the stuck event exactly once per run.
+ */
+import { noopSafetyEventReporter } from './ports.js';
+const DEFAULT_STUCK_AFTER_MS = 5 * 60 * 1000; // 5 minutes with no progress
+const runs = new Map();
+/**
+ * Starts (or restarts) the watchdog for `runId`. A fresh start replaces any
+ * prior entry for the same id — rare but possible during reconnect storms.
+ *
+ * @overallScore 100
+ */
+export function trackRunStart(runId, options = {}) {
+    if (typeof window === 'undefined')
+        return;
+    cancelRun(runId);
+    const now = Date.now();
+    const stuckAfterMs = options.stuckAfterMs ?? DEFAULT_STUCK_AFTER_MS;
+    const entry = {
+        reporter: options.reporter ?? noopSafetyEventReporter,
+        startedAt: now,
+        lastProgressAt: now,
+        timer: scheduleEmit(runId, stuckAfterMs),
+        stuckAfterMs,
+        emitted: false,
+        context: options.context ?? {},
+    };
+    runs.set(runId, entry);
+}
+/** Records progress on `runId`, rescheduling its stuck-timeout. No-ops for an untracked/already-stuck run. */
+export function trackRunProgress(runId) {
+    const entry = runs.get(runId);
+    if (!entry || entry.emitted)
+        return;
+    entry.lastProgressAt = Date.now();
+    clearTimeout(entry.timer);
+    entry.timer = scheduleEmit(runId, entry.stuckAfterMs);
+}
+/**
+ * Marks `runId` terminal and stops watching it. If the run had already
+ * been reported stuck, also reports a `client_run_unstuck` recovery event
+ * so a host's dashboard can pair the two.
+ */
+export function trackRunTerminal(runId, terminalState) {
+    const entry = runs.get(runId);
+    if (!entry)
+        return;
+    clearTimeout(entry.timer);
+    runs.delete(runId);
+    if (entry.emitted) {
+        entry.reporter('client_run_unstuck', {
+            run_id: runId,
+            terminal_state: terminalState,
+            total_duration_ms: Date.now() - entry.startedAt,
+            ...entry.context,
+        });
+    }
+}
+function cancelRun(runId) {
+    const existing = runs.get(runId);
+    if (!existing)
+        return;
+    clearTimeout(existing.timer);
+    runs.delete(runId);
+}
+function scheduleEmit(runId, stuckAfterMs) {
+    return setTimeout(() => emitStuck(runId), stuckAfterMs);
+}
+function emitStuck(runId) {
+    const entry = runs.get(runId);
+    // `!entry || entry.emitted` is a defensive invariant guard, empirically
+    // and structurally unreachable through this module's real call graph
+    // today: `emitStuck` only ever runs as a `setTimeout` callback created by
+    // `scheduleEmit`, and every path that could remove or re-flag an entry
+    // (`trackRunStart`'s `cancelRun`, `trackRunTerminal`) always
+    // `clearTimeout`s that exact timer first — in this single-threaded
+    // runtime, a cleared timer's callback can never still fire. So by the
+    // time this callback runs, its entry is guaranteed to both exist and
+    // have `emitted === false`. Left in place (not stripped) as a guard
+    // against a future refactor silently breaking that invariant — see
+    // packages/ui/source-map.md's 2026-07-22 dated entry for the full proof,
+    // matching this task's own standard for documenting provable
+    // unreachability instead of forcing a test.
+    if (!entry || entry.emitted)
+        return;
+    entry.emitted = true;
+    entry.reporter('client_run_stuck', {
+        run_id: runId,
+        duration_since_last_progress_ms: Date.now() - entry.lastProgressAt,
+        duration_since_start_ms: Date.now() - entry.startedAt,
+        ...entry.context,
+    });
+}
+/** Test-only — flushes internal state between cases. */
+export function __resetStuckRunWatchdogForTests() {
+    for (const entry of runs.values()) {
+        clearTimeout(entry.timer);
+    }
+    runs.clear();
+}
+//# sourceMappingURL=stuck-run.js.map

package/dist/features/observability/stuck-run.js.map

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