@particle-academy/agent-integrations 0.2.4 → 0.3.4

package/dist/index.d.cts

@@ -1,13 +1,23 @@
-export { C as CallToolResult, a as ContentBlock, I as InitializeResult, J as JsonObject, b as JsonRpcMessage, c as JsonRpcNotification, d as JsonRpcRequest, e as JsonValue, f as MCP_PROTOCOL_VERSION, g as McpServerOptions, M as MicroMcpServer, S as ServerCapabilities, h as ServerInfo, T as ToolDefinition, i as ToolHandler, j as Transport, k as errorResult, r as rpcError, t as textResult } from './server-Bv985us3.cjs';
+import { M as MicroMcpServer } from './server-si-VvFxI.cjs';
+export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-si-VvFxI.cjs';
 export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.cjs';
-export { B as Bridge, a as BridgeFactory } from './types-DR5AS6Rd.cjs';
+export { C as CallToolResult, c as ContentBlock, I as InitializeResult, d 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-DksGd5Y7.cjs';
+export { B as Bridge, a as BridgeFactory } from './types-Bf1ZoGmI.cjs';
 export { WhiteboardBridgeAdapter, WhiteboardBridgeOptions, registerWhiteboardBridge } from './bridges/whiteboard.cjs';
 export { FlowBridgeAdapter, FlowBridgeOptions, registerFlowBridge } from './bridges/flow.cjs';
+import { FormFieldDescriptor } from './bridges/forms.cjs';
+export { FormBridgeAdapter, FormBridgeOptions, registerFormBridge } from './bridges/forms.cjs';
+export { SheetsBridgeAdapter, SheetsBridgeOptions, registerSheetsBridge } from './bridges/sheets.cjs';
+export { CodeBridgeAdapter, CodeBridgeOptions, registerCodeBridge } from './bridges/code.cjs';
+export { ChartsBridgeAdapter, ChartsBridgeOptions, registerChartsBridge } from './bridges/charts.cjs';
+export { SceneBridgeAdapter, SceneBridgeOptions, SceneCamera, SceneObject, SceneObjectKind, SceneState, registerSceneBridge } from './bridges/scene.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, CSSProperties } from 'react';
 import { SessionDescriptor } from './sharing/index.cjs';
 export { RelayState, SseRelayOptions, SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './sharing/index.cjs';
 import { StickyNoteItem, ShapeItem, ConnectorItem, Stroke, Viewport } from '@particle-academy/fancy-whiteboard';
+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';
 
 type AgentActivity = {
     id: string;
@@ -85,6 +95,89 @@ type AgentActivityHighlightProps = {
  */
 declare function AgentActivityHighlight({ x, y, width, height, pulseKey, color, duration, className, style, }: AgentActivityHighlightProps): react_jsx_runtime.JSX.Element | null;
 
+type BridgedFormProps = {
+    /** Stable id for this form. Used by agents in `form_*` tool calls. */
+    id: string;
+    /** Human title (also surfaced as the bridge title). */
+    title?: string;
+    /** Optional fancy-screens screen id this form lives in. */
+    screenId?: string;
+    /** Field descriptors — drives the agent-facing schema. */
+    fields: FormFieldDescriptor[];
+    /** Controlled values. */
+    values: Record<string, unknown>;
+    /** Setter — hosts pass their setState. */
+    onChange: (next: Record<string, unknown>) => void;
+    /** Optional submit handler. */
+    onSubmit?: () => Promise<{
+        ok: boolean;
+        values?: Record<string, unknown>;
+        error?: string;
+    }>;
+    /** The MicroMcpServer the bridge registers against. Pass null/undefined
+     *  to render without a bridge (useful for stories / non-shared use). */
+    server?: MicroMcpServer | null;
+    /** Identity used in activity events. */
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+    children: ReactNode;
+};
+/**
+ * BridgedForm — wraps a react-fancy form (or any controlled inputs)
+ * with a `registerFormBridge` lifecycle. Children render the actual form
+ * using `values` + `onChange`; this component only manages the bridge.
+ *
+ * Hosts use it like:
+ *
+ *   <BridgedForm id="signup" fields={...} values={values} onChange={setValues} server={server}>
+ *     <Field><Input value={values.email} onValueChange={(v) => onChange({ ...values, email: v })} /></Field>
+ *     ...
+ *   </BridgedForm>
+ *
+ * Agents can then call form_describe, form_set_value, form_submit, etc.
+ */
+declare function BridgedForm({ id, title, screenId, fields, values, onChange, onSubmit, server, agent, children, }: BridgedFormProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Loose shape of the fancy-screens system context — kept here so this
+ * component doesn't hard-import `@particle-academy/fancy-screens`.
+ */
+type ScreenSystemLike = {
+    registry: Map<string, {
+        id: string;
+        agentActivity?: unknown;
+    }>;
+    updateScreen: (id: string, patch: {
+        agentActivity?: unknown;
+    }) => void;
+};
+type ScreensActivityBridgeProps = {
+    /** The value returned by `useScreenSystem()` from fancy-screens. */
+    system: ScreenSystemLike;
+    /** ms to wait after the last activity before clearing the screen's badge. Default 1500. */
+    fadeMs?: number;
+};
+/**
+ * ScreensActivityBridge — subscribe to the in-process activity registry
+ * and patch each event into the matching screen's `agentActivity` field.
+ * Fade-out clears the badge after `fadeMs`.
+ *
+ * Use it once near the root of your app, ABOVE every <Screen>:
+ *
+ *   const system = useScreenSystem();
+ *   <>
+ *     <ScreensActivityBridge system={system} />
+ *     <Screen id="dashboard">…</Screen>
+ *     <Screen id="form">…</Screen>
+ *   </>
+ *
+ * Renders nothing; pure side-effect component.
+ */
+declare function ScreensActivityBridge({ system, fadeMs }: ScreensActivityBridgeProps): null;
+
 type ShareControlsProps = {
     /** The active session, or null when not sharing yet. */
     session: SessionDescriptor | null;
@@ -152,4 +245,4 @@ type SharedWhiteboardProps = {
  */
 declare function SharedWhiteboard({ initialNotes, initialShapes, initialConnectors, initialStrokes, initialViewport, agent, shareBaseUrl, onRegisterSession, showAgentPanel, showShareControls, broadcastEdits, height, header, className, style, }: SharedWhiteboardProps): react_jsx_runtime.JSX.Element;
 
-export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, SessionDescriptor, ShareControls, type ShareControlsProps, SharedWhiteboard, type SharedWhiteboardProps };
+export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, BridgedForm, type BridgedFormProps, FormFieldDescriptor, MicroMcpServer, ScreensActivityBridge, type ScreensActivityBridgeProps, SessionDescriptor, ShareControls, type ShareControlsProps, SharedWhiteboard, type SharedWhiteboardProps };

package/dist/index.d.ts

@@ -1,13 +1,23 @@
-export { C as CallToolResult, a as ContentBlock, I as InitializeResult, J as JsonObject, b as JsonRpcMessage, c as JsonRpcNotification, d as JsonRpcRequest, e as JsonValue, f as MCP_PROTOCOL_VERSION, g as McpServerOptions, M as MicroMcpServer, S as ServerCapabilities, h as ServerInfo, T as ToolDefinition, i as ToolHandler, j as Transport, k as errorResult, r as rpcError, t as textResult } from './server-Bv985us3.js';
+import { M as MicroMcpServer } from './server-BJu_AMH3.js';
+export { a as McpServerOptions, T as Transport, e as errorResult, r as rpcError, t as textResult } from './server-BJu_AMH3.js';
 export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.js';
-export { B as Bridge, a as BridgeFactory } from './types-CRPA_D0z.js';
+export { C as CallToolResult, c as ContentBlock, I as InitializeResult, d 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-DksGd5Y7.js';
+export { B as Bridge, a as BridgeFactory } from './types-DXKpLuia.js';
 export { WhiteboardBridgeAdapter, WhiteboardBridgeOptions, registerWhiteboardBridge } from './bridges/whiteboard.js';
 export { FlowBridgeAdapter, FlowBridgeOptions, registerFlowBridge } from './bridges/flow.js';
+import { FormFieldDescriptor } from './bridges/forms.js';
+export { FormBridgeAdapter, FormBridgeOptions, registerFormBridge } from './bridges/forms.js';
+export { SheetsBridgeAdapter, SheetsBridgeOptions, registerSheetsBridge } from './bridges/sheets.js';
+export { CodeBridgeAdapter, CodeBridgeOptions, registerCodeBridge } from './bridges/code.js';
+export { ChartsBridgeAdapter, ChartsBridgeOptions, registerChartsBridge } from './bridges/charts.js';
+export { SceneBridgeAdapter, SceneBridgeOptions, SceneCamera, SceneObject, SceneObjectKind, SceneState, registerSceneBridge } from './bridges/scene.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, CSSProperties } from 'react';
 import { SessionDescriptor } from './sharing/index.js';
 export { RelayState, SseRelayOptions, SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './sharing/index.js';
 import { StickyNoteItem, ShapeItem, ConnectorItem, Stroke, Viewport } from '@particle-academy/fancy-whiteboard';
+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';
 
 type AgentActivity = {
     id: string;
@@ -85,6 +95,89 @@ type AgentActivityHighlightProps = {
  */
 declare function AgentActivityHighlight({ x, y, width, height, pulseKey, color, duration, className, style, }: AgentActivityHighlightProps): react_jsx_runtime.JSX.Element | null;
 
+type BridgedFormProps = {
+    /** Stable id for this form. Used by agents in `form_*` tool calls. */
+    id: string;
+    /** Human title (also surfaced as the bridge title). */
+    title?: string;
+    /** Optional fancy-screens screen id this form lives in. */
+    screenId?: string;
+    /** Field descriptors — drives the agent-facing schema. */
+    fields: FormFieldDescriptor[];
+    /** Controlled values. */
+    values: Record<string, unknown>;
+    /** Setter — hosts pass their setState. */
+    onChange: (next: Record<string, unknown>) => void;
+    /** Optional submit handler. */
+    onSubmit?: () => Promise<{
+        ok: boolean;
+        values?: Record<string, unknown>;
+        error?: string;
+    }>;
+    /** The MicroMcpServer the bridge registers against. Pass null/undefined
+     *  to render without a bridge (useful for stories / non-shared use). */
+    server?: MicroMcpServer | null;
+    /** Identity used in activity events. */
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+    children: ReactNode;
+};
+/**
+ * BridgedForm — wraps a react-fancy form (or any controlled inputs)
+ * with a `registerFormBridge` lifecycle. Children render the actual form
+ * using `values` + `onChange`; this component only manages the bridge.
+ *
+ * Hosts use it like:
+ *
+ *   <BridgedForm id="signup" fields={...} values={values} onChange={setValues} server={server}>
+ *     <Field><Input value={values.email} onValueChange={(v) => onChange({ ...values, email: v })} /></Field>
+ *     ...
+ *   </BridgedForm>
+ *
+ * Agents can then call form_describe, form_set_value, form_submit, etc.
+ */
+declare function BridgedForm({ id, title, screenId, fields, values, onChange, onSubmit, server, agent, children, }: BridgedFormProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Loose shape of the fancy-screens system context — kept here so this
+ * component doesn't hard-import `@particle-academy/fancy-screens`.
+ */
+type ScreenSystemLike = {
+    registry: Map<string, {
+        id: string;
+        agentActivity?: unknown;
+    }>;
+    updateScreen: (id: string, patch: {
+        agentActivity?: unknown;
+    }) => void;
+};
+type ScreensActivityBridgeProps = {
+    /** The value returned by `useScreenSystem()` from fancy-screens. */
+    system: ScreenSystemLike;
+    /** ms to wait after the last activity before clearing the screen's badge. Default 1500. */
+    fadeMs?: number;
+};
+/**
+ * ScreensActivityBridge — subscribe to the in-process activity registry
+ * and patch each event into the matching screen's `agentActivity` field.
+ * Fade-out clears the badge after `fadeMs`.
+ *
+ * Use it once near the root of your app, ABOVE every <Screen>:
+ *
+ *   const system = useScreenSystem();
+ *   <>
+ *     <ScreensActivityBridge system={system} />
+ *     <Screen id="dashboard">…</Screen>
+ *     <Screen id="form">…</Screen>
+ *   </>
+ *
+ * Renders nothing; pure side-effect component.
+ */
+declare function ScreensActivityBridge({ system, fadeMs }: ScreensActivityBridgeProps): null;
+
 type ShareControlsProps = {
     /** The active session, or null when not sharing yet. */
     session: SessionDescriptor | null;
@@ -152,4 +245,4 @@ type SharedWhiteboardProps = {
  */
 declare function SharedWhiteboard({ initialNotes, initialShapes, initialConnectors, initialStrokes, initialViewport, agent, shareBaseUrl, onRegisterSession, showAgentPanel, showShareControls, broadcastEdits, height, header, className, style, }: SharedWhiteboardProps): react_jsx_runtime.JSX.Element;
 
-export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, SessionDescriptor, ShareControls, type ShareControlsProps, SharedWhiteboard, type SharedWhiteboardProps };
+export { type AgentActivity, AgentActivityHighlight, type AgentActivityHighlightProps, AgentCursor, type AgentCursorProps, AgentPanel, type AgentPanelProps, BridgedForm, type BridgedFormProps, FormFieldDescriptor, MicroMcpServer, ScreensActivityBridge, type ScreensActivityBridgeProps, SessionDescriptor, ShareControls, type ShareControlsProps, SharedWhiteboard, type SharedWhiteboardProps };

package/dist/index.js

@@ -1,13 +1,25 @@
+export { registerSceneBridge } from './chunk-QJUTISFC.js';
+import { buildShareUrl, buildShareConfig, createSessionDescriptor, attachSseRelay } from './chunk-JMYPUAFH.js';
+export { SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './chunk-JMYPUAFH.js';
+export { useAgentActivity, useAgentActivityForScreen } from './chunk-X66JWQBB.js';
+export { useUndoStack } from './chunk-DJOWMF6Q.js';
 import { attachInProcess } from './chunk-6LTKCNLF.js';
 export { InProcessTransport, RelayTransport, attachInProcess, attachRelay } from './chunk-6LTKCNLF.js';
-import { registerWhiteboardBridge } from './chunk-5ZUHNNLR.js';
-export { registerWhiteboardBridge } from './chunk-5ZUHNNLR.js';
-export { registerFlowBridge } from './chunk-2VOQJKSU.js';
+import { registerWhiteboardBridge } from './chunk-TBEITXF4.js';
+export { registerWhiteboardBridge } from './chunk-TBEITXF4.js';
+export { clearStack as clearUndoStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory as readUndoHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne } from './chunk-ACBENYYO.js';
+export { registerFlowBridge } from './chunk-4IAVAFUV.js';
+import { registerFormBridge } from './chunk-OEIULP2L.js';
+export { registerFormBridge } from './chunk-OEIULP2L.js';
+export { registerSheetsBridge } from './chunk-PDBF4W7E.js';
+export { registerCodeBridge } from './chunk-XYYSTJHW.js';
+export { registerChartsBridge } from './chunk-PHPXKSWI.js';
+export { wrapToolWithActivity } from './chunk-52S7XYZK.js';
+import { onActivity } from './chunk-JU2N4KK6.js';
+export { emitActivity, onActivity, readActivityHistory, resetActivityRegistry } from './chunk-JU2N4KK6.js';
 import { MicroMcpServer } from './chunk-QGCF7YKW.js';
 export { MCP_PROTOCOL_VERSION, MicroMcpServer, errorResult, rpcError, textResult } from './chunk-QGCF7YKW.js';
-import { buildShareUrl, buildShareConfig, createSessionDescriptor, attachSseRelay } from './chunk-FLEOQUKF.js';
-export { SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, createSessionDescriptor, describeSession, readSessionFromUrl } from './chunk-FLEOQUKF.js';
-import { useRef, useEffect, useState, useCallback, useMemo } from 'react';
+import { useRef, useEffect, useState, useMemo, useCallback } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 import { Board, Connector, Shape, StickyNote, CursorLayer } from '@particle-academy/fancy-whiteboard';
 
@@ -174,6 +186,98 @@ function AgentActivityHighlight({
     }
   );
 }
+function BridgedForm({
+  id,
+  title,
+  screenId,
+  fields,
+  values,
+  onChange,
+  onSubmit,
+  server,
+  agent,
+  children
+}) {
+  const valuesRef = useRef(values);
+  const onChangeRef = useRef(onChange);
+  const fieldsRef = useRef(fields);
+  const submitRef = useRef(onSubmit);
+  useEffect(() => {
+    valuesRef.current = values;
+  }, [values]);
+  useEffect(() => {
+    onChangeRef.current = onChange;
+  }, [onChange]);
+  useEffect(() => {
+    fieldsRef.current = fields;
+  }, [fields]);
+  useEffect(() => {
+    submitRef.current = onSubmit;
+  }, [onSubmit]);
+  const focusElement = (name) => {
+    if (typeof document === "undefined") return;
+    const el = document.querySelector(`[data-form-id="${id}"] [name="${name}"]`);
+    el?.focus();
+  };
+  const adapter = useMemo(() => ({
+    id,
+    title,
+    screenId,
+    getFields: () => fieldsRef.current,
+    getValue: (name) => valuesRef.current[name],
+    getValues: () => ({ ...valuesRef.current }),
+    setValue: (name, v) => onChangeRef.current({ ...valuesRef.current, [name]: v }),
+    setValues: (next) => onChangeRef.current({ ...valuesRef.current, ...next }),
+    focus: focusElement,
+    submit: async () => {
+      if (!submitRef.current) {
+        return { ok: true, values: { ...valuesRef.current } };
+      }
+      return submitRef.current();
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }), [id, title, screenId]);
+  useEffect(() => {
+    if (!server) return;
+    const bridge = registerFormBridge(server, { adapter, agent });
+    return () => bridge.dispose();
+  }, [server, adapter, agent]);
+  return /* @__PURE__ */ jsx("div", { "data-form-id": id, children });
+}
+function ScreensActivityBridge({ system, fadeMs = 1500 }) {
+  useEffect(() => {
+    const fadeTimers = /* @__PURE__ */ new Map();
+    const off = onActivity((event) => {
+      const screenId = event.target.screenId;
+      if (!screenId) return;
+      if (!system.registry.has(screenId)) return;
+      const activity = {
+        agentId: event.agentId,
+        agentName: event.agentName,
+        agentColor: event.agentColor,
+        action: event.action,
+        timestamp: event.timestamp,
+        elementId: event.target.elementId,
+        label: event.target.label
+      };
+      system.updateScreen(screenId, { agentActivity: activity });
+      const prev = fadeTimers.get(screenId);
+      if (prev) clearTimeout(prev);
+      fadeTimers.set(
+        screenId,
+        setTimeout(() => {
+          system.updateScreen(screenId, { agentActivity: null });
+          fadeTimers.delete(screenId);
+        }, event.ttlMs ?? fadeMs)
+      );
+    });
+    return () => {
+      off();
+      for (const t of fadeTimers.values()) clearTimeout(t);
+    };
+  }, [system, fadeMs]);
+  return null;
+}
 function ShareControls({
   session,
   onStart,
@@ -562,6 +666,6 @@ function resolveCenter(ref, notes, shapes) {
   return ref;
 }
 
-export { AgentActivityHighlight, AgentCursor, AgentPanel, ShareControls, SharedWhiteboard };
+export { AgentActivityHighlight, AgentCursor, AgentPanel, BridgedForm, ScreensActivityBridge, ShareControls, SharedWhiteboard };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map