@bilig/workpaper 0.131.0 → 0.131.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 +1 -1
- package/README.md +48 -29
- package/SKILL.md +1 -1
- package/package.json +4 -4
- package/server.json +2 -2
package/AGENTS.md
CHANGED
|
@@ -6,7 +6,7 @@ Use this file when an AI coding agent, MCP client, or tool host needs workbook f
|
|
|
6
6
|
|
|
7
7
|
1. Read `https://proompteng.github.io/bilig/llms.txt` for the compact map.
|
|
8
8
|
2. Read `https://proompteng.github.io/bilig/llms-full.txt` when you need enough context to implement a workflow without searching the whole site.
|
|
9
|
-
3. Use `https://proompteng.github.io/bilig/agent-adoption-kit.html` when you need the shortest no-key install, MCP proof, and
|
|
9
|
+
3. Use `https://proompteng.github.io/bilig/agent-adoption-kit.html` when you need the shortest no-key install, MCP proof, and workbook task.
|
|
10
10
|
4. If your host can install skills from a well-known endpoint, run
|
|
11
11
|
`npx --yes skills@latest add https://bilig.proompteng.ai --list`.
|
|
12
12
|
5. Read `https://bilig.proompteng.ai/.well-known/agent-skills/bilig-workpaper/SKILL.txt` when your agent supports skill manifests.
|
package/README.md
CHANGED
|
@@ -17,31 +17,51 @@ npm install @bilig/workpaper
|
|
|
17
17
|
|
|
18
18
|
## Start Here
|
|
19
19
|
|
|
20
|
-
Pick the
|
|
21
|
-
|
|
22
|
-
|
|
|
23
|
-
|
|
|
24
|
-
|
|
|
25
|
-
|
|
|
26
|
-
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
20
|
+
Pick the door that matches the state you own:
|
|
21
|
+
|
|
22
|
+
| Door | Run first | What it proves |
|
|
23
|
+
| -------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
|
|
24
|
+
| Node service or test | `npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door workpaper-service --json` | edit input, recalculate output, persist JSON, restore, and return `verified: true`. |
|
|
25
|
+
| Coding agent or MCP client | `npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json` | tool discovery, cell mutation, formula readback, JSON export, restart proof, and `verified: true`. |
|
|
26
|
+
| New project | `npm create @bilig/workpaper@latest pricing-agent -- --agent` | a starter with `AGENTS.md`, MCP config, and `npm run agent:verify` wired to the same proof loop. |
|
|
27
|
+
|
|
28
|
+
If one of those matches your workflow, keep Bilig nearby:
|
|
29
|
+
<https://github.com/proompteng/bilig>. Watch releases if this is close to a
|
|
30
|
+
production dependency: <https://github.com/proompteng/bilig/subscription>.
|
|
31
|
+
|
|
32
|
+
Framework examples live in the repo instead of this first screen. Start with
|
|
33
|
+
the closest runtime:
|
|
34
|
+
|
|
35
|
+
- Agent tools: Vercel AI SDK, LangGraph, LangChain MCP adapters, Open WebUI,
|
|
36
|
+
FastMCP, smolagents.
|
|
37
|
+
- Workflow engines: Trigger.dev, Inngest, Temporal, Airflow, Dagster, Kestra,
|
|
38
|
+
Prefect, Windmill.
|
|
39
|
+
- Low-code and data tools: n8n, Pipedream, Directus, Airbyte, Meltano.
|
|
40
|
+
- Existing `.xlsx` files: use `@bilig/xlsx-formula-recalc` for stale formula
|
|
41
|
+
caches and exported workbook readback.
|
|
42
|
+
|
|
43
|
+
## Searchable Example Guides
|
|
44
|
+
|
|
45
|
+
These are integration guide names that users search for on npm. They are links,
|
|
46
|
+
not the first-run path:
|
|
47
|
+
|
|
48
|
+
| Guide need | Start here |
|
|
49
|
+
| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
|
|
50
|
+
| Windmill TypeScript workflow fields | <https://proompteng.github.io/bilig/windmill-workpaper-script.html> |
|
|
51
|
+
| Trigger.dev durable task fields | <https://proompteng.github.io/bilig/triggerdev-workpaper-task.html> |
|
|
52
|
+
| Inngest durable step fields | <https://proompteng.github.io/bilig/inngest-workpaper-step.html> |
|
|
53
|
+
| Temporal TypeScript Activity decisions | <https://proompteng.github.io/bilig/temporal-workpaper-activity.html> |
|
|
54
|
+
| Apache Airflow DAG task outputs | <https://proompteng.github.io/bilig/airflow-workpaper-dag.html> |
|
|
55
|
+
| Dagster asset materialization metadata | <https://proompteng.github.io/bilig/dagster-workpaper-asset.html> |
|
|
56
|
+
| Kestra Node Commands flow fields | <https://proompteng.github.io/bilig/kestra-workpaper-flow.html> |
|
|
57
|
+
| Prefect flow fields | <https://proompteng.github.io/bilig/prefect-workpaper-flow.html> |
|
|
58
|
+
| Directus Flow operation for persisted calculated fields | <https://proompteng.github.io/bilig/directus-workpaper-flow-operation.html> |
|
|
59
|
+
| n8n formula readback for self-hosted workflows | <https://proompteng.github.io/bilig/n8n-workpaper-formula-readback.html> |
|
|
60
|
+
| Dify formula readback | <https://proompteng.github.io/bilig/dify-workpaper-formula-readback.html> |
|
|
61
|
+
| Flowise formula readback | <https://proompteng.github.io/bilig/flowise-workpaper-formula-readback.html> |
|
|
62
|
+
| Pipedream formula readback | <https://proompteng.github.io/bilig/pipedream-workpaper-formula-readback.html> |
|
|
63
|
+
| FastMCP Python client for hosted MCP smoke tests | <https://proompteng.github.io/bilig/fastmcp-workpaper-client.html> |
|
|
64
|
+
| Hugging Face smolagents tool | <https://proompteng.github.io/bilig/smolagents-workpaper-tool.html> |
|
|
45
65
|
|
|
46
66
|
## Use A WorkPaper In Node
|
|
47
67
|
|
|
@@ -148,10 +168,9 @@ The mutating tool returns `editedCell`, `before`, `after`, `restored`, and
|
|
|
148
168
|
`checks`. Keep `writableSheets` narrow so the model can edit inputs without
|
|
149
169
|
rewriting formula sheets.
|
|
150
170
|
|
|
151
|
-
##
|
|
171
|
+
## Verify Without Cloning
|
|
152
172
|
|
|
153
|
-
The package ships
|
|
154
|
-
coding agents and service evaluators:
|
|
173
|
+
The package ships evaluator and direct proof commands:
|
|
155
174
|
|
|
156
175
|
```sh
|
|
157
176
|
npm exec --package @bilig/workpaper@latest -- bilig-evaluate --door workpaper-service --json
|
|
@@ -163,7 +182,7 @@ npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./
|
|
|
163
182
|
```
|
|
164
183
|
|
|
165
184
|
`bilig-evaluate` prints a `bilig-evaluator.v1` object with `door`, `evidence`,
|
|
166
|
-
`verified`, `limitations`, and the
|
|
185
|
+
`verified`, `limitations`, and the source command output.
|
|
167
186
|
|
|
168
187
|
The challenge commands edit one input, recalculate dependent formulas, export
|
|
169
188
|
WorkPaper JSON, restore it, and print a `verified: true` proof object.
|
package/SKILL.md
CHANGED
|
@@ -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 XLSX formula bugs that need a
|
|
27
|
+
- reduced XLSX formula 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
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bilig/workpaper",
|
|
3
|
-
"version": "0.131.
|
|
3
|
+
"version": "0.131.2",
|
|
4
4
|
"description": "Scoped Bilig WorkPaper runtime and MCP server for Node.js services, agent tools, and server-side spreadsheet formulas.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agent-tools",
|
|
@@ -91,9 +91,9 @@
|
|
|
91
91
|
"build": "pnpm --dir ../.. --filter bilig-workpaper build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
|
|
92
92
|
},
|
|
93
93
|
"dependencies": {
|
|
94
|
-
"@bilig/headless": "0.131.
|
|
95
|
-
"@bilig/xlsx-formula-recalc": "0.131.
|
|
96
|
-
"bilig-workpaper": "0.131.
|
|
94
|
+
"@bilig/headless": "0.131.2",
|
|
95
|
+
"@bilig/xlsx-formula-recalc": "0.131.2",
|
|
96
|
+
"bilig-workpaper": "0.131.2"
|
|
97
97
|
},
|
|
98
98
|
"devDependencies": {
|
|
99
99
|
"ai": "6.0.182",
|
package/server.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"name": "io.github.proompteng/bilig-workpaper",
|
|
4
4
|
"title": "Bilig WorkPaper",
|
|
5
5
|
"description": "WorkPaper MCP tools, resources, and prompts for readback, edits, and JSON persistence.",
|
|
6
|
-
"version": "0.131.
|
|
6
|
+
"version": "0.131.2",
|
|
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.131.
|
|
21
|
+
"version": "0.131.2",
|
|
22
22
|
"transport": {
|
|
23
23
|
"type": "stdio"
|
|
24
24
|
}
|