@stigmer/react 0.0.36 → 0.0.40

package/search/useResourceList.d.ts

@@ -0,0 +1,48 @@
+import type { ListParams, ListResult } from "@stigmer/sdk";
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+/**
+ * Scope controls resource listing boundaries.
+ *
+ * - `"org"` — resources owned by the active organization (public and private).
+ * - `"all"` — all resources the caller can access, across every organization.
+ */
+export type ResourceListScope = "org" | "all";
+export interface UseResourceListOptions {
+    /** Maximum results per page. @default 20 */
+    readonly pageSize?: number;
+    /** Page number (1-indexed). @default 1 */
+    readonly page?: number;
+    /** Text query to filter results. No debouncing is applied — the consumer controls timing. */
+    readonly query?: string;
+    /**
+     * Controls resource visibility scope.
+     *
+     * - `"org"` — all resources owned by the given organization, regardless of visibility.
+     * - `"all"` — all resources the caller is authorized to access, across all organizations.
+     *
+     * @default "org"
+     */
+    readonly scope?: ResourceListScope;
+}
+export interface UseResourceListReturn {
+    readonly entries: readonly SearchResult[];
+    readonly totalCount: number;
+    readonly totalPages: number;
+    readonly currentPage: number;
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    readonly refetch: () => void;
+}
+/**
+ * Internal hook that provides paginated, scope-aware resource listing.
+ *
+ * Powers the public resource list hooks (`useAgentList`, `useSkillList`,
+ * `useMcpServerList`) — not exported from the public API.
+ *
+ * Unlike {@link useResourceSearch} which manages its own debounced query
+ * state for picker/type-ahead UX, this hook accepts all parameters
+ * externally, giving the consumer full control over query timing,
+ * pagination state, and scope toggling.
+ */
+export declare function useResourceList(listFn: (params: ListParams) => Promise<ListResult>, org: string | null, options?: UseResourceListOptions): UseResourceListReturn;
+//# sourceMappingURL=useResourceList.d.ts.map

package/search/useResourceList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceList.d.ts","sourceRoot":"","sources":["../../src/search/useResourceList.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,EACnD,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAmEvB"}

package/search/useResourceList.js

@@ -0,0 +1,73 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+const DEFAULT_PAGE_SIZE = 20;
+const DEFAULT_PAGE = 1;
+/**
+ * Internal hook that provides paginated, scope-aware resource listing.
+ *
+ * Powers the public resource list hooks (`useAgentList`, `useSkillList`,
+ * `useMcpServerList`) — not exported from the public API.
+ *
+ * Unlike {@link useResourceSearch} which manages its own debounced query
+ * state for picker/type-ahead UX, this hook accepts all parameters
+ * externally, giving the consumer full control over query timing,
+ * pagination state, and scope toggling.
+ */
+export function useResourceList(listFn, org, options) {
+    const [entries, setEntries] = useState([]);
+    const [totalCount, setTotalCount] = useState(0);
+    const [totalPages, setTotalPages] = useState(0);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const pageSize = options?.pageSize ?? DEFAULT_PAGE_SIZE;
+    const page = options?.page ?? DEFAULT_PAGE;
+    const query = options?.query;
+    const scope = options?.scope ?? "org";
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!org) {
+            setEntries([]);
+            setTotalCount(0);
+            setTotalPages(0);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        const params = {
+            org: scope === "all" ? "" : org,
+            query: query || undefined,
+            excludePublic: false,
+            page: { num: page, size: pageSize },
+        };
+        listFn(params).then((result) => {
+            if (cancelled.current)
+                return;
+            setEntries([...result.entries]);
+            setTotalCount(result.totalCount);
+            setTotalPages(result.totalPages);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(err instanceof Error ? err.message : "Failed to load resources");
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [listFn, org, query, scope, page, pageSize, fetchKey]);
+    return {
+        entries,
+        totalCount,
+        totalPages,
+        currentPage: page,
+        isLoading,
+        error,
+        refetch,
+    };
+}
+//# sourceMappingURL=useResourceList.js.map

package/search/useResourceList.js.map

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

package/search/useResourceSearch.d.ts

@@ -0,0 +1,27 @@
+import type { ListParams, ListResult } from "@stigmer/sdk";
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+export interface UseResourceSearchOptions {
+    /** Maximum results per page. @default 30 */
+    readonly pageSize?: number;
+    /** Debounce delay for query changes in milliseconds. @default 300 */
+    readonly debounceMs?: number;
+}
+export interface UseResourceSearchReturn {
+    readonly results: readonly SearchResult[];
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    readonly query: string;
+    readonly setQuery: (query: string) => void;
+    readonly refetch: () => void;
+}
+/**
+ * Internal hook that powers both `useMcpServerSearch` and `useSkillSearch`.
+ *
+ * Wraps a `ListParams -> ListResult` function with query state management,
+ * debounced search, loading/error tracking, and cancellation-safe fetching.
+ *
+ * Not exported from the public API — consumers use the resource-specific
+ * hooks (`useMcpServerSearch`, `useSkillSearch`) instead.
+ */
+export declare function useResourceSearch(listFn: (params: ListParams) => Promise<ListResult>, org: string, options?: UseResourceSearchOptions): UseResourceSearchReturn;
+//# sourceMappingURL=useResourceSearch.d.ts.map

package/search/useResourceSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceSearch.d.ts","sourceRoot":"","sources":["../../src/search/useResourceSearch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE/E,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAKD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,EACnD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CAmDzB"}

package/search/useResourceSearch.js

@@ -0,0 +1,55 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+const DEFAULT_PAGE_SIZE = 30;
+const DEFAULT_DEBOUNCE_MS = 300;
+/**
+ * Internal hook that powers both `useMcpServerSearch` and `useSkillSearch`.
+ *
+ * Wraps a `ListParams -> ListResult` function with query state management,
+ * debounced search, loading/error tracking, and cancellation-safe fetching.
+ *
+ * Not exported from the public API — consumers use the resource-specific
+ * hooks (`useMcpServerSearch`, `useSkillSearch`) instead.
+ */
+export function useResourceSearch(listFn, org, options) {
+    const [results, setResults] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [query, setQuery] = useState("");
+    const [debouncedQuery, setDebouncedQuery] = useState("");
+    const [fetchKey, setFetchKey] = useState(0);
+    const pageSize = options?.pageSize ?? DEFAULT_PAGE_SIZE;
+    const debounceMs = options?.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    // Debounce query changes
+    useEffect(() => {
+        const timer = setTimeout(() => setDebouncedQuery(query), debounceMs);
+        return () => clearTimeout(timer);
+    }, [query, debounceMs]);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        const params = {
+            org,
+            query: debouncedQuery || undefined,
+            page: { num: 1, size: pageSize },
+        };
+        listFn(params).then((result) => {
+            if (cancelled.current)
+                return;
+            setResults([...result.entries]);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(err instanceof Error ? err.message : "Failed to load resources");
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [listFn, org, debouncedQuery, pageSize, fetchKey]);
+    return { results, isLoading, error, query, setQuery, refetch };
+}
+//# sourceMappingURL=useResourceSearch.js.map

package/search/useResourceSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceSearch.js","sourceRoot":"","sources":["../../src/search/useResourceSearch.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAU,QAAQ,EAAE,MAAM,OAAO,CAAC;AAoBjE,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAmD,EACnD,GAAW,EACX,OAAkC;IAElC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAiB,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC;IACxD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAE9D,yBAAyB;IACzB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;QACrE,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAExB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,MAAM,GAAe;YACzB,GAAG;YACH,KAAK,EAAE,cAAc,IAAI,SAAS;YAClC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;SACjC,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CACjB,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAChC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CACN,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAChE,CAAC;YACF,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEtD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC"}

package/session/__tests__/group-sessions.test.d.ts

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

package/session/__tests__/group-sessions.test.d.ts.map

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

package/session/__tests__/group-sessions.test.js

@@ -0,0 +1,91 @@
+import { describe, it, expect } from "vitest";
+import { create } from "@bufbuild/protobuf";
+import { timestampFromDate } from "@bufbuild/protobuf/wkt";
+import { SessionSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import { ApiResourceAuditStatusSchema, ApiResourceAuditSchema, ApiResourceAuditInfoSchema, } from "@stigmer/protos/ai/stigmer/commons/apiresource/status_pb";
+import { groupSessionsByTime } from "../group-sessions";
+const NOW = new Date("2026-03-18T14:00:00Z");
+function makeSession(date) {
+    const session = create(SessionSchema);
+    if (date) {
+        const auditInfo = create(ApiResourceAuditInfoSchema);
+        auditInfo.createdAt = timestampFromDate(date);
+        const audit = create(ApiResourceAuditSchema);
+        audit.specAudit = auditInfo;
+        const status = create(ApiResourceAuditStatusSchema);
+        status.audit = audit;
+        session.status = status;
+    }
+    return session;
+}
+function daysAgo(days) {
+    const d = new Date(NOW);
+    d.setDate(d.getDate() - days);
+    return d;
+}
+function labels(groups) {
+    return groups.map((g) => g.label);
+}
+describe("groupSessionsByTime", () => {
+    it("returns empty array for empty input", () => {
+        expect(groupSessionsByTime([], NOW)).toEqual([]);
+    });
+    it("groups a session created today into 'Today'", () => {
+        const groups = groupSessionsByTime([makeSession(NOW)], NOW);
+        expect(labels(groups)).toEqual(["Today"]);
+        expect(groups[0].sessions).toHaveLength(1);
+    });
+    it("groups a session from yesterday into 'Yesterday'", () => {
+        const groups = groupSessionsByTime([makeSession(daysAgo(1))], NOW);
+        expect(labels(groups)).toEqual(["Yesterday"]);
+    });
+    it("groups a session from 3 days ago into 'Previous 7 Days'", () => {
+        const groups = groupSessionsByTime([makeSession(daysAgo(3))], NOW);
+        expect(labels(groups)).toEqual(["Previous 7 Days"]);
+    });
+    it("groups a session from 15 days ago into 'Previous 30 Days'", () => {
+        const groups = groupSessionsByTime([makeSession(daysAgo(15))], NOW);
+        expect(labels(groups)).toEqual(["Previous 30 Days"]);
+    });
+    it("groups a session from 60 days ago into 'Older'", () => {
+        const groups = groupSessionsByTime([makeSession(daysAgo(60))], NOW);
+        expect(labels(groups)).toEqual(["Older"]);
+    });
+    it("omits empty groups from the result", () => {
+        const groups = groupSessionsByTime([makeSession(NOW), makeSession(daysAgo(60))], NOW);
+        expect(labels(groups)).toEqual(["Today", "Older"]);
+    });
+    it("places sessions with missing timestamps in 'Older'", () => {
+        const groups = groupSessionsByTime([makeSession(null)], NOW);
+        expect(labels(groups)).toEqual(["Older"]);
+        expect(groups[0].sessions).toHaveLength(1);
+    });
+    it("preserves input order within each group", () => {
+        const s1 = makeSession(NOW);
+        const s2 = makeSession(NOW);
+        const s3 = makeSession(NOW);
+        const groups = groupSessionsByTime([s1, s2, s3], NOW);
+        expect(groups[0].sessions[0]).toBe(s1);
+        expect(groups[0].sessions[1]).toBe(s2);
+        expect(groups[0].sessions[2]).toBe(s3);
+    });
+    it("distributes sessions across all five buckets", () => {
+        const sessions = [
+            makeSession(NOW),
+            makeSession(daysAgo(1)),
+            makeSession(daysAgo(4)),
+            makeSession(daysAgo(20)),
+            makeSession(daysAgo(60)),
+        ];
+        const groups = groupSessionsByTime(sessions, NOW);
+        expect(labels(groups)).toEqual([
+            "Today",
+            "Yesterday",
+            "Previous 7 Days",
+            "Previous 30 Days",
+            "Older",
+        ]);
+        groups.forEach((g) => expect(g.sessions).toHaveLength(1));
+    });
+});
+//# sourceMappingURL=group-sessions.test.js.map

package/session/__tests__/group-sessions.test.js.map

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

package/session/__tests__/useSessionConversation.test.d.ts

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

package/session/__tests__/useSessionConversation.test.d.ts.map

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

package/session/__tests__/useSessionConversation.test.js

@@ -0,0 +1,209 @@
+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 { create } from "@bufbuild/protobuf";
+import { AgentExecutionSchema, AgentExecutionStatusSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { SessionSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { StigmerContext } from "../../context";
+import { useSessionConversation } from "../useSessionConversation";
+function makeSession(id) {
+    const session = create(SessionSchema);
+    const metadata = create(ApiResourceMetadataSchema);
+    metadata.id = id;
+    session.metadata = metadata;
+    return session;
+}
+function makeExecution(id, phase) {
+    const exec = create(AgentExecutionSchema);
+    const metadata = create(ApiResourceMetadataSchema);
+    metadata.id = id;
+    exec.metadata = metadata;
+    const status = create(AgentExecutionStatusSchema);
+    status.phase = phase;
+    exec.status = status;
+    return exec;
+}
+/**
+ * Creates a controllable async generator for streaming.
+ */
+function createControllableStream() {
+    let resolve = null;
+    let reject = null;
+    const generator = {
+        next() {
+            return new Promise((res, rej) => {
+                resolve = res;
+                reject = rej;
+            });
+        },
+        return(value) {
+            return Promise.resolve({ done: true, value: value });
+        },
+        throw(err) {
+            return Promise.reject(err);
+        },
+        [Symbol.asyncIterator]() {
+            return generator;
+        },
+    };
+    return {
+        generator,
+        push(value) {
+            resolve?.({ done: false, value });
+        },
+        finish() {
+            resolve?.({ done: true, value: undefined });
+        },
+        fail(err) {
+            reject?.(err);
+        },
+    };
+}
+function createMockStigmer(methods) {
+    return {
+        session: {
+            get: methods.sessionGet,
+        },
+        agentExecution: {
+            listBySession: methods.listBySession,
+            create: methods.executionCreate,
+            subscribe: methods.subscribe,
+            submitApproval: methods.submitApproval,
+        },
+    };
+}
+function createWrapper(client) {
+    return function Wrapper({ children }) {
+        return (_jsx(StigmerContext.Provider, { value: client, children: children }));
+    };
+}
+describe("useSessionConversation", () => {
+    let methods;
+    let mockStigmer;
+    let stream;
+    beforeEach(() => {
+        stream = createControllableStream();
+        methods = {
+            sessionGet: vi.fn().mockResolvedValue(makeSession("session-1")),
+            listBySession: vi.fn().mockResolvedValue({ entries: [] }),
+            executionCreate: vi.fn(),
+            subscribe: vi.fn().mockReturnValue(stream.generator),
+            submitApproval: vi.fn().mockResolvedValue({}),
+        };
+        mockStigmer = createMockStigmer(methods);
+    });
+    it("returns idle state when sessionId is null", () => {
+        const { result } = renderHook(() => useSessionConversation(null, "org"), { wrapper: createWrapper(mockStigmer) });
+        expect(result.current.session).toBeNull();
+        expect(result.current.isLoading).toBe(false);
+        expect(result.current.canSendFollowUp).toBe(true);
+        expect(methods.sessionGet).not.toHaveBeenCalled();
+        expect(methods.listBySession).not.toHaveBeenCalled();
+    });
+    it("isLoading is true while session and executions are loading", () => {
+        methods.sessionGet.mockReturnValue(new Promise(() => { }));
+        methods.listBySession.mockReturnValue(new Promise(() => { }));
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        expect(result.current.isLoading).toBe(true);
+    });
+    it("loads session and executions on mount", async () => {
+        const session = makeSession("session-1");
+        methods.sessionGet.mockResolvedValue(session);
+        methods.listBySession.mockResolvedValue({ entries: [] });
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        await waitFor(() => {
+            expect(result.current.session).toBe(session);
+            expect(result.current.isLoading).toBe(false);
+        });
+    });
+    it("surfaces session fetch errors in loadError", async () => {
+        methods.sessionGet.mockRejectedValue(new Error("session not found"));
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        await waitFor(() => {
+            expect(result.current.loadError?.message).toBe("session not found");
+        });
+    });
+    it("completedExecutions excludes the active non-terminal execution", async () => {
+        const completed = makeExecution("e1", ExecutionPhase.EXECUTION_COMPLETED);
+        const active = makeExecution("e2", ExecutionPhase.EXECUTION_IN_PROGRESS);
+        methods.listBySession.mockResolvedValue({
+            entries: [completed, active],
+        });
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        await waitFor(() => {
+            expect(result.current.completedExecutions).toHaveLength(1);
+            expect(result.current.completedExecutions[0]).toBe(completed);
+        });
+    });
+    it("canSendFollowUp is true when no active execution", async () => {
+        const completed = makeExecution("e1", ExecutionPhase.EXECUTION_COMPLETED);
+        methods.listBySession.mockResolvedValue({ entries: [completed] });
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        await waitFor(() => {
+            expect(result.current.canSendFollowUp).toBe(true);
+        });
+    });
+    it("canSendFollowUp is false while an execution is active", async () => {
+        const active = makeExecution("e1", ExecutionPhase.EXECUTION_IN_PROGRESS);
+        methods.listBySession.mockResolvedValue({ entries: [active] });
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        await waitFor(() => {
+            expect(result.current.canSendFollowUp).toBe(false);
+        });
+    });
+    it("sendFollowUp sets pendingUserMessage optimistically", async () => {
+        methods.listBySession.mockResolvedValue({ entries: [] });
+        const newExec = makeExecution("new-exec", ExecutionPhase.EXECUTION_PENDING);
+        newExec.metadata.id = "new-exec";
+        methods.executionCreate.mockResolvedValue(newExec);
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+        act(() => {
+            result.current.sendFollowUp("Hello agent");
+        });
+        expect(result.current.pendingUserMessage).toBe("Hello agent");
+    });
+    it("sendFollowUp creates execution via the SDK", async () => {
+        methods.listBySession.mockResolvedValue({ entries: [] });
+        const newExec = makeExecution("new-exec", ExecutionPhase.EXECUTION_PENDING);
+        newExec.metadata.id = "new-exec";
+        methods.executionCreate.mockResolvedValue(newExec);
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+        await act(async () => {
+            await result.current.sendFollowUp("Deploy it");
+        });
+        expect(methods.executionCreate).toHaveBeenCalledWith(expect.objectContaining({
+            org: "org",
+            sessionId: "session-1",
+            message: "Deploy it",
+        }));
+    });
+    it("pendingUserMessage clears when stream delivers first snapshot", async () => {
+        methods.listBySession.mockResolvedValue({ entries: [] });
+        const newExec = makeExecution("new-exec", ExecutionPhase.EXECUTION_PENDING);
+        newExec.metadata.id = "new-exec";
+        methods.executionCreate.mockResolvedValue(newExec);
+        const newStream = createControllableStream();
+        methods.subscribe.mockReturnValue(newStream.generator);
+        const { result } = renderHook(() => useSessionConversation("session-1", "org"), { wrapper: createWrapper(mockStigmer) });
+        await waitFor(() => expect(result.current.isLoading).toBe(false));
+        await act(async () => {
+            await result.current.sendFollowUp("Hello");
+        });
+        expect(result.current.pendingUserMessage).toBe("Hello");
+        act(() => {
+            newStream.push(makeExecution("new-exec", ExecutionPhase.EXECUTION_IN_PROGRESS));
+        });
+        await waitFor(() => {
+            expect(result.current.pendingUserMessage).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=useSessionConversation.test.js.map

package/session/__tests__/useSessionConversation.test.js.map

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

package/session/group-sessions.d.ts

@@ -0,0 +1,20 @@
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+export interface SessionGroup {
+    /** Display label for this group (e.g. "Today", "Yesterday"). */
+    readonly label: string;
+    /** Sessions belonging to this group, in their original input order. */
+    readonly sessions: readonly Session[];
+}
+/**
+ * Groups sessions by their creation timestamp into time-based buckets:
+ * "Today", "Yesterday", "Previous 7 Days", "Previous 30 Days", "Older".
+ *
+ * Empty groups are omitted. Sessions with missing timestamps are placed
+ * in the last group. Input order is preserved within each group.
+ *
+ * @param sessions - List of sessions to group (typically from `useSessionList`).
+ * @param now - Reference time for grouping; defaults to the current time.
+ *              Accepts an explicit value for deterministic testing.
+ */
+export declare function groupSessionsByTime(sessions: readonly Session[], now?: Date): readonly SessionGroup[];
+//# sourceMappingURL=group-sessions.d.ts.map

package/session/group-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-sessions.d.ts","sourceRoot":"","sources":["../../src/session/group-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAGpF,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,GAAG,CAAC,EAAE,IAAI,GACT,SAAS,YAAY,EAAE,CAsCzB"}