@stigmer/react 3.12.6 → 3.12.8

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/useMemory.d.ts

@@ -0,0 +1,39 @@
+import type { Memory } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/api_pb";
+/** Return value of {@link useMemory}. */
+export interface UseMemoryReturn {
+    /** The memory record, or `null` while loading / not found / on error. */
+    readonly memory: Memory | null;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /**
+     * `true` when the record no longer exists. A first-class STATE, not an
+     * error: deletion is the platform's consent-revocation mechanism, so a
+     * consumer (the proposal chip, a deep link) must render "no longer
+     * stored" honestly rather than a failure.
+     */
+    readonly notFound: boolean;
+    /** Error from the last failed request (never not-found), or `null`. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the record from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches one memory record by id.
+ *
+ * Built for surfaces that hold a memory's identity but not its CURRENT
+ * lifecycle state — the in-thread proposal chip is the primary consumer:
+ * the tool result it renders from is frozen at capture time, while the
+ * record may have been confirmed, rejected, or deleted since (from the
+ * chip itself, the memory settings page, or another device). Content
+ * visibility is subject-only, so the fetch answers only for the person
+ * the memory is about.
+ *
+ * Pass `null` as `id` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { memory, isLoading, notFound } = useMemory(memoryId);
+ * ```
+ */
+export declare function useMemory(id: string | null): UseMemoryReturn;
+//# sourceMappingURL=useMemory.d.ts.map

package/memory/useMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemory.d.ts","sourceRoot":"","sources":["../../src/memory/useMemory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAKlF,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,CA2B5D"}

package/memory/useMemory.js

@@ -0,0 +1,43 @@
+"use client";
+import { isNotFound } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+const PENDING_LOOKUP = { memory: null, notFound: false };
+/**
+ * Data hook that fetches one memory record by id.
+ *
+ * Built for surfaces that hold a memory's identity but not its CURRENT
+ * lifecycle state — the in-thread proposal chip is the primary consumer:
+ * the tool result it renders from is frozen at capture time, while the
+ * record may have been confirmed, rejected, or deleted since (from the
+ * chip itself, the memory settings page, or another device). Content
+ * visibility is subject-only, so the fetch answers only for the person
+ * the memory is about.
+ *
+ * Pass `null` as `id` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { memory, isLoading, notFound } = useMemory(memoryId);
+ * ```
+ */
+export function useMemory(id) {
+    const stigmer = useStigmer();
+    const { data, isLoading, error, refetch } = useFetch(id
+        ? () => stigmer.memory.get(id).then((memory) => ({ memory, notFound: false }), (err) => {
+            // Deletion is a state this hook reports, never an error it
+            // throws — every other failure propagates.
+            if (isNotFound(err))
+                return { memory: null, notFound: true };
+            throw err;
+        })
+        : null, [stigmer, id], PENDING_LOOKUP);
+    return {
+        memory: data.memory,
+        isLoading,
+        notFound: data.notFound,
+        error,
+        refetch,
+    };
+}
+//# sourceMappingURL=useMemory.js.map

package/memory/useMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemory.js","sourceRoot":"","sources":["../../src/memory/useMemory.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA2BnD,MAAM,cAAc,GAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CAAC,EAAiB;IACzC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAClD,EAAE;QACA,CAAC,CAAC,GAAG,EAAE,CACH,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CACzB,CAAC,MAAM,EAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EACvD,CAAC,GAAG,EAAgB,EAAE;YACpB,2DAA2D;YAC3D,2CAA2C;YAC3C,IAAI,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC7D,MAAM,GAAG,CAAC;QACZ,CAAC,CACF;QACL,CAAC,CAAC,IAAI,EACR,CAAC,OAAO,EAAE,EAAE,CAAC,EACb,cAAc,CACf,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS;QACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK;QACL,OAAO;KACR,CAAC;AACJ,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"}

package/memory/useRejectMemory.js

@@ -0,0 +1,46 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * 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 function useRejectMemory() {
+    const stigmer = useStigmer();
+    const [isRejecting, setIsRejecting] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const rejectMemory = useCallback(async (id) => {
+        setIsRejecting(true);
+        setError(null);
+        try {
+            return await stigmer.memory.reject(id);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsRejecting(false);
+        }
+    }, [stigmer]);
+    return { rejectMemory, isRejecting, error, clearError };
+}
+//# sourceMappingURL=useRejectMemory.js.map

package/memory/useRejectMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRejectMemory.js","sourceRoot":"","sources":["../../src/memory/useRejectMemory.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;;;;;;;;;;;;;;;;;;;GAmBG;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,EAAU,EAAmB,EAAE;QACpC,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,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,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/memory/useUpdateMemoryContent.d.ts

@@ -0,0 +1,32 @@
+import type { Memory } from "@stigmer/protos/ai/stigmer/agentic/memory/v1/api_pb";
+/** Return value of {@link useUpdateMemoryContent}. */
+export interface UseUpdateMemoryContentReturn {
+    /** Replace a memory's fact text. Resolves with the updated record. */
+    readonly updateContent: (memory: Memory, content: string) => Promise<Memory>;
+    /** `true` while the update request 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 edits a memory's fact text — the one field the
+ * subject owns after capture (DD-004).
+ *
+ * The update RPC replaces the entire spec, so the loaded record is
+ * mapped through the generated `toMemoryUpdateInput` and only `content`
+ * is overridden — the wipe-safe editing rule. Subject and provenance
+ * ride along verbatim (they are update-immutable server-side), and the
+ * consent lifecycle is never touched by updates.
+ *
+ * @example
+ * ```tsx
+ * const { updateContent, isUpdating } = useUpdateMemoryContent();
+ *
+ * await updateContent(memory, editedText);
+ * refetch(); // refresh the list after the edit
+ * ```
+ */
+export declare function useUpdateMemoryContent(): UseUpdateMemoryContentReturn;
+//# sourceMappingURL=useUpdateMemoryContent.d.ts.map

package/memory/useUpdateMemoryContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateMemoryContent.d.ts","sourceRoot":"","sources":["../../src/memory/useUpdateMemoryContent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAKlF,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,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;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CA4BrE"}

package/memory/useUpdateMemoryContent.js

@@ -0,0 +1,48 @@
+"use client";
+import { useCallback, useState } from "react";
+import { toMemoryUpdateInput } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that edits a memory's fact text — the one field the
+ * subject owns after capture (DD-004).
+ *
+ * The update RPC replaces the entire spec, so the loaded record is
+ * mapped through the generated `toMemoryUpdateInput` and only `content`
+ * is overridden — the wipe-safe editing rule. Subject and provenance
+ * ride along verbatim (they are update-immutable server-side), and the
+ * consent lifecycle is never touched by updates.
+ *
+ * @example
+ * ```tsx
+ * const { updateContent, isUpdating } = useUpdateMemoryContent();
+ *
+ * await updateContent(memory, editedText);
+ * refetch(); // refresh the list after the edit
+ * ```
+ */
+export function useUpdateMemoryContent() {
+    const stigmer = useStigmer();
+    const [isUpdating, setIsUpdating] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const updateContent = useCallback(async (memory, content) => {
+        setIsUpdating(true);
+        setError(null);
+        try {
+            return await stigmer.memory.update({
+                ...toMemoryUpdateInput(memory),
+                content,
+            });
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsUpdating(false);
+        }
+    }, [stigmer]);
+    return { updateContent, isUpdating, error, clearError };
+}
+//# sourceMappingURL=useUpdateMemoryContent.js.map

package/memory/useUpdateMemoryContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateMemoryContent.js","sourceRoot":"","sources":["../../src/memory/useUpdateMemoryContent.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAcjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,sBAAsB;IACpC,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,aAAa,GAAG,WAAW,CAC/B,KAAK,EAAE,MAAc,EAAE,OAAe,EAAmB,EAAE;QACzD,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;gBACjC,GAAG,mBAAmB,CAAC,MAAM,CAAC;gBAC9B,OAAO;aACR,CAAC,CAAC;QACL,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,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC1D,CAAC"}

package/organization/OrgPreferencesPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OrgPreferencesPanel.d.ts","sourceRoot":"","sources":["../../src/organization/OrgPreferencesPanel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAO9F,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,SAAS,EACT,SAAS,GACV,EAAE,wBAAwB,kDA8K1B"}
+{"version":3,"file":"OrgPreferencesPanel.d.ts","sourceRoot":"","sources":["../../src/organization/OrgPreferencesPanel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AAQ9F,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,SAAS,EACT,SAAS,GACV,EAAE,wBAAwB,kDA8N1B"}