driftdetect-cortex 0.9.41

package/dist/types/prediction.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Prediction System Types
+ *
+ * Defines types for predictive memory retrieval that
+ * anticipates what memories will be needed based on:
+ * - Current file context
+ * - Temporal patterns
+ * - User behavior
+ * - Git activity
+ *
+ * @module types/prediction
+ */
+/**
+ * Input signals for prediction
+ *
+ * All the contextual information used to predict
+ * which memories will be relevant.
+ */
+export interface PredictionSignals {
+    /** File-based signals */
+    file: FileSignals;
+    /** Temporal signals */
+    temporal: TemporalSignals;
+    /** Behavioral signals */
+    behavioral: BehavioralSignals;
+    /** Git-based signals */
+    git: GitSignals;
+    /** When signals were gathered */
+    gatheredAt: string;
+}
+/**
+ * File-based prediction signals
+ */
+export interface FileSignals {
+    /** Currently active file */
+    activeFile: string;
+    /** Recently opened files */
+    recentFiles: string[];
+    /** File type/extension */
+    fileType: string;
+    /** Detected patterns in file */
+    filePatterns: string[];
+    /** Imports in the file */
+    fileImports: string[];
+    /** Functions/classes in the file */
+    fileSymbols: string[];
+    /** Directory context */
+    directory: string;
+}
+/**
+ * Temporal prediction signals
+ */
+export interface TemporalSignals {
+    /** Time of day */
+    timeOfDay: 'morning' | 'afternoon' | 'evening' | 'night';
+    /** Day of week */
+    dayOfWeek: string;
+    /** Session duration in minutes */
+    sessionDuration: number;
+    /** Time since last query */
+    timeSinceLastQuery: number;
+    /** Is this a new session? */
+    isNewSession: boolean;
+}
+/**
+ * Behavioral prediction signals
+ */
+export interface BehavioralSignals {
+    /** Recent queries made */
+    recentQueries: string[];
+    /** Recent intents */
+    recentIntents: Intent[];
+    /** Frequently accessed memories */
+    frequentMemories: string[];
+    /** Current task context (if known) */
+    currentTask?: string;
+    /** User's typical patterns */
+    userPatterns: UserPattern[];
+}
+/**
+ * User behavior pattern
+ */
+export interface UserPattern {
+    /** Pattern type */
+    type: 'file_sequence' | 'query_sequence' | 'time_based' | 'task_based';
+    /** Pattern description */
+    description: string;
+    /** Confidence in this pattern */
+    confidence: number;
+    /** Associated memories */
+    associatedMemories: string[];
+}
+/**
+ * Git-based prediction signals
+ */
+export interface GitSignals {
+    /** Current branch */
+    currentBranch: string;
+    /** Recently modified files */
+    recentlyModifiedFiles: string[];
+    /** Recent commit messages */
+    recentCommitMessages: string[];
+    /** Files with uncommitted changes */
+    uncommittedFiles: string[];
+    /** Is this a feature branch? */
+    isFeatureBranch: boolean;
+    /** Related PR/issue (if any) */
+    relatedIssue?: string;
+}
+/**
+ * Intent types for prediction
+ */
+export type Intent = 'add_feature' | 'fix_bug' | 'refactor' | 'add_test' | 'review_code' | 'understand_code' | 'debug' | 'optimize' | 'document' | 'unknown';
+/**
+ * A predicted memory with confidence
+ */
+export interface PredictedMemory {
+    /** Memory ID */
+    memoryId: string;
+    /** Memory type */
+    memoryType: string;
+    /** Memory summary */
+    summary: string;
+    /** Prediction confidence (0.0 - 1.0) */
+    confidence: number;
+    /** Prediction source/reason */
+    source: PredictionSource;
+    /** Relevance score */
+    relevanceScore: number;
+    /** Whether embedding is preloaded */
+    embeddingPreloaded: boolean;
+}
+/**
+ * Source of a prediction
+ */
+export interface PredictionSource {
+    /** Strategy that made this prediction */
+    strategy: PredictionStrategy;
+    /** Specific reason for prediction */
+    reason: string;
+    /** Signals that contributed */
+    contributingSignals: string[];
+    /** Confidence breakdown */
+    confidenceBreakdown: Record<string, number>;
+}
+/**
+ * Prediction strategies
+ */
+export type PredictionStrategy = 'file_based' | 'pattern_based' | 'temporal' | 'behavioral' | 'git_based' | 'co_occurrence' | 'semantic_similarity';
+/**
+ * Full prediction result
+ */
+export interface PredictionResult {
+    /** Predicted memories */
+    predictions: PredictedMemory[];
+    /** Signals used */
+    signals: PredictionSignals;
+    /** Strategies used */
+    strategiesUsed: PredictionStrategy[];
+    /** Total prediction time (ms) */
+    predictionTimeMs: number;
+    /** Cache status */
+    cacheStatus: 'hit' | 'miss' | 'partial';
+    /** When prediction was made */
+    predictedAt: string;
+}
+/**
+ * Prediction configuration
+ */
+export interface PredictionConfig {
+    /** Maximum predictions to return */
+    maxPredictions: number;
+    /** Minimum confidence threshold */
+    minConfidence: number;
+    /** Strategies to use */
+    strategies: PredictionStrategy[];
+    /** Whether to preload embeddings */
+    preloadEmbeddings: boolean;
+    /** Cache TTL in milliseconds */
+    cacheTtlMs: number;
+    /** Whether to use behavioral signals */
+    useBehavioralSignals: boolean;
+    /** Whether to use git signals */
+    useGitSignals: boolean;
+}
+/**
+ * Default prediction configuration
+ */
+export declare const DEFAULT_PREDICTION_CONFIG: PredictionConfig;
+/**
+ * Cached prediction entry
+ */
+export interface CachedPrediction {
+    /** Cache key */
+    key: string;
+    /** Predicted memories */
+    predictions: PredictedMemory[];
+    /** When cached */
+    cachedAt: string;
+    /** Expiration time */
+    expiresAt: string;
+    /** Signals used to generate */
+    signals: PredictionSignals;
+}
+/**
+ * Prediction cache statistics
+ */
+export interface PredictionCacheStats {
+    /** Total cache entries */
+    totalEntries: number;
+    /** Cache hits */
+    hits: number;
+    /** Cache misses */
+    misses: number;
+    /** Hit rate */
+    hitRate: number;
+    /** Average prediction time (ms) */
+    avgPredictionTimeMs: number;
+    /** Embeddings preloaded */
+    embeddingsPreloaded: number;
+}
+/**
+ * Prediction feedback for learning
+ */
+export interface PredictionFeedback {
+    /** Prediction that was made */
+    predictionId: string;
+    /** Memory that was predicted */
+    memoryId: string;
+    /** Whether prediction was used */
+    wasUsed: boolean;
+    /** Whether prediction was helpful */
+    wasHelpful?: boolean;
+    /** Query that followed (if any) */
+    followingQuery?: string;
+    /** When feedback was recorded */
+    recordedAt: string;
+}
+//# sourceMappingURL=prediction.d.ts.map

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

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

package/dist/types/prediction.js

@@ -0,0 +1,25 @@
+/**
+ * Prediction System Types
+ *
+ * Defines types for predictive memory retrieval that
+ * anticipates what memories will be needed based on:
+ * - Current file context
+ * - Temporal patterns
+ * - User behavior
+ * - Git activity
+ *
+ * @module types/prediction
+ */
+/**
+ * Default prediction configuration
+ */
+export const DEFAULT_PREDICTION_CONFIG = {
+    maxPredictions: 20,
+    minConfidence: 0.3,
+    strategies: ['file_based', 'pattern_based', 'temporal', 'behavioral'],
+    preloadEmbeddings: true,
+    cacheTtlMs: 5 * 60 * 1000, // 5 minutes
+    useBehavioralSignals: true,
+    useGitSignals: true,
+};
+//# sourceMappingURL=prediction.js.map

package/dist/types/prediction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prediction.js","sourceRoot":"","sources":["../../src/types/prediction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA4MH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,GAAG;IAClB,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,CAAC;IACrE,iBAAiB,EAAE,IAAI;IACvB,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACvC,oBAAoB,EAAE,IAAI;IAC1B,aAAa,EAAE,IAAI;CACpB,CAAC"}

package/dist/types/procedural-memory.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Procedural Memory Type
+ *
+ * How-to knowledge - step-by-step procedures for common tasks.
+ * Includes trigger phrases for intent matching and checklists
+ * for verification.
+ */
+import type { BaseMemory } from './memory.js';
+/**
+ * A single step in a procedure
+ */
+export interface ProcedureStep {
+    /** Order of this step (1-indexed) */
+    order: number;
+    /** Action to take */
+    action: string;
+    /** Additional details */
+    details?: string;
+    /** Files involved in this step */
+    files?: string[];
+    /** Patterns to follow */
+    patterns?: string[];
+    /** Constraints to respect */
+    constraints?: string[];
+    /** Example code or command */
+    example?: string;
+}
+/**
+ * A checklist item for verification
+ */
+export interface ChecklistItem {
+    /** What to check */
+    item: string;
+    /** Whether this is required */
+    required: boolean;
+    /** Command or pattern to auto-check (optional) */
+    autoCheck?: string;
+}
+/**
+ * A correction made to the procedure
+ */
+export interface ProcedureCorrection {
+    /** When the correction was made */
+    timestamp: string;
+    /** Original step/action */
+    original: string;
+    /** Corrected step/action */
+    corrected: string;
+    /** Why the correction was needed */
+    reason?: string;
+}
+/**
+ * Procedural Memory - How-to knowledge
+ *
+ * Half-life: 180 days
+ *
+ * Examples:
+ * - "How to add a new API endpoint"
+ * - "How to set up a new database migration"
+ * - "How to deploy to staging"
+ */
+export interface ProceduralMemory extends BaseMemory {
+    type: 'procedural';
+    /** Name of the procedure */
+    name: string;
+    /** Description of what this procedure accomplishes */
+    description: string;
+    /** Trigger phrases for intent matching (e.g., ['add endpoint', 'create api', 'new route']) */
+    triggers: string[];
+    /** Steps to follow */
+    steps: ProcedureStep[];
+    /** Verification checklist */
+    checklist?: ChecklistItem[];
+    /** How many times this procedure has been used */
+    usageCount: number;
+    /** When this procedure was last used */
+    lastUsed?: string;
+    /** Success rate (0.0 - 1.0) */
+    successRate?: number;
+    /** Corrections made to this procedure over time */
+    corrections?: ProcedureCorrection[];
+}
+//# sourceMappingURL=procedural-memory.d.ts.map

package/dist/types/procedural-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedural-memory.d.ts","sourceRoot":"","sources":["../../src/types/procedural-memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,YAAY,CAAC;IAEnB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,sBAAsB;IACtB,KAAK,EAAE,aAAa,EAAE,CAAC;IAEvB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAE5B,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC"}

package/dist/types/procedural-memory.js

@@ -0,0 +1,9 @@
+/**
+ * Procedural Memory Type
+ *
+ * How-to knowledge - step-by-step procedures for common tasks.
+ * Includes trigger phrases for intent matching and checklists
+ * for verification.
+ */
+export {};
+//# sourceMappingURL=procedural-memory.js.map

package/dist/types/procedural-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedural-memory.js","sourceRoot":"","sources":["../../src/types/procedural-memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types/semantic-memory.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Semantic Memory Type
+ *
+ * Consolidated knowledge extracted from episodic memories.
+ * Created through the sleep-inspired consolidation process.
+ */
+import type { BaseMemory } from './memory.js';
+/**
+ * Information about how this memory was consolidated
+ */
+export interface ConsolidationSource {
+    /** IDs of episodic memories this was consolidated from */
+    episodicMemoryIds: string[];
+    /** When consolidation occurred */
+    consolidationDate: string;
+    /** How consolidation was triggered */
+    consolidationMethod: 'automatic' | 'manual';
+}
+/**
+ * Semantic Memory - Consolidated knowledge
+ *
+ * Half-life: 90 days
+ *
+ * Created when multiple episodic memories about the same topic
+ * are consolidated into a single, more abstract piece of knowledge.
+ *
+ * Examples:
+ * - "Users prefer explicit error messages over generic ones"
+ * - "The team uses barrel exports for all public APIs"
+ * - "Database queries should always include pagination"
+ */
+export interface SemanticMemory extends BaseMemory {
+    type: 'semantic';
+    /** Topic of this knowledge */
+    topic: string;
+    /** The consolidated knowledge */
+    knowledge: string;
+    /** How this memory was created */
+    consolidatedFrom?: ConsolidationSource;
+    /** Number of supporting episodes/evidence */
+    supportingEvidence: number;
+    /** Number of contradicting episodes/evidence */
+    contradictingEvidence: number;
+    /** When this knowledge was last reinforced by new evidence */
+    lastReinforced?: string;
+}
+//# sourceMappingURL=semantic-memory.d.ts.map

package/dist/types/semantic-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-memory.d.ts","sourceRoot":"","sources":["../../src/types/semantic-memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,mBAAmB,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC7C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,EAAE,UAAU,CAAC;IAEjB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IAEvC,6CAA6C;IAC7C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,qBAAqB,EAAE,MAAM,CAAC;IAE9B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/types/semantic-memory.js

@@ -0,0 +1,8 @@
+/**
+ * Semantic Memory Type
+ *
+ * Consolidated knowledge extracted from episodic memories.
+ * Created through the sleep-inspired consolidation process.
+ */
+export {};
+//# sourceMappingURL=semantic-memory.js.map

package/dist/types/semantic-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-memory.js","sourceRoot":"","sources":["../../src/types/semantic-memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/session-context.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Session Context Types
+ *
+ * Defines session state tracking for token efficiency.
+ * Tracks what has been loaded in the current session to
+ * avoid re-sending the same context repeatedly.
+ *
+ * @module types/session-context
+ */
+/**
+ * Current session state
+ *
+ * Tracks everything that has been loaded/sent in the
+ * current conversation session.
+ */
+export interface SessionContext {
+    /** Unique session identifier */
+    id: string;
+    /** When the session started */
+    startedAt: string;
+    /** When the session ended (null if active) */
+    endedAt?: string;
+    /** Set of loaded memory IDs */
+    loadedMemories: Set<string>;
+    /** Set of loaded pattern IDs */
+    loadedPatterns: Set<string>;
+    /** Set of loaded file paths */
+    loadedFiles: Set<string>;
+    /** Set of loaded constraint IDs */
+    loadedConstraints: Set<string>;
+    /** Total tokens sent in this session */
+    tokensSent: number;
+    /** Number of queries made */
+    queriesMade: number;
+    /** Last activity timestamp */
+    lastActivity: string;
+    /** Session metadata */
+    metadata?: SessionMetadata;
+}
+/**
+ * Serializable version of SessionContext for storage
+ */
+export interface SerializableSessionContext {
+    id: string;
+    startedAt: string;
+    endedAt?: string;
+    loadedMemories: string[];
+    loadedPatterns: string[];
+    loadedFiles: string[];
+    loadedConstraints: string[];
+    tokensSent: number;
+    queriesMade: number;
+    lastActivity: string;
+    metadata?: SessionMetadata;
+}
+/**
+ * Session metadata
+ */
+export interface SessionMetadata {
+    /** User identifier */
+    userId?: string;
+    /** Project/workspace identifier */
+    projectId?: string;
+    /** Active file when session started */
+    initialFile?: string;
+    /** Client information */
+    client?: string;
+    /** Custom tags */
+    tags?: string[];
+}
+/**
+ * Set of loaded memory IDs with metadata
+ */
+export interface LoadedMemorySet {
+    /** Memory IDs that have been loaded */
+    memoryIds: Set<string>;
+    /** When each memory was loaded */
+    loadedAt: Map<string, string>;
+    /** Compression level used for each memory */
+    compressionLevels: Map<string, number>;
+    /** Token count for each memory */
+    tokenCounts: Map<string, number>;
+}
+/**
+ * Session configuration
+ */
+export interface SessionConfig {
+    /** Maximum session duration (ms) */
+    maxDuration?: number;
+    /** Session timeout for inactivity (ms) */
+    inactivityTimeout?: number;
+    /** Maximum tokens per session */
+    maxTokensPerSession?: number;
+    /** Whether to persist sessions */
+    persistSessions?: boolean;
+    /** Whether to track detailed metrics */
+    trackDetailedMetrics?: boolean;
+    /** Auto-cleanup old sessions */
+    autoCleanup?: boolean;
+    /** Days to keep session history */
+    retentionDays?: number;
+}
+/**
+ * Default session configuration
+ */
+export declare const DEFAULT_SESSION_CONFIG: SessionConfig;
+/**
+ * Session statistics
+ */
+export interface SessionStats {
+    /** Session ID */
+    sessionId: string;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Total memories loaded */
+    memoriesLoaded: number;
+    /** Unique memories loaded */
+    uniqueMemoriesLoaded: number;
+    /** Total patterns loaded */
+    patternsLoaded: number;
+    /** Total files referenced */
+    filesReferenced: number;
+    /** Total tokens sent */
+    tokensSent: number;
+    /** Tokens saved by deduplication */
+    tokensSaved: number;
+    /** Deduplication efficiency (0.0 - 1.0) */
+    deduplicationEfficiency: number;
+    /** Queries made */
+    queriesMade: number;
+    /** Average tokens per query */
+    avgTokensPerQuery: number;
+    /** Compression level distribution */
+    compressionLevelDistribution: Record<number, number>;
+}
+/**
+ * Session event for tracking
+ */
+export interface SessionEvent {
+    /** Event type */
+    type: SessionEventType;
+    /** When the event occurred */
+    timestamp: string;
+    /** Event-specific data */
+    data: Record<string, unknown>;
+}
+/**
+ * Types of session events
+ */
+export type SessionEventType = 'session_started' | 'session_ended' | 'memory_loaded' | 'memory_deduplicated' | 'pattern_loaded' | 'file_loaded' | 'query_made' | 'tokens_sent' | 'compression_applied';
+/**
+ * Request to create a new session
+ */
+export interface CreateSessionRequest {
+    /** Optional session ID (auto-generated if not provided) */
+    id?: string;
+    /** Session metadata */
+    metadata?: SessionMetadata;
+    /** Custom configuration */
+    config?: Partial<SessionConfig>;
+}
+/**
+ * Result of session operations
+ */
+export interface SessionOperationResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Session ID */
+    sessionId: string;
+    /** Operation message */
+    message?: string;
+    /** Updated session context */
+    session?: SessionContext;
+}
+//# sourceMappingURL=session-context.d.ts.map

package/dist/types/session-context.d.ts.map

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

package/dist/types/session-context.js

@@ -0,0 +1,22 @@
+/**
+ * Session Context Types
+ *
+ * Defines session state tracking for token efficiency.
+ * Tracks what has been loaded in the current session to
+ * avoid re-sending the same context repeatedly.
+ *
+ * @module types/session-context
+ */
+/**
+ * Default session configuration
+ */
+export const DEFAULT_SESSION_CONFIG = {
+    maxDuration: 24 * 60 * 60 * 1000, // 24 hours
+    inactivityTimeout: 30 * 60 * 1000, // 30 minutes
+    maxTokensPerSession: 1_000_000, // 1M tokens
+    persistSessions: true,
+    trackDetailedMetrics: true,
+    autoCleanup: true,
+    retentionDays: 7,
+};
+//# sourceMappingURL=session-context.js.map

package/dist/types/session-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context.js","sourceRoot":"","sources":["../../src/types/session-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoGH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;IAC7C,iBAAiB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IAChD,mBAAmB,EAAE,SAAS,EAAE,YAAY;IAC5C,eAAe,EAAE,IAAI;IACrB,oBAAoB,EAAE,IAAI;IAC1B,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,CAAC;CACjB,CAAC"}