@bilig/workpaper 0.107.8 → 0.119.1

package/AGENTS.md

@@ -38,16 +38,16 @@ Do not claim success from a write call alone. The proof is computed readback plu
 ## Fast Commands
 
 ```sh
-npm exec --package @bilig/workpaper@0.107.8 -- bilig-agent-challenge
-npm exec --package @bilig/workpaper@0.107.8 -- bilig-mcp-challenge
-npm exec --package @bilig/workpaper@0.107.8 -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
-npm exec --package @bilig/workpaper@0.107.8 -- bilig-formula-clinic ./reduced.xlsx --cells "Summary!B7,Inputs!B2"
+npm exec --package @bilig/workpaper@latest -- bilig-agent-challenge
+npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge
+npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
+npm exec --package @bilig/workpaper@latest -- bilig-formula-clinic ./reduced.xlsx --cells "Summary!B7,Inputs!B2"
 ```
 
 Claude Desktop users can install the released MCPB bundle from:
 
-- https://github.com/proompteng/bilig/releases/download/libraries-v0.107.8/bilig-workpaper.mcpb
-- https://github.com/proompteng/bilig/releases/download/libraries-v0.107.8/bilig-workpaper.mcpb.sha256
+- https://github.com/proompteng/bilig/releases/latest/download/bilig-workpaper.mcpb
+- https://github.com/proompteng/bilig/releases/latest/download/bilig-workpaper.mcpb.sha256
 
 ## Direct TypeScript
 

package/README.md

@@ -19,14 +19,29 @@ npm install @bilig/workpaper
 
 Pick the path that matches the workflow you are trying to unblock:
 
-| You need...                                                              | Run this first                                                                       | Proof you should get                                                                                                |
-| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
-| Formula workbook logic inside a Node service, route, queue, or test      | `npm create @bilig/workpaper@latest pricing-workpaper`                               | Inputs are written, formulas recalculate, JSON persists, restore matches readback, and `verified: true` is printed. |
-| A coding agent or MCP client that needs spreadsheet operations           | `npm create @bilig/workpaper@latest pricing-agent -- --agent`                        | The generated project includes an agent contract, MCP config, and `npm run agent:verify`.                           |
-| Directus Flow operation for persisted calculated fields                  | `cd examples/directus-workpaper-flow-operation && npm install && npm run smoke`      | The operation returns a Directus `patch` plus before/after/restore WorkPaper proof with `verified: true`.           |
-| n8n, Dify, or Flowise formula readback without spreadsheet UI automation | `npm exec --package @bilig/workpaper@latest -- bilig-n8n-formula-server --port 4321` | The workflow writes one input cell, reads dependent formula output, and returns a compact JSON proof.               |
-| Open WebUI needs MCP spreadsheet tools                                   | `npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge --json`           | Open WebUI can call the hosted Streamable HTTP endpoint or a local stdio server bridged through `mcpo`.             |
-| An existing `.xlsx` file with stale formula results after Node edits     | `npx --package @bilig/xlsx-formula-recalc xlsx-recalc --demo --json`                 | The file-level path updates inputs and returns fresh formula values without Excel, LibreOffice, or a browser.       |
+| You need...                                                                         | Run this first                                                                                                                                                             | Proof you should get                                                                                                 |
+| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| Formula workbook logic inside a Node service, route, queue, or test                 | `npm create @bilig/workpaper@latest pricing-workpaper`                                                                                                                     | Inputs are written, formulas recalculate, JSON persists, restore matches readback, and `verified: true` is printed.  |
+| A coding agent or MCP client that needs spreadsheet operations                      | `npm create @bilig/workpaper@latest pricing-agent -- --agent`                                                                                                              | The generated project includes an agent contract, MCP config, and `npm run agent:verify`.                            |
+| Windmill TypeScript workflow fields                                                 | `cd examples/windmill-workpaper-script && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                              | The script returns a calculated field patch plus before/after/restore WorkPaper proof with `verified: true`.         |
+| Trigger.dev durable task fields                                                     | `cd examples/triggerdev-workpaper-task && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                              | The task helper returns a calculated field patch plus before/after/restore WorkPaper proof with `verified: true`.    |
+| Inngest durable step fields                                                         | `cd examples/inngest-workpaper-step && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                                 | The step helper returns a calculated field patch plus before/after/restore WorkPaper proof with `verified: true`.    |
+| Airbyte post-sync record and state validation                                       | `cd examples/airbyte-workpaper-validation && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                           | The validation step reads Airbyte-style `STREAM`/`GLOBAL` state JSONL and returns a patch plus restore proof.        |
+| Meltano custom utility validation                                                   | `cd examples/meltano-workpaper-utility && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                              | The utility reads a post-ELT JSONL export and writes a formula-backed WorkPaper proof artifact.                      |
+| Temporal TypeScript Activity decisions                                              | `cd examples/temporal-workpaper-activity && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                            | The Activity owns WorkPaper formula work while Workflow code stays free of workbook imports.                         |
+| Apache Airflow DAG task outputs                                                     | `cd examples/airflow-workpaper-dag && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                                  | The Node step writes a full proof file while the DAG returns a compact XCom summary for downstream tasks.            |
+| Dagster asset materialization metadata                                              | `cd examples/dagster-workpaper-asset && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                                | The Node subprocess writes WorkPaper proof and emits compact Dagster Pipes materialization metadata.                 |
+| Kestra Node Commands flow fields                                                    | `cd examples/kestra-workpaper-flow && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                                  | The flow script writes a `workpaper-proof.json` artifact with before/after/restore proof and `verified: true`.       |
+| Prefect flow fields                                                                 | `cd examples/prefect-workpaper-flow && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                                 | The Node step writes a `workpaper-proof.json` artifact that a Prefect task can validate and return.                  |
+| Directus Flow operation for persisted calculated fields                             | `cd examples/directus-workpaper-flow-operation && npm install && npm run smoke`                                                                                            | The operation returns a Directus `patch` plus before/after/restore WorkPaper proof with `verified: true`.            |
+| n8n, Dify, Flowise, or Pipedream formula readback without spreadsheet UI automation | `npm exec --package @bilig/workpaper@latest -- bilig-n8n-formula-server --port 4321`                                                                                       | The workflow writes one input cell, reads dependent formula output, and returns a compact JSON proof.                |
+| Vercel AI SDK `generateText()` or `streamText()` tools                              | Import `createAiSdkWorkPaperTools` from `@bilig/workpaper/ai-sdk`                                                                                                          | The tool call returns before/after/restore formula readback instead of a blind write result.                         |
+| Open WebUI needs MCP spreadsheet tools                                              | `npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge --json`                                                                                                 | Open WebUI can call the hosted Streamable HTTP endpoint or a local stdio server bridged through `mcpo`.              |
+| FastMCP Python client for hosted MCP smoke tests                                    | `cd examples/fastmcp-workpaper-client && uv run --python 3.12 --with 'fastmcp-slim[client]' python fastmcp_workpaper_client.py --output .tmp/fastmcp-workpaper-proof.json` | FastMCP lists Bilig tools, writes `Inputs!B3`, checks restore proof, and exports WorkPaper JSON.                     |
+| LangGraph.js ToolNode should keep formula proof in state                            | `cd examples/langgraph-workpaper-tool-state && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                         | Real `@langchain/langgraph` `ToolNode` returns `ToolMessage` readback proof after a WorkPaper mutation.              |
+| LangChain MCP adapters should load WorkPaper tools                                  | `cd examples/langchain-mcp-workpaper-toolnode && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke`                                                       | `@langchain/mcp-adapters` discovers Bilig MCP tools and `ToolNode` proves write, readback, persistence, and restart. |
+| Hugging Face smolagents tool                                                        | `cd examples/smolagents-workpaper-tool && uv run --python 3.12 --with smolagents python smolagents_workpaper_tool.py --output .tmp/smolagents-workpaper-proof.json`        | A smolagents `Tool` runs Bilig formula readback proof and returns a structured `verified: true` object.              |
+| An existing `.xlsx` file with stale formula results after Node edits                | `npx --package @bilig/xlsx-formula-recalc xlsx-recalc --demo --json`                                                                                                       | The file-level path updates inputs and returns fresh formula values without Excel, LibreOffice, or a browser.        |
 
 ## Use A WorkPaper In Node
 
@@ -83,15 +98,65 @@ console.log({
 workbook.dispose()
 ```
 
+## Use WorkPaper Tools With The Vercel AI SDK
+
+Install the AI SDK and Zod in the application that owns the agent loop:
+
+```sh
+npm install @bilig/workpaper ai zod
+```
+
+Then expose a WorkPaper as normal AI SDK tools:
+
+```ts
+import { generateText, stepCountIs } from 'ai'
+import { WorkPaper } from '@bilig/workpaper'
+import { createAiSdkWorkPaperTools } from '@bilig/workpaper/ai-sdk'
+
+const workpaper = WorkPaper.buildFromSheets({
+  Inputs: [
+    ['Metric', 'Value'],
+    ['Qualified opportunities', 20],
+    ['Win rate', 0.25],
+    ['Average ARR', 12000],
+  ],
+  Summary: [
+    ['Metric', 'Value'],
+    ['Expected customers', '=Inputs!B2*Inputs!B3'],
+    ['Expected ARR', '=B2*Inputs!B4'],
+  ],
+})
+
+const tools = createAiSdkWorkPaperTools({
+  workpaper,
+  defaultReadRange: 'Summary!A1:B3',
+  proofRange: 'Summary!A1:B3',
+  writableSheets: ['Inputs'],
+})
+
+const result = await generateText({
+  model,
+  tools,
+  stopWhen: stepCountIs(2),
+  prompt: 'Read the summary, set Inputs!B3 to 0.4, then report the computed ARR change.',
+})
+
+console.log(result.text)
+```
+
+The mutating tool returns `editedCell`, `before`, `after`, `restored`, and
+`checks`. Keep `writableSheets` narrow so the model can edit inputs without
+rewriting formula sheets.
+
 ## Prove The Agent Loop Without Cloning
 
 The package ships proof commands for coding agents and service evaluators:
 
 ```sh
-npm exec --package @bilig/workpaper -- bilig-agent-challenge
-npm exec --package @bilig/workpaper -- bilig-mcp-challenge
-npm exec --package @bilig/workpaper -- bilig-n8n-formula-server --port 4321
-npm exec --package @bilig/workpaper -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
+npm exec --package @bilig/workpaper@latest -- bilig-agent-challenge --json
+npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge --json
+npm exec --package @bilig/workpaper@latest -- bilig-n8n-formula-server --port 4321
+npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
 ```
 
 The challenge commands edit one input, recalculate dependent formulas, export
@@ -109,17 +174,45 @@ npm exec --package @bilig/workpaper@latest -- bilig-n8n-formula-server --port 43
 Start from the repo examples:
 
 - `examples/directus-workpaper-flow-operation`
+- `examples/windmill-workpaper-script`
+- `examples/triggerdev-workpaper-task`
+- `examples/airbyte-workpaper-validation`
+- `examples/meltano-workpaper-utility`
+- `examples/temporal-workpaper-activity`
+- `examples/airflow-workpaper-dag`
+- `examples/dagster-workpaper-asset`
+- `examples/kestra-workpaper-flow`
+- `examples/prefect-workpaper-flow`
 - `examples/n8n-workpaper-formula-readback/bilig-workpaper-formula-readback.n8n.json`
-- `examples/dify-workpaper-formula-readback`
+- `examples/dify-workpaper-formula-readback` mirrors the Dify plugin source;
+  the package was merged upstream in
+  <https://github.com/langgenius/dify-plugins/pull/2451>
 - `examples/flowise-workpaper-formula-readback/bilig-workpaper-formula-readback.flowise-tool.json`
+- `integrations/pipedream-bilig-workpaper` mirrors the Pipedream action shape;
+  the public review is <https://github.com/PipedreamHQ/pipedream/pull/20972>
+- `examples/fastmcp-workpaper-client`
+- `examples/langchain-mcp-workpaper-toolnode`
+- `examples/smolagents-workpaper-tool`
 
 Docs:
 
 - <https://proompteng.github.io/bilig/directus-workpaper-flow-operation.html>
+- <https://proompteng.github.io/bilig/windmill-workpaper-script.html>
+- <https://proompteng.github.io/bilig/triggerdev-workpaper-task.html>
+- <https://proompteng.github.io/bilig/airbyte-workpaper-validation.html>
+- <https://proompteng.github.io/bilig/meltano-workpaper-utility.html>
+- <https://proompteng.github.io/bilig/temporal-workpaper-activity.html>
+- <https://proompteng.github.io/bilig/airflow-workpaper-dag.html>
+- <https://proompteng.github.io/bilig/dagster-workpaper-asset.html>
+- <https://proompteng.github.io/bilig/kestra-workpaper-flow.html>
+- <https://proompteng.github.io/bilig/prefect-workpaper-flow.html>
 - <https://proompteng.github.io/bilig/open-webui-workpaper-mcp.html>
 - <https://proompteng.github.io/bilig/n8n-workpaper-formula-readback.html>
 - <https://proompteng.github.io/bilig/dify-workpaper-formula-readback.html>
 - <https://proompteng.github.io/bilig/flowise-workpaper-formula-readback.html>
+- <https://proompteng.github.io/bilig/fastmcp-workpaper-client.html>
+- <https://proompteng.github.io/bilig/langgraph-workpaper-toolnode-spreadsheet.html>
+- <https://proompteng.github.io/bilig/smolagents-workpaper-tool.html>
 
 ## XLSX Import And Export
 
@@ -155,4 +248,17 @@ service-owned calculations, JSON persistence, XLSX import/export, and
 agent-readable readback. Unsupported Excel functions, external workbook links,
 macros, and volatile functions may need review.
 
+## After The Proof
+
+If the starter or challenge output gives you `verified: true` for the service
+or agent workflow you need, star or bookmark Bilig so the WorkPaper runtime is
+easy to find again: <https://github.com/proompteng/bilig/stargazers>.
+
+Watch releases if this is close to a production path:
+<https://github.com/proompteng/bilig/subscription>.
+
+If the model is close but blocked by a formula, import/export, persistence,
+framework, MCP, or package-boundary gap, open the smallest adoption blocker:
+<https://github.com/proompteng/bilig/discussions/new?category=general>.
+
 Full docs: <https://proompteng.github.io/bilig/>

package/SKILL.md

@@ -37,12 +37,19 @@ Do not build shell commands by concatenating user text. Treat the commands below
 Use MCP when the host can run a stdio server or call a Streamable HTTP server.
 Configure stdio as an argument array, not a shell-concatenated string:
 
+If the host supports installable skills, first check that the public skill
+package is discoverable:
+
+```sh
+npx --yes skills@latest add proompteng/bilig --skill bilig-workpaper --list
+```
+
 Before wiring a client, an agent can prove the direct WorkPaper loop with:
 
 ```json
 {
   "command": "npm",
-  "args": ["exec", "--package", "@bilig/workpaper@0.107.8", "--", "bilig-agent-challenge"]
+  "args": ["exec", "--package", "@bilig/workpaper@latest", "--", "bilig-agent-challenge"]
 }
 ```
 
@@ -51,7 +58,7 @@ For the actual file-backed MCP path, run the package-owned challenge first:
 ```json
 {
   "command": "npm",
-  "args": ["exec", "--package", "@bilig/workpaper@0.107.8", "--", "bilig-mcp-challenge"]
+  "args": ["exec", "--package", "@bilig/workpaper@latest", "--", "bilig-mcp-challenge"]
 }
 ```
 
@@ -61,7 +68,7 @@ For the actual file-backed MCP path, run the package-owned challenge first:
   "args": [
     "exec",
     "--package",
-    "@bilig/workpaper@0.107.8",
+    "@bilig/workpaper@latest",
     "--",
     "bilig-workpaper-mcp",
     "--workpaper",
@@ -72,7 +79,8 @@ For the actual file-backed MCP path, run the package-owned challenge first:
 }
 ```
 
-The useful file-backed tools are:
+Run `bilig-mcp-challenge` and treat its returned `tools` array as the source
+of truth for the currently published package. The core file-backed tools are:
 
 - `list_sheets`
 - `read_range`
@@ -82,7 +90,11 @@ The useful file-backed tools are:
 - `export_workpaper_document`
 - `validate_formula`
 
-After a write, always read the dependent output cell and export the WorkPaper document.
+After a write, always read the dependent output cell and export the WorkPaper
+document. If the listed tool set includes `set_cell_contents_and_readback`,
+prefer it for stateless clients because the edit and dependent readback happen
+in one tool call. If it is absent, call `set_cell_contents`, then `read_cell`
+or `read_range`, then `export_workpaper_document`.
 
 For remote MCP clients, use the stateless demo endpoint when the client supports
 Streamable HTTP:
@@ -138,7 +150,7 @@ When the user has a reduced XLSX formula/import bug, generate a local report thr
   "args": [
     "exec",
     "--package",
-    "@bilig/workpaper@0.107.8",
+    "@bilig/workpaper@latest",
     "--",
     "bilig-formula-clinic",
     "./reduced.xlsx",
@@ -170,9 +182,22 @@ If any proof step fails, report the blocker instead of claiming the workbook was
 - Agent handbook: https://proompteng.github.io/bilig/headless-workpaper-agent-handbook.html
 - Agent workbook challenge: https://proompteng.github.io/bilig/agent-workbook-challenge.html
 - MCP server guide: https://proompteng.github.io/bilig/mcp-workpaper-tool-server.html
-- Open WebUI MCP setup: https://proompteng.github.io/bilig/open-webui-workpaper-mcp.html
+- Open WebUI tool setup: https://proompteng.github.io/bilig/open-webui-workpaper-mcp.html
 - LobeHub MCP setup: https://proompteng.github.io/bilig/lobehub-workpaper-mcp.html
 - AnythingLLM MCP setup: https://proompteng.github.io/bilig/anythingllm-workpaper-mcp.html
+- Sim MCP setup: https://proompteng.github.io/bilig/sim-workpaper-mcp.html
+- FastMCP Python client: https://proompteng.github.io/bilig/fastmcp-workpaper-client.html
+- smolagents WorkPaper tool: https://proompteng.github.io/bilig/smolagents-workpaper-tool.html
+- Windmill TypeScript script: https://proompteng.github.io/bilig/windmill-workpaper-script.html
+- Trigger.dev task: https://proompteng.github.io/bilig/triggerdev-workpaper-task.html
+- Inngest step: https://proompteng.github.io/bilig/inngest-workpaper-step.html
+- Airbyte validation: https://proompteng.github.io/bilig/airbyte-workpaper-validation.html
+- Meltano utility: https://proompteng.github.io/bilig/meltano-workpaper-utility.html
+- Temporal Activity: https://proompteng.github.io/bilig/temporal-workpaper-activity.html
+- Airflow DAG: https://proompteng.github.io/bilig/airflow-workpaper-dag.html
+- Dagster asset: https://proompteng.github.io/bilig/dagster-workpaper-asset.html
+- Kestra Node flow: https://proompteng.github.io/bilig/kestra-workpaper-flow.html
+- Prefect flow: https://proompteng.github.io/bilig/prefect-workpaper-flow.html
 - XLSX formula clinic: https://proompteng.github.io/bilig/formula-bug-clinic.html
 - Compatibility limits: https://proompteng.github.io/bilig/where-bilig-is-not-excel-compatible-yet.html
 - Repository: https://github.com/proompteng/bilig

package/dist/ai-sdk.d.ts

@@ -0,0 +1,47 @@
+import type { WorkPaper } from 'bilig-workpaper';
+type WorkPaperInstance = ReturnType<typeof WorkPaper.buildFromSheets>;
+export type AiSdkWorkPaperCellValue = string | number | boolean | null;
+export interface AiSdkWorkPaperToolsOptions {
+    readonly workpaper: WorkPaperInstance;
+    readonly defaultReadRange?: string;
+    readonly proofRange?: string;
+    readonly writableSheets?: readonly string[];
+    readonly includeSerializedDocument?: boolean;
+}
+export interface AiSdkWorkPaperSetCellArgs {
+    readonly sheetName: string;
+    readonly address: string;
+    readonly value: AiSdkWorkPaperCellValue;
+}
+export interface AiSdkWorkPaperReadRangeArgs {
+    readonly range?: string;
+}
+export interface AiSdkWorkPaperReadResult {
+    readonly range: string;
+    readonly values: unknown[][];
+    readonly serialized: unknown[][];
+}
+export interface AiSdkWorkPaperWriteResult {
+    readonly editedCell: string;
+    readonly before: AiSdkWorkPaperReadResult;
+    readonly after: AiSdkWorkPaperReadResult;
+    readonly restored: AiSdkWorkPaperReadResult;
+    readonly checks: {
+        readonly previousValue: unknown;
+        readonly newValue: unknown;
+        readonly formulasPersisted: boolean;
+        readonly restoredMatchesAfter: boolean;
+        readonly proofRangeChanged: boolean;
+        readonly serializedBytes: number;
+    };
+    readonly serializedDocument?: string;
+}
+export declare function createAiSdkWorkPaperTools(options: AiSdkWorkPaperToolsOptions): {
+    readWorkPaperSummary: import("ai").Tool<AiSdkWorkPaperReadRangeArgs, AiSdkWorkPaperReadResult>;
+    setWorkPaperInputCell: import("ai").Tool<AiSdkWorkPaperSetCellArgs, AiSdkWorkPaperWriteResult>;
+};
+export declare function createWorkPaperToolHandlers(options: AiSdkWorkPaperToolsOptions): {
+    readWorkPaperSummary(range?: string): AiSdkWorkPaperReadResult;
+    setWorkPaperInputCell(args: AiSdkWorkPaperSetCellArgs): AiSdkWorkPaperWriteResult;
+};
+export {};

package/dist/ai-sdk.js

@@ -0,0 +1,118 @@
+import { createWorkPaperFromDocument, exportWorkPaperDocument, parseWorkPaperDocument, serializeWorkPaperDocument } from 'bilig-workpaper';
+import { tool } from 'ai';
+import { z } from 'zod';
+const setInputCellSchema = z.object({
+    sheetName: z.string().min(1).describe('Target sheet name, for example Inputs.'),
+    address: z
+        .string()
+        .regex(/^[A-Z]+[1-9][0-9]*$/)
+        .describe('A1 cell address inside the target sheet, for example B3.'),
+    value: z
+        .union([z.string(), z.number(), z.boolean(), z.null()])
+        .describe('Literal cell value. Formula strings are accepted only when your WorkPaper contract allows them.'),
+});
+export function createAiSdkWorkPaperTools(options) {
+    const handlers = createWorkPaperToolHandlers(options);
+    const defaultReadRange = options.defaultReadRange ?? 'Summary!A1:B5';
+    return {
+        readWorkPaperSummary: tool({
+            description: 'Read computed WorkPaper values and serialized cells for a small proof range.',
+            inputSchema: createReadRangeInputSchema(defaultReadRange),
+            execute: async ({ range = defaultReadRange } = {}) => {
+                return handlers.readWorkPaperSummary(range);
+            },
+        }),
+        setWorkPaperInputCell: tool({
+            description: 'Set one validated WorkPaper input cell and return before/after/restore formula readback.',
+            inputSchema: setInputCellSchema,
+            execute: async (args) => handlers.setWorkPaperInputCell(args),
+        }),
+    };
+}
+function createReadRangeInputSchema(defaultReadRange) {
+    return z.object({
+        range: z.string().default(defaultReadRange).describe(`A small A1 range including the sheet name, for example ${defaultReadRange}.`),
+    });
+}
+export function createWorkPaperToolHandlers(options) {
+    const defaultReadRange = options.defaultReadRange ?? 'Summary!A1:B5';
+    const proofRange = options.proofRange ?? defaultReadRange;
+    return {
+        readWorkPaperSummary(range = defaultReadRange) {
+            return readWorkPaperRange(options.workpaper, range);
+        },
+        setWorkPaperInputCell(args) {
+            const parsedArgs = setInputCellSchema.parse(args);
+            assertWritableSheet(parsedArgs.sheetName, options.writableSheets);
+            const address = requireCellAddress(options.workpaper, parsedArgs.sheetName, parsedArgs.address);
+            const before = readWorkPaperRange(options.workpaper, proofRange);
+            const previousValue = options.workpaper.getCellSerialized(address);
+            options.workpaper.setCellContents(address, parsedArgs.value);
+            const after = readWorkPaperRange(options.workpaper, proofRange);
+            const saved = serializeWorkPaperDocument(exportWorkPaperDocument(options.workpaper, {
+                includeConfig: true,
+            }));
+            const restored = createWorkPaperFromDocument(parseWorkPaperDocument(saved));
+            const restoredReadback = readWorkPaperRange(restored, proofRange);
+            return {
+                editedCell: options.workpaper.simpleCellAddressToString(address, {
+                    includeSheetName: true,
+                }),
+                before,
+                after,
+                restored: restoredReadback,
+                checks: {
+                    previousValue,
+                    newValue: options.workpaper.getCellSerialized(address),
+                    formulasPersisted: sameJson(after.serialized, restoredReadback.serialized),
+                    restoredMatchesAfter: sameJson(after.values, restoredReadback.values),
+                    proofRangeChanged: !sameJson(before.values, after.values),
+                    serializedBytes: Buffer.byteLength(saved, 'utf8'),
+                },
+                ...(options.includeSerializedDocument ? { serializedDocument: saved } : {}),
+            };
+        },
+    };
+}
+function readWorkPaperRange(workpaper, range) {
+    const parsedRange = workpaper.simpleCellRangeFromString(range, resolveDefaultSheet(workpaper));
+    if (parsedRange === undefined) {
+        throw new Error(`Invalid readable WorkPaper range: ${range}`);
+    }
+    return {
+        range,
+        values: workpaper.getRangeValues(parsedRange),
+        serialized: workpaper.getRangeSerialized(parsedRange),
+    };
+}
+function requireCellAddress(workpaper, sheetName, address) {
+    const sheetId = requireSheet(workpaper, sheetName);
+    const parsedAddress = workpaper.simpleCellAddressFromString(address, sheetId);
+    if (parsedAddress === undefined || parsedAddress.sheet !== sheetId) {
+        throw new Error(`Invalid WorkPaper address: ${sheetName}!${address}`);
+    }
+    return parsedAddress;
+}
+function requireSheet(workpaper, sheetName) {
+    const sheetId = workpaper.getSheetId(sheetName);
+    if (sheetId === undefined) {
+        throw new Error(`Expected sheet "${sheetName}" to exist`);
+    }
+    return sheetId;
+}
+function resolveDefaultSheet(workpaper) {
+    const firstSheetName = workpaper.getSheetNames()[0];
+    if (firstSheetName === undefined) {
+        throw new Error('Expected WorkPaper to contain at least one sheet');
+    }
+    return requireSheet(workpaper, firstSheetName);
+}
+function assertWritableSheet(sheetName, writableSheets) {
+    if (writableSheets !== undefined && !writableSheets.includes(sheetName)) {
+        throw new Error(`Sheet "${sheetName}" is not writable for this AI SDK tool`);
+    }
+}
+function sameJson(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+//# sourceMappingURL=ai-sdk.js.map

package/dist/ai-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.js","sourceRoot":"","sources":["../src/ai-sdk.ts"],"names":[],"mappings":"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"}

package/dist/ai-sdk.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ai-sdk.test.js

@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'vitest';
+import { WorkPaper } from './index.js';
+import { createWorkPaperToolHandlers } from './ai-sdk.js';
+describe('@bilig/workpaper AI SDK handlers', () => {
+    it('edits a WorkPaper input and returns computed restore proof', () => {
+        const workpaper = WorkPaper.buildFromSheets({
+            Inputs: [
+                ['Metric', 'Value'],
+                ['Qualified opportunities', 20],
+                ['Win rate', 0.25],
+                ['Average ARR', 12000],
+            ],
+            Summary: [
+                ['Metric', 'Value'],
+                ['Expected customers', '=Inputs!B2*Inputs!B3'],
+                ['Expected ARR', '=B2*Inputs!B4'],
+            ],
+        });
+        const handlers = createWorkPaperToolHandlers({
+            workpaper,
+            defaultReadRange: 'Summary!A1:B3',
+            proofRange: 'Summary!A1:B3',
+            writableSheets: ['Inputs'],
+        });
+        const before = handlers.readWorkPaperSummary();
+        const write = handlers.setWorkPaperInputCell({
+            sheetName: 'Inputs',
+            address: 'B3',
+            value: 0.4,
+        });
+        expect(readNumber(before.values, 2, 1)).toBe(60000);
+        expect(write.editedCell).toBe('Inputs!B3');
+        expect(readNumber(write.after.values, 2, 1)).toBe(96000);
+        expect(readNumber(write.restored.values, 2, 1)).toBe(96000);
+        expect(write.checks).toMatchObject({
+            previousValue: 0.25,
+            newValue: 0.4,
+            formulasPersisted: true,
+            restoredMatchesAfter: true,
+            proofRangeChanged: true,
+        });
+        expect(write.checks.serializedBytes).toBeGreaterThan(100);
+    });
+    it('blocks writes outside the configured input sheet boundary', () => {
+        const workpaper = WorkPaper.buildFromSheets({
+            Inputs: [['Metric', 'Value']],
+            Summary: [['Metric', '=1+1']],
+        });
+        const handlers = createWorkPaperToolHandlers({
+            workpaper,
+            defaultReadRange: 'Summary!A1:B1',
+            proofRange: 'Summary!A1:B1',
+            writableSheets: ['Inputs'],
+        });
+        expect(() => handlers.setWorkPaperInputCell({
+            sheetName: 'Summary',
+            address: 'B1',
+            value: 3,
+        })).toThrow('Sheet "Summary" is not writable');
+    });
+});
+function readNumber(values, row, col) {
+    const cell = values[row]?.[col];
+    if (!cell || typeof cell !== 'object' || !('value' in cell) || typeof cell.value !== 'number') {
+        throw new Error(`Expected numeric cell at row ${row}, col ${col}; received ${JSON.stringify(cell)}`);
+    }
+    return Math.round(cell.value * 100) / 100;
+}
+//# sourceMappingURL=ai-sdk.test.js.map

package/dist/ai-sdk.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.test.js","sourceRoot":"","sources":["../src/ai-sdk.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilig/workpaper",
-  "version": "0.107.8",
+  "version": "0.119.1",
   "description": "Scoped Bilig WorkPaper runtime and MCP server for Node.js services, agent tools, and server-side spreadsheet formulas.",
   "keywords": [
     "agent-tools",
@@ -66,6 +66,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./ai-sdk": {
+      "types": "./dist/ai-sdk.d.ts",
+      "import": "./dist/ai-sdk.js",
+      "default": "./dist/ai-sdk.js"
+    },
     "./mcp": {
       "types": "./dist/mcp.d.ts",
       "import": "./dist/mcp.js",
@@ -84,8 +89,24 @@
     "build": "pnpm --dir ../.. --filter bilig-workpaper build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@bilig/headless": "0.107.8",
-    "bilig-workpaper": "0.107.8"
+    "@bilig/headless": "0.119.1",
+    "bilig-workpaper": "0.119.1"
+  },
+  "devDependencies": {
+    "ai": "6.0.182",
+    "zod": "4.3.6"
+  },
+  "peerDependencies": {
+    "ai": ">=6.0.0",
+    "zod": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ai": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=22.0.0"

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.proompteng/bilig-workpaper",
   "title": "Bilig WorkPaper",
   "description": "WorkPaper MCP tools, resources, and prompts for readback, edits, and JSON persistence.",
-  "version": "0.107.8",
+  "version": "0.119.1",
   "repository": {
     "url": "https://github.com/proompteng/bilig",
     "source": "github"
@@ -18,7 +18,7 @@
     {
       "registryType": "npm",
       "identifier": "@bilig/workpaper",
-      "version": "0.107.8",
+      "version": "0.119.1",
       "transport": {
         "type": "stdio"
       }