@bilig/workpaper 0.119.0 → 0.119.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/README.md +33 -29
- package/package.json +3 -3
- package/server.json +2 -2
package/README.md
CHANGED
|
@@ -19,29 +19,29 @@ npm install @bilig/workpaper
|
|
|
19
19
|
|
|
20
20
|
Pick the path that matches the workflow you are trying to unblock:
|
|
21
21
|
|
|
22
|
-
| You need...
|
|
23
|
-
|
|
|
24
|
-
| Formula workbook logic inside a Node service, route, queue, or test
|
|
25
|
-
| A coding agent or MCP client that needs spreadsheet operations
|
|
26
|
-
| Windmill TypeScript workflow fields
|
|
27
|
-
| Trigger.dev durable task fields
|
|
28
|
-
| Inngest durable step fields
|
|
29
|
-
| Airbyte post-sync record and state validation
|
|
30
|
-
| Meltano custom utility validation
|
|
31
|
-
| Temporal TypeScript Activity decisions
|
|
32
|
-
| Apache Airflow DAG task outputs
|
|
33
|
-
| Dagster asset materialization metadata
|
|
34
|
-
| Kestra Node Commands flow fields
|
|
35
|
-
| Prefect flow fields
|
|
36
|
-
| Directus Flow operation for persisted calculated fields
|
|
37
|
-
| n8n, Dify, or
|
|
38
|
-
| Vercel AI SDK `generateText()` or `streamText()` tools
|
|
39
|
-
| Open WebUI needs MCP spreadsheet tools
|
|
40
|
-
| FastMCP Python client for hosted MCP smoke tests
|
|
41
|
-
| LangGraph.js ToolNode should keep formula proof in state
|
|
42
|
-
| LangChain MCP adapters should load WorkPaper tools
|
|
43
|
-
| Hugging Face smolagents tool
|
|
44
|
-
| An existing `.xlsx` file with stale formula results after Node edits
|
|
22
|
+
| You need... | Run this first | Proof you should get |
|
|
23
|
+
| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
24
|
+
| Formula workbook logic inside a Node service, route, queue, or test | `npm create @bilig/workpaper@latest pricing-workpaper` | Inputs are written, formulas recalculate, JSON persists, restore matches readback, and `verified: true` is printed. |
|
|
25
|
+
| A coding agent or MCP client that needs spreadsheet operations | `npm create @bilig/workpaper@latest pricing-agent -- --agent` | The generated project includes an agent contract, MCP config, and `npm run agent:verify`. |
|
|
26
|
+
| Windmill TypeScript workflow fields | `cd examples/windmill-workpaper-script && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The script returns a calculated field patch plus before/after/restore WorkPaper proof with `verified: true`. |
|
|
27
|
+
| Trigger.dev durable task fields | `cd examples/triggerdev-workpaper-task && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The task helper returns a calculated field patch plus before/after/restore WorkPaper proof with `verified: true`. |
|
|
28
|
+
| Inngest durable step fields | `cd examples/inngest-workpaper-step && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The step helper returns a calculated field patch plus before/after/restore WorkPaper proof with `verified: true`. |
|
|
29
|
+
| Airbyte post-sync record and state validation | `cd examples/airbyte-workpaper-validation && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The validation step reads Airbyte-style `STREAM`/`GLOBAL` state JSONL and returns a patch plus restore proof. |
|
|
30
|
+
| Meltano custom utility validation | `cd examples/meltano-workpaper-utility && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The utility reads a post-ELT JSONL export and writes a formula-backed WorkPaper proof artifact. |
|
|
31
|
+
| Temporal TypeScript Activity decisions | `cd examples/temporal-workpaper-activity && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The Activity owns WorkPaper formula work while Workflow code stays free of workbook imports. |
|
|
32
|
+
| Apache Airflow DAG task outputs | `cd examples/airflow-workpaper-dag && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The Node step writes a full proof file while the DAG returns a compact XCom summary for downstream tasks. |
|
|
33
|
+
| Dagster asset materialization metadata | `cd examples/dagster-workpaper-asset && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The Node subprocess writes WorkPaper proof and emits compact Dagster Pipes materialization metadata. |
|
|
34
|
+
| Kestra Node Commands flow fields | `cd examples/kestra-workpaper-flow && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The flow script writes a `workpaper-proof.json` artifact with before/after/restore proof and `verified: true`. |
|
|
35
|
+
| Prefect flow fields | `cd examples/prefect-workpaper-flow && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | The Node step writes a `workpaper-proof.json` artifact that a Prefect task can validate and return. |
|
|
36
|
+
| Directus Flow operation for persisted calculated fields | `cd examples/directus-workpaper-flow-operation && npm install && npm run smoke` | The operation returns a Directus `patch` plus before/after/restore WorkPaper proof with `verified: true`. |
|
|
37
|
+
| n8n, Dify, Flowise, or Pipedream formula readback without spreadsheet UI automation | `npm exec --package @bilig/workpaper@latest -- bilig-n8n-formula-server --port 4321` | The workflow writes one input cell, reads dependent formula output, and returns a compact JSON proof. |
|
|
38
|
+
| Vercel AI SDK `generateText()` or `streamText()` tools | Import `createAiSdkWorkPaperTools` from `@bilig/workpaper/ai-sdk` | The tool call returns before/after/restore formula readback instead of a blind write result. |
|
|
39
|
+
| Open WebUI needs MCP spreadsheet tools | `npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge --json` | Open WebUI can call the hosted Streamable HTTP endpoint or a local stdio server bridged through `mcpo`. |
|
|
40
|
+
| FastMCP Python client for hosted MCP smoke tests | `cd examples/fastmcp-workpaper-client && uv run --python 3.12 --with 'fastmcp-slim[client]' python fastmcp_workpaper_client.py --output .tmp/fastmcp-workpaper-proof.json` | FastMCP lists Bilig tools, writes `Inputs!B3`, checks restore proof, and exports WorkPaper JSON. |
|
|
41
|
+
| LangGraph.js ToolNode should keep formula proof in state | `cd examples/langgraph-workpaper-tool-state && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | Real `@langchain/langgraph` `ToolNode` returns `ToolMessage` readback proof after a WorkPaper mutation. |
|
|
42
|
+
| LangChain MCP adapters should load WorkPaper tools | `cd examples/langchain-mcp-workpaper-toolnode && pnpm install --ignore-workspace --lockfile=false && pnpm run smoke` | `@langchain/mcp-adapters` discovers Bilig MCP tools and `ToolNode` proves write, readback, persistence, and restart. |
|
|
43
|
+
| Hugging Face smolagents tool | `cd examples/smolagents-workpaper-tool && uv run --python 3.12 --with smolagents python smolagents_workpaper_tool.py --output .tmp/smolagents-workpaper-proof.json` | A smolagents `Tool` runs Bilig formula readback proof and returns a structured `verified: true` object. |
|
|
44
|
+
| An existing `.xlsx` file with stale formula results after Node edits | `npx --package @bilig/xlsx-formula-recalc xlsx-recalc --demo --json` | The file-level path updates inputs and returns fresh formula values without Excel, LibreOffice, or a browser. |
|
|
45
45
|
|
|
46
46
|
## Use A WorkPaper In Node
|
|
47
47
|
|
|
@@ -153,10 +153,10 @@ rewriting formula sheets.
|
|
|
153
153
|
The package ships proof commands for coding agents and service evaluators:
|
|
154
154
|
|
|
155
155
|
```sh
|
|
156
|
-
npm exec --package @bilig/workpaper -- bilig-agent-challenge
|
|
157
|
-
npm exec --package @bilig/workpaper -- bilig-mcp-challenge
|
|
158
|
-
npm exec --package @bilig/workpaper -- bilig-n8n-formula-server --port 4321
|
|
159
|
-
npm exec --package @bilig/workpaper -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
|
|
156
|
+
npm exec --package @bilig/workpaper@latest -- bilig-agent-challenge --json
|
|
157
|
+
npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge --json
|
|
158
|
+
npm exec --package @bilig/workpaper@latest -- bilig-n8n-formula-server --port 4321
|
|
159
|
+
npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
|
|
160
160
|
```
|
|
161
161
|
|
|
162
162
|
The challenge commands edit one input, recalculate dependent formulas, export
|
|
@@ -184,8 +184,12 @@ Start from the repo examples:
|
|
|
184
184
|
- `examples/kestra-workpaper-flow`
|
|
185
185
|
- `examples/prefect-workpaper-flow`
|
|
186
186
|
- `examples/n8n-workpaper-formula-readback/bilig-workpaper-formula-readback.n8n.json`
|
|
187
|
-
- `examples/dify-workpaper-formula-readback`
|
|
187
|
+
- `examples/dify-workpaper-formula-readback` mirrors the Dify plugin source;
|
|
188
|
+
the package was merged upstream in
|
|
189
|
+
<https://github.com/langgenius/dify-plugins/pull/2451>
|
|
188
190
|
- `examples/flowise-workpaper-formula-readback/bilig-workpaper-formula-readback.flowise-tool.json`
|
|
191
|
+
- `integrations/pipedream-bilig-workpaper` mirrors the Pipedream action shape;
|
|
192
|
+
the public review is <https://github.com/PipedreamHQ/pipedream/pull/20972>
|
|
189
193
|
- `examples/fastmcp-workpaper-client`
|
|
190
194
|
- `examples/langchain-mcp-workpaper-toolnode`
|
|
191
195
|
- `examples/smolagents-workpaper-tool`
|
|
@@ -223,7 +227,7 @@ and need recalculated formula results after changing inputs.
|
|
|
223
227
|
|
|
224
228
|
## Agent Commands And Optional MCP
|
|
225
229
|
|
|
226
|
-
The npm tarball exposes the same CLI entrypoints
|
|
230
|
+
The npm tarball exposes the same CLI entrypoints through the canonical scoped package, so agents
|
|
227
231
|
can install one focused package and still get the MCP stdio server:
|
|
228
232
|
|
|
229
233
|
```ts
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bilig/workpaper",
|
|
3
|
-
"version": "0.119.
|
|
3
|
+
"version": "0.119.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",
|
|
@@ -89,8 +89,8 @@
|
|
|
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.119.
|
|
93
|
-
"bilig-workpaper": "0.119.
|
|
92
|
+
"@bilig/headless": "0.119.2",
|
|
93
|
+
"bilig-workpaper": "0.119.2"
|
|
94
94
|
},
|
|
95
95
|
"devDependencies": {
|
|
96
96
|
"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.119.
|
|
6
|
+
"version": "0.119.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.119.
|
|
21
|
+
"version": "0.119.2",
|
|
22
22
|
"transport": {
|
|
23
23
|
"type": "stdio"
|
|
24
24
|
}
|