@absolutejs/mcp 0.20.1 → 0.22.0

package/dist/src/actionWorkflow.d.ts

@@ -1,5 +1,11 @@
 import type { McpToolRegistry } from "./types";
 export type ActionReview = {
+    /** Complete action-specific terms; adapters bind these to the reviewed revision. */
+    details?: Array<{
+        label: string;
+        value: string;
+    }>;
+    maxCredits?: number;
     /** Set by the tool factory from the available confirmation capability. */
     canConfirm?: boolean;
     actionId: string;
@@ -14,8 +20,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 +42,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,31 @@ 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.
+
+### Action-specific approval terms
+
+`ActionReview.details` carries bounded, labeled terms such as a calendar's exact
+start/end times, target calendar and conference choice. Both structured/text
+results and the shared review App include every term. Labels and values render
+as text. The adapter must bind these terms to `revision` and use the same terms
+at execution; the App cannot validate a provider-specific action for it.
+
+An adapter may return `canConfirm: false` for an individual action even when it
+implements confirmation for other kinds. The factory preserves that restriction
+and still enforces the adapter's general capability and explicit prepaid budget.
+The adapter must independently reject disabled kinds at confirmation time.

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.22.0"
 }