feat: Reusable sandboxes (#1314)

Co-authored-by: Kat Marchán <kzm@zkat.tech>

Author: TartanLlama

.github/workflows/main.yml

@@ -11,7 +11,7 @@ defaults:
     shell: bash
 env:
   # Note: when updated, also update version in ensure-cargo-installs
-  viceroy_version: 0.15.0
+  viceroy_version: 0.16.4
   # Note: when updated, also update version in ensure-cargo-installs ! AND ! release-please.yml
   wasm-tools_version: 1.216.0
   fastly-cli_version: 10.19.0
@@ -46,7 +46,7 @@ jobs:
       matrix:
         include:
           - crate: viceroy
-            version: 0.15.0 # Note: workflow-level env vars can't be used in matrix definitions
+            version: 0.16.4 # Note: workflow-level env vars can't be used in matrix definitions
             options: ""
           - crate: wasm-tools
             version: 1.216.0 # Note: workflow-level env vars can't be used in matrix definitions

documentation/docs/experimental/setReusableSandboxOptions.mdx

@@ -0,0 +1,28 @@
+---
+hide_title: false
+hide_table_of_contents: false
+pagination_next: null
+pagination_prev: null
+---
+# setReusableSandboxOptions
+
+The **`setReusableSandboxOptions()`** function configures the reuse of the same underlying sandbox for multiple requests, which can improve performance by avoiding the overhead of initializing a new sandbox for each request.
+
+## Syntax
+
+```js
+setReusableSandboxOptions(options)
+```
+
+### Parameters
+
+- `options` _: Object_
+  - The configuration options for the reusable sandbox.
+    - `maxRequests` _: number_ (default: `1`, `0` means unlimited)
+      - The maximum number of requests that can be handled by a single sandbox before it is recycled.
+    - `betweenRequestTimeoutMs` _: number_ (default: not specified)
+      - The amount of time in milliseconds to wait between requests before recycling the sandbox.
+    - `maxMemoryMiB` _: number_ (default: no limit)
+      - The maximum amount of memory in MiB that the sandbox can use before it is recycled.
+    - `sandboxTimeoutMs` _: number_ (default: no timeout)
+      - The maximum amount of time in milliseconds that a sandbox can be active before it is recycled.