@stigmer/react 3.12.6 → 3.12.7

package/memory/MemoryListPanel.js

@@ -0,0 +1,141 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { MemoryLifecycleState } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/enum_pb";
+import { formatRelativeTime } from "../activity/format-relative-time.js";
+import { SpinnerIcon } from "../internal/SpinnerIcon.js";
+import { formatMemoryProvenance, groupMemoriesByLifecycle } from "./memoryGroups.js";
+import { useConfirmMemory } from "./useConfirmMemory.js";
+import { useDeleteMemory } from "./useDeleteMemory.js";
+import { useMemories } from "./useMemories.js";
+import { useRejectMemory } from "./useRejectMemory.js";
+import { useUpdateMemoryContent } from "./useUpdateMemoryContent.js";
+/**
+ * Lists everything the platform remembers about the caller in an
+ * organization, grouped pending-proposals-first (DD-005 D4): proposals
+ * awaiting a decision, then confirmed facts, then rejected proposals
+ * kept for audit.
+ *
+ * Every fact is shown VERBATIM — the exact stored text is what future
+ * prompts inject, byte for byte, so the review surface never paraphrases
+ * (DD-005 D6). Provenance renders beside each agent-proposed fact.
+ * Actions per state: confirm/reject/delete on proposals (reject is
+ * one-click — no confirmation dialog), edit/delete on confirmed facts,
+ * delete on rejected ones. Delete asks inline; it works in any state.
+ *
+ * All visual properties flow through `--stgm-*` design tokens.
+ *
+ * @example
+ * ```tsx
+ * <MemoryListPanel org="acme" />
+ * ```
+ */
+export function MemoryListPanel({ org, className, now }) {
+    const { memories, isLoading, error, refetch } = useMemories(org);
+    // At most one row is mid-interaction at a time — the ApiKeyListPanel
+    // single-confirmation posture, extended with an editing mode.
+    const [rowState, setRowState] = useState({ mode: "idle" });
+    const resetRow = useCallback(() => setRowState({ mode: "idle" }), []);
+    const handleChanged = useCallback(() => {
+        setRowState({ mode: "idle" });
+        refetch();
+    }, [refetch]);
+    if (isLoading) {
+        return (_jsx("div", { className: cn("stg:space-y-2", className), "aria-busy": "true", "aria-label": "Loading memories", children: Array.from({ length: 2 }, (_, i) => (_jsx("div", { className: "stg:bg-muted-subtle stg:h-14 stg:animate-pulse stg:rounded-lg" }, i))) }));
+    }
+    if (error) {
+        return (_jsx("p", { className: cn("stg:text-destructive stg:text-xs", className), role: "alert", children: getUserMessage(error) }));
+    }
+    if (memories.length === 0) {
+        return (_jsx("p", { className: cn("stg:text-muted-foreground stg:py-4 stg:text-center stg:text-xs", className), children: "Nothing remembered yet. When an agent proposes a fact worth keeping, it appears here for your decision." }));
+    }
+    const groups = groupMemoriesByLifecycle(memories);
+    return (_jsxs("div", { className: cn("stg:space-y-6", className), children: [groups.proposed.length > 0 && (_jsx(MemoryGroup, { heading: "Pending proposals", description: "Facts agents proposed to remember. Nothing is stored in your sessions until you confirm it.", memories: groups.proposed, rowState: rowState, setRowState: setRowState, onChanged: handleChanged, onCancel: resetRow, now: now })), groups.confirmed.length > 0 && (_jsx(MemoryGroup, { heading: "Remembered", description: "Confirmed facts, shared with agents in your future sessions.", memories: groups.confirmed, rowState: rowState, setRowState: setRowState, onChanged: handleChanged, onCancel: resetRow, now: now })), groups.rejected.length > 0 && (_jsx(MemoryGroup, { heading: "Rejected", description: "Proposals you declined, kept for reference. Delete them to clear the record.", memories: groups.rejected, rowState: rowState, setRowState: setRowState, onChanged: handleChanged, onCancel: resetRow, now: now }))] }));
+}
+function MemoryGroup({ heading, description, memories, rowState, setRowState, onChanged, onCancel, now, }) {
+    return (_jsxs("div", { children: [_jsx("h3", { className: "stg:text-foreground stg:text-xs stg:font-semibold", children: heading }), _jsx("p", { className: "stg:text-muted-foreground stg:mb-2 stg:text-xs", children: description }), _jsx("div", { className: "stg:space-y-2", role: "list", "aria-label": heading, children: memories.map((memory) => {
+                    const id = memory.metadata?.id ?? "";
+                    return (_jsx(MemoryRow, { memory: memory, now: now, mode: rowState.mode !== "idle" && rowState.id === id
+                            ? rowState.mode
+                            : "idle", onStartDelete: () => setRowState({ mode: "confirming-delete", id }), onStartEdit: () => setRowState({ mode: "editing", id }), onCancel: onCancel, onChanged: onChanged }, id));
+                }) })] }));
+}
+function MemoryRow({ memory, now, mode, onStartDelete, onStartEdit, onCancel, onChanged, }) {
+    const id = memory.metadata?.id ?? "";
+    const content = memory.spec?.content ?? "";
+    const state = memory.status?.lifecycleState;
+    const provenance = formatMemoryProvenance(memory);
+    const stateChangedAt = memory.status?.stateChangedAt;
+    const { confirmMemory, isConfirming, error: confirmError } = useConfirmMemory();
+    const { rejectMemory, isRejecting, error: rejectError } = useRejectMemory();
+    const { deleteMemory, isDeleting, error: deleteError } = useDeleteMemory();
+    const actionError = confirmError ?? rejectError ?? deleteError;
+    const isBusy = isConfirming || isRejecting || isDeleting;
+    const act = useCallback(async (action) => {
+        try {
+            await action(id);
+            onChanged();
+        }
+        catch {
+            // error state is surfaced via the hooks
+        }
+    }, [id, onChanged]);
+    if (mode === "editing") {
+        return (_jsx(MemoryEditRow, { memory: memory, onCancel: onCancel, onSaved: onChanged }));
+    }
+    if (mode === "confirming-delete") {
+        return (_jsxs("div", { role: "listitem", className: "stg:flex stg:items-center stg:justify-between stg:gap-3 stg:rounded-lg stg:border stg:border-destructive/30 stg:bg-destructive-subtle stg:px-3 stg:py-2.5", children: [_jsxs("div", { className: "stg:min-w-0 stg:flex-1", children: [_jsxs("p", { className: "stg:text-xs stg:text-foreground", children: ["Forget this permanently? ", _jsx("q", { className: "stg:italic", children: content })] }), deleteError && (_jsx("p", { className: "stg:mt-0.5 stg:text-[0.65rem] stg:text-destructive", children: getUserMessage(deleteError) }))] }), _jsxs("div", { className: "stg:flex stg:shrink-0 stg:items-center stg:gap-1.5", children: [_jsxs("button", { type: "button", onClick: () => void act(deleteMemory), disabled: isDeleting, className: cn("stg:inline-flex stg:items-center stg:gap-1 stg:rounded-md stg:px-2.5 stg:py-1 stg:text-xs stg:font-medium", "stg:bg-destructive stg:text-destructive-foreground stg:hover:bg-destructive-hover", "stg:disabled:pointer-events-none stg:disabled:opacity-50"), children: [isDeleting && _jsx(SpinnerIcon, { size: 12 }), "Delete"] }), _jsx("button", { type: "button", onClick: onCancel, disabled: isDeleting, className: cn("stg:rounded-md stg:px-2.5 stg:py-1 stg:text-xs", "stg:text-muted-foreground stg:hover:text-foreground stg:hover:bg-accent-hover", "stg:disabled:pointer-events-none stg:disabled:opacity-50"), children: "Cancel" })] })] }));
+    }
+    return (_jsx("div", { role: "listitem", className: "stg:rounded-lg stg:border stg:border-border-muted stg:px-3 stg:py-2.5 stg:hover:border-border stg:transition-colors", children: _jsxs("div", { className: "stg:flex stg:items-start stg:justify-between stg:gap-3", children: [_jsxs("div", { className: "stg:min-w-0 stg:flex-1", children: [_jsx("p", { className: "stg:text-sm stg:text-foreground stg:whitespace-pre-wrap", children: content }), _jsxs("p", { className: "stg:mt-1 stg:text-xs stg:text-muted-foreground", children: [provenance ? `${provenance} · ` : "", formatStateStamp(state, stateChangedAt ? timestampDate(stateChangedAt) : undefined, now)] }), actionError && (_jsx("p", { className: "stg:mt-0.5 stg:text-[0.65rem] stg:text-destructive", role: "alert", children: getUserMessage(actionError) }))] }), _jsxs("div", { className: "stg:flex stg:shrink-0 stg:items-center stg:gap-1.5", children: [state === MemoryLifecycleState.lifecycle_state_confirmed && (_jsx(RowButton, { label: `Edit memory: ${content}`, onClick: onStartEdit, disabled: isBusy, children: "Edit" })), isProposed(state) && (_jsxs(_Fragment, { children: [_jsxs(RowButton, { label: `Confirm memory: ${content}`, onClick: () => void act(confirmMemory), disabled: isBusy, emphasis: "primary", children: [isConfirming && _jsx(SpinnerIcon, { size: 12 }), "Confirm"] }), _jsxs(RowButton, { label: `Reject memory: ${content}`, onClick: () => void act(rejectMemory), disabled: isBusy, children: [isRejecting && _jsx(SpinnerIcon, { size: 12 }), "Reject"] })] })), _jsx("button", { type: "button", onClick: onStartDelete, disabled: isBusy, "aria-label": `Delete memory: ${content}`, className: cn("stg:shrink-0 stg:rounded stg:p-1", "stg:text-muted-foreground stg:hover:text-destructive stg:hover:bg-destructive-subtle", "stg:transition-colors stg:disabled:pointer-events-none stg:disabled:opacity-50"), children: _jsx(TrashIcon, {}) })] })] }) }));
+}
+// MemoryEditRow edits the fact text in place — the one field the
+// subject owns. Saving maps the loaded record through the generated
+// update mapper (wipe-safe) and overrides only content.
+function MemoryEditRow({ memory, onCancel, onSaved, }) {
+    const [draft, setDraft] = useState(memory.spec?.content ?? "");
+    const { updateContent, isUpdating, error } = useUpdateMemoryContent();
+    const trimmed = draft.trim();
+    const canSave = trimmed.length > 0 && trimmed.length <= 500 && !isUpdating;
+    const handleSave = async () => {
+        try {
+            await updateContent(memory, trimmed);
+            onSaved();
+        }
+        catch {
+            // error state is surfaced via the hook
+        }
+    };
+    return (_jsxs("div", { role: "listitem", className: "stg:rounded-lg stg:border stg:border-border stg:px-3 stg:py-2.5", children: [_jsx("textarea", { value: draft, onChange: (e) => setDraft(e.target.value), rows: 2, maxLength: 500, "aria-label": "Edit memory text", className: cn("stg:w-full stg:resize-y stg:rounded-md stg:border stg:border-input stg:bg-background stg:px-2 stg:py-1.5 stg:text-sm stg:text-foreground", "stg:focus-visible:outline-none stg:focus-visible:ring-2 stg:focus-visible:ring-ring") }), _jsxs("div", { className: "stg:mt-1.5 stg:flex stg:items-center stg:justify-between", children: [_jsxs("span", { className: "stg:text-[0.65rem] stg:text-muted-foreground", children: [trimmed.length, "/500"] }), _jsxs("div", { className: "stg:flex stg:items-center stg:gap-1.5", children: [_jsxs(RowButton, { label: "Save memory text", onClick: () => void handleSave(), disabled: !canSave, emphasis: "primary", children: [isUpdating && _jsx(SpinnerIcon, { size: 12 }), "Save"] }), _jsx(RowButton, { label: "Cancel editing", onClick: onCancel, disabled: isUpdating, children: "Cancel" })] })] }), error && (_jsx("p", { className: "stg:mt-1 stg:text-[0.65rem] stg:text-destructive", role: "alert", children: getUserMessage(error) }))] }));
+}
+// ---------------------------------------------------------------------------
+// Presentation helpers (internal)
+// ---------------------------------------------------------------------------
+function isProposed(state) {
+    // The zero unspecified state should not exist (create stamps
+    // proposed); offering the decision actions is the safe rendering.
+    return (state === undefined ||
+        state === MemoryLifecycleState.lifecycle_state_unspecified ||
+        state === MemoryLifecycleState.lifecycle_state_proposed);
+}
+function formatStateStamp(state, changedAt, now) {
+    const verb = state === MemoryLifecycleState.lifecycle_state_confirmed
+        ? "Confirmed"
+        : state === MemoryLifecycleState.lifecycle_state_rejected
+            ? "Rejected"
+            : "Proposed";
+    if (!changedAt)
+        return verb;
+    return `${verb} ${formatRelativeTime(changedAt, now)}`;
+}
+function RowButton({ label, onClick, disabled, emphasis, children, }) {
+    return (_jsx("button", { type: "button", "aria-label": label, onClick: onClick, disabled: disabled, className: cn("stg:inline-flex stg:items-center stg:gap-1 stg:rounded-md stg:px-2 stg:py-1 stg:text-xs stg:font-medium", emphasis === "primary"
+            ? "stg:bg-primary stg:text-primary-foreground stg:hover:bg-primary-hover"
+            : "stg:border stg:border-input stg:bg-background stg:text-foreground stg:hover:bg-accent stg:hover:text-accent-foreground", "stg:focus-visible:outline-none stg:focus-visible:ring-2 stg:focus-visible:ring-ring", "stg:disabled:pointer-events-none stg:disabled:opacity-50"), children: children }));
+}
+function TrashIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M2.5 4h11M5.5 4V2.5a1 1 0 0 1 1-1h3a1 1 0 0 1 1 1V4" }), _jsx("path", { d: "M12.5 4v9a1 1 0 0 1-1 1h-7a1 1 0 0 1-1-1V4" }), _jsx("line", { x1: "6.5", y1: "7", x2: "6.5", y2: "11" }), _jsx("line", { x1: "9.5", y1: "7", x2: "9.5", y2: "11" })] }));
+}
+//# sourceMappingURL=MemoryListPanel.js.map

package/memory/MemoryListPanel.js.map

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

package/memory/index.d.ts

@@ -0,0 +1,8 @@
+export { MemoryListPanel, type MemoryListPanelProps } from "./MemoryListPanel.js";
+export { groupMemoriesByLifecycle, formatMemoryProvenance, type MemoryGroups, } from "./memoryGroups.js";
+export { useMemories, type UseMemoriesReturn } from "./useMemories.js";
+export { useConfirmMemory, type UseConfirmMemoryReturn } from "./useConfirmMemory.js";
+export { useRejectMemory, type UseRejectMemoryReturn } from "./useRejectMemory.js";
+export { useDeleteMemory, type UseDeleteMemoryReturn } from "./useDeleteMemory.js";
+export { useUpdateMemoryContent, type UseUpdateMemoryContentReturn, } from "./useUpdateMemoryContent.js";
+//# sourceMappingURL=index.d.ts.map

package/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC"}

package/memory/index.js

@@ -0,0 +1,12 @@
+// Memory — agent-proposed, user-confirmed facts (stigmer/stigmer#293
+// Phase 2). The record is the trust surface over the recall seam: every
+// fact is individually reviewable, editable, and deletable, and nothing
+// is recalled until its subject confirms it.
+export { MemoryListPanel } from "./MemoryListPanel.js";
+export { groupMemoriesByLifecycle, formatMemoryProvenance, } from "./memoryGroups.js";
+export { useMemories } from "./useMemories.js";
+export { useConfirmMemory } from "./useConfirmMemory.js";
+export { useRejectMemory } from "./useRejectMemory.js";
+export { useDeleteMemory } from "./useDeleteMemory.js";
+export { useUpdateMemoryContent, } from "./useUpdateMemoryContent.js";
+//# sourceMappingURL=index.js.map

package/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wEAAwE;AACxE,wEAAwE;AACxE,6CAA6C;AAE7C,OAAO,EAAE,eAAe,EAA6B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GAEvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAA0B,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAA+B,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,eAAe,EAA8B,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,eAAe,EAA8B,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC"}

package/memory/memoryGroups.d.ts

@@ -0,0 +1,31 @@
+import type { Memory } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/api_pb";
+/** Memories bucketed by consent lifecycle, pending proposals first. */
+export interface MemoryGroups {
+    /** Awaiting the caller's decision — the catch-up queue. */
+    readonly proposed: readonly Memory[];
+    /** Confirmed facts, recalled into future sessions. */
+    readonly confirmed: readonly Memory[];
+    /** Rejected proposals, kept for audit until deleted. */
+    readonly rejected: readonly Memory[];
+}
+/**
+ * Buckets memories by lifecycle state for the pending-proposals-first
+ * page layout (DD-005 D4: the memory page is the catch-up surface for
+ * proposals scrolled past in session). Input order (newest first from
+ * the server) is preserved inside each bucket.
+ *
+ * A record in the zero `unspecified` state should not exist (create
+ * stamps `proposed`); it is bucketed with proposals so a decision
+ * surface is always offered rather than hiding the record.
+ */
+export declare function groupMemoriesByLifecycle(memories: readonly Memory[]): MemoryGroups;
+/**
+ * One-line provenance attribution for a memory, or `null` when the
+ * record has none (created directly through the API, not by an agent).
+ *
+ * Trust requires "where did this come from" beside every fact (DD-004);
+ * agent/session display names are not resolvable from the record alone,
+ * so ids are shown — they are what links back to the source surfaces.
+ */
+export declare function formatMemoryProvenance(memory: Memory): string | null;
+//# sourceMappingURL=memoryGroups.d.ts.map

package/memory/memoryGroups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryGroups.d.ts","sourceRoot":"","sources":["../../src/memory/memoryGroups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAGlF,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,YAAY,CAoBd;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQpE"}

package/memory/memoryGroups.js

@@ -0,0 +1,52 @@
+import { MemoryLifecycleState } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/enum_pb";
+/**
+ * Buckets memories by lifecycle state for the pending-proposals-first
+ * page layout (DD-005 D4: the memory page is the catch-up surface for
+ * proposals scrolled past in session). Input order (newest first from
+ * the server) is preserved inside each bucket.
+ *
+ * A record in the zero `unspecified` state should not exist (create
+ * stamps `proposed`); it is bucketed with proposals so a decision
+ * surface is always offered rather than hiding the record.
+ */
+export function groupMemoriesByLifecycle(memories) {
+    const proposed = [];
+    const confirmed = [];
+    const rejected = [];
+    for (const memory of memories) {
+        switch (memory.status?.lifecycleState) {
+            case MemoryLifecycleState.lifecycle_state_confirmed:
+                confirmed.push(memory);
+                break;
+            case MemoryLifecycleState.lifecycle_state_rejected:
+                rejected.push(memory);
+                break;
+            default:
+                proposed.push(memory);
+                break;
+        }
+    }
+    return { proposed, confirmed, rejected };
+}
+/**
+ * One-line provenance attribution for a memory, or `null` when the
+ * record has none (created directly through the API, not by an agent).
+ *
+ * Trust requires "where did this come from" beside every fact (DD-004);
+ * agent/session display names are not resolvable from the record alone,
+ * so ids are shown — they are what links back to the source surfaces.
+ */
+export function formatMemoryProvenance(memory) {
+    const provenance = memory.spec?.provenance;
+    if (!provenance)
+        return null;
+    const parts = [];
+    if (provenance.agentId)
+        parts.push(`agent ${provenance.agentId}`);
+    if (provenance.sessionId)
+        parts.push(`session ${provenance.sessionId}`);
+    if (parts.length === 0)
+        return null;
+    return `Proposed by ${parts.join(" in ")}`;
+}
+//# sourceMappingURL=memoryGroups.js.map

package/memory/memoryGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryGroups.js","sourceRoot":"","sources":["../../src/memory/memoryGroups.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAY5F;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA2B;IAE3B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,QAAQ,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACtC,KAAK,oBAAoB,CAAC,yBAAyB;gBACjD,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,oBAAoB,CAAC,wBAAwB;gBAChD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACtB,MAAM;YACR;gBACE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACtB,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC;IAC3C,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,UAAU,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,IAAI,UAAU,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;IACxE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,eAAe,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/memory/useConfirmMemory.d.ts

@@ -0,0 +1,31 @@
+import type { Memory } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/api_pb";
+/** Return value of {@link useConfirmMemory}. */
+export interface UseConfirmMemoryReturn {
+    /** Confirm a proposed memory by its resource ID. Resolves with the confirmed record. */
+    readonly confirmMemory: (id: string) => Promise<Memory>;
+    /** `true` while the confirm request is in flight. */
+    readonly isConfirming: boolean;
+    /** Error from the last failed confirm, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `memory.confirm()` — the consent act
+ * (DD-005 D3). A confirmed memory is recalled into the caller's future
+ * sessions as background context.
+ *
+ * Confirming an already-confirmed memory succeeds and changes nothing.
+ * Confirming a rejected memory fails with FAILED_PRECONDITION: the
+ * rejection stands — delete the record and let the agent propose again.
+ *
+ * @example
+ * ```tsx
+ * const { confirmMemory, isConfirming } = useConfirmMemory();
+ *
+ * await confirmMemory(memory.metadata?.id ?? "");
+ * refetch(); // refresh the list after the decision
+ * ```
+ */
+export declare function useConfirmMemory(): UseConfirmMemoryReturn;
+//# sourceMappingURL=useConfirmMemory.d.ts.map

package/memory/useConfirmMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConfirmMemory.d.ts","sourceRoot":"","sources":["../../src/memory/useConfirmMemory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAIlF,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,wFAAwF;IACxF,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAyBzD"}

package/memory/useConfirmMemory.js

@@ -0,0 +1,43 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that wraps `memory.confirm()` — the consent act
+ * (DD-005 D3). A confirmed memory is recalled into the caller's future
+ * sessions as background context.
+ *
+ * Confirming an already-confirmed memory succeeds and changes nothing.
+ * Confirming a rejected memory fails with FAILED_PRECONDITION: the
+ * rejection stands — delete the record and let the agent propose again.
+ *
+ * @example
+ * ```tsx
+ * const { confirmMemory, isConfirming } = useConfirmMemory();
+ *
+ * await confirmMemory(memory.metadata?.id ?? "");
+ * refetch(); // refresh the list after the decision
+ * ```
+ */
+export function useConfirmMemory() {
+    const stigmer = useStigmer();
+    const [isConfirming, setIsConfirming] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const confirmMemory = useCallback(async (id) => {
+        setIsConfirming(true);
+        setError(null);
+        try {
+            return await stigmer.memory.confirm(id);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsConfirming(false);
+        }
+    }, [stigmer]);
+    return { confirmMemory, isConfirming, error, clearError };
+}
+//# sourceMappingURL=useConfirmMemory.js.map

package/memory/useConfirmMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConfirmMemory.js","sourceRoot":"","sources":["../../src/memory/useConfirmMemory.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAcjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,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,aAAa,GAAG,WAAW,CAC/B,KAAK,EAAE,EAAU,EAAmB,EAAE;QACpC,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC5D,CAAC"}

package/memory/useDeleteMemory.d.ts

@@ -0,0 +1,30 @@
+import type { Memory } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/api_pb";
+/** Return value of {@link useDeleteMemory}. */
+export interface UseDeleteMemoryReturn {
+    /** Delete a memory by its resource ID, in any lifecycle state. Resolves with the deleted record. */
+    readonly deleteMemory: (id: string) => Promise<Memory>;
+    /** `true` while the delete request is in flight. */
+    readonly isDeleting: boolean;
+    /** Error from the last failed delete, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `memory.delete()`.
+ *
+ * Deletion works in any lifecycle state — it is never refused on
+ * lifecycle grounds (DD-004) — and is the revocation mechanism for
+ * confirmed facts: the fact stops reaching future sessions immediately.
+ * Past executions keep their immutable recall snapshots.
+ *
+ * @example
+ * ```tsx
+ * const { deleteMemory, isDeleting, error } = useDeleteMemory();
+ *
+ * await deleteMemory(memory.metadata?.id ?? "");
+ * refetch(); // refresh the list after deletion
+ * ```
+ */
+export declare function useDeleteMemory(): UseDeleteMemoryReturn;
+//# sourceMappingURL=useDeleteMemory.d.ts.map

package/memory/useDeleteMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteMemory.d.ts","sourceRoot":"","sources":["../../src/memory/useDeleteMemory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAIlF,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,oGAAoG;IACpG,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,oDAAoD;IACpD,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;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAyBvD"}

package/memory/useDeleteMemory.js

@@ -0,0 +1,42 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that wraps `memory.delete()`.
+ *
+ * Deletion works in any lifecycle state — it is never refused on
+ * lifecycle grounds (DD-004) — and is the revocation mechanism for
+ * confirmed facts: the fact stops reaching future sessions immediately.
+ * Past executions keep their immutable recall snapshots.
+ *
+ * @example
+ * ```tsx
+ * const { deleteMemory, isDeleting, error } = useDeleteMemory();
+ *
+ * await deleteMemory(memory.metadata?.id ?? "");
+ * refetch(); // refresh the list after deletion
+ * ```
+ */
+export function useDeleteMemory() {
+    const stigmer = useStigmer();
+    const [isDeleting, setIsDeleting] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const deleteMemory = useCallback(async (id) => {
+        setIsDeleting(true);
+        setError(null);
+        try {
+            return await stigmer.memory.delete(id);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsDeleting(false);
+        }
+    }, [stigmer]);
+    return { deleteMemory, isDeleting, error, clearError };
+}
+//# sourceMappingURL=useDeleteMemory.js.map

package/memory/useDeleteMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteMemory.js","sourceRoot":"","sources":["../../src/memory/useDeleteMemory.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAcjD;;;;;;;;;;;;;;;GAeG;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,EAAU,EAAmB,EAAE;QACpC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,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/memory/useMemories.d.ts

@@ -0,0 +1,33 @@
+import type { Memory } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/api_pb";
+/** Return value of {@link useMemories}. */
+export interface UseMemoriesReturn {
+    /** Every memory the caller can view in the org, newest first. */
+    readonly memories: readonly Memory[];
+    /** `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 list from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the caller's memories in an organization.
+ *
+ * Memory content is subject-only: the server returns exactly the records
+ * that are about the caller (FGA-filtered in cloud; single-user in local
+ * mode), so this list is always "what the platform remembers about ME
+ * here". Ordering is newest first; group by lifecycle state for display
+ * with {@link groupMemoriesByLifecycle}.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { memories, isLoading, refetch } = useMemories(org);
+ * const groups = groupMemoriesByLifecycle(memories);
+ * ```
+ */
+export declare function useMemories(org: string | null): UseMemoriesReturn;
+//# sourceMappingURL=useMemories.d.ts.map

package/memory/useMemories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemories.d.ts","sourceRoot":"","sources":["../../src/memory/useMemories.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAalF,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,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,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAkBjE"}

package/memory/useMemories.js

@@ -0,0 +1,42 @@
+"use client";
+import { create } from "@bufbuild/protobuf";
+import { ListMemoriesRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/io_pb";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * The server-enforced per-subject-per-org record ceiling (all lifecycle
+ * states). Requesting one page of exactly this size fetches EVERY record
+ * the caller can see, by construction — the cap is why this list needs
+ * no pagination UI.
+ */
+const MEMORY_CAP = 100;
+/**
+ * Data hook that fetches the caller's memories in an organization.
+ *
+ * Memory content is subject-only: the server returns exactly the records
+ * that are about the caller (FGA-filtered in cloud; single-user in local
+ * mode), so this list is always "what the platform remembers about ME
+ * here". Ordering is newest first; group by lifecycle state for display
+ * with {@link groupMemoriesByLifecycle}.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { memories, isLoading, refetch } = useMemories(org);
+ * const groups = groupMemoriesByLifecycle(memories);
+ * ```
+ */
+export function useMemories(org) {
+    const stigmer = useStigmer();
+    const { data: memories, isLoading, isRefetching, error, refetch } = useFetch(org
+        ? () => stigmer.memory
+            .list(create(ListMemoriesRequestSchema, {
+            org,
+            pageInfo: { num: 1, size: MEMORY_CAP },
+        }))
+            .then((r) => [...r.items])
+        : null, [stigmer, org], []);
+    return { memories, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useMemories.js.map

package/memory/useMemories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemories.js","sourceRoot":"","sources":["../../src/memory/useMemories.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,UAAU,GAAG,GAAG,CAAC;AAgBvB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,GAAkB;IAC5C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC1E,GAAG;QACD,CAAC,CAAC,GAAG,EAAE,CACH,OAAO,CAAC,MAAM;aACX,IAAI,CAAC,MAAM,CAAC,yBAAyB,EAAE;YACtC,GAAG;YACH,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE;SACvC,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,IAAI,EACR,CAAC,OAAO,EAAE,GAAG,CAAC,EACd,EAAc,CACf,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC"}

package/memory/useRejectMemory.d.ts

@@ -0,0 +1,34 @@
+import type { Memory } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/api_pb";
+/** Return value of {@link useRejectMemory}. */
+export interface UseRejectMemoryReturn {
+    /** Reject a proposed memory by its resource ID. Resolves with the rejected record. */
+    readonly rejectMemory: (id: string) => Promise<Memory>;
+    /** `true` while the reject request is in flight. */
+    readonly isRejecting: boolean;
+    /** Error from the last failed reject, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `memory.reject()`. A rejected memory is never
+ * recalled; the record is kept as an audit trail until deleted.
+ *
+ * Rejecting an already-rejected memory succeeds and changes nothing.
+ * Rejecting a confirmed memory fails with FAILED_PRECONDITION —
+ * deleting a confirmed memory is how it is revoked.
+ *
+ * Rejection is deliberately one click on every surface, with no
+ * confirmation dialog (DD-005 D4): expensive review teaches users to
+ * ignore the proposal queue.
+ *
+ * @example
+ * ```tsx
+ * const { rejectMemory, isRejecting } = useRejectMemory();
+ *
+ * await rejectMemory(memory.metadata?.id ?? "");
+ * refetch(); // refresh the list after the decision
+ * ```
+ */
+export declare function useRejectMemory(): UseRejectMemoryReturn;
+//# sourceMappingURL=useRejectMemory.d.ts.map

package/memory/useRejectMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRejectMemory.d.ts","sourceRoot":"","sources":["../../src/memory/useRejectMemory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAIlF,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,sFAAsF;IACtF,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,oDAAoD;IACpD,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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAyBvD"}