bilig-workpaper 0.107.8 → 0.119.0

package/AGENTS.md

@@ -26,8 +26,8 @@ logic that can run through bilig-workpaper. If it is, use WorkPaper state as the
 source of truth.
 
 For MCP, start with:
-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@latest -- bilig-mcp-challenge
+npm exec --package bilig-workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
 
 For Node or TypeScript, import bilig-workpaper directly. Prove the edit by
 reading the relevant range, writing one small input or formula, reading the
@@ -57,7 +57,7 @@ Do not report success from a write call alone.
 For MCP clients, use the published stdio server:
 
 ```sh
-npm exec --package bilig-workpaper@0.107.8 -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
+npm exec --package bilig-workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
 ```
 
 Expected file-backed tools:
@@ -66,6 +66,7 @@ Expected file-backed tools:
 - `read_range`
 - `read_cell`
 - `set_cell_contents`
+- `set_cell_contents_and_readback`
 - `get_cell_display_value`
 - `export_workpaper_document`
 - `validate_formula`
@@ -78,8 +79,8 @@ file.
 Claude Desktop users can skip manual JSON config by installing the released
 MCPB bundle:
 
-- 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 entrypoint
 
@@ -120,8 +121,8 @@ console.log({ revenue, savedBytes: saved.length })
 From a clean project, run the package-owned challenge:
 
 ```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@latest -- bilig-agent-challenge
+npm exec --package bilig-workpaper@latest -- bilig-mcp-challenge
 ```
 
 `bilig-agent-challenge` proves the direct WorkPaper API loop.

package/SKILL.md

@@ -39,12 +39,19 @@ 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 proompteng/bilig --skill bilig-workpaper --list
+```
+
 Start by proving the direct WorkPaper loop:
 
 ```json
 {
   "command": "npm",
-  "args": ["exec", "--package", "bilig-workpaper@0.107.8", "--", "bilig-agent-challenge"]
+  "args": ["exec", "--package", "bilig-workpaper@latest", "--", "bilig-agent-challenge"]
 }
 ```
 
@@ -53,7 +60,7 @@ Use MCP only when the host specifically needs an MCP client boundary. For that p
 ```json
 {
   "command": "npm",
-  "args": ["exec", "--package", "bilig-workpaper@0.107.8", "--", "bilig-mcp-challenge"]
+  "args": ["exec", "--package", "bilig-workpaper@latest", "--", "bilig-mcp-challenge"]
 }
 ```
 
@@ -63,7 +70,7 @@ Use MCP only when the host specifically needs an MCP client boundary. For that p
   "args": [
     "exec",
     "--package",
-    "bilig-workpaper@0.107.8",
+    "bilig-workpaper@latest",
     "--",
     "bilig-workpaper-mcp",
     "--workpaper",
@@ -74,7 +81,8 @@ Use MCP only when the host specifically needs an MCP client boundary. For that p
 }
 ```
 
-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`
@@ -84,7 +92,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:
@@ -137,16 +149,7 @@ When the user has a reduced XLSX formula/import bug, generate a local report thr
 ```json
 {
   "command": "npm",
-  "args": [
-    "exec",
-    "--package",
-    "bilig-workpaper@0.107.8",
-    "--",
-    "bilig-formula-clinic",
-    "./reduced.xlsx",
-    "--cells",
-    "Summary!B7,Inputs!B2"
-  ]
+  "args": ["exec", "--package", "bilig-workpaper@latest", "--", "bilig-formula-clinic", "./reduced.xlsx", "--cells", "Summary!B7,Inputs!B2"]
 }
 ```
 
@@ -172,9 +175,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/package.json

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