@maximem/synap-js-sdk 0.5.2 → 0.5.6

package/dist/chunk-ZKOJDUN4.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"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"]}

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

@@ -1 +1 @@
-{"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"}
+{"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"}

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 _chunkWWTGJZA7cjs = require('../chunk-WWTGJZA7.cjs');
+var _chunkWE4QSR6Acjs = require('../chunk-WE4QSR6A.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-GJM4YSXW.cjs"))),
+    Promise.resolve().then(() => _interopRequireWildcard(require("../stream-client-A6IO6E47.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 = _chunkWWTGJZA7cjs.GrpcStreamClient; exports.PROTO_SHA = _chunkWWTGJZA7cjs.PROTO_SHA; exports.checkGrpcAvailability = checkGrpcAvailability; exports.listen = listen;
+exports.GrpcStreamClient = _chunkWE4QSR6Acjs.GrpcStreamClient; exports.PROTO_SHA = _chunkWE4QSR6Acjs.PROTO_SHA; exports.checkGrpcAvailability = checkGrpcAvailability; exports.listen = listen;
 //# sourceMappingURL=index.cjs.map

package/dist/grpc/index.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"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"]}

package/dist/grpc/index.d.cts

@@ -128,14 +128,14 @@ declare class GrpcStreamClient {
  *
  * Source:    synap/proto/synap_service.proto
  * Generator: synap/sdk/scripts/gen_proto_descriptor.mjs
- * Proto SHA: c1d834043608ad4f
+ * Proto SHA: a0813b78a8c5d8dc
  *
  * The proto is inlined as a JSON descriptor rather than loaded from disk so
  * that bundlers and Vercel file tracing cannot lose it. Regenerate with
  * `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 = "c1d834043608ad4f";
+declare const PROTO_SHA = "a0813b78a8c5d8dc";
 
 /**
  * gRPC anticipation stream: availability and loading.

package/dist/grpc/index.d.ts

@@ -128,14 +128,14 @@ declare class GrpcStreamClient {
  *
  * Source:    synap/proto/synap_service.proto
  * Generator: synap/sdk/scripts/gen_proto_descriptor.mjs
- * Proto SHA: c1d834043608ad4f
+ * Proto SHA: a0813b78a8c5d8dc
  *
  * The proto is inlined as a JSON descriptor rather than loaded from disk so
  * that bundlers and Vercel file tracing cannot lose it. Regenerate with
  * `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 = "c1d834043608ad4f";
+declare const PROTO_SHA = "a0813b78a8c5d8dc";
 
 /**
  * gRPC anticipation stream: availability and loading.

package/dist/grpc/index.js

@@ -1,7 +1,7 @@
 import {
   GrpcStreamClient,
   PROTO_SHA
-} from "../chunk-DJPYUPSV.js";
+} from "../chunk-RP4YOEUN.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-5CGJNTH4.js"),
+    import("../stream-client-Y5NFAMIH.js"),
     import("../anticipation-cache-WLU4NMD5.js"),
     import("../env-QCUKKW36.js")
   ]);

package/dist/index.cjs

@@ -49,6 +49,7 @@ var ENDPOINTS = {
   memories_get: { method: "GET", path: "/api/v1/memories/{memory_id}", idempotent: true },
   memories_update: { method: "PATCH", path: "/api/v1/memories/{memory_id}", idempotent: false },
   memories_delete: { method: "DELETE", path: "/api/v1/memories/{memory_id}", idempotent: true },
+  memories_forget: { method: "POST", path: "/api/v1/memories/forget", idempotent: false },
   context_fetch_user: { method: "POST", path: "/v1/context/user/fetch", idempotent: true },
   context_fetch_customer: { method: "POST", path: "/v1/context/customer/fetch", idempotent: true },
   context_fetch_client: { method: "POST", path: "/v1/context/client/fetch", idempotent: true },
@@ -536,6 +537,8 @@ function buildFetchRequest(scope, options) {
   const searchQuery = opt(options, "search_query", "searchQuery");
   const maxResults = _nullishCoalesce(opt(options, "max_results", "maxResults"), () => ( 10));
   const precisionLevel = _nullishCoalesce(opt(options, "precision_level", "precisionLevel"), () => ( "high"));
+  const queryDate = opt(options, "query_date", "queryDate");
+  const perQuery = opt(options, "max_results_per_query", "maxResultsPerQuery");
   const mode = _nullishCoalesce(options.mode, () => ( "fast"));
   if (searchQuery !== void 0 && !Array.isArray(searchQuery)) {
     throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("search_query must be an array when provided");
@@ -551,6 +554,8 @@ function buildFetchRequest(scope, options) {
     mode
   };
   if (precisionLevel !== "high") body["precision_level"] = precisionLevel;
+  if (queryDate) body["query_date"] = queryDate;
+  if (perQuery) body["max_results_per_query"] = perQuery;
   if (options.include_conversation_context === false) {
     body["include_conversation_context"] = false;
   }
@@ -626,6 +631,10 @@ function pick(...values) {
   return pickDefined(...values);
 }
 var obj = (v) => _nullishCoalesce(v, () => ( {}));
+function matchedQueries(item = {}) {
+  const raw = _nullishCoalesce(item["matchedQueries"], () => ( item.matched_queries));
+  return Array.isArray(raw) ? raw : [];
+}
 function normalizeTemporalFields(item = {}) {
   return {
     eventDate: pick(item["eventDate"], item.event_date, null),
@@ -642,7 +651,8 @@ function normalizeFact(item = {}) {
     source: item.source || "",
     extractedAt: pick(item["extractedAt"], item.extracted_at, null),
     metadata: obj(item.metadata),
-    ...normalizeTemporalFields(item)
+    ...normalizeTemporalFields(item),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizePreference(item = {}) {
@@ -654,7 +664,8 @@ function normalizePreference(item = {}) {
     source: item.source || "",
     extractedAt: pick(item["extractedAt"], item.extracted_at, null),
     metadata: obj(item.metadata),
-    ...normalizeTemporalFields(item)
+    ...normalizeTemporalFields(item),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizeEpisode(item = {}) {
@@ -665,7 +676,8 @@ function normalizeEpisode(item = {}) {
     significance: pick(item["significance"], item.confidence, 0),
     participants: item["participants"] || [],
     metadata: obj(item.metadata),
-    ...normalizeTemporalFields(item)
+    ...normalizeTemporalFields(item),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizeEmotion(item = {}) {
@@ -676,7 +688,8 @@ function normalizeEmotion(item = {}) {
     detectedAt: pick(item["detectedAt"], item["detected_at"], null),
     context: item["context"] || "",
     metadata: obj(item.metadata),
-    ...normalizeTemporalFields(item)
+    ...normalizeTemporalFields(item),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizeTemporalEvent(item = {}) {
@@ -690,7 +703,8 @@ function normalizeTemporalEvent(item = {}) {
     confidence: pick(item.confidence, 0),
     source: item.source || "",
     extractedAt: pick(item["extractedAt"], item.extracted_at, null),
-    metadata: obj(item.metadata)
+    metadata: obj(item.metadata),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizeContextMetadata(metadata = {}) {
@@ -864,8 +878,33 @@ function buildCreateBody(options) {
     metadata: _nullishCoalesce(options.metadata, () => ( {}))
   };
 }
+var FORGET_MODES = ["preview", "direct"];
+var FORGET_DESCRIPTION_MIN = 3;
+var FORGET_DESCRIPTION_MAX = 500;
+function buildForgetBody(options) {
+  const description = options.description;
+  if (typeof description !== "string" || description.length < FORGET_DESCRIPTION_MIN || description.length > FORGET_DESCRIPTION_MAX) {
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+      `description must be between ${FORGET_DESCRIPTION_MIN} and ${FORGET_DESCRIPTION_MAX} characters`
+    );
+  }
+  const mode = _nullishCoalesce(options.mode, () => ( "preview"));
+  if (!FORGET_MODES.includes(mode)) {
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+      `Invalid mode '${mode}'. Expected one of: ${FORGET_MODES.join(", ")}`
+    );
+  }
+  const o2 = options;
+  return {
+    description,
+    user_id: _nullishCoalesce(either(o2, "user_id", "userId"), () => ( null)),
+    customer_id: _nullishCoalesce(either(o2, "customer_id", "customerId"), () => ( null)),
+    scope: _nullishCoalesce(options.scope, () => ( null)),
+    mode
+  };
+}
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "error", "cancelled"]);
-function createMemoriesInterface(transport) {
+function createMemoriesInterface(transport, onForgotten) {
   return {
     async create(options) {
       const o2 = options;
@@ -951,6 +990,23 @@ function createMemoriesInterface(transport) {
       }
       return transport.request("memories_delete", { pathParams: { memory_id: memoryId } });
     },
+    async forget(options) {
+      const o2 = options;
+      transport.checkCustomerId(_nullishCoalesce(o2["customer_id"], () => ( o2["customerId"])), "memories.forget");
+      const body = buildForgetBody(options);
+      const result = await transport.request("memories_forget", { body });
+      const removed = !!_optionalChain([result, 'optionalAccess', _33 => _33.deleted_ids, 'optionalAccess', _34 => _34.length]) || _optionalChain([result, 'optionalAccess', _35 => _35.status]) === "deleted" || _optionalChain([result, 'optionalAccess', _36 => _36.status]) === "partial";
+      if (removed && onForgotten) {
+        try {
+          onForgotten({
+            userId: _nullishCoalesce(body["user_id"], () => ( null)),
+            customerId: _nullishCoalesce(body["customer_id"], () => ( null))
+          });
+        } catch (e5) {
+        }
+      }
+      return result;
+    },
     async status(ingestionId) {
       if (!ingestionId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("ingestion_id is required");
       return transport.request("memories_status", {
@@ -979,14 +1035,14 @@ function sleep2(ms, signal) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
-      _optionalChain([signal, 'optionalAccess', _33 => _33.removeEventListener, 'call', _34 => _34("abort", onAbort)]);
+      _optionalChain([signal, 'optionalAccess', _37 => _37.removeEventListener, 'call', _38 => _38("abort", onAbort)]);
       resolve();
     }, ms);
     function onAbort() {
       clearTimeout(timer);
-      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _35 => _35.reason]), () => ( new Error("Aborted"))));
+      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _39 => _39.reason]), () => ( new Error("Aborted"))));
     }
-    _optionalChain([signal, 'optionalAccess', _36 => _36.addEventListener, 'call', _37 => _37("abort", onAbort, { once: true })]);
+    _optionalChain([signal, 'optionalAccess', _40 => _40.addEventListener, 'call', _41 => _41("abort", onAbort, { once: true })]);
   });
 }
 
@@ -1225,7 +1281,7 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
           pathParams: { conversation_id: id },
           query: { style: _nullishCoalesce(options.style, () => ( "structured")) }
         });
-        return _nullishCoalesce(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _38 => _38["context_for_prompt"]]), () => ( result)), () => ( {}));
+        return _nullishCoalesce(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _42 => _42["context_for_prompt"]]), () => ( result)), () => ( {}));
       },
       async compact(options) {
         return transport.request("conversations_compact", { body: buildCompactBody(options) });
@@ -1391,7 +1447,22 @@ var KNOWN_EVENT_TYPES = /* @__PURE__ */ new Set([
 ]);
 function toolResultJson(result) {
   if (result === void 0 || result === null) return "";
-  return typeof result === "string" ? result : JSON.stringify(result);
+  return typeof result === "string" ? result : jsonOrText(result);
+}
+function jsonOrText(value) {
+  try {
+    const out = JSON.stringify(
+      value,
+      (_k, v) => typeof v === "bigint" ? String(v) : v
+    );
+    return out === void 0 ? String(value) : out;
+  } catch (e6) {
+    try {
+      return String(value);
+    } catch (e7) {
+      return "";
+    }
+  }
 }
 function createInstanceNamespace(credentials, cache, onTurn) {
   let client = null;
@@ -1400,17 +1471,17 @@ function createInstanceNamespace(credentials, cache, onTurn) {
   let applyCompaction = null;
   const internals = {
     onCompactionUpdate(conversationId, bundle) {
-      _optionalChain([applyCompaction, 'optionalCall', _39 => _39(bundle)]);
-      _optionalChain([dispatchCompaction, 'optionalCall', _40 => _40(conversationId, bundle)]);
+      _optionalChain([applyCompaction, 'optionalCall', _43 => _43(bundle)]);
+      _optionalChain([dispatchCompaction, 'optionalCall', _44 => _44(conversationId, bundle)]);
     },
     setCompactionApplier(apply) {
       applyCompaction = apply;
     },
     sendContextUsed(event) {
-      _optionalChain([client, 'optionalAccess', _41 => _41.sendContextUsed, 'call', _42 => _42(event)]);
+      _optionalChain([client, 'optionalAccess', _45 => _45.sendContextUsed, 'call', _46 => _46(event)]);
     },
     sendContextAssembled(event) {
-      _optionalChain([client, 'optionalAccess', _43 => _43.sendContextAssembled, 'call', _44 => _44(event)]);
+      _optionalChain([client, 'optionalAccess', _47 => _47.sendContextAssembled, 'call', _48 => _48(event)]);
     },
     setCompactionDispatcher(dispatch) {
       dispatchCompaction = dispatch;
@@ -1432,7 +1503,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         ...customerId ? { customer_id: customerId } : {}
       });
       openSessions.set(conversationId, sessionId);
-    } catch (e5) {
+    } catch (e8) {
     }
   }
   const namespace = {
@@ -1440,7 +1511,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
       if (client !== null) {
         throw new (0, _chunkT372OL3Qcjs.ListeningAlreadyActiveError)("Listening is already active on this instance");
       }
-      const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-GJM4YSXW.cjs")));
+      const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-A6IO6E47.cjs")));
       const onContext = _nullishCoalesce(options.on_context, () => ( options.onContext));
       const onDisconnect = _nullishCoalesce(options.on_disconnect, () => ( options.onDisconnect));
       const onReconnect = _nullishCoalesce(options.on_reconnect, () => ( options.onReconnect));
@@ -1458,11 +1529,11 @@ function createInstanceNamespace(credentials, cache, onTurn) {
           if (state !== "connected") openSessions.clear();
           if (state === "reconnecting") {
             reconnectAttempts += 1;
-            _optionalChain([onReconnect, 'optionalCall', _45 => _45(reconnectAttempts)]);
+            _optionalChain([onReconnect, 'optionalCall', _49 => _49(reconnectAttempts)]);
           } else if (state === "disconnected") {
-            const stopped = _nullishCoalesce(_optionalChain([stream, 'optionalAccess', _46 => _46.lastError]), () => ( null));
+            const stopped = _nullishCoalesce(_optionalChain([stream, 'optionalAccess', _50 => _50.lastError]), () => ( null));
             const reason = stopped === null ? "stream disconnected" : `credit_stop:${_nullishCoalesce(stopped.reason, () => ( "unknown"))}`;
-            _optionalChain([onDisconnect, 'optionalCall', _47 => _47(reason)]);
+            _optionalChain([onDisconnect, 'optionalCall', _51 => _51(reason)]);
           }
         }
       });
@@ -1472,7 +1543,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
       } catch (error) {
         if (error instanceof _chunkT372OL3Qcjs.SynapError) throw error;
         throw new (0, _chunkT372OL3Qcjs.SynapError)(
-          `Could not open the Synap anticipation stream: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _48 => _48.message]), () => ( String(error)))}`,
+          `Could not open the Synap anticipation stream: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _52 => _52.message]), () => ( String(error)))}`,
           { cause: error }
         );
       }
@@ -1497,7 +1568,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
           session_id: sessionId,
           conversation_id: conversationId
         });
-      } catch (e6) {
+      } catch (e9) {
       }
     },
     async send_message(options) {
@@ -1518,7 +1589,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( ""))
       );
       if (eventType === "user_message" || eventType === "assistant_message") {
-        _optionalChain([onTurn, 'optionalCall', _49 => _49({
+        _optionalChain([onTurn, 'optionalCall', _53 => _53({
           conversationId,
           role: _nullishCoalesce(options.role, () => ( "user")),
           content: options.content
@@ -1538,7 +1609,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         // Python serialises tool_args with json.dumps into tool_args_json.
         tool_args_json: (() => {
           const a = _nullishCoalesce(options.tool_args, () => ( options.toolArgs));
-          return a === void 0 ? "" : JSON.stringify(a);
+          return a === void 0 ? "" : jsonOrText(a);
         })(),
         tool_result_json: toolResultJson(_nullishCoalesce(options.tool_result, () => ( options.toolResult))),
         tool_call_id: _nullishCoalesce(_nullishCoalesce(options.tool_call_id, () => ( options.toolCallId)), () => ( "")),
@@ -1612,7 +1683,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.2";
+var SDK_VERSION = "0.5.6";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -1824,7 +1895,7 @@ function overlayLocalRecentTurns(response, store, conversationId, configured) {
       compacted_at: orLocal("compacted_at", entry.compactedAt),
       conversation_id: conversationId
     };
-  } catch (e7) {
+  } catch (e10) {
   }
 }
 
@@ -1837,7 +1908,7 @@ function stringify(value) {
   if (t === "string" || t === "number" || t === "boolean") return String(value);
   try {
     return _nullishCoalesce(JSON.stringify(value), () => ( ""));
-  } catch (e8) {
+  } catch (e11) {
     return String(value);
   }
 }
@@ -2111,10 +2182,14 @@ function tryServeFromCache(cache, scope, params, maxItems) {
     });
     if (hit === null) return { response: null, hit: null };
     return { response: buildAnticipationResponse(hit), hit };
-  } catch (e9) {
+  } catch (e12) {
     return { response: null, hit: null };
   }
 }
+function distinctQueryCount(searchQuery) {
+  if (!Array.isArray(searchQuery)) return 0;
+  return new Set(searchQuery.filter((q) => typeof q === "string" && q.length > 0)).size;
+}
 
 // src/context/assembled.ts
 var COLLECTIONS2 = ["facts", "preferences", "episodes", "emotions", "temporal_events"];
@@ -2611,6 +2686,8 @@ var SynapClient = class {
     this.#fetchHooks = {
       beforeFetch: (scope, options2) => {
         const o2 = options2;
+        if (_nullishCoalesce(o2["query_date"], () => ( o2["queryDate"]))) return null;
+        if (_nullishCoalesce(o2["max_results_per_query"], () => ( o2["maxResultsPerQuery"]))) return null;
         const attempt = tryServeFromCache(
           this.#anticipationCache,
           scope,
@@ -2681,7 +2758,11 @@ var SynapClient = class {
         compacted: (conversationId, format) => this.#localCompacted(conversationId, format)
       }
     );
-    this.memories = createMemoriesInterface(this.#transport);
+    this.memories = createMemoriesInterface(this.#transport, ({ userId, customerId }) => {
+      for (const id of /* @__PURE__ */ new Set([userId, customerId])) {
+        if (id) this.#anticipationCache.dropEntity(id);
+      }
+    });
     this.credits = createCreditsNamespace(this.#transport);
     this.cache = createCacheNamespace(this.#anticipationCache);
     this.instance = createInstanceNamespace(
@@ -2811,7 +2892,7 @@ var SynapClient = class {
           this.#registryKeys.push(resolvedInstanceId);
         }
       }
-    } catch (e10) {
+    } catch (e13) {
     }
   }
   /**
@@ -2879,6 +2960,8 @@ var SynapClient = class {
       types,
       mode = "fast",
       precision_level: precisionLevel = "high",
+      query_date: queryDate,
+      max_results_per_query: maxResultsPerQuery,
       include_conversation_context: includeConversationContext = true,
       scopes,
       include_scope_labels: includeScopeLabels = false,
@@ -2893,7 +2976,12 @@ var SynapClient = class {
       max_results: maxResults,
       types,
       mode,
-      precision_level: precisionLevel
+      precision_level: precisionLevel,
+      // In `shared` so it reaches all four branches at once. The Python edit
+      // threaded three call sites by hand and missed the client branch, which
+      // sits one indent deeper; spreading removes that whole class of miss.
+      query_date: queryDate,
+      max_results_per_query: maxResultsPerQuery
     };
     const labels = [];
     const tasks = [];
@@ -2958,7 +3046,7 @@ var SynapClient = class {
         merged.conversation_context = await this.conversation.context.get_context_for_prompt({
           conversation_id: conversationId
         });
-      } catch (e11) {
+      } catch (e14) {
       }
     }
     merged.formatted_context = formatForPrompt(merged, {
@@ -3003,9 +3091,14 @@ var SynapClient = class {
         served_item_ids: served.servedItemIds,
         scope,
         source_bundle_ids: served.bundleId ? [served.bundleId] : [],
-        timestamp_ms: Date.now()
+        timestamp_ms: Date.now(),
+        // How many distinct search queries the fetch carried. A hit never
+        // reaches the fetch route, so this event is how the server learns it
+        // happened and what it is charged by. The count only: this event must
+        // not carry the caller's words.
+        query_count: distinctQueryCount(_nullishCoalesce(options["search_query"], () => ( options["searchQuery"])))
       });
-    } catch (e12) {
+    } catch (e15) {
     }
   }
   /**
@@ -3030,7 +3123,7 @@ var SynapClient = class {
         }),
         scope
       });
-    } catch (e13) {
+    } catch (e16) {
     }
   }
   /**
@@ -3108,7 +3201,7 @@ function pick3(o2, snake, camel) {
 function resolveBaseUrl(options) {
   const explicit = _nullishCoalesce(options.baseUrl, () => ( options.api_base_url));
   if (explicit !== void 0) return explicit;
-  const fromEnv = _optionalChain([_chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_BASE_URL"), 'optionalAccess', _50 => _50.trim, 'call', _51 => _51()]);
+  const fromEnv = _optionalChain([_chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_BASE_URL"), 'optionalAccess', _54 => _54.trim, 'call', _55 => _55()]);
   return fromEnv !== void 0 && fromEnv !== "" ? fromEnv : void 0;
 }
 function resolveCredentials(options) {
@@ -3175,5 +3268,6 @@ function resolveCredentials(options) {
 
 
 
-exports.ANY_SCOPE = _chunkT6U5PVADcjs.ANY_SCOPE; exports.AgentUnavailableError = _chunkT372OL3Qcjs.AgentUnavailableError; exports.AnticipationCache = _chunkT6U5PVADcjs.AnticipationCache; exports.AuthenticationError = _chunkT372OL3Qcjs.AuthenticationError; exports.BM25 = _chunkT6U5PVADcjs.BM25; exports.COMPACTION_LEVELS = COMPACTION_LEVELS; exports.CONTRACT = _chunkT6U5PVADcjs.CONTRACT; exports.ConflictError = _chunkT372OL3Qcjs.ConflictError; exports.ConnectionError = _chunkT372OL3Qcjs.ConnectionError; exports.ContextNotFoundError = _chunkT372OL3Qcjs.ContextNotFoundError; exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL; exports.DEFAULT_DOCUMENT_TYPE = DEFAULT_DOCUMENT_TYPE; exports.DEFAULT_INGEST_MODE = DEFAULT_INGEST_MODE; exports.DEFAULT_RETRY_POLICY = DEFAULT_RETRY_POLICY; exports.DEFAULT_TIMEOUTS = DEFAULT_TIMEOUTS; exports.DOCUMENT_TYPES = DOCUMENT_TYPES; exports.ENDPOINTS = ENDPOINTS; exports.HttpTransport = HttpTransport; exports.INGEST_MODES = INGEST_MODES; exports.ITEM_COLLECTIONS = ITEM_COLLECTIONS; exports.InsufficientCreditsError = _chunkT372OL3Qcjs.InsufficientCreditsError; exports.InvalidConversationIdError = _chunkT372OL3Qcjs.InvalidConversationIdError; exports.InvalidInputError = _chunkT372OL3Qcjs.InvalidInputError; exports.InvalidInstanceIdError = _chunkT372OL3Qcjs.InvalidInstanceIdError; exports.ListeningAlreadyActiveError = _chunkT372OL3Qcjs.ListeningAlreadyActiveError; exports.ListeningNotActiveError = _chunkT372OL3Qcjs.ListeningNotActiveError; exports.NetworkTimeoutError = _chunkT372OL3Qcjs.NetworkTimeoutError; exports.PermanentError = _chunkT372OL3Qcjs.PermanentError; exports.RateLimitError = _chunkT372OL3Qcjs.RateLimitError; exports.SDKError = _chunkT372OL3Qcjs.SDKError; exports.SDK_VERSION = SDK_VERSION; exports.ServiceUnavailableError = _chunkT372OL3Qcjs.ServiceUnavailableError; exports.SessionExpiredError = _chunkT372OL3Qcjs.SessionExpiredError; exports.SynapClient = SynapClient; exports.SynapError = _chunkT372OL3Qcjs.SynapError; exports.SynapPermanentError = _chunkT372OL3Qcjs.SynapPermanentError; exports.SynapTransientError = _chunkT372OL3Qcjs.SynapTransientError; exports.THRESHOLDS = _chunkT6U5PVADcjs.THRESHOLDS; exports.TranscriptConflictError = _chunkT372OL3Qcjs.TranscriptConflictError; exports.TransientError = _chunkT372OL3Qcjs.TransientError; exports.flattenContextItems = flattenContextItems; exports.formatForPrompt = formatForPrompt; exports.isOutcomeUnknown = isOutcomeUnknown; exports.isRecallQuery = _chunkT6U5PVADcjs.isRecallQuery; exports.isSynapError = _chunkT372OL3Qcjs.isSynapError; exports.mergeScopeResults = mergeScopeResults; exports.resolvePath = resolvePath; exports.shouldRetry = shouldRetry; exports.stem = _chunkT6U5PVADcjs.stem; exports.tokenize = _chunkT6U5PVADcjs.tokenize;
+
+exports.ANY_SCOPE = _chunkT6U5PVADcjs.ANY_SCOPE; exports.AgentUnavailableError = _chunkT372OL3Qcjs.AgentUnavailableError; exports.AnticipationCache = _chunkT6U5PVADcjs.AnticipationCache; exports.AuthenticationError = _chunkT372OL3Qcjs.AuthenticationError; exports.BM25 = _chunkT6U5PVADcjs.BM25; exports.COMPACTION_LEVELS = COMPACTION_LEVELS; exports.CONTRACT = _chunkT6U5PVADcjs.CONTRACT; exports.ConflictError = _chunkT372OL3Qcjs.ConflictError; exports.ConnectionError = _chunkT372OL3Qcjs.ConnectionError; exports.ContextNotFoundError = _chunkT372OL3Qcjs.ContextNotFoundError; exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL; exports.DEFAULT_DOCUMENT_TYPE = DEFAULT_DOCUMENT_TYPE; exports.DEFAULT_INGEST_MODE = DEFAULT_INGEST_MODE; exports.DEFAULT_RETRY_POLICY = DEFAULT_RETRY_POLICY; exports.DEFAULT_TIMEOUTS = DEFAULT_TIMEOUTS; exports.DOCUMENT_TYPES = DOCUMENT_TYPES; exports.ENDPOINTS = ENDPOINTS; exports.FORGET_MODES = FORGET_MODES; exports.HttpTransport = HttpTransport; exports.INGEST_MODES = INGEST_MODES; exports.ITEM_COLLECTIONS = ITEM_COLLECTIONS; exports.InsufficientCreditsError = _chunkT372OL3Qcjs.InsufficientCreditsError; exports.InvalidConversationIdError = _chunkT372OL3Qcjs.InvalidConversationIdError; exports.InvalidInputError = _chunkT372OL3Qcjs.InvalidInputError; exports.InvalidInstanceIdError = _chunkT372OL3Qcjs.InvalidInstanceIdError; exports.ListeningAlreadyActiveError = _chunkT372OL3Qcjs.ListeningAlreadyActiveError; exports.ListeningNotActiveError = _chunkT372OL3Qcjs.ListeningNotActiveError; exports.NetworkTimeoutError = _chunkT372OL3Qcjs.NetworkTimeoutError; exports.PermanentError = _chunkT372OL3Qcjs.PermanentError; exports.RateLimitError = _chunkT372OL3Qcjs.RateLimitError; exports.SDKError = _chunkT372OL3Qcjs.SDKError; exports.SDK_VERSION = SDK_VERSION; exports.ServiceUnavailableError = _chunkT372OL3Qcjs.ServiceUnavailableError; exports.SessionExpiredError = _chunkT372OL3Qcjs.SessionExpiredError; exports.SynapClient = SynapClient; exports.SynapError = _chunkT372OL3Qcjs.SynapError; exports.SynapPermanentError = _chunkT372OL3Qcjs.SynapPermanentError; exports.SynapTransientError = _chunkT372OL3Qcjs.SynapTransientError; exports.THRESHOLDS = _chunkT6U5PVADcjs.THRESHOLDS; exports.TranscriptConflictError = _chunkT372OL3Qcjs.TranscriptConflictError; exports.TransientError = _chunkT372OL3Qcjs.TransientError; exports.flattenContextItems = flattenContextItems; exports.formatForPrompt = formatForPrompt; exports.isOutcomeUnknown = isOutcomeUnknown; exports.isRecallQuery = _chunkT6U5PVADcjs.isRecallQuery; exports.isSynapError = _chunkT372OL3Qcjs.isSynapError; exports.mergeScopeResults = mergeScopeResults; exports.resolvePath = resolvePath; exports.shouldRetry = shouldRetry; exports.stem = _chunkT6U5PVADcjs.stem; exports.tokenize = _chunkT6U5PVADcjs.tokenize;
 //# sourceMappingURL=index.cjs.map