@pyric/ui 0.1.0-alpha.7

package/dist/events/digest.d.ts

@@ -0,0 +1,167 @@
+/**
+ * The pure activity-digest reducer — folds a `SandboxEvent[]` (the
+ * unified stream) into the banded digest the activity grid renders.
+ *
+ * Kept free of React so it's trivially testable and reusable by a
+ * non-React consumer (a CLI session summary, say). `useActivityDigest`
+ * is a thin `useMemo` wrapper over `computeActivityDigest`.
+ *
+ * The categorization is the product (see
+ * the design rationale): the can't-miss bands are
+ * **denied** (surfaced first, loudly), **added**, **updated**,
+ * **removed**, **signed-in / signed-out**, and the catch-alls. Every
+ * row + band carries provenance (actor / lens / on-behalf-of) so
+ * attribution rides every aggregate, and the band order LEADS with the
+ * highest-consequence category present.
+ */
+import type { ActivityActor, ActivityEvent, ActivityLens, AnyActivityEvent, ActivityService } from './types.js';
+/**
+ * The band a row falls into. `denied` leads; the write bands
+ * (added/updated/removed) and the auth bands (signed-in/signed-out)
+ * follow; `read`, `errored`, and `other` are the long-tail catch-alls.
+ *
+ * - `denied`     — a rules denial (firestore `request` with `result: 'deny'`).
+ * - `errored`    — an operational failure (`request` with `result: 'unsupported'`).
+ * - `added`      — a doc/object created, or a user created.
+ * - `updated`    — a doc/object/user/rtdb path mutated in place.
+ * - `removed`    — a doc/object/user deleted.
+ * - `signed-in`  — an auth sign-in.
+ * - `signed-out` — an auth sign-out.
+ * - `read`       — an allowed firestore read (`get`/`list`).
+ * - `other`      — anything modelled but uncategorized (e.g. an unknown service op).
+ */
+export type ActivityBandKey = 'denied' | 'errored' | 'added' | 'updated' | 'removed' | 'signed-in' | 'signed-out' | 'read' | 'other';
+/**
+ * A single grid row — the projection of one event onto the
+ * `target · change · for · lens · when` column contract from
+ * `c-result.html`. All display-ready strings plus the structured
+ * provenance the host may style on.
+ */
+export interface ActivityRow {
+    /** The originating event's id — stable React key. */
+    id: string;
+    /** `Date.now()` at the op. Drives the `when` column + recency sort. */
+    at: number;
+    /** Which band this row was sorted into. */
+    band: ActivityBandKey;
+    /** True for denials — first-class so hosts flag the row distinctly. */
+    denied: boolean;
+    /** Originating service. */
+    service: ActivityService;
+    /** `target` — what was mutated, in the service's addressing scheme
+     *  (a doc path `notes/3agHoZHZ`, a `uid`, a storage `fullPath`, an
+     *  rtdb path). Empty string when the event has no addressable target. */
+    target: string;
+    /** `change` — a short human description of the mutation
+     *  (`update, owner rule`, `done → true`, `created`, `signed in`). */
+    change: string;
+    /** `for` — the subject the op acted on behalf of: `request.auth.uid`
+     *  for firestore, the affected `uid` for auth, else the acting
+     *  identity. Empty when anonymous / not applicable. */
+    for: string;
+    /** `lens` — the privilege the op ran under, display-ready
+     *  (`app`, `as alice`, `admin`). */
+    lens: string;
+    /** `when` — left undterived here; the grid formats `at` itself, but a
+     *  pre-rendered relative string is offered for headless consumers. */
+    when: string;
+    actor: ActivityActor;
+    authLens: ActivityLens;
+    /** The on-behalf-of subject uid, structured (mirrors `for`). */
+    subjectUid: string | null;
+    /** Agent plan id, when the op was part of a plan. */
+    planId?: string;
+    /** The pivot key this row fell under — set only when the digest was
+     *  computed with `groupBy !== 'none'`. Mirrors the row's `subgroup`. */
+    groupKey?: string;
+    /** The original event, for drill-in. */
+    event: ActivityEvent;
+}
+/**
+ * One category band: a header (`label · count · attribution`) plus its
+ * rows. Mirrors the mock's `.band` + `.r.data` structure.
+ */
+export interface ActivityBand {
+    key: ActivityBandKey;
+    /** Display label — `Denied`, `Added`, `Updated`, … */
+    label: string;
+    /** Total rows in the band (== `rows.length`; explicit for the header). */
+    count: number;
+    /** A short attribution phrase when the band has a dominant actor /
+     *  subject (`all by alice`, `by the app`, `by agent atlas`). Absent
+     *  when attribution is mixed — the header then shows just the count. */
+    attribution?: string;
+    rows: ActivityRow[];
+}
+/**
+ * The banded digest — the activity grid's entire model. Bands are
+ * pre-sorted lead-with-consequence; `denials` is a flat projection of
+ * the consequential rows for the action-items tier.
+ */
+export interface ActivityDigest {
+    /** Bands in render order — highest-consequence first. Empty bands
+     *  omitted. Each band may carry `subgroups` when `groupBy !== 'none'`. */
+    bands: ActivityBandWithGroups[];
+    /** Total rows across all bands (events the digest categorized). */
+    total: number;
+    /** Of those, how many were denials. */
+    deniedCount: number;
+    /**
+     * The denial rows, flat + recency-sorted — the source for the
+     * action-items tier ("4 writes to /notes were denied"). A projection,
+     * not a separate aggregation: these rows also live in the `denied` band.
+     */
+    denials: ActivityRow[];
+}
+/** How rows within each band are pivoted/grouped. */
+export type ActivityGroupBy = 'none' | 'actor' | 'lens' | 'subject' | 'service';
+export interface ActivityDigestOptions {
+    /**
+     * Row order within a band. `recency` (default) is newest-first to
+     * match the mock's `when` column. `chronological` is oldest-first.
+     */
+    order?: 'recency' | 'chronological';
+    /**
+     * Pivot rows within each band by an attribution axis. `'none'`
+     * (default) leaves the band flat. Any other value splits each band's
+     * rows into sub-groups keyed by that axis — surfaced on the row via
+     * `groupKey` and exposed as `band.subgroups`. The flat `rows` are
+     * always present regardless.
+     */
+    groupBy?: ActivityGroupBy;
+    /**
+     * Cap rows kept per band (the mock shows ~3–4 then "N more"). The
+     * digest keeps ALL rows but records the overflow via `band.count` vs
+     * `rows.length`. Set to a number to actually trim `rows`; the header
+     * `count` still reflects the true total. Default: keep all.
+     */
+    rowsPerBand?: number;
+}
+export interface ActivitySubgroup {
+    key: string;
+    count: number;
+    rows: ActivityRow[];
+}
+/**
+ * A band that may carry pivot sub-groups. `subgroups` is populated only
+ * when the digest was computed with `groupBy !== 'none'`; otherwise the
+ * band is flat (`rows` only). `computeActivityDigest` always returns
+ * bands of this shape so consumers can branch on `subgroups` presence.
+ */
+export interface ActivityBandWithGroups extends ActivityBand {
+    /** Present only when `groupBy !== 'none'`. */
+    subgroups?: ActivitySubgroup[];
+}
+/**
+ * Fold a unified event stream into the banded activity digest. PURE —
+ * no React, no clock reads except the injected `now` (defaults to
+ * `Date.now()`, but pass a fixed value in tests for determinism).
+ *
+ * Events the digest doesn't model (listener lifecycle, snapshot
+ * delivery, session boundaries, unknown kinds) are skipped — a full
+ * `SandboxEvent[]` from `sandbox.history()` flows in unfiltered.
+ */
+export declare function computeActivityDigest(events: readonly AnyActivityEvent[], opts?: ActivityDigestOptions & {
+    now?: number;
+}): ActivityDigest;
+//# sourceMappingURL=digest.d.ts.map

package/dist/events/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/events/digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,YAAY,EAIZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,GACT,WAAW,GACX,YAAY,GACZ,MAAM,GACN,OAAO,CAAC;AAEZ;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,EAAE,eAAe,CAAC;IACtB,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,eAAe,CAAC;IAGzB;;6EAEyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf;yEACqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf;;2DAEuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ;wCACoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb;0EACsE;IACtE,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,gEAAgE;IAChE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;4EACwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd;;4EAEwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;8EAC0E;IAC1E,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,eAAe,CAAC;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgXD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,8CAA8C;IAC9C,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,IAAI,GAAE,qBAAqB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,cAAc,CAiEhB"}

package/dist/events/digest.js

@@ -0,0 +1,426 @@
+/**
+ * The pure activity-digest reducer — folds a `SandboxEvent[]` (the
+ * unified stream) into the banded digest the activity grid renders.
+ *
+ * Kept free of React so it's trivially testable and reusable by a
+ * non-React consumer (a CLI session summary, say). `useActivityDigest`
+ * is a thin `useMemo` wrapper over `computeActivityDigest`.
+ *
+ * The categorization is the product (see
+ * the design rationale): the can't-miss bands are
+ * **denied** (surfaced first, loudly), **added**, **updated**,
+ * **removed**, **signed-in / signed-out**, and the catch-alls. Every
+ * row + band carries provenance (actor / lens / on-behalf-of) so
+ * attribution rides every aggregate, and the band order LEADS with the
+ * highest-consequence category present.
+ */
+// ── Band ordering: lead-with-consequence ──────────────────────────────
+// Lower rank renders first. Denials lead; operational errors next; then
+// the write bands; auth; reads; catch-all. (design-ideation.md:
+// "the answer LEADS with the highest-consequence category present".)
+const BAND_RANK = {
+    denied: 0,
+    errored: 1,
+    added: 2,
+    updated: 3,
+    removed: 4,
+    'signed-in': 5,
+    'signed-out': 6,
+    read: 7,
+    other: 8,
+};
+const BAND_LABEL = {
+    denied: 'Denied',
+    errored: 'Errored',
+    added: 'Added',
+    updated: 'Updated',
+    removed: 'Removed',
+    'signed-in': 'Signed in',
+    'signed-out': 'Signed out',
+    read: 'Read',
+    other: 'Other',
+};
+/** The kinds the digest models. Everything else is skipped. */
+function isModelled(e) {
+    return (e.kind === 'request' ||
+        e.kind === 'write' ||
+        e.kind === 'service_mutation');
+}
+function lastSegment(path) {
+    const trimmed = path.replace(/\/+$/, '');
+    const i = trimmed.lastIndexOf('/');
+    return i === -1 ? trimmed : trimmed.slice(i + 1);
+}
+function defaultActor(actor) {
+    return actor ?? { kind: 'app' };
+}
+function defaultLens(lens) {
+    return lens ?? { mode: 'app-session' };
+}
+function lensLabel(lens) {
+    switch (lens.mode) {
+        case 'admin':
+            return 'admin';
+        case 'as':
+            return lens.uid;
+        case 'app-session':
+            return 'app';
+    }
+}
+function actorLabel(actor) {
+    switch (actor.kind) {
+        case 'app':
+            return 'the app';
+        case 'studio':
+            return 'studio';
+        case 'app-builder':
+            return 'the app builder';
+        case 'agent':
+            return `agent ${actor.name}`;
+    }
+}
+/** A stable identity key for an actor (for attribution counting). */
+function actorKey(actor) {
+    return actor.kind === 'agent' ? `agent:${actor.name}` : actor.kind;
+}
+/** The deciding rule on a denial, parsed from the simulator reasons.
+ *  Best-effort — falls back to a generic phrase. */
+function denialRulePhrase(reasons) {
+    // Reasons look like `Rule #0 (update) → DENY`. We surface the op the
+    // rule governs when present; the design copy says "owner rule" but
+    // that's app-semantic naming the library can't know, so we stay
+    // mechanical: name the failing op.
+    for (const r of reasons) {
+        const m = /Rule #\d+\s*\(([^)]+)\)/i.exec(r);
+        if (m)
+            return `${m[1]} rule`;
+    }
+    return undefined;
+}
+function relativeWhen(at, now) {
+    const deltaMs = Math.max(0, now - at);
+    const s = Math.floor(deltaMs / 1000);
+    if (s < 1)
+        return 'now';
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m`;
+    const h = Math.floor(m / 60);
+    return `${h}h`;
+}
+// ── Per-kind projection: event → { band, row fields } ─────────────────
+function projectRequest(e) {
+    if (e.result === 'deny') {
+        const rule = denialRulePhrase(e.reasons);
+        const change = rule ? `${e.method}, ${rule}` : `${e.method} denied`;
+        return { band: 'denied', change, subjectUid: e.auth?.uid ?? null };
+    }
+    if (e.result === 'unsupported') {
+        return {
+            band: 'errored',
+            change: `${e.method} unsupported`,
+            subjectUid: e.auth?.uid ?? null,
+        };
+    }
+    // Allowed request. Reads land in `read`; allowed writes that DIDN'T
+    // also emit a `write` event still get a band so nothing is dropped.
+    const subjectUid = e.auth?.uid ?? null;
+    if (e.method === 'get' || e.method === 'list') {
+        return { band: 'read', change: e.method, subjectUid };
+    }
+    if (e.method === 'delete') {
+        return { band: 'removed', change: 'deleted', subjectUid };
+    }
+    if (e.method === 'create') {
+        return { band: 'added', change: 'created', subjectUid };
+    }
+    return { band: 'updated', change: e.method, subjectUid };
+}
+/** A compact change summary for a write, diffing prior→next when cheap. */
+function writeChange(e) {
+    if (e.method === 'delete')
+        return 'deleted';
+    if (e.method === 'create') {
+        // Surface a representative field value if present (mock shows the
+        // note title in quotes). Pick the first string-ish scalar.
+        const data = e.nextState ?? e.data ?? null;
+        const preview = data ? firstScalarPreview(data) : undefined;
+        return preview !== undefined ? preview : 'created';
+    }
+    // update / set — try to show a single changed field as `key → value`.
+    const single = singleFieldDiff(e.priorState, e.nextState);
+    if (single)
+        return single;
+    return e.method === 'set' ? 'replaced' : 'updated';
+}
+function firstScalarPreview(data) {
+    for (const v of Object.values(data)) {
+        if (typeof v === 'string')
+            return `"${v}"`;
+    }
+    for (const v of Object.values(data)) {
+        if (typeof v === 'number' || typeof v === 'boolean')
+            return String(v);
+    }
+    return undefined;
+}
+function singleFieldDiff(prior, next) {
+    if (!next)
+        return undefined;
+    const before = prior ?? {};
+    const changed = [];
+    for (const k of Object.keys(next)) {
+        if (!shallowEqual(before[k], next[k]))
+            changed.push(k);
+    }
+    if (changed.length !== 1) {
+        return changed.length > 1 ? `${changed.length} fields changed` : undefined;
+    }
+    const key = changed[0];
+    const v = next[key];
+    if (typeof v === 'string' ||
+        typeof v === 'number' ||
+        typeof v === 'boolean') {
+        const shown = typeof v === 'string' ? v : String(v);
+        return `${key} → ${shown}`;
+    }
+    return `${key} changed`;
+}
+function shallowEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a === 'object' && a && b) {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    return false;
+}
+function projectWrite(e) {
+    const subjectUid = e.auth?.uid ?? null;
+    if (e.method === 'delete')
+        return { band: 'removed', change: 'deleted', subjectUid };
+    if (e.method === 'create')
+        return { band: 'added', change: writeChange(e), subjectUid };
+    return { band: 'updated', change: writeChange(e), subjectUid };
+}
+function projectServiceMutation(e) {
+    const op = e.op;
+    // auth ops carry the affected uid in `path` (or `*` for a clear-all).
+    if (e.service === 'auth') {
+        const affected = e.path && e.path !== '*' ? e.path : null;
+        const subjectUid = affected ?? e.auth?.uid ?? null;
+        switch (op) {
+            case 'sign_in':
+                return { band: 'signed-in', change: 'signed in', subjectUid };
+            case 'sign_out':
+                return { band: 'signed-out', change: 'signed out', subjectUid };
+            case 'user_create':
+                return { band: 'added', change: 'user created', subjectUid };
+            case 'user_update':
+                return { band: 'updated', change: 'user updated', subjectUid };
+            case 'user_delete':
+                return { band: 'removed', change: 'user deleted', subjectUid };
+            case 'users_clear':
+                return { band: 'removed', change: 'all users cleared', subjectUid };
+            default:
+                return { band: 'other', change: op, subjectUid };
+        }
+    }
+    const subjectUid = e.auth?.uid ?? null;
+    if (e.service === 'storage') {
+        switch (op) {
+            case 'object_put':
+                // create vs overwrite: `before` present ⇒ overwrite.
+                return e.before !== undefined
+                    ? { band: 'updated', change: 'object replaced', subjectUid }
+                    : { band: 'added', change: 'object uploaded', subjectUid };
+            case 'object_delete':
+                return { band: 'removed', change: 'object deleted', subjectUid };
+            case 'metadata_update':
+                return { band: 'updated', change: 'metadata updated', subjectUid };
+            default:
+                return { band: 'other', change: op, subjectUid };
+        }
+    }
+    // rtdb
+    switch (op) {
+        case 'set':
+            return e.before !== undefined && e.before !== null
+                ? { band: 'updated', change: 'set', subjectUid }
+                : { band: 'added', change: 'set', subjectUid };
+        case 'update':
+            return { band: 'updated', change: 'update', subjectUid };
+        case 'remove':
+            return { band: 'removed', change: 'removed', subjectUid };
+        case 'transaction':
+            return { band: 'updated', change: 'transaction', subjectUid };
+        default:
+            return { band: 'other', change: op, subjectUid };
+    }
+}
+function project(e) {
+    switch (e.kind) {
+        case 'request':
+            return projectRequest(e);
+        case 'write':
+            return projectWrite(e);
+        case 'service_mutation':
+            return projectServiceMutation(e);
+    }
+}
+function targetOf(e) {
+    switch (e.kind) {
+        case 'request':
+        case 'write':
+            return e.path;
+        case 'service_mutation':
+            // auth: the affected uid; storage/rtdb: the path.
+            if (e.service === 'auth')
+                return e.path && e.path !== '*' ? e.path : '*';
+            return e.path ?? '';
+    }
+}
+function serviceOf(e) {
+    if (e.kind === 'service_mutation')
+        return e.service;
+    return e.service ?? 'firestore';
+}
+/** Build a row from a modelled event. */
+function toRow(e, now) {
+    const { band, change, subjectUid } = project(e);
+    const actor = defaultActor(e.actor);
+    const authLens = defaultLens(e.authLens);
+    const row = {
+        id: e.id,
+        at: e.at,
+        band,
+        denied: band === 'denied',
+        service: serviceOf(e),
+        target: targetOf(e),
+        change,
+        for: subjectUid ?? '',
+        lens: lensLabel(authLens),
+        when: relativeWhen(e.at, now),
+        actor,
+        authLens,
+        subjectUid,
+        event: e,
+    };
+    if (e.planId !== undefined)
+        row.planId = e.planId;
+    return row;
+}
+/** The pivot key for a row under a given group-by axis. */
+function groupKeyFor(row, by) {
+    switch (by) {
+        case 'actor':
+            return actorKey(row.actor);
+        case 'lens':
+            return row.authLens.mode === 'as'
+                ? `as:${row.authLens.uid}`
+                : row.authLens.mode;
+        case 'subject':
+            return row.subjectUid ?? '(anonymous)';
+        case 'service':
+            return row.service;
+        case 'none':
+            return '';
+    }
+}
+/**
+ * Compute the band attribution phrase: when one actor OR one subject
+ * dominates the band, say so ("all by alice", "by the app"). Mixed ⇒
+ * undefined (header shows just the count).
+ */
+function attributionFor(rows) {
+    if (rows.length === 0)
+        return undefined;
+    // Subject dominance first ("all by alice") — it's the most pointed.
+    const subjects = new Set();
+    for (const r of rows)
+        if (r.subjectUid)
+            subjects.add(r.subjectUid);
+    const anonCount = rows.filter((r) => !r.subjectUid).length;
+    if (subjects.size === 1 && anonCount === 0) {
+        const [only] = subjects;
+        return rows.length > 1 ? `all by ${only}` : `by ${only}`;
+    }
+    // Actor dominance ("by the app", "by agent atlas").
+    const actors = new Set();
+    for (const r of rows)
+        actors.add(actorKey(r.actor));
+    if (actors.size === 1) {
+        return `by ${actorLabel(rows[0].actor)}`;
+    }
+    return undefined;
+}
+/**
+ * Fold a unified event stream into the banded activity digest. PURE —
+ * no React, no clock reads except the injected `now` (defaults to
+ * `Date.now()`, but pass a fixed value in tests for determinism).
+ *
+ * Events the digest doesn't model (listener lifecycle, snapshot
+ * delivery, session boundaries, unknown kinds) are skipped — a full
+ * `SandboxEvent[]` from `sandbox.history()` flows in unfiltered.
+ */
+export function computeActivityDigest(events, opts = {}) {
+    const { order = 'recency', groupBy = 'none', rowsPerBand, now = Date.now(), } = opts;
+    const byBand = new Map();
+    let deniedCount = 0;
+    for (const e of events) {
+        if (!isModelled(e))
+            continue;
+        const row = toRow(e, now);
+        if (row.denied)
+            deniedCount++;
+        const list = byBand.get(row.band);
+        if (list)
+            list.push(row);
+        else
+            byBand.set(row.band, [row]);
+    }
+    const sortRows = (rows) => rows.sort((a, b) => order === 'recency' ? b.at - a.at : a.at - b.at);
+    const bands = [];
+    let total = 0;
+    for (const [key, allRows] of byBand) {
+        sortRows(allRows);
+        const count = allRows.length;
+        total += count;
+        const rows = rowsPerBand !== undefined ? allRows.slice(0, rowsPerBand) : allRows;
+        if (groupBy !== 'none') {
+            for (const r of rows)
+                r.groupKey = groupKeyFor(r, groupBy);
+        }
+        const band = {
+            key,
+            label: BAND_LABEL[key],
+            count,
+            rows,
+        };
+        const attr = attributionFor(allRows);
+        if (attr)
+            band.attribution = attr;
+        if (groupBy !== 'none') {
+            const groups = new Map();
+            for (const r of rows) {
+                const gk = groupKeyFor(r, groupBy);
+                const g = groups.get(gk);
+                if (g)
+                    g.push(r);
+                else
+                    groups.set(gk, [r]);
+            }
+            band.subgroups = [...groups.entries()]
+                .map(([k, rs]) => ({ key: k, count: rs.length, rows: rs }))
+                .sort((a, b) => b.count - a.count || a.key.localeCompare(b.key));
+        }
+        bands.push(band);
+    }
+    bands.sort((a, b) => BAND_RANK[a.key] - BAND_RANK[b.key]);
+    const denials = sortRows((byBand.get('denied') ?? []).slice());
+    return { bands, total, deniedCount, denials };
+}
+//# sourceMappingURL=digest.js.map

package/dist/events/digest.js.map

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

package/dist/events/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useActivityDigest, type UseActivityDigestOptions, } from './useActivityDigest.js';
+export { useActivityStream, type UseActivityStreamOptions, type UseActivityStreamResult, } from './useActivityStream.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC"}

package/dist/events/hooks/index.js

@@ -0,0 +1,3 @@
+export { useActivityDigest, } from './useActivityDigest.js';
+export { useActivityStream, } from './useActivityStream.js';
+//# sourceMappingURL=index.js.map

package/dist/events/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC"}

package/dist/events/hooks/useActivityDigest.d.ts

@@ -0,0 +1,27 @@
+import type { AnyActivityEvent } from '../types.js';
+import { type ActivityDigest, type ActivityDigestOptions } from '../digest.js';
+export interface UseActivityDigestOptions extends ActivityDigestOptions {
+    /**
+     * Clock injection for the relative `when` column. Defaults to
+     * `Date.now()` read once per recompute. Pass a fixed value (or a
+     * frozen "session now") for deterministic rendering / tests.
+     *
+     * NOTE: changing `now` between renders re-folds the digest, so don't
+     * pass a fresh `Date.now()` inline unless you want a recompute every
+     * render — pin it (e.g. a ticking value updated on an interval).
+     */
+    now?: number;
+}
+/**
+ * React wrapper over {@link computeActivityDigest} — memoizes the pure
+ * fold over the unified `SandboxEvent` stream into the banded activity
+ * digest. Feed it `sandbox.history()` (a snapshot) or the live buffer
+ * from {@link useActivityStream}; the reducer is identical either way.
+ *
+ * The fold re-runs when `events` identity, any grouping option, or
+ * `now` changes. Keep `events` referentially stable across renders that
+ * shouldn't recompute (the stream hook already returns a stable array
+ * per emission).
+ */
+export declare function useActivityDigest(events: readonly AnyActivityEvent[], options?: UseActivityDigestOptions): ActivityDigest;
+//# sourceMappingURL=useActivityDigest.d.ts.map