@builder.io/ai-utils 0.58.1 → 0.60.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.58.1",
+  "version": "0.60.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/claw.d.ts

@@ -78,6 +78,8 @@ export interface WorkerReportOptions {
     originChannelId?: string;
     /** Clickable URL for the origin channel, if the integration already has one. */
     channelUrl?: string;
+    /** Human-readable name for the origin channel, if the integration has one. */
+    channelName?: string;
     /** The report content. */
     content: string;
     /** Agent/tool ID (for sub-agent reports). */
@@ -88,6 +90,8 @@ export interface WorkerMessageOptions {
     originChannelId?: string;
     /** Clickable URL for the origin channel, if the integration already has one. */
     channelUrl?: string;
+    /** Human-readable name for the origin channel, if the integration has one. */
+    channelName?: string;
     /** The report content. */
     content: string;
     /** Project ID (for branch reports). */
@@ -128,6 +132,8 @@ export interface IncomingMessageOptions {
     channelId: string;
     /** Clickable URL for channelId, if the integration already has one. */
     channelUrl?: string;
+    /** Human-readable channel name, if the integration has one. */
+    channelName?: string;
     /** DM channel ID, if the message was a direct message. */
     dmId?: string;
     /** Display name of the sender. */

package/src/claw.js

@@ -101,6 +101,9 @@ export function formatWorkerReport(opts) {
         if (url) {
             xml += `<origin_channel_url>${url}</origin_channel_url>\n`;
         }
+        if (opts.channelName) {
+            xml += `<origin_channel_name>${opts.channelName}</origin_channel_name>\n`;
+        }
     }
     xml += `<agent_id>${opts.agentId}</agent_id>\n`;
     xml += `<content>\n${opts.content.trim()}\n</content>\n`;
@@ -117,6 +120,9 @@ export function formatWorkerMessage(opts) {
         if (url) {
             xml += `<origin_channel_url>${url}</origin_channel_url>\n`;
         }
+        if (opts.channelName) {
+            xml += `<origin_channel_name>${opts.channelName}</origin_channel_name>\n`;
+        }
     }
     if (opts.senderDisplayName) {
         xml += `<sender>${opts.senderDisplayName}</sender>\n`;
@@ -166,6 +172,9 @@ export function formatIncomingMessage(opts) {
     if (channelUrl) {
         result += `<channel_url>${channelUrl}</channel_url>\n`;
     }
+    if (opts.channelName) {
+        result += `<channel_name>${opts.channelName}</channel_name>\n`;
+    }
     if (opts.dmId) {
         result += `<dm_id>${opts.dmId}</dm_id>\n`;
     }

package/src/claw.spec.js

@@ -103,6 +103,16 @@ describe("formatIncomingMessage", () => {
         });
         expect(result).toContain("<channel_url>https://test.atlassian.net/browse/PROJ-123</channel_url>");
     });
+    it("includes channel_name when provided by the integration", () => {
+        const result = formatIncomingMessage({
+            channelId: "slack/thread/TTEAM/CCHAN/1234567890.000100",
+            channelName: "#engineering",
+            sender: "Charlie",
+            timestamp: "Wednesday, January 3, 2024 at 12:00 PM PST",
+            content: "Slack message",
+        });
+        expect(result).toContain("<channel_name>#engineering</channel_name>");
+    });
     it("does not include channel_url for unsupported platforms", () => {
         const result = formatIncomingMessage({
             channelId: "telegram/chat/123456",
@@ -154,6 +164,14 @@ describe("formatWorkerMessage", () => {
         });
         expect(result).toContain("<origin_channel_url>https://test.atlassian.net/browse/PROJ-456</origin_channel_url>");
     });
+    it("includes origin_channel_name when provided by the integration", () => {
+        const result = formatWorkerMessage({
+            originChannelId: "slack/thread/TTEAM/CCHAN/1234567890.000100",
+            channelName: "#engineering",
+            content: "Worker result",
+        });
+        expect(result).toContain("<origin_channel_name>#engineering</origin_channel_name>");
+    });
     it("does not include origin_channel_url for unsupported platforms", () => {
         const result = formatWorkerMessage({
             originChannelId: "builder/branch/proj-id/my-branch",
@@ -195,6 +213,15 @@ describe("formatWorkerReport", () => {
         });
         expect(result).toContain("<origin_channel_url>https://test.atlassian.net/browse/PROJ-789</origin_channel_url>");
     });
+    it("includes origin_channel_name when provided by the integration", () => {
+        const result = formatWorkerReport({
+            originChannelId: "slack/channel/TTEAM/CCHAN",
+            channelName: "#engineering",
+            content: "Report content",
+            agentId: "agent-xyz",
+        });
+        expect(result).toContain("<origin_channel_name>#engineering</origin_channel_name>");
+    });
     it("does not include origin_channel_url for unsupported platforms", () => {
         const result = formatWorkerReport({
             originChannelId: "telegram/chat/123456",