@grid-is/agent-tools 0.2.3 → 0.3.1

package/README.md

@@ -38,6 +38,25 @@ import { serveStdio, createGridTools } from "@grid-is/agent-tools";
 await serveStdio({ tools: createGridTools() });
 ```
 
+## The tools alone
+
+`@grid-is/agent-tools/tools` exports the spreadsheet tools without the MCP
+server and the file-based workbook session. They run against an in-memory
+`Model`, in Node or in a browser bundle:
+
+```js
+import { Model } from "@grid-is/apiary";
+import { describeStructure, editCells, spreadsheetTools } from "@grid-is/agent-tools/tools";
+
+await Model.preconditions;
+const model = await Model.fromXLSX(bytes, "budget.xlsx");
+const structure = describeStructure.execute({ model }, {});
+```
+
+Each tool is `{ name, description, parameters, execute }`; `parameters` is a
+zod schema, so `z.toJSONSchema(tool.parameters)` produces the JSON Schema an
+agent SDK expects.
+
 ## Tools
 
 | Group | Tools |
@@ -70,8 +89,12 @@ npm run build      # tsdown → dist/
 npm test           # smoke test against test/fixtures/sample.xlsx
 npm run typecheck
 npm run gen:docs   # regenerate the per-tool reference under docs/src/content/docs/tools/
+npm run test:hosts # run the packed server under Claude Code and Codex, each in a fresh state directory
 ```
 
+`test:hosts` needs the `claude` CLI with `ANTHROPIC_API_KEY`, and the `codex`
+CLI with `CODEX_API_KEY` or a saved login. A host that is missing is skipped.
+
 ## Releasing
 
 Releases are managed with [changesets](https://github.com/changesets/changesets).