Vercel AI SDK and LangChain spreadsheet tools for WorkPaper agents

[gregkonush]

I shipped a focused guide for using @bilig/headless as a spreadsheet tool inside Vercel AI SDK and LangChain-style agent loops:

https://proompteng.github.io/bilig/vercel-ai-sdk-langchain-spreadsheet-tool.html

The point is to keep the framework adapter thin and make the workbook contract visible: edit Inputs!B3, return before/after computed values, preserve formulas, serialize/restore the WorkPaper, and prove restored output still matches the post-write state.

Runnable check from a clean checkout:

git clone https://github.com/proompteng/bilig.git
cd bilig/examples/headless-workpaper
npm install
npm run agent:framework-adapters

I am especially looking for feedback from people wiring spreadsheets into coding agents or backend workflows:

• Is the tool result contract explicit enough for production agent writeback?
• Which adapter shape should be added next: Mastra, OpenAI Agents SDK, MCP, or something else?
• What workbook automation example would make evaluation easier?

If the guide saves you time, star/bookmark the repo so other agent builders can find it: https://github.com/proompteng/bilig

[gregkonush]

Update: the guide now has framework-specific pages for the adapter shapes people asked about after the first Vercel AI SDK / LangChain writeup:

• Mastra: https://proompteng.github.io/bilig/mastra-workpaper-spreadsheet-tool.html
• LlamaIndex.TS: https://proompteng.github.io/bilig/llamaindex-workpaper-spreadsheet-tool.html
• LangGraph.js ToolNode: https://proompteng.github.io/bilig/langgraph-workpaper-toolnode-spreadsheet.html
• CopilotKit: https://proompteng.github.io/bilig/copilotkit-workpaper-spreadsheet-action.html
• Cloudflare Agents: https://proompteng.github.io/bilig/cloudflare-agents-workpaper-spreadsheet-tool.html

They all point back to the same checked example:

cd examples/headless-workpaper
npm run agent:framework-adapters

The useful part is still the WorkPaper result contract, not the framework wrapper: the write returns editedCell, before/after formula values, formulasPersisted, restoredMatchesAfter, and expectedArrChanged.

I also opened five small first-PR issues for people who want to improve the framework pages with verification transcripts and state/persistence notes: #323, #324, #325, #326, and #327.