agent-messenger 2.7.0 → 2.9.0

package/src/platforms/kakaotalk/protocol/session.ts

@@ -1,7 +1,6 @@
 import { Binary, Long } from 'bson'
 
 import type { KakaoDeviceType } from '../types'
-
 import {
   BOOKING_HOST,
   BOOKING_PORT,
@@ -25,7 +24,13 @@ export class LocoSession {
   private closeHandler: (() => void) | null = null
   private deviceType: KakaoDeviceType = 'tablet'
 
-  async login(oauthToken: string, userId: string, deviceUuid: string, syncState?: SyncState, deviceType?: KakaoDeviceType): Promise<LoginListResponse> {
+  async login(
+    oauthToken: string,
+    userId: string,
+    deviceUuid: string,
+    syncState?: SyncState,
+    deviceType?: KakaoDeviceType,
+  ): Promise<LoginListResponse> {
     this.deviceType = deviceType ?? 'tablet'
     const deviceConfig = getLocoDeviceConfig(this.deviceType)
 
@@ -43,9 +48,7 @@ export class LocoSession {
 
     const chatIds = syncState?.chatIds.map((id) => new Long(id.low, id.high)) ?? []
     const maxIds = syncState?.maxIds.map((id) => new Long(id.low, id.high)) ?? []
-    const lastTokenId = syncState
-      ? new Long(syncState.lastTokenId.low, syncState.lastTokenId.high)
-      : Long.fromNumber(0)
+    const lastTokenId = syncState ? new Long(syncState.lastTokenId.low, syncState.lastTokenId.high) : Long.fromNumber(0)
     const lbk = syncState?.lbk ?? 0
 
     const response = await this.connection.sendPacket('LOGINLIST', {
@@ -71,7 +74,10 @@ export class LocoSession {
     return response.body as unknown as LoginListResponse
   }
 
-  private async bookAndCheckin(userId: string, deviceConfig: { os: string; appVersion: string; useSub: boolean }): Promise<{ host: string; port: number }> {
+  private async bookAndCheckin(
+    userId: string,
+    deviceConfig: { os: string; appVersion: string; useSub: boolean },
+  ): Promise<{ host: string; port: number }> {
     const bookingConn = new LocoConnection()
     await bookingConn.connectTls(BOOKING_HOST, BOOKING_PORT)
 

package/src/platforms/kakaotalk/token-extractor.ts

@@ -130,7 +130,7 @@ export class KakaoTokenExtractor {
     // Extract oauth_token from talk-pilsner.kakao.com requests
     // talk-pilsner.kakao.com has the real messaging oauth tokens.
     // Other subdomains (bzm-capi, etc.) use different token types.
-    const talkRows = rows.filter(r => r.request_key.includes('talk-pilsner.kakao.com'))
+    const talkRows = rows.filter((r) => r.request_key.includes('talk-pilsner.kakao.com'))
     let token: ExtractedKakaoToken | null = null
 
     for (const row of talkRows) {
@@ -263,10 +263,10 @@ export class KakaoTokenExtractor {
 
   private readWindowsRegistry(): { deviceUuid: string; deviceId: string } | null {
     try {
-      const regOutput = execSync(
-        'reg query "HKCU\\Software\\Kakao\\KakaoTalk\\DeviceInfo" /s 2>nul',
-        { encoding: 'utf8', timeout: 5000 },
-      )
+      const regOutput = execSync('reg query "HKCU\\Software\\Kakao\\KakaoTalk\\DeviceInfo" /s 2>nul', {
+        encoding: 'utf8',
+        timeout: 5000,
+      })
 
       const uuidMatch = regOutput.match(/sys_uuid\s+REG_SZ\s+(.+)/i)
       const deviceIdMatch = regOutput.match(/dev_id\s+REG_SZ\s+(.+)/i)

package/src/platforms/kakaotalk/types.ts

@@ -65,8 +65,7 @@ export const KAKAO_NEXT_ACTIONS: Record<string, { next_action: string; message:
   },
   choose_device: {
     next_action: 'choose_device',
-    message:
-      'Tablet slot occupied. Provide --device-type pc or --device-type tablet with --force to replace.',
+    message: 'Tablet slot occupied. Provide --device-type pc or --device-type tablet with --force to replace.',
   },
 }
 
@@ -105,11 +104,13 @@ export const KakaoChatSchema = z.object({
   display_name: z.string().nullable(),
   active_members: z.number(),
   unread_count: z.number(),
-  last_message: z.object({
-    author_id: z.number(),
-    message: z.string(),
-    sent_at: z.number(),
-  }).nullable(),
+  last_message: z
+    .object({
+      author_id: z.number(),
+      message: z.string(),
+      sent_at: z.number(),
+    })
+    .nullable(),
 })
 
 export const KakaoMessageSchema = z.object({

package/src/platforms/line/cli.ts

@@ -18,10 +18,7 @@ function isAuthCommand(command: CommandType): boolean {
 
 const program = new Command()
 
-program
-  .name('agent-line')
-  .description('CLI tool for LINE messaging')
-  .version(pkg.version)
+program.name('agent-line').description('CLI tool for LINE messaging').version(pkg.version)
 
 program.hook('preAction', async (_thisCommand, actionCommand) => {
   if (isAuthCommand(actionCommand)) return

package/src/platforms/line/client.ts

@@ -2,13 +2,13 @@ import { mkdirSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
 
+import { FileStorage } from '@/vendor/linejs/base/storage/mod.js'
 import {
   loginWithQR as linejsLoginWithQR,
   loginWithPassword as linejsLoginWithPassword,
   loginWithAuthToken as linejsLoginWithAuthToken,
   type Client,
 } from '@/vendor/linejs/client/mod.js'
-import { FileStorage } from '@/vendor/linejs/base/storage/mod.js'
 
 import { LineCredentialManager } from './credential-manager'
 import type {
@@ -146,10 +146,7 @@ export class LineClient {
       if (!creds) {
         const account = await this.credManager.getAccount()
         if (!account) {
-          throw new LineError(
-            'not_authenticated',
-            'No account found. Call loginWithQR() or loginWithEmail() first.',
-          )
+          throw new LineError('not_authenticated', 'No account found. Call loginWithQR() or loginWithEmail() first.')
         }
         creds = account
       }
@@ -171,9 +168,7 @@ export class LineClient {
         mid: profile.mid,
         display_name: profile.displayName,
         status_message: profile.statusMessage || undefined,
-        picture_url: profile.picturePath
-          ? `https://profile.line-scdn.net${profile.picturePath}`
-          : undefined,
+        picture_url: profile.picturePath ? `https://profile.line-scdn.net${profile.picturePath}` : undefined,
       }
     } catch (error) {
       throw wrapError(error, 'get_profile_failed')
@@ -191,9 +186,7 @@ export class LineClient {
         mid: contact.mid,
         display_name: contact.displayName,
         status_message: contact.statusMessage || undefined,
-        picture_url: contact.picturePath
-          ? `https://profile.line-scdn.net${contact.picturePath}`
-          : undefined,
+        picture_url: contact.picturePath ? `https://profile.line-scdn.net${contact.picturePath}` : undefined,
       }))
     } catch (error) {
       throw wrapError(error, 'get_friends_failed')
@@ -232,14 +225,13 @@ export class LineClient {
       }
 
       const messageBoxes = boxes?.messageBoxes ?? []
-      const userMids = messageBoxes
-        .filter((box) => box.midType === 'USER' && !seen.has(box.id))
-        .map((box) => box.id)
-      const groupMids = messageBoxes
-        .filter((box) => box.midType !== 'USER' && !seen.has(box.id))
-        .map((box) => box.id)
+      const userMids = messageBoxes.filter((box) => box.midType === 'USER' && !seen.has(box.id)).map((box) => box.id)
+      const groupMids = messageBoxes.filter((box) => box.midType !== 'USER' && !seen.has(box.id)).map((box) => box.id)
 
-      const nameMap = new Map<string, { name: string; type: 'user' | 'group' | 'room' | 'square'; memberCount?: number }>()
+      const nameMap = new Map<
+        string,
+        { name: string; type: 'user' | 'group' | 'room' | 'square'; memberCount?: number }
+      >()
 
       if (userMids.length > 0) {
         try {
@@ -270,7 +262,7 @@ export class LineClient {
         const info = nameMap.get(box.id)
         results.push({
           chat_id: box.id,
-          type: info?.type ?? (box.midType === 'USER' ? 'user' as const : 'group' as const),
+          type: info?.type ?? (box.midType === 'USER' ? ('user' as const) : ('group' as const)),
           display_name: info?.name ?? box.id,
           member_count: info?.memberCount,
         })
@@ -315,7 +307,7 @@ export class LineClient {
   async sendMessage(chatId: string, text: string): Promise<LineSendResult> {
     try {
       const client = this.ensureClient()
-      let sent;
+      let sent
 
       try {
         sent = await client.base.talk.sendMessage({ to: chatId, text, e2ee: true })

package/src/platforms/line/commands/auth.test.ts

@@ -42,7 +42,8 @@ beforeEach(() => {
   setCurrentAccountSpy = spyOn(LineCredentialManager.prototype, 'setCurrentAccount').mockResolvedValue(undefined)
   removeAccountSpy = spyOn(LineCredentialManager.prototype, 'removeAccount').mockResolvedValue(undefined)
   clearAllSpy = spyOn(LineCredentialManager.prototype, 'clearAll').mockResolvedValue(undefined)
-  consoleLogSpy = mock((..._args: unknown[]) => {}); console.log = consoleLogSpy
+  consoleLogSpy = mock((..._args: unknown[]) => {})
+  console.log = consoleLogSpy
 })
 
 afterEach(() => {

package/src/platforms/line/commands/chat.test.ts

@@ -37,7 +37,8 @@ beforeEach(() => {
   ])
 
   closeSpy = spyOn(LineClient.prototype, 'close').mockImplementation(() => {})
-  consoleLogSpy = mock((..._args: unknown[]) => {}); console.log = consoleLogSpy
+  consoleLogSpy = mock((..._args: unknown[]) => {})
+  console.log = consoleLogSpy
 })
 
 afterEach(() => {

package/src/platforms/line/commands/chat.ts

@@ -5,10 +5,7 @@ import { formatOutput } from '@/shared/utils/output'
 
 import { LineClient } from '../client'
 
-async function listAction(options: {
-  limit?: string
-  pretty?: boolean
-}): Promise<void> {
+async function listAction(options: { limit?: string; pretty?: boolean }): Promise<void> {
   let client: LineClient | undefined
   try {
     client = await new LineClient().login()

package/src/platforms/line/commands/friend.test.ts

@@ -31,7 +31,8 @@ beforeEach(() => {
   ])
 
   closeSpy = spyOn(LineClient.prototype, 'close').mockImplementation(() => {})
-  consoleLogSpy = mock((..._args: unknown[]) => {}); console.log = consoleLogSpy
+  consoleLogSpy = mock((..._args: unknown[]) => {})
+  console.log = consoleLogSpy
 })
 
 afterEach(() => {

package/src/platforms/line/commands/message.test.ts

@@ -43,7 +43,8 @@ beforeEach(() => {
   })
 
   closeSpy = spyOn(LineClient.prototype, 'close').mockImplementation(() => {})
-  consoleLogSpy = mock((..._args: unknown[]) => {}); console.log = consoleLogSpy
+  consoleLogSpy = mock((..._args: unknown[]) => {})
+  console.log = consoleLogSpy
 })
 
 afterEach(() => {

package/src/platforms/line/commands/message.ts

@@ -5,10 +5,7 @@ import { formatOutput } from '@/shared/utils/output'
 
 import { LineClient } from '../client'
 
-async function listAction(
-  chatId: string,
-  options: { count?: string; pretty?: boolean },
-): Promise<void> {
+async function listAction(chatId: string, options: { count?: string; pretty?: boolean }): Promise<void> {
   let client: LineClient | undefined
   try {
     client = await new LineClient().login()
@@ -22,11 +19,7 @@ async function listAction(
   }
 }
 
-async function sendAction(
-  chatId: string,
-  text: string,
-  options: { pretty?: boolean },
-): Promise<void> {
+async function sendAction(chatId: string, text: string, options: { pretty?: boolean }): Promise<void> {
   let client: LineClient | undefined
   try {
     client = await new LineClient().login()

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

@@ -23,7 +23,8 @@ beforeEach(() => {
   })
 
   closeSpy = spyOn(LineClient.prototype, 'close').mockImplementation(() => {})
-  consoleLogSpy = mock((..._args: unknown[]) => {}); console.log = consoleLogSpy
+  consoleLogSpy = mock((..._args: unknown[]) => {})
+  console.log = consoleLogSpy
 })
 
 afterEach(() => {

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

@@ -1,9 +1,8 @@
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
 import { mkdir, rm, stat } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 
-import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
-
 import { LineCredentialManager } from './credential-manager'
 import type { LineAccountCredentials } from './types'
 

package/src/platforms/line/index.test.ts

@@ -1,4 +1,5 @@
 import { expect, test } from 'bun:test'
+
 import {
   CredentialManager,
   LineAccountCredentialsSchema,

package/src/platforms/line/listener.ts

@@ -72,7 +72,7 @@ export class LineListener {
         try {
           const toType = msg.raw.toType
           const isGroupOrRoom = toType === 'GROUP' || toType === 'ROOM' || toType === 0 || toType === 1
-          const chatId = isGroupOrRoom ? msg.to.id : (msg.isMyMessage ? msg.to.id : msg.from.id)
+          const chatId = isGroupOrRoom ? msg.to.id : msg.isMyMessage ? msg.to.id : msg.from.id
 
           const event: LinePushMessageEvent = {
             type: 'message',

package/src/platforms/line/types.test.ts

@@ -1,4 +1,5 @@
 import { describe, test, expect } from 'bun:test'
+
 import {
   LineError,
   LineChatSchema,

package/src/platforms/slack/cli.ts

@@ -40,7 +40,9 @@ const program = new Command()
 
 program
   .name('agent-slack')
-  .description('CLI tool for Slack communication with token extraction from the desktop app or a supported Chromium browser')
+  .description(
+    'CLI tool for Slack communication with token extraction from the desktop app or a supported Chromium browser',
+  )
   .version(pkg.version)
   .option('--workspace <id>', 'Use specific workspace')
 

package/src/platforms/slack/client-mappers.ts

@@ -0,0 +1,297 @@
+import type {
+  SlackBookmark,
+  SlackChannel,
+  SlackDM,
+  SlackFile,
+  SlackMessage,
+  SlackPin,
+  SlackReminder,
+  SlackSavedItem,
+  SlackScheduledMessage,
+  SlackUser,
+  SlackUserProfile,
+  SlackUsergroup,
+} from './types'
+
+function toRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === 'object' ? (value as Record<string, unknown>) : {}
+}
+
+function toString(value: unknown, fallback = ''): string {
+  return typeof value === 'string' ? value : fallback
+}
+
+function toNumber(value: unknown, fallback = 0): number {
+  return typeof value === 'number' ? value : fallback
+}
+
+function toBoolean(value: unknown, fallback = false): boolean {
+  return typeof value === 'boolean' ? value : fallback
+}
+
+function toStringArray(value: unknown): string[] {
+  return Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string') : []
+}
+
+function toOptionalStringArray(value: unknown): string[] | undefined {
+  return Array.isArray(value) ? toStringArray(value) : undefined
+}
+
+export function mapChannel(channel: unknown, defaults?: Partial<Pick<SlackChannel, 'id' | 'name'>>): SlackChannel {
+  const record = toRecord(channel)
+  const topicRecord = record.topic ? toRecord(record.topic) : null
+  const purposeRecord = record.purpose ? toRecord(record.purpose) : null
+
+  return {
+    id: toString(record.id, defaults?.id ?? ''),
+    name: toString(record.name, defaults?.name ?? ''),
+    is_private: toBoolean(record.is_private),
+    is_archived: toBoolean(record.is_archived),
+    created: toNumber(record.created),
+    creator: toString(record.creator),
+    topic: topicRecord
+      ? {
+          value: toString(topicRecord.value),
+          creator: toString(topicRecord.creator),
+          last_set: toNumber(topicRecord.last_set),
+        }
+      : undefined,
+    purpose: purposeRecord
+      ? {
+          value: toString(purposeRecord.value),
+          creator: toString(purposeRecord.creator),
+          last_set: toNumber(purposeRecord.last_set),
+        }
+      : undefined,
+  }
+}
+
+export function mapDM(channel: unknown): SlackDM {
+  const record = toRecord(channel)
+  return {
+    id: toString(record.id),
+    user: toString(record.user, toString(record.name)),
+    is_mpim: toBoolean(record.is_mpim),
+  }
+}
+
+export function mapFile(
+  file: unknown,
+  defaults?: Partial<Pick<SlackFile, 'id' | 'name' | 'title' | 'url_private'>>,
+): SlackFile {
+  const record = toRecord(file)
+  return {
+    id: toString(record.id, defaults?.id ?? ''),
+    name: toString(record.name, defaults?.name ?? ''),
+    title: toString(record.title, defaults?.title ?? toString(record.name, defaults?.name ?? '')),
+    mimetype: toString(record.mimetype, 'application/octet-stream'),
+    size: toNumber(record.size),
+    url_private: toString(record.url_private, defaults?.url_private ?? ''),
+    created: toNumber(record.created),
+    user: toString(record.user),
+    channels: toOptionalStringArray(record.channels),
+  }
+}
+
+function mapEdited(edited: unknown): SlackMessage['edited'] {
+  const record = toRecord(edited)
+  return {
+    user: toString(record.user),
+    ts: toString(record.ts),
+  }
+}
+
+function mapReplies(replies: unknown): SlackMessage['replies'] {
+  if (!Array.isArray(replies)) return undefined
+  return replies.map((reply) => {
+    const record = toRecord(reply)
+    return {
+      user: toString(record.user),
+      ts: toString(record.ts),
+    }
+  })
+}
+
+function mapReactions(reactions: unknown): SlackMessage['reactions'] {
+  if (!Array.isArray(reactions)) return undefined
+  return reactions.map((reaction) => {
+    const record = toRecord(reaction)
+    return {
+      name: toString(record.name),
+      count: toNumber(record.count),
+      users: toStringArray(record.users),
+    }
+  })
+}
+
+export function mapMessage(
+  message: unknown,
+  defaults?: Partial<Pick<SlackMessage, 'ts' | 'text' | 'type'>>,
+): SlackMessage {
+  const record = toRecord(message)
+  const files = Array.isArray(record.files) ? record.files.map((file) => mapFile(file)) : undefined
+
+  return {
+    ts: toString(record.ts, defaults?.ts ?? ''),
+    text: toString(record.text, defaults?.text ?? ''),
+    type: toString(record.type, defaults?.type ?? 'message'),
+    user: typeof record.user === 'string' ? record.user : undefined,
+    username: typeof record.username === 'string' ? record.username : undefined,
+    thread_ts: typeof record.thread_ts === 'string' ? record.thread_ts : undefined,
+    reply_count: typeof record.reply_count === 'number' ? record.reply_count : undefined,
+    replies: mapReplies(record.replies),
+    edited: record.edited ? mapEdited(record.edited) : undefined,
+    reactions: mapReactions(record.reactions),
+    files,
+  }
+}
+
+export function mapUser(user: unknown): SlackUser {
+  const record = toRecord(user)
+  const profileRecord = record.profile ? toRecord(record.profile) : null
+
+  return {
+    id: toString(record.id),
+    name: toString(record.name),
+    real_name: toString(record.real_name, toString(record.name)),
+    is_admin: toBoolean(record.is_admin),
+    is_owner: toBoolean(record.is_owner),
+    is_bot: toBoolean(record.is_bot),
+    is_app_user: toBoolean(record.is_app_user),
+    profile: profileRecord
+      ? {
+          email: typeof profileRecord.email === 'string' ? profileRecord.email : undefined,
+          phone: typeof profileRecord.phone === 'string' ? profileRecord.phone : undefined,
+          title: typeof profileRecord.title === 'string' ? profileRecord.title : undefined,
+          status_text: typeof profileRecord.status_text === 'string' ? profileRecord.status_text : undefined,
+        }
+      : undefined,
+  }
+}
+
+export function mapUserProfile(profile: unknown): SlackUserProfile {
+  const record = toRecord(profile)
+  return {
+    title: typeof record.title === 'string' ? record.title : undefined,
+    phone: typeof record.phone === 'string' ? record.phone : undefined,
+    skype: typeof record.skype === 'string' ? record.skype : undefined,
+    real_name: typeof record.real_name === 'string' ? record.real_name : undefined,
+    real_name_normalized: typeof record.real_name_normalized === 'string' ? record.real_name_normalized : undefined,
+    display_name: typeof record.display_name === 'string' ? record.display_name : undefined,
+    display_name_normalized:
+      typeof record.display_name_normalized === 'string' ? record.display_name_normalized : undefined,
+    status_text: typeof record.status_text === 'string' ? record.status_text : undefined,
+    status_emoji: typeof record.status_emoji === 'string' ? record.status_emoji : undefined,
+    status_expiration: typeof record.status_expiration === 'number' ? record.status_expiration : undefined,
+    email: typeof record.email === 'string' ? record.email : undefined,
+    first_name: typeof record.first_name === 'string' ? record.first_name : undefined,
+    last_name: typeof record.last_name === 'string' ? record.last_name : undefined,
+    image_24: typeof record.image_24 === 'string' ? record.image_24 : undefined,
+    image_32: typeof record.image_32 === 'string' ? record.image_32 : undefined,
+    image_48: typeof record.image_48 === 'string' ? record.image_48 : undefined,
+    image_72: typeof record.image_72 === 'string' ? record.image_72 : undefined,
+    image_192: typeof record.image_192 === 'string' ? record.image_192 : undefined,
+    image_512: typeof record.image_512 === 'string' ? record.image_512 : undefined,
+  }
+}
+
+export function mapSavedItem(item: unknown): SlackSavedItem {
+  const record = toRecord(item)
+  const channelRecord = toRecord(record.channel)
+  return {
+    type: toString(record.type, 'message'),
+    message: mapMessage(record.message),
+    channel: {
+      id: toString(channelRecord.id),
+      name: toString(channelRecord.name),
+    },
+    date_created: toNumber(record.date_created),
+  }
+}
+
+export function mapPin(item: unknown, channel: string): SlackPin {
+  const record = toRecord(item)
+  return {
+    channel,
+    message: mapMessage(record.message),
+    date_created: toNumber(record.created),
+    created_by: toString(record.created_by),
+  }
+}
+
+export function mapBookmark(
+  bookmark: unknown,
+  defaults?: Partial<Pick<SlackBookmark, 'id' | 'channel_id' | 'title' | 'link' | 'type'>>,
+): SlackBookmark {
+  const record = toRecord(bookmark)
+  return {
+    id: toString(record.id, defaults?.id ?? ''),
+    channel_id: toString(record.channel_id, defaults?.channel_id ?? ''),
+    title: toString(record.title, defaults?.title ?? ''),
+    link: toString(record.link, defaults?.link ?? ''),
+    emoji: typeof record.emoji === 'string' ? record.emoji : undefined,
+    icon_url: typeof record.icon_url === 'string' ? record.icon_url : undefined,
+    type: toString(record.type, defaults?.type ?? 'link'),
+    date_created: toNumber(record.date_created),
+    date_updated: toNumber(record.date_updated),
+    created_by: toString(record.created_by),
+  }
+}
+
+export function mapScheduledMessage(
+  message: unknown,
+  defaults?: Partial<Pick<SlackScheduledMessage, 'channel_id' | 'post_at' | 'date_created' | 'text'>>,
+): SlackScheduledMessage {
+  const record = toRecord(message)
+  return {
+    id: toString(record.id, toString(record.scheduled_message_id)),
+    channel_id: toString(record.channel_id, defaults?.channel_id ?? ''),
+    post_at: toNumber(record.post_at, defaults?.post_at ?? 0),
+    date_created: toNumber(record.date_created, defaults?.date_created ?? 0),
+    text: toString(record.text, defaults?.text ?? ''),
+  }
+}
+
+export function mapReminder(
+  reminder: unknown,
+  defaults?: Partial<Pick<SlackReminder, 'text' | 'time'>>,
+): SlackReminder {
+  const record = toRecord(reminder)
+  return {
+    id: toString(record.id),
+    creator: toString(record.creator),
+    text: toString(record.text, defaults?.text ?? ''),
+    user: toString(record.user),
+    recurring: toBoolean(record.recurring),
+    time: toNumber(record.time, defaults?.time ?? 0),
+    complete_ts: toNumber(record.complete_ts),
+  }
+}
+
+export function mapUsergroup(usergroup: unknown): SlackUsergroup {
+  const record = toRecord(usergroup)
+  const prefs = toRecord(record.prefs)
+
+  return {
+    id: toString(record.id),
+    team_id: toString(record.team_id),
+    name: toString(record.name),
+    handle: toString(record.handle),
+    description: toString(record.description),
+    is_external: toBoolean(record.is_external),
+    is_usergroup: toBoolean(record.is_usergroup),
+    date_create: toNumber(record.date_create),
+    date_update: toNumber(record.date_update),
+    date_delete: toNumber(record.date_delete),
+    auto_type: typeof record.auto_type === 'string' ? record.auto_type : null,
+    created_by: toString(record.created_by),
+    updated_by: toString(record.updated_by),
+    deleted_by: typeof record.deleted_by === 'string' ? record.deleted_by : null,
+    prefs: {
+      channels: toStringArray(prefs.channels),
+      groups: toStringArray(prefs.groups),
+    },
+    users: toStringArray(record.users),
+    user_count: toNumber(record.user_count),
+  }
+}