@astrale-os/shell-react 0.2.10-beta.3 → 0.3.1

package/dist/schema/relation.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relation.hook.d.ts","sourceRoot":"","sources":["../../src/schema/relation.hook.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"relation.hook.d.ts","sourceRoot":"","sources":["../../src/schema/relation.hook.ts"],"names":[],"mappings":"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"}

package/dist/schema/relation.hook.js

@@ -1,6 +1,6 @@
-import { NodeId } from '@astrale-os/sdk/graph/node';
 import { Path } from '@astrale-os/sdk/graph/path';
 import { Query } from '@astrale-os/sdk/query';
+import { ClassKey } from '@astrale-os/sdk/schema';
 import { useCallback, useMemo } from 'react';
 import { useStoreResource } from '../graph/resource.js';
 import { bindingFor } from './domain.hook.js';
@@ -13,28 +13,23 @@ export class RelationUnavailableError extends Error {
         this.name = 'RelationUnavailableError';
     }
 }
-/** Traverse one exact rich Edge definition with endpoint and cardinality inference. */
-export function useRelation(definition, source, options) {
-    const binding = bindingFor(definition);
-    if (source !== null && source !== undefined) {
-        admitSource(binding, definition, options.from, source);
-    }
-    admitRelatedDefinition(binding, definition, options.from, options.to);
-    const path = source === null || source === undefined ? null : Path.id(NodeId(source.id));
+/** Traverse one directed resolved Edge Class and bind the selected opposite Nodes. */
+export function useRelation(relation, source, options) {
+    const binding = bindingFor(relation);
+    if (source !== null && source !== undefined)
+        admitSource(binding, relation, options.from, source);
+    admitRelatedDefinition(binding, relation, options.from, options.to);
+    const path = source === null || source === undefined ? null : Path.id(source.id);
     const query = useMemo(() => {
         if (path === null)
             return null;
-        const root = Query.from({ kind: 'node', paths: [path], binding: 'relation_source' });
-        const admitted = root.filter({ satisfies: source.$.definition.schemaRef });
-        const expanded = admitted.expand({
-            via: [definition.schemaRef],
+        const expanded = Query.from({ nodes: [path] }).expand({
+            via: [relation],
             direction: options.from === 'source' ? 'outgoing' : 'incoming',
         });
-        return expanded
-            .filter({ satisfies: options.to.schemaRef })
-            .select({ kind: 'graph', binding: expanded.node });
-    }, [definition, options.from, options.to, path?.raw, source]);
-    const cardinality = effectiveCardinality(binding, definition, options.from, options.to);
+        return expanded.filter({ class: options.to }).select({ kind: 'graph', binding: expanded.node });
+    }, [relation, options.from, options.to, path?.raw]);
+    const cardinality = effectiveCardinality(binding, relation, options.from, options.to);
     const project = useCallback((response) => {
         const result = response.result;
         if (result.kind !== 'graph' || result.selection.kind !== 'node') {
@@ -47,10 +42,7 @@ export function useRelation(definition, source, options) {
         const byId = new Map(result.graph.nodes.map((node) => [node.id, node]));
         const values = result.selection.ids.flatMap((id) => {
             const node = byId.get(id);
-            if (node === undefined)
-                return [];
-            const bind = binding.$.bind;
-            return [bind(options.to, node)];
+            return node === undefined ? [] : [binding.wrapNode(options.to, node)];
         });
         if (cardinality === '0..1')
             return values[0] ?? null;
@@ -59,16 +51,12 @@ export function useRelation(definition, source, options) {
         if (cardinality === '1..*' && values.length === 0)
             return undefined;
         return Object.freeze(values);
-    }, [binding, cardinality, options.to, query]);
+    }, [binding, cardinality, options.to]);
     const resource = useStoreResource(query, options.page?.size ?? 50, project);
-    const unavailable = (cardinality === '1' &&
+    const unavailable = (cardinality === '1' || cardinality === '1..*') &&
         resource.data === undefined &&
         resource.state !== 'idle' &&
-        resource.state !== 'loading') ||
-        (cardinality === '1..*' &&
-            resource.data === undefined &&
-            resource.state !== 'idle' &&
-            resource.state !== 'loading')
+        resource.state !== 'loading'
         ? Object.freeze({ kind: 'required-hidden-or-invalid', cardinality })
         : undefined;
     const require = () => {
@@ -87,50 +75,44 @@ export function useRelation(definition, source, options) {
     });
 }
 function admitSource(binding, relation, from, source) {
-    const accepted = edgeEndpoints(relation)[from].accepts;
-    const matches = accepted.some((ref) => {
-        const candidate = binding.$.inspect(ref);
-        return source.$.definition.satisfies(candidate);
-    });
+    const exact = binding.domain.definition(ClassKey.ref(ClassKey(source.class)));
+    const matches = exact?.ref.kind === 'class' &&
+        exact.kind === 'node' &&
+        edgeEndpoints(relation)[from].accepts.some((ref) => {
+            const accepted = binding.domain.definition(ref);
+            return accepted?.ref.kind === 'class' && accepted.kind === 'node' && exact.satisfies(accepted);
+        });
     if (!matches)
         throw new TypeError('Relation source does not satisfy the selected endpoint.');
 }
-function endpointCardinality(definition, side) {
-    const endpoint = edgeEndpoints(definition)[side];
-    const cardinality = side === 'source' ? endpoint.outgoing : endpoint.incoming;
-    if (cardinality === undefined) {
-        throw new TypeError(`Relation ${side} endpoint does not expose its traversal cardinality.`);
+function admitRelatedDefinition(binding, relation, from, to) {
+    const opposite = from === 'source' ? 'target' : 'source';
+    const matches = edgeEndpoints(relation)[opposite].accepts.some((ref) => {
+        const accepted = binding.domain.definition(ref);
+        return accepted?.ref.kind === 'class' && accepted.kind === 'node' && to.satisfies(accepted);
+    });
+    if (!matches) {
+        throw new TypeError('Relation target Class is not admitted by the opposite endpoint.');
     }
-    return cardinality;
 }
 function effectiveCardinality(binding, relation, from, to) {
-    const base = endpointCardinality(relation, from);
-    if (base !== '1' && base !== '1..*') {
+    const endpoint = edgeEndpoints(relation)[from];
+    const base = from === 'source' ? endpoint.outgoing : endpoint.incoming;
+    if (base === undefined)
+        throw new TypeError(`Relation ${from} cardinality is absent.`);
+    if (base !== '1' && base !== '1..*')
         return base;
-    }
-    const opposite = from === 'source' ? 'target' : 'source';
-    const coversEndpoint = edgeEndpoints(relation)[opposite].accepts.every((ref) => {
-        const candidate = binding.$.inspect(ref);
-        return candidate.satisfies(to);
-    });
-    return (coversEndpoint ? base : base === '1' ? '0..1' : '0..*');
-}
-function admitRelatedDefinition(binding, relation, from, to) {
     const opposite = from === 'source' ? 'target' : 'source';
-    const accepted = edgeEndpoints(relation)[opposite].accepts;
-    const matches = accepted.some((ref) => {
-        const candidate = binding.$.inspect(ref);
-        return to.satisfies(candidate);
+    const covers = edgeEndpoints(relation)[opposite].accepts.every((ref) => {
+        const accepted = binding.domain.definition(ref);
+        return accepted?.ref.kind === 'class' && accepted.kind === 'node' && accepted.satisfies(to);
     });
-    if (!matches)
-        throw new TypeError('Relation target definition is not admitted by the opposite endpoint.');
+    return covers ? base : base === '1' ? '0..1' : '0..*';
 }
 function edgeEndpoints(relation) {
-    const declaration = relation.definition;
-    const source = declaration.endpoints?.source;
-    const target = declaration.endpoints?.target;
-    if (declaration.family !== 'edge' || source === undefined || target === undefined) {
-        throw new TypeError('Relation definition does not expose admitted Edge endpoints.');
+    const definition = relation.definition;
+    if (definition.orientation !== 'directed') {
+        throw new TypeError('useRelation currently requires a directed Edge Class.');
     }
-    return Object.freeze({ source, target });
+    return definition.endpoints;
 }

package/dist/selection/live.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/selection/live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAO9D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAA;AAChC,YAAY,EAAE,MAAM,EAAE,CAAA;AAEtB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAUD,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAgEjF"}
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/selection/live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAM9D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAA;AAChC,YAAY,EAAE,MAAM,EAAE,CAAA;AAEtB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAUD,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAgEjF"}

package/dist/selection/live.js

@@ -1,4 +1,3 @@
-import { Path } from '@astrale-os/sdk/graph/path';
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { useSessionKernel } from '../auth/session-kernel.js';
 /** Resolve selected identities through the authenticated GraphApi; no fake live subscription. */
@@ -34,7 +33,7 @@ export function useResolvedNodes(orderedIds) {
         }
         setState({ key: currentKey, aliveIds: ids, nodes: [], pending: true, error: undefined });
         try {
-            const values = await Promise.all(ids.map((nodeId) => graph.get(Path.id(nodeId))));
+            const values = await Promise.all(ids.map((nodeId) => graph.get(nodeId)));
             if (!alive.current || id !== generation.current)
                 return;
             const aliveIds = [];

package/dist/session/session.context.d.ts

@@ -1,10 +1,9 @@
-import type { GraphStore } from '@astrale-os/kernel-client/store';
+import type { GraphStore } from '@astrale-os/sdk/client/store';
 import type { KernelClient, Shell } from '@astrale-os/shell';
 import type { GraphStoreScope } from '../graph/store.js';
 /**
- * whoami's node type, derived from the auth surface so shell-react needs no
- * direct `@astrale-os/kernel-core` dependency (`Node` is not yet re-exported by
- * kernel-client — API §14 G8). Swap for the blessed re-export when it lands.
+ * whoami's node type, derived from the SDK auth surface so this package does
+ * not duplicate the canonical Client node projection.
  */
 export type SelfNode = Awaited<ReturnType<KernelClient['auth']['whoami']>>;
 /** The live shell for a provider subtree (and, later, an `<ActAs>` subtree). */

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

@@ -1 +1 @@
-{"version":3,"file":"session.context.d.ts","sourceRoot":"","sources":["../../src/session/session.context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAS5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAE1E,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AACD,eAAO,MAAM,YAAY,8CAA2C,CAAA"}
+{"version":3,"file":"session.context.d.ts","sourceRoot":"","sources":["../../src/session/session.context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAS5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAE1E,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AACD,eAAO,MAAM,YAAY,8CAA2C,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.2.10-beta.3",
+  "version": "0.3.1",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {
@@ -29,12 +29,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@astrale-os/kernel-client": ">=0.6.0-beta.8 <1.0.0",
-    "@astrale-os/kernel-core": ">=0.9.0-beta.7 <1.0.0",
-    "@astrale-os/kernel-dsl": ">=0.2.0-beta.5 <1.0.0",
-    "@astrale-os/kernel-protocol": ">=0.5.0-beta.7 <1.0.0",
-    "@astrale-os/kernel-server": ">=0.5.0-beta.8 <1.0.0",
-    "@astrale-os/sdk": ">=0.5.0-beta.14 <1.0.0",
+    "@astrale-os/sdk": ">=0.5.0-beta.17 <1.0.0",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^26.0.0",
@@ -48,15 +43,10 @@
     "typescript": "~6.0.1-rc",
     "vite": "^7.3.6",
     "vitest": "^3.2.4",
-    "@astrale-os/shell": "0.3.8-beta.3"
+    "@astrale-os/shell": "0.4.1"
   },
   "peerDependencies": {
-    "@astrale-os/kernel-client": ">=0.6.0-beta.8 <1.0.0",
-    "@astrale-os/kernel-core": ">=0.9.0-beta.7 <1.0.0",
-    "@astrale-os/kernel-dsl": ">=0.2.0-beta.5 <1.0.0",
-    "@astrale-os/kernel-protocol": ">=0.5.0-beta.7 <1.0.0",
-    "@astrale-os/kernel-server": ">=0.5.0-beta.8 <1.0.0",
-    "@astrale-os/sdk": ">=0.5.0-beta.14 <1.0.0",
+    "@astrale-os/sdk": ">=0.5.0-beta.17 <1.0.0",
     "@astrale-os/shell": ">=0.3.8-beta.3 <1.0.0",
     "react": ">=18",
     "react-dom": ">=18"

package/src/application/apps/app-host.tsx

@@ -1,87 +1,57 @@
-import type {
-  ApplicationNode,
-  AppSession,
-  HostCapabilities,
-  NodeTarget,
-  ResolvedView,
-} from '@astrale-os/shell'
+import type { Key } from '@astrale-os/sdk/schema'
+import type { App, HostCapabilities, ResolvedView } from '@astrale-os/shell'
 import type { CSSProperties, ReactElement, ReactNode } from 'react'
 
-/**
- * AppHost (API §12.2) = useOpenApp + ViewHost. Opens the app's `AppSession`,
- * mounts its entry view with the session credential, and DISPOSES the session
- * with the window (unmount, or an app change). `opening` renders while the
- * session opens; `no-view` when the app pins no entrypoint; every mounted-frame
- * phase is the window module's `WindowState`.
- */
 import { forwardRef, useEffect, useRef, useState } from 'react'
 
 import type { SandboxPolicy, ViewHostHandle } from '../../window/host.js'
 import type { WindowState } from '../../window/lifecycle/states.js'
 
 import { ViewHost } from '../../window/host.js'
-import { toRef } from './apps.hook.js'
 import { useOpenApp } from './open-app.hook.js'
 
-/** The states `AppHost`'s fallback answers — the frame's, plus the two OS phases. */
 export type AppHostFallbackState =
   | WindowState
   | { readonly phase: 'opening' }
   | { readonly phase: 'no-view' }
 
 export interface AppHostProps {
-  app: ApplicationNode | NodeTarget
-  /** Override the entry View while keeping the application's delegated session alive. */
+  app: App | Key.Origin
+  /** Override the installed Domain entry View. */
   view?: ResolvedView
   capabilities?: HostCapabilities
   sandbox?: SandboxPolicy
   fallback?: (state: AppHostFallbackState) => ReactNode
-  onSession?: (session: AppSession) => void
   className?: string
   style?: CSSProperties
 }
 
+/** Resolve and mount an installed Domain through the ordinary Shell View lifecycle. */
 export const AppHost = forwardRef<ViewHostHandle, AppHostProps>(
   function AppHost(props, ref): ReactElement {
     const open = useOpenApp()
-    const [session, setSession] = useState<AppSession | null>(null)
+    const [opened, setOpened] = useState<ResolvedView | null | undefined>(undefined)
     const [error, setError] = useState<unknown>(undefined)
-
-    const appKey = toRef(props.app)
+    const origin = typeof props.app === 'string' ? props.app : props.app.origin
     const openRef = useRef(open)
     openRef.current = open
-    const appRef = useRef(props.app)
-    appRef.current = props.app
-    const onSessionRef = useRef(props.onSession)
-    onSessionRef.current = props.onSession
 
-    // Open (re)opens the session per app; the cleanup disposes it — so the session
-    // is torn down with the window (unmount) and swapped on an app change.
     useEffect(() => {
-      let cancelled = false
-      let opened: AppSession | null = null
-      setSession(null)
+      let active = true
+      setOpened(undefined)
       setError(undefined)
-      void openRef.current(appRef.current).then(
-        (s) => {
-          if (cancelled) {
-            s.dispose()
-            return
-          }
-          opened = s
-          setSession(s)
-          onSessionRef.current?.(s)
+      void openRef.current(origin).then(
+        (view) => {
+          if (active) setOpened(view)
         },
-        (e: unknown) => {
-          if (!cancelled) setError(e)
+        (cause: unknown) => {
+          if (active) setError(cause)
         },
       )
       return () => {
-        cancelled = true
-        opened?.dispose()
+        active = false
       }
-      // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [appKey])
+    }, [origin])
 
     const { fallback, className, style } = props
     const box = (children: ReactNode): ReactElement => (
@@ -90,20 +60,20 @@ export const AppHost = forwardRef<ViewHostHandle, AppHostProps>(
       </div>
     )
 
-    // A session-open failure has no window yet — `windowId` is honestly absent (§10).
     if (error !== undefined) return box(fallback?.({ phase: 'crashed', error }) ?? null)
-    if (session === null) return box(fallback?.({ phase: 'opening' }) ?? null)
-    const view = props.view ?? session.view
-    if (view === null) return box(fallback?.({ phase: 'no-view' }) ?? null)
+    if (opened === undefined && props.view === undefined) {
+      return box(fallback?.({ phase: 'opening' }) ?? null)
+    }
+    const view = props.view ?? opened
+    if (view === null || view === undefined) return box(fallback?.({ phase: 'no-view' }) ?? null)
 
     return (
       <ViewHost
         ref={ref}
         view={view}
-        credential={session.credential}
         capabilities={props.capabilities}
         sandbox={props.sandbox}
-        fallback={fallback ? (s: WindowState) => fallback(s) : undefined}
+        fallback={fallback ? (state: WindowState) => fallback(state) : undefined}
         className={className}
         style={style}
       />

package/src/application/apps/apps.hook.ts

@@ -1,88 +1,38 @@
-import type { PathLike } from '@astrale-os/sdk/graph/path'
-import type { ApplicationNode, NodeTarget, SpaceNode } from '@astrale-os/shell'
+import type { App } from '@astrale-os/shell'
 
-import { Path } from '@astrale-os/sdk/graph/path'
-/**
- * useApps(space?) (API §12.2) — the apps installed in a space (`installed_in`
- * in-edges). No arg targets the CURRENT space (shared store, so a switch anywhere
- * swaps the dock) and is IDLE while none is selected (§1.3); an explicit `null`
- * stays idle; OS plane unavailable → fully idle. Also `toRef`, the app/space
- * subject normalizer the apps hooks share.
- */
-import { useCallback, useEffect, useMemo, useSyncExternalStore } from 'react'
+import { useMemo } from 'react'
 
 import type { ReadState } from '../../graph/memory/read/envelope.js'
-import type { CurrentSpaceSnapshot } from '../spaces/current-space.store.js'
 
 import { useAsyncResource } from '../../graph/async.js'
 import { useShell } from '../../session/shell.hook.js'
-import { currentSpaceStore } from '../spaces/current-space.store.js'
 import { isOsPlaneAvailable } from '../user/user.store.js'
 
-const NO_APPS: readonly ApplicationNode[] = []
-const IDLE_CURRENT: CurrentSpaceSnapshot = { space: null, pending: false, error: undefined }
+const NO_APPS: readonly App[] = []
 
 export interface AppsResult extends ReadState {
-  readonly apps: readonly ApplicationNode[]
+  readonly apps: readonly App[]
 }
 
-export function useApps(space?: SpaceNode | NodeTarget | null): AppsResult {
+/** Read the installed Domain applications available to the current Shell session. */
+export function useApps(): AppsResult {
   const shell = useShell()
   const available = isOsPlaneAvailable(shell)
-
-  // No arg → the CURRENT space, read through the shared store so a switch in any
-  // window swaps the dock here (§12.2). An explicit `null` stays idle; an explicit
-  // space bypasses the store entirely (no needless currentSpace fetch). OS plane
-  // unavailable (§12.2) → fully idle.
-  const useCurrent = space === undefined
-  const store = currentSpaceStore(shell)
-  useEffect(() => {
-    if (useCurrent && available) store.ensure()
-  }, [store, useCurrent, available])
-  const subscribe = useCallback(
-    (cb: () => void) => (useCurrent && available ? store.subscribe(cb) : () => {}),
-    [store, useCurrent, available],
-  )
-  const getSnapshot = useCallback(
-    (): CurrentSpaceSnapshot => (useCurrent && available ? store.getSnapshot() : IDLE_CURRENT),
-    [store, useCurrent, available],
-  )
-  const currentSnap = useSyncExternalStore(subscribe, getSnapshot, getSnapshot)
-
-  const effective = useCurrent ? currentSnap.space : (space ?? null)
-  const effRef = effective === null ? null : toRef(effective)
-  const appsRes = useAsyncResource<readonly ApplicationNode[]>(
-    !available || effRef === null ? null : () => shell.apps.in(effRef),
+  const result = useAsyncResource<readonly App[]>(
+    available ? () => shell.apps.list() : null,
     NO_APPS,
-    [shell, effRef, available],
+    [shell, available],
   )
 
   return useMemo<AppsResult>(
     () => ({
-      apps: appsRes.data,
-      pending: (useCurrent && currentSnap.pending) || appsRes.pending,
-      error: (useCurrent ? currentSnap.error : undefined) ?? appsRes.error,
+      apps: result.data,
+      pending: result.pending,
+      error: result.error,
       live: false,
       seq: 0,
-      refetch: appsRes.refetch,
+      refetch: result.refetch,
     }),
-    [appsRes.data, appsRes.pending, appsRes.error, appsRes.refetch, useCurrent, currentSnap],
+    [result.data, result.pending, result.error, result.refetch],
   )
 }
-
-/** A bound-node-ish subject carries a graph id. */
-function hasId(x: unknown): x is { readonly id: string } {
-  return typeof x === 'object' && x !== null && 'id' in x
-}
-
-/** An `@id` ref for a bound node, else the normalized ref of a raw subject. */
-export function toRef(x: NodeTarget | { readonly id: string }): NodeTarget {
-  return hasId(x) ? x.id : x
-}
-
-/** Stable dependency identity for one Shell node target. */
-export function targetKey(x: NodeTarget | { readonly id: string }): string {
-  if (hasId(x)) return `id:${x.id}`
-  if (typeof x === 'string') return `text:${x}`
-  return `path:${Path.from(x as PathLike).raw}`
-}

package/src/application/apps/open-app.hook.ts

@@ -1,17 +1,12 @@
-/**
- * useOpenApp (API §12.2) — the Action that opens an `AppSession` (the three-call
- * app-open protocol lives in the shell package). Resolves to the session; disposal
- * is the caller's (AppHost disposes it with the window).
- */
-import type { ApplicationNode, AppSession, NodeTarget } from '@astrale-os/shell'
+import type { Key } from '@astrale-os/sdk/schema'
+import type { App, ResolvedView } from '@astrale-os/shell'
 
 import type { Action } from '../../graph/action.js'
 
 import { useAction } from '../../graph/action.js'
 import { useShell } from '../../session/shell.hook.js'
-import { toRef } from './apps.hook.js'
-
-export function useOpenApp(): Action<[ApplicationNode | NodeTarget], AppSession> {
+/** Resolve one installed Domain's ordinary entry View. */
+export function useOpenApp(): Action<[App | Key.Origin], ResolvedView | null> {
   const shell = useShell()
-  return useAction((app: ApplicationNode | NodeTarget) => shell.apps.open(toRef(app)))
+  return useAction((app: App | Key.Origin) => shell.apps.open(app))
 }

package/src/application/index.ts

@@ -1,6 +1,6 @@
 // application — API §12.2. The OS-plane hooks over the shell package's
 // `shell.user/spaces/apps` namespaces + the window module: useUser, useSpaces,
-// useCurrentSpace, useSpace, useApps, useInstalledDomains, useOpenApp,
+// useCurrentSpace, useSpace, useApps, useOpenApp,
 // AppHost, AppLogo.
 export { useUser } from './user/user.hook.js'
 export { useSpaces } from './spaces/spaces.hook.js'
@@ -11,20 +11,10 @@ export { useSpace } from './spaces/space.hook.js'
 export type { SpaceResult } from './spaces/space.hook.js'
 export { useApps } from './apps/apps.hook.js'
 export type { AppsResult } from './apps/apps.hook.js'
-export { useInstalledDomains } from './apps/domains.hook.js'
-export type { DomainsResult } from './apps/domains.hook.js'
 export { useOpenApp } from './apps/open-app.hook.js'
 export { AppHost } from './apps/app-host.js'
 export type { AppHostFallbackState, AppHostProps } from './apps/app-host.js'
 export { AppLogo } from './apps/app-logo.js'
 export type { AppLogoProps } from './apps/app-logo.js'
 // The OS node/session types (from the shell package, single import surface).
-export type {
-  ApplicationNode,
-  AppSession,
-  DomainSearchResult,
-  NodeTarget,
-  ResolvedView,
-  SpaceNode,
-  UserNode,
-} from '@astrale-os/shell'
+export type { App, NodeTarget, ResolvedView, SpaceNode, UserNode } from '@astrale-os/shell'

package/src/application/spaces/space.hook.ts

@@ -1,5 +1,7 @@
+import type { PathLike } from '@astrale-os/sdk/graph/path'
 import type { NodeTarget, SpaceNode } from '@astrale-os/shell'
 
+import { Path } from '@astrale-os/sdk/graph/path'
 /**
  * useSpace(ref) (API §12.2) — a single space by ref; `null`/`undefined` (or an
  * unavailable OS plane) is idle (§1.3). One-shot today (§12 flag).
@@ -11,7 +13,6 @@ import type { CurrentSpaceResult } from './current-space.hook.js'
 import { useAsyncResource } from '../../graph/async.js'
 import { isIdleInput } from '../../graph/memory/read/idle.js'
 import { useShell } from '../../session/shell.hook.js'
-import { targetKey } from '../apps/apps.hook.js'
 import { isOsPlaneAvailable } from '../user/user.store.js'
 
 export type SpaceResult = CurrentSpaceResult
@@ -38,3 +39,7 @@ export function useSpace(ref: NodeTarget | null | undefined): SpaceResult {
     [idle, res],
   )
 }
+
+function targetKey(input: NodeTarget): string {
+  return typeof input === 'string' ? `text:${input}` : `path:${Path.from(input as PathLike).raw}`
+}

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

@@ -1,4 +1,4 @@
-import type { Identity } from '@astrale-os/kernel-client/auth'
+import type { Identity } from '@astrale-os/sdk/auth'
 import type { KernelClient } from '@astrale-os/shell'
 import type { ReactElement, ReactNode } from 'react'
 

package/src/auth/auth.hook.ts

@@ -1,4 +1,4 @@
-import type { AuthApi } from '@astrale-os/kernel-client/auth'
+import type { AuthApi } from '@astrale-os/sdk/auth'
 
 import { useIdentityBinding } from './act-as.context.js'
 

package/src/auth/can.hook.ts

@@ -1,6 +1,6 @@
 import type { NodeId } from '@astrale-os/sdk/graph/node'
 import type { PathLike } from '@astrale-os/sdk/graph/path'
-import type { schema } from '@astrale-os/sdk/schema'
+import type { PolicyRef } from '@astrale-os/sdk/schema'
 
 import { Path } from '@astrale-os/sdk/graph/path'
 import { useEffect, useState } from 'react'
@@ -14,7 +14,7 @@ export type PolicyObject = NodeId | { readonly id: NodeId }
  * invoked callable remains the authorization enforcement point.
  */
 export function useCan(
-  policy: PathLike | schema.PolicyRef | null | undefined,
+  policy: PathLike | PolicyRef | null | undefined,
   object: PolicyObject | null | undefined,
 ): boolean | undefined {
   const { kernel } = useIdentityBinding()
@@ -45,7 +45,7 @@ export function useCan(
   return decision
 }
 
-function policyPath(policy: PathLike | schema.PolicyRef | null | undefined) {
+function policyPath(policy: PathLike | PolicyRef | null | undefined) {
   if (policy === null || policy === undefined) return null
   return policy instanceof Path || typeof policy === 'string'
     ? Path.from(policy).raw

package/src/auth/self.hook.ts

@@ -1,4 +1,4 @@
-import type { Identity } from '@astrale-os/kernel-client/auth'
+import type { Identity } from '@astrale-os/sdk/auth'
 
 import { useIdentityBinding } from './act-as.context.js'