@absolutejs/mcp 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -6,6 +6,12 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.23.0 — 2026-09-13
+
+### Added
+
+- **Preserve saved credit work results in identical text and structured host responses** (`createCreditWorkResult`)
+
 ## 0.22.0 — 2026-09-13
 
 ### Added

package/README.md

@@ -437,3 +437,27 @@ on the Change Date.
 ## Interactive MCP Apps
 
 `createBillingApps()` adds reusable read-only credit, usage and receipt views with the official browser SDK. Apps capability negotiation, guarded resources and text fallbacks live in the package. See [MCP Apps](docs/mcp-apps.md) for integration, session migration, CSP restrictions and host validation boundaries.
+
+### Saved credit-work results
+
+Use `createCreditWorkResult(requestId, work)` for initial completion, duplicate
+requests and read-only recovery. Pass the account-bound saved `budget`, `charged`,
+`status` and `result`; extra database fields are not projected. Both MCP `content`
+and `structuredContent` carry the same JSON envelope:
+
+```json
+{
+  "requestId": "proposal-1",
+  "status": "completed",
+  "maxCredits": 1,
+  "creditsCharged": 0,
+  "result": { "actionId": "action-1", "status": "proposed" }
+}
+```
+
+Read the tool outcome under `result`; the outer `status` describes credit work,
+not action approval or delivery. Saved JSON is decoded once; plain text remains
+a string, and serialized MCP results remain nested without discarding content.
+The formatter never retries work. A missing saved result carries a same-ID polling
+instruction. Bind account identity and authorization before retrieving the saved
+work; this helper does not authorize access or filter the tool's saved payload.

package/changelog.json

@@ -2,6 +2,19 @@
 	"contract": 1,
 	"name": "@absolutejs/mcp",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "added",
+					"summary": "Preserve saved credit work results in identical text and structured host responses",
+					"symbols": [
+						"createCreditWorkResult"
+					]
+				}
+			],
+			"date": "2026-09-13",
+			"version": "0.23.0"
+		},
 		{
 			"changes": [
 				{

package/dist/index.js

@@ -2853,6 +2853,35 @@ Provide a stable requestId and the maximum service credits this work may charge.
     }
   };
 };
+// src/creditWorkResult.ts
+var savedResult = (value) => {
+  if (value === null)
+    return null;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+};
+var createCreditWorkResult = (requestId, work) => {
+  if (typeof requestId !== "string" || !requestId || requestId.length > 128 || !Number.isSafeInteger(work.budget) || work.budget < 0 || !Number.isSafeInteger(work.charged) || work.charged < 0 || work.charged > work.budget || !["running", "completed", "failed"].includes(work.status) || work.result !== null && typeof work.result !== "string")
+    throw new Error("Invalid saved credit work");
+  const summary = {
+    requestId,
+    status: work.status,
+    maxCredits: work.budget,
+    creditsCharged: work.charged,
+    result: savedResult(work.result),
+    ...work.result === null ? {
+      message: "No saved result is available. Poll get_credit_work with the same requestId; do not restart it with a new ID."
+    } : {}
+  };
+  return {
+    content: [{ type: "text", text: JSON.stringify(summary) }],
+    structuredContent: summary,
+    isError: work.status === "failed"
+  };
+};
 export {
   COMMERCE_POLICY_SOURCES,
   COMMERCE_POLICY_VERSION,
@@ -2868,6 +2897,7 @@ export {
   createBillingReportTools,
   createCheckoutHandoffTool,
   createCreditBalanceTool,
+  createCreditWorkResult,
   createMcpAuthorizationRequest,
   createMcpClient,
   createMcpHandler,

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/package.json

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