@astrale-os/shell-react 0.2.8 → 0.2.10-beta.2

package/dist/graph/call/stream.hook.d.ts

@@ -1,28 +1,20 @@
-import type { FnMap, StreamFns } from '@astrale-os/kernel-client';
-export interface StreamOptions<T> {
-    /** Notified per chunk as it arrives (in addition to `chunks` accumulation). */
-    onChunk?(chunk: T): void;
+import type { Call } from '@astrale-os/kernel-client';
+import type { SessionRequestOptions } from '@astrale-os/kernel-client/session';
+import type { Value } from '@astrale-os/sdk/value';
+import type { KernelClient } from '@astrale-os/shell';
+export type KernelStream = Awaited<ReturnType<KernelClient['stream']>>;
+export type StreamItem = Value;
+export type CallAuthor<A extends unknown[]> = Call | ((...args: A) => Call);
+export interface StreamOptions<T = StreamItem> extends SessionRequestOptions {
+    readonly onChunk?: (chunk: T) => void;
 }
-export interface StreamHandle<T> {
-    /** Begin a run: resets chunks, then resolves when the stream ends / rejects on failure. */
-    start(params: unknown): Promise<void>;
-    /** Chunks accumulated in the current run; reset on the next `start`. */
+export interface StreamHandle<A extends unknown[] = unknown[], T = StreamItem> {
+    start(...args: A): Promise<void>;
     readonly chunks: readonly T[];
-    /** The most recent chunk, or null before the first. */
     readonly last: T | null;
-    /** A run is in flight. */
     readonly streaming: boolean;
-    /** Last run failure; retained until the next `start`. */
     readonly error: unknown;
-    /** Close the stream (returns the iterator); a later `start` begins fresh. */
     cancel(): void;
 }
-/**
- * Streaming domain-function dispatch. `start(params)` opens a run over
- * `kernel.stream`; chunks accumulate on `chunks`; `cancel()` closes the iterator
- * and a later `start` begins fresh. A superseding `start` (or unmount) closes the
- * prior run and discards its late chunks/errors — only the current run drives
- * state. Never live; the handle keeps one identity for the hook's lifetime.
- */
-export declare function useStream<K extends StreamFns<FnMap>>(method: K | null, opts?: StreamOptions<FnMap[K]['result']>): StreamHandle<FnMap[K]['result']>;
+export declare function useStream<A extends unknown[] = []>(author: CallAuthor<A> | null, options?: StreamOptions): StreamHandle<A, StreamItem>;
 //# sourceMappingURL=stream.hook.d.ts.map

package/dist/graph/call/stream.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.hook.d.ts","sourceRoot":"","sources":["../../../src/graph/call/stream.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAYjE,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,+EAA+E;IAC/E,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,2FAA2F;IAC3F,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAA;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,6EAA6E;IAC7E,MAAM,IAAI,IAAI,CAAA;CACf;AA2DD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,CAAC,KAAK,CAAC,EAClD,MAAM,EAAE,CAAC,GAAG,IAAI,EAChB,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GACvC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAoGlC"}
+{"version":3,"file":"stream.hook.d.ts","sourceRoot":"","sources":["../../../src/graph/call/stream.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAMrD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AACtE,MAAM,MAAM,UAAU,GAAG,KAAK,CAAA;AAC9B,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CAAA;AAE3E,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,UAAU,CAAE,SAAQ,qBAAqB;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;CACtC;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,UAAU;IAC3E,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,MAAM,IAAI,IAAI,CAAA;CACf;AAmCD,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,EAChD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,EAC5B,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CAAC,CAAC,EAAE,UAAU,CAAC,CA4D7B"}

package/dist/graph/call/stream.hook.js

@@ -1,18 +1,6 @@
-/**
- * useStream (API §7) — streaming domain-function dispatch over `kernel.stream`,
- * an AsyncIterable driven by an explicit start/cancel handle. A superseding
- * `start` (or unmount) closes the prior run and discards its late chunks/errors;
- * never live. Dispatch is a graph operation (rule 2).
- */
 import { useCallback, useEffect, useReducer, useRef } from 'react';
 import { useSessionKernel } from '../../auth/session-kernel.js';
-const IDLE_STREAM = {
-    chunks: [],
-    last: null,
-    streaming: false,
-    error: undefined,
-};
-function streamReducer(state, event) {
+function reducer(state, event) {
     switch (event.type) {
         case 'start':
             return { chunks: [], last: null, streaming: true, error: undefined };
@@ -24,114 +12,70 @@ function streamReducer(state, event) {
                 error: undefined,
             };
         case 'end':
+        case 'cancel':
             return { ...state, streaming: false };
         case 'error':
-            // Chunks accumulated before the failure are preserved.
             return { ...state, streaming: false, error: event.error };
-        case 'cancel':
-            return { ...state, streaming: false };
     }
 }
-/**
- * Streaming domain-function dispatch. `start(params)` opens a run over
- * `kernel.stream`; chunks accumulate on `chunks`; `cancel()` closes the iterator
- * and a later `start` begins fresh. A superseding `start` (or unmount) closes the
- * prior run and discards its late chunks/errors — only the current run drives
- * state. Never live; the handle keeps one identity for the hook's lifetime.
- */
-export function useStream(method, opts) {
+export function useStream(author, options) {
     const kernel = useSessionKernel();
-    // Latest-closure refs so the stable start/cancel dispatch the current inputs.
     const kernelRef = useRef(kernel);
     kernelRef.current = kernel;
-    const methodRef = useRef(method);
-    methodRef.current = method;
-    const optsRef = useRef(opts);
-    optsRef.current = opts;
-    const [snapshot, dispatch] = useReducer(streamReducer, IDLE_STREAM);
-    // `runId` supersession token; only the run whose id is still current drives state.
-    const runIdRef = useRef(0);
-    const currentRef = useRef(null);
-    const alive = useRef(true);
-    const stop = useCallback(() => {
-        const run = currentRef.current;
-        if (run !== null) {
-            run.controller.abort();
-            void run.iterator?.return?.(undefined);
-            currentRef.current = null;
-        }
-    }, []);
-    useEffect(() => {
-        alive.current = true;
-        return () => {
-            alive.current = false;
-            stop();
-        };
-    }, [stop]);
+    const authorRef = useRef(author);
+    authorRef.current = author;
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const [snapshot, dispatch] = useReducer(reducer, {
+        chunks: [],
+        last: null,
+        streaming: false,
+        error: undefined,
+    });
+    const runId = useRef(0);
+    const controller = useRef(null);
     const cancel = useCallback(() => {
-        runIdRef.current += 1;
-        stop();
-        if (alive.current)
-            dispatch({ type: 'cancel' });
-    }, [stop]);
-    const start = useCallback((params) => {
-        const method_ = methodRef.current;
-        if (method_ === null) {
-            return Promise.reject(new Error('useStream: method is null (idle handle started)'));
-        }
-        runIdRef.current += 1;
-        const runId = runIdRef.current;
-        stop(); // close any prior run before opening the new one
+        runId.current += 1;
+        controller.current?.abort();
+        controller.current = null;
+        dispatch({ type: 'cancel' });
+    }, []);
+    useEffect(() => cancel, [cancel]);
+    const start = useCallback(async (...args) => {
+        const current = authorRef.current;
+        if (current === null)
+            throw new Error('useStream: idle handle started');
+        cancel();
+        const id = ++runId.current;
+        const abort = new AbortController();
+        controller.current = abort;
         dispatch({ type: 'start' });
-        const controller = new AbortController();
-        const run = { controller, iterator: null };
-        currentRef.current = run;
-        const current = () => runIdRef.current === runId;
-        return (async () => {
-            try {
-                const iterable = await kernelRef.current.stream(method_, params, {
-                    signal: controller.signal,
-                });
-                if (!current())
+        const call = typeof current === 'function' ? current(...args) : current;
+        try {
+            const { onChunk: _onChunk, ...requestOptions } = optionsRef.current ?? {};
+            const stream = await kernelRef.current.stream(call, {
+                ...requestOptions,
+                signal: abort.signal,
+            });
+            for await (const chunk of stream) {
+                if (id !== runId.current)
                     return;
-                const iterator = iterable[Symbol.asyncIterator]();
-                run.iterator = iterator;
-                for (;;) {
-                    const next = await iterator.next();
-                    if (!current())
-                        return;
-                    if (next.done === true)
-                        break;
-                    if (alive.current)
-                        dispatch({ type: 'chunk', value: next.value });
-                    optsRef.current?.onChunk?.(next.value);
-                }
-                if (current()) {
-                    currentRef.current = null;
-                    if (alive.current)
-                        dispatch({ type: 'end' });
-                }
-            }
-            catch (error) {
-                if (!current())
-                    return; // a superseded/cancelled run's failure is discarded
-                currentRef.current = null;
-                if (alive.current)
-                    dispatch({ type: 'error', error });
-                throw error;
+                dispatch({ type: 'chunk', value: chunk });
+                optionsRef.current?.onChunk?.(chunk);
             }
-        })();
-    }, [stop]);
-    // One render-stable handle: built once (start/cancel are stable), then its
-    // snapshot fields re-stamped each render so reads stay current across chunks.
-    const handleRef = useRef(null);
-    if (handleRef.current === null) {
-        handleRef.current = { start, cancel };
-    }
-    const handle = handleRef.current;
-    handle.chunks = snapshot.chunks;
-    handle.last = snapshot.last;
-    handle.streaming = snapshot.streaming;
-    handle.error = snapshot.error;
-    return handle;
+            if (id === runId.current)
+                dispatch({ type: 'end' });
+        }
+        catch (error) {
+            if (id !== runId.current)
+                return;
+            dispatch({ type: 'error', error });
+            throw error;
+        }
+        finally {
+            if (id === runId.current)
+                controller.current = null;
+        }
+    }, [cancel]);
+    return { start, cancel, ...snapshot };
 }

package/dist/graph/graph.context.d.ts

@@ -1,4 +1,5 @@
-import type { GraphMemory } from '@astrale-os/kernel-client/store';
-export type { GraphMemory };
-export declare const GraphContext: import("react").Context<GraphMemory | null>;
+import type { GraphStore } from '@astrale-os/kernel-client/store';
+/** Optional exact Client GraphStore supplied by an injected Shell adapter. */
+export declare const GraphContext: import("react").Context<GraphStore | null>;
+export type { GraphStore };
 //# sourceMappingURL=graph.context.d.ts.map

package/dist/graph/graph.context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.context.d.ts","sourceRoot":"","sources":["../../src/graph/graph.context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAWlE,YAAY,EAAE,WAAW,EAAE,CAAA;AAC3B,eAAO,MAAM,YAAY,6CAA0C,CAAA"}
+{"version":3,"file":"graph.context.d.ts","sourceRoot":"","sources":["../../src/graph/graph.context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAIjE,8EAA8E;AAC9E,eAAO,MAAM,YAAY,4CAAyC,CAAA;AAGlE,YAAY,EAAE,UAAU,EAAE,CAAA"}

package/dist/graph/graph.context.js

@@ -1,10 +1,4 @@
-/**
- * GraphContext (ex MemoryContext) — the root of the graph plane. Seats the base
- * (default-scope) memory the provider builds; the SAME handle the graph/schema/
- * nav hooks read through `memory/scope.ts`, and selection's liveness source.
- * Under `<ActAs>` the read hooks re-scope via `forScope`; selection reads the
- * base scope here.
- */
 import { createContext } from 'react';
+/** Optional exact Client GraphStore supplied by an injected Shell adapter. */
 export const GraphContext = createContext(null);
-GraphContext.displayName = 'AstraleGraphContext';
+GraphContext.displayName = 'AstraleGraphStoreContext';

package/dist/graph/guards.error.d.ts

@@ -1,9 +1,8 @@
-/**
- * Error taxonomy (API §1.4) — re-exported from kernel-client so shell-react
- * consumers narrow dispatch failures through the single import surface. The
- * dispatched kernel call stays the source of truth; these guards drive UI
- * affordances (retry, request-access, toast). Names match kernel-client exactly.
- */
-export { AuthBatchError, AuthenticationError, ClientSessionError, ConnectionError, DisconnectedError, InvalidTransportError, InvariantViolationError, KernelError, NodeUnavailableError, NotFoundError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, classifyKernelError, isAuthBatchError, isAuthenticationError, isClientSessionError, isDelegationMintError, isDelegationPolicyError, isDelegationRefusedError, isHopLimitExceededError, isIdentityError, isInternalKernelError, isInvalidRequestError, isInvalidTransportError, isInvariantViolationError, isKernelError, isNodeUnavailableError, isNotFoundError, isParseError, isPermissionDeniedError, isPersistenceLoadFailedError, isPoolClosedError, isRedirectPolicyError, isRedirectRefusedError, isRegistryWriteFailedError, isSchemaOwnershipConflictError, isTransportError, isUnsupportedTransportError, isValidationError, isWebOSError, } from '@astrale-os/kernel-client';
-export type { AuthReason, ClientErrorDetails, IdentityError, KernelErrorKind, TransportError, } from '@astrale-os/kernel-client';
+export { ClientError, ProtocolError, ResponseError, StaleRouteError, TransportError, } from '@astrale-os/kernel-client';
+export { NodeUnavailableError } from '@astrale-os/kernel-client/graph';
+export { UnsupportedFeatureError } from './memory/read/envelope.js';
+import { ClientError } from '@astrale-os/kernel-client';
+import { NodeUnavailableError } from '@astrale-os/kernel-client/graph';
+export declare function isClientError(error: unknown): error is ClientError;
+export declare function isNodeUnavailableError(error: unknown): error is NodeUnavailableError;
 //# sourceMappingURL=guards.error.d.ts.map

package/dist/graph/guards.error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.error.d.ts","sourceRoot":"","sources":["../../src/graph/guards.error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,YAAY,GACb,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"guards.error.d.ts","sourceRoot":"","sources":["../../src/graph/guards.error.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAEtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAEpF"}

package/dist/graph/guards.error.js

@@ -1,7 +1,11 @@
-/**
- * Error taxonomy (API §1.4) — re-exported from kernel-client so shell-react
- * consumers narrow dispatch failures through the single import surface. The
- * dispatched kernel call stays the source of truth; these guards drive UI
- * affordances (retry, request-access, toast). Names match kernel-client exactly.
- */
-export { AuthBatchError, AuthenticationError, ClientSessionError, ConnectionError, DisconnectedError, InvalidTransportError, InvariantViolationError, KernelError, NodeUnavailableError, NotFoundError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, classifyKernelError, isAuthBatchError, isAuthenticationError, isClientSessionError, isDelegationMintError, isDelegationPolicyError, isDelegationRefusedError, isHopLimitExceededError, isIdentityError, isInternalKernelError, isInvalidRequestError, isInvalidTransportError, isInvariantViolationError, isKernelError, isNodeUnavailableError, isNotFoundError, isParseError, isPermissionDeniedError, isPersistenceLoadFailedError, isPoolClosedError, isRedirectPolicyError, isRedirectRefusedError, isRegistryWriteFailedError, isSchemaOwnershipConflictError, isTransportError, isUnsupportedTransportError, isValidationError, isWebOSError, } from '@astrale-os/kernel-client';
+export { ClientError, ProtocolError, ResponseError, StaleRouteError, TransportError, } from '@astrale-os/kernel-client';
+export { NodeUnavailableError } from '@astrale-os/kernel-client/graph';
+export { UnsupportedFeatureError } from './memory/read/envelope.js';
+import { ClientError } from '@astrale-os/kernel-client';
+import { NodeUnavailableError } from '@astrale-os/kernel-client/graph';
+export function isClientError(error) {
+    return error instanceof ClientError;
+}
+export function isNodeUnavailableError(error) {
+    return error instanceof NodeUnavailableError;
+}

package/dist/graph/index.d.ts

@@ -1,20 +1,12 @@
-export { useNode } from './query/node.hook.js';
-export type { NodeResult } from './query/node.hook.js';
-export { useChildren } from './query/children.hook.js';
-export type { ChildrenOptions, ChildrenResult } from './query/children.hook.js';
-export { useQuery } from './query/query.hook.js';
-export type { QueryResult } from './query/query.hook.js';
-export { useGraph } from './query/graph.hook.js';
-export { useMutate } from './mutate/mutate.hook.js';
-export type { UseMutateOptions } from './mutate/mutate.hook.js';
-export { useMove } from './mutate/move.hook.js';
-export type { MoveAction } from './mutate/move.hook.js';
+export { useGraphStore } from './store.js';
+export { useQuery } from './query-definition.hook.js';
+export type { QueryResourceOptions } from './query-definition.hook.js';
+export type { GraphResource, GraphResourceState } from './resource.js';
 export { useCall } from './call/call.hook.js';
-export type { CallOptions } from './call/call.hook.js';
+export type { CallOptions, CallResult } from './call/call.hook.js';
 export { useStream } from './call/stream.hook.js';
-export type { StreamHandle, StreamOptions } from './call/stream.hook.js';
+export type { CallAuthor, KernelStream, StreamHandle, StreamItem, StreamOptions, } from './call/stream.hook.js';
 export type { Action } from './action.js';
-export type { ReadState, ReadOptions, Windowed, Node } from './memory/read/envelope.js';
-export type { GraphMemory } from './graph.context.js';
-export type { ShapeInput } from '@astrale-os/kernel-client/store';
+export type { GraphStore } from './graph.context.js';
+export { ClientError, NodeUnavailableError, ProtocolError, ResponseError, StaleRouteError, TransportError, isClientError, isNodeUnavailableError, } from './guards.error.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACxE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAA;AACvF,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACtE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAA"}

package/dist/graph/index.js

@@ -1,9 +1,5 @@
-// graph — the graph plane (API §5 + §7). Merged read hooks, writes, dispatch.
-export { useNode } from './query/node.hook.js';
-export { useChildren } from './query/children.hook.js';
-export { useQuery } from './query/query.hook.js';
-export { useGraph } from './query/graph.hook.js';
-export { useMutate } from './mutate/mutate.hook.js';
-export { useMove } from './mutate/move.hook.js';
+export { useGraphStore } from './store.js';
+export { useQuery } from './query-definition.hook.js';
 export { useCall } from './call/call.hook.js';
 export { useStream } from './call/stream.hook.js';
+export { ClientError, NodeUnavailableError, ProtocolError, ResponseError, StaleRouteError, TransportError, isClientError, isNodeUnavailableError, } from './guards.error.js';

package/dist/graph/memory/read/envelope.d.ts

@@ -1,71 +1,39 @@
-/**
- * The read envelope (API §1.1, §1.5) — the shape every read hook's result
- * extends (`ReadState` + `Windowed`), the `ReadOptions` accepted by every read,
- * and the assembly of the unified `RawRead` projection over a memory shape
- * (empty/idle/keep-previous builders). Dependency-light so every context can
- * consume it without a cycle.
- */
-import type { LiveResult } from '@astrale-os/kernel-client/store';
-/** Base of every read hook's result — stale-while-revalidate + liveness + seq. */
+import type { Node as KernelNode } from '@astrale-os/sdk/graph/node';
+/** Common result state for Shell React reads. */
 export interface ReadState {
-    /** A (re)validation is in flight; data shown alongside is last-good. */
+    /** A request is in flight. Last-good data may still be present. */
     readonly pending: boolean;
-    /** Last refresh failure; last-good data is retained. Cleared on next success. */
+    /** Last request failure. Cleared when the next request begins. */
     readonly error: unknown;
-    /** A watch subscription is active for this shape (Tier ≥ 1), or Tier-0 only. */
+    /** True only when an upstream subscription is active. */
     readonly live: boolean;
-    /** Journal position this result reflects (FRONTEND spec §6.1). 0 until known. */
+    /** Reserved journal position. Direct Graph reads report zero. */
     readonly seq: number;
-    /** Manual revalidate. Rarely needed; kept for tooling and non-live reads. */
     refetch(): Promise<void>;
 }
-/** Windowed reads add a cursor-fold `more`. */
 export interface Windowed {
     readonly more: {
         readonly has: boolean;
-        load(): Promise<void>;
         readonly pending: boolean;
+        load(): Promise<void>;
     };
 }
-/** Options accepted by every read hook (§1.5). */
+/** Options shared by point, Query, and neighbor reads. */
 export interface ReadOptions {
-    /** default true; false = one-shot snapshot. */
-    live?: boolean;
-    /** default true; false → pending-without-data on cold. */
-    suspend?: boolean;
-    /** default false; show previous shape's data while a new one confirms. */
-    keepPrevious?: boolean;
-    /** Visibility permission on the underlying AST — a kernel permission bitmask. */
-    with?: number;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    /** Retain the previous successful value while the next request is pending. */
+    readonly keepPrevious?: boolean;
 }
-/** A graph node — derived from the memory result so no direct kernel-core import is needed. */
-export type Node = NonNullable<LiveResult['node']>;
-/** Read options plus the windowing lever `useChildren`/`useQuery` add. */
-export type CoreReadOptions = ReadOptions & {
-    window?: 'append' | 'paged';
-};
-/**
- * The unified read projection: every data arm the memory materializes, over
- * the shell-react read envelope (`ReadState` + `Windowed`). Each hook narrows
- * to the arms it exposes. The store's `LiveResult` is a structural superset, so
- * the warm path returns it directly (stable ref).
- */
-export interface RawRead extends ReadState, Windowed {
-    readonly nodes: readonly Node[];
-    readonly roots: readonly Node[];
-    readonly first: Node | null;
-    readonly children: readonly Node[];
-    gathered(alias: string): {
-        readonly nodes: readonly Node[];
-        readonly first: Node | null;
-    };
+export type Node = KernelNode;
+export declare const EMPTY_NODES: readonly Node[];
+export declare const NO_MORE: Windowed['more'];
+/** Stable failure for a retained hook whose required Kernel capability does not exist. */
+export declare class UnsupportedFeatureError extends Error {
+    readonly code: 'SHELL_REACT_UNSUPPORTED';
+    readonly feature: string;
+    constructor(feature: string);
 }
-export declare const EMPTY: readonly Node[];
-export declare function emptyRead(pending: boolean): RawRead;
-/** The result for a null/undefined subject (§1.3) — settled, empty, no I/O. */
-export declare const IDLE_READ: RawRead;
-/** Cold shape with `suspend:false` (§1.4) — empty data, pending true. */
-export declare const EMPTY_PENDING: RawRead;
-/** Previous shape's data while a new one confirms (§1.5 `keepPrevious`). */
-export declare function withPending(prev: LiveResult): RawRead;
+export declare function idleReadState(): ReadState;
+export declare function unsupportedReadState(feature: string): ReadState;
 //# sourceMappingURL=envelope.d.ts.map

package/dist/graph/memory/read/envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../../src/graph/memory/read/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAIjE,kFAAkF;AAClF,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,iFAAiF;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,6EAA6E;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,+CAA+C;AAC/C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;QACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;QACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAC1B,CAAA;CACF;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,+FAA+F;AAC/F,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AAElD,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAA;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,OAAQ,SAAQ,SAAS,EAAE,QAAQ;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAA;CAC1F;AAED,eAAO,MAAM,KAAK,EAAE,SAAS,IAAI,EAAO,CAAA;AAQxC,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAcnD;AACD,+EAA+E;AAC/E,eAAO,MAAM,SAAS,SAAmB,CAAA;AACzC,yEAAyE;AACzE,eAAO,MAAM,aAAa,SAAkB,CAAA;AAE5C,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAErD"}
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../../src/graph/memory/read/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAEpE,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;QACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;QACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KACtB,CAAA;CACF;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,MAAM,IAAI,GAAG,UAAU,CAAA;AAE7B,eAAO,MAAM,WAAW,EAAE,SAAS,IAAI,EAAsB,CAAA;AAE7D,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAInC,CAAA;AAEF,0FAA0F;AAC1F,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAG,yBAAyB,CAAS;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB,YAAY,OAAO,EAAE,MAAM,EAI1B;CACF;AAED,wBAAgB,aAAa,IAAI,SAAS,CAQzC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAS/D"}

package/dist/graph/memory/read/envelope.js

@@ -1,29 +1,35 @@
-export const EMPTY = [];
-const idleGathered = () => ({
-    nodes: EMPTY,
-    first: null,
+export const EMPTY_NODES = Object.freeze([]);
+export const NO_MORE = Object.freeze({
+    has: false,
+    pending: false,
+    load: () => Promise.resolve(),
 });
-const idleMore = { has: false, pending: false, load: () => Promise.resolve() };
-export function emptyRead(pending) {
+/** Stable failure for a retained hook whose required Kernel capability does not exist. */
+export class UnsupportedFeatureError extends Error {
+    code = 'SHELL_REACT_UNSUPPORTED';
+    feature;
+    constructor(feature) {
+        super(`${feature} is not supported by the current Kernel Graph contract.`);
+        this.name = 'UnsupportedFeatureError';
+        this.feature = feature;
+    }
+}
+export function idleReadState() {
     return {
-        nodes: EMPTY,
-        roots: EMPTY,
-        first: null,
-        children: EMPTY,
-        gathered: idleGathered,
-        pending,
+        pending: false,
         error: undefined,
         live: false,
         seq: 0,
-        more: idleMore,
         refetch: () => Promise.resolve(),
     };
 }
-/** The result for a null/undefined subject (§1.3) — settled, empty, no I/O. */
-export const IDLE_READ = emptyRead(false);
-/** Cold shape with `suspend:false` (§1.4) — empty data, pending true. */
-export const EMPTY_PENDING = emptyRead(true);
-/** Previous shape's data while a new one confirms (§1.5 `keepPrevious`). */
-export function withPending(prev) {
-    return { ...prev, pending: true };
+export function unsupportedReadState(feature) {
+    const error = new UnsupportedFeatureError(feature);
+    return {
+        pending: false,
+        error,
+        live: false,
+        seq: 0,
+        refetch: () => Promise.reject(error),
+    };
 }

package/dist/graph/memory/read/idle.d.ts

@@ -1,18 +1,4 @@
-/**
- * The idle-input rule (API §1.3). A read hook's `null | undefined` subject is
- * inert: `isIdleInput` is the one gate every read branches on, and
- * `idleReadState` is the settled, not-live, seq-0 envelope it returns.
- */
 import type { ReadState } from './envelope.js';
-/**
- * The chaining rule: every read hook accepts `null | undefined` for its subject
- * and returns an *idle* result (empty data, no I/O). This predicate is the one
- * gate — read hooks branch on it before touching the memory.
- */
-export declare function isIdleInput(subject: unknown): subject is null | undefined;
-/**
- * The idle `ReadState` a read hook returns for a `null`/`undefined` subject:
- * settled, not live, seq 0, `refetch` a resolved no-op.
- */
+export declare function isIdleInput(value: unknown): value is null | undefined;
 export declare function idleReadState(): ReadState;
 //# sourceMappingURL=idle.d.ts.map

package/dist/graph/memory/read/idle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idle.d.ts","sourceRoot":"","sources":["../../../../src/graph/memory/read/idle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,IAAI,GAAG,SAAS,CAEzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAEzC"}
+{"version":3,"file":"idle.d.ts","sourceRoot":"","sources":["../../../../src/graph/memory/read/idle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAI9C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,SAAS,CAErE;AAED,wBAAgB,aAAa,IAAI,SAAS,CAEzC"}

package/dist/graph/memory/read/idle.js

@@ -1,16 +1,7 @@
-/**
- * The chaining rule: every read hook accepts `null | undefined` for its subject
- * and returns an *idle* result (empty data, no I/O). This predicate is the one
- * gate — read hooks branch on it before touching the memory.
- */
-export function isIdleInput(subject) {
-    return subject === null || subject === undefined;
+import { idleReadState as idle } from './envelope.js';
+export function isIdleInput(value) {
+    return value === null || value === undefined;
 }
-/**
- * The idle `ReadState` a read hook returns for a `null`/`undefined` subject:
- * settled, not live, seq 0, `refetch` a resolved no-op.
- */
 export function idleReadState() {
-    return { pending: false, error: undefined, live: false, seq: 0, refetch: idleRefetch };
+    return idle();
 }
-const idleRefetch = () => Promise.resolve();

package/dist/graph/query-definition.hook.d.ts

@@ -0,0 +1,11 @@
+import type { QueryDefinition } from '@astrale-os/sdk/query';
+import type { QueryAST } from '@astrale-os/sdk/query';
+import type { GraphResource } from './resource.js';
+export interface QueryResourceOptions {
+    readonly keepPrevious?: boolean;
+    readonly refreshInterval?: number;
+    readonly refreshWhen?: 'always' | 'visible';
+}
+/** Execute one named SDK Query definition exclusively through the current GraphStore. */
+export declare function useQuery<Input, Output, Query extends QueryAST>(definition: QueryDefinition<Input, Output, Query> | null, input: Input, options?: QueryResourceOptions): GraphResource<Output>;
+//# sourceMappingURL=query-definition.hook.d.ts.map

package/dist/graph/query-definition.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-definition.hook.d.ts","sourceRoot":"","sources":["../../src/graph/query-definition.hook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,eAAe,EAEhB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAMrD,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,eAAe,CAAA;AAMtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CAC5C;AAwID,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAS,QAAQ,EAC5D,UAAU,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,EACxD,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAAC,MAAM,CAAC,CAyDvB"}