@jini-ai/ui 0.1.0

package/dist/features/memory/react/hooks/useMemoryEntries.hooks.js

@@ -0,0 +1,341 @@
+// Feature-local hook for the saved-memories cluster: the entry list + tree, the
+// MEMORY.md index, the preview toggle, and the manual create/edit/delete flow.
+//
+// Same paradigm as useMemoryConfig: transport is INJECTED as the slice port
+// (bound by the wirer), pure logic is imported. Unlike config, this hook also
+// takes runtime *coordination* a host supplies at call time — it does not own
+// the flash pill, the config flags, or the editor modal, so those cross the
+// boundary as small callbacks rather than inter-hook imports.
+import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+import { copyToClipboard } from '../../../../utils/copy-to-clipboard.js';
+import { createAsyncCommitGuard } from '../../async-commit-guard.js';
+import { memoryEntriesPort } from '../../dependencies.js';
+import { EMPTY_DRAFT } from '../../constants.js';
+const LOAD_ERROR_MESSAGE = "Memory data couldn't be loaded. Try again shortly.";
+const MUTATION_ERROR_MESSAGE = "Memory changes couldn't be saved. Try again shortly.";
+export function useMemoryEntries(port, coord) {
+    const { fireFlash, captureConfigHydrationRevision, hydrateConfig, openEditor, closeEditor } = coord;
+    const [rootDir, setRootDir] = useState('');
+    const [index, setIndex] = useState('');
+    const [indexDraft, setIndexDraft] = useState(null);
+    const [entries, setEntries] = useState([]);
+    const [loadError, setLoadError] = useState(null);
+    const [memoryTree, setMemoryTree] = useState([]);
+    const [previewId, setPreviewId] = useState(null);
+    const [previewBody, setPreviewBody] = useState(null);
+    const [editing, setEditingState] = useState(null);
+    // The editor can remain interactive while a save is on the wire. Every edit
+    // change gets a revision, allowing the save completion to close only the
+    // exact draft it persisted rather than dismissing a newer draft.
+    const editingRevisionRef = useRef(0);
+    const setEditing = useCallback((next) => {
+        editingRevisionRef.current += 1;
+        setEditingState(next);
+    }, []);
+    const [busy, setBusy] = useState(false);
+    // Entry and index writes can overlap after the user switches tabs. Keep the
+    // shared `busy` signal true until ALL writes finish, rather than letting the
+    // first completion re-enable controls while another request is still live.
+    const busyOperationCountRef = useRef(0);
+    const beginBusy = useCallback(() => {
+        busyOperationCountRef.current += 1;
+        setBusy(true);
+    }, []);
+    const endBusy = useCallback(() => {
+        busyOperationCountRef.current -= 1;
+        if (busyOperationCountRef.current <= 0) {
+            busyOperationCountRef.current = 0;
+            setBusy(false);
+        }
+    }, []);
+    const entrySaveInFlightRef = useRef(false);
+    const indexSaveInFlightRef = useRef(false);
+    const deletingEntryIdsRef = useRef(new Set());
+    const [filter, setFilter] = useState('all');
+    const editorRef = useRef(null);
+    const editorNameRef = useRef(null);
+    const editingTarget = editing?.id ?? (editing ? 'new' : null);
+    // Each preview/edit action gets its own monotonic token, so a stale
+    // fetchMemoryEntry() response can never win over a newer action — even one
+    // that re-selects the SAME id (close then reopen, or cancel then restart
+    // the same entry) while the abandoned request is still in flight. Tracking
+    // by id alone can't distinguish that case since both requests share an id.
+    const previewRequestTokenRef = useRef(0);
+    const editRequestTokenRef = useRef(0);
+    // reload() is the shared read path for mount, SSE change events, save/delete
+    // flows, and connector refreshes, so overlapping calls are expected. Gate
+    // every state commit behind a monotonic token so an older reload() that
+    // resolves after a newer one can never overwrite the fresher snapshot.
+    const reloadCommitGuardRef = useRef(createAsyncCommitGuard());
+    useEffect(() => {
+        if (!editingTarget)
+            return;
+        editorRef.current?.scrollIntoView?.({ block: 'start', behavior: 'smooth' });
+        editorNameRef.current?.focus({ preventScroll: true });
+    }, [editingTarget]);
+    const onCopyPath = useCallback(async () => {
+        if (!rootDir)
+            return;
+        // `@jini-ai/ui`'s `copyToClipboard` (unlike the pinned source's) never
+        // rejects — it already falls back from the Clipboard API to a hidden
+        // textarea + `execCommand('copy')` internally and resolves `false` when
+        // BOTH paths fail (e.g. a locked-down document). Check the boolean
+        // instead of catching a throw, but preserve the original intent: a total
+        // failure must not claim success with a copy flash.
+        const copied = await copyToClipboard(rootDir);
+        if (copied) {
+            fireFlash('pathCopied');
+        }
+        else {
+            setLoadError(LOAD_ERROR_MESSAGE);
+        }
+    }, [rootDir, fireFlash]);
+    const reload = useCallback(async () => {
+        const token = reloadCommitGuardRef.current.begin();
+        const configHydrationRevision = captureConfigHydrationRevision();
+        try {
+            const list = await port.fetchMemoryList();
+            // The flat list is the primary saved-memory surface. A tree is an
+            // enhancement for hierarchy-aware rendering, so a transient tree
+            // failure must not hide otherwise readable memories or their controls.
+            let tree = [];
+            try {
+                tree = await port.fetchMemoryTree();
+            }
+            catch {
+                // Keep the last confirmed list and render without tree affordances.
+            }
+            // A newer reload() already committed its snapshot; this older response
+            // must not regress it (or hydrateConfig a just-succeeded toggle back).
+            if (!reloadCommitGuardRef.current.isCurrent(token))
+                return;
+            hydrateConfig(list, configHydrationRevision);
+            setRootDir(list.rootDir);
+            setIndex(list.index);
+            setEntries(list.entries);
+            setMemoryTree(tree);
+            setLoadError(null);
+        }
+        catch {
+            // Do not invent an empty "success" response: leave the last confirmed
+            // state intact and let the shell render this explicit failure instead.
+            if (!reloadCommitGuardRef.current.isCurrent(token))
+                return;
+            setLoadError(LOAD_ERROR_MESSAGE);
+        }
+    }, [port, captureConfigHydrationRevision, hydrateConfig]);
+    const filtered = useMemo(() => {
+        if (filter === 'all')
+            return entries;
+        return entries.filter((e) => e.type === filter);
+    }, [entries, filter]);
+    const treeFolders = useMemo(() => memoryTree.filter((node) => node.kind === 'folder'), [memoryTree]);
+    const treeChildren = useMemo(() => {
+        const map = new Map();
+        for (const node of memoryTree) {
+            if (node.kind !== 'entry' || !node.parentId)
+                continue;
+            const list = map.get(node.parentId) ?? [];
+            list.push(node);
+            map.set(node.parentId, list);
+        }
+        return map;
+    }, [memoryTree]);
+    const openPreview = useCallback(async (id) => {
+        if (previewId === id) {
+            previewRequestTokenRef.current += 1;
+            setPreviewId(null);
+            setPreviewBody(null);
+            return;
+        }
+        const token = ++previewRequestTokenRef.current;
+        setPreviewId(id);
+        setPreviewBody(null);
+        let entry;
+        try {
+            // The port resolves null only for a genuine not-found; a 5xx/transport
+            // failure rejects and must surface as a failed read, not render as an
+            // empty preview.
+            entry = await port.fetchMemoryEntry(id);
+        }
+        catch {
+            // A stale request's failure must not clobber a newer action's state.
+            if (previewRequestTokenRef.current !== token)
+                return;
+            setPreviewId(null);
+            setPreviewBody(null);
+            setLoadError(LOAD_ERROR_MESSAGE);
+            return;
+        }
+        if (previewRequestTokenRef.current !== token)
+            return;
+        setLoadError(null);
+        setPreviewBody(entry?.body ?? '');
+    }, [previewId, port]);
+    const startEdit = useCallback(async (id) => {
+        const token = ++editRequestTokenRef.current;
+        let entry;
+        try {
+            entry = await port.fetchMemoryEntry(id);
+        }
+        catch {
+            // A stale request's failure must not clobber a newer action's state.
+            if (editRequestTokenRef.current !== token)
+                return;
+            setLoadError(LOAD_ERROR_MESSAGE);
+            return;
+        }
+        if (editRequestTokenRef.current !== token)
+            return;
+        setLoadError(null);
+        if (!entry)
+            return;
+        openEditor();
+        setEditing({
+            id: entry.id,
+            name: entry.name,
+            description: entry.description,
+            type: entry.type,
+            body: entry.body,
+        });
+    }, [port, openEditor, setEditing]);
+    const startNew = useCallback(() => {
+        editRequestTokenRef.current += 1;
+        openEditor();
+        setEditing({ ...EMPTY_DRAFT });
+    }, [openEditor, setEditing]);
+    const cancelEdit = useCallback(() => {
+        editRequestTokenRef.current += 1;
+        setEditing(null);
+    }, [setEditing]);
+    const onSave = useCallback(async () => {
+        if (!editing)
+            return;
+        if (!editing.name.trim())
+            return;
+        if (entrySaveInFlightRef.current)
+            return;
+        entrySaveInFlightRef.current = true;
+        const wasNew = !editing.id;
+        const editingRevision = editingRevisionRef.current;
+        beginBusy();
+        try {
+            const entry = await port.saveMemoryEntry(editing);
+            if (!entry) {
+                // A resolved `null` is the port's ordinary non-2xx failure signal.
+                // Treat it as a visible failure, like a thrown transport error, rather
+                // than making a click appear to do nothing.
+                setLoadError(MUTATION_ERROR_MESSAGE);
+                return;
+            }
+            await reload();
+            if (editingRevisionRef.current === editingRevision) {
+                setEditing(null);
+                closeEditor();
+            }
+            fireFlash(wasNew ? 'created' : 'saved');
+        }
+        catch {
+            // A thrown save (as opposed to a resolved `null` failure) must still
+            // surface as a load error instead of propagating as an unhandled
+            // rejection with no user-visible feedback at all.
+            setLoadError(LOAD_ERROR_MESSAGE);
+        }
+        finally {
+            entrySaveInFlightRef.current = false;
+            endBusy();
+        }
+    }, [editing, reload, fireFlash, port, closeEditor, setEditing, beginBusy, endBusy]);
+    const onDelete = useCallback(async (id) => {
+        if (deletingEntryIdsRef.current.has(id))
+            return;
+        deletingEntryIdsRef.current.add(id);
+        try {
+            const ok = await port.deleteMemoryEntry(id);
+            if (ok) {
+                await reload();
+                fireFlash('deleted');
+            }
+            else {
+                setLoadError(MUTATION_ERROR_MESSAGE);
+            }
+        }
+        catch {
+            setLoadError(LOAD_ERROR_MESSAGE);
+        }
+        finally {
+            deletingEntryIdsRef.current.delete(id);
+        }
+    }, [reload, fireFlash, port]);
+    const onSaveIndex = useCallback(async () => {
+        if (indexDraft === null)
+            return;
+        if (indexSaveInFlightRef.current)
+            return;
+        indexSaveInFlightRef.current = true;
+        const savedDraft = indexDraft;
+        beginBusy();
+        try {
+            const ok = await port.saveMemoryIndex(savedDraft);
+            if (ok) {
+                setIndex(savedDraft);
+                // Only clear the draft if the user hasn't already typed a NEWER,
+                // still-unsaved edit while this save was in flight — a stale closure
+                // unconditionally clearing here would silently discard that edit
+                // even though it was never sent to the server.
+                setIndexDraft((current) => (current === savedDraft ? null : current));
+                setLoadError(null);
+                fireFlash('indexSaved');
+            }
+            else {
+                setLoadError(MUTATION_ERROR_MESSAGE);
+            }
+        }
+        catch {
+            setLoadError(LOAD_ERROR_MESSAGE);
+        }
+        finally {
+            indexSaveInFlightRef.current = false;
+            endBusy();
+        }
+    }, [indexDraft, fireFlash, port, beginBusy, endBusy]);
+    return {
+        loadError,
+        entries,
+        filtered,
+        memoryTree,
+        treeFolders,
+        treeChildren,
+        rootDir,
+        index,
+        indexDraft,
+        setIndexDraft,
+        previewId,
+        previewBody,
+        editing,
+        setEditing,
+        busy,
+        filter,
+        setFilter,
+        editorRef,
+        editorNameRef,
+        reload,
+        onCopyPath,
+        openPreview,
+        startEdit,
+        startNew,
+        cancelEdit,
+        onSave,
+        onDelete,
+        onSaveIndex,
+    };
+}
+/**
+ * Wirer: binds the real entries transport and returns a hook that still takes
+ * a host's runtime coordination. The default a host injects; swap it via the
+ * component prop in tests.
+ */
+export function useWiredMemoryEntries(coord) {
+    return useMemoryEntries(memoryEntriesPort, coord);
+}
+//# sourceMappingURL=useMemoryEntries.hooks.js.map

package/dist/features/memory/react/hooks/useMemoryEntries.hooks.js.map

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

package/dist/features/memory/react/hooks/useMemoryExtractions.hooks.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryExtractionsPort } from '../../ports.js';
+import type { MemoryExtractionEvent, MemoryExtractionRecord } from '../../types.js';
+export interface MemoryExtractionsController {
+    /** Non-null when the extraction-history read failed. */
+    loadError?: string | null;
+    extractions: MemoryExtractionRecord[];
+    isRefreshing: boolean;
+    /** Wall clock refreshed every 30s so relative ages don't freeze. */
+    nowClock: number;
+    showNoProviderBanner: boolean;
+    connectorExtractions: MemoryExtractionRecord[];
+    reloadExtractions: () => Promise<MemoryExtractionRecord[]>;
+    /** Apply one live `extraction` SSE frame (merge/insert/clear/delete). */
+    applyExtractionEvent: (event: MemoryExtractionEvent) => void;
+    onDeleteExtraction: (id: string) => Promise<void>;
+    /** Clear all history (no confirm — a host owns the prompt). */
+    clearExtractions: () => Promise<void>;
+}
+export declare function useMemoryExtractions(port: MemoryExtractionsPort): MemoryExtractionsController;
+export declare function useWiredMemoryExtractions(): MemoryExtractionsController;
+//# sourceMappingURL=useMemoryExtractions.hooks.d.ts.map

package/dist/features/memory/react/hooks/useMemoryExtractions.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemoryExtractions.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/features/memory/react/hooks/useMemoryExtractions.hooks.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAMpF,MAAM,WAAW,2BAA2B;IAC1C,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,sBAAsB,EAAE,CAAC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oBAAoB,EAAE,sBAAsB,EAAE,CAAC;IAC/C,iBAAiB,EAAE,MAAM,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC3D,yEAAyE;IACzE,oBAAoB,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC7D,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,2BAA2B,CAqK7F;AAED,wBAAgB,yBAAyB,IAAI,2BAA2B,CAEvE"}

package/dist/features/memory/react/hooks/useMemoryExtractions.hooks.js

@@ -0,0 +1,181 @@
+// Feature-local hook for the extraction history: the one-shot list fetch, the
+// live SSE merge, the relative-time clock, and delete/clear. Transport is the
+// injected port; the SSE subscription itself is a host concern (opening an
+// EventSource is DOM transport, so it can't sit in a feature file) — a host
+// opens the stream and feeds each `extraction` frame to `applyExtractionEvent`
+// here.
+//
+// All merge/reconciliation logic and the concurrency-ordering model live in
+// the pure store, `./useMemoryExtractions.store.ts` — read its header comment
+// for the three ordering rules the hook relies on. This file is just the
+// React shell: it owns the port I/O (reload/delete/clear), the derived UI
+// state (banner, connector partition, relative-time clock), and wiring the
+// store's synchronous transitions to React state.
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { createAsyncCommitGuard } from '../../async-commit-guard.js';
+import { memoryExtractionsPort } from '../../dependencies.js';
+import { createExtractionHistoryStore } from './useMemoryExtractions.store.js';
+const LOAD_ERROR_MESSAGE = "Memory extraction history couldn't be loaded. Try again shortly.";
+const MUTATION_ERROR_MESSAGE = "Memory extraction history couldn't be updated. Try again shortly.";
+export function useMemoryExtractions(port) {
+    // Recent extraction attempts, newest first — a render mirror of the
+    // store's rows. All mutation logic lives in the store (see its docs).
+    const [extractions, setExtractions] = useState([]);
+    const [loadError, setLoadError] = useState(null);
+    const [isRefreshing, setIsRefreshing] = useState(false);
+    const storeRef = useRef(null);
+    // `setExtractions` is stable, so creating the store once on first render
+    // keeps store state and the rendered rows resolved together.
+    if (!storeRef.current)
+        storeRef.current = createExtractionHistoryStore(setExtractions);
+    const store = storeRef.current;
+    // Orders reloadExtractions() against itself (rule A, via the slice's
+    // shared primitive): two overlapping reloads race two INDEPENDENT server
+    // reads, so resolution order says nothing about freshness — only call
+    // order does. Only the latest-started call's response may commit; an older
+    // response is discarded outright, not merely reconciled. Local mutations
+    // do NOT invalidate this guard: their effects are already protected by the
+    // store's tombstones/pending hides, which a committing snapshot respects.
+    const reloadGuard = useRef(createAsyncCommitGuard());
+    // isRefreshing counts in-flight reloads so one completing doesn't clear it
+    // while another is still pending.
+    const inFlightReloads = useRef(0);
+    const reloadExtractions = useCallback(async () => {
+        const ticket = reloadGuard.current.begin();
+        inFlightReloads.current += 1;
+        setIsRefreshing(true);
+        // Capture the clock BEFORE the read starts (rule A): mount, SSE frames,
+        // and delete/clear flows can all trigger reloads concurrently, so the
+        // snapshot that lands must reconcile against local state, not overwrite.
+        const sinceClock = store.snapshotClock();
+        // Released at every exit point below instead of a `try/finally`: a bare
+        // `catch {}` here never itself throws, so a `finally` would carry a
+        // structurally-unreachable "exception during catch" edge that no real
+        // test could ever hit — see the coverage-loop note in this file's test
+        // suite for why this shape was chosen over that dead branch.
+        const endReload = () => {
+            inFlightReloads.current -= 1;
+            if (inFlightReloads.current <= 0) {
+                inFlightReloads.current = 0;
+                setIsRefreshing(false);
+            }
+        };
+        try {
+            const confirmed = await port.fetchExtractions();
+            if (!reloadGuard.current.isCurrent(ticket)) {
+                endReload();
+                return store.rows();
+            }
+            // Return what actually committed, not the raw fetch — reconciliation
+            // can drop/keep rows differently than the raw response (a real caller,
+            // useMemoryConnectors, reads this return value directly).
+            const committed = store.commitSnapshot(confirmed, sinceClock);
+            setLoadError(null);
+            endReload();
+            return committed;
+        }
+        catch {
+            endReload();
+            if (!reloadGuard.current.isCurrent(ticket))
+                return store.rows();
+            // Keep the last confirmed history instead of presenting a synthetic
+            // empty list when the daemon cannot be reached — and return that same
+            // preserved state, since callers read this value directly.
+            setLoadError(LOAD_ERROR_MESSAGE);
+            return store.rows();
+        }
+    }, [port, store]);
+    const applyExtractionEvent = useCallback((ev) => {
+        store.applyFrame(ev);
+    }, [store]);
+    const onDeleteExtraction = useCallback(async (id) => {
+        // Optimistic removal: drop the row immediately so the click feels
+        // instant. The SSE 'deleted' echo arriving moments later is a no-op
+        // against the tombstone; if the request fails we re-fetch server truth
+        // instead of silently lying.
+        const token = store.beginDelete(id);
+        let ok = false;
+        try {
+            ok = await port.deleteExtraction(id);
+        }
+        catch {
+            // A network failure rejects rather than returning the adapter's
+            // normal non-2xx `false`. Treat both alike so the optimistic UI
+            // never claims the server-side row was deleted when it was not.
+        }
+        if (ok) {
+            store.settleDeleteSuccess(id);
+            setLoadError(null);
+            return;
+        }
+        store.settleDeleteFailure(id);
+        try {
+            const confirmed = await port.fetchExtractions();
+            // Reconcile rather than overwrite: newer SSE frames or overlapping
+            // mutations may have landed while this recovery read was in flight.
+            store.commitSnapshot(confirmed, token.startClock);
+            // Recovery restores server truth, but the requested delete still
+            // failed. Keep that failure visible instead of making the restored row
+            // look like an unexplained no-op.
+            setLoadError(MUTATION_ERROR_MESSAGE);
+        }
+        catch {
+            store.restoreIfUnchanged(token);
+            setLoadError(LOAD_ERROR_MESSAGE);
+        }
+    }, [port, store]);
+    const clearExtractions = useCallback(async () => {
+        const token = store.beginClear();
+        let ok = false;
+        try {
+            ok = await port.clearExtractionHistory();
+        }
+        catch {
+            // See the per-row delete path above: fetch rejects on transport failure.
+        }
+        if (ok) {
+            store.settleClearSuccess(token);
+            setLoadError(null);
+            return;
+        }
+        store.settleClearFailure();
+        try {
+            const confirmed = await port.fetchExtractions();
+            store.commitSnapshot(confirmed, token.startClock);
+            setLoadError(MUTATION_ERROR_MESSAGE);
+        }
+        catch {
+            store.restoreIfUnchanged(token);
+            setLoadError(LOAD_ERROR_MESSAGE);
+        }
+    }, [port, store]);
+    // The "no API key" banner only shows when the most recent attempt skipped
+    // for that specific reason. We don't show it for memory-disabled (the
+    // user's own toggle) or empty-message (a routine no-op on tool-only turns).
+    const showNoProviderBanner = useMemo(() => {
+        const latest = extractions[0];
+        return Boolean(latest && latest.phase === 'skipped' && latest.reason === 'no-provider');
+    }, [extractions]);
+    const [nowClock, setNowClock] = useState(() => Date.now());
+    useEffect(() => {
+        const id = setInterval(() => setNowClock(Date.now()), 30_000);
+        return () => clearInterval(id);
+    }, []);
+    const connectorExtractions = useMemo(() => extractions.filter((record) => record.kind === 'connector'), [extractions]);
+    return {
+        loadError,
+        extractions,
+        isRefreshing,
+        nowClock,
+        showNoProviderBanner,
+        connectorExtractions,
+        reloadExtractions,
+        applyExtractionEvent,
+        onDeleteExtraction,
+        clearExtractions,
+    };
+}
+export function useWiredMemoryExtractions() {
+    return useMemoryExtractions(memoryExtractionsPort);
+}
+//# sourceMappingURL=useMemoryExtractions.hooks.js.map

package/dist/features/memory/react/hooks/useMemoryExtractions.hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemoryExtractions.hooks.js","sourceRoot":"","sources":["../../../../../src/features/memory/react/hooks/useMemoryExtractions.hooks.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,QAAQ;AACR,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,yEAAyE;AACzE,0EAA0E;AAC1E,2EAA2E;AAC3E,kDAAkD;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,4BAA4B,EAA+B,MAAM,iCAAiC,CAAC;AAE5G,MAAM,kBAAkB,GAAG,kEAAkE,CAAC;AAC9F,MAAM,sBAAsB,GAAG,mEAAmE,CAAC;AAmBnG,MAAM,UAAU,oBAAoB,CAAC,IAA2B;IAC9D,oEAAoE;IACpE,sEAAsE;IACtE,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAA2B,EAAE,CAAC,CAAC;IAC7E,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAChE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAgC,IAAI,CAAC,CAAC;IAC7D,yEAAyE;IACzE,6DAA6D;IAC7D,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,QAAQ,CAAC,OAAO,GAAG,4BAA4B,CAAC,cAAc,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC;IAE/B,qEAAqE;IACrE,yEAAyE;IACzE,sEAAsE;IACtE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,WAAW,GAAG,MAAM,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACrD,2EAA2E;IAC3E,kCAAkC;IAClC,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAElC,MAAM,iBAAiB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC3C,eAAe,CAAC,OAAO,IAAI,CAAC,CAAC;QAC7B,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,wEAAwE;QACxE,sEAAsE;QACtE,yEAAyE;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QACzC,wEAAwE;QACxE,oEAAoE;QACpE,sEAAsE;QACtE,uEAAuE;QACvE,6DAA6D;QAC7D,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,eAAe,CAAC,OAAO,IAAI,CAAC,CAAC;YAC7B,IAAI,eAAe,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;gBACjC,eAAe,CAAC,OAAO,GAAG,CAAC,CAAC;gBAC5B,eAAe,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAChD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3C,SAAS,EAAE,CAAC;gBACZ,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;YACD,qEAAqE;YACrE,uEAAuE;YACvE,0DAA0D;YAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC9D,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;YAChE,oEAAoE;YACpE,sEAAsE;YACtE,2DAA2D;YAC3D,YAAY,CAAC,kBAAkB,CAAC,CAAC;YACjC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAElB,MAAM,oBAAoB,GAAG,WAAW,CACtC,CAAC,EAAyB,EAAE,EAAE;QAC5B,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,MAAM,kBAAkB,GAAG,WAAW,CACpC,KAAK,EAAE,EAAU,EAAE,EAAE;QACnB,kEAAkE;QAClE,oEAAoE;QACpE,uEAAuE;QACvE,6BAA6B;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,EAAE,GAAG,KAAK,CAAC;QACf,IAAI,CAAC;YACH,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;YAChE,gEAAgE;YAChE,gEAAgE;QAClE,CAAC;QACD,IAAI,EAAE,EAAE,CAAC;YACP,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;YAC9B,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAChD,mEAAmE;YACnE,oEAAoE;YACpE,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAClD,iEAAiE;YACjE,uEAAuE;YACvE,kCAAkC;YAClC,YAAY,CAAC,sBAAsB,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAChC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,EACD,CAAC,IAAI,EAAE,KAAK,CAAC,CACd,CAAC;IAEF,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,EAAE,GAAG,KAAK,CAAC;QACf,IAAI,CAAC;YACH,EAAE,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;QAC3E,CAAC;QACD,IAAI,EAAE,EAAE,CAAC;YACP,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAChC,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAChD,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAClD,YAAY,CAAC,sBAAsB,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAChC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAElB,0EAA0E;IAC1E,sEAAsE;IACtE,4EAA4E;IAC5E,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;IAC1F,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAEvH,OAAO;QACL,SAAS;QACT,WAAW;QACX,YAAY;QACZ,QAAQ;QACR,oBAAoB;QACpB,oBAAoB;QACpB,iBAAiB;QACjB,oBAAoB;QACpB,kBAAkB;QAClB,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;AACrD,CAAC"}

package/dist/features/memory/react/hooks/useMemoryExtractions.store.d.ts

@@ -0,0 +1,69 @@
+import type { MemoryExtractionEvent, MemoryExtractionRecord } from '../../types.js';
+export declare function phaseProgress(phase: MemoryExtractionRecord['phase']): number;
+/**
+ * Ordering rule B: resolve two versions of the same persisted attempt without
+ * using browser reception order. Terminal phase progression is authoritative;
+ * when both sides are terminal, the completion timestamp breaks a real tie.
+ * Equivalent records are merged so a confirmed read can fill fields an
+ * earlier stream frame did not yet contain without erasing fields it omitted.
+ */
+export declare function mergeSameAttempt(local: MemoryExtractionRecord, incoming: MemoryExtractionRecord): MemoryExtractionRecord;
+/**
+ * Handed back by `beginDelete`/`beginClear`; carries exactly the facts the
+ * settle path needs and that only the START of the operation can know.
+ */
+export interface DeleteOpToken {
+    /** Rows as they were the instant before the optimistic removal. */
+    previousRows: MemoryExtractionRecord[];
+    /**
+     * Logical time of the optimistic write. The failure path's recovery GET
+     * reconciles against it; the recovery-also-failed path restores
+     * `previousRows` only if nothing advanced the clock past it.
+     */
+    startClock: number;
+}
+export interface ClearOpToken extends DeleteOpToken {
+    /**
+     * Every id this clear owns: rows visible when it started plus ids an
+     * overlapping delete had already optimistically hidden (those can still be
+     * present on the daemon when the clear lands, so the clear covers them
+     * too). Tombstoned wholesale if the clear succeeds.
+     */
+    ownedIds: Set<string>;
+}
+/**
+ * The single source of truth for extraction-history state. Pure TypeScript —
+ * no React, no transport — so every transition is synchronous and the
+ * ordering rules in the module doc comment hold by construction rather than
+ * by per-callsite bookkeeping. The hook is a thin shell that pairs store
+ * transitions with port I/O and mirrors `rows` into React state.
+ */
+export interface ExtractionHistoryStore {
+    rows(): MemoryExtractionRecord[];
+    /** Capture the logical clock before starting a GET (rule A). */
+    snapshotClock(): number;
+    /**
+     * Reconcile a resolved GET against everything that happened since it
+     * started. Returns the rows that actually committed — which can differ
+     * from the raw response — so callers can hand them straight to consumers
+     * (useMemoryConnectors reads reloadExtractions()'s return directly).
+     */
+    commitSnapshot(confirmed: MemoryExtractionRecord[], sinceClock: number): MemoryExtractionRecord[];
+    /** Apply one live SSE frame (merge/insert/defer/clear/delete). */
+    applyFrame(ev: MemoryExtractionEvent): void;
+    beginDelete(id: string): DeleteOpToken;
+    settleDeleteSuccess(id: string): void;
+    settleDeleteFailure(id: string): void;
+    beginClear(): ClearOpToken;
+    settleClearSuccess(token: ClearOpToken): void;
+    settleClearFailure(): void;
+    /**
+     * Last-resort rollback for "mutation failed AND its recovery GET failed":
+     * restore the pre-mutation rows, but only if nothing at all advanced the
+     * clock while the operation was in flight — anything newer (an SSE frame,
+     * another mutation, a committed snapshot) outranks the stale snapshot.
+     */
+    restoreIfUnchanged(token: DeleteOpToken): void;
+}
+export declare function createExtractionHistoryStore(onRowsChanged: (rows: MemoryExtractionRecord[]) => void): ExtractionHistoryStore;
+//# sourceMappingURL=useMemoryExtractions.store.d.ts.map

package/dist/features/memory/react/hooks/useMemoryExtractions.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemoryExtractions.store.d.ts","sourceRoot":"","sources":["../../../../../src/features/memory/react/hooks/useMemoryExtractions.store.ts"],"names":[],"mappings":"AAoEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAKpF,wBAAgB,aAAa,CAAC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,MAAM,CAM5E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,sBAAsB,GAAG,sBAAsB,CAoBxH;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACvC;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD;;;;;OAKG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,IAAI,sBAAsB,EAAE,CAAC;IACjC,gEAAgE;IAChE,aAAa,IAAI,MAAM,CAAC;IACxB;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,sBAAsB,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAAC;IAClG,kEAAkE;IAClE,UAAU,CAAC,EAAE,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC5C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC;IACvC,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,UAAU,IAAI,YAAY,CAAC;IAC3B,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9C,kBAAkB,IAAI,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CAChD;AAED,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,CAAC,IAAI,EAAE,sBAAsB,EAAE,KAAK,IAAI,GACtD,sBAAsB,CAuNxB"}