@particle-academy/agent-integrations 0.6.2 → 0.7.0

package/dist/bridges/artboard.d.cts

@@ -0,0 +1,78 @@
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
+
+/**
+ * Transport-level JSON shapes. These intentionally mirror fancy-artboard's
+ * public `ArtBoardValue` but are defined LOCALLY so this bridge builds
+ * independently of the sibling package — they are plain JSON crossing the
+ * MCP wire, not the live component types. Keep them in sync with
+ * @particle-academy/fancy-artboard's public surface.
+ */
+type Viewport = {
+    x: number;
+    y: number;
+    zoom: number;
+};
+type ArtPieceContent = {
+    kind: "image";
+    src: string;
+    alt?: string;
+} | {
+    kind: "html";
+    html: string;
+} | {
+    kind: "node";
+};
+type ArtPieceData = {
+    id: string;
+    label?: string;
+    width?: number;
+    height?: number;
+    content: ArtPieceContent;
+    pending?: boolean;
+};
+type ArtSectionData = {
+    id: string;
+    title: string;
+    subtitle?: string;
+    pieces: ArtPieceData[];
+};
+type ArtBoardValue = {
+    sections: ArtSectionData[];
+};
+/**
+ * State accessors / mutators the bridge needs from the host. The host owns
+ * artboard state (controlled props on fancy-artboard components); the bridge
+ * calls into these to read or change it.
+ */
+type ArtboardBridgeAdapter = {
+    getValue: () => ArtBoardValue;
+    setValue: (next: ArtBoardValue | ((prev: ArtBoardValue) => ArtBoardValue)) => void;
+    getViewport: () => Viewport;
+    setViewport: (next: Viewport) => void;
+    getFocus: () => string | null;
+    setFocus: (id: string | null) => void;
+    /** Optional: agent presence cursor (for the visualizer). */
+    setAgentCursor?: (cursor: {
+        x: number;
+        y: number;
+    } | null) => void;
+};
+type ArtboardBridgeOptions = {
+    adapter: ArtboardBridgeAdapter;
+    /** Identity used when the agent stamps authorship / cursor. */
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+};
+/**
+ * registerArtboardBridge — wires a full MCP tool set against a fancy-artboard
+ * session controlled by the host. Returns a Bridge handle the host can dispose
+ * to tear everything down.
+ */
+declare function registerArtboardBridge(host: ToolHost, options: ArtboardBridgeOptions): Bridge;
+
+export { type ArtboardBridgeAdapter, type ArtboardBridgeOptions, registerArtboardBridge };

package/dist/bridges/artboard.d.ts

@@ -0,0 +1,78 @@
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
+
+/**
+ * Transport-level JSON shapes. These intentionally mirror fancy-artboard's
+ * public `ArtBoardValue` but are defined LOCALLY so this bridge builds
+ * independently of the sibling package — they are plain JSON crossing the
+ * MCP wire, not the live component types. Keep them in sync with
+ * @particle-academy/fancy-artboard's public surface.
+ */
+type Viewport = {
+    x: number;
+    y: number;
+    zoom: number;
+};
+type ArtPieceContent = {
+    kind: "image";
+    src: string;
+    alt?: string;
+} | {
+    kind: "html";
+    html: string;
+} | {
+    kind: "node";
+};
+type ArtPieceData = {
+    id: string;
+    label?: string;
+    width?: number;
+    height?: number;
+    content: ArtPieceContent;
+    pending?: boolean;
+};
+type ArtSectionData = {
+    id: string;
+    title: string;
+    subtitle?: string;
+    pieces: ArtPieceData[];
+};
+type ArtBoardValue = {
+    sections: ArtSectionData[];
+};
+/**
+ * State accessors / mutators the bridge needs from the host. The host owns
+ * artboard state (controlled props on fancy-artboard components); the bridge
+ * calls into these to read or change it.
+ */
+type ArtboardBridgeAdapter = {
+    getValue: () => ArtBoardValue;
+    setValue: (next: ArtBoardValue | ((prev: ArtBoardValue) => ArtBoardValue)) => void;
+    getViewport: () => Viewport;
+    setViewport: (next: Viewport) => void;
+    getFocus: () => string | null;
+    setFocus: (id: string | null) => void;
+    /** Optional: agent presence cursor (for the visualizer). */
+    setAgentCursor?: (cursor: {
+        x: number;
+        y: number;
+    } | null) => void;
+};
+type ArtboardBridgeOptions = {
+    adapter: ArtboardBridgeAdapter;
+    /** Identity used when the agent stamps authorship / cursor. */
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+};
+/**
+ * registerArtboardBridge — wires a full MCP tool set against a fancy-artboard
+ * session controlled by the host. Returns a Bridge handle the host can dispose
+ * to tear everything down.
+ */
+declare function registerArtboardBridge(host: ToolHost, options: ArtboardBridgeOptions): Bridge;
+
+export { type ArtboardBridgeAdapter, type ArtboardBridgeOptions, registerArtboardBridge };

package/dist/bridges/charts.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import { B as Bridge } from '../types-CCSBGW9T.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
 
 /**
  * Adapter wires a single fancy-echarts chart to the bridge. Charts are

package/dist/bridges/charts.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import { B as Bridge } from '../types-DIVNcIQO.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
 
 /**
  * Adapter wires a single fancy-echarts chart to the bridge. Charts are

package/dist/bridges/code.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import { B as Bridge } from '../types-CCSBGW9T.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
 
 /**
  * Adapter the host wires to a fancy-code CodeEditor (typically via the

package/dist/bridges/code.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import { B as Bridge } from '../types-DIVNcIQO.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
 
 /**
  * Adapter the host wires to a fancy-code CodeEditor (typically via the

package/dist/bridges/flow.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import { B as Bridge } from '../types-CCSBGW9T.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
 
 type FlowNode = {
     id: string;

package/dist/bridges/flow.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import { B as Bridge } from '../types-DIVNcIQO.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
 
 type FlowNode = {
     id: string;

package/dist/bridges/forms.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import { B as Bridge } from '../types-CCSBGW9T.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
 
 /**
  * Field descriptor — what the host says about each form field. Mirrors the

package/dist/bridges/forms.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import { B as Bridge } from '../types-DIVNcIQO.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
 
 /**
  * Field descriptor — what the host says about each form field. Mirrors the

package/dist/bridges/scene.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import { B as Bridge } from '../types-CCSBGW9T.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
 
 /**
  * Loose Scene types — mirror the public surface of fancy-3d's Scene

package/dist/bridges/scene.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import { B as Bridge } from '../types-DIVNcIQO.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
 
 /**
  * Loose Scene types — mirror the public surface of fancy-3d's Scene

package/dist/bridges/screens.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import { B as Bridge } from '../types-CCSBGW9T.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
 
 /**
  * Loose snapshot of a screen — what's in fancy-screens' ScreenMeta plus

package/dist/bridges/screens.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import { B as Bridge } from '../types-DIVNcIQO.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
 
 /**
  * Loose snapshot of a screen — what's in fancy-screens' ScreenMeta plus

package/dist/bridges/sheets.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import { B as Bridge } from '../types-CCSBGW9T.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
 
 /**
  * Loose types — kept here so the bridge builds without a hard dep on

package/dist/bridges/sheets.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import { B as Bridge } from '../types-DIVNcIQO.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
 
 /**
  * Loose types — kept here so the bridge builds without a hard dep on

package/dist/bridges/slides.d.cts

@@ -0,0 +1,58 @@
+import { Deck, DeckOp } from '@particle-academy/fancy-slides';
+export { reduceDeck } from '@particle-academy/fancy-slides';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
+
+/**
+ * Adapter — the bridge calls into these to read or change deck state. The
+ * host owns the deck (it's a controlled prop on `DeckEditor` / `SlideViewer`).
+ * Every mutation funnels through `apply(op)`, which the host typically
+ * implements as `setDeck(deck => reduceDeck(deck, op))`.
+ */
+type SlidesBridgeAdapter = {
+    /** Read the current deck. */
+    getDeck: () => Deck;
+    /**
+     * Apply a typed DeckOp. The same operations the editor + agent use,
+     * so the host's reducer + undo stack handle both code paths identically.
+     */
+    apply: (op: DeckOp) => void;
+    /** Optional screen id for cross-screen presence highlighting. */
+    screenId?: string;
+};
+type SlidesBridgeOptions = {
+    adapter: SlidesBridgeAdapter;
+    /** Identity stamped on activity / op metadata. */
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+};
+/**
+ * registerSlidesBridge — wires the full slide-editor MCP surface against
+ * a fancy-slides Deck. Tools map 1:1 to `DeckOp` cases (plus read-only
+ * helpers); humans and agents take identical paths through the reducer.
+ *
+ *   deck_describe              read-only deck summary
+ *   deck_get                   full deck JSON
+ *   deck_set_title             rename
+ *   deck_apply_theme           swap theme
+ *   slide_list                 ordered list of slide ids + titles
+ *   slide_get                  full slide JSON
+ *   slide_add                  insert a slide
+ *   slide_remove               delete a slide
+ *   slide_reorder              move a slide
+ *   slide_set_layout           change layout preset
+ *   slide_set_notes            update speaker notes
+ *   slide_set_background       background color / image / gradient
+ *   element_add                insert an element onto a slide
+ *   element_remove             delete an element
+ *   element_update             patch an element's fields
+ *   element_move               set element x/y
+ *   element_resize             set element w/h
+ */
+declare function registerSlidesBridge(host: ToolHost, options: SlidesBridgeOptions): Bridge;
+
+export { type SlidesBridgeAdapter, type SlidesBridgeOptions, registerSlidesBridge };

package/dist/bridges/slides.d.ts

@@ -0,0 +1,58 @@
+import { Deck, DeckOp } from '@particle-academy/fancy-slides';
+export { reduceDeck } from '@particle-academy/fancy-slides';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
+
+/**
+ * Adapter — the bridge calls into these to read or change deck state. The
+ * host owns the deck (it's a controlled prop on `DeckEditor` / `SlideViewer`).
+ * Every mutation funnels through `apply(op)`, which the host typically
+ * implements as `setDeck(deck => reduceDeck(deck, op))`.
+ */
+type SlidesBridgeAdapter = {
+    /** Read the current deck. */
+    getDeck: () => Deck;
+    /**
+     * Apply a typed DeckOp. The same operations the editor + agent use,
+     * so the host's reducer + undo stack handle both code paths identically.
+     */
+    apply: (op: DeckOp) => void;
+    /** Optional screen id for cross-screen presence highlighting. */
+    screenId?: string;
+};
+type SlidesBridgeOptions = {
+    adapter: SlidesBridgeAdapter;
+    /** Identity stamped on activity / op metadata. */
+    agent?: {
+        id: string;
+        name?: string;
+        color?: string;
+    };
+};
+/**
+ * registerSlidesBridge — wires the full slide-editor MCP surface against
+ * a fancy-slides Deck. Tools map 1:1 to `DeckOp` cases (plus read-only
+ * helpers); humans and agents take identical paths through the reducer.
+ *
+ *   deck_describe              read-only deck summary
+ *   deck_get                   full deck JSON
+ *   deck_set_title             rename
+ *   deck_apply_theme           swap theme
+ *   slide_list                 ordered list of slide ids + titles
+ *   slide_get                  full slide JSON
+ *   slide_add                  insert a slide
+ *   slide_remove               delete a slide
+ *   slide_reorder              move a slide
+ *   slide_set_layout           change layout preset
+ *   slide_set_notes            update speaker notes
+ *   slide_set_background       background color / image / gradient
+ *   element_add                insert an element onto a slide
+ *   element_remove             delete an element
+ *   element_update             patch an element's fields
+ *   element_move               set element x/y
+ *   element_resize             set element w/h
+ */
+declare function registerSlidesBridge(host: ToolHost, options: SlidesBridgeOptions): Bridge;
+
+export { type SlidesBridgeAdapter, type SlidesBridgeOptions, registerSlidesBridge };

package/dist/bridges/whiteboard.d.cts

@@ -1,7 +1,7 @@
 import { StickyNoteItem, ShapeItem, ConnectorItem, Stroke, Viewport, RemoteCursor } from '@particle-academy/fancy-whiteboard';
-import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
-import { B as Bridge } from '../types-CCSBGW9T.cjs';
-import '../types-aOQLTW0E.cjs';
+import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
+import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
+import '../types-C2zdUpzn.cjs';
 
 /**
  * State accessors / mutators the bridge needs from the host. The host owns

package/dist/bridges/whiteboard.d.ts

@@ -1,7 +1,7 @@
 import { StickyNoteItem, ShapeItem, ConnectorItem, Stroke, Viewport, RemoteCursor } from '@particle-academy/fancy-whiteboard';
-import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
-import { B as Bridge } from '../types-DIVNcIQO.js';
-import '../types-aOQLTW0E.js';
+import { T as ToolHost } from '../tool-host-DldwGNqR.js';
+import { B as Bridge } from '../types-DyaHnqNC.js';
+import '../types-C2zdUpzn.js';
 
 /**
  * State accessors / mutators the bridge needs from the host. The host owns