agent-messenger 2.0.0 → 2.1.0

package/src/platforms/webex/types.ts

@@ -0,0 +1,127 @@
+import { z } from 'zod'
+
+export interface WebexSpace {
+  id: string
+  title: string
+  type: 'group' | 'direct'
+  isLocked: boolean
+  teamId?: string
+  lastActivity: string
+  created: string
+  creatorId: string
+}
+
+export interface WebexMessage {
+  id: string
+  roomId: string
+  roomType: 'group' | 'direct'
+  text?: string
+  markdown?: string
+  html?: string
+  files?: string[]
+  personId: string
+  personEmail: string
+  created: string
+  parentId?: string
+  mentionedPeople?: string[]
+}
+
+export interface WebexPerson {
+  id: string
+  emails: string[]
+  displayName: string
+  nickName?: string
+  firstName?: string
+  lastName?: string
+  avatar?: string
+  orgId: string
+  type: 'person' | 'bot'
+  created: string
+}
+
+export interface WebexMembership {
+  id: string
+  roomId: string
+  personId: string
+  personEmail: string
+  personDisplayName: string
+  isModerator: boolean
+  created: string
+}
+
+export interface WebexConfig {
+  accessToken: string
+  refreshToken: string
+  expiresAt: number
+  clientId?: string
+  clientSecret?: string
+  tokenType?: 'oauth' | 'manual'
+}
+
+export class WebexError extends Error {
+  code: string
+
+  constructor(message: string, code: string) {
+    super(message)
+    this.name = 'WebexError'
+    this.code = code
+  }
+}
+
+export const WebexSpaceSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  type: z.enum(['group', 'direct']),
+  isLocked: z.boolean(),
+  teamId: z.string().optional(),
+  lastActivity: z.string(),
+  created: z.string(),
+  creatorId: z.string(),
+})
+
+export const WebexMessageSchema = z.object({
+  id: z.string(),
+  roomId: z.string(),
+  roomType: z.enum(['group', 'direct']),
+  text: z.string().optional(),
+  markdown: z.string().optional(),
+  html: z.string().optional(),
+  files: z.array(z.string()).optional(),
+  personId: z.string(),
+  personEmail: z.string(),
+  created: z.string(),
+  parentId: z.string().optional(),
+  mentionedPeople: z.array(z.string()).optional(),
+})
+
+export const WebexPersonSchema = z.object({
+  id: z.string(),
+  emails: z.array(z.string()),
+  displayName: z.string(),
+  nickName: z.string().optional(),
+  firstName: z.string().optional(),
+  lastName: z.string().optional(),
+  avatar: z.string().optional(),
+  orgId: z.string(),
+  type: z.enum(['person', 'bot']),
+  created: z.string(),
+})
+
+export const WebexMembershipSchema = z.object({
+  id: z.string(),
+  roomId: z.string(),
+  personId: z.string(),
+  personEmail: z.string(),
+  personDisplayName: z.string(),
+  isModerator: z.boolean(),
+  created: z.string(),
+})
+
+export const WebexConfigSchema = z.object({
+  accessToken: z.string(),
+  refreshToken: z.string(),
+  expiresAt: z.number(),
+  clientId: z.string().optional(),
+  clientSecret: z.string().optional(),
+  tokenType: z.enum(['oauth', 'manual']).optional(),
+})

package/src/tui/adapters/webex-adapter.ts

@@ -0,0 +1,103 @@
+import { exec } from 'node:child_process'
+
+import { WebexClient } from '@/platforms/webex/client'
+import { WebexCredentialManager } from '@/platforms/webex/credential-manager'
+import { getWebexAppCredentials } from '@/platforms/webex/app-config'
+
+import type { AuthHint, AuthIO, PlatformAdapter, UnifiedChannel, UnifiedMessage } from './types'
+
+export class WebexAdapter implements PlatformAdapter {
+  readonly name = 'Webex'
+
+  private client: WebexClient | null = null
+  private personEmail: string | null = null
+
+  async login(): Promise<void> {
+    const client = new WebexClient()
+    await client.login()
+    const me = await client.testAuth()
+    this.client = client
+    this.personEmail = me.emails[0] ?? null
+  }
+
+  async getChannels(): Promise<UnifiedChannel[]> {
+    this.ensureClient()
+    const spaces = await this.client!.listSpaces()
+    return spaces.map((space) => ({
+      id: space.id,
+      name: space.title,
+    }))
+  }
+
+  async getMessages(channelId: string, limit = 50): Promise<UnifiedMessage[]> {
+    this.ensureClient()
+    const messages = await this.client!.listMessages(channelId, { max: limit })
+    return messages
+      .map((msg) => ({
+        id: msg.id,
+        channelId: msg.roomId,
+        author: msg.personEmail,
+        content: msg.text ?? '',
+        timestamp: msg.created,
+      }))
+      .reverse()
+  }
+
+  async sendMessage(channelId: string, text: string): Promise<void> {
+    this.ensureClient()
+    await this.client!.sendMessage(channelId, text)
+  }
+
+  getAuthHint(): AuthHint {
+    return {
+      command: 'agent-webex auth login',
+      description: 'Authenticate with Cisco Webex using OAuth Device Grant. Run the command below to start.',
+    }
+  }
+
+  async authenticate(io: AuthIO): Promise<void> {
+    const credManager = new WebexCredentialManager()
+    const { clientId, clientSecret } = getWebexAppCredentials()
+
+    io.print('Starting Webex OAuth Device Grant flow...')
+    const device = await credManager.requestDeviceCode(clientId)
+
+    io.print(`\nOpen this URL in your browser:\n  ${device.verificationUriComplete}`)
+    io.print(`\nOr go to ${device.verificationUri} and enter code: ${device.userCode}`)
+    openBrowser(device.verificationUriComplete)
+    io.print('\nWaiting for authorization...')
+
+    const config = await credManager.pollDeviceToken(
+      device.deviceCode,
+      device.interval,
+      device.expiresIn,
+      clientId,
+      clientSecret,
+    )
+    await credManager.saveConfig(config)
+
+    const client = new WebexClient()
+    await client.login({ token: config.accessToken })
+    const me = await client.testAuth()
+    this.client = client
+    this.personEmail = me.emails[0] ?? null
+
+    io.print(`\nAuthenticated as ${me.displayName} (${this.personEmail})`)
+  }
+
+  private ensureClient(): void {
+    if (!this.client) {
+      throw new Error('Not logged in. Call login() first.')
+    }
+  }
+}
+
+function openBrowser(url: string): void {
+  const command =
+    process.platform === 'darwin'
+      ? `open "${url}"`
+      : process.platform === 'win32'
+        ? `start "" "${url}"`
+        : `xdg-open "${url}"`
+  exec(command)
+}

package/src/tui/app.ts

@@ -3,6 +3,7 @@ import blessed from 'blessed'
 import { SlackAdapter } from './adapters/slack-adapter'
 import { DiscordAdapter } from './adapters/discord-adapter'
 import { TeamsAdapter } from './adapters/teams-adapter'
+import { WebexAdapter } from './adapters/webex-adapter'
 import { TelegramAdapter } from './adapters/telegram-adapter'
 import { WhatsAppAdapter } from './adapters/whatsapp-adapter'
 import { LineAdapter } from './adapters/line-adapter'
@@ -38,6 +39,7 @@ export async function createApp(): Promise<void> {
     { adapter: new SlackAdapter(), label: 'Slack', enabled: false, channels: null, workspaces: null, listening: false, lastChannelId: null },
     { adapter: new DiscordAdapter(), label: 'Discord', enabled: false, channels: null, workspaces: null, listening: false, lastChannelId: null },
     { adapter: new TeamsAdapter(), label: 'Teams', enabled: false, channels: null, workspaces: null, listening: false, lastChannelId: null },
+    { adapter: new WebexAdapter(), label: 'Webex', enabled: false, channels: null, workspaces: null, listening: false, lastChannelId: null },
     { adapter: new TelegramAdapter(), label: 'Telegram', enabled: false, channels: null, workspaces: null, listening: false, lastChannelId: null },
     { adapter: new WhatsAppAdapter(), label: 'WhatsApp', enabled: false, channels: null, workspaces: null, listening: false, lastChannelId: null },
     { adapter: new LineAdapter(), label: 'LINE', enabled: false, channels: null, workspaces: null, listening: false, lastChannelId: null },