@mzhub/cortex 0.1.0 → 0.1.2

package/dist/{index-DnOyj7gs.d.ts → index-BHvGS1BY.d.mts}

@@ -1,6 +1,6 @@
-import { P as ProviderConfig, c as MemoryOSOptions, H as HydrateOptions, d as HydratedContext, E as ExtractionResult, F as FactFilter, M as MemoryFact, S as Session, C as ConversationExchange } from './types-DybcUhEZ.js';
-import { B as BaseAdapter } from './BaseAdapter-WunbfD_n.js';
-import { B as BaseProvider } from './BaseProvider-BIkJVjtg.js';
+import { P as ProviderConfig, c as MemoryOSOptions, H as HydrateOptions, d as HydratedContext, E as ExtractionResult, F as FactFilter, M as MemoryFact, S as Session, C as ConversationExchange } from './types-DUn4u5hk.mjs';
+import { B as BaseAdapter } from './BaseAdapter-CH2Gg9xO.mjs';
+import { B as BaseProvider } from './BaseProvider-8dmLKPhr.mjs';
 
 interface MemoryOSConfig {
     /** LLM provider configuration or instance */
@@ -21,12 +21,12 @@ interface MemoryOSConfig {
  *
  * @example
  * ```typescript
- * import { MemoryOS } from 'mem-ts';
- * import { JSONFileAdapter } from 'mem-ts/adapters';
+ * import { MemoryOS } from 'cortex';
+ * import { JSONFileAdapter } from 'cortex/adapters';
  *
  * const memory = new MemoryOS({
  *   llm: { provider: 'openai', apiKey: 'sk-...', model: 'gpt-4o-mini' },
- *   adapter: new JSONFileAdapter({ path: './.mem-ts' })
+ *   adapter: new JSONFileAdapter({ path: './.cortex' })
  * });
  *
  * // Before LLM call - get context
@@ -45,6 +45,10 @@ declare class MemoryOS {
     private initialized;
     private activeSessions;
     constructor(config: MemoryOSConfig);
+    /**
+     * Validate configuration at construction time for fail-fast behavior
+     */
+    private validateConfig;
     /**
      * Initialize the memory system (connects to storage, etc.)
      */
@@ -223,8 +227,8 @@ declare global {
  * @example
  * ```typescript
  * import express from 'express';
- * import { MemoryOS } from 'mem-ts';
- * import { createMemoryMiddleware } from 'mem-ts/middleware';
+ * import { MemoryOS } from 'cortex';
+ * import { createMemoryMiddleware } from 'cortex/middleware';
  *
  * const app = express();
  * const memory = new MemoryOS({ ... });
@@ -263,7 +267,7 @@ declare function digestAfterResponse(memory: MemoryOS, userId: string, userMessa
  * @example
  * ```typescript
  * // pages/api/chat.ts or app/api/chat/route.ts
- * import { withMemory } from 'mem-ts/middleware';
+ * import { withMemory } from 'cortex/middleware';
  *
  * export const POST = withMemory(memory, async (req, context) => {
  *   const { message } = await req.json();
@@ -286,4 +290,4 @@ declare function withMemory<T extends {
     }) => string | undefined;
 }): (req: T) => Promise<Response>;
 
-export { MemoryOS as M, type NextFunction as N, type MemoryOSConfig as a, type MemoryMiddlewareOptions as b, createMemoryMiddleware as c, digestAfterResponse as d, type MiddlewareRequest as e, type MiddlewareResponse as f, withMemory as w };
+export { type MemoryMiddlewareOptions as M, type NextFunction as N, MemoryOS as a, type MemoryOSConfig as b, createMemoryMiddleware as c, digestAfterResponse as d, type MiddlewareRequest as e, type MiddlewareResponse as f, withMemory as w };

package/dist/{index-C_w3EJQT.d.mts → index-CA79C0tz.d.ts}

@@ -1,6 +1,6 @@
-import { P as ProviderConfig, c as MemoryOSOptions, H as HydrateOptions, d as HydratedContext, E as ExtractionResult, F as FactFilter, M as MemoryFact, S as Session, C as ConversationExchange } from './types-DybcUhEZ.mjs';
-import { B as BaseAdapter } from './BaseAdapter-Bjj4JG_S.mjs';
-import { B as BaseProvider } from './BaseProvider-B8x1pJXP.mjs';
+import { P as ProviderConfig, c as MemoryOSOptions, H as HydrateOptions, d as HydratedContext, E as ExtractionResult, F as FactFilter, M as MemoryFact, S as Session, C as ConversationExchange } from './types-DUn4u5hk.js';
+import { B as BaseAdapter } from './BaseAdapter-BcNZrPzG.js';
+import { B as BaseProvider } from './BaseProvider-DgYEmkh_.js';
 
 interface MemoryOSConfig {
     /** LLM provider configuration or instance */
@@ -21,12 +21,12 @@ interface MemoryOSConfig {
  *
  * @example
  * ```typescript
- * import { MemoryOS } from 'mem-ts';
- * import { JSONFileAdapter } from 'mem-ts/adapters';
+ * import { MemoryOS } from 'cortex';
+ * import { JSONFileAdapter } from 'cortex/adapters';
  *
  * const memory = new MemoryOS({
  *   llm: { provider: 'openai', apiKey: 'sk-...', model: 'gpt-4o-mini' },
- *   adapter: new JSONFileAdapter({ path: './.mem-ts' })
+ *   adapter: new JSONFileAdapter({ path: './.cortex' })
  * });
  *
  * // Before LLM call - get context
@@ -45,6 +45,10 @@ declare class MemoryOS {
     private initialized;
     private activeSessions;
     constructor(config: MemoryOSConfig);
+    /**
+     * Validate configuration at construction time for fail-fast behavior
+     */
+    private validateConfig;
     /**
      * Initialize the memory system (connects to storage, etc.)
      */
@@ -223,8 +227,8 @@ declare global {
  * @example
  * ```typescript
  * import express from 'express';
- * import { MemoryOS } from 'mem-ts';
- * import { createMemoryMiddleware } from 'mem-ts/middleware';
+ * import { MemoryOS } from 'cortex';
+ * import { createMemoryMiddleware } from 'cortex/middleware';
  *
  * const app = express();
  * const memory = new MemoryOS({ ... });
@@ -263,7 +267,7 @@ declare function digestAfterResponse(memory: MemoryOS, userId: string, userMessa
  * @example
  * ```typescript
  * // pages/api/chat.ts or app/api/chat/route.ts
- * import { withMemory } from 'mem-ts/middleware';
+ * import { withMemory } from 'cortex/middleware';
  *
  * export const POST = withMemory(memory, async (req, context) => {
  *   const { message } = await req.json();
@@ -286,4 +290,4 @@ declare function withMemory<T extends {
     }) => string | undefined;
 }): (req: T) => Promise<Response>;
 
-export { MemoryOS as M, type NextFunction as N, type MemoryOSConfig as a, type MemoryMiddlewareOptions as b, createMemoryMiddleware as c, digestAfterResponse as d, type MiddlewareRequest as e, type MiddlewareResponse as f, withMemory as w };
+export { type MemoryMiddlewareOptions as M, type NextFunction as N, MemoryOS as a, type MemoryOSConfig as b, createMemoryMiddleware as c, digestAfterResponse as d, type MiddlewareRequest as e, type MiddlewareResponse as f, withMemory as w };

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-export { b as MemoryMiddlewareOptions, M as MemoryOS, a as MemoryOSConfig, c as createMemoryMiddleware, d as digestAfterResponse, w as withMemory } from './index-C_w3EJQT.mjs';
-import { f as MemoryOperation, M as MemoryFact, E as ExtractionResult, H as HydrateOptions, d as HydratedContext, S as Session, F as FactFilter, C as ConversationExchange } from './types-DybcUhEZ.mjs';
-export { a as CompletionOptions, b as CompletionResult, h as MemoryOSEvents, c as MemoryOSOptions, g as Message, P as ProviderConfig, e as ProviderName } from './types-DybcUhEZ.mjs';
-import { B as BaseAdapter } from './BaseAdapter-Bjj4JG_S.mjs';
+export { M as MemoryMiddlewareOptions, a as MemoryOS, b as MemoryOSConfig, c as createMemoryMiddleware, d as digestAfterResponse, w as withMemory } from './index-BHvGS1BY.mjs';
+import { f as MemoryOperation, M as MemoryFact, E as ExtractionResult, H as HydrateOptions, d as HydratedContext, S as Session, F as FactFilter, C as ConversationExchange } from './types-DUn4u5hk.mjs';
+export { a as CompletionOptions, b as CompletionResult, g as MemoryOSEvents, c as MemoryOSOptions, h as Message, P as ProviderConfig, e as ProviderName } from './types-DUn4u5hk.mjs';
+import { B as BaseAdapter } from './BaseAdapter-CH2Gg9xO.mjs';
 export { InMemoryAdapter, JSONFileAdapter, JSONFileAdapterConfig, MongoDBAdapter, MongoDBAdapterConfig, PostgresAdapter, PostgresAdapterConfig, UpstashRedisAdapter, UpstashRedisAdapterConfig } from './adapters/index.mjs';
 export { AnthropicProvider, CerebrasProvider, GeminiProvider, GroqProvider, OpenAIProvider, createProvider, getAvailableProviders } from './providers/index.mjs';
-import { B as BaseProvider } from './BaseProvider-B8x1pJXP.mjs';
+import { B as BaseProvider } from './BaseProvider-8dmLKPhr.mjs';
 
 interface ConflictResolutionResult {
     /** Operations to apply after conflict resolution */
@@ -40,6 +40,8 @@ interface ExtractorWorkerConfig {
     minConfidence?: number;
     /** Conflict resolution strategy */
     conflictStrategy?: ConflictStrategy;
+    /** Maximum operations per extraction (default: 10, prevents memory bombs) */
+    maxOperationsPerExtraction?: number;
     /** Enable debug logging */
     debug?: boolean;
 }
@@ -52,6 +54,7 @@ declare class ExtractorWorker {
     private adapter;
     private conflictResolver;
     private minConfidence;
+    private maxOperationsPerExtraction;
     private debug;
     private queue;
     private processing;
@@ -210,7 +213,7 @@ declare class SemanticCache {
 }
 
 /**
- * Token economics utilities for mem-ts.
+ * Token economics utilities for cortex.
  * Provides token estimation, compression, and analytics.
  */
 /**
@@ -396,7 +399,7 @@ declare class MemoryEventEmitter {
 }
 
 /**
- * Security utilities for mem-ts.
+ * Security utilities for cortex.
  * Protects against prompt injection and data poisoning.
  */
 interface SecurityConfig {
@@ -450,7 +453,7 @@ declare function wrapContextSafely(context: string): string;
 declare function sanitizeForStorage(text: string): string;
 
 /**
- * Budget management for mem-ts.
+ * Budget management for cortex.
  * Prevents runaway costs from infinite loops or abuse.
  */
 interface BudgetConfig {
@@ -527,7 +530,7 @@ declare class BudgetManager {
 }
 
 /**
- * Memory decay utilities for mem-ts.
+ * Memory decay utilities for cortex.
  * Prevents the "stalker effect" by forgetting irrelevant facts over time.
  */
 
@@ -602,7 +605,7 @@ declare class DecayManager {
 }
 
 /**
- * Auto-summarization manager for mem-ts.
+ * Auto-summarization manager for cortex.
  * Triggers conversation summarization after a threshold of messages.
  */
 
@@ -714,7 +717,7 @@ declare class TieredAdapter extends BaseAdapter {
 }
 
 /**
- * Embeddings support for mem-ts.
+ * Embeddings support for cortex.
  * Provides vector embeddings for semantic search.
  */
 interface EmbeddingConfig {
@@ -1125,7 +1128,7 @@ declare class PredictiveEngine {
  *   - Ephemeral conversation buffer
  *   - Auto-flushed after extraction
  *
- * This is an OPTIONAL wrapper - you can use mem-ts without HMM.
+ * This is an OPTIONAL wrapper - you can use cortex without HMM.
  */
 
 type MemoryLevel = "raw_log" | "fact" | "pattern" | "core_belief";
@@ -1142,7 +1145,7 @@ interface HierarchicalConfig {
     debug?: boolean;
 }
 /**
- * Hierarchical Memory Manager - Optional HMM mode for mem-ts
+ * Hierarchical Memory Manager - Optional HMM mode for cortex
  */
 declare class HierarchicalMemory {
     private adapter;

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-export { b as MemoryMiddlewareOptions, M as MemoryOS, a as MemoryOSConfig, c as createMemoryMiddleware, d as digestAfterResponse, w as withMemory } from './index-DnOyj7gs.js';
-import { f as MemoryOperation, M as MemoryFact, E as ExtractionResult, H as HydrateOptions, d as HydratedContext, S as Session, F as FactFilter, C as ConversationExchange } from './types-DybcUhEZ.js';
-export { a as CompletionOptions, b as CompletionResult, h as MemoryOSEvents, c as MemoryOSOptions, g as Message, P as ProviderConfig, e as ProviderName } from './types-DybcUhEZ.js';
-import { B as BaseAdapter } from './BaseAdapter-WunbfD_n.js';
+export { M as MemoryMiddlewareOptions, a as MemoryOS, b as MemoryOSConfig, c as createMemoryMiddleware, d as digestAfterResponse, w as withMemory } from './index-CA79C0tz.js';
+import { f as MemoryOperation, M as MemoryFact, E as ExtractionResult, H as HydrateOptions, d as HydratedContext, S as Session, F as FactFilter, C as ConversationExchange } from './types-DUn4u5hk.js';
+export { a as CompletionOptions, b as CompletionResult, g as MemoryOSEvents, c as MemoryOSOptions, h as Message, P as ProviderConfig, e as ProviderName } from './types-DUn4u5hk.js';
+import { B as BaseAdapter } from './BaseAdapter-BcNZrPzG.js';
 export { InMemoryAdapter, JSONFileAdapter, JSONFileAdapterConfig, MongoDBAdapter, MongoDBAdapterConfig, PostgresAdapter, PostgresAdapterConfig, UpstashRedisAdapter, UpstashRedisAdapterConfig } from './adapters/index.js';
 export { AnthropicProvider, CerebrasProvider, GeminiProvider, GroqProvider, OpenAIProvider, createProvider, getAvailableProviders } from './providers/index.js';
-import { B as BaseProvider } from './BaseProvider-BIkJVjtg.js';
+import { B as BaseProvider } from './BaseProvider-DgYEmkh_.js';
 
 interface ConflictResolutionResult {
     /** Operations to apply after conflict resolution */
@@ -40,6 +40,8 @@ interface ExtractorWorkerConfig {
     minConfidence?: number;
     /** Conflict resolution strategy */
     conflictStrategy?: ConflictStrategy;
+    /** Maximum operations per extraction (default: 10, prevents memory bombs) */
+    maxOperationsPerExtraction?: number;
     /** Enable debug logging */
     debug?: boolean;
 }
@@ -52,6 +54,7 @@ declare class ExtractorWorker {
     private adapter;
     private conflictResolver;
     private minConfidence;
+    private maxOperationsPerExtraction;
     private debug;
     private queue;
     private processing;
@@ -210,7 +213,7 @@ declare class SemanticCache {
 }
 
 /**
- * Token economics utilities for mem-ts.
+ * Token economics utilities for cortex.
  * Provides token estimation, compression, and analytics.
  */
 /**
@@ -396,7 +399,7 @@ declare class MemoryEventEmitter {
 }
 
 /**
- * Security utilities for mem-ts.
+ * Security utilities for cortex.
  * Protects against prompt injection and data poisoning.
  */
 interface SecurityConfig {
@@ -450,7 +453,7 @@ declare function wrapContextSafely(context: string): string;
 declare function sanitizeForStorage(text: string): string;
 
 /**
- * Budget management for mem-ts.
+ * Budget management for cortex.
  * Prevents runaway costs from infinite loops or abuse.
  */
 interface BudgetConfig {
@@ -527,7 +530,7 @@ declare class BudgetManager {
 }
 
 /**
- * Memory decay utilities for mem-ts.
+ * Memory decay utilities for cortex.
  * Prevents the "stalker effect" by forgetting irrelevant facts over time.
  */
 
@@ -602,7 +605,7 @@ declare class DecayManager {
 }
 
 /**
- * Auto-summarization manager for mem-ts.
+ * Auto-summarization manager for cortex.
  * Triggers conversation summarization after a threshold of messages.
  */
 
@@ -714,7 +717,7 @@ declare class TieredAdapter extends BaseAdapter {
 }
 
 /**
- * Embeddings support for mem-ts.
+ * Embeddings support for cortex.
  * Provides vector embeddings for semantic search.
  */
 interface EmbeddingConfig {
@@ -1125,7 +1128,7 @@ declare class PredictiveEngine {
  *   - Ephemeral conversation buffer
  *   - Auto-flushed after extraction
  *
- * This is an OPTIONAL wrapper - you can use mem-ts without HMM.
+ * This is an OPTIONAL wrapper - you can use cortex without HMM.
  */
 
 type MemoryLevel = "raw_log" | "fact" | "pattern" | "core_belief";
@@ -1142,7 +1145,7 @@ interface HierarchicalConfig {
     debug?: boolean;
 }
 /**
- * Hierarchical Memory Manager - Optional HMM mode for mem-ts
+ * Hierarchical Memory Manager - Optional HMM mode for cortex
  */
 declare class HierarchicalMemory {
     private adapter;