babylonjs-editor 5.5.2-alpha.0 → 5.5.2

package/declaration/src/editor/layout/assistant/skills.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Defines the name of the file the assistant writes in each skill it installs in a project. It holds the hash of the
+ * files installed, to know if the user modified the skill since.
+ */
+export declare const assistantSkillMarkerFileName = ".babylonjs-editor-skill.json";
+/**
+ * Defines what happened to a skill when installing it in a project:
+ * - "installed": the skill was not in the project and was copied.
+ * - "updated": the skill installed by the editor was replaced by the version of this editor.
+ * - "up-to-date": the skill installed by the editor is already the version of this editor.
+ * - "kept": the skill was modified by the user, or not installed by the editor, and was left as is.
+ */
+export type AssistantSkillInstallResult = "installed" | "updated" | "up-to-date" | "kept";
+/**
+ * Returns the hash of the files of the given skill, the file of the editor excluded.
+ * @param directory defines the absolute path of the folder of the skill.
+ */
+export declare function getSkillHash(directory: string): Promise<string>;
+/**
+ * Installs the given skill in the given folder, or updates the version the editor installed there before. A skill the
+ * user modified, or didn't come from the editor, is never replaced.
+ * @param sourceDirectory defines the absolute path of the folder of the skill bundled with the editor.
+ * @param targetDirectory defines the absolute path of the folder of the skill in the project.
+ */
+export declare function installAssistantSkill(sourceDirectory: string, targetDirectory: string): Promise<AssistantSkillInstallResult>;
+/**
+ * Installs the skills of the plugin of the assistant in the "agents" skills folder of the project ("<project>/.agents/skills"),
+ * where Codex finds the skills of a project: Codex can't load skills from another folder for a single session.
+ * @param pluginDirectory defines the absolute path of the plugin of the assistant bundled with the editor.
+ * @param projectDirectory defines the absolute path of the root folder of the project.
+ * @returns what happened to each skill, by name.
+ */
+export declare function installAssistantSkillsInProject(pluginDirectory: string, projectDirectory: string): Promise<Record<string, AssistantSkillInstallResult>>;

package/declaration/src/editor/layout/assistant/watcher.d.ts

@@ -0,0 +1,43 @@
+import { Editor } from "../../main";
+/**
+ * Returns wether or not changes of the given file of the assets folder are ignored: hidden files and caches, files
+ * generated by the editor, and the content of packages like scenes, which the editor rewrites each time it saves.
+ * @param relativePath defines the path of the file, relative to the assets folder, with forward slashes.
+ */
+export declare function isIgnoredAssetPath(relativePath: string): boolean;
+/**
+ * Watches the assets folder of the project while the AI assistant runs: the assets browser shows the files it adds,
+ * and the elements of the scene created from an asset it modifies are reloaded.
+ */
+export declare class AssistantAssetsWatcher {
+    readonly editor: Editor;
+    readonly assetsDirectory: string;
+    private _watcher;
+    private _refreshTimeout;
+    private _reloadTimeouts;
+    private _hashes;
+    private _assetUpdatedTimes;
+    private _onAssetUpdated;
+    /**
+     * Constructor.
+     * @param editor defines the reference to the editor.
+     * @param assetsDirectory defines the absolute path of the assets folder of the project.
+     */
+    constructor(editor: Editor, assetsDirectory: string);
+    /**
+     * Starts watching the assets folder.
+     */
+    start(): void;
+    /**
+     * Stops watching the assets folder.
+     */
+    stop(): void;
+    private _scheduleRefresh;
+    private _scheduleReload;
+    private _reload;
+    /**
+     * Returns wether or not the given file was just written by the editor itself: while or right after saving the
+     * project, or right after another window of the editor saved an asset of the same type and updated the scene.
+     */
+    private _isWrittenByEditor;
+}

package/declaration/src/editor/layout/assistant.d.ts

@@ -0,0 +1,142 @@
+import { Component, ReactNode } from "react";
+import { Editor } from "../main";
+import { IAssistantExecutable } from "./assistant/executable";
+import { EditorAssistantAgentId } from "./assistant/agents";
+export type EditorAssistantStatus = "idle" | "no-project" | "searching" | "not-found" | "starting" | "running" | "exited" | "error";
+export interface IEditorAssistantProps {
+    /**
+     * Defines the reference to the editor.
+     */
+    editor: Editor;
+    /**
+     * Defines wether or not the panel of the assistant is open. The session starts the first time it opens and keeps
+     * running while it is closed.
+     */
+    open: boolean;
+}
+export interface IEditorAssistantState {
+    status: EditorAssistantStatus;
+    agent: EditorAssistantAgentId;
+    executable: IAssistantExecutable | null;
+    error: string | null;
+    exitCode: number | null;
+    activity: string | null;
+    dragOver: boolean;
+    welcome: boolean;
+}
+export declare class EditorAssistant extends Component<IEditorAssistantProps, IEditorAssistantState> {
+    private _terminal;
+    private _fitAddon;
+    private _webglAddon;
+    private _terminalContainer;
+    private _resizeObserver;
+    private _fitTimeout;
+    private _themeObserver;
+    private _pty;
+    private _mcpServer;
+    private _hooksServer;
+    private _watcher;
+    private _projectPath;
+    private _starting;
+    private _sessionAgent;
+    private _antigravityPluginRemoval;
+    private _antigravityOutput;
+    private _workState;
+    private _inputToastId;
+    private _sessionId;
+    private _activityTimeout;
+    private _projectConfigurationObserver;
+    constructor(props: IEditorAssistantProps);
+    render(): ReactNode;
+    componentDidMount(): void;
+    componentDidUpdate(prevProps: IEditorAssistantProps): void;
+    componentWillUnmount(): void;
+    /**
+     * Gets wether or not a session of the agent is running in the assistant.
+     */
+    get isRunning(): boolean;
+    /**
+     * Focuses the terminal of the assistant so the user can type directly.
+     */
+    focus(): void;
+    /**
+     * Starts a session of the agent chosen by the user in the root folder of the project, connected to this editor window.
+     * @param resume defines wether or not to continue the last conversation of the project instead of starting a new one.
+     */
+    start(resume: boolean): Promise<void>;
+    /**
+     * Returns the absolute path of the plugin of the assistant, holding the skills of the editor, or null when it was not
+     * built.
+     */
+    private _getPluginDirectory;
+    /**
+     * Installs the skills of the editor in the project for Codex, which only finds skills in the project or in the home
+     * folder of the user. The agent still starts when they can't be installed.
+     */
+    private _installSkillsInProject;
+    /**
+     * Stops the current session of the agent, if any, and starts a new one.
+     * @param resume defines wether or not to continue the last conversation of the project instead of starting a new one.
+     */
+    restart(resume: boolean): Promise<void>;
+    private _stopSession;
+    /**
+     * Removes the plugin given to Antigravity CLI, once no session of the assistant uses it anymore, so the other
+     * sessions of Antigravity CLI of the user don't start the MCP server of the editor.
+     */
+    private _removeAntigravityPlugin;
+    /**
+     * Starts the HTTP server the hook events of the new session are sent to. Each session has its own server, so the
+     * events a stopped session still sends are never received.
+     */
+    private _startHooksServer;
+    private _stopHooksServer;
+    private _setWorkState;
+    private _handleHook;
+    private _handleAntigravityHook;
+    /**
+     * Follows the output of Antigravity CLI while it works to know when it waits for the user to allow a tool, a command
+     * or a URL: it runs no hook while it waits.
+     */
+    private _handleAntigravityOutput;
+    /**
+     * Follows what Codex is doing through the title it gives to its terminal: Codex only runs the hooks the user
+     * trusted, while the terminal of the assistant always receives the title.
+     */
+    private _handleTitleChange;
+    /**
+     * Returns the action of the notifications of the assistant, which shows its panel when it is hidden.
+     */
+    private _getShowToastAction;
+    private _ensureMcpServer;
+    private _startWatcher;
+    private _getEnvironment;
+    private _ensureTerminal;
+    private _disposeTerminal;
+    /**
+     * Fits the terminal to its container. A collapsed panel has no size: fitting would give invalid dimensions.
+     */
+    private _fit;
+    private _getTerminalTheme;
+    private _handleDragOver;
+    /**
+     * Types the paths of the dropped assets or files in the prompt of the agent, relative to the project when they
+     * are in it, so the user can talk about them.
+     */
+    private _handleDrop;
+    private _handleLocateExecutable;
+    private _handleResetExecutableLocation;
+    /**
+     * Remembers the agent chosen by the user and starts a new session with it. The conversation of the current agent
+     * can be resumed later from the menu.
+     */
+    private _handleAgentChange;
+    private _getHeader;
+    /**
+     * Returns the message welcoming the user each time the panel opens, until they type or close it.
+     */
+    private _getWelcome;
+    private _getPlaceholder;
+    private _getNotFoundPlaceholder;
+    private _getExitedBar;
+}

package/declaration/src/editor/layout/console.d.ts

@@ -1,6 +1,25 @@
 import { Component, ReactNode } from "react";
 import { Editor } from "../main";
 import { EditorConsoleProgressLogComponent } from "./console/progress-log";
+export type EditorConsoleEntryLevel = "log" | "warn" | "error";
+export interface IEditorConsoleEntry {
+    /**
+     * Defines the number of the entry, increasing with each message logged.
+     */
+    id: number;
+    /**
+     * Defines the level of the message.
+     */
+    level: EditorConsoleEntryLevel;
+    /**
+     * Defines the text of the message.
+     */
+    message: string;
+    /**
+     * Defines the date the message was logged at, in milliseconds.
+     */
+    time: number;
+}
 export interface IEditorConsoleProps {
     editor: Editor;
 }
@@ -37,4 +56,18 @@ export declare class EditorConsole extends Component<IEditorConsoleProps, IEdito
      */
     progress(message: ReactNode): Promise<EditorConsoleProgressLogComponent>;
     private _addLog;
+    private _nextEntryId;
+    private _entries;
+    /**
+     * Gets the id the next message logged in the console will have. Read it before an operation to get the messages it
+     * logs with `getEntriesSince`.
+     */
+    get nextEntryId(): number;
+    /**
+     * Returns the messages logged in the console since the given entry id, oldest first.
+     * @param id defines the id of the first entry to return.
+     */
+    getEntriesSince(id: number): IEditorConsoleEntry[];
+    private _addEntry;
+    private _getConsoleMessageText;
 }

package/declaration/src/editor/layout/toolbar.d.ts

@@ -11,6 +11,8 @@ export declare class EditorToolbar extends Component<IEditorToolbarProps> {
     private _spriteCommands;
     constructor(props: IEditorToolbarProps);
     render(): ReactNode;
+    private _getAssistantButton;
+    private _getAssistantTooltip;
     private _getToolbar;
     private _handleOpenProject;
     private _handleOpenVisualStudioCode;

package/declaration/src/editor/layout.d.ts

@@ -9,6 +9,7 @@ import { EditorAnimation } from "./layout/animation";
 import { EditorAssetsBrowser } from "./layout/assets-browser";
 import { EditorTerminal } from "./layout/terminal";
 import { EditorMarketplaceBrowser } from "./layout/marketplace";
+import { EditorAssistant } from "./layout/assistant";
 export interface IEditorLayoutProps {
     /**
      * The editor reference.
@@ -55,6 +56,10 @@ export declare class EditorLayout extends Component<IEditorLayoutProps> {
      * The marketplace browser of the editor.
      */
     marketplace: EditorMarketplaceBrowser | null;
+    /**
+     * The AI assistant docked on the right of the editor.
+     */
+    assistant: EditorAssistant | null;
     /**
      * Observable for when the layout has changed.
      */
@@ -63,8 +68,13 @@ export declare class EditorLayout extends Component<IEditorLayoutProps> {
     private _model;
     private _components;
     private _layoutVersion;
+    private _assistantSize;
+    private _assistantLayoutSize;
+    private _assistantPanel;
+    private _assistantAnimationTimeout;
     constructor(props: IEditorLayoutProps);
     render(): ReactNode;
+    componentDidUpdate(): void;
     componentDidCatch(): void;
     private _layoutFactory;
     private _saveLayout;
@@ -91,4 +101,16 @@ export declare class EditorLayout extends Component<IEditorLayoutProps> {
      * @param tabId defines the id of the tab to remove from the layout.
      */
     removeLayoutTab(tabId: string): void;
+    /**
+     * Expands or collapses the panel of the assistant to match the state of the editor. The panel can only be resized
+     * once the group computed its first layout: until then, its default size already matches the state.
+     * @param animate defines wether or not the panel slides to its new size.
+     */
+    private _syncAssistantPanel;
+    /**
+     * Lets the panels slide to their new sizes the next time they change, by enabling the transition of their size for
+     * the duration of the animation only: resizing the panels by dragging their handle must follow the pointer.
+     */
+    private _animateAssistantPanel;
+    private _handleSplitLayout;
 }

package/declaration/src/editor/main.d.ts

@@ -2,6 +2,7 @@ import { Component, ReactNode } from "react";
 import { EditorProjectCompressedTextureQuality, EditorProjectCompressedTextureSoftware, EditorProjectPackageManager } from "../project/typings";
 import { CommandPalette } from "./dialogs/command-palette/command-palette";
 import { EditorLayout } from "./layout";
+import { EditorAssistantWorkState } from "./layout/assistant/hooks";
 import "./nodes/camera";
 import "./nodes/scene-link";
 export declare function createEditor(): void;
@@ -64,6 +65,14 @@ export interface IEditorState {
      * Defines the list of tabs that are currently opened in the layout.
      */
     openedTabs: string[];
+    /**
+     * Defines wether or not the AI assistant panel is open on the right of the editor.
+     */
+    assistantOpen: boolean;
+    /**
+     * Defines what the AI assistant is doing: nothing, working on a request, or waiting for the user to answer it.
+     */
+    assistantWorkState: EditorAssistantWorkState;
     /**
      * Defines if the project is being edited.
      */
@@ -107,6 +116,16 @@ export declare class Editor extends Component<IEditorProps, IEditorState> {
      * @param absolutePath defines the absolute path to the project to open.
      */
     openProject(absolutePath: string): Promise<void>;
+    /**
+     * Updates the native menu of the application with the current state of the editor.
+     */
+    updateMenu(): void;
+    /**
+     * Shows or hides the AI assistant panel docked on the right of the editor. Hiding it keeps its session running.
+     * The AI assistant is an experimental feature: it can't be shown while experimental features are disabled.
+     * @param open defines wether or not the AI assistant panel is open.
+     */
+    setAssistantOpen(open: boolean): void;
     /**
      * Closes the current editor window after asking for confirmation.
      */

package/declaration/src/editor/menu.d.ts

@@ -1,4 +1,5 @@
 export declare function setupEditorMenu(options: {
     enableExperimentalFeatures: boolean;
     openedTabs?: string[];
+    assistantOpen?: boolean;
 }): void;

package/declaration/src/mcp/mcp.d.ts

@@ -1,4 +1,4 @@
-import { Scene } from "babylonjs";
+import { Observable, Scene } from "babylonjs";
 import { Editor } from "../editor/main";
 import { IMCPActionOptions } from "./action";
 export interface IEditorMCPDataType {
@@ -14,8 +14,52 @@ export declare const MCPServerPort = 3712;
  * Each handler has the signature `(scene, data, options) => any | Promise<any>`.
  */
 export declare const MCPEndpoints: Record<string, (scene: Scene, data: any, options: IMCPActionOptions) => any>;
+export interface IEditorMcpServerOptions {
+    /**
+     * Defines the port to listen on. 0 lets the system pick a free port.
+     * @default MCPServerPort
+     */
+    port?: number;
+    /**
+     * Defines the token every request must send in the "x-babylonjs-editor-token" header. Null accepts every request.
+     */
+    token?: string | null;
+}
+export interface IEditorMcpServer {
+    /**
+     * Defines the port the server listens on, on the loopback interface.
+     */
+    readonly port: number;
+    /**
+     * Defines the token every request must send, if any.
+     */
+    readonly token: string | null;
+    /**
+     * Notified with the name of the endpoint each time a tool starts being handled.
+     */
+    readonly onRequestObservable: Observable<string>;
+    /**
+     * Notified with the name of the endpoint and wether it succeeded each time a tool was handled.
+     */
+    readonly onResponseObservable: Observable<{
+        endpoint: string;
+        succeeded: boolean;
+    }>;
+    /**
+     * Stops listening.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Starts the HTTP server the MCP server of the editor sends the tools it receives to. It only listens on the
+ * loopback interface, and rejects every request sent by a web page.
+ * @param editor defines the reference to the editor.
+ * @param options defines the port to listen on and the token requests must send.
+ */
+export declare function startMcpServer(editor: Editor, options?: IEditorMcpServerOptions): Promise<IEditorMcpServer>;
 /**
- * Initializes the editor MCP HTTP server.
+ * Initializes the editor MCP HTTP server on its well known port, without any token, for the MCP server of the
+ * Claude Desktop extension.
  * Resilient: if the port is already in use (e.g. a second editor window), the error is caught
  * and logged in the editor console instead of crashing the application.
  * @param editor defines the reference to the editor.

package/declaration/src/mcp/meshes/decals.d.ts

@@ -0,0 +1,28 @@
+import { Scene } from "babylonjs";
+import { IMCPActionOptions } from "../action";
+/**
+ * Defines the default width, height and depth of a decal, in centimeters, like the decals painted in the editor.
+ */
+export declare const defaultDecalSize = 100;
+/**
+ * Defines the configuration of a decal saved in the metadata of its mesh. It is the one the decals painted in the
+ * editor have, so the inspector edits both the same way.
+ */
+export interface IDecalConfiguration {
+    angle: number;
+    sizeX: number;
+    sizeY: number;
+    sizeZ: number;
+    meshId: string;
+    position: number[];
+    normal: number[];
+}
+/**
+ * Projects a decal (a sticker made of a material: a logo, a crack, a stain, a poster, a road marking...) on a mesh. The
+ * decal is parented to the mesh and follows it.
+ */
+export declare function createDecal(scene: Scene, data: any, options: IMCPActionOptions): Promise<any>;
+/**
+ * Changes the size, the angle or the place of a decal, building its geometry again on the mesh it is projected on.
+ */
+export declare function updateDecal(scene: Scene, data: any, options: IMCPActionOptions): any;

package/declaration/src/mcp/play/keys.d.ts

@@ -0,0 +1,26 @@
+export interface IKeyDescription {
+    /**
+     * Defines the value of "KeyboardEvent.key", like "w", " " or "Shift".
+     */
+    key: string;
+    /**
+     * Defines the value of "KeyboardEvent.code", like "KeyW", "Space" or "ShiftLeft".
+     */
+    code: string;
+    /**
+     * Defines the value of the legacy "KeyboardEvent.keyCode", like 87 for W.
+     */
+    keyCode: number;
+}
+/**
+ * Returns the description of the given key, given as its "KeyboardEvent.key" value ("w", "W", " ", "Shift",
+ * "ArrowUp") or its name ("Space", "Ctrl").
+ * @param name defines the key.
+ */
+export declare function getKeyDescription(name: string): IKeyDescription;
+/**
+ * Returns the value stored by the "@visibleAsKeyMap" decorator for the given key: the character code of the upper-cased
+ * "KeyboardEvent.key" value, as the inspector of the editor stores it.
+ * @param value defines the key: a number is kept as is, a string is a key ("w", "Space").
+ */
+export declare function getKeyMapValue(value: unknown): number;

package/declaration/src/mcp/play/play.d.ts

@@ -0,0 +1,29 @@
+import { Scene } from "babylonjs";
+import { IMCPActionOptions } from "../action";
+/**
+ * Plays the scene in the preview of the editor, like the Play button: the project is exported, its scripts compiled
+ * and the game runs in the preview. Returns what the console received while it started.
+ */
+export declare function playScene(_scene: Scene, data: any, options: IMCPActionOptions): Promise<any>;
+/**
+ * Stops the game playing in the preview of the editor.
+ */
+export declare function stopScene(_scene: Scene, _data: any, options: IMCPActionOptions): any;
+/**
+ * Returns the messages logged in the console of the editor.
+ */
+export declare function getConsoleLogs(_scene: Scene, data: any, options: IMCPActionOptions): any;
+/**
+ * Simulates the input of a player in the game playing in the preview: keys held for a duration, mouse movements and
+ * clicks, dispatched on the canvas like the ones of the user.
+ */
+export declare function simulateInput(_scene: Scene, data: any, options: IMCPActionOptions): Promise<any>;
+/**
+ * Returns the state of the game playing in the preview: the active camera, the playing animation groups and the
+ * transform of the given nodes. Compare the states before and after `simulate_input` to check that the game reacts.
+ */
+export declare function inspectPlayScene(_scene: Scene, data: any, options: IMCPActionOptions): any;
+/**
+ * Returns the scene to take screenshots of: the game when it plays in the preview, the scene of the editor otherwise.
+ */
+export declare function getScreenshotScene(scene: Scene, options: IMCPActionOptions): Scene;

package/declaration/src/mcp/screenshot.d.ts

@@ -1,9 +1,10 @@
 import { Scene } from "babylonjs";
 import { IMCPActionOptions } from "./action";
 /**
- * Takes a screenshot of the preview for visual verification.
+ * Takes a screenshot of the preview for visual verification: the game when it plays in the preview (the scene of the
+ * editor is not rendered then), the scene of the editor otherwise.
  */
-export declare function getScreenshot(scene: Scene, data: any): Promise<any>;
+export declare function getScreenshot(scene: Scene, data: any, options: IMCPActionOptions): Promise<any>;
 /**
  * Frames the editor camera on a node to help screenshots.
  */

package/declaration/src/mcp/scripts/scripts.d.ts

@@ -19,15 +19,15 @@ export declare function writeScript(_scene: Scene, data: any): Promise<any>;
 /**
  * Attaches a script file to a node, writing the node script metadata as the inspector does.
  */
-export declare function attachScript(scene: Scene, data: any, options: IMCPActionOptions): any;
+export declare function attachScript(scene: Scene, data: any, options: IMCPActionOptions): Promise<any>;
 /**
  * Lists the scripts attached to a node and their exported values.
  */
-export declare function listAttachedScripts(scene: Scene, data: any): any;
+export declare function listAttachedScripts(scene: Scene, data: any): Promise<any>;
 /**
  * Sets an exported/inspector value of an attached script on a node.
  */
-export declare function setScriptExportedValue(scene: Scene, data: any, options: IMCPActionOptions): any;
+export declare function setScriptExportedValue(scene: Scene, data: any, options: IMCPActionOptions): Promise<any>;
 /**
  * Removes an attached script from a node.
  */

package/declaration/src/mcp/scripts/values.d.ts

@@ -0,0 +1,33 @@
+import { Scene } from "babylonjs";
+import { VisibleInInspectorDecoratorObject } from "../../editor/layout/inspector/script/tools";
+/**
+ * Defines a property of a script shown in the inspector (a "@visibleAs*" decorated property), with its current value.
+ */
+export interface IScriptProperty {
+    key: string;
+    type: string;
+    label?: string;
+    description?: string;
+    entityType?: string;
+    assetType?: string;
+    typeRestriction?: string;
+    min?: number;
+    max?: number;
+    value: any;
+}
+/**
+ * Compiles the given attached script like the inspector does to find its "@visibleAs*" decorated properties, and
+ * updates the values saved in the metadata of the object: the missing ones get their default value, the ones of
+ * removed properties are removed. The loader of the game requires these values for scripts with such properties.
+ * @param script defines the script attached to an object, from "object.metadata.scripts".
+ * @returns the decorated properties of the script.
+ */
+export declare function updateScriptValues(script: any): Promise<VisibleInInspectorDecoratorObject[]>;
+/**
+ * Returns the decorated properties of the given script with their current values.
+ */
+export declare function getScriptProperties(script: any, output: VisibleInInspectorDecoratorObject[]): IScriptProperty[];
+/**
+ * Converts the given value to the value saved for the given decorated property, as the inspector saves it.
+ */
+export declare function getScriptPropertyValue(scene: Scene, property: VisibleInInspectorDecoratorObject, value: any): Promise<any>;

package/declaration/src/mcp/server.d.ts

@@ -0,0 +1,49 @@
+import { IncomingMessage, Server, ServerResponse } from "http";
+/**
+ * Defines the name of the HTTP header the MCP server sends the token of the editor in.
+ */
+export declare const MCPTokenHeader = "x-babylonjs-editor-token";
+/**
+ * Defines the maximum size, in bytes, of the body of a request sent to the editor.
+ */
+export declare const MCPMaxRequestBodySize: number;
+export interface IMCPRequestListenerOptions {
+    /**
+     * Defines the token requests must send in the "x-babylonjs-editor-token" header. Null accepts every request.
+     */
+    token: string | null;
+    /**
+     * Returns the function handling the given endpoint, or undefined when the endpoint doesn't exist.
+     */
+    getAction: (endpoint: string) => ((data: any) => any) | undefined;
+    /**
+     * Called each time a request for an existing endpoint is about to be handled.
+     */
+    onRequest?: (endpoint: string) => void;
+    /**
+     * Called each time a request for an existing endpoint was handled, successfully or not.
+     */
+    onResponse?: (endpoint: string, succeeded: boolean) => void;
+}
+/**
+ * Returns wether or not the given token matches the expected one, in a time that doesn't depend on where they differ.
+ * @param received defines the token received with the request.
+ * @param expected defines the token of the editor.
+ */
+export declare function isMCPTokenValid(received: string | string[] | undefined, expected: string): boolean;
+/**
+ * Creates the function handling the requests sent to the editor by its MCP server. Each request is a POST whose
+ * JSON body holds the name of the endpoint in "endpoint" and the arguments of the tool.
+ * @param options defines the options of the listener.
+ */
+export declare function createMCPRequestListener(options: IMCPRequestListenerOptions): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+/**
+ * Starts listening with the given request listener on the loopback interface only.
+ * @param listener defines the function handling the requests.
+ * @param port defines the port to listen on. 0 lets the system pick a free one.
+ * @returns the server and the port it listens on.
+ */
+export declare function listenMCPServer(listener: (req: IncomingMessage, res: ServerResponse) => Promise<void>, port: number): Promise<{
+    server: Server;
+    port: number;
+}>;

package/declaration/src/mcp/tools/resolve.d.ts

@@ -59,6 +59,7 @@ export declare function toVector3(value: any): Vector3;
 /**
  * Deeply sets a property on the given target using a dotted path (e.g. "material.albedoColor").
  * Arrays are coerced to Color3/Vector3/Color4/Vector2/Vector4 based on the existing property type.
+ * Methods are never replaced: "isEnabled" is set through "setEnabled", and other methods throw.
  * @param target defines the root object on which to set the property.
  * @param path defines the dotted path to the property to set.
  * @param value defines the value to set.