@absolutejs/mcp 0.21.0 → 0.23.0

package/dist/src/actionWorkflow.d.ts

@@ -1,5 +1,10 @@
 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;

package/dist/src/creditWorkResult.d.ts

@@ -0,0 +1,13 @@
+import type { McpToolResult } from "./types";
+/** Public projection of account-bound, persisted work. Never pass an unfiltered
+ * database row or provider response as the saved result. */
+export type McpCreditWorkSnapshot = {
+    budget: number;
+    charged: number;
+    status: "running" | "completed" | "failed";
+    result: string | null;
+};
+/** Keep text-only and structured-only hosts on the same result contract. This
+ * pure formatter never starts, retries, approves, or settles work. Use it for
+ * initial completion, duplicate requests, and read-only recovery alike. */
+export declare const createCreditWorkResult: (requestId: string, work: McpCreditWorkSnapshot) => McpToolResult;

package/dist/src/index.d.ts

@@ -52,4 +52,5 @@ export { createBillingApps } from "./billingApps";
 export { createWorkflowApps } from "./workflowApps";
 export { createWorkflowTools, projectSetupStatus, projectWorkPreview, type McpSetupStatus, type McpWorkPreview, type McpWorkPreviewRequest, } from "./workflowTools";
 export { createSetupSelectionTools, projectSetupSelection, type SetupSelection, type SetupConfirmation, type SetupOption, } from "./setupSelection";
-export { createActionWorkflowTools, projectActionReview, projectActionJob, type ActionReview, type ActionConfirmation, type ActionJob } from "./actionWorkflow";
+export { createActionWorkflowTools, projectActionReview, projectActionJob, type ActionReview, type ActionConfirmation, type ActionJob, } from "./actionWorkflow";
+export { createCreditWorkResult, type McpCreditWorkSnapshot, } from "./creditWorkResult";

package/docs/mcp-apps.md

@@ -142,3 +142,16 @@ 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.21.0"
+  "version": "0.23.0"
 }