@bcrumbs.net/inbox 0.0.63 → 0.0.65

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bcrumbs.net/inbox",
   "description": "Inbox widget for Bread Crumbs portals",
-  "version": "0.0.63",
+  "version": "0.0.65",
   "keyword": [
     "bcrumbs",
     "bc-ui",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@bcrumbs.net/bc-shared": "^0.0.11",
-    "@bcrumbs.net/bc-ui": "^0.0.16",
+    "@bcrumbs.net/bc-ui": "^0.0.17",
     "@bcrumbs.net/bc-api": "^0.0.49",
     "@azure/storage-blob": "^12.25.0"
   },

package/playwright.config.d.ts

@@ -1,7 +1,3 @@
-/**
- * Read environment variables from file.
- * https://github.com/motdotla/dotenv
- */
 /**
  * See https://playwright.dev/docs/test-configuration.
  */

package/src/app/ai/components/Crumby/CrumbyChatError.d.ts

@@ -0,0 +1,9 @@
+import { type FC } from 'react';
+export type CrumbyChatErrorProps = {
+    rtl: boolean;
+    onClose: () => void;
+    /** Starts a fresh chat session in place of the crashed one. */
+    onRestart: () => void;
+};
+/** Shown in the Crumby panel when the chat crashed, instead of blanking the portal. */
+export declare const CrumbyChatError: FC<CrumbyChatErrorProps>;

package/src/app/ai/components/Crumby/CrumbyChatErrorBoundary.d.ts

@@ -0,0 +1,13 @@
+import { type ReactElement, type ReactNode } from 'react';
+type RenderFallback = (resetError: () => void) => ReactElement | null;
+type CrumbyChatErrorBoundaryProps = {
+    /** Rendered after a crash (null while the panel is closed); `resetError` remounts the children, i.e. a fresh chat runtime. */
+    renderFallback: RenderFallback;
+    children: ReactNode;
+};
+/**
+ * Keeps a Crumby chat render crash (e.g. assistant-ui losing a message mid-render after a
+ * failed run) inside the chat panel instead of unmounting the whole portal into a white page.
+ */
+export declare const CrumbyChatErrorBoundary: ({ renderFallback, children }: CrumbyChatErrorBoundaryProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/src/app/ai/components/Crumby/CrumbyHeader.d.ts

@@ -0,0 +1,9 @@
+import { type FC } from 'react';
+export type CrumbyHeaderProps = {
+    rtl: boolean;
+    onClose: () => void;
+    /** When set, shows a back arrow (e.g. back to the onboarding checklist). */
+    onBack?: () => void;
+};
+/** Crumby panel header: optional back arrow, brand, close button. */
+export declare const CrumbyHeader: FC<CrumbyHeaderProps>;

package/src/app/ai/components/Crumby/CrumbyPageContext.d.ts

@@ -0,0 +1,22 @@
+import { type MutableRefObject } from 'react';
+import type { PromptSectionChange, PromptSectionsUpdateResult, PromptState } from '../../config/promptSettings';
+/** Lets Crumby read and edit the Prompt settings form while that page is mounted. */
+export type PromptEditorBridge = {
+    getSections: () => PromptState;
+    applyChanges: (changes: PromptSectionChange[]) => PromptSectionsUpdateResult;
+};
+type CrumbyPageContextValue = {
+    /** Ref (not state) so the chat transport always reads the latest page values at send time. */
+    promptEditorRef: MutableRefObject<PromptEditorBridge | null>;
+    isPromptEditorActive: boolean;
+    registerPromptEditor: (bridge: PromptEditorBridge) => () => void;
+    /** Increments on every open request; the widget opens its chat when it changes. */
+    openRequestId: number;
+    requestOpen: () => void;
+};
+/** Shares page-level state between portal pages and the Crumby widget mounted in the layout. */
+export declare const CrumbyPageProvider: ({ children }: {
+    children: React.ReactNode;
+}) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const useCrumbyPageContext: () => CrumbyPageContextValue;
+export {};

package/src/app/ai/components/Crumby/CrumbyRuntimeProvider.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+type CrumbyRuntimeProviderProps = {
+    api: string;
+    userId?: string;
+    children: React.ReactNode;
+};
+/** Chat runtime for the Crumby widget, wired to the crumby-assist gateway endpoint. */
+export declare const CrumbyRuntimeProvider: ({ api, userId, children }: CrumbyRuntimeProviderProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/src/app/ai/components/CrumbySettings/CrumbyEditsBanner.d.ts

@@ -0,0 +1,14 @@
+import type { PromptKey } from '../../config/promptSettings';
+type CrumbyEditsBannerProps = {
+    editedSections: PromptKey[];
+    canUndo: boolean;
+    onUndo: () => void;
+    onDiscard: () => void;
+    onSave: () => void;
+    saveDisabled: boolean;
+    saving: boolean;
+    rtl?: boolean;
+};
+/** Tells the user Crumby changed prompt sections and offers save / undo / discard. */
+declare const CrumbyEditsBanner: ({ editedSections, canUndo, onUndo, onDiscard, onSave, saveDisabled, saving, rtl, }: CrumbyEditsBannerProps) => import("@emotion/react/jsx-runtime").JSX.Element | null;
+export default CrumbyEditsBanner;

package/src/app/ai/components/CrumbySettings/VoiceSettingsSection.d.ts

@@ -0,0 +1,9 @@
+type Props = {
+    language: string;
+    voiceId: string;
+    voiceName: string;
+    onLanguageChange: (language: string) => void;
+    onVoiceChange: (voiceId: string, voiceName: string) => void;
+};
+declare const VoiceSettingsSection: ({ language, voiceId, voiceName, onLanguageChange, onVoiceChange }: Props) => import("@emotion/react/jsx-runtime").JSX.Element;
+export default VoiceSettingsSection;

package/src/app/ai/components/playground/Button.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
 declare const buttonVariants: (props?: ({
-    variant?: "outline" | "default" | "ghost" | null | undefined;
+    variant?: "default" | "outline" | "ghost" | null | undefined;
     size?: "default" | "icon" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 declare function Button({ className, variant, size, asChild, ...props }: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {

package/src/app/ai/components/playground/ThreadMessages.d.ts

@@ -1,6 +1,8 @@
 type ThreadMessagesProps = {
     /** Overrides the container padding (defaults to 24px) when the parent already provides some (e.g. Crumby ChatView surface). */
     padding?: string;
+    /** Overrides the message-text size for the compact Crumby chat (e.g. `TextSizeRem.XS`). Unset in the playground. */
+    fontSize?: string;
 };
-declare const ThreadMessages: ({ padding }: ThreadMessagesProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const ThreadMessages: ({ padding, fontSize }: ThreadMessagesProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default ThreadMessages;

package/src/app/ai/components/playground/TooltipIconButton.d.ts

@@ -5,7 +5,7 @@ export type TooltipIconButtonProps = ComponentPropsWithoutRef<typeof Button> & {
     side?: "top" | "bottom" | "left" | "right";
 };
 export declare const TooltipIconButton: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLButtonElement> & import("react").ButtonHTMLAttributes<HTMLButtonElement> & import("class-variance-authority").VariantProps<(props?: ({
-    variant?: "outline" | "default" | "ghost" | null | undefined;
+    variant?: "default" | "outline" | "ghost" | null | undefined;
     size?: "default" | "icon" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string> & {
     asChild?: boolean | undefined;

package/src/app/ai/components/sources/mediaTypeForFile.d.ts

@@ -0,0 +1,8 @@
+import { MediaType } from '../../../../graphql.autogenerated';
+interface UploadType {
+    mediaType: MediaType;
+    contentType: string;
+}
+export declare function uploadTypeForFile(fileName: string): UploadType;
+export declare function fileWithContentType(file: File, contentType: string): File;
+export {};

package/src/app/ai/config/promptSettings.d.ts

@@ -0,0 +1,31 @@
+import type { ConfigurationsInput } from '../../../graphql.autogenerated';
+export type PromptKey = 'contextPrompt' | 'rolePrompt' | 'personaPrompt' | 'workflowPrompt' | 'constraints';
+export type PromptState = Record<PromptKey, string>;
+export type PromptSectionChange = {
+    section: PromptKey;
+    value: string;
+};
+export type PromptSectionsUpdateResult = {
+    ok: true;
+    updatedSections: PromptKey[];
+} | {
+    ok: false;
+    error: string;
+};
+export declare const PROMPT_FIELDS: PromptKey[];
+export declare const PROMPT_CHARACTER_LIMITS: Record<PromptKey, number>;
+export declare const EMPTY_PROMPTS: PromptState;
+/** Must match PROMPT_EDITOR_PAGE / UPDATE_PROMPT_SECTIONS_TOOL in the bot's crumby-assistance prompt editor. */
+export declare const PROMPT_EDITOR_PAGE = "aiPromptSettings";
+export declare const UPDATE_PROMPT_SECTIONS_TOOL = "updatePromptSections";
+export declare const isPromptKey: (value: unknown) => value is PromptKey;
+export declare const getPromptState: (configuration?: {
+    contextPrompt?: string | null | undefined;
+    rolePrompt?: string | null | undefined;
+    personaPrompt?: string | null | undefined;
+    workflowPrompt?: string | null | undefined;
+    constraints?: string | null | undefined;
+} | null | undefined) => PromptState;
+export declare const getPromptConfigurationInput: (prompts: PromptState) => Pick<ConfigurationsInput, PromptKey>;
+/** Validates Crumby's proposed section changes; returns an error message the model can act on, or null. */
+export declare const validatePromptSectionChanges: (changes: unknown) => string | null;

package/src/app/ai/hooks/usePromptCopilot.d.ts

@@ -0,0 +1,22 @@
+import { type Dispatch, type SetStateAction } from 'react';
+import { type PromptKey, type PromptState } from '../config/promptSettings';
+type UsePromptCopilotOptions = {
+    prompts: PromptState;
+    setPrompts: Dispatch<SetStateAction<PromptState>>;
+    /** Last saved values; a new object here (save / refetch) resets Crumby's edit history. */
+    savedPrompts: PromptState;
+    /** Register with Crumby only once the saved values are loaded, so loading can't overwrite edits. */
+    enabled: boolean;
+};
+/**
+ * Connects the Prompt settings form to Crumby: Crumby's edits land as unsaved changes
+ * that the user can save, undo step by step, revert per section, or discard.
+ */
+declare const usePromptCopilot: ({ prompts, setPrompts, savedPrompts, enabled }: UsePromptCopilotOptions) => {
+    crumbyEditedSections: PromptKey[];
+    canUndo: boolean;
+    undoLast: () => void;
+    revertSection: (key: PromptKey) => void;
+    discardAll: () => void;
+};
+export default usePromptCopilot;

package/src/app/ai/tools/PromptEditorTool.d.ts

@@ -0,0 +1,2 @@
+/** Registers the client-executed tool that writes Crumby's edits into the Prompt settings form. */
+export declare const PromptEditorTool: () => null;

package/src/app/ai/types/index.d.ts

@@ -43,7 +43,7 @@ export interface SourcesSummary {
         size: number;
     };
 }
-export type SupportedFileType = 'TXT' | 'MD' | 'JSON' | 'HTML';
+export type SupportedFileType = 'TXT' | 'MD' | 'JSON' | 'HTML' | 'PDF';
 export interface FileValidationResult {
     isValid: boolean;
     error?: string;

package/src/app/ai/utils/clientToolResubmit.d.ts

@@ -0,0 +1,8 @@
+import { type UIMessage } from 'ai';
+/**
+ * `sendAutomaticallyWhen` for the Crumby chat: resubmit only after our client tool produced its output.
+ * Server tools finish inside the same request, so resubmitting for them would loop.
+ */
+export declare const shouldResubmitAfterClientTool: ({ messages }: {
+    messages: UIMessage[];
+}) => boolean;

package/src/app/ai/utils/crumbyChatFetch.d.ts

@@ -0,0 +1,15 @@
+type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+type CrumbyChatFetchOptions = {
+    /** Token for each request; defaults to the live Clerk JWT, falling back to the stored token. */
+    getToken?: () => Promise<string | null | undefined>;
+    /** Forced refresh used once after a 401. */
+    refreshToken?: () => Promise<string | null>;
+    fetchImpl?: FetchFn;
+};
+/**
+ * Fetch for the Crumby chat transport. The chat runtime is created once and outlives the
+ * short-lived (~60s) Clerk JWT, so the token is read per request instead of being baked
+ * into the transport headers. A 401 gets one retry with a force-refreshed token.
+ */
+export declare const createCrumbyChatFetch: ({ getToken, refreshToken, fetchImpl, }?: CrumbyChatFetchOptions) => FetchFn;
+export {};

package/src/app/auth/components/AcceptInvitation.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/src/app/auth/components/AuthLanguagePicker.d.ts

@@ -0,0 +1,3 @@
+/** Top-corner language control for unauthenticated auth screens. */
+export declare function AuthLanguagePicker(): import("@emotion/react/jsx-runtime").JSX.Element;
+export default AuthLanguagePicker;

package/src/app/auth/components/AuthVisualCarousel.d.ts

@@ -0,0 +1 @@
+export declare const AuthVisualCarousel: () => import("@emotion/react/jsx-runtime").JSX.Element;

package/src/app/auth/components/ClerkSessionBridge.d.ts

@@ -2,6 +2,10 @@
  * Keeps localStorage.token in sync with the Clerk session JWT so Apollo handleAuth
  * and BCRoutesGuard continue to work without per-client changes.
  *
+ * Clerk session *tokens* stay short-lived (~60s default). The Clerk *session*
+ * (cookie) is configured for 30 days in the Clerk Dashboard. This bridge refreshes
+ * the JWT in place and does not treat JWT expiry as logout.
+ *
  * Prefer the AspNetUsers id returned by /auth/authorize so the rest of the portal
  * keeps seeing the same user id shape as legacy login.
  *

package/src/app/auth/components/password-page/AuthPasswordPageLayout.d.ts

@@ -2,6 +2,8 @@ import { ReactNode } from 'react';
 type AuthPasswordPageLayoutProps = {
     children: ReactNode;
     backgroundImage?: string;
+    cardMaxWidth?: number;
+    showLanguagePicker?: boolean;
 };
-export declare function AuthPasswordPageLayout({ children, backgroundImage }: AuthPasswordPageLayoutProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function AuthPasswordPageLayout({ children, backgroundImage, cardMaxWidth, showLanguagePicker, }: AuthPasswordPageLayoutProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export {};

package/src/app/auth/components/password-page/PasswordSuccessView.d.ts

@@ -3,6 +3,7 @@ type PasswordSuccessViewProps = {
     subtitle: string;
     actionLabel?: string;
     onAction?: () => void;
+    hideIcon?: boolean;
 };
-export declare function PasswordSuccessView({ title, subtitle, actionLabel, onAction }: PasswordSuccessViewProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function PasswordSuccessView({ title, subtitle, actionLabel, onAction, hideIcon }: PasswordSuccessViewProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export {};

package/src/app/auth/config/authProvider.d.ts

@@ -1,4 +1,13 @@
 import type { AuthProvider } from '../../../environments/types';
+export declare const CLERK_ENABLED_FLAG = "clerk_enabled";
+/**
+ * Pin the Clerk JS bundle to one version so the main script and the lazy chunks
+ * it loads always come from the same build. Without a pin, clerk-react asks the
+ * CDN for the floating `@5` script while that script requests version-pinned
+ * chunks; any drift makes the chunk fetch fail with ChunkLoadError. Keep this at
+ * the latest Clerk JS v5, which matches @clerk/clerk-react v5.
+ */
+export declare const CLERK_JS_VERSION = "5.127.2";
 /**
  * Selects the frontend auth UI provider. Runtime window._env_ overrides build-time
  * environment so deployments can flip without a rebuild.
@@ -6,7 +15,16 @@ import type { AuthProvider } from '../../../environments/types';
 export declare function getAuthProvider(): AuthProvider;
 export declare function getClerkPublishableKey(): string | undefined;
 /**
- * Clerk UI is only mounted when selected and a publishable key is present, matching
- * the auth service's isClerkEnabled() gate.
+ * Clerk UI is mounted when a publishable key is present and the PostHog
+ * `clerk_enabled` boolean flag is true. Without PostHog, falls back to AUTH_PROVIDER.
  */
 export declare function isClerkAuthEnabled(): boolean;
+export type ClerkAuthGate = {
+    ready: boolean;
+    enabled: boolean;
+};
+/**
+ * Subscribes to PostHog feature flags so Clerk vs legacy UI updates when
+ * `clerk_enabled` loads or changes. When PostHog is off, `ready` is immediate.
+ */
+export declare function useClerkAuthEnabled(): ClerkAuthGate;