@xemahq/ui-kernel 0.9.2 → 0.11.0

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

@@ -1,105 +0,0 @@
-/**
- * Session profile descriptors — coarse capability flags that gate which
- * UI surfaces a session shows. A profile is owned by exactly one biome
- * (matched by `(biomeId, key)`) and declares a set of namespaced
- * capability strings the host fans out as `SessionContext.capabilities`.
- *
- * Biomes consume capabilities through each contribution's `appliesTo`
- * predicate — the host shell itself never branches on a capability
- * string. This keeps the host neutral; a session that doesn't declare
- * `hasGit` simply gets no git-touching contributions because every git
- * contribution gates on `ctx.capabilities.has('hasGit')`.
- *
- * Capability namespacing: well-known capabilities are documented here as
- * constants so first-party biomes agree on a vocabulary; third-party
- * biomes MUST namespace their own capabilities (`<biome-id>:<flag>`)
- * to avoid collisions.
- */
-import { useMemo } from 'react';
-
-import { biomeRegistry, useBiomeRegistryRevision } from './biome-registry';
-
-/**
- * Well-known capability flags first-party biomes share. Third-party
- * biomes SHOULD prefer namespacing their own (`<biome-id>:<flag>`).
- *
- * Adding a constant here is a contract-stability statement — it
- * documents a flag enough first-party biomes use that we want a stable
- * spelling. Removing one is a breaking change.
- */
-export const SessionCapabilities = {
-  /** Session backs a git workspace; branches, commits, push, PR. */
-  HasGit: 'hasGit',
-  /** Session emits workspace file mutations (created/edited/deleted). */
-  HasWorkspaceFiles: 'hasWorkspaceFiles',
-  /** Session can publish artefacts back to the knowledge base. */
-  SupportsKbPush: 'supportsKbPush',
-  /** Session can open / render in-workspace artefacts (apps, docs). */
-  HasArtifacts: 'hasArtifacts',
-  /** Session can fork to a new branch. */
-  SupportsForking: 'supportsForking',
-  /** Session can share its output (deliverable) to other surfaces. */
-  SupportsSharing: 'supportsSharing',
-} as const;
-
-export type SessionCapability =
-  (typeof SessionCapabilities)[keyof typeof SessionCapabilities];
-
-export interface SessionProfileDescriptor {
-  /**
-   * Stable profile key — matches the backend's `Session.profileKey`
-   * (or the session manifest slug for newer profiles).
-   */
-  readonly key: string;
-  /** Biome that owns this profile. */
-  readonly biomeId: string;
-  /** Displayed label. */
-  readonly label: string;
-  readonly description?: string;
-  /** Capability flags the host fans out as `SessionContext.capabilities`. */
-  readonly capabilities: readonly string[];
-}
-
-/**
- * Hook returning the descriptor that matches a session's `(biomeId,
- * profileKey)`. Falls back to a synthetic descriptor with the well-known
- * core capabilities when no biome owns the profile — that's how
- * sessions started before any biome loaded still get usable defaults
- * (today's behaviour).
- *
- * Resolution order:
- *   1. Exact match on `(biomeId, key)`.
- *   2. Exact match on `key` alone (cross-biome profile name).
- *   3. Synthetic fallback (`unknown` biome, empty capabilities).
- */
-export function useSessionProfileDescriptor(
-  biomeId: string | undefined,
-  profileKey: string | undefined,
-): SessionProfileDescriptor {
-  const revision = useBiomeRegistryRevision();
-  return useMemo(() => {
-    const fallback: SessionProfileDescriptor = {
-      key: profileKey ?? 'unknown',
-      biomeId: biomeId ?? 'unknown',
-      label: profileKey ?? 'Unknown profile',
-      capabilities: [],
-    };
-    if (!profileKey) return fallback;
-    let crossPluginMatch: SessionProfileDescriptor | undefined;
-    for (const biome of biomeRegistry.list()) {
-      for (const profile of biome.session?.profiles ?? []) {
-        if (profile.key !== profileKey) continue;
-        if (
-          biomeId !== null &&
-          biomeId !== undefined &&
-          profile.biomeId === biomeId
-        ) {
-          return profile;
-        }
-        crossPluginMatch ??= profile;
-      }
-    }
-    return crossPluginMatch ?? fallback;
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [revision, biomeId, profileKey]);
-}