npm - @pyric/cli - Versions diffs - 0.1.0-alpha.9 - Mend

@pyric/cli 0.1.0-alpha.9

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 (1169) hide show

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

@@ -0,0 +1,1044 @@
+<!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_.CQYSemvw.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>Run locally</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/how-the-swap-works/"> How the swap works </a> </li><li> <a href="/__pyric/ui/docs/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Develop with Firebase APIs</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/sign-in-and-manage-users/"> Sign in and manage users </a> </li><li> <a href="/__pyric/ui/docs/store-and-query-data/"> Store and query data </a> </li><li> <a href="/__pyric/ui/docs/sync-realtime-data/"> Sync realtime data </a> </li><li> <a href="/__pyric/ui/docs/store-files/"> Store files </a> </li><li> <a href="/__pyric/ui/docs/receive-messages/"> Receive messages </a> </li><li> <a href="/__pyric/ui/docs/run-ai-logic-locally/"> Run AI Logic locally </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-how-to-run-rtdb-onvaluecreated/"> Run an RTDB function locally </a> </li><li> <a href="/__pyric/ui/docs/which-data-service/"> Which data service? </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Inspect and correct</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section"> <h2 class="docs-nav-heading"> Inspect the sandbox </h2> <ul> <li> <a href="/__pyric/ui/docs/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/shape-your-data/"> Seed, snapshot, replay </a> </li><li> <a href="/__pyric/ui/docs/watch-and-review/"> Review agent activity </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading"> Correct Security Rules </h2> <ul> <li> <a href="/__pyric/ui/docs/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/rules-patterns/"> Rules patterns </a> </li><li> <a href="/__pyric/ui/docs/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/whats-possible/"> Case studies </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading"> Work with an agent </h2> <ul> <li> <a href="/__pyric/ui/docs/what-your-agent-can-do/"> Work through an agent </a> </li><li> <a href="/__pyric/ui/docs/skills/"> Agent skills </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Verify the boundary</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-how-to-verify-against-a-captured-session/"> Verify a captured session </a> </li><li> <a href="/__pyric/ui/docs/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Ship unchanged</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/set-up-the-project/"> Set up the Firebase project </a> </li> </ul> </div> </div> </details><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/how-we-know-it-matches-firebase/"> Conformance </a> </li><li> <a href="/__pyric/ui/docs/whats-experimental/"> What&#39;s experimental </a> </li><li> <a href="/__pyric/ui/docs/pyric-conformance-scores/"> Conformance scores </a> </li><li> <a href="/__pyric/ui/docs/pyric-app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-compat/"> Rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-functions-rtdb-compat/"> Functions · RTDB </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" open> <summary>Reference</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section"> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli/"> @pyric/cli </a> </li><li> <a href="/__pyric/ui/docs/pyric-explanation-versioning-and-compatibility/"> pyric </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore/"> pyric / firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules/"> pyric / rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox/"> pyric / sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage/"> pyric / storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth/"> pyric / auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-database/"> pyric / database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-app/"> pyric-admin / app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore/"> pyric-admin / firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth/"> pyric-admin / auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database/"> pyric-admin / database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage/"> pyric-admin / storage </a> </li><li> <a href="/__pyric/ui/docs/ui/"> @pyric/ui </a> </li><li> <a href="/__pyric/ui/docs/api-reference/" aria-current="true"> API reference </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-run-locally"> <summary>Run locally</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/how-the-swap-works/"> How the swap works </a> </li><li> <a href="/__pyric/ui/docs/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-develop-with-firebase-apis"> <summary>Develop with Firebase APIs</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/sign-in-and-manage-users/"> Sign in and manage users </a> </li><li> <a href="/__pyric/ui/docs/store-and-query-data/"> Store and query data </a> </li><li> <a href="/__pyric/ui/docs/sync-realtime-data/"> Sync realtime data </a> </li><li> <a href="/__pyric/ui/docs/store-files/"> Store files </a> </li><li> <a href="/__pyric/ui/docs/receive-messages/"> Receive messages </a> </li><li> <a href="/__pyric/ui/docs/run-ai-logic-locally/"> Run AI Logic locally </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-how-to-run-rtdb-onvaluecreated/"> Run an RTDB function locally </a> </li><li> <a href="/__pyric/ui/docs/which-data-service/"> Which data service? </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-inspect-and-correct"> <summary>Inspect and correct</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section"> <h2 class="docs-nav-heading" id="nav-section-inspect-and-correct-inspect-the-sandbox"> Inspect the sandbox </h2> <ul> <li> <a href="/__pyric/ui/docs/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/shape-your-data/"> Seed, snapshot, replay </a> </li><li> <a href="/__pyric/ui/docs/watch-and-review/"> Review agent activity </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading" id="nav-section-inspect-and-correct-correct-security-rules"> Correct Security Rules </h2> <ul> <li> <a href="/__pyric/ui/docs/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/rules-patterns/"> Rules patterns </a> </li><li> <a href="/__pyric/ui/docs/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/whats-possible/"> Case studies </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading" id="nav-section-inspect-and-correct-work-with-an-agent"> Work with an agent </h2> <ul> <li> <a href="/__pyric/ui/docs/what-your-agent-can-do/"> Work through an agent </a> </li><li> <a href="/__pyric/ui/docs/skills/"> Agent skills </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-verify-the-boundary"> <summary>Verify the boundary</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-how-to-verify-against-a-captured-session/"> Verify a captured session </a> </li><li> <a href="/__pyric/ui/docs/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-ship-unchanged"> <summary>Ship unchanged</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/set-up-the-project/"> Set up the Firebase project </a> </li> </ul> </div> </div> </details><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/how-we-know-it-matches-firebase/"> Conformance </a> </li><li> <a href="/__pyric/ui/docs/whats-experimental/"> What&#39;s experimental </a> </li><li> <a href="/__pyric/ui/docs/pyric-conformance-scores/"> Conformance scores </a> </li><li> <a href="/__pyric/ui/docs/pyric-app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-compat/"> Rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-functions-rtdb-compat/"> Functions · RTDB </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"> <div class="docs-nav-section"> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli/"> @pyric/cli </a> </li><li> <a href="/__pyric/ui/docs/pyric-explanation-versioning-and-compatibility/"> pyric </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore/"> pyric / firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules/"> pyric / rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox/"> pyric / sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage/"> pyric / storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth/"> pyric / auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-database/"> pyric / database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-app/"> pyric-admin / app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore/"> pyric-admin / firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth/"> pyric-admin / auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database/"> pyric-admin / database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage/"> pyric-admin / storage </a> </li><li> <a href="/__pyric/ui/docs/ui/"> @pyric/ui </a> </li><li> <a href="/__pyric/ui/docs/api-reference/" aria-current="true"> API reference </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. -->
+<h2 id="interfaces">Interfaces</h2>
+<p><a id="connectremotesandboxoptions"></a></p>
+<h3 id="connectremotesandboxoptions">ConnectRemoteSandboxOptions</h3>
+<h4 id="properties">Properties</h4>
+<div class="table-scroll">
+<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="cwd"></a> <code>cwd?</code></td><td align="left"><code>string</code></td><td align="left">Project root for <code>.pyric/serve.json</code> discovery. Default: <code>process.cwd()</code>.</td></tr><tr><td align="left"><a id="optimeoutms"></a> <code>opTimeoutMs?</code></td><td align="left"><code>number</code></td><td align="left">Per-op timeout in ms on the Node side (default 35s, above the bridge’s 30s).</td></tr><tr><td align="left"><a id="url"></a> <code>url?</code></td><td align="left"><code>string</code></td><td align="left">Explicit serve base URL (e.g. <code>http://127.0.0.1:5000</code>) — skips discovery.</td></tr></tbody></table></div>
+<hr>
+<p><a id="lazyremotesandbox"></a></p>
+<h3 id="lazyremotesandbox">LazyRemoteSandbox</h3>
+<p><a href="#remotesandbox-1">remoteSandbox</a>’s return type: the branded handle plus <code>ready</code> for
+eager checkers. <code>ready</code> kicks off the connection when first accessed and
+settles with the same fail-fast errors <a href="#connectremotesandbox">connectRemoteSandbox</a> throws
+(no serve discovered / no browser tab connected).</p>
+<h4 id="extends">Extends</h4>
+<ul>
+<li><a href="#remotesandbox"><code>RemoteSandbox</code></a></li>
+</ul>
+<h4 id="properties-1">Properties</h4>
+<div class="table-scroll">
+<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>
+<h4 id="methods">Methods</h4>
+<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>
+<p><code>void</code></p>
+<h6 id="inherited-from">Inherited from</h6>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a>.<a href="#close-2"><code>close</code></a></p>
+<hr>
+<p><a id="remoteauthadmin"></a></p>
+<h3 id="remoteauthadmin">RemoteAuthAdmin</h3>
+<p>Admin auth user-CRUD passthrough (never lensed — auth ops operate the
+worker’s user pool directly, mirroring <code>pyric/auth</code>’s sandbox ops).</p>
+<h4 id="methods-1">Methods</h4>
+<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>
+<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>
+<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>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>
+<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>
+<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>uid</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-3">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>
+<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>
+<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>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>
+<hr>
+<p><a id="remotertdb"></a></p>
+<h3 id="remotertdb">RemoteRtdb</h3>
+<p>Thin RTDB conveniences over the channel. Every call pins
+<code>actAs: { mode: 'admin' }</code> — firebase-admin’s rules-bypass semantics,
+matching what <code>pyric-admin</code>’s database backend needs. Use the raw
+<code>channel</code> for lensed (rules-evaluated) access.</p>
+<h4 id="methods-2">Methods</h4>
+<p><a id="get"></a></p>
+<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>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-6">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>unknown</code>></p>
+<p><a id="onvalue"></a></p>
+<h5 id="onvalue">onValue()</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">onValue</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75">   path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75">   callback</span><span style="color:#ABB2BF">: (</span><span style="color:#E06C75;font-style:italic">snapshot</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RemoteRtdbSnapshot</span><span style="color:#ABB2BF">) </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75">   onError</span><span style="color:#C678DD">?:</span><span style="color:#ABB2BF"> (</span><span style="color:#E06C75;font-style:italic">err</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Error</span><span style="color:#ABB2BF"> &#x26; {</span></span>
+<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>
+<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>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>
+<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>
+<p><code>void</code></p>
+<p><a id="push"></a></p>
+<h5 id="push">push()</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">push</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:#C678DD">?:</span><span style="color:#E06C75"> unknown</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">  key</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  path</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>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>
+<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>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>
+<p><code>Promise</code>&#x3C;{
+<code>key</code>: <code>string</code>;
+<code>path</code>: <code>string</code>;
+}></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>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-10">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>
+<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>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>
+<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>
+<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>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>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<hr>
+<p><a id="remotertdbsnapshot"></a></p>
+<h3 id="remotertdbsnapshot">RemoteRtdbSnapshot</h3>
+<p>Wire shape of an RTDB snapshot as the worker host serializes it.</p>
+<h4 id="properties-2">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="exists"></a> <code>exists</code></td><td align="left"><code>boolean</code></td></tr><tr><td align="left"><a id="key"></a> <code>key</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="size"></a> <code>size</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><a id="value"></a> <code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<hr>
+<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
+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>,
+<code>history()</code>, <code>onEvent</code>, <code>currentUser</code>, …) cannot be mirrored over the
+wire in slice 1 and throw a remediating <code>unimplemented</code> error naming
+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>
+</ul>
+<h4 id="extended-by">Extended by</h4>
+<ul>
+<li><a href="#lazyremotesandbox"><code>LazyRemoteSandbox</code></a></li>
+</ul>
+<h4 id="properties-3">Properties</h4>
+<div class="table-scroll">
+<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>
+<h4 id="methods-3">Methods</h4>
+<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>
+<p><code>void</code></p>
+<hr>
+<p><a id="remotesandboxchannel-1"></a></p>
+<h3 id="remotesandboxchannel">RemoteSandboxChannel</h3>
+<p>The raw relay channel: any worker-protocol op or snap-delivering
+subscription, verbatim. The typed conveniences below are built on this;
+checkpoint 2’s <code>pyric-admin</code> remote-dispatch arm consumes it directly.</p>
+<h4 id="methods-4">Methods</h4>
+<p><a id="op"></a></p>
+<h5 id="op">op()</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">op</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">op</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">WorkerOpPayload</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>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>
+<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>op</code></td><td align="left"><code>WorkerOpPayload</code></td></tr></tbody></table></div>
+<h6 id="returns-14">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>unknown</code>></p>
+<p><a id="subscribe"></a></p>
+<h5 id="subscribe">subscribe()</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">subscribe</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75">   sub</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">WorkerSubPayload</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75">   onSnap</span><span style="color:#ABB2BF">: (</span><span style="color:#E06C75;font-style:italic">value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">) </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75">   onError</span><span style="color:#C678DD">?:</span><span style="color:#ABB2BF"> (</span><span style="color:#E06C75;font-style:italic">err</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Error</span><span style="color:#ABB2BF"> &#x26; {</span></span>
+<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>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>
+<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>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>
+<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>
+<p><code>void</code></p>
+<hr>
+<p><a id="remotesandboxcore"></a></p>
+<h3 id="remotesandboxcore">RemoteSandboxCore</h3>
+<h4 id="properties-4">Properties</h4>
+<div class="table-scroll">
+<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>
+<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>
+<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>reason?</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-17">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>
+<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>msg</code></td><td align="left"><code>BridgeMessage</code></td></tr></tbody></table></div>
+<h6 id="returns-18">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>
+<p><code>void</code></p>
+<hr>
+<p><a id="remotestorage"></a></p>
+<h3 id="remotestorage">RemoteStorage</h3>
+<p>Thin Storage conveniences over the channel — the byte-carrying base64 ops
+plus browse/metadata. Every call pins <code>actAs: { mode: 'admin' }</code>
+(firebase-admin’s rules-bypass semantics, matching <a href="#remotertdb">RemoteRtdb</a>);
+use the raw <code>channel</code> for lensed (rules-evaluated) access. Bytes are
+capped at 8 MiB raw (MAX_STORAGE_OP_BYTES) on both ends —
+streaming transfers are not supported on the sandbox backend.</p>
+<h4 id="methods-6">Methods</h4>
+<p><a id="deleteobject"></a></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>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-20">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>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-21">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>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-22">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>
+<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>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>
+<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>
+<span class="line"><span style="color:#E06C75">  items</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">     fullPath</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">     name</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>
+<span class="line"><span style="color:#E06C75">  prefixes</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">     fullPath</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">     name</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>
+<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>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-24">Returns</h6>
+<p><code>Promise</code>&#x3C;{
+<code>items</code>: {
+<code>fullPath</code>: <code>string</code>;
+<code>name</code>: <code>string</code>;
+}[];
+<code>prefixes</code>: {
+<code>fullPath</code>: <code>string</code>;
+<code>name</code>: <code>string</code>;
+}[];
+}></p>
+<p><a id="putbytes"></a></p>
+<h5 id="putbytes">putBytes()</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">putBytes</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75">   path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75">   data</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">Uint8Array</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75">   options</span><span style="color:#C678DD">?:</span><span style="color:#ABB2BF"> {</span></span>
+<span class="line"><span style="color:#ABB2BF">  contentType?: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  metadata</span><span style="color:#C678DD">?:</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:#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>
+<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>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>
+<hr>
+<p><a id="remotetransport"></a></p>
+<h3 id="remotetransport">RemoteTransport</h3>
+<p>Minimal transport the core writes to. <code>connectRemoteSandbox</code> adapts a
+<code>ws</code> socket; tests inject an in-process pipe to a <code>ConsumerSession</code>.</p>
+<h4 id="methods-7">Methods</h4>
+<p><a id="ref"></a></p>
+<h5 id="ref">ref()?</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"> ref</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>OPTIONAL event-loop hold hooks (exit-hang fix). The WS adapter unrefs
+its socket once connected so an IDLE remote client never pins the Node
+event loop (a finished script exits); the core calls <code>ref()</code> when work
+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>
+<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>
+<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>msg</code></td><td align="left"><code>BridgeMessage</code></td></tr></tbody></table></div>
+<h6 id="returns-27">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>
+<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>
+<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>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>
+<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>
+<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>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>
+<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>
+<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>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>
+<p><a href="#remotestorage"><code>RemoteStorage</code></a></p>
+<hr>
+<p><a id="connectremotesandbox"></a></p>
+<h3 id="connectremotesandbox">connectRemoteSandbox()</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"> connectRemoteSandbox</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ConnectRemoteSandboxOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">RemoteSandbox</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Discover the running <code>pyric dev --bridge</code>, attach to its bridge WS as a
+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>
+<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="#connectremotesandboxoptions"><code>ConnectRemoteSandboxOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-32">Returns</h4>
+<p><code>Promise</code>&#x3C;<a href="#remotesandbox"><code>RemoteSandbox</code></a>></p>
+<hr>
+<p><a id="createlazyremotesandbox"></a></p>
+<h3 id="createlazyremotesandbox">createLazyRemoteSandbox()</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"> createLazyRemoteSandbox</span><span style="color:#ABB2BF">(</span><span style="color:#61AFEF">connect</span><span style="color:#ABB2BF">: () </span><span style="color:#C678DD">=></span><span style="color:#E5C07B"> Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">RemoteSandbox</span><span style="color:#ABB2BF">>, </span><span style="color:#E06C75;font-style:italic">options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  url</span><span style="color:#C678DD">?</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:#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>
+<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>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>
+<p><a href="#lazyremotesandbox"><code>LazyRemoteSandbox</code></a></p>
+<hr>
+<p><a id="createremotesandboxcore"></a></p>
+<h3 id="createremotesandboxcore">createRemoteSandboxCore()</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"> createRemoteSandboxCore</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">transport</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RemoteTransport</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">opts</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  opTimeoutMs</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  serveUrl</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:#E5C07B">RemoteSandboxCore</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Transport-agnostic client core: correlation ids/subIds are minted HERE
+(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>
+<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>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>
+<p><a href="#remotesandboxcore"><code>RemoteSandboxCore</code></a></p>
+<hr>
+<p><a id="createremotesandboxhandle"></a></p>
+<h3 id="createremotesandboxhandle">createRemoteSandboxHandle()</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"> createRemoteSandboxHandle</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">opts</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  channel</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RemoteSandboxChannel</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#61AFEF">  close</span><span style="color:#ABB2BF">: () </span><span style="color:#C678DD">=></span><span style="color:#E5C07B"> void</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  serveUrl</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:#E5C07B">RemoteSandbox</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Build the branded remote sandbox handle over an established channel.</p>
+<p>Split out of <a href="#connectremotesandbox">connectRemoteSandbox</a> so the in-process test harness
+(fake ports + <code>createConsumerSession</code>, no WS) constructs the EXACT handle
+production hands to <code>pyric-admin</code>.</p>
+<p>The handle satisfies <code>Sandbox</code> structurally:</p>
+<ul>
+<li><code>withAuth</code> / <code>dispose</code> are real (pure local construction / teardown).</li>
+<li>Everything whose contract is sync-only or worker-owned (<code>admin</code>,
+<code>snapshot</code>, <code>loadSnapshot</code>, <code>history</code>, <code>onEvent</code>, <code>reset</code>,
+<code>currentUser</code>, <code>onCurrentUserChanged</code>, tab sync, persistence) throws
+a remediating <code>unimplemented</code> error. Notably <code>onEvent</code>: the unified
+event stream (<code>target: 'events'</code>) is not relayable until slice 2’s
+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>
+<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>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>
+<p><a href="#remotesandbox"><code>RemoteSandbox</code></a></p>
+<hr>
+<p><a id="remotesandbox-1"></a></p>
+<h3 id="remotesandbox-1">remoteSandbox()</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"> remoteSandbox</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ConnectRemoteSandboxOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">LazyRemoteSandbox</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Synchronous construction, lazy connection — the ambient-init seam.</p>
+<p><code>@pyric/cli/register</code> installs this behind the
+<code>Symbol.for('pyric.remote.sandboxFactory')</code> global so <code>pyric-admin</code>’s bare
+<code>initializeApp()</code> can mint a full branded handle without awaiting anything.
+The wire connection (discovery → WS attach) happens on the FIRST op (or
+<code>ready</code> access), so the existing fail-fast — “no browser tab is connected —
+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>
+<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="#connectremotesandboxoptions"><code>ConnectRemoteSandboxOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-36">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>