From b641ebff0be1399baecf4a100555f76b69cdf7cb Mon Sep 17 00:00:00 2001
From: Roman Volosatovs <rvolosatovs@riseup.net>
Date: Mon, 4 Dec 2023 14:08:52 +0100
Subject: [PATCH] feat: introduce `outgoing-request.into-incoming-request`

Signed-off-by: Roman Volosatovs <rvolosatovs@riseup.net>
---
 proxy.md      | 12 ++++++++++++
 wit/types.wit |  5 +++++
 2 files changed, 17 insertions(+)

diff --git a/proxy.md b/proxy.md
index cf8856d..d536147 100644
--- a/proxy.md
+++ b/proxy.md
@@ -1032,6 +1032,18 @@ another component by e.g. <code>outgoing-handler.handle</code>.</p>
 <ul>
 <li><a name="method_outgoing_request.headers.0"></a> own&lt;<a href="#headers"><a href="#headers"><code>headers</code></a></a>&gt;</li>
 </ul>
+<h4><a name="static_outgoing_request.into_incoming_request"><code>[static]outgoing-request.into-incoming-request: func</code></a></h4>
+<p>Takes ownership of <a href="#outgoing_request"><code>outgoing-request</code></a>, and returns an <a href="#incoming_request"><code>incoming-request</code></a>.
+This allows guests to invoke <code>incoming-handler.handle</code> on other components.
+This function will trap if the <a href="#headers"><code>headers</code></a> child is still alive.</p>
+<h5>Params</h5>
+<ul>
+<li><a name="static_outgoing_request.into_incoming_request.this"><code>this</code></a>: own&lt;<a href="#outgoing_request"><a href="#outgoing_request"><code>outgoing-request</code></a></a>&gt;</li>
+</ul>
+<h5>Return values</h5>
+<ul>
+<li><a name="static_outgoing_request.into_incoming_request.0"></a> own&lt;<a href="#incoming_request"><a href="#incoming_request"><code>incoming-request</code></a></a>&gt;</li>
+</ul>
 <h4><a name="constructor_request_options"><code>[constructor]request-options: func</code></a></h4>
 <p>Construct a default <a href="#request_options"><code>request-options</code></a> value.</p>
 <h5>Return values</h5>
diff --git a/wit/types.wit b/wit/types.wit
index b1ea89d..0da0c82 100644
--- a/wit/types.wit
+++ b/wit/types.wit
@@ -306,6 +306,11 @@ interface types {
     /// `outgoing-request` is dropped, or its ownership is transfered to
     /// another component by e.g. `outgoing-handler.handle`.
     headers: func() -> headers;
+
+    /// Takes ownership of `outgoing-request`, and returns an `incoming-request`.
+    /// This allows guests to invoke `incoming-handler.handle` on other components.
+    /// This function will trap if the `headers` child is still alive.
+    into-incoming-request: static func(this: outgoing-request) -> incoming-request;
   }
 
   /// Parameters for making an HTTP Request. Each of these parameters is