@mikesaintsg/core 0.0.5 → 0.0.6

package/dist/index.d.ts

@@ -3,6 +3,16 @@ export declare interface AbortableOptions {
     readonly signal?: AbortSignal;
 }
 
+/** Activity metrics for a session */
+export declare interface ActivityMetrics {
+    readonly activeTimeMs: number;
+    readonly idleTimeMs: number;
+    readonly awayTimeMs: number;
+    readonly interactionCount: number;
+    readonly lastInteractionAt: number;
+    readonly sessionStartedAt: number;
+}
+
 /**
  * Activity tracker adapter interface.
  *
@@ -16,6 +26,12 @@ export declare interface ActivityTrackerInterface extends ActivityTrackerSubscri
     exitNode(): DwellRecord | undefined;
     /** Get current engagement state */
     getEngagementState(): EngagementState;
+    /** Get current visibility state */
+    getVisibilityState(): VisibilityState;
+    /** Get current focus state */
+    getFocusState(): FocusState;
+    /** Get activity metrics summary */
+    getMetrics(): ActivityMetrics;
     /** Get current node ID being tracked */
     getCurrentNodeId(): string | undefined;
     /** Get current incomplete dwell record */
@@ -26,6 +42,10 @@ export declare interface ActivityTrackerInterface extends ActivityTrackerSubscri
     getTotalActiveTime(): number;
     /** Get total idle time across all dwells */
     getTotalIdleTime(): number;
+    /** Record an interaction (resets idle timer) */
+    recordInteraction(): void;
+    /** Reset all tracking state */
+    reset(): void;
     /** Clear dwell history */
     clearHistory(): void;
 }
@@ -44,6 +64,12 @@ export declare interface ActivityTrackerOptions extends SubscriptionToHook<Activ
 export declare interface ActivityTrackerSubscriptions {
     /** Subscribe to engagement state changes */
     onEngagementChange(callback: (state: EngagementState, nodeId: string) => void): Unsubscribe;
+    /** Subscribe to visibility state changes */
+    onVisibilityChange(callback: (state: VisibilityState) => void): Unsubscribe;
+    /** Subscribe to focus state changes */
+    onFocusChange(callback: (state: FocusState) => void): Unsubscribe;
+    /** Subscribe to idle warnings before state changes to away */
+    onIdleWarning(callback: (idleTimeMs: number) => void): Unsubscribe;
     /** Subscribe to completed dwell records */
     onDwellComplete(callback: (record: DwellRecord) => void): Unsubscribe;
 }
@@ -284,6 +310,9 @@ export declare interface Destroyable {
     destroy(): void;
 }
 
+/** Detected intent from user input */
+export declare type DetectedIntent = 'search' | 'question' | 'action' | 'navigation' | 'unclear';
+
 /** Dwell record capturing time spent on a node */
 export declare interface DwellRecord {
     readonly nodeId: string;
@@ -466,6 +495,9 @@ export declare interface ExportedWeight {
 /** Generation finish reason */
 export declare type FinishReason = 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'error';
 
+/** Focus state for activity tracking */
+export declare type FocusState = 'focused' | 'blurred';
+
 /** Default form dirty guard message */
 export declare const FORM_DIRTY_DEFAULT_MESSAGE = "You have unsaved changes. Are you sure you want to leave?";
 
@@ -567,6 +599,22 @@ export declare interface GenerationResult {
     readonly aborted: boolean;
 }
 
+/** Intent detection result */
+export declare interface IntentDetectionResult {
+    readonly original: string;
+    readonly intent: DetectedIntent;
+    readonly confidence: number;
+    readonly refinedPrompt: string;
+    readonly processingTimeMs: number;
+    readonly modelTier: ModelTier;
+}
+
+/** Intent detector interface */
+export declare interface IntentDetectorInterface {
+    detect(input: string, options?: AbortableOptions): Promise<IntentDetectionResult>;
+    refine(input: string, intent: DetectedIntent, options?: AbortableOptions): Promise<string>;
+}
+
 /**
  * Type guard for ecosystem errors.
  *
@@ -750,6 +798,46 @@ export declare interface MinimalStoreAccess<T> {
     clear(): Promise<void>;
 }
 
+/** Model info for orchestration */
+export declare interface ModelInfo {
+    readonly tier: ModelTier;
+    readonly modelId: string;
+    readonly state: ModelLoadingState;
+    readonly loadProgress?: number;
+    readonly sizeBytes?: number;
+    readonly loadedAt?: number;
+}
+
+/** Model loading state */
+export declare type ModelLoadingState = 'idle' | 'loading' | 'ready' | 'error';
+
+/** Model orchestrator interface */
+export declare interface ModelOrchestratorInterface extends ModelOrchestratorSubscriptions, Destroyable {
+    getModelInfo(tier: ModelTier): ModelInfo | undefined;
+    isReady(tier: ModelTier): boolean;
+    getReadyTiers(): readonly ModelTier[];
+    getActiveTier(): ModelTier | undefined;
+    getBestAvailableTier(): ModelTier | undefined;
+    preload(tier: ModelTier): Promise<void>;
+    preloadAll(): Promise<void>;
+    estimateComplexity(prompt: string): number;
+    selectTier(complexity: number): ModelTier;
+    generate(prompt: string, options?: OrchestratorGenerateOptions): Promise<OrchestratorGenerateResult>;
+}
+
+/** Model orchestrator subscriptions */
+export declare interface ModelOrchestratorSubscriptions {
+    onModelStateChange(callback: (tier: ModelTier, state: ModelLoadingState) => void): Unsubscribe;
+    onModelSwitch(callback: (from: ModelTier, to: ModelTier, reason: string) => void): Unsubscribe;
+    onLoadProgress(callback: (tier: ModelTier, progress: number) => void): Unsubscribe;
+}
+
+/** Model selection strategy */
+export declare type ModelSelectionStrategy = 'auto' | 'local-only' | 'api-only' | 'local-first';
+
+/** Model tier for progressive loading */
+export declare type ModelTier = 'fast' | 'balanced' | 'powerful';
+
 /**
  * Navigation guard function type.
  * Returns true to allow navigation, false to block.
@@ -777,6 +865,27 @@ export declare interface Ok<T> {
  */
 export declare function ok<T>(value: T): Ok<T>;
 
+/** Model orchestrator generate options */
+export declare interface OrchestratorGenerateOptions extends AbortableOptions {
+    readonly forceTier?: ModelTier;
+    readonly system?: string;
+    readonly tools?: readonly ToolSchema[];
+    readonly maxTokens?: number;
+    readonly temperature?: number;
+}
+
+/** Model orchestrator generate result */
+export declare interface OrchestratorGenerateResult {
+    readonly text: string;
+    readonly tier: ModelTier;
+    readonly modelId: string;
+    readonly latencyMs: number;
+    readonly tokenCount?: number;
+    readonly toolCalls?: readonly ToolCall[];
+    readonly escalated?: boolean;
+    readonly escalationReason?: string;
+}
+
 /**
  * Generic error data interface for package-specific errors.
  * Packages extend this to define their error structure.
@@ -1488,6 +1597,9 @@ export declare interface VectorStoreSearchOptions<TMetadata = unknown> {
     readonly filter?: TMetadata;
 }
 
+/** Visibility state for activity tracking */
+export declare type VisibilityState = 'visible' | 'hidden' | 'prerender';
+
 /**
  * Weight persistence adapter interface.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mikesaintsg/core",
-	"version": "0.0.5",
+	"version": "0.0.6",
 	"type": "module",
 	"description": "Shared types, contracts, and bridge functions for the @mikesaintsg ecosystem. Zero runtime dependencies.",
 	"keywords": [