@backbay/glia 0.2.0-alpha.1

package/dist/primitives/three/Sentinel/sentinelStore.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Sentinel State Store
+ *
+ * Manages the Sentinel orb summoning, dismissal, and docking state.
+ */
+import type { SentinelPhase, DockedPosition, Cardinal, DocketItem, OrbPosition, SentinelState, ConversationState } from './types';
+export declare const useSentinelStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<SentinelState>, "persist" | "setState"> & {
+    setState(partial: SentinelState | Partial<SentinelState> | ((state: SentinelState) => SentinelState | Partial<SentinelState>), replace?: false | undefined): unknown;
+    setState(state: SentinelState | ((state: SentinelState) => SentinelState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<SentinelState, {
+            dockedPosition: DockedPosition;
+            cameraPermission: "prompt" | "granted" | "denied";
+            avatarAnonMode: boolean;
+            avatarMosaicSize: number;
+            visibleCardinals: string[];
+        }, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: SentinelState) => void) => () => void;
+        onFinishHydration: (fn: (state: SentinelState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<SentinelState, {
+            dockedPosition: DockedPosition;
+            cameraPermission: "prompt" | "granted" | "denied";
+            avatarAnonMode: boolean;
+            avatarMosaicSize: number;
+            visibleCardinals: string[];
+        }, unknown>>;
+    };
+}>;
+export type { SentinelPhase, DockedPosition, Cardinal, DocketItem, OrbPosition, SentinelState, ConversationState, };
+//# sourceMappingURL=sentinelStore.d.ts.map

package/dist/primitives/three/Sentinel/sentinelStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinelStore.d.ts","sourceRoot":"","sources":["../../../../src/primitives/three/Sentinel/sentinelStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,QAAQ,EACR,UAAU,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAmBjB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;EAsI5B,CAAC;AAGF,YAAY,EACV,aAAa,EACb,cAAc,EACd,QAAQ,EACR,UAAU,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,CAAC"}

package/dist/primitives/three/Sentinel/sentinelStore.js

@@ -0,0 +1,125 @@
+/**
+ * Sentinel State Store
+ *
+ * Manages the Sentinel orb summoning, dismissal, and docking state.
+ */
+import { create } from 'zustand';
+import { persist } from 'zustand/middleware';
+// -----------------------------------------------------------------------------
+// Default Docket
+// -----------------------------------------------------------------------------
+const defaultDocket = [
+    { id: 'console', position: 'N', icon: 'terminal', label: 'Console' },
+    { id: 'lens', position: 'E', icon: 'eye', label: 'Lens' },
+    { id: 'avatar', position: 'S', icon: 'user', label: 'Avatar' },
+    { id: 'vault', position: 'W', icon: 'vault', label: 'Vault' },
+];
+const defaultVisibleCardinals = ['console', 'lens', 'vault', 'avatar'];
+// -----------------------------------------------------------------------------
+// Store Implementation
+// -----------------------------------------------------------------------------
+export const useSentinelStore = create()(persist((set, get) => ({
+    // Initial state
+    phase: 'docked',
+    dockedPosition: 'taskbar',
+    orbPosition: { x: 0, y: 0 },
+    targetPosition: { x: 0, y: 0 },
+    expandedCardinal: null,
+    expandedRadial: null,
+    docket: defaultDocket,
+    cameraPermission: 'prompt',
+    avatarAnonMode: false,
+    avatarMosaicSize: 0.55,
+    taskbarOrigin: { x: 0, y: 0 },
+    // Cardinal configuration state
+    visibleCardinals: defaultVisibleCardinals,
+    // Conversation state
+    conversationState: 'idle',
+    isTextInputEnabled: false,
+    isMuted: false,
+    // Caption state
+    currentCaption: null,
+    // Actions
+    summon: () => {
+        const state = get();
+        if (state.phase !== 'docked')
+            return;
+        // Calculate center of screen
+        const centerX = typeof window !== 'undefined' ? window.innerWidth / 2 : 0;
+        const centerY = typeof window !== 'undefined' ? window.innerHeight / 2 : 0;
+        set({
+            phase: 'summoning',
+            targetPosition: { x: centerX, y: centerY },
+        });
+    },
+    dismiss: () => {
+        const state = get();
+        if (state.phase !== 'open' && state.phase !== 'avatar')
+            return;
+        set({
+            phase: 'dismissing',
+            targetPosition: state.taskbarOrigin,
+            expandedCardinal: null,
+            expandedRadial: null,
+        });
+    },
+    setPhase: (phase) => set({ phase }),
+    setOrbPosition: (orbPosition) => set({ orbPosition }),
+    setTargetPosition: (targetPosition) => set({ targetPosition }),
+    throwTo: (velocity) => {
+        set({ phase: 'throwing' });
+        // Physics handled by useThrowPhysics hook
+    },
+    dockAt: (dockedPosition) => {
+        set({
+            phase: 'docked',
+            dockedPosition,
+            expandedCardinal: null,
+            expandedRadial: null,
+        });
+    },
+    expandCardinal: (direction) => {
+        set({
+            expandedCardinal: direction,
+            expandedRadial: null, // collapse radial when changing cardinal
+        });
+    },
+    expandRadial: (itemId) => {
+        set({ expandedRadial: itemId });
+    },
+    setDocket: (docket) => set({ docket }),
+    enterAvatarMode: () => {
+        set({
+            phase: 'avatar',
+            expandedCardinal: null,
+            expandedRadial: null,
+        });
+    },
+    exitAvatarMode: () => {
+        set({ phase: 'open' });
+    },
+    setCameraPermission: (cameraPermission) => set({ cameraPermission }),
+    setTaskbarOrigin: (taskbarOrigin) => set({ taskbarOrigin }),
+    setAvatarAnonMode: (enabled) => set({ avatarAnonMode: enabled }),
+    setAvatarMosaicSize: (value) => {
+        const clamped = Math.min(1, Math.max(0, value));
+        set({ avatarMosaicSize: clamped });
+    },
+    // Cardinal configuration actions
+    setVisibleCardinals: (visibleCardinals) => set({ visibleCardinals }),
+    // Conversation actions
+    setConversationState: (conversationState) => set({ conversationState }),
+    toggleTextInput: () => set((state) => ({ isTextInputEnabled: !state.isTextInputEnabled })),
+    toggleMute: () => set((state) => ({ isMuted: !state.isMuted })),
+    // Caption actions
+    setCurrentCaption: (currentCaption) => set({ currentCaption }),
+}), {
+    name: 'sentinel-storage',
+    partialize: (state) => ({
+        dockedPosition: state.dockedPosition,
+        cameraPermission: state.cameraPermission,
+        avatarAnonMode: state.avatarAnonMode,
+        avatarMosaicSize: state.avatarMosaicSize,
+        visibleCardinals: state.visibleCardinals,
+    }),
+}));

package/dist/primitives/three/Sentinel/types.d.ts

@@ -0,0 +1,337 @@
+/**
+ * Sentinel Types
+ *
+ * Type definitions for the Sentinel orb component system.
+ */
+import type { ReactNode, ComponentType } from 'react';
+export type SentinelPhase = 'docked' | 'summoning' | 'open' | 'dismissing' | 'throwing' | 'avatar';
+export type Edge = 'top' | 'left' | 'right';
+export type DockedPosition = 'taskbar' | {
+    edge: Edge;
+    percent: number;
+};
+export type Cardinal = 'N' | 'E' | 'S' | 'W';
+export type ConversationState = 'idle' | 'listening' | 'thinking' | 'speaking';
+export interface DocketItem {
+    id: string;
+    position?: Cardinal;
+    icon: string;
+    label: string;
+    action?: () => void;
+    children?: DocketItem[];
+}
+export interface OrbPosition {
+    x: number;
+    y: number;
+}
+export interface SentinelState {
+    phase: SentinelPhase;
+    dockedPosition: DockedPosition;
+    orbPosition: OrbPosition;
+    targetPosition: OrbPosition;
+    expandedCardinal: Cardinal | null;
+    expandedRadial: string | null;
+    docket: DocketItem[];
+    cameraPermission: 'prompt' | 'granted' | 'denied';
+    avatarAnonMode: boolean;
+    avatarMosaicSize: number;
+    taskbarOrigin: OrbPosition;
+    visibleCardinals: string[];
+    conversationState: ConversationState;
+    isTextInputEnabled: boolean;
+    isMuted: boolean;
+    currentCaption: string | null;
+    summon: () => void;
+    dismiss: () => void;
+    setPhase: (phase: SentinelPhase) => void;
+    setOrbPosition: (pos: OrbPosition) => void;
+    setTargetPosition: (pos: OrbPosition) => void;
+    throwTo: (velocity: {
+        x: number;
+        y: number;
+    }) => void;
+    dockAt: (position: DockedPosition) => void;
+    expandCardinal: (direction: Cardinal | null) => void;
+    expandRadial: (itemId: string | null) => void;
+    setDocket: (items: DocketItem[]) => void;
+    enterAvatarMode: () => void;
+    exitAvatarMode: () => void;
+    setCameraPermission: (status: 'prompt' | 'granted' | 'denied') => void;
+    setTaskbarOrigin: (pos: OrbPosition) => void;
+    setAvatarAnonMode: (enabled: boolean) => void;
+    setAvatarMosaicSize: (value: number) => void;
+    setVisibleCardinals: (cardinals: string[]) => void;
+    setConversationState: (state: ConversationState) => void;
+    toggleTextInput: () => void;
+    toggleMute: () => void;
+    setCurrentCaption: (text: string | null) => void;
+}
+/**
+ * Props for injecting external dependencies into Sentinel components.
+ * This allows the package to be reusable without hardcoded imports.
+ */
+export interface SentinelDependencies {
+    /**
+     * Optional icon renderer component.
+     * Receives name, size, and color props.
+     * If not provided, a simple fallback is used.
+     */
+    IconRenderer?: ComponentType<{
+        name: string;
+        size: number;
+        color: string;
+    }>;
+    /**
+     * Optional 3D glyph component for orb visualization.
+     * Receives variant, scale, position, and state props.
+     * If not provided, a simple sphere is rendered.
+     */
+    GlyphRenderer?: ComponentType<{
+        variant?: string;
+        scale?: number;
+        position?: [number, number, number];
+        state?: 'idle' | 'listening';
+    }>;
+    /**
+     * Optional avatar renderer override for realistic avatar rendering.
+     * Receives avatar motion props and camera stream when available.
+     */
+    AvatarRenderer?: ComponentType<AvatarRendererProps>;
+    /**
+     * Optional handler for opening processes.
+     * Called when a cardinal menu item is clicked.
+     */
+    onOpenProcess?: (processId: string, options: Record<string, unknown>) => void;
+    /**
+     * Map of docket item IDs to process IDs.
+     * Used by CardinalMenu to open processes.
+     */
+    processMap?: Record<string, string>;
+    /**
+     * Optional hook for avatar session management.
+     * When provided, enables real-time avatar motion streaming.
+     * The hook should be called with a userId to create a session.
+     */
+    useAvatarSession?: (options: {
+        userId: string;
+        autoConnect?: boolean;
+    }) => AvatarSessionReturn;
+}
+/**
+ * Props for the SentinelOverlay component
+ */
+export interface SentinelOverlayProps {
+    /** Optional custom class name */
+    className?: string;
+}
+/**
+ * Props for the SentinelOrb component
+ */
+export interface SentinelOrbProps {
+    /** Optional custom class name */
+    className?: string;
+}
+/**
+ * Props for the SentinelTether component
+ */
+export interface SentinelTetherProps {
+    /** Optional custom class name */
+    className?: string;
+}
+/**
+ * Props for the CardinalMenu component
+ */
+export interface CardinalMenuProps {
+    /** Optional custom class name */
+    className?: string;
+    /**
+     * Dynamic array of items to display in the 180-degree arc (top half).
+     * If not provided, falls back to docket items with position.
+     */
+    items?: DocketItem[];
+    /**
+     * Optional callback when user clicks the "edit" link below the arc.
+     * If not provided, the edit link is not rendered.
+     */
+    onEdit?: () => void;
+}
+/**
+ * Props for the CardinalItem component
+ */
+export interface CardinalItemProps {
+    icon: string;
+    label: string;
+    position: Cardinal;
+    onClick?: () => void;
+}
+/**
+ * Props for submenu items
+ */
+export interface SubmenuItem {
+    id: string;
+    icon: string;
+    label: string;
+    action?: () => void;
+    children?: SubmenuItem[];
+}
+/**
+ * Arc constraint for RadialSubmenu
+ * - 'auto': Determine arc based on centerOffset (legacy behavior)
+ * - 'semicircle': Force top 180-degree arc (left to right)
+ */
+export type ArcConstraint = 'auto' | 'semicircle';
+/**
+ * Props for the RadialSubmenu component
+ */
+export interface RadialSubmenuProps {
+    items: SubmenuItem[];
+    centerOffset: {
+        x: number;
+        y: number;
+    };
+    /**
+     * Constrains the arc placement.
+     * - 'auto': Determine based on centerOffset (default)
+     * - 'semicircle': Force top 180-degree arc
+     */
+    arcConstraint?: ArcConstraint;
+    onItemClick: (item: SubmenuItem) => void;
+    onItemHover: (itemId: string | null) => void;
+    hoveredItemId: string | null;
+}
+/**
+ * Props for the VerticalSubmenu component
+ */
+export interface VerticalSubmenuProps {
+    items: SubmenuItem[];
+    anchorPosition: {
+        x: number;
+        y: number;
+    };
+    onItemClick: (item: SubmenuItem) => void;
+}
+/**
+ * Props for the DockedMiniOrb component
+ */
+export interface DockedMiniOrbProps {
+    /** Optional custom class name */
+    className?: string;
+}
+/**
+ * Props for the AvatarMode component
+ */
+export interface AvatarModeProps {
+    /** Optional custom class name */
+    className?: string;
+}
+/**
+ * Motion data from avatar session
+ */
+export interface AvatarMotionData {
+    blendshapes: Record<string, number>;
+    headPose: [number, number, number];
+    timestamp: string;
+}
+/**
+ * Return type for useAvatarSession hook (for dependency injection)
+ */
+export interface AvatarSessionReturn {
+    sessionId: string | null;
+    motionData: AvatarMotionData | null;
+    renderFrame?: {
+        image: string;
+        timestamp?: string;
+        contentType?: string;
+        width?: number;
+        height?: number;
+        latencyMs?: number;
+    } | null;
+    isConnected: boolean;
+    uploadFrame: (frameData: string) => Promise<void>;
+    error: Error | null;
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+}
+/**
+ * Props for the AvatarRenderer component
+ */
+export interface AvatarRendererProps {
+    /**
+     * Whether the avatar is actively engaged (listening/speaking).
+     * Affects animation intensity and glow.
+     */
+    isActive?: boolean;
+    /**
+     * ARKit-compatible blendshapes for facial expressions.
+     * Values range from 0-1.
+     * When provided, these override idle animations.
+     */
+    blendshapes?: Record<string, number>;
+    /**
+     * Head rotation in radians [rx, ry, rz].
+     * When provided, this overrides idle head animation.
+     */
+    headPose?: [number, number, number];
+    /**
+     * Optional rendered frame from a neural avatar service.
+     */
+    renderFrame?: {
+        image: string;
+        timestamp?: string;
+        contentType?: string;
+        width?: number;
+        height?: number;
+        latencyMs?: number;
+    };
+    /**
+     * Optional camera stream for real-time avatar rendering.
+     */
+    stream?: MediaStream | null;
+}
+/**
+ * Props for the CameraPip component
+ */
+export interface CameraPipProps {
+    stream: MediaStream | null;
+    size?: number;
+    onToggle?: () => void;
+}
+export interface UseCameraPermissionReturn {
+    permission: 'prompt' | 'granted' | 'denied';
+    stream: MediaStream | null;
+    error: string | null;
+    requestPermission: () => Promise<boolean>;
+    stopStream: () => void;
+}
+export interface ThrowPhysicsOptions {
+    onPositionUpdate: (pos: {
+        x: number;
+        y: number;
+    }) => void;
+    onSettle: (position: {
+        edge: Edge;
+        percent: number;
+    }) => void;
+    edgePadding?: number;
+}
+export interface ThrowPhysicsReturn {
+    isDragging: boolean;
+    startDrag: (e: React.PointerEvent) => void;
+    onPointerMove: (e: React.PointerEvent) => void;
+    endDrag: (e: React.PointerEvent) => void;
+}
+export interface SentinelProviderProps {
+    children: ReactNode;
+    /**
+     * External dependencies to inject into Sentinel components
+     */
+    dependencies?: SentinelDependencies;
+    /**
+     * Initial docket items (optional, uses defaults if not provided)
+     */
+    initialDocket?: DocketItem[];
+}
+export interface SentinelContextValue {
+    dependencies: SentinelDependencies;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/primitives/three/Sentinel/types.d.ts.map

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

package/dist/primitives/three/Sentinel/types.js

@@ -0,0 +1,6 @@
+/**
+ * Sentinel Types
+ *
+ * Type definitions for the Sentinel orb component system.
+ */
+export {};

package/dist/primitives/three/Sentinel/useCameraPermission.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Camera Permission Hook
+ *
+ * Manages camera permission state and video stream lifecycle
+ * for the Sentinel avatar mode.
+ */
+import type { UseCameraPermissionReturn } from './types';
+export declare function useCameraPermission(): UseCameraPermissionReturn;
+//# sourceMappingURL=useCameraPermission.d.ts.map

package/dist/primitives/three/Sentinel/useCameraPermission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCameraPermission.d.ts","sourceRoot":"","sources":["../../../../src/primitives/three/Sentinel/useCameraPermission.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAOzD,wBAAgB,mBAAmB,IAAI,yBAAyB,CAwI/D"}

package/dist/primitives/three/Sentinel/useCameraPermission.js

@@ -0,0 +1,138 @@
+/**
+ * Camera Permission Hook
+ *
+ * Manages camera permission state and video stream lifecycle
+ * for the Sentinel avatar mode.
+ */
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { useSentinelStore } from './sentinelStore';
+// -----------------------------------------------------------------------------
+// Hook Implementation
+// -----------------------------------------------------------------------------
+export function useCameraPermission() {
+    const [stream, setStream] = useState(null);
+    const [error, setError] = useState(null);
+    const streamRef = useRef(null);
+    const permission = useSentinelStore((state) => state.cameraPermission);
+    const setCameraPermission = useSentinelStore((state) => state.setCameraPermission);
+    // ---------------------------------------------------------------------------
+    // Check initial permission state
+    // ---------------------------------------------------------------------------
+    useEffect(() => {
+        const checkPermission = async () => {
+            // Check if permissions API is supported
+            if (typeof navigator === 'undefined' || !navigator.permissions?.query) {
+                return;
+            }
+            try {
+                const result = await navigator.permissions.query({ name: 'camera' });
+                // Map permission state
+                const mapState = (state) => {
+                    switch (state) {
+                        case 'granted':
+                            return 'granted';
+                        case 'denied':
+                            return 'denied';
+                        default:
+                            return 'prompt';
+                    }
+                };
+                setCameraPermission(mapState(result.state));
+                // Listen for permission changes
+                result.addEventListener('change', () => {
+                    setCameraPermission(mapState(result.state));
+                });
+            }
+            catch {
+                // Permission query not supported for camera in some browsers
+                // Fall back to prompt state
+            }
+        };
+        checkPermission();
+    }, [setCameraPermission]);
+    // ---------------------------------------------------------------------------
+    // Stop stream helper
+    // ---------------------------------------------------------------------------
+    const stopStream = useCallback(() => {
+        if (streamRef.current) {
+            streamRef.current.getTracks().forEach((track) => {
+                track.stop();
+            });
+            streamRef.current = null;
+            setStream(null);
+        }
+    }, []);
+    // ---------------------------------------------------------------------------
+    // Request permission and get stream
+    // ---------------------------------------------------------------------------
+    const requestPermission = useCallback(async () => {
+        setError(null);
+        // Check if getUserMedia is supported
+        if (typeof navigator === 'undefined' || !navigator.mediaDevices?.getUserMedia) {
+            const errorMessage = 'Camera access is not supported in this browser';
+            setError(errorMessage);
+            setCameraPermission('denied');
+            return false;
+        }
+        try {
+            // Stop any existing stream first
+            stopStream();
+            const mediaStream = await navigator.mediaDevices.getUserMedia({
+                video: true,
+                audio: false,
+            });
+            streamRef.current = mediaStream;
+            setStream(mediaStream);
+            setCameraPermission('granted');
+            return true;
+        }
+        catch (err) {
+            const error = err;
+            // Handle specific error types
+            if (error.name === 'NotAllowedError' || error.name === 'PermissionDeniedError') {
+                setError('Camera permission was denied');
+                setCameraPermission('denied');
+            }
+            else if (error.name === 'NotFoundError' || error.name === 'DevicesNotFoundError') {
+                setError('No camera device found');
+                setCameraPermission('denied');
+            }
+            else if (error.name === 'NotReadableError' || error.name === 'TrackStartError') {
+                setError('Camera is already in use by another application');
+                setCameraPermission('denied');
+            }
+            else if (error.name === 'OverconstrainedError') {
+                setError('Camera does not meet the required constraints');
+                setCameraPermission('denied');
+            }
+            else if (error.name === 'AbortError') {
+                setError('Camera access was aborted');
+                setCameraPermission('denied');
+            }
+            else {
+                setError(error.message || 'Failed to access camera');
+                setCameraPermission('denied');
+            }
+            return false;
+        }
+    }, [setCameraPermission, stopStream]);
+    // ---------------------------------------------------------------------------
+    // Cleanup on unmount
+    // ---------------------------------------------------------------------------
+    useEffect(() => {
+        return () => {
+            if (streamRef.current) {
+                streamRef.current.getTracks().forEach((track) => {
+                    track.stop();
+                });
+            }
+        };
+    }, []);
+    return {
+        permission,
+        stream,
+        error,
+        requestPermission,
+        stopStream,
+    };
+}

package/dist/primitives/three/Sentinel/useThrowPhysics.d.ts

@@ -0,0 +1,9 @@
+/**
+ * useThrowPhysics Hook
+ *
+ * Provides physics simulation for throwing the Sentinel orb
+ * and calculating edge docking positions.
+ */
+import type { ThrowPhysicsOptions, ThrowPhysicsReturn } from './types';
+export declare function useThrowPhysics(options: ThrowPhysicsOptions): ThrowPhysicsReturn;
+//# sourceMappingURL=useThrowPhysics.d.ts.map

package/dist/primitives/three/Sentinel/useThrowPhysics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThrowPhysics.d.ts","sourceRoot":"","sources":["../../../../src/primitives/three/Sentinel/useThrowPhysics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAQ,MAAM,SAAS,CAAC;AAgB7E,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAkMhF"}