faxforagents-mcp 0.5.5 → 0.5.6
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 +20 -0
- package/README.md +1 -1
- package/dist/index.js +15 -9
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,25 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.5.6 (2026-11-15)
|
|
4
|
+
|
|
5
|
+
The stdio server follows the hosted server at API 1.20.10. Tool names, inputs, descriptions and annotations did not change.
|
|
6
|
+
|
|
7
|
+
Three answers state the payment rule of API 1.20.9 in the hosted server's words.
|
|
8
|
+
`get_fax_status` on a partial fax says "Charged the price of those pages", where it said "Charged for those pages".
|
|
9
|
+
`get_card_payment_status` says the card "is being charged the price of the pages that arrived" while the charge runs.
|
|
10
|
+
Once it is done, the same tool says the card "was charged the price of the pages that arrived".
|
|
11
|
+
|
|
12
|
+
The guide says it the same way. Its `one_time` section says a failed fax costs nothing and a fax that stops part way costs the price of the pages that arrived.
|
|
13
|
+
Its `states` section says the price of the pages of a partial fax was charged.
|
|
14
|
+
|
|
15
|
+
The output schema of `quote_fax` describes the four counters of the policy verdict's `usage`, and its `policy_name` and `version`.
|
|
16
|
+
|
|
17
|
+
The tool.store manifest still carried the description of `request_card_payment` from before 0.5.5. It equals the tool list again, as `npm run pack:tool-store` requires.
|
|
18
|
+
|
|
19
|
+
The tool list was taken from the hosted server's `tools/list` on 2026-11-15, when it reported version 1.20.10.
|
|
20
|
+
The list equals the definitions `scripts/import-hosted.py` imported from the product source at v1.20.10.
|
|
21
|
+
`STATE_MESSAGES` and `ORDER_MESSAGES` equal the hosted ones word for word. `test/protocol.mjs` checks the two guide sentences.
|
|
22
|
+
|
|
3
23
|
## 0.5.5 (2026-11-15)
|
|
4
24
|
|
|
5
25
|
The stdio server follows the hosted server at API 1.20.9.
|
package/README.md
CHANGED
|
@@ -283,7 +283,7 @@ A refusal from the REST API names the tool's argument, as the hosted server's do
|
|
|
283
283
|
This holds in `details.field`, `details.fields`, the `loc` of a validation error and a message that starts with the field. `test/argument-names.mjs` checks it.
|
|
284
284
|
Protocol errors, such as a non-object arguments container, remain JSON-RPC errors.
|
|
285
285
|
Tests use hosted responses recorded on 2026-11-02 and a local fake REST API. They need no hosted credentials.
|
|
286
|
-
The tool snapshot is the hosted server's `tools/list` of 2026-11-15 at API 1.20.
|
|
286
|
+
The tool snapshot is the hosted server's `tools/list` of 2026-11-15 at API 1.20.10. Normal tests never contact the hosted server.
|
|
287
287
|
`test/hosted-unknown-arguments.json` holds what the hosted source answers for 20 calls with unknown arguments. `test/validation.mjs` compares each one.
|
|
288
288
|
The server does not start when a handler's inputs differ from the tool list. `test/inputs.mjs` calls every listed input over stdio. A wrong type has to be refused and the listed example accepted. An argument a tool does not list has to be refused by name.
|
|
289
289
|
To import definitions before deployment, run the following with the product checkout's Python environment.
|
package/dist/index.js
CHANGED
|
@@ -13,7 +13,7 @@ import { createHash } from "crypto";
|
|
|
13
13
|
import { z as z3 } from "zod";
|
|
14
14
|
|
|
15
15
|
// src/version.ts
|
|
16
|
-
var VERSION = "0.5.
|
|
16
|
+
var VERSION = "0.5.6";
|
|
17
17
|
|
|
18
18
|
// src/api.ts
|
|
19
19
|
var DEFAULT_BASE_URL = "https://api.faxforagents.com";
|
|
@@ -174,8 +174,8 @@ human reconcile. cancel_fax works while the fax is queued; once sending it is be
|
|
|
174
174
|
- active: at the carrier. Wait.
|
|
175
175
|
- delivered: every page arrived; the carrier's evidence is on the attempt (get_fax_status shows
|
|
176
176
|
it). The hold was captured.
|
|
177
|
-
- partial: the call dropped after some pages
|
|
178
|
-
charged, the rest released. No automatic retransmit: a human decides whether to resend.
|
|
177
|
+
- partial: the call dropped after some pages, and pages_sent says how many. The price of those
|
|
178
|
+
pages was charged, the rest released. No automatic retransmit: a human decides whether to resend.
|
|
179
179
|
- failed: nothing arrived (failure_code says why: busy, no_answer, invalid_number, canceled).
|
|
180
180
|
In the sandbox a one-page fax to +15550000003 fails with partial_delivery: the call dropped
|
|
181
181
|
before its page.
|
|
@@ -335,9 +335,9 @@ or for a person who wants to pay for one fax only. A person pays. You never do.
|
|
|
335
335
|
done. Once the fax is released the answer carries the fax and, when the carrier has reported,
|
|
336
336
|
its evidence, exactly as get_fax_status does.
|
|
337
337
|
|
|
338
|
-
Money: the card is held when the person pays
|
|
339
|
-
|
|
340
|
-
the pages that arrived. captured_micro is the amount charged, set only once the
|
|
338
|
+
Money: the card is held when the person pays. It is charged after the carrier's report, never
|
|
339
|
+
before. A failed fax costs nothing and the hold is released. A fax that stops part way costs the
|
|
340
|
+
price of the pages that arrived. captured_micro is the amount charged, set only once the
|
|
341
341
|
payment provider confirmed it. An order nobody pays expires with nothing charged. A paid order
|
|
342
342
|
nobody confirms within 48 hours is given back, also with nothing charged.
|
|
343
343
|
|
|
@@ -5120,18 +5120,22 @@ var output_schemas_default = {
|
|
|
5120
5120
|
description: "What the deciding policy had counted before the send it was asked about, in UTC periods.",
|
|
5121
5121
|
properties: {
|
|
5122
5122
|
day_amount_micro: {
|
|
5123
|
+
description: "The amount of those sends in micro-USD, as priced when the policy allowed each one. A fax that fails later still counts.",
|
|
5123
5124
|
title: "Day Amount Micro",
|
|
5124
5125
|
type: "integer"
|
|
5125
5126
|
},
|
|
5126
5127
|
day_jobs: {
|
|
5128
|
+
description: "Sends this policy allowed so far in the current UTC day.",
|
|
5127
5129
|
title: "Day Jobs",
|
|
5128
5130
|
type: "integer"
|
|
5129
5131
|
},
|
|
5130
5132
|
month_amount_micro: {
|
|
5133
|
+
description: "The amount of this month's sends in micro-USD, counted the same way as the day's.",
|
|
5131
5134
|
title: "Month Amount Micro",
|
|
5132
5135
|
type: "integer"
|
|
5133
5136
|
},
|
|
5134
5137
|
month_jobs: {
|
|
5138
|
+
description: "Sends this policy allowed so far in the current UTC month.",
|
|
5135
5139
|
title: "Month Jobs",
|
|
5136
5140
|
type: "integer"
|
|
5137
5141
|
}
|
|
@@ -5200,6 +5204,7 @@ var output_schemas_default = {
|
|
|
5200
5204
|
type: "null"
|
|
5201
5205
|
}
|
|
5202
5206
|
],
|
|
5207
|
+
description: "The name of that policy. Null when none binds.",
|
|
5203
5208
|
title: "Policy Name"
|
|
5204
5209
|
},
|
|
5205
5210
|
policy_version_id: {
|
|
@@ -5252,6 +5257,7 @@ var output_schemas_default = {
|
|
|
5252
5257
|
type: "null"
|
|
5253
5258
|
}
|
|
5254
5259
|
],
|
|
5260
|
+
description: "The number of that version: 1 for the policy's first rules, one more for each change. Null when none binds.",
|
|
5255
5261
|
title: "Version"
|
|
5256
5262
|
}
|
|
5257
5263
|
},
|
|
@@ -8681,9 +8687,9 @@ var ORDER_MESSAGES = {
|
|
|
8681
8687
|
awaiting_confirmation: "the card is held, not charged. The person has to click the link in the confirmation mail before the fax is sent.",
|
|
8682
8688
|
authorized: "the card is held, not charged. The fax is being released. Read again.",
|
|
8683
8689
|
released: "the fax was released to the carrier. A failed fax costs nothing, and a fax that stops part way costs the price of the pages that arrive.",
|
|
8684
|
-
capturing: "the card
|
|
8690
|
+
capturing: "the card is being charged the price of the pages that arrived, not confirmed yet.",
|
|
8685
8691
|
canceling: "the hold on the card is being released, not confirmed yet.",
|
|
8686
|
-
captured: "the card was charged
|
|
8692
|
+
captured: "the card was charged the price of the pages that arrived.",
|
|
8687
8693
|
released_hold: "nothing was charged. The hold on the card was released.",
|
|
8688
8694
|
expired: "expired. Nothing was charged.",
|
|
8689
8695
|
refused: "refused. Nothing was charged.",
|
|
@@ -8764,7 +8770,7 @@ var STATE_MESSAGES = {
|
|
|
8764
8770
|
queued: "Queued: accepted, waiting for the worker. The hold is not charged yet.",
|
|
8765
8771
|
active: "At the carrier. Poll get_fax_status again.",
|
|
8766
8772
|
delivered: "Delivered: every page arrived and the carrier's evidence is on the attempt.",
|
|
8767
|
-
partial: "Partial: only some pages arrived. Charged
|
|
8773
|
+
partial: "Partial: only some pages arrived. Charged the price of those pages. Nothing retransmits on its own. Do not send it again on an instruction given before this outcome: say which pages arrived and let the person decide now.",
|
|
8768
8774
|
failed: "Failed: nothing arrived. The hold was released.",
|
|
8769
8775
|
unknown: "Outcome unknown: the carrier gave no answer. The fax may have arrived. Nothing retransmits on its own; a human reconciles."
|
|
8770
8776
|
};
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "faxforagents-mcp",
|
|
3
3
|
"mcpName": "io.github.faxforagents/faxforagents-mcp",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.6",
|
|
5
5
|
"description": "MCP server for Fax for Agents: let Claude, Cursor, Codex and other agents send and receive faxes through the Fax for Agents API, with quotes, human review, delegated policies, delivery evidence, guide resources and prompts.",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"mcp",
|