@builder.io/ai-utils 0.33.0 → 0.33.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.33.0",
+  "version": "0.33.1",
   "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/projects.d.ts

@@ -974,4 +974,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 {};