@superblocksteam/library 2.0.102 → 2.0.103-next.0

package/dist/lib/index.d.ts

@@ -1,6 +1,6 @@
 import { Callback, ControlType, DataType, DataTypeString, EntityDefinition, HeaderType, PropertiesPanelDefinition as PropertiesPanelDefinition$1, PropertiesPanelDisplay, PropertyForData, PropsCategory, Relation, WidgetPropertyDefinition } from "@superblocksteam/library-shared/props";
-import { Dim, EditorConfig, EvaluateOrValueComputedArgs, Property, TailwindPropertyKey } from "@superblocksteam/library-shared";
 import { DataRouter, Location, Params } from "react-router";
+import { Dim, EditorConfig, EvaluateOrValueComputedArgs, Property, TailwindPropertyKey } from "@superblocksteam/library-shared";
 import * as React$2 from "react";
 import React$1, { LegacyRef, ReactNode, createElement } from "react";
 import { OrchestratorViewMode, PlaceholderInfo, Profile } from "@superblocksteam/shared";
@@ -32,10 +32,11 @@ type Group = {
   name: string;
   size: number;
 };
+type DataTag = Profile;
 type DataTags = {
-  available: Profile[];
-  selected?: Profile;
-  default: Profile;
+  available: DataTag[];
+  selected?: DataTag;
+  default: DataTag;
 };
 /** @deprecated Use DataTags instead */
 type Profiles = DataTags;
@@ -86,84 +87,423 @@ declare const SbProvider: ({
   context?: SuperblocksAppContext;
 }) => react_jsx_runtime0.JSX.Element;
 //#endregion
-//#region src/lib/internal-details/lib/types.d.ts
-type ExecutionError = {
-  name?: string;
-  message: string;
-  formPath: string;
-  blockPath: string;
-  handled?: boolean;
+//#region src/lib/internal-details/lib/evaluator/entity-types.d.ts
+type SingleInputProp<T = EntityOutputProp, ARGS extends any[] = any[]> = T extends Callback ? Callback<ARGS> : T;
+type NestedInputProp<T, ARGS extends any[] = any[]> = T extends object ? { [K in keyof T]: SingleInputProp<T[K], ARGS> | NestedInputProp<T[K], ARGS> } : never;
+type InputProp<T = EntityOutputProp, ARGS extends any[] = any[]> = SingleInputProp<T, ARGS> | NestedInputProp<T, ARGS>;
+type EntityFunction<ARGS extends any[] = any[], R = EntityOutputProp> = (this: Entity, ...ARGS: ARGS) => R;
+//#endregion
+//#region src/edit-mode/runtime-graph/types.d.ts
+type ComponentNode = {
+  selectorId: SbSelector;
+  sourceId: SbElement;
+  type: any;
+  isSbComponent: boolean;
+  isHtmlElement: boolean;
+  noSelect?: boolean;
+  props?: Record<string, unknown>;
+  firstRenderedTag: SbSelector | undefined;
+  nearestSelectableAncestor: SbSelector | undefined;
+  displayName: string;
 };
-type ExecutionEventRequest = {
-  summary: string;
-  metadata: {
-    placeHoldersInfo?: Record<string, PlaceholderInfo>;
-  };
+//#endregion
+//#region src/edit-mode/features/runtime-tracking-store.d.ts
+declare class RuntimeTrackingStore {
+  readonly editStore: EditStore | undefined;
+  constructor(editStore: EditStore | undefined);
+  private graph;
+  private jsxNodes;
+  private sourceNodes;
+  private disabledComponents;
+  registerComponent(selectorId: SbSelector, params: {
+    sourceId: SbElement;
+    type: any;
+    parentSelectorId?: SbSelector;
+    isSbComponent: boolean;
+    isHtmlElement: boolean;
+    noSelect?: boolean;
+  }): void;
+  getDisplayName(selectorId: SbSelector): string;
+  unregisterComponent(selectorId: SbSelector): void;
+  getFirstAnchorableTag(selectorId: SbSelector): SbSelector | undefined;
+  getNearestSelectableAncestor(selectorId: SbSelector, skipSelf?: boolean): SbSelector | undefined;
+  updatePropsForComponent(selectorId: SbSelector, props: Record<string, unknown>): void;
+  getComponent(selectorId: SbSelector): ComponentNode | undefined;
+  getComponentParent(selectorId: SbSelector): SbSelector;
+  getComponentChildren(selectorId: SbSelector): SbSelector[];
+  getSelectorIdsForSourceId(sourceId: SbElement): Set<SbSelector>;
+  getSourceId(selectorId: SbSelector): SbElement | undefined;
+  getClosestAncestorByType(selectorId: SbSelector, type: string): SbSelector | undefined;
+  hasRenderedNodes(): boolean;
+  getDisabledComponents(): SbSelector[];
+  /**
+   * Given a selectorId that represents a DOM element, walks up the component tree
+   * to find the outermost registered component whose firstRenderedTag matches this selectorId.
+   * This is used to select the component when clicking on its root DOM element.
+   *
+   * IMPORTANT: This only returns a component if the anchorSelectorId is the IMMEDIATE parent
+   * of the component (i.e., the component doesn't have any intermediate nodes between itself
+   * and the anchor). This prevents inner HTML elements from being treated as component roots.
+   *
+   * ONLY returns registered components (isSbComponent: true). Unregistered wrapper components
+   * are treated as transparent and skipped.
+   *
+   * Returns undefined if no registered component has this as its firstRenderedTag.
+   */
+  getOutermostComponentForFirstRenderedTag(anchorSelectorId: SbSelector): SbSelector | undefined;
+}
+//#endregion
+//#region src/edit-mode/features/ai-store.d.ts
+declare class AiManager {
+  private readonly runtimeTrackingStore;
+  private _isTaggingEnabled;
+  private _isEditing;
+  private _editingComponents;
+  private _contextMode;
+  private _targetedComponents;
+  private _targetedSelectors;
+  private _hasHadSuccessfulBuild;
+  private _hasEverHadSuccessfulBuild;
+  constructor(runtimeTrackingStore: RuntimeTrackingStore);
+  getIsTaggingEnabled(): boolean;
+  getIsEditing(): boolean;
+  getShouldShowLoader(): boolean;
+  setIsTaggingEnabled(isTaggingEnabled: boolean): void;
+  getAiContextMode(): AiContextMode;
+  shouldToggleComponentInAiContext(): boolean;
+  getTargetedComponents(): `SB-${string}`[];
+  getTargetedSelectors(): `S-${string}`[];
+  isEditingComponent(id: SbElement): boolean;
+  isTargetingComponent(id: SbElement): boolean;
+  startEditing(): void;
+  setEditingComponents(components: SbElement[]): void;
+  finishEditing(): void;
+  setAiContextMode(mode: AiContextMode, components?: {
+    id: SbElement;
+    selectorId?: SbSelector;
+  }[]): void;
+  addTargetedSelector(selectorId: SbSelector): void;
+  toggleTargetedSelector(selectorId: SbSelector): void;
+  isTargetedSelector(selectorId: SbSelector): boolean;
+  /**
+   * Returns true if we are targeting a different selector of the same source id, since in some cases we want to keep
+   * the same source targeted, but just highlight another selector of it
+   */
+  isAlternateSourceIdTarget(sourceId: SbElement, selectorId: SbSelector): boolean;
+  handleRuntimeError(data: RuntimeErrorData): void;
+  clearRuntimeError(id: string): void;
+  markFirstBuildSuccess(): void;
+  private notifyLoaderState;
+  private removeAllSharedSelectors;
+  private removeAllSelectorsForSource;
+}
+//#endregion
+//#region src/edit-mode/features/connection-manager.d.ts
+type ConnectionStatus = "pre-init" | "disconnected" | "connecting" | "connected";
+declare class ConnectionManager {
+  connectionStatus: ConnectionStatus;
+  constructor();
+  initializeSocket(): void;
+  connect(): void;
+  disconnect(): void;
+}
+//#endregion
+//#region src/edit-mode/features/operation-store.d.ts
+type OptimisticOperation<P> = {
+  type: keyof EditOperations;
+  payload: P;
+  id: string;
+  callback?: () => void;
 };
-type Resolutions = Record<string,
-// name of the field: eg: "range", for the range field let's say the code is {{[1,2,3]}}
-{
-  value: any;
-  bindings: any[];
-}>;
-type ExecutionEvent = {
-  name: string;
-  type: string;
-  timestamp: string;
-  start?: Record<string, unknown>;
-  end?: {
-    performance?: {
-      start: string | number;
-      finish: string | number;
-      total: string | number;
-      execution: string | number;
-      overhead: string | number;
+type ReparentTransaction = OptimisticOperation<ReparentRequest>;
+type SetPropertiesTransaction = OptimisticOperation<SetPropertiesRequest>;
+type SetPropertyTransaction = OptimisticOperation<SetPropertyRequest>;
+type CreateComponentTransaction = OptimisticOperation<CreateRequest>;
+type DeleteComponentsTransaction = OptimisticOperation<DeleteRequest>;
+type PendingTransaction = ReparentTransaction | SetPropertiesTransaction | SetPropertyTransaction | CreateComponentTransaction | DeleteComponentsTransaction;
+declare class OperationManager {
+  private pendingTransactions;
+  private waitingForBatch;
+  private batchOperations;
+  private batchOperationTransactionId;
+  visibleSourceIds: string[];
+  constructor();
+  get allPendingTransactions(): PendingTransaction[];
+  get pendingDeleteOperations(): DeleteComponentsTransaction[];
+  get pendingSetPropertiesOperations(): SetPropertiesTransaction[];
+  get hasPendingOperations(): boolean;
+  get allNames(): never[];
+  private executeOrAddToBatch;
+  private addPendingTransaction;
+  clearPendingTransactions(transactionIds: string[]): void;
+  batchUpdate(performOperations: () => void): void;
+  createComponent(payload: CreateRequest): void;
+  dropComponent(action: {
+    from: {
+      source: SourceLocation;
     };
-    error?: ExecutionError;
-    output?: {
-      result?: any;
-      request?: string;
-      requestV2?: ExecutionEventRequest;
-      stdout?: Array<string>;
-      stderr?: Array<string>;
+    to: {
+      source: SourceLocation;
     };
-    resolved?: Resolutions;
-  };
-  parent: string;
-};
-interface StreamEvent {
-  result: {
-    event: ExecutionEvent;
-    execution: string;
-  };
-}
-type RouteInfo = Omit<UrlState, "host" | "hostname" | "href" | "port" | "protocol">;
-/**
- * Schema representation for SDK API input/output/chunk schemas.
- * Contains both TypeScript and JSON Schema formats for display in the UI.
- */
-interface SdkApiSchemaInfo {
-  /** TypeScript type string representation, e.g., "{ userId: string; limit?: number }" */
-  typescript: string;
-  /** JSON Schema representation for the schema */
-  jsonSchema: object;
+    propsToChange?: Record<string, PropertyInfo>;
+  }): void;
+  deleteComponents(sourceIds: SbElement[]): void;
+  acknowledgeEditOperation(operation: EditOperationPayload<EditOperationType>): void;
+  writeRuntimeProperties(sourceId: SbElement, transactionId: string, updates: Record<string, PropertyInfo<unknown>>): void;
+  setWidgetProperties({
+    sourceId,
+    properties,
+    callback
+  }: {
+    sourceId: SbElement;
+    properties: Record<string, PropertyInfo<unknown>>;
+    callback?: () => void;
+  }): void;
+  setWidgetProperty({
+    sourceId,
+    property,
+    value,
+    callback
+  }: {
+    sourceId: SbElement;
+    property: string;
+    value: PropertyInfo<unknown>;
+    callback?: () => void;
+  }): void;
+  ensureFilesSynced(): Promise<void>;
+  generateSourceId(): `SB-${string}`;
 }
-/**
- * Metadata for an SDK API, sent from the library to ui-code-mode
- * when an SDK API is registered.
- */
-interface SdkApiMetadata {
-  /** Unique name of the API */
-  name: string;
-  /** Plain-language summary of what this API does */
-  description?: string;
-  /** Input schema information */
-  inputSchema: SdkApiSchemaInfo;
-  /** Output schema information (for non-streaming APIs) */
-  outputSchema?: SdkApiSchemaInfo;
-  /** Chunk schema information (for streaming APIs) */
-  chunkSchema?: SdkApiSchemaInfo;
-  /** Whether this is a streaming API */
+//#endregion
+//#region src/edit-mode/features/properties-panel-manager.d.ts
+declare class PropertiesPanelManager {
+  readonly editStore: EditStore;
+  readonly componentsManager: ComponentRegistry;
+  private propertiesDefinitions;
+  private propertiesPanelTrackerDisposer;
+  private _propertyLookupCache;
+  private removeHotReloadListener;
+  constructor(editStore: EditStore, componentsManager: ComponentRegistry);
+  getPropertiesPanel(selectorId: SbSelector): PropertiesPanelDefinition$1;
+  trackPropertiesPanel(selectorId: SbSelector): void;
+  untrackPropertiesPanel(): void;
+  getPropertiesDefinition(type: string): PropertiesDefinition | undefined;
+  setPropertiesDefinition(widgetType: string, propertiesDefinition: PropertiesDefinition): void;
+  updatePropertiesDefinitionForType(type: string): void;
+  computeAndApplySideEffectsForPropertyUpdate(payload: {
+    sourceId: SbElement;
+    updates: Record<string, PropertyInfo<unknown>>;
+  }): Record<SbElement, Record<string, PropertyInfo<unknown>>>;
+  /**
+   * When a custom component's source code is updated, we want to update the properties definition for that component.
+   * In order to do that, we need to listen to vite's hot reload events. We can't put import.meta.hot calls in the library
+   * because Vite just compiled all of those out in library builds, so we inject a listener from the plugin instead.
+   * https://github.com/vitejs/vite/blob/v6.2/packages/vite/src/node/plugins/define.ts#L37
+   */
+  private attachHotReloadListener;
+}
+//#endregion
+//#region src/edit-mode/features/resizing-store.d.ts
+type ResizeState = {
+  selectorId: SbSelector;
+  sourceId: SbElement;
+  dragStartX: number;
+  dragStartY: number;
+  start: {
+    width: number;
+    height: number;
+  };
+  resizedPosition: string;
+  widthToUpdate: Dim | null;
+  heightToUpdate: Dim | null;
+  isApplyingResize: boolean;
+};
+declare class ResizingManager {
+  private root;
+  private _activeResizes;
+  constructor(root: RootStore);
+  get activeResize(): ResizeState | null | undefined;
+  private isLockedAspectRatio;
+  startResizing(dragStartX: number, dragStartY: number, selectorId: SbSelector, position: string): void;
+  private calculateDimension;
+  private handleResizeDimension;
+  resizeWidget(currentX: number, currentY: number, selectorId: SbSelector, canResizeWidth: boolean, canResizeHeight: boolean): void;
+  pendingResize(sourceId: SbElement): {
+    width: Dim | null;
+    height: Dim | null;
+  } | null;
+  get hasAnyPendingResize(): boolean;
+  get pendingResizes(): ResizeState[];
+  applyResize(selectorId: SbSelector): void;
+}
+//#endregion
+//#region src/edit-mode/features/ui-store.d.ts
+declare class UIStore {
+  readonly root: RootStore;
+  readonly editStore: EditStore;
+  resizing: ResizingManager;
+  private _selectedSourceIds;
+  private _selectedSelectorIds;
+  private _focusedSelectorId;
+  private _rootInstanceData;
+  private newComponentSelectPromise;
+  constructor(root: RootStore, editStore: EditStore);
+  getMostRelevantSelectorIdsForSourceId(sourceId: SbElement): SbSelector[];
+  isSourceSelected(sourceId: SbElement): boolean;
+  getSelectedSourceIds(): SbElement[];
+  getSelectedSelectorIds(): SbSelector[];
+  private get focusedSelectorId();
+  getFocusedSourceId(): SbElement | null;
+  getFocusedSelectorId(): SbSelector | null;
+  setSelectedSourceIds(sourceIds: SbElement[]): void;
+  private subscribeNewSourceIdsToRuntimeSync;
+  setSelectedSelectorIds(selectorIds: SbSelector[]): void;
+  setFocusedIds(selectorId: SbSelector | null): void;
+  selectWidget(selectorId: SbSelector | null, _addToSelection?: boolean): void;
+  /**
+   * This is cursed because component selection actually needs to be done by instance ids, but
+   * instance IDs are only guaranteed to be stable after the component is rendered, while source IDs
+   * are assigned by the source tracker.
+   *
+   * If _any_ other selection comes in before we select something, we will cancel this reaction
+   */
+  selectNewComponentBySourceId(sourceId: SbElement, selectorIdsToIgnore?: Set<`S-${string}`>): Promise<void>;
+}
+//#endregion
+//#region src/edit-mode/runtime-sync/runtime-subscriptions-store.d.ts
+/**
+ * MobX store that manages runtime component subscriptions.
+ * Tracks which components are subscribed and builds fresh composites on-demand.
+ * The subscriptions getter allows startEditorSync reactions to track deep observables
+ * from buildComposite, eliminating the need for manual reaction management.
+ */
+declare class RuntimeSubscriptionsStore {
+  readonly editStore: EditStore;
+  private subscribedSourceIds;
+  constructor(editStore: EditStore);
+  subscribe(sourceId: SbElement): void;
+  unsubscribe(sourceId: SbElement): void;
+  clearAll(): void;
+  get subscriptions(): Record<SbElement, RuntimeSyncComposite | null>;
+}
+//#endregion
+//#region src/edit-mode/edit-store.d.ts
+declare global {
+  interface Window {
+    _SB_ENABLE_SESSION_RECORDING?: boolean;
+    __SUPERBLOCKS_EDITOR_HOOK__: InstanceType<typeof EditStore>;
+  }
+}
+declare class EditStore {
+  ui: UIStore;
+  operationManager: OperationManager;
+  propertiesPanelManager: PropertiesPanelManager;
+  runtimeTrackingStore: RuntimeTrackingStore;
+  connectionManager: ConnectionManager;
+  ai: AiManager;
+  runtimeSubscriptionsStore: RuntimeSubscriptionsStore;
+  isInitialized: boolean;
+  recordingInitialized: boolean;
+  interactionMode: InteractionMode;
+  lastInteractionMode: InteractionMode;
+  isDesignModeLocked: boolean;
+  designModeDisabled: boolean;
+  private viteMessageListeners;
+  constructor(rootStore: RootStore);
+  setIsInitialized(isInitialized: boolean): void;
+  setDesignModeDisabled(disabled: boolean): void;
+  setInteractionMode(mode: InteractionMode, notifyEditor?: boolean): void;
+  setDesignModeLocked(locked: boolean): void;
+  onViteMessage<T extends ViteMessageKind, Message extends Extract<ViteMessage, {
+    kind: T;
+  }>>(kind: T, callback: (message: Message) => void): () => void;
+  triggerViteMessage<T extends ViteMessageKind, Message extends Extract<ViteMessage, {
+    kind: T;
+  }>>(kind: T, message: Message): void;
+  startRecording(recording: {
+    userId: string;
+    appId: string;
+    sessionRecordingKey: string;
+  }): void;
+}
+//#endregion
+//#region src/lib/internal-details/lib/types.d.ts
+type ExecutionError = {
+  name?: string;
+  message: string;
+  formPath: string;
+  blockPath: string;
+  handled?: boolean;
+};
+type ExecutionEventRequest = {
+  summary: string;
+  metadata: {
+    placeHoldersInfo?: Record<string, PlaceholderInfo>;
+  };
+};
+type Resolutions = Record<string,
+// name of the field: eg: "range", for the range field let's say the code is {{[1,2,3]}}
+{
+  value: any;
+  bindings: any[];
+}>;
+type ExecutionEvent = {
+  name: string;
+  type: string;
+  timestamp: string;
+  start?: Record<string, unknown>;
+  end?: {
+    performance?: {
+      start: string | number;
+      finish: string | number;
+      total: string | number;
+      execution: string | number;
+      overhead: string | number;
+    };
+    error?: ExecutionError;
+    output?: {
+      result?: any;
+      request?: string;
+      requestV2?: ExecutionEventRequest;
+      stdout?: Array<string>;
+      stderr?: Array<string>;
+    };
+    resolved?: Resolutions;
+  };
+  parent: string;
+};
+interface StreamEvent {
+  result: {
+    event: ExecutionEvent;
+    execution: string;
+  };
+}
+type RouteInfo = Omit<UrlState, "host" | "hostname" | "href" | "port" | "protocol">;
+/**
+ * Schema representation for SDK API input/output/chunk schemas.
+ * Contains both TypeScript and JSON Schema formats for display in the UI.
+ */
+interface SdkApiSchemaInfo {
+  /** TypeScript type string representation, e.g., "{ userId: string; limit?: number }" */
+  typescript: string;
+  /** JSON Schema representation for the schema */
+  jsonSchema: object;
+}
+/**
+ * Metadata for an SDK API, sent from the library to ui-code-mode
+ * when an SDK API is registered.
+ */
+interface SdkApiMetadata {
+  /** Unique name of the API */
+  name: string;
+  /** Plain-language summary of what this API does */
+  description?: string;
+  /** Input schema information */
+  inputSchema: SdkApiSchemaInfo;
+  /** Output schema information (for non-streaming APIs) */
+  outputSchema?: SdkApiSchemaInfo;
+  /** Chunk schema information (for streaming APIs) */
+  chunkSchema?: SdkApiSchemaInfo;
+  /** Whether this is a streaming API */
   isStreaming: boolean;
   /** Declared integrations for this API */
   integrations: Array<{
@@ -670,481 +1010,148 @@ type FromChildToParentMessageTypesMap = {
   "sdk-api-execution-started": {
     executionId: string;
     apiName: string;
-    input: Record<string, unknown>;
-  };
-  /**
-   * Notify the parent when an SDK API execution completes successfully.
-   */
-  "sdk-api-execution-completed": {
-    executionId: string;
-    apiName: string;
-    output: unknown;
-    durationMs: number;
-    diagnostics?: unknown[];
-  };
-  /**
-   * Notify the parent when an SDK API execution fails.
-   */
-  "sdk-api-execution-failed": {
-    executionId: string;
-    apiName: string;
-    error: {
-      code: string;
-      message: string;
-    };
-    durationMs: number;
-    diagnostics?: unknown[];
-  };
-} & AppToEditorMessage<PropertiesPanelDefinition$1>;
-type FromChildToParentMessageTypes = keyof FromChildToParentMessageTypesMap;
-//#endregion
-//#region src/lib/internal-details/location-store.d.ts
-declare class LocationStore {
-  route?: RouteInfo;
-  rootStore: RootStore;
-  constructor(rootStore: RootStore);
-  updateLocation(location: Location, routes: DataRouter["routes"], params: Readonly<Params<string>>): void;
-  sendLocationToEditor(): void;
-  private matchesToRoutePattern;
-  locationToRouteInfo(location: Location, routes: DataRouter["routes"], params: Readonly<Params<string>>): RouteInfo | undefined;
-}
-//#endregion
-//#region src/lib/internal-details/lib/features/api-store.d.ts
-type ApiResult<T = any> = {
-  data?: T;
-  error?: string;
-};
-declare class ApiManager {
-  readonly rootStore: RootStore;
-  /**
-   * Pre-filtered agent URLs for the current profile, sent by the parent.
-   * Used as fallback for cloud orgs where URLs come from
-   * SUPERBLOCKS_UI_AGENT_BASE_URL rather than agent metadata.
-   */
-  private _agentUrls;
-  /**
-   * Full on-premise agent metadata (all profiles) from the parent,
-   * enabling local profile-based filtering without a postMessage
-   * round-trip. Empty for cloud orgs.
-   */
-  private _agents;
-  /**
-   * DP routing config mapping profile keys to DP URLs, sent by the parent.
-   * Only populated when dataPlaneGatewayEnabled is true.
-   */
-  private _dpRoutingConfig;
-  private token;
-  private accessToken;
-  private runningApiControllers;
-  private waitForInitApiPromise;
-  private waitForBootstrapPromise;
-  private resolveBootstrapPromise;
-  private callContexts;
-  constructor(rootStore: RootStore);
-  set agentUrls(urls: string[]);
-  set agents(agents: AgentInfo[]);
-  set dpRoutingConfig(config: Record<string, string>);
-  setTokens(token: string, accessToken: string): void;
-  isInitialized(): boolean;
-  /**
-   * Get agent URLs for the given profile by filtering locally stored
-   * agent metadata. Falls back to the pre-filtered `_agentUrls` when
-   * no full agent metadata is available (cloud orgs or legacy parents).
-   */
-  private getAgentUrlsForProfile;
-  /**
-   * Selects a random agent URL from the available agents and returns it normalized
-   * (with trailing slash) to ensure proper URL path joining.
-   */
-  private getRandomAgentBaseUrl;
-  private awaitInitApiIfNeeded;
-  private awaitBootstrapIfNeeded;
-  notifyBootstrapComplete(): void;
-  loadApiManifest({
-    apis
-  }: {
-    apis?: Record<string, {
-      api: DeleteMeLibraryApi;
-      scopeId: string;
-    }>;
-  }): void;
-  rerunApiByCallId(callId: string): Promise<ApiResult>;
-  runApiByPath({
-    path,
-    inputs,
-    callId,
-    callback,
-    isTestRun,
-    injectedCallerId
-  }: {
-    path: string;
-    inputs: SbApiRunOptions;
-    callId?: string;
-    callback?: () => Promise<unknown>;
-    isTestRun?: boolean;
-    injectedCallerId?: string;
-  }): Promise<ApiResult>;
-  private getHMRCallHash;
-  private getCachedHMRExecution;
-  private executeApi;
-  private executeApiInternal;
-  private findError;
-  private extractStatusCode;
-  /**
-   * Extract step-level logs from execution events.
-   * Captures console.log (stdout), console.error (stderr), output, and errors for each step.
-   */
-  private extractStepLogs;
-  /**
-   * Execute an SDK API directly via the orchestrator's v3/execute endpoint.
-   * Reads execution context (profile, branch, tokens) from rootStore so the
-   * caller doesn't need to resolve them through the parent frame.
-   */
-  executeSdkApiV3(apiName: string, inputs: Record<string, unknown>, options?: {
-    signal?: AbortSignal;
-  }): Promise<{
-    success: boolean;
-    output?: unknown;
-    error?: {
-      code: string;
-      message: string;
-    };
-    diagnostics?: unknown[];
-  }>;
-  cancelApi(apiName: string, _scopeId?: string): Promise<void>;
-}
-//#endregion
-//#region src/edit-mode/runtime-graph/types.d.ts
-type ComponentNode = {
-  selectorId: SbSelector;
-  sourceId: SbElement;
-  type: any;
-  isSbComponent: boolean;
-  isHtmlElement: boolean;
-  noSelect?: boolean;
-  props?: Record<string, unknown>;
-  firstRenderedTag: SbSelector | undefined;
-  nearestSelectableAncestor: SbSelector | undefined;
-  displayName: string;
-};
-//#endregion
-//#region src/edit-mode/features/runtime-tracking-store.d.ts
-declare class RuntimeTrackingStore {
-  readonly editStore: EditStore | undefined;
-  constructor(editStore: EditStore | undefined);
-  private graph;
-  private jsxNodes;
-  private sourceNodes;
-  private disabledComponents;
-  registerComponent(selectorId: SbSelector, params: {
-    sourceId: SbElement;
-    type: any;
-    parentSelectorId?: SbSelector;
-    isSbComponent: boolean;
-    isHtmlElement: boolean;
-    noSelect?: boolean;
-  }): void;
-  getDisplayName(selectorId: SbSelector): string;
-  unregisterComponent(selectorId: SbSelector): void;
-  getFirstAnchorableTag(selectorId: SbSelector): SbSelector | undefined;
-  getNearestSelectableAncestor(selectorId: SbSelector, skipSelf?: boolean): SbSelector | undefined;
-  updatePropsForComponent(selectorId: SbSelector, props: Record<string, unknown>): void;
-  getComponent(selectorId: SbSelector): ComponentNode | undefined;
-  getComponentParent(selectorId: SbSelector): SbSelector;
-  getComponentChildren(selectorId: SbSelector): SbSelector[];
-  getSelectorIdsForSourceId(sourceId: SbElement): Set<SbSelector>;
-  getSourceId(selectorId: SbSelector): SbElement | undefined;
-  getClosestAncestorByType(selectorId: SbSelector, type: string): SbSelector | undefined;
-  hasRenderedNodes(): boolean;
-  getDisabledComponents(): SbSelector[];
-  /**
-   * Given a selectorId that represents a DOM element, walks up the component tree
-   * to find the outermost registered component whose firstRenderedTag matches this selectorId.
-   * This is used to select the component when clicking on its root DOM element.
-   *
-   * IMPORTANT: This only returns a component if the anchorSelectorId is the IMMEDIATE parent
-   * of the component (i.e., the component doesn't have any intermediate nodes between itself
-   * and the anchor). This prevents inner HTML elements from being treated as component roots.
-   *
-   * ONLY returns registered components (isSbComponent: true). Unregistered wrapper components
-   * are treated as transparent and skipped.
-   *
-   * Returns undefined if no registered component has this as its firstRenderedTag.
-   */
-  getOutermostComponentForFirstRenderedTag(anchorSelectorId: SbSelector): SbSelector | undefined;
-}
-//#endregion
-//#region src/edit-mode/features/ai-store.d.ts
-declare class AiManager {
-  private readonly runtimeTrackingStore;
-  private _isTaggingEnabled;
-  private _isEditing;
-  private _editingComponents;
-  private _contextMode;
-  private _targetedComponents;
-  private _targetedSelectors;
-  private _hasHadSuccessfulBuild;
-  private _hasEverHadSuccessfulBuild;
-  constructor(runtimeTrackingStore: RuntimeTrackingStore);
-  getIsTaggingEnabled(): boolean;
-  getIsEditing(): boolean;
-  getShouldShowLoader(): boolean;
-  setIsTaggingEnabled(isTaggingEnabled: boolean): void;
-  getAiContextMode(): AiContextMode;
-  shouldToggleComponentInAiContext(): boolean;
-  getTargetedComponents(): `SB-${string}`[];
-  getTargetedSelectors(): `S-${string}`[];
-  isEditingComponent(id: SbElement): boolean;
-  isTargetingComponent(id: SbElement): boolean;
-  startEditing(): void;
-  setEditingComponents(components: SbElement[]): void;
-  finishEditing(): void;
-  setAiContextMode(mode: AiContextMode, components?: {
-    id: SbElement;
-    selectorId?: SbSelector;
-  }[]): void;
-  addTargetedSelector(selectorId: SbSelector): void;
-  toggleTargetedSelector(selectorId: SbSelector): void;
-  isTargetedSelector(selectorId: SbSelector): boolean;
-  /**
-   * Returns true if we are targeting a different selector of the same source id, since in some cases we want to keep
-   * the same source targeted, but just highlight another selector of it
-   */
-  isAlternateSourceIdTarget(sourceId: SbElement, selectorId: SbSelector): boolean;
-  handleRuntimeError(data: RuntimeErrorData): void;
-  clearRuntimeError(id: string): void;
-  markFirstBuildSuccess(): void;
-  private notifyLoaderState;
-  private removeAllSharedSelectors;
-  private removeAllSelectorsForSource;
-}
-//#endregion
-//#region src/edit-mode/features/connection-manager.d.ts
-type ConnectionStatus = "pre-init" | "disconnected" | "connecting" | "connected";
-declare class ConnectionManager {
-  connectionStatus: ConnectionStatus;
-  constructor();
-  initializeSocket(): void;
-  connect(): void;
-  disconnect(): void;
-}
-//#endregion
-//#region src/edit-mode/features/operation-store.d.ts
-type OptimisticOperation<P> = {
-  type: keyof EditOperations;
-  payload: P;
-  id: string;
-  callback?: () => void;
-};
-type ReparentTransaction = OptimisticOperation<ReparentRequest>;
-type SetPropertiesTransaction = OptimisticOperation<SetPropertiesRequest>;
-type SetPropertyTransaction = OptimisticOperation<SetPropertyRequest>;
-type CreateComponentTransaction = OptimisticOperation<CreateRequest>;
-type DeleteComponentsTransaction = OptimisticOperation<DeleteRequest>;
-type PendingTransaction = ReparentTransaction | SetPropertiesTransaction | SetPropertyTransaction | CreateComponentTransaction | DeleteComponentsTransaction;
-declare class OperationManager {
-  private pendingTransactions;
-  private waitingForBatch;
-  private batchOperations;
-  private batchOperationTransactionId;
-  visibleSourceIds: string[];
-  constructor();
-  get allPendingTransactions(): PendingTransaction[];
-  get pendingDeleteOperations(): DeleteComponentsTransaction[];
-  get pendingSetPropertiesOperations(): SetPropertiesTransaction[];
-  get hasPendingOperations(): boolean;
-  get allNames(): never[];
-  private executeOrAddToBatch;
-  private addPendingTransaction;
-  clearPendingTransactions(transactionIds: string[]): void;
-  batchUpdate(performOperations: () => void): void;
-  createComponent(payload: CreateRequest): void;
-  dropComponent(action: {
-    from: {
-      source: SourceLocation;
-    };
-    to: {
-      source: SourceLocation;
-    };
-    propsToChange?: Record<string, PropertyInfo>;
-  }): void;
-  deleteComponents(sourceIds: SbElement[]): void;
-  acknowledgeEditOperation(operation: EditOperationPayload<EditOperationType>): void;
-  writeRuntimeProperties(sourceId: SbElement, transactionId: string, updates: Record<string, PropertyInfo<unknown>>): void;
-  setWidgetProperties({
-    sourceId,
-    properties,
-    callback
-  }: {
-    sourceId: SbElement;
-    properties: Record<string, PropertyInfo<unknown>>;
-    callback?: () => void;
-  }): void;
-  setWidgetProperty({
-    sourceId,
-    property,
-    value,
-    callback
-  }: {
-    sourceId: SbElement;
-    property: string;
-    value: PropertyInfo<unknown>;
-    callback?: () => void;
-  }): void;
-  ensureFilesSynced(): Promise<void>;
-  generateSourceId(): `SB-${string}`;
-}
-//#endregion
-//#region src/edit-mode/features/properties-panel-manager.d.ts
-declare class PropertiesPanelManager {
-  readonly editStore: EditStore;
-  readonly componentsManager: ComponentRegistry;
-  private propertiesDefinitions;
-  private propertiesPanelTrackerDisposer;
-  private _propertyLookupCache;
-  private removeHotReloadListener;
-  constructor(editStore: EditStore, componentsManager: ComponentRegistry);
-  getPropertiesPanel(selectorId: SbSelector): PropertiesPanelDefinition$1;
-  trackPropertiesPanel(selectorId: SbSelector): void;
-  untrackPropertiesPanel(): void;
-  getPropertiesDefinition(type: string): PropertiesDefinition | undefined;
-  setPropertiesDefinition(widgetType: string, propertiesDefinition: PropertiesDefinition): void;
-  updatePropertiesDefinitionForType(type: string): void;
-  computeAndApplySideEffectsForPropertyUpdate(payload: {
-    sourceId: SbElement;
-    updates: Record<string, PropertyInfo<unknown>>;
-  }): Record<SbElement, Record<string, PropertyInfo<unknown>>>;
-  /**
-   * When a custom component's source code is updated, we want to update the properties definition for that component.
-   * In order to do that, we need to listen to vite's hot reload events. We can't put import.meta.hot calls in the library
-   * because Vite just compiled all of those out in library builds, so we inject a listener from the plugin instead.
-   * https://github.com/vitejs/vite/blob/v6.2/packages/vite/src/node/plugins/define.ts#L37
+    input: Record<string, unknown>;
+  };
+  /**
+   * Notify the parent when an SDK API execution completes successfully.
    */
-  private attachHotReloadListener;
-}
-//#endregion
-//#region src/edit-mode/features/resizing-store.d.ts
-type ResizeState = {
-  selectorId: SbSelector;
-  sourceId: SbElement;
-  dragStartX: number;
-  dragStartY: number;
-  start: {
-    width: number;
-    height: number;
+  "sdk-api-execution-completed": {
+    executionId: string;
+    apiName: string;
+    output: unknown;
+    durationMs: number;
+    diagnostics?: unknown[];
   };
-  resizedPosition: string;
-  widthToUpdate: Dim | null;
-  heightToUpdate: Dim | null;
-  isApplyingResize: boolean;
-};
-declare class ResizingManager {
-  private root;
-  private _activeResizes;
-  constructor(root: RootStore);
-  get activeResize(): ResizeState | null | undefined;
-  private isLockedAspectRatio;
-  startResizing(dragStartX: number, dragStartY: number, selectorId: SbSelector, position: string): void;
-  private calculateDimension;
-  private handleResizeDimension;
-  resizeWidget(currentX: number, currentY: number, selectorId: SbSelector, canResizeWidth: boolean, canResizeHeight: boolean): void;
-  pendingResize(sourceId: SbElement): {
-    width: Dim | null;
-    height: Dim | null;
-  } | null;
-  get hasAnyPendingResize(): boolean;
-  get pendingResizes(): ResizeState[];
-  applyResize(selectorId: SbSelector): void;
-}
-//#endregion
-//#region src/edit-mode/features/ui-store.d.ts
-declare class UIStore {
-  readonly root: RootStore;
-  readonly editStore: EditStore;
-  resizing: ResizingManager;
-  private _selectedSourceIds;
-  private _selectedSelectorIds;
-  private _focusedSelectorId;
-  private _rootInstanceData;
-  private newComponentSelectPromise;
-  constructor(root: RootStore, editStore: EditStore);
-  getMostRelevantSelectorIdsForSourceId(sourceId: SbElement): SbSelector[];
-  isSourceSelected(sourceId: SbElement): boolean;
-  getSelectedSourceIds(): SbElement[];
-  getSelectedSelectorIds(): SbSelector[];
-  private get focusedSelectorId();
-  getFocusedSourceId(): SbElement | null;
-  getFocusedSelectorId(): SbSelector | null;
-  setSelectedSourceIds(sourceIds: SbElement[]): void;
-  private subscribeNewSourceIdsToRuntimeSync;
-  setSelectedSelectorIds(selectorIds: SbSelector[]): void;
-  setFocusedIds(selectorId: SbSelector | null): void;
-  selectWidget(selectorId: SbSelector | null, _addToSelection?: boolean): void;
   /**
-   * This is cursed because component selection actually needs to be done by instance ids, but
-   * instance IDs are only guaranteed to be stable after the component is rendered, while source IDs
-   * are assigned by the source tracker.
-   *
-   * If _any_ other selection comes in before we select something, we will cancel this reaction
+   * Notify the parent when an SDK API execution fails.
    */
-  selectNewComponentBySourceId(sourceId: SbElement, selectorIdsToIgnore?: Set<`S-${string}`>): Promise<void>;
-}
+  "sdk-api-execution-failed": {
+    executionId: string;
+    apiName: string;
+    error: {
+      code: string;
+      message: string;
+    };
+    durationMs: number;
+    diagnostics?: unknown[];
+  };
+} & AppToEditorMessage<PropertiesPanelDefinition$1>;
+type FromChildToParentMessageTypes = keyof FromChildToParentMessageTypesMap;
 //#endregion
-//#region src/edit-mode/runtime-sync/runtime-subscriptions-store.d.ts
-/**
- * MobX store that manages runtime component subscriptions.
- * Tracks which components are subscribed and builds fresh composites on-demand.
- * The subscriptions getter allows startEditorSync reactions to track deep observables
- * from buildComposite, eliminating the need for manual reaction management.
- */
-declare class RuntimeSubscriptionsStore {
-  readonly editStore: EditStore;
-  private subscribedSourceIds;
-  constructor(editStore: EditStore);
-  subscribe(sourceId: SbElement): void;
-  unsubscribe(sourceId: SbElement): void;
-  clearAll(): void;
-  get subscriptions(): Record<SbElement, RuntimeSyncComposite | null>;
+//#region src/lib/internal-details/location-store.d.ts
+declare class LocationStore {
+  route?: RouteInfo;
+  rootStore: RootStore;
+  constructor(rootStore: RootStore);
+  updateLocation(location: Location, routes: DataRouter["routes"], params: Readonly<Params<string>>): void;
+  sendLocationToEditor(): void;
+  private matchesToRoutePattern;
+  locationToRouteInfo(location: Location, routes: DataRouter["routes"], params: Readonly<Params<string>>): RouteInfo | undefined;
 }
 //#endregion
-//#region src/edit-mode/edit-store.d.ts
-declare global {
-  interface Window {
-    _SB_ENABLE_SESSION_RECORDING?: boolean;
-    __SUPERBLOCKS_EDITOR_HOOK__: InstanceType<typeof EditStore>;
-  }
-}
-declare class EditStore {
-  ui: UIStore;
-  operationManager: OperationManager;
-  propertiesPanelManager: PropertiesPanelManager;
-  runtimeTrackingStore: RuntimeTrackingStore;
-  connectionManager: ConnectionManager;
-  ai: AiManager;
-  runtimeSubscriptionsStore: RuntimeSubscriptionsStore;
-  isInitialized: boolean;
-  recordingInitialized: boolean;
-  interactionMode: InteractionMode;
-  lastInteractionMode: InteractionMode;
-  isDesignModeLocked: boolean;
-  designModeDisabled: boolean;
-  private viteMessageListeners;
+//#region src/lib/internal-details/lib/features/api-store.d.ts
+type ApiResult<T = any> = {
+  data?: T;
+  error?: string;
+};
+declare class ApiManager {
+  readonly rootStore: RootStore;
+  /**
+   * Pre-filtered agent URLs for the current profile, sent by the parent.
+   * Used as fallback for cloud orgs where URLs come from
+   * SUPERBLOCKS_UI_AGENT_BASE_URL rather than agent metadata.
+   */
+  private _agentUrls;
+  /**
+   * Full on-premise agent metadata (all profiles) from the parent,
+   * enabling local profile-based filtering without a postMessage
+   * round-trip. Empty for cloud orgs.
+   */
+  private _agents;
+  /**
+   * DP routing config mapping profile keys to DP URLs, sent by the parent.
+   * Only populated when dataPlaneGatewayEnabled is true.
+   */
+  private _dpRoutingConfig;
+  private token;
+  private accessToken;
+  private runningApiControllers;
+  private waitForInitApiPromise;
+  private waitForBootstrapPromise;
+  private resolveBootstrapPromise;
+  private callContexts;
   constructor(rootStore: RootStore);
-  setIsInitialized(isInitialized: boolean): void;
-  setDesignModeDisabled(disabled: boolean): void;
-  setInteractionMode(mode: InteractionMode, notifyEditor?: boolean): void;
-  setDesignModeLocked(locked: boolean): void;
-  onViteMessage<T extends ViteMessageKind, Message extends Extract<ViteMessage, {
-    kind: T;
-  }>>(kind: T, callback: (message: Message) => void): () => void;
-  triggerViteMessage<T extends ViteMessageKind, Message extends Extract<ViteMessage, {
-    kind: T;
-  }>>(kind: T, message: Message): void;
-  startRecording(recording: {
-    userId: string;
-    appId: string;
-    sessionRecordingKey: string;
+  set agentUrls(urls: string[]);
+  set agents(agents: AgentInfo[]);
+  set dpRoutingConfig(config: Record<string, string>);
+  setTokens(token: string, accessToken: string): void;
+  isInitialized(): boolean;
+  /**
+   * Get agent URLs for the given profile by filtering locally stored
+   * agent metadata. Falls back to the pre-filtered `_agentUrls` when
+   * no full agent metadata is available (cloud orgs or legacy parents).
+   */
+  private getAgentUrlsForProfile;
+  /**
+   * Selects a random agent URL from the available agents and returns it normalized
+   * (with trailing slash) to ensure proper URL path joining.
+   */
+  private getRandomAgentBaseUrl;
+  private awaitInitApiIfNeeded;
+  private awaitBootstrapIfNeeded;
+  notifyBootstrapComplete(): void;
+  loadApiManifest({
+    apis
+  }: {
+    apis?: Record<string, {
+      api: DeleteMeLibraryApi;
+      scopeId: string;
+    }>;
   }): void;
+  rerunApiByCallId(callId: string): Promise<ApiResult>;
+  runApiByPath({
+    path,
+    inputs,
+    callId,
+    callback,
+    isTestRun,
+    injectedCallerId
+  }: {
+    path: string;
+    inputs: SbApiRunOptions;
+    callId?: string;
+    callback?: () => Promise<unknown>;
+    isTestRun?: boolean;
+    injectedCallerId?: string;
+  }): Promise<ApiResult>;
+  private getHMRCallHash;
+  private getCachedHMRExecution;
+  private executeApi;
+  private executeApiInternal;
+  private findError;
+  private extractStatusCode;
+  /**
+   * Extract step-level logs from execution events.
+   * Captures console.log (stdout), console.error (stderr), output, and errors for each step.
+   */
+  private extractStepLogs;
+  /**
+   * Execute an SDK API directly via the orchestrator's v3/execute endpoint.
+   * Reads execution context (profile, branch, tokens) from rootStore so the
+   * caller doesn't need to resolve them through the parent frame.
+   */
+  executeSdkApiV3(apiName: string, inputs: Record<string, unknown>, options?: {
+    signal?: AbortSignal;
+  }): Promise<{
+    success: boolean;
+    output?: unknown;
+    error?: {
+      code: string;
+      message: string;
+    };
+    diagnostics?: unknown[];
+  }>;
+  cancelApi(apiName: string, _scopeId?: string): Promise<void>;
 }
 //#endregion
 //#region src/lib/internal-details/lib/root-store.d.ts
@@ -1392,12 +1399,6 @@ type SbComponentProps<El = HTMLElement> = {
   loading?: boolean;
 } & Omit<React.HTMLAttributes<El>, "height" | "width">;
 //#endregion
-//#region src/lib/internal-details/lib/evaluator/entity-types.d.ts
-type SingleInputProp<T = EntityOutputProp, ARGS extends any[] = any[]> = T extends Callback ? Callback<ARGS> : T;
-type NestedInputProp<T, ARGS extends any[] = any[]> = T extends object ? { [K in keyof T]: SingleInputProp<T[K], ARGS> | NestedInputProp<T[K], ARGS> } : never;
-type InputProp<T = EntityOutputProp, ARGS extends any[] = any[]> = SingleInputProp<T, ARGS> | NestedInputProp<T, ARGS>;
-type EntityFunction<ARGS extends any[] = any[], R = EntityOutputProp> = (this: Entity, ...ARGS: ARGS) => R;
-//#endregion
 //#region src/lib/user-facing/properties-panel/props-builder.d.ts
 type Exact<T, Shape> = T extends Shape ? Exclude<keyof T, keyof Shape> extends never ? T : never : never;
 type ManagedProp<T extends DataType = DataType> = PropertyForData<T> & {