@astrale-os/shell-react 0.4.0-beta.16 → 0.4.0-beta.18

package/dist/auth/act-as.context.js

@@ -1,5 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext, useEffect, useMemo, useState } from 'react';
+import { createContext, useContext, useEffect, useState } from 'react';
+import { GraphContext } from '../graph/graph.context.js';
+import { resolveGraphStoreScope, retainStore, storeFor } from '../graph/store.js';
 import { ShellContext } from '../session/session.context.js';
 export const IdentityContext = createContext(null);
 IdentityContext.displayName = 'AstraleIdentityContext';
@@ -19,22 +21,34 @@ export function ActAs({ client, fallback, children }) {
     const [state, setState] = useState({ status: 'pending' });
     useEffect(() => {
         let active = true;
+        let release;
         setState({ status: 'pending' });
-        void client.auth.whoami().then((self) => {
-            if (active)
-                setState({ status: 'ready', self });
-        }, (error) => {
-            if (active)
-                setState({ status: 'failed', error });
-        });
+        void (async () => {
+            try {
+                const self = await client.auth.whoami();
+                if (!active)
+                    return;
+                const scope = await resolveGraphStoreScope(client, self);
+                if (!active)
+                    return;
+                const entry = storeFor(client, scope);
+                release = retainStore(entry);
+                setState({ status: 'ready', binding: { kernel: client, self }, store: entry.store });
+            }
+            catch (error) {
+                if (active)
+                    setState({ status: 'failed', client, error });
+            }
+        })();
         return () => {
             active = false;
+            release?.();
         };
     }, [client]);
-    const value = useMemo(() => (state.status === 'ready' ? { kernel: client, self: state.self } : null), [client, state]);
-    if (state.status === 'failed')
+    if (state.status === 'failed' && state.client === client)
         throw state.error;
-    if (value === null)
+    if (state.status !== 'ready' || state.binding.kernel !== client) {
         return fallback === undefined ? null : _jsx(_Fragment, { children: fallback });
-    return _jsx(IdentityContext.Provider, { value: value, children: children });
+    }
+    return (_jsx(IdentityContext.Provider, { value: state.binding, children: _jsx(GraphContext.Provider, { value: state.store, children: children }) }));
 }

package/dist/graph/query-definition.hook.js

@@ -183,7 +183,7 @@ function combine(snapshots) {
     return 'ready';
 }
 function stableIdentity(value) {
-    const seen = new WeakSet();
+    const ancestors = new WeakSet();
     const encode = (input) => {
         if (input === null)
             return ['null'];
@@ -198,17 +198,22 @@ function stableIdentity(value) {
             }
             return [typeof input, input];
         }
-        if (seen.has(input))
+        if (ancestors.has(input))
             throw new TypeError('Query input cannot contain cycles.');
-        seen.add(input);
-        if (Array.isArray(input))
-            return ['array', input.map(encode)];
-        return [
-            'object',
-            Object.fromEntries(Object.keys(input)
-                .sort()
-                .map((key) => [key, encode(input[key])])),
-        ];
+        ancestors.add(input);
+        try {
+            if (Array.isArray(input))
+                return ['array', input.map(encode)];
+            return [
+                'object',
+                Object.fromEntries(Object.keys(input)
+                    .sort()
+                    .map((key) => [key, encode(input[key])])),
+            ];
+        }
+        finally {
+            ancestors.delete(input);
+        }
     };
     return JSON.stringify(encode(value));
 }

package/dist/graph/resource.js

@@ -227,19 +227,27 @@ export function retainRefreshScheduler(store, identity, refresh, interval, when)
     };
 }
 function schedulePoll(scheduler, immediate = false) {
-    if (scheduler.timer !== undefined)
-        clearTimeout(scheduler.timer);
     const subscribers = [...scheduler.subscribers.values()];
     if (subscribers.length === 0)
         return;
     const interval = Math.min(...subscribers.map((subscriber) => subscriber.interval));
+    const delay = immediate ? 0 : interval;
+    const dueAt = Date.now() + delay;
+    // Observer changes may advance a refresh, but must not postpone pending work.
+    if (scheduler.timer !== undefined) {
+        if (scheduler.dueAt !== undefined && scheduler.dueAt <= dueAt)
+            return;
+        clearTimeout(scheduler.timer);
+    }
+    scheduler.dueAt = dueAt;
     scheduler.timer = setTimeout(() => {
         scheduler.timer = undefined;
+        scheduler.dueAt = undefined;
         const visible = typeof document === 'undefined' || document.visibilityState !== 'hidden';
         const eligible = [...scheduler.subscribers.values()].filter((subscriber) => subscriber.when === 'always' || visible);
         eligible.forEach((subscriber) => void subscriber.refresh().catch(() => { }));
         schedulePoll(scheduler);
-    }, immediate ? 0 : interval);
+    }, delay);
 }
 function positivePage(input) {
     if (!Number.isSafeInteger(input) || input < 1) {

package/dist/graph/store.d.ts

@@ -1,8 +1,8 @@
 import type { GraphApi } from '@astrale-os/sdk/client';
 import type { GraphStore as GraphStoreValue } from '@astrale-os/sdk/client/store';
-import type { Shell } from '@astrale-os/shell';
+import type { KernelClient } from '@astrale-os/shell';
 interface StoreEntry {
-    readonly shell: Shell;
+    readonly client: KernelClient;
     readonly graph: GraphApi;
     readonly scope: string;
     readonly store: GraphStoreValue;
@@ -15,9 +15,9 @@ export interface GraphStoreScope {
     readonly authority: string;
     readonly schemaRevision: string;
 }
-type StoreIdentity = Awaited<ReturnType<Shell['kernel']['auth']['whoami']>>;
-export declare function resolveGraphStoreScope(shell: Shell, knownIdentity?: StoreIdentity | null): Promise<GraphStoreScope>;
-export declare function storeFor(shell: Shell, scope: GraphStoreScope): StoreEntry;
+type StoreIdentity = Awaited<ReturnType<KernelClient['auth']['whoami']>>;
+export declare function resolveGraphStoreScope(client: KernelClient, knownIdentity?: StoreIdentity | null): Promise<GraphStoreScope>;
+export declare function storeFor(client: KernelClient, scope: GraphStoreScope): StoreEntry;
 export declare function retainStore(entry: StoreEntry): () => void;
 /** The exact caller/schema-scoped GraphStore for the current View subtree. */
 export declare function useGraphStore(): GraphStoreValue;

package/dist/graph/store.js

@@ -2,39 +2,39 @@ import { GraphStore } from '@astrale-os/sdk/client/store';
 import { useContext } from 'react';
 import { GraphContext } from './graph.context.js';
 const entries = new WeakMap();
-export async function resolveGraphStoreScope(shell, knownIdentity) {
+export async function resolveGraphStoreScope(client, knownIdentity) {
     const [identity, snapshot] = await Promise.all([
         knownIdentity === undefined
-            ? shell.kernel.auth.whoami().catch(() => null)
+            ? client.auth.whoami().catch(() => null)
             : Promise.resolve(knownIdentity),
-        shell.kernel.snapshot(),
+        client.snapshot(),
     ]);
     return Object.freeze({
         authority: identity === null ? 'anonymous' : `${identity.iss}\u0000${identity.sub}\u0000${identity.id}`,
         schemaRevision: snapshot.publication.schema.revision,
     });
 }
-export function storeFor(shell, scope) {
-    const current = entries.get(shell);
+export function storeFor(client, scope) {
+    const current = entries.get(client);
     const scopeKey = `${scope.authority}\u0000${scope.schemaRevision}`;
-    if (current !== undefined && current.graph === shell.kernel.graph && current.scope === scopeKey) {
+    if (current !== undefined && current.graph === client.graph && current.scope === scopeKey) {
         return current;
     }
-    const supplied = shell.kernel.store;
+    const supplied = client.store;
     const created = {
-        shell,
-        graph: shell.kernel.graph,
+        client,
+        graph: client.graph,
         scope: scopeKey,
         // A supplied Store is trusted only for the KernelClient's first declared scope. A later
         // authority/revision/GraphApi replacement gets a new Store and cannot inherit old memory.
         store: current === undefined && supplied !== undefined
             ? supplied
-            : new GraphStore({ graph: shell.kernel.graph }),
+            : new GraphStore({ graph: client.graph }),
         owned: current !== undefined || supplied === undefined,
         retained: 0,
         generation: 0,
     };
-    entries.set(shell, created);
+    entries.set(client, created);
     if (current !== undefined && current.retained === 0 && current.owned)
         current.store.close();
     return created;
@@ -52,8 +52,8 @@ export function retainStore(entry) {
         queueMicrotask(() => {
             if (entry.retained !== 0 || entry.generation !== generation || !entry.owned)
                 return;
-            if (entries.get(entry.shell) === entry)
-                entries.delete(entry.shell);
+            if (entries.get(entry.client) === entry)
+                entries.delete(entry.client);
             entry.store.close();
         });
     };

package/dist/schema/action.hook.d.ts

@@ -2,9 +2,9 @@ import type { SessionRequestOptions } from '@astrale-os/sdk/client/session';
 import type { NodeId } from '@astrale-os/sdk/graph/node';
 import type { QueryAST, QueryDefinition } from '@astrale-os/sdk/query';
 import type { Domain } from '@astrale-os/sdk/schema';
-import type { CallableInputOf, CallableResultOf, ClassKey, ResolvedFunction, ResolvedMethod } from '@astrale-os/sdk/schema';
-type InstanceMethod = ResolvedMethod<unknown, unknown, false, false>;
-type StaticMethod = ResolvedMethod<unknown, unknown, true, false>;
+import type { CallableInputOf, CallableResultOf, ClassKey, ResolvedFunction, ExecutableMethod } from '@astrale-os/sdk/schema';
+type InstanceMethod = ExecutableMethod<unknown, unknown, false>;
+type StaticMethod = ExecutableMethod<unknown, unknown, true>;
 type Callable = ResolvedFunction | InstanceMethod | StaticMethod;
 /** Receiver identity with optional observed Class for early rejection; the Kernel checks live Class. */
 export interface ActionReceiver {

package/dist/session/provider.js

@@ -45,10 +45,10 @@ export function ShellProvider(props) {
                 await primeUser(shell);
                 if (generation !== ref.generation)
                     return;
-                const storeScope = await resolveGraphStoreScope(shell, self);
+                const storeScope = await resolveGraphStoreScope(shell.kernel, self);
                 if (generation !== ref.generation)
                     return;
-                const graph = storeFor(shell, storeScope);
+                const graph = storeFor(shell.kernel, storeScope);
                 dispatch({
                     type: 'ready',
                     runtime: { shell, self, storeScope, store: graph.store, ownsStore: graph.owned },
@@ -105,7 +105,7 @@ export function ShellProvider(props) {
     useEffect(() => {
         if (shell === null || store === null || storeScope === null)
             return;
-        return retainStore(storeFor(shell, storeScope));
+        return retainStore(storeFor(shell.kernel, storeScope));
     }, [shell, store, storeScope]);
     if (state.status === 'error') {
         if (errorFallback !== undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.4.0-beta.16",
+  "version": "0.4.0-beta.18",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {
@@ -31,7 +31,7 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@astrale-os/sdk": "0.5.0-beta.128",
+    "@astrale-os/sdk": "0.5.0-beta.136",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^26.2.0",
@@ -46,7 +46,7 @@
     "vitest": "4.1.10"
   },
   "peerDependencies": {
-    "@astrale-os/sdk": ">=0.5.0-beta.123 <1.0.0",
+    "@astrale-os/sdk": ">=0.5.0-beta.136 <1.0.0",
     "react": ">=18",
     "react-dom": ">=18"
   },

package/src/auth/act-as.context.tsx

@@ -2,8 +2,10 @@ import type { Identity } from '@astrale-os/sdk/auth'
 import type { KernelClient } from '@astrale-os/shell'
 import type { ReactElement, ReactNode } from 'react'
 
-import { createContext, useContext, useEffect, useMemo, useState } from 'react'
+import { createContext, useContext, useEffect, useState } from 'react'
 
+import { GraphContext } from '../graph/graph.context.js'
+import { resolveGraphStoreScope, retainStore, storeFor } from '../graph/store.js'
 import { ShellContext } from '../session/session.context.js'
 
 export type NodeValue = Identity
@@ -40,31 +42,44 @@ export interface ActAsProps {
 export function ActAs({ client, fallback, children }: ActAsProps): ReactElement | null {
   const [state, setState] = useState<
     | { readonly status: 'pending' }
-    | { readonly status: 'ready'; readonly self: Identity }
-    | { readonly status: 'failed'; readonly error: unknown }
+    | {
+        readonly status: 'ready'
+        readonly binding: IdentityBinding
+        readonly store: ReturnType<typeof storeFor>['store']
+      }
+    | { readonly status: 'failed'; readonly client: KernelClient; readonly error: unknown }
   >({ status: 'pending' })
 
   useEffect(() => {
     let active = true
+    let release: (() => void) | undefined
     setState({ status: 'pending' })
-    void client.auth.whoami().then(
-      (self) => {
-        if (active) setState({ status: 'ready', self })
-      },
-      (error: unknown) => {
-        if (active) setState({ status: 'failed', error })
-      },
-    )
+    void (async () => {
+      try {
+        const self = await client.auth.whoami()
+        if (!active) return
+        const scope = await resolveGraphStoreScope(client, self)
+        if (!active) return
+        const entry = storeFor(client, scope)
+        release = retainStore(entry)
+        setState({ status: 'ready', binding: { kernel: client, self }, store: entry.store })
+      } catch (error) {
+        if (active) setState({ status: 'failed', client, error })
+      }
+    })()
     return () => {
       active = false
+      release?.()
     }
   }, [client])
 
-  const value = useMemo<IdentityBinding | null>(
-    () => (state.status === 'ready' ? { kernel: client, self: state.self } : null),
-    [client, state],
+  if (state.status === 'failed' && state.client === client) throw state.error
+  if (state.status !== 'ready' || state.binding.kernel !== client) {
+    return fallback === undefined ? null : <>{fallback}</>
+  }
+  return (
+    <IdentityContext.Provider value={state.binding}>
+      <GraphContext.Provider value={state.store}>{children}</GraphContext.Provider>
+    </IdentityContext.Provider>
   )
-  if (state.status === 'failed') throw state.error
-  if (value === null) return fallback === undefined ? null : <>{fallback}</>
-  return <IdentityContext.Provider value={value}>{children}</IdentityContext.Provider>
 }

package/src/graph/query-definition.hook.ts

@@ -251,7 +251,7 @@ function combine(snapshots: readonly StoreSnapshot[]): GraphResourceState {
 }
 
 function stableIdentity(value: unknown): string {
-  const seen = new WeakSet<object>()
+  const ancestors = new WeakSet<object>()
   const encode = (input: unknown): unknown => {
     if (input === null) return ['null']
     if (typeof input !== 'object') {
@@ -264,17 +264,21 @@ function stableIdentity(value: unknown): string {
       }
       return [typeof input, input]
     }
-    if (seen.has(input)) throw new TypeError('Query input cannot contain cycles.')
-    seen.add(input)
-    if (Array.isArray(input)) return ['array', input.map(encode)]
-    return [
-      'object',
-      Object.fromEntries(
-        Object.keys(input as Record<string, unknown>)
-          .sort()
-          .map((key) => [key, encode((input as Record<string, unknown>)[key])]),
-      ),
-    ]
+    if (ancestors.has(input)) throw new TypeError('Query input cannot contain cycles.')
+    ancestors.add(input)
+    try {
+      if (Array.isArray(input)) return ['array', input.map(encode)]
+      return [
+        'object',
+        Object.fromEntries(
+          Object.keys(input as Record<string, unknown>)
+            .sort()
+            .map((key) => [key, encode((input as Record<string, unknown>)[key])]),
+        ),
+      ]
+    } finally {
+      ancestors.delete(input)
+    }
   }
   return JSON.stringify(encode(value))
 }

package/src/graph/resource.ts

@@ -176,6 +176,7 @@ interface PollSubscriber {
 interface PollScheduler {
   readonly subscribers: Map<symbol, PollSubscriber>
   timer: ReturnType<typeof setTimeout> | undefined
+  dueAt?: number
   onVisibility?: () => void
 }
 
@@ -344,22 +345,27 @@ export function retainRefreshScheduler(
 }
 
 function schedulePoll(scheduler: PollScheduler, immediate = false): void {
-  if (scheduler.timer !== undefined) clearTimeout(scheduler.timer)
   const subscribers = [...scheduler.subscribers.values()]
   if (subscribers.length === 0) return
   const interval = Math.min(...subscribers.map((subscriber) => subscriber.interval))
-  scheduler.timer = setTimeout(
-    () => {
-      scheduler.timer = undefined
-      const visible = typeof document === 'undefined' || document.visibilityState !== 'hidden'
-      const eligible = [...scheduler.subscribers.values()].filter(
-        (subscriber) => subscriber.when === 'always' || visible,
-      )
-      eligible.forEach((subscriber) => void subscriber.refresh().catch(() => {}))
-      schedulePoll(scheduler)
-    },
-    immediate ? 0 : interval,
-  )
+  const delay = immediate ? 0 : interval
+  const dueAt = Date.now() + delay
+  // Observer changes may advance a refresh, but must not postpone pending work.
+  if (scheduler.timer !== undefined) {
+    if (scheduler.dueAt !== undefined && scheduler.dueAt <= dueAt) return
+    clearTimeout(scheduler.timer)
+  }
+  scheduler.dueAt = dueAt
+  scheduler.timer = setTimeout(() => {
+    scheduler.timer = undefined
+    scheduler.dueAt = undefined
+    const visible = typeof document === 'undefined' || document.visibilityState !== 'hidden'
+    const eligible = [...scheduler.subscribers.values()].filter(
+      (subscriber) => subscriber.when === 'always' || visible,
+    )
+    eligible.forEach((subscriber) => void subscriber.refresh().catch(() => {}))
+    schedulePoll(scheduler)
+  }, delay)
 }
 
 function positivePage(input: number): number {

package/src/graph/store.ts

@@ -1,6 +1,6 @@
 import type { GraphApi } from '@astrale-os/sdk/client'
 import type { GraphStore as GraphStoreValue } from '@astrale-os/sdk/client/store'
-import type { Shell } from '@astrale-os/shell'
+import type { KernelClient } from '@astrale-os/shell'
 
 import { GraphStore } from '@astrale-os/sdk/client/store'
 import { useContext } from 'react'
@@ -8,7 +8,7 @@ import { useContext } from 'react'
 import { GraphContext } from './graph.context.js'
 
 interface StoreEntry {
-  readonly shell: Shell
+  readonly client: KernelClient
   readonly graph: GraphApi
   readonly scope: string
   readonly store: GraphStoreValue
@@ -17,7 +17,7 @@ interface StoreEntry {
   generation: number
 }
 
-const entries = new WeakMap<Shell, StoreEntry>()
+const entries = new WeakMap<KernelClient, StoreEntry>()
 
 /** Authority/schema identity. Session ids and Publication ETags are deliberately absent. */
 export interface GraphStoreScope {
@@ -25,17 +25,17 @@ export interface GraphStoreScope {
   readonly schemaRevision: string
 }
 
-type StoreIdentity = Awaited<ReturnType<Shell['kernel']['auth']['whoami']>>
+type StoreIdentity = Awaited<ReturnType<KernelClient['auth']['whoami']>>
 
 export async function resolveGraphStoreScope(
-  shell: Shell,
+  client: KernelClient,
   knownIdentity?: StoreIdentity | null,
 ): Promise<GraphStoreScope> {
   const [identity, snapshot] = await Promise.all([
     knownIdentity === undefined
-      ? shell.kernel.auth.whoami().catch(() => null)
+      ? client.auth.whoami().catch(() => null)
       : Promise.resolve(knownIdentity),
-    shell.kernel.snapshot(),
+    client.snapshot(),
   ])
   return Object.freeze({
     authority:
@@ -44,28 +44,28 @@ export async function resolveGraphStoreScope(
   })
 }
 
-export function storeFor(shell: Shell, scope: GraphStoreScope): StoreEntry {
-  const current = entries.get(shell)
+export function storeFor(client: KernelClient, scope: GraphStoreScope): StoreEntry {
+  const current = entries.get(client)
   const scopeKey = `${scope.authority}\u0000${scope.schemaRevision}`
-  if (current !== undefined && current.graph === shell.kernel.graph && current.scope === scopeKey) {
+  if (current !== undefined && current.graph === client.graph && current.scope === scopeKey) {
     return current
   }
-  const supplied = shell.kernel.store
+  const supplied = client.store
   const created: StoreEntry = {
-    shell,
-    graph: shell.kernel.graph,
+    client,
+    graph: client.graph,
     scope: scopeKey,
     // A supplied Store is trusted only for the KernelClient's first declared scope. A later
     // authority/revision/GraphApi replacement gets a new Store and cannot inherit old memory.
     store:
       current === undefined && supplied !== undefined
         ? supplied
-        : new GraphStore({ graph: shell.kernel.graph }),
+        : new GraphStore({ graph: client.graph }),
     owned: current !== undefined || supplied === undefined,
     retained: 0,
     generation: 0,
   }
-  entries.set(shell, created)
+  entries.set(client, created)
   if (current !== undefined && current.retained === 0 && current.owned) current.store.close()
   return created
 }
@@ -81,7 +81,7 @@ export function retainStore(entry: StoreEntry): () => void {
     const generation = ++entry.generation
     queueMicrotask(() => {
       if (entry.retained !== 0 || entry.generation !== generation || !entry.owned) return
-      if (entries.get(entry.shell) === entry) entries.delete(entry.shell)
+      if (entries.get(entry.client) === entry) entries.delete(entry.client)
       entry.store.close()
     })
   }

package/src/schema/action.hook.ts

@@ -7,7 +7,7 @@ import type {
   CallableResultOf,
   ClassKey,
   ResolvedFunction,
-  ResolvedMethod,
+  ExecutableMethod,
 } from '@astrale-os/sdk/schema'
 
 import { reference } from '@astrale-os/sdk/client/session'
@@ -22,8 +22,8 @@ import { useAction as useAsyncAction } from '../graph/action.js'
 import { useGraphStore } from '../graph/store.js'
 import { bindingFor } from './domain.hook.js'
 
-type InstanceMethod = ResolvedMethod<unknown, unknown, false, false>
-type StaticMethod = ResolvedMethod<unknown, unknown, true, false>
+type InstanceMethod = ExecutableMethod<unknown, unknown, false>
+type StaticMethod = ExecutableMethod<unknown, unknown, true>
 type Callable = ResolvedFunction | InstanceMethod | StaticMethod
 
 /** Receiver identity with optional observed Class for early rejection; the Kernel checks live Class. */

package/src/session/provider.tsx

@@ -61,9 +61,9 @@ export function ShellProvider(props: ShellProviderProps): ReactElement | null {
         if (generation !== ref.generation) return
         await primeUser(shell)
         if (generation !== ref.generation) return
-        const storeScope = await resolveGraphStoreScope(shell, self)
+        const storeScope = await resolveGraphStoreScope(shell.kernel, self)
         if (generation !== ref.generation) return
-        const graph = storeFor(shell, storeScope)
+        const graph = storeFor(shell.kernel, storeScope)
         dispatch({
           type: 'ready',
           runtime: { shell, self, storeScope, store: graph.store, ownsStore: graph.owned },
@@ -117,7 +117,7 @@ export function ShellProvider(props: ShellProviderProps): ReactElement | null {
   const storeScope = state.runtime?.storeScope ?? null
   useEffect(() => {
     if (shell === null || store === null || storeScope === null) return
-    return retainStore(storeFor(shell, storeScope))
+    return retainStore(storeFor(shell.kernel, storeScope))
   }, [shell, store, storeScope])
 
   if (state.status === 'error') {

package/CHANGELOG.md

@@ -1,303 +0,0 @@
-# Changelog
-
-## [0.4.0-beta.16](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.15...shell-react-v0.4.0-beta.16) (2026-09-08)
-
-
-### Bug Fixes
-
-* **domain:** infer public schema and class declarations ([#198](https://github.com/astrale-os/shell/issues/198)) ([d0741db](https://github.com/astrale-os/shell/commit/d0741db4c39c7144d2d93556edf253e277c6113b))
-* **domain:** publish compact inferred Kernel references ([#203](https://github.com/astrale-os/shell/issues/203)) ([ab2d0d9](https://github.com/astrale-os/shell/commit/ab2d0d9170ba7cd688f30cae6ece94b140d29ffd))
-
-## [0.4.0-beta.15](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.14...shell-react-v0.4.0-beta.15) (2026-09-07)
-
-
-### ⚠ BREAKING CHANGES
-
-* **react:** preflight exact-class instance method targets ([#182](https://github.com/astrale-os/shell/issues/182))
-* **runtime:** simplify Shell users, groups and invitations ([#187](https://github.com/astrale-os/shell/issues/187))
-
-### Features
-
-* **domain:** migrate Shell to project environments ([#183](https://github.com/astrale-os/shell/issues/183)) ([ec72b5d](https://github.com/astrale-os/shell/commit/ec72b5d11fea5ff3266d1fd0a823c4eff5cc6d3e))
-* **react:** preflight exact-class instance method targets ([#182](https://github.com/astrale-os/shell/issues/182)) ([305e92f](https://github.com/astrale-os/shell/commit/305e92f0578309e5e94d8fd78d874f7c5a60ee46))
-* **runtime:** simplify Shell users, groups and invitations ([#187](https://github.com/astrale-os/shell/issues/187)) ([7f00279](https://github.com/astrale-os/shell/commit/7f002791edae81944e6e80940834dee49212aa26))
-
-
-### Bug Fixes
-
-* **react:** require the Shell User and Group API release ([#196](https://github.com/astrale-os/shell/issues/196)) ([df34749](https://github.com/astrale-os/shell/commit/df3474972a54c30816a02fc3510b478299bea4f1))
-
-## [0.4.0-beta.14](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.13...shell-react-v0.4.0-beta.14) (2026-09-04)
-
-
-### Bug Fixes
-
-* **deps:** align SDK and Kernel release cohort ([#177](https://github.com/astrale-os/shell/issues/177)) ([294ec8f](https://github.com/astrale-os/shell/commit/294ec8f6f7a908afb608a1078e03a84ff2cc09ca))
-
-## [0.4.0-beta.13](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.12...shell-react-v0.4.0-beta.13) (2026-09-03)
-
-
-### Bug Fixes
-
-* **deps:** require Shell beta.13 producer ([#172](https://github.com/astrale-os/shell/issues/172)) ([4b8755a](https://github.com/astrale-os/shell/commit/4b8755a086f1fc73beb4affb893d4f23a85308b1))
-
-## [0.4.0-beta.12](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.11...shell-react-v0.4.0-beta.12) (2026-09-03)
-
-
-### Features
-
-* **core:** declare required node class icons ([#163](https://github.com/astrale-os/shell/issues/163)) ([2114424](https://github.com/astrale-os/shell/commit/2114424dc1295d978e49536aea76ace897917987))
-
-## [0.4.0-beta.11](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.10...shell-react-v0.4.0-beta.11) (2026-09-03)
-
-
-### Bug Fixes
-
-* **react:** allow id-only action receivers ([#167](https://github.com/astrale-os/shell/issues/167)) ([7f75975](https://github.com/astrale-os/shell/commit/7f759753864033e9593bb70080fa8b8c5a5157c0))
-
-## [0.4.0-beta.10](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.9...shell-react-v0.4.0-beta.10) (2026-09-01)
-
-
-### Bug Fixes
-
-* **runtime:** admit current Shell prerelease producer ([#160](https://github.com/astrale-os/shell/issues/160)) ([eb4699b](https://github.com/astrale-os/shell/commit/eb4699b891ca1a0561cd841be5e12193cff2a342))
-
-## [0.4.0-beta.9](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.9...shell-react-v0.4.0-beta.9) (2026-09-01)
-
-
-### ⚠ BREAKING CHANGES
-
-* adopt unified Domain functions layer ([#157](https://github.com/astrale-os/shell/issues/157))
-
-### Features
-
-* adopt unified Domain functions layer ([#157](https://github.com/astrale-os/shell/issues/157)) ([ae73910](https://github.com/astrale-os/shell/commit/ae739107da4b3827ff06f09a1bf86958135a2a5a))
-
-## [0.3.2-beta.9](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.8...shell-react-v0.3.2-beta.9) (2026-08-31)
-
-
-### Bug Fixes
-
-* **domain:** preserve caller-owned Shell authority ([#143](https://github.com/astrale-os/shell/issues/143)) ([7150ce0](https://github.com/astrale-os/shell/commit/7150ce0890546b6c605f9192aa78177b95af3615))
-
-## [0.3.2-beta.8](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.7...shell-react-v0.3.2-beta.8) (2026-08-30)
-
-
-### Features
-
-* grant trusted Shell exchange authority ([#140](https://github.com/astrale-os/shell/issues/140)) ([349c4b5](https://github.com/astrale-os/shell/commit/349c4b593b20245a8cb836f2370807b372faf23f))
-
-
-### Bug Fixes
-
-* **deps:** consume Zod-coherent SDK cohort ([#145](https://github.com/astrale-os/shell/issues/145)) ([2d2027c](https://github.com/astrale-os/shell/commit/2d2027c749f83c1e35a5b4a28696761b1f8e71e1))
-* **domain:** adopt function and authority requirements ([#144](https://github.com/astrale-os/shell/issues/144)) ([016e306](https://github.com/astrale-os/shell/commit/016e30603591c32a2c8cf0073fe75995c67ae004))
-
-## [0.3.2-beta.7](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.6...shell-react-v0.3.2-beta.7) (2026-08-29)
-
-
-### Features
-
-* **runtime:** enforce declared iframe requirements ([#129](https://github.com/astrale-os/shell/issues/129)) ([7b8d84a](https://github.com/astrale-os/shell/commit/7b8d84a1189e95c94c2de9f1759b6510a5467813))
-* **shell:** adopt flat identity authentication ([#114](https://github.com/astrale-os/shell/issues/114)) ([f267a79](https://github.com/astrale-os/shell/commit/f267a79cd8bd58c29379c4be91b481c5dd20f1cf))
-
-
-### Bug Fixes
-
-* **domain:** publish visibility-free Shell bundle ([#131](https://github.com/astrale-os/shell/issues/131)) ([61f48e5](https://github.com/astrale-os/shell/commit/61f48e56f9b18a0b83d395ce1bae648d2470140c))
-
-## [0.3.2-beta.6](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.5...shell-react-v0.3.2-beta.6) (2026-08-28)
-
-
-### Bug Fixes
-
-* **domain:** align canonical SDK contracts ([#117](https://github.com/astrale-os/shell/issues/117)) ([78df43d](https://github.com/astrale-os/shell/commit/78df43df4b2878221c7bfc83b32944264b3835e8))
-* surface Domain binding diagnostics ([#125](https://github.com/astrale-os/shell/issues/125)) ([e37b6ca](https://github.com/astrale-os/shell/commit/e37b6ca1634ea5655dafbb2386af2c7198a55fe9))
-
-## [0.3.2-beta.5](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.4...shell-react-v0.3.2-beta.5) (2026-08-27)
-
-
-### Bug Fixes
-
-* **react:** publish against Shell beta.7 ([#115](https://github.com/astrale-os/shell/issues/115)) ([2e2ad9e](https://github.com/astrale-os/shell/commit/2e2ad9e471b6c39413260f76954432a53be2cb23))
-
-## [0.3.2-beta.4](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.3...shell-react-v0.3.2-beta.4) (2026-08-26)
-
-
-### Bug Fixes
-
-* **react:** preserve in-flight queries through StrictMode ([#112](https://github.com/astrale-os/shell/issues/112)) ([e5b7cd7](https://github.com/astrale-os/shell/commit/e5b7cd75e001be393d94e168089eb66a1da4bfb2))
-* **shell:** align the published Shell cohort ([#109](https://github.com/astrale-os/shell/issues/109)) ([6c79cb6](https://github.com/astrale-os/shell/commit/6c79cb6f0370aad84565dda27d2af1a5579c18ff))
-
-## [0.3.2-beta.3](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.2...shell-react-v0.3.2-beta.3) (2026-08-26)
-
-
-### Bug Fixes
-
-* **deploy:** consume current SDK toolchain ([#96](https://github.com/astrale-os/shell/issues/96)) ([73956a0](https://github.com/astrale-os/shell/commit/73956a05a2c9e107afedfa7b1878716644074bc1))
-* **deps:** consume cloudflare adapter beta.44 ([#101](https://github.com/astrale-os/shell/issues/101)) ([7e9f214](https://github.com/astrale-os/shell/commit/7e9f214fe06979d5e1a7f4ca3b00cf431ab50944))
-
-## [0.3.2-beta.2](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta.1...shell-react-v0.3.2-beta.2) (2026-08-25)
-
-
-### Bug Fixes
-
-* retain sandboxed View proof boundaries ([#80](https://github.com/astrale-os/shell/issues/80)) ([7de8800](https://github.com/astrale-os/shell/commit/7de8800dc42106bd4aa0f8a6340117d17c51d195))
-
-## [0.3.2-beta.1](https://github.com/astrale-os/shell/compare/shell-react-v0.3.2-beta...shell-react-v0.3.2-beta.1) (2026-08-25)
-
-
-### Features
-
-* **react:** bind projected recipes to domain context ([#72](https://github.com/astrale-os/shell/issues/72)) ([1d963dc](https://github.com/astrale-os/shell/commit/1d963dc33e98ec7c4b1cece467c9b2428e07aeea))
-
-
-### Bug Fixes
-
-* **packages:** keep install guards private ([#71](https://github.com/astrale-os/shell/issues/71)) ([20a34ee](https://github.com/astrale-os/shell/commit/20a34eeafea868f31663b3076928c3528f4e1aec))
-
-## [0.3.2-beta](https://github.com/astrale-os/shell/compare/shell-react-v0.3.1...shell-react-v0.3.2-beta) (2026-08-24)
-
-
-### Bug Fixes
-
-* **deps:** align Shell packages with SDK beta.22 ([#65](https://github.com/astrale-os/shell/issues/65)) ([18db939](https://github.com/astrale-os/shell/commit/18db93958e64678f9c000e258c12a97525fa95ef))
-* **deps:** require Shell 0.4.2 beta ([#70](https://github.com/astrale-os/shell/issues/70)) ([b6ec3b3](https://github.com/astrale-os/shell/commit/b6ec3b39cd8ab571e7a3e64092e896ac8e14cd62))
-* qualify the Shell release cohort ([8f837e1](https://github.com/astrale-os/shell/commit/8f837e1bf14600db18b96da6de7878f34321332c))
-* qualify the Shell release cohort ([efb23d7](https://github.com/astrale-os/shell/commit/efb23d71088a407209a01cec33e5571d86ecde51))
-* **release:** preserve SDK dependency ownership ([#62](https://github.com/astrale-os/shell/issues/62)) ([5199f73](https://github.com/astrale-os/shell/commit/5199f7358a64cfb1163ebb6d13c94a8b8080bcc1))
-
-## [0.3.1](https://github.com/astrale-os/shell/compare/shell-react-v0.3.0...shell-react-v0.3.1) (2026-08-24)
-
-
-### Bug Fixes
-
-* **release:** qualify published sdk runtime context ([b1411a0](https://github.com/astrale-os/shell/commit/b1411a01710bab785b31c02c81ea09bc902f4e42))
-
-## [0.3.0](https://github.com/astrale-os/shell/compare/shell-react-v0.2.9...shell-react-v0.3.0) (2026-08-24)
-
-
-### ⚠ BREAKING CHANGES
-
-* adopt path-only invocation
-
-### Features
-
-* adopt kernel client session vocabulary ([95877b2](https://github.com/astrale-os/shell/commit/95877b25e6d672fe69f14b28ac9fa712b0649a76))
-* adopt Kernel Client Session vocabulary ([ac61164](https://github.com/astrale-os/shell/commit/ac61164bba8540931ad7c0c2cf68be95fb3336c0))
-* adopt Kernel V2 at the Shell client boundary ([6654ef7](https://github.com/astrale-os/shell/commit/6654ef7989691664af777824be2c97a2906b4008))
-* adopt path-only invocation ([afef6f4](https://github.com/astrale-os/shell/commit/afef6f4c970b3b01bb69f758f163cc9fa2b14641))
-* complete kernel v2 shell migration ([82a2d36](https://github.com/astrale-os/shell/commit/82a2d36ae804ddbfd06fa59afb6a290128c28a82))
-* **domain:** deploy Shell through default adapter ([43bc418](https://github.com/astrale-os/shell/commit/43bc418952666d7aac26194134c2776b58c355e7))
-* **domain:** publish @astrale-domains/shell ([905488b](https://github.com/astrale-os/shell/commit/905488b647e73793eb18ec50e5b06f763b7630e8))
-* migrate shell packages to kernel beta.2 ([62ea4a2](https://github.com/astrale-os/shell/commit/62ea4a2ff5c1b149a94a3969985debd8d791e3f3))
-* **runtime:** add graph-first React view runtime ([40ed99f](https://github.com/astrale-os/shell/commit/40ed99f03b2c2067f209b1be85d1667e6dc904f2))
-* **runtime:** add graph-first React View runtime ([702fe44](https://github.com/astrale-os/shell/commit/702fe44a1687af992a46afac16efed87dfc6e057))
-* **shell:** author graph operations with direct node targets ([a189028](https://github.com/astrale-os/shell/commit/a189028cee3d5f14678325c713b9439487c9e224))
-* **shell:** author graph operations with node targets ([97f0599](https://github.com/astrale-os/shell/commit/97f05997bb34e8935349dbb6f5b9e55a2432cca3))
-
-
-### Bug Fixes
-
-* adopt current Shell domain bindings ([121c7be](https://github.com/astrale-os/shell/commit/121c7bea57ad1bf4cedbab90ed8cba8f59955f06))
-* adopt source cohort domain bindings ([bf79155](https://github.com/astrale-os/shell/commit/bf7915555d7152b2e70127b54a1e8b4fdc269b04))
-* adopt the official kernel cohort ([#47](https://github.com/astrale-os/shell/issues/47)) ([c15a5b0](https://github.com/astrale-os/shell/commit/c15a5b0d8c9f4c3f6dd49bf122cfea09c4af42da))
-* align shell with current kernel client ([5351dc8](https://github.com/astrale-os/shell/commit/5351dc85beafdcca8f74817e032e3aab0edf0397))
-* align Shell with current Kernel cohort ([d1abeaf](https://github.com/astrale-os/shell/commit/d1abeaf2a418e7e6bf89ea85512cd0e8942d407b))
-* **domain:** align deployment with current SDK ([7a5fbae](https://github.com/astrale-os/shell/commit/7a5fbae7283aac0bb9f1aebd7b7bb0a753a1ba15))
-* **domain:** use the published SDK boundary ([2e494c6](https://github.com/astrale-os/shell/commit/2e494c6f8b4d3d25c71bbe51b37436fd35d6c42a))
-* lock shell to current beta cohort ([8350423](https://github.com/astrale-os/shell/commit/8350423f2be37208396bd6ab37e43c102d73bb9e))
-
-## [0.2.9](https://github.com/astrale-os/shell/compare/shell-react-v0.2.8...shell-react-v0.2.9) (2026-07-18)
-
-
-### Features
-
-* **windows:** support resolved iframe sandbox policies ([#30](https://github.com/astrale-os/shell/issues/30)) ([9c6c2e9](https://github.com/astrale-os/shell/commit/9c6c2e999115819227c7400bbb4f1edaf7b7b40d))
-
-
-### Bug Fixes
-
-* **core:** keep managed iframes above workspace surfaces ([#28](https://github.com/astrale-os/shell/issues/28)) ([2ab656a](https://github.com/astrale-os/shell/commit/2ab656a46bcb342850a5703c82d82eea9bfbd958))
-
-## [0.2.8](https://github.com/astrale-os/shell/compare/shell-react-v0.2.7...shell-react-v0.2.8) (2026-07-15)
-
-
-### Features
-
-* **shell:** expose domain search through useDomains ([13dbe0c](https://github.com/astrale-os/shell/commit/13dbe0c769886080fbc0da62dbe82868d27e8aaf))
-* **shell:** expose domain search through useDomains ([bb3076a](https://github.com/astrale-os/shell/commit/bb3076aa1788ec8d1e6f4155014bac3ed0f93783))
-
-
-### Bug Fixes
-
-* **react:** resolve canonical function bindings ([52be852](https://github.com/astrale-os/shell/commit/52be8529ca37aeac3878dfd198f76e3b81d37d25))
-* **react:** resolve canonical function bindings ([db8f0ab](https://github.com/astrale-os/shell/commit/db8f0abbc6b3d43063a9450a1bfbb911f1d7aa1d))
-
-## [0.2.7](https://github.com/astrale-os/shell/compare/shell-react-v0.2.6...shell-react-v0.2.7) (2026-07-12)
-
-
-### Features
-
-* **shell:** resolve views and reject failed intents ([0cf741e](https://github.com/astrale-os/shell/commit/0cf741ec5279ca003b97f39b4b5cbe5c71099ab3))
-
-## [0.2.6](https://github.com/astrale-os/shell/compare/shell-react-v0.2.5...shell-react-v0.2.6) (2026-07-12)
-
-
-### Features
-
-* **shell-react:** add fire-and-forget intent emitter ([850e0e2](https://github.com/astrale-os/shell/commit/850e0e20f44e2475c0859c6690ea8f6f24131768))
-
-## [0.2.5](https://github.com/astrale-os/shell/compare/shell-react-v0.2.4...shell-react-v0.2.5) (2026-07-12)
-
-
-### Bug Fixes
-
-* preserve virtual session capabilities ([#19](https://github.com/astrale-os/shell/issues/19)) ([792993f](https://github.com/astrale-os/shell/commit/792993f070e0f07069876068a14e324e2d446589))
-
-## [0.2.4](https://github.com/astrale-os/shell/compare/shell-react-v0.2.3...shell-react-v0.2.4) (2026-07-12)
-
-
-### Bug Fixes
-
-* **react:** keep endpoint envelopes cardinality-stable ([432dd7e](https://github.com/astrale-os/shell/commit/432dd7eb3b495b305bec6acedbcb888fe96e627c))
-
-## [0.2.3](https://github.com/astrale-os/shell/compare/shell-react-v0.2.2...shell-react-v0.2.3) (2026-07-12)
-
-
-### Bug Fixes
-
-* **deps:** require edge-cardinality kernel client ([83283a9](https://github.com/astrale-os/shell/commit/83283a9c794427946e527d549f5346eacc787c19))
-
-## [0.2.2](https://github.com/astrale-os/shell/compare/shell-react-v0.2.1...shell-react-v0.2.2) (2026-07-12)
-
-
-### Features
-
-* **react:** adopt typed domain class handles ([c63ab05](https://github.com/astrale-os/shell/commit/c63ab053e0fa48a54e2690a58b932b54029afd8b))
-
-## [0.2.1](https://github.com/astrale-os/shell/compare/shell-react-v0.2.0...shell-react-v0.2.1) (2026-07-11)
-
-
-### Bug Fixes
-
-* explicit .js specifiers + nodenext so dist loads under Node's native ESM loader ([#10](https://github.com/astrale-os/shell/issues/10)) ([2f8616f](https://github.com/astrale-os/shell/commit/2f8616ff8b5bf00e2dab9229fd6afd3dbfdce8ce))
-
-## [0.2.0](https://github.com/astrale-os/shell/compare/shell-react-v0.1.0...shell-react-v0.2.0) (2026-07-09)
-
-
-### ⚠ BREAKING CHANGES
-
-* **core:** removed CreateKernelClientAdapterOpts.mintIdentity — the delegation mint is always self per the kernel invariant, so delegationMintVia covers it. createShell({ mintIdentity }) is unchanged (the facade still honors it for the identity-credential mint subject).
-
-* **core:** legacy-ops cutover — get/mutate doors, bounded contexts, auth collapse, shell-react ([#7](https://github.com/astrale-os/shell/issues/7)) ([0119b0f](https://github.com/astrale-os/shell/commit/0119b0f64e152bd1765facce880a533401a3e65e))
-
-
-### Features
-
-* use shell domain schema ([6ca1be8](https://github.com/astrale-os/shell/commit/6ca1be82aece4cd2925c1b4587e65b797686e804))
-
-
-### Bug Fixes
-
-* require published shell schema entrypoints ([92aa701](https://github.com/astrale-os/shell/commit/92aa70117dbfa10bc4dc2133e1c0c322a21a571e))