@particle-academy/agent-integrations 0.41.0 → 0.43.0

package/README.md

@@ -18,6 +18,35 @@ npm install @particle-academy/agent-integrations
 import "@particle-academy/agent-integrations/styles.css";
 ```
 
+## Which version range to depend on
+
+**Use a caret. `^0.42.0` is correct here, and it is deliberate.**
+
+```jsonc
+"@particle-academy/agent-integrations": "^0.42.0"
+```
+
+This package is **pre-1.0, and breaking changes land in MINOR releases** — see
+the note at the top of [`CHANGELOG.md`](./CHANGELOG.md). A caret on a `0.x` locks
+the minor (npm reads `^0.42.0` as `>=0.42.0 <0.43.0`), so it gives you patches and
+holds you at a surface you have already integrated against. That is the right
+default when the next minor may change something under you.
+
+**Moving up a minor is a deliberate act.** Read that version's `CHANGELOG.md`
+entry before you do — breaking entries say what a consumer must actually DO, and
+about half of what reads as breaking needs no action at all.
+
+> **A note on the rest of the suite.** Some Fancy packages recommend an open
+> `>=X <2.0` range instead. That is not an inconsistency: those packages carry a
+> **runtime compatibility check** that fails loudly when a consumer is out of
+> step — `fancy-connector-core`'s `CONNECTOR_API_VERSION` is the example — which
+> is a stronger guarantee than a caret and makes the caret unnecessary. This
+> package has no such check, so the caret is doing real work.
+>
+> The rule inside the suite differs again: first-party packages depend on each
+> other with an open range because they are **released and tested together** at a
+> kit version. A consumer is not, which is why the advice here is not the same.
+
 ## Tree-shake-safe imports
 
 The root barrel is **core-only** — MCP server, presence, undo, sharing,

package/dist/bridges/artboard.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/artboard.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/catalog.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/catalog.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/charts.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/charts.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/cms.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import { DocAdapter } from './doc.cjs';
 import { StyledNode, StagePolicy, TreeOp, StyleProps, LayoutMode, DocReducer, DocTree } from '@particle-academy/fancy-doc-commons';
 import '../types-C58ZXs4K.cjs';

package/dist/bridges/cms.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import { DocAdapter } from './doc.js';
 import { StyledNode, StagePolicy, TreeOp, StyleProps, LayoutMode, DocReducer, DocTree } from '@particle-academy/fancy-doc-commons';
 import '../types-C58ZXs4K.js';

package/dist/bridges/code.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/code.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/doc.d.cts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
 import { J as JsonObject } from '../types-C58ZXs4K.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import { DocNode, DocTree, TreeOp, DocReducer, StagePolicy } from '@particle-academy/fancy-doc-commons';
 
 /** Host-provided access to the document tree. */

package/dist/bridges/doc.d.ts

@@ -1,6 +1,6 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
 import { J as JsonObject } from '../types-C58ZXs4K.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import { DocNode, DocTree, TreeOp, DocReducer, StagePolicy } from '@particle-academy/fancy-doc-commons';
 
 /** Host-provided access to the document tree. */

package/dist/bridges/features.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/features.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/files.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 type FileKind = "file" | "dir";

package/dist/bridges/files.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 type FileKind = "file" | "dir";

package/dist/bridges/flow.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 type FlowNode = {

package/dist/bridges/flow.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 type FlowNode = {

package/dist/bridges/forms.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/forms.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/git.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 type GitProposal = {

package/dist/bridges/git.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 type GitProposal = {

package/dist/bridges/grid.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/grid.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/map.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 type LatLng = {

package/dist/bridges/map.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 type LatLng = {

package/dist/bridges/passkeys.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/passkeys.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/scene.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/scene.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/screens.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/screens.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/sheets.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import { WorkbookData } from '@particle-academy/fancy-sheets';
 import '../types-C58ZXs4K.cjs';
 

package/dist/bridges/sheets.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import { WorkbookData } from '@particle-academy/fancy-sheets';
 import '../types-C58ZXs4K.js';
 

package/dist/bridges/slides.d.cts

@@ -1,6 +1,6 @@
 import { Deck, DeckOp } from '@particle-academy/fancy-slides';
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/slides.d.ts

@@ -1,6 +1,6 @@
 import { Deck, DeckOp } from '@particle-academy/fancy-slides';
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/terminal.d.cts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/terminal.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**

package/dist/bridges/tui.d.cts

@@ -1,4 +1,4 @@
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
 import { HumanPlusEventStore, HumanPlusActor } from '../human-plus/index.cjs';
 import '../types-C58ZXs4K.cjs';
 

package/dist/bridges/tui.d.ts

@@ -1,4 +1,4 @@
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
 import { HumanPlusEventStore, HumanPlusActor } from '../human-plus/index.js';
 import '../types-C58ZXs4K.js';
 

package/dist/bridges/whiteboard.d.cts

@@ -1,6 +1,6 @@
 import { StickyNoteItem, ShapeItem, ConnectorItem, Stroke, Viewport, RemoteCursor } from '@particle-academy/fancy-whiteboard';
-import { T as ToolHost } from '../tool-host-EuYHYSSH.cjs';
-import { B as Bridge } from '../types-NFGP769G.cjs';
+import { T as ToolHost } from '../tool-host-BpEBqf5u.cjs';
+import { B as Bridge } from '../types-C4NaIW6B.cjs';
 import '../types-C58ZXs4K.cjs';
 
 /**

package/dist/bridges/whiteboard.d.ts

@@ -1,6 +1,6 @@
 import { StickyNoteItem, ShapeItem, ConnectorItem, Stroke, Viewport, RemoteCursor } from '@particle-academy/fancy-whiteboard';
-import { T as ToolHost } from '../tool-host-CWTOJEm2.js';
-import { B as Bridge } from '../types-BKD6uf86.js';
+import { T as ToolHost } from '../tool-host-xY5F-eqG.js';
+import { B as Bridge } from '../types-DSwsNTBG.js';
 import '../types-C58ZXs4K.js';
 
 /**