@stigmer/react 3.2.3 → 3.3.0

package/datastore/useInsertRecord.d.ts

@@ -0,0 +1,50 @@
+import { type JsonObject } from "@bufbuild/protobuf";
+import { type RecordEnvelope } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+import type { RecordScope } from "./useRecordList.js";
+/** Arguments for a single record insert. */
+export interface InsertRecordArgs extends RecordScope {
+    /**
+     * Declared field values in their canonical encodings (DD-004). System
+     * field names (`id`, `created_at`, …) are rejected by the server.
+     */
+    readonly record: JsonObject;
+}
+/** Return value of {@link useInsertRecord}. */
+export interface UseInsertRecordReturn {
+    /**
+     * Insert one record. Resolves with the server-stamped envelope (id,
+     * timestamps, attribution). Rejects — and sets `error` — on denial or
+     * constraint violation; the error's message is the server's relayable
+     * text, byte-for-byte (render it verbatim, DD-008 invariant 4).
+     */
+    readonly insertRecord: (args: InsertRecordArgs) => Promise<RecordEnvelope>;
+    /** `true` while the insert is in flight. */
+    readonly isInserting: boolean;
+    /** Error from the last failed insert, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `datastore.insertRecord()` with loading and
+ * error state.
+ *
+ * Constraint violations (`ALREADY_EXISTS` for uniques,
+ * `FAILED_PRECONDITION` for checks) carry the constraint's declared
+ * message plus a `google.rpc.ErrorInfo` naming the constraint — use
+ * `getRecordConstraint` from `@stigmer/sdk` to place the message next
+ * to the fields it covers.
+ *
+ * @example
+ * ```tsx
+ * const { insertRecord, isInserting, error } = useInsertRecord();
+ * await insertRecord({
+ *   org: "acme",
+ *   datastore: "clinic",
+ *   collection: "bookings",
+ *   record: { slot_date: "2026-07-22", slot_time: "09:30:00" },
+ * });
+ * ```
+ */
+export declare function useInsertRecord(): UseInsertRecordReturn;
+//# sourceMappingURL=useInsertRecord.d.ts.map

package/datastore/useInsertRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInsertRecord.d.ts","sourceRoot":"","sources":["../../src/datastore/useInsertRecord.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,8DAA8D,CAAC;AAGtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3E,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAgCvD"}

package/datastore/useInsertRecord.js

@@ -0,0 +1,55 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { InsertRecordRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that wraps `datastore.insertRecord()` with loading and
+ * error state.
+ *
+ * Constraint violations (`ALREADY_EXISTS` for uniques,
+ * `FAILED_PRECONDITION` for checks) carry the constraint's declared
+ * message plus a `google.rpc.ErrorInfo` naming the constraint — use
+ * `getRecordConstraint` from `@stigmer/sdk` to place the message next
+ * to the fields it covers.
+ *
+ * @example
+ * ```tsx
+ * const { insertRecord, isInserting, error } = useInsertRecord();
+ * await insertRecord({
+ *   org: "acme",
+ *   datastore: "clinic",
+ *   collection: "bookings",
+ *   record: { slot_date: "2026-07-22", slot_time: "09:30:00" },
+ * });
+ * ```
+ */
+export function useInsertRecord() {
+    const stigmer = useStigmer();
+    const [isInserting, setIsInserting] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const insertRecord = useCallback(async (args) => {
+        setIsInserting(true);
+        setError(null);
+        try {
+            return await stigmer.datastore.insertRecord(create(InsertRecordRequestSchema, {
+                org: args.org,
+                datastore: args.datastore,
+                collection: args.collection,
+                partition: args.partition ?? "",
+                record: args.record,
+            }));
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsInserting(false);
+        }
+    }, [stigmer]);
+    return { insertRecord, isInserting, error, clearError };
+}
+//# sourceMappingURL=useInsertRecord.js.map

package/datastore/useInsertRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInsertRecord.js","sourceRoot":"","sources":["../../src/datastore/useInsertRecord.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAmB,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,yBAAyB,GAE1B,MAAM,8DAA8D,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AA6BjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,IAAsB,EAA2B,EAAE;QACxD,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,SAAS,CAAC,YAAY,CACzC,MAAM,CAAC,yBAAyB,EAAE;gBAChC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;gBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC1D,CAAC"}

package/datastore/useRecordCollection.d.ts

@@ -0,0 +1,104 @@
+import { type Table } from "@tanstack/react-table";
+import { type RecordEnvelope, type RecordFilter } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+import type { SortValue, WorkbenchColumnDef } from "../resource-workbench/types.js";
+/** Column definition for the records grid — a row is a {@link RecordEnvelope}. */
+export type RecordColumnDef = WorkbenchColumnDef<RecordEnvelope>;
+/** Options for {@link useRecordCollection}. */
+export interface UseRecordCollectionOptions {
+    /** Organization slug. Pass `null` to disable fetching. */
+    readonly org: string | null;
+    /** Datastore slug. Pass `null` to disable fetching. */
+    readonly datastore: string | null;
+    /** Collection name. Pass `null` to disable fetching. */
+    readonly collection: string | null;
+    /** Data partition. Empty or omitted means `"default"` (DD-010). */
+    readonly partition?: string;
+    /**
+     * Typed AND-only filter in the proto shape (DD-005 grammar). The hook
+     * adds no grammar — anything expressible here is exactly what
+     * `findRecords` serves (DD-008 invariant 1).
+     */
+    readonly filter?: RecordFilter;
+    /** Current page number (1-indexed). @default 1 */
+    readonly page?: number;
+    /**
+     * Page size, 1–100 (the RPC max — one surface, one limit).
+     * @default 25 (the RPC default)
+     */
+    readonly pageSize?: number;
+    /**
+     * Active sort: `id` is a sortable field name (declared non-json
+     * field, or system `id`/`created_at`/`updated_at`). `null` keeps the
+     * server default (`created_at` desc, `id` tiebreak).
+     */
+    readonly sort?: SortValue | null;
+    /** Called when the user changes the sort via a column header click. */
+    readonly onSortChange?: (sort: SortValue | null) => void;
+    /** Column definitions for the grid, converted to TanStack columns internally. */
+    readonly columns?: readonly RecordColumnDef[];
+}
+/** Return value of {@link useRecordCollection}. */
+export interface UseRecordCollectionReturn {
+    /** Records in the current page. */
+    readonly records: readonly RecordEnvelope[];
+    /** Total records matching the filter (across all pages). */
+    readonly total: number;
+    /** Total number of pages at the current page size. */
+    readonly totalPages: number;
+    /** The current page number (mirrors input). */
+    readonly currentPage: number;
+    /** `true` during the initial fetch (no data yet). */
+    readonly isLoading: boolean;
+    /** `true` during a background refetch while stale data is shown. */
+    readonly isRefetching: boolean;
+    /**
+     * Error from the last failed fetch, or `null`. A record-layer
+     * `PERMISSION_DENIED` lands here carrying the server's relayable
+     * message verbatim — render it as the denied panel, never a silently
+     * empty grid (DD-008 SD-3).
+     */
+    readonly error: Error | null;
+    /** Imperatively trigger a refetch (e.g. after a record write). */
+    readonly refetch: () => void;
+    /**
+     * The TanStack Table instance for `ResourceTable` (or custom
+     * renderers). `null` when no columns are provided.
+     */
+    readonly table: Table<RecordEnvelope> | null;
+}
+/**
+ * Headless hook that manages records-grid state: `findRecords` fetching,
+ * server-side sort, and RPC limit/offset pagination.
+ *
+ * The deliberate sibling of `useResourceCollection` (DD-008 SD-2):
+ * same headless shape — `useFetch` underneath, TanStack table with
+ * `manualPagination`/`manualSorting`, controlled sort via
+ * `sort`/`onSortChange` — but the record data contract, which the
+ * resource collection structurally cannot carry (its fetch path is
+ * hardcoded to `ListParams`/`SearchResult`). Mirrored, not retrofitted,
+ * so the SDK stays learnable; the produced table feeds the same
+ * presentational `ResourceTable`.
+ *
+ * Everything is server-side: filtering (the typed proto filter),
+ * sorting (single-field `order_by`), and pagination (limit/offset,
+ * default 25, max 100). The hook performs no client-side filtering or
+ * sorting — one query surface (DD-008 invariant 1).
+ *
+ * @example
+ * ```tsx
+ * const collection = useRecordCollection({
+ *   org: "acme",
+ *   datastore: "clinic",
+ *   collection: "bookings",
+ *   partition,
+ *   filter,
+ *   page,
+ *   sort,
+ *   onSortChange: setSort,
+ *   columns: recordColumns,
+ * });
+ * return <ResourceTable table={collection.table} />;
+ * ```
+ */
+export declare function useRecordCollection(options: UseRecordCollectionOptions): UseRecordCollectionReturn;
+//# sourceMappingURL=useRecordCollection.d.ts.map

package/datastore/useRecordCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecordCollection.d.ts","sourceRoot":"","sources":["../../src/datastore/useRecordCollection.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,KAAK,EACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,8DAA8D,CAAC;AAGtE,OAAO,KAAK,EAAiB,SAAS,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEnG,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;AAEjE,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IACzD,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;CAC9C;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAsH3B"}

package/datastore/useRecordCollection.js

@@ -0,0 +1,136 @@
+"use client";
+import { useCallback, useMemo, useRef } from "react";
+import { getCoreRowModel, useReactTable, } from "@tanstack/react-table";
+import { create, toJsonString } from "@bufbuild/protobuf";
+import { FindRecordsRequestSchema, RecordFilterSchema, RecordOrderBySchema, RecordSortDirection, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+const DEFAULT_PAGE_SIZE = 25;
+const MAX_PAGE_SIZE = 100;
+const INITIAL_DATA = { records: [], total: 0 };
+/**
+ * Headless hook that manages records-grid state: `findRecords` fetching,
+ * server-side sort, and RPC limit/offset pagination.
+ *
+ * The deliberate sibling of `useResourceCollection` (DD-008 SD-2):
+ * same headless shape — `useFetch` underneath, TanStack table with
+ * `manualPagination`/`manualSorting`, controlled sort via
+ * `sort`/`onSortChange` — but the record data contract, which the
+ * resource collection structurally cannot carry (its fetch path is
+ * hardcoded to `ListParams`/`SearchResult`). Mirrored, not retrofitted,
+ * so the SDK stays learnable; the produced table feeds the same
+ * presentational `ResourceTable`.
+ *
+ * Everything is server-side: filtering (the typed proto filter),
+ * sorting (single-field `order_by`), and pagination (limit/offset,
+ * default 25, max 100). The hook performs no client-side filtering or
+ * sorting — one query surface (DD-008 invariant 1).
+ *
+ * @example
+ * ```tsx
+ * const collection = useRecordCollection({
+ *   org: "acme",
+ *   datastore: "clinic",
+ *   collection: "bookings",
+ *   partition,
+ *   filter,
+ *   page,
+ *   sort,
+ *   onSortChange: setSort,
+ *   columns: recordColumns,
+ * });
+ * return <ResourceTable table={collection.table} />;
+ * ```
+ */
+export function useRecordCollection(options) {
+    const { org, datastore, collection, partition = "", filter, page = 1, pageSize = DEFAULT_PAGE_SIZE, sort = null, onSortChange, columns = [], } = options;
+    const stigmer = useStigmer();
+    const limit = Math.min(Math.max(pageSize, 1), MAX_PAGE_SIZE);
+    const offset = (Math.max(page, 1) - 1) * limit;
+    // Proto messages are typically rebuilt each render; serialized JSON is
+    // the stable identity for dependency comparison.
+    const filterKey = filter ? toJsonString(RecordFilterSchema, filter) : "";
+    const orderBy = useMemo(() => {
+        if (!sort)
+            return undefined;
+        return create(RecordOrderBySchema, {
+            field: sort.id,
+            direction: sort.direction === "desc" ? RecordSortDirection.desc : RecordSortDirection.asc,
+        });
+    }, [sort]);
+    const orderByKey = orderBy ? toJsonString(RecordOrderBySchema, orderBy) : "";
+    // --- Data fetching via useFetch -----------------------------------------
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(org && datastore && collection
+        ? async () => {
+            const result = await stigmer.datastore.findRecords(create(FindRecordsRequestSchema, {
+                org,
+                datastore,
+                collection,
+                partition,
+                filter,
+                orderBy,
+                limit,
+                offset,
+            }));
+            return { records: result.records, total: result.total };
+        }
+        : null, [org, datastore, collection, partition, filterKey, orderByKey, limit, offset, stigmer], INITIAL_DATA);
+    // --- TanStack Table sorting bridge --------------------------------------
+    const sortingState = useMemo(() => {
+        if (!sort)
+            return [];
+        return [{ id: sort.id, desc: sort.direction === "desc" }];
+    }, [sort]);
+    const onSortChangeRef = useRef(onSortChange);
+    onSortChangeRef.current = onSortChange;
+    const handleSortingChange = useCallback((updater) => {
+        const next = typeof updater === "function" ? updater(sortingState) : updater;
+        if (next.length === 0) {
+            onSortChangeRef.current?.(null);
+        }
+        else {
+            const col = next[0];
+            onSortChangeRef.current?.({
+                id: col.id,
+                direction: (col.desc ? "desc" : "asc"),
+            });
+        }
+    }, [sortingState]);
+    // --- TanStack Table column conversion -----------------------------------
+    const tanstackColumns = useMemo(() => {
+        return columns.map((col) => ({
+            id: col.id,
+            header: col.header,
+            cell: (info) => col.cell(info.row.original),
+            enableSorting: col.sortable ?? false,
+            size: col.minWidth,
+            minSize: col.minWidth,
+        }));
+    }, [columns]);
+    // --- TanStack Table instance -------------------------------------------
+    // No getSortedRowModel: sorting is entirely server-side (manualSorting)
+    // and the page arrives in server order — a client sort model would be
+    // dead code implying a second sorting authority.
+    const table = useReactTable({
+        data: data.records,
+        columns: tanstackColumns,
+        state: { sorting: sortingState },
+        onSortingChange: handleSortingChange,
+        getCoreRowModel: getCoreRowModel(),
+        getRowId: (row) => row.id,
+        manualPagination: true,
+        manualSorting: true,
+    });
+    return {
+        records: data.records,
+        total: data.total,
+        totalPages: Math.ceil(data.total / limit),
+        currentPage: page,
+        isLoading,
+        isRefetching,
+        error,
+        refetch,
+        table: tanstackColumns.length > 0 ? table : null,
+    };
+}
+//# sourceMappingURL=useRecordCollection.js.map

package/datastore/useRecordCollection.js.map

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

package/datastore/useRecordList.d.ts

@@ -0,0 +1,66 @@
+import { type RecordEnvelope, type RecordFilter, type RecordOrderBy } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+/**
+ * Addressing shared by every record read/write: which datastore, which
+ * collection, and which data partition (DD-010 — every record operation
+ * is partition-scoped; empty means the `"default"` partition).
+ */
+export interface RecordScope {
+    /** Organization slug. Required for cloud direct callers; OSS defaults it. */
+    readonly org: string;
+    /** Datastore slug. */
+    readonly datastore: string;
+    /** Collection name. */
+    readonly collection: string;
+    /** Data partition. Empty or omitted means `"default"`. */
+    readonly partition?: string;
+}
+/** Query parameters for {@link useRecordList}. */
+export interface UseRecordListParams extends RecordScope {
+    /**
+     * Typed AND-only filter in the proto shape (DD-005 grammar). The hook
+     * adds no grammar of its own — anything expressible here is exactly
+     * what `findRecords` serves.
+     */
+    readonly filter?: RecordFilter;
+    /** Sort directive. Omitted keeps the default: `created_at` desc, `id` tiebreak. */
+    readonly orderBy?: RecordOrderBy;
+    /** Page size, 1–100. Zero or omitted applies the RPC default of 25. */
+    readonly limit?: number;
+    /** Row offset for pagination. */
+    readonly offset?: number;
+}
+/** Return value of {@link useRecordList}. */
+export interface UseRecordListReturn {
+    /** Records in the current page. */
+    readonly records: readonly RecordEnvelope[];
+    /** Total records matching the filter (across all pages). */
+    readonly total: number;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the current page from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a page of records via `findRecords` — the one
+ * query surface (DD-008 invariant 1): server-side filtering with the
+ * DD-005 grammar, RPC limit/offset pagination, no client-side
+ * filtering.
+ *
+ * A record-layer `PERMISSION_DENIED` (caller holds no read grant on the
+ * collection) surfaces as `error` carrying the server's relayable
+ * message verbatim; consumers render it as the denied panel, never a
+ * silently empty grid.
+ *
+ * Pass `null` to skip fetching (stable no-op) — e.g. while the
+ * collection is not yet selected.
+ *
+ * For the full grid experience (TanStack table, sort bridge, page
+ * state), use {@link useRecordCollection}, which builds on the same
+ * RPC.
+ */
+export declare function useRecordList(params: UseRecordListParams | null): UseRecordListReturn;
+//# sourceMappingURL=useRecordList.d.ts.map

package/datastore/useRecordList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecordList.d.ts","sourceRoot":"","sources":["../../src/datastore/useRecordList.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,8DAA8D,CAAC;AAItE;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AASD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,GAAG,IAAI,GACjC,mBAAmB,CAyCrB"}

package/datastore/useRecordList.js

@@ -0,0 +1,58 @@
+"use client";
+import { create, toJsonString } from "@bufbuild/protobuf";
+import { FindRecordsRequestSchema, RecordFilterSchema, RecordOrderBySchema, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+const INITIAL_DATA = { records: [], total: 0 };
+/**
+ * Data hook that fetches a page of records via `findRecords` — the one
+ * query surface (DD-008 invariant 1): server-side filtering with the
+ * DD-005 grammar, RPC limit/offset pagination, no client-side
+ * filtering.
+ *
+ * A record-layer `PERMISSION_DENIED` (caller holds no read grant on the
+ * collection) surfaces as `error` carrying the server's relayable
+ * message verbatim; consumers render it as the denied panel, never a
+ * silently empty grid.
+ *
+ * Pass `null` to skip fetching (stable no-op) — e.g. while the
+ * collection is not yet selected.
+ *
+ * For the full grid experience (TanStack table, sort bridge, page
+ * state), use {@link useRecordCollection}, which builds on the same
+ * RPC.
+ */
+export function useRecordList(params) {
+    const stigmer = useStigmer();
+    // Proto messages are typically rebuilt each render; serialized JSON is
+    // the stable identity for dependency comparison.
+    const filterKey = params?.filter ? toJsonString(RecordFilterSchema, params.filter) : "";
+    const orderByKey = params?.orderBy ? toJsonString(RecordOrderBySchema, params.orderBy) : "";
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(params
+        ? async () => {
+            const result = await stigmer.datastore.findRecords(create(FindRecordsRequestSchema, {
+                org: params.org,
+                datastore: params.datastore,
+                collection: params.collection,
+                partition: params.partition ?? "",
+                filter: params.filter,
+                orderBy: params.orderBy,
+                limit: params.limit ?? 0,
+                offset: params.offset ?? 0,
+            }));
+            return { records: result.records, total: result.total };
+        }
+        : null, [
+        params?.org,
+        params?.datastore,
+        params?.collection,
+        params?.partition,
+        filterKey,
+        orderByKey,
+        params?.limit,
+        params?.offset,
+        stigmer,
+    ], INITIAL_DATA);
+    return { records: data.records, total: data.total, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useRecordList.js.map

package/datastore/useRecordList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecordList.js","sourceRoot":"","sources":["../../src/datastore/useRecordList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,8DAA8D,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAuDnD,MAAM,YAAY,GAAmB,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,uEAAuE;IACvE,iDAAiD;IACjD,MAAM,SAAS,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,MAAM,UAAU,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5F,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAChE,MAAM;QACJ,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,CAChD,MAAM,CAAC,wBAAwB,EAAE;gBAC/B,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;gBACjC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;gBACxB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;aAC3B,CAAC,CACH,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;QACH,CAAC,CAAC,IAAI,EACR;QACE,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,SAAS;QACjB,SAAS;QACT,UAAU;QACV,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,MAAM;QACd,OAAO;KACR,EACD,YAAY,CACb,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/F,CAAC"}

package/datastore/useUpdateRecord.d.ts

@@ -0,0 +1,52 @@
+import { type JsonObject } from "@bufbuild/protobuf";
+import { type RecordEnvelope } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+import type { RecordScope } from "./useRecordList.js";
+/** Arguments for a single record update. */
+export interface UpdateRecordArgs extends RecordScope {
+    /** Record id (`dsr_…`). */
+    readonly id: string;
+    /**
+     * Partial merge (DD-005): only the supplied fields change; an
+     * explicit `null` clears a field; absent fields keep their stored
+     * values. Constraints evaluate on the merged result. Build this from
+     * per-field edits with `buildUpdateFields`.
+     */
+    readonly fields: JsonObject;
+}
+/** Return value of {@link useUpdateRecord}. */
+export interface UseUpdateRecordReturn {
+    /**
+     * Update one record by id. Resolves with the merged envelope. Rejects
+     * — and sets `error` — on denial or constraint violation; the error's
+     * message is the server's relayable text, byte-for-byte.
+     */
+    readonly updateRecord: (args: UpdateRecordArgs) => Promise<RecordEnvelope>;
+    /** `true` while the update is in flight. */
+    readonly isUpdating: boolean;
+    /** Error from the last failed update, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `datastore.updateRecord()` with loading and
+ * error state.
+ *
+ * The RPC is an honest tri-state partial merge — the hook adds no
+ * merge semantics of its own. A record in another partition is
+ * NOT_FOUND (DD-010: partition scoping is structural).
+ *
+ * @example
+ * ```tsx
+ * const { updateRecord } = useUpdateRecord();
+ * await updateRecord({
+ *   org: "acme",
+ *   datastore: "clinic",
+ *   collection: "bookings",
+ *   id: "dsr_01j9...",
+ *   fields: { patient_phone: "+15550100", notes: null }, // notes cleared
+ * });
+ * ```
+ */
+export declare function useUpdateRecord(): UseUpdateRecordReturn;
+//# sourceMappingURL=useUpdateRecord.d.ts.map

package/datastore/useUpdateRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateRecord.d.ts","sourceRoot":"","sources":["../../src/datastore/useUpdateRecord.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,8DAA8D,CAAC;AAGtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3E,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAiCvD"}

package/datastore/useUpdateRecord.js

@@ -0,0 +1,55 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { UpdateRecordRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that wraps `datastore.updateRecord()` with loading and
+ * error state.
+ *
+ * The RPC is an honest tri-state partial merge — the hook adds no
+ * merge semantics of its own. A record in another partition is
+ * NOT_FOUND (DD-010: partition scoping is structural).
+ *
+ * @example
+ * ```tsx
+ * const { updateRecord } = useUpdateRecord();
+ * await updateRecord({
+ *   org: "acme",
+ *   datastore: "clinic",
+ *   collection: "bookings",
+ *   id: "dsr_01j9...",
+ *   fields: { patient_phone: "+15550100", notes: null }, // notes cleared
+ * });
+ * ```
+ */
+export function useUpdateRecord() {
+    const stigmer = useStigmer();
+    const [isUpdating, setIsUpdating] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const updateRecord = useCallback(async (args) => {
+        setIsUpdating(true);
+        setError(null);
+        try {
+            return await stigmer.datastore.updateRecord(create(UpdateRecordRequestSchema, {
+                org: args.org,
+                datastore: args.datastore,
+                collection: args.collection,
+                partition: args.partition ?? "",
+                id: args.id,
+                fields: args.fields,
+            }));
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsUpdating(false);
+        }
+    }, [stigmer]);
+    return { updateRecord, isUpdating, error, clearError };
+}
+//# sourceMappingURL=useUpdateRecord.js.map

package/datastore/useUpdateRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateRecord.js","sourceRoot":"","sources":["../../src/datastore/useUpdateRecord.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAmB,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,yBAAyB,GAE1B,MAAM,8DAA8D,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAgCjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,IAAsB,EAA2B,EAAE;QACxD,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,SAAS,CAAC,YAAY,CACzC,MAAM,CAAC,yBAAyB,EAAE;gBAChC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;gBAC/B,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC"}

package/environment/EnvironmentListPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnvironmentListPanel.d.ts","sourceRoot":"","sources":["../../src/environment/EnvironmentListPanel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAC;AAW5F,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3E,0DAA0D;IAC1D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1D,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACtD,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,GAAG,EACH,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,QAAgB,EAChB,YAAY,EACZ,SAAS,GACV,EAAE,yBAAyB,2CAgG3B"}
+{"version":3,"file":"EnvironmentListPanel.d.ts","sourceRoot":"","sources":["../../src/environment/EnvironmentListPanel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAC;AAY5F,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3E,0DAA0D;IAC1D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1D,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACtD,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,GAAG,EACH,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,QAAgB,EAChB,YAAY,EACZ,SAAS,GACV,EAAE,yBAAyB,2CA0G3B"}