@forgeintel/sdk 0.5.0-alpha.legacy030.b13 → 0.5.0-alpha.legacy030nested.b13

package/dist/core.js

@@ -8,7 +8,7 @@ import { agentContextAsk, contextIssues, parseAgentContext, takeFromBody, takeFr
 import { EventReporter } from "./reporter.js";
 import { captureClientHeaders } from "./client-signals.js";
 import { ISSUES, NOTE_MAX_LENGTH, OUTCOMES, PROTOCOL, parseSubmission } from "./values.js";
-import { challengeOrigin, describeChallenge, describeChallengeBody, describeReceipt, feedbackExtension, paymentOrigin, readPaymentHeader, readReceipt, receiptExtension } from "./x402.js";
+import { FEEDBACK_FIELD, challengeOrigin, describeChallenge, describeChallengeBody, describeReceipt, feedbackExtension, paymentOrigin, readPaymentHeader, readReceipt, receiptExtension } from "./x402.js";
 export const FEEDBACK_HEADERS = { "Cache-Control": "no-store", "X-Robots-Tag": "noindex" };
 /** Max JSON body for POST {basePath}. */
 export const BODY_LIMIT = 8 * 1024;
@@ -276,7 +276,7 @@ function enabledCore(options, configWarnings) {
             protocol: PROTOCOL,
             cost: "free",
             ratings_are_public_at: links.summary,
-            feedback_id: "Returned by paid responses as the feedback_id body field and the Forge-Feedback-Id header.",
+            feedback_id: `Returned by paid responses in the ${FEEDBACK_FIELD} body object (feedback_id) and the Forge-Feedback-Id header.`,
             quick: { method: "GET", url: `${links.rate}?feedback_id=FEEDBACK_ID&outcome=OUTCOME`, optional_param: "issue=ISSUE" },
             detailed: {
                 method: "POST",
@@ -499,16 +499,16 @@ function enabledCore(options, configWarnings) {
                         body !== null &&
                         typeof body === "object" &&
                         Object.getPrototypeOf(body) === Object.prototype &&
-                        !("feedback_id" in body) &&
-                        !("feedback_url" in body) &&
-                        !(rateHint && "rate_this_call" in body) &&
+                        !(FEEDBACK_FIELD in body) &&
                         (allowInjection?.(request.method, request.path, status) ?? true)) {
-                        // Legacy 0.3.0 shape: flat fields after the merchant's own.
+                        // One namespaced object, so the merchant's own fields stay recognizably theirs.
                         return {
                             ...body,
-                            feedback_id: feedbackId,
-                            feedback_url: feedbackUrl,
-                            ...(rateHint ? { rate_this_call: rateHint.replaceAll("{feedback_url}", feedbackUrl).replaceAll("{summary_url}", callLinks.summary) } : {}),
+                            [FEEDBACK_FIELD]: {
+                                feedback_id: feedbackId,
+                                feedback_url: feedbackUrl,
+                                ...(rateHint ? { rate_this_call: rateHint.replaceAll("{feedback_url}", feedbackUrl).replaceAll("{summary_url}", callLinks.summary) } : {}),
+                            },
                         };
                     }
                 }

package/dist/openapi.js

@@ -3,6 +3,7 @@
 // and on any unexpected input return the original document unchanged.
 import { CONTEXT_FIELD, agentContextParameters, agentContextSchema } from "./context.js";
 import { FEEDBACK_ID_PATTERN } from "./id.js";
+import { FEEDBACK_FIELD } from "./x402.js";
 import { ISSUES, NOTE_MAX_LENGTH, OUTCOMES, PROTOCOL } from "./values.js";
 const METHODS = ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
 const ANNOTATIONS = new Set(["$ref", "description", "title", "summary", "example", "examples", "deprecated", "readOnly", "writeOnly", "$comment"]);
@@ -37,18 +38,24 @@ function resolveRef(doc, ref) {
     return undefined;
 }
 function feedbackProperties(rateUrl, hintField = false) {
-    // Legacy 0.3.0 shape: flat fields, as in the paid body.
     return {
-        ...(hintField ? { rate_this_call: { type: "string", description: "How to rate this paid call in one free request." } } : {}),
-        feedback_id: {
-            type: "string",
-            pattern: FEEDBACK_ID_PATTERN.source,
-            description: "Rating ID for this paid call (also sent as the Forge-Feedback-Id header). See x-forge-feedback.",
-        },
-        feedback_url: {
-            type: "string",
-            format: "uri",
-            description: `Quick-rating URL with outcome left blank; outcome values: ${Object.keys(OUTCOMES).join(", ")}. Base: ${rateUrl}`,
+        [FEEDBACK_FIELD]: {
+            type: "object",
+            description: "Added by Forge to paid responses: how to rate this call. See x-forge-feedback.",
+            required: ["feedback_id", "feedback_url"],
+            properties: {
+                feedback_id: {
+                    type: "string",
+                    pattern: FEEDBACK_ID_PATTERN.source,
+                    description: "Rating ID for this paid call (also sent as the Forge-Feedback-Id header).",
+                },
+                feedback_url: {
+                    type: "string",
+                    format: "uri-reference",
+                    description: `Quick-rating URL with outcome left blank; outcome values: ${Object.keys(OUTCOMES).join(", ")}. Base: ${rateUrl}`,
+                },
+                ...(hintField ? { rate_this_call: { type: "string", description: "How to rate this paid call in one free request." } } : {}),
+            },
         },
     };
 }

package/dist/x402.js

@@ -50,7 +50,7 @@ export function feedbackExtension(rateUrl, tone = "soft") {
             ...ASK[tone].extensionExtras,
             rate: `GET ${rateUrl}?feedback_id=FEEDBACK_ID&outcome=fully`,
             outcome: ["fully", "partially", "no"],
-            feedback_id: "In the paid response body (feedback_id) and the Forge-Feedback-Id header.",
+            feedback_id: `In the paid response body (${FEEDBACK_FIELD}.feedback_id) and the Forge-Feedback-Id header.`,
             payment: "None. Plain GET, not an x402 endpoint.",
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeintel/sdk",
-  "version": "0.5.0-alpha.legacy030.b13",
+  "version": "0.5.0-alpha.legacy030nested.b13",
   "description": "The Forge SDK for x402 paid APIs: agent feedback, agent context, OpenAPI and challenge enrichment, and passive call signals. Express, Hono, Next.js and fetch handlers. No Forge network request on the merchant response path.",
   "license": "MIT",
   "type": "module",