@xemahq/ui-kernel 0.9.2 → 0.11.0

package/src/lib/biome-host/agent-validation.ts

@@ -82,11 +82,17 @@ export interface ValidateBiomeCompositionOptions {
  */
 function biomeOwnedSlotOwner(slot: string): string | null {
   const slashIndex = slot.indexOf('/');
-  if (slashIndex <= 0) return null; // no slash, or leading slash (empty owner)
-  if (slot.indexOf('/', slashIndex + 1) !== -1) return null; // more than one slash
+  if (slashIndex <= 0) {
+    return null;
+  } // no slash, or leading slash (empty owner)
+  if (slot.indexOf('/', slashIndex + 1) !== -1) {
+    return null;
+  } // more than one slash
   const owner = slot.slice(0, slashIndex);
   const name = slot.slice(slashIndex + 1);
-  if (owner.length === 0 || name.length === 0) return null;
+  if (owner.length === 0 || name.length === 0) {
+    return null;
+  }
   return owner;
 }
 
@@ -113,12 +119,17 @@ export function validateBiomeComposition(
       const scope = route.projectScoped ? 'project' : 'root';
       const key = `${scope}:${route.path}`;
       const owners = routeOwners.get(key);
-      if (owners) owners.push(biome.id);
-      else routeOwners.set(key, [biome.id]);
+      if (owners) {
+        owners.push(biome.id);
+      } else {
+        routeOwners.set(key, [biome.id]);
+      }
     }
   }
   for (const [key, owners] of routeOwners) {
-    if (owners.length < 2) continue;
+    if (owners.length < 2) {
+      continue;
+    }
     const [scope, path] = splitFirst(key, ':');
     diagnostics.push({
       code: CompositionDiagnosticCode.DuplicateRoutePath,
@@ -139,12 +150,17 @@ export function validateBiomeComposition(
   for (const biome of biomes) {
     for (const navItem of biome.navItems ?? []) {
       const owners = navOwners.get(navItem.id);
-      if (owners) owners.push(biome.id);
-      else navOwners.set(navItem.id, [biome.id]);
+      if (owners) {
+        owners.push(biome.id);
+      } else {
+        navOwners.set(navItem.id, [biome.id]);
+      }
     }
   }
   for (const [navId, owners] of navOwners) {
-    if (owners.length < 2) continue;
+    if (owners.length < 2) {
+      continue;
+    }
     diagnostics.push({
       code: CompositionDiagnosticCode.DuplicateNavId,
       severity: CompositionDiagnosticSeverity.Error,
@@ -159,7 +175,9 @@ export function validateBiomeComposition(
   // ── Panel slots: known-slot + dependency-closure ─────────────────────
   for (const biome of biomes) {
     for (const panel of biome.panels ?? []) {
-      if (options.knownSlots.has(panel.slot)) continue;
+      if (options.knownSlots.has(panel.slot)) {
+        continue;
+      }
       const owner = biomeOwnedSlotOwner(panel.slot);
       if (owner === null) {
         diagnostics.push({
@@ -197,7 +215,9 @@ export function validateBiomeComposition(
 /** Split on the first occurrence of `sep` into a `[head, tail]` pair. */
 function splitFirst(value: string, sep: string): [string, string] {
   const idx = value.indexOf(sep);
-  if (idx === -1) return [value, ''];
+  if (idx === -1) {
+    return [value, ''];
+  }
   return [value.slice(0, idx), value.slice(idx + sep.length)];
 }
 
@@ -206,10 +226,14 @@ function sortDiagnostics(
   diagnostics: CompositionDiagnostic[],
 ): CompositionDiagnostic[] {
   return diagnostics.slice().sort((a, b) => {
-    if (a.code !== b.code) return a.code.localeCompare(b.code);
+    if (a.code !== b.code) {
+      return a.code.localeCompare(b.code);
+    }
     const ai = a.biomeIds.join(',');
     const bi = b.biomeIds.join(',');
-    if (ai !== bi) return ai.localeCompare(bi);
+    if (ai !== bi) {
+      return ai.localeCompare(bi);
+    }
     return a.message.localeCompare(b.message);
   });
 }

package/src/lib/biome-host/biome-registry.ts

@@ -36,7 +36,10 @@ import type { HostBridge } from './host-bridge';
  * register/unregister/bootstrap call is a no-op — a single flag controls
  * the entire surface.
  */
-class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: string }> {
+class FrontendBiomeRegistry extends Registry<
+  string,
+  FrontendBiome & { key: string }
+> {
   private revisionCount = 0;
   private readonly listeners = new Set<() => void>();
   /**
@@ -54,7 +57,9 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
   }
 
   registerBiome(biome: FrontendBiome): void {
-    if (!this.enabled) return;
+    if (!this.enabled) {
+      return;
+    }
     this.register({ ...biome, key: biome.id });
     this.revisionCount += 1;
     this.notify();
@@ -67,14 +72,20 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
    */
   async runInit(biomeId: string, bridge: HostBridge): Promise<void> {
     const entry = this.get(biomeId);
-    if (!entry || !entry.init) return;
-    if (this.initialized.has(biomeId)) return;
+    if (!entry || !entry.init) {
+      return;
+    }
+    if (this.initialized.has(biomeId)) {
+      return;
+    }
     this.initialized.add(biomeId);
     await entry.init({ bridge, biomeId });
   }
 
   unregisterBiome(id: string): boolean {
-    if (!this.enabled) return false;
+    if (!this.enabled) {
+      return false;
+    }
     const entry = this.get(id);
     const removed = this.unregister(id);
     if (removed) {
@@ -86,7 +97,10 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
         // because the biome is being torn down anyway.
         void Promise.resolve(entry.dispose()).catch((error: unknown) => {
           // Surface for devtools without crashing the unregister flow.
-          console.error(`[xema-ui-kernel] dispose() failed for '${id}':`, error);
+          console.error(
+            `[xema-ui-kernel] dispose() failed for '${id}':`,
+            error,
+          );
         });
       }
       this.notify();
@@ -103,7 +117,9 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
   }
 
   setEnabled(enabled: boolean): void {
-    if (this.enabled === enabled) return;
+    if (this.enabled === enabled) {
+      return;
+    }
     this.enabled = enabled;
     if (!enabled) {
       // When master-disabling, drop any previously-registered biomes so
@@ -140,11 +156,15 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
   }
 
   panelsForSlot(slot: string): readonly PanelContribution[] {
-    if (!this.enabled) return [];
+    if (!this.enabled) {
+      return [];
+    }
     const out: PanelContribution[] = [];
     for (const biome of this.list()) {
       for (const panel of biome.panels ?? []) {
-        if (panel.slot === slot) out.push(panel);
+        if (panel.slot === slot) {
+          out.push(panel);
+        }
       }
     }
     return out.sort((a, b) => (a.weight ?? 100) - (b.weight ?? 100));
@@ -167,7 +187,9 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
    * rejected contribution is never dropped silently.
    */
   outputRenderers(): ReadonlyMap<string, OutputRendererContribution> {
-    if (!this.enabled) return new Map<string, OutputRendererContribution>();
+    if (!this.enabled) {
+      return new Map<string, OutputRendererContribution>();
+    }
     // `onDuplicate` fires SYNCHRONOUSLY from inside `register()`, so this
     // cursor always names the biome whose contribution was rejected — the
     // contribution object itself does not carry its owner.
@@ -200,6 +222,17 @@ class FrontendBiomeRegistry extends Registry<string, FrontendBiome & { key: stri
 
 export const biomeRegistry = new FrontendBiomeRegistry();
 
+function isFrontendBiome(value: unknown): value is FrontendBiome {
+  return (
+    value !== null &&
+    typeof value === 'object' &&
+    'id' in value &&
+    typeof value.id === 'string' &&
+    'displayName' in value &&
+    typeof value.displayName === 'string'
+  );
+}
+
 /**
  * Register an already-built `FrontendBiome` instance. Prefer
  * `registerFrontendBiome(factory, bridge)` for biomes shipped via
@@ -222,9 +255,11 @@ export function registerFrontendBiome(
   factory: FrontendBiomeFactory,
   bridge: HostBridge,
 ): void {
-  if (!biomeRegistry.isEnabled()) return;
-  const biome = factory(bridge);
-  if (!biome || typeof biome !== 'object' || typeof biome.id !== 'string') {
+  if (!biomeRegistry.isEnabled()) {
+    return;
+  }
+  const biome: unknown = factory(bridge);
+  if (!isFrontendBiome(biome)) {
     throw new Error(
       '[xema-ui-kernel] FrontendBiomeFactory returned a non-FrontendBiome value. ' +
         'A biome module must default-export `(bridge) => FrontendBiome`.',

package/src/lib/biome-host/biome-scope-hooks.ts

@@ -11,7 +11,9 @@ export interface RequiredProjectScope {
 }
 
 function normalize(value: string | null | undefined): string | null {
-  if (typeof value !== 'string') return null;
+  if (typeof value !== 'string') {
+    return null;
+  }
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : null;
 }

package/src/lib/biome-host/biome-scoped-query.ts

@@ -18,10 +18,7 @@ import {
   type UseQueryResult,
 } from '@tanstack/react-query';
 
-import {
-  useProjectScope,
-  type ProjectScope,
-} from './biome-scope-hooks';
+import { useProjectScope, type ProjectScope } from './biome-scope-hooks';
 
 /**
  * The canonical Xema-platform tenant header. Every platform biome-api reads it
@@ -38,8 +35,12 @@ const PROJECT_HEADER = 'X-Project-Id';
  */
 export function buildScopedRequestInit(scope: ProjectScope): RequestInit {
   const headers: Record<string, string> = {};
-  if (scope.orgId) headers[ORG_HEADER] = scope.orgId;
-  if (scope.projectId) headers[PROJECT_HEADER] = scope.projectId;
+  if (scope.orgId) {
+    headers[ORG_HEADER] = scope.orgId;
+  }
+  if (scope.projectId) {
+    headers[PROJECT_HEADER] = scope.projectId;
+  }
   return { headers };
 }
 

package/src/lib/biome-host/frontend-biome.ts

@@ -1,6 +1,6 @@
-import type { ComponentType, ReactNode } from 'react';
 import type { HostBridge } from './host-bridge';
 import type { SessionContributions } from './session-contributions';
+import type { ComponentType, ReactNode } from 'react';
 
 /**
  * Runtime contribution types a `target: 'web'` biome composes. Web

package/src/lib/biome-host/host-bridge.ts

@@ -1,12 +1,10 @@
-import type { QueryClient } from '@tanstack/react-query';
-
 import { createContext, useContext, type ReactNode } from 'react';
 
 import type { CapabilityPort } from '../capabilities';
 import type { SystemBus } from '../system-bus';
-
 import type { I18nSource } from './i18n-port';
 import type { RealtimeSource } from './realtime-port';
+import type { QueryClient } from '@tanstack/react-query';
 
 /**
  * `HostBridge` is the host-agnostic abstraction every frontend biome
@@ -44,7 +42,10 @@ export interface HostBridgeNavigation {
    * declares it is the matched route.
    */
   useRouteParams<
-    T extends Record<string, string | undefined> = Record<string, string | undefined>,
+    T extends Record<string, string | undefined> = Record<
+      string,
+      string | undefined
+    >,
   >(): T;
   /**
    * Hook returning the current URL query string as a read-only

package/src/lib/biome-host/i18n-hooks.ts

@@ -10,6 +10,7 @@
  */
 
 import { useHostBridge } from './host-bridge';
+
 import type { I18nSource, Translator } from './i18n-port';
 
 /**

package/src/lib/biome-host/index.ts

@@ -23,7 +23,6 @@ export * from './define-web-biome';
 export * from './create-biome-orval-config';
 export * from './biome-registry';
 export * from './session-contributions';
-export * from './session-profiles';
 export * from './host-sources';
 export * from './biome-mode';
 export * from './agent-validation';

package/src/lib/biome-host/realtime-hooks.ts

@@ -11,6 +11,7 @@
  */
 
 import { useHostBridge } from './host-bridge';
+
 import type {
   RealtimeCloudEvent,
   RealtimeConnectionState,

package/src/lib/biome-host/session-contributions.ts

@@ -13,17 +13,15 @@
  * `SessionContext`.
  *
  * `appliesTo` is the single gating primitive — biomes use it to scope
- * a contribution to a profile, capability flag, session status, or any
- * derived condition. Without it, every contribution applies everywhere.
+ * a contribution to explicit Agent, workspace, domain, or session status
+ * facts. Without it, every contribution applies everywhere.
  *
  * Naming convention: contribution ids MUST be namespaced as
  * `<biome-id>/<contribution>` so cross-biome collisions surface
  * deterministically at registration time (`RegistryDuplicateKeyError`).
  */
-import type { ComponentType, ReactNode } from 'react';
-
 import type { HostBridge } from './host-bridge';
-import type { SessionProfileDescriptor } from './session-profiles';
+import type { ComponentType, ReactNode } from 'react';
 
 /**
  * Read-only snapshot of the session the contribution is evaluated
@@ -41,14 +39,15 @@ export interface SessionContext {
    * sessions they care about.
    */
   readonly biomeId?: string;
-  readonly profileKey?: string;
   readonly status: string;
   /**
-   * Capability flags advertised by the session's profile descriptor
-   * (e.g. `'hasGit'`, `'hasArtifacts'`, `'supportsBranches'`). Biomes
-   * gate against these instead of hard-coding profile keys.
+   * The resolved Agent contract that launched this session. This is
+   * runtime truth returned by the Agent resolver, never a UI-authored
+   * profile or a synthetic fallback.
    */
-  readonly capabilities: ReadonlySet<string>;
+  readonly agent?: SessionResolvedAgent;
+  /** Repository actually bound to the session, when one exists. */
+  readonly repositoryId?: string;
   /**
    * `true` while the session is in a state that accepts new work
    * (running, waiting, idle); `false` for terminal/paused/failed states.
@@ -58,6 +57,19 @@ export interface SessionContext {
   readonly isActive: boolean;
 }
 
+/**
+ * UI-safe projection of the resolved Agent contract. The host obtains this
+ * from the Agent resolver and passes it into the kernel; plugins only consume
+ * the explicit permission/workspace facts they need.
+ */
+export interface SessionResolvedAgent {
+  readonly ref: string;
+  readonly requiredCapabilities: ReadonlySet<string>;
+  readonly mayEditRepositories: boolean;
+  readonly mayWriteKnowledgeBase: boolean;
+  readonly hasOutputSurface: boolean;
+}
+
 /**
  * Stable representation of a session console event passed into activity
  * + tool-call renderers. Mirrors the host's `SessionConsoleEntry` minus
@@ -281,13 +293,4 @@ export interface SessionContributions {
   readonly mutationBars?: readonly MutationBarContribution[];
   readonly headerChips?: readonly HeaderChipContribution[];
   readonly attachmentClasses?: readonly AttachmentClassContribution[];
-  /**
-   * Profile descriptors this biome owns. The host matches a session's
-   * `profileKey` against these and fans out the descriptor's
-   * `capabilities` as `SessionContext.capabilities`, which each
-   * contribution's `appliesTo` predicate reads. A biome that ships a
-   * profile MUST also ship its descriptor here so the capability vocab
-   * stays explicit rather than implicit-from-key-naming.
-   */
-  readonly profiles?: readonly SessionProfileDescriptor[];
 }

package/src/lib/biome-host/use-mutation-with-error-toast.ts

@@ -68,10 +68,12 @@ export function useMutationWithErrorToast<
       if (successTitle !== null && successTitle !== undefined) {
         bridge.toast.success(successTitle, successDescription);
       }
-      if (userOnSuccess) userOnSuccess(data, variables, context, mutation);
+      if (userOnSuccess) {
+        userOnSuccess(data, variables, context, mutation);
+      }
     },
     onError: (error: TError) => {
-      if (errorTitle !== null && errorTitle !== undefined) {
+      if (errorTitle !== undefined) {
         const shouldSuppressToast = customOnError?.(error) === true;
         if (!shouldSuppressToast) {
           const errorMessage = decodeError(

package/src/lib/biome-host/use-page-state.ts

@@ -25,9 +25,12 @@ function buildPath(pathname: string, params: URLSearchParams): string {
 }
 
 function serializeValue<T>(value: T): string {
-  if (typeof value === 'string') return value;
-  if (typeof value === 'number' || typeof value === 'boolean')
+  if (typeof value === 'string') {
+    return value;
+  }
+  if (typeof value === 'number' || typeof value === 'boolean') {
     return String(value);
+  }
   return JSON.stringify(value);
 }
 
@@ -43,7 +46,9 @@ function deserializePrimitive<T>(
   rawValue: string,
   defaultValue: T,
 ): T | undefined {
-  if (typeof defaultValue === 'string') return rawValue as T;
+  if (typeof defaultValue === 'string') {
+    return rawValue as T;
+  }
 
   if (typeof defaultValue === 'number') {
     const numericValue = Number(rawValue);
@@ -51,8 +56,12 @@ function deserializePrimitive<T>(
   }
 
   if (typeof defaultValue === 'boolean') {
-    if (rawValue === 'true') return true as T;
-    if (rawValue === 'false') return false as T;
+    if (rawValue === 'true') {
+      return true as T;
+    }
+    if (rawValue === 'false') {
+      return false as T;
+    }
     return defaultValue;
   }
 
@@ -60,10 +69,14 @@ function deserializePrimitive<T>(
 }
 
 function deserializeValue<T>(rawValue: string | null, defaultValue: T): T {
-  if (rawValue === null) return defaultValue;
+  if (rawValue === null) {
+    return defaultValue;
+  }
 
   const primitive = deserializePrimitive(rawValue, defaultValue);
-  if (primitive !== undefined) return primitive;
+  if (primitive !== undefined) {
+    return primitive;
+  }
 
   // Default is null/undefined or a complex type (array/object). The value was
   // written via JSON.stringify in serializeValue, so attempt to parse it back.
@@ -74,9 +87,13 @@ function deserializeValue<T>(rawValue: string | null, defaultValue: T): T {
     return parsedValue as T;
   }
 
-  if (defaultValue === null || defaultValue === undefined) return rawValue as T;
+  if (defaultValue === null || defaultValue === undefined) {
+    return rawValue as T;
+  }
 
-  if (parsedValue !== undefined) return parsedValue as T;
+  if (parsedValue !== undefined) {
+    return parsedValue as T;
+  }
 
   if (Array.isArray(defaultValue)) {
     return rawValue ? ([rawValue] as unknown as T) : defaultValue;
@@ -218,7 +235,7 @@ export function useBatchPageState(): (
     (updates: Record<string, string | null>) => {
       const next = new URLSearchParams(searchParams);
       for (const [key, value] of Object.entries(updates)) {
-        if (value === null || value === undefined) {
+        if (value === null) {
           next.delete(key);
         } else {
           next.set(key, value);

package/src/lib/capabilities/capability-provider.tsx

@@ -1,13 +1,13 @@
 import { useQuery } from '@tanstack/react-query';
-import type { ReactNode } from 'react';
 
-import { useHostBridge } from '../biome-host/host-bridge';
 import {
   CapabilityContext,
   type CapabilityContextValue,
 } from './capability-context';
+import { useHostBridge } from '../biome-host/host-bridge';
 
 import type { CapabilityPort, MeCapabilitiesSnapshot } from './types';
+import type { ReactNode } from 'react';
 
 /**
  * Stable query-key root for the capability snapshot. Folded with the active
@@ -46,10 +46,13 @@ export interface CapabilityProviderProps {
  * Rendering is fail-soft (callers can show a loading state), but failures are
  * SURFACED via `error` rather than masquerading as an empty capability set.
  */
-export function CapabilityProvider(props: CapabilityProviderProps): JSX.Element {
+export function CapabilityProvider(
+  props: CapabilityProviderProps,
+): JSX.Element {
   const bridge = useHostBridge();
   const port = props.port ?? bridge.capabilities;
-  const orgId = props.orgId !== undefined ? props.orgId : bridge.auth.getOrgId();
+  const orgId =
+    props.orgId !== undefined ? props.orgId : bridge.auth.getOrgId();
 
   const query = useQuery<MeCapabilitiesSnapshot>({
     queryKey: [...CAPABILITIES_QUERY_ROOT, orgId],
@@ -62,5 +65,9 @@ export function CapabilityProvider(props: CapabilityProviderProps): JSX.Element
     error: query.error,
   };
 
-  return <CapabilityContext.Provider value={value}>{props.children}</CapabilityContext.Provider>;
+  return (
+    <CapabilityContext.Provider value={value}>
+      {props.children}
+    </CapabilityContext.Provider>
+  );
 }

package/src/lib/capabilities/use-capability.ts

@@ -1,10 +1,10 @@
-import type { ExecutionEnvironmentKind } from '@xemahq/kernel-contracts/execution-environment';
-
 import {
   useCapabilityContext,
   type CapabilityContextValue,
 } from './capability-context';
+
 import type { MeCapabilitiesSnapshot } from './types';
+import type { ExecutionEnvironmentKind } from '@xemahq/kernel-contracts/execution-environment';
 
 export interface UseCapabilityOptions {
   /**
@@ -45,12 +45,16 @@ export interface CapabilityDecision {
  * On error, `allowed` is `false` and `error` is set; the hook never silently
  * degrades a failed fetch into a confident denial.
  */
-export function useCapability(ref: string, opts?: UseCapabilityOptions): CapabilityDecision {
+export function useCapability(
+  ref: string,
+  opts?: UseCapabilityOptions,
+): CapabilityDecision {
   const { snapshot, isLoading, error } = useCapabilityContext();
 
   const entry = snapshot?.capabilities.find((c) => c.ref === ref);
   const inEnvironment =
-    !!entry && (!opts?.environment || entry.environments.includes(opts.environment));
+    !!entry &&
+    (!opts?.environment || entry.environments.includes(opts.environment));
 
   return {
     allowed: inEnvironment && !entry.approvalRequired,

package/src/lib/contribution-registry/contribution-registry.ts

@@ -134,7 +134,9 @@ export function createContributionRegistry<TEntry>(
       target.set(kind, entry);
       return;
     }
-    if (existing === entry) return;
+    if (existing === entry) {
+      return;
+    }
     if (duplicatePolicy === DuplicateContributionPolicy.FirstWins) {
       // `onDuplicate` is guaranteed present under this policy (checked above).
       (onDuplicate as (k: string, e: TEntry, r: TEntry) => void)(

package/src/lib/system-bus/deeplink.ts

@@ -83,9 +83,13 @@ export type ParsedDeeplink =
 
 function parseQuery(search: string): Record<string, string> {
   const out: Record<string, string> = {};
-  if (search.length === 0) return out;
+  if (search.length === 0) {
+    return out;
+  }
   for (const pair of search.split('&')) {
-    if (pair.length === 0) continue;
+    if (pair.length === 0) {
+      continue;
+    }
     const eq = pair.indexOf('=');
     if (eq === -1) {
       out[decodeURIComponent(pair)] = '';
@@ -105,7 +109,10 @@ function parseQuery(search: string): Record<string, string> {
  */
 export function parseDeeplink(raw: string): ParsedDeeplink {
   if (typeof raw !== 'string' || !raw.startsWith(DEEPLINK_SCHEME)) {
-    throw new DeeplinkParseError(String(raw), `must start with "${DEEPLINK_SCHEME}"`);
+    throw new DeeplinkParseError(
+      String(raw),
+      `must start with "${DEEPLINK_SCHEME}"`,
+    );
   }
   const afterScheme = raw.slice(DEEPLINK_SCHEME.length);
   if (afterScheme.length === 0) {
@@ -140,7 +147,10 @@ export function parseDeeplink(raw: string): ParsedDeeplink {
     case DeeplinkTargetKind.Object: {
       const body = segments.slice(1).join('/');
       if (body.length === 0) {
-        throw new DeeplinkParseError(raw, 'object deeplink missing <XemaObjectRef>');
+        throw new DeeplinkParseError(
+          raw,
+          'object deeplink missing <XemaObjectRef>',
+        );
       }
       return {
         kind: DeeplinkTargetKind.Object,

package/src/lib/system-bus/host-ports.ts

@@ -1,16 +1,12 @@
-import type { CapabilityRef } from '@xemahq/kernel-contracts/capability';
 import type {
   CapabilityInvokeMeta,
   CapabilityInvokeResult,
 } from './capability-invoke';
 import type { ParsedDeeplink } from './deeplink';
-import type { PaletteEntry, PaletteQuery } from './palette';
-import type {
-  OpenWindowRequest,
-  WindowId,
-  WindowState,
-} from './windows';
 import type { WindowArrangement } from './enums';
+import type { PaletteEntry, PaletteQuery } from './palette';
+import type { OpenWindowRequest, WindowId, WindowState } from './windows';
+import type { CapabilityRef } from '@xemahq/kernel-contracts/capability';
 
 /**
  * Framework-agnostic host ports the concrete host implements so the