@builder.io/ai-utils 0.18.6 → 0.18.7

package/package.json

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

package/src/codegen.d.ts

@@ -41,6 +41,7 @@ export interface CustomAgentDefinition {
     systemPrompt?: string;
     tools?: string[];
     model?: string;
+    position?: string;
     needDevServer?: boolean;
     needValidation?: boolean;
     includeMemories?: boolean;
@@ -224,6 +225,82 @@ export interface RecordFrameToolInput {
     title: string;
     frame: "last-image";
 }
+/**
+ * Configuration values proposed by the setup analyzer agent
+ */
+export interface SetupAnalysisValues {
+    projectOverview: {
+        framework: string | null;
+        packageManager: "npm" | "yarn" | "pnpm" | "bun" | null;
+        isMonorepo: boolean;
+        detectedLanguage: "typescript" | "javascript" | null;
+    };
+    rootDirectory: {
+        path: string;
+        reason: string;
+    } | null;
+    installCommand: {
+        command: string;
+        reason: string;
+    } | null;
+    runtimeDependencies: Array<{
+        tool: string;
+        version: string;
+        source: string;
+    }>;
+    devServer: {
+        command: string;
+        url: string;
+        port: number;
+        reason: string;
+    } | null;
+    environmentVariables: Array<{
+        key: string;
+        description: string;
+        isRequired: boolean;
+        isSecret: boolean;
+        defaultValue: string | null;
+        source: string;
+    }>;
+    validationScript: {
+        command: string;
+        reason: string;
+    } | null;
+    npmrcContents: string | null;
+}
+export interface ProposeConfigToolInput {
+    config: SetupAnalysisValues;
+    message?: string;
+}
+export type SetupValueField = "installCommand" | "devServer" | "validationScript";
+export interface UpdateSetupValueToolInput {
+    field: SetupValueField;
+    value: {
+        command: string;
+        url?: string;
+        port?: number;
+    };
+    reason: string;
+}
+export interface VerifyInstallCommandToolInput {
+    command: string;
+    timeout?: number;
+}
+export interface VerifyDevServerToolInput {
+    command: string;
+    url: string;
+    port: number;
+    timeout?: number;
+}
+export interface VerifyValidationScriptToolInput {
+    command: string;
+    timeout?: number;
+}
+export interface VerifyRuntimeDependencyToolInput {
+    tool: string;
+    version: string;
+    source?: string;
+}
 export interface AddQAReviewComment {
     file_path: string;
     line: number;
@@ -293,9 +370,15 @@ export interface CodeGenToolMap {
     ExitPlanMode: ExitPlanModeToolInput;
     ReadMcpResource: ReadMcpResourceToolInput;
     RecordFrame: RecordFrameToolInput;
+    ProposeConfig: ProposeConfigToolInput;
+    UpdateSetupValue: UpdateSetupValueToolInput;
     AddQAReview: AddQAReviewToolInput;
     ResolveQAComments: ResolveQACommentsToolInput;
     ReportUIIssue: ReportUIIssueToolInput;
+    VerifyInstallCommand: VerifyInstallCommandToolInput;
+    VerifyDevServer: VerifyDevServerToolInput;
+    VerifyValidationScript: VerifyValidationScriptToolInput;
+    VerifyRuntimeDependency: VerifyRuntimeDependencyToolInput;
 }
 export type CodeGenTools = keyof CodeGenToolMap;
 export type AllCodeGenTools = CodeGenTools | "web_search";
@@ -782,9 +865,24 @@ export interface GenerateCompletionStepTerminals {
     type: "terminals";
     terminals: CodegenApiTerminal[];
 }
+export interface GenerateCompletionStepProposeConfig {
+    type: "propose_config";
+    config: SetupAnalysisValues;
+    message?: string;
+}
+export interface GenerateCompletionStepUpdateSetupValue {
+    type: "update_setup_value";
+    field: SetupValueField;
+    value: {
+        command: string;
+        url?: string;
+        port?: number;
+    };
+    reason: string;
+}
 export type GenerateCompletionStep = {
     timestamp?: number;
-} & (GenerateCompletionStepPlanning | GenerateCompletionStepStart | GenerateCompletionStepDelta | GenerateCompletionStepUser | GenerateCompletionStepFile | GenerateCompletionStepDiff | GenerateCompletionStepTool | GenerateCompletionStepError | GenerateCompletionStepContinue | GenerateCompletionStepWaitForInput | GenerateCompletionStepAbort | GenerateCompletionStepDone | GenerateCompletionStepUserInput | GenerateCompletionStepText | GenerateCompletionStepRestore | GenerateCompletionStepState | GenerateCompletionStepStdio | GenerateCompletionStepSession | GenerateCompletionStepServerToolResult | GenerateCompletionStepGit | GenerateCompletionStepBuilderAction | GenerateCompletionStepToolResult | GenerateCompletionStepFusionConfigPatch | GenerateCompletionStepToolCallRequest | GenerateCodeEventMCPStatus | GenerateCodeEventMCPAuthRequired | GenerateCompletionStepDevServerState | GenerateCompletionStepAgent | GenerateCompletionStepBatch | GenerateCompletionStepTerminals | GenerateCompletionStepMetadata | GenerateCompletionStepMessageQueue);
+} & (GenerateCompletionStepPlanning | GenerateCompletionStepStart | GenerateCompletionStepDelta | GenerateCompletionStepUser | GenerateCompletionStepFile | GenerateCompletionStepDiff | GenerateCompletionStepTool | GenerateCompletionStepError | GenerateCompletionStepContinue | GenerateCompletionStepWaitForInput | GenerateCompletionStepAbort | GenerateCompletionStepDone | GenerateCompletionStepUserInput | GenerateCompletionStepText | GenerateCompletionStepRestore | GenerateCompletionStepState | GenerateCompletionStepStdio | GenerateCompletionStepSession | GenerateCompletionStepServerToolResult | GenerateCompletionStepGit | GenerateCompletionStepBuilderAction | GenerateCompletionStepToolResult | GenerateCompletionStepFusionConfigPatch | GenerateCompletionStepToolCallRequest | GenerateCodeEventMCPStatus | GenerateCodeEventMCPAuthRequired | GenerateCompletionStepDevServerState | GenerateCompletionStepAgent | GenerateCompletionStepBatch | GenerateCompletionStepTerminals | GenerateCompletionStepMetadata | GenerateCompletionStepMessageQueue | GenerateCompletionStepProposeConfig | GenerateCompletionStepUpdateSetupValue);
 export interface ApplyActionsResult {
     filePath: string;
     addedLines: number;
@@ -864,6 +962,8 @@ export interface GenerateUserMessage {
     enabledMCPs?: string[];
     sessionMode?: SessionMode;
     queue?: boolean;
+    /** Custom agent type to use for this message */
+    agentType?: string;
     /** Enable AddQAReview tool for QA PR review branches */
     enableQAReviewTool?: boolean;
     /** @deprecated */