@bilig/workpaper 0.155.0 → 0.159.0

package/AGENTS.md

@@ -15,18 +15,23 @@ Use this file when an AI coding agent, MCP client, or tool host needs workbook f
    `npx --yes skills@latest add proompteng/bilig --skill bilig-workpaper --list`.
 8. If you are using GitHub Copilot or VS Code agent mode in a cloned checkout,
    use `.github/copilot-instructions.md`,
+   `.github/instructions/bilig-workpaper.instructions.md`,
    `.github/prompts/bilig-workpaper-proof.prompt.md`, and
    `.vscode/mcp.json`.
-9. If you are inside a cloned Bilig repository with Claude Code, use the
-   project skill at `.claude/skills/bilig-workpaper/SKILL.md` or invoke the
-   explicit formula-proof command from
+9. If you are inside a cloned Bilig repository with Claude Code, read
+   `CLAUDE.md` first, then use the project skill at
+   `.claude/skills/bilig-workpaper/SKILL.md` or invoke the explicit
+   formula-proof command from
    `.claude/commands/bilig-workpaper-proof.md`.
-10. If you are using Cursor, Windsurf/Cascade, Cline, or Continue, use
+10. If you are using OpenCode, use `opencode.jsonc` and
+    `.opencode/agents/bilig-workpaper.md`.
+11. If you are using Cursor, Windsurf/Cascade, Cline, or Continue, use
     `.cursor/rules/bilig-workpaper.mdc` or
+    `.devin/rules/bilig-workpaper.md`,
     `.windsurf/rules/bilig-workpaper.md`,
     `.clinerules/bilig-workpaper.md`, or
     `.continue/rules/bilig-workpaper.md`.
-11. Start the MCP server or import `@bilig/workpaper` directly.
+12. Start the MCP server or import `@bilig/workpaper` directly.
 
 Remote MCP clients that support Streamable HTTP can smoke-test the stateless
 demo endpoint at `https://bilig.proompteng.ai/mcp`. Directory scanners that inspect the

package/README.md

@@ -120,6 +120,7 @@ not the first-run path:
 | FastMCP Python client for hosted and local stdio checks | <https://proompteng.github.io/bilig/fastmcp-workpaper-client.html>             |
 | Agno MCPTools workbook readback                         | <https://proompteng.github.io/bilig/agno-workpaper-mcp.html>                   |
 | Pydantic AI MCPToolset typed readback                   | <https://proompteng.github.io/bilig/pydantic-ai-workpaper-mcp.html>            |
+| Google ADK McpToolset workbook readback                 | <https://proompteng.github.io/bilig/google-adk-workpaper-mcp.html>             |
 | Hugging Face smolagents tool                            | <https://proompteng.github.io/bilig/smolagents-workpaper-tool.html>            |
 | Hugging Face Gradio MCP Space                           | <https://proompteng.github.io/bilig/huggingface-workpaper-space.html>          |
 

package/SKILL.md

@@ -203,6 +203,8 @@ If any readback step fails, report the blocker instead of claiming the workbook
 - 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
+- OpenHands MCP setup: https://proompteng.github.io/bilig/openhands-workpaper-mcp.html
+- OpenCode MCP setup: https://proompteng.github.io/bilig/opencode-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
@@ -223,5 +225,6 @@ If any readback step fails, report the blocker instead of claiming the workbook
 - 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
+- Stale XLSX fixture command: npm exec --package @bilig/xlsx-formula-recalc@latest -- xlsx-cache-doctor ./reduced.xlsx --json
 - Compatibility limits: https://proompteng.github.io/bilig/where-bilig-is-not-excel-compatible-yet.html
 - Repository: https://github.com/proompteng/bilig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilig/workpaper",
-  "version": "0.155.0",
+  "version": "0.159.0",
   "description": "WorkPaper API, CLI evaluator, and MCP server for headless spreadsheet formulas in Node.js services and agents.",
   "keywords": [
     "agent-tools",
@@ -89,12 +89,12 @@
     "build": "pnpm --dir ../.. --filter bilig-workpaper build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@bilig/headless": "0.155.0",
-    "@bilig/xlsx-formula-recalc": "0.155.0",
-    "bilig-workpaper": "0.155.0"
+    "@bilig/headless": "0.159.0",
+    "@bilig/xlsx-formula-recalc": "0.159.0",
+    "bilig-workpaper": "0.159.0"
   },
   "devDependencies": {
-    "ai": "6.0.182",
+    "ai": "6.0.195",
     "zod": "4.3.6"
   },
   "peerDependencies": {

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.155.0",
+  "version": "0.159.0",
   "repository": {
     "url": "https://github.com/proompteng/bilig",
     "source": "github"
@@ -18,7 +18,7 @@
     {
       "registryType": "npm",
       "identifier": "@bilig/workpaper",
-      "version": "0.155.0",
+      "version": "0.159.0",
       "transport": {
         "type": "stdio"
       }

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

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

package/dist/ai-sdk.test.js

@@ -1,69 +0,0 @@
-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

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