@chipmobilesdk/rn-ai 0.4.0 → 0.5.0

package/lib/module/core/aiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createDiagnosticChannel","createListenerSet","realScheduler","BehaviorConfigManager","SSE_DONE_SENTINEL","AiError","errorFromHttp","requestSse","createQuotaRequest","DEFAULT_AI_TIMEOUTS","channel","report","operation","error","emit","code","retryable","MAX_RETRY_BACKOFF_MS","backoffBefore","steps","index","step","Math","min","length","max","asQuota","value","undefined","candidate","fields","minuteRemaining","dayRemaining","dayTokensRemaining","every","field","Number","isFinite","createAiClient","clientConfig","resourceKey","transport","fetchFn","fetch","timeouts","scheduler","configManager","configUrl","appId","cache","storage","timeoutMs","configMs","allowedHosts","lastConfig","behaviorListeners","snapshot","quota","behaviorState","config","state","aiEnabled","features","setLastConfig","next","wasEnabled","notify","setQuota","shallowSameQuota","acquire","options","getConfig","recoverable","tokenResult","auth","requestAccessToken","forceRefresh","status","token","tokenError","errorCode","endpoint","path","api","baseUrl","chat","request","handlers","cancelled","settled","inner","delta","text","onDelta","done","result","onDone","cancel","onError","fail","e","Error","message","String","guarded","fn","args","attempt","authRetries","streamErrorCode","url","method","headers","Authorization","body","JSON","stringify","connectTimeoutMs","connectMs","idleTimeoutMs","idleMs","onData","payload","event","parse","type","usage","onEnd","cause","bodyText","response","recover","getHeader","name","catch","configReloads","context","retry","onFailure","onGiveUp","recovery","reloadOnHttpStatus","includes","maxSilentRetries","retryAfter","retryBackoffMs","forceReload","then","reloaded","setTimeout","getQuota","lastQuota","getBehaviorState","subscribe","listener","fromManager","fromClient","add","reloadConfig","a","b"],"sourceRoot":"../../../src","sources":["core/aiClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/quotaRequest.js

@@ -0,0 +1,102 @@
+"use strict";
+
+/**
+ * The quota request, and the recovery it shares with a chat (AI-13).
+ *
+ * `getQuota` used to be the one call with no recovery at all: a gateway that
+ * had moved answered 404 for quota while chats silently re-routed, so the
+ * figure on screen failed while the feature worked. It now goes through the
+ * same `recover` the chat stream does — a designated status reloads the
+ * configuration and retries, a 401 retries once with a token the provider had
+ * to fetch again.
+ */
+
+import { AiError } from "../diagnostics/errors.js";
+import { withTimeout } from "../transport/timeouts.js";
+
+/** Where the quota request is in its recovery, shared with the chat path. */
+
+/** What is left of the app's allowance. */
+
+export function createQuotaRequest(deps) {
+  const {
+    fetchFn,
+    timeouts,
+    endpoint,
+    asQuota,
+    recover,
+    setQuota
+  } = deps;
+  const acquire = deps.acquire;
+  async function getQuota() {
+    try {
+      const snapshotValue = await fetchQuotaWithRecovery({
+        configReloads: 0,
+        authRetries: 0
+      });
+      setQuota(snapshotValue);
+      return snapshotValue;
+    } catch (error) {
+      if (error instanceof AiError) deps.report(error);
+      throw error;
+    }
+  }
+
+  /** Same recovery as a chat: a retired endpoint reloads the config and retries. */
+  function fetchQuotaWithRecovery(state) {
+    return new Promise((resolve, reject) => {
+      fetchQuota(state).then(resolve, error => {
+        if (!(error instanceof HttpFailure)) {
+          reject(error);
+          return;
+        }
+        recover(error.status, error.bodyText, state, {
+          getHeader: name => error.getHeader(name)
+        }, next => fetchQuotaWithRecovery(next).then(resolve, reject), reject, reject);
+      });
+    });
+  }
+
+  /** Carries the response so `recover` can decide; never reaches the caller. */
+  class HttpFailure extends Error {
+    constructor(status, bodyText, headers) {
+      super(`gateway responded ${status}`);
+      this.status = status;
+      this.bodyText = bodyText;
+      this.headers = headers;
+      this.name = 'HttpFailure';
+    }
+    getHeader(name) {
+      return this.headers?.get(name) ?? null;
+    }
+  }
+  async function fetchQuota(state) {
+    const {
+      config,
+      token
+    } = await acquire({
+      forceRefresh: state.authRetries > 0
+    });
+    return withTimeout(timeouts.quotaMs, async signal => {
+      const response = await fetchFn(endpoint(config, 'quota'), {
+        headers: {
+          Authorization: `Bearer ${token}`
+        },
+        signal
+      });
+      if (!response.ok) {
+        throw new HttpFailure(response.status, await response.text(), response.headers);
+      }
+      const parsed = asQuota(await response.json());
+      if (!parsed) {
+        // A body that is not the contract's: better no figure than a wrong one.
+        throw new AiError('internal', 'quota response did not match the contract');
+      }
+      return parsed;
+    }, () => new AiError('network', 'quota request timed out'));
+  }
+  return {
+    getQuota
+  };
+}
+//# sourceMappingURL=quotaRequest.js.map

package/lib/module/core/quotaRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AiError","withTimeout","createQuotaRequest","deps","fetchFn","timeouts","endpoint","asQuota","recover","setQuota","acquire","getQuota","snapshotValue","fetchQuotaWithRecovery","configReloads","authRetries","error","report","state","Promise","resolve","reject","fetchQuota","then","HttpFailure","status","bodyText","getHeader","name","next","Error","constructor","headers","get","config","token","forceRefresh","quotaMs","signal","response","Authorization","ok","text","parsed","json"],"sourceRoot":"../../../src","sources":["core/quotaRequest.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/diagnostics/errors.js

@@ -0,0 +1,99 @@
+"use strict";
+
+/** Typed client errors (contracts/rn-ai-public-api.md). */
+import { SdkError, redactPatterns } from '@chipmobilesdk/rn-core';
+import { RETRY_AFTER_HEADER } from "../contract/gateway.js";
+/** Codes a retry can fix on its own. */
+const RETRYABLE_BY_DEFAULT = new Set(['rate-limited', 'upstream-busy', 'network']);
+
+/** The package's error; an `SdkError` (`@chipmobilesdk/rn-core`) with `pkg: 'rn-ai'`. */
+export class AiError extends SdkError {
+  /** The underlying code, when one layer down had a name for the failure. */
+
+  constructor(code, message, options = {}) {
+    super('rn-ai', code, {
+      message,
+      retryable: options.retryable ?? options.recoverable ?? RETRYABLE_BY_DEFAULT.has(code)
+    });
+    this.name = 'AiError';
+    this.retryAfterSeconds = options.retryAfterSeconds;
+    this.cause = options.cause;
+  }
+
+  /** @deprecated Use `retryable`, the name every SDK package shares. */
+  get recoverable() {
+    return this.retryable;
+  }
+}
+export function isAiError(value) {
+  return value instanceof AiError;
+}
+
+/**
+ * Every gateway code, mapped. Typed as a total record, so a code added to the
+ * shared contract does not compile until the client says what it means (GW-13).
+ */
+const HTTP_CODE_MAP = {
+  BAD_REQUEST: 'internal',
+  AUTH_INVALID: 'auth-invalid',
+  NOT_ENTITLED: 'not-entitled',
+  USER_BLOCKED: 'user-blocked',
+  APP_UNKNOWN: 'app-unknown',
+  // The endpoint moved: the client's configuration is the stale part.
+  ENDPOINT_RETIRED: 'config-unavailable',
+  PAYLOAD_TOO_LARGE: 'payload-too-large',
+  MODALITY_NOT_ALLOWED: 'modality-not-allowed',
+  RATE_LIMITED: 'rate-limited',
+  UPSTREAM_BUSY: 'upstream-busy',
+  UPSTREAM_ERROR: 'upstream-error',
+  INTERNAL: 'internal'
+};
+function isGatewayCode(value) {
+  return typeof value === 'string' && value in HTTP_CODE_MAP;
+}
+
+/** `Retry-After` in seconds, from either form the header may take. */
+export function parseRetryAfter(value) {
+  if (!value) {
+    return undefined;
+  }
+  const seconds = Number(value);
+  if (Number.isFinite(seconds) && seconds >= 0) {
+    return seconds;
+  }
+  const date = Date.parse(value);
+  if (Number.isFinite(date)) {
+    return Math.max(0, Math.round((date - Date.now()) / 1000));
+  }
+  return undefined;
+}
+/** Map a gateway error response (status + JSON body) to a typed AiError. */
+export function errorFromHttp(status, bodyText, context = {}) {
+  // Status 0 is not an answer at all: the request never arrived, or the
+  // connection dropped. That is a network failure a retry may well fix, not an
+  // upstream fault (AI-11).
+  if (status === 0) {
+    return new AiError('network', bodyText === 'timeout' ? 'the request timed out' : 'no connection');
+  }
+  let code = status >= 500 ? 'upstream-error' : 'internal';
+  let message = `gateway responded ${status}`;
+  let gatewayCode;
+  let retryAfterSeconds = parseRetryAfter(context.getHeader?.(RETRY_AFTER_HEADER));
+  try {
+    const parsed = JSON.parse(bodyText);
+    if (isGatewayCode(parsed.error?.code)) {
+      gatewayCode = parsed.error.code;
+      code = HTTP_CODE_MAP[gatewayCode];
+    }
+    // The gateway's text can quote upstream detail; keep it readable but shaped.
+    if (parsed.error?.message) message = redactPatterns(parsed.error.message);
+    retryAfterSeconds = parsed.error?.retryAfterSeconds ?? retryAfterSeconds;
+  } catch {
+    // A body that is not the contract's: the status is all there is to go on.
+  }
+  return new AiError(code, message, {
+    retryAfterSeconds,
+    cause: gatewayCode
+  });
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/diagnostics/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SdkError","redactPatterns","RETRY_AFTER_HEADER","RETRYABLE_BY_DEFAULT","Set","AiError","constructor","code","message","options","retryable","recoverable","has","name","retryAfterSeconds","cause","isAiError","value","HTTP_CODE_MAP","BAD_REQUEST","AUTH_INVALID","NOT_ENTITLED","USER_BLOCKED","APP_UNKNOWN","ENDPOINT_RETIRED","PAYLOAD_TOO_LARGE","MODALITY_NOT_ALLOWED","RATE_LIMITED","UPSTREAM_BUSY","UPSTREAM_ERROR","INTERNAL","isGatewayCode","parseRetryAfter","undefined","seconds","Number","isFinite","date","Date","parse","Math","max","round","now","errorFromHttp","status","bodyText","context","gatewayCode","getHeader","parsed","JSON","error"],"sourceRoot":"../../../src","sources":["diagnostics/errors.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/diagnostics/messageKeys.js

@@ -0,0 +1,61 @@
+"use strict";
+
+/**
+ * User-facing copy keys (UX-002/003) and their English defaults, as an rn-core
+ * message catalog: apps translate them through rn-i18n
+ * (`runtimeEntriesFromCatalog(aiMessages)`) or override them directly.
+ */
+import { defineMessages } from '@chipmobilesdk/rn-core';
+export const aiMessageSet = defineMessages({
+  user: {
+    'ai.state.loading': 'Thinking…',
+    'ai.state.streaming': 'Answering…',
+    // Neutral copy: the app names its own feature (AI-16).
+    'ai.input.placeholder': 'Type a message…',
+    'ai.action.send': 'Send',
+    'ai.action.cancel': 'Cancel',
+    'ai.action.retry': 'Try again',
+    'ai.action.retryAt': 'You can try again at {time}',
+    'ai.quota.remaining': '{count} requests left today',
+    'ai.error.rateLimited': 'You have reached your usage limit.',
+    'ai.error.premiumRequired': 'AI features require a premium subscription for this app.',
+    'ai.error.blocked': 'AI access is suspended for this account.',
+    'ai.error.payloadTooLarge': 'That attachment is too large to send.',
+    'ai.error.modality': 'This kind of content is not supported here.',
+    'ai.error.busy': 'The AI service is busy. Please try again shortly.',
+    'ai.error.unavailable': 'AI features are currently unavailable.',
+    'ai.error.signIn': 'Please sign in again to continue.',
+    'ai.error.offline': 'No connection. Check your network and try again.',
+    'ai.error.generic': 'Something went wrong. Please try again.'
+  }
+});
+export const aiMessages = aiMessageSet.defaults;
+export function aiMessage(key) {
+  return aiMessages[key];
+}
+
+/**
+ * The copy for each error code. A `Record` over the whole code union, so adding a
+ * code without choosing its copy fails to compile (AI-16).
+ */
+const ERROR_MESSAGES = {
+  'auth-invalid': 'ai.error.signIn',
+  'session-expired': 'ai.error.signIn',
+  network: 'ai.error.offline',
+  'not-entitled': 'ai.error.premiumRequired',
+  'user-blocked': 'ai.error.blocked',
+  'app-unknown': 'ai.error.unavailable',
+  'rate-limited': 'ai.error.rateLimited',
+  'upstream-busy': 'ai.error.busy',
+  'payload-too-large': 'ai.error.payloadTooLarge',
+  'modality-not-allowed': 'ai.error.modality',
+  'config-unavailable': 'ai.error.unavailable',
+  'upstream-error': 'ai.error.generic',
+  internal: 'ai.error.generic'
+};
+
+/** The message key to show a user for an error. */
+export function messageKeyForError(error) {
+  return ERROR_MESSAGES[error.code];
+}
+//# sourceMappingURL=messageKeys.js.map

package/lib/module/diagnostics/messageKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defineMessages","aiMessageSet","user","aiMessages","defaults","aiMessage","key","ERROR_MESSAGES","network","internal","messageKeyForError","error","code"],"sourceRoot":"../../../src","sources":["diagnostics/messageKeys.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,SAASA,cAAc,QAAQ,wBAAwB;AAKvD,OAAO,MAAMC,YAAY,GAAGD,cAAc,CAAC;EAC1CE,IAAI,EAAE;IACL,kBAAkB,EAAE,WAAW;IAC/B,oBAAoB,EAAE,YAAY;IAClC;IACA,sBAAsB,EAAE,iBAAiB;IACzC,gBAAgB,EAAE,MAAM;IACxB,kBAAkB,EAAE,QAAQ;IAC5B,iBAAiB,EAAE,WAAW;IAC9B,mBAAmB,EAAE,6BAA6B;IAClD,oBAAoB,EAAE,6BAA6B;IACnD,sBAAsB,EAAE,oCAAoC;IAC5D,0BAA0B,EAAE,0DAA0D;IACtF,kBAAkB,EAAE,0CAA0C;IAC9D,0BAA0B,EAAE,uCAAuC;IACnE,mBAAmB,EAAE,6CAA6C;IAClE,eAAe,EAAE,mDAAmD;IACpE,sBAAsB,EAAE,wCAAwC;IAChE,iBAAiB,EAAE,mCAAmC;IACtD,kBAAkB,EAAE,kDAAkD;IACtE,kBAAkB,EAAE;EACrB;AACD,CAAC,CAAC;AAEF,OAAO,MAAMC,UAAU,GAAGF,YAAY,CAACG,QAAQ;AAI/C,OAAO,SAASC,SAASA,CAACC,GAAiB,EAAU;EACpD,OAAOH,UAAU,CAACG,GAAG,CAAC;AACvB;;AAEA;AACA;AACA;AACA;AACA,MAAMC,cAAiD,GAAG;EACzD,cAAc,EAAE,iBAAiB;EACjC,iBAAiB,EAAE,iBAAiB;EACpCC,OAAO,EAAE,kBAAkB;EAC3B,cAAc,EAAE,0BAA0B;EAC1C,cAAc,EAAE,kBAAkB;EAClC,aAAa,EAAE,sBAAsB;EACrC,cAAc,EAAE,sBAAsB;EACtC,eAAe,EAAE,eAAe;EAChC,mBAAmB,EAAE,0BAA0B;EAC/C,sBAAsB,EAAE,mBAAmB;EAC3C,oBAAoB,EAAE,sBAAsB;EAC5C,gBAAgB,EAAE,kBAAkB;EACpCC,QAAQ,EAAE;AACX,CAAC;;AAED;AACA,OAAO,SAASC,kBAAkBA,CAACC,KAAc,EAAgB;EAChE,OAAOJ,cAAc,CAACI,KAAK,CAACC,IAAI,CAAC;AAClC","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,19 @@
+"use strict";
+
+/**
+ * @chipmobilesdk/rn-ai — AI gateway client for ChipMobileSdk-family React
+ * Native apps (feature 005). Single public entrypoint (LIB-003); modules
+ * under `config/`, `transport/`, `core/`, `react/`, and `diagnostics/` are
+ * private. Contract: specs/005-azure-ai-gateway/contracts/rn-ai-public-api.md
+ */
+export { createAiClient } from "./core/aiClient.js";
+export { configCacheFromKeyValue, SUPPORTED_SCHEMA_VERSION } from "./config/behaviorConfig.js";
+
+// The gateway contract, shared with the service: error codes, quota headers and
+// stream events have one definition (GW-13).
+
+export { GATEWAY_ERROR_STATUS, QUOTA_HEADERS, SSE_DONE_SENTINEL } from "./contract/gateway.js";
+export { useAiBehaviorState, useAiChat, useAiQuota } from "./react/hooks.js";
+export { AiError, isAiError } from "./diagnostics/errors.js";
+export { aiMessage, aiMessageSet, aiMessages, messageKeyForError } from "./diagnostics/messageKeys.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createAiClient","configCacheFromKeyValue","SUPPORTED_SCHEMA_VERSION","GATEWAY_ERROR_STATUS","QUOTA_HEADERS","SSE_DONE_SENTINEL","useAiBehaviorState","useAiChat","useAiQuota","AiError","isAiError","aiMessage","aiMessageSet","aiMessages","messageKeyForError"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,cAAc,QAAQ,oBAAiB;AAiBhD,SAASC,uBAAuB,EAAEC,wBAAwB,QAAQ,4BAAyB;;AAE3F;AACA;;AAUA,SAASC,oBAAoB,EAAEC,aAAa,EAAEC,iBAAiB,QAAQ,uBAAoB;AAU3F,SAASC,kBAAkB,EAAEC,SAAS,EAAEC,UAAU,QAAQ,kBAAe;AAQzE,SAASC,OAAO,EAAEC,SAAS,QAAQ,yBAAsB;AAEzD,SAASC,SAAS,EAAEC,YAAY,EAAEC,UAAU,EAAEC,kBAAkB,QAAQ,8BAA2B","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/react/hooks.js

@@ -0,0 +1,164 @@
+"use strict";
+
+import { useExternalStore } from '@chipmobilesdk/rn-core/react';
+import { useCallback, useEffect, useRef, useState } from 'react';
+const DEFAULT_FLUSH_MS = 50;
+export function useAiChat(client, options = {}) {
+  const [status, setStatus] = useState('idle');
+  const [text, setText] = useState('');
+  const [error, setError] = useState();
+  const [retryAt, setRetryAt] = useState();
+  const fromClient = useAiQuotaValue(client);
+  // The figure this chat was told, for a client of the app's own that keeps none.
+  const [reported, setReported] = useState();
+  const quota = fromClient ?? reported;
+  const handleRef = useRef(null);
+  // Bumped by every send, cancel and unmount. A callback from an older request
+  // is dropped, so it can never overwrite the state of the one on screen —
+  // defence in depth behind the client's own cancel guard.
+  const requestRef = useRef(0);
+
+  // Deltas land here and reach React on a timer, so the transcript renders at a
+  // steady rate however fast the model answers.
+  const pending = useRef('');
+  const flushTimer = useRef(undefined);
+  const flushMs = options.flushIntervalMs ?? DEFAULT_FLUSH_MS;
+  const stopFlushing = useCallback(() => {
+    if (flushTimer.current !== undefined) {
+      clearTimeout(flushTimer.current);
+      flushTimer.current = undefined;
+    }
+  }, []);
+  const flush = useCallback(() => {
+    flushTimer.current = undefined;
+    const buffered = pending.current;
+    if (buffered === '') {
+      return;
+    }
+    pending.current = '';
+    setText(previous => previous + buffered);
+  }, []);
+  useEffect(() => stopFlushing, [stopFlushing]);
+  const send = useCallback(request => {
+    handleRef.current?.cancel();
+    const id = ++requestRef.current;
+    const current = () => requestRef.current === id;
+    stopFlushing();
+    pending.current = '';
+    setText('');
+    setError(undefined);
+    setRetryAt(undefined);
+    setStatus('loading');
+    handleRef.current = client.chat(request, {
+      onDelta: delta => {
+        if (!current()) return;
+        pending.current += delta;
+        if (flushMs <= 0) {
+          flush();
+        } else if (flushTimer.current === undefined) {
+          flushTimer.current = setTimeout(flush, flushMs);
+        }
+        // Only the first delta is a state change; the rest are text.
+        setStatus(previous => previous === 'streaming' ? previous : 'streaming');
+      },
+      onDone: result => {
+        if (!current()) return;
+        stopFlushing();
+        flush();
+        if (result.quota) setReported(result.quota);
+        setStatus('done');
+      },
+      onError: aiError => {
+        if (!current()) return;
+        stopFlushing();
+        // Whatever arrived before the failure is kept: a half-answer is
+        // still what the user was reading.
+        flush();
+        setError(aiError);
+        if (aiError.code === 'rate-limited') {
+          setStatus('rate-limited');
+          if (aiError.retryAfterSeconds !== undefined) {
+            setRetryAt(new Date(Date.now() + aiError.retryAfterSeconds * 1000));
+          }
+        } else {
+          setStatus('error');
+        }
+      }
+    });
+  }, [client, flush, flushMs, stopFlushing]);
+  const cancel = useCallback(() => {
+    requestRef.current += 1;
+    stopFlushing();
+    handleRef.current?.cancel();
+    setStatus('idle');
+  }, [stopFlushing]);
+  useEffect(() => () => {
+    requestRef.current += 1;
+    handleRef.current?.cancel();
+  }, []);
+  return {
+    send,
+    cancel,
+    status,
+    text,
+    error,
+    retryAt,
+    quota
+  };
+}
+const noSubscription = () => () => undefined;
+
+/**
+ * The quota the client last saw, from a chat's `done` event or from
+ * `getQuota()`. One source, so a figure on screen is not stale the moment a
+ * chat finishes (AI-13).
+ */
+function useAiQuotaValue(client) {
+  return useExternalStore(client.subscribe ?? noSubscription, client.lastQuota ?? (() => undefined));
+}
+export function useAiQuota(client) {
+  const fromClient = useAiQuotaValue(client);
+  // A client of the app's own may not keep the last quota; then this is it.
+  const [fetched, setFetched] = useState();
+  const quota = fromClient ?? fetched;
+  const [status, setStatus] = useState('loading');
+  const alive = useRef(true);
+  // Only the latest refresh may settle the state; an older, slower one that
+  // lands afterwards is stale.
+  const latest = useRef(0);
+  const refresh = useCallback(() => {
+    const id = ++latest.current;
+    const current = () => alive.current && latest.current === id;
+    setStatus('loading');
+    client.getQuota().then(snapshot => {
+      if (!current()) return;
+      setFetched(snapshot);
+      setStatus('ready');
+    }).catch(() => {
+      if (current()) setStatus('error');
+    });
+  }, [client]);
+  useEffect(() => {
+    alive.current = true;
+    refresh();
+    return () => {
+      alive.current = false;
+    };
+  }, [refresh]);
+
+  // A quota that arrived through a chat is an answer too: nothing is loading.
+  return {
+    quota,
+    status: status === 'loading' && quota ? 'ready' : status,
+    refresh
+  };
+}
+
+/**
+ * The client's behavior state (config source and whether AI is enabled), live:
+ * re-renders when the kill switch flips or the config state moves (AI-09).
+ */
+export function useAiBehaviorState(client) {
+  return useExternalStore(client.subscribe ?? noSubscription, client.getBehaviorState);
+}
+//# sourceMappingURL=hooks.js.map

package/lib/module/react/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useExternalStore","useCallback","useEffect","useRef","useState","DEFAULT_FLUSH_MS","useAiChat","client","options","status","setStatus","text","setText","error","setError","retryAt","setRetryAt","fromClient","useAiQuotaValue","reported","setReported","quota","handleRef","requestRef","pending","flushTimer","undefined","flushMs","flushIntervalMs","stopFlushing","current","clearTimeout","flush","buffered","previous","send","request","cancel","id","chat","onDelta","delta","setTimeout","onDone","result","onError","aiError","code","retryAfterSeconds","Date","now","noSubscription","subscribe","lastQuota","useAiQuota","fetched","setFetched","alive","latest","refresh","getQuota","then","snapshot","catch","useAiBehaviorState","getBehaviorState"],"sourceRoot":"../../../src","sources":["react/hooks.ts"],"mappings":"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","ignoreList":[]}