@n-dx/core 0.1.0

package/packages/web/dist/viewer/api.js

@@ -0,0 +1,17 @@
+/**
+ * Viewer inbound API barrel — the sanctioned import surface for
+ * sibling zones (crash, route, performance, usage) that consume
+ * viewer-internal symbols.
+ *
+ * This is the inbound counterpart to external.ts (which concentrates
+ * viewer's outbound imports from schema/, shared/, and messaging/).
+ *
+ * Rules:
+ *   - Re-export only — no logic in this file
+ *   - Any symbol consumed by a file outside the web-viewer zone
+ *     should be re-exported here
+ *   - Sibling zones should import from "./api.js" rather than
+ *     reaching into types.js, route-state.js, or hooks/ directly
+ */
+export { parseLegacyHashRoute, parsePathnameRoute, resolveLocationRoute, } from "./route-state.js";
+//# sourceMappingURL=api.js.map

package/packages/web/dist/viewer/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/viewer/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/packages/web/dist/viewer/batched-tick-dispatcher.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Batched tick dispatcher for elapsed time state updates.
+ *
+ * Sits between the shared tick timer and individual `useTick` hook instances.
+ * Instead of N separate `onTick` listeners each calling `setState` independently,
+ * this dispatcher:
+ *
+ *   1. Subscribes to the tick timer **once** (regardless of how many components
+ *      display elapsed time).
+ *   2. On each tick, computes all new values synchronously (read-only phase).
+ *   3. Filters out unchanged values via equality check (skip phase).
+ *   4. Schedules a single `requestAnimationFrame` to apply all state updates
+ *      in one synchronous block (write phase).
+ *
+ * This two-phase (compute → RAF write) approach ensures:
+ *
+ *   - All `setState` calls occur within the same synchronous execution context
+ *     inside the RAF callback, allowing Preact to batch them into a single
+ *     reconciliation pass.
+ *   - State updates are aligned with the browser's paint cycle, eliminating
+ *     wasted intermediate renders.
+ *   - With 20+ visible task cards, the re-render count drops from N individual
+ *     renders to one batched reconciliation per tick.
+ *
+ * Auto-lifecycle: subscribes to the tick timer when the first component
+ * registers, unsubscribes when the last one unregisters. Zero overhead
+ * when no elapsed time displays are mounted.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact integration lives in the `useTick` hook.
+ */
+/** Function that computes the current formatted elapsed time string. */
+type ComputeFn = () => string;
+/** Preact state setter for the display value. */
+type SetDisplayFn = (value: string) => void;
+/** Mutable ref object (matches Preact's useRef shape). */
+interface MutableRef<T> {
+    current: T;
+}
+/** Read-only snapshot of the dispatcher's current state (for testing/monitoring). */
+export interface BatchedTickDispatcherState {
+    /** Number of active registrations. */
+    readonly registrationCount: number;
+    /** Whether a RAF callback is currently pending. */
+    readonly hasPendingRAF: boolean;
+    /** Number of state updates queued for the next RAF. */
+    readonly pendingUpdateCount: number;
+}
+/**
+ * Register an elapsed time updater with the batched dispatcher.
+ *
+ * The dispatcher will call `compute()` on each tick, compare the result
+ * against `lastValueRef.current`, and — if changed — schedule a batched
+ * RAF update that calls `setDisplay(newValue)`.
+ *
+ * The `lastValueRef` is shared with the calling hook so that both the
+ * dispatcher and the hook's immediate-update effect (for `startedAt`
+ * prop changes) stay in sync.
+ *
+ * Returns an unregister function. When the last registration is removed,
+ * the dispatcher unsubscribes from the tick timer automatically.
+ *
+ * @param compute      - Pure function returning the current formatted string.
+ * @param setDisplay   - Preact state setter for the display value.
+ * @param lastValueRef - Mutable ref tracking the last emitted value.
+ * @returns Unregister function (safe to call multiple times).
+ */
+export declare function registerTickUpdater(compute: ComputeFn, setDisplay: SetDisplayFn, lastValueRef: MutableRef<string>): () => void;
+/**
+ * Get the current state of the batched tick dispatcher (for testing/monitoring).
+ */
+export declare function getBatchedTickDispatcherState(): BatchedTickDispatcherState;
+/**
+ * Force-flush all pending RAF updates synchronously.
+ * Cancels any pending RAF. No-op if nothing is pending.
+ */
+export declare function flushBatchedTicks(): void;
+/**
+ * Reset all dispatcher state (for testing). Unsubscribes from the tick
+ * timer, cancels pending RAF, and clears all registrations.
+ */
+export declare function resetBatchedTickDispatcher(): void;
+export {};

package/packages/web/dist/viewer/batched-tick-dispatcher.js

@@ -0,0 +1,183 @@
+/**
+ * Batched tick dispatcher for elapsed time state updates.
+ *
+ * Sits between the shared tick timer and individual `useTick` hook instances.
+ * Instead of N separate `onTick` listeners each calling `setState` independently,
+ * this dispatcher:
+ *
+ *   1. Subscribes to the tick timer **once** (regardless of how many components
+ *      display elapsed time).
+ *   2. On each tick, computes all new values synchronously (read-only phase).
+ *   3. Filters out unchanged values via equality check (skip phase).
+ *   4. Schedules a single `requestAnimationFrame` to apply all state updates
+ *      in one synchronous block (write phase).
+ *
+ * This two-phase (compute → RAF write) approach ensures:
+ *
+ *   - All `setState` calls occur within the same synchronous execution context
+ *     inside the RAF callback, allowing Preact to batch them into a single
+ *     reconciliation pass.
+ *   - State updates are aligned with the browser's paint cycle, eliminating
+ *     wasted intermediate renders.
+ *   - With 20+ visible task cards, the re-render count drops from N individual
+ *     renders to one batched reconciliation per tick.
+ *
+ * Auto-lifecycle: subscribes to the tick timer when the first component
+ * registers, unsubscribes when the last one unregisters. Zero overhead
+ * when no elapsed time displays are mounted.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact integration lives in the `useTick` hook.
+ */
+import { onTick } from "./tick-timer.js";
+// ─── Module state ────────────────────────────────────────────────────────────
+let registrations = [];
+let tickUnsub = null;
+let rafId = null;
+let pendingBatch = null;
+// ─── Internal helpers ────────────────────────────────────────────────────────
+/** Phase 1 (tick callback): compute values, filter unchanged, queue RAF. */
+function onTickFired() {
+    const batch = [];
+    // Snapshot registrations to protect against mid-iteration unregister.
+    const snapshot = registrations.slice();
+    for (const reg of snapshot) {
+        try {
+            const next = reg.compute();
+            if (next !== reg.lastValueRef.current) {
+                batch.push({ setDisplay: reg.setDisplay, value: next, reg });
+            }
+        }
+        catch {
+            // Swallow errors from individual computations to prevent one bad
+            // registration from breaking all others.
+        }
+    }
+    if (batch.length === 0)
+        return;
+    // Commit lastValueRef immediately so the next tick won't re-queue
+    // the same update if RAF hasn't fired yet.
+    for (const { reg, value } of batch) {
+        reg.lastValueRef.current = value;
+    }
+    // Queue state updates for the next animation frame.
+    // If a previous batch is still pending (unlikely at 1s intervals),
+    // merge into it.
+    if (pendingBatch) {
+        for (const { setDisplay, value } of batch) {
+            pendingBatch.push({ setDisplay, value });
+        }
+    }
+    else {
+        pendingBatch = batch.map(({ setDisplay, value }) => ({
+            setDisplay,
+            value,
+        }));
+    }
+    if (rafId === null) {
+        rafId = requestAnimationFrame(applyBatch);
+    }
+}
+/** Phase 2 (RAF callback): apply all state updates in one synchronous block. */
+function applyBatch() {
+    rafId = null;
+    const batch = pendingBatch;
+    pendingBatch = null;
+    if (!batch)
+        return;
+    // All setDisplay calls happen synchronously within this frame →
+    // Preact batches them into a single reconciliation pass.
+    for (const { setDisplay, value } of batch) {
+        try {
+            setDisplay(value);
+        }
+        catch {
+            // Swallow errors from individual setters.
+        }
+    }
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Register an elapsed time updater with the batched dispatcher.
+ *
+ * The dispatcher will call `compute()` on each tick, compare the result
+ * against `lastValueRef.current`, and — if changed — schedule a batched
+ * RAF update that calls `setDisplay(newValue)`.
+ *
+ * The `lastValueRef` is shared with the calling hook so that both the
+ * dispatcher and the hook's immediate-update effect (for `startedAt`
+ * prop changes) stay in sync.
+ *
+ * Returns an unregister function. When the last registration is removed,
+ * the dispatcher unsubscribes from the tick timer automatically.
+ *
+ * @param compute      - Pure function returning the current formatted string.
+ * @param setDisplay   - Preact state setter for the display value.
+ * @param lastValueRef - Mutable ref tracking the last emitted value.
+ * @returns Unregister function (safe to call multiple times).
+ */
+export function registerTickUpdater(compute, setDisplay, lastValueRef) {
+    const reg = { compute, setDisplay, lastValueRef };
+    registrations.push(reg);
+    // Auto-start: subscribe to the tick timer on first registration.
+    if (registrations.length === 1 && tickUnsub === null) {
+        tickUnsub = onTick(onTickFired);
+    }
+    let removed = false;
+    return () => {
+        if (removed)
+            return; // idempotent unregister
+        removed = true;
+        registrations = registrations.filter((r) => r !== reg);
+        // Auto-stop: unsubscribe from tick timer when no registrations remain.
+        if (registrations.length === 0) {
+            if (tickUnsub) {
+                tickUnsub();
+                tickUnsub = null;
+            }
+            if (rafId !== null) {
+                cancelAnimationFrame(rafId);
+                rafId = null;
+                pendingBatch = null;
+            }
+        }
+    };
+}
+/**
+ * Get the current state of the batched tick dispatcher (for testing/monitoring).
+ */
+export function getBatchedTickDispatcherState() {
+    return {
+        registrationCount: registrations.length,
+        hasPendingRAF: rafId !== null,
+        pendingUpdateCount: pendingBatch?.length ?? 0,
+    };
+}
+/**
+ * Force-flush all pending RAF updates synchronously.
+ * Cancels any pending RAF. No-op if nothing is pending.
+ */
+export function flushBatchedTicks() {
+    if (rafId !== null) {
+        cancelAnimationFrame(rafId);
+        rafId = null;
+    }
+    applyBatch();
+}
+/**
+ * Reset all dispatcher state (for testing). Unsubscribes from the tick
+ * timer, cancels pending RAF, and clears all registrations.
+ */
+export function resetBatchedTickDispatcher() {
+    if (tickUnsub) {
+        tickUnsub();
+        tickUnsub = null;
+    }
+    if (rafId !== null) {
+        cancelAnimationFrame(rafId);
+        rafId = null;
+    }
+    registrations = [];
+    pendingBatch = null;
+}
+//# sourceMappingURL=batched-tick-dispatcher.js.map

package/packages/web/dist/viewer/batched-tick-dispatcher.js.map

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

package/packages/web/dist/viewer/bootstrap.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Application bootstrap — module-level side effects.
+ *
+ * Initializes theme, tab-visibility monitoring, polling infrastructure,
+ * and tick-visibility gating.  Called once at application startup before
+ * the first render.
+ *
+ * In deployed (static export) mode, the fetch adapter is installed first
+ * so all subsequent network requests are transparently rewritten to hit
+ * pre-rendered JSON files instead of a live server.
+ */
+/** Run all one-time setup operations. */
+export declare function bootstrap(): void;

package/packages/web/dist/viewer/bootstrap.js

@@ -0,0 +1,40 @@
+/**
+ * Application bootstrap — module-level side effects.
+ *
+ * Initializes theme, tab-visibility monitoring, polling infrastructure,
+ * and tick-visibility gating.  Called once at application startup before
+ * the first render.
+ *
+ * In deployed (static export) mode, the fetch adapter is installed first
+ * so all subsequent network requests are transparently rewritten to hit
+ * pre-rendered JSON files instead of a live server.
+ */
+import { initTheme } from "./components/index.js";
+import { startTabVisibilityMonitor, startPollingManager, startPollingRestart, createTickVisibilityGate, } from "./polling/index.js";
+import { isDeployedMode, installFetchAdapter } from "./deployed-mode.js";
+/** Run all one-time setup operations. */
+export function bootstrap() {
+    if (isDeployedMode()) {
+        installFetchAdapter();
+        document.body.classList.add("ndx-deployed");
+    }
+    initTheme();
+    // Start tab visibility and polling manager so they're available before
+    // the first render.  The polling manager subscribes to visibility changes
+    // and automatically suspends / resumes all registered pollers when the
+    // tab is backgrounded / foregrounded.
+    startTabVisibilityMonitor();
+    startPollingManager();
+    // Bridge tab visibility changes to the tick timer's suspend/resume
+    // lifecycle: when the tab goes hidden, the 1-second elapsed time
+    // interval is cleared to conserve CPU and battery; when the tab
+    // returns, an immediate catch-up tick fires so elapsed time displays
+    // jump to the correct current value.
+    createTickVisibilityGate();
+    // Bridge the graceful degradation system to centralized polling state:
+    // when memory pressure disables autoRefresh, all non-essential polling
+    // sources are suspended; when pressure subsides, they restart at
+    // original intervals.
+    startPollingRestart();
+}
+//# sourceMappingURL=bootstrap.js.map

package/packages/web/dist/viewer/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/viewer/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzE,yCAAyC;AACzC,MAAM,UAAU,SAAS;IACvB,IAAI,cAAc,EAAE,EAAE,CAAC;QACrB,mBAAmB,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED,SAAS,EAAE,CAAC;IAEZ,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,sCAAsC;IACtC,yBAAyB,EAAE,CAAC;IAC5B,mBAAmB,EAAE,CAAC;IAEtB,mEAAmE;IACnE,iEAAiE;IACjE,gEAAgE;IAChE,qEAAqE;IACrE,qCAAqC;IACrC,wBAAwB,EAAE,CAAC;IAE3B,uEAAuE;IACvE,uEAAuE;IACvE,iEAAiE;IACjE,sBAAsB;IACtB,mBAAmB,EAAE,CAAC;AACxB,CAAC"}

package/packages/web/dist/viewer/call-rate-limiter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Call-level rate limiter with queue deduplication.
+ *
+ * Enforces a minimum interval between execution starts. Calls arriving
+ * within the cooldown window are queued (deduplicated: only one pending
+ * call exists at a time — subsequent callers share its promise).
+ *
+ * Designed to sit in front of `createRequestDedup`: the rate limiter
+ * controls *when* calls happen, while the dedup handles concurrent
+ * in-flight request sharing.
+ *
+ * Standalone module with zero framework dependencies.
+ * Preact integration lives in the consumer (views/prd.ts).
+ */
+export interface CallRateLimiterConfig {
+    /**
+     * Minimum milliseconds between execution starts.
+     * Default: 500 (allows max 2 calls per second).
+     */
+    minIntervalMs?: number;
+}
+/** A rate-limited, queue-deduplicated wrapper around an async function. */
+export interface CallRateLimiter<T = void> {
+    /**
+     * Schedule execution. If within the rate limit cooldown, the call is
+     * queued. Multiple callers hitting the queue share one promise (dedup).
+     */
+    execute(): Promise<T>;
+    /** Whether the underlying function is currently executing. */
+    isExecuting(): boolean;
+    /** Whether a call is queued waiting for the rate limit cooldown. */
+    isPending(): boolean;
+    /** Clean up timers and pending state. Safe to call multiple times. */
+    dispose(): void;
+}
+/**
+ * Create a rate-limited, queue-deduplicated wrapper for an async function.
+ *
+ * Usage:
+ * ```ts
+ * const rateLimited = createCallRateLimiter(() => fetchData(), { minIntervalMs: 500 });
+ *
+ * rateLimited.execute(); // executes immediately (first call)
+ * rateLimited.execute(); // queued — shares the same pending promise
+ * rateLimited.execute(); // deduped to the already-queued call
+ *
+ * // After 500ms the queued call fires.
+ * ```
+ */
+export declare function createCallRateLimiter<T = void>(fn: () => Promise<T>, config?: CallRateLimiterConfig): CallRateLimiter<T>;

package/packages/web/dist/viewer/call-rate-limiter.js

@@ -0,0 +1,103 @@
+/**
+ * Call-level rate limiter with queue deduplication.
+ *
+ * Enforces a minimum interval between execution starts. Calls arriving
+ * within the cooldown window are queued (deduplicated: only one pending
+ * call exists at a time — subsequent callers share its promise).
+ *
+ * Designed to sit in front of `createRequestDedup`: the rate limiter
+ * controls *when* calls happen, while the dedup handles concurrent
+ * in-flight request sharing.
+ *
+ * Standalone module with zero framework dependencies.
+ * Preact integration lives in the consumer (views/prd.ts).
+ */
+/** Default minimum interval — 500ms ≈ 2 calls/sec. */
+const DEFAULT_MIN_INTERVAL_MS = 500;
+// ─── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create a rate-limited, queue-deduplicated wrapper for an async function.
+ *
+ * Usage:
+ * ```ts
+ * const rateLimited = createCallRateLimiter(() => fetchData(), { minIntervalMs: 500 });
+ *
+ * rateLimited.execute(); // executes immediately (first call)
+ * rateLimited.execute(); // queued — shares the same pending promise
+ * rateLimited.execute(); // deduped to the already-queued call
+ *
+ * // After 500ms the queued call fires.
+ * ```
+ */
+export function createCallRateLimiter(fn, config) {
+    const minIntervalMs = config?.minIntervalMs ?? DEFAULT_MIN_INTERVAL_MS;
+    let lastExecutionStartMs = 0;
+    let executing = false;
+    let pendingTimer = null;
+    let pendingResolve = null;
+    let pendingReject = null;
+    let pendingPromise = null;
+    let disposed = false;
+    function executeNow() {
+        lastExecutionStartMs = Date.now();
+        executing = true;
+        return fn().then((value) => {
+            executing = false;
+            return value;
+        }, (err) => {
+            executing = false;
+            throw err;
+        });
+    }
+    function execute() {
+        if (disposed) {
+            return Promise.reject(new Error("CallRateLimiter has been disposed"));
+        }
+        const now = Date.now();
+        const elapsed = now - lastExecutionStartMs;
+        if (elapsed >= minIntervalMs) {
+            // Enough time since last execution start — fire immediately.
+            return executeNow();
+        }
+        // Within rate limit cooldown — queue (deduplicated).
+        if (pendingPromise !== null) {
+            // Already queued — return the existing promise (dedup).
+            return pendingPromise;
+        }
+        // Create a new queued execution.
+        pendingPromise = new Promise((resolve, reject) => {
+            pendingResolve = resolve;
+            pendingReject = reject;
+        });
+        const delay = minIntervalMs - elapsed;
+        pendingTimer = setTimeout(() => {
+            const resolve = pendingResolve;
+            const reject = pendingReject;
+            pendingTimer = null;
+            pendingResolve = null;
+            pendingReject = null;
+            pendingPromise = null;
+            executeNow().then(resolve, reject);
+        }, delay);
+        return pendingPromise;
+    }
+    function isExecuting() {
+        return executing;
+    }
+    function isPending() {
+        return pendingPromise !== null;
+    }
+    function dispose() {
+        disposed = true;
+        if (pendingTimer !== null) {
+            clearTimeout(pendingTimer);
+            pendingTimer = null;
+        }
+        pendingResolve = null;
+        pendingReject = null;
+        pendingPromise = null;
+        executing = false;
+    }
+    return { execute, isExecuting, isPending, dispose };
+}
+//# sourceMappingURL=call-rate-limiter.js.map

package/packages/web/dist/viewer/call-rate-limiter.js.map

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

package/packages/web/dist/viewer/components/active-tasks-panel.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Active Tasks Panel — shows currently executing tasks prominently at the
+ * top of the Hench UI.
+ *
+ * Combines data from two sources:
+ * 1. Hench runs with status "running" (from /api/hench/runs)
+ * 2. Active task executions triggered via the dashboard (from /api/hench/execute/status)
+ *
+ * Updates in real-time via WebSocket ("hench:task-execution-progress" events)
+ * and periodic polling as a fallback.
+ *
+ * Displays task title, start time, elapsed duration (live-ticking), and
+ * health status (stale detection).
+ */
+import type { NavigateTo } from "../types.js";
+export interface ActiveRun {
+    id: string;
+    taskId: string;
+    taskTitle: string;
+    taskStatus?: string;
+    startedAt: string;
+    lastActivityAt?: string;
+    status: string;
+    turns: number;
+    model: string;
+}
+export interface ActiveTasksPanelProps {
+    /** Running runs from the parent (from /api/hench/runs with status=running). */
+    runs: ActiveRun[];
+    navigateTo?: NavigateTo;
+}
+export declare function ActiveTasksPanel({ runs, navigateTo }: ActiveTasksPanelProps): import("preact").VNode<import("preact").ClassAttributes<HTMLElement> & {
+    class: string;
+    role: "region";
+    "aria-label": string;
+}> | null;