@mzhub/mem-ts 0.1.0

package/dist/providers/index.mjs

@@ -0,0 +1,370 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/providers/BaseProvider.ts
+var BaseProvider = class {
+  apiKey;
+  model;
+  baseUrl;
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.apiKey = config.apiKey;
+    this.model = config.model || this.getDefaultModel();
+    this.baseUrl = config.baseUrl;
+  }
+  /**
+   * Check if the provider SDK is available
+   */
+  static isAvailable() {
+    return true;
+  }
+};
+
+// src/providers/OpenAIProvider.ts
+var OpenAIProvider = class extends BaseProvider {
+  endpoint;
+  constructor(config) {
+    super(config);
+    this.endpoint = this.baseUrl || "https://api.openai.com/v1";
+  }
+  getDefaultModel() {
+    return "gpt-4o-mini";
+  }
+  getName() {
+    return "openai";
+  }
+  async complete(options) {
+    const {
+      systemPrompt,
+      userPrompt,
+      maxTokens = 1e3,
+      temperature = 0.3,
+      jsonMode = true
+    } = options;
+    const response = await fetch(`${this.endpoint}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify({
+        model: this.model,
+        messages: [
+          { role: "system", content: systemPrompt },
+          { role: "user", content: userPrompt }
+        ],
+        max_tokens: maxTokens,
+        temperature,
+        ...jsonMode && { response_format: { type: "json_object" } }
+      })
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: { message: response.statusText } }));
+      throw new Error(
+        `OpenAI API error: ${errorData.error?.message || response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return {
+      content: data.choices[0]?.message?.content || "",
+      usage: {
+        inputTokens: data.usage?.prompt_tokens || 0,
+        outputTokens: data.usage?.completion_tokens || 0
+      }
+    };
+  }
+};
+
+// src/providers/AnthropicProvider.ts
+var AnthropicProvider = class extends BaseProvider {
+  client;
+  constructor(config) {
+    super(config);
+    this.initClient();
+  }
+  async initClient() {
+    try {
+      const { default: Anthropic } = await import('@anthropic-ai/sdk');
+      this.client = new Anthropic({
+        apiKey: this.apiKey,
+        ...this.baseUrl && { baseURL: this.baseUrl }
+      });
+    } catch {
+      throw new Error(
+        "Anthropic SDK not installed. Run: npm install @anthropic-ai/sdk"
+      );
+    }
+  }
+  getDefaultModel() {
+    return "claude-3-haiku-20240307";
+  }
+  getName() {
+    return "anthropic";
+  }
+  static isAvailable() {
+    try {
+      __require.resolve("@anthropic-ai/sdk");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async complete(options) {
+    const {
+      systemPrompt,
+      userPrompt,
+      maxTokens = 1e3,
+      temperature = 0.3
+    } = options;
+    if (!this.client) {
+      await this.initClient();
+    }
+    const client = this.client;
+    const message = await client.messages.create({
+      model: this.model,
+      max_tokens: maxTokens,
+      temperature,
+      system: systemPrompt,
+      messages: [{ role: "user", content: userPrompt }]
+    });
+    return {
+      content: message.content[0]?.text || "",
+      usage: {
+        inputTokens: message.usage?.input_tokens || 0,
+        outputTokens: message.usage?.output_tokens || 0
+      }
+    };
+  }
+};
+
+// src/providers/GeminiProvider.ts
+var GeminiProvider = class extends BaseProvider {
+  genAI;
+  constructor(config) {
+    super(config);
+    this.initClient();
+  }
+  async initClient() {
+    try {
+      const { GoogleGenerativeAI } = await import('@google/generative-ai');
+      this.genAI = new GoogleGenerativeAI(this.apiKey);
+    } catch {
+      throw new Error(
+        "Google Generative AI SDK not installed. Run: npm install @google/generative-ai"
+      );
+    }
+  }
+  getDefaultModel() {
+    return "gemini-2.0-flash";
+  }
+  getName() {
+    return "gemini";
+  }
+  static isAvailable() {
+    try {
+      __require.resolve("@google/generative-ai");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async complete(options) {
+    const {
+      systemPrompt,
+      userPrompt,
+      maxTokens = 1e3,
+      temperature = 0.3
+    } = options;
+    if (!this.genAI) {
+      await this.initClient();
+    }
+    const genAI = this.genAI;
+    const model = genAI.getGenerativeModel({
+      model: this.model,
+      systemInstruction: systemPrompt
+    });
+    const result = await model.generateContent({
+      contents: [{ role: "user", parts: [{ text: userPrompt }] }],
+      generationConfig: {
+        maxOutputTokens: maxTokens,
+        temperature
+      }
+    });
+    const response = result.response;
+    return {
+      content: response.text() || "",
+      usage: {
+        inputTokens: response.usageMetadata?.promptTokenCount || 0,
+        outputTokens: response.usageMetadata?.candidatesTokenCount || 0
+      }
+    };
+  }
+};
+
+// src/providers/GroqProvider.ts
+var GroqProvider = class extends BaseProvider {
+  client;
+  constructor(config) {
+    super(config);
+    this.initClient();
+  }
+  async initClient() {
+    try {
+      const { default: Groq } = await import('groq-sdk');
+      this.client = new Groq({
+        apiKey: this.apiKey,
+        ...this.baseUrl && { baseURL: this.baseUrl }
+      });
+    } catch {
+      throw new Error("Groq SDK not installed. Run: npm install groq-sdk");
+    }
+  }
+  getDefaultModel() {
+    return "llama-3.3-70b-versatile";
+  }
+  getName() {
+    return "groq";
+  }
+  static isAvailable() {
+    try {
+      __require.resolve("groq-sdk");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async complete(options) {
+    const {
+      systemPrompt,
+      userPrompt,
+      maxTokens = 1e3,
+      temperature = 0.3
+    } = options;
+    if (!this.client) {
+      await this.initClient();
+    }
+    const client = this.client;
+    const completion = await client.chat.completions.create({
+      model: this.model,
+      messages: [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: userPrompt }
+      ],
+      max_tokens: maxTokens,
+      temperature
+    });
+    return {
+      content: completion.choices[0]?.message?.content || "",
+      usage: {
+        inputTokens: completion.usage?.prompt_tokens || 0,
+        outputTokens: completion.usage?.completion_tokens || 0
+      }
+    };
+  }
+};
+
+// src/providers/CerebrasProvider.ts
+var CerebrasProvider = class extends BaseProvider {
+  client;
+  constructor(config) {
+    super(config);
+    this.initClient();
+  }
+  async initClient() {
+    try {
+      const { default: Cerebras } = await import('@cerebras/cerebras_cloud_sdk');
+      this.client = new Cerebras({
+        apiKey: this.apiKey,
+        ...this.baseUrl && { baseURL: this.baseUrl }
+      });
+    } catch {
+      throw new Error(
+        "Cerebras SDK not installed. Run: npm install @cerebras/cerebras_cloud_sdk"
+      );
+    }
+  }
+  getDefaultModel() {
+    return "llama-3.3-70b";
+  }
+  getName() {
+    return "cerebras";
+  }
+  static isAvailable() {
+    try {
+      __require.resolve("@cerebras/cerebras_cloud_sdk");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async complete(options) {
+    const {
+      systemPrompt,
+      userPrompt,
+      maxTokens = 1e3,
+      temperature = 0.3
+    } = options;
+    if (!this.client) {
+      await this.initClient();
+    }
+    const client = this.client;
+    const completion = await client.chat.completions.create({
+      model: this.model,
+      messages: [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: userPrompt }
+      ],
+      max_completion_tokens: maxTokens,
+      temperature
+    });
+    return {
+      content: completion.choices[0]?.message?.content || "",
+      usage: {
+        inputTokens: completion.usage?.prompt_tokens || 0,
+        outputTokens: completion.usage?.completion_tokens || 0
+      }
+    };
+  }
+};
+
+// src/providers/index.ts
+var providerRegistry = {
+  openai: OpenAIProvider,
+  anthropic: AnthropicProvider,
+  gemini: GeminiProvider,
+  groq: GroqProvider,
+  cerebras: CerebrasProvider
+};
+function createProvider(config) {
+  const ProviderClass = providerRegistry[config.provider];
+  if (!ProviderClass) {
+    throw new Error(
+      `Unknown provider: ${config.provider}. Available: ${Object.keys(
+        providerRegistry
+      ).join(", ")}`
+    );
+  }
+  return new ProviderClass({
+    apiKey: config.apiKey,
+    model: config.model,
+    baseUrl: config.baseUrl
+  });
+}
+function getAvailableProviders() {
+  const available = ["openai"];
+  if (AnthropicProvider.isAvailable()) available.push("anthropic");
+  if (GeminiProvider.isAvailable()) available.push("gemini");
+  if (GroqProvider.isAvailable()) available.push("groq");
+  if (CerebrasProvider.isAvailable()) available.push("cerebras");
+  return available;
+}
+
+export { AnthropicProvider, BaseProvider, CerebrasProvider, GeminiProvider, GroqProvider, OpenAIProvider, createProvider, getAvailableProviders };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/providers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/BaseProvider.ts","../../src/providers/OpenAIProvider.ts","../../src/providers/AnthropicProvider.ts","../../src/providers/GeminiProvider.ts","../../src/providers/GroqProvider.ts","../../src/providers/CerebrasProvider.ts","../../src/providers/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { CompletionOptions, CompletionResult } from \"../types\";\r\n\r\n/**\r\n * Abstract base class for LLM providers.\r\n * All provider implementations must extend this class.\r\n */\r\nexport abstract class BaseProvider {\r\n  protected apiKey: string;\r\n  protected model: string;\r\n  protected baseUrl?: string;\r\n\r\n  constructor(config: { apiKey: string; model?: string; baseUrl?: string }) {\r\n    if (!config.apiKey) {\r\n      throw new Error(\"API key is required\");\r\n    }\r\n    this.apiKey = config.apiKey;\r\n    this.model = config.model || this.getDefaultModel();\r\n    this.baseUrl = config.baseUrl;\r\n  }\r\n\r\n  /**\r\n   * Get the default model for this provider\r\n   */\r\n  abstract getDefaultModel(): string;\r\n\r\n  /**\r\n   * Get the provider name\r\n   */\r\n  abstract getName(): string;\r\n\r\n  /**\r\n   * Generate a completion from the LLM\r\n   */\r\n  abstract complete(options: CompletionOptions): Promise<CompletionResult>;\r\n\r\n  /**\r\n   * Check if the provider SDK is available\r\n   */\r\n  static isAvailable(): boolean {\r\n    return true;\r\n  }\r\n}\r\n","import { BaseProvider } from \"./BaseProvider\";\r\nimport type { CompletionOptions, CompletionResult } from \"../types\";\r\n\r\n/**\r\n * OpenAI provider using native fetch (no SDK required)\r\n */\r\nexport class OpenAIProvider extends BaseProvider {\r\n  private endpoint: string;\r\n\r\n  constructor(config: { apiKey: string; model?: string; baseUrl?: string }) {\r\n    super(config);\r\n    this.endpoint = this.baseUrl || \"https://api.openai.com/v1\";\r\n  }\r\n\r\n  getDefaultModel(): string {\r\n    return \"gpt-4o-mini\";\r\n  }\r\n\r\n  getName(): string {\r\n    return \"openai\";\r\n  }\r\n\r\n  async complete(options: CompletionOptions): Promise<CompletionResult> {\r\n    const {\r\n      systemPrompt,\r\n      userPrompt,\r\n      maxTokens = 1000,\r\n      temperature = 0.3,\r\n      jsonMode = true,\r\n    } = options;\r\n\r\n    const response = await fetch(`${this.endpoint}/chat/completions`, {\r\n      method: \"POST\",\r\n      headers: {\r\n        \"Content-Type\": \"application/json\",\r\n        Authorization: `Bearer ${this.apiKey}`,\r\n      },\r\n      body: JSON.stringify({\r\n        model: this.model,\r\n        messages: [\r\n          { role: \"system\", content: systemPrompt },\r\n          { role: \"user\", content: userPrompt },\r\n        ],\r\n        max_tokens: maxTokens,\r\n        temperature,\r\n        ...(jsonMode && { response_format: { type: \"json_object\" } }),\r\n      }),\r\n    });\r\n\r\n    if (!response.ok) {\r\n      const errorData = (await response\r\n        .json()\r\n        .catch(() => ({ error: { message: response.statusText } }))) as {\r\n        error?: { message?: string };\r\n      };\r\n      throw new Error(\r\n        `OpenAI API error: ${errorData.error?.message || response.statusText}`\r\n      );\r\n    }\r\n\r\n    interface OpenAIResponse {\r\n      choices: Array<{ message?: { content?: string } }>;\r\n      usage?: { prompt_tokens?: number; completion_tokens?: number };\r\n    }\r\n\r\n    const data = (await response.json()) as OpenAIResponse;\r\n\r\n    return {\r\n      content: data.choices[0]?.message?.content || \"\",\r\n      usage: {\r\n        inputTokens: data.usage?.prompt_tokens || 0,\r\n        outputTokens: data.usage?.completion_tokens || 0,\r\n      },\r\n    };\r\n  }\r\n}\r\n","import { BaseProvider } from \"./BaseProvider\";\r\nimport type { CompletionOptions, CompletionResult } from \"../types\";\r\n\r\n/**\r\n * Anthropic provider using the official @anthropic-ai/sdk package\r\n */\r\nexport class AnthropicProvider extends BaseProvider {\r\n  private client: unknown;\r\n\r\n  constructor(config: { apiKey: string; model?: string; baseUrl?: string }) {\r\n    super(config);\r\n    this.initClient();\r\n  }\r\n\r\n  private async initClient(): Promise<void> {\r\n    try {\r\n      // Dynamic import to make the SDK optional\r\n      const { default: Anthropic } = await import(\"@anthropic-ai/sdk\");\r\n      this.client = new Anthropic({\r\n        apiKey: this.apiKey,\r\n        ...(this.baseUrl && { baseURL: this.baseUrl }),\r\n      });\r\n    } catch {\r\n      throw new Error(\r\n        \"Anthropic SDK not installed. Run: npm install @anthropic-ai/sdk\"\r\n      );\r\n    }\r\n  }\r\n\r\n  getDefaultModel(): string {\r\n    return \"claude-3-haiku-20240307\";\r\n  }\r\n\r\n  getName(): string {\r\n    return \"anthropic\";\r\n  }\r\n\r\n  static isAvailable(): boolean {\r\n    try {\r\n      require.resolve(\"@anthropic-ai/sdk\");\r\n      return true;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  async complete(options: CompletionOptions): Promise<CompletionResult> {\r\n    const {\r\n      systemPrompt,\r\n      userPrompt,\r\n      maxTokens = 1000,\r\n      temperature = 0.3,\r\n    } = options;\r\n\r\n    if (!this.client) {\r\n      await this.initClient();\r\n    }\r\n\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    const client = this.client as any;\r\n    const message = await client.messages.create({\r\n      model: this.model,\r\n      max_tokens: maxTokens,\r\n      temperature,\r\n      system: systemPrompt,\r\n      messages: [{ role: \"user\", content: userPrompt }],\r\n    });\r\n\r\n    return {\r\n      content: message.content[0]?.text || \"\",\r\n      usage: {\r\n        inputTokens: message.usage?.input_tokens || 0,\r\n        outputTokens: message.usage?.output_tokens || 0,\r\n      },\r\n    };\r\n  }\r\n}\r\n","import { BaseProvider } from \"./BaseProvider\";\r\nimport type { CompletionOptions, CompletionResult } from \"../types\";\r\n\r\n/**\r\n * Google Gemini provider using the official @google/generative-ai package\r\n */\r\nexport class GeminiProvider extends BaseProvider {\r\n  private genAI: unknown;\r\n\r\n  constructor(config: { apiKey: string; model?: string; baseUrl?: string }) {\r\n    super(config);\r\n    this.initClient();\r\n  }\r\n\r\n  private async initClient(): Promise<void> {\r\n    try {\r\n      // Dynamic import to make the SDK optional\r\n      const { GoogleGenerativeAI } = await import(\"@google/generative-ai\");\r\n      this.genAI = new GoogleGenerativeAI(this.apiKey);\r\n    } catch {\r\n      throw new Error(\r\n        \"Google Generative AI SDK not installed. Run: npm install @google/generative-ai\"\r\n      );\r\n    }\r\n  }\r\n\r\n  getDefaultModel(): string {\r\n    return \"gemini-2.0-flash\";\r\n  }\r\n\r\n  getName(): string {\r\n    return \"gemini\";\r\n  }\r\n\r\n  static isAvailable(): boolean {\r\n    try {\r\n      require.resolve(\"@google/generative-ai\");\r\n      return true;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  async complete(options: CompletionOptions): Promise<CompletionResult> {\r\n    const {\r\n      systemPrompt,\r\n      userPrompt,\r\n      maxTokens = 1000,\r\n      temperature = 0.3,\r\n    } = options;\r\n\r\n    if (!this.genAI) {\r\n      await this.initClient();\r\n    }\r\n\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    const genAI = this.genAI as any;\r\n    const model = genAI.getGenerativeModel({\r\n      model: this.model,\r\n      systemInstruction: systemPrompt,\r\n    });\r\n\r\n    const result = await model.generateContent({\r\n      contents: [{ role: \"user\", parts: [{ text: userPrompt }] }],\r\n      generationConfig: {\r\n        maxOutputTokens: maxTokens,\r\n        temperature,\r\n      },\r\n    });\r\n\r\n    const response = result.response;\r\n\r\n    return {\r\n      content: response.text() || \"\",\r\n      usage: {\r\n        inputTokens: response.usageMetadata?.promptTokenCount || 0,\r\n        outputTokens: response.usageMetadata?.candidatesTokenCount || 0,\r\n      },\r\n    };\r\n  }\r\n}\r\n","import { BaseProvider } from \"./BaseProvider\";\r\nimport type { CompletionOptions, CompletionResult } from \"../types\";\r\n\r\n/**\r\n * Groq provider using the official groq-sdk package\r\n */\r\nexport class GroqProvider extends BaseProvider {\r\n  private client: unknown;\r\n\r\n  constructor(config: { apiKey: string; model?: string; baseUrl?: string }) {\r\n    super(config);\r\n    this.initClient();\r\n  }\r\n\r\n  private async initClient(): Promise<void> {\r\n    try {\r\n      // Dynamic import to make the SDK optional\r\n      const { default: Groq } = await import(\"groq-sdk\");\r\n      this.client = new Groq({\r\n        apiKey: this.apiKey,\r\n        ...(this.baseUrl && { baseURL: this.baseUrl }),\r\n      });\r\n    } catch {\r\n      throw new Error(\"Groq SDK not installed. Run: npm install groq-sdk\");\r\n    }\r\n  }\r\n\r\n  getDefaultModel(): string {\r\n    return \"llama-3.3-70b-versatile\";\r\n  }\r\n\r\n  getName(): string {\r\n    return \"groq\";\r\n  }\r\n\r\n  static isAvailable(): boolean {\r\n    try {\r\n      require.resolve(\"groq-sdk\");\r\n      return true;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  async complete(options: CompletionOptions): Promise<CompletionResult> {\r\n    const {\r\n      systemPrompt,\r\n      userPrompt,\r\n      maxTokens = 1000,\r\n      temperature = 0.3,\r\n    } = options;\r\n\r\n    if (!this.client) {\r\n      await this.initClient();\r\n    }\r\n\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    const client = this.client as any;\r\n    const completion = await client.chat.completions.create({\r\n      model: this.model,\r\n      messages: [\r\n        { role: \"system\", content: systemPrompt },\r\n        { role: \"user\", content: userPrompt },\r\n      ],\r\n      max_tokens: maxTokens,\r\n      temperature,\r\n    });\r\n\r\n    return {\r\n      content: completion.choices[0]?.message?.content || \"\",\r\n      usage: {\r\n        inputTokens: completion.usage?.prompt_tokens || 0,\r\n        outputTokens: completion.usage?.completion_tokens || 0,\r\n      },\r\n    };\r\n  }\r\n}\r\n","import { BaseProvider } from \"./BaseProvider\";\r\nimport type { CompletionOptions, CompletionResult } from \"../types\";\r\n\r\n/**\r\n * Cerebras provider using the official @cerebras/cerebras_cloud_sdk package\r\n */\r\nexport class CerebrasProvider extends BaseProvider {\r\n  private client: unknown;\r\n\r\n  constructor(config: { apiKey: string; model?: string; baseUrl?: string }) {\r\n    super(config);\r\n    this.initClient();\r\n  }\r\n\r\n  private async initClient(): Promise<void> {\r\n    try {\r\n      // Dynamic import to make the SDK optional\r\n      const { default: Cerebras } = await import(\r\n        \"@cerebras/cerebras_cloud_sdk\"\r\n      );\r\n      this.client = new Cerebras({\r\n        apiKey: this.apiKey,\r\n        ...(this.baseUrl && { baseURL: this.baseUrl }),\r\n      });\r\n    } catch {\r\n      throw new Error(\r\n        \"Cerebras SDK not installed. Run: npm install @cerebras/cerebras_cloud_sdk\"\r\n      );\r\n    }\r\n  }\r\n\r\n  getDefaultModel(): string {\r\n    return \"llama-3.3-70b\";\r\n  }\r\n\r\n  getName(): string {\r\n    return \"cerebras\";\r\n  }\r\n\r\n  static isAvailable(): boolean {\r\n    try {\r\n      require.resolve(\"@cerebras/cerebras_cloud_sdk\");\r\n      return true;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }\r\n\r\n  async complete(options: CompletionOptions): Promise<CompletionResult> {\r\n    const {\r\n      systemPrompt,\r\n      userPrompt,\r\n      maxTokens = 1000,\r\n      temperature = 0.3,\r\n    } = options;\r\n\r\n    if (!this.client) {\r\n      await this.initClient();\r\n    }\r\n\r\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n    const client = this.client as any;\r\n    const completion = await client.chat.completions.create({\r\n      model: this.model,\r\n      messages: [\r\n        { role: \"system\", content: systemPrompt },\r\n        { role: \"user\", content: userPrompt },\r\n      ],\r\n      max_completion_tokens: maxTokens,\r\n      temperature,\r\n    });\r\n\r\n    return {\r\n      content: completion.choices[0]?.message?.content || \"\",\r\n      usage: {\r\n        inputTokens: completion.usage?.prompt_tokens || 0,\r\n        outputTokens: completion.usage?.completion_tokens || 0,\r\n      },\r\n    };\r\n  }\r\n}\r\n","import { BaseProvider } from \"./BaseProvider\";\r\nimport { OpenAIProvider } from \"./OpenAIProvider\";\r\nimport { AnthropicProvider } from \"./AnthropicProvider\";\r\nimport { GeminiProvider } from \"./GeminiProvider\";\r\nimport { GroqProvider } from \"./GroqProvider\";\r\nimport { CerebrasProvider } from \"./CerebrasProvider\";\r\nimport type { ProviderConfig, ProviderName } from \"../types\";\r\n\r\nexport {\r\n  BaseProvider,\r\n  OpenAIProvider,\r\n  AnthropicProvider,\r\n  GeminiProvider,\r\n  GroqProvider,\r\n  CerebrasProvider,\r\n};\r\n\r\n/**\r\n * Provider registry for creating providers by name\r\n */\r\nconst providerRegistry: Record<\r\n  ProviderName,\r\n  new (config: {\r\n    apiKey: string;\r\n    model?: string;\r\n    baseUrl?: string;\r\n  }) => BaseProvider\r\n> = {\r\n  openai: OpenAIProvider,\r\n  anthropic: AnthropicProvider,\r\n  gemini: GeminiProvider,\r\n  groq: GroqProvider,\r\n  cerebras: CerebrasProvider,\r\n};\r\n\r\n/**\r\n * Create a provider instance from configuration\r\n */\r\nexport function createProvider(config: ProviderConfig): BaseProvider {\r\n  const ProviderClass = providerRegistry[config.provider];\r\n  if (!ProviderClass) {\r\n    throw new Error(\r\n      `Unknown provider: ${config.provider}. Available: ${Object.keys(\r\n        providerRegistry\r\n      ).join(\", \")}`\r\n    );\r\n  }\r\n\r\n  return new ProviderClass({\r\n    apiKey: config.apiKey,\r\n    model: config.model,\r\n    baseUrl: config.baseUrl,\r\n  });\r\n}\r\n\r\n/**\r\n * Check which providers are available (have their SDKs installed)\r\n */\r\nexport function getAvailableProviders(): ProviderName[] {\r\n  const available: ProviderName[] = [\"openai\"]; // OpenAI uses fetch, always available\r\n\r\n  if (AnthropicProvider.isAvailable()) available.push(\"anthropic\");\r\n  if (GeminiProvider.isAvailable()) available.push(\"gemini\");\r\n  if (GroqProvider.isAvailable()) available.push(\"groq\");\r\n  if (CerebrasProvider.isAvailable()) available.push(\"cerebras\");\r\n\r\n  return available;\r\n}\r\n"]}

package/dist/types-G9qmfSeZ.d.mts

@@ -0,0 +1,260 @@
+/**
+ * Core type definitions for mem-ts Memory OS
+ */
+/**
+ * A single memory fact representing a relationship between entities
+ */
+interface MemoryFact {
+    /** Unique identifier (UUID) */
+    id: string;
+    /** The entity (e.g., "User", "Project:WebApp") */
+    subject: string;
+    /** The relationship (e.g., "HAS_ALLERGY", "PREFERS", "WORKS_AT") */
+    predicate: string;
+    /** The value (e.g., "Peanuts", "Dark Mode", "Acme Corp") */
+    object: string;
+    /** Confidence score 0-1 */
+    confidence: number;
+    /**
+     * Importance score 1-10 (Amygdala pattern)
+     * 1-3: Trivia (preferences, minor details)
+     * 4-6: Standard (work, location, relationships)
+     * 7-8: Important (strong preferences, constraints)
+     * 9-10: Critical (allergies, safety, medical, boundaries)
+     */
+    importance: number;
+    /** Conversation ID that created/updated this fact */
+    source: string;
+    /** Specific conversation exchange ID for episodic linking */
+    sourceConversationId?: string;
+    /** When this fact was first created */
+    createdAt: Date;
+    /** When this fact was last updated */
+    updatedAt: Date;
+    /** When this fact was superseded (null if still valid) */
+    invalidatedAt: Date | null;
+    /** Number of times this fact has been accessed (Hebbian learning) */
+    accessCount?: number;
+    /** Last time this fact was accessed */
+    lastAccessedAt?: Date;
+    /**
+     * Emotional context when fact was learned (Emotional Coloring)
+     * Tracks whether the fact was learned in a positive or negative context
+     */
+    sentiment?: "positive" | "negative" | "neutral";
+    /** Description of the emotional context */
+    emotionalContext?: string;
+    /**
+     * Memory consolidation stage (Memory Consolidation Levels)
+     * - short-term: Just learned, may not persist
+     * - working: Being actively used, intermediate storage
+     * - long-term: Consolidated through reinforcement
+     */
+    memoryStage?: "short-term" | "working" | "long-term";
+    /**
+     * IDs of related facts (Associative Linking / Knowledge Graph)
+     * Creates connections between facts for richer context
+     */
+    relatedFactIds?: string[];
+    /**
+     * Vector embedding for semantic search (Attention Filtering)
+     * Stored as array of numbers for similarity matching
+     */
+    embedding?: number[];
+    /**
+     * Memory level in the hierarchy pyramid:
+     * - raw_log: Raw conversation data (ephemeral, auto-deleted)
+     * - fact: Specific discrete facts (your normal facts)
+     * - pattern: Synthesized patterns/traits from multiple facts
+     * - core_belief: Unchangeable truths, always loaded (allergies, identity)
+     */
+    memoryLevel?: "raw_log" | "fact" | "pattern" | "core_belief";
+    /**
+     * IDs of lower-level facts that this pattern/belief was derived from.
+     * Creates provenance chain for "why do I believe this?"
+     */
+    childrenIds?: string[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A memory operation for updating the fact graph
+ */
+interface MemoryOperation {
+    /** Operation type */
+    op: "INSERT" | "UPDATE" | "DELETE";
+    /** The entity */
+    subject: string;
+    /** The relationship */
+    predicate: string;
+    /** The value */
+    object: string;
+    /** Reason for this operation (especially for DELETEs) */
+    reason?: string;
+    /** Confidence score 0-1 */
+    confidence?: number;
+    /** Importance score 1-10 (for safety-critical facts) */
+    importance?: number;
+    /** Sentiment context when fact was learned */
+    sentiment?: "positive" | "negative" | "neutral";
+}
+/**
+ * Result from the fact extraction LLM
+ */
+interface ExtractionResult {
+    /** List of operations to apply */
+    operations: MemoryOperation[];
+    /** Reasoning for the extractions */
+    reasoning?: string;
+}
+/**
+ * A single message in a conversation
+ */
+interface Message {
+    role: "user" | "assistant" | "system";
+    content: string;
+    timestamp: Date;
+}
+/**
+ * A conversation exchange (user message + assistant response)
+ */
+interface ConversationExchange {
+    id: string;
+    userId: string;
+    sessionId: string;
+    userMessage: string;
+    assistantResponse: string;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Session information
+ */
+interface Session {
+    id: string;
+    userId: string;
+    startedAt: Date;
+    endedAt: Date | null;
+    messageCount: number;
+    summary?: string;
+}
+/**
+ * Result from hydrating context before an LLM call
+ */
+interface HydratedContext {
+    /** Compiled prompt ready for injection into system message */
+    compiledPrompt: string;
+    /** Raw facts that were retrieved */
+    facts: MemoryFact[];
+    /** Recent conversation history */
+    recentHistory: ConversationExchange[];
+    /** Token estimate for the compiled context */
+    estimatedTokens: number;
+    /** Whether this was served from cache */
+    fromCache: boolean;
+}
+/**
+ * Options for hydration
+ */
+interface HydrateOptions {
+    /** Maximum number of facts to include */
+    maxFacts?: number;
+    /** Maximum number of recent messages to include */
+    maxHistory?: number;
+    /** Specific predicates to filter for */
+    predicates?: string[];
+    /** Whether to include invalidated facts */
+    includeInvalidated?: boolean;
+}
+/**
+ * Options for LLM completion
+ */
+interface CompletionOptions {
+    /** System prompt */
+    systemPrompt: string;
+    /** User prompt */
+    userPrompt: string;
+    /** Maximum tokens in response */
+    maxTokens?: number;
+    /** Temperature (0-1, lower = more deterministic) */
+    temperature?: number;
+    /** Force JSON output mode */
+    jsonMode?: boolean;
+}
+/**
+ * Result from LLM completion
+ */
+interface CompletionResult {
+    /** The generated content */
+    content: string;
+    /** Token usage */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/**
+ * Supported LLM providers
+ */
+type ProviderName = "openai" | "anthropic" | "gemini" | "groq" | "cerebras";
+/**
+ * LLM provider configuration
+ */
+interface ProviderConfig {
+    /** Provider name */
+    provider: ProviderName;
+    /** API key */
+    apiKey: string;
+    /** Model to use (each provider has its own default) */
+    model?: string;
+    /** Base URL override (for proxies or self-hosted) */
+    baseUrl?: string;
+}
+/**
+ * Filter options for querying facts
+ */
+interface FactFilter {
+    /** Filter by subject */
+    subject?: string;
+    /** Filter by predicate */
+    predicate?: string;
+    /** Filter by predicates (OR) */
+    predicates?: string[];
+    /** Only valid (non-invalidated) facts */
+    validOnly?: boolean;
+    /** Limit number of results */
+    limit?: number;
+    /** Order by field */
+    orderBy?: "createdAt" | "updatedAt" | "confidence";
+    /** Order direction */
+    orderDir?: "asc" | "desc";
+}
+/**
+ * Options for MemoryOS behavior
+ */
+interface MemoryOSOptions {
+    /** Auto-summarize conversations after this many messages */
+    autoSummarizeAfter?: number;
+    /** Conflict resolution strategy */
+    conflictStrategy?: "latest" | "merge" | "keep_both";
+    /** Enable semantic caching */
+    enableCache?: boolean;
+    /** Cache TTL in seconds */
+    cacheTtl?: number;
+    /** Debug mode */
+    debug?: boolean;
+}
+/**
+ * Events emitted by MemoryOS
+ */
+interface MemoryOSEvents {
+    "fact:created": (fact: MemoryFact) => void;
+    "fact:updated": (fact: MemoryFact, oldFact: MemoryFact) => void;
+    "fact:deleted": (fact: MemoryFact, reason: string) => void;
+    "session:start": (session: Session) => void;
+    "session:end": (session: Session) => void;
+    "extraction:complete": (result: ExtractionResult) => void;
+    error: (error: Error) => void;
+}
+
+export type { ConversationExchange as C, ExtractionResult as E, FactFilter as F, HydrateOptions as H, MemoryFact as M, ProviderConfig as P, Session as S, CompletionOptions as a, CompletionResult as b, MemoryOSOptions as c, HydratedContext as d, ProviderName as e, MemoryOperation as f, Message as g, MemoryOSEvents as h };