framer-api 0.1.14-beta → 0.1.16

package/dist/index.d.ts

@@ -64,8 +64,12 @@ interface RunSupervisorAgentCommandOptions {
     goal: string;
     /** Supervisor model id, optionally with eval-style reasoning effort suffix, e.g. `anthropic/claude-opus-4.6=low`. */
     model: string;
-    /** Inner Framer Agent model override. Defaults to `model` when omitted. Supports the same `model=effort` syntax. */
-    userAgentModel?: string;
+    /**
+     * Inner Framer Agent model override. Defaults to `model` when omitted.
+     *
+     * Supports the same `model=effort` syntax. Omitting effort is equivalent to `none`.
+     */
+    framerAgentModel?: string;
     pagePath?: string;
     maxSteps?: number;
     /** When true, capture per-step (system, tools, messages) → response training rows for SFT. */
@@ -78,6 +82,10 @@ interface RunSupervisorAgentCommandResult {
     trainingDataFilename?: string;
     /** JSONL string with one training row per inner-agent step, present when `captureTrainingData` was set. */
     trainingDataJsonl?: string;
+    /** Replay trace filename, present when the inner agent produced at least one model step. */
+    traceFilename?: string;
+    /** Replay trace JSON with system, tools, and final ModelMessage conversation. */
+    traceJson?: string;
     /** Document fixture filename, always present after a completed run. */
     fixtureFilename: string;
     /** Document fixture JSON content (tree + code files). */
@@ -112,6 +120,27 @@ interface ContinueAgentConversationOptions extends AgentTurnOptions {
     conversationId: string;
 }
 
+interface AgentBranch {
+    id: string;
+    title: string;
+    url: string;
+    baseId?: string;
+    joined: boolean;
+}
+interface AgentBranchCollectionItemChange {
+    nodeId: string;
+    name: string;
+    isRemoved: boolean;
+}
+interface AgentBranchChange {
+    type: "page" | "collection" | "designPage" | "siteSettings" | "component" | "layoutTemplate";
+    nodeId: string;
+    name: string;
+    isRemoved: boolean;
+    items?: AgentBranchCollectionItemChange[];
+    settingsTab?: "general" | "redirects";
+}
+
 /** @alpha */
 interface Breakpoint {
     /** Name of the breakpoint as displayed on the node */
@@ -4667,34 +4696,6 @@ declare const getChangedPaths: unique symbol;
 declare const getChangeContributors: unique symbol;
 declare const createManagedCollection: unique symbol;
 declare const rejectAllPending: unique symbol;
-declare const readProjectForAgent: unique symbol;
-declare const readComponentControlsForAgent: unique symbol;
-declare const readIconSetControlsForAgent: unique symbol;
-declare const readIconsForAgent: unique symbol;
-declare const readLayoutTemplateControlsForAgent: unique symbol;
-declare const readShaderControlsForAgent: unique symbol;
-declare const getAgentSystemPrompt: unique symbol;
-declare const getAgentContext: unique symbol;
-declare const applyAgentChanges: unique symbol;
-declare const flattenComponentInstanceForAgent: unique symbol;
-declare const getAncestorsForAgent: unique symbol;
-declare const getGroundNodeForAgent: unique symbol;
-declare const getNodeForAgent: unique symbol;
-declare const getNodesForAgent: unique symbol;
-declare const getNodesOfTypesForAgent: unique symbol;
-declare const getParentNodeForAgent: unique symbol;
-declare const getScopeNodeForAgent: unique symbol;
-declare const makeExternalComponentLocalForAgent: unique symbol;
-declare const paginateForAgent: unique symbol;
-declare const publishForAgent: unique symbol;
-declare const queryImagesForAgent: unique symbol;
-declare const reviewChangesForAgent: unique symbol;
-declare const serializeForAgent: unique symbol;
-declare const serializeNodesForAgent: unique symbol;
-declare const startAgentConversation: unique symbol;
-declare const continueAgentConversation: unique symbol;
-declare const submitAgentClarification: unique symbol;
-declare const runSupervisorAgentCommand: unique symbol;
 declare const ping: unique symbol;
 declare const $framerApiOnly: {
     readonly ping: typeof ping;
@@ -4705,34 +4706,6 @@ declare const $framerApiOnly: {
     readonly getChangeContributors: typeof getChangeContributors;
     readonly createManagedCollection: typeof createManagedCollection;
     readonly rejectAllPending: typeof rejectAllPending;
-    readonly readProjectForAgent: typeof readProjectForAgent;
-    readonly readComponentControlsForAgent: typeof readComponentControlsForAgent;
-    readonly readIconSetControlsForAgent: typeof readIconSetControlsForAgent;
-    readonly readIconsForAgent: typeof readIconsForAgent;
-    readonly readLayoutTemplateControlsForAgent: typeof readLayoutTemplateControlsForAgent;
-    readonly readShaderControlsForAgent: typeof readShaderControlsForAgent;
-    readonly getAgentSystemPrompt: typeof getAgentSystemPrompt;
-    readonly getAgentContext: typeof getAgentContext;
-    readonly applyAgentChanges: typeof applyAgentChanges;
-    readonly flattenComponentInstanceForAgent: typeof flattenComponentInstanceForAgent;
-    readonly getAncestorsForAgent: typeof getAncestorsForAgent;
-    readonly getGroundNodeForAgent: typeof getGroundNodeForAgent;
-    readonly getNodeForAgent: typeof getNodeForAgent;
-    readonly getNodesForAgent: typeof getNodesForAgent;
-    readonly getNodesOfTypesForAgent: typeof getNodesOfTypesForAgent;
-    readonly getParentNodeForAgent: typeof getParentNodeForAgent;
-    readonly getScopeNodeForAgent: typeof getScopeNodeForAgent;
-    readonly makeExternalComponentLocalForAgent: typeof makeExternalComponentLocalForAgent;
-    readonly paginateForAgent: typeof paginateForAgent;
-    readonly publishForAgent: typeof publishForAgent;
-    readonly queryImagesForAgent: typeof queryImagesForAgent;
-    readonly reviewChangesForAgent: typeof reviewChangesForAgent;
-    readonly serializeForAgent: typeof serializeForAgent;
-    readonly serializeNodesForAgent: typeof serializeNodesForAgent;
-    readonly startAgentConversation: typeof startAgentConversation;
-    readonly continueAgentConversation: typeof continueAgentConversation;
-    readonly submitAgentClarification: typeof submitAgentClarification;
-    readonly runSupervisorAgentCommand: typeof runSupervisorAgentCommand;
 };
 
 type Ownership = {
@@ -4806,7 +4779,7 @@ type AllMembers = Omit<FramerPluginAPIAlpha, "isAllowedTo" | "subscribeToIsAllow
     "WebPageNode.clone": WebPageNode["clone"];
     "DesignPageNode.clone": DesignPageNode["clone"];
 } & NamespaceMembers<ColorStyle, "ColorStyle"> & NamespaceMembers<TextStyle, "TextStyle"> & NamespaceMembers<Variable, "Variable"> & NamespaceMembers<BooleanVariable, "BooleanVariable", Variable> & NamespaceMembers<NumberVariable, "NumberVariable", Variable> & NamespaceMembers<StringVariable, "StringVariable", Variable> & NamespaceMembers<FormattedTextVariable, "FormattedTextVariable", Variable> & NamespaceMembers<EnumCase, "EnumCase"> & NamespaceMembers<EnumVariable, "EnumVariable", Variable> & NamespaceMembers<ColorVariable, "ColorVariable", Variable> & NamespaceMembers<ImageVariable, "ImageVariable", Variable> & NamespaceMembers<FileVariable, "FileVariable", Variable> & NamespaceMembers<LinkVariable, "LinkVariable", Variable> & NamespaceMembers<DateVariable, "DateVariable", Variable> & NamespaceMembers<BorderVariable, "BorderVariable", Variable> & NamespaceMembers<UnsupportedVariable, "UnsupportedVariable", Variable> & NamespaceMembers<VectorSet, "VectorSet"> & NamespaceMembers<VectorSetItem, "VectorSetItem">;
-declare const unprotectedMessageTypesSource: ["closeNotification", "closePlugin", "setCloseWarning", "getActiveCollection", "getActiveLocale", "getActiveManagedCollection", "getCanvasRoot", "getChildren", "getCollection", "getCollectionFields", "getCollectionFields2", "getCollectionItems", "getCollectionItems2", "getCollections", "getColorStyle", "getColorStyles", "getCurrentUser", "getCurrentUser2", "getCustomCode", "getDefaultLocale", "getFont", "getFonts", "getImage", "getImageData", "getLocales", "getLocaleLanguages", "getLocaleRegions", "getLocalizationGroups", "getManagedCollection", "getManagedCollectionFields", "getManagedCollectionFields2", "getManagedCollectionItemIds", "getManagedCollections", "getNode", "getNodesWithAttribute", "getNodesWithAttributeSet", "getNodesWithType", "getParent", "getPluginData", "getPluginDataForNode", "getPluginDataKeys", "getPluginDataKeysForNode", "getProjectInfo", "getProjectInfo2", "getPublishInfo", "getRect", "getSelection", "getSVGForNode", "getText", "getTextForNode", "getTextStyle", "getTextStyles", "hideUI", "setBackgroundMessage", "notify", "onPointerDown", "setActiveCollection", "setSelection", "showUI", "getCodeFileVersionContent", "typecheckCode", "getCodeFileVersions", "getCodeFiles", "getCodeFile", "unstable_getDependencyVersion", "getRedirects", "uploadFile", "uploadFiles", "uploadImage", "uploadImages", "zoomIntoView", "navigateTo", "getRuntimeErrorForModule", "getRuntimeErrorForCodeComponentNode", "showProgressOnInstances", "removeProgressFromInstances", "addComponentInstancePlaceholder", "updateComponentInstancePlaceholder", "removeComponentInstancePlaceholder", "setMenu", "showContextMenu", "getBreakpointSuggestionsForWebPage", "getActiveCollectionItemForWebPage", "getVariables", "getVectorSets", "getVectorSetItems", "getVectorSetItemVariables", "getChangedPaths", "getChangeContributors", "getDeployments", "readProjectForAgent", "readComponentControlsForAgent", "readIconSetControlsForAgent", "readIconsForAgent", "readLayoutTemplateControlsForAgent", "readShaderControlsForAgent", "getAgentSystemPrompt", "getAgentContext", "ping", "queryImagesForAgent", "reviewChangesForAgent", "getNodeForAgent", "getNodesForAgent", "getNodesOfTypesForAgent", "getScopeNodeForAgent", "getGroundNodeForAgent", "getParentNodeForAgent", "getAncestorsForAgent", "paginateForAgent", "serializeForAgent", "serializeNodesForAgent", "INTERNAL_getAiServiceInfo", "INTERNAL_sendTrackingEvent", "INTERNAL_getCurrentUser", "INTERNAL_getProjectInfo", "INTERNAL_getHTMLForNode", "getAiServiceInfo", "sendTrackingEvent", "unstable_getCodeFile", "unstable_getCodeFiles", "unstable_getCodeFileVersionContent", "unstable_getCodeFileLint2", "unstable_getCodeFileTypecheck2", "unstable_getCodeFileVersions", "lintCode"];
+declare const unprotectedMessageTypesSource: ["closeNotification", "closePlugin", "setCloseWarning", "getActiveCollection", "getActiveLocale", "getActiveManagedCollection", "getCanvasRoot", "getChildren", "getCollection", "getCollectionFields", "getCollectionFields2", "getCollectionItems", "getCollectionItems2", "getCollections", "getColorStyle", "getColorStyles", "getCurrentUser", "getCurrentUser2", "getCustomCode", "getDefaultLocale", "getFont", "getFonts", "getImage", "getImageData", "getLocales", "getLocaleLanguages", "getLocaleRegions", "getLocalizationGroups", "getManagedCollection", "getManagedCollectionFields", "getManagedCollectionFields2", "getManagedCollectionItemIds", "getManagedCollections", "getNode", "getNodesWithAttribute", "getNodesWithAttributeSet", "getNodesWithType", "getParent", "getPluginData", "getPluginDataForNode", "getPluginDataKeys", "getPluginDataKeysForNode", "getProjectInfo", "getProjectInfo2", "getPublishInfo", "getRect", "getSelection", "getSVGForNode", "getText", "getTextForNode", "getTextStyle", "getTextStyles", "hideUI", "setBackgroundMessage", "notify", "onPointerDown", "setActiveCollection", "setSelection", "showUI", "getCodeFileVersionContent", "typecheckCode", "getCodeFileVersions", "getCodeFiles", "getCodeFile", "unstable_getDependencyVersion", "getRedirects", "uploadFile", "uploadFiles", "uploadImage", "uploadImages", "zoomIntoView", "navigateTo", "getRuntimeErrorForModule", "getRuntimeErrorForCodeComponentNode", "showProgressOnInstances", "removeProgressFromInstances", "addComponentInstancePlaceholder", "updateComponentInstancePlaceholder", "removeComponentInstancePlaceholder", "setMenu", "showContextMenu", "getBreakpointSuggestionsForWebPage", "getActiveCollectionItemForWebPage", "getVariables", "getVectorSets", "getVectorSetItems", "getVectorSetItemVariables", "getChangedPaths", "getChangeContributors", "getDeployments", "readProjectForAgent", "readComponentControlsForAgent", "readIconSetControlsForAgent", "readIconsForAgent", "readLayoutTemplateControlsForAgent", "readShaderControlsForAgent", "getAgentSystemPrompt", "getAgentContext", "getActiveBranchForAgent", "getBranchesForAgent", "getBranchChangesForAgent", "ping", "queryImagesForAgent", "reviewChangesForAgent", "getNodeForAgent", "getNodesForAgent", "getNodesOfTypesForAgent", "getScopeNodeForAgent", "getGroundNodeForAgent", "getParentNodeForAgent", "getAncestorsForAgent", "paginateForAgent", "serializeForAgent", "serializeNodesForAgent", "INTERNAL_getAiServiceInfo", "INTERNAL_sendTrackingEvent", "INTERNAL_getCurrentUser", "INTERNAL_getProjectInfo", "INTERNAL_getHTMLForNode", "getAiServiceInfo", "sendTrackingEvent", "unstable_getCodeFile", "unstable_getCodeFiles", "unstable_getCodeFileVersionContent", "unstable_getCodeFileLint2", "unstable_getCodeFileTypecheck2", "unstable_getCodeFileVersions", "lintCode"];
 type UnprotectedMessageType = (typeof unprotectedMessageTypesSource)[number];
 type ProtectedMessageType = Exclude<keyof PluginMessageAPI, UnprotectedMessageType>;
 type Method = keyof {
@@ -5051,35 +5024,7 @@ declare const methodToMessageTypes: {
     readonly [getChangeContributors]: [];
     readonly [createManagedCollection]: ["createManagedCollection"];
     readonly [rejectAllPending]: [];
-    readonly [readProjectForAgent]: [];
-    readonly [readComponentControlsForAgent]: [];
-    readonly [readIconSetControlsForAgent]: [];
-    readonly [readIconsForAgent]: [];
-    readonly [readLayoutTemplateControlsForAgent]: [];
-    readonly [readShaderControlsForAgent]: [];
-    readonly [getAgentSystemPrompt]: [];
-    readonly [getAgentContext]: [];
     readonly [ping]: [];
-    readonly [applyAgentChanges]: ["applyAgentChanges"];
-    readonly [flattenComponentInstanceForAgent]: ["flattenComponentInstanceForAgent"];
-    readonly [getAncestorsForAgent]: [];
-    readonly [getGroundNodeForAgent]: [];
-    readonly [getNodeForAgent]: [];
-    readonly [getNodesForAgent]: [];
-    readonly [getNodesOfTypesForAgent]: [];
-    readonly [getParentNodeForAgent]: [];
-    readonly [getScopeNodeForAgent]: [];
-    readonly [makeExternalComponentLocalForAgent]: ["makeExternalComponentLocalForAgent"];
-    readonly [paginateForAgent]: [];
-    readonly [publishForAgent]: ["publishForAgent"];
-    readonly [queryImagesForAgent]: [];
-    readonly [reviewChangesForAgent]: [];
-    readonly [serializeForAgent]: [];
-    readonly [serializeNodesForAgent]: [];
-    readonly [startAgentConversation]: ["startAgentConversation"];
-    readonly [continueAgentConversation]: ["continueAgentConversation"];
-    readonly [submitAgentClarification]: ["submitAgentClarification"];
-    readonly [runSupervisorAgentCommand]: ["runSupervisorAgentCommand"];
 };
 type AllMethods = keyof {
     [K in Method as (typeof methodToMessageTypes)[K] extends [] ? never : K]: (typeof methodToMessageTypes)[K];
@@ -6576,6 +6521,20 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
     [$framerApiOnly.createManagedCollection](name: string): Promise<ManagedCollection>;
     /** @internal - Rejects all pending method calls with the given error */
     [$framerApiOnly.rejectAllPending](error: FramerPluginError): void;
+    /** Liveness round-trip: resolves once Vekter's plugin handler answers. Used by the headless backend to verify the transport actually routes, not just that the page is alive. */
+    [$framerApiOnly.ping](): Promise<void>;
+}
+/**
+ * Agent-specific methods exposed by framer-api as its agent namespace.
+ *
+ * Each method delegates to the corresponding wire-protocol name on the engine
+ * (e.g. `agent.publish(...)` invokes `"publishForAgent"`).
+ *
+ * @internal - Available only through framer-api
+ */
+declare class FramerAgentAPI {
+    #private;
+    constructor(engine: PluginEngine);
     /**
      * Returns the static agent system prompt as a string.
      *
@@ -6583,17 +6542,17 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * - **Command reference** — syntax for adding, updating, removing, moving, and duplicating nodes.
      * - **Design rules** — spacing, layout, typography, and responsive design guidance.
      * - **Examples** — common UI patterns expressed as commands.
-     * - **`readProjectForAgent` query reference** — available query types and their parameters.
+     * - **`readProject` query reference** — available query types and their parameters.
      *
-     * This is the sole documentation for the command syntax used by {@link applyAgentChanges}
-     * and the query types used by {@link readProjectForAgent}.
+     * This is the sole documentation for the command syntax used by {@link applyChanges}
+     * and the query types used by {@link readProject}.
      *
      * The prompt is static and does not depend on any specific project.
-     * Call {@link getAgentContext} to get the project-specific context.
+     * Call {@link getContext} to get the project-specific context.
      *
      * @returns A string containing the agent system prompt.
      */
-    [$framerApiOnly.getAgentSystemPrompt](): Promise<string>;
+    getSystemPrompt(): Promise<string>;
     /**
      * Returns the dynamic project context as a string.
      *
@@ -6604,108 +6563,176 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * - **Style presets** — text style presets defined in the project.
      * - **Icon sets** — available icon sets and their definitions.
      *
-     * This data changes per project and page. Pair with the static prompt
-     * from {@link getAgentSystemPrompt} for complete agent context.
+     * This data changes per project. Pair with the static prompt
+     * from {@link getSystemPrompt} for complete agent context.
      *
-     * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns A string containing the project context.
      */
-    [$framerApiOnly.getAgentContext](options?: {
-        pagePath?: string;
-    }): Promise<string>;
+    getContext(): Promise<string>;
+    /**
+     * Returns the active project branch.
+     *
+     * @returns Branch metadata for the active branch.
+     */
+    getActiveBranch(): Promise<AgentBranch>;
+    /**
+     * Returns the project branches.
+     *
+     * @returns Branch metadata for each available branch.
+     */
+    getBranches(): Promise<AgentBranch[]>;
+    /**
+     * Returns a summarized changelog for a branch.
+     *
+     * @param branchId - Branch id.
+     */
+    getBranchChanges(branchId: string): Promise<AgentBranchChange[]>;
+    /**
+     * Switches the active project branch.
+     *
+     * @param branchId - Branch id. Use `"main"` for the main branch.
+     */
+    switchBranch(branchId: string): Promise<void>;
+    /**
+     * Creates a branch and switches to it.
+     *
+     * @param title - Optional branch title. The new branch is created from the active branch.
+     * @returns The created branch.
+     */
+    createBranch(title?: string): Promise<AgentBranch>;
+    /**
+     * Merges the active branch into its base or a target branch and switches to the target.
+     *
+     * @param targetBranchId - Optional target branch id. Use `"main"` for the main branch.
+     */
+    mergeBranch(targetBranchId?: string): Promise<void>;
+    /**
+     * Joins a branch as a contributor so the current user can edit it when permissions allow.
+     *
+     * @param branchId - Branch id to join.
+     */
+    joinBranch(branchId: string): Promise<void>;
+    /**
+     * Leaves a branch as a contributor.
+     *
+     * @param branchId - Branch id to leave.
+     */
+    leaveBranch(branchId: string): Promise<void>;
+    /**
+     * Renames a branch.
+     *
+     * @param branchId - Branch id to rename.
+     * @param title - New branch title.
+     */
+    renameBranch(branchId: string, title: string): Promise<void>;
+    /**
+     * Deletes a branch.
+     *
+     * @param branchId - Branch id to delete.
+     */
+    deleteBranch(branchId: string): Promise<void>;
     /**
      * Reads project state by executing an array of queries against the project.
      *
      * Returns one result per query. Available query types and their parameters
-     * are documented in the string returned by {@link getAgentSystemPrompt}.
+     * are documented in the string returned by {@link getSystemPrompt}.
      *
-     * @param queries - Array of query objects. See {@link getAgentSystemPrompt} for available types.
+     * @param queries - Array of query objects. See {@link getSystemPrompt} for available types.
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns An object with a `results` array, one entry per query.
      */
-    [$framerApiOnly.readProjectForAgent](queries: Record<string, unknown>[], options?: {
+    readProject(queries: Record<string, unknown>[], options?: {
         pagePath?: string;
     }): Promise<{
         results: unknown[];
     }>;
-    /** @alpha */
-    [$framerApiOnly.readComponentControlsForAgent](input: {
+    /**
+     * Reads control definitions for project components.
+     *
+     * @param input - `{ componentIds }`: component ids from project context or previous reads.
+     * @returns The matching component control definitions.
+     */
+    readComponentControls(input: {
         componentIds: readonly string[];
-    }, options?: {
-        pagePath?: string;
     }): Promise<unknown>;
-    /** @alpha */
-    [$framerApiOnly.readIconSetControlsForAgent](input: {
+    /**
+     * Reads icon-set control definitions.
+     *
+     * @param input - `{ iconSetNames }`: icon set names from project context or previous reads.
+     * @returns The matching icon-set control definitions.
+     */
+    readIconSetControls(input: {
         iconSetNames: readonly string[];
-    }, options?: {
-        pagePath?: string;
     }): Promise<unknown>;
-    /** @alpha */
-    [$framerApiOnly.readIconsForAgent](input: {
+    /**
+     * Reads exact icon names for an icon set.
+     *
+     * @param input - `{ iconSetName }`: icon set name from project context or previous reads.
+     * @returns The available icon names in that set.
+     */
+    readIcons(input: {
         iconSetName: string;
-    }, options?: {
-        pagePath?: string;
     }): Promise<string[]>;
-    /** @alpha */
-    [$framerApiOnly.readLayoutTemplateControlsForAgent](input: {
+    /**
+     * Reads layout-template control definitions.
+     *
+     * @param input - `{ layoutTemplateIds }`: layout template ids from project context or previous reads.
+     * @returns The matching layout-template control definitions.
+     */
+    readLayoutTemplateControls(input: {
         layoutTemplateIds: readonly string[];
-    }, options?: {
-        pagePath?: string;
     }): Promise<unknown>;
-    /** @alpha */
-    [$framerApiOnly.readShaderControlsForAgent](input: {
+    /**
+     * Reads shader control definitions.
+     *
+     * @param input - `{ shaderNames }`: shader names from project context or previous reads.
+     * @returns The matching shader control definitions.
+     */
+    readShaderControls(input: {
         shaderNames: readonly string[];
-    }, options?: {
-        pagePath?: string;
     }): Promise<unknown>;
     /**
      * Applies commands to the canvas to create, update, remove, move, or duplicate nodes.
      *
-     * The command syntax is documented in the string returned by {@link getAgentSystemPrompt}.
+     * The command syntax is documented in the string returned by {@link getSystemPrompt}.
      * Each call is scoped to a single page.
      *
-     * @param dsl - A string of commands separated by `;`. See {@link getAgentSystemPrompt} for syntax.
+     * @param dsl - A string of commands separated by `;`. See {@link getSystemPrompt} for syntax.
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      */
-    [$framerApiOnly.applyAgentChanges](dsl: string, options?: {
+    applyChanges(dsl: string, options?: {
         pagePath?: string;
     }): Promise<void>;
-    /** Liveness round-trip: resolves once Vekter's plugin handler answers. Used by the headless
-     *  backend to verify the transport actually routes, not just that the page is alive. */
-    [$framerApiOnly.ping](): Promise<void>;
     /**
      * Executes the publish flow on behalf of an agent.
      *
-     * The input schema is documented in the string returned by {@link getAgentSystemPrompt}.
+     * The input schema is documented in the string returned by {@link getSystemPrompt}.
      *
      * @param input - Action-discriminated input object (preview / confirm_publish / deploy_to_production).
      * @returns The action's result — status, publish URLs, and any errors, warnings, or changes.
      */
-    [$framerApiOnly.publishForAgent](input?: Record<string, unknown>): Promise<unknown>;
+    publish(input?: Record<string, unknown>): Promise<unknown>;
     /**
      * Searches for stock images to use on the canvas (e.g. `"FrameNode"` `fill` values). Returns
      * candidate images with preview thumbnails and a `url` field for each. The returned URLs are
      * registered as trusted for this session so they can be applied directly via `fill="<url>"`
-     * in a subsequent {@link applyAgentChanges} DSL command. Without calling this method first,
+     * in a subsequent {@link applyChanges} DSL command. Without calling this method first,
      * external image URLs are rejected at apply time.
      *
-     * The input schema is documented in the string returned by {@link getAgentSystemPrompt}.
+     * The input schema is documented in the string returned by {@link getSystemPrompt}.
      *
      * @param input - Search input object (source / query / count / orientation).
      * @returns An object describing the candidates or an error.
      */
-    [$framerApiOnly.queryImagesForAgent](input: Record<string, unknown>): Promise<unknown>;
+    queryImages(input: Record<string, unknown>): Promise<unknown>;
     /**
-     * Reviews changes made by prior {@link applyAgentChanges} calls in this session.
+     * Reviews changes made by prior {@link applyChanges} calls in this session.
      *
      * Consumes accumulated diagnostics from the session's agent context.
      *
-     * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The session's accumulated changes, errors, warnings, and deferred trait reports.
      */
-    [$framerApiOnly.reviewChangesForAgent](options?: {
-        pagePath?: string;
-    }): Promise<unknown>;
+    reviewChanges(): Promise<unknown>;
     /**
      * Flattens a local component instance into raw editable layers.
      *
@@ -6713,7 +6740,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The flatten result — `success` with a `replacementId`, or `blocked` with a reason.
      */
-    [$framerApiOnly.flattenComponentInstanceForAgent](input: {
+    flattenComponentInstance(input: {
         id: string;
     }, options?: {
         pagePath?: string;
@@ -6725,7 +6752,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns `success` (with the local component name), `needs_confirmation` (retry with `replaceAll`), or `blocked` with a reason.
      */
-    [$framerApiOnly.makeExternalComponentLocalForAgent](input: {
+    makeExternalComponentLocal(input: {
         id: string;
         replaceAll?: boolean;
     }, options?: {
@@ -6738,7 +6765,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The node, or `null` if no node with that id exists on the page.
      */
-    [$framerApiOnly.getNodeForAgent](input: {
+    getNode(input: {
         id: string;
     }, options?: {
         pagePath?: string;
@@ -6751,7 +6778,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The nodes that were found, in input order.
      */
-    [$framerApiOnly.getNodesForAgent](input: {
+    getNodes(input: {
         ids: readonly string[];
     }, options?: {
         pagePath?: string;
@@ -6763,7 +6790,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The matching nodes without their children.
      */
-    [$framerApiOnly.getNodesOfTypesForAgent](input: {
+    getNodesOfTypes(input: {
         types: readonly string[];
     }, options?: {
         pagePath?: string;
@@ -6775,7 +6802,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The enclosing scope node, or `null` if the node isn't in any scope.
      */
-    [$framerApiOnly.getScopeNodeForAgent](input: {
+    getScopeNode(input: {
         id: string;
     }, options?: {
         pagePath?: string;
@@ -6787,7 +6814,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The top-level node, or `null` if none applies.
      */
-    [$framerApiOnly.getGroundNodeForAgent](input: {
+    getGroundNode(input: {
         id: string;
     }, options?: {
         pagePath?: string;
@@ -6799,7 +6826,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The parent node, or `null` if the node has no parent or doesn't exist.
      */
-    [$framerApiOnly.getParentNodeForAgent](input: {
+    getParentNode(input: {
         id: string;
     }, options?: {
         pagePath?: string;
@@ -6811,7 +6838,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The ancestors ordered from closest parent to the page root.
      */
-    [$framerApiOnly.getAncestorsForAgent](input: {
+    getAncestors(input: {
         id: string;
     }, options?: {
         pagePath?: string;
@@ -6826,7 +6853,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The serialized node, or `null` if no node with that id exists on the page.
      */
-    [$framerApiOnly.serializeForAgent](input: {
+    serialize(input: {
         id: string;
         depth?: number;
         attributeFilter?: readonly string[];
@@ -6844,7 +6871,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The serialized nodes that were found, in input order.
      */
-    [$framerApiOnly.serializeNodesForAgent](input: {
+    serializeNodes(input: {
         ids: readonly string[];
         depth?: number;
         attributeFilter?: readonly string[];
@@ -6863,7 +6890,7 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
      * @param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.
      * @returns The current page, including `keyName`, `cursor`, `results`, `totalResults`, and (if more pages remain) `nextCursor`.
      */
-    [$framerApiOnly.paginateForAgent](input: {
+    paginate(input: {
         items: readonly unknown[];
         keyName?: never;
         cursor?: never;
@@ -6875,13 +6902,13 @@ declare class FramerPluginAPIAlpha extends FramerPluginAPIBeta {
         pagePath?: string;
     }): Promise<unknown>;
     /** @internal - Available only through framer-api */
-    [$framerApiOnly.startAgentConversation](prompt: string, options?: StartAgentConversationOptions): Promise<StartAgentConversationResult>;
+    startConversation(prompt: string, options?: StartAgentConversationOptions): Promise<StartAgentConversationResult>;
     /** @internal - Available only through framer-api */
-    [$framerApiOnly.continueAgentConversation](prompt: string, options: ContinueAgentConversationOptions): Promise<ContinueAgentConversationResult>;
+    continueConversation(prompt: string, options: ContinueAgentConversationOptions): Promise<ContinueAgentConversationResult>;
     /** @internal - Available only through framer-api */
-    [$framerApiOnly.submitAgentClarification](options: SubmitAgentClarificationOptions): Promise<SubmitAgentClarificationResult>;
+    submitClarification(options: SubmitAgentClarificationOptions): Promise<SubmitAgentClarificationResult>;
     /** @internal - Available only through framer-api */
-    [$framerApiOnly.runSupervisorAgentCommand](options: RunSupervisorAgentCommandOptions): Promise<RunSupervisorAgentCommandResult>;
+    runSupervisorCommand(options: RunSupervisorAgentCommandOptions): Promise<RunSupervisorAgentCommandResult>;
 }
 /**
  * Methods that are only available through framer-api (server API),
@@ -7171,6 +7198,26 @@ interface PluginMessageAPI {
         pagePath?: string;
     }) => Promise<string>;
     /** @alpha */
+    getActiveBranchForAgent: () => Promise<AgentBranch>;
+    /** @alpha */
+    getBranchesForAgent: () => Promise<AgentBranch[]>;
+    /** @alpha */
+    getBranchChangesForAgent: (branchId: string) => Promise<AgentBranchChange[]>;
+    /** @alpha */
+    switchBranchForAgent: (branchId: string) => Promise<void>;
+    /** @alpha */
+    createBranchForAgent: (title?: string) => Promise<AgentBranch>;
+    /** @alpha */
+    mergeBranchForAgent: (targetBranchId?: string) => Promise<void>;
+    /** @alpha */
+    joinBranchForAgent: (branchId: string) => Promise<void>;
+    /** @alpha */
+    leaveBranchForAgent: (branchId: string) => Promise<void>;
+    /** @alpha */
+    renameBranchForAgent: (branchId: string, title: string) => Promise<void>;
+    /** @alpha */
+    deleteBranchForAgent: (branchId: string) => Promise<void>;
+    /** @alpha */
     readProjectForAgent: (queries: Record<string, unknown>[], options?: {
         pagePath?: string;
     }) => Promise<{
@@ -7375,7 +7422,7 @@ declare class PluginEngine {
         reject: (error: FramerPluginError) => void;
     }>;
     readonly mode: Mode;
-    readonly subscriptions: Map<"text" | "image" | "publishInfo" | "selection" | "canvasRoot" | "theme" | "customCode" | "colorStyles" | "textStyles" | "redirects" | "codeFiles" | "openCodeFile", Set<(value: any) => void>>;
+    readonly subscriptions: Map<"redirects" | "text" | "image" | "publishInfo" | "selection" | "canvasRoot" | "theme" | "customCode" | "colorStyles" | "textStyles" | "codeFiles" | "openCodeFile", Set<(value: any) => void>>;
     perMethodPermissionMap: PerMethodPermissionMap;
     readonly permissionSubscriptions: Set<VoidFunction>;
     readonly messageTypesCheckedInIsAllowedTo: Set<ProtectedMessageType>;
@@ -7744,10 +7791,13 @@ type BlockedMethods = {
 }[keyof EnabledMethodsConfig];
 /** Used by ActivePlugin.ts for vekter-side validation */
 type AvailablePluginMethods = Omit<FramerPluginAPIAlpha, BlockedMethods>;
+interface FramerReconnectOptions {
+    expectedInitialBranchId?: string;
+}
 interface FramerConnectionMethods {
     disconnect(): Promise<void>;
     /** @internal */
-    reconnect(): Promise<void>;
+    reconnect(options?: FramerReconnectOptions): Promise<void>;
     requestId?: string;
     sessionId?: string;
     [Symbol.dispose](): void;
@@ -7757,7 +7807,9 @@ interface FramerScreenshotMethods {
     screenshot(nodeId: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
     exportSVG(nodeId: string): Promise<string>;
 }
-type Framer = AvailablePluginMethods & FramerConnectionMethods & FramerScreenshotMethods & FramerApiOnlyMethods;
+type Framer = AvailablePluginMethods & FramerConnectionMethods & FramerScreenshotMethods & FramerApiOnlyMethods & {
+    agent: FramerAgentAPI;
+};
 
 /** @internal */
 declare const $framerApiInternal: {