@vellumai/assistant 0.10.3-dev.202606252138.db46320 → 0.10.3-dev.202606252237.df0fc92

package/openapi.yaml

@@ -17426,6 +17426,30 @@ paths:
                                 webUrl:
                                   type: string
                               additionalProperties: false
+                            eventKind:
+                              type: string
+                              enum:
+                                - message
+                                - reaction
+                            reaction:
+                              type: object
+                              properties:
+                                emoji:
+                                  type: string
+                                op:
+                                  type: string
+                                  enum:
+                                    - added
+                                    - removed
+                                actorDisplayName:
+                                  type: string
+                                targetChannelTs:
+                                  type: string
+                              required:
+                                - emoji
+                                - op
+                                - targetChannelTs
+                              additionalProperties: false
                           required:
                             - channelId
                             - channelTs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.10.3-dev.202606252138.db46320",
+  "version": "0.10.3-dev.202606252237.df0fc92",
   "license": "MIT",
   "type": "module",
   "exports": {

package/src/__tests__/list-messages-page-latest.test.ts

@@ -109,6 +109,13 @@ interface MessagePayload {
     sender?: { displayName?: string; externalUserId?: string };
     messageLink?: { appUrl?: string; webUrl?: string };
     threadLink?: { appUrl?: string; webUrl?: string };
+    eventKind?: "message" | "reaction";
+    reaction?: {
+      emoji: string;
+      op: "added" | "removed";
+      actorDisplayName?: string;
+      targetChannelTs: string;
+    };
   };
 }
 
@@ -482,6 +489,7 @@ describe("handleListMessages page=latest", () => {
         webUrl:
           "https://example.slack.com/archives/C123ABCDEF/p1710000000000100",
       },
+      eventKind: "message",
     });
   });
 
@@ -527,6 +535,7 @@ describe("handleListMessages page=latest", () => {
         webUrl:
           "https://example.slack.com/archives/C123ABCDEF/p1710000000000200",
       },
+      eventKind: "message",
     });
   });
 

package/src/api/responses/conversation-message.ts

@@ -283,6 +283,13 @@ const SlackMessageLinkSchema = z.object({
   webUrl: z.string().optional(),
 });
 
+const SlackReactionSchema = z.object({
+  emoji: z.string(),
+  op: z.enum(["added", "removed"]),
+  actorDisplayName: z.string().optional(),
+  targetChannelTs: z.string(),
+});
+
 /** Slack provenance for a history row that originated from a Slack channel. */
 export const ConversationSlackMessageSchema = z.object({
   channelId: z.string(),
@@ -297,6 +304,8 @@ export const ConversationSlackMessageSchema = z.object({
     .optional(),
   messageLink: SlackMessageLinkSchema.optional(),
   threadLink: SlackMessageLinkSchema.optional(),
+  eventKind: z.enum(["message", "reaction"]).optional(),
+  reaction: SlackReactionSchema.optional(),
 });
 export type ConversationSlackMessage = z.infer<
   typeof ConversationSlackMessageSchema

package/src/messaging/channel-binding-metadata.ts

@@ -1,5 +1,5 @@
 import type { ExternalConversationBinding } from "../memory/external-conversation-store.js";
-import type { ChannelBindingMetadata } from "./provider-types.js";
+import type { ChannelBindingMetadata } from "./channel-binding-schema.js";
 import { buildSlackBindingMetadata } from "./providers/slack/binding-metadata.js";
 
 type BindingMetadataBuilder = (

package/src/messaging/channel-binding-schema.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+
+const slackThreadSchema = z.object({
+  channelId: z.string(),
+  threadTs: z.string(),
+  link: z
+    .object({
+      appUrl: z.string().optional(),
+      webUrl: z.string().optional(),
+    })
+    .optional(),
+});
+
+const slackChannelSchema = z.object({
+  channelId: z.string(),
+  name: z.string().optional(),
+  link: z.object({ webUrl: z.string() }).optional(),
+});
+
+/**
+ * Wire shape of a serialized conversation channel binding — the single source
+ * of truth for this contract.
+ *
+ * Consumed as a route `responseBody` (which drives `openapi.yaml` generation
+ * and, in turn, the web client's generated daemon types), and the server-side
+ * builders derive their TypeScript types from it via `z.infer`. The shape is
+ * therefore declared exactly once.
+ */
+export const channelBindingSchema = z.object({
+  sourceChannel: z.string(),
+  externalChatId: z.string(),
+  externalChatName: z.string().optional(),
+  externalThreadId: z.string().optional(),
+  externalUserId: z.string().nullable(),
+  displayName: z.string().nullable(),
+  username: z.string().nullable(),
+  slackThread: slackThreadSchema.optional(),
+  slackChannel: slackChannelSchema.optional(),
+});
+
+type ChannelBinding = z.infer<typeof channelBindingSchema>;
+
+/**
+ * The channel-specific fields a per-channel builder contributes to a binding
+ * (everything beyond the channel-neutral base). Picked from the schema above
+ * so a builder's output can never drift from the wire contract.
+ */
+export type ChannelBindingMetadata = Pick<
+  ChannelBinding,
+  "externalChatName" | "slackThread" | "slackChannel"
+>;

package/src/messaging/provider-types.ts

@@ -1,13 +1,5 @@
 /** Platform-agnostic types for the messaging provider abstraction. */
 
-/**
- * Extra, channel-specific fields a channel contributes to a serialized
- * conversation channel binding (e.g. deep links back to the source message).
- * Additive by design: each channel returns its own fields, so this is an open
- * record rather than a committed cross-channel schema.
- */
-export type ChannelBindingMetadata = Record<string, unknown>;
-
 export interface Conversation {
   id: string;
   name: string;

package/src/messaging/providers/slack/binding-metadata.ts

@@ -1,6 +1,6 @@
 import { getConfig } from "../../../config/loader.js";
 import type { ExternalConversationBinding } from "../../../memory/external-conversation-store.js";
-import type { ChannelBindingMetadata } from "../../provider-types.js";
+import type { ChannelBindingMetadata } from "../../channel-binding-schema.js";
 import {
   buildSlackMessageDeepLinks,
   buildSlackWebChannelUrl,
@@ -12,10 +12,12 @@ import {
  * links that jump back to the source thread and channel in the Slack app or
  * web client.
  *
- * The returned fields are spread onto the channel-neutral binding by the
- * serializer — Slack is the only channel that can currently produce
- * message-level deep links, because the link inputs (workspace team id/url +
- * a stable per-message timestamp) only exist for Slack.
+ * The return type is derived from the channel-binding Zod schema
+ * (`ChannelBindingMetadata`) — the single source of truth that also drives
+ * `openapi.yaml` and the web client's generated types — so this builder cannot
+ * drift from the wire contract. Slack is the only channel that can currently
+ * produce message-level deep links, because the link inputs (workspace team
+ * id/url + a stable per-message timestamp) only exist for Slack.
  */
 export function buildSlackBindingMetadata(
   binding: ExternalConversationBinding,

package/src/runtime/routes/conversation-list-routes.ts

@@ -31,6 +31,7 @@ import {
 import type { ConversationType } from "../../memory/conversation-types.js";
 import { getBindingsForConversations } from "../../memory/external-conversation-store.js";
 import { listGroups } from "../../memory/group-crud.js";
+import { channelBindingSchema } from "../../messaging/channel-binding-schema.js";
 import { UserError } from "../../util/errors.js";
 import { getLogger } from "../../util/logger.js";
 import { ACTOR_PRINCIPALS } from "../auth/route-policy.js";
@@ -86,35 +87,6 @@ const assistantAttentionSchema = z.object({
     .optional(),
 });
 
-const slackThreadSchema = z.object({
-  channelId: z.string(),
-  threadTs: z.string(),
-  link: z
-    .object({
-      appUrl: z.string().optional(),
-      webUrl: z.string().optional(),
-    })
-    .optional(),
-});
-
-const slackChannelSchema = z.object({
-  channelId: z.string(),
-  name: z.string().optional(),
-  link: z.object({ webUrl: z.string() }).optional(),
-});
-
-const channelBindingSchema = z.object({
-  sourceChannel: z.string(),
-  externalChatId: z.string(),
-  externalChatName: z.string().optional(),
-  externalThreadId: z.string().optional(),
-  externalUserId: z.string().nullable(),
-  displayName: z.string().nullable(),
-  username: z.string().nullable(),
-  slackThread: slackThreadSchema.optional(),
-  slackChannel: slackChannelSchema.optional(),
-});
-
 const forkParentSchema = z.object({
   conversationId: z.string(),
   messageId: z.string(),

package/src/runtime/routes/conversation-routes.ts

@@ -394,6 +394,8 @@ function buildSlackHistoryMessage(
       : {}),
     ...(messageLink ? { messageLink } : {}),
     ...(threadLink ? { threadLink } : {}),
+    ...(slackMeta.eventKind ? { eventKind: slackMeta.eventKind } : {}),
+    ...(slackMeta.reaction ? { reaction: slackMeta.reaction } : {}),
   };
 }