@pixerate/editor 0.52.0 → 0.54.0

package/dist/chunk-QIWFEEWG.cjs

@@ -0,0 +1,467 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class;
+
+var _chunkRIWPYSKUcjs = require('./chunk-RIWPYSKU.cjs');
+
+// src/tools/registry.ts
+var ToolRegistryError = class extends Error {
+  
+  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 = _optionalChain([error, 'access', _ => _.details, 'optionalAccess', _2 => _2.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: _nullishCoalesce(text, () => ( String(value))) }],
+    ...isPlainObject ? { structuredContent: value } : {}
+  };
+}
+var ToolRegistry = (_class = class {
+  /** MCP server capabilities this registry supports. */
+  __init() {this.capabilities = { tools: { listChanged: true } }}
+  __init2() {this.entries = []}
+  __init3() {this.listeners = /* @__PURE__ */ new Set()}
+  
+  __init4() {this.timer = null}
+  
+  constructor(options = {}) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);
+    this.options = {
+      onCollision: _nullishCoalesce(options.onCollision, () => ( "namespace")),
+      listChangedDelayMs: _nullishCoalesce(options.listChangedDelayMs, () => ( 0)),
+      validateArguments: _nullishCoalesce(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);
+    _optionalChain([entry, 'access', _3 => _3.unsubscribe, 'optionalCall', _4 => _4()]);
+    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, (_nullishCoalesce(counts.get(tool.name), () => ( 0))) + 1);
+      }
+    }
+    for (const item of all) {
+      const prefix = _nullishCoalesce(item.provider.namespace, () => ( ((_nullishCoalesce(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 = _nullishCoalesce(args, () => ( {}));
+    if (this.options.validateArguments) {
+      const details = _chunkRIWPYSKUcjs.validateJsonSchema.call(void 0, 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 (e2) {
+      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)) _optionalChain([entry, 'access', _5 => _5.unsubscribe, 'optionalCall', _6 => _6()]);
+    this.listeners.clear();
+  }
+}, _class);
+function createToolRegistry(options) {
+  return new ToolRegistry(options);
+}
+
+// src/tools/mcp-server.ts
+var MCP_PROTOCOL_VERSIONS = ["2025-06-18", "2025-03-26", "2024-11-05"];
+var JSON_RPC_ERRORS = {
+  parseError: -32700,
+  invalidRequest: -32600,
+  methodNotFound: -32601,
+  invalidParams: -32602,
+  internalError: -32603
+};
+var errorResponse = (id, code, message, data) => ({
+  jsonrpc: "2.0",
+  id,
+  error: { code, message, ...data !== void 0 ? { data } : {} }
+});
+function createMcpServer(registry, options) {
+  let initialized = false;
+  let unsubscribe = null;
+  const running = /* @__PURE__ */ new Map();
+  const startNotifications = () => {
+    if (unsubscribe || !options.send) return;
+    const send = options.send;
+    unsubscribe = registry.onListChanged(() => send({ jsonrpc: "2.0", method: "notifications/tools/list_changed" }));
+  };
+  async function dispatch(request) {
+    const id = _nullishCoalesce(request.id, () => ( null));
+    const isNotification = request.id === void 0 || request.id === null;
+    const params = _nullishCoalesce(request.params, () => ( {}));
+    switch (request.method) {
+      case "initialize": {
+        const requested = String(_nullishCoalesce(params.protocolVersion, () => ( "")));
+        const protocolVersion = MCP_PROTOCOL_VERSIONS.includes(requested) ? requested : MCP_PROTOCOL_VERSIONS[0];
+        return {
+          jsonrpc: "2.0",
+          id,
+          result: {
+            protocolVersion,
+            capabilities: registry.capabilities,
+            serverInfo: { name: options.name, version: options.version, ...options.title ? { title: options.title } : {} },
+            ...options.instructions ? { instructions: options.instructions } : {}
+          }
+        };
+      }
+      case "notifications/initialized":
+        initialized = true;
+        startNotifications();
+        return null;
+      case "notifications/cancelled": {
+        const requestId = params.requestId;
+        if (requestId !== void 0) _optionalChain([running, 'access', _7 => _7.get, 'call', _8 => _8(requestId), 'optionalAccess', _9 => _9.abort, 'call', _10 => _10(params.reason)]);
+        return null;
+      }
+      case "ping":
+        return { jsonrpc: "2.0", id, result: {} };
+      case "tools/list":
+        return { jsonrpc: "2.0", id, result: registry.listTools() };
+      case "tools/call": {
+        const name = params.name;
+        if (typeof name !== "string") {
+          return errorResponse(id, JSON_RPC_ERRORS.invalidParams, 'tools/call needs a string "name".');
+        }
+        if (!registry.hasTool(name)) {
+          return errorResponse(id, JSON_RPC_ERRORS.invalidParams, `Unknown tool: ${name}`);
+        }
+        const args = params.arguments;
+        if (args !== void 0 && (typeof args !== "object" || args === null || Array.isArray(args))) {
+          return errorResponse(id, JSON_RPC_ERRORS.invalidParams, '"arguments" must be an object.');
+        }
+        const controller = new AbortController();
+        if (!isNotification) running.set(id, controller);
+        try {
+          const result = await registry.callTool(name, _nullishCoalesce(args, () => ( {})), { signal: controller.signal });
+          if (controller.signal.aborted) return null;
+          return { jsonrpc: "2.0", id, result };
+        } finally {
+          if (!isNotification) running.delete(id);
+        }
+      }
+      default:
+        if (isNotification) return null;
+        return errorResponse(id, JSON_RPC_ERRORS.methodNotFound, `Method not found: ${request.method}`);
+    }
+  }
+  return {
+    get initialized() {
+      return initialized;
+    },
+    async handle(message) {
+      let request;
+      if (typeof message === "string") {
+        try {
+          request = JSON.parse(message);
+        } catch (e3) {
+          return errorResponse(null, JSON_RPC_ERRORS.parseError, "Parse error.");
+        }
+      } else {
+        request = message;
+      }
+      if (!request || typeof request !== "object" || Array.isArray(request) || request.jsonrpc !== "2.0" || typeof request.method !== "string") {
+        const id = request && typeof request === "object" && !Array.isArray(request) ? _nullishCoalesce(request.id, () => ( null)) : null;
+        return errorResponse(id, JSON_RPC_ERRORS.invalidRequest, "Invalid JSON-RPC 2.0 request.");
+      }
+      try {
+        return await dispatch(request);
+      } catch (error) {
+        if (request.id === void 0 || request.id === null) return null;
+        return errorResponse(
+          request.id,
+          JSON_RPC_ERRORS.internalError,
+          error instanceof Error ? error.message : String(error)
+        );
+      }
+    },
+    close() {
+      _optionalChain([unsubscribe, 'optionalCall', _11 => _11()]);
+      unsubscribe = null;
+      for (const controller of running.values()) controller.abort("Server closed.");
+      running.clear();
+    }
+  };
+}
+
+// src/tools/bridge-client.ts
+var TOOL_BRIDGE_PROTOCOL = 1;
+var TOOL_BRIDGE_DEFAULT_PORT = 4477;
+function connectToolBridge(registry, options) {
+  const Ctor = _nullishCoalesce(options.WebSocket, () => ( globalThis.WebSocket));
+  if (!Ctor) throw new Error("No WebSocket implementation: pass options.WebSocket.");
+  const base = _nullishCoalesce(options.url, () => ( `ws://127.0.0.1:${TOOL_BRIDGE_DEFAULT_PORT}`));
+  const url = options.token ? `${base}${base.includes("?") ? "&" : "?"}token=${encodeURIComponent(options.token)}` : base;
+  let status = "connecting";
+  let editorId = null;
+  let socket = null;
+  let closed = false;
+  let delay = 500;
+  let retry = null;
+  const running = /* @__PURE__ */ new Map();
+  const setStatus = (next, detail) => {
+    if (next === status && !detail) return;
+    status = next;
+    _optionalChain([options, 'access', _12 => _12.onStatus, 'optionalCall', _13 => _13(next, detail)]);
+  };
+  const send = (message) => {
+    if (socket && socket.readyState === 1) socket.send(JSON.stringify(message));
+  };
+  const unsubscribe = registry.onListChanged((tools) => send({ t: "tools", tools }));
+  const open = () => {
+    if (closed) return;
+    setStatus("connecting");
+    const ws = new Ctor(url);
+    socket = ws;
+    ws.addEventListener("open", () => {
+      delay = 500;
+      send({ t: "hello", v: TOOL_BRIDGE_PROTOCOL, name: options.name, ...options.kind ? { kind: options.kind } : {}, tools: registry.listTools().tools });
+    });
+    ws.addEventListener("message", (event) => {
+      let message;
+      try {
+        message = JSON.parse(String(event.data));
+      } catch (e4) {
+        return;
+      }
+      if (message.t === "welcome") {
+        editorId = message.id;
+        setStatus("connected");
+      } else if (message.t === "call") {
+        const controller = new AbortController();
+        running.set(message.id, controller);
+        void registry.callTool(message.name, _nullishCoalesce(message.arguments, () => ( {})), { signal: controller.signal }).then((result) => {
+          running.delete(message.id);
+          if (!controller.signal.aborted) send({ t: "result", id: message.id, result });
+        });
+      } else if (message.t === "cancel") {
+        _optionalChain([running, 'access', _14 => _14.get, 'call', _15 => _15(message.id), 'optionalAccess', _16 => _16.abort, 'call', _17 => _17(_nullishCoalesce(message.reason, () => ( "Cancelled by the agent.")))]);
+        running.delete(message.id);
+      }
+    });
+    ws.addEventListener("close", (event) => {
+      if (socket !== ws) return;
+      socket = null;
+      editorId = null;
+      for (const controller of running.values()) controller.abort("The bridge disconnected.");
+      running.clear();
+      if (closed) return setStatus("closed");
+      setStatus("disconnected", event.reason || void 0);
+      if (options.reconnect === false) return;
+      retry = setTimeout(open, delay);
+      delay = Math.min(1e4, delay * 2);
+    });
+    ws.addEventListener("error", () => {
+    });
+  };
+  open();
+  return {
+    get status() {
+      return status;
+    },
+    get editorId() {
+      return editorId;
+    },
+    close() {
+      if (closed) return;
+      closed = true;
+      if (retry) clearTimeout(retry);
+      unsubscribe();
+      for (const controller of running.values()) controller.abort("The editor disconnected.");
+      running.clear();
+      const ws = socket;
+      socket = null;
+      _optionalChain([ws, 'optionalAccess', _18 => _18.close, 'call', _19 => _19(1e3, "Editor closed.")]);
+      setStatus("closed");
+    }
+  };
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.ToolRegistryError = ToolRegistryError; exports.TOOL_NAMESPACE_SEPARATOR = TOOL_NAMESPACE_SEPARATOR; exports.toToolResult = toToolResult; exports.ToolRegistry = ToolRegistry; exports.createToolRegistry = createToolRegistry; exports.MCP_PROTOCOL_VERSIONS = MCP_PROTOCOL_VERSIONS; exports.JSON_RPC_ERRORS = JSON_RPC_ERRORS; exports.createMcpServer = createMcpServer; exports.TOOL_BRIDGE_PROTOCOL = TOOL_BRIDGE_PROTOCOL; exports.TOOL_BRIDGE_DEFAULT_PORT = TOOL_BRIDGE_DEFAULT_PORT; exports.connectToolBridge = connectToolBridge;
+//# sourceMappingURL=chunk-QIWFEEWG.cjs.map

package/dist/chunk-QIWFEEWG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/chunk-QIWFEEWG.cjs","../src/tools/registry.ts","../src/tools/mcp-server.ts","../src/tools/bridge-client.ts"],"names":[],"mappings":"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","file":"/home/runner/work/editor/editor/packages/core/dist/chunk-QIWFEEWG.cjs","sourcesContent":[null,"import { validateJsonSchema, type JsonSchema, type SchemaValidationError } from './schema.js';\n\n/**\n * MCP-shaped tool definition, as returned by `tools/list`.\n */\nexport interface McpToolDefinition {\n\tname: string;\n\ttitle?: string;\n\tdescription?: string;\n\tinputSchema: JsonSchema & { type: 'object' };\n\toutputSchema?: JsonSchema;\n\tannotations?: {\n\t\ttitle?: string;\n\t\treadOnlyHint?: boolean;\n\t\tdestructiveHint?: boolean;\n\t\tidempotentHint?: boolean;\n\t\topenWorldHint?: boolean;\n\t\t[key: string]: unknown;\n\t};\n}\n\nexport type McpToolContent =\n\t| { type: 'text'; text: string }\n\t| { type: 'image'; data: string; mimeType: string }\n\t| { type: string; [key: string]: unknown };\n\n/** MCP `tools/call` result. */\nexport interface McpToolResult {\n\tcontent: McpToolContent[];\n\tstructuredContent?: Record<string, unknown>;\n\tisError?: boolean;\n}\n\n/** MCP `tools/list` result. */\nexport interface McpListToolsResult {\n\ttools: McpToolDefinition[];\n}\n\nexport interface ToolCallContext {\n\t/** Name the tool was called by (possibly namespaced). */\n\tname: string;\n\t/** Id of the provider that owns the tool. */\n\tproviderId: string;\n\tsignal?: AbortSignal;\n}\n\n/**\n * Handler return values are normalized into an {@link McpToolResult}: a full\n * result (`{ content: [...] }`) is passed through, a string becomes a text\n * block, `undefined` becomes an empty result, and anything else is returned\n * as `structuredContent` (plain objects) plus a JSON text block.\n */\nexport type AgentToolHandler = (args: Record<string, any>, context: ToolCallContext) => unknown | Promise<unknown>;\n\nexport interface AgentTool extends McpToolDefinition {\n\thandler: AgentToolHandler;\n}\n\n/**\n * A source of tools, typically one per mounted editor, spreadsheet or canvas.\n */\nexport interface AgentToolProvider {\n\t/** Unique id within a registry, e.g. `doc-1`. Used as the namespace on collisions. */\n\tid: string;\n\t/** Always prefix this provider's tools with `<namespace>__`. */\n\tnamespace?: string;\n\t/** Tools, or a function returning the current tools (re-read on every `listTools`). */\n\ttools: readonly AgentTool[] | (() => readonly AgentTool[]);\n\t/** Lets the provider signal that its tool list changed; returns an unsubscribe function. */\n\tsubscribe?: (notify: () => void) => () => void;\n}\n\nexport type ToolErrorCode = 'unknown_tool' | 'invalid_arguments' | 'tool_failed';\n\n/** Structured error carried in `structuredContent.error` of a failed call. */\nexport interface ToolCallError {\n\tcode: ToolErrorCode;\n\tmessage: string;\n\ttool: string;\n\tdetails?: SchemaValidationError[];\n}\n\nexport class ToolRegistryError extends Error {\n\treadonly code: 'duplicate_provider' | 'name_collision' | 'invalid_tool';\n\n\tconstructor(code: ToolRegistryError['code'], message: string) {\n\t\tsuper(message);\n\t\tthis.name = 'ToolRegistryError';\n\t\tthis.code = code;\n\t}\n}\n\nexport interface ToolRegistryOptions {\n\t/**\n\t * What to do when two providers contribute the same tool name:\n\t * `namespace` (default) exposes every colliding tool as `<providerId>__<name>`;\n\t * `error` makes `register` throw.\n\t */\n\tonCollision?: 'namespace' | 'error';\n\t/** Coalescing window for `listChanged` notifications in ms (default 0: same tick). */\n\tlistChangedDelayMs?: number;\n\t/** Validate arguments against `inputSchema` before calling handlers (default `true`). */\n\tvalidateArguments?: boolean;\n}\n\n/** Separator between namespace and tool name; valid in MCP and LLM tool-name charsets. */\nexport const TOOL_NAMESPACE_SEPARATOR = '__';\n\nconst TOOL_NAME_REGEX = /^[A-Za-z0-9_.-]{1,128}$/;\nconst sanitizeNamespace = (id: string) => id.replace(/[^A-Za-z0-9_-]/g, '_');\n\ninterface ResolvedTool {\n\tname: string;\n\ttool: AgentTool;\n\tprovider: AgentToolProvider;\n}\n\ninterface ProviderEntry {\n\tprovider: AgentToolProvider;\n\tunsubscribe?: () => void;\n}\n\nfunction readTools(provider: AgentToolProvider): readonly AgentTool[] {\n\treturn typeof provider.tools === 'function' ? provider.tools() : provider.tools;\n}\n\nfunction toDefinition(name: string, tool: AgentTool): McpToolDefinition {\n\tconst { handler: _handler, name: _name, ...rest } = tool;\n\treturn { name, ...rest };\n}\n\nfunction errorResult(error: ToolCallError): McpToolResult {\n\tconst details = error.details?.length\n\t\t? '\\n' + error.details.map((d) => `- ${d.path}: ${d.message}`).join('\\n')\n\t\t: '';\n\treturn {\n\t\tisError: true,\n\t\tcontent: [{ type: 'text', text: `${error.message}${details}` }],\n\t\tstructuredContent: { error: error as unknown as Record<string, unknown> }\n\t};\n}\n\n/** Normalizes a handler's return value into an MCP `tools/call` result. */\nexport function toToolResult(value: unknown): McpToolResult {\n\tif (\n\t\tvalue &&\n\t\ttypeof value === 'object' &&\n\t\tArray.isArray((value as McpToolResult).content)\n\t) {\n\t\treturn value as McpToolResult;\n\t}\n\tif (value === undefined) return { content: [] };\n\tif (typeof value === 'string') return { content: [{ type: 'text', text: value }] };\n\tconst text = JSON.stringify(value);\n\tconst isPlainObject = typeof value === 'object' && value !== null && !Array.isArray(value);\n\treturn {\n\t\tcontent: [{ type: 'text', text: text ?? String(value) }],\n\t\t...(isPlainObject ? { structuredContent: value as Record<string, unknown> } : {})\n\t};\n}\n\n/**\n * Transport-agnostic registry of agent tools contributed by live providers.\n *\n * `listTools()` and `callTool()` return MCP `tools/list` / `tools/call`\n * result shapes, and `onListChanged` fires (coalesced) whenever the exposed\n * tool list changes, mirroring MCP's `notifications/tools/list_changed`, so an\n * MCP server can be a thin wrapper around it.\n */\nexport class ToolRegistry {\n\t/** MCP server capabilities this registry supports. */\n\treadonly capabilities = { tools: { listChanged: true } } as const;\n\n\tprivate readonly entries: ProviderEntry[] = [];\n\tprivate readonly listeners = new Set<(tools: McpToolDefinition[]) => void>();\n\tprivate readonly options: Required<ToolRegistryOptions>;\n\tprivate timer: ReturnType<typeof setTimeout> | null = null;\n\tprivate lastSignature: string;\n\n\tconstructor(options: ToolRegistryOptions = {}) {\n\t\tthis.options = {\n\t\t\tonCollision: options.onCollision ?? 'namespace',\n\t\t\tlistChangedDelayMs: options.listChangedDelayMs ?? 0,\n\t\t\tvalidateArguments: options.validateArguments ?? true\n\t\t};\n\t\tthis.lastSignature = this.signature();\n\t}\n\n\t/**\n\t * Registers a provider and returns a function that unregisters it.\n\t * Throws a {@link ToolRegistryError} for a duplicate provider id, an invalid\n\t * tool name, or (with `onCollision: 'error'`) a tool name collision.\n\t */\n\tregister(provider: AgentToolProvider): () => void {\n\t\tif (this.entries.some((e) => e.provider.id === provider.id)) {\n\t\t\tthrow new ToolRegistryError('duplicate_provider', `Tool provider \"${provider.id}\" is already registered.`);\n\t\t}\n\t\tfor (const tool of readTools(provider)) {\n\t\t\tif (!TOOL_NAME_REGEX.test(tool.name)) {\n\t\t\t\tthrow new ToolRegistryError('invalid_tool', `Invalid tool name \"${tool.name}\" from provider \"${provider.id}\".`);\n\t\t\t}\n\t\t}\n\t\tconst entry: ProviderEntry = { provider };\n\t\tthis.entries.push(entry);\n\t\ttry {\n\t\t\tconst names = this.resolve(this.options.onCollision === 'error').map((t) => t.name);\n\t\t\tconst duplicate = names.find((name, i) => names.indexOf(name) !== i);\n\t\t\tif (duplicate) {\n\t\t\t\t// Only possible with explicit namespaces (or duplicate names within one provider).\n\t\t\t\tthrow new ToolRegistryError('name_collision', `Tool name \"${duplicate}\" is exposed more than once.`);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthis.entries.pop();\n\t\t\tthrow error;\n\t\t}\n\t\tif (provider.subscribe) {\n\t\t\tentry.unsubscribe = provider.subscribe(() => this.notifyListChanged());\n\t\t}\n\t\tthis.notifyListChanged();\n\t\tlet registered = true;\n\t\treturn () => {\n\t\t\tif (!registered) return;\n\t\t\tregistered = false;\n\t\t\tthis.unregister(provider);\n\t\t};\n\t}\n\n\t/** Removes a provider by id or instance. Returns whether it was registered. */\n\tunregister(providerOrId: string | AgentToolProvider): boolean {\n\t\tconst index = this.entries.findIndex((e) =>\n\t\t\ttypeof providerOrId === 'string' ? e.provider.id === providerOrId : e.provider === providerOrId\n\t\t);\n\t\tif (index === -1) return false;\n\t\tconst [entry] = this.entries.splice(index, 1);\n\t\tentry.unsubscribe?.();\n\t\tthis.notifyListChanged();\n\t\treturn true;\n\t}\n\n\t/** Registered provider ids in registration order. */\n\tproviderIds(): string[] {\n\t\treturn this.entries.map((e) => e.provider.id);\n\t}\n\n\t/**\n\t * Resolves exposed names. Tools are ordered by provider registration, then\n\t * by their order within the provider.\n\t */\n\tprivate resolve(throwOnCollision = false): ResolvedTool[] {\n\t\tconst all: ResolvedTool[] = [];\n\t\tconst counts = new Map<string, number>();\n\t\tfor (const { provider } of this.entries) {\n\t\t\tfor (const tool of readTools(provider)) {\n\t\t\t\tall.push({ name: tool.name, tool, provider });\n\t\t\t\tif (!provider.namespace) counts.set(tool.name, (counts.get(tool.name) ?? 0) + 1);\n\t\t\t}\n\t\t}\n\t\tfor (const item of all) {\n\t\t\tconst prefix = item.provider.namespace ?? ((counts.get(item.name) ?? 0) > 1 ? item.provider.id : undefined);\n\t\t\tif (prefix !== undefined) {\n\t\t\t\tif (throwOnCollision && !item.provider.namespace) {\n\t\t\t\t\tthrow new ToolRegistryError(\n\t\t\t\t\t\t'name_collision',\n\t\t\t\t\t\t`Tool \"${item.name}\" from provider \"${item.provider.id}\" collides with another provider's tool.`\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\titem.name = `${sanitizeNamespace(prefix)}${TOOL_NAMESPACE_SEPARATOR}${item.name}`;\n\t\t\t}\n\t\t}\n\t\treturn all;\n\t}\n\n\t/** MCP `tools/list` result for the current providers. */\n\tlistTools(): McpListToolsResult {\n\t\treturn { tools: this.resolve().map(({ name, tool }) => toDefinition(name, tool)) };\n\t}\n\n\t/** Whether a tool with this exposed name exists. */\n\thasTool(name: string): boolean {\n\t\treturn this.resolve().some((t) => t.name === name);\n\t}\n\n\t/** Looks up a tool definition by exposed name. */\n\tgetTool(name: string): McpToolDefinition | undefined {\n\t\tconst found = this.resolve().find((t) => t.name === name);\n\t\treturn found ? toDefinition(found.name, found.tool) : undefined;\n\t}\n\n\t/**\n\t * Calls a tool by exposed name and returns an MCP `tools/call` result.\n\t * Never rejects: unknown tools, invalid arguments and handler errors come\n\t * back as `isError: true` results with a {@link ToolCallError} in\n\t * `structuredContent.error` (MCP transports may map `unknown_tool` to a\n\t * JSON-RPC `-32602` error instead).\n\t */\n\tasync callTool(name: string, args: Record<string, unknown> = {}, options: { signal?: AbortSignal } = {}): Promise<McpToolResult> {\n\t\tconst found = this.resolve().find((t) => t.name === name);\n\t\tif (!found) {\n\t\t\treturn errorResult({ code: 'unknown_tool', message: `Unknown tool \"${name}\".`, tool: name });\n\t\t}\n\t\tconst input = args ?? {};\n\t\tif (this.options.validateArguments) {\n\t\t\tconst details = validateJsonSchema(input, found.tool.inputSchema);\n\t\t\tif (details.length > 0) {\n\t\t\t\treturn errorResult({\n\t\t\t\t\tcode: 'invalid_arguments',\n\t\t\t\t\tmessage: `Invalid arguments for tool \"${name}\".`,\n\t\t\t\t\ttool: name,\n\t\t\t\t\tdetails\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\ttry {\n\t\t\tconst value = await found.tool.handler(input as Record<string, any>, {\n\t\t\t\tname,\n\t\t\t\tproviderId: found.provider.id,\n\t\t\t\tsignal: options.signal\n\t\t\t});\n\t\t\treturn toToolResult(value);\n\t\t} catch (error) {\n\t\t\treturn errorResult({\n\t\t\t\tcode: 'tool_failed',\n\t\t\t\tmessage: error instanceof Error ? error.message : String(error),\n\t\t\t\ttool: name\n\t\t\t});\n\t\t}\n\t}\n\n\t/**\n\t * Subscribes to tool-list changes. Notifications are coalesced: many\n\t * registrations or provider signals within the delay window produce one\n\t * call, and none if the exposed list ends up unchanged (e.g. a provider\n\t * unmounted and remounted). Returns an unsubscribe function.\n\t */\n\tonListChanged(listener: (tools: McpToolDefinition[]) => void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => {\n\t\t\tthis.listeners.delete(listener);\n\t\t};\n\t}\n\n\t/** Schedules a coalesced `listChanged` check; providers may call it directly. */\n\tnotifyListChanged(): void {\n\t\tif (this.timer !== null) return;\n\t\tthis.timer = setTimeout(() => this.flush(), this.options.listChangedDelayMs);\n\t}\n\n\t/** Runs a pending `listChanged` check immediately. */\n\tflush(): void {\n\t\tif (this.timer !== null) {\n\t\t\tclearTimeout(this.timer);\n\t\t\tthis.timer = null;\n\t\t}\n\t\tconst signature = this.signature();\n\t\tif (signature === this.lastSignature) return;\n\t\tthis.lastSignature = signature;\n\t\tconst { tools } = this.listTools();\n\t\tfor (const listener of Array.from(this.listeners)) listener(tools);\n\t}\n\n\tprivate signature(): string {\n\t\ttry {\n\t\t\treturn JSON.stringify(this.listTools().tools);\n\t\t} catch {\n\t\t\treturn String(Math.random());\n\t\t}\n\t}\n\n\t/** Unregisters every provider and listener and cancels pending notifications. */\n\tdispose(): void {\n\t\tif (this.timer !== null) clearTimeout(this.timer);\n\t\tthis.timer = null;\n\t\tfor (const entry of this.entries.splice(0)) entry.unsubscribe?.();\n\t\tthis.listeners.clear();\n\t}\n}\n\nexport function createToolRegistry(options?: ToolRegistryOptions): ToolRegistry {\n\treturn new ToolRegistry(options);\n}\n","import type { ToolRegistry } from './registry.js';\n\n/** MCP protocol revisions this server speaks, newest first. */\nexport const MCP_PROTOCOL_VERSIONS = ['2025-06-18', '2025-03-26', '2024-11-05'] as const;\n\nexport type JsonRpcId = string | number;\n\nexport interface JsonRpcRequest {\n\tjsonrpc: '2.0';\n\tid?: JsonRpcId | null;\n\tmethod: string;\n\tparams?: Record<string, any>;\n}\n\nexport interface JsonRpcResponse {\n\tjsonrpc: '2.0';\n\tid: JsonRpcId | null;\n\tresult?: unknown;\n\terror?: { code: number; message: string; data?: unknown };\n}\n\nexport interface JsonRpcNotification {\n\tjsonrpc: '2.0';\n\tmethod: string;\n\tparams?: Record<string, unknown>;\n}\n\n/** Standard JSON-RPC error codes used by the server. */\nexport const JSON_RPC_ERRORS = {\n\tparseError: -32700,\n\tinvalidRequest: -32600,\n\tmethodNotFound: -32601,\n\tinvalidParams: -32602,\n\tinternalError: -32603\n} as const;\n\nexport interface McpServerOptions {\n\t/** `serverInfo` sent in the `initialize` result. */\n\tname: string;\n\tversion: string;\n\ttitle?: string;\n\t/** Usage hints for the client's model, sent in the `initialize` result. */\n\tinstructions?: string;\n\t/**\n\t * Sends server → client messages (`notifications/tools/list_changed`).\n\t * Without it the server still answers requests but announces nothing.\n\t */\n\tsend?: (message: JsonRpcNotification) => void;\n}\n\nexport interface McpServer {\n\t/**\n\t * Handles one client message (a JSON string or a parsed object) and\n\t * resolves to the response to send back, or `null` for notifications.\n\t * Never rejects.\n\t */\n\thandle(message: string | JsonRpcRequest): Promise<JsonRpcResponse | null>;\n\t/** Whether the client has completed the `initialize` handshake. */\n\treadonly initialized: boolean;\n\t/** Stops list-changed notifications and aborts running tool calls. */\n\tclose(): void;\n}\n\nconst errorResponse = (id: JsonRpcId | null, code: number, message: string, data?: unknown): JsonRpcResponse => ({\n\tjsonrpc: '2.0',\n\tid,\n\terror: { code, message, ...(data !== undefined ? { data } : {}) }\n});\n\n/**\n * A transport-agnostic MCP server for a {@link ToolRegistry}: wire `handle`\n * to any transport (stdio lines, a WebSocket, `postMessage`, an HTTP POST\n * handler) and pass `send` for server → client notifications.\n *\n * Supports `initialize` (with protocol version negotiation), `ping`,\n * `tools/list`, `tools/call` and `notifications/cancelled` (aborts the\n * call's `signal`), and announces `notifications/tools/list_changed` after\n * the client sends `notifications/initialized`. An unknown tool is a\n * JSON-RPC `-32602` error, as the MCP spec asks; invalid arguments and\n * handler failures are `isError` tool results the model can read and fix.\n */\nexport function createMcpServer(registry: ToolRegistry, options: McpServerOptions): McpServer {\n\tlet initialized = false;\n\tlet unsubscribe: (() => void) | null = null;\n\tconst running = new Map<JsonRpcId, AbortController>();\n\n\tconst startNotifications = () => {\n\t\tif (unsubscribe || !options.send) return;\n\t\tconst send = options.send;\n\t\tunsubscribe = registry.onListChanged(() => send({ jsonrpc: '2.0', method: 'notifications/tools/list_changed' }));\n\t};\n\n\tasync function dispatch(request: JsonRpcRequest): Promise<JsonRpcResponse | null> {\n\t\tconst id = request.id ?? null;\n\t\tconst isNotification = request.id === undefined || request.id === null;\n\t\tconst params = request.params ?? {};\n\n\t\tswitch (request.method) {\n\t\t\tcase 'initialize': {\n\t\t\t\tconst requested = String(params.protocolVersion ?? '');\n\t\t\t\tconst protocolVersion = (MCP_PROTOCOL_VERSIONS as readonly string[]).includes(requested)\n\t\t\t\t\t? requested\n\t\t\t\t\t: MCP_PROTOCOL_VERSIONS[0];\n\t\t\t\treturn {\n\t\t\t\t\tjsonrpc: '2.0',\n\t\t\t\t\tid,\n\t\t\t\t\tresult: {\n\t\t\t\t\t\tprotocolVersion,\n\t\t\t\t\t\tcapabilities: registry.capabilities,\n\t\t\t\t\t\tserverInfo: { name: options.name, version: options.version, ...(options.title ? { title: options.title } : {}) },\n\t\t\t\t\t\t...(options.instructions ? { instructions: options.instructions } : {})\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t}\n\t\t\tcase 'notifications/initialized':\n\t\t\t\tinitialized = true;\n\t\t\t\tstartNotifications();\n\t\t\t\treturn null;\n\t\t\tcase 'notifications/cancelled': {\n\t\t\t\tconst requestId = params.requestId as JsonRpcId | undefined;\n\t\t\t\tif (requestId !== undefined) running.get(requestId)?.abort(params.reason);\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tcase 'ping':\n\t\t\t\treturn { jsonrpc: '2.0', id, result: {} };\n\t\t\tcase 'tools/list':\n\t\t\t\treturn { jsonrpc: '2.0', id, result: registry.listTools() };\n\t\t\tcase 'tools/call': {\n\t\t\t\tconst name = params.name;\n\t\t\t\tif (typeof name !== 'string') {\n\t\t\t\t\treturn errorResponse(id, JSON_RPC_ERRORS.invalidParams, 'tools/call needs a string \"name\".');\n\t\t\t\t}\n\t\t\t\tif (!registry.hasTool(name)) {\n\t\t\t\t\treturn errorResponse(id, JSON_RPC_ERRORS.invalidParams, `Unknown tool: ${name}`);\n\t\t\t\t}\n\t\t\t\tconst args = params.arguments;\n\t\t\t\tif (args !== undefined && (typeof args !== 'object' || args === null || Array.isArray(args))) {\n\t\t\t\t\treturn errorResponse(id, JSON_RPC_ERRORS.invalidParams, '\"arguments\" must be an object.');\n\t\t\t\t}\n\t\t\t\tconst controller = new AbortController();\n\t\t\t\tif (!isNotification) running.set(id as JsonRpcId, controller);\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await registry.callTool(name, args ?? {}, { signal: controller.signal });\n\t\t\t\t\t// A cancelled request gets no response (MCP cancellation semantics).\n\t\t\t\t\tif (controller.signal.aborted) return null;\n\t\t\t\t\treturn { jsonrpc: '2.0', id, result };\n\t\t\t\t} finally {\n\t\t\t\t\tif (!isNotification) running.delete(id as JsonRpcId);\n\t\t\t\t}\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tif (isNotification) return null;\n\t\t\t\treturn errorResponse(id, JSON_RPC_ERRORS.methodNotFound, `Method not found: ${request.method}`);\n\t\t}\n\t}\n\n\treturn {\n\t\tget initialized() {\n\t\t\treturn initialized;\n\t\t},\n\t\tasync handle(message) {\n\t\t\tlet request: JsonRpcRequest;\n\t\t\tif (typeof message === 'string') {\n\t\t\t\ttry {\n\t\t\t\t\trequest = JSON.parse(message);\n\t\t\t\t} catch {\n\t\t\t\t\treturn errorResponse(null, JSON_RPC_ERRORS.parseError, 'Parse error.');\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\trequest = message;\n\t\t\t}\n\t\t\tif (\n\t\t\t\t!request ||\n\t\t\t\ttypeof request !== 'object' ||\n\t\t\t\tArray.isArray(request) ||\n\t\t\t\trequest.jsonrpc !== '2.0' ||\n\t\t\t\ttypeof request.method !== 'string'\n\t\t\t) {\n\t\t\t\tconst id = request && typeof request === 'object' && !Array.isArray(request) ? (request as JsonRpcRequest).id ?? null : null;\n\t\t\t\treturn errorResponse(id, JSON_RPC_ERRORS.invalidRequest, 'Invalid JSON-RPC 2.0 request.');\n\t\t\t}\n\t\t\ttry {\n\t\t\t\treturn await dispatch(request);\n\t\t\t} catch (error) {\n\t\t\t\tif (request.id === undefined || request.id === null) return null;\n\t\t\t\treturn errorResponse(\n\t\t\t\t\trequest.id,\n\t\t\t\t\tJSON_RPC_ERRORS.internalError,\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\t\tclose() {\n\t\t\tunsubscribe?.();\n\t\t\tunsubscribe = null;\n\t\t\tfor (const controller of running.values()) controller.abort('Server closed.');\n\t\t\trunning.clear();\n\t\t}\n\t};\n}\n","// The editor side of the tool bridge (Ursula's `connectRemote` / src/remote/protocol.ts): a page\n// connects its ToolRegistry to a local MCP bridge process over a WebSocket, and the bridge's MCP\n// client can then list and call the page's tools. No imports beyond the registry types, so it\n// runs in browsers, workers and Node alike.\nimport type { McpToolDefinition, McpToolResult, ToolRegistry } from './registry.js';\n\n/** Protocol version spoken between `connectToolBridge` and `createToolBridge`. */\nexport const TOOL_BRIDGE_PROTOCOL = 1;\n\n/** Default port the bridge listens on (127.0.0.1 only). */\nexport const TOOL_BRIDGE_DEFAULT_PORT = 4477;\n\n/** Editor → bridge messages. */\nexport type ToolBridgeEditorMessage =\n\t| { t: 'hello'; v: number; name: string; kind?: string; tools: McpToolDefinition[] }\n\t| { t: 'tools'; tools: McpToolDefinition[] }\n\t| { t: 'result'; id: string; result: McpToolResult };\n\n/** Bridge → editor messages. */\nexport type ToolBridgeServerMessage =\n\t| { t: 'welcome'; v: number; id: string }\n\t| { t: 'call'; id: string; name: string; arguments: Record<string, unknown> }\n\t| { t: 'cancel'; id: string; reason?: string };\n\nexport type ToolBridgeStatus = 'connecting' | 'connected' | 'disconnected' | 'closed';\n\n/** The parts of a WebSocket the client uses (the browser's, Node's global one, or `ws`). */\nexport interface ToolBridgeSocket {\n\treadonly readyState: number;\n\tsend(data: string): void;\n\tclose(code?: number, reason?: string): void;\n\taddEventListener(type: 'open' | 'close' | 'error' | 'message', listener: (event: any) => void): void;\n}\n\nexport interface ConnectToolBridgeOptions {\n\t/** Bridge URL (default `ws://127.0.0.1:4477`). */\n\turl?: string;\n\t/** The bridge's token, if it was started with one (sent as `?token=`). */\n\ttoken?: string;\n\t/** How this editor is listed to the agent (`list_editors`), e.g. \"Diagram — Order flow\". */\n\tname: string;\n\t/** What kind of editor this is (\"diagram\", \"chart\", \"document\"…), shown in `list_editors`. */\n\tkind?: string;\n\t/** Reconnect after the bridge goes away (default true), backing off up to 10 s. */\n\treconnect?: boolean;\n\t/** WebSocket constructor (default: the global one). */\n\tWebSocket?: new (url: string) => ToolBridgeSocket;\n\t/** Called when the connection state changes. */\n\tonStatus?: (status: ToolBridgeStatus, detail?: string) => void;\n}\n\nexport interface ToolBridgeConnection {\n\treadonly status: ToolBridgeStatus;\n\t/** The id the bridge gave this editor (`list_editors`), once connected. */\n\treadonly editorId: string | null;\n\t/** Disconnects and stops reconnecting; running calls are aborted. */\n\tclose(): void;\n}\n\n/**\n * Connects a `ToolRegistry` to a local MCP bridge (`createToolBridge` /\n * `pixerate-mcp-bridge`), so an MCP client (Claude Desktop, Claude Code, an IDE) can call\n * the page's tools: the registry's tool list is sent on connect and whenever it changes,\n * calls run through `registry.callTool` with an `AbortSignal` the bridge cancels, and the\n * connection comes back after the bridge restarts.\n */\nexport function connectToolBridge(registry: ToolRegistry, options: ConnectToolBridgeOptions): ToolBridgeConnection {\n\tconst Ctor = options.WebSocket ?? (globalThis as { WebSocket?: new (url: string) => ToolBridgeSocket }).WebSocket;\n\tif (!Ctor) throw new Error('No WebSocket implementation: pass options.WebSocket.');\n\tconst base = options.url ?? `ws://127.0.0.1:${TOOL_BRIDGE_DEFAULT_PORT}`;\n\tconst url = options.token ? `${base}${base.includes('?') ? '&' : '?'}token=${encodeURIComponent(options.token)}` : base;\n\tlet status: ToolBridgeStatus = 'connecting';\n\tlet editorId: string | null = null;\n\tlet socket: ToolBridgeSocket | null = null;\n\tlet closed = false;\n\tlet delay = 500;\n\tlet retry: ReturnType<typeof setTimeout> | null = null;\n\tconst running = new Map<string, AbortController>();\n\tconst setStatus = (next: ToolBridgeStatus, detail?: string) => {\n\t\tif (next === status && !detail) return;\n\t\tstatus = next;\n\t\toptions.onStatus?.(next, detail);\n\t};\n\tconst send = (message: ToolBridgeEditorMessage) => {\n\t\tif (socket && socket.readyState === 1) socket.send(JSON.stringify(message));\n\t};\n\tconst unsubscribe = registry.onListChanged((tools) => send({ t: 'tools', tools }));\n\n\tconst open = () => {\n\t\tif (closed) return;\n\t\tsetStatus('connecting');\n\t\tconst ws = new Ctor(url);\n\t\tsocket = ws;\n\t\tws.addEventListener('open', () => {\n\t\t\tdelay = 500;\n\t\t\tsend({ t: 'hello', v: TOOL_BRIDGE_PROTOCOL, name: options.name, ...(options.kind ? { kind: options.kind } : {}), tools: registry.listTools().tools });\n\t\t});\n\t\tws.addEventListener('message', (event: { data: unknown }) => {\n\t\t\tlet message: ToolBridgeServerMessage;\n\t\t\ttry {\n\t\t\t\tmessage = JSON.parse(String(event.data));\n\t\t\t} catch {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (message.t === 'welcome') {\n\t\t\t\teditorId = message.id;\n\t\t\t\tsetStatus('connected');\n\t\t\t} else if (message.t === 'call') {\n\t\t\t\tconst controller = new AbortController();\n\t\t\t\trunning.set(message.id, controller);\n\t\t\t\tvoid registry.callTool(message.name, message.arguments ?? {}, { signal: controller.signal }).then((result) => {\n\t\t\t\t\trunning.delete(message.id);\n\t\t\t\t\tif (!controller.signal.aborted) send({ t: 'result', id: message.id, result });\n\t\t\t\t});\n\t\t\t} else if (message.t === 'cancel') {\n\t\t\t\trunning.get(message.id)?.abort(message.reason ?? 'Cancelled by the agent.');\n\t\t\t\trunning.delete(message.id);\n\t\t\t}\n\t\t});\n\t\tws.addEventListener('close', (event: { code?: number; reason?: string }) => {\n\t\t\tif (socket !== ws) return;\n\t\t\tsocket = null;\n\t\t\teditorId = null;\n\t\t\tfor (const controller of running.values()) controller.abort('The bridge disconnected.');\n\t\t\trunning.clear();\n\t\t\tif (closed) return setStatus('closed');\n\t\t\tsetStatus('disconnected', event.reason || undefined);\n\t\t\tif (options.reconnect === false) return;\n\t\t\tretry = setTimeout(open, delay);\n\t\t\tdelay = Math.min(10_000, delay * 2);\n\t\t});\n\t\t// Errors are followed by `close`, which handles reconnecting.\n\t\tws.addEventListener('error', () => {});\n\t};\n\topen();\n\n\treturn {\n\t\tget status() {\n\t\t\treturn status;\n\t\t},\n\t\tget editorId() {\n\t\t\treturn editorId;\n\t\t},\n\t\tclose() {\n\t\t\tif (closed) return;\n\t\t\tclosed = true;\n\t\t\tif (retry) clearTimeout(retry);\n\t\t\tunsubscribe();\n\t\t\tfor (const controller of running.values()) controller.abort('The editor disconnected.');\n\t\t\trunning.clear();\n\t\t\tconst ws = socket;\n\t\t\tsocket = null;\n\t\t\tws?.close(1000, 'Editor closed.');\n\t\t\tsetStatus('closed');\n\t\t}\n\t};\n}\n"]}

package/dist/{chunk-QFTVLEVN.js → chunk-RIXTW3C4.js}

@@ -6,11 +6,11 @@ import {
   describeChart,
   layoutChart,
   layoutSparkline
-} from "./chunk-WBOAXDKD.js";
+} from "./chunk-VODBAO32.js";
 import {
   DEFAULT_CHART_THEME,
   normalizeChartSpec
-} from "./chunk-OV7UAKIY.js";
+} from "./chunk-633QC34G.js";
 import {
   isTrackChangesEnabled
 } from "./chunk-SWE3NPOU.js";
@@ -2057,4 +2057,4 @@ export {
   getTableState,
   createTableStore
 };
-//# sourceMappingURL=chunk-QFTVLEVN.js.map
+//# sourceMappingURL=chunk-RIXTW3C4.js.map