@zuplo/runtime 7.4.1 → 7.4.3

package/out/types/index.d.ts

@@ -15661,12 +15661,69 @@ export declare class ZuploMcpSdk {
    */
   getRawCallToolRequest(): CallToolRequest | null;
   /**
-   * Sets the MCP request/response context object.
-   * Use this to set `_meta` that should be included in the tool result.
+   * Overrides fields of the MCP tool result the gateway is about to send.
    *
-   * @param req - The object containing metadata (e.g. `{ _meta: { ... } }`)
+   * Every field is independently optional; an absent field keeps the value
+   * the gateway derives from the downstream response. The most useful
+   * combination is `content` alone: the human-readable summary replaces the
+   * raw serialized body while `structuredContent` is still auto-derived from
+   * it — one call, compact model context, full data preserved.
+   *
+   * @example A compact summary for the model, full JSON in structuredContent
+   * ```ts
+   * const response = await context.invokeRoute("/todos");
+   * new ZuploMcpSdk(context).setRawCallToolResult({
+   *   content: [{ type: "text", text: "Fetched the todo list" }],
+   * });
+   * return response;
+   * ```
+   *
+   * Notes:
+   *
+   * - The stored value is *consumed* when the gateway builds the tool result
+   *   (asymmetric with {@link getRawCallToolRequest}, which can be read any
+   *   number of times).
+   * - The value is written to the context that carried the matching
+   *   `tools/call` request, which is looked up exactly one `invokeRoute`
+   *   generation up. Calling this from a grandchild invocation (a route that
+   *   itself invokes another route) silently stores the override where the
+   *   gateway never reads it.
+   * - `isError` is deliberately not overridable: it follows the status of the
+   *   response your handler returns, so upstream failures cannot be masked.
+   * - `structuredContent` must be a JSON object. The MCP 2025-11-25 wire
+   *   format rejects arrays and scalars here.
+   * - Declining the spec's backwards-compatibility SHOULD (mirroring
+   *   serialized JSON into a text block) has a concrete cost: clients that
+   *   predate `structuredContent` see only your summary in `content`.
+   * - MCP reserves `_meta` keys with the `modelcontextprotocol.io/` prefix
+   *   for the protocol itself; use your own prefix for application metadata.
+   *
+   * @param result - The fields to override on the tool result
+   */
+  setRawCallToolResult(result: ZuploMcpToolResultOverride): void;
+}
+
+/**
+ * The subset of a `tools/call` result a module author may override via
+ * {@link ZuploMcpSdk.setRawCallToolResult}. Every field is independently
+ * optional; an absent field keeps the value the gateway derives from the
+ * downstream response.
+ */
+export declare interface ZuploMcpToolResultOverride {
+  /**
+   * Content blocks for the model to read. Replaces the gateway's default
+   * (the serialized downstream body in a single text block).
+   */
+  content?: CallToolResult["content"];
+  /**
+   * The structured form of the tool's output. MUST be a JSON object — the
+   * MCP 2025-11-25 wire format rejects arrays/strings/numbers here.
+   */
+  structuredContent?: Record<string, unknown>;
+  /**
+   * Per-call metadata. Replaces the gateway's default of `{}`.
    */
-  setRawCallToolResult(req: CallToolResult): void;
+  _meta?: Record<string, unknown>;
 }
 
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zuplo/runtime",
   "type": "module",
-  "version": "7.4.1",
+  "version": "7.4.3",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "exports": {