@mzhub/cortex 0.1.0 → 0.1.2

package/dist/{BaseAdapter-WunbfD_n.d.ts → BaseAdapter-BcNZrPzG.d.ts}

@@ -1,4 +1,4 @@
-import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from './types-DybcUhEZ.js';
+import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from './types-DUn4u5hk.js';
 
 /**
  * Abstract base class for storage adapters.

package/dist/{BaseAdapter-Bjj4JG_S.d.mts → BaseAdapter-CH2Gg9xO.d.mts}

@@ -1,4 +1,4 @@
-import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from './types-DybcUhEZ.mjs';
+import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from './types-DUn4u5hk.mjs';
 
 /**
  * Abstract base class for storage adapters.

package/dist/BaseProvider-8dmLKPhr.d.mts

@@ -0,0 +1,61 @@
+import { a as CompletionOptions, b as CompletionResult } from './types-DUn4u5hk.mjs';
+
+/**
+ * Configuration for provider retry and timeout behavior
+ */
+interface ProviderRetryConfig {
+    /** Request timeout in milliseconds (default: 30000) */
+    timeoutMs?: number;
+    /** Maximum retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in milliseconds (default: 1000) */
+    retryDelayMs?: number;
+}
+/**
+ * Abstract base class for LLM providers.
+ * All provider implementations must extend this class.
+ */
+declare abstract class BaseProvider {
+    protected apiKey: string;
+    protected model: string;
+    protected baseUrl?: string;
+    protected timeoutMs: number;
+    protected maxRetries: number;
+    protected retryDelayMs: number;
+    constructor(config: {
+        apiKey: string;
+        model?: string;
+        baseUrl?: string;
+        retry?: ProviderRetryConfig;
+    });
+    /**
+     * Get the default model for this provider
+     */
+    abstract getDefaultModel(): string;
+    /**
+     * Get the provider name
+     */
+    abstract getName(): string;
+    /**
+     * Generate a completion from the LLM
+     */
+    abstract complete(options: CompletionOptions): Promise<CompletionResult>;
+    /**
+     * Check if the provider SDK is available
+     */
+    static isAvailable(): boolean;
+    /**
+     * Execute a fetch request with timeout and retry logic
+     */
+    protected fetchWithRetry(url: string, init: RequestInit): Promise<Response>;
+    /**
+     * Check if an HTTP status code is retryable
+     */
+    private isRetryableStatus;
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    protected sleep(ms: number): Promise<void>;
+}
+
+export { BaseProvider as B };

package/dist/BaseProvider-DgYEmkh_.d.ts

@@ -0,0 +1,61 @@
+import { a as CompletionOptions, b as CompletionResult } from './types-DUn4u5hk.js';
+
+/**
+ * Configuration for provider retry and timeout behavior
+ */
+interface ProviderRetryConfig {
+    /** Request timeout in milliseconds (default: 30000) */
+    timeoutMs?: number;
+    /** Maximum retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in milliseconds (default: 1000) */
+    retryDelayMs?: number;
+}
+/**
+ * Abstract base class for LLM providers.
+ * All provider implementations must extend this class.
+ */
+declare abstract class BaseProvider {
+    protected apiKey: string;
+    protected model: string;
+    protected baseUrl?: string;
+    protected timeoutMs: number;
+    protected maxRetries: number;
+    protected retryDelayMs: number;
+    constructor(config: {
+        apiKey: string;
+        model?: string;
+        baseUrl?: string;
+        retry?: ProviderRetryConfig;
+    });
+    /**
+     * Get the default model for this provider
+     */
+    abstract getDefaultModel(): string;
+    /**
+     * Get the provider name
+     */
+    abstract getName(): string;
+    /**
+     * Generate a completion from the LLM
+     */
+    abstract complete(options: CompletionOptions): Promise<CompletionResult>;
+    /**
+     * Check if the provider SDK is available
+     */
+    static isAvailable(): boolean;
+    /**
+     * Execute a fetch request with timeout and retry logic
+     */
+    protected fetchWithRetry(url: string, init: RequestInit): Promise<Response>;
+    /**
+     * Check if an HTTP status code is retryable
+     */
+    private isRetryableStatus;
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    protected sleep(ms: number): Promise<void>;
+}
+
+export { BaseProvider as B };

package/dist/adapters/index.d.mts

@@ -1,5 +1,5 @@
-import { B as BaseAdapter } from '../BaseAdapter-Bjj4JG_S.mjs';
-import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from '../types-DybcUhEZ.mjs';
+import { B as BaseAdapter } from '../BaseAdapter-CH2Gg9xO.mjs';
+import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from '../types-DUn4u5hk.mjs';
 
 /**
  * In-memory storage adapter for development and testing.
@@ -54,7 +54,7 @@ interface JSONUserData {
     sessions: Session[];
 }
 interface JSONFileAdapterConfig {
-    /** Base path for storing JSON files (default: ./.mem-ts) */
+    /** Base path for storing JSON files (default: ./.cortex) */
     path?: string;
     /** Pretty print JSON files (default: true in dev, false in prod) */
     prettyPrint?: boolean;
@@ -64,7 +64,7 @@ interface JSONFileAdapterConfig {
  * Stores each user's data in separate JSON files for portability.
  *
  * Directory structure:
- * .mem-ts/
+ * .cortex/
  * ├── users/
  * │   ├── {userId}/
  * │   │   ├── facts.json

package/dist/adapters/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BaseAdapter } from '../BaseAdapter-WunbfD_n.js';
-import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from '../types-DybcUhEZ.js';
+import { B as BaseAdapter } from '../BaseAdapter-BcNZrPzG.js';
+import { F as FactFilter, M as MemoryFact, C as ConversationExchange, S as Session } from '../types-DUn4u5hk.js';
 
 /**
  * In-memory storage adapter for development and testing.
@@ -54,7 +54,7 @@ interface JSONUserData {
     sessions: Session[];
 }
 interface JSONFileAdapterConfig {
-    /** Base path for storing JSON files (default: ./.mem-ts) */
+    /** Base path for storing JSON files (default: ./.cortex) */
     path?: string;
     /** Pretty print JSON files (default: true in dev, false in prod) */
     prettyPrint?: boolean;
@@ -64,7 +64,7 @@ interface JSONFileAdapterConfig {
  * Stores each user's data in separate JSON files for portability.
  *
  * Directory structure:
- * .mem-ts/
+ * .cortex/
  * ├── users/
  * │   ├── {userId}/
  * │   │   ├── facts.json

package/dist/adapters/index.js

@@ -287,7 +287,7 @@ var JSONFileAdapter = class extends BaseAdapter {
   prettyPrint;
   constructor(config = {}) {
     super();
-    this.basePath = config.path || "./.mem-ts";
+    this.basePath = config.path || "./.cortex";
     this.prettyPrint = config.prettyPrint ?? process.env.NODE_ENV !== "production";
   }
   async initialize() {
@@ -906,6 +906,14 @@ var PostgresAdapter = class extends BaseAdapter {
       CREATE INDEX IF NOT EXISTS idx_facts_user_valid 
       ON ${this.schema}.facts (user_id, invalidated_at)
     `);
+    await this.query(
+      `
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_facts_unique_active_triple 
+      ON ${this.schema}.facts (user_id, subject, predicate) 
+      WHERE invalidated_at IS NULL
+    `
+    ).catch(() => {
+    });
     await this.query(`
       CREATE TABLE IF NOT EXISTS ${this.schema}.conversations (
         id UUID PRIMARY KEY,