@maximem/synap-js-sdk 0.4.7 → 0.4.8

package/dist/chunk-ODVOQOSO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/behavior/anticipation.json","../src/behavior/contract.ts","../src/cache/bm25.ts","../src/context/anticipation-cache.ts"],"sourcesContent":["{\n  \"$comment\": \"SOURCE OF TRUTH for anticipation-cache behavior, shared by the Python and JS/TS SDKs. Do not duplicate these values into either SDK's source. See ../README.md. Regexes are restricted to the intersection of Python 're' and ECMAScript; both SDKs have a parity test.\",\n  \"version\": 1,\n  \"recall_bypass\": {\n    \"note\": \"WS4 of the playground query-hygiene plan. A recall-shaped question never serves from the anticipation cache. Asymmetric cost is why: a stale false-hit makes the agent answer 'I don't see that' while the store holds the fact (the BZQR6J cross-session failure), whereas bypassing costs only cold-fetch latency on a turn where the user already expects a lookup. Stem coverage cannot gate this \\u2014 false hits were measured at coverage=1.00. Ties break toward INCLUDING a pattern.\",\n    \"env_flag\": \"SYNAP_SDK_CACHE_RECALL_BYPASS\",\n    \"default\": false,\n    \"patterns\": [\n      {\n        \"pattern\": \"\\\\bremind me\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4, playground query-hygiene plan).\"\n      },\n      {\n        \"pattern\": \"\\\\bon file\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\b(your|my|the) records\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\bdo you (have|know|remember|recall|see)\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\bwhat (do|did) (i|you) (say|tell|mention|have)\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\bwhat('s| is) my\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\bwhere (am i|do i live)\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\bhow long have i\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\bwhich of my\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\bwhat .{0,40}\\\\b(again|earlier|last time|previously|yesterday)\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4). 'again' alone is deliberately NOT a marker: 'book me a ride again' is a task query, not a recall query.\"\n      },\n      {\n        \"pattern\": \"\\\\bwill you use to (contact|reach|notify)\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"Original set (WS4).\"\n      },\n      {\n        \"pattern\": \"\\\\b(confirm|verify|double.?check)\\\\b.{0,40}\\\\bmy\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"2026-07-16 eval register issue #11: 'can you confirm my email address?' served a stale bundle. Also catches 'confirm my booking' \\u2014 an intentional over-match, costing one cloud fetch.\"\n      },\n      {\n        \"pattern\": \"\\\\b(linked to|associated with|registered (to|on|with)) my\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"2026-07-16 eval register issue #11: 'what name is linked to my Uber account?' served a stale bundle.\"\n      },\n      {\n        \"pattern\": \"\\\\b(best|preferred) way to (reach|contact|update|notify) me\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"2026-07-16 eval register issue #11: 'best way to contact me with updates' served a stale bundle.\"\n      },\n      {\n        \"pattern\": \"\\\\bhow (do|will|can|should) you (reach|contact|notify) me\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"2026-07-16 eval register issue #11, sibling phrasing of the above.\"\n      },\n      {\n        \"pattern\": \"\\\\bwhich .{0,40}\\\\b(are|will) you (going to )?(use|using)\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"2026-07-16 eval register issue #11: 'which email are you going to use?' served a stale bundle.\"\n      },\n      {\n        \"pattern\": \"\\\\bon (my|the) account\\\\b\",\n        \"flags\": \"i\",\n        \"note\": \"2026-07-16 eval register issue #11.\"\n      }\n    ]\n  },\n  \"thresholds\": {\n    \"bm25\": {\n      \"value\": 1.5,\n      \"note\": \"Nominal threshold. The value actually applied is derived per query: max(effective_floor, min(bm25, query_token_scale * len(query_tokens))). Short queries cannot reach the nominal score, so holding them to it would miss every time.\"\n    },\n    \"novel_term\": {\n      \"value\": 0.45,\n      \"note\": \"Fraction of query stems absent from the cached corpus that forces a miss.\"\n    },\n    \"min_corpus_for_novel_gate\": {\n      \"value\": 200,\n      \"note\": \"The novel-term gate is meaningless on a small corpus, where the ratio is dominated by ordinary English word forms. Measured: a fresh playground conversation reaches ~60 stems after the first push and would trip the 0.45 gate on essentially every second-turn query. 200 means the gate engages once a customer has ~3-4 typical bundles cached.\"\n    },\n    \"effective_floor\": {\n      \"value\": 0.6,\n      \"note\": \"Lower bound on the derived per-query threshold. Below this, BM25 stops discriminating.\"\n    },\n    \"query_token_scale\": {\n      \"value\": 0.3,\n      \"note\": \"Scales the threshold down for short queries: 0.3 points of score per query token.\"\n    }\n  },\n  \"bm25\": {\n    \"k1\": 1.5,\n    \"b\": 0.75,\n    \"idf_floor\": 0.5,\n    \"min_token_len\": 2,\n    \"min_stem_len\": 4,\n    \"suffixes\": [\n      \"ences\",\n      \"ances\",\n      \"ation\",\n      \"tion\",\n      \"sion\",\n      \"ence\",\n      \"ance\",\n      \"ness\",\n      \"ment\",\n      \"able\",\n      \"ible\",\n      \"ical\",\n      \"ally\",\n      \"ies\",\n      \"ive\",\n      \"ful\",\n      \"ous\",\n      \"ing\",\n      \"ary\",\n      \"ly\",\n      \"ed\",\n      \"es\",\n      \"s\"\n    ],\n    \"stop_words\": [\n      \"a\",\n      \"about\",\n      \"after\",\n      \"an\",\n      \"and\",\n      \"are\",\n      \"at\",\n      \"be\",\n      \"been\",\n      \"before\",\n      \"being\",\n      \"but\",\n      \"by\",\n      \"can\",\n      \"could\",\n      \"did\",\n      \"do\",\n      \"does\",\n      \"for\",\n      \"from\",\n      \"had\",\n      \"has\",\n      \"have\",\n      \"how\",\n      \"if\",\n      \"in\",\n      \"into\",\n      \"is\",\n      \"it\",\n      \"its\",\n      \"may\",\n      \"might\",\n      \"no\",\n      \"nor\",\n      \"not\",\n      \"of\",\n      \"on\",\n      \"or\",\n      \"over\",\n      \"should\",\n      \"so\",\n      \"than\",\n      \"that\",\n      \"the\",\n      \"then\",\n      \"these\",\n      \"this\",\n      \"those\",\n      \"to\",\n      \"was\",\n      \"were\",\n      \"what\",\n      \"when\",\n      \"where\",\n      \"which\",\n      \"who\",\n      \"whom\",\n      \"why\",\n      \"will\",\n      \"with\",\n      \"would\"\n    ],\n    \"alias_token\": {\n      \"pattern\": \"\\\\[\\\\[([A-Za-z][A-Za-z0-9_]*_[a-z0-9]{12})\\\\]\\\\]\",\n      \"note\": \"An alias label as it appears in text: [[PERSON_PHONE_h2n7v5cx8m0d]]. Kept whole rather than split, because 'person' and 'phone' are boilerplate shared by every label of that field type and would make two different people's memories score alike. Mirrors synap/cloud/shared/tokenizer.py \\u2014 keep the two in step.\"\n    },\n    \"suffix_note\": \"Order matters: longest-first, because _stem returns on first match. Reordering this list silently changes every stem and therefore every BM25 score.\"\n  },\n  \"env_flags\": {\n    \"$comment\": \"Read at CALL time, never at module load. Python does os.environ.get inside the function bodies; JS must do the same or late process.env mutation stops working and the flag looks broken. See gotcha G-S.\",\n    \"SYNAP_SDK_CACHE_RECALL_BYPASS\": {\n      \"default\": false,\n      \"truthy\": [\n        \"true\",\n        \"1\",\n        \"yes\"\n      ]\n    },\n    \"SYNAP_SDK_CACHE_HONOR_TTL_HINT\": {\n      \"default\": false,\n      \"truthy\": [\n        \"true\",\n        \"1\",\n        \"yes\"\n      ],\n      \"note\": \"A bundle's server ttl_hint_seconds may only SHORTEN the global TTL, never extend it.\"\n    },\n    \"SYNAP_SDK_CACHE_INVALIDATE_ON_WRITE\": {\n      \"default\": false,\n      \"truthy\": [\n        \"true\",\n        \"1\",\n        \"yes\"\n      ],\n      \"note\": \"2026-07-16 eval register issue #8: the cloud invalidates its own Redis caches on ingest, but that stops at the process boundary.\"\n    },\n    \"SYNAP_SDK_CACHE_MAX_ENTRY_AGE\": {\n      \"default\": null,\n      \"note\": \"2026-07-16 eval register issue #6: stored_at is a sliding lease renewed on hit, so under steady traffic a pre-update snapshot never expired. Defaults to 2x the sliding TTL; 0 disables.\"\n    },\n    \"SYNAP_SDK_CACHE_COVERAGE_MIN\": {\n      \"default\": null\n    }\n  },\n  \"coverage_gate\": {\n    \"note\": \"Fraction of the query's stems present in the picked items. A bundle can clear the BM25 threshold on one shared token ('account') while lacking the asked-for fact entirely: the false HIT behind the eval's 'forgot the name' failure. ALWAYS computed and reported; ENFORCED only when SYNAP_SDK_CACHE_COVERAGE_MIN is explicitly set, so default behavior is unchanged. When it does fire it must gate BEFORE any side effect, so a rejected lookup leaves cache state untouched.\",\n    \"env_flag\": \"SYNAP_SDK_CACHE_COVERAGE_MIN\",\n    \"default\": null,\n    \"empty_query_coverage\": 1.0\n  },\n  \"telemetry\": {\n    \"rejected_items_cap\": {\n      \"value\": 20,\n      \"note\": \"Rejected items reported per lookup, highest score first, so a large cache cannot bloat the payload.\"\n    },\n    \"content_preview_chars\": 120\n  },\n  \"rung_key\": {\n    \"$comment\": \"SOURCE OF TRUTH for how a scope rung is written on the wire and compared in both SDK anticipation caches. The server stamps a pushed bundle with this string (ContextBundleProto.anticipation_scope_rung) and each SDK builds the same string from the `scope` path its own fetch names; a bundle is servable only when the two agree. Three implementations exist by necessity (server Python, SDK Python, SDK TypeScript) because the producer is not an SDK, so the vectors below are what stops them drifting.\",\n    \"note\": \"Node ids are deliberately not what travels. They are registry surrogates and an SDK in a customer's process has never seen one; a caller names a rung with level keys and its own external ids, so that is the vocabulary the comparison happens in. Level keys are ^[a-z][a-z0-9_]{0,63}$ so they can hold neither separator and only the value needs escaping.\",\n    \"separator\": \"|\",\n    \"assign\": \"=\",\n    \"sort\": \"by level key, ascending, plain codepoint order\",\n    \"escapes\": {\n      \"\\\\\": \"\\\\\\\\\",\n      \"|\": \"\\\\p\",\n      \"=\": \"\\\\e\"\n    },\n    \"escape_order\": \"backslash first. Reversing it makes `a|b` and `a\\\\pb` encode to the same string, which is a false match between two different rungs.\",\n    \"absent\": \"null (an empty proto string on the wire) means the bundle or the request named no rung. Serving requires the two to be EQUAL, so absent matches only absent. That leaves every client without nested scoping byte-identical to today and refuses every genuinely cross-rung serve; the cost of the rule being wrong is a cold fetch, and the cost of a subset rule being wrong is one person's context handed to another.\",\n    \"vectors\": [\n      {\n        \"path\": {},\n        \"key\": null,\n        \"note\": \"no path named\"\n      },\n      {\n        \"path\": {\n          \"customer\": \"acme\"\n        },\n        \"key\": \"customer=acme\"\n      },\n      {\n        \"path\": {\n          \"customer\": \"acme\",\n          \"team\": \"payments\",\n          \"user\": \"dana\"\n        },\n        \"key\": \"customer=acme|team=payments|user=dana\"\n      },\n      {\n        \"path\": {\n          \"user\": \"dana\",\n          \"team\": \"payments\",\n          \"customer\": \"acme\"\n        },\n        \"key\": \"customer=acme|team=payments|user=dana\",\n        \"note\": \"insertion order must not change the key; a dict has whatever order the caller wrote and ladder order is not available here\"\n      },\n      {\n        \"path\": {\n          \"customer\": \"a|b\"\n        },\n        \"key\": \"customer=a\\\\pb\"\n      },\n      {\n        \"path\": {\n          \"customer\": \"a=b\"\n        },\n        \"key\": \"customer=a\\\\eb\"\n      },\n      {\n        \"path\": {\n          \"customer\": \"a\\\\b\"\n        },\n        \"key\": \"customer=a\\\\\\\\b\"\n      },\n      {\n        \"path\": {\n          \"customer\": \"a\\\\pb\"\n        },\n        \"key\": \"customer=a\\\\\\\\pb\",\n        \"note\": \"the escape-order case: this must NOT collide with a|b above\"\n      },\n      {\n        \"path\": {\n          \"customer\": \"ab\"\n        },\n        \"key\": \"customer=ab\"\n      },\n      {\n        \"path\": {\n          \"customer\": \"a\",\n          \"b\": \"c\"\n        },\n        \"key\": \"b=c|customer=a\",\n        \"note\": \"sorted by key, so `customer=ab` and this cannot collapse\"\n      }\n    ]\n  }\n}\n","/**\n * Loader for the shared SDK behavior contract.\n *\n * The values here are tuned against measured eval failures and are shared,\n * byte-identical, with the Python SDK. They live in data rather than code\n * specifically so the two SDKs cannot drift. See\n * `synap/sdk/CONTRACT/README.md`.\n *\n * `anticipation.json` is vendored into `src/` by\n * `synap/sdk/scripts/sync-behavior.sh` and imported (not read from disk) so\n * that the bundler inlines it. Reading it with `node:fs` at runtime would work\n * in Node and break in every bundled target: Edge, Workers, and anything under\n * webpack/turbopack, where `dist/` is rewritten and relative paths do not\n * survive. It is the same failure mode as `@grpc/proto-loader` reading a\n * `.proto` off disk (gotcha G-P).\n */\n\nimport contractJson from './anticipation.json' with { type: 'json' };\n\nexport interface RecallPattern {\n  pattern: string;\n  flags: string;\n  note: string;\n}\n\nexport interface BehaviorContract {\n  version: number;\n  recall_bypass: {\n    note: string;\n    env_flag: string;\n    default: boolean;\n    patterns: RecallPattern[];\n  };\n  thresholds: {\n    bm25: { value: number; note: string };\n    novel_term: { value: number; note: string };\n    min_corpus_for_novel_gate: { value: number; note: string };\n    effective_floor: { value: number; note: string };\n    query_token_scale: { value: number; note: string };\n  };\n  coverage_gate: {\n    note: string;\n    env_flag: string;\n    default: number | null;\n    empty_query_coverage: number;\n  };\n  telemetry: {\n    rejected_items_cap: { value: number; note: string };\n    content_preview_chars: number;\n  };\n  bm25: {\n    k1: number;\n    b: number;\n    idf_floor: number;\n    min_token_len: number;\n    min_stem_len: number;\n    suffixes: string[];\n    stop_words: string[];\n    alias_token: { pattern: string; note: string };\n  };\n}\n\nexport const CONTRACT = contractJson as unknown as BehaviorContract;\n\n/** ECMAScript flags we accept. Anything else is invalid in Python too. */\nconst ALLOWED_FLAGS = new Set(['i', 'm', 's']);\n\nfunction compile(pattern: string, flags: string): RegExp {\n  for (const ch of flags) {\n    if (!ALLOWED_FLAGS.has(ch)) {\n      throw new Error(\n        `Unsupported regex flag '${ch}' in behavior contract. Flags must be ` +\n          `valid in both Python and ECMAScript.`,\n      );\n    }\n  }\n  return new RegExp(pattern, flags);\n}\n\n/**\n * Compiled recall-bypass patterns, in contract order.\n *\n * Deliberately NOT using the `g` flag: a global RegExp carries `lastIndex`\n * between calls, so a shared instance would match on one query and then miss\n * on the next. That failure is intermittent and traffic-dependent, which is\n * the worst kind to debug.\n */\nexport const RECALL_PATTERNS: readonly RegExp[] = CONTRACT.recall_bypass.patterns.map((p) =>\n  compile(p.pattern, p.flags ?? ''),\n);\n\nexport const THRESHOLDS = {\n  bm25: CONTRACT.thresholds.bm25.value,\n  novelTerm: CONTRACT.thresholds.novel_term.value,\n  minCorpusForNovelGate: CONTRACT.thresholds.min_corpus_for_novel_gate.value,\n  /** Lower bound on the derived per-query threshold. */\n  effectiveFloor: CONTRACT.thresholds.effective_floor.value,\n  /** Points of score allowed per query token when deriving the threshold. */\n  queryTokenScale: CONTRACT.thresholds.query_token_scale.value,\n} as const;\n\nexport const BM25_PARAMS = CONTRACT.bm25;\nexport const STOP_WORDS: ReadonlySet<string> = new Set(CONTRACT.bm25.stop_words);\n// Order is load-bearing: stem() returns on first match, so this must stay\n// longest-first exactly as the contract lists it.\nexport const SUFFIXES: readonly string[] = CONTRACT.bm25.suffixes;\nexport const ALIAS_TOKEN_SOURCE = CONTRACT.bm25.alias_token.pattern;\n\n/** True when any query string looks like an explicit memory-recall ask. */\nexport function isRecallQuery(searchQuery: readonly (string | null | undefined)[] | null | undefined): boolean {\n  for (const q of searchQuery ?? []) {\n    if (!q) continue;\n    for (const pattern of RECALL_PATTERNS) {\n      if (pattern.test(q)) return true;\n    }\n  }\n  return false;\n}\n","/**\n * BM25 scorer for the anticipation cache.\n *\n * A faithful port of `maximem_synap/cache/bm25.py`. Every tuned value comes\n * from the shared behavior contract, so the two implementations cannot drift\n * on parameters. What they *can* still drift on is arithmetic, which is what\n * the shared conformance corpus is for.\n */\n\nimport { BM25_PARAMS, STOP_WORDS, SUFFIXES, ALIAS_TOKEN_SOURCE } from '../behavior/contract.js';\n\nconst MIN_STEM_LEN = BM25_PARAMS.min_stem_len;\nconst MIN_TOKEN_LEN = BM25_PARAMS.min_token_len;\n\nexport function stem(word: string): string {\n  // Order is load-bearing: longest suffix first, return on first match.\n  for (const suffix of SUFFIXES) {\n    if (word.endsWith(suffix) && word.length - suffix.length >= MIN_STEM_LEN) {\n      return word.slice(0, word.length - suffix.length);\n    }\n  }\n  return word;\n}\n\n/**\n * An alias label, as it appears in text: `[[PERSON_PHONE_h2n7v5cx8m0d]]`.\n *\n * Kept whole rather than split into `person`, `phone` and the suffix, because\n * the first two are boilerplate shared by every label of that field type and\n * would make two different people's memories score alike.\n *\n * Mirrors `synap/cloud/shared/tokenizer.py`. Keep the two in step.\n */\nfunction aliasTokenRe(): RegExp {\n  // Constructed per call because `g` regexes carry `lastIndex`, and this one\n  // is used with replace(). A module-level shared instance would produce\n  // different results on alternating calls.\n  return new RegExp(ALIAS_TOKEN_SOURCE, 'g');\n}\n\nconst WORD_RE = /[a-z0-9]+/g;\n\n/** Tokenize, lowercase, remove stop words, and stem. Alias labels survive whole. */\nexport function tokenize(text: string | null | undefined): string[] {\n  if (!text) return [];\n\n  const labels: string[] = [];\n  const remainder = text.replace(aliasTokenRe(), (_match, captured: string) => {\n    labels.push(captured.toLowerCase());\n    return ' ';\n  });\n\n  const words = remainder.toLowerCase().match(WORD_RE) ?? [];\n  const out = labels.slice();\n  for (const w of words) {\n    if (w.length >= MIN_TOKEN_LEN && !STOP_WORDS.has(w)) out.push(stem(w));\n  }\n  return out;\n}\n\n/** Okapi BM25 scorer over a small in-memory corpus. */\nexport class BM25 {\n  static readonly IDF_FLOOR = BM25_PARAMS.idf_floor;\n\n  readonly k1: number;\n  readonly b: number;\n  readonly corpus: readonly (readonly string[])[];\n  readonly docCount: number;\n  readonly avgdl: number;\n  readonly docLens: readonly number[];\n  readonly idf: ReadonlyMap<string, number>;\n\n  constructor(\n    corpus: readonly (readonly string[])[],\n    k1: number = BM25_PARAMS.k1,\n    b: number = BM25_PARAMS.b,\n  ) {\n    this.k1 = k1;\n    this.b = b;\n    this.corpus = corpus;\n    this.docCount = corpus.length;\n    this.docLens = corpus.map((doc) => doc.length);\n    // Python falls back to 1.0 rather than dividing by zero on an empty corpus.\n    this.avgdl = this.docCount\n      ? this.docLens.reduce((a, n) => a + n, 0) / this.docCount\n      : 1.0;\n\n    const idf = new Map<string, number>();\n    const allTerms = new Set<string>();\n    for (const doc of corpus) for (const t of doc) allTerms.add(t);\n    for (const term of allTerms) {\n      let df = 0;\n      for (const doc of corpus) if (doc.includes(term)) df++;\n      const raw = Math.log((this.docCount - df + 0.5) / (df + 0.5) + 1.0);\n      idf.set(term, Math.max(raw, BM25.IDF_FLOOR));\n    }\n    this.idf = idf;\n  }\n\n  score(queryTokens: readonly string[], docIdx: number): number {\n    const doc = this.corpus[docIdx];\n    if (doc === undefined) return 0;\n    const dl = this.docLens[docIdx] ?? 0;\n\n    const tfMap = new Map<string, number>();\n    for (const t of doc) tfMap.set(t, (tfMap.get(t) ?? 0) + 1);\n\n    let s = 0;\n    for (const term of queryTokens) {\n      const tf = tfMap.get(term);\n      if (tf === undefined) continue;\n      const idf = this.idf.get(term) ?? BM25.IDF_FLOOR;\n      const numerator = tf * (this.k1 + 1);\n      const denominator = tf + this.k1 * (1 - this.b + (this.b * dl) / this.avgdl);\n      s += (idf * numerator) / denominator;\n    }\n    return s;\n  }\n\n  scores(queryTokens: readonly string[]): number[] {\n    return this.corpus.map((_, i) => this.score(queryTokens, i));\n  }\n}\n","/**\n * In-memory TTL cache for context bundles pushed over gRPC.\n *\n * Port of `maximem_synap/cache/anticipation_cache.py`.\n *\n * ## Why this is a faithful port and not a simplification\n *\n * `@maximem/synap-vercel-adk` already contains a native TS anticipation cache,\n * and it is a simplification: a hardcoded 30-minute TTL, a plain BM25 threshold\n * with no per-query derivation, and none of the gates below. Shipping that as\n * the SDK's cache would mean two retrieval behaviors under one brand, which is\n * gotcha G-C. Every gate here exists because a specific eval failed without it:\n *\n *  - **Recall bypass** runs BEFORE scoring. The measured false hit scored 2.86\n *    at coverage 1.00, so no score-side gate could ever have caught it.\n *  - **The novel-term gate** is suppressed below a 200-stem corpus, because at\n *    cold start ordinary English trips it on nearly every query.\n *  - **The per-query threshold** scales down for short queries, which otherwise\n *    cannot reach the nominal score at all.\n *  - **The coverage gate** catches a bundle that clears BM25 on one shared\n *    token (\"account\") while lacking the asked-for fact.\n *\n * All thresholds come from the shared behavior contract.\n */\n\nimport { BM25, tokenize } from '../cache/bm25.js';\nimport { CONTRACT, THRESHOLDS, isRecallQuery } from '../behavior/contract.js';\nimport { getEnvFlag, getEnvFloat } from '../util/env.js';\n\nconst EFFECTIVE_FLOOR = CONTRACT.thresholds.effective_floor.value;\nconst QUERY_TOKEN_SCALE = CONTRACT.thresholds.query_token_scale.value;\nconst REJECTED_CAP = CONTRACT.telemetry.rejected_items_cap.value;\nconst PREVIEW_CHARS = CONTRACT.telemetry.content_preview_chars;\n\n/** Sentinel scope that matches any requester. */\nexport const ANY_SCOPE = '_any';\n\n// ── the rung a request or a bundle stands at ───────────────────────────────\n//\n// A pushed bundle is stamped with the scope rung the server retrieved it at,\n// and a fetch names one through `scope_path`. Both are written the same way so\n// they can be compared as strings, because nothing in this process can resolve\n// anything: the server speaks in registry node ids and an SDK in a customer's\n// app has never seen one, so the comparison happens in the vocabulary the\n// CALLER uses, which is level keys and the client's own external ids.\n//\n// The recipe and its golden vectors live in the shared behavior contract\n// (CONTRACT/behavior/anticipation.json, `rung_key`). It is written three times\n// (here, the Python SDK, the server) because the producer is not an SDK, so\n// the usual \"port it once\" rule cannot apply. Do NOT re-tune it here.\nconst RUNG_SEPARATOR = '|';\nconst RUNG_ASSIGN = '=';\n\n/**\n * The rung a `scope_path` names, canonically, or null for no path.\n *\n * Sorted by level key because an object carries whatever order the caller\n * wrote it in, and the ladder's own order is not knowable here. Only the value\n * is escaped: level keys are `^[a-z][a-z0-9_]{0,63}$`, so they can hold\n * neither separator. Backslash is escaped first, or `a|b` and `a\\pb` would\n * encode to the same string, which is a false match between two rungs.\n */\nexport function rungKey(\n  scopePath: Record<string, string> | null | undefined,\n): string | null {\n  if (!scopePath) return null;\n  const pairs: [string, string][] = [];\n  for (const [k, v] of Object.entries(scopePath)) {\n    if (k === '' || v === null || v === undefined || String(v) === '') continue;\n    pairs.push([String(k), String(v)]);\n  }\n  if (pairs.length === 0) return null;\n  pairs.sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0));\n  return pairs\n    .map(([k, v]) => {\n      const escaped = v\n        .split('\\\\').join('\\\\\\\\')\n        .split(RUNG_SEPARATOR).join('\\\\p')\n        .split(RUNG_ASSIGN).join('\\\\e');\n      return `${k}${RUNG_ASSIGN}${escaped}`;\n    })\n    .join(RUNG_SEPARATOR);\n}\n\n/**\n * May a bundle stamped `bundleRung` answer a request at `requestRung`?\n *\n * Equality, and equality on purpose. A subset rule (\"the bundle names more\n * rungs than you did, close enough\") reads as the generous option and is the\n * dangerous one: the rung nobody named is exactly the rung that tells two\n * people sharing an external id apart, which is the case the whole ladder\n * exists for. Being wrong here costs a cold fetch; being wrong the other way\n * hands one person's context to another.\n *\n * null on either side means \"named no rung\". Both null is every request in\n * production today and it serves, so nothing changes for anyone who has not\n * turned nested scoping on. `''` normalises to null because a proto string\n * field has no null and an unstamped bundle arrives as the empty string.\n */\nexport function rungServes(\n  bundleRung: string | null | undefined,\n  requestRung: string | null | undefined,\n): boolean {\n  return (bundleRung || null) === (requestRung || null);\n}\n\nexport interface BundleItem {\n  item_id?: string;\n  content?: string;\n  [key: string]: unknown;\n}\n\nexport interface ContextBundle {\n  bundleId: string;\n  entityId?: string | null;\n  conversationId?: string | null;\n  itemsByType: Record<string, BundleItem[]>;\n  /** Server hint; may only SHORTEN the global TTL, never extend it. */\n  ttlHintSeconds?: number | null;\n  /** Which anticipation pattern produced this bundle. Diagnostics only. */\n  bundleType?: string | null;\n  /** The queries the server anticipated. Diagnostics only. */\n  searchQueries?: readonly string[] | null;\n  /**\n   * The scope rung the server retrieved this bundle at, as `rungKey` writes\n   * one. Absent from anything an older server sent, which reads as \"named no\n   * rung\" rather than as \"matches anything\".\n   */\n  scopeRung?: string | null;\n}\n\ninterface ItemRecord {\n  bundleId: string;\n  itemType: string;\n  content: string;\n  tokens: string[];\n  itemDict: BundleItem;\n}\n\ninterface EntryRecord {\n  bundleId: string;\n  entityId: string;\n  conversationId: string | null;\n  bundleType: string | null;\n  searchQueries: string[];\n  /** Sliding lease, refreshed on hit unless TTL hints are honoured. */\n  storedAt: number;\n  /** Absolute creation time; the max-entry-age cap uses this, not the lease. */\n  createdAt: number;\n  ttlHintSeconds: number | null;\n  scopeRung: string | null;\n}\n\nexport interface LookupResult {\n  itemsByType: Record<string, BundleItem[]>;\n  bundleIds: string[];\n  score: number;\n  coverage: number;\n}\n\nexport interface LookupParams {\n  searchQuery?: readonly string[] | null;\n  entityId?: string | null;\n  customerId?: string | null;\n  clientId?: string | null;\n  conversationId?: string | null;\n  /**\n   * The rung this request names, from its `scope_path`. A SECOND, independent\n   * dimension and NOT another tier of the entity funnel: the funnel widens and\n   * the rung does not, because a rung is a boundary and a boundary that widens\n   * is not one.\n   */\n  scopeRung?: string | null;\n  maxItems?: number;\n}\n\nexport type ExitReason =\n  | 'empty'\n  | 'recall_bypass'\n  | 'no_query_tokens'\n  | 'novel_term_gate'\n  | 'empty_corpus'\n  | 'no_items_above_threshold'\n  | 'coverage_gate'\n  | 'hit';\n\nexport interface LookupTelemetry {\n  searchQuery: string[];\n  entityId: string | null;\n  customerId: string | null;\n  clientId: string | null;\n  conversationId: string | null;\n  scopeRung: string | null;\n  scopeFilterAccepted: string[];\n  novelTermRatio: number | null;\n  bm25Threshold: number | null;\n  bm25QueryTokens: string[];\n  itemsPicked: unknown[];\n  itemsRejected: unknown[];\n  coverage: number | null;\n  hit: boolean;\n  exitReason: ExitReason;\n}\n\nexport interface SnapshotItemPreview {\n  type: string;\n  scope: string | null;\n  content: string;\n}\n\nexport interface SnapshotItemRecord {\n  bundle_id: string;\n  item_type: string;\n  tokens: string[];\n  content: string;\n}\n\nexport interface SnapshotBundle {\n  bundle_id: string;\n  entity_id: string;\n  conversation_id: string | null;\n  bundle_type: string | null;\n  search_queries: string[];\n  scope_counts: Record<string, number>;\n  total_items: number;\n  items: SnapshotItemPreview[];\n}\n\nexport interface AnticipationCacheSnapshot {\n  total_entries: number;\n  total_item_records: number;\n  scope_breakdown_overall: Record<string, number>;\n  corpus_vocab_size: number;\n  corpus_vocab_sample: string[];\n  item_records: SnapshotItemRecord[];\n  bundles: SnapshotBundle[];\n}\n\nexport interface AnticipationCacheOptions {\n  ttlSeconds?: number;\n  maxBundles?: number;\n  /** Injected in tests. Defaults to a monotonic clock. */\n  now?: () => number;\n  onLookup?: (telemetry: LookupTelemetry) => void;\n}\n\nconst DEFAULT_TTL_SECONDS = 1800;\nconst DEFAULT_MAX_BUNDLES = 50;\n\nexport class AnticipationCache {\n  private readonly ttlSeconds: number;\n  private readonly maxBundles: number;\n  private readonly now: () => number;\n  private readonly onLookup: ((t: LookupTelemetry) => void) | undefined;\n\n  private entries = new Map<string, EntryRecord>();\n  private items: ItemRecord[] = [];\n  private corpusVocab = new Set<string>();\n  private bm25: BM25 | null = null;\n  private bm25Dirty = true;\n\n  constructor(options: AnticipationCacheOptions = {}) {\n    this.ttlSeconds = options.ttlSeconds ?? DEFAULT_TTL_SECONDS;\n    this.maxBundles = options.maxBundles ?? DEFAULT_MAX_BUNDLES;\n    this.now = options.now ?? monotonicNow;\n    this.onLookup = options.onLookup;\n  }\n\n  get size(): number {\n    return this.entries.size;\n  }\n\n  get itemCount(): number {\n    return this.items.length;\n  }\n\n  store(bundle: ContextBundle): void {\n    if (!bundle.bundleId) return;\n    this.evictExpired();\n\n    // Client-scope knowledge (FAQs, policies) arrives with no entity, and the\n    // sentinel makes it visible to every requester.\n    const entityId = bundle.entityId || ANY_SCOPE;\n\n    if (this.entries.has(bundle.bundleId)) this.dropBundle(bundle.bundleId);\n\n    const now = this.now();\n    this.entries.set(bundle.bundleId, {\n      bundleId: bundle.bundleId,\n      entityId,\n      conversationId: bundle.conversationId ?? null,\n      bundleType: bundle.bundleType ?? null,\n      searchQueries: [...(bundle.searchQueries ?? [])],\n      storedAt: now,\n      createdAt: now,\n      ttlHintSeconds: bundle.ttlHintSeconds ?? null,\n      scopeRung: bundle.scopeRung || null,\n    });\n\n    for (const [itemType, list] of Object.entries(bundle.itemsByType ?? {})) {\n      for (const item of list ?? []) {\n        const content = String(item.content ?? '');\n        const tokens = tokenize(content);\n        this.items.push({ bundleId: bundle.bundleId, itemType, content, tokens, itemDict: item });\n        for (const t of tokens) this.corpusVocab.add(t);\n      }\n    }\n    this.bm25Dirty = true;\n\n    // LRU by lease age.\n    while (this.entries.size > this.maxBundles) {\n      let oldest: EntryRecord | null = null;\n      for (const e of this.entries.values()) {\n        if (oldest === null || e.storedAt < oldest.storedAt) oldest = e;\n      }\n      if (oldest === null) break;\n      this.dropBundle(oldest.bundleId);\n    }\n  }\n\n  lookup(params: LookupParams): LookupResult | null {\n    const {\n      searchQuery = null, entityId = null, customerId = null,\n      clientId = null, conversationId = null, scopeRung = null, maxItems = 10,\n    } = params;\n\n    this.evictExpired();\n\n    const accepted = this.buildAcceptedScope(entityId, customerId, clientId);\n    const telemetry: LookupTelemetry = {\n      searchQuery: (searchQuery ?? []).filter((q): q is string => Boolean(q)),\n      entityId, customerId, clientId, conversationId,\n      scopeRung: scopeRung ?? null,\n      scopeFilterAccepted: [...accepted].sort(),\n      novelTermRatio: null, bm25Threshold: null, bm25QueryTokens: [],\n      itemsPicked: [], itemsRejected: [], coverage: null,\n      hit: false, exitReason: 'empty',\n    };\n\n    if (this.entries.size === 0 || this.items.length === 0) {\n      return this.miss(telemetry, 'empty');\n    }\n\n    const hasQuery = (searchQuery ?? []).some((q) => q && q.trim() !== '');\n    if (!hasQuery) {\n      return this.freshnessLookup(entityId, scopeRung ?? null, maxItems, telemetry);\n    }\n\n    // Recall bypass fires BEFORE scoring: a stale false-hit on a recall-shaped\n    // question makes the agent deny a fact the store holds, and the measured\n    // failure cleared every score-side gate.\n    if (getEnvFlag(CONTRACT.recall_bypass.env_flag) && isRecallQuery(searchQuery)) {\n      return this.miss(telemetry, 'recall_bypass');\n    }\n\n    const queryTokens = (searchQuery ?? []).flatMap((q) => tokenize(q));\n    telemetry.bm25QueryTokens = queryTokens;\n    if (queryTokens.length === 0) {\n      return this.miss(telemetry, 'no_query_tokens');\n    }\n\n    const uniqueStems = new Set(queryTokens);\n    let novel = 0;\n    for (const s of uniqueStems) if (!this.corpusVocab.has(s)) novel++;\n    const novelRatio = uniqueStems.size ? novel / uniqueStems.size : 0;\n    telemetry.novelTermRatio = round4(novelRatio);\n\n    // Only meaningful once the corpus has real vocabulary. Below the floor the\n    // ratio is dominated by ordinary English and would miss on nearly anything.\n    if (\n      this.corpusVocab.size >= THRESHOLDS.minCorpusForNovelGate &&\n      novelRatio >= THRESHOLDS.novelTerm\n    ) {\n      return this.miss(telemetry, 'novel_term_gate');\n    }\n\n    if (this.bm25Dirty || this.bm25 === null) {\n      if (this.items.length === 0) return this.miss(telemetry, 'empty_corpus');\n      this.bm25 = new BM25(this.items.map((i) => i.tokens));\n      this.bm25Dirty = false;\n    }\n\n    const scores = this.bm25.scores(queryTokens);\n    const validBundles = this.getValidBundleIds(accepted, conversationId, scopeRung ?? null);\n\n    const effectiveThreshold = Math.max(\n      EFFECTIVE_FLOOR,\n      Math.min(THRESHOLDS.bm25, QUERY_TOKEN_SCALE * queryTokens.length),\n    );\n    telemetry.bm25Threshold = round4(effectiveThreshold);\n\n    const picked: { score: number; item: ItemRecord }[] = [];\n    const rejected: { score: number; payload: Record<string, unknown> }[] = [];\n\n    for (let idx = 0; idx < scores.length; idx++) {\n      const item = this.items[idx]!;\n      const score = scores[idx]!;\n      const reject = (reason: string) =>\n        rejected.push({\n          score,\n          payload: {\n            item_index: idx, bundle_id: item.bundleId, item_type: item.itemType,\n            content_first_120: item.content.slice(0, PREVIEW_CHARS),\n            bm25_score: round4(score), reason,\n          },\n        });\n      if (score < effectiveThreshold) { reject('below_threshold'); continue; }\n      if (!validBundles.has(item.bundleId)) { reject('scope_filter_excluded'); continue; }\n      picked.push({ score, item });\n    }\n\n    rejected.sort((a, b) => b.score - a.score);\n    telemetry.itemsRejected = rejected.slice(0, REJECTED_CAP).map((r) => r.payload);\n\n    if (picked.length === 0) {\n      return this.miss(telemetry, 'no_items_above_threshold');\n    }\n\n    picked.sort((a, b) => b.score - a.score);\n    const top = picked.slice(0, maxItems);\n\n    const pickedStems = new Set<string>();\n    for (const { item } of top) for (const t of item.tokens) pickedStems.add(t);\n    let overlap = 0;\n    for (const s of uniqueStems) if (pickedStems.has(s)) overlap++;\n    const coverage = uniqueStems.size ? overlap / uniqueStems.size : 1.0;\n    telemetry.coverage = round4(coverage);\n\n    // Observe-only unless explicitly configured. A malformed setting stays\n    // observe-only rather than failing closed on every lookup.\n    const coverageMin = getEnvFloat('SYNAP_SDK_CACHE_COVERAGE_MIN');\n    if (coverageMin !== null && coverage < coverageMin) {\n      // Gate BEFORE any side effect, so a rejected lookup leaves cache state\n      // untouched and does not refresh a lease.\n      return this.miss(telemetry, 'coverage_gate');\n    }\n\n    const itemsByType: Record<string, BundleItem[]> = {};\n    const bundleIds = new Set<string>();\n    for (const { item } of top) {\n      (itemsByType[item.itemType] ??= []).push(item.itemDict);\n      bundleIds.add(item.bundleId);\n    }\n\n    // Honouring a TTL hint also means a hit stops renewing the lease, otherwise\n    // a hinted bundle under steady traffic would outlive its hint.\n    const refreshOnHit = !getEnvFlag('SYNAP_SDK_CACHE_HONOR_TTL_HINT');\n    if (refreshOnHit) {\n      const now = this.now();\n      for (const id of bundleIds) {\n        const entry = this.entries.get(id);\n        if (entry) entry.storedAt = now;\n      }\n    }\n\n    telemetry.hit = true;\n    telemetry.exitReason = 'hit';\n    telemetry.itemsPicked = top.map(({ score, item }) => ({\n      bundle_id: item.bundleId, item_type: item.itemType,\n      content_first_120: item.content.slice(0, PREVIEW_CHARS), bm25_score: round4(score),\n    }));\n    this.fire(telemetry);\n\n    return {\n      itemsByType,\n      bundleIds: [...bundleIds],\n      score: top[0]!.score,\n      coverage,\n    };\n  }\n\n  /**\n   * Drop this entity's bundles after a write, so the cache stops serving a\n   * pre-write view. Gated on the flag: this is the write-path hook.\n   */\n  invalidateEntity(entityId: string): number {\n    if (!getEnvFlag('SYNAP_SDK_CACHE_INVALIDATE_ON_WRITE')) return 0;\n    return this.dropEntity(entityId);\n  }\n\n  /**\n   * Unconditionally drop this entity's bundles. Backs `cache.clear_user` and\n   * `cache.clear_customer`, which are explicit user requests and so are not\n   * gated on the invalidate-on-write flag.\n   */\n  dropEntity(entityId: string): number {\n    let dropped = 0;\n    for (const entry of [...this.entries.values()]) {\n      // Never drop shared client-scope knowledge on one entity's behalf.\n      if (entry.entityId === ANY_SCOPE) continue;\n      if (entry.entityId === entityId) { this.dropBundle(entry.bundleId); dropped++; }\n    }\n    return dropped;\n  }\n\n  /**\n   * A read-only diagnostic projection of the cache.\n   *\n   * Backs `client.anticipation_cache_snapshot()` and mirrors Python's shape\n   * key for key, including snake_case keys: this output gets logged, diffed\n   * and pasted into issues across both SDKs, so it is a wire format.\n   *\n   * Note the 140-character content previews. That is Python's literal, and it\n   * is deliberately NOT the 120 of `telemetry.content_preview_chars` from the\n   * contract, which caps lookup telemetry rather than this snapshot.\n   */\n  snapshot(): AnticipationCacheSnapshot {\n    const SNAPSHOT_PREVIEW_CHARS = 140;\n    const overallScope = new Map<string, number>();\n    const itemsByBundle = new Map<string, ItemRecord[]>();\n    for (const record of this.items) {\n      const list = itemsByBundle.get(record.bundleId);\n      if (list === undefined) itemsByBundle.set(record.bundleId, [record]);\n      else list.push(record);\n    }\n\n    const bundles: SnapshotBundle[] = [];\n    for (const [bundleId, entry] of this.entries) {\n      const perBundle = new Map<string, number>();\n      const itemPreviews: SnapshotItemPreview[] = [];\n      for (const record of itemsByBundle.get(bundleId) ?? []) {\n        // `scope` is absent on plenty of items; Python's Counter happily keys\n        // on None, which JSON-serialises to null, so preserve the distinction\n        // rather than coercing to a string.\n        const scope = (record.itemDict['scope'] ?? null) as string | null;\n        const key = scope === null ? '' : scope;\n        overallScope.set(key, (overallScope.get(key) ?? 0) + 1);\n        perBundle.set(key, (perBundle.get(key) ?? 0) + 1);\n        itemPreviews.push({\n          type: record.itemType,\n          scope,\n          content: record.content.slice(0, SNAPSHOT_PREVIEW_CHARS),\n        });\n      }\n      let totalItems = 0;\n      for (const n of perBundle.values()) totalItems += n;\n      bundles.push({\n        bundle_id: bundleId,\n        entity_id: entry.entityId,\n        conversation_id: entry.conversationId,\n        bundle_type: entry.bundleType,\n        search_queries: [...entry.searchQueries],\n        scope_counts: Object.fromEntries(perBundle),\n        total_items: totalItems,\n        items: itemPreviews,\n      });\n    }\n\n    return {\n      total_entries: this.entries.size,\n      total_item_records: this.items.length,\n      scope_breakdown_overall: Object.fromEntries(overallScope),\n      corpus_vocab_size: this.corpusVocab.size,\n      corpus_vocab_sample: [...this.corpusVocab].sort().slice(0, 80),\n      item_records: this.items.slice(0, 20).map((rec) => ({\n        bundle_id: rec.bundleId,\n        item_type: rec.itemType,\n        tokens: rec.tokens.slice(0, 25),\n        content: rec.content.slice(0, SNAPSHOT_PREVIEW_CHARS),\n      })),\n      bundles,\n    };\n  }\n\n  /**\n   * The freshest `user_summary` bundle for this entity, or null.\n   *\n   * `entityId` is REQUIRED, and a missing one refuses the lookup rather than\n   * falling back to the freshest summary across all users. Python hardened this\n   * for exactly that reason: the permissive version could splice user A's\n   * summary into user B's response on the conversation-scope path.\n   */\n  lookupUserSummary(\n    entityId: string | null | undefined,\n    scopeRung: string | null = null,\n  ): Record<string, unknown> | null {\n    if (!entityId) return null;\n    this.evictExpired();\n\n    let freshest: EntryRecord | null = null;\n    for (const entry of this.entries.values()) {\n      if (entry.bundleType !== 'user_summary') continue;\n      if (!rungServes(entry.scopeRung, scopeRung)) continue;\n      // ANY_SCOPE covers client-shared summaries, which are safe for everyone.\n      if (entry.entityId !== entityId && entry.entityId !== ANY_SCOPE) continue;\n      if (freshest === null || entry.storedAt > freshest.storedAt) freshest = entry;\n    }\n    if (freshest === null) return null;\n\n    // Serving refreshes the sliding lease, unless the server's TTL hint is\n    // being honoured, in which case the hint owns expiry.\n    if (!getEnvFlag('SYNAP_SDK_CACHE_HONOR_TTL_HINT')) {\n      freshest.storedAt = this.now();\n    }\n    return this.#bundleFor(freshest.bundleId);\n  }\n\n  /** Rebuild a bundle's items_by_type from the flat item records. */\n  #bundleFor(bundleId: string): Record<string, unknown> {\n    const itemsByType: Record<string, BundleItem[]> = {};\n    for (const record of this.items) {\n      if (record.bundleId !== bundleId) continue;\n      (itemsByType[record.itemType] ??= []).push(record.itemDict);\n    }\n    return { bundle_id: bundleId, items_by_type: itemsByType };\n  }\n\n  /**\n   * Drop every bundle belonging to one conversation.\n   *\n   * Backs the `compaction_update` signal on the Listen stream: a compaction\n   * rewrites the conversation's summary, so any bundle built from the previous\n   * state is stale and must not keep serving for the rest of its TTL.\n   *\n   * Unlike `dropEntity`, client-scope bundles are NOT spared: a bundle is only\n   * dropped here if it is bound to this specific conversation, and a shared\n   * client-scope bundle has no conversation id to match.\n   */\n  dropConversation(conversationId: string): number {\n    if (!conversationId) return 0;\n    let dropped = 0;\n    for (const entry of [...this.entries.values()]) {\n      if (entry.conversationId === conversationId) { this.dropBundle(entry.bundleId); dropped++; }\n    }\n    return dropped;\n  }\n\n  clear(): void {\n    this.entries.clear();\n    this.items = [];\n    this.corpusVocab.clear();\n    this.bm25 = null;\n    this.bm25Dirty = true;\n  }\n\n  // ── internals ───────────────────────────────────────────────────────────────\n\n  private miss(telemetry: LookupTelemetry, reason: ExitReason): null {\n    telemetry.exitReason = reason;\n    telemetry.hit = false;\n    this.fire(telemetry);\n    return null;\n  }\n\n  private fire(telemetry: LookupTelemetry): void {\n    // Exception-safe by contract: a buggy hook must never break the SDK.\n    try {\n      this.onLookup?.(telemetry);\n    } catch {\n      /* ignored on purpose */\n    }\n  }\n\n  private freshnessLookup(\n    entityId: string | null,\n    scopeRung: string | null,\n    maxItems: number,\n    telemetry: LookupTelemetry,\n  ): LookupResult | null {\n    // This path serves a WHOLE bundle on no query at all, so it is the least\n    // filtered way out of this cache and needs the rung as much as the scored\n    // path does.\n    const candidates = [...this.entries.values()]\n      .filter((e) => rungServes(e.scopeRung, scopeRung))\n      .filter((e) => entityId === null || e.entityId === entityId || e.entityId === ANY_SCOPE)\n      .sort((a, b) => b.storedAt - a.storedAt);\n    if (candidates.length === 0) return this.miss(telemetry, 'empty');\n\n    const newest = candidates[0]!;\n    const itemsByType: Record<string, BundleItem[]> = {};\n    let n = 0;\n    for (const item of this.items) {\n      if (item.bundleId !== newest.bundleId) continue;\n      if (n >= maxItems) break;\n      (itemsByType[item.itemType] ??= []).push(item.itemDict);\n      n++;\n    }\n    if (n === 0) return this.miss(telemetry, 'empty');\n\n    telemetry.hit = true;\n    telemetry.exitReason = 'hit';\n    this.fire(telemetry);\n    return { itemsByType, bundleIds: [newest.bundleId], score: 0, coverage: 1.0 };\n  }\n\n  /**\n   * The widened scope-match set for a request.\n   *\n   * A narrower-scope request also matches broader-scope bundles for the same\n   * customer or client. Falsy ids are dropped so an empty customer_id cannot\n   * accidentally match bundles keyed at \"\".\n   */\n  private buildAcceptedScope(\n    entityId: string | null, customerId: string | null, clientId: string | null,\n  ): Set<string> {\n    const accepted = new Set<string>([ANY_SCOPE]);\n    if (entityId) accepted.add(entityId);\n    if (customerId) accepted.add(customerId);\n    if (clientId) accepted.add(clientId);\n    return accepted;\n  }\n\n  /**\n   * The rung is checked FIRST and it never widens. Everything else here widens\n   * deliberately: a user-scope request reaches customer-shared bundles, and a\n   * conversation-scope request reaches user-scope ones. A rung is the opposite\n   * kind of thing, so it is checked before the tiers and no amount of widening\n   * can put a cross-rung bundle back in.\n   */\n  private getValidBundleIds(\n    accepted: Set<string>, conversationId: string | null, scopeRung: string | null,\n  ): Set<string> {\n    const valid = new Set<string>();\n    for (const entry of this.entries.values()) {\n      if (!rungServes(entry.scopeRung, scopeRung)) continue;\n      if (!accepted.has(entry.entityId)) continue;\n      // A conversation-scoped bundle is only valid inside its conversation.\n      if (entry.conversationId && conversationId && entry.conversationId !== conversationId) continue;\n      valid.add(entry.bundleId);\n    }\n    return valid;\n  }\n\n  private effectiveTtl(entry: EntryRecord): number {\n    if (!getEnvFlag('SYNAP_SDK_CACHE_HONOR_TTL_HINT')) return this.ttlSeconds;\n    if (entry.ttlHintSeconds == null || entry.ttlHintSeconds <= 0) return this.ttlSeconds;\n    // A hint may only shorten.\n    return Math.min(this.ttlSeconds, entry.ttlHintSeconds);\n  }\n\n  private evictExpired(): void {\n    const now = this.now();\n    // Default cap is twice the sliding TTL; 0 disables. Without it a bundle\n    // under steady traffic renews forever and can serve a retired value\n    // indefinitely.\n    const configuredMaxAge = getEnvFloat('SYNAP_SDK_CACHE_MAX_ENTRY_AGE');\n    const maxAge = configuredMaxAge ?? this.ttlSeconds * 2;\n\n    for (const entry of [...this.entries.values()]) {\n      const idleExpired = now - entry.storedAt > this.effectiveTtl(entry);\n      const ageExpired = maxAge > 0 && now - entry.createdAt > maxAge;\n      if (idleExpired || ageExpired) this.dropBundle(entry.bundleId);\n    }\n  }\n\n  private dropBundle(bundleId: string): void {\n    if (!this.entries.delete(bundleId)) return;\n    this.items = this.items.filter((i) => i.bundleId !== bundleId);\n    // Vocabulary is rebuilt rather than decremented: a stem can be shared by\n    // several bundles, so per-bundle subtraction would drop stems still in use.\n    this.corpusVocab = new Set(this.items.flatMap((i) => i.tokens));\n    this.bm25Dirty = true;\n  }\n}\n\nfunction monotonicNow(): number {\n  // performance.now() is monotonic and unaffected by wall-clock adjustments,\n  // matching Python's time.monotonic(). Date.now() would let an NTP step\n  // expire or resurrect every entry at once.\n  return typeof performance !== 'undefined' && typeof performance.now === 'function'\n    ? performance.now() / 1000\n    : Date.now() / 1000;\n}\n\nfunction round4(n: number): number {\n  return Number(n.toFixed(4));\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-ZU6ZC4SU.js → chunk-T5QQBJ6T.js}

@@ -1,5 +1,5 @@
 // src/grpc/descriptor.ts
-var PROTO_SHA = "1a9a098645d1b3cf";
+var PROTO_SHA = "a58c9b031b41530d";
 var SYNAP_PROTO_DESCRIPTOR = {
   "nested": {
     "synap": {
@@ -211,6 +211,11 @@ var SYNAP_PROTO_DESCRIPTOR = {
                   "rule": "repeated",
                   "type": "string",
                   "id": 13
+                },
+                "scope": {
+                  "keyType": "string",
+                  "type": "string",
+                  "id": 14
                 }
               }
             },
@@ -394,6 +399,10 @@ var SYNAP_PROTO_DESCRIPTOR = {
                 "ttl_hint_seconds": {
                   "type": "int32",
                   "id": 23
+                },
+                "anticipation_scope_rung": {
+                  "type": "string",
+                  "id": 24
                 }
               }
             },
@@ -780,6 +789,10 @@ var GrpcStreamClient = class {
       // customer; falling back to customer id keeps org-scope bundles usable.
       entityId: String(bundle["anticipation_user_id"] ?? "") || String(bundle["anticipation_customer_id"] ?? "") || null,
       conversationId: conversationId || null,
+      // The rung the server retrieved this bundle at. Absent from anything an
+      // older server sent, and absent reads as "named no rung" rather than as
+      // "matches anything".
+      scopeRung: String(bundle["anticipation_scope_rung"] ?? "") || null,
       itemsByType,
       // 0 means "use the SDK default"; anything else is floored at 60s.
       ttlHintSeconds: ttlHint > 0 ? Math.max(ttlHint, MIN_TTL_SECONDS) : null,
@@ -853,4 +866,4 @@ export {
   PROTO_SHA,
   GrpcStreamClient
 };
-//# sourceMappingURL=chunk-ZU6ZC4SU.js.map
+//# sourceMappingURL=chunk-T5QQBJ6T.js.map

package/dist/chunk-T5QQBJ6T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/grpc/descriptor.ts","../src/grpc/stream-client.ts"],"sourcesContent":["/**\n * GENERATED FILE. Do not edit by hand.\n *\n * Source:    synap/proto/synap_service.proto\n * Generator: synap/sdk/scripts/gen_proto_descriptor.mjs\n * Proto SHA: a58c9b031b41530d\n *\n * The proto is inlined as a JSON descriptor rather than loaded from disk so\n * that bundlers and Vercel file tracing cannot lose it. Regenerate with\n * `npm run sync-behavior` in synap/sdk/js.\n */\n\n/** sha256 (first 16 hex chars) of the proto this descriptor was built from. */\nexport const PROTO_SHA = 'a58c9b031b41530d';\n\nexport const SYNAP_PROTO_DESCRIPTOR = {\n  \"nested\": {\n    \"synap\": {\n      \"nested\": {\n        \"v1\": {\n          \"nested\": {\n            \"SynapService\": {\n              \"methods\": {\n                \"Listen\": {\n                  \"requestType\": \"StreamEvent\",\n                  \"requestStream\": true,\n                  \"responseType\": \"StreamResponse\",\n                  \"responseStream\": true\n                },\n                \"IngestTelemetry\": {\n                  \"requestType\": \"TelemetryEvent\",\n                  \"requestStream\": true,\n                  \"responseType\": \"TelemetryAck\"\n                }\n              }\n            },\n            \"StreamEvent\": {\n              \"oneofs\": {\n                \"payload\": {\n                  \"oneof\": [\n                    \"conversation_event\",\n                    \"heartbeat_ping\",\n                    \"session_control\",\n                    \"context_used\",\n                    \"context_assembled\"\n                  ]\n                }\n              },\n              \"fields\": {\n                \"conversation_event\": {\n                  \"type\": \"ConversationEvent\",\n                  \"id\": 1\n                },\n                \"heartbeat_ping\": {\n                  \"type\": \"HeartbeatPing\",\n                  \"id\": 2\n                },\n                \"session_control\": {\n                  \"type\": \"SessionControl\",\n                  \"id\": 3\n                },\n                \"context_used\": {\n                  \"type\": \"ContextUsedEvent\",\n                  \"id\": 4\n                },\n                \"context_assembled\": {\n                  \"type\": \"ContextAssembledEvent\",\n                  \"id\": 5\n                }\n              }\n            },\n            \"ContextUsedEvent\": {\n              \"fields\": {\n                \"bundle_id\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"conversation_id\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"user_id\": {\n                  \"type\": \"string\",\n                  \"id\": 3\n                },\n                \"customer_id\": {\n                  \"type\": \"string\",\n                  \"id\": 4\n                },\n                \"served_item_ids\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 5\n                },\n                \"timestamp_ms\": {\n                  \"type\": \"int64\",\n                  \"id\": 6\n                },\n                \"scope\": {\n                  \"type\": \"string\",\n                  \"id\": 7\n                },\n                \"source_bundle_ids\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 8\n                }\n              }\n            },\n            \"ContextAssembledEvent\": {\n              \"fields\": {\n                \"correlation_id\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"conversation_id\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"user_id\": {\n                  \"type\": \"string\",\n                  \"id\": 3\n                },\n                \"customer_id\": {\n                  \"type\": \"string\",\n                  \"id\": 4\n                },\n                \"final_item_ids\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 5\n                },\n                \"final_total_tokens\": {\n                  \"type\": \"int32\",\n                  \"id\": 6\n                },\n                \"compaction_id\": {\n                  \"type\": \"string\",\n                  \"id\": 7\n                },\n                \"recent_turn_count\": {\n                  \"type\": \"int32\",\n                  \"id\": 8\n                },\n                \"compaction_end_timestamp\": {\n                  \"type\": \"string\",\n                  \"id\": 9\n                },\n                \"assembly_source\": {\n                  \"type\": \"string\",\n                  \"id\": 10\n                },\n                \"assembly_duration_ms\": {\n                  \"type\": \"int32\",\n                  \"id\": 11\n                },\n                \"cache_hit\": {\n                  \"type\": \"bool\",\n                  \"id\": 12\n                },\n                \"timestamp_ms\": {\n                  \"type\": \"int64\",\n                  \"id\": 13\n                },\n                \"sdk_version\": {\n                  \"type\": \"string\",\n                  \"id\": 14\n                }\n              }\n            },\n            \"ConversationEvent\": {\n              \"fields\": {\n                \"event_type\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"conversation_id\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"user_id\": {\n                  \"type\": \"string\",\n                  \"id\": 3\n                },\n                \"role\": {\n                  \"type\": \"string\",\n                  \"id\": 4\n                },\n                \"content\": {\n                  \"type\": \"string\",\n                  \"id\": 5\n                },\n                \"customer_id\": {\n                  \"type\": \"string\",\n                  \"id\": 6\n                },\n                \"session_id\": {\n                  \"type\": \"string\",\n                  \"id\": 7\n                },\n                \"metadata\": {\n                  \"keyType\": \"string\",\n                  \"type\": \"string\",\n                  \"id\": 8\n                },\n                \"timestamp_ms\": {\n                  \"type\": \"int64\",\n                  \"id\": 9\n                },\n                \"tool_name\": {\n                  \"type\": \"string\",\n                  \"id\": 10\n                },\n                \"tool_args_json\": {\n                  \"type\": \"string\",\n                  \"id\": 11\n                },\n                \"search_queries\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 12\n                },\n                \"context_types\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 13\n                },\n                \"scope\": {\n                  \"keyType\": \"string\",\n                  \"type\": \"string\",\n                  \"id\": 14\n                }\n              }\n            },\n            \"HeartbeatPing\": {\n              \"fields\": {\n                \"timestamp_ms\": {\n                  \"type\": \"int64\",\n                  \"id\": 1\n                }\n              }\n            },\n            \"SessionControl\": {\n              \"fields\": {\n                \"action\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"session_id\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"conversation_id\": {\n                  \"type\": \"string\",\n                  \"id\": 3\n                },\n                \"user_id\": {\n                  \"type\": \"string\",\n                  \"id\": 4\n                },\n                \"customer_id\": {\n                  \"type\": \"string\",\n                  \"id\": 5\n                }\n              }\n            },\n            \"StreamResponse\": {\n              \"oneofs\": {\n                \"payload\": {\n                  \"oneof\": [\n                    \"context_bundle\",\n                    \"heartbeat_pong\",\n                    \"signal\"\n                  ]\n                }\n              },\n              \"fields\": {\n                \"context_bundle\": {\n                  \"type\": \"ContextBundleProto\",\n                  \"id\": 1\n                },\n                \"heartbeat_pong\": {\n                  \"type\": \"HeartbeatPong\",\n                  \"id\": 2\n                },\n                \"signal\": {\n                  \"type\": \"StreamSignal\",\n                  \"id\": 3\n                }\n              }\n            },\n            \"HeartbeatPong\": {\n              \"fields\": {\n                \"timestamp_ms\": {\n                  \"type\": \"int64\",\n                  \"id\": 1\n                }\n              }\n            },\n            \"StreamSignal\": {\n              \"fields\": {\n                \"signal_type\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"reason\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"metadata\": {\n                  \"keyType\": \"string\",\n                  \"type\": \"string\",\n                  \"id\": 3\n                }\n              }\n            },\n            \"ContextBundleProto\": {\n              \"fields\": {\n                \"bundle_id\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"decision_id\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"items_by_type\": {\n                  \"keyType\": \"string\",\n                  \"type\": \"ContextItemList\",\n                  \"id\": 3\n                },\n                \"total_tokens\": {\n                  \"type\": \"int32\",\n                  \"id\": 4\n                },\n                \"token_budget\": {\n                  \"type\": \"int32\",\n                  \"id\": 5\n                },\n                \"budget_exceeded\": {\n                  \"type\": \"bool\",\n                  \"id\": 6\n                },\n                \"retrieval_mode\": {\n                  \"type\": \"string\",\n                  \"id\": 7\n                },\n                \"sources_queried\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 8\n                },\n                \"degradation_level\": {\n                  \"type\": \"string\",\n                  \"id\": 9\n                },\n                \"warnings\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 10\n                },\n                \"created_at\": {\n                  \"type\": \"string\",\n                  \"id\": 11\n                },\n                \"retrieval_time_ms\": {\n                  \"type\": \"int32\",\n                  \"id\": 12\n                },\n                \"cache_hit\": {\n                  \"type\": \"bool\",\n                  \"id\": 13\n                },\n                \"search_queries\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 14\n                },\n                \"anticipation_user_id\": {\n                  \"type\": \"string\",\n                  \"id\": 15\n                },\n                \"anticipation_customer_id\": {\n                  \"type\": \"string\",\n                  \"id\": 16\n                },\n                \"anticipation_conversation_id\": {\n                  \"type\": \"string\",\n                  \"id\": 17\n                },\n                \"search_keywords\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"string\",\n                  \"id\": 18\n                },\n                \"bundle_type\": {\n                  \"type\": \"string\",\n                  \"id\": 19\n                },\n                \"conversation_context\": {\n                  \"type\": \"ConversationContextProto\",\n                  \"id\": 20\n                },\n                \"bundle_confidence\": {\n                  \"type\": \"float\",\n                  \"id\": 21\n                },\n                \"origin_pattern_id\": {\n                  \"type\": \"string\",\n                  \"id\": 22\n                },\n                \"ttl_hint_seconds\": {\n                  \"type\": \"int32\",\n                  \"id\": 23\n                },\n                \"anticipation_scope_rung\": {\n                  \"type\": \"string\",\n                  \"id\": 24\n                }\n              }\n            },\n            \"ConversationContextProto\": {\n              \"fields\": {\n                \"summary\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"current_state_json\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"key_extractions_json\": {\n                  \"type\": \"string\",\n                  \"id\": 3\n                },\n                \"recent_turns\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"RecentTurnProto\",\n                  \"id\": 4\n                },\n                \"compaction_id\": {\n                  \"type\": \"string\",\n                  \"id\": 5\n                },\n                \"compacted_at\": {\n                  \"type\": \"string\",\n                  \"id\": 6\n                },\n                \"conversation_id\": {\n                  \"type\": \"string\",\n                  \"id\": 7\n                }\n              }\n            },\n            \"RecentTurnProto\": {\n              \"fields\": {\n                \"role\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"content\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"timestamp\": {\n                  \"type\": \"string\",\n                  \"id\": 3\n                }\n              }\n            },\n            \"ContextItemList\": {\n              \"fields\": {\n                \"items\": {\n                  \"rule\": \"repeated\",\n                  \"type\": \"ContextItemProto\",\n                  \"id\": 1\n                }\n              }\n            },\n            \"ContextItemProto\": {\n              \"fields\": {\n                \"item_id\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"content\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"context_type\": {\n                  \"type\": \"string\",\n                  \"id\": 3\n                },\n                \"source\": {\n                  \"type\": \"string\",\n                  \"id\": 4\n                },\n                \"similarity_score\": {\n                  \"type\": \"float\",\n                  \"id\": 5\n                },\n                \"relevance_score\": {\n                  \"type\": \"float\",\n                  \"id\": 6\n                },\n                \"confidence\": {\n                  \"type\": \"float\",\n                  \"id\": 7\n                },\n                \"scope\": {\n                  \"type\": \"string\",\n                  \"id\": 8\n                },\n                \"entity_id\": {\n                  \"type\": \"string\",\n                  \"id\": 9\n                },\n                \"created_at\": {\n                  \"type\": \"string\",\n                  \"id\": 10\n                },\n                \"event_date\": {\n                  \"type\": \"string\",\n                  \"id\": 11\n                },\n                \"valid_until\": {\n                  \"type\": \"string\",\n                  \"id\": 12\n                },\n                \"temporal_category\": {\n                  \"type\": \"string\",\n                  \"id\": 13\n                },\n                \"temporal_confidence\": {\n                  \"type\": \"float\",\n                  \"id\": 14\n                }\n              }\n            },\n            \"TelemetryEvent\": {\n              \"fields\": {\n                \"event_type\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"instance_id\": {\n                  \"type\": \"string\",\n                  \"id\": 2\n                },\n                \"client_id\": {\n                  \"type\": \"string\",\n                  \"id\": 3\n                },\n                \"correlation_id\": {\n                  \"type\": \"string\",\n                  \"id\": 4\n                },\n                \"timestamp_ms\": {\n                  \"type\": \"int64\",\n                  \"id\": 5\n                },\n                \"latency_ms\": {\n                  \"type\": \"int32\",\n                  \"id\": 6\n                },\n                \"status\": {\n                  \"type\": \"string\",\n                  \"id\": 7\n                },\n                \"error_code\": {\n                  \"type\": \"string\",\n                  \"id\": 8\n                },\n                \"scope\": {\n                  \"type\": \"string\",\n                  \"id\": 9\n                },\n                \"cache_status\": {\n                  \"type\": \"string\",\n                  \"id\": 10\n                },\n                \"attempt\": {\n                  \"type\": \"int32\",\n                  \"id\": 11\n                },\n                \"http_method\": {\n                  \"type\": \"string\",\n                  \"id\": 12\n                },\n                \"http_path\": {\n                  \"type\": \"string\",\n                  \"id\": 13\n                },\n                \"http_status_code\": {\n                  \"type\": \"int32\",\n                  \"id\": 14\n                },\n                \"metadata\": {\n                  \"keyType\": \"string\",\n                  \"type\": \"string\",\n                  \"id\": 15\n                },\n                \"sdk_version\": {\n                  \"type\": \"string\",\n                  \"id\": 16\n                },\n                \"batch_id\": {\n                  \"type\": \"string\",\n                  \"id\": 17\n                }\n              }\n            },\n            \"TelemetryAck\": {\n              \"fields\": {\n                \"status\": {\n                  \"type\": \"string\",\n                  \"id\": 1\n                },\n                \"events_received\": {\n                  \"type\": \"int32\",\n                  \"id\": 2\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n} as const;\n","/**\n * Bidirectional gRPC stream client for the Synap anticipation channel.\n *\n * Mirrors Python's `GRPCTransport` and the synap-vercel-adk client:\n *   - `/synap.v1.SynapService/Listen`, StreamEvent in, StreamResponse out\n *   - Auth via `authorization: Bearer <key>` plus `x-client-id` / `x-instance-id`\n *   - 30s heartbeat, exponential-backoff reconnect\n *   - Server pushes ContextBundleProto, which lands in the AnticipationCache\n *\n * Node-only, and reached exclusively through a lazy `import()` so that merely\n * importing the SDK on Edge or in a Worker stays safe. grpc-js is built on\n * `node:http2`/`node:net`/`node:tls`; a static import fails the BUILD there.\n *\n * The proto arrives as an inlined descriptor (see ./descriptor.ts) rather than\n * being read from disk, so bundlers and Vercel file tracing cannot lose it.\n */\n\nimport type { AnticipationCache } from '../context/anticipation-cache.js';\nimport { SYNAP_PROTO_DESCRIPTOR } from './descriptor.js';\n\nexport type StreamState =\n  | 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'closed';\n\n/**\n * The ONLY bundle type the cache refuses.\n *\n * NOTE: this deliberately differs from the synap-vercel-adk stream client,\n * which caches an allowlist of `anticipation` and `user_summary` and drops\n * compaction updates. Python's `_handle_anticipated_bundle` stores everything\n * except `reactive`, and Python is the reference implementation, so an\n * allowlist here would silently cache less than the pip SDK does.\n *\n * Reactive bundles are excluded because they answer a fetch that already\n * happened; caching one serves a stale answer to a different question.\n */\nconst UNCACHEABLE_BUNDLE_TYPE = 'reactive';\n\n// Mirrors the Python GRPCTransport constants.\nconst MAX_RECONNECT_ATTEMPTS = 10;\nconst BACKOFF_BASE_MS = 1_000;\nconst BACKOFF_MAX_MS = 30_000;\nconst HEARTBEAT_INTERVAL_MS = 30_000;\nconst HEARTBEAT_TIMEOUT_MS = 10_000;\nconst MAX_MISSED_HEARTBEATS = 3;\n/** The server may only SHORTEN the SDK default, never extend it past this floor. */\nconst MIN_TTL_SECONDS = 60;\n\nexport interface StreamCredentials {\n  apiKey: string;\n  clientId: string;\n  instanceId: string;\n}\n\nexport interface StreamClientOptions {\n  host?: string;\n  port?: number;\n  useTls?: boolean;\n  /** Injected in tests so reconnect backoff does not make the suite slow. */\n  sleep?: (ms: number) => Promise<void>;\n  /** How long to wait for the channel to become ready. Default 10s. */\n  connectTimeoutMs?: number;\n  onStateChange?: (state: StreamState) => void;\n  /** Fires for every bundle, before the cache filter. Backs `listen({onContext})`. */\n  onContext?: (bundle: Record<string, unknown>) => void;\n  /** Fires only for `compaction_update` bundles. Backs the compaction subscriptions. */\n  onCompactionUpdate?: (conversationId: string, bundle: Record<string, unknown>) => void;\n}\n\ninterface DuplexCall {\n  write: (msg: unknown) => void;\n  on: (event: string, handler: (arg?: unknown) => void) => void;\n  end: () => void;\n}\n\nexport interface ConversationEventInput {\n  event_type: string;\n  conversation_id?: string;\n  user_id?: string;\n  customer_id?: string;\n  role?: string;\n  content?: string;\n  session_id?: string;\n  metadata?: Record<string, string>;\n  timestamp_ms?: number;\n  /** proto: ConversationEvent.tool_name */\n  tool_name?: string;\n  /** proto: ConversationEvent.tool_args_json. Python sends json.dumps(tool_args). */\n  tool_args_json?: string;\n  search_queries?: string[];\n  context_types?: string[];\n}\n\nexport class GrpcStreamClient {\n  readonly host: string;\n  readonly port: number;\n  readonly useTls: boolean;\n\n  #state: StreamState = 'disconnected';\n  #call: DuplexCall | null = null;\n  #reconnectAttempts = 0;\n  #lastPongAt = 0;\n  #missedHeartbeats = 0;\n  #heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n  #shutdownRequested = false;\n\n  #grpc: typeof import('@grpc/grpc-js') | null = null;\n  #ServiceStub: (new (target: string, creds: unknown, opts: unknown) => Record<string, unknown>) | null = null;\n\n  readonly #credentials: StreamCredentials;\n  readonly #cache: AnticipationCache;\n  readonly #options: StreamClientOptions;\n  readonly #sleep: (ms: number) => Promise<void>;\n  readonly #connectTimeoutMs: number;\n\n  constructor(\n    credentials: StreamCredentials,\n    cache: AnticipationCache,\n    options: StreamClientOptions = {},\n  ) {\n    this.#credentials = credentials;\n    this.#cache = cache;\n    this.#options = options;\n    this.host = options.host ?? 'synap-cloud-prod.maximem.ai';\n    this.port = options.port ?? 443;\n    this.useTls = options.useTls ?? true;\n    this.#sleep = options.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));\n    this.#connectTimeoutMs = options.connectTimeoutMs ?? 10_000;\n  }\n\n  get currentState(): StreamState { return this.#state; }\n  get isConnected(): boolean { return this.#state === 'connected'; }\n\n  async connect(): Promise<void> {\n    await this.#loadGrpc();\n    this.#shutdownRequested = false;\n    await this.#establish();\n    this.#startHeartbeat();\n  }\n\n  async disconnect(): Promise<void> {\n    this.#shutdownRequested = true;\n    this.#stopHeartbeat();\n    this.#closeCall();\n    this.#setState('closed');\n  }\n\n  /** Fire-and-forget: a dropped event must never fail the caller's turn. */\n  sendConversationEvent(event: ConversationEventInput): void {\n    this.#write({ conversation_event: { ...event } });\n  }\n\n  sendSessionControl(input: {\n    action: string;\n    session_id?: string;\n    conversation_id?: string;\n    user_id?: string;\n    customer_id?: string;\n  }): void {\n    this.#write({ session_control: { ...input } });\n  }\n\n  sendContextUsed(event: Record<string, unknown>): void {\n    this.#write({ context_used: { ...event } });\n  }\n\n  sendContextAssembled(event: Record<string, unknown>): void {\n    this.#write({ context_assembled: { ...event } });\n  }\n\n  #write(msg: unknown): void {\n    if (!this.isConnected || this.#call === null) return;\n    try {\n      this.#call.write(msg);\n    } catch {\n      // Non-fatal. These are telemetry and control events; losing one is\n      // strictly better than surfacing a stream hiccup to the caller.\n    }\n  }\n\n  async #loadGrpc(): Promise<void> {\n    if (this.#grpc !== null) return;\n    const [grpcMod, protoMod] = await Promise.all([\n      import(/* @vite-ignore */ '@grpc/grpc-js'),\n      import(/* @vite-ignore */ '@grpc/proto-loader'),\n    ]);\n    this.#grpc = grpcMod;\n\n    // `fromJSON`, not `loadSync`: no path, no disk read, nothing for a bundler\n    // to fail to trace. `keepCase` keeps the snake_case field names the server\n    // and the Python SDK both use.\n    const pkgDef = protoMod.fromJSON(\n      SYNAP_PROTO_DESCRIPTOR as unknown as Parameters<typeof protoMod.fromJSON>[0],\n      { keepCase: true, longs: Number, enums: String, defaults: true, oneofs: true },\n    );\n    const pkg = grpcMod.loadPackageDefinition(pkgDef) as unknown as {\n      synap: { v1: { SynapService: new (t: string, c: unknown, o: unknown) => Record<string, unknown> } };\n    };\n    this.#ServiceStub = pkg.synap.v1.SynapService;\n  }\n\n  async #establish(): Promise<void> {\n    this.#setState('connecting');\n    const grpc = this.#grpc;\n    const Stub = this.#ServiceStub;\n    if (grpc === null || Stub === null) throw new Error('gRPC not loaded');\n\n    const channelCreds = this.useTls\n      ? grpc.credentials.createSsl()\n      : grpc.credentials.createInsecure();\n\n    const stub = new Stub(`${this.host}:${this.port}`, channelCreds, {\n      'grpc.keepalive_time_ms': 30_000,\n      'grpc.keepalive_timeout_ms': 10_000,\n      'grpc.keepalive_permit_without_calls': 1,\n    });\n\n    // Wait for the channel before reporting success.\n    //\n    // grpc-js connects LAZILY: constructing the stub and creating the call both\n    // return immediately, and a bad host surfaces later through the call's\n    // 'error' event. Without this, `await listen()` resolved against an\n    // unreachable port, `is_listening` read true for a stream that never\n    // connected, and `send_message()` then dropped every event silently,\n    // because sends are deliberately fire-and-forget. Failing loudly here is\n    // the difference between a clear error and an agent that looks like it has\n    // no memory.\n    await new Promise<void>((resolve, reject) => {\n      const deadline = new Date(Date.now() + this.#connectTimeoutMs);\n      const waitForReady = (stub as unknown as {\n        waitForReady?: (d: Date, cb: (e?: Error) => void) => void;\n      }).waitForReady;\n      if (typeof waitForReady !== 'function') {\n        // Older grpc-js, or a stub that does not expose it. Fall back to the\n        // lazy behaviour rather than failing outright.\n        resolve();\n        return;\n      }\n      waitForReady.call(stub, deadline, (error?: Error) => {\n        if (error) reject(error);\n        else resolve();\n      });\n    });\n\n    const metadata = new grpc.Metadata();\n    metadata.add('authorization', `Bearer ${this.#credentials.apiKey}`);\n    metadata.add('x-client-id', this.#credentials.clientId);\n    metadata.add('x-instance-id', this.#credentials.instanceId);\n\n    const call = (stub['Listen'] as (m: unknown) => DuplexCall)(metadata);\n    call.on('data', (msg) => this.#handleMessage(msg as Record<string, unknown>));\n    call.on('error', (err) => { void this.#handleDisconnect(`error: ${String(err)}`); });\n    call.on('end', () => { void this.#handleDisconnect('server_close'); });\n\n    this.#call = call;\n    this.#setState('connected');\n    this.#reconnectAttempts = 0;\n    this.#lastPongAt = Date.now();\n  }\n\n  #handleMessage(msg: Record<string, unknown>): void {\n    if (msg['context_bundle']) {\n      this.#handleBundle(msg['context_bundle'] as Record<string, unknown>);\n      return;\n    }\n    if (msg['heartbeat_pong']) {\n      this.#lastPongAt = Date.now();\n      this.#missedHeartbeats = 0;\n      return;\n    }\n    const signal = msg['signal'] as { signal_type?: string } | undefined;\n    if (signal?.signal_type === 'closing') {\n      void this.#handleDisconnect('server_signal_closing');\n    }\n  }\n\n  #handleBundle(bundle: Record<string, unknown>): void {\n    const bundleType = String(bundle['bundle_type'] ?? '') || 'anticipation';\n    const conversationId = String(bundle['anticipation_conversation_id'] ?? '');\n\n    if (bundleType !== UNCACHEABLE_BUNDLE_TYPE) this.#store(bundle, bundleType, conversationId);\n\n    if (bundleType === 'compaction_update' && conversationId !== '') {\n      // Python also deletes this conversation's `compacted_full` /\n      // `compacted_context` entries from its separate CacheManager. This SDK\n      // has no such cache, and calling dropConversation() here would delete\n      // the bundle just stored above, so there is nothing to invalidate.\n      this.#options.onCompactionUpdate?.(conversationId, bundle);\n    }\n\n    // Fires for every type, after storing, matching Python's ordering.\n    this.#options.onContext?.(bundle);\n  }\n\n  #store(bundle: Record<string, unknown>, bundleType: string, conversationId: string): void {\n    const itemsByType: Record<string, Array<Record<string, unknown>>> = {};\n    for (const [type, list] of Object.entries(bundle['items_by_type'] ?? {})) {\n      const items = (list as { items?: Array<Record<string, unknown>> })?.items;\n      itemsByType[type] = items ?? [];\n    }\n\n    const ttlHint = Number(bundle['ttl_hint_seconds'] ?? 0);\n    this.#cache.store({\n      bundleId: String(bundle['bundle_id'] ?? ''),\n      // The cache keys on ONE entity. User id wins when present, so a bundle\n      // pushed for a user cannot be served to a different user in the same\n      // customer; falling back to customer id keeps org-scope bundles usable.\n      entityId:\n        String(bundle['anticipation_user_id'] ?? '') ||\n        String(bundle['anticipation_customer_id'] ?? '') ||\n        null,\n      conversationId: conversationId || null,\n      // The rung the server retrieved this bundle at. Absent from anything an\n      // older server sent, and absent reads as \"named no rung\" rather than as\n      // \"matches anything\".\n      scopeRung: String(bundle['anticipation_scope_rung'] ?? '') || null,\n      itemsByType,\n      // 0 means \"use the SDK default\"; anything else is floored at 60s.\n      ttlHintSeconds: ttlHint > 0 ? Math.max(ttlHint, MIN_TTL_SECONDS) : null,\n      bundleType,\n      searchQueries: [\n        ...((bundle['search_queries'] as string[] | undefined) ?? []),\n        ...((bundle['search_keywords'] as string[] | undefined) ?? []),\n      ],\n    });\n  }\n\n  async #handleDisconnect(_reason: string): Promise<void> {\n    if (this.#shutdownRequested) return;\n\n    this.#closeCall();\n    this.#setState('reconnecting');\n\n    if (this.#reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {\n      this.#setState('disconnected');\n      return;\n    }\n\n    // Jittered exponential backoff. The jitter matters with many SDK instances\n    // behind one deploy: without it they all retry in lockstep.\n    const delay = Math.min(\n      BACKOFF_BASE_MS * 2 ** this.#reconnectAttempts + Math.random() * 1_000,\n      BACKOFF_MAX_MS,\n    );\n    this.#reconnectAttempts += 1;\n\n    await this.#sleep(delay);\n    if (this.#shutdownRequested) return;\n    try {\n      await this.#establish();\n    } catch {\n      void this.#handleDisconnect('reconnect_failed');\n    }\n  }\n\n  #startHeartbeat(): void {\n    this.#heartbeatTimer = setInterval(() => {\n      if (!this.isConnected || this.#call === null) return;\n      const now = Date.now();\n\n      if (now - this.#lastPongAt > HEARTBEAT_TIMEOUT_MS) {\n        this.#missedHeartbeats += 1;\n        if (this.#missedHeartbeats >= MAX_MISSED_HEARTBEATS) {\n          void this.#handleDisconnect('heartbeat_timeout');\n          return;\n        }\n      }\n      try {\n        this.#call.write({ heartbeat_ping: { timestamp_ms: now } });\n      } catch {\n        void this.#handleDisconnect('heartbeat_write_error');\n      }\n    }, HEARTBEAT_INTERVAL_MS);\n    // Never hold the process open on the heartbeat alone: a CLI that finishes\n    // its work should exit, not hang for 30s.\n    this.#heartbeatTimer.unref?.();\n  }\n\n  #stopHeartbeat(): void {\n    if (this.#heartbeatTimer !== null) {\n      clearInterval(this.#heartbeatTimer);\n      this.#heartbeatTimer = null;\n    }\n  }\n\n  #closeCall(): void {\n    try {\n      this.#call?.end();\n    } catch {\n      /* already torn down */\n    }\n    this.#call = null;\n  }\n\n  #setState(state: StreamState): void {\n    this.#state = state;\n    this.#options.onStateChange?.(state);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-RB57I2IQ.cjs → chunk-T6U5PVAD.cjs}

@@ -269,6 +269,89 @@ var anticipation_default = {
       note: "Rejected items reported per lookup, highest score first, so a large cache cannot bloat the payload."
     },
     content_preview_chars: 120
+  },
+  rung_key: {
+    $comment: "SOURCE OF TRUTH for how a scope rung is written on the wire and compared in both SDK anticipation caches. The server stamps a pushed bundle with this string (ContextBundleProto.anticipation_scope_rung) and each SDK builds the same string from the `scope` path its own fetch names; a bundle is servable only when the two agree. Three implementations exist by necessity (server Python, SDK Python, SDK TypeScript) because the producer is not an SDK, so the vectors below are what stops them drifting.",
+    note: "Node ids are deliberately not what travels. They are registry surrogates and an SDK in a customer's process has never seen one; a caller names a rung with level keys and its own external ids, so that is the vocabulary the comparison happens in. Level keys are ^[a-z][a-z0-9_]{0,63}$ so they can hold neither separator and only the value needs escaping.",
+    separator: "|",
+    assign: "=",
+    sort: "by level key, ascending, plain codepoint order",
+    escapes: {
+      "\\": "\\\\",
+      "|": "\\p",
+      "=": "\\e"
+    },
+    escape_order: "backslash first. Reversing it makes `a|b` and `a\\pb` encode to the same string, which is a false match between two different rungs.",
+    absent: "null (an empty proto string on the wire) means the bundle or the request named no rung. Serving requires the two to be EQUAL, so absent matches only absent. That leaves every client without nested scoping byte-identical to today and refuses every genuinely cross-rung serve; the cost of the rule being wrong is a cold fetch, and the cost of a subset rule being wrong is one person's context handed to another.",
+    vectors: [
+      {
+        path: {},
+        key: null,
+        note: "no path named"
+      },
+      {
+        path: {
+          customer: "acme"
+        },
+        key: "customer=acme"
+      },
+      {
+        path: {
+          customer: "acme",
+          team: "payments",
+          user: "dana"
+        },
+        key: "customer=acme|team=payments|user=dana"
+      },
+      {
+        path: {
+          user: "dana",
+          team: "payments",
+          customer: "acme"
+        },
+        key: "customer=acme|team=payments|user=dana",
+        note: "insertion order must not change the key; a dict has whatever order the caller wrote and ladder order is not available here"
+      },
+      {
+        path: {
+          customer: "a|b"
+        },
+        key: "customer=a\\pb"
+      },
+      {
+        path: {
+          customer: "a=b"
+        },
+        key: "customer=a\\eb"
+      },
+      {
+        path: {
+          customer: "a\\b"
+        },
+        key: "customer=a\\\\b"
+      },
+      {
+        path: {
+          customer: "a\\pb"
+        },
+        key: "customer=a\\\\pb",
+        note: "the escape-order case: this must NOT collide with a|b above"
+      },
+      {
+        path: {
+          customer: "ab"
+        },
+        key: "customer=ab"
+      },
+      {
+        path: {
+          customer: "a",
+          b: "c"
+        },
+        key: "b=c|customer=a",
+        note: "sorted by key, so `customer=ab` and this cannot collapse"
+      }
+    ]
   }
 };
 
@@ -395,6 +478,25 @@ var QUERY_TOKEN_SCALE = CONTRACT.thresholds.query_token_scale.value;
 var REJECTED_CAP = CONTRACT.telemetry.rejected_items_cap.value;
 var PREVIEW_CHARS = CONTRACT.telemetry.content_preview_chars;
 var ANY_SCOPE = "_any";
+var RUNG_SEPARATOR = "|";
+var RUNG_ASSIGN = "=";
+function rungKey(scopePath) {
+  if (!scopePath) return null;
+  const pairs = [];
+  for (const [k, v] of Object.entries(scopePath)) {
+    if (k === "" || v === null || v === void 0 || String(v) === "") continue;
+    pairs.push([String(k), String(v)]);
+  }
+  if (pairs.length === 0) return null;
+  pairs.sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0);
+  return pairs.map(([k, v]) => {
+    const escaped = v.split("\\").join("\\\\").split(RUNG_SEPARATOR).join("\\p").split(RUNG_ASSIGN).join("\\e");
+    return `${k}${RUNG_ASSIGN}${escaped}`;
+  }).join(RUNG_SEPARATOR);
+}
+function rungServes(bundleRung, requestRung) {
+  return (bundleRung || null) === (requestRung || null);
+}
 var DEFAULT_TTL_SECONDS = 1800;
 var DEFAULT_MAX_BUNDLES = 50;
 var AnticipationCache = (_class2 = class {
@@ -433,7 +535,8 @@ var AnticipationCache = (_class2 = class {
       searchQueries: [..._nullishCoalesce(bundle.searchQueries, () => ( []))],
       storedAt: now,
       createdAt: now,
-      ttlHintSeconds: _nullishCoalesce(bundle.ttlHintSeconds, () => ( null))
+      ttlHintSeconds: _nullishCoalesce(bundle.ttlHintSeconds, () => ( null)),
+      scopeRung: bundle.scopeRung || null
     });
     for (const [itemType, list] of Object.entries(_nullishCoalesce(bundle.itemsByType, () => ( {})))) {
       for (const item of _nullishCoalesce(list, () => ( []))) {
@@ -460,6 +563,7 @@ var AnticipationCache = (_class2 = class {
       customerId = null,
       clientId = null,
       conversationId = null,
+      scopeRung = null,
       maxItems = 10
     } = params;
     this.evictExpired();
@@ -470,6 +574,7 @@ var AnticipationCache = (_class2 = class {
       customerId,
       clientId,
       conversationId,
+      scopeRung: _nullishCoalesce(scopeRung, () => ( null)),
       scopeFilterAccepted: [...accepted].sort(),
       novelTermRatio: null,
       bm25Threshold: null,
@@ -485,7 +590,7 @@ var AnticipationCache = (_class2 = class {
     }
     const hasQuery = (_nullishCoalesce(searchQuery, () => ( []))).some((q) => q && q.trim() !== "");
     if (!hasQuery) {
-      return this.freshnessLookup(entityId, maxItems, telemetry);
+      return this.freshnessLookup(entityId, _nullishCoalesce(scopeRung, () => ( null)), maxItems, telemetry);
     }
     if (_chunkZKOJDUN4cjs.getEnvFlag.call(void 0, CONTRACT.recall_bypass.env_flag) && isRecallQuery(searchQuery)) {
       return this.miss(telemetry, "recall_bypass");
@@ -509,7 +614,7 @@ var AnticipationCache = (_class2 = class {
       this.bm25Dirty = false;
     }
     const scores = this.bm25.scores(queryTokens);
-    const validBundles = this.getValidBundleIds(accepted, conversationId);
+    const validBundles = this.getValidBundleIds(accepted, conversationId, _nullishCoalesce(scopeRung, () => ( null)));
     const effectiveThreshold = Math.max(
       EFFECTIVE_FLOOR,
       Math.min(THRESHOLDS.bm25, QUERY_TOKEN_SCALE * queryTokens.length)
@@ -683,12 +788,13 @@ var AnticipationCache = (_class2 = class {
    * for exactly that reason: the permissive version could splice user A's
    * summary into user B's response on the conversation-scope path.
    */
-  lookupUserSummary(entityId) {
+  lookupUserSummary(entityId, scopeRung = null) {
     if (!entityId) return null;
     this.evictExpired();
     let freshest = null;
     for (const entry of this.entries.values()) {
       if (entry.bundleType !== "user_summary") continue;
+      if (!rungServes(entry.scopeRung, scopeRung)) continue;
       if (entry.entityId !== entityId && entry.entityId !== ANY_SCOPE) continue;
       if (freshest === null || entry.storedAt > freshest.storedAt) freshest = entry;
     }
@@ -749,8 +855,8 @@ var AnticipationCache = (_class2 = class {
     } catch (e2) {
     }
   }
-  freshnessLookup(entityId, maxItems, telemetry) {
-    const candidates = [...this.entries.values()].filter((e) => entityId === null || e.entityId === entityId || e.entityId === ANY_SCOPE).sort((a, b) => b.storedAt - a.storedAt);
+  freshnessLookup(entityId, scopeRung, maxItems, telemetry) {
+    const candidates = [...this.entries.values()].filter((e) => rungServes(e.scopeRung, scopeRung)).filter((e) => entityId === null || e.entityId === entityId || e.entityId === ANY_SCOPE).sort((a, b) => b.storedAt - a.storedAt);
     if (candidates.length === 0) return this.miss(telemetry, "empty");
     const newest = candidates[0];
     const itemsByType = {};
@@ -781,9 +887,17 @@ var AnticipationCache = (_class2 = class {
     if (clientId) accepted.add(clientId);
     return accepted;
   }
-  getValidBundleIds(accepted, conversationId) {
+  /**
+   * The rung is checked FIRST and it never widens. Everything else here widens
+   * deliberately: a user-scope request reaches customer-shared bundles, and a
+   * conversation-scope request reaches user-scope ones. A rung is the opposite
+   * kind of thing, so it is checked before the tiers and no amount of widening
+   * can put a cross-rung bundle back in.
+   */
+  getValidBundleIds(accepted, conversationId, scopeRung) {
     const valid = /* @__PURE__ */ new Set();
     for (const entry of this.entries.values()) {
+      if (!rungServes(entry.scopeRung, scopeRung)) continue;
       if (!accepted.has(entry.entityId)) continue;
       if (entry.conversationId && conversationId && entry.conversationId !== conversationId) continue;
       valid.add(entry.bundleId);
@@ -828,5 +942,7 @@ function round4(n) {
 
 
 
-exports.CONTRACT = CONTRACT; exports.THRESHOLDS = THRESHOLDS; exports.isRecallQuery = isRecallQuery; exports.stem = stem; exports.tokenize = tokenize; exports.BM25 = BM25; exports.ANY_SCOPE = ANY_SCOPE; exports.AnticipationCache = AnticipationCache;
-//# sourceMappingURL=chunk-RB57I2IQ.cjs.map
+
+
+exports.CONTRACT = CONTRACT; exports.THRESHOLDS = THRESHOLDS; exports.isRecallQuery = isRecallQuery; exports.stem = stem; exports.tokenize = tokenize; exports.BM25 = BM25; exports.ANY_SCOPE = ANY_SCOPE; exports.rungKey = rungKey; exports.rungServes = rungServes; exports.AnticipationCache = AnticipationCache;
+//# sourceMappingURL=chunk-T6U5PVAD.cjs.map