@builder.io/ai-utils 0.33.0 → 0.34.0

package/package.json

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

package/src/claw.d.ts

@@ -85,6 +85,8 @@ export interface WorkerMessageOptions {
     projectId?: string;
     /** Branch name (for branch reports). */
     branchName?: string;
+    /** Sender display name (e.g. "Branch Agent (proj-123/feat-my-feature)"). */
+    senderDisplayName?: string;
 }
 /**
  * Formats a `<worker_report>` message for the org-agent.
@@ -95,6 +97,23 @@ export interface WorkerMessageOptions {
  */
 export declare function formatWorkerReport(opts: WorkerReportOptions): string;
 export declare function formatWorkerMessage(opts: WorkerMessageOptions): string;
+export interface SystemMessageOptions {
+    /** Identifier of the system sender (e.g. "cron:daily_check"). */
+    senderId?: string;
+    /** Human-readable display name (e.g. "Cron Job Trigger: daily_check"). */
+    senderDisplayName?: string;
+    /** Pre-formatted timestamp string. */
+    timestamp: string;
+    /** The message body. */
+    content: string;
+}
+/**
+ * Formats a `<system_message>` for the org-agent.
+ *
+ * Used for autonomous system events (cron triggers, scheduled tasks, etc.)
+ * that are not user messages or worker reports.
+ */
+export declare function formatSystemMessage(opts: SystemMessageOptions): string;
 export interface IncomingMessageOptions {
     /** The source channel (e.g. slack/thread/TEAM/CHANNEL/TS). */
     channelId: string;

package/src/claw.js

@@ -114,7 +114,7 @@ export function formatWorkerReport(opts) {
         }
     }
     xml += `<agent_id>${opts.agentId}</agent_id>\n`;
-    xml += `<content>${opts.content}</content>\n`;
+    xml += `<content>\n${opts.content.trim()}\n</content>\n`;
     xml += `</worker_report>\n`;
     xml += WORKER_REPORT_TRAILER;
     return xml;
@@ -128,14 +128,34 @@ export function formatWorkerMessage(opts) {
             xml += `<origin_channel_url>${url}</origin_channel_url>\n`;
         }
     }
+    if (opts.senderDisplayName) {
+        xml += `<sender>${opts.senderDisplayName}</sender>\n`;
+    }
     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`;
     }
-    xml += `<content>${opts.content}</content>\n`;
+    xml += `<content>\n${opts.content.trim()}\n</content>\n`;
     xml += `</worker_message>\n`;
-    xml += WORKER_REPORT_TRAILER;
+    return xml;
+}
+/**
+ * Formats a `<system_message>` for the org-agent.
+ *
+ * Used for autonomous system events (cron triggers, scheduled tasks, etc.)
+ * that are not user messages or worker reports.
+ */
+export function formatSystemMessage(opts) {
+    let xml = `<system_message>\n`;
+    if (opts.senderId) {
+        xml += `<sender_id>${opts.senderId}</sender_id>\n`;
+    }
+    if (opts.senderDisplayName) {
+        xml += `<sender>${opts.senderDisplayName}</sender>\n`;
+    }
+    xml += `<timestamp>${opts.timestamp}</timestamp>\n`;
+    xml += `<content>\n${opts.content.trim()}\n</content>\n`;
+    xml += `</system_message>\n`;
+    xml += `This is an automated system message, NOT a user message. Execute the task described above.`;
     return xml;
 }
 /**
@@ -162,7 +182,7 @@ export function formatIncomingMessage(opts) {
         result += `<sender>${opts.sender}</sender>\n`;
     }
     result += `<timestamp>${opts.timestamp}</timestamp>\n`;
-    result += `<content>${opts.content}</content>\n`;
+    result += `<content>\n${opts.content.trim()}\n</content>\n`;
     result += `</incoming_message>\n`;
     return result;
 }

package/src/codegen.d.ts

@@ -1713,7 +1713,11 @@ export interface FusionConfig {
     proxyDefaultOrigin?: string;
     setupDependencies?: SetupDependency[];
     projectId?: string;
+    /** Human-readable project name (e.g. "My App") */
+    projectName?: string;
     branchName?: string;
+    /** Human-readable branch name, AI-generated or user-set (e.g. "Add dark mode") */
+    branchFriendlyName?: string;
     sessionId?: string;
     browserAutomationInstructions?: string;
     /** Whether this branch is for a code review - affects enabled agents and tools */

package/src/projects.d.ts

@@ -363,6 +363,8 @@ export interface PartialBranchData {
     isFork?: boolean | null;
     /** Whether this branch is for a code review - affects enabled agents and tools*/
     type?: BranchType | null;
+    /** Auto-assigned category based on the user prompt (feature, fix, research, other) */
+    category?: BranchCategory | null;
     cloneFrom?: {
         projectId: string;
         branchName: string;
@@ -420,6 +422,8 @@ export interface OrgAgentConfig {
     longLived: boolean;
 }
 export type BranchType = "code-review" | "setup-project" | "org-agent" | "default";
+/** Category of work a branch represents, auto-assigned during prompt analysis. */
+export type BranchCategory = "feature" | "fix" | "research" | "other";
 export interface BranchSharedData {
     appName?: string | null;
     prNumber?: number | null;
@@ -489,6 +493,8 @@ export interface BranchSharedData {
     screenshots?: Record<string, string>;
     /** Whether this branch is for a code review - affects enabled agents and tools */
     type?: BranchType | null;
+    /** Auto-assigned category based on the user prompt (feature, fix, research, other) */
+    category?: BranchCategory | null;
     agentType?: AgentType | null;
     /** ID of the last PR review — doubles as the vcpCodeGenEvents completion ID for feedback */
     lastReviewId?: string | null;
@@ -808,6 +814,7 @@ export interface SettingUpContainerMessage extends BaseCreateBranchMessage {
     branchName: string;
     branchFriendlyName: string | undefined;
     branchDescription: string | undefined;
+    branchCategory: BranchCategory | undefined;
 }
 export interface ContainerReadyMessage extends BaseCreateBranchMessage {
     type: "container-ready";
@@ -974,4 +981,16 @@ export interface ExitPlanModeData {
  * Extracts the plan content and sessionMode from the tool's structured result
  */
 export declare function parseExitPlanMode(chunk: CreateBranchChunkMessage | SendMessageChunkMessage): ExitPlanModeData | null;
+export interface CronJobConfig {
+    id: string;
+    cron: string;
+    description: string;
+    prompt: string;
+    enabled: boolean;
+}
+export interface OrgCronConfigOptions {
+    jobs: CronJobConfig[];
+    projectId: string;
+    branchName: string;
+}
 export {};