@data-club/ai-hub 0.0.1

package/dist/components/internal/PasswordInput.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `<PasswordInput>` — internal helper used by `<DataClubAIHubLogin />` and
+ * `<DataClubAIHubChangePassword />` to render a password field with its own
+ * show/hide eye-icon toggle.
+ *
+ * The toggle is **per-field** (each input owns its own state) so a user
+ * can reveal one field while keeping another masked — useful for visually
+ * verifying a match between New and Confirm without exposing both at once.
+ *
+ * Not exported from the package (no JSDoc-required interface surfaces here);
+ * lives under `components/internal/` to make that explicit.
+ *
+ * @see ui-sketches/01-login.md — show_password_toggle
+ * @see ui-sketches/02-change-password.md — per-field toggle
+ */
+import { type ReactNode } from "react";
+/**
+ * Props for the internal `<PasswordInput>` helper.
+ */
+export interface PasswordInputProps {
+    /** Stable DOM id used by the label + `aria-describedby` if any. */
+    id: string;
+    /** Input value. */
+    value: string;
+    /** Change handler — receives the next plaintext value. */
+    onChange: (next: string) => void;
+    /** Native `name` attribute for autofill / form submission. */
+    name: string;
+    /** Native `autoComplete` value — caller picks per field. */
+    autoComplete?: string;
+    /** Placeholder text. Defaults to "••••••••". */
+    placeholder?: string;
+    /** Whether the input is disabled (e.g. during submit). */
+    disabled?: boolean;
+    /** Whether to autofocus on mount. */
+    autoFocus?: boolean;
+    /** Required field — mirrors HTML `required` for browser-side validation. */
+    required?: boolean;
+    /** `aria-label` for the toggle when the password is currently hidden. */
+    showAriaLabel: string;
+    /** `aria-label` for the toggle when the password is currently shown. */
+    hideAriaLabel: string;
+    /** BEM class for the wrapper `<div>` that holds the input + toggle. */
+    wrapperClassName: string;
+    /** BEM class for the `<input>` itself. */
+    inputClassName: string;
+    /** BEM class for the toggle `<button>`. */
+    toggleClassName: string;
+    /** Optional `data-testid` on the wrapper — used by RTL tests. */
+    testId?: string;
+}
+/**
+ * Renders a password field with a show/hide eye-icon toggle.
+ *
+ * The toggle is `type="button"` (not submit) and keyboard-accessible
+ * (Enter / Space activate without submitting the surrounding form).
+ *
+ * @param props - the input props.
+ * @returns the input + toggle pair.
+ */
+export declare function PasswordInput(props: PasswordInputProps): ReactNode;
+//# sourceMappingURL=PasswordInput.d.ts.map

package/dist/components/internal/PasswordInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PasswordInput.d.ts","sourceRoot":"","sources":["../../../src/components/internal/PasswordInput.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,gBAAgB,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAoDlE"}

package/dist/components/internal/PasswordInput.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `<PasswordInput>` — internal helper used by `<DataClubAIHubLogin />` and
+ * `<DataClubAIHubChangePassword />` to render a password field with its own
+ * show/hide eye-icon toggle.
+ *
+ * The toggle is **per-field** (each input owns its own state) so a user
+ * can reveal one field while keeping another masked — useful for visually
+ * verifying a match between New and Confirm without exposing both at once.
+ *
+ * Not exported from the package (no JSDoc-required interface surfaces here);
+ * lives under `components/internal/` to make that explicit.
+ *
+ * @see ui-sketches/01-login.md — show_password_toggle
+ * @see ui-sketches/02-change-password.md — per-field toggle
+ */
+import { useState } from "react";
+/**
+ * Renders a password field with a show/hide eye-icon toggle.
+ *
+ * The toggle is `type="button"` (not submit) and keyboard-accessible
+ * (Enter / Space activate without submitting the surrounding form).
+ *
+ * @param props - the input props.
+ * @returns the input + toggle pair.
+ */
+export function PasswordInput(props) {
+    const { id, value, onChange, name, autoComplete, placeholder = "••••••••", disabled, autoFocus, required, showAriaLabel, hideAriaLabel, wrapperClassName, inputClassName, toggleClassName, testId, } = props;
+    const [revealed, setRevealed] = useState(false);
+    return (_jsxs("div", { className: wrapperClassName, ...(testId !== undefined ? { "data-testid": testId } : {}), children: [_jsx("input", { id: id, type: revealed ? "text" : "password", value: value, onChange: (e) => onChange(e.target.value), name: name, ...(autoComplete !== undefined ? { autoComplete } : {}), placeholder: placeholder, disabled: disabled, autoFocus: autoFocus, required: required, className: inputClassName }), _jsx("button", { type: "button", className: toggleClassName, "aria-label": revealed ? hideAriaLabel : showAriaLabel, "aria-pressed": revealed, onClick: () => setRevealed((r) => !r), tabIndex: 0, children: _jsx(EyeIcon, { open: revealed }) })] }));
+}
+/**
+ * Inline eye icon. Two paths so the open / closed variants share weight
+ * and stroke caps without two `<svg>` trees.
+ *
+ * @param props - icon props.
+ * @param props.open - true → "show" (eye), false → "hide" (eye with slash).
+ */
+function EyeIcon(props) {
+    return (_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", width: "18", height: "18", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", focusable: "false", children: [_jsx("path", { d: "M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7S2 12 2 12z" }), _jsx("circle", { cx: "12", cy: "12", r: "3" }), !props.open ? _jsx("path", { d: "M3 3l18 18" }) : null] }));
+}
+//# sourceMappingURL=PasswordInput.js.map

package/dist/components/internal/PasswordInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PasswordInput.js","sourceRoot":"","sources":["../../../src/components/internal/PasswordInput.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAsCjD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EACJ,EAAE,EACF,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,WAAW,GAAG,UAAU,EACxB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,MAAM,GACP,GAAG,KAAK,CAAC;IAEV,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,OAAO,CACL,eACE,SAAS,EAAE,gBAAgB,KACvB,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAE3D,gBACE,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,EACpC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACzC,IAAI,EAAE,IAAI,KACN,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACxD,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,cAAc,GACzB,EACF,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,eAAe,gBACd,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,kBACtC,QAAQ,EACtB,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EACrC,QAAQ,EAAE,CAAC,YAGX,KAAC,OAAO,IAAC,IAAI,EAAE,QAAQ,GAAI,GACpB,IACL,CACP,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,OAAO,CAAC,KAAwB;IACvC,OAAO,CACL,eACE,KAAK,EAAC,4BAA4B,EAClC,OAAO,EAAC,WAAW,EACnB,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,GAAG,EACf,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,iBACV,MAAM,EAClB,SAAS,EAAC,OAAO,aAEjB,eAAM,CAAC,EAAC,kDAAkD,GAAG,EAC7D,iBAAQ,EAAE,EAAC,IAAI,EAAC,EAAE,EAAC,IAAI,EAAC,CAAC,EAAC,GAAG,GAAG,EAC/B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAM,CAAC,EAAC,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,IACzC,CACP,CAAC;AACJ,CAAC"}

package/dist/context/AIHubContext.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Internal React context shared by `<AIHubProvider>` + the `useAIHub` /
+ * `useAIHubAuth` hooks.
+ *
+ * Kept separate from `AIHubProvider.tsx` so the hooks can import the
+ * context object without pulling in the provider's component tree (and
+ * the JSX dependencies that come with it).
+ *
+ * @see SPECIFICATIONS.md §7.2 — provider + hooks
+ */
+import type { AgentSummary, AIHubClient, LoginResponse, PatchSessionOptions } from "../client/AIHubClient.js";
+import type { AIHubEffort } from "../client/AIHubClient.js";
+import type { AIHubAuthContext, AIHubFeatureToggles, AIHubMessage, AIHubRole, AIHubState, AIHubToolCallRecord, AIHubUser, Session } from "../types.js";
+/**
+ * The shape provided by `<AIHubProvider>` to its descendants. Hook
+ * implementations destructure this; consumers don't see it directly.
+ */
+export interface AIHubContextValue {
+    /** The underlying SDK — consumers can call any method directly. */
+    client: AIHubClient;
+    /** Currently authenticated user, or null when no valid token is present. */
+    user: AIHubUser | null;
+    /** Echoes `user.role` for convenience; null when unauthenticated. */
+    role: AIHubRole | null;
+    /** Deployment-wide context from `/auth/me`; null when unauthenticated. */
+    deployment: AIHubAuthContext["deployment"] | null;
+    /**
+     * True when the user must call `changePassword` before any other endpoint
+     * accepts the token. Forces the change-password screen to render under
+     * `AuthGate` (Step 8).
+     */
+    mustChangePassword: boolean;
+    /** Initialization state — `true` until the first `/auth/me` resolves. */
+    hydrating: boolean;
+    /**
+     * Logs in via `client.login`. Stores the token + refreshes auth state.
+     * Returns the underlying `LoginResponse` so callers (e.g. the auto-
+     * rendered `<DataClubAIHubLogin />`) can branch on `mustChangePassword`
+     * + read the just-authenticated `user` without waiting for the next
+     * render. Throws `AIHubRequestError` on failure (the caller decides UX).
+     */
+    login: (username: string, password: string) => Promise<LoginResponse>;
+    /**
+     * Clears the local token; calls `client.logout()` best-effort for the
+     * audit log. The state transitions to `user=null, role=null` so consumers
+     * route back to login.
+     */
+    logout: () => Promise<void>;
+    /**
+     * Calls `client.changePassword`; after success, refreshes `/auth/me` so
+     * `user` + `deployment` reflect the now-clearable `is_initial_password`
+     * flag.
+     */
+    changePassword: (currentPassword: string | null, newPassword: string) => Promise<void>;
+    /**
+     * Active turn's reducer state, driven by SSE events flowing from
+     * `client.streamChat()`. Re-derived from the persisted event log on
+     * reconnect (§7.5).
+     */
+    state: AIHubState;
+    /** Per-message reasoning effort (§7.4). Defaults to `"medium"`. */
+    effort: AIHubEffort;
+    /** Sets the per-message effort. Survives until changed. */
+    setEffort: (next: AIHubEffort) => void;
+    /**
+     * The ai-hub agents catalog visible to the caller (non-archived only,
+     * with caller-scoped `session_count`). Loaded once after authentication;
+     * refreshed via `refreshAgents()`.
+     */
+    agents: AgentSummary[];
+    /** True while the initial `/agents` request is in flight. */
+    agentsLoading: boolean;
+    /** Refetches `/agents` — e.g. after a new session was created. */
+    refreshAgents: () => Promise<void>;
+    /**
+     * The ai-hub agent the user has opened. `null` when on the agents
+     * picker. The sessions list + chat column read from this.
+     */
+    activeAgentId: string | null;
+    /**
+     * Opens an agent (transitions out of the agents picker) or clears the
+     * selection back to it (`null`).
+     */
+    setActiveAgent: (id: string | null) => void;
+    /**
+     * Sessions for the active agent + current user, ordered by
+     * `updated_at DESC`. Empty when no agent is open.
+     */
+    sessions: Session[];
+    /** True while the active agent's `/sessions` request is in flight. */
+    sessionsLoading: boolean;
+    /** Refetches `/sessions` for the active agent. */
+    refreshSessions: () => Promise<void>;
+    /**
+     * Whether the sessions list includes archived rows. Toggled by the
+     * `archived_filter_toggle` at the bottom of the panel.
+     */
+    includeArchivedSessions: boolean;
+    /** Sets the archived filter. */
+    setIncludeArchivedSessions: (next: boolean) => void;
+    /** The opened session id, or `null` if none. */
+    activeSessionId: string | null;
+    /** Opens a session (loads its message history). */
+    setActiveSession: (id: string | null) => void;
+    /**
+     * Creates a session via `POST /sessions` and selects it. `title` is
+     * required (1..80 chars). Rejected client-side on empty / oversize.
+     */
+    createSession: (title: string) => Promise<Session>;
+    /** Rename / archive a session via `PATCH /sessions/{id}`. */
+    patchSession: (id: string, patch: PatchSessionOptions) => Promise<Session>;
+    /**
+     * Messages for the active session. Loaded from
+     * `GET /sessions/{id}/messages` when `activeSessionId` changes; appended
+     * to during streaming. Empty when no session is active.
+     */
+    messages: AIHubMessage[];
+    /** True while the active session's message history is loading. */
+    messagesLoading: boolean;
+    /**
+     * In-progress assistant text — accumulating `assistant_delta`s for the
+     * currently-streaming turn. `null` when no turn is in flight.
+     */
+    streamingAssistantText: string | null;
+    /**
+     * In-progress reasoning text — accumulating `reasoning_delta`s for
+     * the currently-streaming turn. `null` when no reasoning is in
+     * flight. The live assistant bubble renders this via
+     * `<ReasoningView />`.
+     */
+    streamingReasoning: string | null;
+    /**
+     * In-progress tool calls — built up from `tool_call_started` /
+     * `tool_call_input_delta` / `tool_call_result` events. Empty when no
+     * tool is being invoked.
+     */
+    streamingToolCalls: ReadonlyArray<AIHubToolCallRecord>;
+    /**
+     * Sends `text` against the active session, opening an SSE stream. Throws
+     * if no session is active or the request fails before the stream opens.
+     */
+    sendMessage: (text: string) => Promise<void>;
+    /**
+     * Cancels the in-flight turn via `POST /chat/{turn_id}/cancel`.
+     * The server-side handler calls Letta's authoritative
+     * `agents.messages.cancel` API (which rolls back the in-progress
+     * step from the conversation history while preserving completed
+     * steps) and signals our runner to emit `stream_end{cancelled}`.
+     * The client deliberately DOES NOT abort the SSE iterator — it
+     * waits for the genuine terminal event so the post-stream
+     * canonicalize sees Letta's true final state.
+     */
+    stop: () => Promise<void>;
+    /**
+     * True from the moment the user clicks Stop until the in-flight
+     * turn's `stream_end` lands. UI-only flag; the state machine's
+     * `state.status` stays `running` for the brief "Stopping…" window
+     * because the server is server-authoritative for that. Drives the
+     * button label / disabled state in `<MessageInput>`.
+     */
+    isStoppingTurn: boolean;
+    /**
+     * Text to push into the input on the next render. Set by the post-
+     * stream-end branch when a cancel rolled back the user's message
+     * (single-step cancel: Letta deletes the entire turn including the
+     * user message). `<MessageInput>` reads it, populates the textarea,
+     * and clears via `consumePendingDraft()`.
+     */
+    pendingDraft: string | null;
+    /**
+     * Atomically reads + clears `pendingDraft` — used by `<MessageInput>`
+     * after it copies the value into its local textarea state. Returns
+     * the consumed value (or null if none was pending).
+     */
+    consumePendingDraft: () => string | null;
+    /**
+     * Returned by `sendMessage` when the stream fails before any `stream_end`
+     * fires (network drop, unrecoverable error). Plain message for the
+     * `--failed` modifier — Step 10 enriches with a Retry button.
+     */
+    lastTurnError: string | null;
+    /** Resolved theme (`light` | `dark`) — computed per §7.6 precedence. */
+    theme: "light" | "dark";
+    /**
+     * Flips the theme. Optimistic; reverts on server error
+     * (`theme_switcher_disabled` → server returned 409).
+     */
+    setTheme: (next: "light" | "dark") => Promise<void>;
+    /**
+     * Mirror of `deployment.theme_switcher_enabled`. When false, the
+     * `AIHub.ThemeSwitcher` primitive renders nothing.
+     */
+    themeSwitcherEnabled: boolean;
+    /**
+     * The deployment-wide UI feature toggles fetched from public
+     * `GET /feature-toggles` on mount. `null` while the request is in
+     * flight; thereafter the wire blob (possibly empty `{}`).
+     *
+     * Consumers should not branch on individual keys directly — use
+     * `useAffordanceFlags()` to compute the resolved flag stack with
+     * precedence ("server toggle > React prop > built-in default").
+     *
+     * @see SPECIFICATIONS.md §8.4
+     */
+    featureToggles: AIHubFeatureToggles | null;
+    /**
+     * Re-fetches the toggles blob. Called by the super-admin Settings
+     * page (Step 12) after a save so the saving super-admin sees the
+     * effect without a page reload.
+     */
+    refreshFeatureToggles: () => Promise<void>;
+}
+/**
+ * The React context object. Default value is `null` — every hook checks
+ * for null and throws a "Wrapped in `<AIHubProvider>`?" error in dev so
+ * misconfiguration surfaces immediately instead of cascading null-deref
+ * failures in components.
+ */
+export declare const aiHubContext: import("react").Context<AIHubContextValue | null>;
+//# sourceMappingURL=AIHubContext.d.ts.map

package/dist/context/AIHubContext.d.ts.map

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

package/dist/context/AIHubContext.js

@@ -0,0 +1,19 @@
+/**
+ * Internal React context shared by `<AIHubProvider>` + the `useAIHub` /
+ * `useAIHubAuth` hooks.
+ *
+ * Kept separate from `AIHubProvider.tsx` so the hooks can import the
+ * context object without pulling in the provider's component tree (and
+ * the JSX dependencies that come with it).
+ *
+ * @see SPECIFICATIONS.md §7.2 — provider + hooks
+ */
+import { createContext } from "react";
+/**
+ * The React context object. Default value is `null` — every hook checks
+ * for null and throws a "Wrapped in `<AIHubProvider>`?" error in dev so
+ * misconfiguration surfaces immediately instead of cascading null-deref
+ * failures in components.
+ */
+export const aiHubContext = createContext(null);
+//# sourceMappingURL=AIHubContext.js.map

package/dist/context/AIHubContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIHubContext.js","sourceRoot":"","sources":["../../src/context/AIHubContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAuOtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAC"}

package/dist/context/AIHubProvider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * `<AIHubProvider>` — root of every ai-hub React tree.
+ *
+ * Owns:
+ *
+ * - The shared `AIHubClient` instance (consumers call SDK methods through
+ *   `useAIHub().client`).
+ * - The JWT lifecycle: read from `tokenStorage` on mount, attempt `/auth/me`
+ *   to hydrate `user` + `deployment`; clear on logout; clear and route
+ *   back to login on any 401 from the server (§6.7 — no silent refresh).
+ * - The resolved theme: client-side precedence per §7.6, FOUC-avoided via
+ *   a cached value in `localStorage` applied on first paint.
+ * - Per-message reasoning effort state.
+ * - **Step 9 — chat state:** agents catalog, active agent, sessions list,
+ *   active session, message history, in-flight turn state (driven by the
+ *   §10 reducer over SSE events from `client.streamChat`), `sendMessage`,
+ *   `stop`. The state-aware affordance gates (TPM banner, theme switcher,
+ *   tool-call card, reasoning view) layer on top in Step 10.
+ *
+ * @see SPECIFICATIONS.md §7.2 — provider props
+ * @see SPECIFICATIONS.md §7.5 — state on the client
+ * @see SPECIFICATIONS.md §7.6 — theme resolution
+ * @see SPECIFICATIONS.md §6.7 — auth model
+ */
+import { type ReactNode } from "react";
+import { AIHubClient, type PatchSessionOptions } from "../client/AIHubClient.js";
+import type { TokenStorageMode, TokenStorage } from "../client/tokenStorage.js";
+import type { AIHubError } from "../types.js";
+import { type ResolvedTheme } from "./theme.js";
+/**
+ * Public props on `<AIHubProvider>`.
+ *
+ * `defaultTheme` is overridden by the deployment's `theme_default` once
+ * `/auth/me` resolves (server config wins — same rule as the §8.4 toggles).
+ */
+export interface AIHubProviderProps {
+    /**
+     * Base URL the ai-hub-server routes are mounted at. Typically
+     * `/api/ai-hub` in a per-customer wrapper.
+     */
+    baseUrl: string;
+    /** Custom `fetch`; defaults to `globalThis.fetch`. */
+    fetch?: typeof fetch;
+    /** Token storage mode or custom adapter. Defaults to `"localStorage"`. */
+    tokenStorage?: TokenStorageMode | TokenStorage;
+    /**
+     * Pre-built `AIHubClient`. When set, `baseUrl` / `fetch` / `tokenStorage`
+     * are ignored. Useful for tests that need to stub the SDK without going
+     * through the provider's lifecycle.
+     */
+    client?: AIHubClient;
+    /**
+     * Notification hook for top-level errors. Fired for transport and
+     * surfaced stream errors; not fired for normal stream `done` /
+     * `cancelled`. The provider does not render its own error UI.
+     */
+    onError?: (err: AIHubError) => void;
+    /**
+     * Fallback theme used when no `/auth/me` has resolved yet and the cache
+     * is empty. Server config (`theme_default`) wins after hydration.
+     */
+    defaultTheme?: ResolvedTheme;
+    /** The tree under the provider. */
+    children: ReactNode;
+}
+/**
+ * The provider component. Single instance per ai-hub mount — multiple
+ * mounts on the same page each manage their own auth state (this is the
+ * shape `defineWebComponent` ships).
+ *
+ * @param props - the provider props.
+ */
+export declare function AIHubProvider(props: AIHubProviderProps): ReactNode;
+export type { PatchSessionOptions };
+//# sourceMappingURL=AIHubProvider.d.ts.map

package/dist/context/AIHubProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIHubProvider.d.ts","sourceRoot":"","sources":["../../src/context/AIHubProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,WAAW,EAGX,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKhF,OAAO,KAAK,EAGV,UAAU,EAQX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AA0DpB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,gBAAgB,GAAG,YAAY,CAAC;IAC/C;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAk5BlE;AAED,YAAY,EAAE,mBAAmB,EAAE,CAAC"}