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 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.9. Normal tests never contact the hosted server.
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.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; pages_sent says how many. Those pages were
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 and charged only after the carrier reports pages
339
- as arrived. A failed fax charges nothing and the hold is released. A partial fax is charged for
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 charge for the pages that arrived is in progress, not confirmed yet.",
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 for the pages that arrived.",
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 for 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.",
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.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",