@builder.io/dev-tools 1.28.17-dev.202603022023.5dff3f8ef → 1.28.17-dev.202603031856.393f0415b

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

@@ -22,6 +22,7 @@ export interface ToolContext {
     debug: boolean;
     sys: DevToolsSys;
     credentials: Credentials;
+    asyncSubAgents: boolean;
     files: ProjectFile[];
     user: UserSource;
     position: CodeGenPosition;

package/types/cli/codegen.d.ts

@@ -1,6 +1,6 @@
 import type { DevToolsSys } from "../types";
 import { type Credentials } from "./credentials";
-import type { CodegenFeedback, CodeGenToolMap, CodegenTurn, CustomInstruction, FusionConfig, GenerateCompletionState, GenerateCompletionStep, GenerateUserMessage, SessionMode, UserContext, UserSource, WorkspaceFolder, LoadWholeSessionOptions, LoadWholeSessionResult, LoadHistoryResult, CodeGenMode, ApplyActionsResult, PrivacyMode, CodeGenPosition, BackupGitRepoResult, SuggestedActionBuildError, PushChangesArgs, CodegenApiResult, CodegenApiTerminal, ConfigureDevOrchestratorOpts, ConfigureDevOrchestratorUpdates, RepoMetrics, FolderWatchEvent, MCPServerConfig, CodegenApiCreateTerminal, SyncChangesFromRemote, SearchFilesOptions, SearchFilesResult, SearchFileTreeOptions, SearchFileTreeResult, HttpServerState, ExplorationMetadataToolInput, CodegenAbortOptions, MessageUpdateOptions, GitRepoContext, SystemReminderObj, GitSnapshot, AutoPushMode } from "$/ai-utils";
+import type { CodegenFeedback, CodeGenToolMap, CodegenTurn, CustomInstruction, FusionConfig, GenerateCompletionState, GenerateCompletionStep, GenerateUserMessage, SessionMode, UserContext, UserSource, WorkspaceFolder, LoadWholeSessionOptions, LoadWholeSessionResult, LoadHistoryResult, CodeGenMode, ApplyActionsResult, PrivacyMode, CodeGenPosition, BackupGitRepoResult, SuggestedActionBuildError, PushChangesArgs, CodegenApiResult, CodegenApiTerminal, ConfigureDevOrchestratorOpts, ConfigureDevOrchestratorUpdates, RepoMetrics, FolderWatchEvent, MCPServerConfig, CodegenApiCreateTerminal, SyncChangesFromRemote, SearchFilesOptions, SearchFilesResult, SearchFileTreeOptions, SearchFileTreeResult, HttpServerState, ExplorationMetadataToolInput, CodegenAbortOptions, MessageUpdateOptions, GitRepoContext, SystemReminderObj, GitSnapshot, AutoPushMode, QueueMode, CustomAgentDefinition } from "$/ai-utils";
 import { type ToolResolution } from "./code-tools";
 import { type SubAgent } from "./utils/agent-discovery";
 import EventEmitter from "node:events";
@@ -26,7 +26,7 @@ export interface SessionContext {
     sessionId: string;
     turns: CodegenTurn[];
     customInstructions: CustomInstruction[];
-    customAgents: SubAgent[];
+    customAgents: CustomAgentDefinition[];
     userContext: UserContext;
     prettierConfig: Record<string, unknown> | null;
     state: GenerateCompletionState;
@@ -43,6 +43,7 @@ export interface CodeGenSessionOptionsBase {
     position: CodeGenPosition;
     maxTokens?: number;
     mode: CodeGenMode;
+    queueMode?: QueueMode;
     privacyMode?: PrivacyMode;
     builtInCustomInstructions?: CustomInstruction[];
     builtInCustomAgents?: SubAgent[];
@@ -61,6 +62,7 @@ export interface CodeGenSessionOptionsBase {
     agentType?: string;
     includeMemories?: boolean;
     fusionStatusMonitor?: FusionStatusMonitor;
+    asyncSubAgents?: boolean;
 }
 export interface CodeGenSessionOptionsSession extends CodeGenSessionOptionsBase {
     sessionOrCompletionId?: string;
@@ -96,6 +98,7 @@ export declare class CodeGenSession {
     /** Returns runtime git repo contexts for all enabled repos */
     get gitRepoContexts(): readonly GitRepoContext[];
     get workingDirectory(): string;
+    get bashWorkingDirectory(): string;
     getSessionMode(): SessionMode;
     switchSessionMode(newMode: SessionMode): Promise<void>;
     removeSystemReminder(tag: string): void;
@@ -309,6 +312,14 @@ export declare class CodeGenSession {
         resume?: string;
         mcpServers?: boolean;
     }): Promise<SpawnAgentResult>;
+    /**
+     * Returns info about currently running background sub-agents.
+     */
+    getRunningSubAgents(): Array<{
+        id: string;
+        description: string;
+        startedAt: number;
+    }>;
     setProxyOrigin(proxySrc: string | undefined, proxyDefaultOrigin: string | undefined): void;
     getTurns(): CodegenTurn[];
     getSessionContext(): SessionContext;
@@ -444,6 +455,12 @@ export declare class CodeGenSession {
      * @returns The file content or null if the file doesn't exist
      */
     readFile(filePath: string, skipAclCheck?: boolean): Promise<string | null>;
+    /**
+     * Reads a binary file from the workspace and returns its content as base64.
+     * Unlike readFile which reads as UTF-8 (corrupting binary data), this method
+     * preserves binary content by encoding it as base64.
+     */
+    readBinaryFile(filePath: string): Promise<string | null>;
     /**
      * Gets file content at a specific git reference (e.g., origin/main, HEAD~1, commit hash)
      * @param filePath - The file path relative to the workspace
@@ -524,6 +541,17 @@ export declare class CodeGenSession {
      * @returns Array of file names in the directory or empty array if directory doesn't exist
      */
     listDir(dirPath: string): Promise<string[]>;
+    /**
+     * List custom instructions (rules and skills) discovered from the workspace.
+     * Returns instructions with isSkill flag to distinguish skills from rules.
+     */
+    listCustomInstructions(): Promise<Array<{
+        id: string;
+        name: string;
+        description?: string;
+        type?: string;
+        isSkill: boolean;
+    }>>;
     /**
      * Get stats for a file in the workspace
      * @param filePath A file path that may include a workspace prefix

package/types/cli/index.d.ts

@@ -154,4 +154,6 @@ export interface CLIArgs {
      * Requires designSystemName to be provided or will prompt for it.
      */
     testFusionExample?: boolean;
+    /** Run space-sync in continuous mode, syncing every 2 minutes */
+    continuous?: boolean;
 }

package/types/cli/org-agent/branch-tools.d.ts

@@ -0,0 +1,4 @@
+import type { SendMessageToBranchToolInput, SpawnBranchToolInput } from "$/ai-utils";
+import type { ToolContext, ToolResolution } from "../code-tools";
+export declare function spawnBranch(toolContext: ToolContext, input: SpawnBranchToolInput): Promise<ToolResolution>;
+export declare function sendMessageToBranch(toolContext: ToolContext, input: SendMessageToBranchToolInput): Promise<ToolResolution>;

package/types/cli/org-agent/cron-checker.d.ts

@@ -0,0 +1,6 @@
+export interface StartCronCheckerOptions {
+    cronFilePath: string;
+    emitMessage: (content: string) => Promise<void>;
+    intervalMs?: number;
+}
+export declare function startCronChecker(options: StartCronCheckerOptions): () => void;

package/types/cli/org-agent/sync-org-tree.d.ts

@@ -0,0 +1,3 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+import type { CLIArgs } from "../index";
+export declare function runSpaceSyncCommand(sys: DevToolsSys, args: CLIArgs): Promise<void>;

package/types/cli/org-agent/tree-builder.d.ts

@@ -0,0 +1,8 @@
+import type { DevToolsSys } from "../../core";
+export interface SyncOrgTreeOptions {
+    sys: DevToolsSys;
+    ownerId: string;
+    privateKey: string;
+    outputDir: string;
+}
+export declare function syncOrgTree(options: SyncOrgTreeOptions): Promise<void>;

package/types/cli/org-agent/tree-builder.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/cli/utils/agent-parser.d.ts

@@ -2,7 +2,7 @@
  * Agent definition parsing utilities
  * Handles parsing of custom agent definition files
  */
-import type { CodeGenMode } from "$/ai-utils";
+import type { CodeGenMode, QueueMode } from "$/ai-utils";
 export interface SubAgent {
     name: string;
     description?: string;
@@ -16,6 +16,8 @@ export interface SubAgent {
     needDevServer?: boolean;
     needValidation?: boolean;
     resetAfterRun?: boolean;
+    mcpServers?: boolean;
+    queueMode?: QueueMode;
 }
 /**
  * Parses an agent definition file (Markdown with YAML frontmatter)

package/types/cli/utils/agents/org-agent-system-prompt.d.ts

@@ -0,0 +1,11 @@
+export interface OrgAgentSystemPromptOptions {
+    soulMd?: string;
+    agentsMd?: string;
+    activeProjectsSummary?: string;
+    memoriesContext?: string;
+}
+/**
+ * Assembles the full system prompt for the org agent by concatenating
+ * the SOUL.md, AGENTS.md, active projects summary, and memories context.
+ */
+export declare function assembleOrgAgentSystemPrompt(options: OrgAgentSystemPromptOptions): string;

package/types/cli/utils/agents/org-agent.d.ts

@@ -0,0 +1,2 @@
+import type { CustomAgentDefinition } from "$/ai-utils";
+export declare const ORG_AGENT: CustomAgentDefinition;

package/types/cli/utils/agents/org-worker.d.ts

@@ -0,0 +1,2 @@
+import type { CustomAgentDefinition } from "$/ai-utils";
+export declare const ORG_WORKER: CustomAgentDefinition;

package/types/cli/utils/agents/project-setup-agent.d.ts

@@ -0,0 +1,2 @@
+import type { CustomAgentDefinition } from "$/ai-utils";
+export declare const PROJECT_SETUP_AGENT: CustomAgentDefinition;

package/types/cli/utils/memory-sync.d.ts

@@ -22,4 +22,8 @@ export declare function loadMemories(sys: DevToolsSys, credentials: Credentials,
  * Write memories to `.builder/memories/` as markdown files grouped by category.
  * Errors are silently swallowed to avoid blocking session initialization.
  */
-export declare function syncMemoriesToDisk(sys: DevToolsSys, memories: MemorySummary[], rootDir: string): Promise<void>;
+/**
+ * Write memories as markdown files into the given directory.
+ * Clears the directory first, then writes category files.
+ */
+export declare function syncMemoriesToDir(sys: DevToolsSys, memories: MemorySummary[], memoriesDir: string): Promise<void>;

package/types/cli/utils/workspace-path-resolver.d.ts

@@ -1,4 +1,4 @@
-import type { WorkspaceFolder, WorkspaceConfiguration } from "@builder.io/ai-utils";
+import type { WorkspaceFolder, WorkspaceConfiguration } from "$/ai-utils";
 import type { DevToolsPath, DevToolsSys } from "../../types";
 export interface ResolveWorkspacePathOptions {
     filePath: string;

package/types/common/ast/component-input-types.d.ts

@@ -17,7 +17,7 @@ export declare const NUMBER_TYPES: string[];
 export declare const BOOLEAN_TYPES: string[];
 export declare const ARRAY_TYPES: string[];
 export declare const OBJECT_TYPES: string[];
-export declare function getPrimitiveType(t: string): "number" | "string" | "boolean" | "object" | "array";
+export declare function getPrimitiveType(t: string): "string" | "object" | "number" | "boolean" | "array";
 export declare function removeQuotes(text: string): string;
 export declare const resolveType: (sys: DevToolsSys, checker: ts.TypeChecker, type: ts.Type) => string[] | undefined;
 export declare const typeToString: (sys: DevToolsSys, checker: ts.TypeChecker, type: ts.Type) => string;

package/types/common/utils.d.ts

@@ -19,7 +19,7 @@ export declare function clone<T>(obj: T): T;
 export declare function shouldSkipFolder(sys: DevToolsSys, skipFolders: Set<string>, fileName: string): boolean;
 export declare function getPackageManager(): string;
 export declare function isWindows(): boolean;
-export declare function builderNpxPackage(): "@builder.io/agent" | "\"@builder.io/dev-tools\"" | "builder.io";
+export declare function builderNpxPackage(): "builder.io" | "@builder.io/agent" | "\"@builder.io/dev-tools\"";
 /**
  * Sanitizes a component name for use in filesystem paths by replacing invalid characters with underscores
  * @param name The component name to sanitize