@builder.io/dev-tools 1.49.0-dev.202604280837.d3fa6e0b7 → 1.49.0-dev.202604281510.704996d11

package/types/cli/codegen.d.ts

@@ -319,6 +319,8 @@ export declare class CodeGenSession {
          * slot is freed promptly instead of sitting idle for 30min.
          */
         browserDisconnectUrl?: string;
+        /** Optional override for the maximum timeout for this agent. */
+        maxTimeoutMs?: number;
     } | {
         success: false;
         response: string;

package/types/cli/constants.d.ts

@@ -1 +1 @@
-export declare const apiAirV2Host = "https://a485-2409-40e2-209b-6375-bd83-4261-2db0-1881.ngrok-free.app";
+export declare const apiAirV2Host: string;

package/types/cli/launch.d.ts

@@ -117,6 +117,6 @@ export declare function runFusionCommand({ sys, args, existingSession, }: {
     args: LaunchArgs;
     existingSession?: CodeGenSession;
 }): Promise<void>;
-declare const PUBLIC_METHODS: ("abort" | "abortSetupCommand" | "abortValidateCommand" | "switchSessionMode" | "switchModelOverride" | "queueSystemReminder" | "setDefaultAutoPush" | "setPrivacyMode" | "loadHistory" | "loadMoreTurns" | "setCustomInstructions" | "pushRepoV2" | "uploadBackup" | "pushChanges" | "abortMerge" | "syncChangesFromRemote" | "createTerminal" | "updateTerminal" | "writeTerminal" | "signalTerminal" | "disposeTerminal" | "restartTerminal" | "getAllFiles" | "searchFiles" | "searchFileTree" | "collectRepoMetrics" | "restoreFromCompletionId" | "restoreBeforeCompletionId" | "undoLastUserMessage" | "sendFeedback" | "clearSession" | "clearMessageQueue" | "updateMessage" | "flushMessageQueue" | "sendMessage" | "setProxyOrigin" | "toolFullfilment" | "abortToolCall" | "stopEventLoop" | "configureDevOrchestrator" | "tsServerInit" | "tsServerOpenFile" | "tsServerChangeFile" | "tsServerCloseFile" | "tsServerGetCompletions" | "tsServerGetCompletionDetails" | "tsServerGetDefinition" | "tsServerGetTypeDefinition" | "tsServerGetQuickInfo" | "tsServerGetReferences" | "tsServerGetSignatureHelp" | "tsServerRequestDiagnostics" | "tsServerGetRenameLocations" | "tsServerGetNavTree" | "tsServerOrganizeImports" | "tsServerGetInlayHints" | "tsServerGetCodeFixes" | "tsServerGetApplicableRefactors" | "tsServerGetEditsForRefactor" | "tsServerGetImplementation" | "tsServerGetSelectionRange" | "tsServerGetLinkedEditingRange" | "tsServerGetFormatRange" | "manualCommit" | "launchEditor" | "readFile" | "readFileWithChecksum" | "readBinaryFile" | "getSingleFileDiff" | "discardFileChanges" | "revertDiscard" | "fileExists" | "writeFile" | "listDir" | "listCustomInstructions" | "deleteFile" | "getDiff")[];
+declare const PUBLIC_METHODS: ("fileExists" | "readFile" | "listDir" | "getAllFiles" | "abort" | "pushRepoV2" | "pushChanges" | "syncChangesFromRemote" | "flushMessageQueue" | "abortSetupCommand" | "abortValidateCommand" | "switchSessionMode" | "switchModelOverride" | "queueSystemReminder" | "setDefaultAutoPush" | "setPrivacyMode" | "loadHistory" | "loadMoreTurns" | "setCustomInstructions" | "uploadBackup" | "abortMerge" | "createTerminal" | "updateTerminal" | "writeTerminal" | "signalTerminal" | "disposeTerminal" | "restartTerminal" | "searchFiles" | "searchFileTree" | "collectRepoMetrics" | "restoreFromCompletionId" | "restoreBeforeCompletionId" | "undoLastUserMessage" | "sendFeedback" | "clearSession" | "clearMessageQueue" | "updateMessage" | "sendMessage" | "setProxyOrigin" | "toolFullfilment" | "abortToolCall" | "stopEventLoop" | "configureDevOrchestrator" | "tsServerInit" | "tsServerOpenFile" | "tsServerChangeFile" | "tsServerCloseFile" | "tsServerGetCompletions" | "tsServerGetCompletionDetails" | "tsServerGetDefinition" | "tsServerGetTypeDefinition" | "tsServerGetQuickInfo" | "tsServerGetReferences" | "tsServerGetSignatureHelp" | "tsServerRequestDiagnostics" | "tsServerGetRenameLocations" | "tsServerGetNavTree" | "tsServerOrganizeImports" | "tsServerGetInlayHints" | "tsServerGetCodeFixes" | "tsServerGetApplicableRefactors" | "tsServerGetEditsForRefactor" | "tsServerGetImplementation" | "tsServerGetSelectionRange" | "tsServerGetLinkedEditingRange" | "tsServerGetFormatRange" | "manualCommit" | "launchEditor" | "readFileWithChecksum" | "readBinaryFile" | "getSingleFileDiff" | "discardFileChanges" | "revertDiscard" | "writeFile" | "listCustomInstructions" | "deleteFile" | "getDiff")[];
 export type PublicCodeGenSession = Pick<InstanceType<typeof CodeGenSession>, (typeof PUBLIC_METHODS)[0]>;
 export {};

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

@@ -18,6 +18,10 @@ export interface SubAgent {
     resetAfterRun?: boolean;
     mcpServers?: boolean;
     queueMode?: QueueMode;
+    /** Maximum wall time (in milliseconds) before the agent watchdog aborts. */
+    maxTimeoutMs?: number;
+    /** Max LLM completion turns when spawned via the Agent tool (dev-tools). */
+    maxCompletions?: number;
     /** Default reasoning effort level for this agent type. Overrides the session default. */
     reasoning?: ReasoningEffort;
 }
@@ -34,6 +38,7 @@ export interface SubAgent {
  *   - Grep
  *   - WebSearch
  * mode: quality-v4-agent  # Optional: agent mode
+ * maxCompletions: 120    # Optional: max Agent-tool spawn turns
  * ---
  * System prompt content here (Markdown)
  * ```

package/types/cli/utils/macros/macro-player.d.ts

@@ -0,0 +1,44 @@
+import type { LocalMCPClientManager } from "../../mcp-local";
+import type { ReplayTargetInfo } from "../replay-action-uploader";
+export interface MacroAction {
+    toolName: string;
+    input: unknown;
+    url: string;
+    ok: boolean;
+    durationMs?: number;
+    targets?: Record<string, ReplayTargetInfo>;
+}
+export interface MacroPlayResult {
+    ok: boolean;
+    stepsRun: number;
+    totalSteps: number;
+    durationMs: number;
+    finalUrl?: string;
+    failure?: {
+        stepIndex: number;
+        toolName: string;
+        reason: string;
+    };
+}
+/**
+ * Re-issues the recorded `tool_call` actions of a macro through the
+ * in-process Chrome MCP client.
+ *
+ * Uid resolution: every recorded call may reference snapshot uids that
+ * are stale across sessions. Before each call that contains uids we
+ * take a fresh snapshot, then resolve each original uid to a fresh
+ * one via the recorded `targets` map (role+name → text → role-only).
+ * On miss we fail loud — silently skipping would lead to misleading
+ * "macro succeeded" reports.
+ */
+export declare class MacroPlayer {
+    #private;
+    constructor(mcp: LocalMCPClientManager);
+    play(macroName: string, actions: MacroAction[], signal?: AbortSignal): Promise<MacroPlayResult>;
+}
+/**
+ * Format a `MacroPlayResult` as the short summary string the agent
+ * receives back. Keep this terse — dumping every CDP response would
+ * defeat the token-saving purpose of macros.
+ */
+export declare function formatMacroSummary(macroName: string, result: MacroPlayResult): string;

package/types/cli/utils/macros/snapshot-utils.d.ts

@@ -0,0 +1,57 @@
+import type { ReplayTargetInfo } from "../replay-action-uploader";
+/**
+ * Parsed shape of one node in a `chrome-devtools-mcp` snapshot. The
+ * MCP returns an indented YAML-ish accessibility tree that looks like:
+ *
+ * ```
+ *   button "Sign in" [uid=42_3]
+ *   textbox "Email" [uid=42_4]
+ * ```
+ *
+ * We don't need a full parser — we just want a flat list keyed by uid
+ * so we can (a) look up role/name/text at record time, and (b) resolve
+ * a stale uid against a fresh snapshot at replay time.
+ */
+export interface SnapshotNode {
+    uid: string;
+    role?: string;
+    name?: string;
+    text?: string;
+}
+export interface ParsedSnapshot {
+    url?: string;
+    nodes: SnapshotNode[];
+    byUid: Map<string, SnapshotNode>;
+}
+/**
+ * Extract a flat list of `[uid=…]` nodes from an MCP snapshot text
+ * blob. Tolerant of formatting drift between chrome-devtools-mcp
+ * versions — anything we can't parse is silently ignored.
+ */
+export declare function parseSnapshot(text: string): ParsedSnapshot;
+/**
+ * Build a `targets` map for a recorded tool call: for every uid that
+ * appears anywhere in the tool input, capture role/name/text from the
+ * latest snapshot. `cssPath` is left undefined here — high-value
+ * callers (e.g. record-time `click`) can fill it in via an explicit
+ * `evaluate_script` call.
+ */
+export declare function captureTargets(input: unknown, snapshot: ParsedSnapshot | undefined): Record<string, ReplayTargetInfo> | undefined;
+/**
+ * Walk an arbitrary MCP tool input and collect any string field whose
+ * key looks uid-like (`uid`, `ref`, `element`, `from`, `to`) or any
+ * value matching the snapshot uid pattern.
+ */
+export declare function collectUids(input: unknown): Set<string>;
+/**
+ * Replace every uid in `input` using the provided mapping. Returns a
+ * fresh deep-cloned object — does not mutate the original. Returns
+ * `null` if any uid in `input` has no replacement (caller should treat
+ * this as a fatal macro failure).
+ */
+export declare function substituteUids(input: unknown, mapping: Map<string, string>): unknown | null;
+/**
+ * Resolve a recorded `ReplayTargetInfo` against a fresh snapshot.
+ * Tries role+name → exact text match → role-only fallback.
+ */
+export declare function resolveTarget(target: ReplayTargetInfo | undefined, snapshot: ParsedSnapshot): string | undefined;

package/types/cli/utils/replay-action-uploader.d.ts

@@ -5,18 +5,40 @@ import { type Credentials } from "../credentials";
  * the published `@builder.io/dev-tools` package free of cross-package
  * type imports.
  *
- * Only the user-visible content is captured: assistant `text` blocks
- * and `thinking` blocks. Tool calls and chapter markers are
- * deliberately excluded.
+ * Captures user-visible content (`text`, `thinking`, `checkpoint`) plus
+ * UI-affecting `mcp__chrome__*` tool calls (`tool_call`) used both to
+ * overlay the replay timeline and to record macros.
  */
-export interface ReplayActionRecord {
-    /** Wall-clock timestamp in ms epoch. */
+export interface ReplayTargetInfo {
+    role?: string;
+    name?: string;
+    text?: string;
+    cssPath?: string;
+}
+export type ReplayActionRecord = {
     ts: number;
-    type: "text" | "thinking" | "checkpoint";
+    type: "text" | "thinking";
     content?: string;
+} | {
+    ts: number;
+    type: "checkpoint";
     label?: string;
     imageUrl?: string;
-}
+} | {
+    ts: number;
+    type: "tool_call";
+    toolName: string;
+    input: unknown;
+    url: string;
+    ok: boolean;
+    durationMs?: number;
+    /**
+     * Per-uid resolution captured at record time, keyed by the uid as
+     * it appeared in the original input. Replay re-resolves to a
+     * fresh uid using these.
+     */
+    targets?: Record<string, ReplayTargetInfo>;
+};
 /**
  * Buffers user-visible agent blocks (`text`, `thinking`) during a
  * `browser-testing` run and POSTs them as JSON to
@@ -42,6 +64,21 @@ export declare class ReplayActionUploader {
     recordText(content: string, ts?: number): void;
     recordReasoning(content: string, ts?: number): void;
     recordCheckpoint(ts?: number, label?: string, imageUrl?: string): void;
+    /**
+     * Record a UI-affecting Chrome MCP tool call so it can later be
+     * replayed as part of a macro. Read-only tools (snapshots,
+     * screenshots, console reads) must NOT be recorded — they only
+     * matter at record time to resolve element references.
+     */
+    recordToolCall(record: {
+        ts?: number;
+        toolName: string;
+        input: unknown;
+        url: string;
+        ok: boolean;
+        durationMs?: number;
+        targets?: Record<string, ReplayTargetInfo>;
+    }): void;
     flush(): Promise<void>;
     close(): Promise<void>;
 }