agent-messenger 2.11.1 → 2.12.0

package/skills/agent-line/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-line
 description: Interact with LINE - send messages, read chats, manage conversations
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-line:*)
 metadata:
   openclaw:

package/skills/agent-slack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slack
 description: Interact with Slack workspaces - send messages, read channels, manage reactions
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:

package/skills/agent-slackbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slackbot
 description: Interact with Slack workspaces using bot tokens - send messages, read channels, manage reactions
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-slackbot:*)
 metadata:
   openclaw:

package/skills/agent-teams/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-teams
 description: Interact with Microsoft Teams - send messages, read channels, manage reactions
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-teams:*)
 metadata:
   openclaw:

package/skills/agent-telegram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-telegram
 description: Interact with Telegram through TDLib - authenticate, inspect chats, and send messages
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-telegram:*)
 ---
 

package/skills/agent-webex/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-webex
 description: Interact with Cisco Webex - send messages, read spaces, manage memberships
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-webex:*)
 metadata:
   openclaw:

package/skills/agent-wechatbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-wechatbot
 description: Interact with WeChat Official Account using API credentials - send messages, manage templates, list followers
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-wechatbot:*)
 metadata:
   openclaw:

package/skills/agent-whatsapp/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-whatsapp
 description: Interact with WhatsApp - send messages, read chats, manage conversations
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-whatsapp:*)
 metadata:
   openclaw:

package/skills/agent-whatsappbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-whatsappbot
 description: Interact with WhatsApp using Cloud API credentials - send messages, manage templates
-version: 2.11.1
+version: 2.12.0
 allowed-tools: Bash(agent-whatsappbot:*)
 metadata:
   openclaw:

package/src/platforms/channeltalk/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { ChannelConfig, ChannelCredentials, ChannelWorkspaceEntry } from './types'
 import { ChannelConfigSchema } from './types'
 
@@ -11,7 +11,7 @@ export class ChannelCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'channel-credentials.json')
   }
 

package/src/platforms/channeltalkbot/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, rename, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { ChannelBotConfig, ChannelBotCredentials, ChannelBotWorkspaceEntry } from './types'
 import { ChannelBotConfigSchema } from './types'
 
@@ -17,7 +17,7 @@ export class ChannelBotCredentialManager {
   protected renameFile: typeof rename = rename
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, CREDENTIALS_FILENAME)
     this.legacyPath = join(this.configDir, LEGACY_FILENAME)
   }

package/src/platforms/discord/credential-manager.ts

@@ -1,8 +1,9 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
+
 export interface DiscordConfig {
   token: string | null
   current_server: string | null
@@ -14,7 +15,7 @@ export class DiscordCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'discord-credentials.json')
   }
 

package/src/platforms/discordbot/client.test.ts

@@ -290,6 +290,25 @@ describe('DiscordBotClient', () => {
       const headers = fetchCalls[0].options?.headers as Record<string, string>
       expect(headers.Authorization).toBe('Bot bot-token')
     })
+
+    it('throws when response has no attachments', async () => {
+      const { tmpdir } = await import('node:os')
+      const { join } = await import('node:path')
+      const tempFile = join(tmpdir(), 'test-discordbot-upload-empty.txt')
+      await Bun.write(tempFile, 'test content')
+
+      mockResponse({
+        id: 'msg1',
+        channel_id: 'ch1',
+        author: { id: '123', username: 'bot' },
+        content: '',
+        timestamp: '2024-01-01T00:00:00.000Z',
+        attachments: [],
+      })
+
+      const client = await new DiscordBotClient().login({ token: 'bot-token' })
+      await expect(client.uploadFile('ch1', tempFile)).rejects.toThrow('Upload succeeded but no attachments returned')
+    })
   })
 
   describe('listFiles', () => {

package/src/platforms/discordbot/client.ts

@@ -307,11 +307,12 @@ export class DiscordBotClient {
     }
     const message = await this.requestFormData<MessageWithAttachments>(`/channels/${channelId}/messages`, formData)
 
-    if (!message.attachments || message.attachments.length === 0) {
+    const first = message.attachments?.[0]
+    if (!first) {
       throw new DiscordBotError('Upload succeeded but no attachments returned', 'no_attachments')
     }
 
-    return message.attachments[0]
+    return first
   }
 
   async listFiles(channelId: string): Promise<DiscordFile[]> {

package/src/platforms/discordbot/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { DiscordBotConfig, DiscordBotCredentials } from './types'
 import { DiscordBotConfigSchema } from './types'
 
@@ -11,7 +11,7 @@ export class DiscordBotCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'discordbot-credentials.json')
   }
 

package/src/platforms/instagram/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import { createAccountId, type InstagramAccount, type InstagramAccountPaths, type InstagramConfig } from './types'
 
 export class InstagramCredentialManager {
@@ -11,7 +11,7 @@ export class InstagramCredentialManager {
   private instagramRootDir: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'instagram-credentials.json')
     this.instagramRootDir = join(this.configDir, 'instagram')
   }

package/src/platforms/kakaotalk/client.ts

@@ -1,10 +1,10 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
 import { Long } from 'bson'
 
+import { getConfigDir } from '@/shared/utils/config-dir'
 import { warn } from '@/shared/utils/stderr'
 
 import { LANG, PC_OS_NAME, getLocoDeviceConfig } from './protocol/config'
@@ -105,10 +105,8 @@ function wrapError(error: unknown, code: string): KakaoTalkError {
 
 const MAX_PAGES = 50
 
-const CONFIG_DIR = join(homedir(), '.config', 'agent-messenger')
-
 function syncStatePath(deviceUuid: string): string {
-  return join(CONFIG_DIR, `kakaotalk-sync-state-${deviceUuid}.json`)
+  return join(getConfigDir(), `kakaotalk-sync-state-${deviceUuid}.json`)
 }
 
 async function loadSyncState(deviceUuid: string): Promise<SyncState | undefined> {
@@ -133,7 +131,7 @@ async function loadSyncState(deviceUuid: string): Promise<SyncState | undefined>
 }
 
 async function saveSyncState(deviceUuid: string, state: SyncState): Promise<void> {
-  await mkdir(CONFIG_DIR, { recursive: true })
+  await mkdir(getConfigDir(), { recursive: true })
   const path = syncStatePath(deviceUuid)
   await writeFile(path, JSON.stringify(state, null, 2))
   await chmod(path, 0o600)

package/src/platforms/kakaotalk/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, rm, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { KakaoAccountCredentials, KakaoConfig, KakaoDeviceType } from './types'
 
 export interface PendingLoginState {
@@ -18,7 +18,7 @@ export class KakaoCredentialManager {
   private pendingLoginPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'kakaotalk-credentials.json')
     this.pendingLoginPath = join(this.configDir, 'kakaotalk-pending-login.json')
   }

package/src/platforms/line/client.ts

@@ -1,7 +1,7 @@
 import { mkdirSync } from 'node:fs'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '@/shared/utils/config-dir'
 import { FileStorage } from '@/vendor/linejs/base/storage/mod.js'
 import {
   loginWithQR as linejsLoginWithQR,
@@ -41,7 +41,7 @@ function getDefaultDevice(): LineDevice {
 }
 
 function createStorage(accountId?: string): FileStorage {
-  const dir = join(homedir(), '.config', 'agent-messenger', 'line-storage')
+  const dir = join(getConfigDir(), 'line-storage')
   mkdirSync(dir, { recursive: true })
   return new FileStorage(join(dir, `${accountId ?? 'default'}.json`))
 }

package/src/platforms/line/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { mkdir, rm, writeFile, readFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { LineAccountCredentials, LineConfig } from './types'
 
 export class LineCredentialManager {
@@ -10,7 +10,7 @@ export class LineCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'line-credentials.json')
   }
 

package/src/platforms/slack/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { Config, WorkspaceCredentials } from './types'
 
 export class SlackCredentialManager {
@@ -10,7 +10,7 @@ export class SlackCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'slack-credentials.json')
   }
 

package/src/platforms/slackbot/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { SlackBotConfig, SlackBotCredentials, SlackBotWorkspace } from './types'
 import { SlackBotConfigSchema } from './types'
 
@@ -11,7 +11,7 @@ export class SlackBotCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'slackbot-credentials.json')
   }
 
@@ -103,6 +103,7 @@ export class SlackBotCredentialManager {
     // Try "workspace_id/bot_id" format first
     if (botId.includes('/')) {
       const [workspaceId, id] = botId.split('/')
+      if (!workspaceId || !id) return null
       const workspace = config.workspaces[workspaceId]
       if (!workspace) return null
       const bot = workspace.bots[id]
@@ -131,22 +132,24 @@ export class SlackBotCredentialManager {
       }
     }
 
-    if (matches.length === 1) return matches[0]
+    const [onlyMatch, ...rest] = matches
+    if (onlyMatch && rest.length === 0) return onlyMatch
     return null
   }
 
   async setCredentials(creds: SlackBotCredentials): Promise<void> {
     const config = await this.load()
 
-    if (!config.workspaces[creds.workspace_id]) {
-      config.workspaces[creds.workspace_id] = {
-        workspace_id: creds.workspace_id,
-        workspace_name: creds.workspace_name,
-        bots: {},
-      }
+    const existing = config.workspaces[creds.workspace_id]
+    const workspace: SlackBotWorkspace = existing ?? {
+      workspace_id: creds.workspace_id,
+      workspace_name: creds.workspace_name,
+      bots: {},
+    }
+    if (!existing) {
+      config.workspaces[creds.workspace_id] = workspace
     }
 
-    const workspace = config.workspaces[creds.workspace_id]
     workspace.workspace_name = creds.workspace_name
     workspace.bots[creds.bot_id] = {
       bot_id: creds.bot_id,
@@ -167,6 +170,7 @@ export class SlackBotCredentialManager {
 
     if (botId.includes('/')) {
       const [workspaceId, id] = botId.split('/')
+      if (!workspaceId || !id) return false
       const workspace = config.workspaces[workspaceId]
       if (!workspace || !workspace.bots[id]) return false
 
@@ -183,16 +187,16 @@ export class SlackBotCredentialManager {
       return true
     }
 
-    const matches: { workspace: SlackBotWorkspace }[] = []
+    const matches: SlackBotWorkspace[] = []
     for (const workspace of Object.values(config.workspaces)) {
       if (workspace.bots[botId]) {
-        matches.push({ workspace })
+        matches.push(workspace)
       }
     }
 
-    if (matches.length !== 1) return false
+    const [workspace, ...rest] = matches
+    if (!workspace || rest.length > 0) return false
 
-    const { workspace } = matches[0]
     delete workspace.bots[botId]
     if (Object.keys(workspace.bots).length === 0) {
       delete config.workspaces[workspace.workspace_id]

package/src/platforms/teams/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { TeamsAccount, TeamsAccountType, TeamsConfig, TeamsConfigLegacy, TeamsRegion } from './types'
 
 export class TeamsCredentialManager {
@@ -12,7 +12,7 @@ export class TeamsCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'teams-credentials.json')
   }
 

package/src/platforms/telegram/commands/whoami.test.ts

@@ -33,6 +33,7 @@ describe('whoami command', () => {
       return fn(fakeClient, {} as TelegramAccount, new TelegramCredentialManager())
     })
     consoleLogSpy = spyOn(console, 'log').mockImplementation(() => {})
+    consoleLogSpy.mockClear()
   })
 
   afterEach(() => {

package/src/platforms/telegram/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import {
   createAccountId,
   type TelegramAccount,
@@ -21,7 +21,7 @@ export class TelegramCredentialManager {
   private tdlibRootDir: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'telegram-credentials.json')
     this.provisioningStatePath = join(this.configDir, 'telegram-provisioning-state.json')
     this.tdlibRootDir = join(this.configDir, 'telegram')

package/src/platforms/webex/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import { getWebexAppCredentials } from './app-config'
 import type { WebexConfig } from './types'
 import { WebexConfigSchema } from './types'
@@ -19,7 +19,7 @@ export class WebexCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'webex-credentials.json')
   }
 

package/src/platforms/wechatbot/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { WeChatBotAccountEntry, WeChatBotConfig, WeChatBotCredentials } from './types'
 import { WeChatBotConfigSchema } from './types'
 
@@ -11,7 +11,7 @@ export class WeChatBotCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'wechatbot-credentials.json')
   }
 

package/src/platforms/whatsapp/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import { createAccountId, type WhatsAppAccount, type WhatsAppAccountPaths, type WhatsAppConfig } from './types'
 
 export class WhatsAppCredentialManager {
@@ -11,7 +11,7 @@ export class WhatsAppCredentialManager {
   private baileysRootDir: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'whatsapp-credentials.json')
     this.baileysRootDir = join(this.configDir, 'whatsapp')
   }

package/src/platforms/whatsappbot/credential-manager.ts

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from '../../shared/utils/config-dir'
 import type { WhatsAppBotAccountEntry, WhatsAppBotConfig, WhatsAppBotCredentials } from './types'
 import { WhatsAppBotConfigSchema } from './types'
 
@@ -11,7 +11,7 @@ export class WhatsAppBotCredentialManager {
   private credentialsPath: string
 
   constructor(configDir?: string) {
-    this.configDir = configDir ?? join(homedir(), '.config', 'agent-messenger')
+    this.configDir = configDir ?? getConfigDir()
     this.credentialsPath = join(this.configDir, 'whatsappbot-credentials.json')
   }
 

package/src/shared/utils/config-dir.test.ts

@@ -0,0 +1,41 @@
+import { afterEach, beforeEach, describe, expect, it } from 'bun:test'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+import { CONFIG_DIR_ENV_VAR, getConfigDir } from './config-dir'
+
+describe('getConfigDir', () => {
+  let original: string | undefined
+
+  beforeEach(() => {
+    original = process.env[CONFIG_DIR_ENV_VAR]
+    delete process.env[CONFIG_DIR_ENV_VAR]
+  })
+
+  afterEach(() => {
+    if (original === undefined) {
+      delete process.env[CONFIG_DIR_ENV_VAR]
+    } else {
+      process.env[CONFIG_DIR_ENV_VAR] = original
+    }
+  })
+
+  it('returns the default path when the env var is unset', () => {
+    expect(getConfigDir()).toBe(join(homedir(), '.config', 'agent-messenger'))
+  })
+
+  it('returns the env var value when set', () => {
+    process.env[CONFIG_DIR_ENV_VAR] = '/tmp/custom-config-dir'
+    expect(getConfigDir()).toBe('/tmp/custom-config-dir')
+  })
+
+  it('falls back to the default when the env var is empty', () => {
+    process.env[CONFIG_DIR_ENV_VAR] = ''
+    expect(getConfigDir()).toBe(join(homedir(), '.config', 'agent-messenger'))
+  })
+
+  it('does not append agent-messenger to the override path', () => {
+    process.env[CONFIG_DIR_ENV_VAR] = '/var/lib/messenger'
+    expect(getConfigDir()).toBe('/var/lib/messenger')
+  })
+})

package/src/shared/utils/config-dir.ts

@@ -0,0 +1,23 @@
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+export const CONFIG_DIR_ENV_VAR = 'AGENT_MESSENGER_CONFIG_DIR'
+
+/**
+ * Resolves the directory used to persist agent-messenger configuration and
+ * credentials.
+ *
+ * Resolution order:
+ * 1. `AGENT_MESSENGER_CONFIG_DIR` environment variable (if set and non-empty)
+ * 2. Default: `~/.config/agent-messenger`
+ *
+ * Used by every platform credential manager so that a single env var override
+ * relocates all stored credentials, sync state, and derived-key caches.
+ */
+export function getConfigDir(): string {
+  const override = process.env[CONFIG_DIR_ENV_VAR]
+  if (override && override.length > 0) {
+    return override
+  }
+  return join(homedir(), '.config', 'agent-messenger')
+}

package/src/shared/utils/derived-key-cache.ts

@@ -1,8 +1,9 @@
 import { existsSync } from 'node:fs'
 import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { getConfigDir } from './config-dir'
+
 export type Platform = 'slack' | 'discord' | 'teams' | 'instagram' | 'channeltalk'
 
 /**
@@ -18,7 +19,7 @@ export class DerivedKeyCache {
   private cacheDir: string
 
   constructor(cacheDir?: string) {
-    this.cacheDir = cacheDir ?? join(homedir(), '.config', 'agent-messenger', '.derived-keys')
+    this.cacheDir = cacheDir ?? join(getConfigDir(), '.derived-keys')
   }
 
   private getKeyPath(platform: Platform): string {