@absolutejs/mcp 0.20.1 → 0.21.0

package/dist/src/actionWorkflow.d.ts

@@ -1,5 +1,6 @@
 import type { McpToolRegistry } from "./types";
 export type ActionReview = {
+    maxCredits?: number;
     /** Set by the tool factory from the available confirmation capability. */
     canConfirm?: boolean;
     actionId: string;
@@ -14,8 +15,15 @@ export type ActionReview = {
 export type ActionConfirmation = {
     actionId: string;
     expectedRevision: string;
+    maxCredits?: number;
 };
 export type ActionJob = {
+    creditUsage?: {
+        workId: string;
+        maxCredits: number;
+        creditsCharged: number;
+        status: "reserved" | "settled";
+    };
     actionId: string;
     status: "awaiting_approval" | "queued" | "running" | "succeeded" | "failed" | "unknown" | "denied" | "expired";
     title: string;
@@ -29,7 +37,8 @@ export declare const projectActionJob: (value: unknown) => ActionJob;
  * Every draft writer must refuse edits after that claim. Never send inline.
  * Job reads/resume only reattach to saved work, including ambiguous outcomes. */
 export declare const createActionWorkflowTools: (adapter: {
-    review: (actionId: string) => Promise<ActionReview>;
+    requiresBudget?: boolean;
+    review: (actionId: string, maxCredits?: number) => Promise<ActionReview>;
     job: (actionId: string) => Promise<ActionJob>;
     confirm?: (request: ActionConfirmation) => Promise<ActionJob>;
 }) => McpToolRegistry;

package/docs/mcp-apps.md

@@ -127,3 +127,18 @@ and summaries; do not expose raw provider errors, credentials or queue internals
 The text-only path carries the same review and status; host support does not
 expand authorization or commerce eligibility. Review bodies are bounded at
 100,000 characters, subjects at 2,000, and recipient lists at 100.
+
+### Deferred prepaid action budgets
+
+Action review accepts optional `maxCredits`; confirmation echoes that exact value.
+A `requiresBudget` adapter exposes approval only for a review containing an explicit
+positive safe-integer budget and marks confirmation as `paid_access` for
+`usage_credits`. Existing server-bound host commerce policy still applies.
+The consumer must bind the budget into its revision, atomically reserve with the
+outbox, and transfer metering to its durable worker. Never interpret a review read
+as spending permission. Missing or changed budgets must fail confirmation.
+
+The shared App displays the hold, charge ceiling and uncertain-outcome behavior
+before approval, then carries the budget unchanged to confirmation. Job results
+may show projected `creditUsage` (work ID, maximum, charged amount and reserved or
+settled state). Read/resume/refresh never reserve, settle or retry execution.

package/package.json

@@ -90,5 +90,5 @@
     "canary:checkout": "bun canary/checkout.ts"
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.20.1"
+  "version": "0.21.0"
 }