@particle-academy/agent-integrations 0.2.4

package/dist/index.d.ts

@@ -0,0 +1,155 @@
+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';
+export { InProcessTransport, RelayChannel, RelayTransport, attachInProcess, attachRelay } from './mcp/index.js';
+export { B as Bridge, a as BridgeFactory } from './types-CRPA_D0z.js';
+export { WhiteboardBridgeAdapter, WhiteboardBridgeOptions, registerWhiteboardBridge } from './bridges/whiteboard.js';
+export { FlowBridgeAdapter, FlowBridgeOptions, registerFlowBridge } from './bridges/flow.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';
+
+type AgentActivity = {
+    id: string;
+    /** Wall-clock timestamp; component formats it. */
+    at: number;
+    /** "tool" for MCP tool invocations, "message" for chat, "info" for status. */
+    kind: "tool" | "message" | "info" | "error";
+    /** Short label, e.g. "whiteboard_add_sticky" or "Agent". */
+    source: string;
+    /** Body text. */
+    text: string;
+    /** Optional structured payload, rendered as collapsed JSON. */
+    detail?: unknown;
+};
+type AgentPanelProps = {
+    /** The agent's identity (name + color appears in the header). */
+    agent?: {
+        name?: string;
+        color?: string;
+    };
+    /** Activity stream. Most recent at the end. */
+    activity: AgentActivity[];
+    /** Optional chat composer — pass an onSubmit to enable. */
+    onSubmit?: (message: string) => void;
+    /** Disabled while a request is in flight. */
+    busy?: boolean;
+    /** Right-rail header actions. */
+    actions?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * AgentPanel — sidebar showing the agent's identity, a tool-and-chat log,
+ * and an optional input composer. Pure presentational: hosts feed it the
+ * activity stream from their own state (typically the MCP transport log).
+ */
+declare function AgentPanel({ agent, activity, onSubmit, busy, actions, className, style }: AgentPanelProps): react_jsx_runtime.JSX.Element;
+
+type AgentCursorProps = {
+    x: number;
+    y: number;
+    name?: string;
+    color?: string;
+    /** Optional caption shown under the name (e.g. current tool). */
+    status?: string;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * AgentCursor — on-canvas presence marker for the agent. Drop it inside
+ * (or alongside) a fancy-whiteboard <Board> at screen coords matching
+ * the agent's reported position.
+ */
+declare function AgentCursor({ x, y, name, color, status, className, style }: AgentCursorProps): react_jsx_runtime.JSX.Element;
+
+type AgentActivityHighlightProps = {
+    /** Bounds of the highlighted item in the parent's coord system. */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Trigger token — change it (e.g. set to Date.now()) to re-fire the pulse. */
+    pulseKey?: string | number;
+    /** Highlight tint. */
+    color?: string;
+    /** Pulse duration in ms. Defaults 1200. */
+    duration?: number;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * AgentActivityHighlight — short pulsing outline that flashes around an
+ * item the agent just touched. Position the parent so this can be placed
+ * absolutely matching the item's bounds.
+ */
+declare function AgentActivityHighlight({ x, y, width, height, pulseKey, color, duration, className, style, }: AgentActivityHighlightProps): react_jsx_runtime.JSX.Element | null;
+
+type ShareControlsProps = {
+    /** The active session, or null when not sharing yet. */
+    session: SessionDescriptor | null;
+    onStart: () => void;
+    onStop: () => void;
+    /** Optional connection-state badge text. */
+    status?: string;
+    /** Override the URL base used in the share URL. */
+    shareBaseUrl?: string;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * ShareControls — the host-facing UI for turning sharing on/off and
+ * surfacing the resulting connection details (URL / JSON / cURL).
+ */
+declare function ShareControls({ session, onStart, onStop, status, shareBaseUrl, className, style, }: ShareControlsProps): react_jsx_runtime.JSX.Element;
+
+type SharedWhiteboardProps = {
+    /** Initial board contents. */
+    initialNotes?: StickyNoteItem[];
+    initialShapes?: ShapeItem[];
+    initialConnectors?: ConnectorItem[];
+    initialStrokes?: Stroke[];
+    initialViewport?: Viewport;
+    /** Agent identity displayed in the panel + cursor. */
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+    /**
+     * Where the relay HTTP endpoints live. The host app implements these (see
+     * docs/relay-protocol.md). Pass `null` to disable sharing — the board
+     * still works locally with the in-process MCP server.
+     */
+    shareBaseUrl?: string | null;
+    /**
+     * Optional callback to register a new session token with the host's
+     * relay broker. Receives `{ session, token }` and should return after
+     * registration. Defaults to POSTing JSON to `${shareBaseUrl}/register`.
+     */
+    onRegisterSession?: (descriptor: SessionDescriptor) => Promise<void>;
+    /** Show the agent panel. Default true. */
+    showAgentPanel?: boolean;
+    /** Show share controls. Default true. */
+    showShareControls?: boolean;
+    /** Auto-broadcast local edits as `notifications/state_update`. Default true. */
+    broadcastEdits?: boolean;
+    /** Pixel height of the board area. Default 640. */
+    height?: number;
+    /** Header content rendered above the board. */
+    header?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * SharedWhiteboard — drop-in component that bundles every piece of the
+ * "agent-collaborative whiteboard" UX: board with all primitives, in-page
+ * MCP server, share controls, agent panel, presence cursor, activity
+ * highlight, and outbound state broadcast.
+ *
+ * Most apps only need this one component. For deeper customization, swap
+ * it for the lower-level primitives (Board, MicroMcpServer, ShareControls).
+ */
+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 };