From a7dacae51fa0d664414b2faf82ffd332f3834d57 Mon Sep 17 00:00:00 2001 From: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com> Date: Wed, 29 Jul 2026 23:56:00 +0800 Subject: [PATCH 1/3] feat: add Atlas Cloud provider Signed-off-by: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com> --- src/config.ts | 14 ++++++++- src/providers/index.ts | 9 ++++++ src/types.ts | 10 +++++- test/atlascloud-provider.test.ts | 54 ++++++++++++++++++++++++++++++++ 4 files changed, 85 insertions(+), 2 deletions(-) create mode 100644 test/atlascloud-provider.test.ts diff --git a/src/config.ts b/src/config.ts index 3348ac2267..92963d6b68 100644 --- a/src/config.ts +++ b/src/config.ts @@ -63,6 +63,15 @@ function detectProvider(env: Record): ProviderConfig { }; } + if (hasRealValue(env["ATLASCLOUD_API_KEY"])) { + return { + provider: "atlascloud", + model: env["ATLASCLOUD_MODEL"] || "deepseek-ai/deepseek-v4-pro", + maxTokens, + baseURL: env["ATLASCLOUD_BASE_URL"] || "https://api.atlascloud.ai/v1", + }; + } + // MiniMax: Anthropic-compatible API, requires raw fetch to avoid SDK stainless headers if (hasRealValue(env["MINIMAX_API_KEY"])) { return { @@ -203,6 +212,7 @@ export function detectLlmProviderKind(): "llm" | "noop" { const env = getMergedEnv(); if ( hasRealValue(env["ANTHROPIC_API_KEY"]) || + hasRealValue(env["ATLASCLOUD_API_KEY"]) || hasRealValue(env["GEMINI_API_KEY"]) || hasRealValue(env["GOOGLE_API_KEY"]) || hasRealValue(env["OPENROUTER_API_KEY"]) || @@ -362,7 +372,8 @@ function hasLLMProviderConfigured(env: Record): bool env["OPENAI_API_KEY"] && (env["OPENAI_API_KEY_FOR_LLM"] || "").toLowerCase() !== "false"; return Boolean( - env["ANTHROPIC_API_KEY"] || + env["ANTHROPIC_API_KEY"] || + env["ATLASCLOUD_API_KEY"] || openaiKeyForLlm || env["OPENROUTER_API_KEY"] || env["GEMINI_API_KEY"] || @@ -414,6 +425,7 @@ export function getStandalonePersistPath(): string { const VALID_PROVIDERS = new Set([ "anthropic", + "atlascloud", "gemini", "openrouter", "agent-sdk", diff --git a/src/providers/index.ts b/src/providers/index.ts index 0ec3feba0e..c826b517ce 100644 --- a/src/providers/index.ts +++ b/src/providers/index.ts @@ -36,6 +36,8 @@ function defaultModelFor(providerType: ProviderConfig["provider"]): string { switch (providerType) { case "openai": return getEnvVar("OPENAI_MODEL") || "gpt-4o-mini"; + case "atlascloud": + return getEnvVar("ATLASCLOUD_MODEL") || "deepseek-ai/deepseek-v4-pro"; case "anthropic": return getEnvVar("ANTHROPIC_MODEL") || "claude-sonnet-4-20250514"; case "gemini": @@ -94,6 +96,13 @@ export function createFallbackProvider( function createBaseProvider(config: ProviderConfig): MemoryProvider { switch (config.provider) { + case "atlascloud": + return new OpenAIProvider( + requireEnvVar("ATLASCLOUD_API_KEY"), + config.model, + config.maxTokens, + config.baseURL || "https://api.atlascloud.ai/v1", + ); case "minimax": return new MinimaxProvider( requireEnvVar("MINIMAX_API_KEY"), diff --git a/src/types.ts b/src/types.ts index 113daeae12..b7d34c3a8f 100644 --- a/src/types.ts +++ b/src/types.ts @@ -147,7 +147,15 @@ export interface ProviderConfig { baseURL?: string; } -export type ProviderType = "agent-sdk" | "anthropic" | "gemini" | "openrouter" | "minimax" | "openai" | "noop"; +export type ProviderType = + | "agent-sdk" + | "anthropic" + | "atlascloud" + | "gemini" + | "openrouter" + | "minimax" + | "openai" + | "noop"; export interface MemoryProvider { name: string; diff --git a/test/atlascloud-provider.test.ts b/test/atlascloud-provider.test.ts new file mode 100644 index 0000000000..b1b8b3d0da --- /dev/null +++ b/test/atlascloud-provider.test.ts @@ -0,0 +1,54 @@ +import { afterEach, beforeEach, describe, expect, it } from "vitest"; +import { loadConfig, loadFallbackConfig } from "../src/config.js"; +import { createProvider } from "../src/providers/index.js"; + +const providerEnvKeys = [ + "ANTHROPIC_API_KEY", + "ATLASCLOUD_API_KEY", + "ATLASCLOUD_BASE_URL", + "ATLASCLOUD_MODEL", + "GEMINI_API_KEY", + "GOOGLE_API_KEY", + "MINIMAX_API_KEY", + "OPENAI_API_KEY", + "OPENROUTER_API_KEY", + "FALLBACK_PROVIDERS", +]; + +describe("Atlas Cloud provider", () => { + const savedEnv: Record = {}; + + beforeEach(() => { + for (const key of providerEnvKeys) { + savedEnv[key] = process.env[key]; + process.env[key] = ""; + } + }); + + afterEach(() => { + for (const key of providerEnvKeys) { + if (savedEnv[key] === undefined) delete process.env[key]; + else process.env[key] = savedEnv[key]; + } + }); + + it("selects Atlas Cloud defaults from ATLASCLOUD_API_KEY", () => { + process.env.ATLASCLOUD_API_KEY = "atlas-test-key"; + + const config = loadConfig(); + + expect(config.provider).toEqual({ + provider: "atlascloud", + model: "deepseek-ai/deepseek-v4-pro", + maxTokens: 4096, + baseURL: "https://api.atlascloud.ai/v1", + }); + expect(() => createProvider(config.provider)).not.toThrow(); + }); + + it("supports Atlas Cloud as a fallback provider", () => { + process.env.FALLBACK_PROVIDERS = "atlascloud"; + + expect(loadFallbackConfig().providers).toEqual(["atlascloud"]); + }); +}); From 7e0bcd9fa32a5b2246917be385e8bf7ae728ba14 Mon Sep 17 00:00:00 2001 From: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com> Date: Wed, 29 Jul 2026 23:56:12 +0800 Subject: [PATCH 2/3] feat: add Atlas Cloud provider Signed-off-by: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com> --- src/config.ts | 42 ++++++++++++++--------- src/providers/index.ts | 9 ++--- src/types.ts | 76 +++++++++++++++++++++++++++++++++++------- 3 files changed, 95 insertions(+), 32 deletions(-) diff --git a/src/config.ts b/src/config.ts index 92963d6b68..a9d1d10802 100644 --- a/src/config.ts +++ b/src/config.ts @@ -54,7 +54,10 @@ function detectProvider(env: Record): ProviderConfig { const maxTokens = parseInt(env["MAX_TOKENS"] || "4096", 10); // OpenAI-compatible: supports OpenAI, DeepSeek, SiliconFlow, Azure, vLLM, LM Studio - if (hasRealValue(env["OPENAI_API_KEY"]) && env["OPENAI_API_KEY_FOR_LLM"] !== "false") { + if ( + hasRealValue(env["OPENAI_API_KEY"]) && + env["OPENAI_API_KEY_FOR_LLM"] !== "false" + ) { return { provider: "openai", model: env["OPENAI_MODEL"] || "gpt-4o-mini", @@ -89,8 +92,14 @@ function detectProvider(env: Record): ProviderConfig { baseURL: env["ANTHROPIC_BASE_URL"], }; } - if (hasRealValue(env["GEMINI_API_KEY"]) || hasRealValue(env["GOOGLE_API_KEY"])) { - if (!hasRealValue(env["GEMINI_API_KEY"]) && hasRealValue(env["GOOGLE_API_KEY"])) { + if ( + hasRealValue(env["GEMINI_API_KEY"]) || + hasRealValue(env["GOOGLE_API_KEY"]) + ) { + if ( + !hasRealValue(env["GEMINI_API_KEY"]) && + hasRealValue(env["GOOGLE_API_KEY"]) + ) { process.stderr.write( "[agentmemory] GOOGLE_API_KEY detected — treating as GEMINI_API_KEY. " + "Set GEMINI_API_KEY in ~/.agentmemory/.env to silence this warning.\n", @@ -306,9 +315,8 @@ export function loadAgentScope(): { if (!raw) return null; const agentId = raw.trim().slice(0, 128); if (!agentId) return null; - const mode = env["AGENTMEMORY_AGENT_SCOPE"] === "isolated" - ? "isolated" - : "shared"; + const mode = + env["AGENTMEMORY_AGENT_SCOPE"] === "isolated" ? "isolated" : "shared"; return { agentId, mode }; } @@ -365,22 +373,24 @@ export function isConsolidationEnabled(): boolean { return hasLLMProviderConfigured(env); } -function hasLLMProviderConfigured(env: Record): boolean { +function hasLLMProviderConfigured( + env: Record, +): boolean { const provider = (env["AGENTMEMORY_PROVIDER"] || "").toLowerCase(); if (provider === "noop") return false; const openaiKeyForLlm = env["OPENAI_API_KEY"] && (env["OPENAI_API_KEY_FOR_LLM"] || "").toLowerCase() !== "false"; return Boolean( - env["ANTHROPIC_API_KEY"] || - env["ATLASCLOUD_API_KEY"] || - openaiKeyForLlm || - env["OPENROUTER_API_KEY"] || - env["GEMINI_API_KEY"] || - env["GOOGLE_API_KEY"] || - env["MINIMAX_API_KEY"] || - env["OPENAI_BASE_URL"] || - provider === "agent-sdk", + env["ANTHROPIC_API_KEY"] || + env["ATLASCLOUD_API_KEY"] || + openaiKeyForLlm || + env["OPENROUTER_API_KEY"] || + env["GEMINI_API_KEY"] || + env["GOOGLE_API_KEY"] || + env["MINIMAX_API_KEY"] || + env["OPENAI_BASE_URL"] || + provider === "agent-sdk", ); } diff --git a/src/providers/index.ts b/src/providers/index.ts index c826b517ce..6973d131c2 100644 --- a/src/providers/index.ts +++ b/src/providers/index.ts @@ -13,7 +13,10 @@ import { ResilientProvider } from "./resilient.js"; import { FallbackChainProvider } from "./fallback-chain.js"; import { getEnvVar } from "../config.js"; -export { createEmbeddingProvider, createImageEmbeddingProvider } from "./embedding/index.js"; +export { + createEmbeddingProvider, + createImageEmbeddingProvider, +} from "./embedding/index.js"; function requireEnvVar(key: string): string { const value = getEnvVar(key); @@ -141,9 +144,7 @@ function createBaseProvider(config: ProviderConfig): MemoryProvider { case "openai": { const openaiKey = getEnvVar("OPENAI_API_KEY"); if (!openaiKey) { - throw new Error( - "OPENAI_API_KEY is required for the openai provider", - ); + throw new Error("OPENAI_API_KEY is required for the openai provider"); } return new OpenAIProvider( openaiKey, diff --git a/src/types.ts b/src/types.ts index b7d34c3a8f..94b9be7878 100644 --- a/src/types.ts +++ b/src/types.ts @@ -161,7 +161,11 @@ export interface MemoryProvider { name: string; compress(systemPrompt: string, userPrompt: string): Promise; summarize(systemPrompt: string, userPrompt: string): Promise; - describeImage?(imageData: string, mimeType: string, prompt: string): Promise; + describeImage?( + imageData: string, + mimeType: string, + prompt: string, + ): Promise; } export interface AgentMemoryConfig { @@ -315,7 +319,63 @@ export interface ExportPagination { } export interface ExportData { - version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.7.7" | "0.7.9" | "0.8.0" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" | "0.8.7" | "0.8.8" | "0.8.9" | "0.8.10" | "0.8.11" | "0.8.12" | "0.8.13" | "0.9.0" | "0.9.1" | "0.9.2" | "0.9.3" | "0.9.4" | "0.9.5" | "0.9.6" | "0.9.7" | "0.9.8" | "0.9.9" | "0.9.10" | "0.9.11" | "0.9.12" | "0.9.13" | "0.9.14" | "0.9.15" | "0.9.16" | "0.9.17" | "0.9.18" | "0.9.19" | "0.9.20" | "0.9.21" | "0.9.22" | "0.9.23" | "0.9.24" | "0.9.25" | "0.9.26" | "0.9.27" | "0.9.28"; + version: + | "0.3.0" + | "0.4.0" + | "0.5.0" + | "0.6.0" + | "0.6.1" + | "0.7.0" + | "0.7.2" + | "0.7.3" + | "0.7.4" + | "0.7.5" + | "0.7.6" + | "0.7.7" + | "0.7.9" + | "0.8.0" + | "0.8.1" + | "0.8.2" + | "0.8.3" + | "0.8.4" + | "0.8.5" + | "0.8.6" + | "0.8.7" + | "0.8.8" + | "0.8.9" + | "0.8.10" + | "0.8.11" + | "0.8.12" + | "0.8.13" + | "0.9.0" + | "0.9.1" + | "0.9.2" + | "0.9.3" + | "0.9.4" + | "0.9.5" + | "0.9.6" + | "0.9.7" + | "0.9.8" + | "0.9.9" + | "0.9.10" + | "0.9.11" + | "0.9.12" + | "0.9.13" + | "0.9.14" + | "0.9.15" + | "0.9.16" + | "0.9.17" + | "0.9.18" + | "0.9.19" + | "0.9.20" + | "0.9.21" + | "0.9.22" + | "0.9.23" + | "0.9.24" + | "0.9.25" + | "0.9.26" + | "0.9.27" + | "0.9.28"; exportedAt: string; sessions: Session[]; observations: Record; @@ -500,10 +560,7 @@ export interface GraphSnapshot { } export type ConsolidationTier = - | "working" - | "episodic" - | "semantic" - | "procedural"; + "working" | "episodic" | "semantic" | "procedural"; export interface SemanticMemory { id: string; @@ -674,11 +731,7 @@ export interface Action { } export type ActionEdgeType = - | "requires" - | "unlocks" - | "spawned_by" - | "gated_by" - | "conflicts_with"; + "requires" | "unlocks" | "spawned_by" | "gated_by" | "conflicts_with"; export interface ActionEdge { id: string; @@ -862,7 +915,6 @@ export interface MeshPeer { syncFilter?: { project?: string }; } - export interface EnrichedChunk { id: string; originalObsId: string; From 672cdf88bf5af2704b554d85c0ad78a9e5048848 Mon Sep 17 00:00:00 2001 From: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com> Date: Wed, 29 Jul 2026 23:58:39 +0800 Subject: [PATCH 3/3] revert: restore upstream formatting Signed-off-by: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com> --- src/config.ts | 42 +++++++++-------------- src/providers/index.ts | 9 +++-- src/types.ts | 76 +++++++----------------------------------- 3 files changed, 32 insertions(+), 95 deletions(-) diff --git a/src/config.ts b/src/config.ts index a9d1d10802..92963d6b68 100644 --- a/src/config.ts +++ b/src/config.ts @@ -54,10 +54,7 @@ function detectProvider(env: Record): ProviderConfig { const maxTokens = parseInt(env["MAX_TOKENS"] || "4096", 10); // OpenAI-compatible: supports OpenAI, DeepSeek, SiliconFlow, Azure, vLLM, LM Studio - if ( - hasRealValue(env["OPENAI_API_KEY"]) && - env["OPENAI_API_KEY_FOR_LLM"] !== "false" - ) { + if (hasRealValue(env["OPENAI_API_KEY"]) && env["OPENAI_API_KEY_FOR_LLM"] !== "false") { return { provider: "openai", model: env["OPENAI_MODEL"] || "gpt-4o-mini", @@ -92,14 +89,8 @@ function detectProvider(env: Record): ProviderConfig { baseURL: env["ANTHROPIC_BASE_URL"], }; } - if ( - hasRealValue(env["GEMINI_API_KEY"]) || - hasRealValue(env["GOOGLE_API_KEY"]) - ) { - if ( - !hasRealValue(env["GEMINI_API_KEY"]) && - hasRealValue(env["GOOGLE_API_KEY"]) - ) { + if (hasRealValue(env["GEMINI_API_KEY"]) || hasRealValue(env["GOOGLE_API_KEY"])) { + if (!hasRealValue(env["GEMINI_API_KEY"]) && hasRealValue(env["GOOGLE_API_KEY"])) { process.stderr.write( "[agentmemory] GOOGLE_API_KEY detected — treating as GEMINI_API_KEY. " + "Set GEMINI_API_KEY in ~/.agentmemory/.env to silence this warning.\n", @@ -315,8 +306,9 @@ export function loadAgentScope(): { if (!raw) return null; const agentId = raw.trim().slice(0, 128); if (!agentId) return null; - const mode = - env["AGENTMEMORY_AGENT_SCOPE"] === "isolated" ? "isolated" : "shared"; + const mode = env["AGENTMEMORY_AGENT_SCOPE"] === "isolated" + ? "isolated" + : "shared"; return { agentId, mode }; } @@ -373,24 +365,22 @@ export function isConsolidationEnabled(): boolean { return hasLLMProviderConfigured(env); } -function hasLLMProviderConfigured( - env: Record, -): boolean { +function hasLLMProviderConfigured(env: Record): boolean { const provider = (env["AGENTMEMORY_PROVIDER"] || "").toLowerCase(); if (provider === "noop") return false; const openaiKeyForLlm = env["OPENAI_API_KEY"] && (env["OPENAI_API_KEY_FOR_LLM"] || "").toLowerCase() !== "false"; return Boolean( - env["ANTHROPIC_API_KEY"] || - env["ATLASCLOUD_API_KEY"] || - openaiKeyForLlm || - env["OPENROUTER_API_KEY"] || - env["GEMINI_API_KEY"] || - env["GOOGLE_API_KEY"] || - env["MINIMAX_API_KEY"] || - env["OPENAI_BASE_URL"] || - provider === "agent-sdk", + env["ANTHROPIC_API_KEY"] || + env["ATLASCLOUD_API_KEY"] || + openaiKeyForLlm || + env["OPENROUTER_API_KEY"] || + env["GEMINI_API_KEY"] || + env["GOOGLE_API_KEY"] || + env["MINIMAX_API_KEY"] || + env["OPENAI_BASE_URL"] || + provider === "agent-sdk", ); } diff --git a/src/providers/index.ts b/src/providers/index.ts index 6973d131c2..c826b517ce 100644 --- a/src/providers/index.ts +++ b/src/providers/index.ts @@ -13,10 +13,7 @@ import { ResilientProvider } from "./resilient.js"; import { FallbackChainProvider } from "./fallback-chain.js"; import { getEnvVar } from "../config.js"; -export { - createEmbeddingProvider, - createImageEmbeddingProvider, -} from "./embedding/index.js"; +export { createEmbeddingProvider, createImageEmbeddingProvider } from "./embedding/index.js"; function requireEnvVar(key: string): string { const value = getEnvVar(key); @@ -144,7 +141,9 @@ function createBaseProvider(config: ProviderConfig): MemoryProvider { case "openai": { const openaiKey = getEnvVar("OPENAI_API_KEY"); if (!openaiKey) { - throw new Error("OPENAI_API_KEY is required for the openai provider"); + throw new Error( + "OPENAI_API_KEY is required for the openai provider", + ); } return new OpenAIProvider( openaiKey, diff --git a/src/types.ts b/src/types.ts index 94b9be7878..b7d34c3a8f 100644 --- a/src/types.ts +++ b/src/types.ts @@ -161,11 +161,7 @@ export interface MemoryProvider { name: string; compress(systemPrompt: string, userPrompt: string): Promise; summarize(systemPrompt: string, userPrompt: string): Promise; - describeImage?( - imageData: string, - mimeType: string, - prompt: string, - ): Promise; + describeImage?(imageData: string, mimeType: string, prompt: string): Promise; } export interface AgentMemoryConfig { @@ -319,63 +315,7 @@ export interface ExportPagination { } export interface ExportData { - version: - | "0.3.0" - | "0.4.0" - | "0.5.0" - | "0.6.0" - | "0.6.1" - | "0.7.0" - | "0.7.2" - | "0.7.3" - | "0.7.4" - | "0.7.5" - | "0.7.6" - | "0.7.7" - | "0.7.9" - | "0.8.0" - | "0.8.1" - | "0.8.2" - | "0.8.3" - | "0.8.4" - | "0.8.5" - | "0.8.6" - | "0.8.7" - | "0.8.8" - | "0.8.9" - | "0.8.10" - | "0.8.11" - | "0.8.12" - | "0.8.13" - | "0.9.0" - | "0.9.1" - | "0.9.2" - | "0.9.3" - | "0.9.4" - | "0.9.5" - | "0.9.6" - | "0.9.7" - | "0.9.8" - | "0.9.9" - | "0.9.10" - | "0.9.11" - | "0.9.12" - | "0.9.13" - | "0.9.14" - | "0.9.15" - | "0.9.16" - | "0.9.17" - | "0.9.18" - | "0.9.19" - | "0.9.20" - | "0.9.21" - | "0.9.22" - | "0.9.23" - | "0.9.24" - | "0.9.25" - | "0.9.26" - | "0.9.27" - | "0.9.28"; + version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.7.7" | "0.7.9" | "0.8.0" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" | "0.8.7" | "0.8.8" | "0.8.9" | "0.8.10" | "0.8.11" | "0.8.12" | "0.8.13" | "0.9.0" | "0.9.1" | "0.9.2" | "0.9.3" | "0.9.4" | "0.9.5" | "0.9.6" | "0.9.7" | "0.9.8" | "0.9.9" | "0.9.10" | "0.9.11" | "0.9.12" | "0.9.13" | "0.9.14" | "0.9.15" | "0.9.16" | "0.9.17" | "0.9.18" | "0.9.19" | "0.9.20" | "0.9.21" | "0.9.22" | "0.9.23" | "0.9.24" | "0.9.25" | "0.9.26" | "0.9.27" | "0.9.28"; exportedAt: string; sessions: Session[]; observations: Record; @@ -560,7 +500,10 @@ export interface GraphSnapshot { } export type ConsolidationTier = - "working" | "episodic" | "semantic" | "procedural"; + | "working" + | "episodic" + | "semantic" + | "procedural"; export interface SemanticMemory { id: string; @@ -731,7 +674,11 @@ export interface Action { } export type ActionEdgeType = - "requires" | "unlocks" | "spawned_by" | "gated_by" | "conflicts_with"; + | "requires" + | "unlocks" + | "spawned_by" + | "gated_by" + | "conflicts_with"; export interface ActionEdge { id: string; @@ -915,6 +862,7 @@ export interface MeshPeer { syncFilter?: { project?: string }; } + export interface EnrichedChunk { id: string; originalObsId: string;