@particle-academy/agent-integrations 0.38.0 → 0.39.1

package/dist/chunk-MJ2S25ON.js

@@ -0,0 +1,209 @@
+import { ensureUndoToolsRegistered, pushUndoEntry } from './chunk-CT3LRNH7.js';
+import { wrapToolWithActivity } from './chunk-2VENWGLZ.js';
+import { textResult, errorResult } from './chunk-DF3PLL2E.js';
+
+// src/bridges/grid.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerGridBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...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);
+    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;
+    }
+  };
+}
+
+export { registerGridBridge };
+//# sourceMappingURL=chunk-MJ2S25ON.js.map
+//# sourceMappingURL=chunk-MJ2S25ON.js.map

package/dist/chunk-MJ2S25ON.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/grid.ts"],"names":[],"mappings":"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","file":"chunk-MJ2S25ON.js","sourcesContent":["import { textResult, errorResult } from \"../mcp/server\";\nimport type { ToolHost } from \"../mcp/tool-host\";\nimport type { JsonObject } from \"../mcp/types\";\nimport type { Bridge } from \"./types\";\nimport { wrapToolWithActivity } from \"../presence/wrap-tool-with-activity\";\nimport { ensureUndoToolsRegistered } from \"../undo/undo-tools\";\nimport { pushUndoEntry } from \"../undo/undo-stack\";\nimport type { AgentTarget } from \"../presence/types\";\n\n/**\n * Loose grid types — the public state shape of `@particle-academy/fancy-grid`,\n * mirrored here rather than imported.\n *\n * Same reason the scene bridge mirrors fancy-3d's descriptor: a bridge must not\n * drag its surface package into every consumer's tree. fancy-grid keeps\n * TanStack Table and Virtual as PEERS specifically so nothing bundles them, and\n * an `import type` here would still make fancy-grid a build-time dependency of\n * agent-integrations. The state is four small JSON shapes; the coupling is not\n * worth it.\n */\nexport type GridSort = { id: string; desc: boolean };\nexport type GridFilter = { id: string; value: string };\nexport type GridPagination = { pageIndex: number; pageSize: number };\n\nexport type GridState = {\n  sorting?: GridSort[];\n  filters?: GridFilter[];\n  /** Keyed by row id — see the grid's `getRowId`. */\n  rowSelection?: Record<string, boolean>;\n  pagination?: GridPagination;\n};\n\nexport type GridBridgeAdapter = {\n  id: string;\n  title?: string;\n  screenId?: string;\n  /** Controlled state — the same object the grid's `onStateChange` emits. */\n  getState: () => GridState;\n  setState: (next: GridState) => void;\n  /**\n   * Column ids an agent may address. Supplied so a tool can REJECT an unknown\n   * column instead of writing a sort nothing applies — a silently ignored sort\n   * looks identical to a grid that simply is not sorted.\n   */\n  getColumnIds?: () => string[];\n  /** Row ids currently on screen, for `grid_select_rows` validation. */\n  getRowIds?: () => string[];\n  /**\n   * Write one cell. Absent when the grid is read-only, in which case\n   * `grid_edit_cell` is not registered at all rather than failing at call time\n   * — an agent should discover the capability from the tool list.\n   */\n  editCell?: (rowId: string, columnId: string, value: unknown) => void | Promise<void>;\n};\n\nexport type GridBridgeOptions = {\n  adapter: GridBridgeAdapter;\n  agent?: { id: string; name?: string; color?: string };\n  /**\n   * Gate writes behind a human confirmation. `grid_edit_cell` is the only\n   * mutation that changes DATA rather than view state, so it is the one that\n   * matters here — sorting a grid is not a trust-but-verify action.\n   */\n  pendingMode?: boolean;\n  onPending?: (staged: { id: string; label: string; apply: () => void | Promise<void> }) => void;\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\n/**\n * registerGridBridge — MCP access to a `fancy-grid` surface.\n *\n * `grid_sort`, `grid_filter`, `grid_select_rows` and `grid_edit_cell`, plus a\n * read tool. View state (sort / filter / selection / page) goes through one\n * `setState` channel because that is how the grid is controlled — a bridge that\n * mutated pieces separately would drift from what the component actually\n * accepts.\n */\nexport function registerGridBridge(host: ToolHost, options: GridBridgeOptions): Bridge {\n  const { adapter } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const disposers: Array<() => void> = [];\n\n  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });\n\n  const target = (part?: string): AgentTarget => ({\n    kind: \"grid\",\n    screenId: adapter.screenId,\n    elementId: part ? `${adapter.id}:${part}` : adapter.id,\n    label: part ? `${adapter.title ?? adapter.id} → ${part}` : (adapter.title ?? adapter.id),\n  });\n\n  const reg = (\n    name: string,\n    description: string,\n    properties: Record<string, unknown>,\n    required: string[],\n    handler: (args: JsonObject) => Promise<ReturnType<typeof textResult>> | ReturnType<typeof textResult>,\n    isMutation: boolean,\n    partFromArgs?: (args: JsonObject) => string | undefined,\n  ) => {\n    const wrapped = async (args: JsonObject) => {\n      try {\n        return await handler(args);\n      } catch (e) {\n        return errorResult(e instanceof Error ? e.message : String(e));\n      }\n    };\n    const final = isMutation\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name,\n          agent,\n          kind: \"grid\",\n          screenId: adapter.screenId,\n          resolveTarget: ({ args }) => target(partFromArgs?.(args)),\n        })\n      : wrapped;\n\n    disposers.push(\n      host.registerTool(\n        {\n          name,\n          description,\n          inputSchema: { type: \"object\", properties: properties as never, required, additionalProperties: false },\n        },\n        final as never,\n      ),\n    );\n  };\n\n  /** Reject an unknown column rather than writing state nothing applies. */\n  const assertColumn = (id: string): void => {\n    const known = adapter.getColumnIds?.();\n    if (known && !known.includes(id)) {\n      throw new Error(`Unknown column \"${id}\". Available: ${known.join(\", \")}`);\n    }\n  };\n\n  const commit = (next: GridState, action: string, label: string, previous: GridState): void => {\n    adapter.setState(next);\n    pushUndoEntry(agent.id, {\n      timestamp: Date.now(),\n      bridgeId: `grid:${adapter.id}`,\n      action,\n      label,\n      undo: () => adapter.setState(previous),\n      redo: () => adapter.setState(next),\n    });\n  };\n\n  // ───────────── Read ─────────────\n\n  reg(\n    \"grid_get\",\n    \"Read the grid's view state — sorting, filters, selected row ids, pagination — plus the addressable column and row ids.\",\n    {},\n    [],\n    () => {\n      const state = adapter.getState();\n      return textResult(\n        JSON.stringify(\n          {\n            id: adapter.id,\n            title: adapter.title,\n            sorting: state.sorting ?? [],\n            filters: state.filters ?? [],\n            selectedRowIds: Object.entries(state.rowSelection ?? {})\n              .filter(([, on]) => on)\n              .map(([id]) => id),\n            pagination: state.pagination,\n            columnIds: adapter.getColumnIds?.() ?? null,\n            rowIds: adapter.getRowIds?.() ?? null,\n            editable: Boolean(adapter.editCell),\n          },\n          null,\n          2,\n        ),\n      );\n    },\n    false,\n  );\n\n  // ───────────── View state ─────────────\n\n  reg(\n    \"grid_sort\",\n    \"Sort the grid. Pass an empty array to clear sorting. Multiple entries sort by each in order.\",\n    {\n      sorting: {\n        type: \"array\",\n        description: 'e.g. [{ \"id\": \"createdAt\", \"desc\": true }]',\n        items: {\n          type: \"object\",\n          properties: { id: { type: \"string\" }, desc: { type: \"boolean\" } },\n          required: [\"id\"],\n          additionalProperties: false,\n        },\n      },\n    },\n    [\"sorting\"],\n    (args) => {\n      const raw = Array.isArray(args.sorting) ? (args.sorting as GridSort[]) : [];\n      const sorting = raw.map((s) => {\n        assertColumn(String(s.id));\n        return { id: String(s.id), desc: Boolean(s.desc) };\n      });\n\n      const previous = adapter.getState();\n      commit({ ...previous, sorting }, \"grid_sort\", `Sorted by ${sorting.map((s) => s.id).join(\", \") || \"nothing\"}`, previous);\n      return textResult(`Sorted by ${sorting.map((s) => `${s.id}${s.desc ? \" desc\" : \"\"}`).join(\", \") || \"nothing\"}.`);\n    },\n    true,\n    (args) => (Array.isArray(args.sorting) && args.sorting[0] ? String((args.sorting[0] as GridSort).id) : undefined),\n  );\n\n  reg(\n    \"grid_filter\",\n    \"Filter the grid. Pass an empty array to clear all filters.\",\n    {\n      filters: {\n        type: \"array\",\n        description: 'e.g. [{ \"id\": \"status\", \"value\": \"open\" }]',\n        items: {\n          type: \"object\",\n          properties: { id: { type: \"string\" }, value: { type: \"string\" } },\n          required: [\"id\", \"value\"],\n          additionalProperties: false,\n        },\n      },\n    },\n    [\"filters\"],\n    (args) => {\n      const raw = Array.isArray(args.filters) ? (args.filters as GridFilter[]) : [];\n      const filters = raw.map((f) => {\n        assertColumn(String(f.id));\n        return { id: String(f.id), value: String(f.value) };\n      });\n\n      const previous = adapter.getState();\n      commit({ ...previous, filters }, \"grid_filter\", `Filtered ${filters.map((f) => f.id).join(\", \") || \"cleared\"}`, previous);\n      return textResult(`Filtering on ${filters.map((f) => `${f.id}=${f.value}`).join(\", \") || \"nothing\"}.`);\n    },\n    true,\n    (args) => (Array.isArray(args.filters) && args.filters[0] ? String((args.filters[0] as GridFilter).id) : undefined),\n  );\n\n  reg(\n    \"grid_select_rows\",\n    \"Replace the grid's row selection with the given row ids. Pass an empty array to clear.\",\n    { rowIds: { type: \"array\", items: { type: \"string\" }, description: \"Row ids, per the grid's getRowId.\" } },\n    [\"rowIds\"],\n    (args) => {\n      const ids = Array.isArray(args.rowIds) ? args.rowIds.map(String) : [];\n      const known = adapter.getRowIds?.();\n      if (known) {\n        const missing = ids.filter((id) => !known.includes(id));\n        if (missing.length) {\n          // Selecting a row that is not loaded looks like it worked and shows\n          // nothing — worth an error rather than a silent no-op.\n          throw new Error(`Row id(s) not on this page: ${missing.join(\", \")}`);\n        }\n      }\n\n      const previous = adapter.getState();\n      const rowSelection: Record<string, boolean> = {};\n      for (const id of ids) rowSelection[id] = true;\n\n      commit({ ...previous, rowSelection }, \"grid_select_rows\", `Selected ${ids.length} row${ids.length === 1 ? \"\" : \"s\"}`, previous);\n      return textResult(`Selected ${ids.length} row${ids.length === 1 ? \"\" : \"s\"}.`);\n    },\n    true,\n  );\n\n  // ───────────── Data ─────────────\n\n  if (adapter.editCell) {\n    reg(\n      \"grid_edit_cell\",\n      \"Write one cell. This changes DATA, not just the view.\",\n      {\n        rowId: { type: \"string\" },\n        columnId: { type: \"string\" },\n        value: { description: \"New value. Any JSON scalar or object the column accepts.\" },\n      },\n      [\"rowId\", \"columnId\"],\n      async (args) => {\n        const rowId = String(args.rowId);\n        const columnId = String(args.columnId);\n        assertColumn(columnId);\n\n        const apply = async () => {\n          await adapter.editCell?.(rowId, columnId, args.value);\n        };\n\n        if (options.pendingMode) {\n          // Trust-but-verify: the only tool here that changes stored data\n          // stages instead of writing. Sorting a grid is not a destructive act;\n          // editing a cell is.\n          const id = `grid-edit-${Date.now().toString(36)}`;\n          options.onPending?.({ id, label: `set ${columnId} on row ${rowId}`, apply });\n          return textResult(`Staged: set ${columnId} on row ${rowId}. Awaiting confirmation.`);\n        }\n\n        await apply();\n        return textResult(`Set ${columnId} on row ${rowId}.`);\n      },\n      true,\n      (args) => `${String(args.rowId)}:${String(args.columnId)}`,\n    );\n  }\n\n  return {\n    id: `grid:${adapter.id}`,\n    title: adapter.title ?? adapter.id,\n    dispose: () => {\n      for (const d of disposers) d();\n      disposers.length = 0;\n    },\n  };\n}\n"]}

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);
@@ -6080,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;