From 8c72538102449595d5e664fe451a3fc0735191a3 Mon Sep 17 00:00:00 2001
From: Gregory Schier <gschier1990@gmail.com>
Date: Sun, 16 Aug 2026 10:00:35 -0700
Subject: [PATCH] Say on send() that an unsaved response's body is call-scoped

---
 packages/plugin-runtime-types/src/plugins/Context.ts | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/plugin-runtime-types/src/plugins/Context.ts b/packages/plugin-runtime-types/src/plugins/Context.ts
index 31197b82..973e224f 100644
--- a/packages/plugin-runtime-types/src/plugins/Context.ts
+++ b/packages/plugin-runtime-types/src/plugins/Context.ts
@@ -152,6 +152,15 @@ export interface Context {
     render(args: RenderGrpcRequestRequest): Promise<RenderGrpcRequestResponse["grpcRequest"]>;
   };
   httpRequest: {
+    /**
+     * Send a request and wait for the response.
+     *
+     * A request with an id is saved, and its body can be read back by response
+     * id whenever you like. A request without one is not: it is sent, the
+     * response comes back, and nothing keeps it. Read that body with
+     * `ctx.httpResponse.body()` before returning — it is only there for the
+     * rest of this call.
+     */
     send(args: SendHttpRequestRequest): Promise<SendHttpRequestResponse["httpResponse"]>;
     getById(args: GetHttpRequestByIdRequest): Promise<GetHttpRequestByIdResponse["httpRequest"]>;
     render(args: RenderHttpRequestRequest): Promise<RenderHttpRequestResponse["httpRequest"]>;