@stigmer/react 1.0.4 → 2.0.1

package/__tests__/hooks.test.js

@@ -3,6 +3,7 @@ import { describe, it, expect } from "vitest";
 import { renderHook } from "@testing-library/react";
 import { StigmerContext } from "../context";
 import { useStigmer } from "../hooks";
+import { ExecutionTargetContext, useExecutionTarget } from "../execution-target-context";
 describe("useStigmer", () => {
     it("throws when used outside StigmerProvider", () => {
         expect(() => renderHook(() => useStigmer())).toThrow("useStigmer must be used within <StigmerProvider>. " +
@@ -15,4 +16,20 @@ describe("useStigmer", () => {
         expect(result.current).toBe(mockClient);
     });
 });
+describe("useExecutionTarget", () => {
+    it("returns undefined when no ExecutionTargetContext.Provider wraps it", () => {
+        const { result } = renderHook(() => useExecutionTarget());
+        expect(result.current).toBeUndefined();
+    });
+    it("returns 'local' when provider sets executionTarget to local", () => {
+        const wrapper = ({ children }) => (_jsx(ExecutionTargetContext.Provider, { value: "local", children: children }));
+        const { result } = renderHook(() => useExecutionTarget(), { wrapper });
+        expect(result.current).toBe("local");
+    });
+    it("returns 'cloud' when provider sets executionTarget to cloud", () => {
+        const wrapper = ({ children }) => (_jsx(ExecutionTargetContext.Provider, { value: "cloud", children: children }));
+        const { result } = renderHook(() => useExecutionTarget(), { wrapper });
+        expect(result.current).toBe("cloud");
+    });
+});
 //# sourceMappingURL=hooks.test.js.map

package/__tests__/hooks.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.test.js","sourceRoot":"","sources":["../../src/__tests__/hooks.test.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAClD,oDAAoD;YAClD,yEAAyE,CAC5E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,EAAE,EAAwB,CAAC;QAEvD,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAA2B,EAAE,EAAE,CAAC,CACzD,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,YACvC,QAAQ,GACe,CAC3B,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"hooks.test.js","sourceRoot":"","sources":["../../src/__tests__/hooks.test.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEzF,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAClD,oDAAoD;YAClD,yEAAyE,CAC5E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,EAAE,EAAwB,CAAC;QAEvD,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAA2B,EAAE,EAAE,CAAC,CACzD,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,YACvC,QAAQ,GACe,CAC3B,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAA2B,EAAE,EAAE,CAAC,CACzD,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAC,OAAO,YAC3C,QAAQ,GACuB,CACnC,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,kBAAkB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAA2B,EAAE,EAAE,CAAC,CACzD,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAC,OAAO,YAC3C,QAAQ,GACuB,CACnC,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,kBAAkB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/__tests__/runner-adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner-adapter.test.d.ts.map

package/__tests__/runner-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-adapter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runner-adapter.test.tsx"],"names":[],"mappings":""}

package/__tests__/runner-adapter.test.js

@@ -0,0 +1,153 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { renderHook, act } from "@testing-library/react";
+import { StigmerContext } from "../context";
+import { FetchCacheContext } from "../internal/FetchCacheProvider";
+import { ExecutionTargetContext } from "../execution-target-context";
+import { RunnerAdapterContext, useRunnerAdapter } from "../runner-adapter";
+import { useCreateSession } from "../session/useCreateSession";
+function createMockAdapter() {
+    return {
+        onSessionCreated: vi.fn().mockResolvedValue(undefined),
+        onSessionTerminated: vi.fn().mockResolvedValue(undefined),
+        onWorkflowExecutionCreated: vi.fn().mockResolvedValue(undefined),
+        onWorkflowExecutionTerminated: vi.fn().mockResolvedValue(undefined),
+    };
+}
+function createMockStigmer(overrides = {}) {
+    return {
+        agent: {
+            getByReference: vi.fn().mockResolvedValue({
+                status: { defaultInstanceId: "ain-default" },
+            }),
+        },
+        session: {
+            create: overrides.create ?? vi.fn().mockResolvedValue({
+                metadata: { id: "ses-new-1" },
+            }),
+        },
+    };
+}
+function wrapperWithAdapter(client, adapter, executionTarget) {
+    return function Wrapper({ children }) {
+        return (_jsx(FetchCacheContext.Provider, { value: null, children: _jsx(ExecutionTargetContext.Provider, { value: executionTarget, children: _jsx(RunnerAdapterContext.Provider, { value: adapter, children: _jsx(StigmerContext.Provider, { value: client, children: children }) }) }) }));
+    };
+}
+describe("RunnerAdapter", () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe("useRunnerAdapter", () => {
+        it("returns null when no adapter is provided", () => {
+            const { result } = renderHook(() => useRunnerAdapter(), {
+                wrapper: wrapperWithAdapter(createMockStigmer(), null),
+            });
+            expect(result.current).toBeNull();
+        });
+        it("returns the adapter when provided", () => {
+            const adapter = createMockAdapter();
+            const { result } = renderHook(() => useRunnerAdapter(), {
+                wrapper: wrapperWithAdapter(createMockStigmer(), adapter),
+            });
+            expect(result.current).toBe(adapter);
+        });
+    });
+    describe("useCreateSession + adapter integration", () => {
+        it("calls adapter.onSessionCreated when target is local", async () => {
+            const adapter = createMockAdapter();
+            const client = createMockStigmer();
+            const { result } = renderHook(() => useCreateSession(), {
+                wrapper: wrapperWithAdapter(client, adapter, "local"),
+            });
+            await act(async () => {
+                await result.current.create({
+                    org: "acme",
+                    agentInstanceId: "ain-123",
+                });
+            });
+            expect(adapter.onSessionCreated).toHaveBeenCalledTimes(1);
+            expect(adapter.onSessionCreated).toHaveBeenCalledWith("ses-new-1");
+        });
+        it("does NOT call adapter when target is cloud", async () => {
+            const adapter = createMockAdapter();
+            const client = createMockStigmer();
+            const { result } = renderHook(() => useCreateSession(), {
+                wrapper: wrapperWithAdapter(client, adapter, "cloud"),
+            });
+            await act(async () => {
+                await result.current.create({
+                    org: "acme",
+                    agentInstanceId: "ain-123",
+                });
+            });
+            expect(adapter.onSessionCreated).not.toHaveBeenCalled();
+        });
+        it("does NOT call adapter when target is unspecified", async () => {
+            const adapter = createMockAdapter();
+            const client = createMockStigmer();
+            const { result } = renderHook(() => useCreateSession(), {
+                wrapper: wrapperWithAdapter(client, adapter, undefined),
+            });
+            await act(async () => {
+                await result.current.create({
+                    org: "acme",
+                    agentInstanceId: "ain-123",
+                });
+            });
+            expect(adapter.onSessionCreated).not.toHaveBeenCalled();
+        });
+        it("does NOT call adapter when adapter is null", async () => {
+            const client = createMockStigmer();
+            const { result } = renderHook(() => useCreateSession(), {
+                wrapper: wrapperWithAdapter(client, null, "local"),
+            });
+            await act(async () => {
+                await result.current.create({
+                    org: "acme",
+                    agentInstanceId: "ain-123",
+                });
+            });
+            // No error — adapter call is simply skipped
+            expect(result.current.error).toBeNull();
+        });
+        it("propagates adapter errors to the caller", async () => {
+            const adapter = createMockAdapter();
+            adapter.onSessionCreated.mockRejectedValue(new Error("Runner failed to start"));
+            const client = createMockStigmer();
+            const { result } = renderHook(() => useCreateSession(), {
+                wrapper: wrapperWithAdapter(client, adapter, "local"),
+            });
+            let caughtError;
+            await act(async () => {
+                try {
+                    await result.current.create({
+                        org: "acme",
+                        agentInstanceId: "ain-123",
+                    });
+                }
+                catch (err) {
+                    caughtError = err;
+                }
+            });
+            expect(caughtError).toBeTruthy();
+            expect(caughtError.message).toBe("Runner failed to start");
+        });
+        it("uses per-call executionTarget over context for adapter guard", async () => {
+            const adapter = createMockAdapter();
+            const client = createMockStigmer();
+            // Context is "cloud" but per-call is "local"
+            const { result } = renderHook(() => useCreateSession(), {
+                wrapper: wrapperWithAdapter(client, adapter, "cloud"),
+            });
+            await act(async () => {
+                await result.current.create({
+                    org: "acme",
+                    agentInstanceId: "ain-123",
+                    executionTarget: "local",
+                });
+            });
+            expect(adapter.onSessionCreated).toHaveBeenCalledTimes(1);
+        });
+    });
+});
+//# sourceMappingURL=runner-adapter.test.js.map

package/__tests__/runner-adapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-adapter.test.js","sourceRoot":"","sources":["../../src/__tests__/runner-adapter.test.tsx"],"names":[],"mappings":"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"}

package/activity/__tests__/useRecentActivity-optimistic.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useRecentActivity-optimistic.test.d.ts.map

package/activity/__tests__/useRecentActivity-optimistic.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecentActivity-optimistic.test.d.ts","sourceRoot":"","sources":["../../../src/activity/__tests__/useRecentActivity-optimistic.test.tsx"],"names":[],"mappings":""}

package/activity/__tests__/useRecentActivity-optimistic.test.js

@@ -0,0 +1,139 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { renderHook, act, waitFor } from "@testing-library/react";
+import { StigmerContext } from "../../context";
+import { FetchCacheContext } from "../../internal/FetchCacheProvider";
+import { useRecentActivity } from "../useRecentActivity";
+vi.mock("../../organization/OrgProvider", () => ({
+    useActiveOrgSlug: () => "test-org",
+}));
+function createMockStigmer(overrides = {}) {
+    return {
+        activity: {
+            listRecentActivity: overrides.listRecentActivity ??
+                vi.fn().mockResolvedValue({ entries: [] }),
+        },
+    };
+}
+function wrapper(client) {
+    return function Wrapper({ children }) {
+        return (_jsx(FetchCacheContext.Provider, { value: null, children: _jsx(StigmerContext.Provider, { value: client, children: children }) }));
+    };
+}
+async function flush() {
+    await act(async () => {
+        await Promise.resolve();
+    });
+}
+describe("useRecentActivity — optimistic prepend", () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("prependOptimistic adds entry at position 0", async () => {
+        const listRecentActivity = vi.fn().mockResolvedValue({ entries: [] });
+        const client = createMockStigmer({ listRecentActivity });
+        const { result } = renderHook(() => useRecentActivity(), {
+            wrapper: wrapper(client),
+        });
+        await flush();
+        expect(result.current.entries).toHaveLength(0);
+        act(() => {
+            result.current.prependOptimistic({
+                id: "wfx_new",
+                type: "workflow_execution",
+                subject: "New Execution",
+            });
+        });
+        expect(result.current.entries).toHaveLength(1);
+        expect(result.current.entries[0].id).toBe("wfx_new");
+        expect(result.current.entries[0].type).toBe("workflow_execution");
+        expect(result.current.entries[0].subject).toBe("New Execution");
+        expect(result.current.entries[0].updatedAt.getTime()).toBeGreaterThan(0);
+    });
+    it("optimistic entry appears above server entries", async () => {
+        const serverEntries = [
+            { id: "old_1", type: "session", subject: "Old session", updatedAt: { seconds: BigInt(1716800000), nanos: 0 }, status: "" },
+            { id: "old_2", type: "workflow_execution", subject: "Old exec", updatedAt: { seconds: BigInt(1716790000), nanos: 0 }, status: "completed" },
+        ];
+        const listRecentActivity = vi.fn().mockResolvedValue({ entries: serverEntries });
+        const client = createMockStigmer({ listRecentActivity });
+        const { result } = renderHook(() => useRecentActivity(), {
+            wrapper: wrapper(client),
+        });
+        await flush();
+        expect(result.current.entries).toHaveLength(2);
+        act(() => {
+            result.current.prependOptimistic({
+                id: "wfx_brand_new",
+                type: "workflow_execution",
+                subject: "Brand New Execution",
+            });
+        });
+        expect(result.current.entries).toHaveLength(3);
+        expect(result.current.entries[0].id).toBe("wfx_brand_new");
+        expect(result.current.entries[1].id).toBe("old_1");
+        expect(result.current.entries[2].id).toBe("old_2");
+    });
+    it("optimistic entry is deduplicated when server data includes its ID", async () => {
+        let fetchCount = 0;
+        const listRecentActivity = vi.fn().mockImplementation(async () => {
+            fetchCount++;
+            if (fetchCount === 1) {
+                return { entries: [] };
+            }
+            return {
+                entries: [
+                    { id: "wfx_new", type: "workflow_execution", subject: "Server-resolved name", updatedAt: { seconds: BigInt(1716810000), nanos: 0 }, status: "" },
+                ],
+            };
+        });
+        const client = createMockStigmer({ listRecentActivity });
+        const { result } = renderHook(() => useRecentActivity(), {
+            wrapper: wrapper(client),
+        });
+        await flush();
+        act(() => {
+            result.current.prependOptimistic({
+                id: "wfx_new",
+                type: "workflow_execution",
+                subject: "Loading\u2026",
+            });
+        });
+        expect(result.current.entries).toHaveLength(1);
+        expect(result.current.entries[0].subject).toBe("Loading\u2026");
+        // Trigger refetch — server now returns the entry
+        act(() => {
+            result.current.refetch();
+        });
+        await flush();
+        await waitFor(() => {
+            expect(result.current.entries).toHaveLength(1);
+            expect(result.current.entries[0].subject).toBe("Server-resolved name");
+        });
+    });
+    it("does not duplicate if prependOptimistic is called twice with same id", async () => {
+        const listRecentActivity = vi.fn().mockResolvedValue({ entries: [] });
+        const client = createMockStigmer({ listRecentActivity });
+        const { result } = renderHook(() => useRecentActivity(), {
+            wrapper: wrapper(client),
+        });
+        await flush();
+        act(() => {
+            result.current.prependOptimistic({
+                id: "wfx_dup",
+                type: "workflow_execution",
+                subject: "First call",
+            });
+        });
+        act(() => {
+            result.current.prependOptimistic({
+                id: "wfx_dup",
+                type: "workflow_execution",
+                subject: "Second call",
+            });
+        });
+        expect(result.current.entries).toHaveLength(1);
+        expect(result.current.entries[0].subject).toBe("First call");
+    });
+});
+//# sourceMappingURL=useRecentActivity-optimistic.test.js.map

package/activity/__tests__/useRecentActivity-optimistic.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecentActivity-optimistic.test.js","sourceRoot":"","sources":["../../../src/activity/__tests__/useRecentActivity-optimistic.test.tsx"],"names":[],"mappings":"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"}

package/activity/__tests__/useRecentActivity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useRecentActivity.test.d.ts.map

package/activity/__tests__/useRecentActivity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecentActivity.test.d.ts","sourceRoot":"","sources":["../../../src/activity/__tests__/useRecentActivity.test.ts"],"names":[],"mappings":""}

package/activity/__tests__/useRecentActivity.test.js

@@ -0,0 +1,107 @@
+import { describe, it, expect } from "vitest";
+import { create } from "@bufbuild/protobuf";
+import { timestampFromDate, timestampDate } from "@bufbuild/protobuf/wkt";
+import { RecentActivityEntrySchema, } from "@stigmer/protos/ai/stigmer/activity/v1/io_pb";
+import { groupRecentActivityByTime } from "../group-activity";
+const EPOCH = new Date(0);
+function makeProtoEntry(id, type, subject, updatedAt, status) {
+    const entry = create(RecentActivityEntrySchema);
+    entry.id = id;
+    entry.type = type;
+    entry.subject = subject;
+    entry.updatedAt = timestampFromDate(updatedAt);
+    entry.status = status ?? "";
+    return entry;
+}
+function normalizeEntry(entry) {
+    const updatedAt = entry.updatedAt
+        ? timestampDate(entry.updatedAt)
+        : EPOCH;
+    return {
+        id: entry.id,
+        type: entry.type === "session" ? "session" : "workflow_execution",
+        subject: entry.subject || (entry.type === "session" ? "Untitled session" : "Untitled execution"),
+        updatedAt: updatedAt.getTime() > 0 ? updatedAt : EPOCH,
+        status: entry.status || undefined,
+    };
+}
+describe("normalizeEntry", () => {
+    it("converts proto RecentActivityEntry to local type", () => {
+        const ts = new Date("2026-05-27T12:00:00Z");
+        const proto = makeProtoEntry("wfx_123", "workflow_execution", "my-workflow", ts, "completed");
+        const result = normalizeEntry(proto);
+        expect(result.id).toBe("wfx_123");
+        expect(result.type).toBe("workflow_execution");
+        expect(result.subject).toBe("my-workflow");
+        expect(result.updatedAt.getTime()).toBe(ts.getTime());
+        expect(result.status).toBe("completed");
+    });
+    it("falls back to 'Untitled session' for empty session subject", () => {
+        const ts = new Date("2026-05-27T12:00:00Z");
+        const proto = makeProtoEntry("sess_1", "session", "", ts);
+        const result = normalizeEntry(proto);
+        expect(result.subject).toBe("Untitled session");
+    });
+    it("falls back to 'Untitled execution' for empty execution subject", () => {
+        const ts = new Date("2026-05-27T12:00:00Z");
+        const proto = makeProtoEntry("wfx_1", "workflow_execution", "", ts);
+        const result = normalizeEntry(proto);
+        expect(result.subject).toBe("Untitled execution");
+    });
+    it("uses EPOCH when updatedAt is missing", () => {
+        const entry = create(RecentActivityEntrySchema);
+        entry.id = "sess_2";
+        entry.type = "session";
+        entry.subject = "test";
+        const result = normalizeEntry(entry);
+        expect(result.updatedAt).toEqual(EPOCH);
+    });
+    it("session entries have undefined status", () => {
+        const ts = new Date("2026-05-27T12:00:00Z");
+        const proto = makeProtoEntry("sess_3", "session", "hello", ts);
+        const result = normalizeEntry(proto);
+        expect(result.status).toBeUndefined();
+    });
+});
+describe("groupRecentActivityByTime (server-sorted input)", () => {
+    it("groups entries into Today bucket when all are recent", () => {
+        const now = new Date("2026-05-27T18:00:00Z");
+        const entries = [
+            { id: "a", type: "workflow_execution", subject: "wf-a", updatedAt: new Date("2026-05-27T12:00:00Z") },
+            { id: "b", type: "session", subject: "sess-b", updatedAt: new Date("2026-05-27T10:00:00Z") },
+            { id: "c", type: "workflow_execution", subject: "wf-c", updatedAt: new Date("2026-05-27T08:00:00Z") },
+        ];
+        const groups = groupRecentActivityByTime(entries, now);
+        expect(groups).toHaveLength(1);
+        expect(groups[0].label).toBe("Today");
+        expect(groups[0].entries).toHaveLength(3);
+        expect(groups[0].entries[0].id).toBe("a");
+        expect(groups[0].entries[1].id).toBe("b");
+        expect(groups[0].entries[2].id).toBe("c");
+    });
+    it("preserves server sort order within each bucket", () => {
+        const now = new Date("2026-05-27T18:00:00Z");
+        const entries = [
+            { id: "newest", type: "workflow_execution", subject: "wf", updatedAt: new Date("2026-05-27T14:00:00Z") },
+            { id: "middle", type: "session", subject: "sess", updatedAt: new Date("2026-05-27T10:00:00Z") },
+            { id: "oldest", type: "workflow_execution", subject: "wf2", updatedAt: new Date("2026-05-27T06:00:00Z") },
+        ];
+        const groups = groupRecentActivityByTime(entries, now);
+        expect(groups[0].entries.map((e) => e.id)).toEqual(["newest", "middle", "oldest"]);
+    });
+    it("splits entries across Today and Yesterday", () => {
+        const now = new Date("2026-05-27T18:00:00Z");
+        const entries = [
+            { id: "today", type: "session", subject: "t", updatedAt: new Date("2026-05-27T16:00:00Z") },
+            { id: "yesterday", type: "workflow_execution", subject: "y", updatedAt: new Date("2026-05-25T12:00:00Z") },
+        ];
+        const groups = groupRecentActivityByTime(entries, now);
+        expect(groups.length).toBeGreaterThanOrEqual(2);
+        expect(groups[0].label).toBe("Today");
+        expect(groups[0].entries[0].id).toBe("today");
+        const nonTodayGroup = groups.find((g) => g.label !== "Today");
+        expect(nonTodayGroup).toBeDefined();
+        expect(nonTodayGroup.entries[0].id).toBe("yesterday");
+    });
+});
+//# sourceMappingURL=useRecentActivity.test.js.map

package/activity/__tests__/useRecentActivity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecentActivity.test.js","sourceRoot":"","sources":["../../../src/activity/__tests__/useRecentActivity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EACL,yBAAyB,GAC1B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;AAE1B,SAAS,cAAc,CACrB,EAAU,EACV,IAAsC,EACtC,OAAe,EACf,SAAe,EACf,MAAe;IAEf,MAAM,KAAK,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC/C,KAAK,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAC5B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,KAAiB;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS;QAC/B,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;QAChC,CAAC,CAAC,KAAK,CAAC;IAEV,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB;QACjE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,oBAAoB,CAAC;QAChG,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;QACtD,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;KAClC,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;QAC9F,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAErC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;QAChD,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC;QACpB,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;QACvB,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QACvB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAC/D,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC7C,MAAM,OAAO,GAA0B;YACrC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE;YACrG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE;YAC5F,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE;SACtG,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC7C,MAAM,OAAO,GAA0B;YACrC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE;YACxG,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE;YAC/F,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE;SAC1G,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC7C,MAAM,OAAO,GAA0B;YACrC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE;YAC3F,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE;SAC3G,CAAC;QAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;QAC9D,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,aAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/activity/index.d.ts

@@ -1,4 +1,4 @@
 export type { RecentActivityType, RecentActivityEntry, RecentActivityGroup, } from "./types";
-export { useRecentActivity, type UseRecentActivityOptions, type UseRecentActivityReturn, } from "./useRecentActivity";
+export { useRecentActivity, type UseRecentActivityOptions, type UseRecentActivityReturn, type OptimisticEntryInput, } from "./useRecentActivity";
 export { groupRecentActivityByTime } from "./group-activity";
 //# sourceMappingURL=index.d.ts.map

package/activity/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/activity/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/activity/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/activity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/activity/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,iBAAiB,GAGlB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/activity/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,iBAAiB,GAIlB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/activity/types.d.ts

@@ -14,8 +14,9 @@ export interface RecentActivityEntry {
     readonly subject: string;
     /**
      * Last meaningful update timestamp, used for interleaved sort.
-     * For sessions: `status.audit.specAudit.createdAt`.
-     * For workflow executions: `status.audit.specAudit.createdAt`.
+     * Derived from `status.audit.statusAudit.updatedAt` (bumped on every
+     * meaningful status change), with fallback to `specAudit.createdAt`
+     * for resources that have never been independently updated.
      */
     readonly updatedAt: Date;
     /**

package/activity/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/activity/types.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,oBAAoB,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAClD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/activity/types.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,oBAAoB,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAClD"}

package/activity/useRecentActivity.d.ts

@@ -1,35 +1,47 @@
-import type { RecentActivityEntry } from "./types";
+import type { RecentActivityEntry, RecentActivityType } from "./types";
 /** Options for {@link useRecentActivity}. */
 export interface UseRecentActivityOptions {
     /**
-     * Maximum entries per source. The hook fetches up to `pageSize`
-     * sessions and `pageSize` workflow executions, then merges and
-     * trims to `pageSize` total entries.
+     * Maximum entries to return. The server merges sessions and workflow
+     * executions into a single sorted list and returns at most `pageSize`.
      *
      * @default 30
      */
     readonly pageSize?: number;
 }
+/** Minimal fields required to synthesize an optimistic sidebar entry. */
+export interface OptimisticEntryInput {
+    readonly id: string;
+    readonly type: RecentActivityType;
+    readonly subject: string;
+}
 /** Return value of {@link useRecentActivity}. */
 export interface UseRecentActivityReturn {
     /** Merged entries sorted by `updatedAt` descending. */
     readonly entries: readonly RecentActivityEntry[];
-    /** `true` while either source is loading for the first time. */
+    /** `true` while the initial fetch is in flight. */
     readonly isLoading: boolean;
-    /** First non-null error from either source. */
+    /** First non-null error from the fetch. */
     readonly error: Error | null;
-    /** Re-fetch both sources. */
+    /** Re-fetch from the server. */
     readonly refetch: () => void;
+    /**
+     * Prepend an optimistic entry to the top of the recents list.
+     * The entry is automatically replaced by server data on the next
+     * successful refetch that includes its ID.
+     */
+    readonly prependOptimistic: (entry: OptimisticEntryInput) => void;
 }
 /**
- * Fetches recent agent sessions and workflow executions, merges them
- * into a single list sorted by most-recent-first, and exposes a
- * unified {@link RecentActivityEntry} array.
+ * Fetches recent activity via the unified `listRecentActivity` RPC,
+ * which returns a merged, time-sorted list of the caller's most
+ * recent sessions and workflow executions in a single call.
  *
- * Implementation uses client-side merge of two existing data hooks
- * (`useSessionList` and `useWorkflowExecutionList`), keeping the
- * backend contract unchanged. A dedicated `listRecentActivity` RPC
- * can replace this approach later without changing consumers.
+ * The server handles:
+ * - FGA authorization filtering (or org-scoped fast path)
+ * - Cross-collection merge-sort by `statusAudit.updatedAt`
+ * - Fallback to `specAudit.createdAt` for documents without status updates
+ * - Pagination / trimming to the requested page size
  */
 export declare function useRecentActivity(options?: UseRecentActivityOptions): UseRecentActivityReturn;
 //# sourceMappingURL=useRecentActivity.d.ts.map

package/activity/useRecentActivity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRecentActivity.d.ts","sourceRoot":"","sources":["../../src/activity/useRecentActivity.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAKD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CA6BzB"}
+{"version":3,"file":"useRecentActivity.d.ts","sourceRoot":"","sources":["../../src/activity/useRecentActivity.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEvE,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACnE;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CAgDzB"}