@bilig/workpaper 0.159.0 → 0.160.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/AGENTS.md +2 -0
  2. package/README.md +3 -0
  3. package/SKILL.md +6 -0
  4. package/dist/work-paper-mcp-stdio-bin.js +11 -1
  5. package/dist/work-paper-mcp-stdio-bin.js.map +1 -1
  6. package/package.json +5 -5
  7. package/server.json +3 -3
package/AGENTS.md CHANGED
@@ -66,10 +66,12 @@ npm exec --yes --package @bilig/workpaper@latest -- bilig-agent-start --json
66
66
  npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door workpaper-service --json
67
67
  npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json
68
68
  npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --scenario provider-backed --json
69
+ npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- bilig-evaluate --door workbook-compatibility --json
69
70
  npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- bilig-evaluate --door xlsx-cache --json
70
71
  npm exec --package @bilig/workpaper@latest -- bilig-agent-challenge --json
71
72
  npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge --json
72
73
  npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
74
+ npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp --from-xlsx ./pricing.xlsx --workpaper ./.bilig/pricing.workpaper.json --writable
73
75
  npm exec --package @bilig/workpaper@latest -- bilig-formula-clinic ./reduced.xlsx --cells "Summary!B7,Inputs!B2"
74
76
  ```
75
77
 
package/README.md CHANGED
@@ -251,6 +251,9 @@ The challenge commands edit one input, recalculate dependent formulas, export
251
251
  WorkPaper JSON, restore it, and print a `verified: true` proof object.
252
252
  Use `--from-xlsx` when the agent already has an XLSX file: Bilig imports it once
253
253
  into persisted WorkPaper JSON, then starts the same file-backed MCP server.
254
+ That XLSX-backed MCP path also lists `analyze_workbook_risk`, a read-only tool
255
+ fixed to the source workbook passed at startup. It reports workbook risk
256
+ indicators before an agent trusts the imported WorkPaper and does not certify Excel compatibility.
254
257
 
255
258
  ## Agent Adoption Kit
256
259
 
package/SKILL.md CHANGED
@@ -111,6 +111,12 @@ treat its returned `tools` array as the source of truth for the currently publis
111
111
  - `export_workpaper_document`
112
112
  - `validate_formula`
113
113
 
114
+ When the server is started through `@bilig/workpaper@latest` with
115
+ `--from-xlsx ./pricing.xlsx --workpaper ./.bilig/pricing.workpaper.json`,
116
+ `tools/list` also includes `analyze_workbook_risk`. That tool is fixed to
117
+ the source XLSX passed at startup and reports workbook risk indicators before an
118
+ agent trusts the imported WorkPaper. It does not certify Excel compatibility.
119
+
114
120
  After a write, always read the dependent output cell and export the WorkPaper
115
121
  document. If the listed tool set includes `set_cell_contents_and_readback`,
116
122
  prefer it for stateless clients because the edit and dependent readback happen
package/dist/work-paper-mcp-stdio-bin.js CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { buildDemoWorkPaper, createFileBackedWorkPaperMcpToolServer, createFileBackedWorkPaperMcpToolServerFromFile, parseWorkPaperMcpStdioCliArgs, runDemoWorkPaperMcpStdioServer, workPaperMcpStdioHelpText, } from '@bilig/headless/mcp';
2
+ import { buildDemoWorkPaper, createFileBackedWorkPaperMcpToolServer, createFileBackedWorkPaperMcpToolServerFromFile, createFileBackedWorkPaperMcpToolServerFromXlsxFile, parseWorkPaperMcpStdioCliArgs, runDemoWorkPaperMcpStdioServer, withXlsxWorkbookRiskTool, workPaperMcpStdioHelpText, } from 'bilig-workpaper/mcp';
3
3
  const cliOptions = parseWorkPaperMcpStdioCliArgs(process.argv.slice(2));
4
4
  if (cliOptions.help) {
5
5
  process.stdout.write(workPaperMcpStdioHelpText());
@@ -17,6 +17,16 @@ if (cliOptions.demoWorkPaperTools) {
17
17
  else if (cliOptions.workpaperPath === undefined) {
18
18
  runDemoWorkPaperMcpStdioServer();
19
19
  }
20
+ else if (cliOptions.fromXlsxPath !== undefined) {
21
+ runDemoWorkPaperMcpStdioServer({
22
+ server: withXlsxWorkbookRiskTool(createFileBackedWorkPaperMcpToolServerFromXlsxFile({
23
+ fromXlsxPath: cliOptions.fromXlsxPath,
24
+ overwriteWorkPaper: cliOptions.overwriteWorkPaper,
25
+ workpaperPath: cliOptions.workpaperPath,
26
+ writable: cliOptions.writable,
27
+ }), { xlsxPath: cliOptions.fromXlsxPath }),
28
+ });
29
+ }
20
30
  else {
21
31
  runDemoWorkPaperMcpStdioServer({
22
32
  server: createFileBackedWorkPaperMcpToolServerFromFile({
package/dist/work-paper-mcp-stdio-bin.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"work-paper-mcp-stdio-bin.js","sourceRoot":"","sources":["../src/work-paper-mcp-stdio-bin.ts"],"names":[],"mappings":";AACA,OAAO,EACL,kBAAkB,EAClB,sCAAsC,EACtC,8CAA8C,EAC9C,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAE5B,MAAM,UAAU,GAAG,6BAA6B,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACvE,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;IACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,IAAI,UAAU,CAAC,kBAAkB,EAAE,CAAC;IAClC,8BAA8B,CAAC;QAC7B,MAAM,EAAE,sCAAsC,CAAC;YAC7C,QAAQ,EAAE,kBAAkB,EAAE;YAC9B,UAAU,EAAE,wBAAwB;YACpC,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAC,CAAA;AACJ,CAAC;KAAM,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;IAClD,8BAA8B,EAAE,CAAA;AAClC,CAAC;KAAM,CAAC;IACN,8BAA8B,CAAC;QAC7B,MAAM,EAAE,8CAA8C,CAAC;YACrD,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC;KACH,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"work-paper-mcp-stdio-bin.js","sourceRoot":"","sources":["../src/work-paper-mcp-stdio-bin.ts"],"names":[],"mappings":";AACA,OAAO,EACL,kBAAkB,EAClB,sCAAsC,EACtC,8CAA8C,EAC9C,kDAAkD,EAClD,6BAA6B,EAC7B,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAE5B,MAAM,UAAU,GAAG,6BAA6B,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACvE,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;IACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,IAAI,UAAU,CAAC,kBAAkB,EAAE,CAAC;IAClC,8BAA8B,CAAC;QAC7B,MAAM,EAAE,sCAAsC,CAAC;YAC7C,QAAQ,EAAE,kBAAkB,EAAE;YAC9B,UAAU,EAAE,wBAAwB;YACpC,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAC,CAAA;AACJ,CAAC;KAAM,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;IAClD,8BAA8B,EAAE,CAAA;AAClC,CAAC;KAAM,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;IACjD,8BAA8B,CAAC;QAC7B,MAAM,EAAE,wBAAwB,CAC9B,kDAAkD,CAAC;YACjD,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;YACjD,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC,EACF,EAAE,QAAQ,EAAE,UAAU,CAAC,YAAY,EAAE,CACtC;KACF,CAAC,CAAA;AACJ,CAAC;KAAM,CAAC;IACN,8BAA8B,CAAC;QAC7B,MAAM,EAAE,8CAA8C,CAAC;YACrD,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC;KACH,CAAC,CAAA;AACJ,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bilig/workpaper",
3
- "version": "0.159.0",
3
+ "version": "0.160.1",
4
4
  "description": "WorkPaper API, CLI evaluator, and MCP server for headless spreadsheet formulas in Node.js services and agents.",
5
5
  "keywords": [
6
6
  "agent-tools",
@@ -28,7 +28,7 @@
28
28
  "workpaper",
29
29
  "xlsx"
30
30
  ],
31
- "homepage": "https://proompteng.github.io/bilig/",
31
+ "homepage": "https://proompteng.github.io/bilig/agent-framework-workbook-tools.html",
32
32
  "bugs": {
33
33
  "url": "https://github.com/proompteng/bilig/issues"
34
34
  },
@@ -89,9 +89,9 @@
89
89
  "build": "pnpm --dir ../.. --filter bilig-workpaper build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
90
90
  },
91
91
  "dependencies": {
92
- "@bilig/headless": "0.159.0",
93
- "@bilig/xlsx-formula-recalc": "0.159.0",
94
- "bilig-workpaper": "0.159.0"
92
+ "@bilig/headless": "0.160.1",
93
+ "@bilig/xlsx-formula-recalc": "0.160.1",
94
+ "bilig-workpaper": "0.160.1"
95
95
  },
96
96
  "devDependencies": {
97
97
  "ai": "6.0.195",
package/server.json CHANGED
@@ -2,8 +2,8 @@
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "io.github.proompteng/bilig-workpaper",
4
4
  "title": "Bilig WorkPaper",
5
- "description": "WorkPaper MCP tools, resources, and prompts for readback, edits, and JSON persistence.",
6
- "version": "0.159.0",
5
+ "description": "Formula readback, input edits, JSON persistence, and workbook risk preflight for agents.",
6
+ "version": "0.160.1",
7
7
  "repository": {
8
8
  "url": "https://github.com/proompteng/bilig",
9
9
  "source": "github"
@@ -18,7 +18,7 @@
18
18
  {
19
19
  "registryType": "npm",
20
20
  "identifier": "@bilig/workpaper",
21
- "version": "0.159.0",
21
+ "version": "0.160.1",
22
22
  "transport": {
23
23
  "type": "stdio"
24
24
  }