@astrale-os/shell-react 0.2.5 → 0.2.7

package/dist/index.d.ts

@@ -26,8 +26,8 @@ export { SelectionScope, useSelection } from './selection/index.js';
 export type { Selection, SelectionScopeProps } from './selection/index.js';
 export { useCloseGuard, useTargetNode, useViewsFor, useWindow, useWindowList, useWindows, ViewHost, ViewStage, } from './window/index.js';
 export type { CloseGuard, CloseVerdict, ViewDescriptor, ViewHostProps, ViewSource, ViewHostHandle, ViewsForResult, WindowListEntry, WindowState, WindowView, } from './window/index.js';
-export { useIntent, useSendIntent } from './intents/index.js';
-export type { IntentCtx, IntentPayload, IntentReply, SendIntent } from './intents/index.js';
+export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js';
+export type { EmitIntent, IntentCtx, IntentPayload, IntentReply, SendIntent, } from './intents/index.js';
 export { AppHost, AppLogo, useApps, useCurrentSpace, useOpenApp, useRoles, useSpace, useSpaces, useUser, } from './application/index.js';
 export type { AppHostFallbackState, AppHostProps, AppLogoProps, AppsResult, CurrentSpaceResult, RolesResult, SpaceResult, SpacesResult, } from './application/index.js';
 export type { ApplicationNode, AppSession, RoleNode, SpaceNode, UserNode } from '@astrale-os/shell';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -25,7 +25,7 @@ export { SelectionScope, useSelection } from './selection/index.js';
 // ─── window (§10) ────────────────────────────────────────────────────────────
 export { useCloseGuard, useTargetNode, useViewsFor, useWindow, useWindowList, useWindows, ViewHost, ViewStage, } from './window/index.js';
 // ─── intents (§11) ───────────────────────────────────────────────────────────
-export { useIntent, useSendIntent } from './intents/index.js';
+export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js';
 // ─── application — the OS plane (§12) ────────────────────────────────────────
 export { AppHost, AppLogo, useApps, useCurrentSpace, useOpenApp, useRoles, useSpace, useSpaces, useUser, } from './application/index.js';
 // ─── error taxonomy (§1.4) — guards + classes, re-exported from kernel-client ─

package/dist/intents/emit-intent.hook.d.ts

@@ -0,0 +1,17 @@
+import type { IntentRegistry } from '@astrale-os/shell';
+import type { IntentPayload } from './envelope.js';
+/** Fire-and-forget intent sender returned by {@link useEmitIntent}. */
+export interface EmitIntent {
+    <K extends keyof IntentRegistry>(name: K, payload: IntentPayload<K>, 
+    /** `to`: `'parent'` (reserved) or a child windowId. Default: the parent, if any. */
+    opts?: {
+        to?: 'parent' | string;
+    }): void;
+}
+/**
+ * Return a stable sender for intents that do not need a reply. Emitted messages
+ * carry no correlation id, so listeners can handle navigation and notifications
+ * without retaining a pending request.
+ */
+export declare function useEmitIntent(): EmitIntent;
+//# sourceMappingURL=emit-intent.hook.d.ts.map

package/dist/intents/emit-intent.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-intent.hook.d.ts","sourceRoot":"","sources":["../../src/intents/emit-intent.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAMlD,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAChC,IAAI,CAAA;CACR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAgB1C"}

package/dist/intents/emit-intent.hook.js

@@ -0,0 +1,22 @@
+import { useCallback } from 'react';
+import { useShell } from '../session/shell.hook.js';
+import { intentMessage } from './envelope.js';
+import { resolveIntentTarget } from './resolve-intent-target.js';
+/**
+ * Return a stable sender for intents that do not need a reply. Emitted messages
+ * carry no correlation id, so listeners can handle navigation and notifications
+ * without retaining a pending request.
+ */
+export function useEmitIntent() {
+    const shell = useShell();
+    return useCallback((name, payload, opts) => {
+        const target = resolveIntentTarget(shell, opts?.to);
+        if (target.kind === 'invalid')
+            throw new Error(`useEmitIntent: ${target.reason}`);
+        const message = intentMessage(name, payload);
+        if (target.kind === 'parent')
+            shell.parent.send(message);
+        else
+            shell.children.send(target.windowId, message);
+    }, [shell]);
+}

package/dist/intents/index.d.ts

@@ -1,5 +1,7 @@
 export { useIntent } from './listen-intent.hook.js';
 export type { IntentCtx } from './listen-intent.hook.js';
+export { useEmitIntent } from './emit-intent.hook.js';
+export type { EmitIntent } from './emit-intent.hook.js';
 export { useSendIntent } from './send-intent.hook.js';
 export type { SendIntent } from './send-intent.hook.js';
 export type { IntentPayload, IntentReply } from './envelope.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/intents/index.js

@@ -1,3 +1,4 @@
 // intents — API §11 (useIntent, useSendIntent). See SHELL_REACT_API.md.
 export { useIntent } from './listen-intent.hook.js';
+export { useEmitIntent } from './emit-intent.hook.js';
 export { useSendIntent } from './send-intent.hook.js';

package/dist/intents/resolve-intent-target.d.ts

@@ -0,0 +1,12 @@
+import type { Shell } from '@astrale-os/shell';
+export type IntentTarget = {
+    readonly kind: 'parent';
+} | {
+    readonly kind: 'child';
+    readonly windowId: string;
+} | {
+    readonly kind: 'invalid';
+    readonly reason: string;
+};
+export declare function resolveIntentTarget(shell: Shell, to: string | undefined): IntentTarget;
+//# sourceMappingURL=resolve-intent-target.d.ts.map

package/dist/intents/resolve-intent-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-intent-target.d.ts","sourceRoot":"","sources":["../../src/intents/resolve-intent-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAYtF"}

package/dist/intents/resolve-intent-target.js

@@ -0,0 +1,13 @@
+export function resolveIntentTarget(shell, to) {
+    if (to === undefined) {
+        return shell.parent !== null
+            ? { kind: 'parent' }
+            : { kind: 'invalid', reason: 'no target — pass opts.to (a child windowId) from a root shell' };
+    }
+    if (to === 'parent') {
+        return shell.parent !== null
+            ? { kind: 'parent' }
+            : { kind: 'invalid', reason: "opts.to 'parent' but this shell has no parent channel" };
+    }
+    return { kind: 'child', windowId: to };
+}

package/dist/intents/send-intent.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send-intent.hook.d.ts","sourceRoot":"","sources":["../../src/intents/send-intent.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAS,MAAM,mBAAmB,CAAA;AAW7E,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAK/D,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CAClC;AAqBD,wBAAgB,aAAa,IAAI,UAAU,CAiE1C"}
+{"version":3,"file":"send-intent.hook.d.ts","sourceRoot":"","sources":["../../src/intents/send-intent.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAWtE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAM/D,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CAClC;AAED,wBAAgB,aAAa,IAAI,UAAU,CAiF1C"}

package/dist/intents/send-intent.hook.js

@@ -8,19 +8,7 @@
 import { useCallback, useEffect, useRef } from 'react';
 import { useShell } from '../session/shell.hook.js';
 import { INTENT_REPLY, NOOP, intentMessage } from './envelope.js';
-function resolveTarget(shell, to) {
-    if (to === undefined) {
-        return shell.parent !== null
-            ? { kind: 'parent' }
-            : { kind: 'invalid', reason: 'no target — pass opts.to (a child windowId) from a root shell' };
-    }
-    if (to === 'parent') {
-        return shell.parent !== null
-            ? { kind: 'parent' }
-            : { kind: 'invalid', reason: "opts.to 'parent' but this shell has no parent channel" };
-    }
-    return { kind: 'child', windowId: to };
-}
+import { resolveIntentTarget } from './resolve-intent-target.js';
 export function useSendIntent() {
     const shell = useShell();
     // Unmount settlers for in-flight sends, so a pending reply resolves on teardown.
@@ -34,14 +22,14 @@ export function useSendIntent() {
         };
     }, []);
     return useCallback((name, payload, opts) => {
-        const target = resolveTarget(shell, opts?.to);
+        const target = resolveIntentTarget(shell, opts?.to);
         if (target.kind === 'invalid') {
             return Promise.reject(new Error(`useSendIntent: ${target.reason}`));
         }
         const correlationId = crypto.randomUUID();
         const message = intentMessage(name, payload, correlationId);
         const pending = pendingRef.current;
-        return new Promise((resolve) => {
+        return new Promise((resolve, reject) => {
             let done = false;
             let offReply = NOOP;
             let offClose = NOOP;
@@ -55,12 +43,25 @@ export function useSendIntent() {
                 pending.delete(onUnmount);
                 resolve(value);
             }
+            function fail(error) {
+                if (done)
+                    return;
+                done = true;
+                offReply();
+                offClose();
+                pending.delete(onUnmount);
+                reject(error);
+            }
             const onReply = (m) => {
                 if (m.envelope.name !== INTENT_REPLY)
                     return;
                 const reply = m.envelope.payload;
                 if (reply.correlationId !== correlationId)
                     return;
+                if (reply.error) {
+                    fail(new Error(reply.error.message));
+                    return;
+                }
                 settle(reply.result);
             };
             pending.add(onUnmount);

package/dist/window/hooks/views-for.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"views-for.hook.d.ts","sourceRoot":"","sources":["../../../src/window/hooks/views-for.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAW/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAKjE,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;CAC1C;AAiBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAqBpF"}
+{"version":3,"file":"views-for.hook.d.ts","sourceRoot":"","sources":["../../../src/window/hooks/views-for.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAW/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAKjE,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;CAC1C;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAqBpF"}

package/dist/window/hooks/views-for.hook.js

@@ -1,4 +1,3 @@
-import { K } from '@astrale-os/kernel-core';
 /**
  * useViewsFor (API §10) — "what Views can render this node", as mountable
  * `ViewDescriptor`s for the open-with menu. Backed one-shot (`live:false`) by the
@@ -7,14 +6,12 @@ import { K } from '@astrale-os/kernel-core';
  */
 import { useMemo } from 'react';
 import { useAsyncResource } from '../../graph/async.js';
-import { useKernelClient } from '../../session/kernel-client.hook.js';
-/** The `View.resolve` wire address — the qualified static-method slug from the schema. */
-const VIEW_RESOLVE_METHOD = K.View.resolve.path.method.raw;
+import { useShell } from '../../session/shell.hook.js';
 const NO_VIEWS = Object.freeze([]);
 export function useViewsFor(node) {
-    const kernel = useKernelClient();
+    const shell = useShell();
     const target = resolvePath(node);
-    const res = useAsyncResource(target === null ? null : () => resolveViews(kernel, target), NO_VIEWS, [kernel, target]);
+    const res = useAsyncResource(target === null ? null : () => resolveViews(shell, target), NO_VIEWS, [shell, target]);
     return useMemo(() => ({
         views: res.data,
         pending: res.pending,
@@ -25,9 +22,9 @@ export function useViewsFor(node) {
     }), [res.data, res.pending, res.error, res.refetch]);
 }
 /** Dispatch `View.resolve` and project its rows to mountable `ViewDescriptor`s. */
-async function resolveViews(kernel, node) {
-    const rows = (await kernel.call(VIEW_RESOLVE_METHOD, { node }));
-    if (rows === null || rows === undefined || rows.length === 0)
+async function resolveViews(shell, node) {
+    const rows = await shell.views.resolve(node);
+    if (rows.length === 0)
         return NO_VIEWS;
     return rows.map((r) => ({ id: r.id, path: r.path, url: r.url, handshake: r.handshake }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {
@@ -44,7 +44,7 @@
     "react-dom": "^19.2.0",
     "typescript": "~6.0.1-rc",
     "vitest": "^3.2.4",
-    "@astrale-os/shell": "0.3.4"
+    "@astrale-os/shell": "0.3.5"
   },
   "peerDependencies": {
     "@astrale-os/shell": ">=0.2.0 <1.0.0",

package/src/index.ts

@@ -117,8 +117,14 @@ export type {
 } from './window/index.js'
 
 // ─── intents (§11) ───────────────────────────────────────────────────────────
-export { useIntent, useSendIntent } from './intents/index.js'
-export type { IntentCtx, IntentPayload, IntentReply, SendIntent } from './intents/index.js'
+export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js'
+export type {
+  EmitIntent,
+  IntentCtx,
+  IntentPayload,
+  IntentReply,
+  SendIntent,
+} from './intents/index.js'
 
 // ─── application — the OS plane (§12) ────────────────────────────────────────
 export {

package/src/intents/emit-intent.hook.ts

@@ -0,0 +1,42 @@
+import type { IntentRegistry } from '@astrale-os/shell'
+
+import { useCallback } from 'react'
+
+import type { IntentPayload } from './envelope.js'
+
+import { useShell } from '../session/shell.hook.js'
+import { intentMessage } from './envelope.js'
+import { resolveIntentTarget } from './resolve-intent-target.js'
+
+/** Fire-and-forget intent sender returned by {@link useEmitIntent}. */
+export interface EmitIntent {
+  <K extends keyof IntentRegistry>(
+    name: K,
+    payload: IntentPayload<K>,
+    /** `to`: `'parent'` (reserved) or a child windowId. Default: the parent, if any. */
+    opts?: { to?: 'parent' | string },
+  ): void
+}
+
+/**
+ * Return a stable sender for intents that do not need a reply. Emitted messages
+ * carry no correlation id, so listeners can handle navigation and notifications
+ * without retaining a pending request.
+ */
+export function useEmitIntent(): EmitIntent {
+  const shell = useShell()
+  return useCallback(
+    <K extends keyof IntentRegistry>(
+      name: K,
+      payload: IntentPayload<K>,
+      opts?: { to?: 'parent' | string },
+    ): void => {
+      const target = resolveIntentTarget(shell, opts?.to)
+      if (target.kind === 'invalid') throw new Error(`useEmitIntent: ${target.reason}`)
+      const message = intentMessage(name, payload)
+      if (target.kind === 'parent') shell.parent!.send(message)
+      else shell.children.send(target.windowId, message)
+    },
+    [shell],
+  )
+}

package/src/intents/index.ts

@@ -1,6 +1,8 @@
 // intents — API §11 (useIntent, useSendIntent). See SHELL_REACT_API.md.
 export { useIntent } from './listen-intent.hook.js'
 export type { IntentCtx } from './listen-intent.hook.js'
+export { useEmitIntent } from './emit-intent.hook.js'
+export type { EmitIntent } from './emit-intent.hook.js'
 export { useSendIntent } from './send-intent.hook.js'
 export type { SendIntent } from './send-intent.hook.js'
 export type { IntentPayload, IntentReply } from './envelope.js'

package/src/intents/resolve-intent-target.ts

@@ -0,0 +1,20 @@
+import type { Shell } from '@astrale-os/shell'
+
+export type IntentTarget =
+  | { readonly kind: 'parent' }
+  | { readonly kind: 'child'; readonly windowId: string }
+  | { readonly kind: 'invalid'; readonly reason: string }
+
+export function resolveIntentTarget(shell: Shell, to: string | undefined): IntentTarget {
+  if (to === undefined) {
+    return shell.parent !== null
+      ? { kind: 'parent' }
+      : { kind: 'invalid', reason: 'no target — pass opts.to (a child windowId) from a root shell' }
+  }
+  if (to === 'parent') {
+    return shell.parent !== null
+      ? { kind: 'parent' }
+      : { kind: 'invalid', reason: "opts.to 'parent' but this shell has no parent channel" }
+  }
+  return { kind: 'child', windowId: to }
+}

package/src/intents/send-intent.hook.ts

@@ -1,4 +1,4 @@
-import type { IntentMessage, IntentRegistry, Shell } from '@astrale-os/shell'
+import type { IntentMessage, IntentRegistry } from '@astrale-os/shell'
 
 /**
  * useSendIntent (API §11) — a stable typed sender. Each call attaches a
@@ -13,6 +13,7 @@ import type { IntentPayload, IntentReply } from './envelope.js'
 
 import { useShell } from '../session/shell.hook.js'
 import { INTENT_REPLY, NOOP, intentMessage } from './envelope.js'
+import { resolveIntentTarget } from './resolve-intent-target.js'
 
 /** The typed sender returned by {@link useSendIntent}. */
 export interface SendIntent {
@@ -24,25 +25,6 @@ export interface SendIntent {
   ): Promise<IntentReply<K> | void>
 }
 
-type Target =
-  | { readonly kind: 'parent' }
-  | { readonly kind: 'child'; readonly windowId: string }
-  | { readonly kind: 'invalid'; readonly reason: string }
-
-function resolveTarget(shell: Shell, to: string | undefined): Target {
-  if (to === undefined) {
-    return shell.parent !== null
-      ? { kind: 'parent' }
-      : { kind: 'invalid', reason: 'no target — pass opts.to (a child windowId) from a root shell' }
-  }
-  if (to === 'parent') {
-    return shell.parent !== null
-      ? { kind: 'parent' }
-      : { kind: 'invalid', reason: "opts.to 'parent' but this shell has no parent channel" }
-  }
-  return { kind: 'child', windowId: to }
-}
-
 export function useSendIntent(): SendIntent {
   const shell = useShell()
   // Unmount settlers for in-flight sends, so a pending reply resolves on teardown.
@@ -61,7 +43,7 @@ export function useSendIntent(): SendIntent {
       payload: IntentPayload<K>,
       opts?: { to?: 'parent' | string },
     ): Promise<IntentReply<K> | void> => {
-      const target = resolveTarget(shell, opts?.to)
+      const target = resolveIntentTarget(shell, opts?.to)
       if (target.kind === 'invalid') {
         return Promise.reject(new Error(`useSendIntent: ${target.reason}`))
       }
@@ -69,7 +51,7 @@ export function useSendIntent(): SendIntent {
       const message = intentMessage(name, payload, correlationId)
       const pending = pendingRef.current
 
-      return new Promise<IntentReply<K> | void>((resolve) => {
+      return new Promise<IntentReply<K> | void>((resolve, reject) => {
         let done = false
         let offReply = NOOP
         let offClose = NOOP
@@ -82,10 +64,26 @@ export function useSendIntent(): SendIntent {
           pending.delete(onUnmount)
           resolve(value)
         }
+        function fail(error: Error): void {
+          if (done) return
+          done = true
+          offReply()
+          offClose()
+          pending.delete(onUnmount)
+          reject(error)
+        }
         const onReply = (m: IntentMessage): void => {
           if (m.envelope.name !== INTENT_REPLY) return
-          const reply = m.envelope.payload as { correlationId: string; result: unknown }
+          const reply = m.envelope.payload as {
+            correlationId: string
+            result?: unknown
+            error?: { message: string }
+          }
           if (reply.correlationId !== correlationId) return
+          if (reply.error) {
+            fail(new Error(reply.error.message))
+            return
+          }
           settle(reply.result as IntentReply<K>)
         }
 

package/src/window/hooks/views-for.hook.ts

@@ -1,6 +1,6 @@
 import type { PathLike } from '@astrale-os/kernel-client/graph'
+import type { Shell } from '@astrale-os/shell'
 
-import { K } from '@astrale-os/kernel-core'
 /**
  * useViewsFor (API §10) — "what Views can render this node", as mountable
  * `ViewDescriptor`s for the open-with menu. Backed one-shot (`live:false`) by the
@@ -13,35 +13,22 @@ import type { ReadState } from '../../graph/memory/read/envelope.js'
 import type { Node, ViewDescriptor } from '../lifecycle/mount.js'
 
 import { useAsyncResource } from '../../graph/async.js'
-import { useKernelClient } from '../../session/kernel-client.hook.js'
+import { useShell } from '../../session/shell.hook.js'
 
 export interface ViewsForResult extends ReadState {
   readonly views: readonly ViewDescriptor[]
 }
 
-/** The `View.resolve` wire address — the qualified static-method slug from the schema. */
-const VIEW_RESOLVE_METHOD = K.View.resolve.path.method.raw
-
-/** The kernel `View.resolve` row shape (id/path/url/name?/handshake?/origin). */
-interface ViewOut {
-  readonly id: string
-  readonly path: string
-  readonly url: string
-  readonly name?: string
-  readonly handshake?: 'shell' | 'none'
-  readonly origin: 'self' | 'class'
-}
-
 const NO_VIEWS: readonly ViewDescriptor[] = Object.freeze([])
 
 export function useViewsFor(node: Node | PathLike | null | undefined): ViewsForResult {
-  const kernel = useKernelClient()
+  const shell = useShell()
   const target = resolvePath(node)
 
   const res = useAsyncResource<readonly ViewDescriptor[]>(
-    target === null ? null : () => resolveViews(kernel, target),
+    target === null ? null : () => resolveViews(shell, target),
     NO_VIEWS,
-    [kernel, target],
+    [shell, target],
   )
 
   return useMemo<ViewsForResult>(
@@ -58,12 +45,9 @@ export function useViewsFor(node: Node | PathLike | null | undefined): ViewsForR
 }
 
 /** Dispatch `View.resolve` and project its rows to mountable `ViewDescriptor`s. */
-async function resolveViews(
-  kernel: { call(method: string, params: unknown): Promise<unknown> },
-  node: string,
-): Promise<readonly ViewDescriptor[]> {
-  const rows = (await kernel.call(VIEW_RESOLVE_METHOD, { node })) as ViewOut[] | null | undefined
-  if (rows === null || rows === undefined || rows.length === 0) return NO_VIEWS
+async function resolveViews(shell: Shell, node: string): Promise<readonly ViewDescriptor[]> {
+  const rows = await shell.views.resolve(node)
+  if (rows.length === 0) return NO_VIEWS
   return rows.map((r) => ({ id: r.id, path: r.path, url: r.url, handshake: r.handshake }))
 }