@tanstack/ai-client 0.29.2 → 0.31.0

package/README.md

@@ -61,12 +61,8 @@ framework bindings as your app needs them.
 
 - [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
   what TanStack AI is and how the packages fit together.
-- [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
-  add streaming chat to a React app.
-- [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
-  build with Vue composables.
-- [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
-  build with Svelte 5 runes.
+- [Quick Start](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
+  add streaming chat. Pick your framework at the top of the page.
 - [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
   use TanStack AI from a server endpoint, script, or backend service.
 - [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
@@ -226,15 +222,15 @@ on.
 
 ## Framework Packages
 
-| Package                                                                    | What it provides                                                         |
-| -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
-| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients                          |
-| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)   | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
-| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)   | Solid hooks for chat and generations                                     |
-| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)       | Vue composables for chat and generations                                 |
-| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations                              |
-| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat                                                    |
-| `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui`    | Headless UI components for chat interfaces                               |
+| Package                                                                                           | What it provides                                                                                                                        |
+| ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client)                        | Headless chat, realtime, and generation clients                                                                                         |
+| [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react)                          | React hooks including `useChat`, `useRealtimeChat`, and generation hooks                                                                |
+| [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid)                          | Solid hooks for chat and generations                                                                                                    |
+| [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue)                              | Vue composables for chat and generations                                                                                                |
+| [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte)                        | Svelte 5 factories for chat and generations                                                                                             |
+| [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact)                        | Preact hooks for chat                                                                                                                   |
+| `@tanstack/ai-react/ui`, `@tanstack/ai-solid/ui`, `@tanstack/ai-vue/ui`, `@tanstack/ai-svelte/ui` | Headless UI components for chat interfaces. `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, and `@tanstack/ai-vue-ui` are deprecated. |
 
 ## Advanced Docs
 

package/dist/esm/byok/client.d.ts

@@ -1,4 +1,4 @@
-import { ProviderId } from '@tanstack/ai/byok';
+import { ByokProvider, ProviderId } from '@tanstack/ai/byok';
 import { Keyring, KeyringStorage } from './storage.js';
 export type KeyStatus = {
     state: 'empty';
@@ -25,6 +25,11 @@ export type ByokSnapshot = {
 };
 export interface DefineByokOptions {
     storage?: KeyringStorage;
+    /**
+     * Descriptors whose `with` companions the store expands: `headers()` and
+     * `prepare()` for such a provider cover its companions too.
+     */
+    providers?: ReadonlyArray<ByokProvider>;
 }
 export declare const EMPTY_BYOK_SNAPSHOT: ByokSnapshot;
 export declare class ByokClient {

package/dist/esm/byok/client.js

@@ -37,12 +37,14 @@ var ByokClient = class {
 	#prompt = null;
 	#coverageAll = false;
 	#coverage = {};
+	#companions = {};
 	#listeners = /* @__PURE__ */ new Set();
 	#snapshot;
 	#storageError = null;
 	#ready;
 	constructor(options = {}) {
 		this.storage = options.storage ?? memoryStorage();
+		for (const provider of options.providers ?? []) if (provider.with?.length) this.#companions[requireProviderId(provider.id)] = provider.with.map((companion) => requireProviderId(companion.id));
 		this.#locked = Boolean(this.storage.unlockable);
 		this.#snapshot = this.#buildSnapshot();
 		this.#ready = this.#hydrate();
@@ -94,12 +96,18 @@ var ByokClient = class {
 	#hasCoverage(provider) {
 		return this.#coverageAll || this.#coverage[provider] === true;
 	}
+	/** The slug plus every companion declared on its descriptor. */
+	#expand(provider) {
+		return [provider, ...this.#companions[provider] ?? []];
+	}
 	headers(provider) {
 		const headers = {};
 		if (provider) {
 			requireProviderId(provider);
-			const key = this.#keys[provider];
-			if (key) headers[byokHeaderName(provider)] = key;
+			for (const id of this.#expand(provider)) {
+				const key = this.#keys[id];
+				if (key) headers[byokHeaderName(id)] = key;
+			}
 			return headers;
 		}
 		for (const [id, key] of Object.entries(this.#keys)) if (key) headers[byokHeaderName(id)] = key;
@@ -110,10 +118,11 @@ var ByokClient = class {
 		if (this.storage.unlockable && this.#locked) await this.unlock();
 		if (!provider) return;
 		requireProviderId(provider);
-		if (this.#keys[provider]) return;
-		if (this.#hasCoverage(provider)) return;
-		this.request(provider, "missing");
-		throw new ByokBlockedError(provider, "missing");
+		for (const id of this.#expand(provider)) {
+			if (this.#keys[id] || this.#hasCoverage(id)) continue;
+			this.request(id, "missing");
+			throw new ByokBlockedError(id, "missing");
+		}
 	}
 	async update(providerOrKey, key) {
 		await this.#ready;

package/dist/esm/byok/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":["#listeners","#ready","#locked","#snapshot","#buildSnapshot","#hydrate","#statuses","#prompt","#storageError","#keys","#emit","#coverageAll","#coverage","#hasCoverage","#lockedProvider"],"sources":["../../../src/byok/client.ts"],"sourcesContent":["import {\n  ByokBlockedError,\n  byokHeaderName,\n  isProviderId,\n  maskKey,\n} from '@tanstack/ai/byok'\nimport { memoryStorage } from './storage'\nimport type { ProviderId } from '@tanstack/ai/byok'\nimport type { Keyring, KeyringStorage } from './storage'\n\nexport type KeyStatus =\n  | { state: 'empty' }\n  | { state: 'set'; masked: string }\n  | { state: 'locked'; masked: string }\n  | { state: 'error'; masked: string; message: string }\n\nexport type ByokPrompt = {\n  provider: ProviderId\n  reason: 'missing' | 'locked'\n}\n\nexport type ByokSnapshot = {\n  status: Partial<Record<string, KeyStatus>>\n  locked: boolean\n  prompt: ByokPrompt | null\n  storageError: string | null\n}\n\nexport interface DefineByokOptions {\n  storage?: KeyringStorage\n}\n\nexport const EMPTY_BYOK_SNAPSHOT: ByokSnapshot = {\n  status: {},\n  locked: false,\n  prompt: null,\n  storageError: null,\n}\n\nfunction requireProviderId(value: string): ProviderId {\n  if (!isProviderId(value)) {\n    throw new Error(`Invalid BYOK provider id: ${value}`)\n  }\n  return value\n}\n\nfunction errorMessage(error: unknown, fallback: string): string {\n  return error instanceof Error && error.message.length > 0\n    ? error.message\n    : fallback\n}\n\nfunction isByokCeremonyCancel(error: unknown): boolean {\n  if (\n    typeof DOMException !== 'undefined' &&\n    error instanceof DOMException &&\n    error.name === 'NotAllowedError'\n  ) {\n    return true\n  }\n  if (error instanceof Error) {\n    if (error.name === 'NotAllowedError') return true\n    const message = error.message.toLowerCase()\n    return message.includes('cancelled') || message.includes('not allowed')\n  }\n  return false\n}\n\nfunction sanitizeKeyring(value: unknown): Keyring {\n  if (typeof value !== 'object' || value === null) return {}\n  const keys: Keyring = {}\n  for (const [provider, key] of Object.entries(value)) {\n    if (isProviderId(provider) && typeof key === 'string' && key.length > 0) {\n      keys[provider] = key\n    }\n  }\n  return keys\n}\n\nexport class ByokClient {\n  readonly storage: KeyringStorage\n  #keys: Keyring = {}\n  #statuses: Partial<Record<string, KeyStatus>> = {}\n  #locked: boolean\n  #prompt: ByokPrompt | null = null\n  #coverageAll = false\n  #coverage: Record<string, boolean> = {}\n  readonly #listeners = new Set<() => void>()\n  #snapshot: ByokSnapshot\n  #storageError: string | null = null\n  readonly #ready: Promise<void>\n\n  constructor(options: DefineByokOptions = {}) {\n    this.storage = options.storage ?? memoryStorage()\n    this.#locked = Boolean(this.storage.unlockable)\n    this.#snapshot = this.#buildSnapshot()\n    this.#ready = this.#hydrate()\n  }\n\n  /** Resolves when constructor hydration (peek/load) finishes. */\n  ready = (): Promise<void> => this.#ready\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.#listeners.add(listener)\n    return () => {\n      this.#listeners.delete(listener)\n    }\n  }\n\n  getSnapshot = (): ByokSnapshot => this.#snapshot\n\n  #buildSnapshot(): ByokSnapshot {\n    return {\n      status: { ...this.#statuses },\n      locked: this.#locked,\n      prompt: this.#prompt,\n      storageError: this.#storageError,\n    }\n  }\n\n  keys(): Keyring {\n    return { ...this.#keys }\n  }\n\n  request(provider: ProviderId, reason: ByokPrompt['reason']): void {\n    this.#prompt = { provider: requireProviderId(provider), reason }\n    this.#emit()\n  }\n\n  /**\n   * `true` — the server can fill any slug from env.\n   * `false` — no env coverage.\n   * A record merges per-id flags and clears the all/none boolean.\n   */\n  setServerCoverage(flags: boolean | Readonly<Record<string, boolean>>): void {\n    if (typeof flags === 'boolean') {\n      this.#coverageAll = flags\n      this.#coverage = {}\n      return\n    }\n    this.#coverageAll = false\n    this.#coverage = { ...this.#coverage, ...flags }\n  }\n\n  #hasCoverage(provider: string): boolean {\n    return this.#coverageAll || this.#coverage[provider] === true\n  }\n\n  headers(provider?: ProviderId): Record<string, string> {\n    const headers: Record<string, string> = {}\n    if (provider) {\n      requireProviderId(provider)\n      const key = this.#keys[provider]\n      if (key) headers[byokHeaderName(provider)] = key\n      return headers\n    }\n    for (const [id, key] of Object.entries(this.#keys)) {\n      if (key) headers[byokHeaderName(id)] = key\n    }\n    return headers\n  }\n\n  async prepare(provider?: ProviderId): Promise<void> {\n    await this.#ready\n    if (this.storage.unlockable && this.#locked) {\n      await this.unlock()\n    }\n    if (!provider) return\n    requireProviderId(provider)\n    if (this.#keys[provider]) return\n    if (this.#hasCoverage(provider)) return\n    this.request(provider, 'missing')\n    throw new ByokBlockedError(provider, 'missing')\n  }\n\n  async update(\n    providerOrKey: ProviderId | string,\n    key?: string,\n  ): Promise<void> {\n    await this.#ready\n    let provider: ProviderId\n    let nextKey: string\n    if (key === undefined) {\n      if (!this.#prompt) {\n        throw new Error('byok.update(key) cannot run when prompt is null')\n      }\n      provider = this.#prompt.provider\n      nextKey = providerOrKey\n    } else {\n      provider = requireProviderId(providerOrKey)\n      nextKey = key\n    }\n    nextKey = nextKey.trim()\n    if (nextKey.length === 0) {\n      throw new Error('BYOK key must be non-empty')\n    }\n    if (this.storage.unlockable && this.#locked) {\n      await this.unlock()\n    }\n    const previousKeys = this.#keys\n    const previousStatuses = { ...this.#statuses }\n    const previousLocked = this.#locked\n    const previousPrompt = this.#prompt\n    const previousStorageError = this.#storageError\n    const next = { ...this.#keys, [provider]: nextKey }\n    try {\n      await this.storage.save(next)\n    } catch (error) {\n      this.#keys = previousKeys\n      this.#statuses = previousStatuses\n      this.#locked = previousLocked\n      this.#prompt = previousPrompt\n      this.#storageError = previousStorageError\n      this.#statuses[provider] = {\n        state: 'error',\n        masked: maskKey(nextKey),\n        message: errorMessage(error, `Failed to persist ${provider} key`),\n      }\n      this.#emit()\n      throw error\n    }\n    this.#keys = next\n    this.#statuses[provider] = { state: 'set', masked: maskKey(nextKey) }\n    this.#locked = false\n    this.#prompt = null\n    this.#storageError = null\n    this.#emit()\n  }\n\n  async clear(provider?: ProviderId): Promise<void> {\n    await this.#ready\n    if (provider) {\n      requireProviderId(provider)\n      if (this.storage.unlockable && this.#locked) {\n        await this.unlock()\n      }\n      const previousKeys = this.#keys\n      const previousStatuses = { ...this.#statuses }\n      const next = { ...this.#keys }\n      delete next[provider]\n      try {\n        await this.storage.save(next)\n      } catch (error) {\n        this.#keys = previousKeys\n        this.#statuses = previousStatuses\n        this.#emit()\n        throw error\n      }\n      this.#keys = next\n      delete this.#statuses[provider]\n      this.#emit()\n      return\n    }\n    const previousKeys = this.#keys\n    const previousStatuses = this.#statuses\n    const previousLocked = this.#locked\n    const previousPrompt = this.#prompt\n    try {\n      await this.storage.clear()\n    } catch (error) {\n      this.#keys = previousKeys\n      this.#statuses = previousStatuses\n      this.#locked = previousLocked\n      this.#prompt = previousPrompt\n      this.#emit()\n      throw error\n    }\n    this.#keys = {}\n    this.#statuses = {}\n    this.#locked = false\n    this.#prompt = null\n    this.#storageError = null\n    this.#emit()\n  }\n\n  async unlock(): Promise<void> {\n    await this.#ready\n    if (!this.storage.unlockable) return\n    try {\n      const loaded = sanitizeKeyring(await this.storage.load())\n      this.#keys = { ...loaded, ...this.#keys }\n      for (const [id, value] of Object.entries(loaded)) {\n        if (!isProviderId(id) || !value) continue\n        const existing = this.#statuses[id]\n        if (!existing || existing.state === 'locked') {\n          this.#statuses[id] = { state: 'set', masked: maskKey(value) }\n        }\n      }\n      this.#locked = false\n      this.#storageError = null\n      this.#emit()\n    } catch (error) {\n      if (isByokCeremonyCancel(error)) {\n        const provider = this.#lockedProvider()\n        if (provider) {\n          this.request(provider, 'locked')\n          throw new ByokBlockedError(provider, 'locked')\n        }\n      }\n      this.#storageError = errorMessage(error, 'Failed to unlock keyring')\n      this.#emit()\n      throw error instanceof Error ? error : new Error(String(error))\n    }\n  }\n\n  #lockedProvider(): ProviderId | undefined {\n    if (this.#prompt && isProviderId(this.#prompt.provider)) {\n      return this.#prompt.provider\n    }\n    for (const [id, status] of Object.entries(this.#statuses)) {\n      if (status?.state === 'locked' && isProviderId(id)) return id\n    }\n    return undefined\n  }\n\n  async #hydrate(): Promise<void> {\n    if (this.storage.unlockable) {\n      if (!this.storage.peek) return\n      try {\n        const preview = await this.storage.peek()\n        for (const [id, last4] of Object.entries(preview)) {\n          if (!isProviderId(id) || this.#statuses[id]) continue\n          this.#statuses[id] = {\n            state: 'locked',\n            masked: last4 ? last4 : '••',\n          }\n        }\n        this.#locked = Object.keys(preview).length > 0\n        this.#storageError = null\n        this.#emit()\n      } catch (error) {\n        this.#storageError = errorMessage(error, 'Failed to read keyring')\n        this.#emit()\n      }\n      return\n    }\n    try {\n      const loaded = sanitizeKeyring(await this.storage.load())\n      this.#keys = { ...loaded, ...this.#keys }\n      for (const [id, value] of Object.entries(loaded)) {\n        if (!isProviderId(id) || !value) continue\n        this.#statuses[id] = { state: 'set', masked: maskKey(value) }\n      }\n      this.#storageError = null\n      this.#emit()\n    } catch (error) {\n      this.#storageError = errorMessage(error, 'Failed to read keyring')\n      this.#emit()\n    }\n  }\n\n  #emit(): void {\n    this.#snapshot = this.#buildSnapshot()\n    for (const listener of this.#listeners) listener()\n  }\n}\n\nexport function defineByok(options: DefineByokOptions = {}): ByokClient {\n  return new ByokClient(options)\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.js","names":["#companions","#listeners","#ready","#locked","#snapshot","#buildSnapshot","#hydrate","#statuses","#prompt","#storageError","#keys","#emit","#coverageAll","#coverage","#expand","#hasCoverage","#lockedProvider"],"sources":["../../../src/byok/client.ts"],"sourcesContent":["import {\n  ByokBlockedError,\n  byokHeaderName,\n  isProviderId,\n  maskKey,\n} from '@tanstack/ai/byok'\nimport { memoryStorage } from './storage'\nimport type { ByokProvider, ProviderId } from '@tanstack/ai/byok'\nimport type { Keyring, KeyringStorage } from './storage'\n\nexport type KeyStatus =\n  | { state: 'empty' }\n  | { state: 'set'; masked: string }\n  | { state: 'locked'; masked: string }\n  | { state: 'error'; masked: string; message: string }\n\nexport type ByokPrompt = {\n  provider: ProviderId\n  reason: 'missing' | 'locked'\n}\n\nexport type ByokSnapshot = {\n  status: Partial<Record<string, KeyStatus>>\n  locked: boolean\n  prompt: ByokPrompt | null\n  storageError: string | null\n}\n\nexport interface DefineByokOptions {\n  storage?: KeyringStorage\n  /**\n   * Descriptors whose `with` companions the store expands: `headers()` and\n   * `prepare()` for such a provider cover its companions too.\n   */\n  providers?: ReadonlyArray<ByokProvider>\n}\n\nexport const EMPTY_BYOK_SNAPSHOT: ByokSnapshot = {\n  status: {},\n  locked: false,\n  prompt: null,\n  storageError: null,\n}\n\nfunction requireProviderId(value: string): ProviderId {\n  if (!isProviderId(value)) {\n    throw new Error(`Invalid BYOK provider id: ${value}`)\n  }\n  return value\n}\n\nfunction errorMessage(error: unknown, fallback: string): string {\n  return error instanceof Error && error.message.length > 0\n    ? error.message\n    : fallback\n}\n\nfunction isByokCeremonyCancel(error: unknown): boolean {\n  if (\n    typeof DOMException !== 'undefined' &&\n    error instanceof DOMException &&\n    error.name === 'NotAllowedError'\n  ) {\n    return true\n  }\n  if (error instanceof Error) {\n    if (error.name === 'NotAllowedError') return true\n    const message = error.message.toLowerCase()\n    return message.includes('cancelled') || message.includes('not allowed')\n  }\n  return false\n}\n\nfunction sanitizeKeyring(value: unknown): Keyring {\n  if (typeof value !== 'object' || value === null) return {}\n  const keys: Keyring = {}\n  for (const [provider, key] of Object.entries(value)) {\n    if (isProviderId(provider) && typeof key === 'string' && key.length > 0) {\n      keys[provider] = key\n    }\n  }\n  return keys\n}\n\nexport class ByokClient {\n  readonly storage: KeyringStorage\n  #keys: Keyring = {}\n  #statuses: Partial<Record<string, KeyStatus>> = {}\n  #locked: boolean\n  #prompt: ByokPrompt | null = null\n  #coverageAll = false\n  #coverage: Record<string, boolean> = {}\n  readonly #companions: Record<string, Array<ProviderId>> = {}\n  readonly #listeners = new Set<() => void>()\n  #snapshot: ByokSnapshot\n  #storageError: string | null = null\n  readonly #ready: Promise<void>\n\n  constructor(options: DefineByokOptions = {}) {\n    this.storage = options.storage ?? memoryStorage()\n    for (const provider of options.providers ?? []) {\n      if (provider.with?.length) {\n        this.#companions[requireProviderId(provider.id)] = provider.with.map(\n          (companion) => requireProviderId(companion.id),\n        )\n      }\n    }\n    this.#locked = Boolean(this.storage.unlockable)\n    this.#snapshot = this.#buildSnapshot()\n    this.#ready = this.#hydrate()\n  }\n\n  /** Resolves when constructor hydration (peek/load) finishes. */\n  ready = (): Promise<void> => this.#ready\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.#listeners.add(listener)\n    return () => {\n      this.#listeners.delete(listener)\n    }\n  }\n\n  getSnapshot = (): ByokSnapshot => this.#snapshot\n\n  #buildSnapshot(): ByokSnapshot {\n    return {\n      status: { ...this.#statuses },\n      locked: this.#locked,\n      prompt: this.#prompt,\n      storageError: this.#storageError,\n    }\n  }\n\n  keys(): Keyring {\n    return { ...this.#keys }\n  }\n\n  request(provider: ProviderId, reason: ByokPrompt['reason']): void {\n    this.#prompt = { provider: requireProviderId(provider), reason }\n    this.#emit()\n  }\n\n  /**\n   * `true` — the server can fill any slug from env.\n   * `false` — no env coverage.\n   * A record merges per-id flags and clears the all/none boolean.\n   */\n  setServerCoverage(flags: boolean | Readonly<Record<string, boolean>>): void {\n    if (typeof flags === 'boolean') {\n      this.#coverageAll = flags\n      this.#coverage = {}\n      return\n    }\n    this.#coverageAll = false\n    this.#coverage = { ...this.#coverage, ...flags }\n  }\n\n  #hasCoverage(provider: string): boolean {\n    return this.#coverageAll || this.#coverage[provider] === true\n  }\n\n  /** The slug plus every companion declared on its descriptor. */\n  #expand(provider: ProviderId): Array<ProviderId> {\n    return [provider, ...(this.#companions[provider] ?? [])]\n  }\n\n  headers(provider?: ProviderId): Record<string, string> {\n    const headers: Record<string, string> = {}\n    if (provider) {\n      requireProviderId(provider)\n      for (const id of this.#expand(provider)) {\n        const key = this.#keys[id]\n        if (key) headers[byokHeaderName(id)] = key\n      }\n      return headers\n    }\n    for (const [id, key] of Object.entries(this.#keys)) {\n      if (key) headers[byokHeaderName(id)] = key\n    }\n    return headers\n  }\n\n  async prepare(provider?: ProviderId): Promise<void> {\n    await this.#ready\n    if (this.storage.unlockable && this.#locked) {\n      await this.unlock()\n    }\n    if (!provider) return\n    requireProviderId(provider)\n    for (const id of this.#expand(provider)) {\n      if (this.#keys[id] || this.#hasCoverage(id)) continue\n      this.request(id, 'missing')\n      throw new ByokBlockedError(id, 'missing')\n    }\n  }\n\n  async update(\n    providerOrKey: ProviderId | string,\n    key?: string,\n  ): Promise<void> {\n    await this.#ready\n    let provider: ProviderId\n    let nextKey: string\n    if (key === undefined) {\n      if (!this.#prompt) {\n        throw new Error('byok.update(key) cannot run when prompt is null')\n      }\n      provider = this.#prompt.provider\n      nextKey = providerOrKey\n    } else {\n      provider = requireProviderId(providerOrKey)\n      nextKey = key\n    }\n    nextKey = nextKey.trim()\n    if (nextKey.length === 0) {\n      throw new Error('BYOK key must be non-empty')\n    }\n    if (this.storage.unlockable && this.#locked) {\n      await this.unlock()\n    }\n    const previousKeys = this.#keys\n    const previousStatuses = { ...this.#statuses }\n    const previousLocked = this.#locked\n    const previousPrompt = this.#prompt\n    const previousStorageError = this.#storageError\n    const next = { ...this.#keys, [provider]: nextKey }\n    try {\n      await this.storage.save(next)\n    } catch (error) {\n      this.#keys = previousKeys\n      this.#statuses = previousStatuses\n      this.#locked = previousLocked\n      this.#prompt = previousPrompt\n      this.#storageError = previousStorageError\n      this.#statuses[provider] = {\n        state: 'error',\n        masked: maskKey(nextKey),\n        message: errorMessage(error, `Failed to persist ${provider} key`),\n      }\n      this.#emit()\n      throw error\n    }\n    this.#keys = next\n    this.#statuses[provider] = { state: 'set', masked: maskKey(nextKey) }\n    this.#locked = false\n    this.#prompt = null\n    this.#storageError = null\n    this.#emit()\n  }\n\n  async clear(provider?: ProviderId): Promise<void> {\n    await this.#ready\n    if (provider) {\n      requireProviderId(provider)\n      if (this.storage.unlockable && this.#locked) {\n        await this.unlock()\n      }\n      const previousKeys = this.#keys\n      const previousStatuses = { ...this.#statuses }\n      const next = { ...this.#keys }\n      delete next[provider]\n      try {\n        await this.storage.save(next)\n      } catch (error) {\n        this.#keys = previousKeys\n        this.#statuses = previousStatuses\n        this.#emit()\n        throw error\n      }\n      this.#keys = next\n      delete this.#statuses[provider]\n      this.#emit()\n      return\n    }\n    const previousKeys = this.#keys\n    const previousStatuses = this.#statuses\n    const previousLocked = this.#locked\n    const previousPrompt = this.#prompt\n    try {\n      await this.storage.clear()\n    } catch (error) {\n      this.#keys = previousKeys\n      this.#statuses = previousStatuses\n      this.#locked = previousLocked\n      this.#prompt = previousPrompt\n      this.#emit()\n      throw error\n    }\n    this.#keys = {}\n    this.#statuses = {}\n    this.#locked = false\n    this.#prompt = null\n    this.#storageError = null\n    this.#emit()\n  }\n\n  async unlock(): Promise<void> {\n    await this.#ready\n    if (!this.storage.unlockable) return\n    try {\n      const loaded = sanitizeKeyring(await this.storage.load())\n      this.#keys = { ...loaded, ...this.#keys }\n      for (const [id, value] of Object.entries(loaded)) {\n        if (!isProviderId(id) || !value) continue\n        const existing = this.#statuses[id]\n        if (!existing || existing.state === 'locked') {\n          this.#statuses[id] = { state: 'set', masked: maskKey(value) }\n        }\n      }\n      this.#locked = false\n      this.#storageError = null\n      this.#emit()\n    } catch (error) {\n      if (isByokCeremonyCancel(error)) {\n        const provider = this.#lockedProvider()\n        if (provider) {\n          this.request(provider, 'locked')\n          throw new ByokBlockedError(provider, 'locked')\n        }\n      }\n      this.#storageError = errorMessage(error, 'Failed to unlock keyring')\n      this.#emit()\n      throw error instanceof Error ? error : new Error(String(error))\n    }\n  }\n\n  #lockedProvider(): ProviderId | undefined {\n    if (this.#prompt && isProviderId(this.#prompt.provider)) {\n      return this.#prompt.provider\n    }\n    for (const [id, status] of Object.entries(this.#statuses)) {\n      if (status?.state === 'locked' && isProviderId(id)) return id\n    }\n    return undefined\n  }\n\n  async #hydrate(): Promise<void> {\n    if (this.storage.unlockable) {\n      if (!this.storage.peek) return\n      try {\n        const preview = await this.storage.peek()\n        for (const [id, last4] of Object.entries(preview)) {\n          if (!isProviderId(id) || this.#statuses[id]) continue\n          this.#statuses[id] = {\n            state: 'locked',\n            masked: last4 ? last4 : '••',\n          }\n        }\n        this.#locked = Object.keys(preview).length > 0\n        this.#storageError = null\n        this.#emit()\n      } catch (error) {\n        this.#storageError = errorMessage(error, 'Failed to read keyring')\n        this.#emit()\n      }\n      return\n    }\n    try {\n      const loaded = sanitizeKeyring(await this.storage.load())\n      this.#keys = { ...loaded, ...this.#keys }\n      for (const [id, value] of Object.entries(loaded)) {\n        if (!isProviderId(id) || !value) continue\n        this.#statuses[id] = { state: 'set', masked: maskKey(value) }\n      }\n      this.#storageError = null\n      this.#emit()\n    } catch (error) {\n      this.#storageError = errorMessage(error, 'Failed to read keyring')\n      this.#emit()\n    }\n  }\n\n  #emit(): void {\n    this.#snapshot = this.#buildSnapshot()\n    for (const listener of this.#listeners) listener()\n  }\n}\n\nexport function defineByok(options: DefineByokOptions = {}): ByokClient {\n  return new ByokClient(options)\n}\n"],"mappings":"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"}

package/dist/esm/chat-client.d.ts

@@ -380,8 +380,6 @@ export declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = an
     sendMessage(content: string | MultimodalContent, body?: Record<string, any>, sendOptions?: SendMessageOptions): Promise<void>;
     /** True while interrupt descriptors still own continuation. */
     private hasPendingInterrupts;
-    /** True while an interrupt batch owns the next user turn. */
-    private hasBlockingInterrupts;
     /** True while a stream is active, a send is claiming the client, or the queue is draining. */
     private isSendBusy;
     private resolveBusyReason;

package/dist/esm/chat-client.js

@@ -1111,7 +1111,7 @@ var ChatClient = class {
 	async sendMessage(content, body, sendOptions) {
 		this.mountDevtools();
 		if (typeof content === "string" && !content.trim()) return;
-		if (this.hasBlockingInterrupts()) throw new Error("ChatClient: cannot send normal input while pending interrupts exist. Use resumeInterrupts() instead.");
+		if (this.hasPendingInterrupts()) throw new Error("ChatClient: cannot send normal input while pending interrupts exist. Use resumeInterrupts() instead.");
 		const resolvedBody = {
 			...body,
 			...sendOptions?.body
@@ -1138,10 +1138,6 @@ var ChatClient = class {
 	hasPendingInterrupts() {
 		return this.interruptManager.getDescriptors().length > 0;
 	}
-	/** True while an interrupt batch owns the next user turn. */
-	hasBlockingInterrupts() {
-		return this.activeInterruptSubmission !== void 0 || this.hasPendingInterrupts();
-	}
 	/** True while a stream is active, a send is claiming the client, or the queue is draining. */
 	isSendBusy() {
 		return this.isLoading || this.sendInFlight || this.messageQueueDraining;
@@ -1233,7 +1229,7 @@ var ChatClient = class {
 	*/
 	async append(message) {
 		this.mountDevtools();
-		if (this.hasBlockingInterrupts()) throw new Error("ChatClient: cannot append normal input while pending interrupts exist. Use resumeInterrupts() instead.");
+		if (this.hasPendingInterrupts()) throw new Error("ChatClient: cannot append normal input while pending interrupts exist. Use resumeInterrupts() instead.");
 		const normalizedMessage = normalizeToUIMessage(message, generateMessageId);
 		if (normalizedMessage.role === "system") return;
 		const uiMessage = normalizedMessage;