npm - @pyric/cli - Versions diffs - 0.1.0-alpha.10 → 0.1.0-alpha.11 - Mend

@pyric/cli 0.1.0-alpha.10 → 0.1.0-alpha.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (304) hide show

package/dist/serve/docs-ui/docs/pyric-cli-remote-reference-api/index.html CHANGED Viewed

@@ -1,6 +1,7 @@
-<!DOCTYPE html><html lang="en"> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>API reference: @pyric/cli/remote · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/cli/remote."><link rel="preconnect" href="https://fonts.googleapis.com"><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet"><link rel="stylesheet" href="/__pyric/ui/_astro/_slug_.DPUwShm2.css"></head> <body>  <header class="studio__bar"> <div class="studio__bar-inner"> <a class="studio__brand" href="/__pyric/ui/" aria-label="Pyric Studio">Pyric</a> <nav class="studio__nav" aria-label="Studio tabs"> <a class="studio__nav-tab" href="/__pyric/ui/"> Home </a><a class="studio__nav-tab" href="/__pyric/ui/firestore"> Firestore </a><a class="studio__nav-tab" href="/__pyric/ui/auth"> Auth </a><a class="studio__nav-tab" href="/__pyric/ui/rtdb"> RTDB </a><a class="studio__nav-tab" href="/__pyric/ui/storage"> Storage </a><a class="studio__nav-tab" href="/__pyric/ui/traffic"> Traffic </a><a class="studio__nav-tab" href="/__pyric/ui/settings"> Settings </a><a class="studio__nav-tab" href="/__pyric/ui/docs" aria-current="page"> Docs </a> </nav> </div> </header> <div class="docs-shell">  <details class="docs-nav-drawer"> <summary>Navigate</summary> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div> <script type="module">let i=null;function d(t){return i||(i=fetch(t).then(e=>e.json())),i}function l(t,e){return t.title.toLowerCase().includes(e)||t.excerpt.toLowerCase().includes(e)?!0:t.headings.some(r=>r.text.toLowerCase().includes(e))}function u(t,e,r){if(e.innerHTML="",t.length===0){e.hidden=!1;{const n=document.createElement("li");n.className="docs-search-empty",n.textContent="No matches",e.appendChild(n)}return}e.hidden=!1;for(const n of t.slice(0,8)){const s=document.createElement("li"),c=document.createElement("a");c.href=n.path;const o=document.createElement("span");o.className="docs-search-result-title",o.textContent=n.title;const a=document.createElement("span");a.className="docs-search-result-meta",a.textContent=[n.group,n.section].filter(Boolean).join(" / "),c.append(o,a),s.appendChild(c),e.appendChild(s)}}document.querySelectorAll(".docs-search").forEach(t=>{const e=t.dataset.indexUrl,r=t.querySelector(".docs-search-input"),n=t.querySelector(".docs-search-results");r.addEventListener("input",async()=>{const s=r.value.trim().toLowerCase();if(!s){n.hidden=!0,n.innerHTML="";return}const{pages:c}=await d(e);r.value.trim().toLowerCase()===s&&u(c.filter(o=>l(o,s)),n)}),r.addEventListener("focus",()=>{d(e),n.childElementCount>0&&(n.hidden=!1)}),r.addEventListener("keydown",s=>{s.key==="Escape"&&(r.value="",n.hidden=!0,n.innerHTML="",r.blur())}),r.addEventListener("blur",()=>{window.setTimeout(()=>{n.hidden=!0},150)})});document.addEventListener("keydown",t=>{if(!(t.metaKey||t.ctrlKey)||t.key.toLowerCase()!=="k")return;const e=[...document.querySelectorAll(".docs-search-input")].find(r=>r.offsetParent!==null);e&&(t.preventDefault(),e.focus(),e.select())});</script> <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/"> Overview </a><details class="docs-nav-group"> <summary>Get started</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/get-started/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/get-started/how-the-swap-works/"> How the swap works </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Build</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/build/authentication/"> Authentication </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-firestore/"> Cloud Firestore </a> </li><li> <a href="/__pyric/ui/docs/build/realtime-database/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-storage/"> Cloud Storage </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-messaging/"> Cloud Messaging </a> </li><li> <a href="/__pyric/ui/docs/build/ai-logic/"> AI Logic </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Secure &amp; debug</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/secure/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/secure/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/secure/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/secure/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/secure/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/secure/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/secure/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/secure/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Observe &amp; shape</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/observe/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/observe/shape-your-data/"> Seed, snapshot, replay </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Ship &amp; test</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/ship/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Work with an agent</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/agent/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/agent/work-with-an-agent/"> Use the MCP tools </a> </li><li> <a href="/__pyric/ui/docs/agent/watch-and-review/"> Watch in Pyric Studio </a> </li> </ul> </div> </div> </details><a class="docs-nav-toplink" href="/__pyric/ui/docs/trust/versioning-and-compatibility/"> Trust </a><details class="docs-nav-group"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/conformance-scores/"> Public API coverage </a> </li><li> <a href="/__pyric/ui/docs/trust/how-we-know-it-matches-firebase/"> How we know it matches Firebase </a> </li><li> <a href="/__pyric/ui/docs/app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/functions-rtdb-compat/"> Functions · RTDB </a> </li><li> <a href="/__pyric/ui/docs/rules-compat/"> Rules </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" open> <summary>Reference</summary> <div class="docs-nav-group-body docs-nav-group-body--reference"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/api-reference/"> API reference </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-app-reference-api/"> pyric/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-reference-api/"> pyric/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-reference-api/"> pyric/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-reference-api/"> pyric/ai </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-scripting-reference-api/"> pyric/ai/scripting </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-reference-api/"> pyric/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-reference-api/"> pyric/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-reference-api/"> pyric/messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-sw-reference-api/"> pyric/messaging/sw </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-reference-api/"> pyric/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-values-reference-api/"> pyric/firestore-values </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-reference-api/"> pyric/sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-firestore-reference-api/"> pyric/sandbox/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-database-reference-api/"> pyric/sandbox/database </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric-admin</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-admin-app-reference-api/"> pyric-admin/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore-reference-api/"> pyric-admin/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth-reference-api/"> pyric-admin/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database-reference-api/"> pyric-admin/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage-reference-api/"> pyric-admin/storage </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">create-pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/create-pyric-reference-api/"> create-pyric </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/cli</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-credentials-node-reference-api/"> @pyric/cli/credentials/node </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-verify-reference-api/"> @pyric/cli/verify </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-reference-api/"> @pyric/cli/conformance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-browser-reference-api/"> @pyric/cli/conformance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-reference-api/"> @pyric/cli/assurance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-browser-reference-api/"> @pyric/cli/assurance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-reference-api/"> @pyric/cli/bridge </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-client-reference-api/"> @pyric/cli/bridge/client </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-discover-reference-api/"> @pyric/cli/discover </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-vite-reference-api/"> @pyric/cli/vite </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-serve-worker-reference-api/"> @pyric/cli/serve/worker </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-remote-reference-api/" aria-current="page"> @pyric/cli/remote </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-register-reference-api/"> @pyric/cli/register </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/ui</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-ui-auth-reference-api/"> @pyric/ui/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-auth-hooks-reference-api/"> @pyric/ui/auth/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-primitives-reference-api/"> @pyric/ui/primitives </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-reference-api/"> @pyric/ui/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-hooks-reference-api/"> @pyric/ui/firestore/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rtdb-reference-api/"> @pyric/ui/rtdb </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-reference-api/"> @pyric/ui/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-hooks-reference-api/"> @pyric/ui/storage/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-reference-api/"> @pyric/ui/traffic </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-hooks-reference-api/"> @pyric/ui/traffic/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-reference-api/"> @pyric/ui/events </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-hooks-reference-api/"> @pyric/ui/events/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-agents-reference-api/"> @pyric/ui/agents </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-reference-api/"> @pyric/ui/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-hooks-reference-api/"> @pyric/ui/rules/hooks </a> </li> </ul> </div> </div> </details> </nav> </details> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div>  <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/" id="nav-group-overview"> Overview </a><details class="docs-nav-group" id="nav-group-get-started"> <summary>Get started</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/get-started/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/get-started/how-the-swap-works/"> How the swap works </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-build"> <summary>Build</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/build/authentication/"> Authentication </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-firestore/"> Cloud Firestore </a> </li><li> <a href="/__pyric/ui/docs/build/realtime-database/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-storage/"> Cloud Storage </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-messaging/"> Cloud Messaging </a> </li><li> <a href="/__pyric/ui/docs/build/ai-logic/"> AI Logic </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-secure-debug"> <summary>Secure &amp; debug</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/secure/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/secure/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/secure/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/secure/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/secure/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/secure/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/secure/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/secure/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-observe-shape"> <summary>Observe &amp; shape</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/observe/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/observe/shape-your-data/"> Seed, snapshot, replay </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-ship-test"> <summary>Ship &amp; test</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/ship/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-work-with-an-agent"> <summary>Work with an agent</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/agent/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/agent/work-with-an-agent/"> Use the MCP tools </a> </li><li> <a href="/__pyric/ui/docs/agent/watch-and-review/"> Watch in Pyric Studio </a> </li> </ul> </div> </div> </details><a class="docs-nav-toplink" href="/__pyric/ui/docs/trust/versioning-and-compatibility/" id="nav-group-trust"> Trust </a><details class="docs-nav-group" id="nav-group-conformance"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/conformance-scores/"> Public API coverage </a> </li><li> <a href="/__pyric/ui/docs/trust/how-we-know-it-matches-firebase/"> How we know it matches Firebase </a> </li><li> <a href="/__pyric/ui/docs/app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/functions-rtdb-compat/"> Functions · RTDB </a> </li><li> <a href="/__pyric/ui/docs/rules-compat/"> Rules </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" id="nav-group-reference" open> <summary>Reference</summary> <div class="docs-nav-group-body docs-nav-group-body--reference"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/api-reference/"> API reference </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-app-reference-api/"> pyric/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-reference-api/"> pyric/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-reference-api/"> pyric/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-reference-api/"> pyric/ai </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-scripting-reference-api/"> pyric/ai/scripting </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-reference-api/"> pyric/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-reference-api/"> pyric/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-reference-api/"> pyric/messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-sw-reference-api/"> pyric/messaging/sw </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-reference-api/"> pyric/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-values-reference-api/"> pyric/firestore-values </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-reference-api/"> pyric/sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-firestore-reference-api/"> pyric/sandbox/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-database-reference-api/"> pyric/sandbox/database </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric-admin</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-admin-app-reference-api/"> pyric-admin/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore-reference-api/"> pyric-admin/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth-reference-api/"> pyric-admin/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database-reference-api/"> pyric-admin/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage-reference-api/"> pyric-admin/storage </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">create-pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/create-pyric-reference-api/"> create-pyric </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/cli</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-credentials-node-reference-api/"> @pyric/cli/credentials/node </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-verify-reference-api/"> @pyric/cli/verify </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-reference-api/"> @pyric/cli/conformance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-browser-reference-api/"> @pyric/cli/conformance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-reference-api/"> @pyric/cli/assurance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-browser-reference-api/"> @pyric/cli/assurance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-reference-api/"> @pyric/cli/bridge </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-client-reference-api/"> @pyric/cli/bridge/client </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-discover-reference-api/"> @pyric/cli/discover </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-vite-reference-api/"> @pyric/cli/vite </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-serve-worker-reference-api/"> @pyric/cli/serve/worker </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-remote-reference-api/" aria-current="page"> @pyric/cli/remote </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-register-reference-api/"> @pyric/cli/register </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/ui</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-ui-auth-reference-api/"> @pyric/ui/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-auth-hooks-reference-api/"> @pyric/ui/auth/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-primitives-reference-api/"> @pyric/ui/primitives </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-reference-api/"> @pyric/ui/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-hooks-reference-api/"> @pyric/ui/firestore/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rtdb-reference-api/"> @pyric/ui/rtdb </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-reference-api/"> @pyric/ui/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-hooks-reference-api/"> @pyric/ui/storage/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-reference-api/"> @pyric/ui/traffic </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-hooks-reference-api/"> @pyric/ui/traffic/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-reference-api/"> @pyric/ui/events </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-hooks-reference-api/"> @pyric/ui/events/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-agents-reference-api/"> @pyric/ui/agents </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-reference-api/"> @pyric/ui/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-hooks-reference-api/"> @pyric/ui/rules/hooks </a> </li> </ul> </div> </div> </details> </nav> <main class="doc-main"> <nav class="docs-breadcrumbs" aria-label="Breadcrumb"> <ol> <li>  <a href="/__pyric/ui/docs/api-reference/">API reference</a> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span>@pyric/cli</span> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span aria-current="page">@pyric/cli/remote</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/cli/remote</code></h1> <p class="api-reference-meta"> 18 published symbols from <code>@pyric/cli</code> </p> <p class="api-reference-source">
+<!DOCTYPE html><html lang="en"> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>API reference: @pyric/cli/remote · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/cli/remote."><link rel="preconnect" href="https://fonts.googleapis.com"><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet"><link rel="stylesheet" href="/__pyric/ui/_astro/_slug_.CXh9yTP1.css">
+<link rel="stylesheet" href="/__pyric/ui/_astro/_slug_.DUci-duz.css"></head> <body>  <header class="studio__bar"> <div class="studio__bar-inner"> <a class="studio__brand" href="/__pyric/ui/" aria-label="Pyric Studio">Pyric</a> <nav class="studio__nav" aria-label="Studio tabs"> <a class="studio__nav-tab" href="/__pyric/ui/"> Home </a><a class="studio__nav-tab" href="/__pyric/ui/firestore"> Firestore </a><a class="studio__nav-tab" href="/__pyric/ui/auth"> Auth </a><a class="studio__nav-tab" href="/__pyric/ui/rtdb"> RTDB </a><a class="studio__nav-tab" href="/__pyric/ui/storage"> Storage </a><a class="studio__nav-tab" href="/__pyric/ui/traffic"> Traffic </a><a class="studio__nav-tab" href="/__pyric/ui/settings"> Settings </a><a class="studio__nav-tab" href="/__pyric/ui/docs" aria-current="page"> Docs </a> </nav> </div> </header> <div class="docs-shell">  <details class="docs-nav-drawer"> <summary>Navigate</summary> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div> <script type="module">let i=null;function d(t){return i||(i=fetch(t).then(e=>e.json())),i}function l(t,e){return t.title.toLowerCase().includes(e)||t.excerpt.toLowerCase().includes(e)?!0:t.headings.some(r=>r.text.toLowerCase().includes(e))}function u(t,e,r){if(e.innerHTML="",t.length===0){e.hidden=!1;{const n=document.createElement("li");n.className="docs-search-empty",n.textContent="No matches",e.appendChild(n)}return}e.hidden=!1;for(const n of t.slice(0,8)){const s=document.createElement("li"),c=document.createElement("a");c.href=n.path;const o=document.createElement("span");o.className="docs-search-result-title",o.textContent=n.title;const a=document.createElement("span");a.className="docs-search-result-meta",a.textContent=[n.group,n.section].filter(Boolean).join(" / "),c.append(o,a),s.appendChild(c),e.appendChild(s)}}document.querySelectorAll(".docs-search").forEach(t=>{const e=t.dataset.indexUrl,r=t.querySelector(".docs-search-input"),n=t.querySelector(".docs-search-results");r.addEventListener("input",async()=>{const s=r.value.trim().toLowerCase();if(!s){n.hidden=!0,n.innerHTML="";return}const{pages:c}=await d(e);r.value.trim().toLowerCase()===s&&u(c.filter(o=>l(o,s)),n)}),r.addEventListener("focus",()=>{d(e),n.childElementCount>0&&(n.hidden=!1)}),r.addEventListener("keydown",s=>{s.key==="Escape"&&(r.value="",n.hidden=!0,n.innerHTML="",r.blur())}),r.addEventListener("blur",()=>{window.setTimeout(()=>{n.hidden=!0},150)})});document.addEventListener("keydown",t=>{if(!(t.metaKey||t.ctrlKey)||t.key.toLowerCase()!=="k")return;const e=[...document.querySelectorAll(".docs-search-input")].find(r=>r.offsetParent!==null);e&&(t.preventDefault(),e.focus(),e.select())});</script> <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/"> Overview </a><details class="docs-nav-group"> <summary>Get started</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/get-started/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/get-started/how-the-swap-works/"> How the swap works </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Build</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/build/authentication/"> Authentication </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-firestore/"> Cloud Firestore </a> </li><li> <a href="/__pyric/ui/docs/build/realtime-database/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-storage/"> Cloud Storage </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-messaging/"> Cloud Messaging </a> </li><li> <a href="/__pyric/ui/docs/build/ai-logic/"> AI Logic </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Secure &amp; debug</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/secure/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/secure/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/secure/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/secure/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/secure/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/secure/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/secure/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/secure/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Observe &amp; shape</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/observe/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/observe/shape-your-data/"> Seed, snapshot, replay </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Ship &amp; test</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/ship/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Work with an agent</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/agent/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/agent/work-with-an-agent/"> Use the MCP tools </a> </li><li> <a href="/__pyric/ui/docs/agent/watch-and-review/"> Watch in Pyric Studio </a> </li> </ul> </div> </div> </details><a class="docs-nav-toplink" href="/__pyric/ui/docs/trust/versioning-and-compatibility/"> Trust </a><details class="docs-nav-group"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/conformance-scores/"> Public API coverage </a> </li><li> <a href="/__pyric/ui/docs/trust/how-we-know-it-matches-firebase/"> How we know it matches Firebase </a> </li><li> <a href="/__pyric/ui/docs/app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/functions-rtdb-compat/"> Functions · RTDB </a> </li><li> <a href="/__pyric/ui/docs/rules-compat/"> Rules </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" open> <summary>Reference</summary> <div class="docs-nav-group-body docs-nav-group-body--reference"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/api-reference/"> API reference </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-app-reference-api/"> pyric/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-reference-api/"> pyric/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-reference-api/"> pyric/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-reference-api/"> pyric/ai </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-scripting-reference-api/"> pyric/ai/scripting </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-reference-api/"> pyric/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-reference-api/"> pyric/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-reference-api/"> pyric/messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-sw-reference-api/"> pyric/messaging/sw </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-reference-api/"> pyric/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-values-reference-api/"> pyric/firestore-values </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-reference-api/"> pyric/sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-firestore-reference-api/"> pyric/sandbox/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-database-reference-api/"> pyric/sandbox/database </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric-admin</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-admin-app-reference-api/"> pyric-admin/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore-reference-api/"> pyric-admin/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth-reference-api/"> pyric-admin/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database-reference-api/"> pyric-admin/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage-reference-api/"> pyric-admin/storage </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">create-pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/create-pyric-reference-api/"> create-pyric </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/cli</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-credentials-node-reference-api/"> @pyric/cli/credentials/node </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-verify-reference-api/"> @pyric/cli/verify </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-reference-api/"> @pyric/cli/conformance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-browser-reference-api/"> @pyric/cli/conformance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-docs-reference-api/"> @pyric/cli/conformance/docs </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-reference-api/"> @pyric/cli/assurance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-browser-reference-api/"> @pyric/cli/assurance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-reference-api/"> @pyric/cli/bridge </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-client-reference-api/"> @pyric/cli/bridge/client </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-discover-reference-api/"> @pyric/cli/discover </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-vite-reference-api/"> @pyric/cli/vite </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-serve-worker-reference-api/"> @pyric/cli/serve/worker </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-remote-reference-api/" aria-current="page"> @pyric/cli/remote </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-register-reference-api/"> @pyric/cli/register </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/ui</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-ui-auth-reference-api/"> @pyric/ui/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-auth-hooks-reference-api/"> @pyric/ui/auth/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-primitives-reference-api/"> @pyric/ui/primitives </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-reference-api/"> @pyric/ui/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-hooks-reference-api/"> @pyric/ui/firestore/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rtdb-reference-api/"> @pyric/ui/rtdb </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-reference-api/"> @pyric/ui/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-hooks-reference-api/"> @pyric/ui/storage/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-reference-api/"> @pyric/ui/traffic </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-hooks-reference-api/"> @pyric/ui/traffic/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-reference-api/"> @pyric/ui/events </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-hooks-reference-api/"> @pyric/ui/events/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-agents-reference-api/"> @pyric/ui/agents </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-reference-api/"> @pyric/ui/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-hooks-reference-api/"> @pyric/ui/rules/hooks </a> </li> </ul> </div> </div> </details> </nav> </details> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div>  <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/" id="nav-group-overview"> Overview </a><details class="docs-nav-group" id="nav-group-get-started"> <summary>Get started</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/get-started/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/get-started/how-the-swap-works/"> How the swap works </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-build"> <summary>Build</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/build/authentication/"> Authentication </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-firestore/"> Cloud Firestore </a> </li><li> <a href="/__pyric/ui/docs/build/realtime-database/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-storage/"> Cloud Storage </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-messaging/"> Cloud Messaging </a> </li><li> <a href="/__pyric/ui/docs/build/ai-logic/"> AI Logic </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-secure-debug"> <summary>Secure &amp; debug</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/secure/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/secure/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/secure/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/secure/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/secure/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/secure/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/secure/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/secure/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-observe-shape"> <summary>Observe &amp; shape</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/observe/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/observe/shape-your-data/"> Seed, snapshot, replay </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-ship-test"> <summary>Ship &amp; test</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/ship/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-work-with-an-agent"> <summary>Work with an agent</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/agent/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/agent/work-with-an-agent/"> Use the MCP tools </a> </li><li> <a href="/__pyric/ui/docs/agent/watch-and-review/"> Watch in Pyric Studio </a> </li> </ul> </div> </div> </details><a class="docs-nav-toplink" href="/__pyric/ui/docs/trust/versioning-and-compatibility/" id="nav-group-trust"> Trust </a><details class="docs-nav-group" id="nav-group-conformance"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/conformance-scores/"> Public API coverage </a> </li><li> <a href="/__pyric/ui/docs/trust/how-we-know-it-matches-firebase/"> How we know it matches Firebase </a> </li><li> <a href="/__pyric/ui/docs/app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/functions-rtdb-compat/"> Functions · RTDB </a> </li><li> <a href="/__pyric/ui/docs/rules-compat/"> Rules </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" id="nav-group-reference" open> <summary>Reference</summary> <div class="docs-nav-group-body docs-nav-group-body--reference"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/api-reference/"> API reference </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-app-reference-api/"> pyric/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-reference-api/"> pyric/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-reference-api/"> pyric/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-reference-api/"> pyric/ai </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-scripting-reference-api/"> pyric/ai/scripting </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-reference-api/"> pyric/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-reference-api/"> pyric/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-reference-api/"> pyric/messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-sw-reference-api/"> pyric/messaging/sw </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-reference-api/"> pyric/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-values-reference-api/"> pyric/firestore-values </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-reference-api/"> pyric/sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-firestore-reference-api/"> pyric/sandbox/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-database-reference-api/"> pyric/sandbox/database </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric-admin</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-admin-app-reference-api/"> pyric-admin/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore-reference-api/"> pyric-admin/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth-reference-api/"> pyric-admin/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database-reference-api/"> pyric-admin/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage-reference-api/"> pyric-admin/storage </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">create-pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/create-pyric-reference-api/"> create-pyric </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/cli</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-credentials-node-reference-api/"> @pyric/cli/credentials/node </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-verify-reference-api/"> @pyric/cli/verify </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-reference-api/"> @pyric/cli/conformance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-browser-reference-api/"> @pyric/cli/conformance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-docs-reference-api/"> @pyric/cli/conformance/docs </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-reference-api/"> @pyric/cli/assurance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-browser-reference-api/"> @pyric/cli/assurance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-reference-api/"> @pyric/cli/bridge </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-client-reference-api/"> @pyric/cli/bridge/client </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-discover-reference-api/"> @pyric/cli/discover </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-vite-reference-api/"> @pyric/cli/vite </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-serve-worker-reference-api/"> @pyric/cli/serve/worker </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-remote-reference-api/" aria-current="page"> @pyric/cli/remote </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-register-reference-api/"> @pyric/cli/register </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/ui</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-ui-auth-reference-api/"> @pyric/ui/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-auth-hooks-reference-api/"> @pyric/ui/auth/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-primitives-reference-api/"> @pyric/ui/primitives </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-reference-api/"> @pyric/ui/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-hooks-reference-api/"> @pyric/ui/firestore/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rtdb-reference-api/"> @pyric/ui/rtdb </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-reference-api/"> @pyric/ui/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-hooks-reference-api/"> @pyric/ui/storage/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-reference-api/"> @pyric/ui/traffic </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-hooks-reference-api/"> @pyric/ui/traffic/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-reference-api/"> @pyric/ui/events </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-hooks-reference-api/"> @pyric/ui/events/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-agents-reference-api/"> @pyric/ui/agents </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-reference-api/"> @pyric/ui/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-hooks-reference-api/"> @pyric/ui/rules/hooks </a> </li> </ul> </div> </div> </details> </nav> <main class="doc-main"> <nav class="docs-breadcrumbs" aria-label="Breadcrumb"> <ol> <li>  <a href="/__pyric/ui/docs/api-reference/">API reference</a> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span>@pyric/cli</span> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span aria-current="page">@pyric/cli/remote</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/cli/remote</code></h1> <p class="api-reference-meta"> 18 published symbols from <code>@pyric/cli</code> </p> <p class="api-reference-source">
 Generated from the TypeScript declarations shipped at this import path.
-</p>  </header> <article class="prose api-reference-body">  <!-- Generated from published package declarations via TypeDoc. Do not edit by hand; run bun run docs:api:generate. -->
+</p>  </header> <article class="prose api-reference-body">  <!-- Generated from published package declarations via TypeDoc. Rendered by the api-reference content loader. -->
 <h2 id="interfaces">Interfaces</h2>
 <p><a id="connectremotesandboxoptions"></a></p>
 <h3 id="connectremotesandboxoptions">ConnectRemoteSandboxOptions</h3>
@@ -84,16 +85,502 @@ settles with the same fail-fast errors <a href="#connectremotesandbox">connectRe
-<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="auth"></a> <code>auth</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remoteauthadmin"><code>RemoteAuthAdmin</code></a></td><td align="left">Admin auth user CRUD.</td></tr><tr><td align="left"><a id="channel"></a> <code>channel</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td><td align="left">The raw worker op/sub relay channel (narrowed to the wire payload types).</td></tr><tr><td align="left"><a id="ready"></a> <code>ready</code></td><td align="left"><code>readonly</code></td><td align="left"><code>Promise</code>&#x3C;<code>void</code>></td><td align="left">-</td></tr><tr><td align="left"><a id="rtdb"></a> <code>rtdb</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotertdb"><code>RemoteRtdb</code></a></td><td align="left">RTDB conveniences (admin lens pinned).</td></tr><tr><td align="left"><a id="storage"></a> <code>storage</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotestorage"><code>RemoteStorage</code></a></td><td align="left">Storage conveniences (admin lens pinned; 8 MiB per-op byte cap).</td></tr></tbody></table></div>
+<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="remote_sandbox"></a> <code>[REMOTE_SANDBOX]</code></td><td align="left"><code>readonly</code></td><td align="left"><code>true</code></td><td align="left">-</td></tr><tr><td align="left"><a id="admin"></a> <code>admin</code></td><td align="left"><code>readonly</code></td><td align="left"><code>SandboxAdmin</code></td><td align="left">Admin-plane access (rule-bypass reads). Identity-agnostic by design — admin reads aren’t gated on auth, so they live on the sandbox, not on a context. See SandboxAdmin.</td></tr><tr><td align="left"><a id="auth"></a> <code>auth</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remoteauthadmin"><code>RemoteAuthAdmin</code></a></td><td align="left">Admin auth user CRUD.</td></tr><tr><td align="left"><a id="channel"></a> <code>channel</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td><td align="left">The raw worker op/sub relay channel (narrowed to the wire payload types).</td></tr><tr><td align="left"><a id="currentuser"></a> <code>currentUser</code></td><td align="left"><code>public</code></td><td align="left">{ <code>token?</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>; <code>uid</code>: <code>string</code>; }</td><td align="left">Current authenticated user across the sandbox. Mutated by <code>pyric/auth</code>’s <code>signInAnonymously</code> / <code>signInWithEmailAndPassword</code> / <code>signOut</code> / <code>sandbox.setUser</code>. Read per-call by service factories (e.g. a future <code>getFirestore(sandbox)</code> overload) so they see auth state changes without re-binding handles. Defaults to <code>null</code> (anonymous / signed out). <strong>Independent of <code>withAuth({uid})</code></strong> — <code>withAuth</code> still produces a frozen <a href="/docs/pyric-firestore-reference-api/#sandboxcontext">SandboxContext</a> that carries its own identity for the runner’s test code (the existing pattern: explicit identity per service call). <code>currentUser</code> exists for the <code>pyric/auth</code> mirror, where consumer app code drives identity through a stateful <code>Auth</code> handle rather than naming it per call.</td></tr><tr><td align="left"><code>currentUser.token?</code></td><td align="left"><code>public</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td><td align="left">-</td></tr><tr><td align="left"><code>currentUser.uid</code></td><td align="left"><code>public</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="ready"></a> <code>ready</code></td><td align="left"><code>readonly</code></td><td align="left"><code>Promise</code>&#x3C;<code>void</code>></td><td align="left">-</td></tr><tr><td align="left"><a id="rtdb"></a> <code>rtdb</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotertdb"><code>RemoteRtdb</code></a></td><td align="left">RTDB conveniences (admin lens pinned).</td></tr><tr><td align="left"><a id="serveurl"></a> <code>serveUrl</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td><td align="left">Base URL of the <code>pyric dev</code> this handle is attached to (used in error guidance: “open <serveurl> in a browser and retry”).</serveurl></td></tr><tr><td align="left"><a id="storage"></a> <code>storage</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotestorage"><code>RemoteStorage</code></a></td><td align="left">Storage conveniences (admin lens pinned; 8 MiB per-op byte cap).</td></tr></tbody></table></div>
 <h4 id="methods">Methods</h4>
+<p><a id="clearpersistence"></a></p>
+<h5 id="clearpersistence">clearPersistence()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">clearPersistence</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Wipe the persisted blob for this sandbox’s <code>key</code>. In-memory state
+is left intact — call <code>reset()</code> if you want both. Useful for
+“sign out and forget” flows.</p>
+<p>No-op when persistence is not enabled.</p>
+<h6 id="returns">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<h6 id="inherited-from">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#clearpersistence-2"><code>clearPersistence</code></a></p>
 <p><a id="close"></a></p>
 <h5 id="close">close()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">close</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Close the connection. In-flight ops reject; subscriptions stop.</p>
-<h6 id="returns">Returns</h6>
+<h6 id="returns-1">Returns</h6>
 <p><code>void</code></p>
-<h6 id="inherited-from">Inherited from</h6>
+<h6 id="inherited-from-1">Inherited from</h6>
 <p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#close-2"><code>close</code></a></p>
+<p><a id="dispose"></a></p>
+<h5 id="dispose">dispose()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">dispose</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Tear down listener registries on this sandbox’s environment without
+replacing it. Use this when you’re about to discard the sandbox
+itself (e.g. <code>runner.reseed()</code> builds a fresh sandbox rather than
+calling <code>reset()</code>) and want to drop callback references on the
+outgoing instance defensively. Idempotent. Does not touch data.</p>
+<h6 id="returns-2">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-2">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#dispose-2"><code>dispose</code></a></p>
+<p><a id="enablepersistence"></a></p>
+<h5 id="enablepersistence">enablePersistence()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">enablePersistence</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">options</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">SandboxPersistenceOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Persist the sandbox’s data to a backend and restore it on next
+<code>enablePersistence</code> call. The default <code>'indexedDB'</code> backend turns
+the sandbox into the host page’s local Firestore — writes flush
+automatically and a fresh <code>initializeSandbox()</code> rehydrates from
+the prior session.</p>
+<p>Restoration happens before the promise resolves; awaiting this
+call is sufficient to guarantee in-memory state matches the
+persisted blob.</p>
+<p>Idempotent across the same <code>key</code> — calling twice in one process
+is a no-op on the second call. Different keys are rejected as an
+error (a sandbox can persist to at most one backend at a time).</p>
+<p>Listener semantics: every write event the sandbox emits triggers
+a debounced flush (default 250ms). Browser hosts additionally
+flush on <code>beforeunload</code> so a page navigation doesn’t lose the
+tail of the debounce window.</p>
+<p>See <a href="/docs/pyric-sandbox-reference-api/#sandboxpersistenceoptions">SandboxPersistenceOptions</a> for backend selection and
+tuning.</p>
+<h6 id="parameters">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#sandboxpersistenceoptions"><code>SandboxPersistenceOptions</code></a></td></tr></tbody></table></div>
+<h6 id="returns-3">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<h6 id="inherited-from-3">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#enablepersistence-2"><code>enablePersistence</code></a></p>
+<p><a id="enabletabsync"></a></p>
+<h5 id="enabletabsync">enableTabSync()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">enableTabSync</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">options</span><span style="color:#C678DD">?:</span><span style="color:#E06C75"> TabSyncOptions</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Enable cross-tab realtime sync via <code>BroadcastChannel</code>. A write in
+this tab will propagate to every OTHER tab of the same origin that
+also called <code>enableTabSync</code>, causing their <code>onSnapshot</code> listeners to
+re-evaluate — restoring production’s cross-client realtime behavior.</p>
+<p><strong>Opt-in, OFF by default.</strong> Firestore only (RTDB is a follow-on).</p>
+<p>Returns a disable function. Calling it removes the <code>onEvent</code>
+subscription, the channel message listener, and closes the channel
+(when it was created internally). After disable, no further propagation
+occurs in either direction.</p>
+<p><strong>Multi-writer note:</strong> concurrent writes from two tabs to the same doc
+produce last-write-wins divergence — there is no conflict resolution.
+The intended model is one active writer (one user, one tab) with
+observers in other tabs; this covers the overwhelming majority of
+local development scenarios.</p>
+<h6 id="parameters-1">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options?</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#tabsyncoptions"><code>TabSyncOptions</code></a></td></tr></tbody></table></div>
+<h6 id="returns-4">Returns</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-5">Returns</h6>
+<p><code>void</code></p>
+<h6 id="see">See</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#tabsyncoptions">TabSyncOptions</a> for channel injection (tests) and originId.</p>
+<h6 id="example">Example</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#7F848E;font-style:italic">// In every tab that should participate in realtime:</span></span>
+<span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> sandbox</span><span style="color:#56B6C2"> =</span><span style="color:#61AFEF"> initializeSandbox</span><span style="color:#ABB2BF">();</span></span>
+<span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> disableSync</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> sandbox</span><span style="color:#ABB2BF">.</span><span style="color:#61AFEF">enableTabSync</span><span style="color:#ABB2BF">();</span></span>
+<span class="line"><span style="color:#7F848E;font-style:italic">// Later, to stop syncing:</span></span>
+<span class="line"><span style="color:#61AFEF">disableSync</span><span style="color:#ABB2BF">();</span></span></code></pre>
+<h6 id="inherited-from-4">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#enabletabsync-2"><code>enableTabSync</code></a></p>
+<p><a id="flush"></a></p>
+<h5 id="flush">flush()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">flush</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Force a snapshot to the configured persistence backend right now.
+Useful before a manual navigation, or in tests that need
+deterministic ordering against the debounce window. Resolves once
+the write hits the backend.</p>
+<p>Throws if persistence is not enabled.</p>
+<h6 id="returns-6">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<h6 id="inherited-from-5">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#flush-2"><code>flush</code></a></p>
+<p><a id="history"></a></p>
+<h5 id="history">history()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">history</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">SandboxEvent</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<p>Every <a href="/docs/pyric-sandbox-reference-api/#sandboxevent">SandboxEvent</a> this sandbox has emitted since init or
+the last <code>reset()</code>. Returns a defensive copy.</p>
+<p>Use this for replay: hand the array to <code>replay(events, rules)</code>
+from <code>pyric/sandbox</code> and the engine re-issues every
+captured write against a fresh sandbox.</p>
+<p>Unlike <a href="/docs/pyric-firestore-reference-api/#onevent">onEvent</a> (live stream from the moment of subscribe),
+<code>history()</code> returns <em>every</em> event the sandbox has seen — useful
+for consumers that attach late (e.g., loading a saved session
+before subscribing) or that need a snapshot at a particular moment.</p>
+<p><code>reset()</code> and <code>dispose()</code> each append a closing <code>session_boundary</code>
+event; <code>reset()</code> then clears the history. Consumers that took a
+snapshot <em>before</em> reset retain the boundary in their copy.</p>
+<h6 id="returns-7">Returns</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#sandboxevent"><code>SandboxEvent</code></a>[]</p>
+<h6 id="inherited-from-6">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#history-2"><code>history</code></a></p>
+<p><a id="loadsnapshot"></a></p>
+<h5 id="loadsnapshot">loadSnapshot()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">loadSnapshot</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">data</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">SandboxSnapshot</span><span style="color:#ABB2BF">): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>CLOBBER-restore the sandbox’s entire state from a prior <a href="/docs/pyric-firestore-reference-api/#snapshot">snapshot</a>:
+<code>reset()</code> (clears firestore + the signed-in session), then rebuild firestore
+from <code>data</code> and restore each registered service. This is a TOTAL replace —
+documents absent from <code>data</code> do NOT survive — and is the counterpart to
+<a href="/docs/pyric-firestore-reference-api/#snapshot">snapshot</a>. It is what makes “transfer (clobber) one instance’s data
+into another” and named-branch switching possible.</p>
+<p>Fires a <code>session_boundary</code> (reset phase), re-evaluates live listeners against
+the loaded state, and the next persistence flush writes the loaded state.
+Services present in <code>data</code> but not currently registered are skipped (a
+snapshot taken via <a href="/docs/pyric-firestore-reference-api/#snapshot">snapshot</a> always includes every registered
+service, so this only affects cross-instance imports from a sandbox that had
+a service this one lacks).</p>
+<h6 id="parameters-2">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>data</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#sandboxsnapshot"><code>SandboxSnapshot</code></a></td></tr></tbody></table></div>
+<h6 id="returns-8">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-7">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#loadsnapshot-2"><code>loadSnapshot</code></a></p>
+<p><a id="oncurrentuserchanged"></a></p>
+<h5 id="oncurrentuserchanged">onCurrentUserChanged()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">onCurrentUserChanged</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">cb</span><span style="color:#ABB2BF">: (</span><span style="color:#E06C75;font-style:italic">user</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  token</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">>;</span></span>
+<span class="line"><span style="color:#E06C75">  uid</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}) </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Subscribe to <code>currentUser</code> changes. Fires on every mutation —
+sign-in, sign-out, user swap. Does NOT fire on subscribe.</p>
+<p>Survives <code>reset()</code> and <code>dispose()</code> only as a no-op: a disposed
+sandbox emits nothing further; a reset sandbox clears
+<code>currentUser</code> to <code>null</code> (and fires the change) before swapping
+the env.</p>
+<p>Returns an unsubscribe function. Listener errors are swallowed —
+subscribers are observational, the sandbox does not propagate
+their errors.</p>
+<h6 id="parameters-3">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>cb</code></td><td align="left">(<code>user</code>: { <code>token?</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>; <code>uid</code>: <code>string</code>; }) => <code>void</code></td></tr></tbody></table></div>
+<h6 id="returns-9">Returns</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-10">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-8">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#oncurrentuserchanged-2"><code>onCurrentUserChanged</code></a></p>
+<p><a id="onevent"></a></p>
+<h5 id="onevent">onEvent()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">onEvent</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">cb</span><span style="color:#ABB2BF">: (</span><span style="color:#E06C75;font-style:italic">event</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">SandboxEvent</span><span style="color:#ABB2BF">) </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Subscribe to every event the sandbox emits — see <a href="/docs/pyric-sandbox-reference-api/#sandboxevent">SandboxEvent</a>
+for the discriminated-union shape. One subscription covers
+request/denial/snapshot-error/listener-lifecycle/session-boundary;
+filter on <code>event.kind</code> to recover individual streams.</p>
+<p>Replaces the prior three-channel surface (<code>onRequest</code> / <code>onDenial</code>
+/ <code>onSnapshotError</code>) — see issue #307. Filter cookbook:</p>
+<ul>
+<li>All denials:    <code>event.kind === 'request' &#x26;&#x26; event.result === 'deny'</code></li>
+<li>Stream errors:  <code>event.kind === 'listener_errored'</code></li>
+<li>Per-op traffic: <code>event.kind === 'request'</code></li>
+</ul>
+<p>Survives <code>sandbox.reset()</code> — the subscription is held on the
+sandbox, not on the underlying environment. A <code>session_boundary</code>
+event with <code>phase: 'reset'</code> fires before the env swap so consumers
+can segment their stream.</p>
+<p>Returns an unsubscribe function. Listener errors are swallowed so a
+faulty subscriber can’t change rule semantics or hide other events.
+Both synchronous throws and rejected Promises from async callbacks
+are silently discarded — subscribers are <strong>observational</strong>, the
+sandbox doesn’t await them and doesn’t propagate their errors.</p>
+<h6 id="parameters-4">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>cb</code></td><td align="left">(<code>event</code>: <a href="/docs/pyric-sandbox-reference-api/#sandboxevent"><code>SandboxEvent</code></a>) => <code>void</code></td></tr></tbody></table></div>
+<h6 id="returns-11">Returns</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-12">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-9">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#onevent-2"><code>onEvent</code></a></p>
+<p><a id="registerpersistableservice"></a></p>
+<h5 id="registerpersistableservice">registerPersistableService()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">registerPersistableService</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">name</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">hooks</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">PersistableService</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Register a service (auth, storage, …) as a persistence participant.
+The sandbox calls <code>hooks.snapshot()</code> on every flush and
+<code>hooks.restore(data)</code> on restore. If <code>hooks.subscribe</code> is provided,
+the persistence controller subscribes and schedules a debounced
+flush on each change — so auth-user edits flush promptly, not only
+on the next Firestore write.</p>
+<p>Returns an unregister function — call it if the service is torn
+down before the sandbox is disposed (uncommon in practice; the
+sandbox’s <code>dispose()</code> clears the registry anyway).</p>
+<p>Throws <code>failed-precondition</code> when a service with the same <code>name</code> is
+already registered — the auth package registers <code>'auth'</code> once when
+<code>getAuth(sandbox)</code> first creates a backend, so accidental double-
+registration is a caller bug, not a no-op.</p>
+<p><strong>Advanced / internal API.</strong> Service packages (auth, storage) call
+this when they first attach to a sandbox. Consumer app code should
+not need to call this directly.</p>
+<h6 id="parameters-5">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>name</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>hooks</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#persistableservice"><code>PersistableService</code></a></td></tr></tbody></table></div>
+<h6 id="returns-13">Returns</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-14">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-10">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#registerpersistableservice-2"><code>registerPersistableService</code></a></p>
+<p><a id="reset"></a></p>
+<h5 id="reset">reset()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">reset</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Reset the underlying environment to a fresh state — wipes data,
+rules, and any service-specific configuration.</p>
+<p>Snapshot listeners attached to the OLD environment are dropped at
+the swap — they can’t survive because their target docs have been
+wiped. <code>onEvent</code> subscribers DO survive — the registry lives on
+the sandbox, and a <code>session_boundary</code> event with <code>phase: 'reset'</code>
+fires before the swap so subscribers know the rollover happened.
+Existing <a href="/docs/pyric-firestore-reference-api/#sandboxcontext">SandboxContext</a>s continue to work — their sandbox
+reference is stable; subsequent operations resolve to the new env.</p>
+<h6 id="returns-15">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-11">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#reset-2"><code>reset</code></a></p>
+<p><a id="resetall"></a></p>
+<h5 id="resetall">resetAll()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">resetAll</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;{</span></span>
+<span class="line"><span style="color:#E06C75">  errors</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">[];</span></span>
+<span class="line"><span style="color:#ABB2BF">}>;</span></span></code></pre>
+<p>Reset the WHOLE sandbox: <a href="/docs/pyric-firestore-reference-api/#reset">reset</a> (Firestore env + signed-in
+session), then clear every registered persistable service that
+provides a <a href="/docs/pyric-sandbox-reference-api/#reset-2">PersistableService.reset</a> hook — auth users, the
+RTDB tree, storage objects. This is the one sandbox-owned “wipe
+everything” path: because it iterates the service registry, a new
+service that registers with a <code>reset</code> hook is cleared automatically,
+and a consumer (Pyric Studio’s reset) cannot forget one.</p>
+<p>Service resets may be async (storage clears IndexedDB stores); the
+returned promise resolves when every service has finished clearing.
+A service whose <code>reset</code> throws is isolated (others still clear) and
+REPORTED in the returned <code>errors</code> (as <code>name: message</code>) — a reset that
+leaves data behind must never look successful to the caller.</p>
+<h6 id="returns-16">Returns</h6>
+<p><code>Promise</code>&#x3C;{
+<code>errors</code>: <code>string</code>[];
+}></p>
+<h6 id="inherited-from-12">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#resetall-2"><code>resetAll</code></a></p>
+<p><a id="runwithprovenance"></a></p>
+<h5 id="runwithprovenance">runWithProvenance()?</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">optional</span><span style="color:#61AFEF"> runWithProvenance</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">T</span><span style="color:#ABB2BF">>(</span><span style="color:#E06C75">provenance</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">EventProvenance</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">fn</span><span style="color:#ABB2BF">: () </span><span style="color:#C678DD">=></span><span style="color:#E5C07B"> T</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">T</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Run <code>fn</code> with ambient <a href="/docs/pyric-sandbox-reference-api/#eventprovenance">EventProvenance</a> defaults: every event
+emitted SYNCHRONOUSLY during <code>fn</code> that doesn’t already carry a
+provenance field (on the event itself or via an explicit per-emit
+override) is stamped with these values instead of the global
+defaults. This is the mechanical “who issued this op” seam the
+serve worker uses to tag Studio-issued ops (<code>actor: { kind: 'studio' }</code>) and to stamp the auth lens an op ran under
+(<code>authLens</code>) — declared by the caller that issues the op, never
+inferred from the op’s shape.</p>
+<p>SYNCHRONOUS WINDOW: the ambient values apply only until <code>fn</code>
+returns (for an async <code>fn</code>, its synchronous prefix — which covers
+the local environment’s rules eval + event emission, since those
+run before the op’s promise is handed back). Work an op DEFERS
+(snapshot-listener deliveries and re-evals drain on a microtask,
+off-stack) is intentionally OUTSIDE the window: a listener re-eval
+belongs to the listener’s owner, not to whoever’s write triggered
+it. Nested calls stack — the innermost window wins per field, and
+each window restores the previous one on exit (including on throw).</p>
+<p>OPTIONAL because remote sandbox proxies can’t provide an ambient
+emit window (events are emitted in the worker they front). Callers
+spell <code>sandbox.runWithProvenance?.(prov, fn) ?? fn()</code>.</p>
+<h6 id="type-parameters">Type Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Type Parameter</th></tr></thead><tbody><tr><td align="left"><code>T</code></td></tr></tbody></table></div>
+<h6 id="parameters-6">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>provenance</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#eventprovenance"><code>EventProvenance</code></a></td></tr><tr><td align="left"><code>fn</code></td><td align="left">() => <code>T</code></td></tr></tbody></table></div>
+<h6 id="returns-17">Returns</h6>
+<p><code>T</code></p>
+<h6 id="inherited-from-13">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#runwithprovenance-2"><code>runWithProvenance</code></a></p>
+<p><a id="snapshot"></a></p>
+<h5 id="snapshot">snapshot()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">snapshot</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">SandboxSnapshot</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Capture a snapshot of every service’s state. For v1 with only
+Firestore, the return value carries a <code>firestore</code> key mapping doc
+paths to data. Future services will add their own keys.</p>
+<h6 id="returns-18">Returns</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#sandboxsnapshot"><code>SandboxSnapshot</code></a></p>
+<h6 id="inherited-from-14">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#snapshot-2"><code>snapshot</code></a></p>
+<p><a id="withauth"></a></p>
+<h5 id="withauth">withAuth()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">withAuth</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">auth</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#ABB2BF">  token?: </span><span style="color:#E06C75">Record</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, unknown>;</span></span>
+<span class="line"><span style="color:#E06C75">  uid</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}): </span><span style="color:#E06C75">SandboxContext</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Derive a context bound to this sandbox under the given auth
+identity. Operations through services attached to the returned
+context evaluate rules under that identity. Many contexts can
+coexist for one sandbox; data is shared.</p>
+<p><code>null</code> is anonymous; an <code>AuthState</code> object names the user (and
+optional custom claims). Passing <code>undefined</code> is a deliberate
+error — say <code>withAuth(null)</code> for anonymous so the call site is
+unambiguous.</p>
+<h6 id="parameters-7">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left">{ <code>token?</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>; <code>uid</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>auth.token?</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr><tr><td align="left"><code>auth.uid</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-19">Returns</h6>
+<p><a href="/docs/pyric-firestore-reference-api/#sandboxcontext"><code>SandboxContext</code></a></p>
+<h6 id="example-1">Example</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> sandbox</span><span style="color:#56B6C2"> =</span><span style="color:#61AFEF"> initializeSandbox</span><span style="color:#ABB2BF">();</span></span>
+<span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> dbAlice</span><span style="color:#56B6C2"> =</span><span style="color:#61AFEF"> getFirestore</span><span style="color:#ABB2BF">(</span><span style="color:#E5C07B">sandbox</span><span style="color:#ABB2BF">.</span><span style="color:#61AFEF">withAuth</span><span style="color:#ABB2BF">({ </span><span style="color:#E06C75">uid</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">'alice'</span><span style="color:#ABB2BF"> }));</span></span>
+<span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> dbAnon</span><span style="color:#56B6C2">  =</span><span style="color:#61AFEF"> getFirestore</span><span style="color:#ABB2BF">(</span><span style="color:#E5C07B">sandbox</span><span style="color:#ABB2BF">.</span><span style="color:#61AFEF">withAuth</span><span style="color:#ABB2BF">(</span><span style="color:#D19A66">null</span><span style="color:#ABB2BF">));</span></span></code></pre>
+<h6 id="inherited-from-15">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#withauth-2"><code>withAuth</code></a></p>
 <hr>
 <p><a id="remoteauthadmin"></a></p>
 <h3 id="remoteauthadmin">RemoteAuthAdmin</h3>
@@ -103,12 +590,12 @@ worker’s user pool directly, mirroring <code>pyric/auth</code>’s sandbox ops
 <p><a id="clearusers"></a></p>
 <h5 id="clearusers">clearUsers()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">clearUsers</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="returns-1">Returns</h6>
+<h6 id="returns-20">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <p><a id="createuser"></a></p>
 <h5 id="createuser">createUser()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">createUser</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">request</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">CreateUserRequest</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">AuthUserRecord</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="parameters">Parameters</h6>
+<h6 id="parameters-8">Parameters</h6>
 <div class="table-scroll">
@@ -122,13 +609,13 @@ worker’s user pool directly, mirroring <code>pyric/auth</code>’s sandbox ops
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>request</code></td><td align="left"><code>CreateUserRequest</code></td></tr></tbody></table></div>
-<h6 id="returns-2">Returns</h6>
-<p><code>Promise</code>&#x3C;<code>AuthUserRecord</code>></p>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>request</code></td><td align="left"><a href="/docs/pyric-auth-reference-api/#createuserrequest"><code>CreateUserRequest</code></a></td></tr></tbody></table></div>
+<h6 id="returns-21">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-auth-reference-api/#authuserrecord"><code>AuthUserRecord</code></a>></p>
 <p><a id="deleteuser"></a></p>
 <h5 id="deleteuser">deleteUser()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">deleteUser</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">uid</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="parameters-1">Parameters</h6>
+<h6 id="parameters-9">Parameters</h6>
 <div class="table-scroll">
@@ -143,17 +630,17 @@ worker’s user pool directly, mirroring <code>pyric/auth</code>’s sandbox ops
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>uid</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-3">Returns</h6>
+<h6 id="returns-22">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <p><a id="listusers"></a></p>
 <h5 id="listusers">listUsers()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">listUsers</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">AuthUserRecord</span><span style="color:#ABB2BF">[]</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="returns-4">Returns</h6>
-<p><code>Promise</code>&#x3C;<code>AuthUserRecord</code>[]></p>
+<h6 id="returns-23">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-auth-reference-api/#authuserrecord"><code>AuthUserRecord</code></a>[]></p>
 <p><a id="updateuser"></a></p>
 <h5 id="updateuser">updateUser()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">updateUser</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">uid</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">request</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">UpdateUserRequest</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">AuthUserRecord</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="parameters-2">Parameters</h6>
+<h6 id="parameters-10">Parameters</h6>
 <div class="table-scroll">
@@ -171,9 +658,9 @@ worker’s user pool directly, mirroring <code>pyric/auth</code>’s sandbox ops
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>uid</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>request</code></td><td align="left"><code>UpdateUserRequest</code></td></tr></tbody></table></div>
-<h6 id="returns-5">Returns</h6>
-<p><code>Promise</code>&#x3C;<code>AuthUserRecord</code>></p>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>uid</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>request</code></td><td align="left"><a href="/docs/pyric-auth-reference-api/#updateuserrequest"><code>UpdateUserRequest</code></a></td></tr></tbody></table></div>
+<h6 id="returns-24">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-auth-reference-api/#authuserrecord"><code>AuthUserRecord</code></a>></p>
 <hr>
 <p><a id="remotertdb"></a></p>
 <h3 id="remotertdb">RemoteRtdb</h3>
@@ -186,7 +673,7 @@ matching what <code>pyric-admin</code>’s database backend needs. Use the raw
 <h5 id="get">get()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">get</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">unknown</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Read the value at <code>path</code> (null when absent).</p>
-<h6 id="parameters-3">Parameters</h6>
+<h6 id="parameters-11">Parameters</h6>
 <div class="table-scroll">
@@ -201,7 +688,7 @@ matching what <code>pyric-admin</code>’s database backend needs. Use the raw
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-6">Returns</h6>
+<h6 id="returns-25">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>unknown</code>></p>
 <p><a id="onvalue"></a></p>
 <h5 id="onvalue">onValue()</h5>
@@ -212,7 +699,7 @@ matching what <code>pyric-admin</code>’s database backend needs. Use the raw
 <span class="line"><span style="color:#E06C75">  code</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
 <span class="line"><span style="color:#ABB2BF">}) </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Subscribe to the value at <code>path</code> (initial snapshot + every change).</p>
-<h6 id="parameters-4">Parameters</h6>
+<h6 id="parameters-12">Parameters</h6>
 <div class="table-scroll">
@@ -235,9 +722,9 @@ matching what <code>pyric-admin</code>’s database backend needs. Use the raw
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>callback</code></td><td align="left">(<code>snapshot</code>: <a href="#remotertdbsnapshot"><code>RemoteRtdbSnapshot</code></a>) => <code>void</code></td></tr><tr><td align="left"><code>onError?</code></td><td align="left">(<code>err</code>: <code>Error</code> &#x26; { <code>code</code>: <code>string</code>; }) => <code>void</code></td></tr></tbody></table></div>
-<h6 id="returns-7">Returns</h6>
+<h6 id="returns-26">Returns</h6>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="returns-8">Returns</h6>
+<h6 id="returns-27">Returns</h6>
 <p><code>void</code></p>
 <p><a id="push"></a></p>
 <h5 id="push">push()</h5>
@@ -248,7 +735,7 @@ matching what <code>pyric-admin</code>’s database backend needs. Use the raw
 <p>Push <code>value</code> under a CLIENT-minted 20-char push id (the worker-protocol
 contract: <code>rtdb.push</code> carries the key, so <code>.key</code> is known synchronously
 on the pyric-admin side). Resolves with the minted key + full path.</p>
-<h6 id="parameters-5">Parameters</h6>
+<h6 id="parameters-13">Parameters</h6>
 <div class="table-scroll">
@@ -267,7 +754,7 @@ on the pyric-admin side). Resolves with the minted key + full path.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>value?</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
-<h6 id="returns-9">Returns</h6>
+<h6 id="returns-28">Returns</h6>
 <p><code>Promise</code>&#x3C;{
 <code>key</code>: <code>string</code>;
 <code>path</code>: <code>string</code>;
@@ -275,7 +762,7 @@ on the pyric-admin side). Resolves with the minted key + full path.</p>
 <p><a id="remove"></a></p>
 <h5 id="remove">remove()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">remove</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="parameters-6">Parameters</h6>
+<h6 id="parameters-14">Parameters</h6>
 <div class="table-scroll">
@@ -290,12 +777,12 @@ on the pyric-admin side). Resolves with the minted key + full path.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-10">Returns</h6>
+<h6 id="returns-29">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <p><a id="set"></a></p>
 <h5 id="set">set()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">set</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">unknown</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="parameters-7">Parameters</h6>
+<h6 id="parameters-15">Parameters</h6>
 <div class="table-scroll">
@@ -314,12 +801,12 @@ on the pyric-admin side). Resolves with the minted key + full path.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
-<h6 id="returns-11">Returns</h6>
+<h6 id="returns-30">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <p><a id="update"></a></p>
 <h5 id="update">update()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">update</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">values</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">Record</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">unknown</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="parameters-8">Parameters</h6>
+<h6 id="parameters-16">Parameters</h6>
 <div class="table-scroll">
@@ -338,7 +825,7 @@ on the pyric-admin side). Resolves with the minted key + full path.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>values</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr></tbody></table></div>
-<h6 id="returns-12">Returns</h6>
+<h6 id="returns-31">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="remotertdbsnapshot"></a></p>
@@ -375,7 +862,7 @@ on the pyric-admin side). Resolves with the minted key + full path.</p>
 <p><a id="remotesandbox"></a></p>
 <h3 id="remotesandbox">RemoteSandbox</h3>
 <p>The Node-side remote sandbox handle. Extends <code>pyric/sandbox</code>’s branded
-RemoteSandboxBase — structurally a full <code>Sandbox</code>, so it can be
+<a href="/docs/pyric-sandbox-reference-api/#remotesandbox">RemoteSandboxBase</a> — structurally a full <code>Sandbox</code>, so it can be
 passed to <code>pyric-admin/app</code>’s <code>initializeApp({ sandbox })</code>, whose RTDB and
 Auth backends dispatch on the brand and route through <a href="#channel-1">channel</a>.</p>
 <p>Sandbox members that are genuinely sync-only (<code>admin</code>, <code>snapshot()</code>,
@@ -385,7 +872,7 @@ what to do instead. Implemented members: <code>withAuth</code> (pure local pair
 construction) and <code>dispose</code> (aliases <a href="#close-2">close</a>).</p>
 <h4 id="extends-1">Extends</h4>
 <ul>
-<li><code>unknown</code></li>
+<li><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a></li>
 </ul>
 <h4 id="extended-by">Extended by</h4>
 <ul>
@@ -427,14 +914,511 @@ construction) and <code>dispose</code> (aliases <a href="#close-2">close</a>).</
-<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="auth-1"></a> <code>auth</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remoteauthadmin"><code>RemoteAuthAdmin</code></a></td><td align="left">Admin auth user CRUD.</td></tr><tr><td align="left"><a id="channel-1"></a> <code>channel</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td><td align="left">The raw worker op/sub relay channel (narrowed to the wire payload types).</td></tr><tr><td align="left"><a id="rtdb-1"></a> <code>rtdb</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotertdb"><code>RemoteRtdb</code></a></td><td align="left">RTDB conveniences (admin lens pinned).</td></tr><tr><td align="left"><a id="storage-1"></a> <code>storage</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotestorage"><code>RemoteStorage</code></a></td><td align="left">Storage conveniences (admin lens pinned; 8 MiB per-op byte cap).</td></tr></tbody></table></div>
+<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th><th align="left">Description</th><th align="left">Overrides</th></tr></thead><tbody><tr><td align="left"><a id="remote_sandbox-1"></a> <code>[REMOTE_SANDBOX]</code></td><td align="left"><code>readonly</code></td><td align="left"><code>true</code></td><td align="left">-</td><td align="left">-</td></tr><tr><td align="left"><a id="admin-1"></a> <code>admin</code></td><td align="left"><code>readonly</code></td><td align="left"><code>SandboxAdmin</code></td><td align="left">Admin-plane access (rule-bypass reads). Identity-agnostic by design — admin reads aren’t gated on auth, so they live on the sandbox, not on a context. See SandboxAdmin.</td><td align="left">-</td></tr><tr><td align="left"><a id="auth-1"></a> <code>auth</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remoteauthadmin"><code>RemoteAuthAdmin</code></a></td><td align="left">Admin auth user CRUD.</td><td align="left">-</td></tr><tr><td align="left"><a id="channel-1"></a> <code>channel</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td><td align="left">The raw worker op/sub relay channel (narrowed to the wire payload types).</td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#channel"><code>channel</code></a></td></tr><tr><td align="left"><a id="currentuser-1"></a> <code>currentUser</code></td><td align="left"><code>public</code></td><td align="left">{ <code>token?</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>; <code>uid</code>: <code>string</code>; }</td><td align="left">Current authenticated user across the sandbox. Mutated by <code>pyric/auth</code>’s <code>signInAnonymously</code> / <code>signInWithEmailAndPassword</code> / <code>signOut</code> / <code>sandbox.setUser</code>. Read per-call by service factories (e.g. a future <code>getFirestore(sandbox)</code> overload) so they see auth state changes without re-binding handles. Defaults to <code>null</code> (anonymous / signed out). <strong>Independent of <code>withAuth({uid})</code></strong> — <code>withAuth</code> still produces a frozen <a href="/docs/pyric-firestore-reference-api/#sandboxcontext">SandboxContext</a> that carries its own identity for the runner’s test code (the existing pattern: explicit identity per service call). <code>currentUser</code> exists for the <code>pyric/auth</code> mirror, where consumer app code drives identity through a stateful <code>Auth</code> handle rather than naming it per call.</td><td align="left">-</td></tr><tr><td align="left"><code>currentUser.token?</code></td><td align="left"><code>public</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td><td align="left">-</td><td align="left">-</td></tr><tr><td align="left"><code>currentUser.uid</code></td><td align="left"><code>public</code></td><td align="left"><code>string</code></td><td align="left">-</td><td align="left">-</td></tr><tr><td align="left"><a id="rtdb-1"></a> <code>rtdb</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotertdb"><code>RemoteRtdb</code></a></td><td align="left">RTDB conveniences (admin lens pinned).</td><td align="left">-</td></tr><tr><td align="left"><a id="serveurl-1"></a> <code>serveUrl</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td><td align="left">Base URL of the <code>pyric dev</code> this handle is attached to (used in error guidance: “open <serveurl> in a browser and retry”).</serveurl></td><td align="left">-</td></tr><tr><td align="left"><a id="storage-1"></a> <code>storage</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#remotestorage"><code>RemoteStorage</code></a></td><td align="left">Storage conveniences (admin lens pinned; 8 MiB per-op byte cap).</td><td align="left">-</td></tr></tbody></table></div>
 <h4 id="methods-3">Methods</h4>
+<p><a id="clearpersistence-2"></a></p>
+<h5 id="clearpersistence-1">clearPersistence()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">clearPersistence</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Wipe the persisted blob for this sandbox’s <code>key</code>. In-memory state
+is left intact — call <code>reset()</code> if you want both. Useful for
+“sign out and forget” flows.</p>
+<p>No-op when persistence is not enabled.</p>
+<h6 id="returns-32">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<h6 id="inherited-from-16">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#clearpersistence-2"><code>clearPersistence</code></a></p>
 <p><a id="close-2"></a></p>
 <h5 id="close-1">close()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">close</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Close the connection. In-flight ops reject; subscriptions stop.</p>
-<h6 id="returns-13">Returns</h6>
+<h6 id="returns-33">Returns</h6>
+<p><code>void</code></p>
+<p><a id="dispose-2"></a></p>
+<h5 id="dispose-1">dispose()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">dispose</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Tear down listener registries on this sandbox’s environment without
+replacing it. Use this when you’re about to discard the sandbox
+itself (e.g. <code>runner.reseed()</code> builds a fresh sandbox rather than
+calling <code>reset()</code>) and want to drop callback references on the
+outgoing instance defensively. Idempotent. Does not touch data.</p>
+<h6 id="returns-34">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-17">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#dispose-4"><code>dispose</code></a></p>
+<p><a id="enablepersistence-2"></a></p>
+<h5 id="enablepersistence-1">enablePersistence()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">enablePersistence</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">options</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">SandboxPersistenceOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Persist the sandbox’s data to a backend and restore it on next
+<code>enablePersistence</code> call. The default <code>'indexedDB'</code> backend turns
+the sandbox into the host page’s local Firestore — writes flush
+automatically and a fresh <code>initializeSandbox()</code> rehydrates from
+the prior session.</p>
+<p>Restoration happens before the promise resolves; awaiting this
+call is sufficient to guarantee in-memory state matches the
+persisted blob.</p>
+<p>Idempotent across the same <code>key</code> — calling twice in one process
+is a no-op on the second call. Different keys are rejected as an
+error (a sandbox can persist to at most one backend at a time).</p>
+<p>Listener semantics: every write event the sandbox emits triggers
+a debounced flush (default 250ms). Browser hosts additionally
+flush on <code>beforeunload</code> so a page navigation doesn’t lose the
+tail of the debounce window.</p>
+<p>See <a href="/docs/pyric-sandbox-reference-api/#sandboxpersistenceoptions">SandboxPersistenceOptions</a> for backend selection and
+tuning.</p>
+<h6 id="parameters-17">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#sandboxpersistenceoptions"><code>SandboxPersistenceOptions</code></a></td></tr></tbody></table></div>
+<h6 id="returns-35">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<h6 id="inherited-from-18">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#enablepersistence-2"><code>enablePersistence</code></a></p>
+<p><a id="enabletabsync-2"></a></p>
+<h5 id="enabletabsync-1">enableTabSync()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">enableTabSync</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">options</span><span style="color:#C678DD">?:</span><span style="color:#E06C75"> TabSyncOptions</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Enable cross-tab realtime sync via <code>BroadcastChannel</code>. A write in
+this tab will propagate to every OTHER tab of the same origin that
+also called <code>enableTabSync</code>, causing their <code>onSnapshot</code> listeners to
+re-evaluate — restoring production’s cross-client realtime behavior.</p>
+<p><strong>Opt-in, OFF by default.</strong> Firestore only (RTDB is a follow-on).</p>
+<p>Returns a disable function. Calling it removes the <code>onEvent</code>
+subscription, the channel message listener, and closes the channel
+(when it was created internally). After disable, no further propagation
+occurs in either direction.</p>
+<p><strong>Multi-writer note:</strong> concurrent writes from two tabs to the same doc
+produce last-write-wins divergence — there is no conflict resolution.
+The intended model is one active writer (one user, one tab) with
+observers in other tabs; this covers the overwhelming majority of
+local development scenarios.</p>
+<h6 id="parameters-18">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options?</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#tabsyncoptions"><code>TabSyncOptions</code></a></td></tr></tbody></table></div>
+<h6 id="returns-36">Returns</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-37">Returns</h6>
+<p><code>void</code></p>
+<h6 id="see-1">See</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#tabsyncoptions">TabSyncOptions</a> for channel injection (tests) and originId.</p>
+<h6 id="example-2">Example</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#7F848E;font-style:italic">// In every tab that should participate in realtime:</span></span>
+<span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> sandbox</span><span style="color:#56B6C2"> =</span><span style="color:#61AFEF"> initializeSandbox</span><span style="color:#ABB2BF">();</span></span>
+<span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> disableSync</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> sandbox</span><span style="color:#ABB2BF">.</span><span style="color:#61AFEF">enableTabSync</span><span style="color:#ABB2BF">();</span></span>
+<span class="line"><span style="color:#7F848E;font-style:italic">// Later, to stop syncing:</span></span>
+<span class="line"><span style="color:#61AFEF">disableSync</span><span style="color:#ABB2BF">();</span></span></code></pre>
+<h6 id="inherited-from-19">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#enabletabsync-2"><code>enableTabSync</code></a></p>
+<p><a id="flush-2"></a></p>
+<h5 id="flush-1">flush()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">flush</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Force a snapshot to the configured persistence backend right now.
+Useful before a manual navigation, or in tests that need
+deterministic ordering against the debounce window. Resolves once
+the write hits the backend.</p>
+<p>Throws if persistence is not enabled.</p>
+<h6 id="returns-38">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<h6 id="inherited-from-20">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#flush-4"><code>flush</code></a></p>
+<p><a id="history-2"></a></p>
+<h5 id="history-1">history()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">history</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">SandboxEvent</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<p>Every <a href="/docs/pyric-sandbox-reference-api/#sandboxevent">SandboxEvent</a> this sandbox has emitted since init or
+the last <code>reset()</code>. Returns a defensive copy.</p>
+<p>Use this for replay: hand the array to <code>replay(events, rules)</code>
+from <code>pyric/sandbox</code> and the engine re-issues every
+captured write against a fresh sandbox.</p>
+<p>Unlike <a href="/docs/pyric-firestore-reference-api/#onevent">onEvent</a> (live stream from the moment of subscribe),
+<code>history()</code> returns <em>every</em> event the sandbox has seen — useful
+for consumers that attach late (e.g., loading a saved session
+before subscribing) or that need a snapshot at a particular moment.</p>
+<p><code>reset()</code> and <code>dispose()</code> each append a closing <code>session_boundary</code>
+event; <code>reset()</code> then clears the history. Consumers that took a
+snapshot <em>before</em> reset retain the boundary in their copy.</p>
+<h6 id="returns-39">Returns</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#sandboxevent"><code>SandboxEvent</code></a>[]</p>
+<h6 id="inherited-from-21">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#history-2"><code>history</code></a></p>
+<p><a id="loadsnapshot-2"></a></p>
+<h5 id="loadsnapshot-1">loadSnapshot()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">loadSnapshot</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">data</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">SandboxSnapshot</span><span style="color:#ABB2BF">): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>CLOBBER-restore the sandbox’s entire state from a prior <a href="/docs/pyric-firestore-reference-api/#snapshot">snapshot</a>:
+<code>reset()</code> (clears firestore + the signed-in session), then rebuild firestore
+from <code>data</code> and restore each registered service. This is a TOTAL replace —
+documents absent from <code>data</code> do NOT survive — and is the counterpart to
+<a href="/docs/pyric-firestore-reference-api/#snapshot">snapshot</a>. It is what makes “transfer (clobber) one instance’s data
+into another” and named-branch switching possible.</p>
+<p>Fires a <code>session_boundary</code> (reset phase), re-evaluates live listeners against
+the loaded state, and the next persistence flush writes the loaded state.
+Services present in <code>data</code> but not currently registered are skipped (a
+snapshot taken via <a href="/docs/pyric-firestore-reference-api/#snapshot">snapshot</a> always includes every registered
+service, so this only affects cross-instance imports from a sandbox that had
+a service this one lacks).</p>
+<h6 id="parameters-19">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>data</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#sandboxsnapshot"><code>SandboxSnapshot</code></a></td></tr></tbody></table></div>
+<h6 id="returns-40">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-22">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#loadsnapshot-2"><code>loadSnapshot</code></a></p>
+<p><a id="oncurrentuserchanged-2"></a></p>
+<h5 id="oncurrentuserchanged-1">onCurrentUserChanged()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">onCurrentUserChanged</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">cb</span><span style="color:#ABB2BF">: (</span><span style="color:#E06C75;font-style:italic">user</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  token</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">>;</span></span>
+<span class="line"><span style="color:#E06C75">  uid</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}) </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Subscribe to <code>currentUser</code> changes. Fires on every mutation —
+sign-in, sign-out, user swap. Does NOT fire on subscribe.</p>
+<p>Survives <code>reset()</code> and <code>dispose()</code> only as a no-op: a disposed
+sandbox emits nothing further; a reset sandbox clears
+<code>currentUser</code> to <code>null</code> (and fires the change) before swapping
+the env.</p>
+<p>Returns an unsubscribe function. Listener errors are swallowed —
+subscribers are observational, the sandbox does not propagate
+their errors.</p>
+<h6 id="parameters-20">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>cb</code></td><td align="left">(<code>user</code>: { <code>token?</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>; <code>uid</code>: <code>string</code>; }) => <code>void</code></td></tr></tbody></table></div>
+<h6 id="returns-41">Returns</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-42">Returns</h6>
 <p><code>void</code></p>
+<h6 id="inherited-from-23">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#oncurrentuserchanged-2"><code>onCurrentUserChanged</code></a></p>
+<p><a id="onevent-2"></a></p>
+<h5 id="onevent-1">onEvent()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">onEvent</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">cb</span><span style="color:#ABB2BF">: (</span><span style="color:#E06C75;font-style:italic">event</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">SandboxEvent</span><span style="color:#ABB2BF">) </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Subscribe to every event the sandbox emits — see <a href="/docs/pyric-sandbox-reference-api/#sandboxevent">SandboxEvent</a>
+for the discriminated-union shape. One subscription covers
+request/denial/snapshot-error/listener-lifecycle/session-boundary;
+filter on <code>event.kind</code> to recover individual streams.</p>
+<p>Replaces the prior three-channel surface (<code>onRequest</code> / <code>onDenial</code>
+/ <code>onSnapshotError</code>) — see issue #307. Filter cookbook:</p>
+<ul>
+<li>All denials:    <code>event.kind === 'request' &#x26;&#x26; event.result === 'deny'</code></li>
+<li>Stream errors:  <code>event.kind === 'listener_errored'</code></li>
+<li>Per-op traffic: <code>event.kind === 'request'</code></li>
+</ul>
+<p>Survives <code>sandbox.reset()</code> — the subscription is held on the
+sandbox, not on the underlying environment. A <code>session_boundary</code>
+event with <code>phase: 'reset'</code> fires before the env swap so consumers
+can segment their stream.</p>
+<p>Returns an unsubscribe function. Listener errors are swallowed so a
+faulty subscriber can’t change rule semantics or hide other events.
+Both synchronous throws and rejected Promises from async callbacks
+are silently discarded — subscribers are <strong>observational</strong>, the
+sandbox doesn’t await them and doesn’t propagate their errors.</p>
+<h6 id="parameters-21">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>cb</code></td><td align="left">(<code>event</code>: <a href="/docs/pyric-sandbox-reference-api/#sandboxevent"><code>SandboxEvent</code></a>) => <code>void</code></td></tr></tbody></table></div>
+<h6 id="returns-43">Returns</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-44">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-24">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#onevent-2"><code>onEvent</code></a></p>
+<p><a id="registerpersistableservice-2"></a></p>
+<h5 id="registerpersistableservice-1">registerPersistableService()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">registerPersistableService</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">name</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">hooks</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">PersistableService</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Register a service (auth, storage, …) as a persistence participant.
+The sandbox calls <code>hooks.snapshot()</code> on every flush and
+<code>hooks.restore(data)</code> on restore. If <code>hooks.subscribe</code> is provided,
+the persistence controller subscribes and schedules a debounced
+flush on each change — so auth-user edits flush promptly, not only
+on the next Firestore write.</p>
+<p>Returns an unregister function — call it if the service is torn
+down before the sandbox is disposed (uncommon in practice; the
+sandbox’s <code>dispose()</code> clears the registry anyway).</p>
+<p>Throws <code>failed-precondition</code> when a service with the same <code>name</code> is
+already registered — the auth package registers <code>'auth'</code> once when
+<code>getAuth(sandbox)</code> first creates a backend, so accidental double-
+registration is a caller bug, not a no-op.</p>
+<p><strong>Advanced / internal API.</strong> Service packages (auth, storage) call
+this when they first attach to a sandbox. Consumer app code should
+not need to call this directly.</p>
+<h6 id="parameters-22">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>name</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>hooks</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#persistableservice"><code>PersistableService</code></a></td></tr></tbody></table></div>
+<h6 id="returns-45">Returns</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-46">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-25">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#registerpersistableservice-2"><code>registerPersistableService</code></a></p>
+<p><a id="reset-2"></a></p>
+<h5 id="reset-1">reset()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">reset</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Reset the underlying environment to a fresh state — wipes data,
+rules, and any service-specific configuration.</p>
+<p>Snapshot listeners attached to the OLD environment are dropped at
+the swap — they can’t survive because their target docs have been
+wiped. <code>onEvent</code> subscribers DO survive — the registry lives on
+the sandbox, and a <code>session_boundary</code> event with <code>phase: 'reset'</code>
+fires before the swap so subscribers know the rollover happened.
+Existing <a href="/docs/pyric-firestore-reference-api/#sandboxcontext">SandboxContext</a>s continue to work — their sandbox
+reference is stable; subsequent operations resolve to the new env.</p>
+<h6 id="returns-47">Returns</h6>
+<p><code>void</code></p>
+<h6 id="inherited-from-26">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#reset-4"><code>reset</code></a></p>
+<p><a id="resetall-2"></a></p>
+<h5 id="resetall-1">resetAll()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">resetAll</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;{</span></span>
+<span class="line"><span style="color:#E06C75">  errors</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">[];</span></span>
+<span class="line"><span style="color:#ABB2BF">}>;</span></span></code></pre>
+<p>Reset the WHOLE sandbox: <a href="/docs/pyric-firestore-reference-api/#reset">reset</a> (Firestore env + signed-in
+session), then clear every registered persistable service that
+provides a <a href="/docs/pyric-sandbox-reference-api/#reset-2">PersistableService.reset</a> hook — auth users, the
+RTDB tree, storage objects. This is the one sandbox-owned “wipe
+everything” path: because it iterates the service registry, a new
+service that registers with a <code>reset</code> hook is cleared automatically,
+and a consumer (Pyric Studio’s reset) cannot forget one.</p>
+<p>Service resets may be async (storage clears IndexedDB stores); the
+returned promise resolves when every service has finished clearing.
+A service whose <code>reset</code> throws is isolated (others still clear) and
+REPORTED in the returned <code>errors</code> (as <code>name: message</code>) — a reset that
+leaves data behind must never look successful to the caller.</p>
+<h6 id="returns-48">Returns</h6>
+<p><code>Promise</code>&#x3C;{
+<code>errors</code>: <code>string</code>[];
+}></p>
+<h6 id="inherited-from-27">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#resetall-2"><code>resetAll</code></a></p>
+<p><a id="runwithprovenance-2"></a></p>
+<h5 id="runwithprovenance-1">runWithProvenance()?</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">optional</span><span style="color:#61AFEF"> runWithProvenance</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">T</span><span style="color:#ABB2BF">>(</span><span style="color:#E06C75">provenance</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">EventProvenance</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">fn</span><span style="color:#ABB2BF">: () </span><span style="color:#C678DD">=></span><span style="color:#E5C07B"> T</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">T</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Run <code>fn</code> with ambient <a href="/docs/pyric-sandbox-reference-api/#eventprovenance">EventProvenance</a> defaults: every event
+emitted SYNCHRONOUSLY during <code>fn</code> that doesn’t already carry a
+provenance field (on the event itself or via an explicit per-emit
+override) is stamped with these values instead of the global
+defaults. This is the mechanical “who issued this op” seam the
+serve worker uses to tag Studio-issued ops (<code>actor: { kind: 'studio' }</code>) and to stamp the auth lens an op ran under
+(<code>authLens</code>) — declared by the caller that issues the op, never
+inferred from the op’s shape.</p>
+<p>SYNCHRONOUS WINDOW: the ambient values apply only until <code>fn</code>
+returns (for an async <code>fn</code>, its synchronous prefix — which covers
+the local environment’s rules eval + event emission, since those
+run before the op’s promise is handed back). Work an op DEFERS
+(snapshot-listener deliveries and re-evals drain on a microtask,
+off-stack) is intentionally OUTSIDE the window: a listener re-eval
+belongs to the listener’s owner, not to whoever’s write triggered
+it. Nested calls stack — the innermost window wins per field, and
+each window restores the previous one on exit (including on throw).</p>
+<p>OPTIONAL because remote sandbox proxies can’t provide an ambient
+emit window (events are emitted in the worker they front). Callers
+spell <code>sandbox.runWithProvenance?.(prov, fn) ?? fn()</code>.</p>
+<h6 id="type-parameters-1">Type Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Type Parameter</th></tr></thead><tbody><tr><td align="left"><code>T</code></td></tr></tbody></table></div>
+<h6 id="parameters-23">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>provenance</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#eventprovenance"><code>EventProvenance</code></a></td></tr><tr><td align="left"><code>fn</code></td><td align="left">() => <code>T</code></td></tr></tbody></table></div>
+<h6 id="returns-49">Returns</h6>
+<p><code>T</code></p>
+<h6 id="inherited-from-28">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#runwithprovenance-2"><code>runWithProvenance</code></a></p>
+<p><a id="snapshot-2"></a></p>
+<h5 id="snapshot-1">snapshot()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">snapshot</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">SandboxSnapshot</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Capture a snapshot of every service’s state. For v1 with only
+Firestore, the return value carries a <code>firestore</code> key mapping doc
+paths to data. Future services will add their own keys.</p>
+<h6 id="returns-50">Returns</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#sandboxsnapshot"><code>SandboxSnapshot</code></a></p>
+<h6 id="inherited-from-29">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#snapshot-4"><code>snapshot</code></a></p>
+<p><a id="withauth-2"></a></p>
+<h5 id="withauth-1">withAuth()</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">withAuth</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">auth</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#ABB2BF">  token?: </span><span style="color:#E06C75">Record</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, unknown>;</span></span>
+<span class="line"><span style="color:#E06C75">  uid</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}): </span><span style="color:#E06C75">SandboxContext</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Derive a context bound to this sandbox under the given auth
+identity. Operations through services attached to the returned
+context evaluate rules under that identity. Many contexts can
+coexist for one sandbox; data is shared.</p>
+<p><code>null</code> is anonymous; an <code>AuthState</code> object names the user (and
+optional custom claims). Passing <code>undefined</code> is a deliberate
+error — say <code>withAuth(null)</code> for anonymous so the call site is
+unambiguous.</p>
+<h6 id="parameters-24">Parameters</h6>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left">{ <code>token?</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>; <code>uid</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>auth.token?</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr><tr><td align="left"><code>auth.uid</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-51">Returns</h6>
+<p><a href="/docs/pyric-firestore-reference-api/#sandboxcontext"><code>SandboxContext</code></a></p>
+<h6 id="example-3">Example</h6>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> sandbox</span><span style="color:#56B6C2"> =</span><span style="color:#61AFEF"> initializeSandbox</span><span style="color:#ABB2BF">();</span></span>
+<span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> dbAlice</span><span style="color:#56B6C2"> =</span><span style="color:#61AFEF"> getFirestore</span><span style="color:#ABB2BF">(</span><span style="color:#E5C07B">sandbox</span><span style="color:#ABB2BF">.</span><span style="color:#61AFEF">withAuth</span><span style="color:#ABB2BF">({ </span><span style="color:#E06C75">uid</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">'alice'</span><span style="color:#ABB2BF"> }));</span></span>
+<span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> dbAnon</span><span style="color:#56B6C2">  =</span><span style="color:#61AFEF"> getFirestore</span><span style="color:#ABB2BF">(</span><span style="color:#E5C07B">sandbox</span><span style="color:#ABB2BF">.</span><span style="color:#61AFEF">withAuth</span><span style="color:#ABB2BF">(</span><span style="color:#D19A66">null</span><span style="color:#ABB2BF">));</span></span></code></pre>
+<h6 id="inherited-from-30">Inherited from</h6>
+<p><a href="/docs/pyric-sandbox-reference-api/#remotesandbox"><code>RemoteSandbox</code></a>.<a href="/docs/pyric-sandbox-reference-api/#withauth-4"><code>withAuth</code></a></p>
 <hr>
 <p><a id="remotesandboxchannel-1"></a></p>
 <h3 id="remotesandboxchannel">RemoteSandboxChannel</h3>
@@ -448,7 +1432,7 @@ checkpoint 2’s <code>pyric-admin</code> remote-dispatch arm consumes it direct
 <p>Dispatch one worker op. Resolves with the worker’s <code>res.value</code>;
 rejects with an Error carrying <code>.code</code>. NOTE: callers choose their own
 <code>actAs</code> lens — nothing is pinned here.</p>
-<h6 id="parameters-9">Parameters</h6>
+<h6 id="parameters-25">Parameters</h6>
 <div class="table-scroll">
@@ -463,7 +1447,7 @@ rejects with an Error carrying <code>.code</code>. NOTE: callers choose their ow
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>op</code></td><td align="left"><code>WorkerOpPayload</code></td></tr></tbody></table></div>
-<h6 id="returns-14">Returns</h6>
+<h6 id="returns-52">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>unknown</code>></p>
 <p><a id="subscribe"></a></p>
 <h5 id="subscribe">subscribe()</h5>
@@ -476,7 +1460,7 @@ rejects with an Error carrying <code>.code</code>. NOTE: callers choose their ow
 <p>Register a worker subscription. <code>onSnap</code> receives each snap value;
 an establishment failure (the worker host’s <code>{ __error }</code> snap) routes
 to <code>onError</code> instead. Returns the unsubscribe function.</p>
-<h6 id="parameters-10">Parameters</h6>
+<h6 id="parameters-26">Parameters</h6>
 <div class="table-scroll">
@@ -499,9 +1483,9 @@ to <code>onError</code> instead. Returns the unsubscribe function.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>sub</code></td><td align="left"><code>WorkerSubPayload</code></td></tr><tr><td align="left"><code>onSnap</code></td><td align="left">(<code>value</code>: <code>unknown</code>) => <code>void</code></td></tr><tr><td align="left"><code>onError?</code></td><td align="left">(<code>err</code>: <code>Error</code> &#x26; { <code>code</code>: <code>string</code>; }) => <code>void</code></td></tr></tbody></table></div>
-<h6 id="returns-15">Returns</h6>
+<h6 id="returns-53">Returns</h6>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="returns-16">Returns</h6>
+<h6 id="returns-54">Returns</h6>
 <p><code>void</code></p>
 <hr>
 <p><a id="remotesandboxcore"></a></p>
@@ -529,11 +1513,11 @@ to <code>onError</code> instead. Returns the unsubscribe function.</p>
 <table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="channel-2"></a> <code>channel</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td><td align="left">-</td></tr><tr><td align="left"><a id="ready-1"></a> <code>ready</code></td><td align="left"><code>Promise</code>&#x3C;<code>void</code>></td><td align="left">Resolves on <code>attach-ack</code>; rejects when no browser tab is connected.</td></tr></tbody></table></div>
 <h4 id="methods-5">Methods</h4>
-<p><a id="dispose"></a></p>
-<h5 id="dispose">dispose()</h5>
+<p><a id="dispose-4"></a></p>
+<h5 id="dispose-2">dispose()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">dispose</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">reason</span><span style="color:#C678DD">?:</span><span style="color:#E06C75"> string</span><span style="color:#ABB2BF">): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Fail everything in flight (transport closed). Idempotent.</p>
-<h6 id="parameters-11">Parameters</h6>
+<h6 id="parameters-27">Parameters</h6>
 <div class="table-scroll">
@@ -548,13 +1532,13 @@ to <code>onError</code> instead. Returns the unsubscribe function.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>reason?</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-17">Returns</h6>
+<h6 id="returns-55">Returns</h6>
 <p><code>void</code></p>
 <p><a id="handlemessage"></a></p>
 <h5 id="handlemessage">handleMessage()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">handleMessage</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">msg</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">BridgeMessage</span><span style="color:#ABB2BF">): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Feed one parsed message from the transport into the core.</p>
-<h6 id="parameters-12">Parameters</h6>
+<h6 id="parameters-28">Parameters</h6>
 <div class="table-scroll">
@@ -568,14 +1552,14 @@ to <code>onError</code> instead. Returns the unsubscribe function.</p>
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>msg</code></td><td align="left"><code>BridgeMessage</code></td></tr></tbody></table></div>
-<h6 id="returns-18">Returns</h6>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>msg</code></td><td align="left"><a href="/docs/pyric-cli-bridge-client-reference-api/#bridgemessage"><code>BridgeMessage</code></a></td></tr></tbody></table></div>
+<h6 id="returns-56">Returns</h6>
 <p><code>void</code></p>
 <p><a id="start"></a></p>
 <h5 id="start">start()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">start</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Send the attach handshake. <code>ready</code> settles on the ack.</p>
-<h6 id="returns-19">Returns</h6>
+<h6 id="returns-57">Returns</h6>
 <p><code>void</code></p>
 <hr>
 <p><a id="remotestorage"></a></p>
@@ -591,7 +1575,7 @@ streaming transfers are not supported on the sandbox backend.</p>
 <h5 id="deleteobject">deleteObject()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">deleteObject</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Delete the object at <code>path</code>. Idempotent (missing = no-op).</p>
-<h6 id="parameters-13">Parameters</h6>
+<h6 id="parameters-29">Parameters</h6>
 <div class="table-scroll">
@@ -606,13 +1590,13 @@ streaming transfers are not supported on the sandbox backend.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-20">Returns</h6>
+<h6 id="returns-58">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <p><a id="exists-1"></a></p>
 <h5 id="exists">exists()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">exists</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">boolean</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Does an object exist at <code>path</code>? (<code>getMetadata</code> with not-found → false.)</p>
-<h6 id="parameters-14">Parameters</h6>
+<h6 id="parameters-30">Parameters</h6>
 <div class="table-scroll">
@@ -627,14 +1611,14 @@ streaming transfers are not supported on the sandbox backend.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-21">Returns</h6>
+<h6 id="returns-59">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>boolean</code>></p>
 <p><a id="getbytes"></a></p>
 <h5 id="getbytes">getBytes()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">getBytes</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">Buffer</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">ArrayBufferLike</span><span style="color:#56B6C2">>></span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Download the object’s bytes. Rejects <code>storage/object-not-found</code> when
 absent, <code>payload-too-large</code> when over the op cap.</p>
-<h6 id="parameters-15">Parameters</h6>
+<h6 id="parameters-31">Parameters</h6>
 <div class="table-scroll">
@@ -649,13 +1633,13 @@ absent, <code>payload-too-large</code> when over the op cap.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-22">Returns</h6>
+<h6 id="returns-60">Returns</h6>
 <p><code>Promise</code>&#x3C;<code>Buffer</code>&#x3C;<code>ArrayBufferLike</code>>></p>
 <p><a id="getmetadata"></a></p>
 <h5 id="getmetadata">getMetadata()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">getMetadata</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">FullMetadata</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Read the object’s <code>FullMetadata</code>.</p>
-<h6 id="parameters-16">Parameters</h6>
+<h6 id="parameters-32">Parameters</h6>
 <div class="table-scroll">
@@ -670,8 +1654,8 @@ absent, <code>payload-too-large</code> when over the op cap.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-23">Returns</h6>
-<p><code>Promise</code>&#x3C;<code>FullMetadata</code>></p>
+<h6 id="returns-61">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-storage-reference-api/#fullmetadata"><code>FullMetadata</code></a>></p>
 <p><a id="listall"></a></p>
 <h5 id="listall">listAll()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">listAll</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;{</span></span>
@@ -685,7 +1669,7 @@ absent, <code>payload-too-large</code> when over the op cap.</p>
 <span class="line"><span style="color:#ABB2BF">  }[];</span></span>
 <span class="line"><span style="color:#ABB2BF">}>;</span></span></code></pre>
 <p>Enumerate immediate child items + prefixes under <code>path</code>.</p>
-<h6 id="parameters-17">Parameters</h6>
+<h6 id="parameters-33">Parameters</h6>
 <div class="table-scroll">
@@ -700,7 +1684,7 @@ absent, <code>payload-too-large</code> when over the op cap.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h6 id="returns-24">Returns</h6>
+<h6 id="returns-62">Returns</h6>
 <p><code>Promise</code>&#x3C;{
 <code>items</code>: {
 <code>fullPath</code>: <code>string</code>;
@@ -722,7 +1706,7 @@ absent, <code>payload-too-large</code> when over the op cap.</p>
 <span class="line"><span style="color:#ABB2BF">}): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">FullMetadata</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Upload <code>data</code> at <code>path</code> (replaces any existing object). Resolves with
 the stored object’s <code>FullMetadata</code>.</p>
-<h6 id="parameters-18">Parameters</h6>
+<h6 id="parameters-34">Parameters</h6>
 <div class="table-scroll">
@@ -753,8 +1737,8 @@ the stored object’s <code>FullMetadata</code>.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>data</code></td><td align="left"><code>Uint8Array</code></td></tr><tr><td align="left"><code>options?</code></td><td align="left">{ <code>contentType?</code>: <code>string</code>; <code>metadata?</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>; }</td></tr><tr><td align="left"><code>options.contentType?</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>options.metadata?</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr></tbody></table></div>
-<h6 id="returns-25">Returns</h6>
-<p><code>Promise</code>&#x3C;<code>FullMetadata</code>></p>
+<h6 id="returns-63">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-storage-reference-api/#fullmetadata"><code>FullMetadata</code></a>></p>
 <hr>
 <p><a id="remotetransport"></a></p>
 <h3 id="remotetransport">RemoteTransport</h3>
@@ -770,12 +1754,12 @@ event loop (a finished script exits); the core calls <code>ref()</code> when wor
 becomes outstanding (first pending op / live subscription) and
 <code>unref()</code> when the last one settles, so in-flight delivery keeps the
 process alive. Pure in-process transports (tests) may omit both.</p>
-<h6 id="returns-26">Returns</h6>
+<h6 id="returns-64">Returns</h6>
 <p><code>void</code></p>
 <p><a id="send"></a></p>
 <h5 id="send">send()</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#61AFEF">send</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">msg</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">BridgeMessage</span><span style="color:#ABB2BF">): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="parameters-19">Parameters</h6>
+<h6 id="parameters-35">Parameters</h6>
 <div class="table-scroll">
@@ -789,19 +1773,19 @@ process alive. Pure in-process transports (tests) may omit both.</p>
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>msg</code></td><td align="left"><code>BridgeMessage</code></td></tr></tbody></table></div>
-<h6 id="returns-27">Returns</h6>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>msg</code></td><td align="left"><a href="/docs/pyric-cli-bridge-client-reference-api/#bridgemessage"><code>BridgeMessage</code></a></td></tr></tbody></table></div>
+<h6 id="returns-65">Returns</h6>
 <p><code>void</code></p>
 <p><a id="unref"></a></p>
 <h5 id="unref">unref()?</h5>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">optional</span><span style="color:#61AFEF"> unref</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h6 id="returns-28">Returns</h6>
+<h6 id="returns-66">Returns</h6>
 <p><code>void</code></p>
 <h2 id="functions">Functions</h2>
 <p><a id="buildremoteauthadmin"></a></p>
 <h3 id="buildremoteauthadmin">buildRemoteAuthAdmin()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> buildRemoteAuthAdmin</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">channel</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RemoteSandboxChannel</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RemoteAuthAdmin</span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h4 id="parameters-20">Parameters</h4>
+<h4 id="parameters-36">Parameters</h4>
 <div class="table-scroll">
@@ -816,13 +1800,13 @@ process alive. Pure in-process transports (tests) may omit both.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>channel</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td></tr></tbody></table></div>
-<h4 id="returns-29">Returns</h4>
+<h4 id="returns-67">Returns</h4>
 <p><a href="#remoteauthadmin"><code>RemoteAuthAdmin</code></a></p>
 <hr>
 <p><a id="buildremotertdb"></a></p>
 <h3 id="buildremotertdb">buildRemoteRtdb()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> buildRemoteRtdb</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">channel</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RemoteSandboxChannel</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RemoteRtdb</span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h4 id="parameters-21">Parameters</h4>
+<h4 id="parameters-37">Parameters</h4>
 <div class="table-scroll">
@@ -837,13 +1821,13 @@ process alive. Pure in-process transports (tests) may omit both.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>channel</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td></tr></tbody></table></div>
-<h4 id="returns-30">Returns</h4>
+<h4 id="returns-68">Returns</h4>
 <p><a href="#remotertdb"><code>RemoteRtdb</code></a></p>
 <hr>
 <p><a id="buildremotestorage"></a></p>
 <h3 id="buildremotestorage">buildRemoteStorage()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> buildRemoteStorage</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">channel</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RemoteSandboxChannel</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RemoteStorage</span><span style="color:#ABB2BF">;</span></span></code></pre>
-<h4 id="parameters-22">Parameters</h4>
+<h4 id="parameters-38">Parameters</h4>
 <div class="table-scroll">
@@ -858,7 +1842,7 @@ process alive. Pure in-process transports (tests) may omit both.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>channel</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td></tr></tbody></table></div>
-<h4 id="returns-31">Returns</h4>
+<h4 id="returns-69">Returns</h4>
 <p><a href="#remotestorage"><code>RemoteStorage</code></a></p>
 <hr>
 <p><a id="connectremotesandbox"></a></p>
@@ -869,7 +1853,7 @@ worker-relay CONSUMER (never a peer — attaching cannot kick the browser
 tab out of last-connection-wins), and return the typed remote handle.</p>
 <p>Fails fast when no serve is discoverable or no browser tab is connected —
 there is deliberately no headless fallback (see module doc).</p>
-<h4 id="parameters-23">Parameters</h4>
+<h4 id="parameters-39">Parameters</h4>
 <div class="table-scroll">
@@ -884,7 +1868,7 @@ there is deliberately no headless fallback (see module doc).</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options?</code></td><td align="left"><a href="#connectremotesandboxoptions"><code>ConnectRemoteSandboxOptions</code></a></td></tr></tbody></table></div>
-<h4 id="returns-32">Returns</h4>
+<h4 id="returns-70">Returns</h4>
 <p><code>Promise</code>&#x3C;<a href="#remotesandbox"><code>RemoteSandbox</code></a>></p>
 <hr>
 <p><a id="createlazyremotesandbox"></a></p>
@@ -894,7 +1878,7 @@ there is deliberately no headless fallback (see module doc).</p>
 <span class="line"><span style="color:#ABB2BF">}): </span><span style="color:#E5C07B">LazyRemoteSandbox</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>The lazy wrapper with the connect function injected — the test seam
 (tests inject a fake connect; production injects <code>connectRemoteSandbox</code>).</p>
-<h4 id="parameters-24">Parameters</h4>
+<h4 id="parameters-40">Parameters</h4>
 <div class="table-scroll">
@@ -917,7 +1901,7 @@ there is deliberately no headless fallback (see module doc).</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>connect</code></td><td align="left">() => <code>Promise</code>&#x3C;<a href="#remotesandbox"><code>RemoteSandbox</code></a>></td></tr><tr><td align="left"><code>options?</code></td><td align="left">{ <code>url?</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>options.url?</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-33">Returns</h4>
+<h4 id="returns-71">Returns</h4>
 <p><a href="#lazyremotesandbox"><code>LazyRemoteSandbox</code></a></p>
 <hr>
 <p><a id="createremotesandboxcore"></a></p>
@@ -930,7 +1914,7 @@ there is deliberately no headless fallback (see module doc).</p>
 (this leg’s id space; the bridge re-mints for the peer leg), pending ops
 carry a Node-side timeout above the bridge’s 30s, and <code>{ __error }</code> snap
 values are routed to the subscription’s error handler.</p>
-<h4 id="parameters-25">Parameters</h4>
+<h4 id="parameters-41">Parameters</h4>
 <div class="table-scroll">
@@ -957,7 +1941,7 @@ values are routed to the subscription’s error handler.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>transport</code></td><td align="left"><a href="#remotetransport"><code>RemoteTransport</code></a></td></tr><tr><td align="left"><code>opts</code></td><td align="left">{ <code>opTimeoutMs?</code>: <code>number</code>; <code>serveUrl</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>opts.opTimeoutMs?</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><code>opts.serveUrl</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-34">Returns</h4>
+<h4 id="returns-72">Returns</h4>
 <p><a href="#remotesandboxcore"><code>RemoteSandboxCore</code></a></p>
 <hr>
 <p><a id="createremotesandboxhandle"></a></p>
@@ -983,7 +1967,7 @@ bounded backpressure lands, and no remote dispatch arm may depend on
 it — a throw (not a silent no-op) keeps a subscriber from believing
 it is observing events that will never arrive.</li>
 </ul>
-<h4 id="parameters-26">Parameters</h4>
+<h4 id="parameters-42">Parameters</h4>
 <div class="table-scroll">
@@ -1010,7 +1994,7 @@ it is observing events that will never arrive.</li>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>opts</code></td><td align="left">{ <code>channel</code>: <a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a>; <code>close</code>: () => <code>void</code>; <code>serveUrl</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>opts.channel</code></td><td align="left"><a href="#remotesandboxchannel-1"><code>RemoteSandboxChannel</code></a></td></tr><tr><td align="left"><code>opts.close</code></td><td align="left">() => <code>void</code></td></tr><tr><td align="left"><code>opts.serveUrl</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-35">Returns</h4>
+<h4 id="returns-73">Returns</h4>
 <p><a href="#remotesandbox"><code>RemoteSandbox</code></a></p>
 <hr>
 <p><a id="remotesandbox-1"></a></p>
@@ -1025,7 +2009,7 @@ The wire connection (discovery → WS attach) happens on the FIRST op (or
 open <url>” — surfaces on first use instead of at construction. A failed
 connect is NOT latched: the next op retries, matching the error’s own
 “…and retry” guidance. <code>connectRemoteSandbox</code> (eager) is unchanged.</url></p>
-<h4 id="parameters-27">Parameters</h4>
+<h4 id="parameters-43">Parameters</h4>
 <div class="table-scroll">
@@ -1040,5 +2024,5 @@ connect is NOT latched: the next op retries, matching the error’s own
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options?</code></td><td align="left"><a href="#connectremotesandboxoptions"><code>ConnectRemoteSandboxOptions</code></a></td></tr></tbody></table></div>
-<h4 id="returns-36">Returns</h4>
+<h4 id="returns-74">Returns</h4>
 <p><a href="#lazyremotesandbox"><code>LazyRemoteSandbox</code></a></p>  </article> </main> <aside class="doc-toc api-symbols" aria-label="API symbols"> <h2 class="doc-toc-heading">Symbols</h2> <input class="api-symbol-filter" type="search" placeholder="Filter symbols" aria-label="Filter API symbols" data-api-symbol-filter> <div class="api-symbol-groups" data-api-symbol-groups> <section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#interfaces"> Interfaces </a> <ul> <li data-api-symbol="connectremotesandboxoptions"> <a href="#connectremotesandboxoptions">ConnectRemoteSandboxOptions</a> </li><li data-api-symbol="lazyremotesandbox"> <a href="#lazyremotesandbox">LazyRemoteSandbox</a> </li><li data-api-symbol="remoteauthadmin"> <a href="#remoteauthadmin">RemoteAuthAdmin</a> </li><li data-api-symbol="remotertdb"> <a href="#remotertdb">RemoteRtdb</a> </li><li data-api-symbol="remotertdbsnapshot"> <a href="#remotertdbsnapshot">RemoteRtdbSnapshot</a> </li><li data-api-symbol="remotesandbox"> <a href="#remotesandbox">RemoteSandbox</a> </li><li data-api-symbol="remotesandboxchannel"> <a href="#remotesandboxchannel">RemoteSandboxChannel</a> </li><li data-api-symbol="remotesandboxcore"> <a href="#remotesandboxcore">RemoteSandboxCore</a> </li><li data-api-symbol="remotestorage"> <a href="#remotestorage">RemoteStorage</a> </li><li data-api-symbol="remotetransport"> <a href="#remotetransport">RemoteTransport</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#functions"> Functions </a> <ul> <li data-api-symbol="buildremoteauthadmin()"> <a href="#buildremoteauthadmin">buildRemoteAuthAdmin()</a> </li><li data-api-symbol="buildremotertdb()"> <a href="#buildremotertdb">buildRemoteRtdb()</a> </li><li data-api-symbol="buildremotestorage()"> <a href="#buildremotestorage">buildRemoteStorage()</a> </li><li data-api-symbol="connectremotesandbox()"> <a href="#connectremotesandbox">connectRemoteSandbox()</a> </li><li data-api-symbol="createlazyremotesandbox()"> <a href="#createlazyremotesandbox">createLazyRemoteSandbox()</a> </li><li data-api-symbol="createremotesandboxcore()"> <a href="#createremotesandboxcore">createRemoteSandboxCore()</a> </li><li data-api-symbol="createremotesandboxhandle()"> <a href="#createremotesandboxhandle">createRemoteSandboxHandle()</a> </li><li data-api-symbol="remotesandbox()"> <a href="#remotesandbox-1">remoteSandbox()</a> </li> </ul> </section> <p class="api-symbol-empty" data-api-symbol-empty hidden>No matching symbols</p> </div> </aside> </div> <script type="module">const a=document.querySelector("[data-api-symbol-filter]"),d=[...document.querySelectorAll("[data-api-symbol-group]")],n=document.querySelector("[data-api-symbol-empty]");a?.addEventListener("input",()=>{const t=a.value.trim().toLowerCase();let o=0;for(const i of d){let e=0;i.querySelectorAll("[data-api-symbol]").forEach(l=>{const r=!t||(l.dataset.apiSymbol??"").includes(t);l.hidden=!r,r&&e++}),i.hidden=e===0,o+=e}n&&(n.hidden=o>0)});</script> <script type="module">const s=new Map;document.querySelectorAll('.doc-toc a[href^="#"]').forEach(t=>s.set(decodeURIComponent(t.hash.slice(1)),t));if(s.size>0){const t=new Set,n=()=>{let o=null;for(const e of s.keys())if(t.has(e)){o=e;break}s.forEach((e,c)=>e.classList.toggle("active",c===o))},r=new IntersectionObserver(o=>{for(const e of o)e.isIntersecting?t.add(e.target.id):t.delete(e.target.id);n()},{rootMargin:"-72px 0px -60% 0px"});s.forEach((o,e)=>{const c=document.getElementById(e);c&&r.observe(c)})}</script> <script type="module">document.querySelector('.studio__nav [aria-current="page"]')?.scrollIntoView({block:"nearest",inline:"center"});</script> </body> </html>