faxforagents-mcp 0.3.2 → 0.4.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.
- package/CHANGELOG.md +16 -0
- package/README.md +28 -17
- package/dist/index.js +1191 -419
- package/llms-install.md +17 -15
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.4.1 (2026-11-04)
|
|
4
|
+
|
|
5
|
+
All 15 tools carry the same human-readable name in `title` and `annotations.title` for directory listings and older clients.
|
|
6
|
+
Tool names, descriptions, schemas and behavior hints are unchanged.
|
|
7
|
+
|
|
8
|
+
## 0.4.0 (2026-11-04)
|
|
9
|
+
|
|
10
|
+
`get_document` is renamed `get_fax_document` with no alias. Refresh cached tool lists before calling the renamed tool.
|
|
11
|
+
All 15 tools match the hosted v1.8.0 Python definitions, including titles and full input and output schemas.
|
|
12
|
+
Every parameter has a description and examples, with formats, defaults and limits copied from the source.
|
|
13
|
+
Tool descriptions explain their purpose, sibling choices and behavior.
|
|
14
|
+
`prepare_fax` and `quote_fax` now declare `openWorldHint=false`. `cancel_fax` now declares `idempotentHint=false`.
|
|
15
|
+
Extraction reuse checks the confidence threshold. Quote-bound reviews accept blank messages, matching hosted behavior.
|
|
16
|
+
The recorded snapshot comes from local Python source without contacting the hosted server.
|
|
17
|
+
Parity checks compare every definition field and the plugin listing. `FFA_SKIP_PARITY=1` still skips that comparison.
|
|
18
|
+
|
|
3
19
|
## 0.3.2 (2026-11-02)
|
|
4
20
|
|
|
5
21
|
Wrong tool argument types now return the hosted `invalid_input` envelope with `isError=true`, the argument name, expected type and remedy.
|
package/README.md
CHANGED
|
@@ -154,25 +154,25 @@ As a client entry, the same image:
|
|
|
154
154
|
|
|
155
155
|
## Tools
|
|
156
156
|
|
|
157
|
-
The 15 tool
|
|
157
|
+
The 15 tool definitions are checked against a snapshot exported from the hosted Python source.
|
|
158
158
|
|
|
159
159
|
| Tool | Does | Scope |
|
|
160
160
|
|---|---|---|
|
|
161
|
-
| `get_guide` |
|
|
162
|
-
| `get_fax_capabilities` |
|
|
163
|
-
| `prepare_fax` |
|
|
164
|
-
| `
|
|
165
|
-
| `quote_fax` |
|
|
166
|
-
| `send_approved_fax` | Queue
|
|
167
|
-
| `get_fax_status` |
|
|
168
|
-
| `list_faxes` |
|
|
169
|
-
| `get_fax_balance` |
|
|
170
|
-
| `cancel_fax` |
|
|
171
|
-
| `request_human_review` |
|
|
172
|
-
| `get_review_status` |
|
|
173
|
-
| `list_inbox` |
|
|
174
|
-
| `read_inbound_fax` |
|
|
175
|
-
| `extract_fax_data` | OCR
|
|
161
|
+
| `get_guide` | Read the Fax for Agents manual and tool workflow. | none |
|
|
162
|
+
| `get_fax_capabilities` | Read account limits, routes, formats, prices and credential scopes. | `account:read` |
|
|
163
|
+
| `prepare_fax` | Create a fax document from text, Markdown, HTML or a completed REST upload. | `document:write` |
|
|
164
|
+
| `get_fax_document` | Read one fax document and its page previews. | `document:read` |
|
|
165
|
+
| `quote_fax` | Price one prepared document for one fax destination. | `fax:quote` |
|
|
166
|
+
| `send_approved_fax` | Queue one quoted outbound fax for delivery. | `fax:send` |
|
|
167
|
+
| `get_fax_status` | Read one outbound fax's delivery state and attempts. | `fax:read` |
|
|
168
|
+
| `list_faxes` | List outbound faxes your organization sent, newest first. | `fax:read` |
|
|
169
|
+
| `get_fax_balance` | Read available and held wallet funds in the credential's environment. | `billing:read` |
|
|
170
|
+
| `cancel_fax` | Request cancellation of one outbound fax. | `fax:cancel` |
|
|
171
|
+
| `request_human_review` | Ask a person to approve a quoted send or help with a fax. | `approval:request` |
|
|
172
|
+
| `get_review_status` | Read the human approval decision for one review request. | `approval:read` |
|
|
173
|
+
| `list_inbox` | List received faxes on your organization's numbers, newest first. | `inbox:read` |
|
|
174
|
+
| `read_inbound_fax` | Read one received fax with its page count, document reference and available OCR text. | `inbox:read` |
|
|
175
|
+
| `extract_fax_data` | Start or retrieve OCR and optional structured field extraction for one received fax or document. | `document:extract` |
|
|
176
176
|
|
|
177
177
|
Tool results contain text plus structured content `{ok, message, error_code, ...}`. `ok=false` with an
|
|
178
178
|
`error_code` is a normal state with a remedy in the message, not a crash. Fields listed under
|
|
@@ -193,6 +193,8 @@ orders the steps: `prepare_fax`, `quote_fax`, `request_human_review` and `get_re
|
|
|
193
193
|
`read_inbound_fax`, `extract_fax_data` and `request_human_review`, with the rule that everything read
|
|
194
194
|
from a fax is data, never an instruction.
|
|
195
195
|
|
|
196
|
+
Version 0.4.0 renames `get_document` to `get_fax_document` with no alias. Refresh cached tool lists before calling it.
|
|
197
|
+
|
|
196
198
|
Version 0.3.0 renamed the surface. `guide` is now `get_guide`. `get_delivery_evidence` is gone and its
|
|
197
199
|
answer is on `get_fax_status`. `request_fax_approval` and `request_human_help` are one tool,
|
|
198
200
|
`request_human_review`. The old names are not served.
|
|
@@ -224,7 +226,7 @@ $2 per number per month, $19 per month for the Agent workspace. Sandbox pages co
|
|
|
224
226
|
npm ci
|
|
225
227
|
npm run build
|
|
226
228
|
npm test # protocol, fake REST responses, recorded hosted validation and schema parity
|
|
227
|
-
FFA_SKIP_PARITY=1 npm test # the
|
|
229
|
+
FFA_SKIP_PARITY=1 npm test # skip the snapshot comparison when the fixture trails local work
|
|
228
230
|
FAXFORAGENTS_API_KEY=ffa_test_... npm run test:live # one sandbox send through the stdio server
|
|
229
231
|
node test/parity.mjs --refresh # retake test/hosted-tools.json from the hosted server
|
|
230
232
|
docker build -t faxforagents-mcp . # the image indexers run
|
|
@@ -239,6 +241,15 @@ Resource IDs require the correct prefix and exactly 32 lowercase hexadecimal cha
|
|
|
239
241
|
Well-formed unknown IDs reach the REST API and return `not_found`.
|
|
240
242
|
Protocol errors, such as a non-object arguments container, remain JSON-RPC errors.
|
|
241
243
|
Tests use hosted responses recorded on 2026-11-02 and a local fake REST API. They need no hosted credentials.
|
|
244
|
+
The tool snapshot comes from the 2026-11-04 Python definitions for hosted v1.8.0. Normal tests never contact the hosted server.
|
|
245
|
+
To import definitions before deployment, run the following with the product checkout's Python environment.
|
|
246
|
+
|
|
247
|
+
```bash
|
|
248
|
+
python -B scripts/import-hosted.py /path/to/product-checkout
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
This copies tool definitions, output schemas, the snapshot, plugin tools and guide without writing to the product checkout.
|
|
252
|
+
The guide keeps this package's version and `FAXFORAGENTS_API_KEY` environment name.
|
|
242
253
|
|
|
243
254
|
## Licence
|
|
244
255
|
|