@particle-academy/agent-integrations 0.6.1 → 0.6.3

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { M as MicroMcpServer } from './server-BsSwfemr.cjs';
-export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-BsSwfemr.cjs';
-export { T as ToolHost, a as ToolRegistry } from './tool-host-BQuUygLF.cjs';
+import { a as MicroMcpServer } from './server-C2OpfPEo.cjs';
+export { M as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-C2OpfPEo.cjs';
+export { T as ToolHost, a as ToolRegistry } from './tool-host-CX3WFXgh.cjs';
 export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.cjs';
-export { C as CallToolResult, d as ContentBlock, I as InitializeResult, c as JsonObject, J as JsonRpcMessage, e as JsonRpcNotification, f as JsonRpcRequest, g as JsonValue, M as MCP_PROTOCOL_VERSION, a as ServerCapabilities, S as ServerInfo, T as ToolDefinition, b as ToolHandler } from './types-aOQLTW0E.cjs';
-export { B as Bridge, a as BridgeFactory } from './types-CCSBGW9T.cjs';
+export { C as CallToolResult, a as ContentBlock, I as InitializeResult, f as JsonObject, i as JsonRpcMessage, j as JsonRpcNotification, k as JsonRpcRequest, m as JsonValue, M as MCP_PROTOCOL_VERSION, S as ServerCapabilities, n as ServerInfo, T as ToolDefinition, o as ToolHandler } from './types-C2zdUpzn.cjs';
+export { B as Bridge, a as BridgeFactory } from './types-Cq5u8MJ8.cjs';
 import { FormFieldDescriptor } from './bridges/forms.cjs';
 export { FormBridgeAdapter, FormBridgeOptions, registerFormBridge } from './bridges/forms.cjs';
 export { SheetsBridgeAdapter, SheetsBridgeOptions, registerSheetsBridge } from './bridges/sheets.cjs';
@@ -12,13 +12,15 @@ export { CodeBridgeAdapter, CodeBridgeOptions, registerCodeBridge } from './brid
 export { ChartsBridgeAdapter, ChartsBridgeOptions, registerChartsBridge } from './bridges/charts.cjs';
 export { SceneBridgeAdapter, SceneBridgeOptions, SceneCamera, SceneObject, SceneObjectKind, SceneState, registerSceneBridge } from './bridges/scene.cjs';
 export { ScreenSnapshot, ScreensBridgeAdapter, ScreensBridgeOptions, registerScreensBridge } from './bridges/screens.cjs';
+export { SlidesBridgeAdapter, SlidesBridgeOptions, registerSlidesBridge } from './bridges/slides.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, CSSProperties } from 'react';
-import { S as SessionDescriptor } from './token-CrJF76oH.cjs';
-export { b as buildShareConfig, a as buildShareUrl, c as createSessionDescriptor, d as describeSession, r as readSessionFromUrl } from './token-CrJF76oH.cjs';
+import { S as SessionDescriptor } from './token-C1O22GxJ.cjs';
+export { b as buildShareConfig, a as buildShareUrl, d as createSessionDescriptor, e as describeSession, r as readSessionFromUrl } from './token-C1O22GxJ.cjs';
 export { ActivityAgent, ActivityFilter, ActivityResolverContext, ActivityTargetResolver, ToolHandler as ActivityWrappedHandler, AgentActivityEvent, AgentActivityListener, AgentTarget, AgentTargetKind, emitActivity, onActivity, readActivityHistory, resetActivityRegistry, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity } from './presence/index.cjs';
 export { UndoEntry, UndoToolsOptions, clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne, useUndoStack } from './undo/index.cjs';
 export { RelayState, SseRelayOptions, SseRelayTransport, attachSseRelay } from './sharing/index.cjs';
+import '@particle-academy/fancy-slides';
 
 type AgentActivity = {
     id: string;

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { M as MicroMcpServer } from './server-Du3-IGqM.js';
-export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-Du3-IGqM.js';
-export { T as ToolHost, a as ToolRegistry } from './tool-host-C8JMMGYq.js';
+import { a as MicroMcpServer } from './server-CKAqFTyc.js';
+export { M as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-CKAqFTyc.js';
+export { T as ToolHost, a as ToolRegistry } from './tool-host-DldwGNqR.js';
 export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.js';
-export { C as CallToolResult, d as ContentBlock, I as InitializeResult, c as JsonObject, J as JsonRpcMessage, e as JsonRpcNotification, f as JsonRpcRequest, g as JsonValue, M as MCP_PROTOCOL_VERSION, a as ServerCapabilities, S as ServerInfo, T as ToolDefinition, b as ToolHandler } from './types-aOQLTW0E.js';
-export { B as Bridge, a as BridgeFactory } from './types-DIVNcIQO.js';
+export { C as CallToolResult, a as ContentBlock, I as InitializeResult, f as JsonObject, i as JsonRpcMessage, j as JsonRpcNotification, k as JsonRpcRequest, m as JsonValue, M as MCP_PROTOCOL_VERSION, S as ServerCapabilities, n as ServerInfo, T as ToolDefinition, o as ToolHandler } from './types-C2zdUpzn.js';
+export { B as Bridge, a as BridgeFactory } from './types-DyaHnqNC.js';
 import { FormFieldDescriptor } from './bridges/forms.js';
 export { FormBridgeAdapter, FormBridgeOptions, registerFormBridge } from './bridges/forms.js';
 export { SheetsBridgeAdapter, SheetsBridgeOptions, registerSheetsBridge } from './bridges/sheets.js';
@@ -12,13 +12,15 @@ export { CodeBridgeAdapter, CodeBridgeOptions, registerCodeBridge } from './brid
 export { ChartsBridgeAdapter, ChartsBridgeOptions, registerChartsBridge } from './bridges/charts.js';
 export { SceneBridgeAdapter, SceneBridgeOptions, SceneCamera, SceneObject, SceneObjectKind, SceneState, registerSceneBridge } from './bridges/scene.js';
 export { ScreenSnapshot, ScreensBridgeAdapter, ScreensBridgeOptions, registerScreensBridge } from './bridges/screens.js';
+export { SlidesBridgeAdapter, SlidesBridgeOptions, registerSlidesBridge } from './bridges/slides.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, CSSProperties } from 'react';
-import { S as SessionDescriptor } from './token-CrJF76oH.js';
-export { b as buildShareConfig, a as buildShareUrl, c as createSessionDescriptor, d as describeSession, r as readSessionFromUrl } from './token-CrJF76oH.js';
+import { S as SessionDescriptor } from './token-C1O22GxJ.js';
+export { b as buildShareConfig, a as buildShareUrl, d as createSessionDescriptor, e as describeSession, r as readSessionFromUrl } from './token-C1O22GxJ.js';
 export { ActivityAgent, ActivityFilter, ActivityResolverContext, ActivityTargetResolver, ToolHandler as ActivityWrappedHandler, AgentActivityEvent, AgentActivityListener, AgentTarget, AgentTargetKind, emitActivity, onActivity, readActivityHistory, resetActivityRegistry, useAgentActivity, useAgentActivityForScreen, wrapToolWithActivity } from './presence/index.js';
 export { UndoEntry, UndoToolsOptions, clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne, useUndoStack } from './undo/index.js';
 export { RelayState, SseRelayOptions, SseRelayTransport, attachSseRelay } from './sharing/index.js';
+import '@particle-academy/fancy-slides';
 
 type AgentActivity = {
     id: string;

package/dist/index.js

@@ -1,5 +1,6 @@
 export { registerSceneBridge } from './chunk-XRAJSOPS.js';
 export { registerScreensBridge } from './chunk-57ZDHD53.js';
+export { registerSlidesBridge } from './chunk-NE3GIGQD.js';
 export { useSheetsActivityHighlights, useSheetsAdapter } from './chunk-5XELJIJR.js';
 export { AgentActivityHighlight, AgentCursor, AgentPanel, ShareControls } from './chunk-ZHAK2DQR.js';
 import './chunk-IJ6JX5VC.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/BridgedForm/BridgedForm.tsx","../src/components/ScreensActivityBridge/ScreensActivityBridge.tsx"],"names":["useEffect"],"mappings":"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","file":"index.js","sourcesContent":["import { type ReactNode, useEffect, useMemo, useRef } from \"react\";\nimport type { MicroMcpServer } from \"../../mcp/server\";\nimport { registerFormBridge, type FormBridgeAdapter, type FormFieldDescriptor } from \"../../bridges/forms\";\n\nexport type BridgedFormProps = {\n  /** Stable id for this form. Used by agents in `form_*` tool calls. */\n  id: string;\n  /** Human title (also surfaced as the bridge title). */\n  title?: string;\n  /** Optional fancy-screens screen id this form lives in. */\n  screenId?: string;\n  /** Field descriptors — drives the agent-facing schema. */\n  fields: FormFieldDescriptor[];\n  /** Controlled values. */\n  values: Record<string, unknown>;\n  /** Setter — hosts pass their setState. */\n  onChange: (next: Record<string, unknown>) => void;\n  /** Optional submit handler. */\n  onSubmit?: () => Promise<{ ok: boolean; values?: Record<string, unknown>; error?: string }>;\n  /** The MicroMcpServer the bridge registers against. Pass null/undefined\n   *  to render without a bridge (useful for stories / non-shared use). */\n  server?: MicroMcpServer | null;\n  /** Identity used in activity events. */\n  agent?: { id: string; name?: string; color?: string };\n  children: ReactNode;\n};\n\n/**\n * BridgedForm — wraps a react-fancy form (or any controlled inputs)\n * with a `registerFormBridge` lifecycle. Children render the actual form\n * using `values` + `onChange`; this component only manages the bridge.\n *\n * Hosts use it like:\n *\n *   <BridgedForm id=\"signup\" fields={...} values={values} onChange={setValues} server={server}>\n *     <Field><Input value={values.email} onValueChange={(v) => onChange({ ...values, email: v })} /></Field>\n *     ...\n *   </BridgedForm>\n *\n * Agents can then call form_describe, form_set_value, form_submit, etc.\n */\nexport function BridgedForm({\n  id,\n  title,\n  screenId,\n  fields,\n  values,\n  onChange,\n  onSubmit,\n  server,\n  agent,\n  children,\n}: BridgedFormProps) {\n  // Refs so the adapter sees fresh values without re-installing the bridge.\n  const valuesRef = useRef(values);\n  const onChangeRef = useRef(onChange);\n  const fieldsRef = useRef(fields);\n  const submitRef = useRef(onSubmit);\n  useEffect(() => { valuesRef.current = values; }, [values]);\n  useEffect(() => { onChangeRef.current = onChange; }, [onChange]);\n  useEffect(() => { fieldsRef.current = fields; }, [fields]);\n  useEffect(() => { submitRef.current = onSubmit; }, [onSubmit]);\n\n  const focusElement = (name: string) => {\n    if (typeof document === \"undefined\") return;\n    const el = document.querySelector(`[data-form-id=\"${id}\"] [name=\"${name}\"]`) as HTMLElement | null;\n    el?.focus();\n  };\n\n  const adapter = useMemo<FormBridgeAdapter>(() => ({\n    id,\n    title,\n    screenId,\n    getFields: () => fieldsRef.current,\n    getValue: (name) => valuesRef.current[name],\n    getValues: () => ({ ...valuesRef.current }),\n    setValue: (name, v) => onChangeRef.current({ ...valuesRef.current, [name]: v }),\n    setValues: (next) => onChangeRef.current({ ...valuesRef.current, ...next }),\n    focus: focusElement,\n    submit: async () => {\n      if (!submitRef.current) {\n        return { ok: true, values: { ...valuesRef.current } };\n      }\n      return submitRef.current();\n    },\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }), [id, title, screenId]);\n\n  useEffect(() => {\n    if (!server) return;\n    const bridge = registerFormBridge(server, { adapter, agent });\n    return () => bridge.dispose();\n  }, [server, adapter, agent]);\n\n  return <div data-form-id={id}>{children}</div>;\n}\n","import { useEffect } from \"react\";\nimport { onActivity } from \"../../presence/registry\";\n\n/**\n * Loose shape of the fancy-screens system context — kept here so this\n * component doesn't hard-import `@particle-academy/fancy-screens`.\n */\ntype ScreenSystemLike = {\n  registry: Map<string, { id: string; agentActivity?: unknown }>;\n  updateScreen: (id: string, patch: { agentActivity?: unknown }) => void;\n};\n\nexport type ScreensActivityBridgeProps = {\n  /** The value returned by `useScreenSystem()` from fancy-screens. */\n  system: ScreenSystemLike;\n  /** ms to wait after the last activity before clearing the screen's badge. Default 1500. */\n  fadeMs?: number;\n};\n\n/**\n * ScreensActivityBridge — subscribe to the in-process activity registry\n * and patch each event into the matching screen's `agentActivity` field.\n * Fade-out clears the badge after `fadeMs`.\n *\n * Use it once near the root of your app, ABOVE every <Screen>:\n *\n *   const system = useScreenSystem();\n *   <>\n *     <ScreensActivityBridge system={system} />\n *     <Screen id=\"dashboard\">…</Screen>\n *     <Screen id=\"form\">…</Screen>\n *   </>\n *\n * Renders nothing; pure side-effect component.\n */\nexport function ScreensActivityBridge({ system, fadeMs = 1500 }: ScreensActivityBridgeProps) {\n  useEffect(() => {\n    const fadeTimers = new Map<string, ReturnType<typeof setTimeout>>();\n    const off = onActivity((event) => {\n      const screenId = event.target.screenId;\n      if (!screenId) return;\n      // Only patch screens that are currently registered.\n      if (!system.registry.has(screenId)) return;\n      const activity = {\n        agentId: event.agentId,\n        agentName: event.agentName,\n        agentColor: event.agentColor,\n        action: event.action,\n        timestamp: event.timestamp,\n        elementId: event.target.elementId,\n        label: event.target.label,\n      };\n      system.updateScreen(screenId, { agentActivity: activity });\n      const prev = fadeTimers.get(screenId);\n      if (prev) clearTimeout(prev);\n      fadeTimers.set(\n        screenId,\n        setTimeout(() => {\n          system.updateScreen(screenId, { agentActivity: null });\n          fadeTimers.delete(screenId);\n        }, event.ttlMs ?? fadeMs),\n      );\n    });\n    return () => {\n      off();\n      for (const t of fadeTimers.values()) clearTimeout(t);\n    };\n  }, [system, fadeMs]);\n  return null;\n}\n"]}
+{"version":3,"sources":["../src/components/BridgedForm/BridgedForm.tsx","../src/components/ScreensActivityBridge/ScreensActivityBridge.tsx"],"names":["useEffect"],"mappings":"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","file":"index.js","sourcesContent":["import { type ReactNode, useEffect, useMemo, useRef } from \"react\";\nimport type { MicroMcpServer } from \"../../mcp/server\";\nimport { registerFormBridge, type FormBridgeAdapter, type FormFieldDescriptor } from \"../../bridges/forms\";\n\nexport type BridgedFormProps = {\n  /** Stable id for this form. Used by agents in `form_*` tool calls. */\n  id: string;\n  /** Human title (also surfaced as the bridge title). */\n  title?: string;\n  /** Optional fancy-screens screen id this form lives in. */\n  screenId?: string;\n  /** Field descriptors — drives the agent-facing schema. */\n  fields: FormFieldDescriptor[];\n  /** Controlled values. */\n  values: Record<string, unknown>;\n  /** Setter — hosts pass their setState. */\n  onChange: (next: Record<string, unknown>) => void;\n  /** Optional submit handler. */\n  onSubmit?: () => Promise<{ ok: boolean; values?: Record<string, unknown>; error?: string }>;\n  /** The MicroMcpServer the bridge registers against. Pass null/undefined\n   *  to render without a bridge (useful for stories / non-shared use). */\n  server?: MicroMcpServer | null;\n  /** Identity used in activity events. */\n  agent?: { id: string; name?: string; color?: string };\n  children: ReactNode;\n};\n\n/**\n * BridgedForm — wraps a react-fancy form (or any controlled inputs)\n * with a `registerFormBridge` lifecycle. Children render the actual form\n * using `values` + `onChange`; this component only manages the bridge.\n *\n * Hosts use it like:\n *\n *   <BridgedForm id=\"signup\" fields={...} values={values} onChange={setValues} server={server}>\n *     <Field><Input value={values.email} onValueChange={(v) => onChange({ ...values, email: v })} /></Field>\n *     ...\n *   </BridgedForm>\n *\n * Agents can then call form_describe, form_set_value, form_submit, etc.\n */\nexport function BridgedForm({\n  id,\n  title,\n  screenId,\n  fields,\n  values,\n  onChange,\n  onSubmit,\n  server,\n  agent,\n  children,\n}: BridgedFormProps) {\n  // Refs so the adapter sees fresh values without re-installing the bridge.\n  const valuesRef = useRef(values);\n  const onChangeRef = useRef(onChange);\n  const fieldsRef = useRef(fields);\n  const submitRef = useRef(onSubmit);\n  useEffect(() => { valuesRef.current = values; }, [values]);\n  useEffect(() => { onChangeRef.current = onChange; }, [onChange]);\n  useEffect(() => { fieldsRef.current = fields; }, [fields]);\n  useEffect(() => { submitRef.current = onSubmit; }, [onSubmit]);\n\n  const focusElement = (name: string) => {\n    if (typeof document === \"undefined\") return;\n    const el = document.querySelector(`[data-form-id=\"${id}\"] [name=\"${name}\"]`) as HTMLElement | null;\n    el?.focus();\n  };\n\n  const adapter = useMemo<FormBridgeAdapter>(() => ({\n    id,\n    title,\n    screenId,\n    getFields: () => fieldsRef.current,\n    getValue: (name) => valuesRef.current[name],\n    getValues: () => ({ ...valuesRef.current }),\n    setValue: (name, v) => onChangeRef.current({ ...valuesRef.current, [name]: v }),\n    setValues: (next) => onChangeRef.current({ ...valuesRef.current, ...next }),\n    focus: focusElement,\n    submit: async () => {\n      if (!submitRef.current) {\n        return { ok: true, values: { ...valuesRef.current } };\n      }\n      return submitRef.current();\n    },\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }), [id, title, screenId]);\n\n  useEffect(() => {\n    if (!server) return;\n    const bridge = registerFormBridge(server, { adapter, agent });\n    return () => bridge.dispose();\n  }, [server, adapter, agent]);\n\n  return <div data-form-id={id}>{children}</div>;\n}\n","import { useEffect } from \"react\";\nimport { onActivity } from \"../../presence/registry\";\n\n/**\n * Loose shape of the fancy-screens system context — kept here so this\n * component doesn't hard-import `@particle-academy/fancy-screens`.\n */\ntype ScreenSystemLike = {\n  registry: Map<string, { id: string; agentActivity?: unknown }>;\n  updateScreen: (id: string, patch: { agentActivity?: unknown }) => void;\n};\n\nexport type ScreensActivityBridgeProps = {\n  /** The value returned by `useScreenSystem()` from fancy-screens. */\n  system: ScreenSystemLike;\n  /** ms to wait after the last activity before clearing the screen's badge. Default 1500. */\n  fadeMs?: number;\n};\n\n/**\n * ScreensActivityBridge — subscribe to the in-process activity registry\n * and patch each event into the matching screen's `agentActivity` field.\n * Fade-out clears the badge after `fadeMs`.\n *\n * Use it once near the root of your app, ABOVE every <Screen>:\n *\n *   const system = useScreenSystem();\n *   <>\n *     <ScreensActivityBridge system={system} />\n *     <Screen id=\"dashboard\">…</Screen>\n *     <Screen id=\"form\">…</Screen>\n *   </>\n *\n * Renders nothing; pure side-effect component.\n */\nexport function ScreensActivityBridge({ system, fadeMs = 1500 }: ScreensActivityBridgeProps) {\n  useEffect(() => {\n    const fadeTimers = new Map<string, ReturnType<typeof setTimeout>>();\n    const off = onActivity((event) => {\n      const screenId = event.target.screenId;\n      if (!screenId) return;\n      // Only patch screens that are currently registered.\n      if (!system.registry.has(screenId)) return;\n      const activity = {\n        agentId: event.agentId,\n        agentName: event.agentName,\n        agentColor: event.agentColor,\n        action: event.action,\n        timestamp: event.timestamp,\n        elementId: event.target.elementId,\n        label: event.target.label,\n      };\n      system.updateScreen(screenId, { agentActivity: activity });\n      const prev = fadeTimers.get(screenId);\n      if (prev) clearTimeout(prev);\n      fadeTimers.set(\n        screenId,\n        setTimeout(() => {\n          system.updateScreen(screenId, { agentActivity: null });\n          fadeTimers.delete(screenId);\n        }, event.ttlMs ?? fadeMs),\n      );\n    });\n    return () => {\n      off();\n      for (const t of fadeTimers.values()) clearTimeout(t);\n    };\n  }, [system, fadeMs]);\n  return null;\n}\n"]}

package/dist/mcp/index.d.cts

@@ -1,8 +1,8 @@
-import { T as Transport, M as MicroMcpServer } from '../server-BsSwfemr.cjs';
-export { a as McpServerOptions, e as errorResult, r as rpcError, t as textResult } from '../server-BsSwfemr.cjs';
-import { J as JsonRpcMessage } from '../types-aOQLTW0E.cjs';
-export { C as CallToolResult, d as ContentBlock, I as InitializeResult, h as JSONRPC_INTERNAL_ERROR, i as JSONRPC_INVALID_PARAMS, j as JSONRPC_INVALID_REQUEST, k as JSONRPC_METHOD_NOT_FOUND, l as JSONRPC_PARSE_ERROR, c as JsonObject, m as JsonRpcError, n as JsonRpcId, e as JsonRpcNotification, f as JsonRpcRequest, o as JsonRpcSuccess, g as JsonValue, M as MCP_PROTOCOL_VERSION, R as RegisteredTool, a as ServerCapabilities, S as ServerInfo, T as ToolDefinition, b as ToolHandler, p as ToolInputSchema } from '../types-aOQLTW0E.cjs';
-import '../tool-host-BQuUygLF.cjs';
+import { T as Transport, a as MicroMcpServer } from '../server-C2OpfPEo.cjs';
+export { M as McpServerOptions, e as errorResult, r as rpcError, t as textResult } from '../server-C2OpfPEo.cjs';
+import { i as JsonRpcMessage } from '../types-C2zdUpzn.cjs';
+export { C as CallToolResult, a as ContentBlock, I as InitializeResult, J as JSONRPC_INTERNAL_ERROR, b as JSONRPC_INVALID_PARAMS, c as JSONRPC_INVALID_REQUEST, d as JSONRPC_METHOD_NOT_FOUND, e as JSONRPC_PARSE_ERROR, f as JsonObject, g as JsonRpcError, h as JsonRpcId, j as JsonRpcNotification, k as JsonRpcRequest, l as JsonRpcSuccess, m as JsonValue, M as MCP_PROTOCOL_VERSION, R as RegisteredTool, S as ServerCapabilities, n as ServerInfo, T as ToolDefinition, o as ToolHandler, p as ToolInputSchema } from '../types-C2zdUpzn.cjs';
+import '../tool-host-CX3WFXgh.cjs';
 
 /**
  * InProcessTransport — direct function-call wiring between an in-page MCP

package/dist/mcp/index.d.ts

@@ -1,8 +1,8 @@
-import { T as Transport, M as MicroMcpServer } from '../server-Du3-IGqM.js';
-export { a as McpServerOptions, e as errorResult, r as rpcError, t as textResult } from '../server-Du3-IGqM.js';
-import { J as JsonRpcMessage } from '../types-aOQLTW0E.js';
-export { C as CallToolResult, d as ContentBlock, I as InitializeResult, h as JSONRPC_INTERNAL_ERROR, i as JSONRPC_INVALID_PARAMS, j as JSONRPC_INVALID_REQUEST, k as JSONRPC_METHOD_NOT_FOUND, l as JSONRPC_PARSE_ERROR, c as JsonObject, m as JsonRpcError, n as JsonRpcId, e as JsonRpcNotification, f as JsonRpcRequest, o as JsonRpcSuccess, g as JsonValue, M as MCP_PROTOCOL_VERSION, R as RegisteredTool, a as ServerCapabilities, S as ServerInfo, T as ToolDefinition, b as ToolHandler, p as ToolInputSchema } from '../types-aOQLTW0E.js';
-import '../tool-host-C8JMMGYq.js';
+import { T as Transport, a as MicroMcpServer } from '../server-CKAqFTyc.js';
+export { M as McpServerOptions, e as errorResult, r as rpcError, t as textResult } from '../server-CKAqFTyc.js';
+import { i as JsonRpcMessage } from '../types-C2zdUpzn.js';
+export { C as CallToolResult, a as ContentBlock, I as InitializeResult, J as JSONRPC_INTERNAL_ERROR, b as JSONRPC_INVALID_PARAMS, c as JSONRPC_INVALID_REQUEST, d as JSONRPC_METHOD_NOT_FOUND, e as JSONRPC_PARSE_ERROR, f as JsonObject, g as JsonRpcError, h as JsonRpcId, j as JsonRpcNotification, k as JsonRpcRequest, l as JsonRpcSuccess, m as JsonValue, M as MCP_PROTOCOL_VERSION, R as RegisteredTool, S as ServerCapabilities, n as ServerInfo, T as ToolDefinition, o as ToolHandler, p as ToolInputSchema } from '../types-C2zdUpzn.js';
+import '../tool-host-DldwGNqR.js';
 
 /**
  * InProcessTransport — direct function-call wiring between an in-page MCP

package/dist/presence/index.d.cts

@@ -1,4 +1,4 @@
-import { C as CallToolResult } from '../types-aOQLTW0E.cjs';
+import { C as CallToolResult } from '../types-C2zdUpzn.cjs';
 
 /**
  * Presence layer types — describe what the agent is doing right now and

package/dist/presence/index.d.ts

@@ -1,4 +1,4 @@
-import { C as CallToolResult } from '../types-aOQLTW0E.js';
+import { C as CallToolResult } from '../types-C2zdUpzn.js';
 
 /**
  * Presence layer types — describe what the agent is doing right now and

package/dist/{server-BsSwfemr.d.cts → server-C2OpfPEo.d.cts}

@@ -1,5 +1,5 @@
-import { S as ServerInfo, a as ServerCapabilities, J as JsonRpcMessage, C as CallToolResult } from './types-aOQLTW0E.cjs';
-import { a as ToolRegistry } from './tool-host-BQuUygLF.cjs';
+import { n as ServerInfo, S as ServerCapabilities, i as JsonRpcMessage, C as CallToolResult } from './types-C2zdUpzn.cjs';
+import { a as ToolRegistry } from './tool-host-CX3WFXgh.cjs';
 
 type McpServerOptions = {
     info: ServerInfo;
@@ -60,4 +60,4 @@ declare function rpcError(code: number, message: string, data?: any): {
 declare function textResult(text: string, structured?: any): CallToolResult;
 declare function errorResult(text: string): CallToolResult;
 
-export { MicroMcpServer as M, type Transport as T, type McpServerOptions as a, errorResult as e, rpcError as r, textResult as t };
+export { type McpServerOptions as M, type Transport as T, MicroMcpServer as a, errorResult as e, rpcError as r, textResult as t };

package/dist/{server-Du3-IGqM.d.ts → server-CKAqFTyc.d.ts}

@@ -1,5 +1,5 @@
-import { S as ServerInfo, a as ServerCapabilities, J as JsonRpcMessage, C as CallToolResult } from './types-aOQLTW0E.js';
-import { a as ToolRegistry } from './tool-host-C8JMMGYq.js';
+import { n as ServerInfo, S as ServerCapabilities, i as JsonRpcMessage, C as CallToolResult } from './types-C2zdUpzn.js';
+import { a as ToolRegistry } from './tool-host-DldwGNqR.js';
 
 type McpServerOptions = {
     info: ServerInfo;
@@ -60,4 +60,4 @@ declare function rpcError(code: number, message: string, data?: any): {
 declare function textResult(text: string, structured?: any): CallToolResult;
 declare function errorResult(text: string): CallToolResult;
 
-export { MicroMcpServer as M, type Transport as T, type McpServerOptions as a, errorResult as e, rpcError as r, textResult as t };
+export { type McpServerOptions as M, type Transport as T, MicroMcpServer as a, errorResult as e, rpcError as r, textResult as t };

package/dist/sharing/index.d.cts

@@ -1,7 +1,7 @@
-export { S as SessionDescriptor, b as buildShareConfig, a as buildShareUrl, e as constantTimeEqual, c as createSessionDescriptor, d as describeSession, r as readSessionFromUrl } from '../token-CrJF76oH.cjs';
-import { J as JsonRpcMessage } from '../types-aOQLTW0E.cjs';
-import { T as Transport, M as MicroMcpServer } from '../server-BsSwfemr.cjs';
-import '../tool-host-BQuUygLF.cjs';
+export { S as SessionDescriptor, b as buildShareConfig, a as buildShareUrl, c as constantTimeEqual, d as createSessionDescriptor, e as describeSession, r as readSessionFromUrl } from '../token-C1O22GxJ.cjs';
+import { i as JsonRpcMessage } from '../types-C2zdUpzn.cjs';
+import { T as Transport, a as MicroMcpServer } from '../server-C2OpfPEo.cjs';
+import '../tool-host-CX3WFXgh.cjs';
 
 /**
  * SseRelayTransport — bridges the in-page MicroMcpServer to a host-app

package/dist/sharing/index.d.ts

@@ -1,7 +1,7 @@
-export { S as SessionDescriptor, b as buildShareConfig, a as buildShareUrl, e as constantTimeEqual, c as createSessionDescriptor, d as describeSession, r as readSessionFromUrl } from '../token-CrJF76oH.js';
-import { J as JsonRpcMessage } from '../types-aOQLTW0E.js';
-import { T as Transport, M as MicroMcpServer } from '../server-Du3-IGqM.js';
-import '../tool-host-C8JMMGYq.js';
+export { S as SessionDescriptor, b as buildShareConfig, a as buildShareUrl, c as constantTimeEqual, d as createSessionDescriptor, e as describeSession, r as readSessionFromUrl } from '../token-C1O22GxJ.js';
+import { i as JsonRpcMessage } from '../types-C2zdUpzn.js';
+import { T as Transport, a as MicroMcpServer } from '../server-CKAqFTyc.js';
+import '../tool-host-DldwGNqR.js';
 
 /**
  * SseRelayTransport — bridges the in-page MicroMcpServer to a host-app

package/dist/sheets-adapter.d.cts

@@ -1,7 +1,7 @@
 import { SheetsBridgeAdapter } from './bridges/sheets.cjs';
-import './tool-host-BQuUygLF.cjs';
-import './types-aOQLTW0E.cjs';
-import './types-CCSBGW9T.cjs';
+import './tool-host-CX3WFXgh.cjs';
+import './types-C2zdUpzn.cjs';
+import './types-Cq5u8MJ8.cjs';
 
 /**
  * Shared-session helpers for `@particle-academy/fancy-sheets`.

package/dist/sheets-adapter.d.ts

@@ -1,7 +1,7 @@
 import { SheetsBridgeAdapter } from './bridges/sheets.js';
-import './tool-host-C8JMMGYq.js';
-import './types-aOQLTW0E.js';
-import './types-DIVNcIQO.js';
+import './tool-host-DldwGNqR.js';
+import './types-C2zdUpzn.js';
+import './types-DyaHnqNC.js';
 
 /**
  * Shared-session helpers for `@particle-academy/fancy-sheets`.

package/dist/{token-CrJF76oH.d.cts → token-C1O22GxJ.d.cts}

@@ -31,4 +31,4 @@ declare function readSessionFromUrl(): SessionDescriptor | null;
 /** Constant-time string compare so a mismatched token leaks no timing info. */
 declare function constantTimeEqual(a: string, b: string): boolean;
 
-export { type SessionDescriptor as S, buildShareUrl as a, buildShareConfig as b, createSessionDescriptor as c, describeSession as d, constantTimeEqual as e, readSessionFromUrl as r };
+export { type SessionDescriptor as S, buildShareUrl as a, buildShareConfig as b, constantTimeEqual as c, createSessionDescriptor as d, describeSession as e, readSessionFromUrl as r };

package/dist/{token-CrJF76oH.d.ts → token-C1O22GxJ.d.ts}

@@ -31,4 +31,4 @@ declare function readSessionFromUrl(): SessionDescriptor | null;
 /** Constant-time string compare so a mismatched token leaks no timing info. */
 declare function constantTimeEqual(a: string, b: string): boolean;
 
-export { type SessionDescriptor as S, buildShareUrl as a, buildShareConfig as b, createSessionDescriptor as c, describeSession as d, constantTimeEqual as e, readSessionFromUrl as r };
+export { type SessionDescriptor as S, buildShareUrl as a, buildShareConfig as b, constantTimeEqual as c, createSessionDescriptor as d, describeSession as e, readSessionFromUrl as r };

package/dist/{tool-host-BQuUygLF.d.cts → tool-host-CX3WFXgh.d.cts}

@@ -1,4 +1,4 @@
-import { T as ToolDefinition, b as ToolHandler, R as RegisteredTool, c as JsonObject, C as CallToolResult } from './types-aOQLTW0E.cjs';
+import { T as ToolDefinition, o as ToolHandler, R as RegisteredTool, f as JsonObject, C as CallToolResult } from './types-C2zdUpzn.cjs';
 
 /**
  * ToolHost — the minimal surface a bridge needs to register its tools.

package/dist/{tool-host-C8JMMGYq.d.ts → tool-host-DldwGNqR.d.ts}

@@ -1,4 +1,4 @@
-import { T as ToolDefinition, b as ToolHandler, R as RegisteredTool, c as JsonObject, C as CallToolResult } from './types-aOQLTW0E.js';
+import { T as ToolDefinition, o as ToolHandler, R as RegisteredTool, f as JsonObject, C as CallToolResult } from './types-C2zdUpzn.js';
 
 /**
  * ToolHost — the minimal surface a bridge needs to register its tools.

package/dist/{types-aOQLTW0E.d.cts → types-C2zdUpzn.d.cts}

@@ -109,4 +109,4 @@ type RegisteredTool = {
 };
 declare const MCP_PROTOCOL_VERSION = "2025-06-18";
 
-export { type CallToolResult as C, type InitializeResult as I, type JsonRpcMessage as J, MCP_PROTOCOL_VERSION as M, type RegisteredTool as R, type ServerInfo as S, type ToolDefinition as T, type ServerCapabilities as a, type ToolHandler as b, type JsonObject as c, type ContentBlock as d, type JsonRpcNotification as e, type JsonRpcRequest as f, type JsonValue as g, JSONRPC_INTERNAL_ERROR as h, JSONRPC_INVALID_PARAMS as i, JSONRPC_INVALID_REQUEST as j, JSONRPC_METHOD_NOT_FOUND as k, JSONRPC_PARSE_ERROR as l, type JsonRpcError as m, type JsonRpcId as n, type JsonRpcSuccess as o, type ToolInputSchema as p };
+export { type CallToolResult as C, type InitializeResult as I, JSONRPC_INTERNAL_ERROR as J, MCP_PROTOCOL_VERSION as M, type RegisteredTool as R, type ServerCapabilities as S, type ToolDefinition as T, type ContentBlock as a, JSONRPC_INVALID_PARAMS as b, JSONRPC_INVALID_REQUEST as c, JSONRPC_METHOD_NOT_FOUND as d, JSONRPC_PARSE_ERROR as e, type JsonObject as f, type JsonRpcError as g, type JsonRpcId as h, type JsonRpcMessage as i, type JsonRpcNotification as j, type JsonRpcRequest as k, type JsonRpcSuccess as l, type JsonValue as m, type ServerInfo as n, type ToolHandler as o, type ToolInputSchema as p };

package/dist/{types-aOQLTW0E.d.ts → types-C2zdUpzn.d.ts}

@@ -109,4 +109,4 @@ type RegisteredTool = {
 };
 declare const MCP_PROTOCOL_VERSION = "2025-06-18";
 
-export { type CallToolResult as C, type InitializeResult as I, type JsonRpcMessage as J, MCP_PROTOCOL_VERSION as M, type RegisteredTool as R, type ServerInfo as S, type ToolDefinition as T, type ServerCapabilities as a, type ToolHandler as b, type JsonObject as c, type ContentBlock as d, type JsonRpcNotification as e, type JsonRpcRequest as f, type JsonValue as g, JSONRPC_INTERNAL_ERROR as h, JSONRPC_INVALID_PARAMS as i, JSONRPC_INVALID_REQUEST as j, JSONRPC_METHOD_NOT_FOUND as k, JSONRPC_PARSE_ERROR as l, type JsonRpcError as m, type JsonRpcId as n, type JsonRpcSuccess as o, type ToolInputSchema as p };
+export { type CallToolResult as C, type InitializeResult as I, JSONRPC_INTERNAL_ERROR as J, MCP_PROTOCOL_VERSION as M, type RegisteredTool as R, type ServerCapabilities as S, type ToolDefinition as T, type ContentBlock as a, JSONRPC_INVALID_PARAMS as b, JSONRPC_INVALID_REQUEST as c, JSONRPC_METHOD_NOT_FOUND as d, JSONRPC_PARSE_ERROR as e, type JsonObject as f, type JsonRpcError as g, type JsonRpcId as h, type JsonRpcMessage as i, type JsonRpcNotification as j, type JsonRpcRequest as k, type JsonRpcSuccess as l, type JsonValue as m, type ServerInfo as n, type ToolHandler as o, type ToolInputSchema as p };

package/dist/{types-CCSBGW9T.d.cts → types-Cq5u8MJ8.d.cts}

@@ -1,4 +1,4 @@
-import { T as ToolHost } from './tool-host-BQuUygLF.cjs';
+import { T as ToolHost } from './tool-host-CX3WFXgh.cjs';
 
 /**
  * Bridge — registers a cohesive set of MCP tools/resources for a single

package/dist/{types-DIVNcIQO.d.ts → types-DyaHnqNC.d.ts}

@@ -1,4 +1,4 @@
-import { T as ToolHost } from './tool-host-C8JMMGYq.js';
+import { T as ToolHost } from './tool-host-DldwGNqR.js';
 
 /**
  * Bridge — registers a cohesive set of MCP tools/resources for a single

package/dist/undo/index.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import '../types-C2zdUpzn.cjs';
 
 /**
  * Generic undo/redo stack keyed by `agentId`. Each entry holds:

package/dist/undo/index.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import '../types-C2zdUpzn.js';
 
 /**
  * Generic undo/redo stack keyed by `agentId`. Each entry holds:

package/docs/relay-server.md

@@ -75,12 +75,232 @@ docker build -t agent-integrations-relay .
 docker run -p 8787:8787 agent-integrations-relay
 ```
 
-Deploy targets that just want a container:
+## Deployment recipes
+
+The relay is a tiny stateless Node HTTP server. Any platform that can host a
+long-running Node process works. Pick whichever matches the rest of your
+infrastructure — verification steps are at the bottom of each recipe.
+
+### Laravel Forge (Node site or daemon)
+
+Forge supports both Node sites and standalone daemons, either fits.
+
+**Option A — Forge "Static" site running Node:**
+
+1. In Forge, create a new site on your server. Set **Project Type** to
+   *Static / Node*. Web directory: `/public` (unused — we'll serve from the
+   relay port).
+2. Add a domain (e.g. `relay.particle.academy`) and an LE SSL cert.
+3. Connect the site to a deploy repo — point it at this package's git URL or
+   a thin wrapper repo containing just:
+   ```
+   .
+   ├── package.json   (just "scripts": { "start": "agent-integrations-relay --port 8787" }
+   │                   and "dependencies": { "@particle-academy/agent-integrations": "^0.6.1" })
+   └── README.md
+   ```
+4. Deploy script:
+   ```bash
+   cd $FORGE_SITE_PATH
+   npm install --omit=dev
+   ```
+5. In **Daemons** (sidebar), add:
+   - **Command:** `npx agent-integrations-relay --port 8787 --cors https://your-site.example`
+   - **Directory:** `$FORGE_SITE_PATH`
+   - **User:** `forge`
+   Daemon auto-restarts on crash.
+6. In the site's **Nginx config**, replace the upstream block with:
+   ```nginx
+   location / {
+       proxy_pass http://127.0.0.1:8787;
+       proxy_http_version 1.1;
+       proxy_set_header Host $host;
+       proxy_set_header X-Real-IP $remote_addr;
+
+       # SSE needs these — otherwise the stream is buffered and never reaches the agent.
+       proxy_buffering off;
+       proxy_cache off;
+       proxy_read_timeout 6h;
+       proxy_send_timeout 6h;
+       chunked_transfer_encoding on;
+   }
+   ```
+7. Restart Nginx via the Forge UI button or `sudo nginx -s reload`.
+
+**Option B — daemon alongside an existing Laravel app on the same server:**
+
+If you'd rather not give it its own subdomain, run it as a Forge daemon on
+an internal port and proxy from an existing site's Nginx config:
+
+```nginx
+# Inside an existing Forge Laravel site
+location /mcp-relay/ {
+    proxy_pass http://127.0.0.1:8787/;
+    proxy_http_version 1.1;
+    proxy_buffering off;
+    proxy_read_timeout 6h;
+    chunked_transfer_encoding on;
+}
+```
+
+**Verify:**
+
+```bash
+curl https://relay.particle.academy/                  # → {"ok":true,"service":"…"}
+curl -X POST -H 'content-type: application/json' \
+  -d '{"session":"smoke-001","token":"abcdef0123456789abcdef0123456789"}' \
+  https://relay.particle.academy/register             # → {"ok":true}
+```
+
+### Fly.io
+
+```bash
+git clone https://github.com/Particle-Academy/agent-integrations
+cd agent-integrations
+npm install && npm run build
+docker build -t agent-integrations-relay .
+
+# Init + deploy (first time only):
+fly launch \
+  --name relay-particle-academy \
+  --no-deploy \
+  --copy-config \
+  --image agent-integrations-relay \
+  --internal-port 8787 \
+  --region iad
+fly deploy
+```
+
+Public URL prints at the end, e.g. `https://relay-particle-academy.fly.dev`.
+
+### Railway
+
+```bash
+# Commit the Dockerfile to your relay repo, then:
+railway login
+railway init
+railway up
+```
+
+In the Railway dashboard, enable a public domain on the service; copy the
+generated `*.up.railway.app` URL.
+
+### Render
+
+1. New → **Web Service**
+2. Connect a git repo containing the Dockerfile
+3. Runtime: **Docker**
+4. Port: `8787`
+5. Add `Header: Cache-Control: no-cache` on the service so Render's CDN
+   doesn't buffer SSE
+
+### Google Cloud Run
+
+```bash
+gcloud builds submit --tag gcr.io/$PROJECT/agent-integrations-relay
+gcloud run deploy agent-integrations-relay \
+  --image gcr.io/$PROJECT/agent-integrations-relay \
+  --port 8787 \
+  --allow-unauthenticated \
+  --min-instances 1 \
+  --timeout 3600
+```
+
+Cloud Run's default request timeout is 60s — bump it via `--timeout 3600`
+(max 3600s on managed Cloud Run) so SSE streams aren't cut off. For longer
+sessions, use **Cloud Run for Anthos / GKE** or a Compute Engine VM.
+
+### Bare server (systemd)
+
+If the relay is going on a VM you already own, `systemd`:
+
+```ini
+# /etc/systemd/system/mcp-relay.service
+[Unit]
+Description=MCP relay broker
+After=network.target
+
+[Service]
+Type=simple
+User=relay
+WorkingDirectory=/opt/relay
+ExecStart=/usr/bin/npx agent-integrations-relay --port 8787 --cors https://your-site.example
+Restart=on-failure
+RestartSec=5
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now mcp-relay
+sudo systemctl status mcp-relay
+```
+
+Front with Nginx using the same SSE-friendly proxy block as the Forge
+recipe.
+
+## Smoke testing any deploy
+
+After you have a public URL, regardless of host:
+
+```bash
+RELAY=https://relay.example.com
+
+# 1. Health
+curl $RELAY/
+
+# 2. Register a session
+curl -X POST -H 'content-type: application/json' \
+  -d '{"session":"smoke-001","token":"abcdef0123456789abcdef0123456789"}' \
+  $RELAY/register
+
+# 3. POST a frame
+curl -X POST -H 'content-type: application/json' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
+  "$RELAY/smoke-001/inbox?token=abcdef0123456789abcdef0123456789"
+
+# 4. SSE stream — should hang open + emit keepalive comments every 15s
+curl -N "$RELAY/smoke-001/events?token=abcdef0123456789abcdef0123456789&direction=inbound"
+```
+
+If `curl -N` returns immediately, your proxy is buffering. Re-check
+`proxy_buffering off` (Nginx) or the equivalent on your edge.
+
+## Hooking into your demo site
+
+Set the relay base URL in your demo's environment. For a Laravel host (like
+particle.academy):
+
+```env
+# .env on the demo site
+MCP_RELAY_BASE_URL=https://relay.particle.academy
+```
+
+Bind it to a config and read it from your Livewire/Blade layer:
+
+```php
+// config/mcp.php
+return [
+    'relay_base_url' => env('MCP_RELAY_BASE_URL', ''),
+];
+```
+
+Then pass it to the React mount placeholder:
+
+```blade
+<div
+    data-fancy-demo="composer"
+    data-relay-base="{{ config('mcp.relay_base_url') }}"
+></div>
+```
 
-- **Fly.io:** `fly launch --image agent-integrations-relay --internal-port 8787`
-- **Railway:** `railway up` after committing the Dockerfile
-- **Render:** point a Web Service at the Dockerfile, expose 8787
-- **Cloud Run:** `gcloud run deploy --image agent-integrations-relay --port 8787 --allow-unauthenticated`
+The React side reads `node.dataset.relayBase`, passes it to the demo
+component, and the component uses it for `attachSseRelay({ baseUrl: ... })`.
+See [agent-hookable-demos.md](./agent-hookable-demos.md) for the
+end-to-end pattern.
 
 ## Wire protocol
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/agent-integrations",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "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",
@@ -57,6 +57,10 @@
       "import": { "types": "./dist/bridges/screens.d.ts", "default": "./dist/bridges-screens.js" },
       "require": { "types": "./dist/bridges/screens.d.cts", "default": "./dist/bridges-screens.cjs" }
     },
+    "./bridges/slides": {
+      "import": { "types": "./dist/bridges/slides.d.ts", "default": "./dist/bridges-slides.js" },
+      "require": { "types": "./dist/bridges/slides.d.cts", "default": "./dist/bridges-slides.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" }
@@ -96,15 +100,18 @@
     "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-sheets": "^0.1.0"
+    "@particle-academy/fancy-flow": "^0.2.0 || ^0.3.0",
+    "@particle-academy/fancy-sheets": "^0.1.0",
+    "@particle-academy/fancy-slides": "^0.1.4"
   },
   "peerDependenciesMeta": {
     "@particle-academy/fancy-whiteboard": { "optional": true },
     "@particle-academy/fancy-flow": { "optional": true },
-    "@particle-academy/fancy-sheets": { "optional": true }
+    "@particle-academy/fancy-sheets": { "optional": true },
+    "@particle-academy/fancy-slides": { "optional": true }
   },
   "devDependencies": {
+    "@particle-academy/fancy-slides": "^0.1.6",
     "@particle-academy/fancy-whiteboard": "^0.1.5",
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",