agent-messenger 2.23.2 → 2.23.3

package/src/platforms/webex/typings/webex-message-handler.d.ts

@@ -155,6 +155,8 @@ declare module 'webex-message-handler' {
   export interface DecryptedMessage {
     /** Mercury activity UUID. Works as parentId for threaded replies. */
     id: string
+    /** Raw UUID ref for `id`. */
+    ref: string
     /**
      * Full Conversation-service activity URL, when present on the raw Mercury
      * activity (e.g. for an outbound "acknowledge" read-receipt). Undefined if
@@ -163,8 +165,14 @@ declare module 'webex-message-handler' {
     url?: string
     /** Parent activity UUID for threaded replies. Undefined if not a thread reply. */
     parentId?: string
+    /** Raw UUID ref for `parentId`. Undefined when `parentId` is absent. */
+    parentRef?: string
     roomId: string
+    /** Raw UUID ref for `roomId`. */
+    roomRef: string
     personId: string
+    /** Raw UUID ref for `personId`. */
+    personRef: string
     personEmail: string
     text: string
     html?: string
@@ -172,6 +180,8 @@ declare module 'webex-message-handler' {
     roomType?: string
     /** Person UUIDs mentioned via @mention in the message. */
     mentionedPeople: string[]
+    /** Raw UUID refs for `mentionedPeople`, index-aligned. */
+    mentionedPeopleRefs: string[]
     /** Group mention types (e.g. "all") in the message. */
     mentionedGroups: string[]
     /** File URLs attached to the message. Empty if no files. */
@@ -181,19 +191,33 @@ declare module 'webex-message-handler' {
 
   export interface DeletedMessage {
     messageId: string
+    /** Raw UUID ref for `messageId`. */
+    messageRef: string
     roomId: string
+    /** Raw UUID ref for `roomId`. */
+    roomRef: string
     personId: string
+    /** Raw UUID ref for `personId`. */
+    personRef: string
   }
 
   export interface MembershipActivity {
-    /** Activity ID. */
+    /** Activity ID (raw Mercury activity UUID). */
     id: string
+    /** Raw UUID ref for `id`. Equal to `id` since the activity id is already raw. */
+    ref: string
     /** ID of the person who performed the action. */
     actorId: string
+    /** Raw UUID ref for `actorId`. */
+    actorRef: string
     /** ID of the member affected. */
     personId: string
+    /** Raw UUID ref for `personId`. */
+    personRef: string
     /** Conversation/space ID. */
     roomId: string
+    /** Raw UUID ref for `roomId`. */
+    roomRef: string
     /** Membership action: "add", "leave", "assignModerator", or "unassignModerator". */
     action: string
     /** ISO 8601 timestamp. */
@@ -207,14 +231,22 @@ declare module 'webex-message-handler' {
   export interface AttachmentAction {
     /** Activity ID. */
     id: string
+    /** Raw UUID ref for `id`. */
+    ref: string
     /** ID of the message the card was attached to. */
     messageId: string
+    /** Raw UUID ref for `messageId`. Empty when `messageId` is empty. */
+    messageRef: string
     /** ID of the person who submitted the card. */
     personId: string
+    /** Raw UUID ref for `personId`. */
+    personRef: string
     /** Email of the person who submitted the card. */
     personEmail: string
     /** Conversation/space ID. */
     roomId: string
+    /** Raw UUID ref for `roomId`. */
+    roomRef: string
     /** Card form input values. */
     inputs: Record<string, unknown>
     /** ISO 8601 timestamp. */
@@ -224,12 +256,18 @@ declare module 'webex-message-handler' {
   }
 
   export interface RoomActivity {
-    /** Activity ID. */
+    /** Activity ID (raw Mercury activity UUID). */
     id: string
+    /** Raw UUID ref for `id`. Equal to `id` since the activity id is already raw. */
+    ref: string
     /** Conversation/space ID. */
     roomId: string
+    /** Raw UUID ref for `roomId`. */
+    roomRef: string
     /** ID of the person who performed the action. */
     actorId: string
+    /** Raw UUID ref for `actorId`. */
+    actorRef: string
     /** Room action: "created" or "updated". */
     action: string
     /** ISO 8601 timestamp. */

package/src/platforms/webexbot/commands/file.ts

@@ -5,7 +5,6 @@ import { Command } from 'commander'
 
 import { cliOutput } from '@/shared/utils/cli-output'
 
-import { toRef } from '../../webex/id-normalizer'
 import type { BotOption } from './shared'
 import { getClient } from './shared'
 
@@ -40,9 +39,9 @@ export async function uploadAction(
 
     return {
       id: message.id,
-      ref: toRef(message.id),
+      ref: message.ref,
       roomId: message.roomId,
-      roomRef: toRef(message.roomId),
+      roomRef: message.roomRef,
       files: message.files,
       created: message.created,
     }

package/src/platforms/webexbot/commands/member.ts

@@ -2,7 +2,6 @@ import { Command } from 'commander'
 
 import { cliOutput } from '@/shared/utils/cli-output'
 
-import { toRef } from '../../webex/id-normalizer'
 import type { BotOption } from './shared'
 import { getClient } from './shared'
 
@@ -29,9 +28,9 @@ export async function listAction(space: string, options: BotOption & { max?: str
     return {
       members: members.map((m) => ({
         id: m.id,
-        ref: toRef(m.id),
+        ref: m.ref,
         personId: m.personId,
-        personRef: toRef(m.personId),
+        personRef: m.personRef,
         personEmail: m.personEmail,
         personDisplayName: m.personDisplayName,
         isModerator: m.isModerator,

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

@@ -2,7 +2,6 @@ import { Command } from 'commander'
 
 import { cliOutput } from '@/shared/utils/cli-output'
 
-import { toRef } from '../../webex/id-normalizer'
 import type { WebexMessage } from '../../webex/types'
 import type { BotOption } from './shared'
 import { getClient } from './shared'
@@ -33,9 +32,9 @@ interface MessageResult {
 function formatMessage(message: WebexMessage): MessageResult {
   return {
     id: message.id,
-    ref: toRef(message.id),
+    ref: message.ref,
     roomId: message.roomId,
-    roomRef: toRef(message.roomId),
+    roomRef: message.roomRef,
     text: message.text,
     markdown: message.markdown,
     html: message.html,
@@ -88,9 +87,9 @@ export async function repliesAction(
     return {
       messages: messages.map((msg) => ({
         id: msg.id,
-        ref: toRef(msg.id),
+        ref: msg.ref,
         roomId: msg.roomId,
-        roomRef: toRef(msg.roomId),
+        roomRef: msg.roomRef,
         text: msg.text,
         personEmail: msg.personEmail,
         created: msg.created,
@@ -125,9 +124,9 @@ export async function listAction(space: string, options: BotOption & { max?: str
     return {
       messages: messages.map((msg) => ({
         id: msg.id,
-        ref: toRef(msg.id),
+        ref: msg.ref,
         roomId: msg.roomId,
-        roomRef: toRef(msg.roomId),
+        roomRef: msg.roomRef,
         text: msg.text,
         personEmail: msg.personEmail,
         created: msg.created,

package/src/platforms/webexbot/commands/snapshot.ts

@@ -34,7 +34,7 @@ export async function snapshotAction(options: BotOption & { full?: boolean; max?
     const result: SnapshotResult = {
       bot: {
         id: me.id,
-        ref: toRef(me.id),
+        ref: me.ref,
         displayName: me.displayName,
         emails: me.emails,
       },

package/src/platforms/webexbot/commands/user.test.ts

@@ -12,9 +12,11 @@ const mockListPeople = mock(() =>
   Promise.resolve([
     {
       id: personId,
+      ref: 'p1',
       emails: ['alice@example.com'],
       displayName: 'Alice',
       orgId,
+      orgRef: 'o1',
       type: 'person' as const,
       created: '',
     },
@@ -24,9 +26,11 @@ const mockListPeople = mock(() =>
 const mockGetPerson = mock(() =>
   Promise.resolve({
     id: personId,
+    ref: 'p1',
     emails: ['alice@example.com'],
     displayName: 'Alice',
     orgId,
+    orgRef: 'o1',
     type: 'person' as const,
     created: '2024-01-01T00:00:00Z',
   }),

package/src/platforms/webexbot/commands/user.ts

@@ -2,7 +2,6 @@ import { Command } from 'commander'
 
 import { cliOutput } from '@/shared/utils/cli-output'
 
-import { toRef } from '../../webex/id-normalizer'
 import type { WebexPerson } from '../../webex/types'
 import type { BotOption } from './shared'
 import { getClient } from './shared'
@@ -33,7 +32,7 @@ interface UserResult {
 function formatPerson(person: WebexPerson): UserResult {
   return {
     id: person.id,
-    ref: toRef(person.id),
+    ref: person.ref,
     emails: person.emails,
     displayName: person.displayName,
     nickName: person.nickName,
@@ -41,7 +40,7 @@ function formatPerson(person: WebexPerson): UserResult {
     lastName: person.lastName,
     avatar: person.avatar,
     orgId: person.orgId,
-    orgRef: toRef(person.orgId),
+    orgRef: person.orgRef,
     type: person.type,
     created: person.created,
   }
@@ -58,7 +57,7 @@ export async function listAction(
     return {
       users: people.map((p) => ({
         id: p.id,
-        ref: toRef(p.id),
+        ref: p.ref,
         emails: p.emails,
         displayName: p.displayName,
         type: p.type,

package/src/platforms/webexbot/commands/whoami.ts

@@ -2,7 +2,6 @@ import { Command } from 'commander'
 
 import { cliOutput } from '@/shared/utils/cli-output'
 
-import { toRef } from '../../webex/id-normalizer'
 import type { BotOption } from './shared'
 import { getClient } from './shared'
 
@@ -25,12 +24,12 @@ export async function whoamiAction(options: BotOption): Promise<WhoamiResult> {
     const info = await client.testAuth()
     return {
       id: info.id,
-      ref: toRef(info.id),
+      ref: info.ref,
       emails: info.emails,
       displayName: info.displayName,
       avatar: info.avatar,
       orgId: info.orgId,
-      orgRef: toRef(info.orgId),
+      orgRef: info.orgRef,
       type: info.type,
       created: info.created,
     }

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

@@ -37,9 +37,9 @@ export class WebexAdapter implements PlatformAdapter {
     return messages
       .map((msg) => ({
         id: msg.id,
-        ref: toRef(msg.id),
+        ref: msg.ref,
         channelId: msg.roomId,
-        channelRef: toRef(msg.roomId),
+        channelRef: msg.roomRef,
         author: msg.personEmail,
         content: msg.text ?? '',
         timestamp: msg.created,