@maximem/synap-js-sdk 0.5.6 → 0.5.7

package/dist/chunk-T372OL3Q.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/chunk-T372OL3Q.cjs","../src/errors.ts","../src/util/correlation.ts"],"names":[],"mappings":"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","file":"/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/chunk-T372OL3Q.cjs","sourcesContent":[null,"/**\n * Synap SDK error taxonomy.\n *\n * Mirrors `maximem_synap/models/errors.py` 1:1, including the four\n * backward-compatibility aliases at the bottom. If you add an error to one\n * SDK, add it to the other in the same change.\n *\n * ## Why every error carries a `.code`\n *\n * This package ships dual ESM + CJS. A consumer whose dependency graph pulls\n * in both formats gets *two* copies of every class in this file, and then:\n *\n *     try { ... } catch (e) { if (e instanceof SynapError) { ... } }\n *\n * silently evaluates to `false` against the copy from the other format. Error\n * handling stops working and nothing throws to tell you. `.code` is a plain\n * string, so it is immune. Prefer it at package boundaries:\n *\n *     if (isSynapError(e) && e.code === 'rate_limit') { ... }\n *\n * `Symbol.hasInstance` is also wired up on the base class, so `instanceof`\n * works across realms too -- but `.code` is the documented contract.\n */\n\n/** Stable, format-independent discriminators. Never renumber or reuse. */\nexport type SynapErrorCode =\n  | 'synap_error'\n  | 'transient'\n  | 'permanent'\n  | 'network_timeout'\n  | 'rate_limit'\n  | 'insufficient_credits'\n  | 'service_unavailable'\n  | 'invalid_input'\n  | 'invalid_instance_id'\n  | 'invalid_conversation_id'\n  | 'authentication'\n  | 'context_not_found'\n  | 'conflict'\n  | 'transcript_conflict'\n  | 'session_expired'\n  | 'listening_already_active'\n  | 'listening_not_active'\n  | 'agent_unavailable';\n\nconst BRAND = Symbol.for('@maximem/synap-js-sdk.SynapError');\n\nexport interface SynapErrorOptions {\n  correlationId?: string | null;\n  cause?: unknown;\n}\n\nexport class SynapError extends Error {\n  /**\n   * The single declaration site for each subclass's code.\n   *\n   * It is `static` rather than a class field on purpose. Under\n   * `useDefineForClassFields` (the default at our ES2022 target) a class field\n   * is an *instance* property, so it is invisible from the constructor object.\n   * `Symbol.hasInstance` below only has the constructor to work with, so a\n   * field would leave it unable to tell `AuthenticationError` from\n   * `RateLimitError` -- it would report every Synap error as an instance of\n   * every other one.\n   */\n  static readonly errorCode: SynapErrorCode = 'synap_error';\n  /** True for errors where a retry may succeed. Static for the same reason. */\n  static readonly isTransient: boolean = false;\n\n  /** Own, enumerable, so logs and JSON.stringify include it. */\n  readonly code: SynapErrorCode;\n  readonly correlationId: string | null;\n  readonly transient: boolean;\n\n  constructor(message: string, options: SynapErrorOptions = {}) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    const ctor = new.target as typeof SynapError;\n    this.name = new.target.name;\n    this.code = ctor.errorCode;\n    this.transient = ctor.isTransient;\n    this.correlationId = options.correlationId ?? null;\n    Object.defineProperty(this, BRAND, { value: true, enumerable: false });\n    // Without this, subclassing a built-in under a downlevel target breaks the\n    // prototype chain and `instanceof` fails even within a single copy.\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static override [Symbol.hasInstance](instance: unknown): boolean {\n    if (instance === null || typeof instance !== 'object') return false;\n    // Cross-realm / dual-format tolerant: identify by brand, then narrow by the\n    // subclass's own code so `e instanceof RateLimitError` stays meaningful.\n    if (!(BRAND in instance)) return false;\n    const expected = (this as unknown as { errorCode?: SynapErrorCode }).errorCode;\n    // Called on something that is not one of our classes: fall back to the brand.\n    if (expected === undefined) return true;\n    // Everything branded descends from the root.\n    if (expected === 'synap_error') return true;\n    const actual = (instance as { code?: string }).code;\n    return actual === expected || descendsFrom(actual, expected);\n  }\n}\n\n/** Type guard that works across ESM/CJS copies and realms. */\nexport function isSynapError(e: unknown): e is SynapError {\n  return typeof e === 'object' && e !== null && BRAND in e;\n}\n\nexport class SynapTransientError extends SynapError {\n  static override readonly errorCode: SynapErrorCode = 'transient';\n  static override readonly isTransient: boolean = true;\n}\n\nexport class SynapPermanentError extends SynapError {\n  static override readonly errorCode: SynapErrorCode = 'permanent';\n  static override readonly isTransient: boolean = false;\n}\n\n// ─── Transient ────────────────────────────────────────────────────────────────\n\nexport class NetworkTimeoutError extends SynapTransientError {\n  static override readonly errorCode: SynapErrorCode = 'network_timeout';\n}\n\n/**\n * Rate limit exceeded (HTTP 429, gRPC RESOURCE_EXHAUSTED).\n *\n * Also carries the two credit stops the server reports as 429, because both\n * recover with time or a plan change rather than with a retry of this request:\n * `reason: 'trial_limit_reached'` (the Trial cap is spent, see `upgradeUrl`)\n * and `reason: 'subscription_inactive'` (a paid plan whose subscription is past\n * due, unpaid or cancelled, see `manageUrl`). `reason` is null for an ordinary\n * rate limit and against a server too old to send one.\n */\nexport class RateLimitError extends SynapTransientError {\n  static override readonly errorCode: SynapErrorCode = 'rate_limit';\n  readonly retryAfterSeconds: number | null;\n  /** Machine-readable cause, when the stop was a credit stop. */\n  readonly reason: string | null;\n  /** Where a Trial customer upgrades. Python calls this `upgrade_url`. */\n  readonly upgradeUrl: string | null;\n  /** Where billing is managed. Python calls this `manage_url`. */\n  readonly manageUrl: string | null;\n\n  constructor(\n    message: string,\n    options: SynapErrorOptions & {\n      retryAfterSeconds?: number | null;\n      reason?: string | null;\n      upgradeUrl?: string | null;\n      manageUrl?: string | null;\n    } = {},\n  ) {\n    super(message, options);\n    this.retryAfterSeconds = options.retryAfterSeconds ?? null;\n    this.reason = options.reason ?? null;\n    this.upgradeUrl = options.upgradeUrl ?? null;\n    this.manageUrl = options.manageUrl ?? null;\n  }\n}\n\nexport class ServiceUnavailableError extends SynapTransientError {\n  static override readonly errorCode: SynapErrorCode = 'service_unavailable';\n}\n\nexport class AgentUnavailableError extends SynapTransientError {\n  static override readonly errorCode: SynapErrorCode = 'agent_unavailable';\n  constructor(message = 'Agent unavailable', options: SynapErrorOptions = {}) {\n    super(message, options);\n  }\n}\n\n// ─── Permanent ────────────────────────────────────────────────────────────────\n\n/**\n * The caller's credit wallet cannot cover this request.\n *\n * HTTP 402, and gRPC RESOURCE_EXHAUSTED with credit-related trailing metadata.\n * Permanent by design: retrying without topping up burns quota and never\n * succeeds. This is the error behind \"the agent forgot\" reports where retrieval\n * silently returns nothing.\n */\nexport class InsufficientCreditsError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'insufficient_credits';\n  readonly balanceCredits: number | null;\n  readonly requiredCredits: number | null;\n  /** Where the balance can be viewed. Python calls this `recovery_url`. */\n  readonly recoveryUrl: string | null;\n  /** Where a redeem code can be entered. Python calls this `redeem_url`. */\n  readonly redeemUrl: string | null;\n  /**\n   * Machine-readable cause. `'overages_disabled'` means the plan is paid and\n   * the balance is spent, but the account has not allowed usage past zero, so\n   * the work stops until someone allows overages or adds credits. Null when an\n   * older server did not send one.\n   */\n  readonly reason: string | null;\n  /** Where that setting and billing are managed. Python calls this `manage_url`. */\n  readonly manageUrl: string | null;\n\n  constructor(\n    message: string,\n    options: SynapErrorOptions & {\n      balanceCredits?: number | null;\n      requiredCredits?: number | null;\n      recoveryUrl?: string | null;\n      redeemUrl?: string | null;\n      reason?: string | null;\n      manageUrl?: string | null;\n    } = {},\n  ) {\n    super(message, options);\n    this.balanceCredits = options.balanceCredits ?? null;\n    this.requiredCredits = options.requiredCredits ?? null;\n    this.recoveryUrl = options.recoveryUrl ?? null;\n    this.redeemUrl = options.redeemUrl ?? null;\n    this.reason = options.reason ?? null;\n    this.manageUrl = options.manageUrl ?? null;\n  }\n}\n\nexport class InvalidInputError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'invalid_input';\n}\n\n/**\n * Raised by `validateInstanceId` before any network call, matching Python's\n * `utils/validators.py`. The message text is identical in both SDKs.\n */\nexport class InvalidInstanceIdError extends InvalidInputError {\n  static override readonly errorCode: SynapErrorCode = 'invalid_instance_id';\n}\n\n/** See the note on InvalidInstanceIdError. Raised by `validateConversationId`. */\nexport class InvalidConversationIdError extends InvalidInputError {\n  static override readonly errorCode: SynapErrorCode = 'invalid_conversation_id';\n}\n\nexport class AuthenticationError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'authentication';\n}\n\nexport class ContextNotFoundError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'context_not_found';\n}\n\nexport class ConflictError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'conflict';\n}\n\nexport class TranscriptConflictError extends ConflictError {\n  static override readonly errorCode: SynapErrorCode = 'transcript_conflict';\n}\n\nexport class SessionExpiredError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'session_expired';\n}\n\nexport class ListeningAlreadyActiveError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'listening_already_active';\n}\n\nexport class ListeningNotActiveError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'listening_not_active';\n}\n\n// ─── Hierarchy metadata (drives the cross-copy instanceof above) ──────────────\n\nconst PARENT: Partial<Record<SynapErrorCode, SynapErrorCode>> = {\n  transient: 'synap_error',\n  permanent: 'synap_error',\n  network_timeout: 'transient',\n  rate_limit: 'transient',\n  service_unavailable: 'transient',\n  agent_unavailable: 'transient',\n  insufficient_credits: 'permanent',\n  invalid_input: 'permanent',\n  invalid_instance_id: 'invalid_input',\n  invalid_conversation_id: 'invalid_input',\n  authentication: 'permanent',\n  context_not_found: 'permanent',\n  conflict: 'permanent',\n  transcript_conflict: 'conflict',\n  session_expired: 'permanent',\n  listening_already_active: 'permanent',\n  listening_not_active: 'permanent',\n};\n\nfunction descendsFrom(actual: string | undefined, expected: string): boolean {\n  let cur = actual as SynapErrorCode | undefined;\n  const seen = new Set<string>();\n  while (cur && !seen.has(cur)) {\n    seen.add(cur);\n    if (cur === expected) return true;\n    cur = PARENT[cur];\n  }\n  return false;\n}\n\n// ─── Backward-compatibility aliases (mirrors the tail of errors.py) ──────────\n// `ConnectionError` deliberately shadows the global in a module scope. Python\n// does the same thing; keeping the name means ported code reads identically.\n\nexport const SDKError = SynapError;\nexport const TransientError = SynapTransientError;\nexport const PermanentError = SynapPermanentError;\nexport const ConnectionError = NetworkTimeoutError;\n","/**\n * Correlation ID generation.\n *\n * `globalThis.crypto` is unflagged from Node 19 onward and this package\n * declares `engines.node >= 20`, so `randomUUID` is normally present. It is\n * still feature-detected rather than assumed, because `engines` is advisory:\n * npm warns and installs anyway, and the SDK also runs on Workers, Edge and\n * Bun, where the available crypto surface varies.\n *\n * Deliberately does NOT import `node:crypto`. That import is what breaks Edge\n * and Workers builds at bundle time, and a correlation ID is not a security\n * value, so there is nothing to gain from it.\n */\nexport function newCorrelationId(): string {\n  const c = globalThis.crypto;\n  if (typeof c?.randomUUID === 'function') return c.randomUUID();\n\n  if (typeof c?.getRandomValues === 'function') {\n    const b = c.getRandomValues(new Uint8Array(16));\n    // RFC 4122 version (4) and variant bits. The `?? 0` guards satisfy\n    // `noUncheckedIndexedAccess`; a 16-byte array always has these slots.\n    b[6] = ((b[6] ?? 0) & 0x0f) | 0x40;\n    b[8] = ((b[8] ?? 0) & 0x3f) | 0x80;\n    const h = Array.from(b, (x) => x.toString(16).padStart(2, '0')).join('');\n    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;\n  }\n\n  // Last resort. Correlation IDs are for tracing only, never for security, so\n  // Math.random is acceptable here and only here.\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n  });\n}\n"]}
+{"version":3,"sources":["/Users/scaler/maximem_synap/synap/sdk/js/dist/chunk-T372OL3Q.cjs","../src/errors.ts","../src/util/correlation.ts"],"names":[],"mappings":"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","file":"/Users/scaler/maximem_synap/synap/sdk/js/dist/chunk-T372OL3Q.cjs","sourcesContent":[null,"/**\n * Synap SDK error taxonomy.\n *\n * Mirrors `maximem_synap/models/errors.py` 1:1, including the four\n * backward-compatibility aliases at the bottom. If you add an error to one\n * SDK, add it to the other in the same change.\n *\n * ## Why every error carries a `.code`\n *\n * This package ships dual ESM + CJS. A consumer whose dependency graph pulls\n * in both formats gets *two* copies of every class in this file, and then:\n *\n *     try { ... } catch (e) { if (e instanceof SynapError) { ... } }\n *\n * silently evaluates to `false` against the copy from the other format. Error\n * handling stops working and nothing throws to tell you. `.code` is a plain\n * string, so it is immune. Prefer it at package boundaries:\n *\n *     if (isSynapError(e) && e.code === 'rate_limit') { ... }\n *\n * `Symbol.hasInstance` is also wired up on the base class, so `instanceof`\n * works across realms too -- but `.code` is the documented contract.\n */\n\n/** Stable, format-independent discriminators. Never renumber or reuse. */\nexport type SynapErrorCode =\n  | 'synap_error'\n  | 'transient'\n  | 'permanent'\n  | 'network_timeout'\n  | 'rate_limit'\n  | 'insufficient_credits'\n  | 'service_unavailable'\n  | 'invalid_input'\n  | 'invalid_instance_id'\n  | 'invalid_conversation_id'\n  | 'authentication'\n  | 'context_not_found'\n  | 'conflict'\n  | 'transcript_conflict'\n  | 'session_expired'\n  | 'listening_already_active'\n  | 'listening_not_active'\n  | 'agent_unavailable';\n\nconst BRAND = Symbol.for('@maximem/synap-js-sdk.SynapError');\n\nexport interface SynapErrorOptions {\n  correlationId?: string | null;\n  cause?: unknown;\n}\n\nexport class SynapError extends Error {\n  /**\n   * The single declaration site for each subclass's code.\n   *\n   * It is `static` rather than a class field on purpose. Under\n   * `useDefineForClassFields` (the default at our ES2022 target) a class field\n   * is an *instance* property, so it is invisible from the constructor object.\n   * `Symbol.hasInstance` below only has the constructor to work with, so a\n   * field would leave it unable to tell `AuthenticationError` from\n   * `RateLimitError` -- it would report every Synap error as an instance of\n   * every other one.\n   */\n  static readonly errorCode: SynapErrorCode = 'synap_error';\n  /** True for errors where a retry may succeed. Static for the same reason. */\n  static readonly isTransient: boolean = false;\n\n  /** Own, enumerable, so logs and JSON.stringify include it. */\n  readonly code: SynapErrorCode;\n  readonly correlationId: string | null;\n  readonly transient: boolean;\n\n  constructor(message: string, options: SynapErrorOptions = {}) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    const ctor = new.target as typeof SynapError;\n    this.name = new.target.name;\n    this.code = ctor.errorCode;\n    this.transient = ctor.isTransient;\n    this.correlationId = options.correlationId ?? null;\n    Object.defineProperty(this, BRAND, { value: true, enumerable: false });\n    // Without this, subclassing a built-in under a downlevel target breaks the\n    // prototype chain and `instanceof` fails even within a single copy.\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static override [Symbol.hasInstance](instance: unknown): boolean {\n    if (instance === null || typeof instance !== 'object') return false;\n    // Cross-realm / dual-format tolerant: identify by brand, then narrow by the\n    // subclass's own code so `e instanceof RateLimitError` stays meaningful.\n    if (!(BRAND in instance)) return false;\n    const expected = (this as unknown as { errorCode?: SynapErrorCode }).errorCode;\n    // Called on something that is not one of our classes: fall back to the brand.\n    if (expected === undefined) return true;\n    // Everything branded descends from the root.\n    if (expected === 'synap_error') return true;\n    const actual = (instance as { code?: string }).code;\n    return actual === expected || descendsFrom(actual, expected);\n  }\n}\n\n/** Type guard that works across ESM/CJS copies and realms. */\nexport function isSynapError(e: unknown): e is SynapError {\n  return typeof e === 'object' && e !== null && BRAND in e;\n}\n\nexport class SynapTransientError extends SynapError {\n  static override readonly errorCode: SynapErrorCode = 'transient';\n  static override readonly isTransient: boolean = true;\n}\n\nexport class SynapPermanentError extends SynapError {\n  static override readonly errorCode: SynapErrorCode = 'permanent';\n  static override readonly isTransient: boolean = false;\n}\n\n// ─── Transient ────────────────────────────────────────────────────────────────\n\nexport class NetworkTimeoutError extends SynapTransientError {\n  static override readonly errorCode: SynapErrorCode = 'network_timeout';\n}\n\n/**\n * Rate limit exceeded (HTTP 429, gRPC RESOURCE_EXHAUSTED).\n *\n * Also carries the two credit stops the server reports as 429, because both\n * recover with time or a plan change rather than with a retry of this request:\n * `reason: 'trial_limit_reached'` (the Trial cap is spent, see `upgradeUrl`)\n * and `reason: 'subscription_inactive'` (a paid plan whose subscription is past\n * due, unpaid or cancelled, see `manageUrl`). `reason` is null for an ordinary\n * rate limit and against a server too old to send one.\n */\nexport class RateLimitError extends SynapTransientError {\n  static override readonly errorCode: SynapErrorCode = 'rate_limit';\n  readonly retryAfterSeconds: number | null;\n  /** Machine-readable cause, when the stop was a credit stop. */\n  readonly reason: string | null;\n  /** Where a Trial customer upgrades. Python calls this `upgrade_url`. */\n  readonly upgradeUrl: string | null;\n  /** Where billing is managed. Python calls this `manage_url`. */\n  readonly manageUrl: string | null;\n\n  constructor(\n    message: string,\n    options: SynapErrorOptions & {\n      retryAfterSeconds?: number | null;\n      reason?: string | null;\n      upgradeUrl?: string | null;\n      manageUrl?: string | null;\n    } = {},\n  ) {\n    super(message, options);\n    this.retryAfterSeconds = options.retryAfterSeconds ?? null;\n    this.reason = options.reason ?? null;\n    this.upgradeUrl = options.upgradeUrl ?? null;\n    this.manageUrl = options.manageUrl ?? null;\n  }\n}\n\nexport class ServiceUnavailableError extends SynapTransientError {\n  static override readonly errorCode: SynapErrorCode = 'service_unavailable';\n}\n\nexport class AgentUnavailableError extends SynapTransientError {\n  static override readonly errorCode: SynapErrorCode = 'agent_unavailable';\n  constructor(message = 'Agent unavailable', options: SynapErrorOptions = {}) {\n    super(message, options);\n  }\n}\n\n// ─── Permanent ────────────────────────────────────────────────────────────────\n\n/**\n * The caller's credit wallet cannot cover this request.\n *\n * HTTP 402, and gRPC RESOURCE_EXHAUSTED with credit-related trailing metadata.\n * Permanent by design: retrying without topping up burns quota and never\n * succeeds. This is the error behind \"the agent forgot\" reports where retrieval\n * silently returns nothing.\n */\nexport class InsufficientCreditsError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'insufficient_credits';\n  readonly balanceCredits: number | null;\n  readonly requiredCredits: number | null;\n  /** Where the balance can be viewed. Python calls this `recovery_url`. */\n  readonly recoveryUrl: string | null;\n  /** Where a redeem code can be entered. Python calls this `redeem_url`. */\n  readonly redeemUrl: string | null;\n  /**\n   * Machine-readable cause. `'overages_disabled'` means the plan is paid and\n   * the balance is spent, but the account has not allowed usage past zero, so\n   * the work stops until someone allows overages or adds credits. Null when an\n   * older server did not send one.\n   */\n  readonly reason: string | null;\n  /** Where that setting and billing are managed. Python calls this `manage_url`. */\n  readonly manageUrl: string | null;\n\n  constructor(\n    message: string,\n    options: SynapErrorOptions & {\n      balanceCredits?: number | null;\n      requiredCredits?: number | null;\n      recoveryUrl?: string | null;\n      redeemUrl?: string | null;\n      reason?: string | null;\n      manageUrl?: string | null;\n    } = {},\n  ) {\n    super(message, options);\n    this.balanceCredits = options.balanceCredits ?? null;\n    this.requiredCredits = options.requiredCredits ?? null;\n    this.recoveryUrl = options.recoveryUrl ?? null;\n    this.redeemUrl = options.redeemUrl ?? null;\n    this.reason = options.reason ?? null;\n    this.manageUrl = options.manageUrl ?? null;\n  }\n}\n\nexport class InvalidInputError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'invalid_input';\n}\n\n/**\n * Raised by `validateInstanceId` before any network call, matching Python's\n * `utils/validators.py`. The message text is identical in both SDKs.\n */\nexport class InvalidInstanceIdError extends InvalidInputError {\n  static override readonly errorCode: SynapErrorCode = 'invalid_instance_id';\n}\n\n/** See the note on InvalidInstanceIdError. Raised by `validateConversationId`. */\nexport class InvalidConversationIdError extends InvalidInputError {\n  static override readonly errorCode: SynapErrorCode = 'invalid_conversation_id';\n}\n\nexport class AuthenticationError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'authentication';\n}\n\nexport class ContextNotFoundError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'context_not_found';\n}\n\nexport class ConflictError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'conflict';\n}\n\nexport class TranscriptConflictError extends ConflictError {\n  static override readonly errorCode: SynapErrorCode = 'transcript_conflict';\n}\n\nexport class SessionExpiredError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'session_expired';\n}\n\nexport class ListeningAlreadyActiveError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'listening_already_active';\n}\n\nexport class ListeningNotActiveError extends SynapPermanentError {\n  static override readonly errorCode: SynapErrorCode = 'listening_not_active';\n}\n\n// ─── Hierarchy metadata (drives the cross-copy instanceof above) ──────────────\n\nconst PARENT: Partial<Record<SynapErrorCode, SynapErrorCode>> = {\n  transient: 'synap_error',\n  permanent: 'synap_error',\n  network_timeout: 'transient',\n  rate_limit: 'transient',\n  service_unavailable: 'transient',\n  agent_unavailable: 'transient',\n  insufficient_credits: 'permanent',\n  invalid_input: 'permanent',\n  invalid_instance_id: 'invalid_input',\n  invalid_conversation_id: 'invalid_input',\n  authentication: 'permanent',\n  context_not_found: 'permanent',\n  conflict: 'permanent',\n  transcript_conflict: 'conflict',\n  session_expired: 'permanent',\n  listening_already_active: 'permanent',\n  listening_not_active: 'permanent',\n};\n\nfunction descendsFrom(actual: string | undefined, expected: string): boolean {\n  let cur = actual as SynapErrorCode | undefined;\n  const seen = new Set<string>();\n  while (cur && !seen.has(cur)) {\n    seen.add(cur);\n    if (cur === expected) return true;\n    cur = PARENT[cur];\n  }\n  return false;\n}\n\n// ─── Backward-compatibility aliases (mirrors the tail of errors.py) ──────────\n// `ConnectionError` deliberately shadows the global in a module scope. Python\n// does the same thing; keeping the name means ported code reads identically.\n\nexport const SDKError = SynapError;\nexport const TransientError = SynapTransientError;\nexport const PermanentError = SynapPermanentError;\nexport const ConnectionError = NetworkTimeoutError;\n","/**\n * Correlation ID generation.\n *\n * `globalThis.crypto` is unflagged from Node 19 onward and this package\n * declares `engines.node >= 20`, so `randomUUID` is normally present. It is\n * still feature-detected rather than assumed, because `engines` is advisory:\n * npm warns and installs anyway, and the SDK also runs on Workers, Edge and\n * Bun, where the available crypto surface varies.\n *\n * Deliberately does NOT import `node:crypto`. That import is what breaks Edge\n * and Workers builds at bundle time, and a correlation ID is not a security\n * value, so there is nothing to gain from it.\n */\nexport function newCorrelationId(): string {\n  const c = globalThis.crypto;\n  if (typeof c?.randomUUID === 'function') return c.randomUUID();\n\n  if (typeof c?.getRandomValues === 'function') {\n    const b = c.getRandomValues(new Uint8Array(16));\n    // RFC 4122 version (4) and variant bits. The `?? 0` guards satisfy\n    // `noUncheckedIndexedAccess`; a 16-byte array always has these slots.\n    b[6] = ((b[6] ?? 0) & 0x0f) | 0x40;\n    b[8] = ((b[8] ?? 0) & 0x3f) | 0x80;\n    const h = Array.from(b, (x) => x.toString(16).padStart(2, '0')).join('');\n    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;\n  }\n\n  // Last resort. Correlation IDs are for tracing only, never for security, so\n  // Math.random is acceptable here and only here.\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n  });\n}\n"]}

package/dist/chunk-T6U5PVAD.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/chunk-T6U5PVAD.cjs","../src/behavior/anticipation.json","../src/behavior/contract.ts","../src/cache/bm25.ts","../src/context/anticipation-cache.ts"],"names":[],"mappings":"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","file":"/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/chunk-T6U5PVAD.cjs","sourcesContent":[null,"{\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"]}
+{"version":3,"sources":["/Users/scaler/maximem_synap/synap/sdk/js/dist/chunk-T6U5PVAD.cjs","../src/behavior/anticipation.json","../src/behavior/contract.ts","../src/cache/bm25.ts","../src/context/anticipation-cache.ts"],"names":[],"mappings":"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","file":"/Users/scaler/maximem_synap/synap/sdk/js/dist/chunk-T6U5PVAD.cjs","sourcesContent":[null,"{\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"]}

package/dist/chunk-ZKOJDUN4.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/chunk-ZKOJDUN4.cjs","../src/util/env.ts"],"names":[],"mappings":"AAAA;ACaA,IAAM,OAAA,kBAAS,IAAI,GAAA,CAAI,CAAC,MAAA,EAAQ,GAAA,EAAK,KAAK,CAAC,CAAA;AAE3C,SAAS,OAAA,CAAQ,IAAA,EAAkC;AACjD,EAAA,GAAA,CAAI,OAAO,QAAA,IAAY,YAAA,GAAe,OAAA,CAAQ,IAAA,IAAQ,KAAA,CAAA,EAAW,OAAO,KAAA,CAAA;AACxE,EAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA;AACzB;AAGO,SAAS,UAAA,CAAW,IAAA,EAAc,SAAA,EAAW,KAAA,EAAgB;AAClE,EAAA,MAAM,IAAA,EAAM,OAAA,CAAQ,IAAI,CAAA;AACxB,EAAA,GAAA,CAAI,IAAA,IAAQ,KAAA,EAAA,GAAa,GAAA,CAAI,IAAA,CAAK,EAAA,IAAM,EAAA,EAAI,OAAO,QAAA;AACnD,EAAA,OAAO,MAAA,CAAO,GAAA,CAAI,GAAA,CAAI,IAAA,CAAK,CAAA,CAAE,WAAA,CAAY,CAAC,CAAA;AAC5C;AAGO,SAAS,WAAA,CAAY,IAAA,EAA6B;AACvD,EAAA,MAAM,IAAA,kBAAM,OAAA,iBAAQ,IAAI,CAAA,6BAAG,IAAA,mBAAK,GAAA;AAChC,EAAA,GAAA,CAAI,CAAC,GAAA,EAAK,OAAO,IAAA;AACjB,EAAA,MAAM,EAAA,EAAI,MAAA,CAAO,GAAG,CAAA;AACpB,EAAA,OAAO,MAAA,CAAO,QAAA,CAAS,CAAC,EAAA,EAAI,EAAA,EAAI,IAAA;AAClC;AAEO,SAAS,MAAA,CAAO,IAAA,EAAkC;AACvD,EAAA,MAAM,EAAA,EAAI,OAAA,CAAQ,IAAI,CAAA;AACtB,EAAA,OAAO,EAAA,IAAM,KAAA,EAAA,GAAa,EAAA,IAAM,GAAA,EAAK,KAAA,EAAA,EAAY,CAAA;AACnD;ADjBA;AACA;AACE;AACA;AACA;AACF,4FAAC","file":"/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/chunk-ZKOJDUN4.cjs","sourcesContent":[null,"/**\n * Environment access.\n *\n * Every read happens at CALL time, never at module load. Python does\n * `os.environ.get(...)` inside the function bodies, and tests plus runtime\n * toggles depend on that: a value captured at import time makes a later\n * `process.env` mutation look like the flag simply does not work. That is\n * gotcha G-S.\n *\n * `process` is absent on Workers and in the browser, so every accessor\n * tolerates it being missing.\n */\n\nconst TRUTHY = new Set(['true', '1', 'yes']);\n\nfunction readEnv(name: string): string | undefined {\n  if (typeof process === 'undefined' || process.env === undefined) return undefined;\n  return process.env[name];\n}\n\n/** Boolean flag. Defaults to false, matching the Python SDK's flags. */\nexport function getEnvFlag(name: string, fallback = false): boolean {\n  const raw = readEnv(name);\n  if (raw === undefined || raw.trim() === '') return fallback;\n  return TRUTHY.has(raw.trim().toLowerCase());\n}\n\n/** Numeric setting. Returns null when unset OR malformed: a bad value must not fail closed. */\nexport function getEnvFloat(name: string): number | null {\n  const raw = readEnv(name)?.trim();\n  if (!raw) return null;\n  const n = Number(raw);\n  return Number.isFinite(n) ? n : null;\n}\n\nexport function getEnv(name: string): string | undefined {\n  const v = readEnv(name);\n  return v === undefined || v === '' ? undefined : v;\n}\n"]}
+{"version":3,"sources":["/Users/scaler/maximem_synap/synap/sdk/js/dist/chunk-ZKOJDUN4.cjs","../src/util/env.ts"],"names":[],"mappings":"AAAA;ACaA,IAAM,OAAA,kBAAS,IAAI,GAAA,CAAI,CAAC,MAAA,EAAQ,GAAA,EAAK,KAAK,CAAC,CAAA;AAE3C,SAAS,OAAA,CAAQ,IAAA,EAAkC;AACjD,EAAA,GAAA,CAAI,OAAO,QAAA,IAAY,YAAA,GAAe,OAAA,CAAQ,IAAA,IAAQ,KAAA,CAAA,EAAW,OAAO,KAAA,CAAA;AACxE,EAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA;AACzB;AAGO,SAAS,UAAA,CAAW,IAAA,EAAc,SAAA,EAAW,KAAA,EAAgB;AAClE,EAAA,MAAM,IAAA,EAAM,OAAA,CAAQ,IAAI,CAAA;AACxB,EAAA,GAAA,CAAI,IAAA,IAAQ,KAAA,EAAA,GAAa,GAAA,CAAI,IAAA,CAAK,EAAA,IAAM,EAAA,EAAI,OAAO,QAAA;AACnD,EAAA,OAAO,MAAA,CAAO,GAAA,CAAI,GAAA,CAAI,IAAA,CAAK,CAAA,CAAE,WAAA,CAAY,CAAC,CAAA;AAC5C;AAGO,SAAS,WAAA,CAAY,IAAA,EAA6B;AACvD,EAAA,MAAM,IAAA,kBAAM,OAAA,iBAAQ,IAAI,CAAA,6BAAG,IAAA,mBAAK,GAAA;AAChC,EAAA,GAAA,CAAI,CAAC,GAAA,EAAK,OAAO,IAAA;AACjB,EAAA,MAAM,EAAA,EAAI,MAAA,CAAO,GAAG,CAAA;AACpB,EAAA,OAAO,MAAA,CAAO,QAAA,CAAS,CAAC,EAAA,EAAI,EAAA,EAAI,IAAA;AAClC;AAEO,SAAS,MAAA,CAAO,IAAA,EAAkC;AACvD,EAAA,MAAM,EAAA,EAAI,OAAA,CAAQ,IAAI,CAAA;AACtB,EAAA,OAAO,EAAA,IAAM,KAAA,EAAA,GAAa,EAAA,IAAM,GAAA,EAAK,KAAA,EAAA,EAAY,CAAA;AACnD;ADjBA;AACA;AACE;AACA;AACA;AACF,4FAAC","file":"/Users/scaler/maximem_synap/synap/sdk/js/dist/chunk-ZKOJDUN4.cjs","sourcesContent":[null,"/**\n * Environment access.\n *\n * Every read happens at CALL time, never at module load. Python does\n * `os.environ.get(...)` inside the function bodies, and tests plus runtime\n * toggles depend on that: a value captured at import time makes a later\n * `process.env` mutation look like the flag simply does not work. That is\n * gotcha G-S.\n *\n * `process` is absent on Workers and in the browser, so every accessor\n * tolerates it being missing.\n */\n\nconst TRUTHY = new Set(['true', '1', 'yes']);\n\nfunction readEnv(name: string): string | undefined {\n  if (typeof process === 'undefined' || process.env === undefined) return undefined;\n  return process.env[name];\n}\n\n/** Boolean flag. Defaults to false, matching the Python SDK's flags. */\nexport function getEnvFlag(name: string, fallback = false): boolean {\n  const raw = readEnv(name);\n  if (raw === undefined || raw.trim() === '') return fallback;\n  return TRUTHY.has(raw.trim().toLowerCase());\n}\n\n/** Numeric setting. Returns null when unset OR malformed: a bad value must not fail closed. */\nexport function getEnvFloat(name: string): number | null {\n  const raw = readEnv(name)?.trim();\n  if (!raw) return null;\n  const n = Number(raw);\n  return Number.isFinite(n) ? n : null;\n}\n\nexport function getEnv(name: string): string | undefined {\n  const v = readEnv(name);\n  return v === undefined || v === '' ? undefined : v;\n}\n"]}

package/dist/env-55ULHNJZ.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/env-55ULHNJZ.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACF,kJAAC","file":"/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/env-55ULHNJZ.cjs"}
+{"version":3,"sources":["/Users/scaler/maximem_synap/synap/sdk/js/dist/env-55ULHNJZ.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACF,kJAAC","file":"/Users/scaler/maximem_synap/synap/sdk/js/dist/env-55ULHNJZ.cjs"}

package/dist/grpc/index.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkWE4QSR6Acjs = require('../chunk-WE4QSR6A.cjs');
+var _chunkHCULAVJCcjs = require('../chunk-HCULAVJC.cjs');
 
 
 var _chunkT372OL3Qcjs = require('../chunk-T372OL3Q.cjs');
@@ -39,7 +39,7 @@ async function listen(options) {
     throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)(availability.detail);
   }
   const [{ GrpcStreamClient: StreamClient }, { AnticipationCache }, { getEnv }] = await Promise.all([
-    Promise.resolve().then(() => _interopRequireWildcard(require("../stream-client-A6IO6E47.cjs"))),
+    Promise.resolve().then(() => _interopRequireWildcard(require("../stream-client-N46JBT5A.cjs"))),
     Promise.resolve().then(() => _interopRequireWildcard(require("../anticipation-cache-LRE3TLK4.cjs"))),
     Promise.resolve().then(() => _interopRequireWildcard(require("../env-55ULHNJZ.cjs")))
   ]);
@@ -83,5 +83,5 @@ async function listen(options) {
 
 
 
-exports.GrpcStreamClient = _chunkWE4QSR6Acjs.GrpcStreamClient; exports.PROTO_SHA = _chunkWE4QSR6Acjs.PROTO_SHA; exports.checkGrpcAvailability = checkGrpcAvailability; exports.listen = listen;
+exports.GrpcStreamClient = _chunkHCULAVJCcjs.GrpcStreamClient; exports.PROTO_SHA = _chunkHCULAVJCcjs.PROTO_SHA; exports.checkGrpcAvailability = checkGrpcAvailability; exports.listen = listen;
 //# sourceMappingURL=index.cjs.map

package/dist/grpc/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/grpc/index.cjs","../../src/grpc/index.ts"],"names":[],"mappings":"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","file":"/private/tmp/claude-501/-Users-anish-maximemai-maximem-synap/364ae6d0-b8b7-4119-bfaf-7676354661c6/scratchpad/jsrel/synap/sdk/js/dist/grpc/index.cjs","sourcesContent":[null,"/**\n * gRPC anticipation stream: availability and loading.\n *\n * This is a SUBPATH export (`@maximem/synap-js-sdk/grpc`) and is never\n * imported by the main entry point. Three reasons, all of which have bitten\n * someone already:\n *\n *  1. `@grpc/grpc-js` plus its protos is roughly 5MB. HTTP-only and Edge users\n *     should not pay for it (gotcha G-Q).\n *  2. grpc-js is built on `node:http2`, `node:net` and `node:tls`. Merely\n *     importing it on Edge or Workers fails the *build*, not the call. Keeping\n *     it behind a subpath plus a lazy `import()` means importing the SDK on\n *     Edge stays safe.\n *  3. It is an `optionalDependency`, so it may legitimately be absent.\n *\n * ## Proto loading\n *\n * The stream is live. The proto ships as an INLINED JSON descriptor\n * (./descriptor.ts) loaded through `proto-loader.fromJSON`, not through\n * `loadSync(path)`. proto-loader's file-based path reads the `.proto` off disk\n * at runtime, which breaks under webpack/turbopack bundling and Vercel's `nft`\n * file tracing: at deploy time rather than at test time (gotcha G-P). Inlining\n * gets the same result as ts-proto codegen without a codegen toolchain.\n */\n\nimport { ListeningNotActiveError } from '../errors.js';\nexport { GrpcStreamClient } from './stream-client.js';\nexport type {\n  StreamState, StreamCredentials, StreamClientOptions, ConversationEventInput,\n} from './stream-client.js';\nexport { PROTO_SHA } from './descriptor.js';\n\nexport type GrpcAvailability =\n  | { available: true }\n  | { available: false; reason: 'not-node' | 'module-missing'; detail: string };\n\n/**\n * Whether a gRPC stream could run here.\n *\n * Deliberately does not throw: callers use this to decide whether to offer the\n * stream at all, and a hard failure at that point is unhelpful.\n */\nexport async function checkGrpcAvailability(): Promise<GrpcAvailability> {\n  const isNode =\n    typeof process !== 'undefined' &&\n    process.versions?.node !== undefined &&\n    typeof (globalThis as { EdgeRuntime?: unknown }).EdgeRuntime === 'undefined';\n\n  if (!isNode) {\n    return {\n      available: false,\n      reason: 'not-node',\n      detail:\n        'gRPC needs raw TCP and node:http2, which Edge runtimes and Workers do ' +\n        'not provide. HTTP context fetching works normally here; only the ' +\n        'anticipation stream is unavailable. Reaching Edge would require a ' +\n        'gRPC-Web or Connect endpoint on the server, which does not exist yet.',\n    };\n  }\n\n  try {\n    await import(/* @vite-ignore */ '@grpc/grpc-js');\n    return { available: true };\n  } catch (error) {\n    return {\n      available: false,\n      reason: 'module-missing',\n      detail:\n        '@grpc/grpc-js is an optional dependency and is not installed. Run ' +\n        '`npm install @grpc/grpc-js` to enable the anticipation stream. ' +\n        `(${(error as Error)?.message ?? String(error)})`,\n    };\n  }\n}\n\nexport interface ListenOptions {\n  conversationId: string;\n  userId?: string;\n  customerId?: string;\n  onBundle?: (bundle: unknown) => void;\n}\n\nexport interface ListeningSession {\n  stop(): Promise<void>;\n  readonly active: boolean;\n}\n\n/**\n * Start the anticipation stream directly, without a SynapClient.\n *\n * Most callers want `client.instance.listen()` instead, which shares the\n * client's credentials and anticipation cache. This exists for the case where\n * only the stream is wanted.\n *\n * **Opt-in, and off by default.** The removed wrapper called `listen()`\n * unconditionally during init, so every user had a stream whether they asked\n * for one or not. Making it opt-in is the right default, but it is not a\n * neutral change: fewer streams means fewer anticipation hits and therefore\n * MORE billed cloud fetches for existing users. That has to be announced\n * rather than discovered (gotcha G-Y).\n */\nexport async function listen(\n  options: ListenOptions & {\n    apiKey?: string;\n    clientId?: string;\n    instanceId?: string;\n    host?: string;\n    port?: number;\n    useTls?: boolean;\n  },\n): Promise<ListeningSession> {\n  if (!options.conversationId) {\n    // conversation_id is not a scope tier, but the stream genuinely requires\n    // one: it is what the server keys the anticipation session on.\n    throw new ListeningNotActiveError('conversation_id is required to start a listening stream');\n  }\n\n  const availability = await checkGrpcAvailability();\n  if (!availability.available) {\n    throw new ListeningNotActiveError(availability.detail);\n  }\n\n  const [{ GrpcStreamClient: StreamClient }, { AnticipationCache }, { getEnv }] = await Promise.all([\n    import('./stream-client.js'),\n    import('../context/anticipation-cache.js'),\n    import('../util/env.js'),\n  ]);\n\n  const apiKey = options.apiKey ?? getEnv('SYNAP_API_KEY') ?? '';\n  if (apiKey === '') {\n    throw new ListeningNotActiveError(\n      'No Synap API key found. Set SYNAP_API_KEY or pass apiKey.',\n    );\n  }\n\n  const cache = new AnticipationCache();\n  const client = new StreamClient(\n    {\n      apiKey,\n      clientId: options.clientId ?? getEnv('SYNAP_CLIENT_ID') ?? '',\n      instanceId: options.instanceId ?? getEnv('SYNAP_INSTANCE_ID') ?? '',\n    },\n    cache,\n    {\n      ...(options.host !== undefined ? { host: options.host } : {}),\n      ...(options.port !== undefined ? { port: options.port } : {}),\n      ...(options.useTls !== undefined ? { useTls: options.useTls } : {}),\n      ...(options.onBundle !== undefined ? { onContext: options.onBundle } : {}),\n    },\n  );\n  await client.connect();\n  client.sendSessionControl({\n    action: 'start',\n    conversation_id: options.conversationId,\n    ...(options.userId !== undefined ? { user_id: options.userId } : {}),\n    ...(options.customerId !== undefined ? { customer_id: options.customerId } : {}),\n  });\n\n  return {\n    stop: () => client.disconnect(),\n    get active() { return client.isConnected; },\n  };\n}\n"]}
+{"version":3,"sources":["/Users/scaler/maximem_synap/synap/sdk/js/dist/grpc/index.cjs","../../src/grpc/index.ts"],"names":[],"mappings":"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","file":"/Users/scaler/maximem_synap/synap/sdk/js/dist/grpc/index.cjs","sourcesContent":[null,"/**\n * gRPC anticipation stream: availability and loading.\n *\n * This is a SUBPATH export (`@maximem/synap-js-sdk/grpc`) and is never\n * imported by the main entry point. Three reasons, all of which have bitten\n * someone already:\n *\n *  1. `@grpc/grpc-js` plus its protos is roughly 5MB. HTTP-only and Edge users\n *     should not pay for it (gotcha G-Q).\n *  2. grpc-js is built on `node:http2`, `node:net` and `node:tls`. Merely\n *     importing it on Edge or Workers fails the *build*, not the call. Keeping\n *     it behind a subpath plus a lazy `import()` means importing the SDK on\n *     Edge stays safe.\n *  3. It is an `optionalDependency`, so it may legitimately be absent.\n *\n * ## Proto loading\n *\n * The stream is live. The proto ships as an INLINED JSON descriptor\n * (./descriptor.ts) loaded through `proto-loader.fromJSON`, not through\n * `loadSync(path)`. proto-loader's file-based path reads the `.proto` off disk\n * at runtime, which breaks under webpack/turbopack bundling and Vercel's `nft`\n * file tracing: at deploy time rather than at test time (gotcha G-P). Inlining\n * gets the same result as ts-proto codegen without a codegen toolchain.\n */\n\nimport { ListeningNotActiveError } from '../errors.js';\nexport { GrpcStreamClient } from './stream-client.js';\nexport type {\n  StreamState, StreamCredentials, StreamClientOptions, ConversationEventInput,\n} from './stream-client.js';\nexport { PROTO_SHA } from './descriptor.js';\n\nexport type GrpcAvailability =\n  | { available: true }\n  | { available: false; reason: 'not-node' | 'module-missing'; detail: string };\n\n/**\n * Whether a gRPC stream could run here.\n *\n * Deliberately does not throw: callers use this to decide whether to offer the\n * stream at all, and a hard failure at that point is unhelpful.\n */\nexport async function checkGrpcAvailability(): Promise<GrpcAvailability> {\n  const isNode =\n    typeof process !== 'undefined' &&\n    process.versions?.node !== undefined &&\n    typeof (globalThis as { EdgeRuntime?: unknown }).EdgeRuntime === 'undefined';\n\n  if (!isNode) {\n    return {\n      available: false,\n      reason: 'not-node',\n      detail:\n        'gRPC needs raw TCP and node:http2, which Edge runtimes and Workers do ' +\n        'not provide. HTTP context fetching works normally here; only the ' +\n        'anticipation stream is unavailable. Reaching Edge would require a ' +\n        'gRPC-Web or Connect endpoint on the server, which does not exist yet.',\n    };\n  }\n\n  try {\n    await import(/* @vite-ignore */ '@grpc/grpc-js');\n    return { available: true };\n  } catch (error) {\n    return {\n      available: false,\n      reason: 'module-missing',\n      detail:\n        '@grpc/grpc-js is an optional dependency and is not installed. Run ' +\n        '`npm install @grpc/grpc-js` to enable the anticipation stream. ' +\n        `(${(error as Error)?.message ?? String(error)})`,\n    };\n  }\n}\n\nexport interface ListenOptions {\n  conversationId: string;\n  userId?: string;\n  customerId?: string;\n  onBundle?: (bundle: unknown) => void;\n}\n\nexport interface ListeningSession {\n  stop(): Promise<void>;\n  readonly active: boolean;\n}\n\n/**\n * Start the anticipation stream directly, without a SynapClient.\n *\n * Most callers want `client.instance.listen()` instead, which shares the\n * client's credentials and anticipation cache. This exists for the case where\n * only the stream is wanted.\n *\n * **Opt-in, and off by default.** The removed wrapper called `listen()`\n * unconditionally during init, so every user had a stream whether they asked\n * for one or not. Making it opt-in is the right default, but it is not a\n * neutral change: fewer streams means fewer anticipation hits and therefore\n * MORE billed cloud fetches for existing users. That has to be announced\n * rather than discovered (gotcha G-Y).\n */\nexport async function listen(\n  options: ListenOptions & {\n    apiKey?: string;\n    clientId?: string;\n    instanceId?: string;\n    host?: string;\n    port?: number;\n    useTls?: boolean;\n  },\n): Promise<ListeningSession> {\n  if (!options.conversationId) {\n    // conversation_id is not a scope tier, but the stream genuinely requires\n    // one: it is what the server keys the anticipation session on.\n    throw new ListeningNotActiveError('conversation_id is required to start a listening stream');\n  }\n\n  const availability = await checkGrpcAvailability();\n  if (!availability.available) {\n    throw new ListeningNotActiveError(availability.detail);\n  }\n\n  const [{ GrpcStreamClient: StreamClient }, { AnticipationCache }, { getEnv }] = await Promise.all([\n    import('./stream-client.js'),\n    import('../context/anticipation-cache.js'),\n    import('../util/env.js'),\n  ]);\n\n  const apiKey = options.apiKey ?? getEnv('SYNAP_API_KEY') ?? '';\n  if (apiKey === '') {\n    throw new ListeningNotActiveError(\n      'No Synap API key found. Set SYNAP_API_KEY or pass apiKey.',\n    );\n  }\n\n  const cache = new AnticipationCache();\n  const client = new StreamClient(\n    {\n      apiKey,\n      clientId: options.clientId ?? getEnv('SYNAP_CLIENT_ID') ?? '',\n      instanceId: options.instanceId ?? getEnv('SYNAP_INSTANCE_ID') ?? '',\n    },\n    cache,\n    {\n      ...(options.host !== undefined ? { host: options.host } : {}),\n      ...(options.port !== undefined ? { port: options.port } : {}),\n      ...(options.useTls !== undefined ? { useTls: options.useTls } : {}),\n      ...(options.onBundle !== undefined ? { onContext: options.onBundle } : {}),\n    },\n  );\n  await client.connect();\n  client.sendSessionControl({\n    action: 'start',\n    conversation_id: options.conversationId,\n    ...(options.userId !== undefined ? { user_id: options.userId } : {}),\n    ...(options.customerId !== undefined ? { customer_id: options.customerId } : {}),\n  });\n\n  return {\n    stop: () => client.disconnect(),\n    get active() { return client.isConnected; },\n  };\n}\n"]}

package/dist/grpc/index.d.cts

@@ -135,7 +135,7 @@ declare class GrpcStreamClient {
  * `npm run sync-behavior` in synap/sdk/js.
  */
 /** sha256 (first 16 hex chars) of the proto this descriptor was built from. */
-declare const PROTO_SHA = "a0813b78a8c5d8dc";
+declare const PROTO_SHA = "2cf2b5663f67394b";
 
 /**
  * gRPC anticipation stream: availability and loading.

package/dist/grpc/index.d.ts

@@ -135,7 +135,7 @@ declare class GrpcStreamClient {
  * `npm run sync-behavior` in synap/sdk/js.
  */
 /** sha256 (first 16 hex chars) of the proto this descriptor was built from. */
-declare const PROTO_SHA = "a0813b78a8c5d8dc";
+declare const PROTO_SHA = "2cf2b5663f67394b";
 
 /**
  * gRPC anticipation stream: availability and loading.

package/dist/grpc/index.js

@@ -1,7 +1,7 @@
 import {
   GrpcStreamClient,
   PROTO_SHA
-} from "../chunk-RP4YOEUN.js";
+} from "../chunk-FXGLT6AT.js";
 import {
   ListeningNotActiveError
 } from "../chunk-BWMPKLFG.js";
@@ -39,7 +39,7 @@ async function listen(options) {
     throw new ListeningNotActiveError(availability.detail);
   }
   const [{ GrpcStreamClient: StreamClient }, { AnticipationCache }, { getEnv }] = await Promise.all([
-    import("../stream-client-Y5NFAMIH.js"),
+    import("../stream-client-VWKINE47.js"),
     import("../anticipation-cache-WLU4NMD5.js"),
     import("../env-QCUKKW36.js")
   ]);