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-discover-reference-api/index.html ADDED Viewed

@@ -0,0 +1,2355 @@
+<!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/discover · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/cli/discover."><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/discover</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/cli/discover</code></h1> <p class="api-reference-meta"> 65 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="classes">Classes</h2>
+<p><a id="localenvironmentcrawleradapter"></a></p>
+<h3 id="localenvironmentcrawleradapter">LocalEnvironmentCrawlerAdapter</h3>
+<p>Wrap a LocalEnvironment as a Firestore root that satisfies
+the discover/crawler + find-collection-group contracts.</p>
+<h4 id="implements">Implements</h4>
+<ul>
+<li><a href="#crawlerfirestore"><code>CrawlerFirestore</code></a></li>
+<li><a href="#collectiongroupcapablefirestore"><code>CollectionGroupCapableFirestore</code></a></li>
+</ul>
+<h4 id="constructors">Constructors</h4>
+<p><a id="constructor"></a></p>
+<h5 id="constructor">Constructor</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:#C678DD">new</span><span style="color:#61AFEF"> LocalEnvironmentCrawlerAdapter</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">env</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">LocalEnvironment</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">LocalEnvironmentCrawlerAdapter</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>env</code></td><td align="left"><code>LocalEnvironment</code></td></tr></tbody></table></div>
+<h6 id="returns">Returns</h6>
+<p><a href="#localenvironmentcrawleradapter"><code>LocalEnvironmentCrawlerAdapter</code></a></p>
+<h4 id="methods">Methods</h4>
+<p><a id="collection"></a></p>
+<h5 id="collection">collection()</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">collection</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">CrawlerCollectionRef</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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-1">Returns</h6>
+<p><a href="#crawlercollectionref"><code>CrawlerCollectionRef</code></a></p>
+<h6 id="implementation-of">Implementation of</h6>
+<p><a href="#crawlerfirestore"><code>CrawlerFirestore</code></a>.<a href="#collection-2"><code>collection</code></a></p>
+<p><a id="collectiongroup"></a></p>
+<h5 id="collectiongroup">collectionGroup()</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">collectionGroup</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">collectionId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">CollectionGroupQuery</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>collectionId</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-2">Returns</h6>
+<p><a href="#collectiongroupquery"><code>CollectionGroupQuery</code></a></p>
+<h6 id="implementation-of-1">Implementation of</h6>
+<p><a href="#collectiongroupcapablefirestore"><code>CollectionGroupCapableFirestore</code></a>.<a href="#collectiongroup-2"><code>collectionGroup</code></a></p>
+<p><a id="doc"></a></p>
+<h5 id="doc">doc()</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">doc</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">CrawlerDocumentRef</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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-3">Returns</h6>
+<p><a href="#crawlerdocumentref"><code>CrawlerDocumentRef</code></a></p>
+<h6 id="implementation-of-2">Implementation of</h6>
+<p><a href="#crawlerfirestore"><code>CrawlerFirestore</code></a>.<a href="#doc-2"><code>doc</code></a></p>
+<p><a id="listcollections"></a></p>
+<h5 id="listcollections">listCollections()</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">listCollections</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">CrawlerCollectionRef</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;<a href="#crawlercollectionref"><code>CrawlerCollectionRef</code></a>[]></p>
+<h6 id="implementation-of-3">Implementation of</h6>
+<p><a href="#crawlerfirestore"><code>CrawlerFirestore</code></a>.<a href="#listcollections-4"><code>listCollections</code></a></p>
+<hr>
+<p><a id="semaphore"></a></p>
+<h3 id="semaphore">Semaphore</h3>
+<p>FIFO counting semaphore. <code>acquire()</code> resolves immediately while
+fewer than <code>max</code> permits are checked out, otherwise it queues until
+a <code>release()</code> frees a slot. Waiters are served in arrival order.</p>
+<p><code>release()</code> without a prior <code>acquire()</code> is a no-op (does not go
+negative). This is intentional — it lets defensive <code>try/finally</code>
+release in error paths without bookkeeping.</p>
+<h4 id="constructors-1">Constructors</h4>
+<p><a id="constructor-1"></a></p>
+<h5 id="constructor-1">Constructor</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:#C678DD">new</span><span style="color:#61AFEF"> Semaphore</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">max</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">Semaphore</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>max</code></td><td align="left"><code>number</code></td></tr></tbody></table></div>
+<h6 id="returns-5">Returns</h6>
+<p><a href="#semaphore"><code>Semaphore</code></a></p>
+<h4 id="accessors">Accessors</h4>
+<p><a id="inflight"></a></p>
+<h5 id="inflight">inFlight</h5>
+<h6 id="get-signature">Get Signature</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:#E06C75">get</span><span style="color:#61AFEF"> inFlight</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Number of permits currently checked out. For tests and instrumentation
+only; do not branch on this in production logic.</p>
+<h6 id="returns-6">Returns</h6>
+<p><code>number</code></p>
+<p><a id="pending"></a></p>
+<h5 id="pending">pending</h5>
+<h6 id="get-signature-1">Get Signature</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:#E06C75">get</span><span style="color:#61AFEF"> pending</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Number of waiters queued. For tests and instrumentation only.</p>
+<h6 id="returns-7">Returns</h6>
+<p><code>number</code></p>
+<h4 id="methods-1">Methods</h4>
+<p><a id="acquire"></a></p>
+<h5 id="acquire">acquire()</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">acquire</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-8">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<p><a id="release"></a></p>
+<h5 id="release">release()</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">release</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-9">Returns</h6>
+<p><code>void</code></p>
+<hr>
+<p><a id="sessionstore"></a></p>
+<h3 id="sessionstore">SessionStore</h3>
+<p>In-process LRU session store with TTL sweep and per-session byte cap.</p>
+<p>Eviction policy:</p>
+<ol>
+<li>On every <code>create</code>/<code>get</code>/<code>update</code>, sweep TTL-expired sessions first.
+Their tokens land in the eviction log as <code>SESSION_EXPIRED</code>.</li>
+<li>If <code>create</code> would exceed <code>maxSessions</code>, evict the LRU
+(oldest-by-<code>lastAccessedAt</code>). Its token lands in the eviction log
+as <code>SESSION_EVICTED</code> so the displaced agent gets a meaningful
+error on its next call.</li>
+<li><code>update</code> rejects with <code>SESSION_PAYLOAD_TOO_LARGE</code> if the new
+<code>bytes</code> exceeds <code>maxSessionBytes</code> (per-session cap, not aggregate).</li>
+</ol>
+<p>The eviction log is a bounded ring buffer; once it overflows, evicted
+tokens degrade silently to <code>SESSION_EXPIRED</code> (still actionable — the
+recoveryHint is the same: re-issue without continuation).</p>
+<h4 id="type-parameters">Type Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Type Parameter</th></tr></thead><tbody><tr><td align="left"><code>TState</code></td></tr></tbody></table></div>
+<h4 id="constructors-2">Constructors</h4>
+<p><a id="constructor-2"></a></p>
+<h5 id="constructor-2">Constructor</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:#C678DD">new</span><span style="color:#61AFEF"> SessionStore</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">TState</span><span style="color:#ABB2BF">>(</span><span style="color:#E06C75">opts</span><span style="color:#C678DD">?:</span><span style="color:#E06C75"> SessionStoreOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">SessionStore</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">TState</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>opts?</code></td><td align="left"><a href="#sessionstoreoptions"><code>SessionStoreOptions</code></a></td></tr></tbody></table></div>
+<h6 id="returns-10">Returns</h6>
+<p><a href="#sessionstore"><code>SessionStore</code></a>&#x3C;<code>TState</code>></p>
+<h4 id="accessors-1">Accessors</h4>
+<p><a id="size"></a></p>
+<h5 id="size">size</h5>
+<h6 id="get-signature-2">Get Signature</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:#E06C75">get</span><span style="color:#61AFEF"> size</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Live session count.</p>
+<h6 id="returns-11">Returns</h6>
+<p><code>number</code></p>
+<h4 id="methods-2">Methods</h4>
+<p><a id="create"></a></p>
+<h5 id="create">create()</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">create</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">state</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">TState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">bytes</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">SessionResult</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">SessionRecord</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">TState</span><span style="color:#56B6C2">>></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Create a new session. Always succeeds unless <code>bytes</code> exceeds the
+per-session byte cap. On cap-hit, evicts the LRU session — the
+displaced token will report <code>SESSION_EVICTED</code> on its next access.</p>
+<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>state</code></td><td align="left"><code>TState</code></td></tr><tr><td align="left"><code>bytes</code></td><td align="left"><code>number</code></td></tr></tbody></table></div>
+<h6 id="returns-12">Returns</h6>
+<p><a href="#sessionresult"><code>SessionResult</code></a>&#x3C;<a href="#sessionrecord"><code>SessionRecord</code></a>&#x3C;<code>TState</code>>></p>
+<p><a id="delete"></a></p>
+<h5 id="delete">delete()</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:#C678DD">delete</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">token</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">boolean</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Best-effort delete; returns true if a session was removed.</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>token</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-13">Returns</h6>
+<p><code>boolean</code></p>
+<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">token</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">SessionResult</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">SessionRecord</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">TState</span><span style="color:#56B6C2">>></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Look up a session by token. Touches <code>lastAccessedAt</code> on success so
+subsequent reads keep the session warm. On expired/malformed/evicted
+tokens returns the appropriate structured error.</p>
+<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>token</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-14">Returns</h6>
+<p><a href="#sessionresult"><code>SessionResult</code></a>&#x3C;<a href="#sessionrecord"><code>SessionRecord</code></a>&#x3C;<code>TState</code>>></p>
+<p><a id="sweepexpired"></a></p>
+<h5 id="sweepexpired">sweepExpired()</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">sweepExpired</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">now</span><span style="color:#C678DD">?:</span><span style="color:#E06C75"> number</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Drop sessions whose <code>lastAccessedAt + ttlMs</code> is in the past.
+Returns the number of sessions evicted. Public for tests +
+future scheduled-sweep usage; <code>create</code>/<code>get</code>/<code>update</code> all call it
+lazily so callers don’t normally need to.</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>now?</code></td><td align="left"><code>number</code></td></tr></tbody></table></div>
+<h6 id="returns-15">Returns</h6>
+<p><code>number</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>
+<span class="line"><span style="color:#E06C75">   token</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">   state</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">TState</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75">bytes</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">SessionResult</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">SessionRecord</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">TState</span><span style="color:#56B6C2">>></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Replace the state of an existing session. Same lookup/error model
+as <code>get</code>, plus per-session-bytes enforcement on the new payload.</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>token</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>state</code></td><td align="left"><code>TState</code></td></tr><tr><td align="left"><code>bytes</code></td><td align="left"><code>number</code></td></tr></tbody></table></div>
+<h6 id="returns-16">Returns</h6>
+<p><a href="#sessionresult"><code>SessionResult</code></a>&#x3C;<a href="#sessionrecord"><code>SessionRecord</code></a>&#x3C;<code>TState</code>>></p>
+<hr>
+<p><a id="wireprotounavailableerror"></a></p>
+<h3 id="wireprotounavailableerror">WireProtoUnavailableError</h3>
+<p>Thrown when <code>DocumentSnapshot._fieldsProto</code> is unavailable or malformed.
+Per prerequisite 0.A, the wire reader does NOT silently fall back to
+<code>data()</code> — that would collapse integer/double at the value boundary
+and corrupt every downstream codegen consumer.</p>
+<h4 id="extends">Extends</h4>
+<ul>
+<li><code>Error</code></li>
+</ul>
+<h4 id="constructors-3">Constructors</h4>
+<p><a id="constructor-3"></a></p>
+<h5 id="constructor-3">Constructor</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:#C678DD">new</span><span style="color:#61AFEF"> WireProtoUnavailableError</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">opts</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  docPath</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">  reason</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">WireProtoUnavailableError</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>opts</code></td><td align="left">{ <code>docPath</code>: <code>string</code>; <code>reason</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>opts.docPath</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>opts.reason</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-17">Returns</h6>
+<p><a href="#wireprotounavailableerror"><code>WireProtoUnavailableError</code></a></p>
+<h6 id="overrides">Overrides</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:#E5C07B">Error</span><span style="color:#ABB2BF">.</span><span style="color:#E06C75">constructor</span></span></code></pre>
+<h4 id="properties">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">Default value</th><th align="left">Overrides</th></tr></thead><tbody><tr><td align="left"><a id="name"></a> <code>name</code></td><td align="left"><code>readonly</code></td><td align="left"><code>"WireProtoUnavailableError"</code></td><td align="left"><code>"WireProtoUnavailableError"</code></td><td align="left"><code>Error.name</code></td></tr></tbody></table></div>
+<h2 id="interfaces">Interfaces</h2>
+<p><a id="collectiongroupcapablefirestore"></a></p>
+<h3 id="collectiongroupcapablefirestore">CollectionGroupCapableFirestore</h3>
+<p>Optional source capability used by <code>findCollectionGroup</code>.</p>
+<h4 id="methods-3">Methods</h4>
+<p><a id="collectiongroup-2"></a></p>
+<h5 id="collectiongroup-1">collectionGroup()</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">collectionGroup</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">collectionId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">CollectionGroupQuery</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>collectionId</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-18">Returns</h6>
+<p><a href="#collectiongroupquery"><code>CollectionGroupQuery</code></a></p>
+<hr>
+<p><a id="collectiongroupquery"></a></p>
+<h3 id="collectiongroupquery">CollectionGroupQuery</h3>
+<p>Minimal collection-group query shape used by host discovery.</p>
+<h4 id="methods-4">Methods</h4>
+<p><a id="get-2"></a></p>
+<h5 id="get-1">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:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;{</span></span>
+<span class="line"><span style="color:#E06C75">  docs</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">CollectionGroupSnapshot</span><span style="color:#ABB2BF">[];</span></span>
+<span class="line"><span style="color:#ABB2BF">}>;</span></span></code></pre>
+<h6 id="returns-19">Returns</h6>
+<p><code>Promise</code>&#x3C;{
+<code>docs</code>: <a href="#collectiongroupsnapshot"><code>CollectionGroupSnapshot</code></a>[];
+}></p>
+<p><a id="limit"></a></p>
+<h5 id="limit">limit()</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">limit</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">n</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">CollectionGroupQuery</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>n</code></td><td align="left"><code>number</code></td></tr></tbody></table></div>
+<h6 id="returns-20">Returns</h6>
+<p><a href="#collectiongroupquery"><code>CollectionGroupQuery</code></a></p>
+<p><a id="select"></a></p>
+<h5 id="select">select()</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">select</span><span style="color:#ABB2BF">(...</span><span style="color:#E06C75">fields</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">[]): </span><span style="color:#E06C75">CollectionGroupQuery</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>fields</code></td><td align="left"><code>string</code>[]</td></tr></tbody></table></div>
+<h6 id="returns-21">Returns</h6>
+<p><a href="#collectiongroupquery"><code>CollectionGroupQuery</code></a></p>
+<hr>
+<p><a id="collectiongroupsnapshot"></a></p>
+<h3 id="collectiongroupsnapshot">CollectionGroupSnapshot</h3>
+<p>Parent-path projection used by collection-group discovery.</p>
+<h4 id="properties-1">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="ref"></a> <code>ref</code></td><td align="left">{ <code>parent</code>: { <code>path</code>: <code>string</code>; }; }</td></tr><tr><td align="left"><code>ref.parent</code></td><td align="left">{ <code>path</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>ref.parent.path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="collectionschema"></a></p>
+<h3 id="collectionschema">CollectionSchema</h3>
+<p>Schema for a single collection as surfaced in the tool output’s
+<code>finalizedSchemas</code>.</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="declaredat"></a> <code>declaredAt</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><a id="examplepath"></a> <code>examplePath?</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="samplingcomplete"></a> <code>samplingComplete</code></td><td align="left"><a href="#samplingcomplete-1"><code>SamplingComplete</code></a></td></tr><tr><td align="left"><a id="schema"></a> <code>schema</code></td><td align="left"><a href="#fieldschema"><code>FieldSchema</code></a></td></tr><tr><td align="left"><a id="subcollectiontemplatepaths"></a> <code>subcollectionTemplatePaths</code></td><td align="left"><code>string</code>[]</td></tr><tr><td align="left"><a id="templatepath"></a> <code>templatePath</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="convergenceresult"></a></p>
+<h3 id="convergenceresult">ConvergenceResult</h3>
+<h4 id="properties-3">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="declaredat-1"></a> <code>declaredAt</code></td><td align="left"><code>number</code></td><td align="left">Doc index where <code>stopOnStable</code> fired (0-based), or null if never.</td></tr><tr><td align="left"><a id="finalschema"></a> <code>finalSchema</code></td><td align="left"><a href="#fieldschema"><code>FieldSchema</code></a></td><td align="left">Final accumulated schema.</td></tr><tr><td align="left"><a id="missedchangesafterdeclared"></a> <code>missedChangesAfterDeclared</code></td><td align="left"><a href="#schemachange"><code>SchemaChange</code></a>[]</td><td align="left">Changes emitted <em>after</em> convergence was declared — caller-visible for test-time assertion that <code>stopOnStable</code> would not have lost data.</td></tr><tr><td align="left"><a id="totalchanges"></a> <code>totalChanges</code></td><td align="left"><code>number</code></td><td align="left">Total change count across the stream.</td></tr><tr><td align="left"><a id="totaldocs"></a> <code>totalDocs</code></td><td align="left"><code>number</code></td><td align="left">Total docs consumed (≤ stream length).</td></tr></tbody></table></div>
+<hr>
+<p><a id="crawlercollectionref"></a></p>
+<h3 id="crawlercollectionref">CrawlerCollectionRef</h3>
+<p>Minimal collection-reference shape needed for traversal.</p>
+<h4 id="properties-4">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="id"></a> <code>id</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="path"></a> <code>path</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="methods-5">Methods</h4>
+<p><a id="listdocuments"></a></p>
+<h5 id="listdocuments">listDocuments()</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">listDocuments</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">CrawlerDocumentRef</span><span style="color:#ABB2BF">[]</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-22">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="#crawlerdocumentref"><code>CrawlerDocumentRef</code></a>[]></p>
+<hr>
+<p><a id="crawlerdocumentref"></a></p>
+<h3 id="crawlerdocumentref">CrawlerDocumentRef</h3>
+<p>Minimal document-reference shape needed for traversal and sampling.</p>
+<h4 id="properties-5">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="id-1"></a> <code>id</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="path-1"></a> <code>path</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="methods-6">Methods</h4>
+<p><a id="get-4"></a></p>
+<h5 id="get-2">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:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">WireDocumentSnapshot</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-23">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="#wiredocumentsnapshot"><code>WireDocumentSnapshot</code></a>></p>
+<p><a id="listcollections-2"></a></p>
+<h5 id="listcollections-1">listCollections()</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">listCollections</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">CrawlerCollectionRef</span><span style="color:#ABB2BF">[]</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-24">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="#crawlercollectionref"><code>CrawlerCollectionRef</code></a>[]></p>
+<hr>
+<p><a id="crawlerfirestore"></a></p>
+<h3 id="crawlerfirestore">CrawlerFirestore</h3>
+<p>Firestore-shaped source consumed by the crawler.</p>
+<p><code>collection</code> and <code>doc</code> are needed only when resuming a continuation.</p>
+<h4 id="methods-7">Methods</h4>
+<p><a id="collection-2"></a></p>
+<h5 id="collection-1">collection()?</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"> collection</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">CrawlerCollectionRef</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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-25">Returns</h6>
+<p><a href="#crawlercollectionref"><code>CrawlerCollectionRef</code></a></p>
+<p><a id="doc-2"></a></p>
+<h5 id="doc-1">doc()?</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"> doc</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">CrawlerDocumentRef</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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-26">Returns</h6>
+<p><a href="#crawlerdocumentref"><code>CrawlerDocumentRef</code></a></p>
+<p><a id="listcollections-4"></a></p>
+<h5 id="listcollections-2">listCollections()</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">listCollections</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">CrawlerCollectionRef</span><span style="color:#ABB2BF">[]</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-27">Returns</h6>
+<p><code>Promise</code>&#x3C;<a href="#crawlercollectionref"><code>CrawlerCollectionRef</code></a>[]></p>
+<hr>
+<p><a id="crawloptions"></a></p>
+<h3 id="crawloptions">CrawlOptions</h3>
+<p>Crawl options. All fields are optional with documented defaults.</p>
+<ul>
+<li><code>maxConcurrency</code>: in-flight RPC cap. Default 32 per the Risk #1 sweep
+on 2026-05-05. Sweep over <code>{4, 8, 16, 32, 64}</code> against the corpus
+showed <code>4 → 8 → 16 → 32 → 64</code> was a steady ~10–15% per-doubling
+descent (no plateau). 32 was picked over 64 because the curve hadn’t
+flattened — 64 was the cap of the test range, not a true knee — and
+doubling in-flight RPCs again increases the chance of tripping
+per-project connection/quota limits in agent environments. Agents
+that want max speed can override.</li>
+<li><code>maxDepth</code>: hard cap on BFS layers from the root. Defaults to 10
+(well above any real-world Firestore tree). Used as a runaway guard,
+not an agent-facing knob.</li>
+<li><code>rootFilter</code>: optional predicate on root collection IDs. Used by tests
+and the corpus harness to scope discovery to a known prefix without
+walking the entire database.</li>
+</ul>
+<h4 id="properties-6">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="continuation"></a> <code>continuation?</code></td><td align="left"><code>string</code></td><td align="left">Resume a previously paused crawl. Only valid when a <code>SessionStore</code> is passed to <code>crawl()</code>. The token is the <code>continuation</code> value from a prior paused result. Malformed/expired tokens surface as a <code>SESSION_EXPIRED</code>/<code>SESSION_EVICTED</code>/<code>SESSION_MALFORMED_TOKEN</code> error event with no other side effects (per 0.C).</td></tr><tr><td align="left"><a id="dryrun"></a> <code>dryRun?</code></td><td align="left"><code>boolean</code></td><td align="left">Informational-only cost preview. When <code>true</code>, the crawler issues exactly <strong>one</strong> RPC — <code>db.listCollections()</code> at the root — and returns a heuristic projection of what a real crawl would cost. No documents are read, no per-doc <code>listCollections</code> calls are made, no sampling occurs. The result has empty <code>discovered</code> and <code>finalizedSchemas</code>, <code>complete: true</code>, and <code>continuation: undefined</code>. It is <strong>not</strong> a partial crawl that can be resumed — to “commit”, call <code>crawl()</code> again with <code>dryRun: false</code> (a fresh full crawl). Rationale: an agent reading <code>dryRun: true</code> reasonably expects no real crawl happened. Doing a structure walk under that flag would let the agent make decisions on data it didn’t realize it paid for. See Item 5 revision in the implementation plan. Default <code>false</code>.</td></tr><tr><td align="left"><a id="dryrunsubtreemultiplier"></a> <code>dryRunSubtreeMultiplier?</code></td><td align="left"><code>number</code></td><td align="left">Heuristic multiplier used in the dryRun cost projection: assumes each root collection has roughly this many subtree-collections (root + descendants) on average. Default 3 — conservative for typical app schemas. Surfaced as an option so agents tuning for known shapes can revise. Only consulted when <code>dryRun: true</code>.</td></tr><tr><td align="left"><a id="maxbatchbytes"></a> <code>maxBatchBytes?</code></td><td align="left"><code>number</code></td><td align="left">Pause threshold for batch payload size. After each layer (structure phase) and each templatePath (sampling phase) the crawler measures the JSON-serialized state size; if it exceeds this many bytes, the crawl pauses and returns a continuation token. Default 1 MB per Phase 0.4 sizing — well below <code>maxSessionBytes=32MB</code> so the agent has headroom for response framing. Only effective when a <code>SessionStore</code> is provided to <code>crawl()</code>. With no store, single-call mode runs to completion regardless of size.</td></tr><tr><td align="left"><a id="maxconcurrency"></a> <code>maxConcurrency?</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="maxdepth"></a> <code>maxDepth?</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="maxerrorspercollection"></a> <code>maxErrorsPerCollection?</code></td><td align="left"><code>number</code></td><td align="left">Per-templatePath cap on tolerated PERMISSION_DENIED / transient errors during sampling. Default 3 per prerequisite 0.E. Past this threshold, sampling for the templatePath stops and <code>samplingComplete</code> is set to <code>sampling_open</code> so the agent can see the collection wasn’t fully sampled. Errors during structure discovery are emitted but do not count toward this cap.</td></tr><tr><td align="left"><a id="maxsamples"></a> <code>maxSamples?</code></td><td align="left"><code>number</code></td><td align="left">Hard cap on docs sampled per templatePath. Default 50 per Phase 2.1 lock. Item 3 will add adaptive <code>stopOnStable</code> early-exit on top of this cap; for now sampling reads exactly <code>min(maxSamples, available)</code> docs per templatePath.</td></tr><tr><td align="left"><a id="rootfilter"></a> <code>rootFilter?</code></td><td align="left">(<code>collectionId</code>: <code>string</code>) => <code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="stoponstable"></a> <code>stopOnStable?</code></td><td align="left"><code>number</code></td><td align="left">Adaptive early-exit threshold. After this many consecutive no-change merges in a templatePath’s sampling stream, sampling stops and <code>samplingComplete</code> is set to <code>converged_via_stable</code>. Default 8 per Phase 2.1 lock. Set to a value > maxSamples to disable early-exit (the hard cap then governs). Reads are issued in chunks of <code>stopOnStable</code> so an early-exit avoids fetching the remainder of <code>sampleRefs</code>. Worst-case wasted-read count per templatePath is <code>stopOnStable - 1</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="crawlresult"></a></p>
+<h3 id="crawlresult">CrawlResult</h3>
+<h4 id="extended-by">Extended by</h4>
+<ul>
+<li><a href="#fullcrawlresult"><code>FullCrawlResult</code></a></li>
+</ul>
+<h4 id="properties-7">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="discovered"></a> <code>discovered</code></td><td align="left"><code>Map</code>&#x3C;<code>string</code>, <a href="#discoveredcollection"><code>DiscoveredCollection</code></a>></td><td align="left">-</td></tr><tr><td align="left"><a id="events"></a> <code>events</code></td><td align="left"><a href="#discoverevent"><code>DiscoverEvent</code></a>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="listops"></a> <code>listOps</code></td><td align="left"><code>number</code></td><td align="left">Total <code>listCollections</code> + <code>listDocuments</code> calls — feeds cost reporting.</td></tr></tbody></table></div>
+<hr>
+<p><a id="discoveredcollection"></a></p>
+<h3 id="discoveredcollection">DiscoveredCollection</h3>
+<p>Per-template-path bookkeeping built up during a crawl. Collection refs
+are kept here for Item 2.3 to drive document sampling.</p>
+<p>Multiple concrete collection paths may collapse to the same template
+path (e.g. <code>users/uid_1/posts</code> and <code>users/uid_2/posts</code> both map to
+<code>users/{userId}/posts</code>); their refs are accumulated under one entry.</p>
+<h4 id="properties-8">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="depth"></a> <code>depth</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="docrefs"></a> <code>docRefs</code></td><td align="left"><a href="#crawlerdocumentref"><code>CrawlerDocumentRef</code></a>[]</td><td align="left">Doc refs accumulated across <code>refs</code> during BFS expansion. Sampling draws from this pool — re-listing would double the listDocuments cost we already paid during structure discovery.</td></tr><tr><td align="left"><a id="examplepath-1"></a> <code>examplePath</code></td><td align="left"><code>string</code></td><td align="left">First concrete collection path encountered for this template.</td></tr><tr><td align="left"><a id="refs"></a> <code>refs</code></td><td align="left"><a href="#crawlercollectionref"><code>CrawlerCollectionRef</code></a>[]</td><td align="left">All concrete collection refs that share this template path.</td></tr><tr><td align="left"><a id="templatepath-1"></a> <code>templatePath</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="discoverpathstoolresult"></a></p>
+<h3 id="discoverpathstoolresult">DiscoverPathsToolResult</h3>
+<p>JSON-serializable shape returned by <code>firestore_discover_paths</code>.</p>
+<h4 id="properties-9">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="complete"></a> <code>complete</code></td><td align="left"><code>boolean</code></td><td align="left">True iff the crawl finished. Equivalent to <code>continuation === undefined</code>.</td></tr><tr><td align="left"><a id="continuation-1"></a> <code>continuation?</code></td><td align="left"><code>string</code></td><td align="left">Opaque resume handle iff the crawl paused at a payload boundary.</td></tr><tr><td align="left"><a id="dryruncostestimate"></a> <code>dryRunCostEstimate?</code></td><td align="left"><a href="#dryruncostestimate-1"><code>DryRunCostEstimate</code></a></td><td align="left">Present iff this was a <code>dryRun: true</code> preview.</td></tr><tr><td align="left"><a id="events-1"></a> <code>events</code></td><td align="left"><a href="#discoverevent"><code>DiscoverEvent</code></a>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="listops-1"></a> <code>listOps</code></td><td align="left"><code>number</code></td><td align="left"><code>listCollections</code> + <code>listDocuments</code> calls — cumulative across batches.</td></tr><tr><td align="left"><a id="readops"></a> <code>readOps</code></td><td align="left"><code>number</code></td><td align="left"><code>.get()</code> calls during sampling — cumulative across batches.</td></tr><tr><td align="left"><a id="schemas"></a> <code>schemas</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <a href="#collectionschema"><code>CollectionSchema</code></a>></td><td align="left">Per-templatePath finalized schemas, keyed by templatePath.</td></tr></tbody></table></div>
+<hr>
+<p><a id="dryruncostestimate-1"></a></p>
+<h3 id="dryruncostestimate">DryRunCostEstimate</h3>
+<p>Heuristic cost projection returned by <code>dryRun: true</code>. The numbers are
+upper-bound estimates — agents should treat them as “no more than”
+figures, not exact predictions. Formulas are documented in-line so
+consumers can sanity-check.</p>
+<h4 id="properties-10">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="estimatedlistops"></a> <code>estimatedListOps</code></td><td align="left"><code>number</code></td><td align="left">Projected total <code>listCollections</code> + <code>listDocuments</code> cost of a real crawl: <code>1 + rootCount × subtreeMultiplier</code>. The <code>1</code> is the root <code>listCollections</code>; each subtree contributes one <code>listDocuments</code> call to enumerate docs. Per-doc <code>listCollections</code> cost is folded into the multiplier (a subtree of 3 implies ~2 layers of doc listings).</td></tr><tr><td align="left"><a id="estimatedreadops"></a> <code>estimatedReadOps</code></td><td align="left"><code>number</code></td><td align="left">Projected total <code>.get()</code> cost of sampling: <code>rootCount × subtreeMultiplier × maxSamples</code>. Upper bound — <code>stopOnStable</code> early-exit and <code>cappedByMax</code> can reduce the actual draw.</td></tr><tr><td align="left"><a id="maxsamples-1"></a> <code>maxSamples</code></td><td align="left"><code>number</code></td><td align="left">The <code>maxSamples</code> value the projection used.</td></tr><tr><td align="left"><a id="rootcollectioncount"></a> <code>rootCollectionCount</code></td><td align="left"><code>number</code></td><td align="left">Number of root collections discovered by the single root listCollections call.</td></tr><tr><td align="left"><a id="rootcollectionids"></a> <code>rootCollectionIds</code></td><td align="left"><code>string</code>[]</td><td align="left">The root collection IDs (after <code>rootFilter</code> is applied, if any).</td></tr><tr><td align="left"><a id="subtreemultiplier"></a> <code>subtreeMultiplier</code></td><td align="left"><code>number</code></td><td align="left">The <code>dryRunSubtreeMultiplier</code> value the projection used.</td></tr></tbody></table></div>
+<hr>
+<p><a id="enumcandidate"></a></p>
+<h3 id="enumcandidate">EnumCandidate</h3>
+<p>Captured low-cardinality value set for enum-candidate fields.</p>
+<h4 id="properties-11">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="qualifies"></a> <code>qualifies</code></td><td align="left"><code>boolean</code></td><td align="left">Whether the field still passes the threshold; flips to false if widened past it.</td></tr><tr><td align="left"><a id="threshold"></a> <code>threshold</code></td><td align="left"><code>number</code></td><td align="left">Distinct count after which the candidate is dropped (default 10).</td></tr><tr><td align="left"><a id="values"></a> <code>values</code></td><td align="left">(<code>string</code> | <code>number</code>)[]</td><td align="left">Distinct values observed so far (string/number); ordered by first-seen.</td></tr></tbody></table></div>
+<hr>
+<p><a id="fielddescriptor"></a></p>
+<h3 id="fielddescriptor">FieldDescriptor</h3>
+<p>Per-field descriptor accumulated across a sampled stream.</p>
+<ul>
+<li><code>types</code> is a deduped union; vector-dim drift keeps each dimension as a
+distinct entry by default (Phase 1.2 lock).</li>
+<li><code>presenceSeen / presenceTotal</code> ratio drives presence-based agent UX; the
+denominator includes docs where the field was absent.</li>
+<li><code>nullable</code> is an annotation, not a peer type (Phase 2.1 lock — <code>null</code>
+never appears as a <code>FieldType</code> in this descriptor’s types[]).</li>
+<li><code>enumCandidate</code> populated when the field qualifies per Phase 3.2 lock
+(<code>distinct ≤ 10 AND distinct ≤ samplesSeen / 2</code>); otherwise <code>undefined</code>.
+Tracked only for <code>scalar:string</code> and <code>scalar:integer/double</code>; other kinds
+are not enum candidates.</li>
+<li><code>example</code> is one observed non-null value per Phase 3.2 lock. Drives form
+placeholders, fixtures, README payloads. JSON-stringifiable (wire-typed
+primitives + arrays + plain-object maps).</li>
+<li><code>reservedReason</code> populated by the wire layer when the field name matches
+a reserved-name pattern per 0.B; agents/codegen use it to skip or
+sanitize the field.</li>
+</ul>
+<h4 id="properties-12">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="enumcandidate-1"></a> <code>enumCandidate?</code></td><td align="left"><a href="#enumcandidate"><code>EnumCandidate</code></a></td></tr><tr><td align="left"><a id="example"></a> <code>example?</code></td><td align="left"><a href="#examplevalue"><code>ExampleValue</code></a></td></tr><tr><td align="left"><a id="nullable"></a> <code>nullable</code></td><td align="left"><code>boolean</code></td></tr><tr><td align="left"><a id="presenceseen"></a> <code>presenceSeen</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><a id="presencetotal"></a> <code>presenceTotal</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><a id="reservedreason"></a> <code>reservedReason?</code></td><td align="left"><a href="#reservedfieldreason"><code>ReservedFieldReason</code></a></td></tr><tr><td align="left"><a id="types"></a> <code>types</code></td><td align="left"><a href="#fieldtype"><code>FieldType</code></a>[]</td></tr></tbody></table></div>
+<hr>
+<p><a id="fieldobservation"></a></p>
+<h3 id="fieldobservation">FieldObservation</h3>
+<p>A single field observation passed into <code>mergeDoc</code>. The wire layer
+(<code>wire.ts</code>) is responsible for producing this shape.</p>
+<h4 id="properties-13">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="enumsample"></a> <code>enumSample?</code></td><td align="left"><code>EnumSample</code></td><td align="left">For enum-eligible scalars (string/int/double), the raw value. Used to update enumCandidate.</td></tr><tr><td align="left"><a id="example-1"></a> <code>example?</code></td><td align="left"><code>ExampleValue</code></td><td align="left">A JSON-safe sample of the wire value. Used to populate <code>example</code> on the descriptor when no example exists yet. Optional — wire layer omits for kinds with no codegen-friendly representation.</td></tr><tr><td align="left"><a id="isnull"></a> <code>isNull</code></td><td align="left"><code>boolean</code></td><td align="left">True iff the wire value was a null literal.</td></tr><tr><td align="left"><a id="type"></a> <code>type</code></td><td align="left"><a href="#fieldtype"><code>FieldType</code></a></td><td align="left">The inferred FieldType for this observation. <code>null</code> is allowed and is surfaced via <code>isNull</code>; the <code>type</code> itself is <code>{kind:'scalar', type:'null'}</code> by convention but is NOT added to the descriptor’s types[] union.</td></tr></tbody></table></div>
+<hr>
+<p><a id="fieldschema"></a></p>
+<h3 id="fieldschema">FieldSchema</h3>
+<p>Per-collection accumulated schema. <code>samplesSeen</code> is the doc count fed
+through <code>mergeDoc</code>, used as the presence denominator.</p>
+<h4 id="properties-14">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="fields"></a> <code>fields</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <a href="#fielddescriptor"><code>FieldDescriptor</code></a>></td></tr><tr><td align="left"><a id="samplesseen"></a> <code>samplesSeen</code></td><td align="left"><code>number</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="findcollectiongrouphost"></a></p>
+<h3 id="findcollectiongrouphost">FindCollectionGroupHost</h3>
+<h4 id="properties-15">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="sampledoccount"></a> <code>sampleDocCount</code></td><td align="left"><code>number</code></td><td align="left">Number of docs in the N-doc draw that shared this parent path. NOT the host’s total doc count — that’s a separate query.</td></tr><tr><td align="left"><a id="templatepath-2"></a> <code>templatePath</code></td><td align="left"><code>string</code></td><td align="left">Template-form parent collection path, e.g. <code>users/{userId}/posts</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="findcollectiongroupoptions"></a></p>
+<h3 id="findcollectiongroupoptions">FindCollectionGroupOptions</h3>
+<h4 id="properties-16">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="limit-2"></a> <code>limit?</code></td><td align="left"><code>number</code></td><td align="left">Max docs to fetch from the collection group. Default 100 — covers ~22 distinct hosts with high confidence per the coupon-collector heuristic. Raise this if the result reports <code>limitWasReached: true</code> and you suspect more hosts exist.</td></tr></tbody></table></div>
+<hr>
+<p><a id="findcollectiongroupresult"></a></p>
+<h3 id="findcollectiongroupresult">FindCollectionGroupResult</h3>
+<h4 id="properties-17">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="hosts"></a> <code>hosts</code></td><td align="left"><a href="#findcollectiongrouphost"><code>FindCollectionGroupHost</code></a>[]</td><td align="left">Discovered hosts, deduped by templatePath. Order is insertion order (i.e. the order in which the first matching doc surfaced).</td></tr><tr><td align="left"><a id="limitwasreached"></a> <code>limitWasReached</code></td><td align="left"><code>boolean</code></td><td align="left">True iff <code>reads === limit</code>, signaling the agent should consider raising <code>limit</code> if they need exhaustive host coverage.</td></tr><tr><td align="left"><a id="reads"></a> <code>reads</code></td><td align="left"><code>number</code></td><td align="left">Total docs read — the cost line item. Always <code>min(limit, totalDocsInGroup)</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="firestorediscovertooldeps"></a></p>
+<h3 id="firestorediscovertooldeps">FirestoreDiscoverToolDeps</h3>
+<h4 id="methods-8">Methods</h4>
+<p><a id="resolvedb"></a></p>
+<h5 id="resolvedb">resolveDb()</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">resolveDb</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">CrawlerFirestore</span><span style="color:#56B6C2"> &#x26;</span><span style="color:#E06C75"> CollectionGroupCapableFirestore</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Resolver returning the CrawlerFirestore to scan. Called per
+dispatch (F4). For <code>firestore_find_collection_group</code> the returned
+Firestore must also satisfy <a href="#collectiongroupcapablefirestore">CollectionGroupCapableFirestore</a>.</p>
+<h6 id="returns-28">Returns</h6>
+<p><a href="#crawlerfirestore"><code>CrawlerFirestore</code></a> &#x26; <a href="#collectiongroupcapablefirestore"><code>CollectionGroupCapableFirestore</code></a></p>
+<hr>
+<p><a id="fullcrawlresult"></a></p>
+<h3 id="fullcrawlresult">FullCrawlResult</h3>
+<p>Result of a full crawl (structure + sampling). Augments <code>CrawlResult</code>
+with the per-templatePath finalized schemas the agent surface consumes.</p>
+<p><code>continuation</code> is present iff the crawl paused at a <code>maxBatchBytes</code>
+boundary; agents resume by calling <code>crawl(db, { continuation }, sessions)</code>.
+<code>complete</code> is true iff the crawl finished — equivalent to
+<code>continuation === undefined</code> but more readable at call sites.</p>
+<p>Counter fields (<code>listOps</code>, <code>readOps</code>) are <em>cumulative</em> across batches:
+a paused crawl returns the running total so the agent’s cost-reporting
+doesn’t have to do the bookkeeping.</p>
+<h4 id="extends-1">Extends</h4>
+<ul>
+<li><a href="#crawlresult"><code>CrawlResult</code></a></li>
+</ul>
+<h4 id="properties-18">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="complete-1"></a> <code>complete</code></td><td align="left"><code>boolean</code></td><td align="left">True iff the crawl completed (no continuation pending).</td></tr><tr><td align="left"><a id="continuation-2"></a> <code>continuation?</code></td><td align="left"><code>string</code></td><td align="left">Opaque resume handle (only present when paused).</td></tr><tr><td align="left"><a id="discovered-1"></a> <code>discovered</code></td><td align="left"><code>Map</code>&#x3C;<code>string</code>, <a href="#discoveredcollection"><code>DiscoveredCollection</code></a>></td><td align="left">-</td></tr><tr><td align="left"><a id="dryruncostestimate-2"></a> <code>dryRunCostEstimate?</code></td><td align="left"><a href="#dryruncostestimate-1"><code>DryRunCostEstimate</code></a></td><td align="left">Present iff the crawl was a <code>dryRun: true</code> preview. Heuristic projection of what a full crawl would cost; see <a href="#dryrun">CrawlOptions.dryRun</a>.</td></tr><tr><td align="left"><a id="events-2"></a> <code>events</code></td><td align="left"><a href="#discoverevent"><code>DiscoverEvent</code></a>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="finalizedschemas"></a> <code>finalizedSchemas</code></td><td align="left"><code>Map</code>&#x3C;<code>string</code>, <a href="#collectionschema"><code>CollectionSchema</code></a>></td><td align="left">-</td></tr><tr><td align="left"><a id="listops-2"></a> <code>listOps</code></td><td align="left"><code>number</code></td><td align="left">Total <code>listCollections</code> + <code>listDocuments</code> calls — feeds cost reporting.</td></tr><tr><td align="left"><a id="readops-1"></a> <code>readOps</code></td><td align="left"><code>number</code></td><td align="left"><code>.get()</code> calls issued during sampling — feeds cost reporting.</td></tr></tbody></table></div>
+<hr>
+<p><a id="persistedcrawlstate"></a></p>
+<h3 id="persistedcrawlstate">PersistedCrawlState</h3>
+<p>JSON-serializable snapshot of an in-progress crawl. Stored in the
+session between batches. Refs (CollectionRef/DocumentRef) carry
+methods so they can’t be persisted directly — we serialize their
+paths and reconstruct via <code>db.collection(path)</code> / <code>db.doc(path)</code> on
+resume.</p>
+<p>Phase invariants:</p>
+<ul>
+<li><code>structure</code> phase: <code>frontierPaths</code> may be non-empty; <code>samplingQueue</code>
+is empty.</li>
+<li><code>sampling</code> phase: <code>frontierPaths</code> is empty; <code>samplingQueue</code> lists
+the templatePaths still pending. Existing entries in
+<code>finalizedSchemas</code> are immutable across the rest of the crawl.</li>
+</ul>
+<h4 id="properties-19">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="currentdepth"></a> <code>currentDepth</code></td><td align="left"><code>number</code></td><td align="left">Layer index after the last completed structure pass.</td></tr><tr><td align="left"><a id="discovered-2"></a> <code>discovered</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <a href="#persisteddiscoveredcollection"><code>PersistedDiscoveredCollection</code></a>></td><td align="left">Discovered map serialized — all paths only, refs reconstructed on resume.</td></tr><tr><td align="left"><a id="finalizedschemas-1"></a> <code>finalizedSchemas</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <a href="#collectionschema"><code>CollectionSchema</code></a>></td><td align="left">Per-templatePath finalized schemas — immutable once set.</td></tr><tr><td align="left"><a id="frontierpaths"></a> <code>frontierPaths</code></td><td align="left"><code>string</code>[]</td><td align="left">Concrete collection paths to expand in the next structure layer.</td></tr><tr><td align="left"><a id="listops-3"></a> <code>listOps</code></td><td align="left"><code>number</code></td><td align="left">Cumulative cost counters across batches.</td></tr><tr><td align="left"><a id="maxdepth-1"></a> <code>maxDepth</code></td><td align="left"><code>number</code></td><td align="left">Crawl options carried so resume preserves caps the agent set.</td></tr><tr><td align="left"><a id="phase"></a> <code>phase</code></td><td align="left"><code>"structure"</code> | <code>"sampling"</code></td><td align="left">-</td></tr><tr><td align="left"><a id="readops-2"></a> <code>readOps</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="samplingqueue"></a> <code>samplingQueue</code></td><td align="left"><code>string</code>[]</td><td align="left">TemplatePaths still to sample. Drained left-to-right.</td></tr></tbody></table></div>
+<hr>
+<p><a id="persisteddiscoveredcollection"></a></p>
+<h3 id="persisteddiscoveredcollection">PersistedDiscoveredCollection</h3>
+<p>Persisted shape of a <code>DiscoveredCollection</code> (refs → paths).</p>
+<h4 id="properties-20">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="depth-1"></a> <code>depth</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><a id="docrefpaths"></a> <code>docRefPaths</code></td><td align="left"><code>string</code>[]</td></tr><tr><td align="left"><a id="examplepath-2"></a> <code>examplePath</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="refpaths"></a> <code>refPaths</code></td><td align="left"><code>string</code>[]</td></tr><tr><td align="left"><a id="templatepath-3"></a> <code>templatePath</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="sessionerror"></a></p>
+<h3 id="sessionerror">SessionError</h3>
+<h4 id="properties-21">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="code"></a> <code>code</code></td><td align="left"><a href="#sessionerrorcode-1"><code>SessionErrorCode</code></a></td></tr><tr><td align="left"><a id="message"></a> <code>message</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="recoveryhint"></a> <code>recoveryHint</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="sessionrecord"></a></p>
+<h3 id="sessionrecord">SessionRecord</h3>
+<p>A live session record. <code>state</code> is opaque to the store — Item 4.2 will
+instantiate <code>SessionStore</code> with the concrete crawler-state type.</p>
+<h4 id="type-parameters-1">Type Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Type Parameter</th></tr></thead><tbody><tr><td align="left"><code>TState</code></td></tr></tbody></table></div>
+<h4 id="properties-22">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="bytes"></a> <code>bytes</code></td><td align="left"><code>public</code></td><td align="left"><code>number</code></td><td align="left">Caller-reported payload size for byte-cap enforcement.</td></tr><tr><td align="left"><a id="createdat"></a> <code>createdAt</code></td><td align="left"><code>readonly</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="id-2"></a> <code>id</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td><td align="left">Raw ULID — internal id; not the token surfaced to agents.</td></tr><tr><td align="left"><a id="lastaccessedat"></a> <code>lastAccessedAt</code></td><td align="left"><code>public</code></td><td align="left"><code>number</code></td><td align="left">Last get/update; drives both LRU eviction and TTL.</td></tr><tr><td align="left"><a id="state"></a> <code>state</code></td><td align="left"><code>public</code></td><td align="left"><code>TState</code></td><td align="left">-</td></tr><tr><td align="left"><a id="token"></a> <code>token</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td><td align="left">Opaque continuation handle: <code>disc_&#x3C;base64url-ulid></code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="sessionstoreoptions"></a></p>
+<h3 id="sessionstoreoptions">SessionStoreOptions</h3>
+<h4 id="properties-23">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="evictionlogsize"></a> <code>evictionLogSize?</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="maxsessionbytes"></a> <code>maxSessionBytes?</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="maxsessions"></a> <code>maxSessions?</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="now"></a> <code>now?</code></td><td align="left">() => <code>number</code></td><td align="left">Test seam — defaults to <code>Date.now</code>.</td></tr><tr><td align="left"><a id="randombytes"></a> <code>randomBytes?</code></td><td align="left">(<code>n</code>: <code>number</code>) => <code>Uint8Array</code></td><td align="left">Test seam — defaults to <code>crypto.randomBytes</code>.</td></tr><tr><td align="left"><a id="ttlms"></a> <code>ttlMs?</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="wiredocumentsnapshot"></a></p>
+<h3 id="wiredocumentsnapshot">WireDocumentSnapshot</h3>
+<p>Minimal document snapshot shape needed for wire-type inference.</p>
+<h4 id="properties-24">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="ref-1"></a> <code>ref?</code></td><td align="left">{ <code>path?</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>ref.path?</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h2 id="type-aliases">Type Aliases</h2>
+<p><a id="discoverevent"></a></p>
+<h3 id="discoverevent">DiscoverEvent</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">type</span><span style="color:#E5C07B"> DiscoverEvent</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  depth</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">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"collection_discovered"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  parentPath</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:#E06C75">  templatePath</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>
+<span class="line"><span style="color:#E06C75">  changes</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">SchemaChange</span><span style="color:#ABB2BF">[];</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"schema_updated"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  templatePath</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>
+<span class="line"><span style="color:#E06C75">  declaredAt</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF"> | </span><span style="color:#E5C07B">null</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"sampling_complete"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  samplesSeen</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">  samplingComplete</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">SamplingComplete</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  templatePath</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>
+<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:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"error"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  message</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">  templatePath</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>Event stream emitted by <code>firestore_discover_paths</code>. Frozen enum per
+Phase 3.3 lock. Order within a batch is meaningful — agents may rely on
+<code>collection_discovered</code> arriving before <code>schema_updated</code> for the same path.</p>
+<hr>
+<p><a id="examplevalue"></a></p>
+<h3 id="examplevalue">ExampleValue</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">type</span><span style="color:#E5C07B"> ExampleValue</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#E5C07B">string</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#E5C07B">number</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#E5C07B">boolean</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#E5C07B">null</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#E5C07B">ExampleValue</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 style="color:#E06C75;font-style:italic">k</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">]: </span><span style="color:#E5C07B">ExampleValue</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>A representative observed value, JSON-safe.</p>
+<hr>
+<p><a id="fieldpath"></a></p>
+<h3 id="fieldpath">FieldPath</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">type</span><span style="color:#E5C07B"> FieldPath</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> ReadonlyArray</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"[]"</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Path within a doc to a field. <code>'[]'</code> segment denotes array element scope,
+used for nested-array/map descriptors.</p>
+<hr>
+<p><a id="fieldtype"></a></p>
+<h3 id="fieldtype">FieldType</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">type</span><span style="color:#E5C07B"> FieldType</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"scalar"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FirestoreScalarType</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>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"reference"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  targetCollection</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>
+<span class="line"><span style="color:#E06C75">  elementTypes</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">[];</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"array"</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>
+<span class="line"><span style="color:#E06C75">  fields</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">FieldDescriptor</span><span style="color:#ABB2BF">>;</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"map"</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>
+<span class="line"><span style="color:#E06C75">  dimension</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"mixed"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"vector"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>One observed type for a field. Vector kept distinct from map per Phase 1.2
+vector-sentinel lock; reference target is the <strong>template-form full path</strong>
+per Phase 3.1 lock (<code>users/{userId}/posts</code>, not <code>posts</code>).</p>
+<hr>
+<p><a id="firestorescalartype"></a></p>
+<h3 id="firestorescalartype">FirestoreScalarType</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">type</span><span style="color:#E5C07B"> FirestoreScalarType</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"null"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"boolean"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"integer"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"double"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"timestamp"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"string"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"bytes"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"geopoint"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Firestore scalar wire types. Matches the discriminator emitted by
+<code>_fieldsProto.&#x3C;field>.valueType</code> (Phase 0.1 lock).</p>
+<p><code>null</code> is represented as a scalar so descriptors can carry a single union
+shape; the merge layer separately tracks <code>nullable</code> per descriptor.</p>
+<hr>
+<p><a id="reservedfieldreason"></a></p>
+<h3 id="reservedfieldreason">ReservedFieldReason</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">type</span><span style="color:#E5C07B"> ReservedFieldReason</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"firestore_reserved_name"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"dotted_field_name"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"numeric_field_name"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"double_underscore_wrap"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Why a field name is flagged reserved per 0.B.</p>
+<hr>
+<p><a id="samplingcomplete-1"></a></p>
+<h3 id="samplingcomplete">SamplingComplete</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">type</span><span style="color:#E5C07B"> SamplingComplete</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"converged_via_stable"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"converged_via_exhausted"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"converged_via_max"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"sampling_open"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>4-state classification for sampling termination per Phase 2.2 lock.</p>
+<ul>
+<li><code>converged_via_stable</code>: hit <code>stopOnStable</code> consecutive no-change docs.
+Schema is <em>probably</em> complete — known false-negative is mid-stream drift
+later than <code>stopOnStable</code> docs into the stable region (out of scope per
+Phase 2.1 lock; deferred to a future <code>firestore_re_crawl</code>).</li>
+<li><code>converged_via_exhausted</code>: iterator returned empty before <code>maxSamples</code>.
+Schema is <em>provably</em> complete — we read every doc.</li>
+<li><code>converged_via_max</code>: hit <code>maxSamples</code> cap without converging. Schema may
+be incomplete; agent should treat with caution.</li>
+<li><code>sampling_open</code>: crawl interrupted (continuation boundary). Resume with
+the returned continuation handle to keep sampling.</li>
+</ul>
+<hr>
+<p><a id="schemachange"></a></p>
+<h3 id="schemachange">SchemaChange</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">type</span><span style="color:#E5C07B"> SchemaChange</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"field_added"</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">FieldPath</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldType</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>
+<span class="line"><span style="color:#E06C75">  addedType</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"type_expanded"</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">FieldPath</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>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"presence_changed"</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">FieldPath</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  presenceSeen</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">  presenceTotal</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</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>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"enum_added"</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">FieldPath</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  values</span><span style="color:#ABB2BF">: (</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF"> | </span><span style="color:#E5C07B">number</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>
+<span class="line"><span style="color:#E06C75">  addedValue</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</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">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"enum_widened"</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">FieldPath</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>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"enum_dropped"</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">FieldPath</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  reason</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"over_threshold"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"type_widened"</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>
+<span class="line"><span style="color:#E06C75">  addedDimension</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">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"vector_dim_drift"</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">FieldPath</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>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"became_nullable"</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">FieldPath</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>Frozen <code>SchemaChange</code> enum per Phase 5 implementation plan lock. Emitted
+by the merge layer; carried in <code>schema_updated</code> events.</p>
+<p>Renamed from v1 scope’s <code>ChangeReason</code> to match the agent-facing terminology
+in the validation plan’s event-model lock.</p>
+<hr>
+<p><a id="sessionerrorcode-1"></a></p>
+<h3 id="sessionerrorcode">SessionErrorCode</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">type</span><span style="color:#E5C07B"> SessionErrorCode</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"SESSION_EXPIRED"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"SESSION_EVICTED"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"SESSION_PAYLOAD_TOO_LARGE"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"SESSION_MALFORMED_TOKEN"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="sessionresult"></a></p>
+<h3 id="sessionresult">SessionResult</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">type</span><span style="color:#E5C07B"> SessionResult</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">T</span><span style="color:#ABB2BF">> </span><span style="color:#56B6C2">=</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  ok</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">true</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">T</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>
+<span class="line"><span style="color:#E06C75">  error</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">SessionError</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  ok</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">false</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>Discriminated-union result so callers don’t have to try/catch.</p>
+<h4 id="type-parameters-2">Type Parameters</h4>
+<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>
+<hr>
+<p><a id="wirevalue"></a></p>
+<h3 id="wirevalue">WireValue</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">type</span><span style="color:#E5C07B"> WireValue</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> any</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h2 id="variables">Variables</h2>
+<p><a id="default_enum_threshold"></a></p>
+<h3 id="default_enum_threshold">DEFAULT_ENUM_THRESHOLD</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">const</span><span style="color:#E5C07B"> DEFAULT_ENUM_THRESHOLD</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">10</span><span style="color:#56B6C2"> =</span><span style="color:#D19A66"> 10</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Default enum-candidate distinct-value cap (Phase 3.2 lock).</p>
+<hr>
+<p><a id="default_max_session_bytes"></a></p>
+<h3 id="default_max_session_bytes">DEFAULT_MAX_SESSION_BYTES</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">const</span><span style="color:#E5C07B"> DEFAULT_MAX_SESSION_BYTES</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="default_max_sessions"></a></p>
+<h3 id="default_max_sessions">DEFAULT_MAX_SESSIONS</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">const</span><span style="color:#E5C07B"> DEFAULT_MAX_SESSIONS</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">8</span><span style="color:#56B6C2"> =</span><span style="color:#D19A66"> 8</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="default_ttl_ms"></a></p>
+<h3 id="default_ttl_ms">DEFAULT_TTL_MS</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">const</span><span style="color:#E5C07B"> DEFAULT_TTL_MS</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h2 id="functions">Functions</h2>
+<p><a id="classifyfieldname"></a></p>
+<h3 id="classifyfieldname">classifyFieldName()</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"> classifyFieldName</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">name</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">ReservedFieldReason</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Classify a field name. Returns undefined for normal names, or a
+specific ReservedFieldReason for names that codegen must skip/sanitize.</p>
+<p>Rules ordered by specificity (most specific first):</p>
+<ul>
+<li>exact <code>__name__</code> etc. → firestore_reserved_name</li>
+<li>contains ’.’          → dotted_field_name (breaks dot-path access)</li>
+<li>pure-numeric          → numeric_field_name (looks like array index)</li>
+<li><strong>foo</strong>               → double_underscore_wrap (sentinel collision)</li>
+</ul>
+<h4 id="parameters-17">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>name</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-29">Returns</h4>
+<p><a href="#reservedfieldreason"><code>ReservedFieldReason</code></a></p>
+<hr>
+<p><a id="crawl"></a></p>
+<h3 id="crawl">crawl()</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"> crawl</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   db</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">CrawlerFirestore</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">CrawlOptions</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">sessions</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">SessionStore</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">PersistedCrawlState</span><span style="color:#ABB2BF">>): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">FullCrawlResult</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Full crawl: discover structure, then sample up to <code>maxSamples</code> docs per
+discovered templatePath and feed them through the merge layer. Emits
+<code>schema_updated</code> events for every non-empty merge and <code>sampling_complete</code>
+once per templatePath.</p>
+<p><strong>Pause/resume (Item 4.2).</strong> When a <code>SessionStore</code> is supplied, the
+crawler measures the persisted-state size at two pause boundaries:</p>
+<ol>
+<li>End of every BFS layer in the structure phase</li>
+<li>End of every templatePath in the sampling phase</li>
+</ol>
+<p>If the persisted state exceeds <code>maxBatchBytes</code> (default 1 MB), the
+crawler persists state and returns a <code>continuation</code> token. The agent
+resumes by passing <code>{ continuation }</code> on the next call. Counters
+(<code>listOps</code>, <code>readOps</code>) are cumulative across batches; events are
+per-batch only (agents accumulate them themselves).</p>
+<p>Without a <code>SessionStore</code>, the crawler runs to completion regardless of
+size — single-call mode is unchanged.</p>
+<p><strong>Continuation lifecycle.</strong> Continuation handles are minted/validated by
+the supplied <code>SessionStore</code> (see <code>discover/session.ts</code>). Malformed,
+expired, or evicted tokens surface as a single <code>error</code> event and an
+otherwise-empty result — agents can re-issue without continuation
+per the recovery hint.</p>
+<h4 id="parameters-18">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>db</code></td><td align="left"><a href="#crawlerfirestore"><code>CrawlerFirestore</code></a></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#crawloptions"><code>CrawlOptions</code></a></td></tr><tr><td align="left"><code>sessions?</code></td><td align="left"><a href="#sessionstore"><code>SessionStore</code></a>&#x3C;<a href="#persistedcrawlstate"><code>PersistedCrawlState</code></a>></td></tr></tbody></table></div>
+<h4 id="returns-30">Returns</h4>
+<p><code>Promise</code>&#x3C;<a href="#fullcrawlresult"><code>FullCrawlResult</code></a>></p>
+<hr>
+<p><a id="crawlstructure"></a></p>
+<h3 id="crawlstructure">crawlStructure()</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"> crawlStructure</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">db</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">CrawlerFirestore</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">CrawlOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">CrawlResult</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Walk the Firestore tree breadth-first. Each layer issues its
+<code>listDocuments</code> + per-doc <code>listCollections</code> calls in parallel under a
+shared concurrency cap.</p>
+<p>Returns once every reachable collection (within <code>maxDepth</code>) is recorded.
+The returned <code>discovered</code> map is keyed by templatePath; <code>events</code> is the
+ordered event log emitted during the walk (currently only
+<code>collection_discovered</code>).</p>
+<h4 id="parameters-19">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>db</code></td><td align="left"><a href="#crawlerfirestore"><code>CrawlerFirestore</code></a></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#crawloptions"><code>CrawlOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-31">Returns</h4>
+<p><code>Promise</code>&#x3C;<a href="#crawlresult"><code>CrawlResult</code></a>></p>
+<hr>
+<p><a id="createfirestorediscovertools"></a></p>
+<h3 id="createfirestorediscovertools">createFirestoreDiscoverTools()</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"> createFirestoreDiscoverTools</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">deps</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FirestoreDiscoverToolDeps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">ToolHandler</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">unknown</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>deps</code></td><td align="left"><a href="#firestorediscovertooldeps"><code>FirestoreDiscoverToolDeps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-32">Returns</h4>
+<p><code>ToolHandler</code>&#x3C;<code>unknown</code>, <code>unknown</code>>[]</p>
+<hr>
+<p><a id="decodetoken"></a></p>
+<h3 id="decodetoken">decodeToken()</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"> decodeToken</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">token</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">  id</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>Decode a <code>disc_&#x3C;base64url></code> token. Returns <code>null</code> on any malformation
+— caller maps null to <code>SESSION_MALFORMED_TOKEN</code>.</p>
+<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>token</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-33">Returns</h4>
+<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>
+<span class="line"><span style="color:#E06C75">  id</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></code></pre>
+<h5 id="id">id</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">id</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="emptyschema"></a></p>
+<h3 id="emptyschema">emptySchema()</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"> emptySchema</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">FieldSchema</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h4 id="returns-34">Returns</h4>
+<p><a href="#fieldschema"><code>FieldSchema</code></a></p>
+<hr>
+<p><a id="encodetoken"></a></p>
+<h3 id="encodetoken">encodeToken()</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"> encodeToken</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">ulidBytes</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Uint8Array</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Encode a 16-byte ULID into a <code>disc_&#x3C;base64url></code> token. Internal — used
+by <code>SessionStore.create</code>.</p>
+<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>ulidBytes</code></td><td align="left"><code>Uint8Array</code></td></tr></tbody></table></div>
+<h4 id="returns-35">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="fieldtypekey"></a></p>
+<h3 id="fieldtypekey">fieldTypeKey()</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"> fieldTypeKey</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">t</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Stable key for FieldType used in dedup. NaN/±Infinity all collapse to
+<code>s:double</code> so no special handling needed (Phase 1.2 lock).</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>t</code></td><td align="left"><a href="#fieldtype"><code>FieldType</code></a></td></tr></tbody></table></div>
+<h4 id="returns-36">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="findcollectiongroup"></a></p>
+<h3 id="findcollectiongroup">findCollectionGroup()</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"> findCollectionGroup</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   db</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">CollectionGroupCapableFirestore</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   collectionId</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;font-style:italic">options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FindCollectionGroupOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">FindCollectionGroupResult</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Find every collection-group host of a given collection ID.</p>
+<p>One read per returned doc — cost is bounded by <code>limit</code> (default 100).
+Returns the hosts in template-path form (e.g. <code>users/{userId}/posts</code>)
+with the per-host sample doc count.</p>
+<p>Throws on Admin SDK errors (network / permission). The tool is
+standalone — no session, no continuation, no events — so error
+propagation is straightforward.</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>db</code></td><td align="left"><a href="#collectiongroupcapablefirestore"><code>CollectionGroupCapableFirestore</code></a></td></tr><tr><td align="left"><code>collectionId</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#findcollectiongroupoptions"><code>FindCollectionGroupOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-37">Returns</h4>
+<p><code>Promise</code>&#x3C;<a href="#findcollectiongroupresult"><code>FindCollectionGroupResult</code></a>></p>
+<hr>
+<p><a id="infertemplatevariable"></a></p>
+<h3 id="infertemplatevariable">inferTemplateVariable()</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"> inferTemplateVariable</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">collectionId</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Convert a collection ID to the conventional template-variable name a
+Firestore rules author would write for its docs. Strips a trailing
+snake/dot-cased prefix word so <code>ttt_lobbies</code> → <code>lobbyId</code> (not
+<code>ttt_lobbieId</code>).</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>collectionId</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-38">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="mergedescriptorwithobservation"></a></p>
+<h3 id="mergedescriptorwithobservation">mergeDescriptorWithObservation()</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"> mergeDescriptorWithObservation</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   prev</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldDescriptor</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   observation</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldObservation</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"absent"</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   newTotal</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;font-style:italic">   path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldPath</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">MergeFieldResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Merge a single field observation into an existing descriptor.
+<code>observation === 'absent'</code> means the field was missing from the doc.
+<code>newTotal</code> is the doc count after this observation.</p>
+<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>prev</code></td><td align="left"><a href="#fielddescriptor"><code>FieldDescriptor</code></a></td></tr><tr><td align="left"><code>observation</code></td><td align="left"><a href="#fieldobservation"><code>FieldObservation</code></a> | <code>"absent"</code></td></tr><tr><td align="left"><code>newTotal</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><code>path</code></td><td align="left"><a href="#fieldpath"><code>FieldPath</code></a></td></tr></tbody></table></div>
+<h4 id="returns-39">Returns</h4>
+<p><code>MergeFieldResult</code></p>
+<hr>
+<p><a id="mergedoc"></a></p>
+<h3 id="mergedoc">mergeDoc()</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"> mergeDoc</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">prev</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldSchema</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">doc</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">FieldObservation</span><span style="color:#ABB2BF">>): {</span></span>
+<span class="line"><span style="color:#E06C75">  changes</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">SchemaChange</span><span style="color:#ABB2BF">[];</span></span>
+<span class="line"><span style="color:#E06C75">  next</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldSchema</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>Merge a single document’s typed field observations into a collection-level
+schema. Returns the next schema and the changes emitted.</p>
+<p>The wire layer (<code>wire.ts</code>) is responsible for converting Firestore wire
+values into the <code>Record&#x3C;string, FieldObservation></code> shape expected here.</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>prev</code></td><td align="left"><a href="#fieldschema"><code>FieldSchema</code></a></td></tr><tr><td align="left"><code>doc</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <a href="#fieldobservation"><code>FieldObservation</code></a>></td></tr></tbody></table></div>
+<h4 id="returns-40">Returns</h4>
+<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>
+<span class="line"><span style="color:#E06C75">  changes</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">SchemaChange</span><span style="color:#ABB2BF">[];</span></span>
+<span class="line"><span style="color:#E06C75">  next</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">FieldSchema</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="changes">changes</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">changes</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">SchemaChange</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<h5 id="next">next</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">next</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">FieldSchema</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="runconvergence"></a></p>
+<h3 id="runconvergence">runConvergence()</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"> runConvergence</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">docs</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Iterable</span><span style="color:#ABB2BF">&#x3C;</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">FieldObservation</span><span style="color:#ABB2BF">>>, </span><span style="color:#E06C75;font-style:italic">stopOnStable</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">ConvergenceResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Stream-driven convergence runner. Used by the production crawler’s
+sampling loop and by Phase 2.x tests that replay corpus snapshots.</p>
+<p><code>stopOnStable</code> is the optimistic early-exit signal (Phase 2.1 lock — must
+be paired with a <code>maxSamples</code> hard cap in the crawler, not here).</p>
+<h4 id="parameters-28">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>docs</code></td><td align="left"><code>Iterable</code>&#x3C;<code>Record</code>&#x3C;<code>string</code>, <a href="#fieldobservation"><code>FieldObservation</code></a>>></td></tr><tr><td align="left"><code>stopOnStable</code></td><td align="left"><code>number</code></td></tr></tbody></table></div>
+<h4 id="returns-41">Returns</h4>
+<p><a href="#convergenceresult"><code>ConvergenceResult</code></a></p>
+<hr>
+<p><a id="runwithlimit"></a></p>
+<h3 id="runwithlimit">runWithLimit()</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"> runWithLimit</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">T</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">R</span><span style="color:#ABB2BF">>(</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   items</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#E5C07B"> T</span><span style="color:#ABB2BF">[],</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   limit</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#61AFEF">producer</span><span style="color:#ABB2BF">: (</span><span style="color:#E06C75;font-style:italic">item</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">T</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">index</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</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">R</span><span style="color:#ABB2BF">>): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">R</span><span style="color:#ABB2BF">[]>;</span></span></code></pre>
+<p>Run <code>items</code> through <code>producer</code> concurrently, capping in-flight calls
+at <code>limit</code>. Returns results in input order (same shape as
+<code>Promise.all(items.map(producer))</code> — but bounded).</p>
+<p><code>producer</code> may throw; the rejection propagates after in-flight work
+settles. Other items continue running so the rejection isn’t masked
+by a Promise.all-style fast-fail leaving zombie pending work.</p>
+<p>Implementation detail: uses an internal <code>Semaphore(limit)</code>; callers
+who need to share a permit pool across multiple <code>runWithLimit</code> calls
+(e.g. crawler global RPC cap) should use the <code>Semaphore</code> class
+directly via <code>acquire</code>/<code>release</code>.</p>
+<h4 id="type-parameters-3">Type Parameters</h4>
+<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><tr><td align="left"><code>R</code></td></tr></tbody></table></div>
+<h4 id="parameters-29">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>items</code></td><td align="left">readonly <code>T</code>[]</td></tr><tr><td align="left"><code>limit</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><code>producer</code></td><td align="left">(<code>item</code>: <code>T</code>, <code>index</code>: <code>number</code>) => <code>Promise</code>&#x3C;<code>R</code>></td></tr></tbody></table></div>
+<h4 id="returns-42">Returns</h4>
+<p><code>Promise</code>&#x3C;<code>R</code>[]></p>
+<hr>
+<p><a id="snapshottoobservations"></a></p>
+<h3 id="snapshottoobservations">snapshotToObservations()</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"> snapshotToObservations</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">snap</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">WireDocumentSnapshot</span><span style="color:#ABB2BF">): {</span></span>
+<span class="line"><span style="color:#E06C75">  observations</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">FieldObservation</span><span style="color:#ABB2BF">>;</span></span>
+<span class="line"><span style="color:#E06C75">  reservedNames</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">ReservedFieldReason</span><span style="color:#ABB2BF">>;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>Convert a Firestore document snapshot into a FieldObservation map.
+Detects reserved field names per 0.B — they appear in the output but
+the descriptor returned by the merge layer carries <code>reservedReason</code>
+so codegen can skip them.</p>
+<p>Throws <code>WireProtoUnavailableError</code> if <code>_fieldsProto</code> is absent (0.A
+fail-loud contract). Empty docs (proto present but zero keys) return
+an empty record without throwing.</p>
+<h4 id="parameters-30">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>snap</code></td><td align="left"><a href="#wiredocumentsnapshot"><code>WireDocumentSnapshot</code></a></td></tr></tbody></table></div>
+<h4 id="returns-43">Returns</h4>
+<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>
+<span class="line"><span style="color:#E06C75">  observations</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">FieldObservation</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  reservedNames</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">ReservedFieldReason</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="observations">observations</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">observations</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">FieldObservation</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="reservednames">reservedNames</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">reservedNames</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">ReservedFieldReason</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="totemplatepath"></a></p>
+<h3 id="totemplatepath">toTemplatePath()</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"> toTemplatePath</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">concretePath</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Map a concrete collection path to its template-path form per Phase 3.1
+lock. Doc-id segments become <code>{singular(parentColl)Id}</code> so the result
+matches Firestore rules’ <code>path.raw</code> segments under typical naming
+conventions (TTT corpus verified: <code>ttt_lobbies</code> → <code>{lobbyId}</code>).</p>
+<p>Inputs alternate <code>coll/doc/coll/doc/.../coll</code>. Length is always odd (a
+collection path ends on a collection segment).</p>
+<p>Heuristic — agents needing strict alignment with rules should normalize
+both sides before joining. See Risk 6 in the implementation plan.</p>
+<p>Examples:
+<code>users</code> → <code>users</code>
+<code>users/uid_1/posts</code> → <code>users/{userId}/posts</code>
+<code>ttt_lobbies/abc/games/g1/moves</code> → <code>ttt_lobbies/{lobbyId}/games/{gameId}/moves</code></p>
+<h4 id="parameters-31">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>concretePath</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-44">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="wirevaluetofieldtype"></a></p>
+<h3 id="wirevaluetofieldtype">wireValueToFieldType()</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"> wireValueToFieldType</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">v</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Pure type extraction. Does not extract examples or enum samples — use
+<code>wireValueToObservation</code> for the full observation.</p>
+<h4 id="parameters-32">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>v</code></td><td align="left"><code>any</code></td></tr></tbody></table></div>
+<h4 id="returns-45">Returns</h4>
+<p><a href="#fieldtype"><code>FieldType</code></a></p>
+<hr>
+<p><a id="wirevaluetoobservation"></a></p>
+<h3 id="wirevaluetoobservation">wireValueToObservation()</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"> wireValueToObservation</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">v</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">FieldObservation</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Full observation including JSON-safe example projection and enum sample
+extraction. The merge layer consumes this shape.</p>
+<h4 id="parameters-33">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>v</code></td><td align="left"><code>any</code></td></tr></tbody></table></div>
+<h4 id="returns-46">Returns</h4>
+<p><a href="#fieldobservation"><code>FieldObservation</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="#classes"> Classes </a> <ul> <li data-api-symbol="localenvironmentcrawleradapter"> <a href="#localenvironmentcrawleradapter">LocalEnvironmentCrawlerAdapter</a> </li><li data-api-symbol="semaphore"> <a href="#semaphore">Semaphore</a> </li><li data-api-symbol="sessionstore"> <a href="#sessionstore">SessionStore</a> </li><li data-api-symbol="wireprotounavailableerror"> <a href="#wireprotounavailableerror">WireProtoUnavailableError</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#interfaces"> Interfaces </a> <ul> <li data-api-symbol="collectiongroupcapablefirestore"> <a href="#collectiongroupcapablefirestore">CollectionGroupCapableFirestore</a> </li><li data-api-symbol="collectiongroupquery"> <a href="#collectiongroupquery">CollectionGroupQuery</a> </li><li data-api-symbol="collectiongroupsnapshot"> <a href="#collectiongroupsnapshot">CollectionGroupSnapshot</a> </li><li data-api-symbol="collectionschema"> <a href="#collectionschema">CollectionSchema</a> </li><li data-api-symbol="convergenceresult"> <a href="#convergenceresult">ConvergenceResult</a> </li><li data-api-symbol="crawlercollectionref"> <a href="#crawlercollectionref">CrawlerCollectionRef</a> </li><li data-api-symbol="crawlerdocumentref"> <a href="#crawlerdocumentref">CrawlerDocumentRef</a> </li><li data-api-symbol="crawlerfirestore"> <a href="#crawlerfirestore">CrawlerFirestore</a> </li><li data-api-symbol="crawloptions"> <a href="#crawloptions">CrawlOptions</a> </li><li data-api-symbol="crawlresult"> <a href="#crawlresult">CrawlResult</a> </li><li data-api-symbol="discoveredcollection"> <a href="#discoveredcollection">DiscoveredCollection</a> </li><li data-api-symbol="discoverpathstoolresult"> <a href="#discoverpathstoolresult">DiscoverPathsToolResult</a> </li><li data-api-symbol="dryruncostestimate"> <a href="#dryruncostestimate">DryRunCostEstimate</a> </li><li data-api-symbol="enumcandidate"> <a href="#enumcandidate">EnumCandidate</a> </li><li data-api-symbol="fielddescriptor"> <a href="#fielddescriptor">FieldDescriptor</a> </li><li data-api-symbol="fieldobservation"> <a href="#fieldobservation">FieldObservation</a> </li><li data-api-symbol="fieldschema"> <a href="#fieldschema">FieldSchema</a> </li><li data-api-symbol="findcollectiongrouphost"> <a href="#findcollectiongrouphost">FindCollectionGroupHost</a> </li><li data-api-symbol="findcollectiongroupoptions"> <a href="#findcollectiongroupoptions">FindCollectionGroupOptions</a> </li><li data-api-symbol="findcollectiongroupresult"> <a href="#findcollectiongroupresult">FindCollectionGroupResult</a> </li><li data-api-symbol="firestorediscovertooldeps"> <a href="#firestorediscovertooldeps">FirestoreDiscoverToolDeps</a> </li><li data-api-symbol="fullcrawlresult"> <a href="#fullcrawlresult">FullCrawlResult</a> </li><li data-api-symbol="persistedcrawlstate"> <a href="#persistedcrawlstate">PersistedCrawlState</a> </li><li data-api-symbol="persisteddiscoveredcollection"> <a href="#persisteddiscoveredcollection">PersistedDiscoveredCollection</a> </li><li data-api-symbol="sessionerror"> <a href="#sessionerror">SessionError</a> </li><li data-api-symbol="sessionrecord"> <a href="#sessionrecord">SessionRecord</a> </li><li data-api-symbol="sessionstoreoptions"> <a href="#sessionstoreoptions">SessionStoreOptions</a> </li><li data-api-symbol="wiredocumentsnapshot"> <a href="#wiredocumentsnapshot">WireDocumentSnapshot</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#type-aliases"> Type Aliases </a> <ul> <li data-api-symbol="discoverevent"> <a href="#discoverevent">DiscoverEvent</a> </li><li data-api-symbol="examplevalue"> <a href="#examplevalue">ExampleValue</a> </li><li data-api-symbol="fieldpath"> <a href="#fieldpath">FieldPath</a> </li><li data-api-symbol="fieldtype"> <a href="#fieldtype">FieldType</a> </li><li data-api-symbol="firestorescalartype"> <a href="#firestorescalartype">FirestoreScalarType</a> </li><li data-api-symbol="reservedfieldreason"> <a href="#reservedfieldreason">ReservedFieldReason</a> </li><li data-api-symbol="samplingcomplete"> <a href="#samplingcomplete">SamplingComplete</a> </li><li data-api-symbol="schemachange"> <a href="#schemachange">SchemaChange</a> </li><li data-api-symbol="sessionerrorcode"> <a href="#sessionerrorcode">SessionErrorCode</a> </li><li data-api-symbol="sessionresult"> <a href="#sessionresult">SessionResult</a> </li><li data-api-symbol="wirevalue"> <a href="#wirevalue">WireValue</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#variables"> Variables </a> <ul> <li data-api-symbol="default_enum_threshold"> <a href="#default_enum_threshold">DEFAULT_ENUM_THRESHOLD</a> </li><li data-api-symbol="default_max_session_bytes"> <a href="#default_max_session_bytes">DEFAULT_MAX_SESSION_BYTES</a> </li><li data-api-symbol="default_max_sessions"> <a href="#default_max_sessions">DEFAULT_MAX_SESSIONS</a> </li><li data-api-symbol="default_ttl_ms"> <a href="#default_ttl_ms">DEFAULT_TTL_MS</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="classifyfieldname()"> <a href="#classifyfieldname">classifyFieldName()</a> </li><li data-api-symbol="crawl()"> <a href="#crawl">crawl()</a> </li><li data-api-symbol="crawlstructure()"> <a href="#crawlstructure">crawlStructure()</a> </li><li data-api-symbol="createfirestorediscovertools()"> <a href="#createfirestorediscovertools">createFirestoreDiscoverTools()</a> </li><li data-api-symbol="decodetoken()"> <a href="#decodetoken">decodeToken()</a> </li><li data-api-symbol="emptyschema()"> <a href="#emptyschema">emptySchema()</a> </li><li data-api-symbol="encodetoken()"> <a href="#encodetoken">encodeToken()</a> </li><li data-api-symbol="fieldtypekey()"> <a href="#fieldtypekey">fieldTypeKey()</a> </li><li data-api-symbol="findcollectiongroup()"> <a href="#findcollectiongroup">findCollectionGroup()</a> </li><li data-api-symbol="infertemplatevariable()"> <a href="#infertemplatevariable">inferTemplateVariable()</a> </li><li data-api-symbol="mergedescriptorwithobservation()"> <a href="#mergedescriptorwithobservation">mergeDescriptorWithObservation()</a> </li><li data-api-symbol="mergedoc()"> <a href="#mergedoc">mergeDoc()</a> </li><li data-api-symbol="runconvergence()"> <a href="#runconvergence">runConvergence()</a> </li><li data-api-symbol="runwithlimit()"> <a href="#runwithlimit">runWithLimit()</a> </li><li data-api-symbol="snapshottoobservations()"> <a href="#snapshottoobservations">snapshotToObservations()</a> </li><li data-api-symbol="totemplatepath()"> <a href="#totemplatepath">toTemplatePath()</a> </li><li data-api-symbol="wirevaluetofieldtype()"> <a href="#wirevaluetofieldtype">wireValueToFieldType()</a> </li><li data-api-symbol="wirevaluetoobservation()"> <a href="#wirevaluetoobservation">wireValueToObservation()</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>