@chipmobilesdk/rn-ai 0.4.0 → 0.5.0

package/lib/typescript/commonjs/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @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';
+export type { AiClient, AiClientConfig, AiBehaviorState, TokenProvider, AccessTokenRequestOptions, ChatRequest, ChatMessage, ContentPart, ChatStreamHandlers, ChatHandle, Usage, QuotaSnapshot, } from './core/aiClient';
+export type { AppBehaviorConfig, AiConfigCache, BehaviorState } from './config/behaviorConfig';
+export { configCacheFromKeyValue, SUPPORTED_SCHEMA_VERSION } from './config/behaviorConfig';
+export type { GatewayErrorCode, GatewayErrorBody, GatewayQuota, GatewayStreamEvent, GatewayUsage, QuotaHeaderName, QuotaHeaderNames, } from './contract/gateway';
+export { GATEWAY_ERROR_STATUS, QUOTA_HEADERS, SSE_DONE_SENTINEL } from './contract/gateway';
+export type { AiTimeouts } from './transport/timeouts';
+export type { SseRequest, SseHandlers, SseHandle, SseResponseInfo, StreamTransport, } from './transport/sseClient';
+export { useAiBehaviorState, useAiChat, useAiQuota } from './react/hooks';
+export type { AiChatStatus, UseAiChatOptions, UseAiChatResult, UseAiQuotaResult, } from './react/hooks';
+export { AiError, isAiError } from './diagnostics/errors';
+export type { AiErrorCode } from './diagnostics/errors';
+export { aiMessage, aiMessageSet, aiMessages, messageKeyForError } from './diagnostics/messageKeys';
+export type { AiMessageKey } from './diagnostics/messageKeys';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EACX,QAAQ,EACR,cAAc,EACd,eAAe,EACf,aAAa,EACb,yBAAyB,EACzB,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,KAAK,EACL,aAAa,GACb,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAI5F,YAAY,EACX,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5F,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,eAAe,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpG,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/lib/typescript/commonjs/package.json

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

package/lib/typescript/commonjs/react/hooks.d.ts

@@ -0,0 +1,37 @@
+import type { AiBehaviorState, AiClient, ChatRequest, QuotaSnapshot } from '../core/aiClient';
+import type { AiError } from '../diagnostics/errors';
+export type AiChatStatus = 'idle' | 'loading' | 'streaming' | 'done' | 'error' | 'rate-limited';
+export interface UseAiChatResult {
+    send(request: ChatRequest): void;
+    cancel(): void;
+    status: AiChatStatus;
+    /** Accumulated streamed text, flushed on an interval rather than per token. */
+    text: string;
+    error?: AiError;
+    retryAt?: Date;
+    quota?: QuotaSnapshot;
+}
+export interface UseAiChatOptions {
+    /**
+     * How often the accumulated text reaches the screen, in milliseconds.
+     *
+     * A model streams 30–100 tokens a second, and a render per token is 30–100
+     * renders of the whole transcript a second on the JS thread (PERF-12). At the
+     * default a long answer costs about 20 renders a second instead, and the last
+     * tokens are always flushed with the terminal state. `0` renders per token.
+     */
+    flushIntervalMs?: number;
+}
+export declare function useAiChat(client: AiClient, options?: UseAiChatOptions): UseAiChatResult;
+export interface UseAiQuotaResult {
+    quota?: QuotaSnapshot;
+    status: 'loading' | 'ready' | 'error';
+    refresh(): void;
+}
+export declare function useAiQuota(client: AiClient): UseAiQuotaResult;
+/**
+ * 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 declare function useAiBehaviorState(client: AiClient): AiBehaviorState;
+//# sourceMappingURL=hooks.d.ts.map

package/lib/typescript/commonjs/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,eAAe,EACf,QAAQ,EAER,WAAW,EACX,aAAa,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAChC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA2G3F;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACtC,OAAO,IAAI,IAAI,CAAC;CAChB;AAgBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,CAqC7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,eAAe,CAEpE"}

package/lib/typescript/commonjs/transport/sseClient.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ */
+export interface SseRequest {
+    url: string;
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    /** JSON string body for POST requests. */
+    body?: string;
+    /** Hard limit on the whole request. Rarely right for a stream; prefer the two below. */
+    timeoutMs?: number;
+    /** Fails with `onError(0, 'timeout')` if response headers have not arrived by then. */
+    connectTimeoutMs?: number;
+    /** Fails with `onError(0, 'timeout')` when no chunk arrives for this long. Reset per chunk. */
+    idleTimeoutMs?: number;
+}
+/** What the response said besides its body. Absent for a failure with no response. */
+export interface SseResponseInfo {
+    /** A response header, or null. `Retry-After` is the one this package reads. */
+    getHeader(name: string): string | null;
+}
+export interface SseHandlers {
+    /** One call per `data:` event payload (raw string, already de-framed). */
+    onData(payload: string): void;
+    /** Stream closed normally (transport level; `[DONE]` handling is the caller's). */
+    onEnd(): void;
+    /** Transport or HTTP error. `status` is 0 for network failures. */
+    onError(status: number, bodyText: string, response?: SseResponseInfo): void;
+}
+export interface SseHandle {
+    cancel(): void;
+}
+/**
+ * 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.
+ */
+export type StreamTransport = (request: SseRequest, handlers: SseHandlers) => SseHandle;
+/**
+ * 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 declare function drainSseEvents(text: string, fromIndex: number, emit: (payload: string) => void): number;
+export declare function requestSse(request: SseRequest, handlers: SseHandlers): SseHandle;
+//# sourceMappingURL=sseClient.d.ts.map

package/lib/typescript/commonjs/transport/sseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseClient.d.ts","sourceRoot":"","sources":["../../../../src/transport/sseClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+FAA+F;IAC/F,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC/B,+EAA+E;IAC/E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC3B,0EAA0E;IAC1E,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mFAAmF;IACnF,KAAK,IAAI,IAAI,CAAC;IACd,mEAAmE;IACnE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,KAAK,SAAS,CAAC;AAExF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,MAAM,CAiBR;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,SAAS,CA0GhF"}

package/lib/typescript/commonjs/transport/timeouts.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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.
+ */
+export interface AiTimeouts {
+    /** Request sent → response headers received, for the chat stream. */
+    connectMs: number;
+    /** Longest silence allowed between two chunks of the chat stream. */
+    idleMs: number;
+    /** Behavior-config fetch, including reading the body. */
+    configMs: number;
+    /** Quota fetch, including reading the body. */
+    quotaMs: number;
+}
+/**
+ * The gateway sends headers only once the model has answered, so `connectMs`
+ * also covers time to first token on a large image prompt.
+ */
+export declare const DEFAULT_AI_TIMEOUTS: AiTimeouts;
+/**
+ * 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 declare function withTimeout<T>(ms: number, run: (signal: AbortSignal | undefined) => Promise<T>, onTimeout: () => Error): Promise<T>;
+//# sourceMappingURL=timeouts.d.ts.map

package/lib/typescript/commonjs/transport/timeouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.d.ts","sourceRoot":"","sources":["../../../../src/transport/timeouts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IAC1B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAKjC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EACpD,SAAS,EAAE,MAAM,KAAK,GACpB,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/lib/typescript/module/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/module/config/behaviorConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviorConfig.d.ts","sourceRoot":"","sources":["../../../../src/config/behaviorConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAKlG,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,iBAAiB,EAAE,OAAO,CAAA;KAAE,CAAC;IACvE,aAAa,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,QAAQ,EAAE;QACT,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CACjC;AAED,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,qBAAa,iBAAkB,YAAW,aAAa;IACtD,OAAO,CAAC,GAAG,CAA6B;IAClC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAGxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CASzE;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,eAAe,GAAG,aAAa,GAAG,aAAa,CAAC;AAEzF,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAiB1C,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKjD;AASD,MAAM,WAAW,0BAA0B;IAC1C,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,0BAA+B,GACtC,iBAAiB,CAmEnB;AAQD,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IA+BrB,OAAO,CAAC,IAAI;IA9BxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAyD;IACzE;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2C;IACxE,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAE1D,wDAAwD;IACxD,IAAI,KAAK,IAAI,aAAa,CAEzB;IAED,+CAA+C;IAC/C,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI3C,OAAO,CAAC,QAAQ;gBAMI,IAAI,EAAE,kBAAkB;IAY5C,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,aAAa;YAIP,SAAS;IAavB,OAAO,CAAC,YAAY;IAIpB,0EAA0E;YAC5D,SAAS;YAuBT,gBAAgB;YA6BhB,OAAO;IAIrB;;;;OAIG;IACG,SAAS,CAAC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAgBpF"}

package/lib/typescript/module/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/module/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/module/core/aiClient.d.ts

@@ -0,0 +1,104 @@
+import { type Scheduler } from '@chipmobilesdk/rn-core';
+import { type AiConfigCache, type BehaviorState } from '../config/behaviorConfig.js';
+import { type GatewayQuota, type GatewayUsage } from '../contract/gateway.js';
+import { AiError } from '../diagnostics/errors.js';
+import { type StreamTransport } from '../transport/sseClient.js';
+import { type AiTimeouts } from '../transport/timeouts.js';
+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/module/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/module/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.js';
+import { AiError } from '../diagnostics/errors.js';
+import { type AiTimeouts } from '../transport/timeouts.js';
+/** 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/module/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,6BAA0B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAAuB,CAAC;AAChD,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,0BAAuB,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/module/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/module/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/module/diagnostics/messageKeys.d.ts

@@ -0,0 +1,46 @@
+import type { AiError } from './errors.js';
+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/module/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,aAAU,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"}

package/lib/typescript/module/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @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 type { AiClient, AiClientConfig, AiBehaviorState, TokenProvider, AccessTokenRequestOptions, ChatRequest, ChatMessage, ContentPart, ChatStreamHandlers, ChatHandle, Usage, QuotaSnapshot, } from './core/aiClient.js';
+export type { AppBehaviorConfig, AiConfigCache, BehaviorState } from './config/behaviorConfig.js';
+export { configCacheFromKeyValue, SUPPORTED_SCHEMA_VERSION } from './config/behaviorConfig.js';
+export type { GatewayErrorCode, GatewayErrorBody, GatewayQuota, GatewayStreamEvent, GatewayUsage, QuotaHeaderName, QuotaHeaderNames, } from './contract/gateway.js';
+export { GATEWAY_ERROR_STATUS, QUOTA_HEADERS, SSE_DONE_SENTINEL } from './contract/gateway.js';
+export type { AiTimeouts } from './transport/timeouts.js';
+export type { SseRequest, SseHandlers, SseHandle, SseResponseInfo, StreamTransport, } from './transport/sseClient.js';
+export { useAiBehaviorState, useAiChat, useAiQuota } from './react/hooks.js';
+export type { AiChatStatus, UseAiChatOptions, UseAiChatResult, UseAiQuotaResult, } from './react/hooks.js';
+export { AiError, isAiError } from './diagnostics/errors.js';
+export type { AiErrorCode } from './diagnostics/errors.js';
+export { aiMessage, aiMessageSet, aiMessages, messageKeyForError } from './diagnostics/messageKeys.js';
+export type { AiMessageKey } from './diagnostics/messageKeys.js';
+//# sourceMappingURL=index.d.ts.map