@particle-academy/agent-integrations 0.37.0 → 0.39.0

package/dist/components-shared-whiteboard.js

@@ -1,4 +1,4 @@
-import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-ABP2THQV.js';
+import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-QYWPCRT2.js';
 import { createSessionDescriptor, attachSseRelay } from './chunk-JDCB2NMM.js';
 import { attachInProcess } from './chunk-AFUULW5E.js';
 import { registerWhiteboardBridge } from './chunk-2U5JB6ZA.js';

package/dist/index.cjs

@@ -1365,13 +1365,215 @@ function registerChartsBridge(host, options) {
   };
 }
 
-// src/bridges/scene.ts
+// src/bridges/grid.ts
 var DEFAULT_AGENT5 = { id: "agent", name: "Agent", color: "#a855f7" };
-function registerSceneBridge(host, options) {
+function registerGridBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT5, ...options.agent ?? {} };
   const disposers = [];
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
+  const target = (part) => ({
+    kind: "grid",
+    screenId: adapter.screenId,
+    elementId: part ? `${adapter.id}:${part}` : adapter.id,
+    label: part ? `${adapter.title ?? adapter.id} \u2192 ${part}` : adapter.title ?? adapter.id
+  });
+  const reg = (name, description, properties, required, handler, isMutation, partFromArgs) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = isMutation ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent,
+      kind: "grid",
+      screenId: adapter.screenId,
+      resolveTarget: ({ args }) => target(partFromArgs?.(args))
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        {
+          name,
+          description,
+          inputSchema: { type: "object", properties, required, additionalProperties: false }
+        },
+        final
+      )
+    );
+  };
+  const assertColumn = (id) => {
+    const known = adapter.getColumnIds?.();
+    if (known && !known.includes(id)) {
+      throw new Error(`Unknown column "${id}". Available: ${known.join(", ")}`);
+    }
+  };
+  const commit = (next, action, label, previous) => {
+    adapter.setState(next);
+    fancyAutoCommon.pushUndoEntry(agent.id, {
+      timestamp: Date.now(),
+      bridgeId: `grid:${adapter.id}`,
+      action,
+      label,
+      undo: () => adapter.setState(previous),
+      redo: () => adapter.setState(next)
+    });
+  };
+  reg(
+    "grid_get",
+    "Read the grid's view state \u2014 sorting, filters, selected row ids, pagination \u2014 plus the addressable column and row ids.",
+    {},
+    [],
+    () => {
+      const state = adapter.getState();
+      return textResult(
+        JSON.stringify(
+          {
+            id: adapter.id,
+            title: adapter.title,
+            sorting: state.sorting ?? [],
+            filters: state.filters ?? [],
+            selectedRowIds: Object.entries(state.rowSelection ?? {}).filter(([, on]) => on).map(([id]) => id),
+            pagination: state.pagination,
+            columnIds: adapter.getColumnIds?.() ?? null,
+            rowIds: adapter.getRowIds?.() ?? null,
+            editable: Boolean(adapter.editCell)
+          },
+          null,
+          2
+        )
+      );
+    },
+    false
+  );
+  reg(
+    "grid_sort",
+    "Sort the grid. Pass an empty array to clear sorting. Multiple entries sort by each in order.",
+    {
+      sorting: {
+        type: "array",
+        description: 'e.g. [{ "id": "createdAt", "desc": true }]',
+        items: {
+          type: "object",
+          properties: { id: { type: "string" }, desc: { type: "boolean" } },
+          required: ["id"],
+          additionalProperties: false
+        }
+      }
+    },
+    ["sorting"],
+    (args) => {
+      const raw = Array.isArray(args.sorting) ? args.sorting : [];
+      const sorting = raw.map((s) => {
+        assertColumn(String(s.id));
+        return { id: String(s.id), desc: Boolean(s.desc) };
+      });
+      const previous = adapter.getState();
+      commit({ ...previous, sorting }, "grid_sort", `Sorted by ${sorting.map((s) => s.id).join(", ") || "nothing"}`, previous);
+      return textResult(`Sorted by ${sorting.map((s) => `${s.id}${s.desc ? " desc" : ""}`).join(", ") || "nothing"}.`);
+    },
+    true,
+    (args) => Array.isArray(args.sorting) && args.sorting[0] ? String(args.sorting[0].id) : void 0
+  );
+  reg(
+    "grid_filter",
+    "Filter the grid. Pass an empty array to clear all filters.",
+    {
+      filters: {
+        type: "array",
+        description: 'e.g. [{ "id": "status", "value": "open" }]',
+        items: {
+          type: "object",
+          properties: { id: { type: "string" }, value: { type: "string" } },
+          required: ["id", "value"],
+          additionalProperties: false
+        }
+      }
+    },
+    ["filters"],
+    (args) => {
+      const raw = Array.isArray(args.filters) ? args.filters : [];
+      const filters = raw.map((f) => {
+        assertColumn(String(f.id));
+        return { id: String(f.id), value: String(f.value) };
+      });
+      const previous = adapter.getState();
+      commit({ ...previous, filters }, "grid_filter", `Filtered ${filters.map((f) => f.id).join(", ") || "cleared"}`, previous);
+      return textResult(`Filtering on ${filters.map((f) => `${f.id}=${f.value}`).join(", ") || "nothing"}.`);
+    },
+    true,
+    (args) => Array.isArray(args.filters) && args.filters[0] ? String(args.filters[0].id) : void 0
+  );
+  reg(
+    "grid_select_rows",
+    "Replace the grid's row selection with the given row ids. Pass an empty array to clear.",
+    { rowIds: { type: "array", items: { type: "string" }, description: "Row ids, per the grid's getRowId." } },
+    ["rowIds"],
+    (args) => {
+      const ids = Array.isArray(args.rowIds) ? args.rowIds.map(String) : [];
+      const known = adapter.getRowIds?.();
+      if (known) {
+        const missing = ids.filter((id) => !known.includes(id));
+        if (missing.length) {
+          throw new Error(`Row id(s) not on this page: ${missing.join(", ")}`);
+        }
+      }
+      const previous = adapter.getState();
+      const rowSelection = {};
+      for (const id of ids) rowSelection[id] = true;
+      commit({ ...previous, rowSelection }, "grid_select_rows", `Selected ${ids.length} row${ids.length === 1 ? "" : "s"}`, previous);
+      return textResult(`Selected ${ids.length} row${ids.length === 1 ? "" : "s"}.`);
+    },
+    true
+  );
+  if (adapter.editCell) {
+    reg(
+      "grid_edit_cell",
+      "Write one cell. This changes DATA, not just the view.",
+      {
+        rowId: { type: "string" },
+        columnId: { type: "string" },
+        value: { description: "New value. Any JSON scalar or object the column accepts." }
+      },
+      ["rowId", "columnId"],
+      async (args) => {
+        const rowId = String(args.rowId);
+        const columnId = String(args.columnId);
+        assertColumn(columnId);
+        const apply = async () => {
+          await adapter.editCell?.(rowId, columnId, args.value);
+        };
+        if (options.pendingMode) {
+          const id = `grid-edit-${Date.now().toString(36)}`;
+          options.onPending?.({ id, label: `set ${columnId} on row ${rowId}`, apply });
+          return textResult(`Staged: set ${columnId} on row ${rowId}. Awaiting confirmation.`);
+        }
+        await apply();
+        return textResult(`Set ${columnId} on row ${rowId}.`);
+      },
+      true,
+      (args) => `${String(args.rowId)}:${String(args.columnId)}`
+    );
+  }
+  return {
+    id: `grid:${adapter.id}`,
+    title: adapter.title ?? adapter.id,
+    dispose: () => {
+      for (const d of disposers) d();
+      disposers.length = 0;
+    }
+  };
+}
+
+// src/bridges/scene.ts
+var DEFAULT_AGENT6 = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerSceneBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT6, ...options.agent ?? {} };
+  const disposers = [];
+  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (objectId) => ({
     kind: "scene",
     screenId: adapter.screenId,
@@ -1564,10 +1766,10 @@ function parseTriple(v) {
 }
 
 // src/bridges/screens.ts
-var DEFAULT_AGENT6 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT7 = { id: "agent", name: "Agent", color: "#a855f7" };
 function registerScreensBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT6, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT7, ...options.agent ?? {} };
   const disposers = [];
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (screenId) => ({
@@ -1739,10 +1941,10 @@ function registerScreensBridge(host, options) {
 }
 
 // src/bridges/slides.ts
-var DEFAULT_AGENT7 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT8 = { id: "agent", name: "Agent", color: "#a855f7" };
 function registerSlidesBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT7, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT8, ...options.agent ?? {} };
   const disposers = [];
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const deckTarget = () => ({
@@ -2182,13 +2384,13 @@ function firstTextContent(slide) {
 }
 
 // src/bridges/map.ts
-var DEFAULT_AGENT8 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT9 = { id: "agent", name: "Agent", color: "#a855f7" };
 var num2 = (v, fallback) => typeof v === "number" && Number.isFinite(v) ? v : 0;
 var str2 = (v, fallback = "") => typeof v === "string" ? v : fallback;
 var newId = (prefix) => `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 7)}`;
 function registerMapBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT8, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT9, ...options.agent ?? {} };
   const disposers = [];
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const mTarget = (args, result) => ({
@@ -2596,7 +2798,7 @@ function registerGitBridge(host, options) {
 }
 
 // src/bridges/files.ts
-var DEFAULT_AGENT9 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT10 = { id: "agent", name: "Agent", color: "#a855f7" };
 var MAX_SNAPSHOT_DEPTH = 8;
 function assertPathWithinRoot(root, path) {
   const segments = path.replace(/[\\/]+/g, "/").split("/");
@@ -2626,7 +2828,7 @@ var asPaths = (v) => {
 };
 function registerFilesBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT9, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT10, ...options.agent ?? {} };
   const disposers = [];
   const guard = (path) => {
     if (options.root !== void 0) assertPathWithinRoot(options.root, path);
@@ -2826,10 +3028,10 @@ function registerFilesBridge(host, options) {
 }
 
 // src/bridges/terminal.ts
-var DEFAULT_AGENT10 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT11 = { id: "agent", name: "Agent", color: "#a855f7" };
 var truncate = (s, n = 60) => s.length > n ? s.slice(0, n) + "\u2026" : s;
 function registerTerminalBridge(host, options) {
-  const agent = { ...DEFAULT_AGENT10, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT11, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const screenId = options.screenId ?? options.adapter?.screenId;
   const disposers = [];
@@ -3119,10 +3321,10 @@ function registerTerminalBridge(host, options) {
 }
 
 // src/bridges/navigation.ts
-var DEFAULT_AGENT11 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT12 = { id: "agent", name: "Agent", color: "#a855f7" };
 function registerNavigationBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT11, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT12, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const disposers = [];
   let groundedRevision = null;
@@ -3383,12 +3585,12 @@ function registerNavigationBridge(host, options) {
 }
 
 // src/bridges/catalog.ts
-var DEFAULT_AGENT12 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT13 = { id: "agent", name: "Agent", color: "#a855f7" };
 var str4 = (v, fallback = "") => typeof v === "string" ? v : fallback;
 var num4 = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
 function registerCatalogBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT12, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT13, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const catalogId = adapter.id ?? "catalog";
   const disposers = [];
@@ -3684,12 +3886,12 @@ function registerCatalogBridge(host, options) {
 }
 
 // src/bridges/features.ts
-var DEFAULT_AGENT13 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT14 = { id: "agent", name: "Agent", color: "#a855f7" };
 var str5 = (v, fallback = "") => typeof v === "string" ? v : fallback;
 var num5 = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
 function registerFeaturesBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT13, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT14, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const featuresId = adapter.id ?? "features";
   const disposers = [];
@@ -3898,7 +4100,7 @@ function registerFeaturesBridge(host, options) {
 }
 
 // src/bridges/passkeys.ts
-var DEFAULT_AGENT14 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT15 = { id: "agent", name: "Agent", color: "#a855f7" };
 var str6 = (v, fallback = "") => typeof v === "string" ? v : fallback;
 function toSummary(record) {
   return {
@@ -3921,7 +4123,7 @@ var PASSKEY_BRIDGE_TOOLS = [
 ];
 function registerPasskeyBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT14, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT15, ...options.agent ?? {} };
   const surfaceId = adapter.id ?? "passkeys";
   const disposers = [];
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
@@ -4082,10 +4284,10 @@ function registerPasskeyBridge(host, options) {
     }
   };
 }
-var DEFAULT_AGENT15 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT16 = { id: "agent", name: "Agent", color: "#a855f7" };
 function registerDocBridge(host, options) {
   const { adapter, surface } = options;
-  const agent = { ...DEFAULT_AGENT15, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT16, ...options.agent ?? {} };
   const reducer = options.reducer ?? fancyDocCommons.treeReducer();
   const stage = options.stagePolicy ?? fancyDocCommons.autoApply;
   const makeNode = options.makeNode ?? (({ id, type, parent, order }, props) => ({ id, type, parent, order, props }));
@@ -4744,11 +4946,11 @@ function attachSseRelay(server, options) {
 
 // src/sharing/use-co-browse-session.ts
 init_registry();
-var DEFAULT_AGENT16 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT17 = { id: "agent", name: "Agent", color: "#a855f7" };
 var USER = { id: "human", name: "You" };
 function useCoBrowseSession(options) {
   const { adapter, extraBridges } = options;
-  const agent = { ...DEFAULT_AGENT16, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT17, ...options.agent ?? {} };
   const relayBaseUrl = options.relayBaseUrl ?? "/agent-relay";
   const serverRef = react.useRef(null);
   const relayRef = react.useRef(null);
@@ -4892,17 +5094,47 @@ function AgentPanel({ agent, activity, onSubmit, busy, actions, className, style
 }
 function ActivityRow({ item }) {
   const time = formatTime(item.at);
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `fai-row fai-row--${item.kind}`, children: [
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-row__meta", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "fai-row__source", children: item.source }),
-      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "fai-row__time", children: time })
-    ] }),
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "fai-row__text", children: item.text }),
-    item.detail !== void 0 && /* @__PURE__ */ jsxRuntime.jsxs("details", { className: "fai-row__detail", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("summary", { children: "details" }),
-      /* @__PURE__ */ jsxRuntime.jsx("pre", { children: safeJson(item.detail) })
-    ] })
-  ] });
+  const status = item.status ?? (item.kind === "error" ? "error" : "ok");
+  const isCall = item.kind === "tool" && (item.args !== void 0 || item.result !== void 0 || item.durationMs !== void 0);
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: `fai-row fai-row--${item.kind}${isCall ? ` fai-row--${status}` : ""}`,
+      "data-fai-row": "",
+      "data-kind": item.kind,
+      "data-status": isCall ? status : void 0,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-row__meta", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "fai-row__source", children: item.source }),
+          isCall && item.args !== void 0 && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "fai-row__args", "data-fai-args": "", children: [
+            "(",
+            inline(item.args),
+            ")"
+          ] }),
+          isCall && item.durationMs !== void 0 && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "fai-row__latency", "data-fai-latency": "", children: [
+            "\xB7 ",
+            item.durationMs,
+            "ms"
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "fai-row__time", children: time })
+        ] }),
+        isCall && item.result !== void 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-row__result", "data-fai-result": "", children: [
+          "\u2192 ",
+          inline(item.result)
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "fai-row__text", children: item.text }),
+        item.detail !== void 0 && /* @__PURE__ */ jsxRuntime.jsxs("details", { className: "fai-row__detail", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("summary", { children: "details" }),
+          /* @__PURE__ */ jsxRuntime.jsx("pre", { children: safeJson(item.detail) })
+        ] })
+      ]
+    }
+  );
+}
+function inline(v, max = 80) {
+  if (typeof v === "string") return v.length > max ? `${v.slice(0, max)}\u2026` : v;
+  const json = safeJson(v).replace(/\s+/g, " ");
+  return json.length > max ? `${json.slice(0, max)}\u2026` : json;
 }
 function formatTime(at) {
   const d = new Date(at);
@@ -6050,6 +6282,7 @@ exports.registerFeaturesBridge = registerFeaturesBridge;
 exports.registerFilesBridge = registerFilesBridge;
 exports.registerFormBridge = registerFormBridge;
 exports.registerGitBridge = registerGitBridge;
+exports.registerGridBridge = registerGridBridge;
 exports.registerMapBridge = registerMapBridge;
 exports.registerNavigationBridge = registerNavigationBridge;
 exports.registerPasskeyBridge = registerPasskeyBridge;