@backbay/glia-agent 0.1.0

package/dist/cognition.d.ts

@@ -0,0 +1,742 @@
+import { d as CognitiveMode, c as CognitionState, C as CognitionEvent } from './types-CRp9rbx0.js';
+export { a as CognitionSignals, b as CognitionSnapshot, e as CognitiveSubmode, D as DetailedBalance, f as DynamicsState, E as EvidenceRef, P as PersonaSignals, g as PersonalityConfig, h as PolicyConfig, T as TrapWarning, j as clamp01, i as createInitialCognitionState } from './types-CRp9rbx0.js';
+import { z } from 'zod';
+import { b as AnchorState, A as AVO } from './types-B0jyNVTH.js';
+
+declare const CognitionStateSchema: z.ZodObject<{
+    mode: z.ZodEnum<["idle", "listening", "deliberating", "acting", "explaining", "recovering", "blocked"]>;
+    submode: z.ZodOptional<z.ZodEnum<["reading", "searching", "verifying", "waiting", "writing", "tool_call"]>>;
+    focusRunId: z.ZodOptional<z.ZodString>;
+    attention: z.ZodNumber;
+    workload: z.ZodNumber;
+    timePressure: z.ZodNumber;
+    planDrift: z.ZodNumber;
+    costPressure: z.ZodNumber;
+    risk: z.ZodNumber;
+    uncertainty: z.ZodNumber;
+    confidence: z.ZodNumber;
+    errorStress: z.ZodNumber;
+    personaAnchor: z.ZodNumber;
+    personaDriftRisk: z.ZodNumber;
+    personaStyle: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dynamics: z.ZodOptional<z.ZodObject<{
+        potentialV: z.ZodOptional<z.ZodNumber>;
+        actionRate: z.ZodOptional<z.ZodNumber>;
+        detailedBalance: z.ZodOptional<z.ZodObject<{
+            chi2PerNdf: z.ZodNumber;
+            passed: z.ZodBoolean;
+            threshold: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            chi2PerNdf: number;
+            passed: boolean;
+            threshold: number;
+        }, {
+            chi2PerNdf: number;
+            passed: boolean;
+            threshold: number;
+        }>>;
+        traps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            stateId: z.ZodString;
+            reason: z.ZodString;
+            recommendation: z.ZodString;
+            severity: z.ZodOptional<z.ZodEnum<["info", "warning", "danger"]>>;
+        }, "strip", z.ZodTypeAny, {
+            stateId: string;
+            reason: string;
+            recommendation: string;
+            severity?: "info" | "warning" | "danger" | undefined;
+        }, {
+            stateId: string;
+            reason: string;
+            recommendation: string;
+            severity?: "info" | "warning" | "danger" | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        potentialV?: number | undefined;
+        actionRate?: number | undefined;
+        detailedBalance?: {
+            chi2PerNdf: number;
+            passed: boolean;
+            threshold: number;
+        } | undefined;
+        traps?: {
+            stateId: string;
+            reason: string;
+            recommendation: string;
+            severity?: "info" | "warning" | "danger" | undefined;
+        }[] | undefined;
+    }, {
+        potentialV?: number | undefined;
+        actionRate?: number | undefined;
+        detailedBalance?: {
+            chi2PerNdf: number;
+            passed: boolean;
+            threshold: number;
+        } | undefined;
+        traps?: {
+            stateId: string;
+            reason: string;
+            recommendation: string;
+            severity?: "info" | "warning" | "danger" | undefined;
+        }[] | undefined;
+    }>>;
+    personality: z.ZodOptional<z.ZodObject<{
+        style: z.ZodEnum<["professional", "casual", "terse", "verbose"]>;
+        riskTolerance: z.ZodEnum<["conservative", "moderate", "aggressive"]>;
+        autonomy: z.ZodEnum<["low", "medium", "high", "full"]>;
+    }, "strip", z.ZodTypeAny, {
+        style: "professional" | "casual" | "terse" | "verbose";
+        riskTolerance: "conservative" | "moderate" | "aggressive";
+        autonomy: "low" | "medium" | "high" | "full";
+    }, {
+        style: "professional" | "casual" | "terse" | "verbose";
+        riskTolerance: "conservative" | "moderate" | "aggressive";
+        autonomy: "low" | "medium" | "high" | "full";
+    }>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        safetyMode: z.ZodBoolean;
+        trustTier: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        safetyMode: boolean;
+        trustTier?: string | undefined;
+    }, {
+        safetyMode: boolean;
+        trustTier?: string | undefined;
+    }>>;
+    moodAVO: z.ZodObject<{
+        arousal: z.ZodNumber;
+        valence: z.ZodNumber;
+        openness: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        arousal: number;
+        valence: number;
+        openness: number;
+    }, {
+        arousal: number;
+        valence: number;
+        openness: number;
+    }>;
+    emotionAVO: z.ZodObject<{
+        arousal: z.ZodNumber;
+        valence: z.ZodNumber;
+        openness: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        arousal: number;
+        valence: number;
+        openness: number;
+    }, {
+        arousal: number;
+        valence: number;
+        openness: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    mode: "idle" | "listening" | "explaining" | "recovering" | "deliberating" | "acting" | "blocked";
+    moodAVO: {
+        arousal: number;
+        valence: number;
+        openness: number;
+    };
+    emotionAVO: {
+        arousal: number;
+        valence: number;
+        openness: number;
+    };
+    attention: number;
+    workload: number;
+    timePressure: number;
+    planDrift: number;
+    costPressure: number;
+    risk: number;
+    uncertainty: number;
+    confidence: number;
+    errorStress: number;
+    personaAnchor: number;
+    personaDriftRisk: number;
+    submode?: "reading" | "searching" | "verifying" | "waiting" | "writing" | "tool_call" | undefined;
+    focusRunId?: string | undefined;
+    dynamics?: {
+        potentialV?: number | undefined;
+        actionRate?: number | undefined;
+        detailedBalance?: {
+            chi2PerNdf: number;
+            passed: boolean;
+            threshold: number;
+        } | undefined;
+        traps?: {
+            stateId: string;
+            reason: string;
+            recommendation: string;
+            severity?: "info" | "warning" | "danger" | undefined;
+        }[] | undefined;
+    } | undefined;
+    personality?: {
+        style: "professional" | "casual" | "terse" | "verbose";
+        riskTolerance: "conservative" | "moderate" | "aggressive";
+        autonomy: "low" | "medium" | "high" | "full";
+    } | undefined;
+    policy?: {
+        safetyMode: boolean;
+        trustTier?: string | undefined;
+    } | undefined;
+    personaStyle?: string[] | undefined;
+}, {
+    mode: "idle" | "listening" | "explaining" | "recovering" | "deliberating" | "acting" | "blocked";
+    moodAVO: {
+        arousal: number;
+        valence: number;
+        openness: number;
+    };
+    emotionAVO: {
+        arousal: number;
+        valence: number;
+        openness: number;
+    };
+    attention: number;
+    workload: number;
+    timePressure: number;
+    planDrift: number;
+    costPressure: number;
+    risk: number;
+    uncertainty: number;
+    confidence: number;
+    errorStress: number;
+    personaAnchor: number;
+    personaDriftRisk: number;
+    submode?: "reading" | "searching" | "verifying" | "waiting" | "writing" | "tool_call" | undefined;
+    focusRunId?: string | undefined;
+    dynamics?: {
+        potentialV?: number | undefined;
+        actionRate?: number | undefined;
+        detailedBalance?: {
+            chi2PerNdf: number;
+            passed: boolean;
+            threshold: number;
+        } | undefined;
+        traps?: {
+            stateId: string;
+            reason: string;
+            recommendation: string;
+            severity?: "info" | "warning" | "danger" | undefined;
+        }[] | undefined;
+    } | undefined;
+    personality?: {
+        style: "professional" | "casual" | "terse" | "verbose";
+        riskTolerance: "conservative" | "moderate" | "aggressive";
+        autonomy: "low" | "medium" | "high" | "full";
+    } | undefined;
+    policy?: {
+        safetyMode: boolean;
+        trustTier?: string | undefined;
+    } | undefined;
+    personaStyle?: string[] | undefined;
+}>;
+declare const CognitionSnapshotSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    timestamp: z.ZodNumber;
+    state: z.ZodObject<{
+        mode: z.ZodEnum<["idle", "listening", "deliberating", "acting", "explaining", "recovering", "blocked"]>;
+        submode: z.ZodOptional<z.ZodEnum<["reading", "searching", "verifying", "waiting", "writing", "tool_call"]>>;
+        focusRunId: z.ZodOptional<z.ZodString>;
+        attention: z.ZodNumber;
+        workload: z.ZodNumber;
+        timePressure: z.ZodNumber;
+        planDrift: z.ZodNumber;
+        costPressure: z.ZodNumber;
+        risk: z.ZodNumber;
+        uncertainty: z.ZodNumber;
+        confidence: z.ZodNumber;
+        errorStress: z.ZodNumber;
+        personaAnchor: z.ZodNumber;
+        personaDriftRisk: z.ZodNumber;
+        personaStyle: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dynamics: z.ZodOptional<z.ZodObject<{
+            potentialV: z.ZodOptional<z.ZodNumber>;
+            actionRate: z.ZodOptional<z.ZodNumber>;
+            detailedBalance: z.ZodOptional<z.ZodObject<{
+                chi2PerNdf: z.ZodNumber;
+                passed: z.ZodBoolean;
+                threshold: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                chi2PerNdf: number;
+                passed: boolean;
+                threshold: number;
+            }, {
+                chi2PerNdf: number;
+                passed: boolean;
+                threshold: number;
+            }>>;
+            traps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                stateId: z.ZodString;
+                reason: z.ZodString;
+                recommendation: z.ZodString;
+                severity: z.ZodOptional<z.ZodEnum<["info", "warning", "danger"]>>;
+            }, "strip", z.ZodTypeAny, {
+                stateId: string;
+                reason: string;
+                recommendation: string;
+                severity?: "info" | "warning" | "danger" | undefined;
+            }, {
+                stateId: string;
+                reason: string;
+                recommendation: string;
+                severity?: "info" | "warning" | "danger" | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            potentialV?: number | undefined;
+            actionRate?: number | undefined;
+            detailedBalance?: {
+                chi2PerNdf: number;
+                passed: boolean;
+                threshold: number;
+            } | undefined;
+            traps?: {
+                stateId: string;
+                reason: string;
+                recommendation: string;
+                severity?: "info" | "warning" | "danger" | undefined;
+            }[] | undefined;
+        }, {
+            potentialV?: number | undefined;
+            actionRate?: number | undefined;
+            detailedBalance?: {
+                chi2PerNdf: number;
+                passed: boolean;
+                threshold: number;
+            } | undefined;
+            traps?: {
+                stateId: string;
+                reason: string;
+                recommendation: string;
+                severity?: "info" | "warning" | "danger" | undefined;
+            }[] | undefined;
+        }>>;
+        personality: z.ZodOptional<z.ZodObject<{
+            style: z.ZodEnum<["professional", "casual", "terse", "verbose"]>;
+            riskTolerance: z.ZodEnum<["conservative", "moderate", "aggressive"]>;
+            autonomy: z.ZodEnum<["low", "medium", "high", "full"]>;
+        }, "strip", z.ZodTypeAny, {
+            style: "professional" | "casual" | "terse" | "verbose";
+            riskTolerance: "conservative" | "moderate" | "aggressive";
+            autonomy: "low" | "medium" | "high" | "full";
+        }, {
+            style: "professional" | "casual" | "terse" | "verbose";
+            riskTolerance: "conservative" | "moderate" | "aggressive";
+            autonomy: "low" | "medium" | "high" | "full";
+        }>>;
+        policy: z.ZodOptional<z.ZodObject<{
+            safetyMode: z.ZodBoolean;
+            trustTier: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            safetyMode: boolean;
+            trustTier?: string | undefined;
+        }, {
+            safetyMode: boolean;
+            trustTier?: string | undefined;
+        }>>;
+        moodAVO: z.ZodObject<{
+            arousal: z.ZodNumber;
+            valence: z.ZodNumber;
+            openness: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            arousal: number;
+            valence: number;
+            openness: number;
+        }, {
+            arousal: number;
+            valence: number;
+            openness: number;
+        }>;
+        emotionAVO: z.ZodObject<{
+            arousal: z.ZodNumber;
+            valence: z.ZodNumber;
+            openness: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            arousal: number;
+            valence: number;
+            openness: number;
+        }, {
+            arousal: number;
+            valence: number;
+            openness: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "idle" | "listening" | "explaining" | "recovering" | "deliberating" | "acting" | "blocked";
+        moodAVO: {
+            arousal: number;
+            valence: number;
+            openness: number;
+        };
+        emotionAVO: {
+            arousal: number;
+            valence: number;
+            openness: number;
+        };
+        attention: number;
+        workload: number;
+        timePressure: number;
+        planDrift: number;
+        costPressure: number;
+        risk: number;
+        uncertainty: number;
+        confidence: number;
+        errorStress: number;
+        personaAnchor: number;
+        personaDriftRisk: number;
+        submode?: "reading" | "searching" | "verifying" | "waiting" | "writing" | "tool_call" | undefined;
+        focusRunId?: string | undefined;
+        dynamics?: {
+            potentialV?: number | undefined;
+            actionRate?: number | undefined;
+            detailedBalance?: {
+                chi2PerNdf: number;
+                passed: boolean;
+                threshold: number;
+            } | undefined;
+            traps?: {
+                stateId: string;
+                reason: string;
+                recommendation: string;
+                severity?: "info" | "warning" | "danger" | undefined;
+            }[] | undefined;
+        } | undefined;
+        personality?: {
+            style: "professional" | "casual" | "terse" | "verbose";
+            riskTolerance: "conservative" | "moderate" | "aggressive";
+            autonomy: "low" | "medium" | "high" | "full";
+        } | undefined;
+        policy?: {
+            safetyMode: boolean;
+            trustTier?: string | undefined;
+        } | undefined;
+        personaStyle?: string[] | undefined;
+    }, {
+        mode: "idle" | "listening" | "explaining" | "recovering" | "deliberating" | "acting" | "blocked";
+        moodAVO: {
+            arousal: number;
+            valence: number;
+            openness: number;
+        };
+        emotionAVO: {
+            arousal: number;
+            valence: number;
+            openness: number;
+        };
+        attention: number;
+        workload: number;
+        timePressure: number;
+        planDrift: number;
+        costPressure: number;
+        risk: number;
+        uncertainty: number;
+        confidence: number;
+        errorStress: number;
+        personaAnchor: number;
+        personaDriftRisk: number;
+        submode?: "reading" | "searching" | "verifying" | "waiting" | "writing" | "tool_call" | undefined;
+        focusRunId?: string | undefined;
+        dynamics?: {
+            potentialV?: number | undefined;
+            actionRate?: number | undefined;
+            detailedBalance?: {
+                chi2PerNdf: number;
+                passed: boolean;
+                threshold: number;
+            } | undefined;
+            traps?: {
+                stateId: string;
+                reason: string;
+                recommendation: string;
+                severity?: "info" | "warning" | "danger" | undefined;
+            }[] | undefined;
+        } | undefined;
+        personality?: {
+            style: "professional" | "casual" | "terse" | "verbose";
+            riskTolerance: "conservative" | "moderate" | "aggressive";
+            autonomy: "low" | "medium" | "high" | "full";
+        } | undefined;
+        policy?: {
+            safetyMode: boolean;
+            trustTier?: string | undefined;
+        } | undefined;
+        personaStyle?: string[] | undefined;
+    }>;
+    recentEvents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        t: z.ZodNumber;
+        event: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        t: number;
+        event: Record<string, unknown>;
+    }, {
+        t: number;
+        event: Record<string, unknown>;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    state: {
+        mode: "idle" | "listening" | "explaining" | "recovering" | "deliberating" | "acting" | "blocked";
+        moodAVO: {
+            arousal: number;
+            valence: number;
+            openness: number;
+        };
+        emotionAVO: {
+            arousal: number;
+            valence: number;
+            openness: number;
+        };
+        attention: number;
+        workload: number;
+        timePressure: number;
+        planDrift: number;
+        costPressure: number;
+        risk: number;
+        uncertainty: number;
+        confidence: number;
+        errorStress: number;
+        personaAnchor: number;
+        personaDriftRisk: number;
+        submode?: "reading" | "searching" | "verifying" | "waiting" | "writing" | "tool_call" | undefined;
+        focusRunId?: string | undefined;
+        dynamics?: {
+            potentialV?: number | undefined;
+            actionRate?: number | undefined;
+            detailedBalance?: {
+                chi2PerNdf: number;
+                passed: boolean;
+                threshold: number;
+            } | undefined;
+            traps?: {
+                stateId: string;
+                reason: string;
+                recommendation: string;
+                severity?: "info" | "warning" | "danger" | undefined;
+            }[] | undefined;
+        } | undefined;
+        personality?: {
+            style: "professional" | "casual" | "terse" | "verbose";
+            riskTolerance: "conservative" | "moderate" | "aggressive";
+            autonomy: "low" | "medium" | "high" | "full";
+        } | undefined;
+        policy?: {
+            safetyMode: boolean;
+            trustTier?: string | undefined;
+        } | undefined;
+        personaStyle?: string[] | undefined;
+    };
+    version: "1.0";
+    timestamp: number;
+    recentEvents?: {
+        t: number;
+        event: Record<string, unknown>;
+    }[] | undefined;
+}, {
+    state: {
+        mode: "idle" | "listening" | "explaining" | "recovering" | "deliberating" | "acting" | "blocked";
+        moodAVO: {
+            arousal: number;
+            valence: number;
+            openness: number;
+        };
+        emotionAVO: {
+            arousal: number;
+            valence: number;
+            openness: number;
+        };
+        attention: number;
+        workload: number;
+        timePressure: number;
+        planDrift: number;
+        costPressure: number;
+        risk: number;
+        uncertainty: number;
+        confidence: number;
+        errorStress: number;
+        personaAnchor: number;
+        personaDriftRisk: number;
+        submode?: "reading" | "searching" | "verifying" | "waiting" | "writing" | "tool_call" | undefined;
+        focusRunId?: string | undefined;
+        dynamics?: {
+            potentialV?: number | undefined;
+            actionRate?: number | undefined;
+            detailedBalance?: {
+                chi2PerNdf: number;
+                passed: boolean;
+                threshold: number;
+            } | undefined;
+            traps?: {
+                stateId: string;
+                reason: string;
+                recommendation: string;
+                severity?: "info" | "warning" | "danger" | undefined;
+            }[] | undefined;
+        } | undefined;
+        personality?: {
+            style: "professional" | "casual" | "terse" | "verbose";
+            riskTolerance: "conservative" | "moderate" | "aggressive";
+            autonomy: "low" | "medium" | "high" | "full";
+        } | undefined;
+        policy?: {
+            safetyMode: boolean;
+            trustTier?: string | undefined;
+        } | undefined;
+        personaStyle?: string[] | undefined;
+    };
+    version: "1.0";
+    timestamp: number;
+    recentEvents?: {
+        t: number;
+        event: Record<string, unknown>;
+    }[] | undefined;
+}>;
+type CognitionSnapshotInput = z.input<typeof CognitionSnapshotSchema>;
+type CognitionSnapshotOutput = z.output<typeof CognitionSnapshotSchema>;
+interface CognitionSnapshotValidationResult {
+    success: boolean;
+    data?: CognitionSnapshotOutput;
+    error?: z.ZodError;
+}
+declare function validateCognitionSnapshot(input: unknown): CognitionSnapshotValidationResult;
+
+/**
+ * Cognition State Reducers
+ *
+ * Pure functions for updating cognition state based on events and time decay.
+ */
+
+/**
+ * Trigger types that cause mode transitions
+ */
+type CognitionTrigger = 'ui.input_received' | 'ui.user_idle' | 'ui.interrupt' | 'run.started' | 'run.completed' | 'run.event';
+/**
+ * Maps trigger events to resulting cognitive modes
+ */
+declare const MODE_TRANSITION_MAP: Record<CognitionTrigger, CognitiveMode>;
+/**
+ * Apply exponential decay to time-based signals
+ */
+declare function reduceDecay(state: CognitionState, deltaMs: number): CognitionState;
+/**
+ * Main event reducer - handles all cognition events
+ */
+declare function reduceEvent(state: CognitionState, event: CognitionEvent): CognitionState;
+
+/**
+ * CognitionController manages the cognitive state lifecycle for the Glyph character.
+ *
+ * It handles:
+ * - Cognitive mode transitions (idle, listening, deliberating, acting, etc.)
+ * - Continuous signal processing (attention, workload, risk, etc.)
+ * - Event-driven state changes from UI and kernel events
+ * - Emotion bridge (mood and emotion AVO dimensions)
+ * - Time-based decay of stress signals
+ */
+
+type EventHandler<T> = (data: T) => void;
+interface CognitionControllerEvents {
+    /** Emitted when any state change occurs */
+    change: CognitionState;
+    /** Emitted when mode changes */
+    modeChange: {
+        from: CognitiveMode;
+        to: CognitiveMode;
+    };
+}
+interface CognitionControllerOptions {
+    /** Initial state overrides */
+    initial?: Partial<CognitionState>;
+}
+interface EmotionTarget {
+    /** The anchor state name for the current mode */
+    anchor: AnchorState;
+    /** The target AVO values adjusted by signals */
+    avo: AVO;
+}
+/**
+ * CognitionController manages the cognitive state lifecycle for the Glyph character.
+ */
+declare class CognitionController {
+    private _state;
+    private _listeners;
+    private _disposed;
+    constructor(options?: CognitionControllerOptions);
+    /**
+     * Get current cognition state
+     */
+    getState(): CognitionState;
+    /**
+     * Get the emotion target for the current cognitive state
+     * Returns anchor state and AVO values adjusted by signals
+     */
+    getEmotionTarget(): EmotionTarget;
+    /**
+     * Get emotion bridge - derives anchor and AVO from cognitive state
+     * @deprecated Use getEmotionTarget() instead
+     */
+    getEmotionBridge(): {
+        anchor?: AnchorState;
+        avo?: AVO;
+    };
+    /**
+     * Handle a cognition event and update state
+     */
+    handleEvent(event: CognitionEvent): void;
+    /**
+     * Process an event and update state
+     * @deprecated Use handleEvent() instead
+     */
+    emit(event: CognitionEvent): void;
+    /**
+     * Update tick - call each frame with delta time in milliseconds
+     * Applies time-based decay to stress signals
+     */
+    tick(deltaMs: number): void;
+    /**
+     * Subscribe to controller events
+     * Returns unsubscribe function
+     */
+    on<K extends keyof CognitionControllerEvents>(event: K, handler: EventHandler<CognitionControllerEvents[K]>): () => void;
+    /**
+     * Dispose controller and clean up resources
+     */
+    dispose(): void;
+    /**
+     * Adjust AVO values based on current signal levels
+     */
+    private _adjustAVOBySignals;
+    private _emitEvent;
+}
+
+interface UseCognitionOptions extends CognitionControllerOptions {
+    onChange?: (state: CognitionState) => void;
+    autoTick?: boolean;
+}
+interface UseCognitionResult {
+    state: CognitionState;
+    emotion: EmotionTarget;
+    handleEvent: (event: CognitionEvent) => void;
+    tick: (deltaMs: number) => void;
+    /** @deprecated Use handleEvent instead */
+    emit: (event: CognitionEvent) => void;
+}
+/**
+ * React hook for managing Glyph cognition state.
+ *
+ * Creates a CognitionController and provides reactive state updates.
+ * Automatically handles RAF-based animation when autoTick is true (default).
+ *
+ * @example
+ * ```tsx
+ * const { state, emotion, emit, tick } = useCognition({
+ *   initial: { mode: 'idle' },
+ *   onChange: (state) => console.log('Cognition changed:', state),
+ * });
+ *
+ * // Handle agent events
+ * emit({ type: 'run.started', runId: 'r1' });
+ *
+ * // Access emotion bridge for rendering
+ * console.log(emotion.anchor, emotion.avo);
+ * ```
+ */
+declare function useCognition(options?: UseCognitionOptions): UseCognitionResult;
+
+export { CognitionController, type CognitionControllerOptions, CognitionEvent, type CognitionSnapshotInput, type CognitionSnapshotOutput, CognitionSnapshotSchema, type CognitionSnapshotValidationResult, CognitionState, CognitionStateSchema, CognitiveMode, MODE_TRANSITION_MAP, type UseCognitionOptions, type UseCognitionResult, reduceDecay, reduceEvent, useCognition, validateCognitionSnapshot };