@particle-academy/agent-integrations 0.3.4 → 0.5.0

package/dist/undo/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MicroMcpServer } from '../server-BJu_AMH3.js';
-import '../types-DksGd5Y7.js';
+import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
+import '../types-aOQLTW0E.js';
 
 /**
  * Generic undo/redo stack keyed by `agentId`. Each entry holds:
@@ -48,12 +48,12 @@ type UndoToolsOptions = {
  * ensureUndoToolsRegistered — bridges call this on construction. Safe to
  * call repeatedly with the same server; subsequent calls are no-ops.
  */
-declare function ensureUndoToolsRegistered(server: MicroMcpServer, options?: UndoToolsOptions): void;
+declare function ensureUndoToolsRegistered(host: ToolHost, options?: UndoToolsOptions): void;
 /**
  * registerUndoTools — add agent_undo / agent_redo / agent_history to the
  * server. Returns a disposer that unregisters all three.
  */
-declare function registerUndoTools(server: MicroMcpServer, options?: UndoToolsOptions): () => void;
+declare function registerUndoTools(host: ToolHost, options?: UndoToolsOptions): () => void;
 
 /**
  * useUndoStack — minimal React snapshot of an agent's history. Polls every

package/dist/undo.cjs

@@ -57,18 +57,18 @@ function errorResult(text) {
 }
 
 // src/undo/undo-tools.ts
-var installedServers = /* @__PURE__ */ new WeakSet();
-function ensureUndoToolsRegistered(server, options = {}) {
-  if (installedServers.has(server)) return;
-  installedServers.add(server);
-  registerUndoTools(server, options);
+var installedHosts = /* @__PURE__ */ new WeakSet();
+function ensureUndoToolsRegistered(host, options = {}) {
+  if (installedHosts.has(host)) return;
+  installedHosts.add(host);
+  registerUndoTools(host, options);
 }
-function registerUndoTools(server, options = {}) {
+function registerUndoTools(host, options = {}) {
   const defaultAgent = options.defaultAgentId ?? "agent";
   const disposers = [];
   const agentOf = (args) => typeof args?.agentId === "string" ? args.agentId : defaultAgent;
   disposers.push(
-    server.registerTool(
+    host.registerTool(
       {
         name: "agent_undo",
         description: "Undo the most recent action on the agent's stack. Optional agentId targets a specific agent.",
@@ -86,7 +86,7 @@ function registerUndoTools(server, options = {}) {
     )
   );
   disposers.push(
-    server.registerTool(
+    host.registerTool(
       {
         name: "agent_redo",
         description: "Redo the most recently undone action.",
@@ -104,7 +104,7 @@ function registerUndoTools(server, options = {}) {
     )
   );
   disposers.push(
-    server.registerTool(
+    host.registerTool(
       {
         name: "agent_history",
         description: "List the agent's undo stack (oldest first). Useful for understanding what's reversible.",

package/dist/undo.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/undo/undo-stack.ts","../src/mcp/server.ts","../src/undo/undo-tools.ts","../src/undo/use-undo-stack.ts"],"names":["useState","useEffect","useCallback"],"mappings":"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","file":"undo.cjs","sourcesContent":["/**\n * Generic undo/redo stack keyed by `agentId`. Each entry holds:\n *  - `do` — re-applies the action (for redo)\n *  - `undo` — reverses it\n *  - `label` — human-readable summary surfaced in agent_history\n *\n * Bridges register entries by calling `pushUndoEntry` after a successful\n * mutation. The corresponding MCP tools (`agent_undo`, `agent_redo`,\n * `agent_history`) are registered once per server via `registerUndoTools`.\n *\n * Stacks are per-agent so multiple agents can rewind independently.\n */\n\nexport type UndoEntry = {\n  /** Wall-clock ms. */\n  timestamp: number;\n  /** Bridge id (e.g. \"whiteboard\", \"form:signup\"). */\n  bridgeId: string;\n  /** Tool name that produced the entry. */\n  action: string;\n  /** Short human label, e.g. `Added sticky n_abc`. */\n  label: string;\n  /** Reverse the action. */\n  undo: () => void | Promise<void>;\n  /** Re-apply the action (used when redoing after an undo). */\n  redo: () => void | Promise<void>;\n};\n\ntype Stack = { past: UndoEntry[]; future: UndoEntry[] };\n\nconst stacks = new Map<string, Stack>();\nconst CAP = 200;\n\nfunction getStack(agentId: string): Stack {\n  let s = stacks.get(agentId);\n  if (!s) {\n    s = { past: [], future: [] };\n    stacks.set(agentId, s);\n  }\n  return s;\n}\n\n/** Push a new undo entry on the agent's stack. Clears the redo (future) stack. */\nexport function pushUndoEntry(agentId: string, entry: UndoEntry): void {\n  const s = getStack(agentId);\n  s.past.push(entry);\n  if (s.past.length > CAP) s.past.splice(0, s.past.length - CAP);\n  s.future.length = 0;\n}\n\n/** Pop and undo the most recent entry. Returns the entry that ran, or null. */\nexport async function undoOne(agentId: string): Promise<UndoEntry | null> {\n  const s = getStack(agentId);\n  const entry = s.past.pop();\n  if (!entry) return null;\n  await entry.undo();\n  s.future.push(entry);\n  return entry;\n}\n\n/** Re-apply the most recently undone entry. Returns it, or null if no future. */\nexport async function redoOne(agentId: string): Promise<UndoEntry | null> {\n  const s = getStack(agentId);\n  const entry = s.future.pop();\n  if (!entry) return null;\n  await entry.redo();\n  s.past.push(entry);\n  return entry;\n}\n\n/** Read the past stack (oldest first). */\nexport function readHistory(agentId: string): UndoEntry[] {\n  return getStack(agentId).past.slice();\n}\n\n/** Wipe an agent's stacks. */\nexport function clearStack(agentId: string): void {\n  stacks.delete(agentId);\n}\n\n/** Test/teardown helper. */\nexport function resetAllUndoStacks(): void {\n  stacks.clear();\n}\n","import {\n  type CallToolResult,\n  type JsonObject,\n  type JsonRpcMessage,\n  type JsonRpcRequest,\n  type JsonRpcId,\n  type RegisteredTool,\n  type ServerCapabilities,\n  type ServerInfo,\n  type ToolDefinition,\n  type ToolHandler,\n  JSONRPC_INTERNAL_ERROR,\n  JSONRPC_INVALID_PARAMS,\n  JSONRPC_METHOD_NOT_FOUND,\n  MCP_PROTOCOL_VERSION,\n} from \"./types\";\n\nexport type McpServerOptions = {\n  info: ServerInfo;\n  /** Defaults to { tools: { listChanged: true } } */\n  capabilities?: ServerCapabilities;\n  /** Free-text instructions surfaced to clients during initialize. */\n  instructions?: string;\n};\n\nexport type Transport = {\n  /** Called by the server when it has a message to deliver to the client. */\n  send: (message: JsonRpcMessage) => void;\n  /** Called by the server when it's torn down so the transport can clean up. */\n  close?: () => void;\n};\n\n/**\n * MicroMcpServer — protocol-level MCP server, transport-agnostic.\n *\n * Use it like:\n *\n *   const server = new MicroMcpServer({ info: { name: \"session\", version: \"0.1\" } });\n *   server.registerTool({ name: \"...\", inputSchema: { type: \"object\" } }, async (args) => ({...}));\n *   const transport = new InProcessTransport();\n *   server.attach(transport);\n *   transport.deliver({ ... }); // client → server frames\n *\n * The same server can serve multiple transports (e.g. an in-process agent\n * AND a relayed external client) by attaching each one.\n */\nexport class MicroMcpServer {\n  private tools = new Map<string, RegisteredTool>();\n  private transports = new Set<Transport>();\n  private notifyListChangedScheduled = false;\n\n  readonly info: ServerInfo;\n  readonly capabilities: ServerCapabilities;\n  readonly instructions?: string;\n\n  constructor(options: McpServerOptions) {\n    this.info = options.info;\n    this.capabilities = options.capabilities ?? { tools: { listChanged: true } };\n    this.instructions = options.instructions;\n  }\n\n  attach(transport: Transport): () => void {\n    this.transports.add(transport);\n    return () => this.detach(transport);\n  }\n\n  detach(transport: Transport): void {\n    if (this.transports.delete(transport)) {\n      transport.close?.();\n    }\n  }\n\n  registerTool(definition: ToolDefinition, handler: ToolHandler): () => void {\n    this.tools.set(definition.name, { definition, handler });\n    this.scheduleListChangedNotification();\n    return () => this.unregisterTool(definition.name);\n  }\n\n  unregisterTool(name: string): void {\n    if (this.tools.delete(name)) {\n      this.scheduleListChangedNotification();\n    }\n  }\n\n  listTools(): ToolDefinition[] {\n    return Array.from(this.tools.values()).map((t) => t.definition);\n  }\n\n  /**\n   * Receive a JSON-RPC frame from a client (called by the transport).\n   * The transport is responsible for sending the response back.\n   */\n  async receive(transport: Transport, message: JsonRpcMessage): Promise<void> {\n    if (!(\"method\" in message)) return; // It's a response, not a request — ignore.\n\n    const isNotification = !(\"id\" in message);\n    if (isNotification) {\n      // Notifications are fire-and-forget. We ignore unknown methods.\n      return;\n    }\n\n    const request = message as JsonRpcRequest;\n    try {\n      const result = await this.handle(request);\n      transport.send({ jsonrpc: \"2.0\", id: request.id, result });\n    } catch (err) {\n      transport.send({\n        jsonrpc: \"2.0\",\n        id: request.id,\n        error: this.toRpcError(err),\n      });\n    }\n  }\n\n  private async handle(request: JsonRpcRequest): Promise<any> {\n    const { method, params } = request;\n    switch (method) {\n      case \"initialize\":\n        return {\n          protocolVersion: MCP_PROTOCOL_VERSION,\n          capabilities: this.capabilities,\n          serverInfo: this.info,\n          ...(this.instructions ? { instructions: this.instructions } : {}),\n        };\n\n      case \"tools/list\":\n        return { tools: this.listTools() };\n\n      case \"tools/call\": {\n        const name = params?.name;\n        const args = (params?.arguments ?? {}) as JsonObject;\n        if (typeof name !== \"string\") {\n          throw rpcError(JSONRPC_INVALID_PARAMS, \"tools/call requires `name`\");\n        }\n        const tool = this.tools.get(name);\n        if (!tool) {\n          throw rpcError(JSONRPC_METHOD_NOT_FOUND, `Unknown tool: ${name}`);\n        }\n        const result = await tool.handler(args);\n        return result satisfies CallToolResult;\n      }\n\n      case \"ping\":\n        return {};\n\n      default:\n        throw rpcError(JSONRPC_METHOD_NOT_FOUND, `Unsupported method: ${method}`);\n    }\n  }\n\n  private scheduleListChangedNotification(): void {\n    if (this.notifyListChangedScheduled) return;\n    this.notifyListChangedScheduled = true;\n    queueMicrotask(() => {\n      this.notifyListChangedScheduled = false;\n      this.broadcast({ jsonrpc: \"2.0\", method: \"notifications/tools/list_changed\" });\n    });\n  }\n\n  private broadcast(message: JsonRpcMessage): void {\n    for (const t of this.transports) t.send(message);\n  }\n\n  private toRpcError(err: unknown): { code: number; message: string; data?: any } {\n    if (err && typeof err === \"object\" && \"code\" in err && \"message\" in err) {\n      return err as any;\n    }\n    return {\n      code: JSONRPC_INTERNAL_ERROR,\n      message: err instanceof Error ? err.message : String(err),\n    };\n  }\n}\n\nexport function rpcError(code: number, message: string, data?: any) {\n  return { code, message, ...(data !== undefined ? { data } : {}) };\n}\n\n/**\n * Helper to build a CallToolResult from a string or structured value.\n */\nexport function textResult(text: string, structured?: any): CallToolResult {\n  return {\n    content: [{ type: \"text\", text }],\n    ...(structured !== undefined ? { structuredContent: structured } : {}),\n  };\n}\n\nexport function errorResult(text: string): CallToolResult {\n  return { content: [{ type: \"text\", text }], isError: true };\n}\n\n// Internal helper so the JsonRpcId import isn't dropped by tsup\ntype _KeepIdImport = JsonRpcId;\n","import { textResult, errorResult } from \"../mcp/server\";\nimport type { MicroMcpServer } from \"../mcp/server\";\nimport { readHistory, redoOne, undoOne } from \"./undo-stack\";\n\nexport type UndoToolsOptions = {\n  /** Default agent id when the caller doesn't pass one. */\n  defaultAgentId?: string;\n};\n\n/**\n * Idempotent tracker so multiple bridges on the same server only register\n * agent_undo / agent_redo / agent_history once.\n */\nconst installedServers = new WeakSet<MicroMcpServer>();\n\n/**\n * ensureUndoToolsRegistered — bridges call this on construction. Safe to\n * call repeatedly with the same server; subsequent calls are no-ops.\n */\nexport function ensureUndoToolsRegistered(server: MicroMcpServer, options: UndoToolsOptions = {}): void {\n  if (installedServers.has(server)) return;\n  installedServers.add(server);\n  registerUndoTools(server, options);\n}\n\n/**\n * registerUndoTools — add agent_undo / agent_redo / agent_history to the\n * server. Returns a disposer that unregisters all three.\n */\nexport function registerUndoTools(server: MicroMcpServer, options: UndoToolsOptions = {}): () => void {\n  const defaultAgent = options.defaultAgentId ?? \"agent\";\n  const disposers: Array<() => void> = [];\n  const agentOf = (args: any): string =>\n    typeof args?.agentId === \"string\" ? args.agentId : defaultAgent;\n\n  disposers.push(\n    server.registerTool(\n      {\n        name: \"agent_undo\",\n        description: \"Undo the most recent action on the agent's stack. Optional agentId targets a specific agent.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const entry = await undoOne(agentOf(args));\n        if (!entry) return errorResult(\"Nothing to undo.\");\n        return textResult(`Undid: ${entry.label}`, { entry: serialize(entry) });\n      },\n    ),\n  );\n\n  disposers.push(\n    server.registerTool(\n      {\n        name: \"agent_redo\",\n        description: \"Redo the most recently undone action.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const entry = await redoOne(agentOf(args));\n        if (!entry) return errorResult(\"Nothing to redo.\");\n        return textResult(`Redid: ${entry.label}`, { entry: serialize(entry) });\n      },\n    ),\n  );\n\n  disposers.push(\n    server.registerTool(\n      {\n        name: \"agent_history\",\n        description: \"List the agent's undo stack (oldest first). Useful for understanding what's reversible.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const history = readHistory(agentOf(args)).map(serialize);\n        const text = history.map((e) => `${new Date(e.timestamp).toISOString()} ${e.bridgeId} ${e.action}: ${e.label}`).join(\"\\n\");\n        return textResult(text || \"(empty)\", history);\n      },\n    ),\n  );\n\n  return () => disposers.forEach((d) => d());\n}\n\nfunction serialize(entry: import(\"./undo-stack\").UndoEntry) {\n  return {\n    timestamp: entry.timestamp,\n    bridgeId: entry.bridgeId,\n    action: entry.action,\n    label: entry.label,\n  };\n}\n","import { useState, useEffect, useCallback } from \"react\";\nimport { readHistory } from \"./undo-stack\";\n\n/**\n * useUndoStack — minimal React snapshot of an agent's history. Polls every\n * `intervalMs` (default 500). Use this to render an inline \"agent timeline\"\n * in a sidebar or activity panel. No subscription model in v1 — keeping it\n * simple; bridge mutations are infrequent enough that polling is fine.\n */\nexport function useUndoStack(agentId: string, intervalMs = 500) {\n  const [history, setHistory] = useState(() => readHistory(agentId));\n\n  useEffect(() => {\n    let cancelled = false;\n    const tick = () => {\n      if (cancelled) return;\n      setHistory(readHistory(agentId));\n    };\n    const id = setInterval(tick, intervalMs);\n    tick();\n    return () => { cancelled = true; clearInterval(id); };\n  }, [agentId, intervalMs]);\n\n  const refresh = useCallback(() => setHistory(readHistory(agentId)), [agentId]);\n  return { history, refresh };\n}\n"]}
+{"version":3,"sources":["../src/undo/undo-stack.ts","../src/mcp/server.ts","../src/undo/undo-tools.ts","../src/undo/use-undo-stack.ts"],"names":["useState","useEffect","useCallback"],"mappings":"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","file":"undo.cjs","sourcesContent":["/**\n * Generic undo/redo stack keyed by `agentId`. Each entry holds:\n *  - `do` — re-applies the action (for redo)\n *  - `undo` — reverses it\n *  - `label` — human-readable summary surfaced in agent_history\n *\n * Bridges register entries by calling `pushUndoEntry` after a successful\n * mutation. The corresponding MCP tools (`agent_undo`, `agent_redo`,\n * `agent_history`) are registered once per server via `registerUndoTools`.\n *\n * Stacks are per-agent so multiple agents can rewind independently.\n */\n\nexport type UndoEntry = {\n  /** Wall-clock ms. */\n  timestamp: number;\n  /** Bridge id (e.g. \"whiteboard\", \"form:signup\"). */\n  bridgeId: string;\n  /** Tool name that produced the entry. */\n  action: string;\n  /** Short human label, e.g. `Added sticky n_abc`. */\n  label: string;\n  /** Reverse the action. */\n  undo: () => void | Promise<void>;\n  /** Re-apply the action (used when redoing after an undo). */\n  redo: () => void | Promise<void>;\n};\n\ntype Stack = { past: UndoEntry[]; future: UndoEntry[] };\n\nconst stacks = new Map<string, Stack>();\nconst CAP = 200;\n\nfunction getStack(agentId: string): Stack {\n  let s = stacks.get(agentId);\n  if (!s) {\n    s = { past: [], future: [] };\n    stacks.set(agentId, s);\n  }\n  return s;\n}\n\n/** Push a new undo entry on the agent's stack. Clears the redo (future) stack. */\nexport function pushUndoEntry(agentId: string, entry: UndoEntry): void {\n  const s = getStack(agentId);\n  s.past.push(entry);\n  if (s.past.length > CAP) s.past.splice(0, s.past.length - CAP);\n  s.future.length = 0;\n}\n\n/** Pop and undo the most recent entry. Returns the entry that ran, or null. */\nexport async function undoOne(agentId: string): Promise<UndoEntry | null> {\n  const s = getStack(agentId);\n  const entry = s.past.pop();\n  if (!entry) return null;\n  await entry.undo();\n  s.future.push(entry);\n  return entry;\n}\n\n/** Re-apply the most recently undone entry. Returns it, or null if no future. */\nexport async function redoOne(agentId: string): Promise<UndoEntry | null> {\n  const s = getStack(agentId);\n  const entry = s.future.pop();\n  if (!entry) return null;\n  await entry.redo();\n  s.past.push(entry);\n  return entry;\n}\n\n/** Read the past stack (oldest first). */\nexport function readHistory(agentId: string): UndoEntry[] {\n  return getStack(agentId).past.slice();\n}\n\n/** Wipe an agent's stacks. */\nexport function clearStack(agentId: string): void {\n  stacks.delete(agentId);\n}\n\n/** Test/teardown helper. */\nexport function resetAllUndoStacks(): void {\n  stacks.clear();\n}\n","import {\n  type CallToolResult,\n  type JsonObject,\n  type JsonRpcMessage,\n  type JsonRpcRequest,\n  type JsonRpcId,\n  type RegisteredTool,\n  type ServerCapabilities,\n  type ServerInfo,\n  type ToolDefinition,\n  type ToolHandler,\n  JSONRPC_INTERNAL_ERROR,\n  JSONRPC_INVALID_PARAMS,\n  JSONRPC_METHOD_NOT_FOUND,\n  MCP_PROTOCOL_VERSION,\n} from \"./types\";\nimport { ToolRegistry } from \"./tool-host\";\n\nexport type McpServerOptions = {\n  info: ServerInfo;\n  /** Defaults to { tools: { listChanged: true } } */\n  capabilities?: ServerCapabilities;\n  /** Free-text instructions surfaced to clients during initialize. */\n  instructions?: string;\n};\n\nexport type Transport = {\n  /** Called by the server when it has a message to deliver to the client. */\n  send: (message: JsonRpcMessage) => void;\n  /** Called by the server when it's torn down so the transport can clean up. */\n  close?: () => void;\n};\n\n/**\n * MicroMcpServer — protocol-level MCP server, transport-agnostic.\n *\n * Use it like:\n *\n *   const server = new MicroMcpServer({ info: { name: \"session\", version: \"0.1\" } });\n *   server.registerTool({ name: \"...\", inputSchema: { type: \"object\" } }, async (args) => ({...}));\n *   const transport = new InProcessTransport();\n *   server.attach(transport);\n *   transport.deliver({ ... }); // client → server frames\n *\n * The same server can serve multiple transports (e.g. an in-process agent\n * AND a relayed external client) by attaching each one.\n */\nexport class MicroMcpServer extends ToolRegistry {\n  private transports = new Set<Transport>();\n  private notifyListChangedScheduled = false;\n\n  readonly info: ServerInfo;\n  readonly capabilities: ServerCapabilities;\n  readonly instructions?: string;\n\n  constructor(options: McpServerOptions) {\n    super();\n    this.info = options.info;\n    this.capabilities = options.capabilities ?? { tools: { listChanged: true } };\n    this.instructions = options.instructions;\n  }\n\n  attach(transport: Transport): () => void {\n    this.transports.add(transport);\n    return () => this.detach(transport);\n  }\n\n  detach(transport: Transport): void {\n    if (this.transports.delete(transport)) {\n      transport.close?.();\n    }\n  }\n\n  unregisterTool(name: string): void {\n    if (this.tools.delete(name)) {\n      this.scheduleListChangedNotification();\n    }\n  }\n\n  protected onToolsChanged(): void {\n    this.scheduleListChangedNotification();\n  }\n\n  /**\n   * Receive a JSON-RPC frame from a client (called by the transport).\n   * The transport is responsible for sending the response back.\n   */\n  async receive(transport: Transport, message: JsonRpcMessage): Promise<void> {\n    if (!(\"method\" in message)) return; // It's a response, not a request — ignore.\n\n    const isNotification = !(\"id\" in message);\n    if (isNotification) {\n      // Notifications are fire-and-forget. We ignore unknown methods.\n      return;\n    }\n\n    const request = message as JsonRpcRequest;\n    try {\n      const result = await this.handle(request);\n      transport.send({ jsonrpc: \"2.0\", id: request.id, result });\n    } catch (err) {\n      transport.send({\n        jsonrpc: \"2.0\",\n        id: request.id,\n        error: this.toRpcError(err),\n      });\n    }\n  }\n\n  private async handle(request: JsonRpcRequest): Promise<any> {\n    const { method, params } = request;\n    switch (method) {\n      case \"initialize\":\n        return {\n          protocolVersion: MCP_PROTOCOL_VERSION,\n          capabilities: this.capabilities,\n          serverInfo: this.info,\n          ...(this.instructions ? { instructions: this.instructions } : {}),\n        };\n\n      case \"tools/list\":\n        return { tools: this.listTools() };\n\n      case \"tools/call\": {\n        const name = params?.name;\n        const args = (params?.arguments ?? {}) as JsonObject;\n        if (typeof name !== \"string\") {\n          throw rpcError(JSONRPC_INVALID_PARAMS, \"tools/call requires `name`\");\n        }\n        const tool = this.tools.get(name);\n        if (!tool) {\n          throw rpcError(JSONRPC_METHOD_NOT_FOUND, `Unknown tool: ${name}`);\n        }\n        const result = await tool.handler(args);\n        return result satisfies CallToolResult;\n      }\n\n      case \"ping\":\n        return {};\n\n      default:\n        throw rpcError(JSONRPC_METHOD_NOT_FOUND, `Unsupported method: ${method}`);\n    }\n  }\n\n  private scheduleListChangedNotification(): void {\n    if (this.notifyListChangedScheduled) return;\n    this.notifyListChangedScheduled = true;\n    queueMicrotask(() => {\n      this.notifyListChangedScheduled = false;\n      this.broadcast({ jsonrpc: \"2.0\", method: \"notifications/tools/list_changed\" });\n    });\n  }\n\n  private broadcast(message: JsonRpcMessage): void {\n    for (const t of this.transports) t.send(message);\n  }\n\n  private toRpcError(err: unknown): { code: number; message: string; data?: any } {\n    if (err && typeof err === \"object\" && \"code\" in err && \"message\" in err) {\n      return err as any;\n    }\n    return {\n      code: JSONRPC_INTERNAL_ERROR,\n      message: err instanceof Error ? err.message : String(err),\n    };\n  }\n}\n\nexport function rpcError(code: number, message: string, data?: any) {\n  return { code, message, ...(data !== undefined ? { data } : {}) };\n}\n\n/**\n * Helper to build a CallToolResult from a string or structured value.\n */\nexport function textResult(text: string, structured?: any): CallToolResult {\n  return {\n    content: [{ type: \"text\", text }],\n    ...(structured !== undefined ? { structuredContent: structured } : {}),\n  };\n}\n\nexport function errorResult(text: string): CallToolResult {\n  return { content: [{ type: \"text\", text }], isError: true };\n}\n\n// Internal helper so the JsonRpcId import isn't dropped by tsup\ntype _KeepIdImport = JsonRpcId;\n","import { textResult, errorResult } from \"../mcp/server\";\nimport type { ToolHost } from \"../mcp/tool-host\";\nimport { readHistory, redoOne, undoOne } from \"./undo-stack\";\n\nexport type UndoToolsOptions = {\n  /** Default agent id when the caller doesn't pass one. */\n  defaultAgentId?: string;\n};\n\n/**\n * Idempotent tracker so multiple bridges on the same server only register\n * agent_undo / agent_redo / agent_history once.\n */\nconst installedHosts = new WeakSet<ToolHost>();\n\n/**\n * ensureUndoToolsRegistered — bridges call this on construction. Safe to\n * call repeatedly with the same server; subsequent calls are no-ops.\n */\nexport function ensureUndoToolsRegistered(host: ToolHost, options: UndoToolsOptions = {}): void {\n  if (installedHosts.has(host)) return;\n  installedHosts.add(host);\n  registerUndoTools(host, options);\n}\n\n/**\n * registerUndoTools — add agent_undo / agent_redo / agent_history to the\n * server. Returns a disposer that unregisters all three.\n */\nexport function registerUndoTools(host: ToolHost, options: UndoToolsOptions = {}): () => void {\n  const defaultAgent = options.defaultAgentId ?? \"agent\";\n  const disposers: Array<() => void> = [];\n  const agentOf = (args: any): string =>\n    typeof args?.agentId === \"string\" ? args.agentId : defaultAgent;\n\n  disposers.push(\n    host.registerTool(\n      {\n        name: \"agent_undo\",\n        description: \"Undo the most recent action on the agent's stack. Optional agentId targets a specific agent.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const entry = await undoOne(agentOf(args));\n        if (!entry) return errorResult(\"Nothing to undo.\");\n        return textResult(`Undid: ${entry.label}`, { entry: serialize(entry) });\n      },\n    ),\n  );\n\n  disposers.push(\n    host.registerTool(\n      {\n        name: \"agent_redo\",\n        description: \"Redo the most recently undone action.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const entry = await redoOne(agentOf(args));\n        if (!entry) return errorResult(\"Nothing to redo.\");\n        return textResult(`Redid: ${entry.label}`, { entry: serialize(entry) });\n      },\n    ),\n  );\n\n  disposers.push(\n    host.registerTool(\n      {\n        name: \"agent_history\",\n        description: \"List the agent's undo stack (oldest first). Useful for understanding what's reversible.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const history = readHistory(agentOf(args)).map(serialize);\n        const text = history.map((e) => `${new Date(e.timestamp).toISOString()} ${e.bridgeId} ${e.action}: ${e.label}`).join(\"\\n\");\n        return textResult(text || \"(empty)\", history);\n      },\n    ),\n  );\n\n  return () => disposers.forEach((d) => d());\n}\n\nfunction serialize(entry: import(\"./undo-stack\").UndoEntry) {\n  return {\n    timestamp: entry.timestamp,\n    bridgeId: entry.bridgeId,\n    action: entry.action,\n    label: entry.label,\n  };\n}\n","import { useState, useEffect, useCallback } from \"react\";\nimport { readHistory } from \"./undo-stack\";\n\n/**\n * useUndoStack — minimal React snapshot of an agent's history. Polls every\n * `intervalMs` (default 500). Use this to render an inline \"agent timeline\"\n * in a sidebar or activity panel. No subscription model in v1 — keeping it\n * simple; bridge mutations are infrequent enough that polling is fine.\n */\nexport function useUndoStack(agentId: string, intervalMs = 500) {\n  const [history, setHistory] = useState(() => readHistory(agentId));\n\n  useEffect(() => {\n    let cancelled = false;\n    const tick = () => {\n      if (cancelled) return;\n      setHistory(readHistory(agentId));\n    };\n    const id = setInterval(tick, intervalMs);\n    tick();\n    return () => { cancelled = true; clearInterval(id); };\n  }, [agentId, intervalMs]);\n\n  const refresh = useCallback(() => setHistory(readHistory(agentId)), [agentId]);\n  return { history, refresh };\n}\n"]}

package/dist/undo.js

@@ -1,5 +1,5 @@
-export { useUndoStack } from './chunk-DJOWMF6Q.js';
-export { clearStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne } from './chunk-ACBENYYO.js';
-import './chunk-QGCF7YKW.js';
+export { useUndoStack } from './chunk-RGO42EQ6.js';
+export { clearStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne } from './chunk-GQ7XXK7G.js';
+import './chunk-4KAIV6OD.js';
 //# sourceMappingURL=undo.js.map
 //# sourceMappingURL=undo.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/agent-integrations",
-  "version": "0.3.4",
+  "version": "0.5.0",
   "description": "MCP-driven agent presence in collab sessions: per-session micro-MCP server, pluggable bridges to fancy-* packages, and agent UX components (panel + on-canvas cursor).",
   "repository": {
     "type": "git",
@@ -18,12 +18,60 @@
       "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" }
     },
     "./mcp": {
-      "import": { "types": "./dist/mcp.d.ts", "default": "./dist/mcp.js" },
-      "require": { "types": "./dist/mcp.d.cts", "default": "./dist/mcp.cjs" }
+      "import": { "types": "./dist/mcp/index.d.ts", "default": "./dist/mcp.js" },
+      "require": { "types": "./dist/mcp/index.d.cts", "default": "./dist/mcp.cjs" }
     },
     "./bridges/whiteboard": {
-      "import": { "types": "./dist/bridges-whiteboard.d.ts", "default": "./dist/bridges-whiteboard.js" },
-      "require": { "types": "./dist/bridges-whiteboard.d.cts", "default": "./dist/bridges-whiteboard.cjs" }
+      "import": { "types": "./dist/bridges/whiteboard.d.ts", "default": "./dist/bridges-whiteboard.js" },
+      "require": { "types": "./dist/bridges/whiteboard.d.cts", "default": "./dist/bridges-whiteboard.cjs" }
+    },
+    "./bridges/flow": {
+      "import": { "types": "./dist/bridges/flow.d.ts", "default": "./dist/bridges-flow.js" },
+      "require": { "types": "./dist/bridges/flow.d.cts", "default": "./dist/bridges-flow.cjs" }
+    },
+    "./bridges/forms": {
+      "import": { "types": "./dist/bridges/forms.d.ts", "default": "./dist/bridges-forms.js" },
+      "require": { "types": "./dist/bridges/forms.d.cts", "default": "./dist/bridges-forms.cjs" }
+    },
+    "./bridges/sheets": {
+      "import": { "types": "./dist/bridges/sheets.d.ts", "default": "./dist/bridges-sheets.js" },
+      "require": { "types": "./dist/bridges/sheets.d.cts", "default": "./dist/bridges-sheets.cjs" }
+    },
+    "./bridges/code": {
+      "import": { "types": "./dist/bridges/code.d.ts", "default": "./dist/bridges-code.js" },
+      "require": { "types": "./dist/bridges/code.d.cts", "default": "./dist/bridges-code.cjs" }
+    },
+    "./bridges/charts": {
+      "import": { "types": "./dist/bridges/charts.d.ts", "default": "./dist/bridges-charts.js" },
+      "require": { "types": "./dist/bridges/charts.d.cts", "default": "./dist/bridges-charts.cjs" }
+    },
+    "./bridges/scene": {
+      "import": { "types": "./dist/bridges/scene.d.ts", "default": "./dist/bridges-scene.js" },
+      "require": { "types": "./dist/bridges/scene.d.cts", "default": "./dist/bridges-scene.cjs" }
+    },
+    "./bridges/screens": {
+      "import": { "types": "./dist/bridges/screens.d.ts", "default": "./dist/bridges-screens.js" },
+      "require": { "types": "./dist/bridges/screens.d.cts", "default": "./dist/bridges-screens.cjs" }
+    },
+    "./sheets-adapter": {
+      "import": { "types": "./dist/sheets-adapter.d.ts", "default": "./dist/sheets-adapter.js" },
+      "require": { "types": "./dist/sheets-adapter.d.cts", "default": "./dist/sheets-adapter.cjs" }
+    },
+    "./components/shared-whiteboard": {
+      "import": { "types": "./dist/components/SharedWhiteboard/index.d.ts", "default": "./dist/components-shared-whiteboard.js" },
+      "require": { "types": "./dist/components/SharedWhiteboard/index.d.cts", "default": "./dist/components-shared-whiteboard.cjs" }
+    },
+    "./presence": {
+      "import": { "types": "./dist/presence/index.d.ts", "default": "./dist/presence.js" },
+      "require": { "types": "./dist/presence/index.d.cts", "default": "./dist/presence.cjs" }
+    },
+    "./undo": {
+      "import": { "types": "./dist/undo/index.d.ts", "default": "./dist/undo.js" },
+      "require": { "types": "./dist/undo/index.d.cts", "default": "./dist/undo.cjs" }
+    },
+    "./sharing": {
+      "import": { "types": "./dist/sharing/index.d.ts", "default": "./dist/sharing.js" },
+      "require": { "types": "./dist/sharing/index.d.cts", "default": "./dist/sharing.cjs" }
     },
     "./styles.css": "./dist/styles.css"
   },
@@ -40,11 +88,13 @@
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "@particle-academy/fancy-whiteboard": "^0.1.0",
-    "@particle-academy/fancy-flow": "^0.2.0"
+    "@particle-academy/fancy-flow": "^0.2.0",
+    "@particle-academy/fancy-sheets": "^0.1.0"
   },
   "peerDependenciesMeta": {
     "@particle-academy/fancy-whiteboard": { "optional": true },
-    "@particle-academy/fancy-flow": { "optional": true }
+    "@particle-academy/fancy-flow": { "optional": true },
+    "@particle-academy/fancy-sheets": { "optional": true }
   },
   "devDependencies": {
     "@particle-academy/fancy-whiteboard": "^0.1.5",

package/dist/chunk-4IAVAFUV.js

@@ -1,342 +0,0 @@
-import { wrapToolWithActivity } from './chunk-52S7XYZK.js';
-import { errorResult, textResult } from './chunk-QGCF7YKW.js';
-
-// src/bridges/flow.ts
-var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
-var num = (v, fallback) => typeof v === "number" && Number.isFinite(v) ? v : 0;
-var str = (v, fallback = "") => typeof v === "string" ? v : fallback;
-var newId = (prefix) => `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 7)}`;
-function registerFlowBridge(server, options) {
-  const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
-  const disposers = [];
-  const flTarget = (args, result) => ({
-    kind: "flow",
-    elementId: result?.structuredContent?.id ?? args?.id
-  });
-  const reg = (name, description, properties, required, handler, resolveTarget) => {
-    const wrapped = async (args) => {
-      try {
-        return await handler(args);
-      } catch (e) {
-        return errorResult(e instanceof Error ? e.message : String(e));
-      }
-    };
-    const final = resolveTarget ? wrapToolWithActivity(wrapped, {
-      toolName: name,
-      agent: { id: agent.id, name: agent.name, color: agent.color },
-      kind: "flow",
-      resolveTarget: ({ args, result }) => resolveTarget(args, result)
-    }) : wrapped;
-    disposers.push(
-      server.registerTool(
-        {
-          name,
-          description,
-          inputSchema: { type: "object", properties, required, additionalProperties: false }
-        },
-        final
-      )
-    );
-  };
-  reg("flow_get_state", "Get the full graph: nodes + edges.", {}, [], () => {
-    const state = { nodes: adapter.getNodes(), edges: adapter.getEdges() };
-    return textResult(JSON.stringify(state, null, 2), state);
-  });
-  reg("flow_list_nodes", "Summarise every node: id, kind, label, position, status.", {}, [], () => {
-    const items = adapter.getNodes().map((n) => ({
-      id: n.id,
-      kind: n.type,
-      label: n.data?.label,
-      x: Math.round(n.position.x),
-      y: Math.round(n.position.y),
-      status: n.data?.status ?? "idle"
-    }));
-    const text = items.map((i) => `${i.kind} ${i.id}: "${i.label}" @(${i.x},${i.y}) [${i.status}]`).join("\n") || "(empty graph)";
-    return textResult(text, items);
-  });
-  reg(
-    "flow_get_node",
-    "Get a single node's full record by id.",
-    { id: { type: "string" } },
-    ["id"],
-    (args) => {
-      const id = str(args.id);
-      const node = adapter.getNodes().find((n) => n.id === id);
-      if (!node) return errorResult(`No node with id ${id}`);
-      return textResult(JSON.stringify(node, null, 2), node);
-    }
-  );
-  reg(
-    "flow_list_node_kinds",
-    "List every node kind registered in fancy-flow's registry. Use this to discover what's authorable before adding nodes.",
-    { category: { type: "string", description: "Optional category filter: trigger | logic | data | ai | io | human | output | custom." } },
-    [],
-    async () => {
-      try {
-        const { listNodeKinds } = await import('@particle-academy/fancy-flow');
-        const cat = adapter ? void 0 : void 0;
-        const all = (cat ? listNodeKinds(cat) : listNodeKinds()).map((k) => ({
-          name: k.name,
-          category: k.category,
-          label: k.label,
-          description: k.description,
-          icon: k.icon,
-          accent: k.accent,
-          inputs: k.inputs ?? [],
-          outputs: k.outputs ?? [],
-          configFields: (k.configSchema ?? []).map((f) => ({ key: f.key, type: f.type, label: f.label, required: !!f.required }))
-        }));
-        const text = all.map((k) => `${k.category}/${k.name}: ${k.label}${k.description ? " \u2014 " + k.description : ""}`).join("\n");
-        return textResult(text || "(no kinds registered)", all);
-      } catch (e) {
-        return errorResult(`fancy-flow registry not available: ${e instanceof Error ? e.message : String(e)}`);
-      }
-    }
-  );
-  reg(
-    "flow_get_node_schema",
-    "Get the full configSchema + ports for a node kind. Use to know exactly what fields a kind accepts before calling flow_add_node.",
-    { name: { type: "string" } },
-    ["name"],
-    async (args) => {
-      try {
-        const { getNodeKind } = await import('@particle-academy/fancy-flow');
-        const k = getNodeKind(str(args.name));
-        if (!k) return errorResult(`No kind registered: ${args.name}`);
-        const summary = {
-          name: k.name,
-          category: k.category,
-          label: k.label,
-          description: k.description,
-          inputs: k.inputs ?? [],
-          outputs: k.outputs ?? [],
-          configSchema: k.configSchema ?? [],
-          defaultConfig: k.defaultConfig ?? null
-        };
-        return textResult(JSON.stringify(summary, null, 2), summary);
-      } catch (e) {
-        return errorResult(`fancy-flow registry not available: ${e instanceof Error ? e.message : String(e)}`);
-      }
-    }
-  );
-  reg("flow_list_edges", "Summarise every edge.", {}, [], () => {
-    const items = adapter.getEdges().map((e) => ({
-      id: e.id,
-      from: `${e.source}${e.sourceHandle ? `:${e.sourceHandle}` : ""}`,
-      to: `${e.target}${e.targetHandle ? `:${e.targetHandle}` : ""}`
-    }));
-    return textResult(items.map((i) => `${i.id}: ${i.from} \u2192 ${i.to}`).join("\n") || "(no edges)", items);
-  });
-  reg(
-    "flow_add_node",
-    "Add a node of any kind registered in fancy-flow's registry. Call flow_list_node_kinds first to discover what's available.",
-    {
-      kind: { type: "string", description: "Registry kind name (e.g. memory_store, llm_call, branch)." },
-      label: { type: "string" },
-      x: { type: "number" },
-      y: { type: "number" },
-      description: { type: "string" },
-      config: { type: "object", description: "Config fields per the kind's configSchema." },
-      body: { type: "string", description: "Note kinds only \u2014 body text." }
-    },
-    ["kind", "label", "x", "y"],
-    async (args) => {
-      const kindName = str(args.kind);
-      let kindDef = null;
-      try {
-        const { getNodeKind, defaultConfigFor } = await import('@particle-academy/fancy-flow');
-        kindDef = getNodeKind(kindName);
-        var defaults = kindDef ? defaultConfigFor(kindDef) : {};
-      } catch {
-        var defaults = {};
-      }
-      const isLegacy = ["trigger", "action", "decision", "output", "note", "subgraph"].includes(kindName);
-      if (!kindDef && !isLegacy) {
-        return errorResult(`Unknown kind: ${kindName} \u2014 call flow_list_node_kinds for the registry.`);
-      }
-      const id = newId("n");
-      const config = { ...defaults, ...args.config && typeof args.config === "object" ? args.config : {} };
-      const node = {
-        id,
-        type: kindName,
-        position: { x: num(args.x), y: num(args.y) },
-        data: {
-          kind: kindName,
-          label: str(args.label),
-          ...args.description ? { description: str(args.description) } : {},
-          config,
-          ...kindName === "note" && args.body ? { body: str(args.body) } : {}
-        }
-      };
-      adapter.setNodes((all) => [...all, node]);
-      return textResult(`Added ${kindName} ${id} ("${str(args.label)}")`, node);
-    },
-    flTarget
-  );
-  reg(
-    "flow_update_node",
-    "Update fields on a node. Only provided fields change.",
-    {
-      id: { type: "string" },
-      label: { type: "string" },
-      x: { type: "number" },
-      y: { type: "number" },
-      description: { type: "string" },
-      config: { type: "object" }
-    },
-    ["id"],
-    (args) => {
-      const id = str(args.id);
-      let updated = null;
-      adapter.setNodes(
-        (all) => all.map((n) => {
-          if (n.id !== id) return n;
-          updated = {
-            ...n,
-            position: {
-              x: args.x !== void 0 ? num(args.x) : n.position.x,
-              y: args.y !== void 0 ? num(args.y) : n.position.y
-            },
-            data: {
-              ...n.data,
-              ...args.label !== void 0 ? { label: str(args.label) } : {},
-              ...args.description !== void 0 ? { description: str(args.description) } : {},
-              ...args.config && typeof args.config === "object" ? { config: { ...n.data.config ?? {}, ...args.config } } : {}
-            }
-          };
-          return updated;
-        })
-      );
-      if (!updated) return errorResult(`No node with id ${id}`);
-      return textResult(`Updated node ${id}`, updated);
-    },
-    flTarget
-  );
-  reg(
-    "flow_delete_node",
-    "Remove a node by id (also removes any connected edges).",
-    { id: { type: "string" } },
-    ["id"],
-    (args) => {
-      const id = str(args.id);
-      if (!adapter.getNodes().some((n) => n.id === id)) {
-        return errorResult(`No node with id ${id}`);
-      }
-      adapter.setNodes((all) => all.filter((n) => n.id !== id));
-      adapter.setEdges((all) => all.filter((e) => e.source !== id && e.target !== id));
-      return textResult(`Deleted node ${id}`);
-    },
-    flTarget
-  );
-  reg(
-    "flow_connect",
-    "Create an edge between two nodes (optionally specifying handle ids).",
-    {
-      source: { type: "string" },
-      target: { type: "string" },
-      sourceHandle: { type: "string" },
-      targetHandle: { type: "string" },
-      label: { type: "string" }
-    },
-    ["source", "target"],
-    (args) => {
-      const source = str(args.source);
-      const target = str(args.target);
-      const all = adapter.getNodes();
-      if (!all.find((n) => n.id === source)) return errorResult(`No source node ${source}`);
-      if (!all.find((n) => n.id === target)) return errorResult(`No target node ${target}`);
-      const edge = {
-        id: newId("e"),
-        source,
-        target,
-        ...args.sourceHandle ? { sourceHandle: str(args.sourceHandle) } : {},
-        ...args.targetHandle ? { targetHandle: str(args.targetHandle) } : {},
-        ...args.label ? { label: str(args.label) } : {}
-      };
-      adapter.setEdges((existing) => [...existing, edge]);
-      return textResult(`Connected ${source}${edge.sourceHandle ? `:${edge.sourceHandle}` : ""} \u2192 ${target}${edge.targetHandle ? `:${edge.targetHandle}` : ""}`, edge);
-    },
-    flTarget
-  );
-  reg(
-    "flow_disconnect",
-    "Remove an edge by id.",
-    { id: { type: "string" } },
-    ["id"],
-    (args) => {
-      const id = str(args.id);
-      if (!adapter.getEdges().some((e) => e.id === id)) {
-        return errorResult(`No edge ${id}`);
-      }
-      adapter.setEdges((all) => all.filter((e) => e.id !== id));
-      return textResult(`Disconnected ${id}`);
-    },
-    flTarget
-  );
-  reg(
-    "flow_set_node_status",
-    "Manually set a node's status badge (idle | queued | running | done | error) and optional text. Useful for narration outside a run.",
-    {
-      id: { type: "string" },
-      status: { type: "string", enum: ["idle", "queued", "running", "done", "error"] },
-      text: { type: "string" }
-    },
-    ["id", "status"],
-    (args) => {
-      const id = str(args.id);
-      const status = str(args.status);
-      const text = args.text !== void 0 ? str(args.text) : void 0;
-      if (adapter.setNodeStatus) {
-        adapter.setNodeStatus(id, status, text);
-      } else {
-        let found = false;
-        adapter.setNodes(
-          (all) => all.map((n) => {
-            if (n.id !== id) return n;
-            found = true;
-            return { ...n, data: { ...n.data, status, statusText: text } };
-          })
-        );
-        if (!found) return errorResult(`No node with id ${id}`);
-      }
-      return textResult(`${id} \u2192 ${status}${text ? ` (${text})` : ""}`);
-    },
-    flTarget
-  );
-  reg(
-    "flow_run",
-    "Trigger a run of the current graph. Returns the topological result. Requires the host to have wired `run` into the adapter.",
-    {},
-    [],
-    async () => {
-      if (!adapter.run) return errorResult("Host did not provide a run handler.");
-      const result = await adapter.run();
-      return textResult(result.ok ? "Run complete" : `Run failed: ${result.error ?? "unknown"}`, result);
-    },
-    flTarget
-  );
-  reg(
-    "flow_cancel",
-    "Cancel an in-flight run.",
-    {},
-    [],
-    () => {
-      if (!adapter.cancel) return errorResult("Host did not provide a cancel handler.");
-      adapter.cancel();
-      return textResult("Run cancelled");
-    },
-    flTarget
-  );
-  return {
-    id: "flow",
-    title: "Flow",
-    dispose: () => {
-      for (const d of disposers) d();
-    }
-  };
-}
-
-export { registerFlowBridge };
-//# sourceMappingURL=chunk-4IAVAFUV.js.map
-//# sourceMappingURL=chunk-4IAVAFUV.js.map