@particle-academy/agent-integrations 0.6.1 → 0.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/dist/bridges/charts.d.cts +3 -3
  2. package/dist/bridges/charts.d.ts +3 -3
  3. package/dist/bridges/code.d.cts +3 -3
  4. package/dist/bridges/code.d.ts +3 -3
  5. package/dist/bridges/flow.d.cts +3 -3
  6. package/dist/bridges/flow.d.ts +3 -3
  7. package/dist/bridges/forms.d.cts +3 -3
  8. package/dist/bridges/forms.d.ts +3 -3
  9. package/dist/bridges/scene.d.cts +3 -3
  10. package/dist/bridges/scene.d.ts +3 -3
  11. package/dist/bridges/screens.d.cts +3 -3
  12. package/dist/bridges/screens.d.ts +3 -3
  13. package/dist/bridges/sheets.d.cts +3 -3
  14. package/dist/bridges/sheets.d.ts +3 -3
  15. package/dist/bridges/slides.d.cts +58 -0
  16. package/dist/bridges/slides.d.ts +58 -0
  17. package/dist/bridges/whiteboard.d.cts +3 -3
  18. package/dist/bridges/whiteboard.d.ts +3 -3
  19. package/dist/bridges-slides.cjs +438 -0
  20. package/dist/bridges-slides.cjs.map +1 -0
  21. package/dist/bridges-slides.js +6 -0
  22. package/dist/bridges-slides.js.map +1 -0
  23. package/dist/chunk-NE3GIGQD.js +384 -0
  24. package/dist/chunk-NE3GIGQD.js.map +1 -0
  25. package/dist/components/SharedWhiteboard/index.d.cts +1 -1
  26. package/dist/components/SharedWhiteboard/index.d.ts +1 -1
  27. package/dist/index.cjs +377 -0
  28. package/dist/index.cjs.map +1 -1
  29. package/dist/index.d.cts +9 -7
  30. package/dist/index.d.ts +9 -7
  31. package/dist/index.js +1 -0
  32. package/dist/index.js.map +1 -1
  33. package/dist/mcp/index.d.cts +5 -5
  34. package/dist/mcp/index.d.ts +5 -5
  35. package/dist/presence/index.d.cts +1 -1
  36. package/dist/presence/index.d.ts +1 -1
  37. package/dist/{server-BsSwfemr.d.cts → server-C2OpfPEo.d.cts} +3 -3
  38. package/dist/{server-Du3-IGqM.d.ts → server-CKAqFTyc.d.ts} +3 -3
  39. package/dist/sharing/index.d.cts +4 -4
  40. package/dist/sharing/index.d.ts +4 -4
  41. package/dist/sheets-adapter.d.cts +3 -3
  42. package/dist/sheets-adapter.d.ts +3 -3
  43. package/dist/{token-CrJF76oH.d.cts → token-C1O22GxJ.d.cts} +1 -1
  44. package/dist/{token-CrJF76oH.d.ts → token-C1O22GxJ.d.ts} +1 -1
  45. package/dist/{tool-host-BQuUygLF.d.cts → tool-host-CX3WFXgh.d.cts} +1 -1
  46. package/dist/{tool-host-C8JMMGYq.d.ts → tool-host-DldwGNqR.d.ts} +1 -1
  47. package/dist/{types-aOQLTW0E.d.cts → types-C2zdUpzn.d.cts} +1 -1
  48. package/dist/{types-aOQLTW0E.d.ts → types-C2zdUpzn.d.ts} +1 -1
  49. package/dist/{types-CCSBGW9T.d.cts → types-Cq5u8MJ8.d.cts} +1 -1
  50. package/dist/{types-DIVNcIQO.d.ts → types-DyaHnqNC.d.ts} +1 -1
  51. package/dist/undo/index.d.cts +2 -2
  52. package/dist/undo/index.d.ts +2 -2
  53. package/docs/relay-server.md +225 -5
  54. package/package.json +11 -4
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
2
- import { B as Bridge } from '../types-CCSBGW9T.cjs';
3
- import '../types-aOQLTW0E.cjs';
1
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
2
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
3
+ import '../types-C2zdUpzn.cjs';
4
4
 
5
5
  /**
6
6
  * Adapter wires a single fancy-echarts chart to the bridge. Charts are
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
2
- import { B as Bridge } from '../types-DIVNcIQO.js';
3
- import '../types-aOQLTW0E.js';
1
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
2
+ import { B as Bridge } from '../types-DyaHnqNC.js';
3
+ import '../types-C2zdUpzn.js';
4
4
 
5
5
  /**
6
6
  * Adapter wires a single fancy-echarts chart to the bridge. Charts are
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
2
- import { B as Bridge } from '../types-CCSBGW9T.cjs';
3
- import '../types-aOQLTW0E.cjs';
1
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
2
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
3
+ import '../types-C2zdUpzn.cjs';
4
4
 
5
5
  /**
6
6
  * Adapter the host wires to a fancy-code CodeEditor (typically via the
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
2
- import { B as Bridge } from '../types-DIVNcIQO.js';
3
- import '../types-aOQLTW0E.js';
1
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
2
+ import { B as Bridge } from '../types-DyaHnqNC.js';
3
+ import '../types-C2zdUpzn.js';
4
4
 
5
5
  /**
6
6
  * Adapter the host wires to a fancy-code CodeEditor (typically via the
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
2
- import { B as Bridge } from '../types-CCSBGW9T.cjs';
3
- import '../types-aOQLTW0E.cjs';
1
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
2
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
3
+ import '../types-C2zdUpzn.cjs';
4
4
 
5
5
  type FlowNode = {
6
6
  id: string;
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
2
- import { B as Bridge } from '../types-DIVNcIQO.js';
3
- import '../types-aOQLTW0E.js';
1
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
2
+ import { B as Bridge } from '../types-DyaHnqNC.js';
3
+ import '../types-C2zdUpzn.js';
4
4
 
5
5
  type FlowNode = {
6
6
  id: string;
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
2
- import { B as Bridge } from '../types-CCSBGW9T.cjs';
3
- import '../types-aOQLTW0E.cjs';
1
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
2
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
3
+ import '../types-C2zdUpzn.cjs';
4
4
 
5
5
  /**
6
6
  * Field descriptor — what the host says about each form field. Mirrors the
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
2
- import { B as Bridge } from '../types-DIVNcIQO.js';
3
- import '../types-aOQLTW0E.js';
1
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
2
+ import { B as Bridge } from '../types-DyaHnqNC.js';
3
+ import '../types-C2zdUpzn.js';
4
4
 
5
5
  /**
6
6
  * Field descriptor — what the host says about each form field. Mirrors the
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
2
- import { B as Bridge } from '../types-CCSBGW9T.cjs';
3
- import '../types-aOQLTW0E.cjs';
1
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
2
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
3
+ import '../types-C2zdUpzn.cjs';
4
4
 
5
5
  /**
6
6
  * Loose Scene types — mirror the public surface of fancy-3d's Scene
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
2
- import { B as Bridge } from '../types-DIVNcIQO.js';
3
- import '../types-aOQLTW0E.js';
1
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
2
+ import { B as Bridge } from '../types-DyaHnqNC.js';
3
+ import '../types-C2zdUpzn.js';
4
4
 
5
5
  /**
6
6
  * Loose Scene types — mirror the public surface of fancy-3d's Scene
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
2
- import { B as Bridge } from '../types-CCSBGW9T.cjs';
3
- import '../types-aOQLTW0E.cjs';
1
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
2
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
3
+ import '../types-C2zdUpzn.cjs';
4
4
 
5
5
  /**
6
6
  * Loose snapshot of a screen — what's in fancy-screens' ScreenMeta plus
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
2
- import { B as Bridge } from '../types-DIVNcIQO.js';
3
- import '../types-aOQLTW0E.js';
1
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
2
+ import { B as Bridge } from '../types-DyaHnqNC.js';
3
+ import '../types-C2zdUpzn.js';
4
4
 
5
5
  /**
6
6
  * Loose snapshot of a screen — what's in fancy-screens' ScreenMeta plus
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
2
- import { B as Bridge } from '../types-CCSBGW9T.cjs';
3
- import '../types-aOQLTW0E.cjs';
1
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
2
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
3
+ import '../types-C2zdUpzn.cjs';
4
4
 
5
5
  /**
6
6
  * Loose types — kept here so the bridge builds without a hard dep on
@@ -1,6 +1,6 @@
1
- import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
2
- import { B as Bridge } from '../types-DIVNcIQO.js';
3
- import '../types-aOQLTW0E.js';
1
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
2
+ import { B as Bridge } from '../types-DyaHnqNC.js';
3
+ import '../types-C2zdUpzn.js';
4
4
 
5
5
  /**
6
6
  * Loose types — kept here so the bridge builds without a hard dep on
@@ -0,0 +1,58 @@
1
+ import { Deck, DeckOp } from '@particle-academy/fancy-slides';
2
+ export { reduceDeck } from '@particle-academy/fancy-slides';
3
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
4
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
5
+ import '../types-C2zdUpzn.cjs';
6
+
7
+ /**
8
+ * Adapter — the bridge calls into these to read or change deck state. The
9
+ * host owns the deck (it's a controlled prop on `DeckEditor` / `SlideViewer`).
10
+ * Every mutation funnels through `apply(op)`, which the host typically
11
+ * implements as `setDeck(deck => reduceDeck(deck, op))`.
12
+ */
13
+ type SlidesBridgeAdapter = {
14
+ /** Read the current deck. */
15
+ getDeck: () => Deck;
16
+ /**
17
+ * Apply a typed DeckOp. The same operations the editor + agent use,
18
+ * so the host's reducer + undo stack handle both code paths identically.
19
+ */
20
+ apply: (op: DeckOp) => void;
21
+ /** Optional screen id for cross-screen presence highlighting. */
22
+ screenId?: string;
23
+ };
24
+ type SlidesBridgeOptions = {
25
+ adapter: SlidesBridgeAdapter;
26
+ /** Identity stamped on activity / op metadata. */
27
+ agent?: {
28
+ id: string;
29
+ name?: string;
30
+ color?: string;
31
+ };
32
+ };
33
+ /**
34
+ * registerSlidesBridge — wires the full slide-editor MCP surface against
35
+ * a fancy-slides Deck. Tools map 1:1 to `DeckOp` cases (plus read-only
36
+ * helpers); humans and agents take identical paths through the reducer.
37
+ *
38
+ * deck_describe read-only deck summary
39
+ * deck_get full deck JSON
40
+ * deck_set_title rename
41
+ * deck_apply_theme swap theme
42
+ * slide_list ordered list of slide ids + titles
43
+ * slide_get full slide JSON
44
+ * slide_add insert a slide
45
+ * slide_remove delete a slide
46
+ * slide_reorder move a slide
47
+ * slide_set_layout change layout preset
48
+ * slide_set_notes update speaker notes
49
+ * slide_set_background background color / image / gradient
50
+ * element_add insert an element onto a slide
51
+ * element_remove delete an element
52
+ * element_update patch an element's fields
53
+ * element_move set element x/y
54
+ * element_resize set element w/h
55
+ */
56
+ declare function registerSlidesBridge(host: ToolHost, options: SlidesBridgeOptions): Bridge;
57
+
58
+ export { type SlidesBridgeAdapter, type SlidesBridgeOptions, registerSlidesBridge };
@@ -0,0 +1,58 @@
1
+ import { Deck, DeckOp } from '@particle-academy/fancy-slides';
2
+ export { reduceDeck } from '@particle-academy/fancy-slides';
3
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
4
+ import { B as Bridge } from '../types-DyaHnqNC.js';
5
+ import '../types-C2zdUpzn.js';
6
+
7
+ /**
8
+ * Adapter — the bridge calls into these to read or change deck state. The
9
+ * host owns the deck (it's a controlled prop on `DeckEditor` / `SlideViewer`).
10
+ * Every mutation funnels through `apply(op)`, which the host typically
11
+ * implements as `setDeck(deck => reduceDeck(deck, op))`.
12
+ */
13
+ type SlidesBridgeAdapter = {
14
+ /** Read the current deck. */
15
+ getDeck: () => Deck;
16
+ /**
17
+ * Apply a typed DeckOp. The same operations the editor + agent use,
18
+ * so the host's reducer + undo stack handle both code paths identically.
19
+ */
20
+ apply: (op: DeckOp) => void;
21
+ /** Optional screen id for cross-screen presence highlighting. */
22
+ screenId?: string;
23
+ };
24
+ type SlidesBridgeOptions = {
25
+ adapter: SlidesBridgeAdapter;
26
+ /** Identity stamped on activity / op metadata. */
27
+ agent?: {
28
+ id: string;
29
+ name?: string;
30
+ color?: string;
31
+ };
32
+ };
33
+ /**
34
+ * registerSlidesBridge — wires the full slide-editor MCP surface against
35
+ * a fancy-slides Deck. Tools map 1:1 to `DeckOp` cases (plus read-only
36
+ * helpers); humans and agents take identical paths through the reducer.
37
+ *
38
+ * deck_describe read-only deck summary
39
+ * deck_get full deck JSON
40
+ * deck_set_title rename
41
+ * deck_apply_theme swap theme
42
+ * slide_list ordered list of slide ids + titles
43
+ * slide_get full slide JSON
44
+ * slide_add insert a slide
45
+ * slide_remove delete a slide
46
+ * slide_reorder move a slide
47
+ * slide_set_layout change layout preset
48
+ * slide_set_notes update speaker notes
49
+ * slide_set_background background color / image / gradient
50
+ * element_add insert an element onto a slide
51
+ * element_remove delete an element
52
+ * element_update patch an element's fields
53
+ * element_move set element x/y
54
+ * element_resize set element w/h
55
+ */
56
+ declare function registerSlidesBridge(host: ToolHost, options: SlidesBridgeOptions): Bridge;
57
+
58
+ export { type SlidesBridgeAdapter, type SlidesBridgeOptions, registerSlidesBridge };
@@ -1,7 +1,7 @@
1
1
  import { StickyNoteItem, ShapeItem, ConnectorItem, Stroke, Viewport, RemoteCursor } from '@particle-academy/fancy-whiteboard';
2
- import { T as ToolHost } from '../tool-host-BQuUygLF.cjs';
3
- import { B as Bridge } from '../types-CCSBGW9T.cjs';
4
- import '../types-aOQLTW0E.cjs';
2
+ import { T as ToolHost } from '../tool-host-CX3WFXgh.cjs';
3
+ import { B as Bridge } from '../types-Cq5u8MJ8.cjs';
4
+ import '../types-C2zdUpzn.cjs';
5
5
 
6
6
  /**
7
7
  * State accessors / mutators the bridge needs from the host. The host owns
@@ -1,7 +1,7 @@
1
1
  import { StickyNoteItem, ShapeItem, ConnectorItem, Stroke, Viewport, RemoteCursor } from '@particle-academy/fancy-whiteboard';
2
- import { T as ToolHost } from '../tool-host-C8JMMGYq.js';
3
- import { B as Bridge } from '../types-DIVNcIQO.js';
4
- import '../types-aOQLTW0E.js';
2
+ import { T as ToolHost } from '../tool-host-DldwGNqR.js';
3
+ import { B as Bridge } from '../types-DyaHnqNC.js';
4
+ import '../types-C2zdUpzn.js';
5
5
 
6
6
  /**
7
7
  * State accessors / mutators the bridge needs from the host. The host owns