agent-messenger 2.11.2 → 2.12.0

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')
   }
 

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 {