@pixerate/editor 0.28.0 → 0.30.0

package/dist/agent/index.js

@@ -1,9 +1,22 @@
+import {
+  EDITOR_MCP_TOOLS,
+  EXPORT_EXCLUDED_SELECTORS,
+  MCP_TOOL_EDIT_CANVAS,
+  MCP_TOOL_EDIT_PROMPT,
+  MCP_TOOL_GET_EDITOR_STATE,
+  MCP_TOOL_VIEW_EDITOR,
+  TOOL_NAMESPACE_SEPARATOR,
+  ToolRegistry,
+  ToolRegistryError,
+  createToolRegistry,
+  toToolResult
+} from "../chunk-36BLROHV.js";
 import {
   hasVariantCommands
 } from "../chunk-IB3ZHQAX.js";
 import {
   validateJsonSchema
-} from "../chunk-ARRTP33I.js";
+} from "../chunk-D6S5M7HV.js";
 import {
   TABLE_ACTIONS,
   getTableActionState,
@@ -289,426 +302,6 @@ function planToolCall(name, args, snapshot, options) {
   return command ? planAgentCommand(command, snapshot, options) : [];
 }
 
-// src/agent/tools.ts
-var MCP_TOOL_GET_EDITOR_STATE = {
-  name: "get_editor_state",
-  title: "Get editor state",
-  annotations: {
-    title: "Get editor state",
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: false
-  },
-  description: "Retrieves the current state of the document, variables, selection, and canvas graph (nodes and edges).",
-  inputSchema: {
-    type: "object",
-    properties: {
-      includeDocument: {
-        type: "boolean",
-        description: "Whether to include the prompt document text and variables (default: true)."
-      },
-      includeCanvas: {
-        type: "boolean",
-        description: "Whether to include the canvas nodes and edges (default: true)."
-      }
-    }
-  }
-};
-var MCP_TOOL_EDIT_CANVAS = {
-  name: "edit_canvas",
-  title: "Edit the canvas",
-  annotations: {
-    title: "Edit the canvas",
-    readOnlyHint: false,
-    destructiveHint: true,
-    idempotentHint: false,
-    openWorldHint: false
-  },
-  description: "Applies high-level structural operations to the visual canvas (adding nodes, connecting edges, organizing layout, or moving elements).",
-  inputSchema: {
-    type: "object",
-    properties: {
-      operation: {
-        type: "string",
-        enum: [
-          "add_node",
-          "remove_nodes",
-          "connect",
-          "update_node",
-          "layout",
-          "select",
-          "highlight"
-        ],
-        description: "The canvas operation to execute."
-      },
-      node: {
-        type: "object",
-        description: "Node definition when operation is add_node. Can omit position to auto-place."
-      },
-      nearNodeId: {
-        type: "string",
-        description: "Anchor node ID to position beside using collision-aware placement."
-      },
-      side: {
-        type: "string",
-        enum: ["top", "right", "bottom", "left"],
-        description: "Side of the anchor node to place the new node beside."
-      },
-      nodeIds: {
-        type: "array",
-        items: { type: "string" },
-        description: "Array of node IDs for remove_nodes, select, or highlight."
-      },
-      source: {
-        type: "string",
-        description: "Source node ID for connect operation."
-      },
-      target: {
-        type: "string",
-        description: "Target node ID for connect operation."
-      },
-      label: {
-        type: "string",
-        description: "Optional edge label for connect operation."
-      },
-      direction: {
-        type: "string",
-        enum: ["LR", "TB", "RL", "BT"],
-        description: "Layout direction (default LR)."
-      },
-      incremental: {
-        type: "boolean",
-        description: "Preserve existing node coordinates and blend layout (default true)."
-      }
-    },
-    required: ["operation"]
-  }
-};
-var MCP_TOOL_EDIT_PROMPT = {
-  name: "edit_prompt",
-  title: "Edit the prompt",
-  annotations: {
-    title: "Edit the prompt",
-    readOnlyHint: false,
-    destructiveHint: true,
-    idempotentHint: false,
-    openWorldHint: false
-  },
-  description: "Applies edits to the prompt template document, including inserting text, replacing ranges, and setting variables.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      operation: {
-        type: "string",
-        enum: ["insert_text", "replace_range", "set_variable", "select"],
-        description: "The prompt operation to execute."
-      },
-      text: {
-        type: "string",
-        description: "Text to insert or replace."
-      },
-      at: {
-        type: "number",
-        description: "Position to insert text at."
-      },
-      from: {
-        type: "number",
-        description: "Start offset for replace_range or select."
-      },
-      to: {
-        type: "number",
-        description: "End offset for replace_range or select."
-      },
-      name: {
-        type: "string",
-        description: "Variable name for set_variable."
-      },
-      value: {
-        description: "Variable value for set_variable."
-      }
-    },
-    required: ["operation"]
-  }
-};
-var MCP_TOOL_VIEW_EDITOR = {
-  name: "view_editor",
-  title: "View the editor",
-  annotations: {
-    title: "View the editor",
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: false
-  },
-  description: "Captures a visual image snapshot (JPEG or PNG) of the editor canvas or viewport for multimodal evaluation. Active agent cursor indicators are automatically excluded from the snapshot.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      scope: {
-        type: "string",
-        enum: ["viewport", "canvas"],
-        description: "Whether to capture only the visible viewport or the full canvas bounding box (default: viewport)."
-      },
-      format: {
-        type: "string",
-        enum: ["jpeg", "png"],
-        description: "Image format of the base64 snapshot (default: jpeg)."
-      },
-      maxEdge: {
-        type: "integer",
-        description: "Maximum width or height dimension in pixels (default: 1024)."
-      }
-    }
-  }
-};
-var EXPORT_EXCLUDED_SELECTORS = [
-  ".pixerate-presence",
-  ".agent-presence",
-  ".ursula-presence"
-];
-var EDITOR_MCP_TOOLS = [
-  MCP_TOOL_GET_EDITOR_STATE,
-  MCP_TOOL_EDIT_CANVAS,
-  MCP_TOOL_EDIT_PROMPT,
-  MCP_TOOL_VIEW_EDITOR
-];
-
-// src/agent/registry.ts
-var ToolRegistryError = class extends Error {
-  code;
-  constructor(code, message) {
-    super(message);
-    this.name = "ToolRegistryError";
-    this.code = code;
-  }
-};
-var TOOL_NAMESPACE_SEPARATOR = "__";
-var TOOL_NAME_REGEX = /^[A-Za-z0-9_.-]{1,128}$/;
-var sanitizeNamespace = (id) => id.replace(/[^A-Za-z0-9_-]/g, "_");
-function readTools(provider) {
-  return typeof provider.tools === "function" ? provider.tools() : provider.tools;
-}
-function toDefinition(name, tool) {
-  const { handler: _handler, name: _name, ...rest } = tool;
-  return { name, ...rest };
-}
-function errorResult(error) {
-  const details = error.details?.length ? "\n" + error.details.map((d) => `- ${d.path}: ${d.message}`).join("\n") : "";
-  return {
-    isError: true,
-    content: [{ type: "text", text: `${error.message}${details}` }],
-    structuredContent: { error }
-  };
-}
-function toToolResult(value) {
-  if (value && typeof value === "object" && Array.isArray(value.content)) {
-    return value;
-  }
-  if (value === void 0) return { content: [] };
-  if (typeof value === "string") return { content: [{ type: "text", text: value }] };
-  const text = JSON.stringify(value);
-  const isPlainObject = typeof value === "object" && value !== null && !Array.isArray(value);
-  return {
-    content: [{ type: "text", text: text ?? String(value) }],
-    ...isPlainObject ? { structuredContent: value } : {}
-  };
-}
-var ToolRegistry = class {
-  /** MCP server capabilities this registry supports. */
-  capabilities = { tools: { listChanged: true } };
-  entries = [];
-  listeners = /* @__PURE__ */ new Set();
-  options;
-  timer = null;
-  lastSignature;
-  constructor(options = {}) {
-    this.options = {
-      onCollision: options.onCollision ?? "namespace",
-      listChangedDelayMs: options.listChangedDelayMs ?? 0,
-      validateArguments: options.validateArguments ?? true
-    };
-    this.lastSignature = this.signature();
-  }
-  /**
-   * Registers a provider and returns a function that unregisters it.
-   * Throws a {@link ToolRegistryError} for a duplicate provider id, an invalid
-   * tool name, or (with `onCollision: 'error'`) a tool name collision.
-   */
-  register(provider) {
-    if (this.entries.some((e) => e.provider.id === provider.id)) {
-      throw new ToolRegistryError("duplicate_provider", `Tool provider "${provider.id}" is already registered.`);
-    }
-    for (const tool of readTools(provider)) {
-      if (!TOOL_NAME_REGEX.test(tool.name)) {
-        throw new ToolRegistryError("invalid_tool", `Invalid tool name "${tool.name}" from provider "${provider.id}".`);
-      }
-    }
-    const entry = { provider };
-    this.entries.push(entry);
-    try {
-      const names = this.resolve(this.options.onCollision === "error").map((t) => t.name);
-      const duplicate = names.find((name, i) => names.indexOf(name) !== i);
-      if (duplicate) {
-        throw new ToolRegistryError("name_collision", `Tool name "${duplicate}" is exposed more than once.`);
-      }
-    } catch (error) {
-      this.entries.pop();
-      throw error;
-    }
-    if (provider.subscribe) {
-      entry.unsubscribe = provider.subscribe(() => this.notifyListChanged());
-    }
-    this.notifyListChanged();
-    let registered = true;
-    return () => {
-      if (!registered) return;
-      registered = false;
-      this.unregister(provider);
-    };
-  }
-  /** Removes a provider by id or instance. Returns whether it was registered. */
-  unregister(providerOrId) {
-    const index = this.entries.findIndex(
-      (e) => typeof providerOrId === "string" ? e.provider.id === providerOrId : e.provider === providerOrId
-    );
-    if (index === -1) return false;
-    const [entry] = this.entries.splice(index, 1);
-    entry.unsubscribe?.();
-    this.notifyListChanged();
-    return true;
-  }
-  /** Registered provider ids in registration order. */
-  providerIds() {
-    return this.entries.map((e) => e.provider.id);
-  }
-  /**
-   * Resolves exposed names. Tools are ordered by provider registration, then
-   * by their order within the provider.
-   */
-  resolve(throwOnCollision = false) {
-    const all = [];
-    const counts = /* @__PURE__ */ new Map();
-    for (const { provider } of this.entries) {
-      for (const tool of readTools(provider)) {
-        all.push({ name: tool.name, tool, provider });
-        if (!provider.namespace) counts.set(tool.name, (counts.get(tool.name) ?? 0) + 1);
-      }
-    }
-    for (const item of all) {
-      const prefix = item.provider.namespace ?? ((counts.get(item.name) ?? 0) > 1 ? item.provider.id : void 0);
-      if (prefix !== void 0) {
-        if (throwOnCollision && !item.provider.namespace) {
-          throw new ToolRegistryError(
-            "name_collision",
-            `Tool "${item.name}" from provider "${item.provider.id}" collides with another provider's tool.`
-          );
-        }
-        item.name = `${sanitizeNamespace(prefix)}${TOOL_NAMESPACE_SEPARATOR}${item.name}`;
-      }
-    }
-    return all;
-  }
-  /** MCP `tools/list` result for the current providers. */
-  listTools() {
-    return { tools: this.resolve().map(({ name, tool }) => toDefinition(name, tool)) };
-  }
-  /** Whether a tool with this exposed name exists. */
-  hasTool(name) {
-    return this.resolve().some((t) => t.name === name);
-  }
-  /** Looks up a tool definition by exposed name. */
-  getTool(name) {
-    const found = this.resolve().find((t) => t.name === name);
-    return found ? toDefinition(found.name, found.tool) : void 0;
-  }
-  /**
-   * Calls a tool by exposed name and returns an MCP `tools/call` result.
-   * Never rejects: unknown tools, invalid arguments and handler errors come
-   * back as `isError: true` results with a {@link ToolCallError} in
-   * `structuredContent.error` (MCP transports may map `unknown_tool` to a
-   * JSON-RPC `-32602` error instead).
-   */
-  async callTool(name, args = {}, options = {}) {
-    const found = this.resolve().find((t) => t.name === name);
-    if (!found) {
-      return errorResult({ code: "unknown_tool", message: `Unknown tool "${name}".`, tool: name });
-    }
-    const input = args ?? {};
-    if (this.options.validateArguments) {
-      const details = validateJsonSchema(input, found.tool.inputSchema);
-      if (details.length > 0) {
-        return errorResult({
-          code: "invalid_arguments",
-          message: `Invalid arguments for tool "${name}".`,
-          tool: name,
-          details
-        });
-      }
-    }
-    try {
-      const value = await found.tool.handler(input, {
-        name,
-        providerId: found.provider.id,
-        signal: options.signal
-      });
-      return toToolResult(value);
-    } catch (error) {
-      return errorResult({
-        code: "tool_failed",
-        message: error instanceof Error ? error.message : String(error),
-        tool: name
-      });
-    }
-  }
-  /**
-   * Subscribes to tool-list changes. Notifications are coalesced: many
-   * registrations or provider signals within the delay window produce one
-   * call, and none if the exposed list ends up unchanged (e.g. a provider
-   * unmounted and remounted). Returns an unsubscribe function.
-   */
-  onListChanged(listener) {
-    this.listeners.add(listener);
-    return () => {
-      this.listeners.delete(listener);
-    };
-  }
-  /** Schedules a coalesced `listChanged` check; providers may call it directly. */
-  notifyListChanged() {
-    if (this.timer !== null) return;
-    this.timer = setTimeout(() => this.flush(), this.options.listChangedDelayMs);
-  }
-  /** Runs a pending `listChanged` check immediately. */
-  flush() {
-    if (this.timer !== null) {
-      clearTimeout(this.timer);
-      this.timer = null;
-    }
-    const signature = this.signature();
-    if (signature === this.lastSignature) return;
-    this.lastSignature = signature;
-    const { tools } = this.listTools();
-    for (const listener of Array.from(this.listeners)) listener(tools);
-  }
-  signature() {
-    try {
-      return JSON.stringify(this.listTools().tools);
-    } catch {
-      return String(Math.random());
-    }
-  }
-  /** Unregisters every provider and listener and cancels pending notifications. */
-  dispose() {
-    if (this.timer !== null) clearTimeout(this.timer);
-    this.timer = null;
-    for (const entry of this.entries.splice(0)) entry.unsubscribe?.();
-    this.listeners.clear();
-  }
-};
-function createToolRegistry(options) {
-  return new ToolRegistry(options);
-}
-
 // src/agent/providers.ts
 import { TextSelection } from "@tiptap/pm/state";
 var toEditor = (target) => "commands" in target ? target : target.editor;