bilig-workpaper 0.131.1 → 0.131.3

package/README.md

@@ -72,9 +72,9 @@ npm exec --package bilig-workpaper -- bilig-mcp-challenge
 npm exec --package bilig-workpaper -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
 ```
 
-`bilig-evaluate` prints the shared `bilig-evaluator.v1` proof shape; the
-challenge commands remain available for callers that already know the direct
-WorkPaper or MCP path they need.
+`bilig-evaluate` prints a `bilig-evaluator.v1` object. The challenge commands
+remain available for callers that already know the direct WorkPaper or MCP path
+they need.
 
 For a runnable starter project, use `npm create @bilig/workpaper`.
 

package/SKILL.md

@@ -24,7 +24,7 @@ Trigger this skill for tasks involving:
 - quote, budget, payout, pricing, import-validation, or forecast models;
 - agent spreadsheet tools that need deterministic cell addresses;
 - MCP clients that can run a stdio server or call a Streamable HTTP endpoint;
-- reduced XLSX formula bugs that need a paste-ready report.
+- reduced XLSX formula bugs that need a local report.
 
 Do not trigger it for manual spreadsheet editing, Office macros, VBA, pivots, charts, COM automation, or exact Excel desktop behavior unless the user explicitly asks to compare Bilig against an Excel oracle.
 
@@ -32,37 +32,39 @@ Do not trigger it for manual spreadsheet editing, Office macros, VBA, pivots, ch
 
 Do not build shell commands by concatenating user text. Treat the commands below as literal templates, validate workbook paths before use, and reject values containing newlines, backticks, `$(`, `;`, `&`, `|`, `<`, or `>`. Prefer MCP client `command` plus `args` arrays or direct TypeScript calls when inserting user-provided paths or cell references.
 
-## First Choice: Direct npm check or TypeScript
+## First Check: Agent Evaluator
 
-Use the package directly when the host can run npm or TypeScript. This is the
-highest-traffic evaluator path because it meets developers where they already
-search: npm, ExcelJS, SheetJS, xlsx-populate, and StackOverflow formula
-recalculation problems.
-
-If the host supports installable skills, first check that the public skill
-package is discoverable:
-
-```sh
-npx --yes skills@latest add https://bilig.proompteng.ai --list
-npx --yes skills@latest add proompteng/bilig --skill bilig-workpaper --list
-```
-
-Start by checking the direct WorkPaper loop:
+Before wiring a client, prove the published agent door with the package-owned evaluator.
+It exercises MCP discovery, cell mutation, formula readback, JSON export, restart restore, and returns `verified: true`:
 
 ```json
 {
   "command": "npm",
-  "args": ["exec", "--package", "bilig-workpaper@latest", "--", "bilig-agent-challenge", "--json"]
+  "args": ["exec", "--yes", "--package", "bilig-workpaper@latest", "--", "bilig-evaluate", "--door", "agent-mcp", "--json"]
 }
 ```
 
-Use MCP only when the host specifically needs an MCP client boundary. For that path, run the package-owned challenge first:
+For service-owned WorkPaper logic without MCP, run `bilig-evaluate --door workpaper-service --json`.
+Use the lower-level challenge commands only when debugging the direct API loop or file-backed MCP JSON-RPC transcript:
 
 ```json
-{
-  "command": "npm",
-  "args": ["exec", "--package", "bilig-workpaper@latest", "--", "bilig-mcp-challenge", "--json"]
-}
+[
+  { "command": "npm", "args": ["exec", "--package", "bilig-workpaper@latest", "--", "bilig-agent-challenge", "--json"] },
+  { "command": "npm", "args": ["exec", "--package", "bilig-workpaper@latest", "--", "bilig-mcp-challenge", "--json"] }
+]
+```
+
+## First Choice: MCP
+
+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 https://bilig.proompteng.ai --list
+npx --yes skills@latest add proompteng/bilig --skill bilig-workpaper --list
 ```
 
 ```json
@@ -82,13 +84,15 @@ Use MCP only when the host specifically needs an MCP client boundary. For that p
 }
 ```
 
-Run `bilig-mcp-challenge` and treat its returned `tools` array as the source
+Run `bilig-evaluate --door agent-mcp --json` first. If the evaluator fails,
+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`
 - `read_cell`
 - `set_cell_contents`
+- `set_cell_contents_and_readback`
 - `get_cell_display_value`
 - `export_workpaper_document`
 - `validate_formula`
@@ -182,6 +186,7 @@ If any readback step fails, report the blocker instead of claiming the workbook
 - 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
+- Hugging Face WorkPaper Space template: https://proompteng.github.io/bilig/huggingface-workpaper-space.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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bilig-workpaper",
-  "version": "0.131.1",
+  "version": "0.131.3",
   "description": "Bilig WorkPaper runtime for Node.js services, agent tools, and server-side spreadsheet formulas.",
   "keywords": [
     "agent-tools",
@@ -83,8 +83,8 @@
     "build": "pnpm --dir ../.. --filter @bilig/headless build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@bilig/headless": "0.131.1",
-    "@bilig/xlsx-formula-recalc": "0.131.1"
+    "@bilig/headless": "0.131.3",
+    "@bilig/xlsx-formula-recalc": "0.131.3"
   },
   "engines": {
     "node": ">=22.0.0"