@backbay/glia 0.2.0-alpha.1

package/dist/audio/schema.d.ts.map

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

package/dist/audio/schema.js

@@ -0,0 +1,116 @@
+/**
+ * Zod schemas for audio proof validation.
+ *
+ * This is the runtime counterpart of `docs/schemas/audio-proof.schema.json`.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Enums
+// =============================================================================
+export const AudioProofVersionSchema = z.enum(['1.0']);
+export const AudioFormatSchema = z.enum(['wav', 'pcm_s16le', 'opus', 'mp3', 'flac']);
+export const VoiceLicenseCategorySchema = z.enum(['cc0', 'cc-by', 'cc-by-nc', 'custom', 'unknown']);
+// =============================================================================
+// Nested Schemas
+// =============================================================================
+export const AvoSchema = z.object({
+    valence: z.number().min(0).max(1),
+    arousal: z.number().min(0).max(1),
+    openness: z.number().min(0).max(1),
+});
+export const AudioArtifactSchema = z.object({
+    id: z.string().min(1),
+    uri: z.string().optional(),
+    format: AudioFormatSchema,
+    sha256: z.string().min(32),
+    sampleRateHz: z.number().int().min(8000).optional(),
+    channels: z.number().int().min(1).max(8).optional(),
+    durationMs: z.number().int().min(1),
+});
+export const AudioGateResultSchema = z.object({
+    passed: z.boolean(),
+    metrics: z.record(z.string(), z.unknown()).optional(),
+    reason: z.string().optional(),
+});
+export const AudioGatesSchema = z.object({
+    quality: AudioGateResultSchema,
+    semantic: AudioGateResultSchema,
+    affect: AudioGateResultSchema,
+    multimodalConsistency: AudioGateResultSchema.optional(),
+    watermark: AudioGateResultSchema.optional(),
+    speakerConsistency: AudioGateResultSchema.optional(),
+    antiSpoof: AudioGateResultSchema.optional(),
+    mos: AudioGateResultSchema.optional(),
+    safetyText: AudioGateResultSchema.optional(),
+    safetyAudio: AudioGateResultSchema.optional(),
+});
+export const EvidenceRefSchema = z.object({
+    type: z.enum(['run', 'run_receipt', 'artifact', 'ui']),
+    runId: z.string().optional(),
+    receiptHash: z.string().optional(),
+    path: z.string().optional(),
+    digest: z.string().optional(),
+    componentId: z.string().optional(),
+    note: z.string().optional(),
+});
+// =============================================================================
+// Main Schema
+// =============================================================================
+export const AudioProofSchema = z.object({
+    version: AudioProofVersionSchema,
+    createdAt: z.string().datetime(),
+    manifest: z.object({
+        traceId: z.string().optional(),
+        runId: z.string().optional(),
+        text: z.string().min(1),
+        language: z.string().optional(),
+        targetAffect: AvoSchema,
+        policy: z.object({
+            safetyMode: z.boolean(),
+            trustTier: z.string().optional(),
+            voiceCloningAllowed: z.boolean(),
+        }),
+        cognitionSnapshot: z.record(z.string(), z.unknown()).optional(),
+    }),
+    proof: z.object({
+        synthesis: z.object({
+            providerId: z.string().min(1),
+            model: z.object({
+                id: z.string().min(1),
+                revision: z.string().optional(),
+                sha256: z.string().optional(),
+            }),
+            voice: z.object({
+                voiceId: z.string().min(1),
+                licenseCategory: VoiceLicenseCategorySchema,
+                licenseText: z.string().optional(),
+                source: z.string().optional(),
+            }),
+            controls: z.record(z.string(), z.unknown()).optional(),
+            seed: z.number().int().min(0).optional(),
+        }),
+        attempts: z
+            .array(z.object({
+            attempt: z.number().int().min(1),
+            artifactRef: z.string().min(1),
+            notes: z.string().optional(),
+            gates: AudioGatesSchema,
+        }))
+            .optional(),
+        artifacts: z.array(AudioArtifactSchema).min(1),
+        gates: AudioGatesSchema,
+        evidence: z.array(EvidenceRefSchema).optional(),
+    }),
+    verdict: z.object({
+        passed: z.boolean(),
+        reason: z.string().optional(),
+        score: z.number().optional(),
+    }),
+});
+export function validateAudioProof(audioProof) {
+    const result = AudioProofSchema.safeParse(audioProof);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return { success: false, errors: result.error };
+}

package/dist/audio/types.d.ts

@@ -0,0 +1,175 @@
+import type { AVO } from '../emotion/types.js';
+export type AudioFormat = 'wav' | 'pcm_s16le' | 'opus' | 'mp3' | 'flac';
+export type VoiceLicenseCategory = 'cc0' | 'cc-by' | 'cc-by-nc' | 'custom' | 'unknown';
+export declare const DEFAULT_TARGET_AVO: AVO;
+export interface VoiceCatalogEntry {
+    voiceId: string;
+    displayName?: string;
+    language?: string;
+    tags?: string[];
+    licenseCategory: VoiceLicenseCategory;
+    licenseText?: string;
+    source?: string;
+}
+export interface VoiceCatalog {
+    get: (voiceId: string) => VoiceCatalogEntry | null;
+    list: () => VoiceCatalogEntry[];
+}
+export interface AudioPolicy {
+    safetyMode: boolean;
+    trustTier?: string;
+    voiceCloningAllowed: boolean;
+    /**
+     * If true, callers should avoid playing unverified audio.
+     * Typically derived from trust tier and safety mode.
+     */
+    requireProofBeforePlayback?: boolean;
+    /**
+     * Optional allowlist; if set, speech plans must use one of these voice IDs.
+     */
+    allowedVoiceIds?: string[];
+}
+export type AudioPlannerMode = 'idle' | 'listening' | 'deliberating' | 'acting' | 'explaining' | 'recovering' | 'blocked';
+export interface SpeechControls {
+    /**
+     * Expressiveness/diversity knob, when supported by the backend.
+     * Recommended range: 0..1 (provider may map differently).
+     */
+    temperature?: number;
+    /**
+     * Decode quality / steps knob, when supported by the backend.
+     */
+    quality?: number;
+    /**
+     * Free-form provider-specific controls.
+     */
+    [key: string]: unknown;
+}
+export interface SpeechSynthesisRequest {
+    traceId: string;
+    runId?: string;
+    text: string;
+    language?: string;
+    voiceId: string;
+    targetAffect: AVO;
+    controls?: SpeechControls;
+    /**
+     * Optional client policy context. Including this enables the server to emit a more accurate
+     * `AudioProof.manifest.policy` without having to guess.
+     */
+    policy?: {
+        safetyMode: boolean;
+        trustTier?: string;
+        voiceCloningAllowed: boolean;
+    };
+}
+export interface AudioArtifact {
+    id: string;
+    uri?: string;
+    format: AudioFormat;
+    sha256: string;
+    durationMs: number;
+    sampleRateHz?: number;
+    channels?: number;
+}
+export interface SpeechSynthesisResult {
+    audio: Blob;
+    artifact: AudioArtifact;
+    proof?: AudioProof;
+}
+export interface SpeechSynthesisProvider {
+    providerId: string;
+    synthesizeSpeech: (request: SpeechSynthesisRequest, options?: {
+        signal?: AbortSignal;
+    }) => Promise<SpeechSynthesisResult>;
+}
+export interface AudioVerifier {
+    verifierId: string;
+    verifySpeech: (args: {
+        request: SpeechSynthesisRequest;
+        result: SpeechSynthesisResult;
+        policy: AudioPolicy;
+    }) => Promise<AudioProof>;
+}
+export interface AudioGateResult {
+    passed: boolean;
+    metrics?: Record<string, unknown>;
+    reason?: string;
+}
+export interface AudioGates {
+    quality: AudioGateResult;
+    semantic: AudioGateResult;
+    affect: AudioGateResult;
+    multimodalConsistency?: AudioGateResult;
+    watermark?: AudioGateResult;
+    speakerConsistency?: AudioGateResult;
+    antiSpoof?: AudioGateResult;
+    mos?: AudioGateResult;
+    safetyText?: AudioGateResult;
+    safetyAudio?: AudioGateResult;
+}
+export interface EvidenceRef {
+    type: 'run' | 'run_receipt' | 'artifact' | 'ui';
+    runId?: string;
+    receiptHash?: string;
+    path?: string;
+    digest?: string;
+    componentId?: string;
+    note?: string;
+}
+export interface AudioProof {
+    version: '1.0';
+    createdAt: string;
+    manifest: {
+        traceId?: string;
+        runId?: string;
+        text: string;
+        language?: string;
+        targetAffect: AVO;
+        policy: {
+            safetyMode: boolean;
+            trustTier?: string;
+            voiceCloningAllowed: boolean;
+        };
+        cognitionSnapshot?: {
+            snapshotVersion?: string;
+            snapshotId?: string;
+            [key: string]: unknown;
+        };
+    };
+    proof: {
+        synthesis: {
+            providerId: string;
+            model: {
+                id: string;
+                revision?: string;
+                sha256?: string;
+            };
+            voice: {
+                voiceId: string;
+                licenseCategory: VoiceLicenseCategory;
+                licenseText?: string;
+                source?: string;
+            };
+            controls?: SpeechControls;
+            seed?: number;
+        };
+        attempts?: Array<{
+            attempt: number;
+            artifactRef: string;
+            notes?: string;
+            gates: AudioGates;
+        }>;
+        artifacts: AudioArtifact[];
+        gates: AudioGates;
+        evidence?: EvidenceRef[];
+    };
+    verdict: {
+        passed: boolean;
+        reason?: string;
+        score?: number;
+    };
+}
+export declare function clamp01(value: number): number;
+export declare function createTraceId(): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/audio/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/audio/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAM/C,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAExE,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvF,eAAO,MAAM,kBAAkB,EAAE,GAKhC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,oBAAoB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,iBAAiB,GAAG,IAAI,CAAC;IACnD,IAAI,EAAE,MAAM,iBAAiB,EAAE,CAAC;CACjC;AAMD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAMD,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,WAAW,GACX,cAAc,GACd,QAAQ,GACR,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;;OAGG;IACH,MAAM,CAAC,EAAE;QACP,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,mBAAmB,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,CAChB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAC/B,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE;QACnB,OAAO,EAAE,sBAAsB,CAAC;QAChC,MAAM,EAAE,qBAAqB,CAAC;QAC9B,MAAM,EAAE,WAAW,CAAC;KACrB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3B;AAMD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IAExB,qBAAqB,CAAC,EAAE,eAAe,CAAC;IACxC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,GAAG,aAAa,GAAG,UAAU,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,GAAG,CAAC;QAClB,MAAM,EAAE;YACN,UAAU,EAAE,OAAO,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,mBAAmB,EAAE,OAAO,CAAC;SAC9B,CAAC;QACF,iBAAiB,CAAC,EAAE;YAClB,eAAe,CAAC,EAAE,MAAM,CAAC;YACzB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC;KACH,CAAC;IAEF,KAAK,EAAE;QACL,SAAS,EAAE;YACT,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE;gBACL,EAAE,EAAE,MAAM,CAAC;gBACX,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAClB,MAAM,CAAC,EAAE,MAAM,CAAC;aACjB,CAAC;YACF,KAAK,EAAE;gBACL,OAAO,EAAE,MAAM,CAAC;gBAChB,eAAe,EAAE,oBAAoB,CAAC;gBACtC,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,MAAM,CAAC,EAAE,MAAM,CAAC;aACjB,CAAC;YACF,QAAQ,CAAC,EAAE,cAAc,CAAC;YAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;QAEF,QAAQ,CAAC,EAAE,KAAK,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,UAAU,CAAC;SACnB,CAAC,CAAC;QAEH,SAAS,EAAE,aAAa,EAAE,CAAC;QAC3B,KAAK,EAAE,UAAU,CAAC;QAClB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;KAC1B,CAAC;IAEF,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAMD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,aAAa,IAAI,MAAM,CAKtC"}

package/dist/audio/types.js

@@ -0,0 +1,18 @@
+export const DEFAULT_TARGET_AVO = {
+    // Match the emotion system's "idle" anchor for a stable neutral baseline.
+    arousal: 0.25,
+    valence: 0.6,
+    openness: 0.35,
+};
+// =============================================================================
+// Helpers
+// =============================================================================
+export function clamp01(value) {
+    return Math.max(0, Math.min(1, value));
+}
+export function createTraceId() {
+    if (typeof crypto !== 'undefined' && 'randomUUID' in crypto) {
+        return crypto.randomUUID();
+    }
+    return `trace_${Date.now()}_${Math.random().toString(16).slice(2)}`;
+}

package/dist/cognition/controller.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 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
+ */
+import type { AVO, AnchorState } from '../emotion/types.js';
+import type { CognitionState, CognitionEvent, CognitiveMode } from './types.js';
+/**
+ * Maps cognitive modes to emotion anchor states for visual representation
+ */
+export declare const MODE_TO_ANCHOR: Record<CognitiveMode, AnchorState>;
+/**
+ * Default AVO values for each cognitive mode
+ * These are the target emotional states for each mode
+ */
+export declare const MODE_TO_AVO: Record<CognitiveMode, AVO>;
+type EventHandler<T> = (data: T) => void;
+export interface CognitionControllerEvents {
+    /** Emitted when any state change occurs */
+    change: CognitionState;
+    /** Emitted when mode changes */
+    modeChange: {
+        from: CognitiveMode;
+        to: CognitiveMode;
+    };
+}
+export interface CognitionControllerOptions {
+    /** Initial state overrides */
+    initial?: Partial<CognitionState>;
+}
+export 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.
+ */
+export 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;
+}
+export {};
+//# sourceMappingURL=controller.d.ts.map

package/dist/cognition/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/cognition/controller.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAQpB;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,CAQ7D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,GAAG,CAQlD,CAAC;AAMF,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEzC,MAAM,WAAW,yBAAyB;IACxC,2CAA2C;IAC3C,MAAM,EAAE,cAAc,CAAC;IACvB,gCAAgC;IAChC,UAAU,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,EAAE,EAAE,aAAa,CAAA;KAAE,CAAC;CACxD;AAED,MAAM,WAAW,0BAA0B;IACzC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,MAAM,EAAE,WAAW,CAAC;IACpB,gDAAgD;IAChD,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAA+E;IACjG,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,GAAE,0BAA+B;IAIpD;;OAEG;IACH,QAAQ,IAAI,cAAc;IAI1B;;;OAGG;IACH,gBAAgB,IAAI,aAAa;IAUjC;;;OAGG;IACH,gBAAgB,IAAI;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE;IAKvD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAaxC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAIjC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAgB3B;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAC1C,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,GAClD,MAAM,IAAI;IAWb;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,UAAU;CAMnB"}

package/dist/cognition/controller.js

@@ -0,0 +1,145 @@
+// packages/bb-ui/src/cognition/controller.ts
+import { createInitialCognitionState } from './types.js';
+import { reduceEvent, reduceDecay } from './reducers.js';
+// =============================================================================
+// Mode Mappings
+// =============================================================================
+/**
+ * Maps cognitive modes to emotion anchor states for visual representation
+ */
+export const MODE_TO_ANCHOR = {
+    idle: 'idle',
+    listening: 'listening',
+    deliberating: 'thinking',
+    acting: 'focused',
+    explaining: 'explaining',
+    recovering: 'recovering',
+    blocked: 'concerned',
+};
+/**
+ * Default AVO values for each cognitive mode
+ * These are the target emotional states for each mode
+ */
+export const MODE_TO_AVO = {
+    idle: { arousal: 0.25, valence: 0.60, openness: 0.35 },
+    listening: { arousal: 0.45, valence: 0.70, openness: 0.05 },
+    deliberating: { arousal: 0.60, valence: 0.60, openness: 0.40 },
+    acting: { arousal: 0.70, valence: 0.70, openness: 0.50 },
+    explaining: { arousal: 0.55, valence: 0.80, openness: 0.85 },
+    recovering: { arousal: 0.40, valence: 0.45, openness: 0.40 },
+    blocked: { arousal: 0.55, valence: 0.30, openness: 0.30 },
+};
+/**
+ * CognitionController manages the cognitive state lifecycle for the Glyph character.
+ */
+export class CognitionController {
+    _state;
+    _listeners = new Map();
+    _disposed = false;
+    constructor(options = {}) {
+        this._state = createInitialCognitionState(options.initial);
+    }
+    /**
+     * Get current cognition state
+     */
+    getState() {
+        return { ...this._state };
+    }
+    /**
+     * Get the emotion target for the current cognitive state
+     * Returns anchor state and AVO values adjusted by signals
+     */
+    getEmotionTarget() {
+        const anchor = MODE_TO_ANCHOR[this._state.mode];
+        const baseAVO = MODE_TO_AVO[this._state.mode];
+        // Adjust AVO based on signals
+        const avo = this._adjustAVOBySignals(baseAVO);
+        return { anchor, avo };
+    }
+    /**
+     * Get emotion bridge - derives anchor and AVO from cognitive state
+     * @deprecated Use getEmotionTarget() instead
+     */
+    getEmotionBridge() {
+        const target = this.getEmotionTarget();
+        return { anchor: target.anchor, avo: target.avo };
+    }
+    /**
+     * Handle a cognition event and update state
+     */
+    handleEvent(event) {
+        if (this._disposed)
+            return;
+        const prevMode = this._state.mode;
+        this._state = reduceEvent(this._state, event);
+        if (this._state.mode !== prevMode) {
+            this._emitEvent('modeChange', { from: prevMode, to: this._state.mode });
+        }
+        this._emitEvent('change', this._state);
+    }
+    /**
+     * Process an event and update state
+     * @deprecated Use handleEvent() instead
+     */
+    emit(event) {
+        this.handleEvent(event);
+    }
+    /**
+     * Update tick - call each frame with delta time in milliseconds
+     * Applies time-based decay to stress signals
+     */
+    tick(deltaMs) {
+        if (this._disposed)
+            return;
+        const prevState = this._state;
+        this._state = reduceDecay(this._state, deltaMs);
+        // Only emit change if state actually changed
+        if (prevState.errorStress !== this._state.errorStress ||
+            prevState.timePressure !== this._state.timePressure ||
+            prevState.planDrift !== this._state.planDrift) {
+            this._emitEvent('change', this._state);
+        }
+    }
+    /**
+     * Subscribe to controller events
+     * Returns unsubscribe function
+     */
+    on(event, handler) {
+        if (!this._listeners.has(event)) {
+            this._listeners.set(event, new Set());
+        }
+        this._listeners.get(event).add(handler);
+        return () => {
+            this._listeners.get(event)?.delete(handler);
+        };
+    }
+    /**
+     * Dispose controller and clean up resources
+     */
+    dispose() {
+        this._disposed = true;
+        this._listeners.clear();
+    }
+    /**
+     * Adjust AVO values based on current signal levels
+     */
+    _adjustAVOBySignals(baseAVO) {
+        const { errorStress, workload, timePressure, uncertainty, confidence, personaDriftRisk } = this._state;
+        // Arousal increases with workload, time pressure, and error stress
+        const arousalBoost = (workload * 0.2) + (timePressure * 0.15) + (errorStress * 0.1);
+        // Valence decreases with error stress and uncertainty
+        const valenceDrops = (errorStress * 0.3) + (uncertainty * 0.15);
+        const valenceBoost = (confidence - 0.5) * 0.2; // Confidence above 0.5 boosts valence
+        // Openness decreases with persona drift risk (more grounded when drift risk is high)
+        // Per spec section 7.6: high drift risk should reduce openness to signal groundedness
+        const opennessDrop = personaDriftRisk * 0.3;
+        return {
+            arousal: Math.max(0, Math.min(1, baseAVO.arousal + arousalBoost)),
+            valence: Math.max(0, Math.min(1, baseAVO.valence - valenceDrops + valenceBoost)),
+            openness: Math.max(0, Math.min(1, baseAVO.openness - opennessDrop)),
+        };
+    }
+    _emitEvent(event, data) {
+        this._listeners.get(event)?.forEach((handler) => handler(data));
+    }
+}

package/dist/cognition/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useCognition } from './useCognition.js';
+export type { UseCognitionOptions, UseCognitionResult } from './useCognition.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cognition/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cognition/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cognition/hooks/index.js

@@ -0,0 +1 @@
+export { useCognition } from './useCognition.js';

package/dist/cognition/hooks/useCognition.d.ts

@@ -0,0 +1,36 @@
+import type { CognitionState, CognitionEvent } from '../types.js';
+import { type CognitionControllerOptions, type EmotionTarget } from '../controller.js';
+export interface UseCognitionOptions extends CognitionControllerOptions {
+    onChange?: (state: CognitionState) => void;
+    autoTick?: boolean;
+}
+export 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);
+ * ```
+ */
+export declare function useCognition(options?: UseCognitionOptions): UseCognitionResult;
+//# sourceMappingURL=useCognition.d.ts.map

package/dist/cognition/hooks/useCognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCognition.d.ts","sourceRoot":"","sources":["../../../src/cognition/hooks/useCognition.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAuB,KAAK,0BAA0B,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE5G,MAAM,WAAW,mBAAoB,SAAQ,0BAA0B;IACrE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,0CAA0C;IAC1C,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CA0FlF"}