@chipmobilesdk/rn-ai 0.4.0 → 0.5.0

package/lib/module/transport/sseClient.js

@@ -0,0 +1,146 @@
+"use strict";
+
+/**
+ * Minimal SSE reader over XMLHttpRequest (research R2).
+ *
+ * React Native's fetch does not reliably expose ReadableStream on Hermes, so
+ * we use XHR incremental text delivery (readyState LOADING + onprogress) —
+ * the same mechanism community SSE libraries use — with zero dependencies.
+ * The gateway never compresses SSE responses (contract), which keeps
+ * incremental delivery intact on both platforms.
+ */
+
+/** What the response said besides its body. Absent for a failure with no response. */
+
+/**
+ * The transport port: how this package makes a streaming request.
+ *
+ * A published port rather than `typeof requestSse`, so the default reader's
+ * own signature is not part of the public API (AI-18): an app may inject its
+ * own transport, and this package may change how `requestSse` is written
+ * without that being a breaking change.
+ */
+
+/**
+ * Parse complete `data:` events out of `text` starting at `fromIndex`.
+ *
+ * Both line endings are accepted. A proxy that normalises to CRLF — an API
+ * gateway or a corporate middlebox — used to make every event invisible until
+ * the stream closed, because only `\n\n` counted as a separator (AI-22).
+ */
+export function drainSseEvents(text, fromIndex, emit) {
+  let cursor = fromIndex;
+  for (;;) {
+    const separator = /\r\n\r\n|\n\n|\r\r/.exec(text.slice(cursor));
+    if (!separator) {
+      return cursor; // incomplete event stays buffered
+    }
+    const rawEvent = text.slice(cursor, cursor + separator.index);
+    cursor += separator.index + separator[0].length;
+    const dataLines = rawEvent.split(/\r\n|\n|\r/).filter(line => line.startsWith('data:')).map(line => line.slice(5).trimStart());
+    if (dataLines.length > 0) {
+      emit(dataLines.join('\n'));
+    }
+  }
+}
+export function requestSse(request, handlers) {
+  const xhr = new XMLHttpRequest();
+  let seen = 0;
+  let finished = false;
+  let cancelled = false;
+
+  // One timer, re-armed as the request progresses: the connect limit until
+  // headers arrive, then the idle limit, restarted by every chunk.
+  let stallTimer;
+  const disarm = () => {
+    if (stallTimer !== undefined) {
+      clearTimeout(stallTimer);
+      stallTimer = undefined;
+    }
+  };
+
+  /** The response's own headers, for `Retry-After` on a 429 (AI-11). */
+  const response = {
+    getHeader(name) {
+      try {
+        return xhr.getResponseHeader(name);
+      } catch {
+        // Headers are unavailable before they arrive, and on some polyfills.
+        return null;
+      }
+    }
+  };
+  const finish = fn => {
+    disarm();
+    if (!finished && !cancelled) {
+      finished = true;
+      fn();
+    }
+  };
+  const stalled = () => {
+    stallTimer = undefined;
+    if (finished || cancelled) return;
+    finished = true;
+    try {
+      xhr.abort();
+    } catch {
+      // already settled
+    }
+    handlers.onError(0, 'timeout');
+  };
+  const arm = ms => {
+    disarm();
+    if (ms && !finished && !cancelled) stallTimer = setTimeout(stalled, ms);
+  };
+
+  /**
+   * Drains whatever has arrived. `onprogress` and `readyState === 3` both fire
+   * for the same chunk, and which of the two fires at all has been platform
+   * dependent, so both stay registered; the length check makes the second call
+   * for one chunk free rather than another full `responseText` drain (AI-V1).
+   */
+  let drained = -1;
+  const pump = () => {
+    if (xhr.status !== 200) return; // error path handled on load/error
+    const text = xhr.responseText ?? '';
+    if (text.length === drained) return;
+    drained = text.length;
+    arm(request.idleTimeoutMs);
+    seen = drainSseEvents(text, seen, handlers.onData);
+  };
+  xhr.open(request.method ?? 'POST', request.url, true);
+  for (const [k, v] of Object.entries(request.headers ?? {})) {
+    xhr.setRequestHeader(k, v);
+  }
+  xhr.setRequestHeader('Accept', 'text/event-stream');
+  if (request.timeoutMs) xhr.timeout = request.timeoutMs;
+  xhr.onprogress = pump;
+  xhr.onreadystatechange = () => {
+    if (xhr.readyState === 2) arm(request.connectTimeoutMs); // HEADERS_RECEIVED
+    if (xhr.readyState === 3) pump(); // LOADING: incremental text
+  };
+  xhr.onload = () => {
+    if (xhr.status === 200) {
+      pump();
+      finish(handlers.onEnd);
+    } else {
+      finish(() => handlers.onError(xhr.status, xhr.responseText ?? '', response));
+    }
+  };
+  xhr.onerror = () => finish(() => handlers.onError(0, 'network error'));
+  xhr.ontimeout = () => finish(() => handlers.onError(0, 'timeout'));
+  xhr.send(request.body);
+  arm(request.connectTimeoutMs);
+  return {
+    cancel() {
+      cancelled = true;
+      disarm();
+      try {
+        xhr.abort();
+      } catch {
+        // aborting a settled XHR is a no-op
+      }
+    }
+  };
+}
+//# sourceMappingURL=sseClient.js.map

package/lib/module/transport/sseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["drainSseEvents","text","fromIndex","emit","cursor","separator","exec","slice","rawEvent","index","length","dataLines","split","filter","line","startsWith","map","trimStart","join","requestSse","request","handlers","xhr","XMLHttpRequest","seen","finished","cancelled","stallTimer","disarm","undefined","clearTimeout","response","getHeader","name","getResponseHeader","finish","fn","stalled","abort","onError","arm","ms","setTimeout","drained","pump","status","responseText","idleTimeoutMs","onData","open","method","url","k","v","Object","entries","headers","setRequestHeader","timeoutMs","timeout","onprogress","onreadystatechange","readyState","connectTimeoutMs","onload","onEnd","onerror","ontimeout","send","body","cancel"],"sourceRoot":"../../../src","sources":["transport/sseClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/transport/timeouts.js

@@ -0,0 +1,41 @@
+"use strict";
+
+/**
+ * Time limits for every network call the client makes (AI-04).
+ *
+ * Without them a stalled mobile connection left `useAiChat` in `loading` or
+ * `streaming`, and `useAiQuota` in `loading`, until the user gave up.
+ */
+
+/**
+ * The gateway sends headers only once the model has answered, so `connectMs`
+ * also covers time to first token on a large image prompt.
+ */
+export const DEFAULT_AI_TIMEOUTS = {
+  connectMs: 30_000,
+  idleMs: 30_000,
+  configMs: 10_000,
+  quotaMs: 10_000
+};
+
+/**
+ * Runs `run` with an abort signal and rejects with `onTimeout()` after `ms`.
+ * The race matters as much as the signal: an injected `fetchFn` (or an old
+ * polyfill) may ignore the signal entirely.
+ */
+export async function withTimeout(ms, run, onTimeout) {
+  const controller = typeof AbortController === 'undefined' ? undefined : new AbortController();
+  let timer;
+  const expired = new Promise((_, reject) => {
+    timer = setTimeout(() => {
+      controller?.abort();
+      reject(onTimeout());
+    }, ms);
+  });
+  try {
+    return await Promise.race([run(controller?.signal), expired]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+//# sourceMappingURL=timeouts.js.map

package/lib/module/transport/timeouts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_AI_TIMEOUTS","connectMs","idleMs","configMs","quotaMs","withTimeout","ms","run","onTimeout","controller","AbortController","undefined","timer","expired","Promise","_","reject","setTimeout","abort","race","signal","clearTimeout"],"sourceRoot":"../../../src","sources":["transport/timeouts.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA,OAAO,MAAMA,mBAA+B,GAAG;EAC9CC,SAAS,EAAE,MAAM;EACjBC,MAAM,EAAE,MAAM;EACdC,QAAQ,EAAE,MAAM;EAChBC,OAAO,EAAE;AACV,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,WAAWA,CAChCC,EAAU,EACVC,GAAoD,EACpDC,SAAsB,EACT;EACb,MAAMC,UAAU,GAAG,OAAOC,eAAe,KAAK,WAAW,GAAGC,SAAS,GAAG,IAAID,eAAe,CAAC,CAAC;EAC7F,IAAIE,KAAgD;EACpD,MAAMC,OAAO,GAAG,IAAIC,OAAO,CAAQ,CAACC,CAAC,EAAEC,MAAM,KAAK;IACjDJ,KAAK,GAAGK,UAAU,CAAC,MAAM;MACxBR,UAAU,EAAES,KAAK,CAAC,CAAC;MACnBF,MAAM,CAACR,SAAS,CAAC,CAAC,CAAC;IACpB,CAAC,EAAEF,EAAE,CAAC;EACP,CAAC,CAAC;EACF,IAAI;IACH,OAAO,MAAMQ,OAAO,CAACK,IAAI,CAAC,CAACZ,GAAG,CAACE,UAAU,EAAEW,MAAM,CAAC,EAAEP,OAAO,CAAC,CAAC;EAC9D,CAAC,SAAS;IACTQ,YAAY,CAACT,KAAK,CAAC;EACpB;AACD","ignoreList":[]}

package/lib/typescript/commonjs/config/behaviorConfig.d.ts

@@ -0,0 +1,119 @@
+import { type KeyValuePort } from '@chipmobilesdk/rn-core';
+/** App behavior configuration (contracts/app-behavior-config.md). */
+export interface AppBehaviorConfig {
+    schemaVersion: number;
+    appId: string;
+    configVersion: number;
+    refreshTtlSeconds: number;
+    api: {
+        baseUrl: string;
+        scopes: string[];
+        supportsStreaming: boolean;
+    };
+    limitsDisplay?: {
+        requestsPerDay?: number;
+        tokensPerDay?: number;
+    };
+    recovery: {
+        reloadOnHttpStatus: number[];
+        maxSilentRetries: number;
+        retryBackoffMs: number[];
+    };
+    features: {
+        aiEnabled: boolean;
+    };
+}
+/** Persistence port; default is in-memory (inject a durable store for offline launch). */
+export interface AiConfigCache {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+}
+export declare class MemoryConfigCache implements AiConfigCache {
+    private map;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+}
+/**
+ * An `AiConfigCache` over rn-core's synchronous `KeyValuePort` (AI-10).
+ *
+ * Without a durable cache every launch waits for the network before the first
+ * chat, which is exactly what the cache-first design exists to avoid. Open the
+ * port the way the app opens its other durable state, for example
+ * `openDurable(() => createMMKV({ id: 'app' }))`.
+ */
+export declare function configCacheFromKeyValue(port: KeyValuePort): AiConfigCache;
+export type BehaviorState = 'unloaded' | 'ready-network' | 'ready-cache' | 'unavailable';
+/** The newest document layout this release understands. */
+export declare const SUPPORTED_SCHEMA_VERSION = 1;
+/** https, or http on a development machine: a bearer token travels to this host. */
+export declare function isTrustedUrl(url: string): boolean;
+export interface ParseBehaviorConfigOptions {
+    /** The app this document must be for; a document for another app is refused. */
+    expectedAppId?: string;
+    /** Hosts `api.baseUrl` may name. Any host is accepted when omitted. */
+    allowedHosts?: readonly string[];
+}
+/**
+ * Parse + validate; unknown fields ignored (forward compatibility).
+ *
+ * Every field this package acts on is checked here, because the document is
+ * remote and the alternative is a TypeError inside an XHR callback, a revalidate
+ * on every single request, or a bearer token sent to a host nobody vetted
+ * (AI-06, AI-07).
+ */
+export declare function parseBehaviorConfig(json: string, options?: ParseBehaviorConfigOptions): AppBehaviorConfig;
+export interface BehaviorConfigDeps {
+    configUrl: string;
+    appId: string;
+    cache?: AiConfigCache;
+    fetchFn?: typeof fetch;
+    now?: () => number;
+    /** Limit on one config fetch, body included. Defaults to 10 s. */
+    timeoutMs?: number;
+    /** Hosts the document's `api.baseUrl` may name. */
+    allowedHosts?: readonly string[];
+}
+/**
+ * Cache-first behavior config (FR-018): launch never blocks on the network;
+ * TTL revalidation uses ETag; designated errors force a reload.
+ */
+export declare class BehaviorConfigManager {
+    private deps;
+    private cacheKey;
+    private cache;
+    private fetchFn;
+    private now;
+    private current?;
+    /**
+     * One cache read and one network fetch at a time (AI-08): a cold start makes a
+     * chat and a quota call together, and each used to fetch the config itself.
+     */
+    private readonly cacheRead;
+    private readonly networkFetch;
+    private currentState;
+    private readonly stateListeners;
+    /** Where the config came from, or why there is none. */
+    get state(): BehaviorState;
+    /** Called whenever `state` changes (AI-09). */
+    subscribe(listener: () => void): () => void;
+    private setState;
+    constructor(deps: BehaviorConfigDeps);
+    private parse;
+    private isFresh;
+    private loadFromCache;
+    private readCache;
+    private fetchNetwork;
+    /** One attempt; `conditional` sends the stored ETag when there is one. */
+    private fetchOnce;
+    private fetchFromNetwork;
+    private persist;
+    /**
+     * Cache-first read. Fresh cache returns immediately; stale cache returns
+     * immediately too while a background revalidation runs; no cache at all
+     * falls through to the network (or `config-unavailable`).
+     */
+    getConfig(options?: {
+        forceReload?: boolean;
+    }): Promise<AppBehaviorConfig>;
+}
+//# sourceMappingURL=behaviorConfig.d.ts.map

package/lib/typescript/commonjs/config/behaviorConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviorConfig.d.ts","sourceRoot":"","sources":["../../../../src/config/behaviorConfig.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/contract/gateway.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The gateway↔client contract: error codes, quota headers, stream events.
+ *
+ * One definition, imported by both sides (GW-13). The gateway's own codes and
+ * the client's map of them were two hand-maintained lists, and they had already
+ * drifted: `BAD_REQUEST`, `ENDPOINT_RETIRED` and `INTERNAL` existed on the
+ * server and were unknown to the client, which fell back to a guess from the
+ * status. Adding a code now fails to compile on whichever side has not handled
+ * it.
+ *
+ * Types and plain constants only, and no import of anything: the gateway runs
+ * on Node and imports this file for its types alone.
+ */
+/** Every error the gateway answers with (`error.code` in the body). */
+export type GatewayErrorCode = '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';
+/** The HTTP status each code is sent with. */
+export declare const GATEWAY_ERROR_STATUS: Readonly<Record<GatewayErrorCode, number>>;
+/** The error body. `message` is safe to log; it never carries upstream detail. */
+export interface GatewayErrorBody {
+    error: {
+        code: GatewayErrorCode;
+        message: string;
+        retryAfterSeconds?: number;
+    };
+}
+/** The quota headers, by name. A rename here breaks both sides' compile. */
+export declare const QUOTA_HEADERS: {
+    readonly minuteRemaining: "X-Quota-Minute-Remaining";
+    readonly dayRemaining: "X-Quota-Day-Remaining";
+    readonly dayTokensRemaining: "X-Quota-Day-Tokens-Remaining";
+};
+/** The names field by field, so a side declaring its own literals is checked exactly. */
+export type QuotaHeaderNames = typeof QUOTA_HEADERS;
+export type QuotaHeaderName = QuotaHeaderNames[keyof QuotaHeaderNames];
+/** What is left of an app's allowance, as the gateway reports it. */
+export interface GatewayQuota {
+    minuteRemaining: number;
+    dayRemaining: number;
+    dayTokensRemaining: number;
+}
+/** What one answer cost. */
+export interface GatewayUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/** The `data:` payloads of a chat stream, before the `[DONE]` sentinel. */
+export type GatewayStreamEvent = {
+    type: 'delta';
+    text: string;
+} | {
+    type: 'done';
+    usage: GatewayUsage;
+    quota?: GatewayQuota;
+} | {
+    type: 'error';
+    code: GatewayErrorCode;
+};
+/** The last `data:` line of a stream that completed. */
+export declare const SSE_DONE_SENTINEL = "[DONE]";
+export type SseDoneSentinel = typeof SSE_DONE_SENTINEL;
+/** The `Retry-After` header, which a 429 always carries. */
+export declare const RETRY_AFTER_HEADER = "Retry-After";
+//# sourceMappingURL=gateway.d.ts.map

package/lib/typescript/commonjs/contract/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../../src/contract/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GACzB,aAAa,GACb,cAAc,GACd,cAAc,GACd,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,mBAAmB,GACnB,sBAAsB,GACtB,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,UAAU,CAAC;AAEd,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAa3E,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE;QACN,IAAI,EAAE,gBAAgB,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACF;AAED,4EAA4E;AAC5E,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,OAAO,aAAa,CAAC;AACpD,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,gBAAgB,CAAC,CAAC;AAEvE,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAED,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE7C,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC;AAEvD,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,gBAAgB,CAAC"}

package/lib/typescript/commonjs/core/aiClient.d.ts

@@ -0,0 +1,104 @@
+import { type Scheduler } from '@chipmobilesdk/rn-core';
+import { type AiConfigCache, type BehaviorState } from '../config/behaviorConfig';
+import { type GatewayQuota, type GatewayUsage } from '../contract/gateway';
+import { AiError } from '../diagnostics/errors';
+import { type StreamTransport } from '../transport/sseClient';
+import { type AiTimeouts } from '../transport/timeouts';
+export interface AccessTokenRequestOptions {
+    /**
+     * Skip the cached token and ask the provider for a new one. Set after a 401:
+     * the cached token is valid by the clock and refused by the server, so asking
+     * again without this re-sends the token that was just rejected (AI-01).
+     */
+    forceRefresh?: boolean;
+}
+/** Minimal slice of the rn-auth `Auth` controller the client needs. */
+export interface TokenProvider {
+    requestAccessToken(resourceKey: string, options?: AccessTokenRequestOptions): Promise<{
+        status: string;
+        token?: string;
+        errorCode?: string;
+    }>;
+}
+export type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    mimeType: string;
+    dataBase64: string;
+} | {
+    type: 'audio';
+    format: 'wav' | 'mp3';
+    dataBase64: string;
+};
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: ContentPart[];
+}
+export interface ChatRequest {
+    messages: ChatMessage[];
+    options?: {
+        temperature?: number;
+        maxOutputTokens?: number;
+    };
+}
+/** What one answer cost, as the gateway reports it. */
+export type Usage = GatewayUsage;
+/** What is left of the app's allowance. */
+export type QuotaSnapshot = GatewayQuota;
+export interface ChatStreamHandlers {
+    onDelta(text: string): void;
+    onDone(result: {
+        usage: Usage;
+        quota?: QuotaSnapshot;
+    }): void;
+    onError(error: AiError): void;
+}
+export interface ChatHandle {
+    cancel(): void;
+}
+export interface AiBehaviorState {
+    config: BehaviorState;
+    aiEnabled: boolean;
+}
+export interface AiClientConfig {
+    appId: string;
+    configUrl: string;
+    auth: TokenProvider;
+    /** rn-auth resource key configured for the gateway API scope. */
+    resourceKey?: string;
+    storage?: AiConfigCache;
+    fetchFn?: typeof fetch;
+    /** The streaming transport. Injected in tests, or to replace the XHR reader. */
+    transport?: StreamTransport;
+    /** Overrides for the network time limits; see `AiTimeouts` for the defaults. */
+    timeouts?: Partial<AiTimeouts>;
+    /** Test seam: how the backoff before a silent retry is waited out. */
+    scheduler?: Scheduler;
+    /**
+     * Hosts the remote config's `api.baseUrl` may name. A config document decides
+     * where this client sends its bearer token, so an app with a fixed deployment
+     * can pin it (AI-07).
+     */
+    allowedHosts?: readonly string[];
+}
+export interface AiClient {
+    chat(request: ChatRequest, handlers: ChatStreamHandlers): ChatHandle;
+    getQuota(): Promise<QuotaSnapshot>;
+    /**
+     * The last quota this client saw, from a chat's `done` event or `getQuota`.
+     * Optional so an app's own `AiClient` keeps compiling.
+     */
+    lastQuota?(): QuotaSnapshot | undefined;
+    /** The current behavior state; the same object until it changes. */
+    getBehaviorState(): AiBehaviorState;
+    /**
+     * Called whenever the behavior state or the last quota changes (AI-09, AI-13);
+     * returns the unsubscribe. Optional so an app's own `AiClient` keeps compiling.
+     */
+    subscribe?(listener: () => void): () => void;
+    reloadConfig(): Promise<void>;
+}
+export declare function createAiClient(clientConfig: AiClientConfig): AiClient;
+//# sourceMappingURL=aiClient.d.ts.map

package/lib/typescript/commonjs/core/aiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiClient.d.ts","sourceRoot":"","sources":["../../../../src/core/aiClient.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/core/quotaRequest.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 type { AppBehaviorConfig } from '../config/behaviorConfig';
+import { AiError } from '../diagnostics/errors';
+import { type AiTimeouts } from '../transport/timeouts';
+/** Where the quota request is in its recovery, shared with the chat path. */
+export interface RecoveryState {
+    configReloads: number;
+    authRetries: number;
+}
+export interface QuotaRequestDeps {
+    fetchFn: typeof fetch;
+    timeouts: AiTimeouts;
+    acquire: (options?: {
+        forceRefresh?: boolean;
+    }) => Promise<{
+        config: AppBehaviorConfig;
+        token: string;
+    }>;
+    endpoint: (config: AppBehaviorConfig, path: 'chat' | 'quota') => string;
+    asQuota: (value: unknown) => QuotaSnapshot | undefined;
+    recover: (status: number, bodyText: string, state: RecoveryState, context: {
+        getHeader?: (name: string) => string | null;
+    }, retry: (next: RecoveryState) => void, onFailure: (error: unknown) => void, onGiveUp: (error: AiError) => void) => void;
+    report: (error: AiError) => void;
+    setQuota: (next: QuotaSnapshot | undefined) => void;
+}
+/** What is left of the app's allowance. */
+export type QuotaSnapshot = {
+    minuteRemaining: number;
+    dayRemaining: number;
+    dayTokensRemaining: number;
+};
+export declare function createQuotaRequest(deps: QuotaRequestDeps): {
+    getQuota: () => Promise<QuotaSnapshot>;
+};
+//# sourceMappingURL=quotaRequest.d.ts.map

package/lib/typescript/commonjs/core/quotaRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quotaRequest.d.ts","sourceRoot":"","sources":["../../../../src/core/quotaRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAErE,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;QAC1D,MAAM,EAAE,iBAAiB,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,KAAK,MAAM,CAAC;IACxE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,aAAa,GAAG,SAAS,CAAC;IACvD,OAAO,EAAE,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;KAAE,EACxD,KAAK,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,EACpC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAC9B,IAAI,CAAC;IACV,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,CAAC;CACpD;AAED,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;oBAI7B,OAAO,CAAC,aAAa,CAAC;EAuEjD"}

package/lib/typescript/commonjs/diagnostics/errors.d.ts

@@ -0,0 +1,38 @@
+/** Typed client errors (contracts/rn-ai-public-api.md). */
+import { SdkError } from '@chipmobilesdk/rn-core';
+export type AiErrorCode = 'auth-invalid'
+/** The session itself ended: the user has to sign in again. */
+ | 'session-expired' | 'not-entitled' | 'user-blocked' | 'app-unknown' | 'rate-limited' | 'upstream-busy' | 'payload-too-large' | 'modality-not-allowed' | 'config-unavailable'
+/** The request never reached the gateway: no connection, a timeout, a dropped stream. */
+ | 'network' | 'upstream-error' | 'internal';
+export interface AiErrorOptions {
+    retryAfterSeconds?: number | undefined;
+    /** Whether retrying can succeed. Defaults by code; see `RETRYABLE_BY_DEFAULT`. */
+    retryable?: boolean | undefined;
+    /** @deprecated Use `retryable`; accepted as its alias. */
+    recoverable?: boolean | undefined;
+    /**
+     * The code the layer underneath reported — an rn-auth `AuthErrorCode`, or the
+     * gateway's own code. Kept so a screen can say *why* rather than only *what*.
+     */
+    cause?: string | undefined;
+}
+/** The package's error; an `SdkError` (`@chipmobilesdk/rn-core`) with `pkg: 'rn-ai'`. */
+export declare class AiError extends SdkError<AiErrorCode> {
+    readonly retryAfterSeconds?: number | undefined;
+    /** The underlying code, when one layer down had a name for the failure. */
+    readonly cause?: string | undefined;
+    constructor(code: AiErrorCode, message: string, options?: AiErrorOptions);
+    /** @deprecated Use `retryable`, the name every SDK package shares. */
+    get recoverable(): boolean;
+}
+export declare function isAiError(value: unknown): value is AiError;
+/** `Retry-After` in seconds, from either form the header may take. */
+export declare function parseRetryAfter(value: string | null | undefined): number | undefined;
+export interface HttpErrorContext {
+    /** The response headers, when the transport can read them. */
+    getHeader?: (name: string) => string | null | undefined;
+}
+/** Map a gateway error response (status + JSON body) to a typed AiError. */
+export declare function errorFromHttp(status: number, bodyText: string, context?: HttpErrorContext): AiError;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/commonjs/diagnostics/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/errors.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,QAAQ,EAAkB,MAAM,wBAAwB,CAAC;AAQlE,MAAM,MAAM,WAAW,GACpB,cAAc;AAChB,+DAA+D;GAC7D,iBAAiB,GACjB,cAAc,GACd,cAAc,GACd,aAAa,GACb,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB;AACtB,yFAAyF;GACvF,SAAS,GACT,gBAAgB,GAChB,UAAU,CAAC;AAEd,MAAM,WAAW,cAAc;IAC9B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AASD,yFAAyF;AACzF,qBAAa,OAAQ,SAAQ,QAAQ,CAAC,WAAW,CAAC;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAU5E,sEAAsE;IACtE,IAAI,WAAW,IAAI,OAAO,CAEzB;CACD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AA0BD,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAapF;AAED,MAAM,WAAW,gBAAgB;IAChC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACxD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CA4BT"}

package/lib/typescript/commonjs/diagnostics/messageKeys.d.ts

@@ -0,0 +1,46 @@
+import type { AiError } from './errors';
+export declare const aiMessageSet: import("@chipmobilesdk/rn-core").MessageSet<{
+    'ai.state.loading': string;
+    'ai.state.streaming': string;
+    'ai.input.placeholder': string;
+    'ai.action.send': string;
+    'ai.action.cancel': string;
+    'ai.action.retry': string;
+    'ai.action.retryAt': string;
+    'ai.quota.remaining': string;
+    'ai.error.rateLimited': string;
+    'ai.error.premiumRequired': string;
+    'ai.error.blocked': string;
+    'ai.error.payloadTooLarge': string;
+    'ai.error.modality': string;
+    'ai.error.busy': string;
+    'ai.error.unavailable': string;
+    'ai.error.signIn': string;
+    'ai.error.offline': string;
+    'ai.error.generic': string;
+}, Record<never, string>>;
+export declare const aiMessages: Readonly<{
+    'ai.state.loading': string;
+    'ai.state.streaming': string;
+    'ai.input.placeholder': string;
+    'ai.action.send': string;
+    'ai.action.cancel': string;
+    'ai.action.retry': string;
+    'ai.action.retryAt': string;
+    'ai.quota.remaining': string;
+    'ai.error.rateLimited': string;
+    'ai.error.premiumRequired': string;
+    'ai.error.blocked': string;
+    'ai.error.payloadTooLarge': string;
+    'ai.error.modality': string;
+    'ai.error.busy': string;
+    'ai.error.unavailable': string;
+    'ai.error.signIn': string;
+    'ai.error.offline': string;
+    'ai.error.generic': string;
+} & Record<never, string>>;
+export type AiMessageKey = keyof typeof aiMessages;
+export declare function aiMessage(key: AiMessageKey): string;
+/** The message key to show a user for an error. */
+export declare function messageKeyForError(error: AiError): AiMessageKey;
+//# sourceMappingURL=messageKeys.d.ts.map

package/lib/typescript/commonjs/diagnostics/messageKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageKeys.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/messageKeys.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;yBAsBvB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;0BAAwB,CAAC;AAEhD,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,UAAU,CAAC;AAEnD,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAEnD;AAsBD,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAE/D"}