@builder.io/ai-utils 0.97.0 → 0.99.0

package/package.json

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

package/src/codegen.d.ts

@@ -374,6 +374,7 @@ export declare const BuilderEditToolInputSchema: z.ZodObject<{
     filePath: z.ZodString;
     old_str: z.ZodString;
     new_str: z.ZodString;
+    replace_all: z.ZodOptional<z.ZodBoolean>;
     activeLocale: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type BuilderEditToolInput = z.infer<typeof BuilderEditToolInputSchema>;
@@ -1553,6 +1554,7 @@ export declare const CodeGenToolMapSchema: z.ZodObject<{
         filePath: z.ZodString;
         old_str: z.ZodString;
         new_str: z.ZodString;
+        replace_all: z.ZodOptional<z.ZodBoolean>;
         activeLocale: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     WebFetch: z.ZodObject<{
@@ -2169,6 +2171,17 @@ export type CodeGenPosition = z.infer<typeof CodeGenPositionSchema>;
 export declare const PublishAgentMessageRequestSchema: z.ZodObject<{
     message: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodOptional<z.ZodString>;
+    modelOverride: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        high: "high";
+        low: "low";
+        max: "max";
+        medium: "medium";
+        minimal: "minimal";
+        none: "none";
+        xhigh: "xhigh";
+    }>>;
     toolResults: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodLiteral<"tool_result">;
         tool_use_id: z.ZodString;
@@ -3988,6 +4001,7 @@ export interface GenerateCodeEventDone {
     nextUrl: string;
     autoContinue: boolean;
     model: string;
+    modelOverride?: string;
     promptVersion: string | undefined;
     /** True when this turn was a compaction pass run on an internal model. */
     compact: boolean;

package/src/codegen.js

@@ -567,6 +567,9 @@ export const BuilderEditToolInputSchema = z
     new_str: z.string().meta({
         description: "New content to replace the old content with",
     }),
+    replace_all: z.boolean().optional().meta({
+        description: "Replace every occurrence of old_str instead of only the first. Matches old_str as an exact substring, so it is not restricted to complete lines — use it to change a word repeated throughout a long rich-text body. Only use it when every occurrence should get the same replacement.",
+    }),
     activeLocale: z.string().min(1).optional().meta({
         description: 'Locale to edit. Use "Default" for the default locale, or one of the configured available locales.',
     }),
@@ -1781,6 +1784,8 @@ export const PublishAgentMessageRequestSchema = z
     .object({
     message: z.string().max(100000).optional(),
     sessionId: z.string().min(1).max(256).optional(),
+    modelOverride: z.string().min(1).max(256).optional(),
+    reasoning: ReasoningEffortSchema.optional(),
     toolResults: z.array(ContentMessageItemToolResultSchema).optional(),
     confirmation: z
         .object({
@@ -1793,7 +1798,7 @@ export const PublishAgentMessageRequestSchema = z
     path: ["message"],
     message: "A message or at least one tool result is required.",
 })
-    .refine(({ message, sessionId }) => Boolean(message) || Boolean(sessionId), {
+    .refine(({ toolResults, sessionId }) => !(toolResults === null || toolResults === void 0 ? void 0 : toolResults.length) || Boolean(sessionId), {
     path: ["sessionId"],
     message: "A session ID is required when continuing with tool results.",
 })

package/src/completion.d.ts

@@ -1,6 +1,7 @@
 import type { BuilderContent, BuilderElement, Component } from "@builder.io/sdk";
-import type { Message, MessageParam, Attachment } from "./messages.js";
+import type { Message, MessageParam, Attachment, ContentMessageItemToolResult } from "./messages.js";
 import type { BuilderModel } from "./events.js";
+import type { ReasoningEffort } from "./codegen.js";
 export type { BuilderContent, BuilderElement, Component };
 export interface CompletionOptions {
     /**
@@ -14,6 +15,11 @@ export interface CompletionOptions {
      * Note: This is not the Builder.io data model.
      */
     modelId?: string;
+    /**
+     * Reasoning effort for the selected LLM.
+     * Defaults according to the session mode, typically to medium.
+     */
+    reasoning?: ReasoningEffort;
     /**
      * The unique LOCAL identifier of the thread to submit the user message to.
      * This is used to identify the thread with our own id (openai assistant id is different)
@@ -84,6 +90,13 @@ export interface CompletionOptions {
      */
     thread?: "persist" | "ephemeral";
     attachments?: Attachment[];
+    /**
+     * Answers to a prior `AskUserQuestion` tool call, sent on the follow-up
+     * request that resumes the paused turn. Each entry's `tool_use_id` must match
+     * the `id` from the `assistant.model.question.required` event, so the resumed
+     * codegen session pairs the answer with its pending tool_use.
+     */
+    toolResults?: ContentMessageItemToolResult[];
 }
 export interface BuilderEditorState {
     /**

package/src/editor-ai.d.ts

@@ -10,6 +10,7 @@ export declare const EditorAiReadRequestSchema: z.ZodObject<{
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
     activeLocale: z.ZodOptional<z.ZodString>;
+    baseContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type EditorAiReadRequest = z.infer<typeof EditorAiReadRequestSchema>;
 export declare const EditorAiReadResponseSchema: z.ZodObject<{
@@ -25,11 +26,13 @@ export declare const EditorAiEditRequestSchema: z.ZodObject<{
     contentId: z.ZodString;
     old_str: z.ZodString;
     new_str: z.ZodString;
+    replace_all: z.ZodOptional<z.ZodBoolean>;
     activeLocale: z.ZodOptional<z.ZodString>;
     components: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
     }, z.core.$loose>>>;
     allowedComponentNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    baseContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type EditorAiEditRequest = z.infer<typeof EditorAiEditRequestSchema>;
 export declare const EditorAiEditResponseSchema: z.ZodObject<{
@@ -46,6 +49,7 @@ export declare const EditorAiWriteRequestSchema: z.ZodObject<{
         name: z.ZodString;
     }, z.core.$loose>>>;
     allowedComponentNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    baseContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type EditorAiWriteRequest = z.infer<typeof EditorAiWriteRequestSchema>;
 export declare const EditorAiWriteResponseSchema: z.ZodObject<{

package/src/editor-ai.js

@@ -16,6 +16,9 @@ const componentsField = z.array(EditorAiComponentSchema).optional();
 // Omitted is unrestricted; empty forbids every component. Only components-only
 // spaces send it.
 const allowedComponentNamesField = z.array(z.string().min(1)).optional();
+// Edit this instead of the stored document, letting a caller work on an
+// unpublished revision. Ownership still checked against stored. Blocks decoded.
+const baseContentField = z.record(z.string(), z.unknown()).optional();
 export const EditorAiReadRequestSchema = z
     .object({
     contentId: z.string().min(1),
@@ -23,6 +26,7 @@ export const EditorAiReadRequestSchema = z
     limit: z.number().int().min(1).max(EDITOR_AI_READ_MAX_LIMIT).optional(),
     // Locale to operate on; defaults to "Default" when omitted.
     activeLocale: z.string().min(1).optional(),
+    baseContent: baseContentField,
 })
     .meta({ title: "EditorAiReadRequest" });
 export const EditorAiReadResponseSchema = z
@@ -45,10 +49,13 @@ export const EditorAiEditRequestSchema = z
         message: "old_str must not be only whitespace",
     }),
     new_str: z.string(),
+    // Exact-substring replace of every occurrence, skipping the fuzzy line diff.
+    replace_all: z.boolean().optional(),
     // Locale to operate on; defaults to "Default" when omitted.
     activeLocale: z.string().min(1).optional(),
     components: componentsField,
     allowedComponentNames: allowedComponentNamesField,
+    baseContent: baseContentField,
 })
     .meta({ title: "EditorAiEditRequest" });
 export const EditorAiEditResponseSchema = z
@@ -66,6 +73,7 @@ export const EditorAiWriteRequestSchema = z
     activeLocale: z.string().min(1).optional(),
     components: componentsField,
     allowedComponentNames: allowedComponentNamesField,
+    baseContent: baseContentField,
 })
     .meta({ title: "EditorAiWriteRequest" });
 export const EditorAiWriteResponseSchema = z

package/src/events.d.ts

@@ -1,12 +1,12 @@
 import type { BuilderContent, BuilderElement } from "@builder.io/sdk";
 import type { AssistantMessage, AssistantMessageAction } from "./messages.js";
 import type { AssistantSettings } from "./settings.js";
-import type { ExitState, UserSource, CodeGenPosition, ReviewSeverity, ReviewVerdict } from "./codegen.js";
+import type { ExitState, UserSource, CodeGenPosition, ReviewSeverity, ReviewVerdict, AskUserQuestion } from "./codegen.js";
 import type { FileUpload } from "./messages.js";
 import type { BuilderConfigRealtime } from "./builder-config.js";
 import type { DeployFailureReport } from "./projects.js";
 export type BuilderAssistantEventHandler = (ev: BuilderAssistantEvent) => void;
-export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptSubmitEvent | AppReadyEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | AssistantThemeEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent | AppPasteSmartExportEvent | ThreadMessageRetryEvent | AppFigmaImportEvent | AppWebImportEvent | AppMcpServersEvent | AssistantContentInitialEvent | ThreadMessageSummaryEvent | ThreadMessageSummaryCodegenDeltaEvent | ThreadMessageThinkingDeltaEvent | AssistantHeartbeatEvent | ShowUpgradeDialogEvent | AssistantFusionSuggestionEvent | AppNavigateToFusionEvent | ModelPermissionRequiredEvent | ModelPermissionResponseEvent;
+export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptSubmitEvent | AppReadyEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | AssistantThemeEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent | AppPasteSmartExportEvent | ThreadMessageRetryEvent | AppFigmaImportEvent | AppWebImportEvent | AppMcpServersEvent | AssistantContentInitialEvent | ThreadMessageSummaryEvent | ThreadMessageSummaryCodegenDeltaEvent | ThreadMessageThinkingDeltaEvent | AssistantHeartbeatEvent | ShowUpgradeDialogEvent | AssistantFusionSuggestionEvent | AppNavigateToFusionEvent | ModelPermissionRequiredEvent | ModelPermissionResponseEvent | AssistantQuestionRequiredEvent;
 export interface AssistantCompletionResultEvent {
     type: "assistant.result";
     data: {
@@ -1400,4 +1400,16 @@ export interface ModelPermissionResponseEvent extends AwaitResultEvent {
         reason?: string;
     };
 }
+/**
+ * Emitted when the model calls `AskUserQuestion`. The turn pauses; the client
+ * renders the questions and resumes by sending a new completion whose
+ * `toolResults` carries a result with `tool_use_id === data.id`.
+ */
+export interface AssistantQuestionRequiredEvent {
+    type: "assistant.model.question.required";
+    data: {
+        id: string;
+        questions: AskUserQuestion[];
+    };
+}
 export {};

package/src/publish-agent.d.ts

@@ -1,3 +1,4 @@
+import type { GenerateCompletionStep } from "./codegen.js";
 import { z } from "zod";
 export declare const PublishAgentSessionCursorSchema: z.ZodObject<{
     updatedAt: z.ZodNumber;
@@ -23,52 +24,6 @@ export declare const PublishAgentSessionUpdateRequestSchema: z.ZodObject<{
     archived: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type PublishAgentSessionUpdateRequest = z.infer<typeof PublishAgentSessionUpdateRequestSchema>;
-export declare const PublishAgentAttachmentReferenceSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    type: z.ZodString;
-    name: z.ZodOptional<z.ZodString>;
-    size: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export type PublishAgentAttachmentReference = z.infer<typeof PublishAgentAttachmentReferenceSchema>;
-export declare const PublishAgentToolReferenceSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    status: z.ZodEnum<{
-        completed: "completed";
-        requested: "requested";
-    }>;
-}, z.core.$strip>;
-export type PublishAgentToolReference = z.infer<typeof PublishAgentToolReferenceSchema>;
-export declare const PublishAgentSessionMessageSchema: z.ZodObject<{
-    id: z.ZodString;
-    role: z.ZodEnum<{
-        assistant: "assistant";
-        user: "user";
-    }>;
-    senderId: z.ZodOptional<z.ZodString>;
-    content: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodNumber;
-    status: z.ZodEnum<{
-        completed: "completed";
-        error: "error";
-        running: "running";
-    }>;
-    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodOptional<z.ZodString>;
-        type: z.ZodString;
-        name: z.ZodOptional<z.ZodString>;
-        size: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodOptional<z.ZodString>;
-        name: z.ZodString;
-        status: z.ZodEnum<{
-            completed: "completed";
-            requested: "requested";
-        }>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export type PublishAgentSessionMessage = z.infer<typeof PublishAgentSessionMessageSchema>;
 export declare const PublishAgentSessionSummarySchema: z.ZodObject<{
     id: z.ZodString;
     spaceId: z.ZodString;
@@ -114,36 +69,8 @@ export declare const PublishAgentSessionDetailResponseSchema: z.ZodObject<{
         totalCompletions: z.ZodNumber;
         numUserMessages: z.ZodNumber;
     }, z.core.$strip>;
-    messages: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        role: z.ZodEnum<{
-            assistant: "assistant";
-            user: "user";
-        }>;
-        senderId: z.ZodOptional<z.ZodString>;
-        content: z.ZodOptional<z.ZodString>;
-        createdAt: z.ZodNumber;
-        status: z.ZodEnum<{
-            completed: "completed";
-            error: "error";
-            running: "running";
-        }>;
-        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            id: z.ZodOptional<z.ZodString>;
-            type: z.ZodString;
-            name: z.ZodOptional<z.ZodString>;
-            size: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>>;
-        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            id: z.ZodOptional<z.ZodString>;
-            name: z.ZodString;
-            status: z.ZodEnum<{
-                completed: "completed";
-                requested: "requested";
-            }>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    messagesCanLoadMore: z.ZodBoolean;
-    messagesNextCursor: z.ZodNullable<z.ZodString>;
+    steps: z.ZodArray<z.ZodCustom<GenerateCompletionStep, GenerateCompletionStep>>;
+    canLoadMore: z.ZodBoolean;
+    nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type PublishAgentSessionDetailResponse = z.infer<typeof PublishAgentSessionDetailResponseSchema>;

package/src/publish-agent.js

@@ -30,33 +30,6 @@ export const PublishAgentSessionUpdateRequestSchema = z
     message: "Provide title, archived, or both.",
 })
     .meta({ title: "PublishAgentSessionUpdateRequest" });
-export const PublishAgentAttachmentReferenceSchema = z
-    .object({
-    id: z.string().optional(),
-    type: z.string(),
-    name: z.string().optional(),
-    size: z.number().optional(),
-})
-    .meta({ title: "PublishAgentAttachmentReference" });
-export const PublishAgentToolReferenceSchema = z
-    .object({
-    id: z.string().optional(),
-    name: z.string(),
-    status: z.enum(["requested", "completed"]),
-})
-    .meta({ title: "PublishAgentToolReference" });
-export const PublishAgentSessionMessageSchema = z
-    .object({
-    id: z.string(),
-    role: z.enum(["user", "assistant"]),
-    senderId: z.string().optional(),
-    content: z.string().optional(),
-    createdAt: z.number(),
-    status: z.enum(["completed", "running", "error"]),
-    attachments: z.array(PublishAgentAttachmentReferenceSchema).optional(),
-    tools: z.array(PublishAgentToolReferenceSchema).optional(),
-})
-    .meta({ title: "PublishAgentSessionMessage" });
 export const PublishAgentSessionSummarySchema = z
     .object({
     id: z.string(),
@@ -81,8 +54,8 @@ export const PublishAgentSessionListResponseSchema = z
 export const PublishAgentSessionDetailResponseSchema = z
     .object({
     session: PublishAgentSessionSummarySchema,
-    messages: z.array(PublishAgentSessionMessageSchema),
-    messagesCanLoadMore: z.boolean(),
-    messagesNextCursor: z.string().nullable(),
+    steps: z.array(z.custom()),
+    canLoadMore: z.boolean(),
+    nextCursor: z.string().nullable(),
 })
     .meta({ title: "PublishAgentSessionDetailResponse" });