@vinaverse/server 0.1.0-alpha.15 → 0.1.0-alpha.16

package/README.md

@@ -160,6 +160,14 @@ try {
   `conversations.delete(id, { subject_id })` read and delete a person's past conversations; another subject's or an
   unknown conversation is `not_found`, never told apart. **Served from A7**, when the gateway's history support ships:
   until then every call is answered 404, which reads as `not_found` and does not mean the conversation is unknown.
+- **The chat experience:** `agents.getExperience(agent, { experience_mode })` reads the tenant's chat settings for an
+  agent, resolved, before any session: copy it into your agent status as `features.chat`. Inside a session the app
+  reads the session's own copy. **Served once the gateway's chat settings ship** (VIN-115): until then the call is
+  answered 404, which reads as `not_found` and does not mean the agent is unknown.
+- **Memory:** `subjects.getMemory(id, { experience_mode })`, `subjects.putMemory(id, body)`,
+  `subjects.acknowledgeMemoryNotice(id, { version })` and `subjects.deleteMemoryPreference(id, preferenceId)` back a
+  person's memory settings screen: what the agent remembers, their choice, the notice they saw, and forgetting one
+  thing.
 - **Every operation** is also on `vinaverse.api`, the typed openapi-fetch client (`api.GET('/v1/usage')`).
 - **Backend only.** The client refuses a client secret, and refuses to start in a browser or in React Native: a
   service key there ships to everyone who loads the app. Apps use `@vinaverse/client` with the session's client secret.

package/dist/api.cjs

@@ -470,6 +470,50 @@ function createApiClient(options) {
           params: { path: { subject_id: subjectId }, header },
           ...init(o)
         })
+      ),
+      /** What the agent remembers of the person, and their choice, on one side of the app (memory settings). */
+      getMemory: (subjectId, query = {}, o) => run(
+        api.GET("/v1/subjects/{subject_id}/memory", {
+          params: { path: { subject_id: subjectId }, query },
+          ...init(o)
+        })
+      ),
+      /** The person's choice: whether the agent may remember them. */
+      putMemory: (subjectId, body, o) => run(
+        api.PUT("/v1/subjects/{subject_id}/memory", {
+          params: { path: { subject_id: subjectId } },
+          body,
+          ...init(o)
+        })
+      ),
+      /** The person saw the memory notice of this version. */
+      acknowledgeMemoryNotice: (subjectId, body, o) => run(
+        api.POST("/v1/subjects/{subject_id}/memory/notice", {
+          params: { path: { subject_id: subjectId } },
+          body,
+          ...init(o)
+        })
+      ),
+      /** Forgets one thing the agent learned about the person. */
+      deleteMemoryPreference: (subjectId, preferenceId, o) => run(
+        api.DELETE(
+          "/v1/subjects/{subject_id}/memory/preferences/{preference_id}",
+          {
+            params: {
+              path: { subject_id: subjectId, preference_id: preferenceId }
+            },
+            ...init(o)
+          }
+        )
+      )
+    },
+    agents: {
+      /** The tenant's chat experience for an agent, resolved, before any session: copy it into the agent status. */
+      getExperience: (agent, query = {}, o) => run(
+        api.GET("/v1/agents/{agent}/experience", {
+          params: { path: { agent }, query },
+          ...init(o)
+        })
       )
     },
     feedback: {

package/dist/api.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/api/errors.ts","../src/api/random.ts","../src/api/retry.ts","../src/api/client.ts"],"names":["createClient","key"],"mappings":"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","file":"api.cjs","sourcesContent":["// What the Vinaverse API answers when it refuses a call: RFC 9457 problem details (vinaverse-v1.yaml, `Problem`),\n// as a typed error. conformance/README.md §5 lists every code with its status and whether it is retryable.\nimport type { components } from '../generated/vinaverse-v1.js';\n\nexport type ApiProblem = components['schemas']['Problem'];\nexport type ApiProblemCode = ApiProblem['code'];\n\n/** The API refused a call: its problem details, typed, with the request id to quote to support. */\nexport class VinaverseApiError extends Error {\n  override readonly name = 'VinaverseApiError';\n  readonly status: number;\n  /** The problem's code (`invalid_request`, `rate_limited`, …), or `http_<status>` when the body was not a problem. */\n  readonly code: ApiProblemCode | `http_${number}`;\n  /** Whether the same call may succeed later: the problem's `retryable`, else true for 429 and 5xx. */\n  readonly retryable: boolean;\n  /** `Vinaverse-Request-Id`, or the problem's `request_id`. */\n  readonly requestId: string | undefined;\n  /** `Retry-After`, in seconds, when the API sent one. */\n  readonly retryAfter: number | undefined;\n  /** For `invalid_request`: the fields refused, as JSON Pointers into the request. */\n  readonly errors: readonly { pointer: string; message: string }[];\n  /** The problem as sent, or undefined when the body was not one. */\n  readonly problem: ApiProblem | undefined;\n  /** The `Idempotency-Key` the call carried: send the same call again with it to have it done once. */\n  readonly idempotencyKey: string | undefined;\n\n  constructor(init: {\n    status: number;\n    problem?: ApiProblem | undefined;\n    requestId?: string | undefined;\n    retryAfter?: number | undefined;\n    idempotencyKey?: string | undefined;\n  }) {\n    const { status, problem } = init;\n    super(\n      problem\n        ? `${problem.title} (${problem.code})${problem.detail ? `: ${problem.detail}` : ''}`\n        : `The Vinaverse API answered HTTP ${status}.`,\n    );\n    this.idempotencyKey = init.idempotencyKey;\n    this.status = status;\n    this.problem = problem;\n    this.code = problem?.code ?? `http_${status}`;\n    this.retryable = problem?.retryable ?? (status === 429 || status >= 500);\n    this.requestId = init.requestId ?? problem?.request_id;\n    this.retryAfter = init.retryAfter;\n    this.errors = problem?.errors ?? [];\n  }\n}\n\n/** The error for a refused response and its parsed body: what every call of the API client throws. */\nexport function apiError(\n  response: Response,\n  body: unknown,\n  idempotencyKey?: string,\n): VinaverseApiError {\n  return new VinaverseApiError({\n    status: response.status,\n    problem: isProblem(body) ? body : undefined,\n    requestId: response.headers.get('vinaverse-request-id') ?? undefined,\n    retryAfter: retryAfterSeconds(response),\n    idempotencyKey,\n  });\n}\n\n/** `Retry-After` in seconds: a number of seconds or an HTTP date; undefined when absent or unreadable. */\nexport function retryAfterSeconds(\n  response: Response,\n  now: () => number = Date.now,\n): number | undefined {\n  const value = response.headers.get('retry-after');\n  if (value === null || value.trim() === '') return undefined;\n  if (/^\\d+$/.test(value.trim())) return Number(value.trim());\n  const at = Date.parse(value);\n  return Number.isNaN(at)\n    ? undefined\n    : Math.max(0, Math.ceil((at - now()) / 1000));\n}\n\nfunction isProblem(body: unknown): body is ApiProblem {\n  if (typeof body !== 'object' || body === null) return false;\n  const b = body as Record<string, unknown>;\n  return typeof b.code === 'string' && typeof b.status === 'number';\n}\n","// A random UUID for idempotency keys wherever the client runs. Node 20+, Deno, Bun and edge runtimes have\n// `crypto.randomUUID`; Node 18 has it only in its crypto module when loaded as an ES module, so it is loaded from\n// there, once.\nlet fromNode: Promise<() => string> | undefined;\n\nexport async function randomUUID(): Promise<string> {\n  const global = (globalThis as { crypto?: { randomUUID?: () => string } })\n    .crypto;\n  if (global?.randomUUID) return global.randomUUID();\n  // Built at run time on purpose: a bundler for an edge runtime, where this line never runs, must not resolve it.\n  const specifier = ['node', 'crypto'].join(':');\n  fromNode ??= import(\n    /* webpackIgnore: true */ /* @vite-ignore */ specifier\n  ).then((mod: { randomUUID: () => string }) => mod.randomUUID);\n  return (await fromNode)();\n}\n","// Safe retries for calls to the Vinaverse API. A call is sent again only when that cannot do it twice:\n// - `429`: the API refused it before doing anything, so any call is retried, after its `Retry-After`;\n// - a retryable failure (a `5xx`, a problem with `retryable: true`, a timeout or a network error): only a read\n//   (`GET`, `HEAD`, `OPTIONS`), an idempotent `PUT` or `DELETE`, or a call carrying an `Idempotency-Key`, which the\n//   API answers once whatever the number of tries.\n// Delays: `Retry-After` when the API sends one, else 0.5 s doubling, with jitter; a `Retry-After` longer than\n// `maxRetryDelay` is not waited for: the refusal is returned.\n// Each try reads the whole response within its timeout, so a stalled body cannot hang a call, and the caller's\n// signal stops everything at once: a try in flight, a body being read, a wait between tries. An aborted signal never\n// sends the call. Redirects are refused: a service key never follows one.\n\nimport { retryAfterSeconds } from './errors.js';\n\nexport type FetchFn = (input: Request) => Promise<Response>;\n\nexport interface RetryOptions {\n  /** Retries after the first try: a whole number, 0 or more; default 2. */\n  readonly maxRetries?: number;\n  /** The longest wait, in seconds, before a retry: 0 to 2 147 483 (a timer's limit); default 30. */\n  readonly maxRetryDelay?: number;\n  /** One try's timeout, reading the body included, in milliseconds: more than 0, at most 2 147 483 647; default 30 000. */\n  readonly timeout?: number;\n  /** Waits, in milliseconds; tests replace it. The wait ends early when the call is aborted. */\n  readonly sleep?: (ms: number) => Promise<void>;\n  readonly random?: () => number;\n}\n\nconst IDEMPOTENT = new Set(['GET', 'HEAD', 'PUT', 'DELETE', 'OPTIONS']);\n/** Statuses whose responses have no body. */\nconst NULL_BODY = new Set([101, 204, 205, 304]);\n/** A refusal's body is read up to this size: a problem is far smaller; more is an intermediary's page. */\nconst MAX_REFUSAL_BYTES = 64 * 1024;\n\n/**\n * The API did not answer within `timeout` on the last try. `idempotencyKey` is the key the call carried: pass it as\n * `{ idempotencyKey }` to try the same call again later without doing it twice.\n */\nexport class VinaverseTimeoutError extends Error {\n  override readonly name = 'VinaverseTimeoutError';\n  readonly idempotencyKey: string | undefined;\n  constructor(ms: number, idempotencyKey?: string) {\n    super(`The Vinaverse API did not answer within ${ms} ms.`);\n    this.idempotencyKey = idempotencyKey;\n  }\n}\n\n/** The call could not reach the API (`cause` holds why). `idempotencyKey` as for a timeout. */\nexport class VinaverseNetworkError extends Error {\n  override readonly name = 'VinaverseNetworkError';\n  readonly idempotencyKey: string | undefined;\n  constructor(cause: unknown, idempotencyKey?: string) {\n    super(\n      `The Vinaverse API could not be reached: ${cause instanceof Error ? cause.message : String(cause)}`,\n      { cause },\n    );\n    this.idempotencyKey = idempotencyKey;\n  }\n}\n\n/** The longest a timer can wait: beyond it, Node fires it after 1 ms. */\nconst MAX_TIMER_MS = 2_147_483_647;\n\n/**\n * `guard` checks each request's URL before anything is sent (the client allows its own origin only); what it throws\n * is thrown as is.\n */\nexport function retryingFetch(\n  fetchFn: FetchFn,\n  options: RetryOptions = {},\n  guard: (url: string) => void = () => {},\n): FetchFn {\n  const maxRetries = check(\n    'maxRetries',\n    options.maxRetries ?? 2,\n    (n) => Number.isSafeInteger(n) && n >= 0,\n  );\n  const maxDelay =\n    check(\n      'maxRetryDelay',\n      options.maxRetryDelay ?? 30,\n      (n) => Number.isFinite(n) && n >= 0 && n * 1000 <= MAX_TIMER_MS,\n    ) * 1000;\n  const timeout = check(\n    'timeout',\n    options.timeout ?? 30_000,\n    (n) => Number.isFinite(n) && n > 0 && n <= MAX_TIMER_MS,\n  );\n  const sleep = options.sleep;\n  const random = options.random ?? Math.random;\n\n  return async (request) => {\n    guard(request.url);\n    const signal = request.signal;\n    const key = request.headers.get('idempotency-key') ?? undefined;\n    const replayable =\n      IDEMPOTENT.has(request.method.toUpperCase()) || key !== undefined;\n    for (let attempt = 0; ; attempt++) {\n      if (signal.aborted) throw aborted(signal);\n      const last = attempt >= maxRetries;\n      let response: Response;\n      try {\n        response = await once(fetchFn, request.clone(), signal, timeout);\n      } catch (error) {\n        if (signal.aborted) throw aborted(signal);\n        // A network error or a timeout: the call may have been done; only a replayable one goes again.\n        if (last || !replayable) {\n          throw error instanceof VinaverseTimeoutError\n            ? new VinaverseTimeoutError(timeout, key)\n            : new VinaverseNetworkError(error, key);\n        }\n        await wait(sleep, Math.min(backoff(attempt, random), maxDelay), signal);\n        continue;\n      }\n      const retry =\n        response.status === 429 ||\n        (replayable && retryable(response, await problemOf(response)));\n      if (!retry || last) return response;\n      const delay = retryAfter(response) ?? backoff(attempt, random);\n      if (delay > maxDelay) return response;\n      await wait(sleep, delay, signal);\n    }\n  };\n}\n\n/** One try, its body read in full within the timeout; refused bodies up to `MAX_REFUSAL_BYTES`. */\nasync function once(\n  fetchFn: FetchFn,\n  request: Request,\n  signal: AbortSignal,\n  timeout: number,\n): Promise<Response> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeout);\n  const stop = () => controller.abort();\n  signal.addEventListener('abort', stop, { once: true });\n  if (signal.aborted) controller.abort();\n  try {\n    // Raced against the timeout and the caller's signal too, so a transport that ignores its signal is still bounded.\n    const pending = fetchFn(\n      new Request(request, { signal: controller.signal, redirect: 'error' }),\n    );\n    pending.catch(() => {}); // when the abort wins, the transport's own failure is not reported twice\n    const response = await until(pending, controller.signal);\n    const empty = NULL_BODY.has(response.status);\n    const body = empty\n      ? null\n      : await readBody(\n          response,\n          response.ok ? Number.POSITIVE_INFINITY : MAX_REFUSAL_BYTES,\n          controller.signal,\n        );\n    return new Response(body, {\n      status: response.status,\n      statusText: response.statusText,\n      headers: response.headers,\n    });\n  } catch (error) {\n    if (controller.signal.aborted && !signal.aborted)\n      throw new VinaverseTimeoutError(timeout);\n    throw error;\n  } finally {\n    clearTimeout(timer);\n    signal.removeEventListener('abort', stop);\n  }\n}\n\nasync function readBody(\n  response: Response,\n  limit: number,\n  signal: AbortSignal,\n): Promise<Uint8Array<ArrayBuffer> | null> {\n  if (!response.body) return null;\n  const reader = response.body.getReader();\n  const chunks: Uint8Array[] = [];\n  let size = 0;\n  for (;;) {\n    const read = reader.read();\n    read.catch(() => {}); // an abort below wins; the read's own failure is not reported twice\n    const { done, value } = await until(read, signal).catch(\n      async (error: unknown) => {\n        void reader.cancel().catch(() => {}); // not awaited: a teed body settles its cancel only with its twin\n        throw error;\n      },\n    );\n    if (done) break;\n    chunks.push(value);\n    size += value.length;\n    if (size >= limit) {\n      void reader.cancel().catch(() => {}); // not awaited: a teed body settles its cancel only with its twin\n      break;\n    }\n  }\n  const body = new Uint8Array(new ArrayBuffer(Math.min(size, limit)));\n  let at = 0;\n  for (const chunk of chunks) {\n    const part = chunk.subarray(0, body.length - at);\n    body.set(part, at);\n    at += part.length;\n    if (at >= body.length) break;\n  }\n  return body;\n}\n\nasync function problemOf(\n  response: Response,\n): Promise<{ retryable?: unknown } | undefined> {\n  if (response.ok) return undefined;\n  try {\n    return (await response.clone().json()) as { retryable?: unknown };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction retryable(\n  response: Response,\n  problem: { retryable?: unknown } | undefined,\n): boolean {\n  if (response.status >= 500) return true;\n  // Another refusal is retried only when the API says so.\n  return response.status >= 400 && problem?.retryable === true;\n}\n\n/** `promise`, or the signal's abort, whichever comes first. */\nasync function until<T>(promise: Promise<T>, signal: AbortSignal): Promise<T> {\n  if (signal.aborted) throw aborted(signal);\n  let stop: () => void = () => {};\n  const abort = new Promise<never>((_, reject) => {\n    stop = () => reject(aborted(signal));\n    signal.addEventListener('abort', stop, { once: true });\n  });\n  try {\n    return await Promise.race([promise, abort]);\n  } finally {\n    signal.removeEventListener('abort', stop);\n  }\n}\n\n/** Waits `ms`, or less: an abort ends the wait, clears its timer, and throws. */\nfunction wait(\n  sleep: ((ms: number) => Promise<void>) | undefined,\n  ms: number,\n  signal: AbortSignal,\n): Promise<void> {\n  if (sleep) return until(sleep(ms), signal);\n  if (signal.aborted) return Promise.reject(aborted(signal));\n  return new Promise<void>((resolve, reject) => {\n    const stop = () => {\n      clearTimeout(timer);\n      reject(aborted(signal));\n    };\n    const timer = setTimeout(() => {\n      signal.removeEventListener('abort', stop);\n      resolve();\n    }, ms);\n    signal.addEventListener('abort', stop, { once: true });\n  });\n}\n\nfunction aborted(signal: AbortSignal): unknown {\n  return (\n    signal.reason ?? new DOMException('The call was aborted.', 'AbortError')\n  );\n}\n\nfunction retryAfter(response: Response): number | undefined {\n  const seconds = retryAfterSeconds(response);\n  return seconds === undefined ? undefined : seconds * 1000;\n}\n\nfunction backoff(attempt: number, random: () => number): number {\n  const base = 500 * 2 ** attempt;\n  return Math.round(base / 2 + random() * (base / 2));\n}\n\nfunction check(\n  name: string,\n  value: number,\n  valid: (n: number) => boolean,\n): number {\n  if (typeof value !== 'number' || !valid(value)) {\n    throw new TypeError(`${name} is not valid: ${String(value)}`);\n  }\n  return value;\n}\n","// The Vinaverse API from a Node backend: typed calls generated from the pinned public contract (vinaverse-v1.yaml,\n// through openapi-fetch), authenticated with a service key, with idempotency keys added where the contract wants\n// one, safe retries honouring `Retry-After` (./retry.ts), and refusals thrown as typed errors (./errors.ts).\n// A service key never belongs in a browser or an app: the client refuses to start there.\nimport createClient, { type Client } from 'openapi-fetch';\nimport type { operations, paths } from '../generated/vinaverse-v1.js';\nimport { apiError } from './errors.js';\nimport { randomUUID } from './random.js';\nimport { type FetchFn, type RetryOptions, retryingFetch } from './retry.js';\n\ntype Op = operations;\n/** An operation's JSON request body. */\nexport type ApiBody<K extends keyof Op> = Op[K] extends {\n  requestBody?: { content: { 'application/json': infer B } };\n}\n  ? B\n  : never;\n/** An operation's success result. */\nexport type ApiResult<K extends keyof Op> = Success<Op[K]['responses']>;\ntype Success<R> = R extends {\n  200: { content: { 'application/json': infer B } };\n}\n  ? B\n  : R extends { 201: { content: { 'application/json': infer B } } }\n    ? B\n    : R extends { 202: { content: { 'application/json': infer B } } }\n      ? B\n      : undefined;\ntype QueryOf<K extends keyof Op> = Op[K]['parameters'] extends {\n  query?: infer Q;\n}\n  ? NonNullable<Q>\n  : never;\n\n/** Per call: a signal that stops it at once, waits between tries included. */\nexport interface CallOptions {\n  readonly signal?: AbortSignal;\n}\n\n/**\n * For the calls the contract makes idempotent: a key of your own, 1 to 255 characters (one is made otherwise).\n * After a `VinaverseTimeoutError` or a `VinaverseNetworkError`, try again later with the error's `idempotencyKey`,\n * so the call is done once however many times it is sent.\n */\nexport interface KeyedCallOptions extends CallOptions {\n  readonly idempotencyKey?: string;\n}\n\nexport interface ApiClientOptions extends RetryOptions {\n  /** A service key, `vv_sk_<mock|dev|live>_…`: from your secrets store, never from code. */\n  readonly apiKey: string;\n  /**\n   * Default: `https://api.vinaverse.com` for a live key, `https://api-dev.vinaverse.com` for mock and dev keys. Any\n   * other URL must be `https:` (a proxy you run, say), or `http:` on this machine only (`localhost`, `127.0.0.1`,\n   * `[::1]`): a service key never travels in clear.\n   */\n  readonly baseUrl?: string;\n  readonly fetch?: (request: Request) => Promise<Response>;\n  /** Extra headers on every call, for example `Vinaverse-Mock-Scenario` in tests against the mock environment. */\n  readonly headers?: Readonly<Record<string, string>>;\n}\n\nconst SERVICE_KEY = /^vv_sk_(mock|dev|live)_[A-Za-z0-9_-]{8,}$/;\n\n/** The client was made where a service key must never be: a browser or an app. */\nexport class ServiceKeyExposureError extends Error {\n  override readonly name = 'ServiceKeyExposureError';\n}\n\nexport function createApiClient(options: ApiClientOptions) {\n  refuseClientRuntime();\n  const key = options.apiKey;\n  if (typeof key !== 'string' || !SERVICE_KEY.test(key)) {\n    throw new TypeError(\n      key?.startsWith?.('vv_cs_')\n        ? 'createApiClient takes a service key (vv_sk_…); a client secret (vv_cs_…) is for the app'\n        : 'createApiClient needs a service key: vv_sk_<mock|dev|live>_…',\n    );\n  }\n  const live = key.startsWith('vv_sk_live_');\n  const baseUrl = safeBaseUrl(\n    options.baseUrl ??\n      (live ? 'https://api.vinaverse.com' : 'https://api-dev.vinaverse.com'),\n  );\n  const transport: FetchFn =\n    options.fetch ?? ((request) => globalThis.fetch(request));\n  const api: Client<paths> = createClient<paths>({\n    baseUrl,\n    redirect: 'error', // the API never redirects; a service key never follows one\n    // Every request, from a helper or from `api` with a per-call baseUrl, goes to this origin only.\n    fetch: retryingFetch(transport, options, sameOrigin(baseUrl)),\n    headers: {\n      ...options.headers,\n      authorization: `Bearer ${key}`,\n      accept: 'application/json',\n    },\n  });\n\n  type Answer = Promise<{\n    data?: unknown;\n    error?: unknown;\n    response: Response;\n  }>;\n  async function run<T>(call: Answer, idempotencyKey?: string): Promise<T> {\n    const { data, error, response } = await call;\n    if (!response.ok) throw apiError(response, error, idempotencyKey);\n    return data as T;\n  }\n  /** A call the contract makes idempotent: under the caller's key, or a new one, on every try. */\n  async function keyed<T>(\n    o: KeyedCallOptions | undefined,\n    call: (header: { 'Idempotency-Key': string }) => Answer,\n  ): Promise<T> {\n    const key = o?.idempotencyKey ?? (await newKey());\n    if (typeof key !== 'string' || key.length < 1 || key.length > 255) {\n      throw new TypeError('idempotencyKey must be 1 to 255 characters');\n    }\n    return run<T>(call({ 'Idempotency-Key': key }), key);\n  }\n  const init = (o?: CallOptions) => (o?.signal ? { signal: o.signal } : {});\n\n  return {\n    /** Every operation of the contract, typed, for what the helpers below do not cover (openapi-fetch). */\n    api,\n    sessions: {\n      /** Mint a session for the person in your app; give the app its `id`, URLs and `client_secret` only. */\n      create: (body: ApiBody<'createSession'>, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'createSession'>>(o, (header) =>\n          api.POST('/v1/sessions', {\n            body,\n            params: { header },\n            ...init(o),\n          }),\n        ),\n      get: (sessionId: string, o?: CallOptions) =>\n        run<ApiResult<'getSession'>>(\n          api.GET('/v1/sessions/{session_id}', {\n            params: { path: { session_id: sessionId } },\n            ...init(o),\n          }),\n        ),\n      revoke: (sessionId: string, o?: CallOptions) =>\n        run<ApiResult<'revokeSession'>>(\n          api.POST('/v1/sessions/{session_id}/revoke', {\n            params: { path: { session_id: sessionId } },\n            ...init(o),\n          }),\n        ),\n      /**\n       * Where the person is now, for an open session (no new session per screen): a screen context, or\n       * `{ clear: true, revision }`; `revision` greater than the session's, the same revision and body a retry.\n       */\n      updateContext: (\n        sessionId: string,\n        body: ApiBody<'updateSessionContext'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'updateSessionContext'>>(\n          api.PUT('/v1/sessions/{session_id}/context', {\n            params: { path: { session_id: sessionId } },\n            body,\n            ...init(o),\n          }),\n        ),\n      /** A fresh client secret for an open session: what an app's `refreshSecret(sessionId)` asks your backend for. */\n      refreshClientSecret: (sessionId: string, o?: CallOptions) =>\n        run<ApiResult<'refreshClientSecret'>>(\n          api.POST('/v1/sessions/{session_id}/client_secret', {\n            params: { path: { session_id: sessionId } },\n            ...init(o),\n          }),\n        ),\n    },\n    conversations: {\n      get: (conversationId: string, o?: CallOptions) =>\n        run<ApiResult<'getConversation'>>(\n          api.GET('/v1/conversations/{conversation_id}', {\n            params: { path: { conversation_id: conversationId } },\n            ...init(o),\n          }),\n        ),\n      /** A person's past conversations with an agent, newest activity first (history). */\n      list: (query: QueryOf<'listConversations'>, o?: CallOptions) =>\n        run<ApiResult<'listConversations'>>(\n          api.GET('/v1/conversations', { params: { query }, ...init(o) }),\n        ),\n      /** A past conversation's messages, the newest page first and oldest first within a page. */\n      listMessages: (\n        conversationId: string,\n        query: QueryOf<'listConversationMessages'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'listConversationMessages'>>(\n          api.GET('/v1/conversations/{conversation_id}/messages', {\n            params: { path: { conversation_id: conversationId }, query },\n            ...init(o),\n          }),\n        ),\n      /** Deletes a person's conversation (history's delete); another subject's or an unknown one is `not_found`. */\n      delete: (\n        conversationId: string,\n        query: QueryOf<'deleteConversation'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'deleteConversation'>>(\n          api.DELETE('/v1/conversations/{conversation_id}', {\n            params: { path: { conversation_id: conversationId }, query },\n            ...init(o),\n          }),\n        ),\n    },\n    suggestions: {\n      create: (body: ApiBody<'createSuggestions'>, o?: CallOptions) =>\n        run<ApiResult<'createSuggestions'>>(\n          api.POST('/v1/suggestions', { body, ...init(o) }),\n        ),\n    },\n    moderation: {\n      createJob: (body: ApiBody<'createModerationJob'>, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'createModerationJob'>>(o, (header) =>\n          api.POST('/v1/moderation/jobs', {\n            body,\n            params: { header },\n            ...init(o),\n          }),\n        ),\n      getJob: (jobId: string, o?: CallOptions) =>\n        run<ApiResult<'getModerationJob'>>(\n          api.GET('/v1/moderation/jobs/{job_id}', {\n            params: { path: { job_id: jobId } },\n            ...init(o),\n          }),\n        ),\n      getItem: (itemId: string, o?: CallOptions) =>\n        run<ApiResult<'getModerationItem'>>(\n          api.GET('/v1/moderation/items/{item_id}', {\n            params: { path: { item_id: itemId } },\n            ...init(o),\n          }),\n        ),\n    },\n    media: {\n      createJob: (body: ApiBody<'createMediaJob'>, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'createMediaJob'>>(o, (header) =>\n          api.POST('/v1/media/jobs', {\n            body,\n            params: { header },\n            ...init(o),\n          }),\n        ),\n      listJobs: (query: QueryOf<'listMediaJobs'> = {}, o?: CallOptions) =>\n        run<ApiResult<'listMediaJobs'>>(\n          api.GET('/v1/media/jobs', { params: { query }, ...init(o) }),\n        ),\n      getJob: (jobId: string, o?: CallOptions) =>\n        run<ApiResult<'getMediaJob'>>(\n          api.GET('/v1/media/jobs/{job_id}', {\n            params: { path: { job_id: jobId } },\n            ...init(o),\n          }),\n        ),\n      cancelJob: (jobId: string, o?: CallOptions) =>\n        run<ApiResult<'cancelMediaJob'>>(\n          api.POST('/v1/media/jobs/{job_id}/cancel', {\n            params: { path: { job_id: jobId } },\n            ...init(o),\n          }),\n        ),\n      listProfiles: (o?: CallOptions) =>\n        run<ApiResult<'listMediaProfiles'>>(\n          api.GET('/v1/media/profiles', { ...init(o) }),\n        ),\n    },\n    screening: {\n      text: (body: ApiBody<'screenText'>, o?: CallOptions) =>\n        run<ApiResult<'screenText'>>(\n          api.POST('/v1/screening/text', { body, ...init(o) }),\n        ),\n    },\n    documentChecks: {\n      create: (body: ApiBody<'createDocumentCheck'>, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'createDocumentCheck'>>(o, (header) =>\n          api.POST('/v1/document-checks', {\n            body,\n            params: { header },\n            ...init(o),\n          }),\n        ),\n      get: (checkId: string, o?: CallOptions) =>\n        run<ApiResult<'getDocumentCheck'>>(\n          api.GET('/v1/document-checks/{check_id}', {\n            params: { path: { check_id: checkId } },\n            ...init(o),\n          }),\n        ),\n    },\n    subjects: {\n      erase: (subjectId: string, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'eraseSubject'>>(o, (header) =>\n          api.POST('/v1/subjects/{subject_id}/erase', {\n            params: { path: { subject_id: subjectId }, header },\n            ...init(o),\n          }),\n        ),\n    },\n    feedback: {\n      send: (body: ApiBody<'sendFeedback'>, o?: CallOptions) =>\n        run<ApiResult<'sendFeedback'>>(\n          api.POST('/v1/feedback', { body, ...init(o) }),\n        ),\n    },\n    events: {\n      send: (body: ApiBody<'sendEvents'>, o?: CallOptions) =>\n        run<ApiResult<'sendEvents'>>(\n          api.POST('/v1/events', { body, ...init(o) }),\n        ),\n    },\n    knowledge: {\n      sendDocument: (body: ApiBody<'sendKnowledgeDocument'>, o?: CallOptions) =>\n        run<ApiResult<'sendKnowledgeDocument'>>(\n          api.POST('/v1/knowledge/documents', { body, ...init(o) }),\n        ),\n    },\n    catalog: {\n      put: (\n        type: Op['putCatalogEntity']['parameters']['path']['type'],\n        id: string,\n        body: ApiBody<'putCatalogEntity'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'putCatalogEntity'>>(\n          api.PUT('/v1/catalog/{type}/{id}', {\n            params: { path: { type, id } },\n            body,\n            ...init(o),\n          }),\n        ),\n    },\n    usage: {\n      get: (query: QueryOf<'getUsage'> = {}, o?: CallOptions) =>\n        run<ApiResult<'getUsage'>>(\n          api.GET('/v1/usage', { params: { query }, ...init(o) }),\n        ),\n    },\n  };\n}\n\nexport type ApiClient = ReturnType<typeof createApiClient>;\n\n/**\n * Throws in a browser (a `window` with a `document`) and in React Native: a service key there ships to everyone who\n * loads the app. Node, AWS Lambda, Deno, Bun and edge runtimes have neither.\n */\nfunction refuseClientRuntime(): void {\n  const scope = globalThis as {\n    window?: unknown;\n    document?: unknown;\n    navigator?: { product?: unknown };\n  };\n  if (scope.window !== undefined && scope.document !== undefined) {\n    throw new ServiceKeyExposureError(\n      'The Vinaverse API client holds a service key and runs on your backend only, never in a browser. Give the app a session client secret (sessions.create).',\n    );\n  }\n  if (scope.navigator?.product === 'ReactNative') {\n    throw new ServiceKeyExposureError(\n      'The Vinaverse API client holds a service key and runs on your backend only, never in an app. Use @vinaverse/client with a session client secret.',\n    );\n  }\n}\n\nconst LOOPBACK = new Set(['localhost', '127.0.0.1', '[::1]']);\n\n/** The base URL, checked: `https:`, or `http:` on this machine only, so a service key never travels in clear. */\nfunction safeBaseUrl(value: string): string {\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    throw new TypeError(`baseUrl is not a URL: ${value}`);\n  }\n  if (\n    url.protocol !== 'https:' &&\n    !(url.protocol === 'http:' && LOOPBACK.has(url.hostname))\n  ) {\n    throw new TypeError(\n      `baseUrl must be https: (or http: on localhost); a service key never travels in clear: ${url.origin}`,\n    );\n  }\n  return value.replace(/\\/+$/, '');\n}\n\n/** A check for every request: the client's own origin, and so never in clear nor to another host. */\nfunction sameOrigin(baseUrl: string): (url: string) => void {\n  const origin = new URL(baseUrl).origin;\n  return (url) => {\n    const target = new URL(url);\n    if (target.origin !== origin) {\n      throw new TypeError(\n        `The Vinaverse API client sends its service key to ${origin} only, not to ${target.origin}`,\n      );\n    }\n  };\n}\n\nfunction newKey(): Promise<string> {\n  return randomUUID();\n}\n"]}
+{"version":3,"sources":["../src/api/errors.ts","../src/api/random.ts","../src/api/retry.ts","../src/api/client.ts"],"names":["createClient","key"],"mappings":"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","file":"api.cjs","sourcesContent":["// What the Vinaverse API answers when it refuses a call: RFC 9457 problem details (vinaverse-v1.yaml, `Problem`),\n// as a typed error. conformance/README.md §5 lists every code with its status and whether it is retryable.\nimport type { components } from '../generated/vinaverse-v1.js';\n\nexport type ApiProblem = components['schemas']['Problem'];\nexport type ApiProblemCode = ApiProblem['code'];\n\n/** The API refused a call: its problem details, typed, with the request id to quote to support. */\nexport class VinaverseApiError extends Error {\n  override readonly name = 'VinaverseApiError';\n  readonly status: number;\n  /** The problem's code (`invalid_request`, `rate_limited`, …), or `http_<status>` when the body was not a problem. */\n  readonly code: ApiProblemCode | `http_${number}`;\n  /** Whether the same call may succeed later: the problem's `retryable`, else true for 429 and 5xx. */\n  readonly retryable: boolean;\n  /** `Vinaverse-Request-Id`, or the problem's `request_id`. */\n  readonly requestId: string | undefined;\n  /** `Retry-After`, in seconds, when the API sent one. */\n  readonly retryAfter: number | undefined;\n  /** For `invalid_request`: the fields refused, as JSON Pointers into the request. */\n  readonly errors: readonly { pointer: string; message: string }[];\n  /** The problem as sent, or undefined when the body was not one. */\n  readonly problem: ApiProblem | undefined;\n  /** The `Idempotency-Key` the call carried: send the same call again with it to have it done once. */\n  readonly idempotencyKey: string | undefined;\n\n  constructor(init: {\n    status: number;\n    problem?: ApiProblem | undefined;\n    requestId?: string | undefined;\n    retryAfter?: number | undefined;\n    idempotencyKey?: string | undefined;\n  }) {\n    const { status, problem } = init;\n    super(\n      problem\n        ? `${problem.title} (${problem.code})${problem.detail ? `: ${problem.detail}` : ''}`\n        : `The Vinaverse API answered HTTP ${status}.`,\n    );\n    this.idempotencyKey = init.idempotencyKey;\n    this.status = status;\n    this.problem = problem;\n    this.code = problem?.code ?? `http_${status}`;\n    this.retryable = problem?.retryable ?? (status === 429 || status >= 500);\n    this.requestId = init.requestId ?? problem?.request_id;\n    this.retryAfter = init.retryAfter;\n    this.errors = problem?.errors ?? [];\n  }\n}\n\n/** The error for a refused response and its parsed body: what every call of the API client throws. */\nexport function apiError(\n  response: Response,\n  body: unknown,\n  idempotencyKey?: string,\n): VinaverseApiError {\n  return new VinaverseApiError({\n    status: response.status,\n    problem: isProblem(body) ? body : undefined,\n    requestId: response.headers.get('vinaverse-request-id') ?? undefined,\n    retryAfter: retryAfterSeconds(response),\n    idempotencyKey,\n  });\n}\n\n/** `Retry-After` in seconds: a number of seconds or an HTTP date; undefined when absent or unreadable. */\nexport function retryAfterSeconds(\n  response: Response,\n  now: () => number = Date.now,\n): number | undefined {\n  const value = response.headers.get('retry-after');\n  if (value === null || value.trim() === '') return undefined;\n  if (/^\\d+$/.test(value.trim())) return Number(value.trim());\n  const at = Date.parse(value);\n  return Number.isNaN(at)\n    ? undefined\n    : Math.max(0, Math.ceil((at - now()) / 1000));\n}\n\nfunction isProblem(body: unknown): body is ApiProblem {\n  if (typeof body !== 'object' || body === null) return false;\n  const b = body as Record<string, unknown>;\n  return typeof b.code === 'string' && typeof b.status === 'number';\n}\n","// A random UUID for idempotency keys wherever the client runs. Node 20+, Deno, Bun and edge runtimes have\n// `crypto.randomUUID`; Node 18 has it only in its crypto module when loaded as an ES module, so it is loaded from\n// there, once.\nlet fromNode: Promise<() => string> | undefined;\n\nexport async function randomUUID(): Promise<string> {\n  const global = (globalThis as { crypto?: { randomUUID?: () => string } })\n    .crypto;\n  if (global?.randomUUID) return global.randomUUID();\n  // Built at run time on purpose: a bundler for an edge runtime, where this line never runs, must not resolve it.\n  const specifier = ['node', 'crypto'].join(':');\n  fromNode ??= import(\n    /* webpackIgnore: true */ /* @vite-ignore */ specifier\n  ).then((mod: { randomUUID: () => string }) => mod.randomUUID);\n  return (await fromNode)();\n}\n","// Safe retries for calls to the Vinaverse API. A call is sent again only when that cannot do it twice:\n// - `429`: the API refused it before doing anything, so any call is retried, after its `Retry-After`;\n// - a retryable failure (a `5xx`, a problem with `retryable: true`, a timeout or a network error): only a read\n//   (`GET`, `HEAD`, `OPTIONS`), an idempotent `PUT` or `DELETE`, or a call carrying an `Idempotency-Key`, which the\n//   API answers once whatever the number of tries.\n// Delays: `Retry-After` when the API sends one, else 0.5 s doubling, with jitter; a `Retry-After` longer than\n// `maxRetryDelay` is not waited for: the refusal is returned.\n// Each try reads the whole response within its timeout, so a stalled body cannot hang a call, and the caller's\n// signal stops everything at once: a try in flight, a body being read, a wait between tries. An aborted signal never\n// sends the call. Redirects are refused: a service key never follows one.\n\nimport { retryAfterSeconds } from './errors.js';\n\nexport type FetchFn = (input: Request) => Promise<Response>;\n\nexport interface RetryOptions {\n  /** Retries after the first try: a whole number, 0 or more; default 2. */\n  readonly maxRetries?: number;\n  /** The longest wait, in seconds, before a retry: 0 to 2 147 483 (a timer's limit); default 30. */\n  readonly maxRetryDelay?: number;\n  /** One try's timeout, reading the body included, in milliseconds: more than 0, at most 2 147 483 647; default 30 000. */\n  readonly timeout?: number;\n  /** Waits, in milliseconds; tests replace it. The wait ends early when the call is aborted. */\n  readonly sleep?: (ms: number) => Promise<void>;\n  readonly random?: () => number;\n}\n\nconst IDEMPOTENT = new Set(['GET', 'HEAD', 'PUT', 'DELETE', 'OPTIONS']);\n/** Statuses whose responses have no body. */\nconst NULL_BODY = new Set([101, 204, 205, 304]);\n/** A refusal's body is read up to this size: a problem is far smaller; more is an intermediary's page. */\nconst MAX_REFUSAL_BYTES = 64 * 1024;\n\n/**\n * The API did not answer within `timeout` on the last try. `idempotencyKey` is the key the call carried: pass it as\n * `{ idempotencyKey }` to try the same call again later without doing it twice.\n */\nexport class VinaverseTimeoutError extends Error {\n  override readonly name = 'VinaverseTimeoutError';\n  readonly idempotencyKey: string | undefined;\n  constructor(ms: number, idempotencyKey?: string) {\n    super(`The Vinaverse API did not answer within ${ms} ms.`);\n    this.idempotencyKey = idempotencyKey;\n  }\n}\n\n/** The call could not reach the API (`cause` holds why). `idempotencyKey` as for a timeout. */\nexport class VinaverseNetworkError extends Error {\n  override readonly name = 'VinaverseNetworkError';\n  readonly idempotencyKey: string | undefined;\n  constructor(cause: unknown, idempotencyKey?: string) {\n    super(\n      `The Vinaverse API could not be reached: ${cause instanceof Error ? cause.message : String(cause)}`,\n      { cause },\n    );\n    this.idempotencyKey = idempotencyKey;\n  }\n}\n\n/** The longest a timer can wait: beyond it, Node fires it after 1 ms. */\nconst MAX_TIMER_MS = 2_147_483_647;\n\n/**\n * `guard` checks each request's URL before anything is sent (the client allows its own origin only); what it throws\n * is thrown as is.\n */\nexport function retryingFetch(\n  fetchFn: FetchFn,\n  options: RetryOptions = {},\n  guard: (url: string) => void = () => {},\n): FetchFn {\n  const maxRetries = check(\n    'maxRetries',\n    options.maxRetries ?? 2,\n    (n) => Number.isSafeInteger(n) && n >= 0,\n  );\n  const maxDelay =\n    check(\n      'maxRetryDelay',\n      options.maxRetryDelay ?? 30,\n      (n) => Number.isFinite(n) && n >= 0 && n * 1000 <= MAX_TIMER_MS,\n    ) * 1000;\n  const timeout = check(\n    'timeout',\n    options.timeout ?? 30_000,\n    (n) => Number.isFinite(n) && n > 0 && n <= MAX_TIMER_MS,\n  );\n  const sleep = options.sleep;\n  const random = options.random ?? Math.random;\n\n  return async (request) => {\n    guard(request.url);\n    const signal = request.signal;\n    const key = request.headers.get('idempotency-key') ?? undefined;\n    const replayable =\n      IDEMPOTENT.has(request.method.toUpperCase()) || key !== undefined;\n    for (let attempt = 0; ; attempt++) {\n      if (signal.aborted) throw aborted(signal);\n      const last = attempt >= maxRetries;\n      let response: Response;\n      try {\n        response = await once(fetchFn, request.clone(), signal, timeout);\n      } catch (error) {\n        if (signal.aborted) throw aborted(signal);\n        // A network error or a timeout: the call may have been done; only a replayable one goes again.\n        if (last || !replayable) {\n          throw error instanceof VinaverseTimeoutError\n            ? new VinaverseTimeoutError(timeout, key)\n            : new VinaverseNetworkError(error, key);\n        }\n        await wait(sleep, Math.min(backoff(attempt, random), maxDelay), signal);\n        continue;\n      }\n      const retry =\n        response.status === 429 ||\n        (replayable && retryable(response, await problemOf(response)));\n      if (!retry || last) return response;\n      const delay = retryAfter(response) ?? backoff(attempt, random);\n      if (delay > maxDelay) return response;\n      await wait(sleep, delay, signal);\n    }\n  };\n}\n\n/** One try, its body read in full within the timeout; refused bodies up to `MAX_REFUSAL_BYTES`. */\nasync function once(\n  fetchFn: FetchFn,\n  request: Request,\n  signal: AbortSignal,\n  timeout: number,\n): Promise<Response> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeout);\n  const stop = () => controller.abort();\n  signal.addEventListener('abort', stop, { once: true });\n  if (signal.aborted) controller.abort();\n  try {\n    // Raced against the timeout and the caller's signal too, so a transport that ignores its signal is still bounded.\n    const pending = fetchFn(\n      new Request(request, { signal: controller.signal, redirect: 'error' }),\n    );\n    pending.catch(() => {}); // when the abort wins, the transport's own failure is not reported twice\n    const response = await until(pending, controller.signal);\n    const empty = NULL_BODY.has(response.status);\n    const body = empty\n      ? null\n      : await readBody(\n          response,\n          response.ok ? Number.POSITIVE_INFINITY : MAX_REFUSAL_BYTES,\n          controller.signal,\n        );\n    return new Response(body, {\n      status: response.status,\n      statusText: response.statusText,\n      headers: response.headers,\n    });\n  } catch (error) {\n    if (controller.signal.aborted && !signal.aborted)\n      throw new VinaverseTimeoutError(timeout);\n    throw error;\n  } finally {\n    clearTimeout(timer);\n    signal.removeEventListener('abort', stop);\n  }\n}\n\nasync function readBody(\n  response: Response,\n  limit: number,\n  signal: AbortSignal,\n): Promise<Uint8Array<ArrayBuffer> | null> {\n  if (!response.body) return null;\n  const reader = response.body.getReader();\n  const chunks: Uint8Array[] = [];\n  let size = 0;\n  for (;;) {\n    const read = reader.read();\n    read.catch(() => {}); // an abort below wins; the read's own failure is not reported twice\n    const { done, value } = await until(read, signal).catch(\n      async (error: unknown) => {\n        void reader.cancel().catch(() => {}); // not awaited: a teed body settles its cancel only with its twin\n        throw error;\n      },\n    );\n    if (done) break;\n    chunks.push(value);\n    size += value.length;\n    if (size >= limit) {\n      void reader.cancel().catch(() => {}); // not awaited: a teed body settles its cancel only with its twin\n      break;\n    }\n  }\n  const body = new Uint8Array(new ArrayBuffer(Math.min(size, limit)));\n  let at = 0;\n  for (const chunk of chunks) {\n    const part = chunk.subarray(0, body.length - at);\n    body.set(part, at);\n    at += part.length;\n    if (at >= body.length) break;\n  }\n  return body;\n}\n\nasync function problemOf(\n  response: Response,\n): Promise<{ retryable?: unknown } | undefined> {\n  if (response.ok) return undefined;\n  try {\n    return (await response.clone().json()) as { retryable?: unknown };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction retryable(\n  response: Response,\n  problem: { retryable?: unknown } | undefined,\n): boolean {\n  if (response.status >= 500) return true;\n  // Another refusal is retried only when the API says so.\n  return response.status >= 400 && problem?.retryable === true;\n}\n\n/** `promise`, or the signal's abort, whichever comes first. */\nasync function until<T>(promise: Promise<T>, signal: AbortSignal): Promise<T> {\n  if (signal.aborted) throw aborted(signal);\n  let stop: () => void = () => {};\n  const abort = new Promise<never>((_, reject) => {\n    stop = () => reject(aborted(signal));\n    signal.addEventListener('abort', stop, { once: true });\n  });\n  try {\n    return await Promise.race([promise, abort]);\n  } finally {\n    signal.removeEventListener('abort', stop);\n  }\n}\n\n/** Waits `ms`, or less: an abort ends the wait, clears its timer, and throws. */\nfunction wait(\n  sleep: ((ms: number) => Promise<void>) | undefined,\n  ms: number,\n  signal: AbortSignal,\n): Promise<void> {\n  if (sleep) return until(sleep(ms), signal);\n  if (signal.aborted) return Promise.reject(aborted(signal));\n  return new Promise<void>((resolve, reject) => {\n    const stop = () => {\n      clearTimeout(timer);\n      reject(aborted(signal));\n    };\n    const timer = setTimeout(() => {\n      signal.removeEventListener('abort', stop);\n      resolve();\n    }, ms);\n    signal.addEventListener('abort', stop, { once: true });\n  });\n}\n\nfunction aborted(signal: AbortSignal): unknown {\n  return (\n    signal.reason ?? new DOMException('The call was aborted.', 'AbortError')\n  );\n}\n\nfunction retryAfter(response: Response): number | undefined {\n  const seconds = retryAfterSeconds(response);\n  return seconds === undefined ? undefined : seconds * 1000;\n}\n\nfunction backoff(attempt: number, random: () => number): number {\n  const base = 500 * 2 ** attempt;\n  return Math.round(base / 2 + random() * (base / 2));\n}\n\nfunction check(\n  name: string,\n  value: number,\n  valid: (n: number) => boolean,\n): number {\n  if (typeof value !== 'number' || !valid(value)) {\n    throw new TypeError(`${name} is not valid: ${String(value)}`);\n  }\n  return value;\n}\n","// The Vinaverse API from a Node backend: typed calls generated from the pinned public contract (vinaverse-v1.yaml,\n// through openapi-fetch), authenticated with a service key, with idempotency keys added where the contract wants\n// one, safe retries honouring `Retry-After` (./retry.ts), and refusals thrown as typed errors (./errors.ts).\n// A service key never belongs in a browser or an app: the client refuses to start there.\nimport createClient, { type Client } from 'openapi-fetch';\nimport type { operations, paths } from '../generated/vinaverse-v1.js';\nimport { apiError } from './errors.js';\nimport { randomUUID } from './random.js';\nimport { type FetchFn, type RetryOptions, retryingFetch } from './retry.js';\n\ntype Op = operations;\n/** An operation's JSON request body. */\nexport type ApiBody<K extends keyof Op> = Op[K] extends {\n  requestBody?: { content: { 'application/json': infer B } };\n}\n  ? B\n  : never;\n/** An operation's success result. */\nexport type ApiResult<K extends keyof Op> = Success<Op[K]['responses']>;\ntype Success<R> = R extends {\n  200: { content: { 'application/json': infer B } };\n}\n  ? B\n  : R extends { 201: { content: { 'application/json': infer B } } }\n    ? B\n    : R extends { 202: { content: { 'application/json': infer B } } }\n      ? B\n      : undefined;\ntype QueryOf<K extends keyof Op> = Op[K]['parameters'] extends {\n  query?: infer Q;\n}\n  ? NonNullable<Q>\n  : never;\n\n/** Per call: a signal that stops it at once, waits between tries included. */\nexport interface CallOptions {\n  readonly signal?: AbortSignal;\n}\n\n/**\n * For the calls the contract makes idempotent: a key of your own, 1 to 255 characters (one is made otherwise).\n * After a `VinaverseTimeoutError` or a `VinaverseNetworkError`, try again later with the error's `idempotencyKey`,\n * so the call is done once however many times it is sent.\n */\nexport interface KeyedCallOptions extends CallOptions {\n  readonly idempotencyKey?: string;\n}\n\nexport interface ApiClientOptions extends RetryOptions {\n  /** A service key, `vv_sk_<mock|dev|live>_…`: from your secrets store, never from code. */\n  readonly apiKey: string;\n  /**\n   * Default: `https://api.vinaverse.com` for a live key, `https://api-dev.vinaverse.com` for mock and dev keys. Any\n   * other URL must be `https:` (a proxy you run, say), or `http:` on this machine only (`localhost`, `127.0.0.1`,\n   * `[::1]`): a service key never travels in clear.\n   */\n  readonly baseUrl?: string;\n  readonly fetch?: (request: Request) => Promise<Response>;\n  /** Extra headers on every call, for example `Vinaverse-Mock-Scenario` in tests against the mock environment. */\n  readonly headers?: Readonly<Record<string, string>>;\n}\n\nconst SERVICE_KEY = /^vv_sk_(mock|dev|live)_[A-Za-z0-9_-]{8,}$/;\n\n/** The client was made where a service key must never be: a browser or an app. */\nexport class ServiceKeyExposureError extends Error {\n  override readonly name = 'ServiceKeyExposureError';\n}\n\nexport function createApiClient(options: ApiClientOptions) {\n  refuseClientRuntime();\n  const key = options.apiKey;\n  if (typeof key !== 'string' || !SERVICE_KEY.test(key)) {\n    throw new TypeError(\n      key?.startsWith?.('vv_cs_')\n        ? 'createApiClient takes a service key (vv_sk_…); a client secret (vv_cs_…) is for the app'\n        : 'createApiClient needs a service key: vv_sk_<mock|dev|live>_…',\n    );\n  }\n  const live = key.startsWith('vv_sk_live_');\n  const baseUrl = safeBaseUrl(\n    options.baseUrl ??\n      (live ? 'https://api.vinaverse.com' : 'https://api-dev.vinaverse.com'),\n  );\n  const transport: FetchFn =\n    options.fetch ?? ((request) => globalThis.fetch(request));\n  const api: Client<paths> = createClient<paths>({\n    baseUrl,\n    redirect: 'error', // the API never redirects; a service key never follows one\n    // Every request, from a helper or from `api` with a per-call baseUrl, goes to this origin only.\n    fetch: retryingFetch(transport, options, sameOrigin(baseUrl)),\n    headers: {\n      ...options.headers,\n      authorization: `Bearer ${key}`,\n      accept: 'application/json',\n    },\n  });\n\n  type Answer = Promise<{\n    data?: unknown;\n    error?: unknown;\n    response: Response;\n  }>;\n  async function run<T>(call: Answer, idempotencyKey?: string): Promise<T> {\n    const { data, error, response } = await call;\n    if (!response.ok) throw apiError(response, error, idempotencyKey);\n    return data as T;\n  }\n  /** A call the contract makes idempotent: under the caller's key, or a new one, on every try. */\n  async function keyed<T>(\n    o: KeyedCallOptions | undefined,\n    call: (header: { 'Idempotency-Key': string }) => Answer,\n  ): Promise<T> {\n    const key = o?.idempotencyKey ?? (await newKey());\n    if (typeof key !== 'string' || key.length < 1 || key.length > 255) {\n      throw new TypeError('idempotencyKey must be 1 to 255 characters');\n    }\n    return run<T>(call({ 'Idempotency-Key': key }), key);\n  }\n  const init = (o?: CallOptions) => (o?.signal ? { signal: o.signal } : {});\n\n  return {\n    /** Every operation of the contract, typed, for what the helpers below do not cover (openapi-fetch). */\n    api,\n    sessions: {\n      /** Mint a session for the person in your app; give the app its `id`, URLs and `client_secret` only. */\n      create: (body: ApiBody<'createSession'>, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'createSession'>>(o, (header) =>\n          api.POST('/v1/sessions', {\n            body,\n            params: { header },\n            ...init(o),\n          }),\n        ),\n      get: (sessionId: string, o?: CallOptions) =>\n        run<ApiResult<'getSession'>>(\n          api.GET('/v1/sessions/{session_id}', {\n            params: { path: { session_id: sessionId } },\n            ...init(o),\n          }),\n        ),\n      revoke: (sessionId: string, o?: CallOptions) =>\n        run<ApiResult<'revokeSession'>>(\n          api.POST('/v1/sessions/{session_id}/revoke', {\n            params: { path: { session_id: sessionId } },\n            ...init(o),\n          }),\n        ),\n      /**\n       * Where the person is now, for an open session (no new session per screen): a screen context, or\n       * `{ clear: true, revision }`; `revision` greater than the session's, the same revision and body a retry.\n       */\n      updateContext: (\n        sessionId: string,\n        body: ApiBody<'updateSessionContext'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'updateSessionContext'>>(\n          api.PUT('/v1/sessions/{session_id}/context', {\n            params: { path: { session_id: sessionId } },\n            body,\n            ...init(o),\n          }),\n        ),\n      /** A fresh client secret for an open session: what an app's `refreshSecret(sessionId)` asks your backend for. */\n      refreshClientSecret: (sessionId: string, o?: CallOptions) =>\n        run<ApiResult<'refreshClientSecret'>>(\n          api.POST('/v1/sessions/{session_id}/client_secret', {\n            params: { path: { session_id: sessionId } },\n            ...init(o),\n          }),\n        ),\n    },\n    conversations: {\n      get: (conversationId: string, o?: CallOptions) =>\n        run<ApiResult<'getConversation'>>(\n          api.GET('/v1/conversations/{conversation_id}', {\n            params: { path: { conversation_id: conversationId } },\n            ...init(o),\n          }),\n        ),\n      /** A person's past conversations with an agent, newest activity first (history). */\n      list: (query: QueryOf<'listConversations'>, o?: CallOptions) =>\n        run<ApiResult<'listConversations'>>(\n          api.GET('/v1/conversations', { params: { query }, ...init(o) }),\n        ),\n      /** A past conversation's messages, the newest page first and oldest first within a page. */\n      listMessages: (\n        conversationId: string,\n        query: QueryOf<'listConversationMessages'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'listConversationMessages'>>(\n          api.GET('/v1/conversations/{conversation_id}/messages', {\n            params: { path: { conversation_id: conversationId }, query },\n            ...init(o),\n          }),\n        ),\n      /** Deletes a person's conversation (history's delete); another subject's or an unknown one is `not_found`. */\n      delete: (\n        conversationId: string,\n        query: QueryOf<'deleteConversation'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'deleteConversation'>>(\n          api.DELETE('/v1/conversations/{conversation_id}', {\n            params: { path: { conversation_id: conversationId }, query },\n            ...init(o),\n          }),\n        ),\n    },\n    suggestions: {\n      create: (body: ApiBody<'createSuggestions'>, o?: CallOptions) =>\n        run<ApiResult<'createSuggestions'>>(\n          api.POST('/v1/suggestions', { body, ...init(o) }),\n        ),\n    },\n    moderation: {\n      createJob: (body: ApiBody<'createModerationJob'>, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'createModerationJob'>>(o, (header) =>\n          api.POST('/v1/moderation/jobs', {\n            body,\n            params: { header },\n            ...init(o),\n          }),\n        ),\n      getJob: (jobId: string, o?: CallOptions) =>\n        run<ApiResult<'getModerationJob'>>(\n          api.GET('/v1/moderation/jobs/{job_id}', {\n            params: { path: { job_id: jobId } },\n            ...init(o),\n          }),\n        ),\n      getItem: (itemId: string, o?: CallOptions) =>\n        run<ApiResult<'getModerationItem'>>(\n          api.GET('/v1/moderation/items/{item_id}', {\n            params: { path: { item_id: itemId } },\n            ...init(o),\n          }),\n        ),\n    },\n    media: {\n      createJob: (body: ApiBody<'createMediaJob'>, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'createMediaJob'>>(o, (header) =>\n          api.POST('/v1/media/jobs', {\n            body,\n            params: { header },\n            ...init(o),\n          }),\n        ),\n      listJobs: (query: QueryOf<'listMediaJobs'> = {}, o?: CallOptions) =>\n        run<ApiResult<'listMediaJobs'>>(\n          api.GET('/v1/media/jobs', { params: { query }, ...init(o) }),\n        ),\n      getJob: (jobId: string, o?: CallOptions) =>\n        run<ApiResult<'getMediaJob'>>(\n          api.GET('/v1/media/jobs/{job_id}', {\n            params: { path: { job_id: jobId } },\n            ...init(o),\n          }),\n        ),\n      cancelJob: (jobId: string, o?: CallOptions) =>\n        run<ApiResult<'cancelMediaJob'>>(\n          api.POST('/v1/media/jobs/{job_id}/cancel', {\n            params: { path: { job_id: jobId } },\n            ...init(o),\n          }),\n        ),\n      listProfiles: (o?: CallOptions) =>\n        run<ApiResult<'listMediaProfiles'>>(\n          api.GET('/v1/media/profiles', { ...init(o) }),\n        ),\n    },\n    screening: {\n      text: (body: ApiBody<'screenText'>, o?: CallOptions) =>\n        run<ApiResult<'screenText'>>(\n          api.POST('/v1/screening/text', { body, ...init(o) }),\n        ),\n    },\n    documentChecks: {\n      create: (body: ApiBody<'createDocumentCheck'>, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'createDocumentCheck'>>(o, (header) =>\n          api.POST('/v1/document-checks', {\n            body,\n            params: { header },\n            ...init(o),\n          }),\n        ),\n      get: (checkId: string, o?: CallOptions) =>\n        run<ApiResult<'getDocumentCheck'>>(\n          api.GET('/v1/document-checks/{check_id}', {\n            params: { path: { check_id: checkId } },\n            ...init(o),\n          }),\n        ),\n    },\n    subjects: {\n      erase: (subjectId: string, o?: KeyedCallOptions) =>\n        keyed<ApiResult<'eraseSubject'>>(o, (header) =>\n          api.POST('/v1/subjects/{subject_id}/erase', {\n            params: { path: { subject_id: subjectId }, header },\n            ...init(o),\n          }),\n        ),\n      /** What the agent remembers of the person, and their choice, on one side of the app (memory settings). */\n      getMemory: (\n        subjectId: string,\n        query: QueryOf<'getSubjectMemory'> = {},\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'getSubjectMemory'>>(\n          api.GET('/v1/subjects/{subject_id}/memory', {\n            params: { path: { subject_id: subjectId }, query },\n            ...init(o),\n          }),\n        ),\n      /** The person's choice: whether the agent may remember them. */\n      putMemory: (\n        subjectId: string,\n        body: ApiBody<'putSubjectMemory'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'putSubjectMemory'>>(\n          api.PUT('/v1/subjects/{subject_id}/memory', {\n            params: { path: { subject_id: subjectId } },\n            body,\n            ...init(o),\n          }),\n        ),\n      /** The person saw the memory notice of this version. */\n      acknowledgeMemoryNotice: (\n        subjectId: string,\n        body: ApiBody<'acknowledgeMemoryNotice'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'acknowledgeMemoryNotice'>>(\n          api.POST('/v1/subjects/{subject_id}/memory/notice', {\n            params: { path: { subject_id: subjectId } },\n            body,\n            ...init(o),\n          }),\n        ),\n      /** Forgets one thing the agent learned about the person. */\n      deleteMemoryPreference: (\n        subjectId: string,\n        preferenceId: string,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'deleteMemoryPreference'>>(\n          api.DELETE(\n            '/v1/subjects/{subject_id}/memory/preferences/{preference_id}',\n            {\n              params: {\n                path: { subject_id: subjectId, preference_id: preferenceId },\n              },\n              ...init(o),\n            },\n          ),\n        ),\n    },\n    agents: {\n      /** The tenant's chat experience for an agent, resolved, before any session: copy it into the agent status. */\n      getExperience: (\n        agent: string,\n        query: QueryOf<'getAgentExperience'> = {},\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'getAgentExperience'>>(\n          api.GET('/v1/agents/{agent}/experience', {\n            params: { path: { agent }, query },\n            ...init(o),\n          }),\n        ),\n    },\n    feedback: {\n      send: (body: ApiBody<'sendFeedback'>, o?: CallOptions) =>\n        run<ApiResult<'sendFeedback'>>(\n          api.POST('/v1/feedback', { body, ...init(o) }),\n        ),\n    },\n    events: {\n      send: (body: ApiBody<'sendEvents'>, o?: CallOptions) =>\n        run<ApiResult<'sendEvents'>>(\n          api.POST('/v1/events', { body, ...init(o) }),\n        ),\n    },\n    knowledge: {\n      sendDocument: (body: ApiBody<'sendKnowledgeDocument'>, o?: CallOptions) =>\n        run<ApiResult<'sendKnowledgeDocument'>>(\n          api.POST('/v1/knowledge/documents', { body, ...init(o) }),\n        ),\n    },\n    catalog: {\n      put: (\n        type: Op['putCatalogEntity']['parameters']['path']['type'],\n        id: string,\n        body: ApiBody<'putCatalogEntity'>,\n        o?: CallOptions,\n      ) =>\n        run<ApiResult<'putCatalogEntity'>>(\n          api.PUT('/v1/catalog/{type}/{id}', {\n            params: { path: { type, id } },\n            body,\n            ...init(o),\n          }),\n        ),\n    },\n    usage: {\n      get: (query: QueryOf<'getUsage'> = {}, o?: CallOptions) =>\n        run<ApiResult<'getUsage'>>(\n          api.GET('/v1/usage', { params: { query }, ...init(o) }),\n        ),\n    },\n  };\n}\n\nexport type ApiClient = ReturnType<typeof createApiClient>;\n\n/**\n * Throws in a browser (a `window` with a `document`) and in React Native: a service key there ships to everyone who\n * loads the app. Node, AWS Lambda, Deno, Bun and edge runtimes have neither.\n */\nfunction refuseClientRuntime(): void {\n  const scope = globalThis as {\n    window?: unknown;\n    document?: unknown;\n    navigator?: { product?: unknown };\n  };\n  if (scope.window !== undefined && scope.document !== undefined) {\n    throw new ServiceKeyExposureError(\n      'The Vinaverse API client holds a service key and runs on your backend only, never in a browser. Give the app a session client secret (sessions.create).',\n    );\n  }\n  if (scope.navigator?.product === 'ReactNative') {\n    throw new ServiceKeyExposureError(\n      'The Vinaverse API client holds a service key and runs on your backend only, never in an app. Use @vinaverse/client with a session client secret.',\n    );\n  }\n}\n\nconst LOOPBACK = new Set(['localhost', '127.0.0.1', '[::1]']);\n\n/** The base URL, checked: `https:`, or `http:` on this machine only, so a service key never travels in clear. */\nfunction safeBaseUrl(value: string): string {\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    throw new TypeError(`baseUrl is not a URL: ${value}`);\n  }\n  if (\n    url.protocol !== 'https:' &&\n    !(url.protocol === 'http:' && LOOPBACK.has(url.hostname))\n  ) {\n    throw new TypeError(\n      `baseUrl must be https: (or http: on localhost); a service key never travels in clear: ${url.origin}`,\n    );\n  }\n  return value.replace(/\\/+$/, '');\n}\n\n/** A check for every request: the client's own origin, and so never in clear nor to another host. */\nfunction sameOrigin(baseUrl: string): (url: string) => void {\n  const origin = new URL(baseUrl).origin;\n  return (url) => {\n    const target = new URL(url);\n    if (target.origin !== origin) {\n      throw new TypeError(\n        `The Vinaverse API client sends its service key to ${origin} only, not to ${target.origin}`,\n      );\n    }\n  };\n}\n\nfunction newKey(): Promise<string> {\n  return randomUUID();\n}\n"]}

package/dist/api.d.cts

@@ -1,4 +1,4 @@
-import { o as operations, p as paths, c as components } from './vinaverse-v1.d-DiulmRgx.cjs';
+import { o as operations, p as paths, c as components } from './vinaverse-v1.d-D-NPpZqW.cjs';
 import { Client } from 'openapi-fetch';
 
 interface RetryOptions {
@@ -114,6 +114,9 @@ declare function createApiClient(options: ApiClientOptions): {
             business_scope_id?: components["schemas"]["BusinessScopeId"];
             screen_context?: components["schemas"]["ScreenContext"];
             welcome?: components["schemas"]["Welcome"];
+            memory?: components["schemas"]["SessionMemory"];
+            anchor?: components["schemas"]["SessionAnchorView"];
+            experience?: components["schemas"]["ChatExperience"];
         }>;
         get: (sessionId: string, o?: CallOptions) => Promise<{
             id: string;
@@ -182,6 +185,7 @@ declare function createApiClient(options: ApiClientOptions): {
         }>;
         /** A past conversation's messages, the newest page first and oldest first within a page. */
         listMessages: (conversationId: string, query: QueryOf<"listConversationMessages">, o?: CallOptions) => Promise<{
+            conversation: components["schemas"]["ConversationSummary"];
             data: components["schemas"]["TimelineItem"][];
             next_cursor: string | null;
         }>;
@@ -375,7 +379,8 @@ declare function createApiClient(options: ApiClientOptions): {
             flags?: components["schemas"]["DocumentFlag"][];
             decision?: components["schemas"]["Decision"];
             model?: {
-                id?: string;
+                id?: components["schemas"]["ModelName"];
+                label?: string;
                 provider?: string;
             };
             error?: components["schemas"]["Problem"];
@@ -391,6 +396,30 @@ declare function createApiClient(options: ApiClientOptions): {
             sessions_revoked: number;
             deadline: string;
         }>;
+        /** What the agent remembers of the person, and their choice, on one side of the app (memory settings). */
+        getMemory: (subjectId: string, query?: QueryOf<"getSubjectMemory">, o?: CallOptions) => Promise<{
+            remembered: boolean;
+            notice_acknowledged?: components["schemas"]["MemoryNoticeVersion"];
+            preferences: components["schemas"]["MemoryPreference"][];
+            last_search?: components["schemas"]["LastSearch"];
+        }>;
+        /** The person's choice: whether the agent may remember them. */
+        putMemory: (subjectId: string, body: ApiBody<"putSubjectMemory">, o?: CallOptions) => Promise<{
+            remembered: boolean;
+        }>;
+        /** The person saw the memory notice of this version. */
+        acknowledgeMemoryNotice: (subjectId: string, body: ApiBody<"acknowledgeMemoryNotice">, o?: CallOptions) => Promise<undefined>;
+        /** Forgets one thing the agent learned about the person. */
+        deleteMemoryPreference: (subjectId: string, preferenceId: string, o?: CallOptions) => Promise<undefined>;
+    };
+    agents: {
+        /** The tenant's chat experience for an agent, resolved, before any session: copy it into the agent status. */
+        getExperience: (agent: string, query?: QueryOf<"getAgentExperience">, o?: CallOptions) => Promise<{
+            agent: string;
+            experience_mode: components["schemas"]["ExperienceMode"];
+            experience: components["schemas"]["ChatExperience"];
+            updated_at?: string;
+        }>;
     };
     feedback: {
         send: (body: ApiBody<"sendFeedback">, o?: CallOptions) => Promise<{

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import { o as operations, p as paths, c as components } from './vinaverse-v1.d-DiulmRgx.js';
+import { o as operations, p as paths, c as components } from './vinaverse-v1.d-D-NPpZqW.js';
 import { Client } from 'openapi-fetch';
 
 interface RetryOptions {
@@ -114,6 +114,9 @@ declare function createApiClient(options: ApiClientOptions): {
             business_scope_id?: components["schemas"]["BusinessScopeId"];
             screen_context?: components["schemas"]["ScreenContext"];
             welcome?: components["schemas"]["Welcome"];
+            memory?: components["schemas"]["SessionMemory"];
+            anchor?: components["schemas"]["SessionAnchorView"];
+            experience?: components["schemas"]["ChatExperience"];
         }>;
         get: (sessionId: string, o?: CallOptions) => Promise<{
             id: string;
@@ -182,6 +185,7 @@ declare function createApiClient(options: ApiClientOptions): {
         }>;
         /** A past conversation's messages, the newest page first and oldest first within a page. */
         listMessages: (conversationId: string, query: QueryOf<"listConversationMessages">, o?: CallOptions) => Promise<{
+            conversation: components["schemas"]["ConversationSummary"];
             data: components["schemas"]["TimelineItem"][];
             next_cursor: string | null;
         }>;
@@ -375,7 +379,8 @@ declare function createApiClient(options: ApiClientOptions): {
             flags?: components["schemas"]["DocumentFlag"][];
             decision?: components["schemas"]["Decision"];
             model?: {
-                id?: string;
+                id?: components["schemas"]["ModelName"];
+                label?: string;
                 provider?: string;
             };
             error?: components["schemas"]["Problem"];
@@ -391,6 +396,30 @@ declare function createApiClient(options: ApiClientOptions): {
             sessions_revoked: number;
             deadline: string;
         }>;
+        /** What the agent remembers of the person, and their choice, on one side of the app (memory settings). */
+        getMemory: (subjectId: string, query?: QueryOf<"getSubjectMemory">, o?: CallOptions) => Promise<{
+            remembered: boolean;
+            notice_acknowledged?: components["schemas"]["MemoryNoticeVersion"];
+            preferences: components["schemas"]["MemoryPreference"][];
+            last_search?: components["schemas"]["LastSearch"];
+        }>;
+        /** The person's choice: whether the agent may remember them. */
+        putMemory: (subjectId: string, body: ApiBody<"putSubjectMemory">, o?: CallOptions) => Promise<{
+            remembered: boolean;
+        }>;
+        /** The person saw the memory notice of this version. */
+        acknowledgeMemoryNotice: (subjectId: string, body: ApiBody<"acknowledgeMemoryNotice">, o?: CallOptions) => Promise<undefined>;
+        /** Forgets one thing the agent learned about the person. */
+        deleteMemoryPreference: (subjectId: string, preferenceId: string, o?: CallOptions) => Promise<undefined>;
+    };
+    agents: {
+        /** The tenant's chat experience for an agent, resolved, before any session: copy it into the agent status. */
+        getExperience: (agent: string, query?: QueryOf<"getAgentExperience">, o?: CallOptions) => Promise<{
+            agent: string;
+            experience_mode: components["schemas"]["ExperienceMode"];
+            experience: components["schemas"]["ChatExperience"];
+            updated_at?: string;
+        }>;
     };
     feedback: {
         send: (body: ApiBody<"sendFeedback">, o?: CallOptions) => Promise<{

package/dist/api.js

@@ -464,6 +464,50 @@ function createApiClient(options) {
           params: { path: { subject_id: subjectId }, header },
           ...init(o)
         })
+      ),
+      /** What the agent remembers of the person, and their choice, on one side of the app (memory settings). */
+      getMemory: (subjectId, query = {}, o) => run(
+        api.GET("/v1/subjects/{subject_id}/memory", {
+          params: { path: { subject_id: subjectId }, query },
+          ...init(o)
+        })
+      ),
+      /** The person's choice: whether the agent may remember them. */
+      putMemory: (subjectId, body, o) => run(
+        api.PUT("/v1/subjects/{subject_id}/memory", {
+          params: { path: { subject_id: subjectId } },
+          body,
+          ...init(o)
+        })
+      ),
+      /** The person saw the memory notice of this version. */
+      acknowledgeMemoryNotice: (subjectId, body, o) => run(
+        api.POST("/v1/subjects/{subject_id}/memory/notice", {
+          params: { path: { subject_id: subjectId } },
+          body,
+          ...init(o)
+        })
+      ),
+      /** Forgets one thing the agent learned about the person. */
+      deleteMemoryPreference: (subjectId, preferenceId, o) => run(
+        api.DELETE(
+          "/v1/subjects/{subject_id}/memory/preferences/{preference_id}",
+          {
+            params: {
+              path: { subject_id: subjectId, preference_id: preferenceId }
+            },
+            ...init(o)
+          }
+        )
+      )
+    },
+    agents: {
+      /** The tenant's chat experience for an agent, resolved, before any session: copy it into the agent status. */
+      getExperience: (agent, query = {}, o) => run(
+        api.GET("/v1/agents/{agent}/experience", {
+          params: { path: { agent }, query },
+          ...init(o)
+        })
       )
     },
     feedback: {