bilig-workpaper 0.164.0 → 0.164.2
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.
- package/AGENTS.md +4 -5
- package/README.md +5 -5
- package/SKILL.md +11 -12
- package/dist/work-paper-mcp-xlsx-risk-tool.js +1 -1
- package/dist/work-paper-mcp-xlsx-risk-tool.js.map +1 -1
- package/package.json +5 -7
package/AGENTS.md
CHANGED
|
@@ -9,7 +9,7 @@ driving a spreadsheet UI.
|
|
|
9
9
|
|
|
10
10
|
Use `bilig-workpaper` first when the task is workbook-shaped business logic:
|
|
11
11
|
pricing, quote approval, budget checks, payout models, import validation,
|
|
12
|
-
forecasting, or
|
|
12
|
+
forecasting, or tool integrations that need formula readback.
|
|
13
13
|
|
|
14
14
|
Use `bilig-workpaper` only when the task explicitly targets lower-level
|
|
15
15
|
runtime subpaths, package-boundary audits, provenance checks, or internals of
|
|
@@ -21,7 +21,7 @@ are for human visual review, not formula truth.
|
|
|
21
21
|
|
|
22
22
|
## Handoff prompt
|
|
23
23
|
|
|
24
|
-
Paste this into
|
|
24
|
+
Paste this into a tool host when it is about to automate a spreadsheet
|
|
25
25
|
through a desktop app or browser grid:
|
|
26
26
|
|
|
27
27
|
```text
|
|
@@ -51,7 +51,7 @@ verified, and limitations. Do not claim success from a write call alone.
|
|
|
51
51
|
|
|
52
52
|
## Minimum edit loop
|
|
53
53
|
|
|
54
|
-
For every
|
|
54
|
+
For every tool-owned workbook edit:
|
|
55
55
|
|
|
56
56
|
1. identify the exact sheet and A1 cell or range.
|
|
57
57
|
2. read the current input and dependent output.
|
|
@@ -90,7 +90,7 @@ file.
|
|
|
90
90
|
When the server is started through `bilig-workpaper@latest` with
|
|
91
91
|
`--from-xlsx ./pricing.xlsx`, `tools/list` also includes
|
|
92
92
|
`analyze_workbook_risk`. That tool is fixed to the source XLSX passed at
|
|
93
|
-
startup and reports workbook risk indicators before
|
|
93
|
+
startup and reports workbook risk indicators before a workflow trusts the imported
|
|
94
94
|
WorkPaper. Without `--workpaper --writable`, edits stay in memory; add a
|
|
95
95
|
WorkPaper JSON path only when the task needs persisted file state. It does not
|
|
96
96
|
certify Excel compatibility.
|
|
@@ -153,7 +153,6 @@ npm exec --yes --package bilig-workpaper@latest -- bilig-agent-start --json
|
|
|
153
153
|
npm exec --yes --package bilig-workpaper@latest -- bilig-evaluate --door workpaper-service --json
|
|
154
154
|
npm exec --yes --package bilig-workpaper@latest -- bilig-evaluate --door agent-mcp --json
|
|
155
155
|
npm exec --yes --package bilig-workpaper@latest -- bilig-evaluate --door agent-mcp --scenario provider-backed --json
|
|
156
|
-
npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- bilig-evaluate --door xlsx-cache --json
|
|
157
156
|
npm exec --package bilig-workpaper@latest -- bilig-agent-challenge --json
|
|
158
157
|
npm exec --package bilig-workpaper@latest -- bilig-mcp-challenge --json
|
|
159
158
|
pnpm --dir examples/headless-workpaper run agent:mcp-xlsx-risk-preflight
|
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# bilig-workpaper
|
|
2
2
|
|
|
3
|
-
Bilig WorkPaper runtime for Node.js services,
|
|
3
|
+
Bilig WorkPaper runtime for Node.js services, tool integrations, and server-side spreadsheet formulas.
|
|
4
4
|
|
|
5
|
-
This is the unscoped npm entrypoint for the Bilig headless runtime. Use it when business logic is easiest to review as workbook cells and formulas, but the calculation needs to run in a backend service, queue worker, serverless route, test, or
|
|
5
|
+
This is the unscoped npm entrypoint for the Bilig headless runtime. Use it when business logic is easiest to review as workbook cells and formulas, but the calculation needs to run in a backend service, queue worker, serverless route, test, or tool integration.
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
@@ -51,10 +51,10 @@ import { exportXlsx, importXlsx } from 'bilig-workpaper/xlsx'
|
|
|
51
51
|
|
|
52
52
|
Use `xlsx-formula-recalc` when you only need to edit and recalculate XLSX files. Use `exceljs-formula-recalc` when you already use ExcelJS and need recalculated formula results after changing inputs.
|
|
53
53
|
|
|
54
|
-
##
|
|
54
|
+
## Tool Commands And Optional MCP
|
|
55
55
|
|
|
56
56
|
The npm tarball includes `AGENTS.md`, `SKILL.md`, and the same CLI entrypoints
|
|
57
|
-
as `@bilig/headless`, so
|
|
57
|
+
as `@bilig/headless`, so tool hosts can inspect `node_modules/bilig-workpaper`
|
|
58
58
|
without discovering the scoped package first.
|
|
59
59
|
|
|
60
60
|
```ts
|
|
@@ -79,6 +79,6 @@ For a runnable starter project, use `npm create @bilig/workpaper`.
|
|
|
79
79
|
|
|
80
80
|
## Scope
|
|
81
81
|
|
|
82
|
-
Bilig is not a desktop Excel clone. It is a formula workbook runtime for service-owned calculations, JSON persistence, XLSX import/export, and
|
|
82
|
+
Bilig is not a desktop Excel clone. It is a formula workbook runtime for service-owned calculations, JSON persistence, XLSX import/export, and verified readback. Unsupported Excel functions, external workbook links, macros, and volatile functions may need review.
|
|
83
83
|
|
|
84
84
|
Full docs: <https://proompteng.github.io/bilig/>
|
package/SKILL.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: bilig-workpaper
|
|
3
3
|
version: 0.1.0
|
|
4
|
-
description: Use bilig-workpaper WorkPaper state for workbook formulas,
|
|
4
|
+
description: Use bilig-workpaper WorkPaper state for workbook formulas, MCP editing, and tool integrations without driving spreadsheet UI.
|
|
5
5
|
tags:
|
|
6
|
-
-
|
|
6
|
+
- agents
|
|
7
7
|
- spreadsheet-automation
|
|
8
8
|
- formulas
|
|
9
|
-
-
|
|
9
|
+
- workpaper
|
|
10
10
|
- mcp
|
|
11
11
|
- typescript
|
|
12
12
|
---
|
|
@@ -24,7 +24,7 @@ Trigger this skill for tasks involving:
|
|
|
24
24
|
- quote, budget, payout, pricing, import-validation, or forecast models;
|
|
25
25
|
- agent spreadsheet tools that need deterministic cell addresses;
|
|
26
26
|
- MCP clients that can run a stdio server or call a Streamable HTTP endpoint;
|
|
27
|
-
- reduced
|
|
27
|
+
- reduced formula/import bugs that need a local report.
|
|
28
28
|
|
|
29
29
|
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.
|
|
30
30
|
|
|
@@ -114,7 +114,7 @@ treat its returned `tools` array as the source of truth for the currently publis
|
|
|
114
114
|
When the server is started through `bilig-workpaper@latest` with
|
|
115
115
|
`--from-xlsx ./pricing.xlsx`, `tools/list` also includes
|
|
116
116
|
`analyze_workbook_risk`. That tool is fixed to the source XLSX passed at
|
|
117
|
-
startup and reports workbook risk indicators before
|
|
117
|
+
startup and reports workbook risk indicators before a workflow trusts the imported
|
|
118
118
|
WorkPaper. Without `--workpaper --writable`, edits stay in memory; add a
|
|
119
119
|
WorkPaper JSON path only when the task needs persisted file state. It does not
|
|
120
120
|
certify Excel compatibility.
|
|
@@ -177,9 +177,9 @@ console.log({
|
|
|
177
177
|
book.dispose()
|
|
178
178
|
```
|
|
179
179
|
|
|
180
|
-
##
|
|
180
|
+
## Formula Clinic
|
|
181
181
|
|
|
182
|
-
When the user has a reduced
|
|
182
|
+
When the user has a reduced workbook formula/import bug, generate a local report through an argument array:
|
|
183
183
|
|
|
184
184
|
```json
|
|
185
185
|
{
|
|
@@ -192,7 +192,7 @@ The report is local. It does not upload workbook contents. Ask for a reduced pub
|
|
|
192
192
|
|
|
193
193
|
## Required Verification
|
|
194
194
|
|
|
195
|
-
Return readback, not
|
|
195
|
+
Return readback, not a write-only claim. A successful agent response should include:
|
|
196
196
|
|
|
197
197
|
- the exact edited sheet and A1 cell;
|
|
198
198
|
- before values for relevant inputs and dependent outputs;
|
|
@@ -206,8 +206,8 @@ If any readback step fails, report the blocker instead of claiming the workbook
|
|
|
206
206
|
## Reference URLs
|
|
207
207
|
|
|
208
208
|
- Compact docs map: https://proompteng.github.io/bilig/llms.txt
|
|
209
|
-
- Full
|
|
210
|
-
-
|
|
209
|
+
- Full host context: https://proompteng.github.io/bilig/llms-full.txt
|
|
210
|
+
- Host handbook: https://proompteng.github.io/bilig/headless-workpaper-agent-handbook.html
|
|
211
211
|
- Agent workbook challenge: https://proompteng.github.io/bilig/agent-workbook-challenge.html
|
|
212
212
|
- MCP server guide: https://proompteng.github.io/bilig/mcp-workpaper-tool-server.html
|
|
213
213
|
- OpenHands MCP setup: https://proompteng.github.io/bilig/openhands-workpaper-mcp.html
|
|
@@ -232,7 +232,6 @@ If any readback step fails, report the blocker instead of claiming the workbook
|
|
|
232
232
|
- Dagster asset: https://proompteng.github.io/bilig/dagster-workpaper-asset.html
|
|
233
233
|
- Kestra Node flow: https://proompteng.github.io/bilig/kestra-workpaper-flow.html
|
|
234
234
|
- Prefect flow: https://proompteng.github.io/bilig/prefect-workpaper-flow.html
|
|
235
|
-
-
|
|
236
|
-
- Stale XLSX fixture command: npm exec --package @bilig/xlsx-formula-recalc@latest -- xlsx-cache-doctor ./reduced.xlsx --json
|
|
235
|
+
- Formula clinic: https://proompteng.github.io/bilig/formula-bug-clinic.html
|
|
237
236
|
- Compatibility limits: https://proompteng.github.io/bilig/where-bilig-is-not-excel-compatible-yet.html
|
|
238
237
|
- Repository: https://github.com/proompteng/bilig
|
|
@@ -4,7 +4,7 @@ const defaultXlsxWorkbookRiskInspectLimit = 2000;
|
|
|
4
4
|
const xlsxWorkbookRiskToolDefinition = {
|
|
5
5
|
name: 'analyze_workbook_risk',
|
|
6
6
|
title: 'Analyze XLSX Workbook Risk',
|
|
7
|
-
description: 'Analyze the XLSX file that started this MCP server and return workbook risk indicators before
|
|
7
|
+
description: 'Analyze the XLSX file that started this MCP server and return workbook risk indicators before the workflow trusts the imported WorkPaper. This diagnostic does not certify Excel compatibility.',
|
|
8
8
|
inputSchema: {
|
|
9
9
|
type: 'object',
|
|
10
10
|
properties: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"work-paper-mcp-xlsx-risk-tool.js","sourceRoot":"","sources":["../src/work-paper-mcp-xlsx-risk-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAG7C,OAAO,EAAE,wCAAwC,EAAoC,MAAM,2CAA2C,CAAA;AAOtI,MAAM,mCAAmC,GAAG,IAAI,CAAA;AAEhD,MAAM,8BAA8B,GAAG;IACrC,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,4BAA4B;IACnC,WAAW,EACT,
|
|
1
|
+
{"version":3,"file":"work-paper-mcp-xlsx-risk-tool.js","sourceRoot":"","sources":["../src/work-paper-mcp-xlsx-risk-tool.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,10 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bilig-workpaper",
|
|
3
|
-
"version": "0.164.
|
|
4
|
-
"description": "Bilig WorkPaper runtime for Node
|
|
3
|
+
"version": "0.164.2",
|
|
4
|
+
"description": "Bilig WorkPaper runtime for Node services: edit inputs, recalculate formulas, read outputs, and save JSON.",
|
|
5
5
|
"keywords": [
|
|
6
|
-
"agent-tools",
|
|
7
|
-
"ai-agents",
|
|
8
6
|
"bilig",
|
|
9
7
|
"bilig-workpaper",
|
|
10
8
|
"excel",
|
|
@@ -88,9 +86,9 @@
|
|
|
88
86
|
"build": "pnpm --dir ../.. --filter @bilig/xlsx build && pnpm --dir ../.. --filter @bilig/headless build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
|
|
89
87
|
},
|
|
90
88
|
"dependencies": {
|
|
91
|
-
"@bilig/headless": "0.164.
|
|
92
|
-
"@bilig/protocol": "0.164.
|
|
93
|
-
"@bilig/xlsx": "0.164.
|
|
89
|
+
"@bilig/headless": "0.164.2",
|
|
90
|
+
"@bilig/protocol": "0.164.2",
|
|
91
|
+
"@bilig/xlsx": "0.164.2"
|
|
94
92
|
},
|
|
95
93
|
"engines": {
|
|
96
94
|
"node": ">=22.0.0"
|