@builder.io/ai-utils 0.32.0 → 0.33.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Builder.io AI utils",
   "type": "module",
   "main": "src/index.js",

package/src/claw.d.ts

@@ -44,7 +44,39 @@ export interface ParsedChannelId {
  *   "inbox/user/builder-user-id" → { platform: "inbox", type: "user", ids: ["builder-user-id"] }
  */
 export declare function parseChannelId(channelId: string): ParsedChannelId;
+/**
+ * Converts a Builder channel_id URI to a clickable URL for the
+ * corresponding platform (Slack, Jira, etc.).
+ *
+ * Supported formats:
+ *
+ *   Slack (uses app_redirect URLs - works for all workspaces):
+ *     slack/thread/TEAM_ID/CHANNEL_ID/THREAD_TS
+ *       → https://slack.com/app_redirect?team=TEAM_ID&channel=CHANNEL_ID&message_ts=THREAD_TS
+ *     slack/channel/TEAM_ID/CHANNEL_ID
+ *       → https://slack.com/app_redirect?team=TEAM_ID&channel=CHANNEL_ID
+ *     slack/dm/TEAM_ID/USER_ID
+ *       → https://slack.com/app_redirect?team=TEAM_ID&channel=USER_ID
+ *
+ *   Jira:
+ *     Returns null - needs integration.baseUrl from database
+ *     (Future: jira/comment/CLOUD_ID/ISSUE_KEY → {baseUrl}/browse/ISSUE_KEY)
+ *
+ * Returns null for unsupported platforms or malformed channel IDs.
+ *
+ * TODO: Accept optional integration metadata parameter to construct proper
+ * workspace-specific URLs (Slack teamDomain, Jira baseUrl).
+ */
+export declare function convertChannelIdToUrl(channelId: string): string | null;
 export interface WorkerReportOptions {
+    /** The original user's channel that triggered this work. */
+    originChannelId?: string;
+    /** The report content. */
+    content: string;
+    /** Agent/tool ID (for sub-agent reports). */
+    agentId: string;
+}
+export interface WorkerMessageOptions {
     /** The original user's channel that triggered this work. */
     originChannelId?: string;
     /** The report content. */
@@ -53,8 +85,6 @@ export interface WorkerReportOptions {
     projectId?: string;
     /** Branch name (for branch reports). */
     branchName?: string;
-    /** Agent/tool ID (for sub-agent reports). */
-    agentId?: string;
 }
 /**
  * Formats a `<worker_report>` message for the org-agent.
@@ -64,6 +94,7 @@ export interface WorkerReportOptions {
  * correct user channel.
  */
 export declare function formatWorkerReport(opts: WorkerReportOptions): string;
+export declare function formatWorkerMessage(opts: WorkerMessageOptions): string;
 export interface IncomingMessageOptions {
     /** The source channel (e.g. slack/thread/TEAM/CHANNEL/TS). */
     channelId: string;

package/src/claw.js

@@ -16,6 +16,78 @@ export function parseChannelId(channelId) {
     const [platform, type, ...ids] = parts;
     return { platform, type, ids };
 }
+/**
+ * Converts a Builder channel_id URI to a clickable URL for the
+ * corresponding platform (Slack, Jira, etc.).
+ *
+ * Supported formats:
+ *
+ *   Slack (uses app_redirect URLs - works for all workspaces):
+ *     slack/thread/TEAM_ID/CHANNEL_ID/THREAD_TS
+ *       → https://slack.com/app_redirect?team=TEAM_ID&channel=CHANNEL_ID&message_ts=THREAD_TS
+ *     slack/channel/TEAM_ID/CHANNEL_ID
+ *       → https://slack.com/app_redirect?team=TEAM_ID&channel=CHANNEL_ID
+ *     slack/dm/TEAM_ID/USER_ID
+ *       → https://slack.com/app_redirect?team=TEAM_ID&channel=USER_ID
+ *
+ *   Jira:
+ *     Returns null - needs integration.baseUrl from database
+ *     (Future: jira/comment/CLOUD_ID/ISSUE_KEY → {baseUrl}/browse/ISSUE_KEY)
+ *
+ * Returns null for unsupported platforms or malformed channel IDs.
+ *
+ * TODO: Accept optional integration metadata parameter to construct proper
+ * workspace-specific URLs (Slack teamDomain, Jira baseUrl).
+ */
+export function convertChannelIdToUrl(channelId) {
+    let parsed;
+    try {
+        parsed = parseChannelId(channelId);
+    }
+    catch (_a) {
+        return null;
+    }
+    const { platform, type, ids } = parsed;
+    if (platform === "slack") {
+        return slackChannelIdToUrl(type, ids);
+    }
+    // Jira URLs need integration.baseUrl from database - not available here
+    // TODO: Add integration metadata parameter to support Jira URLs
+    if (platform === "jira") {
+        return null;
+    }
+    return null;
+}
+function slackChannelIdToUrl(type, ids) {
+    // Use app_redirect URLs for all Slack types - they work universally across
+    // all workspaces without needing to know the workspace domain.
+    // These URLs open in the Slack app or web client automatically.
+    if (type === "thread") {
+        // slack/thread/TEAM_ID/CHANNEL_ID/THREAD_TS
+        const [teamId, slackChannelId, threadTs] = ids;
+        if (!teamId || !slackChannelId || !threadTs) {
+            return null;
+        }
+        return `https://slack.com/app_redirect?team=${teamId}&channel=${slackChannelId}&message_ts=${threadTs}`;
+    }
+    if (type === "channel") {
+        // slack/channel/TEAM_ID/CHANNEL_ID
+        const [teamId, slackChannelId] = ids;
+        if (!teamId || !slackChannelId) {
+            return null;
+        }
+        return `https://slack.com/app_redirect?team=${teamId}&channel=${slackChannelId}`;
+    }
+    if (type === "dm") {
+        // slack/dm/TEAM_ID/USER_ID
+        const [teamId, userId] = ids;
+        if (!teamId || !userId) {
+            return null;
+        }
+        return `https://slack.com/app_redirect?team=${teamId}&channel=${userId}`;
+    }
+    return null;
+}
 // ── Org-agent message formatting ──
 //
 // The org-agent receives two kinds of messages in its conversation:
@@ -36,19 +108,33 @@ export function formatWorkerReport(opts) {
     let xml = `<worker_report>\n`;
     if (opts.originChannelId) {
         xml += `<origin_channel_id>${opts.originChannelId}</origin_channel_id>\n`;
+        const url = convertChannelIdToUrl(opts.originChannelId);
+        if (url) {
+            xml += `<origin_channel_url>${url}</origin_channel_url>\n`;
+        }
     }
-    if (opts.projectId) {
-        xml += `<project_id>${opts.projectId}</project_id>\n`;
+    xml += `<agent_id>${opts.agentId}</agent_id>\n`;
+    xml += `<content>${opts.content}</content>\n`;
+    xml += `</worker_report>\n`;
+    xml += WORKER_REPORT_TRAILER;
+    return xml;
+}
+export function formatWorkerMessage(opts) {
+    let xml = `<worker_message>\n`;
+    if (opts.originChannelId) {
+        xml += `<origin_channel_id>${opts.originChannelId}</origin_channel_id>\n`;
+        const url = convertChannelIdToUrl(opts.originChannelId);
+        if (url) {
+            xml += `<origin_channel_url>${url}</origin_channel_url>\n`;
+        }
     }
-    if (opts.branchName && opts.projectId) {
+    if (opts.projectId && opts.branchName) {
+        xml += `<project_id>${opts.projectId}</project_id>\n`;
         xml += `<branch_name>${opts.branchName}</branch_name>\n`;
         xml += `<channel_id>builder/branch/${opts.projectId}/${opts.branchName}</channel_id>\n`;
     }
-    if (opts.agentId) {
-        xml += `<agent_id>${opts.agentId}</agent_id>\n`;
-    }
     xml += `<content>${opts.content}</content>\n`;
-    xml += `</worker_report>\n`;
+    xml += `</worker_message>\n`;
     xml += WORKER_REPORT_TRAILER;
     return xml;
 }
@@ -65,6 +151,10 @@ export function formatIncomingMessage(opts) {
     }
     result += `<incoming_message>\n`;
     result += `<channel_id>${opts.channelId}</channel_id>\n`;
+    const channelUrl = convertChannelIdToUrl(opts.channelId);
+    if (channelUrl) {
+        result += `<channel_url>${channelUrl}</channel_url>\n`;
+    }
     if (opts.dmId) {
         result += `<dm_id>${opts.dmId}</dm_id>\n`;
     }

package/src/claw.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/src/claw.spec.js

@@ -0,0 +1,200 @@
+import { describe, it, expect } from "vitest";
+import { convertChannelIdToUrl, formatIncomingMessage, formatWorkerMessage, formatWorkerReport, } from "./claw";
+describe("convertChannelIdToUrl", () => {
+    describe("slack/thread format", () => {
+        it("converts a thread channel ID to a Slack app_redirect URL", () => {
+            const url = convertChannelIdToUrl("slack/thread/T01ABC123/C01DEF456/1700000000.123456");
+            expect(url).toBe("https://slack.com/app_redirect?team=T01ABC123&channel=C01DEF456&message_ts=1700000000.123456");
+        });
+        it("handles timestamps with dots correctly", () => {
+            const url = convertChannelIdToUrl("slack/thread/TTEAM/CCHAN/1234567890.000100");
+            expect(url).toBe("https://slack.com/app_redirect?team=TTEAM&channel=CCHAN&message_ts=1234567890.000100");
+        });
+        it("returns null when teamId is missing", () => {
+            expect(convertChannelIdToUrl("slack/thread/CCHAN/1234567890.000100")).toBeNull();
+        });
+        it("returns null when channelId is missing", () => {
+            expect(convertChannelIdToUrl("slack/thread/TTEAM/1234567890.000100")).toBeNull();
+        });
+        it("returns null when threadTs is missing", () => {
+            expect(convertChannelIdToUrl("slack/thread/TTEAM/CCHAN")).toBeNull();
+        });
+    });
+    describe("slack/channel format", () => {
+        it("converts a channel ID to a Slack app_redirect URL", () => {
+            const url = convertChannelIdToUrl("slack/channel/T01ABC123/C01DEF456");
+            expect(url).toBe("https://slack.com/app_redirect?team=T01ABC123&channel=C01DEF456");
+        });
+        it("returns null when teamId is missing", () => {
+            expect(convertChannelIdToUrl("slack/channel/C01DEF456")).toBeNull();
+        });
+        it("returns null when channelId is missing", () => {
+            expect(convertChannelIdToUrl("slack/channel/TTEAM")).toBeNull();
+        });
+    });
+    describe("slack/dm format", () => {
+        it("converts a DM channel ID to a Slack app_redirect URL", () => {
+            const url = convertChannelIdToUrl("slack/dm/T01ABC123/U01XYZ789");
+            expect(url).toBe("https://slack.com/app_redirect?team=T01ABC123&channel=U01XYZ789");
+        });
+        it("returns null when teamId is missing", () => {
+            expect(convertChannelIdToUrl("slack/dm/U01XYZ789")).toBeNull();
+        });
+        it("returns null when userId is missing", () => {
+            expect(convertChannelIdToUrl("slack/dm/TTEAM")).toBeNull();
+        });
+    });
+    describe("jira/comment format", () => {
+        it("returns null (needs integration.baseUrl from database)", () => {
+            const url = convertChannelIdToUrl("jira/comment/cloud-id/PROJ-123");
+            expect(url).toBeNull();
+        });
+    });
+    describe("unsupported platforms", () => {
+        it("returns null for telegram channel IDs", () => {
+            expect(convertChannelIdToUrl("telegram/chat/123456")).toBeNull();
+        });
+        it("returns null for builder branch channel IDs", () => {
+            expect(convertChannelIdToUrl("builder/branch/proj-id/my-branch")).toBeNull();
+        });
+        it("returns null for inbox channel IDs", () => {
+            expect(convertChannelIdToUrl("inbox/user/user-id")).toBeNull();
+        });
+        it("returns null for internal channel IDs", () => {
+            expect(convertChannelIdToUrl("internal/support")).toBeNull();
+        });
+        it("returns null for completely invalid input", () => {
+            expect(convertChannelIdToUrl("not-a-channel-id")).toBeNull();
+        });
+        it("returns null for empty string", () => {
+            expect(convertChannelIdToUrl("")).toBeNull();
+        });
+    });
+});
+describe("formatIncomingMessage", () => {
+    it("includes channel_url for Slack thread channel IDs", () => {
+        const result = formatIncomingMessage({
+            channelId: "slack/thread/TTEAM/CCHAN/1234567890.000100",
+            sender: "Alice",
+            timestamp: "Monday, January 1, 2024 at 10:00 AM PST",
+            content: "Hello!",
+        });
+        expect(result).toContain("<channel_url>https://slack.com/app_redirect?team=TTEAM&channel=CCHAN&message_ts=1234567890.000100</channel_url>");
+    });
+    it("includes channel_url for Slack channel IDs", () => {
+        const result = formatIncomingMessage({
+            channelId: "slack/channel/TTEAM/CCHAN",
+            sender: "Bob",
+            timestamp: "Tuesday, January 2, 2024 at 11:00 AM PST",
+            content: "Hey there",
+        });
+        expect(result).toContain("<channel_url>https://slack.com/app_redirect?team=TTEAM&channel=CCHAN</channel_url>");
+    });
+    it("does not include channel_url for Jira (needs integration.baseUrl)", () => {
+        const result = formatIncomingMessage({
+            channelId: "jira/comment/cloud-id/PROJ-123",
+            sender: "Charlie",
+            timestamp: "Wednesday, January 3, 2024 at 12:00 PM PST",
+            content: "Jira comment",
+        });
+        expect(result).not.toContain("<channel_url>");
+    });
+    it("does not include channel_url for unsupported platforms", () => {
+        const result = formatIncomingMessage({
+            channelId: "telegram/chat/123456",
+            sender: "Charlie",
+            timestamp: "Wednesday, January 3, 2024 at 12:00 PM PST",
+            content: "Telegram message",
+        });
+        expect(result).not.toContain("<channel_url>");
+    });
+    it("includes dm_id without generating dm_url", () => {
+        const result = formatIncomingMessage({
+            channelId: "slack/thread/TTEAM/CCHAN/1234567890.000100",
+            dmId: "slack/dm/TTEAM/UUSER",
+            sender: "Dave",
+            timestamp: "Thursday, January 4, 2024 at 1:00 PM PST",
+            content: "DM context",
+        });
+        expect(result).toContain("<dm_id>slack/dm/TTEAM/UUSER</dm_id>");
+        expect(result).not.toContain("<dm_url>");
+    });
+    it("preserves all other fields unchanged", () => {
+        const result = formatIncomingMessage({
+            channelId: "slack/thread/TTEAM/CCHAN/1234567890.000100",
+            sender: "Frank",
+            timestamp: "Saturday, January 6, 2024 at 3:00 PM PST",
+            content: "Test message",
+            messageContext: "Prior context",
+        });
+        expect(result).toContain("<channel_id>slack/thread/TTEAM/CCHAN/1234567890.000100</channel_id>");
+        expect(result).toContain("<sender>Frank</sender>");
+        expect(result).toContain("Prior context");
+    });
+});
+describe("formatWorkerMessage", () => {
+    it("includes origin_channel_url for Slack originChannelId", () => {
+        const result = formatWorkerMessage({
+            originChannelId: "slack/thread/TTEAM/CCHAN/1234567890.000100",
+            content: "Worker result",
+            projectId: "proj-123",
+            branchName: "feat/my-feature",
+        });
+        expect(result).toContain("<origin_channel_url>https://slack.com/app_redirect?team=TTEAM&channel=CCHAN&message_ts=1234567890.000100</origin_channel_url>");
+    });
+    it("does not include origin_channel_url for Jira (needs integration.baseUrl)", () => {
+        const result = formatWorkerMessage({
+            originChannelId: "jira/comment/cloud-id/PROJ-456",
+            content: "Worker result",
+        });
+        expect(result).not.toContain("<origin_channel_url>");
+    });
+    it("does not include origin_channel_url for unsupported platforms", () => {
+        const result = formatWorkerMessage({
+            originChannelId: "builder/branch/proj-id/my-branch",
+            content: "Worker result",
+        });
+        expect(result).not.toContain("<origin_channel_url>");
+    });
+    it("omits origin_channel_url when originChannelId is absent", () => {
+        const result = formatWorkerMessage({
+            content: "Worker result without origin",
+        });
+        expect(result).not.toContain("<origin_channel_url>");
+        expect(result).not.toContain("<origin_channel_id>");
+    });
+    it("uses matching XML tags (worker_message, not worker_report)", () => {
+        const result = formatWorkerMessage({
+            content: "Test content",
+        });
+        expect(result).toContain("<worker_message>");
+        expect(result).toContain("</worker_message>");
+        expect(result).not.toContain("</worker_report>");
+    });
+});
+describe("formatWorkerReport", () => {
+    it("includes origin_channel_url for Slack originChannelId", () => {
+        const result = formatWorkerReport({
+            originChannelId: "slack/channel/TTEAM/CCHAN",
+            content: "Report content",
+            agentId: "agent-abc",
+        });
+        expect(result).toContain("<origin_channel_url>https://slack.com/app_redirect?team=TTEAM&channel=CCHAN</origin_channel_url>");
+    });
+    it("does not include origin_channel_url for Jira (needs integration.baseUrl)", () => {
+        const result = formatWorkerReport({
+            originChannelId: "jira/comment/cloud-id/PROJ-789",
+            content: "Report content",
+            agentId: "agent-xyz",
+        });
+        expect(result).not.toContain("<origin_channel_url>");
+    });
+    it("does not include origin_channel_url for unsupported platforms", () => {
+        const result = formatWorkerReport({
+            originChannelId: "telegram/chat/123456",
+            content: "Report content",
+            agentId: "agent-xyz",
+        });
+        expect(result).not.toContain("<origin_channel_url>");
+    });
+});

package/src/codegen.d.ts

@@ -45,6 +45,7 @@ export interface CustomAgentDefinition {
     systemPrompt?: string;
     tools?: string[];
     model?: string;
+    roundRobinModels?: string[];
     mode?: CodeGenMode;
     position?: string;
     needDevServer?: boolean;
@@ -224,6 +225,8 @@ export interface WebFetchToolInput {
 export interface ExplorationMetadataToolInput {
     category?: "reusable_knowledge" | "one_off" | "bad_quality";
     gif_id?: string;
+    timeline_id?: string;
+    recording_id?: string;
     important_files: {
         file_path: string;
         relevance?: "high" | "medium" | "low";
@@ -244,6 +247,58 @@ export interface ReadMcpResourceToolInput {
 export interface RecordFrameToolInput {
     title: string;
     frame: "last-image";
+    category?: TimelineEventCategory;
+    description?: string;
+}
+export type TestOutcome = "succeeded" | "couldnt_verify" | "failed" | "other";
+export interface ReportTestOutcomeToolInput {
+    outcome: TestOutcome;
+    summary: string;
+    details?: string;
+}
+export type TimelineEventCategory = "navigation" | "interaction" | "assertion" | "error" | "milestone" | "code-change" | "observation";
+export interface TimelineEvent {
+    id: number;
+    timestamp: number;
+    label: string;
+    category: TimelineEventCategory;
+    description?: string;
+    toolName?: string;
+    frameIndex?: number;
+    durationMs?: number;
+    thinking?: string;
+}
+export interface TimelineFrameMetadata {
+    index: number;
+    timestamp: number;
+    title: string;
+    category: TimelineEventCategory;
+    eventId: number;
+    explicit: boolean;
+    displayDurationMs: number;
+    fileName?: string;
+    image_url?: string;
+    cursorX?: number | null;
+    cursorY?: number | null;
+    viewportWidth?: number;
+    viewportHeight?: number;
+}
+export interface TimelineRecording {
+    version: 1;
+    sessionId: string;
+    startTime: number;
+    endTime: number;
+    totalFrames: number;
+    events: TimelineEvent[];
+    frames: TimelineFrameMetadata[];
+    testOutcome?: TestOutcome;
+    testSummary?: string;
+    testDetails?: string;
+    uiIssues?: Array<{
+        title: string;
+        description: string;
+        debugInfo?: string;
+    }>;
 }
 /**
  * Configuration values proposed by the setup analyzer agent
@@ -500,6 +555,11 @@ export interface SendMessageToolInput {
     markdown: string;
     status: "starting" | "question" | "will-follow-up" | "done:success" | "done:error";
     loadingMessage?: string;
+    /**
+     * When true, send the response as a voice message using text-to-speech.
+     * Only supported for Telegram channels.
+     */
+    voiceResponse?: boolean;
 }
 export interface SpawnBranchToolInput {
     projectId: string;
@@ -536,6 +596,7 @@ export interface SubmitPRReviewToolInput {
 /** SubmitRecording - Visual verification with recording (posted as separate review) */
 export interface SubmitRecordingToolInput {
     gif_id: string;
+    timeline_id?: string;
     recording_caption: string;
     summary?: string;
     comments?: PRReviewComment[];
@@ -612,6 +673,7 @@ export interface CodeGenToolMap {
     ResolveQAComments: ResolveQACommentsToolInput;
     ReportUIIssue: ReportUIIssueToolInput;
     ReportIssue: ReportIssueToolInput;
+    ReportTestOutcome: ReportTestOutcomeToolInput;
     VerifySetupCommand: VerifySetupCommandToolInput;
     VerifyDevCommand: VerifyDevCommandToolInput;
     VerifyDevServer: VerifyDevServerToolInput;
@@ -726,6 +788,17 @@ export interface CodeGenInputOptions {
     projectId?: string;
     branchName?: string;
     repoHash?: string;
+    /**
+     * Server-side branch.agentType cached from middleware Firestore lookup.
+     * Used to avoid redundant getBranch calls for billing exemption checks.
+     * @internal - Set by middleware, not by clients
+     */
+    branchAgentType?: string | null;
+    /**
+     * True when middleware performed a Firestore branch lookup; do not use source-based exemption.
+     * @internal - Set by middleware, not by clients
+     */
+    branchAgentTypeChecked?: boolean;
     /** @deprecated */
     prevId?: string;
     /** @deprecated */
@@ -1121,6 +1194,8 @@ export interface GenerateCompletionStepToolCallRequest {
     id: string;
     name: string;
     input: any;
+    /** When true, this tool call can be resolved by a user message if no client handler exists */
+    messageValid?: boolean;
 }
 export interface GenerateCompletionStepTerminals {
     type: "terminals";
@@ -1130,6 +1205,8 @@ export interface GenerateCompletionStepProposeConfig {
     type: "propose_config";
     config: SetupAnalysisValues;
     message?: string;
+    /** When true, the project requires no dependency installation. The UI should not show an Apply dialog for dependencies. */
+    noDependencies?: boolean;
 }
 export interface GenerateCompletionStepUpdateSetupValue {
     type: "update_setup_value";
@@ -1165,10 +1242,11 @@ export interface UserSourceBase {
     principals?: string[];
     jobs?: string[];
     permissions?: UserSourcePermission[];
+    channelId?: string;
 }
 /** All integration sources: Slack, Teams, Jira, Linear, and git providers (GitHub, GitLab, Azure, Bitbucket). */
 export interface UserSourceOther extends UserSourceBase {
-    source: "slack" | "telegram" | "teams" | "jira" | "linear" | "github" | "gitlab" | "azure" | "bitbucket";
+    source: "slack" | "telegram" | "whatsapp" | "teams" | "jira" | "linear" | "github" | "gitlab" | "azure" | "bitbucket";
     /** User ID from the external platform (Slack user ID, GitHub user id, etc.) */
     userId?: string;
     userName?: string;

package/src/events.d.ts

@@ -530,7 +530,6 @@ export declare const ForceSetupAgentV1: {
 };
 export type ClawMessageSentV1 = FusionEventVariant<"claw.message.sent", {
     branchName: string;
-    messageType: "text" | "task-result" | "cron-trigger";
     content: string;
     senderType: "user" | "sub-agent" | "system";
     senderId?: string;
@@ -538,6 +537,8 @@ export type ClawMessageSentV1 = FusionEventVariant<"claw.message.sent", {
     channelId?: string;
     dmId?: string;
     senderDisplayName?: string;
+    agentBranchName?: string;
+    agentProjectId?: string;
     userSource?: UserSource;
     /** Optional context to include alongside the message (e.g. Slack thread history). */
     messageContext?: string;
@@ -548,13 +549,62 @@ export declare const ClawMessageSentV1: {
     eventName: "claw.message.sent";
     version: "1";
 };
+export type CodegenCompletionV1 = FusionEventVariant<"codegen.completion", {
+    completionId: string;
+    role?: string;
+    projectId?: string;
+    branchName?: string;
+    sessionId: string;
+    userSourceUserId?: string;
+    model?: string;
+    compact?: boolean;
+    usedTokens?: number;
+    category?: string;
+    userPrompt?: string;
+}, {
+    projectId?: string;
+    branchName?: string;
+    sessionId: string;
+}, 1>;
+export declare const CodegenCompletionV1: {
+    eventName: "codegen.completion";
+    version: "1";
+};
+export type CodegenUserPromptV1 = FusionEventVariant<"codegen.user.prompt", {
+    completionId: string;
+    role?: string;
+    projectId?: string;
+    branchName?: string;
+    sessionId: string;
+    userSourceUserId?: string;
+    model?: string;
+    compact?: boolean;
+    usedTokens?: number;
+    category?: string;
+    userPrompt: string;
+}, {
+    projectId?: string;
+    branchName?: string;
+    sessionId: string;
+}, 1>;
+export declare const CodegenUserPromptV1: {
+    eventName: "codegen.user.prompt";
+    version: "1";
+};
 export interface SendMessageToOrgAgentInput {
+    agentBranchName?: string;
+    agentProjectId?: string;
     content: string;
+    senderType?: "user" | "sub-agent" | "system";
     channelId?: string;
     senderDisplayName?: string;
     messageContext?: string;
+    senderId?: string;
+    dmId?: string;
+    userSource?: UserSource;
+    attachments?: FileUpload[];
 }
-export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | GitPrCreatedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | ForceSetupAgentV1 | ClawMessageSentV1;
+export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | GitPrCreatedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -34,3 +34,11 @@ export const ClawMessageSentV1 = {
     eventName: "claw.message.sent",
     version: "1",
 };
+export const CodegenCompletionV1 = {
+    eventName: "codegen.completion",
+    version: "1",
+};
+export const CodegenUserPromptV1 = {
+    eventName: "codegen.user.prompt",
+    version: "1",
+};

package/src/organization.d.ts

@@ -84,6 +84,10 @@ interface OrganizationSettings {
         enabled?: boolean;
     };
     disableFigmaImageUpload?: boolean;
+    prReviewer?: {
+        instructions?: string;
+        model?: string;
+    };
     enableTicketAssessment?: boolean;
     ticketAssessmentPrompt?: string;
     ticketAssessmentModel?: string;
@@ -292,6 +296,7 @@ export interface FeatureMap {
     enterpriseGitProviders?: boolean;
     agentCreditsRollover?: boolean;
     selfHostedGitProviders?: boolean;
+    reviewAgent?: boolean;
 }
 export interface SubscriptionInfo {
     price?: number;

package/src/projects.d.ts

@@ -569,6 +569,7 @@ export interface Project {
     /** MIGRATION: accepts both string and number during migration period */
     updatedAt: InMigrationDate;
     pinned?: boolean;
+    pinOrder?: number;
     archived?: boolean;
     createdBy: string;
     lastUpdateBy?: string;
@@ -644,6 +645,7 @@ export interface Project {
         prReviewer?: {
             enabled: boolean;
             instructions?: string;
+            model?: string;
         };
         enableSnapshots?: boolean;
         postMergeMemories?: boolean;
@@ -867,6 +869,7 @@ export interface SendMessageOptions {
     featureFlags?: Record<string, boolean>;
     webhook?: WebhookConfig;
     fireAndForget?: boolean;
+    skipPromptAnalysis?: boolean;
     canHandleTools?: (keyof CodeGenToolMap)[];
 }
 export interface MemoryData {

package/src/projects.js

@@ -30,6 +30,7 @@ export const EXAMPLE_REPOS = [
     "BuilderIO/fusion-angular-tailwind-starter",
     "BuilderIO/fusion-svelte-tailwind-starter",
     "BuilderIO/fusion-vue-tailwind-starter",
+    "BuilderIO/org-agent-starter",
 ];
 export const STARTER_REPO = "BuilderIO/fusion-starter";
 export const EXAMPLE_OR_STARTER_REPOS = [...EXAMPLE_REPOS, STARTER_REPO];