builder.io 1.6.81 → 1.6.83

package/types/cli/code-tools.d.ts

@@ -1,9 +1,7 @@
-import type { CodeGenTools, CommitMode, ContentMessageItemToolResult, GenerateCompletionStep, ProjectFile, WorkspaceFolder } from "$/ai-utils";
+import type { CodeGenTools, CommitMode, ContentMessageItemToolResult, ProjectFile, WorkspaceFolder } from "$/ai-utils";
 import type { DevToolsSys } from "../core";
-import { type ChildProcessByStdio } from "child_process";
-import type { RunCommandCtx } from "./codegen";
-import type EventEmitter from "events";
-import type { Readable } from "stream";
+import { type DevServerOrchestrator } from "./launch/dev-server-orchestrator";
+import type { CodeGenEventEmitter } from "./codegen";
 export interface LLMToolCalls {
     name: CodeGenTools;
     input: Record<string, any>;
@@ -15,9 +13,8 @@ export interface ToolResolution {
     title?: string;
 }
 export interface FusionContext {
-    commandCtx?: RunCommandCtx;
+    devServerOrchestrator?: DevServerOrchestrator;
     checkCommand?: string;
-    serverUrl: string;
     allowedCommands: RegExp[];
     commitMode: CommitMode;
     git: boolean;
@@ -28,10 +25,7 @@ export interface FusionContext {
 export interface ToolContext extends Partial<FusionContext> {
     sys: DevToolsSys;
     files: ProjectFile[];
-    emitter: EventEmitter<{
-        step: [GenerateCompletionStep];
-        idle: [];
-    }>;
+    emitter: CodeGenEventEmitter;
     signal: AbortSignal | undefined;
     workingDirectory: string;
     resolveWorkspacePath: (path: string, forceWorkspace: boolean) => {
@@ -63,5 +57,4 @@ interface RipgrepResult {
 }
 export declare function runRipgrep(sys: DevToolsSys, workingDirectory: string, pattern: string, includeGlob?: string, excludeGlob?: string): Promise<RipgrepResult>;
 export declare function newAbortError(): Error;
-export declare function killProcess(sys: DevToolsSys, proc: ChildProcessByStdio<null, Readable, Readable> | undefined, abortSignal?: AbortSignal, timeout?: number): Promise<boolean>;
 export {};

package/types/cli/codegen.d.ts

@@ -1,24 +1,9 @@
 import type { DevToolsSys } from "../types";
 import { type Credentials } from "./credentials";
-import type { CodegenFeedback, CodegenTurn, CommitMode, CustomInstruction, GenerateCompletionState, GenerateCompletionStep, GenerateCompletionStepGit, GenerateUserMessage, UserContext, WorkspaceConfiguration, WorkspaceFolder } from "$/ai-utils";
+import type { CodegenFeedback, CodegenTurn, CommitMode, CustomInstruction, FusionConfig, GenerateCompletionState, GenerateCompletionStep, GenerateCompletionStepGit, GenerateUserMessage, UserContext, WorkspaceConfiguration, WorkspaceFolder } from "$/ai-utils";
 import prettier from "prettier";
 import { type FusionContext } from "./code-tools";
-export interface RunCommandCtx {
-    command: string;
-    state: "running" | "stopped";
-    ensureRunning: (abortSignal?: AbortSignal) => Promise<boolean>;
-    addCheckpoint: () => void;
-    getCheckpoints: (n: number, mode: "all" | "out" | "err") => string;
-    getAllStdout: () => string;
-    getAllStderr: () => string;
-    getOutput: () => string;
-    waitUntilIdle: (initialWaitMs?: number, idleTimeMs?: number) => Promise<void>;
-    pid: number | undefined;
-    onClose: (callback: (code: number | null) => void) => void;
-    onStdout: (callback: (data: string) => void) => void;
-    onStderr: (callback: (data: string) => void) => void;
-    restart: (abortSignal?: AbortSignal) => Promise<void>;
-}
+import EventEmitter from "node:events";
 export interface SessionContext {
     sessionId: string;
     turns: CodegenTurn[];
@@ -42,6 +27,7 @@ export interface CodeGenSessionOptionsBase {
     workingDirectory?: string;
     workspace?: WorkspaceConfiguration;
     mcpServers?: boolean;
+    enabledTools?: string;
 }
 export interface CodeGenSessionOptionsSession extends CodeGenSessionOptionsBase {
     sessionOrCompletionId?: string;
@@ -50,6 +36,11 @@ export interface CodeGenSessionOptionsInitialUrl extends CodeGenSessionOptionsBa
     initialUrl: string;
 }
 export type CodeGenSessionOptions = CodeGenSessionOptionsSession | CodeGenSessionOptionsInitialUrl;
+export type CodeGenEventEmitter = EventEmitter<{
+    step: [GenerateCompletionStep];
+    idle: [];
+    fusionConfigPatch: [Partial<FusionConfig>];
+}>;
 export declare class CodeGenSession {
     #private;
     constructor(options: CodeGenSessionOptions);

package/types/cli/index.d.ts

@@ -57,4 +57,6 @@ export interface CLIArgs {
     serverUrl?: string;
     /** Remove all mappings from the space, publishing zero mappings even if mapper files exist */
     clearMappings?: boolean;
+    /** Enabled tools, list of strings separated by commas */
+    enabledTools?: string;
 }

package/types/cli/launch/InitStateMachine.d.ts

@@ -19,6 +19,20 @@ export interface InitConfig {
     sys: DevToolsSys;
     debug?: boolean;
 }
+export declare enum InitErrorType {
+    FATAL = "fatal",
+    SOFT_ERROR = "soft-error",
+    HARD_ERROR = "hard-error"
+}
+export interface InitError {
+    userMessage: string;
+    contextForLLMs?: string;
+    type: InitErrorType;
+}
+export interface InitExecutionResult {
+    success: boolean;
+    errors: InitError[];
+}
 export interface InitStatus {
     state: InitState;
     progress: number;
@@ -62,6 +76,7 @@ export declare class InitStateMachine extends EventEmitter implements TypedEvent
     private operationLog;
     private operationCounter;
     private readonly repositories;
+    private allInitErrors;
     constructor(config: InitConfig);
     private updateStatus;
     private sanitizeError;
@@ -79,7 +94,7 @@ export declare class InitStateMachine extends EventEmitter implements TypedEvent
     private configureGitUser;
     private installDependencies;
     private stashChanges;
-    execute(signal?: AbortSignal): Promise<boolean>;
+    execute(signal?: AbortSignal): Promise<InitExecutionResult>;
     getCurrentState(): InitState;
     getMetadata(): Record<string, any>;
     getOperationLog(): OperationLogEntry[];

package/types/cli/launch/dev-server-orchestrator.d.ts

@@ -0,0 +1,33 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+import { type RequestHandler as ProxyRequestHandler } from "http-proxy-middleware";
+import { type ChildProcessByStdio } from "node:child_process";
+import type { Readable } from "node:stream";
+import type { FusionConfig } from "$/ai-utils";
+export type RunCommandState = "running" | "stopped" | "idle";
+export interface DevServerOrchestrator {
+    command: string;
+    state: RunCommandState;
+    proxyTarget: string;
+    proxyPort: number;
+    proxyMiddleware: ProxyRequestHandler | undefined;
+    pid: number | undefined;
+    ensureRunning: (abortSignal?: AbortSignal) => Promise<boolean>;
+    setCommand: (newCommand: string, signal?: AbortSignal) => Promise<boolean>;
+    setPort: (newPort: number) => Promise<boolean>;
+    pingServer: (signal?: AbortSignal) => Promise<Response>;
+    addCheckpoint: () => void;
+    getOpenPorts: () => Promise<number[]>;
+    getCheckpoints: (n: number, mode: "all" | "out" | "err") => string;
+    getAllStdout: () => string;
+    getAllStderr: () => string;
+    getOutput: () => string;
+    waitUntilIdle: (initialWaitMs?: number, idleTimeMs?: number) => Promise<void>;
+    onClose: (callback: (code: number | null) => void) => void;
+    onStdout: (callback: (data: string) => void) => void;
+    onStderr: (callback: (data: string) => void) => void;
+    restart: (abortSignal?: AbortSignal) => Promise<void>;
+}
+export declare function devServerOrchestrator(sys: DevToolsSys, fusionConfig: FusionConfig): Promise<DevServerOrchestrator>;
+export declare function createMockRunCommandCtx(): DevServerOrchestrator;
+export declare const checkPortsListenedByPid: (pid: number) => number[];
+export declare function killProcess(sys: DevToolsSys, proc: ChildProcessByStdio<null, Readable, Readable> | undefined, abortSignal?: AbortSignal, timeout?: number): Promise<boolean>;

package/types/cli/launch/errors.d.ts

@@ -0,0 +1,3 @@
+export declare const isGitHubAuthError: (errorMessage: string) => boolean;
+export declare const getGitHubAuthErrorMessage: (repoName: string, hasGhToken: boolean) => string;
+export declare const getUserMessageForNpmInstallErrors: (errorOutput: string) => string;

package/types/cli/launch/proxy.d.ts

@@ -0,0 +1,3 @@
+import { type Options as ProxyOptions } from "http-proxy-middleware";
+import type { DevToolsSys } from "types";
+export declare const createProxyOptions: (serverUrl: string, sys: DevToolsSys) => ProxyOptions;

package/types/cli/launch/server.d.ts

@@ -8,8 +8,9 @@ export declare const NON_AUTHENTICATED_ENDPOINTS: {
     readonly STATUS: "/status";
     readonly PROXY_STATUS: "/proxy-status";
 };
-export declare const configureServer: ({ app, validBuilderPrivateKey, authenticateProxy, }: {
+export declare const configureServer: ({ app, validBuilderPrivateKey, authenticateProxy, isLocal, }: {
     app: Express;
     validBuilderPrivateKey: string | undefined;
     authenticateProxy: boolean;
+    isLocal: boolean;
 }) => void;

package/types/cli/launch.d.ts

@@ -23,6 +23,12 @@ export interface LaunchArgs extends CLIArgs {
     dev?: boolean;
     /** Skip browser auto-open (flag form) */
     open?: boolean;
+    /**
+     * If true, CLI will run the init command instead of the launch command.
+     *
+     * @default false
+     */
+    fusionInit?: boolean;
     /**
      * If true, CLI will be interactive and prompt the user for input.
      *
@@ -60,4 +66,4 @@ export interface LaunchArgs extends CLIArgs {
 export declare function runFusionCommand({ sys, args, }: {
     sys: DevToolsSys;
     args: LaunchArgs;
-}): Promise<undefined>;
+}): Promise<void>;

package/types/cli/utils/component-group-mdx-prompt.d.ts

@@ -1 +1 @@
-export declare const COMPONENT_GROUP_MDX_PROMPT = "# Component Group Documentation Generation\n\n## Objective\nGenerate comprehensive MDX documentation for a specific component group, analyzing their interfaces, relationships, and usage patterns using only the relevant files provided in the input.\n\n## Instructions\n\n### 1. Component Analysis\nFor the given component group, analyze each relevant file by:\n- **Interface examination** - Extract and document all props, their types, and descriptions\n- **Usage pattern analysis** - Identify how components work together\n- **Relationship mapping** - Document dependencies and coupling between components\n- **Example extraction** - Find real usage examples from the codebase\n\n### 2. Documentation Structure\nCreate comprehensive documentation covering:\n- **Group overview** - Purpose and architectural decisions\n- **Component interfaces** - Detailed prop documentation\n- **Usage examples** - Practical code examples\n- **Best practices** - Recommended usage patterns\n\n## Required Output Format\n\nGenerate an MDX file with this structure:\n\n```mdx\n---\ntitle: \"{{GROUP_NAME}} Components\"\ndescription: \"{{GROUP_DESCRIPTION}}\"\ncomponents: [{{COMPONENT_LIST}}]\nrelevantFiles: [{{FILE_LIST}}]\n---\n\n# {{GROUP_NAME}} Components\n\n## Overview\n[Detailed description of the component group, its purpose, and architectural decisions]\n\n## Components\n\n### [Component1Name]\n\n**Interface:**\n```typescript\ninterface [Component1]Props {\n  // Document all props with types and descriptions\n  property: string; // Description of what this prop does\n  onAction?: () => void; // Optional callback description\n}\n```\n\n**Usage Example:**\n```tsx\nimport { [Component1] } from '@cloudscape-design/components';\n\nfunction Example() {\n  return (\n    <[Component1]\n      property=\"value\"\n      onAction={() => console.log('action')}\n    >\n      Content\n    </[Component1]>\n  );\n}\n```\n\n### [Component2Name]\n[Repeat structure for each component]\n\n## Component Relationships\n\n[Explain how components in this group work together, including:]\n- Shared contexts or state\n- Compositional patterns\n- Data flow between components\n- Common usage combinations\n\n## Best Practices\n\n- [Practice 1: Specific recommendation]\n- [Practice 2: Another recommendation]\n- [Practice 3: Usage pattern guidance]\n\n## Common Patterns\n\n### Pattern 1: [Pattern Name]\n```tsx\n// Example of common usage pattern\n<[ParentComponent]>\n  <[ChildComponent1] />\n  <[ChildComponent2] />\n</[ParentComponent]>\n```\n\n### Pattern 2: [Another Pattern]\n```tsx\n// Another common pattern\n```\n\n## Related Groups\n\n- [Link to related component groups]\n- [Cross-references to components used together]\n```\n\n## File Generation Requirements\n\n**File Naming:**\n- Use kebab-case derived from group name: `{{GROUP_NAME_KEBAB}}.mdx`\n- Place in `repo-indexing/` folder\n- Example: `repo-indexing/{{GROUP_NAME_KEBAB}}.mdx`\n\n**Content Requirements:**\n1. **Extract real interfaces** - Don't create placeholder interfaces, extract actual TypeScript interfaces from the codebase\n2. **Include practical examples** - Use realistic, working code examples\n3. **Document all props** - Include type information, default values, and descriptions\n4. **Explain relationships** - Focus on how components work together within the group\n5. **Provide context** - Explain architectural decisions and design patterns\n\n**Quality Standards:**\n- All code examples must be syntactically correct\n- Interface documentation must match actual component props\n- Examples should demonstrate real-world usage scenarios\n- Include accessibility considerations where relevant\n\n## Input Format\nYou will receive a single component group object:\n```json\n{\n  \"name\": \"{{GROUP_NAME}}\", \n  \"description\": \"{{GROUP_DESCRIPTION}}\",\n  \"components\": [{{COMPONENT_LIST}}],\n  \"relevantFiles\": [{{FILE_LIST}}]\n}\n```\n\n## Output\nReturn only the complete MDX file content, ready to be saved as `repo-indexing/{{GROUP_NAME_KEBAB}}.mdx`";
+export declare const COMPONENT_GROUP_MDX_PROMPT = "# Component Group Documentation Generation\n\n## Objective\nGenerate comprehensive MDX documentation for a specific component group, analyzing their interfaces, relationships, and usage patterns using only the relevant files provided in the input.\n\n## Instructions\n\n### 1. Component Analysis\nFor the given component group, analyze each relevant file by:\n- **Interface examination** - Extract and document all props, their types, and descriptions\n- **Usage pattern analysis** - Identify how components work together\n- **Relationship mapping** - Document dependencies and coupling between components\n- **Example extraction** - Find real usage examples from the codebase\n\n### 2. Documentation Structure\nCreate comprehensive documentation covering:\n- **Group overview** - Purpose and architectural decisions\n- **Component interfaces** - Detailed prop documentation\n- **Usage examples** - Practical code examples\n- **Best practices** - Recommended usage patterns\n\n## Required Output Format\n\nGenerate an MDX file with this structure:\n\n```mdx\n---\n# {{GROUP_NAME}} Components\n\n## Overview\n[Detailed description of the component group, its purpose, and architectural decisions]\n\n## Components\n\n### [Component1Name]\n\n**Interface:**\n```typescript\ninterface [Component1]Props {\n  // Document all props with types and descriptions\n  property: string; // Description of what this prop does\n  onAction?: () => void; // Optional callback description\n}\n```\n\n**Usage Example:**\n```tsx\nimport { [Component1] } from '@cloudscape-design/components';\n\nfunction Example() {\n  return (\n    <[Component1]\n      property=\"value\"\n      onAction={() => console.log('action')}\n    >\n      Content\n    </[Component1]>\n  );\n}\n```\n\n### [Component2Name]\n[Repeat structure for each component]\n\n## Component Relationships\n\n[Explain how components in this group work together, including:]\n- Shared contexts or state\n- Compositional patterns\n- Data flow between components\n- Common usage combinations\n\n## Best Practices\n\n- [Practice 1: Specific recommendation]\n- [Practice 2: Another recommendation]\n- [Practice 3: Usage pattern guidance]\n\n## Common Patterns\n\n### Pattern 1: [Pattern Name]\n```tsx\n// Example of common usage pattern\n<[ParentComponent]>\n  <[ChildComponent1] />\n  <[ChildComponent2] />\n</[ParentComponent]>\n```\n\n### Pattern 2: [Another Pattern]\n```tsx\n// Another common pattern\n```\n\n## Related Groups\n\n- [Link to related component groups]\n- [Cross-references to components used together]\n```\n\n## File Generation Requirements\n\n**File Naming:**\n- Use kebab-case derived from group name: `{{GROUP_NAME_KEBAB}}.mdx`\n- Place in `repo-indexing/` folder\n- Example: `repo-indexing/{{GROUP_NAME_KEBAB}}.mdx`\n\n**Content Requirements:**\n1. **Extract real interfaces** - Don't create placeholder interfaces, extract actual TypeScript interfaces from the codebase\n2. **Include practical examples** - Use realistic, working code examples\n3. **Document all props** - Include type information, default values, and descriptions\n4. **Explain relationships** - Focus on how components work together within the group\n5. **Provide context** - Explain architectural decisions and design patterns\n\n**Quality Standards:**\n- All code examples must be syntactically correct\n- Interface documentation must match actual component props\n- Examples should demonstrate real-world usage scenarios\n- Include accessibility considerations where relevant\n\n## Input Format\nYou will receive a single component group object:\n```json\n{\n  \"name\": \"{{GROUP_NAME}}\", \n  \"description\": \"{{GROUP_DESCRIPTION}}\",\n  \"components\": [{{COMPONENT_LIST}}],\n  \"relevantFiles\": [{{FILE_LIST}}]\n}\n```\n\n## Output\nReturn only the complete MDX file content, ready to be saved as `repo-indexing/{{GROUP_NAME_KEBAB}}.mdx`";