@ezychat/web 0.1.46 → 0.1.48

package/dist-lib/types/api/queries.d.ts

@@ -1,11 +1,13 @@
 import { type InfiniteData, type QueryClient } from '@tanstack/react-query';
-import { type CreateApiTokenBodyInput, type UpdateApiTokenBody, type Chat, type ChatListResponse, type ChatStatus, type Message, type MessageListResponse, type PatchUserBody, type Settings, type User } from '@ezychat/shared';
+import { type CreateApiTokenBodyInput, type UpdateApiTokenBody, type Chat, type ChatListResponse, type ChatStatus, type DirectoryUser, type InboxStatusPayload, type Message, type MessageListResponse, type PatchUserBody, type Settings, type WaStatus } from '@ezychat/shared';
 export interface ChatFilters {
     status?: ChatStatus;
     assigned: 'me' | 'none' | 'any';
     q?: string;
     /** customer tag filter */
     tag?: string;
+    /** One inbox (multi-inbox); unset = every inbox the user may open. */
+    inbox?: number;
 }
 export declare const qk: {
     me: readonly ["me"];
@@ -24,6 +26,7 @@ export declare const qk: {
     users: readonly ["users"];
     directory: readonly ["users", "directory"];
     wa: readonly ["wa"];
+    inboxes: readonly ["inboxes"];
     tunnel: readonly ["tunnel"];
     cloudflareSetup: readonly ["cloudflare-setup"];
     settings: readonly ["settings"];
@@ -65,6 +68,9 @@ export declare function useMe(): import("@tanstack/react-query").UseQueryResult<
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    aiAgentId?: number | undefined;
+    aiDeleted?: boolean | undefined;
+    inboxIds?: number[] | undefined;
 } | null, Error>;
 export declare function useSetupStatus(): import("@tanstack/react-query").UseQueryResult<{
     needsSetup: boolean;
@@ -86,6 +92,9 @@ export declare function useLogin(): import("@tanstack/react-query").UseMutationR
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    aiAgentId?: number | undefined;
+    aiDeleted?: boolean | undefined;
+    inboxIds?: number[] | undefined;
 } | null, Error, {
     username: string;
     password: string;
@@ -108,6 +117,9 @@ export declare function useSetMyLocale(): import("@tanstack/react-query").UseMut
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    aiAgentId?: number | undefined;
+    aiDeleted?: boolean | undefined;
+    inboxIds?: number[] | undefined;
 }, Error, "en" | "ms" | "zh-CN" | null, unknown>;
 export declare function useChangePassword(): import("@tanstack/react-query").UseMutationResult<unknown, Error, {
     currentPassword: string;
@@ -116,6 +128,8 @@ export declare function useChangePassword(): import("@tanstack/react-query").Use
 export declare function useChats(filters: ChatFilters): import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<{
     chats: {
         jid: string;
+        inboxId: number;
+        waJid: string;
         type: "dm" | "group";
         name: string;
         avatarUrl: string | null;
@@ -134,6 +148,8 @@ export declare function useChats(filters: ChatFilters): import("@tanstack/react-
 export declare function useChat(jid: string | null | undefined): import("@tanstack/react-query").UseQueryResult<{
     chat: {
         jid: string;
+        inboxId: number;
+        waJid: string;
         type: "dm" | "group";
         name: string;
         avatarUrl: string | null;
@@ -300,6 +316,8 @@ export declare function useRetryMessage(): import("@tanstack/react-query").UseMu
 }, Error, string, unknown>;
 export declare function usePatchChat(jid: string): import("@tanstack/react-query").UseMutationResult<{
     jid: string;
+    inboxId: number;
+    waJid: string;
     type: "dm" | "group";
     name: string;
     avatarUrl: string | null;
@@ -448,9 +466,12 @@ export declare function useUsers(opts?: {
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    aiAgentId?: number | undefined;
+    aiDeleted?: boolean | undefined;
+    inboxIds?: number[] | undefined;
 }[], Error>;
 /** Public team-member fields every logged-in user may see (`GET /api/users/directory`). */
-export type DirectoryUser = Pick<User, 'id' | 'displayName' | 'role' | 'disabled' | 'kind' | 'aiRole'>;
+export type { DirectoryUser };
 /**
  * Team directory for every role (agents included). Needs the server route
  * `GET /api/users/directory`; when it is missing (404) or forbidden, resolves to an empty list
@@ -458,7 +479,17 @@ export type DirectoryUser = Pick<User, 'id' | 'displayName' | 'role' | 'disabled
  */
 export declare function useUserDirectory(opts?: {
     enabled?: boolean;
-}): import("@tanstack/react-query").UseQueryResult<DirectoryUser[], Error>;
+}): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    displayName: string;
+    role: "admin" | "agent";
+    disabled: boolean;
+    inboxIds: "all" | number[];
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+    aiAgentId?: number | undefined;
+    aiDeleted?: boolean | undefined;
+}[], Error>;
 export declare function useCreateUser(): import("@tanstack/react-query").UseMutationResult<{
     id: number;
     username: string;
@@ -470,6 +501,9 @@ export declare function useCreateUser(): import("@tanstack/react-query").UseMuta
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    aiAgentId?: number | undefined;
+    aiDeleted?: boolean | undefined;
+    inboxIds?: number[] | undefined;
 }, Error, {
     username: string;
     displayName: string;
@@ -487,6 +521,9 @@ export declare function usePatchUser(): import("@tanstack/react-query").UseMutat
     locale: "en" | "ms" | "zh-CN" | null;
     kind?: "human" | "ai" | undefined;
     aiRole?: "sales" | undefined;
+    aiAgentId?: number | undefined;
+    aiDeleted?: boolean | undefined;
+    inboxIds?: number[] | undefined;
 }, Error, {
     id: number;
     patch: PatchUserBody;
@@ -507,6 +544,44 @@ export declare function useWaStatus(opts?: {
     qr: string | null;
     lastError: string | null;
 }, Error>;
+/** The inbox 1 number (the number linked before multi-inbox). */
+export declare const PRIMARY_INBOX_ID = 1;
+/**
+ * The inboxes the signed-in user may open (`GET /api/inboxes`; the server filters them). A server
+ * without the route (404) counts as one inbox, so no inbox UI shows.
+ */
+export declare function useInboxes(opts?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<{
+    inboxes: {
+        id: number;
+        name: string;
+        tone: "success" | "primary" | "warning" | "info";
+        number: string | null;
+        status: {
+            state: "open" | "qr" | "disconnected" | "connecting" | "logged_out" | "replaced" | "blocked";
+            me: {
+                jid: string;
+                name: string | null;
+                lid?: string | null | undefined;
+            } | null;
+            qr: string | null;
+            lastError: string | null;
+        };
+        removed: boolean;
+        aiAgentId: number | null;
+        memberIds?: number[] | undefined;
+    }[];
+    maxInboxes: number;
+    canAdd: boolean;
+}, Error>;
+/** Applies a socket `inbox:status` to the cached inbox list. */
+export declare function patchInboxStatusInCache(qc: QueryClient, p: InboxStatusPayload): void;
+/**
+ * Connection status of one inbox. Inbox 1 reads `GET /api/wa/status` as before (Lite unchanged);
+ * other inboxes read the inbox list, which `inbox:status` keeps current.
+ */
+export declare function useInboxStatus(inboxId: number | undefined): WaStatus | undefined;
 export type WaAction = 'logout' | 'relink' | 'takeover';
 export declare function useWaAction(): import("@tanstack/react-query").UseMutationResult<unknown, Error, WaAction, unknown>;
 /** Link by phone number: returns the 8-character code to enter in WhatsApp → Linked devices. */

package/dist-lib/types/extensions/agent-section.d.ts

@@ -0,0 +1,18 @@
+import { type ReactNode } from 'react';
+import type { AiAgentPreset } from '@ezychat/shared';
+/** The AI agent whose page an extension section (`agentSections`) is rendered on. */
+export interface AgentSectionInfo {
+    agentId: number;
+    displayName: string;
+    preset: AiAgentPreset;
+}
+/** Wraps the extension sections of one agent page (core use only). */
+export declare function AgentSectionProvider({ value, children, }: {
+    value: AgentSectionInfo;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Inside an `agentSections` element: the agent whose page shows it (id, saved name and preset).
+ * Null anywhere else.
+ */
+export declare function useAgentSection(): AgentSectionInfo | null;

package/dist-lib/types/extensions/index.d.ts

@@ -2,3 +2,4 @@ export * from './types';
 export { WebExtensionsProvider, useWebExtensions } from './context';
 export { registerExtensionCatalogs, useExtensionTranslation, type ExtensionTranslate, } from './i18n';
 export { ExtensionBoundary, extensionRoutes } from './routes';
+export { AgentSectionProvider, useAgentSection, type AgentSectionInfo } from './agent-section';

package/dist-lib/types/extensions/types.d.ts

@@ -36,7 +36,7 @@ export interface WebExtensionRoute {
     section?: WebExtensionAdminSection;
 }
 /** Core admin sections an extension admin route may sit under (the `ADMIN_NAV` paths). */
-export declare const WEB_EXTENSION_ADMIN_SECTIONS: readonly ["members", "quick-replies", "whatsapp", "tunnel", "settings", "audit"];
+export declare const WEB_EXTENSION_ADMIN_SECTIONS: readonly ["members", "quick-replies", "whatsapp", "inboxes", "tunnel", "settings", "audit"];
 export type WebExtensionAdminSection = (typeof WEB_EXTENSION_ADMIN_SECTIONS)[number];
 /** A small badge on an admin nav link: a count, or a dot that asks for attention. */
 export interface WebExtensionNavBadge {

package/dist-lib/types/i18n/resources.d.ts

@@ -149,6 +149,8 @@ export declare const enResources: {
             noInstallerFeed: string;
             unverifiedFeed: string;
             releaseNotes: string;
+            whatsNew: string;
+            updatedTo: string;
         };
         share: {
             title: string;
@@ -531,6 +533,7 @@ export declare const enResources: {
                 ai_unavailable: string;
                 lookup_failed: string;
                 business_rule: string;
+                confidential_leak: string;
             };
             resolved: string;
             reopenedByMessage: string;
@@ -628,6 +631,7 @@ export declare const enResources: {
         waBanner: {
             settingsShort: string;
             openSettings: string;
+            openInboxes: string;
             connecting: {
                 title: string;
                 body: string;
@@ -652,6 +656,19 @@ export declare const enResources: {
                 title: string;
                 body: string;
             };
+            inbox: {
+                connecting: string;
+                disconnected: string;
+                qr: string;
+                loggedOut: string;
+                replaced: string;
+                blocked: string;
+            };
+        };
+        inboxFilter: {
+            label: string;
+            all: string;
+            option: string;
         };
         phoneLink: {
             label: string;
@@ -994,6 +1011,13 @@ export declare const enResources: {
                 apiTokenAuthFailed: string;
                 mcpEnable: string;
                 mcpDisable: string;
+                inboxCreate: string;
+                inboxUpdate: string;
+                inboxRemove: string;
+                inboxAccessUpdate: string;
+                aiAgentCreate: string;
+                aiAgentDelete: string;
+                aiAgentInboxUpdate: string;
             };
             fields: {
                 chat: string;
@@ -1033,6 +1057,12 @@ export declare const enResources: {
                 lanEnabled: string;
                 historyDays: string;
                 expires: string;
+                inbox: string;
+                inboxes: string;
+                members: string;
+                agent: string;
+                preset: string;
+                internal: string;
             };
             reasons: {
                 rateLimited: string;
@@ -1378,7 +1408,6 @@ export declare const enResources: {
             settingsTitle: string;
             settingsDescription: string;
             roleBadge: string;
-            addMember: string;
             membersDescription: string;
             assistant: string;
             behavior: string;
@@ -1478,6 +1507,14 @@ export declare const enResources: {
                 advanced: string;
                 advancedRecommended: string;
                 advancedCustomised: string;
+                nextSteps: {
+                    title: string;
+                    context: string;
+                    try: string;
+                    turnOn: string;
+                    done: string;
+                    todo: string;
+                };
             };
             try: {
                 label: string;
@@ -1500,6 +1537,12 @@ export declare const enResources: {
                 noKnowledge: string;
                 model: string;
                 failed: string;
+                agentHint: string;
+                safety: string;
+                answeredAs: string;
+                needsConnection: string;
+                noRole: string;
+                confidentialLeak: string;
             };
             voice: {
                 title: string;
@@ -1583,10 +1626,39 @@ export declare const enResources: {
                 confirmText: string;
                 deleteFailed: string;
                 namesMore: string;
+                internal: string;
+                internalHint: string;
+                internalIntro: string;
+                internalBadgeTitle: string;
+                internalFilterLabel: string;
+                internalFilterAll: string;
+                internalFilterCustomer: string;
+                internalFilterInternal: string;
+                internalFilterEmpty: string;
+                internalAudience: string;
+                internalAudienceCustomer: string;
+                internalAudienceInternal: string;
+                internalTotal: string;
+                addFileTitle: string;
+                fileLabel: string;
+                itemSaved: string;
+                actions: string;
+                markInternal: string;
+                markCustomer: string;
+                markInternalFor: string;
+                markCustomerFor: string;
+                markedInternal: string;
+                markedCustomer: string;
             };
             defaults: {
-                instructions: string;
-                handoffRules: string;
+                sales: {
+                    instructions: string;
+                    handoffRules: string;
+                };
+                faq: {
+                    instructions: string;
+                    handoffRules: string;
+                };
             };
             replaceKey: string;
             keepKey: string;
@@ -1653,6 +1725,92 @@ export declare const enResources: {
                 keyForbidden: string;
                 saveAnyway: string;
             };
+            agents: {
+                add: string;
+                aiBadge: string;
+                limitHint: string;
+                noInbox: string;
+                answersInbox: string;
+                newTitle: string;
+                newDescription: string;
+                description: string;
+                pickTitle: string;
+                pickHint: string;
+                nameTitle: string;
+                nameLabel: string;
+                nameHint: string;
+                nameRequired: string;
+                inboxLabel: string;
+                inboxHint: string;
+                inboxNone: string;
+                inboxHas: string;
+                inboxMove: string;
+                roleTitle: string;
+                roleLabel: string;
+                roleHint: string;
+                rolePlaceholder: string;
+                handoffTitle: string;
+                handoffHint: string;
+                handoffPlaceholder: string;
+                useTemplate: string;
+                templateTitle: string;
+                templateBody: string;
+                templateConfirm: string;
+                templateApplied: string;
+                customTemplateNote: string;
+                advanced: string;
+                advancedBlank: string;
+                usingTemplate: string;
+                tryTitle: string;
+                deleteTitle: string;
+                deleteHint: string;
+                delete: string;
+                deleteConfirmTitle: string;
+                deleteConfirmBody_one: string;
+                deleteConfirmBody_other: string;
+                deleted: string;
+                created: string;
+                saved: string;
+                save: string;
+                create: string;
+                limitTitle: string;
+                limitBody: string;
+                limitBodyLite: string;
+                backToMembers: string;
+                notFoundTitle: string;
+                notFoundBody: string;
+                on: string;
+                off: string;
+                errors: {
+                    agent_limit: string;
+                    inbox_has_agent: string;
+                    internal_too_large: string;
+                    last_agent: string;
+                    agent_not_found: string;
+                };
+                noFreeInbox: string;
+                addInbox: string;
+                createNext: string;
+            };
+            presets: {
+                sales: string;
+                faq: string;
+                custom: string;
+                salesDescription: string;
+                faqDescription: string;
+                customDescription: string;
+                badge: string;
+            };
+            guardrails: {
+                title: string;
+                badge: string;
+                intro: string;
+                rule1: string;
+                rule2: string;
+                rule3: string;
+                rule4: string;
+            };
+            openAgents: string;
         };
         enrichment: {
             title: string;
@@ -1694,6 +1852,67 @@ export declare const enResources: {
                 correction: string;
             };
         };
+        inboxes: {
+            title: string;
+            add: string;
+            emptyTitle: string;
+            emptyBody: string;
+            description: string;
+            edit: string;
+            remove: string;
+            status: string;
+            whoCanOpen: string;
+            admin: string;
+            accessHint: string;
+            typeLinkedPhone: string;
+            numberAfterScan: string;
+            limitReached: string;
+            membersField: string;
+            membersFieldHint: string;
+            membersFieldNoAgents: string;
+            membersFieldNone: string;
+            removeTitle: string;
+            removeConfirm: string;
+            removeBodyPhone: string;
+            removed: string;
+            required: string;
+            saved: string;
+            createdPhone: string;
+            addTitle: string;
+            editTitle: string;
+            dialogDescription: string;
+            save: string;
+            name: string;
+            nameHint: string;
+            scanTitle: string;
+            scanBody: string;
+            scanSteps: string;
+            linkedAs: string;
+            relink: string;
+            offlineTitle: string;
+            offlineBody: string;
+            state: {
+                connected: string;
+                waiting_scan: string;
+                phone_offline: string;
+            };
+            membersAccess: string;
+            membersAccessAll: string;
+            membersAccessNone: string;
+            membersAccessTitle: string;
+            membersAccessDescription: string;
+            membersAccessNoInboxes: string;
+            membersAccessSave: string;
+            membersAccessSaved: string;
+            aiAgent: string;
+            aiAgentNone: string;
+            aiAgentField: string;
+            aiAgentFieldHint: string;
+            aiAgentOption: string;
+            aiAgentMove: string;
+            aiAgentReplace: string;
+            aiAgentRemove: string;
+        };
     };
     errors: {
         generic: string;

package/dist-lib/types/inbox/ChatFilters.d.ts

@@ -1,6 +1,9 @@
+import type { Inbox } from '@ezychat/shared';
 import { type ChatFilters as Filters } from '../api/queries';
 export interface ChatFiltersProps {
     value: Filters;
     onChange(next: Filters): void;
+    /** The active inboxes the user may open; the inbox filter shows with two or more. */
+    inboxes?: readonly Inbox[];
 }
-export declare function ChatFilters({ value, onChange }: ChatFiltersProps): import("react").JSX.Element;
+export declare function ChatFilters({ value, onChange, inboxes }: ChatFiltersProps): import("react").JSX.Element;

package/dist-lib/types/inbox/ChatListItem.d.ts

@@ -1,4 +1,4 @@
-import type { Chat } from '@ezychat/shared';
+import type { Chat, Inbox } from '@ezychat/shared';
 export interface ChatListItemProps {
     chat: Chat;
     active: boolean;
@@ -6,8 +6,10 @@ export interface ChatListItemProps {
     assigneeName: string | null;
     /** The current user owns this chat: the chip gets the accent outline. */
     assignedToMe?: boolean;
+    /** The chat's inbox, only while the user sees two or more inboxes. */
+    inbox?: Pick<Inbox, 'name' | 'tone'>;
 }
 export declare function GroupIcon({ className }: {
     className?: string;
 }): import("react").JSX.Element;
-export declare function ChatListItem({ chat, active, assigneeName, assignedToMe, }: ChatListItemProps): import("react").JSX.Element;
+export declare function ChatListItem({ chat, active, assigneeName, assignedToMe, inbox, }: ChatListItemProps): import("react").JSX.Element;

package/dist-lib/types/inbox/ConversationHeader.d.ts

@@ -1,4 +1,4 @@
-import type { Chat } from '@ezychat/shared';
+import type { Chat, Inbox } from '@ezychat/shared';
 import type { Directory } from './useDirectory';
 export interface ConversationHeaderProps {
     chat: Chat;
@@ -20,6 +20,8 @@ export interface ConversationHeaderProps {
     onOpenInfo?(): void;
     /** Group chats: WhatsApp's member count, shown under the name once known. */
     memberCount?: number | null;
+    /** The chat's inbox, only while the user sees two or more inboxes (replies leave from it). */
+    inbox?: Pick<Inbox, 'name' | 'tone'>;
     busy?: boolean;
 }
-export declare function ConversationHeader({ chat, directory, onBack, onAssign, onToggleStatus, notesOpen, notesCount, onToggleNotes, showCustomer, customerOpen, onToggleCustomer, onOpenInfo, memberCount, busy, }: ConversationHeaderProps): import("react").JSX.Element;
+export declare function ConversationHeader({ chat, directory, onBack, onAssign, onToggleStatus, notesOpen, notesCount, onToggleNotes, showCustomer, customerOpen, onToggleCustomer, onOpenInfo, memberCount, inbox, busy, }: ConversationHeaderProps): import("react").JSX.Element;

package/dist-lib/types/inbox/InboxChip.d.ts

@@ -0,0 +1,6 @@
+import type { Inbox } from '@ezychat/shared';
+/** The inbox a chat belongs to, in that inbox's colour (shown only with two or more inboxes). */
+export declare function InboxChip({ inbox, className, }: Readonly<{
+    inbox: Pick<Inbox, 'name' | 'tone'>;
+    className?: string;
+}>): import("react").JSX.Element;

package/dist-lib/types/inbox/WaBanner.d.ts

@@ -4,6 +4,11 @@ type WaStateName = WaStatus['state'];
 export declare function waQueuesMessages(state: WaStateName | undefined): boolean;
 /** States where sending is pointless until an admin acts (composer disabled). */
 export declare function waSendingBlocked(state: WaStateName | undefined): boolean;
-/** Top-of-inbox banner shown whenever the WhatsApp connection isn't open. */
+/**
+ * Top-of-inbox banner shown whenever a WhatsApp connection isn't open. With one inbox (Lite) it is
+ * today's single banner; with two or more visible inboxes there is one per inbox that is not open,
+ * titled with that inbox's name. A user who sees one inbox other than inbox 1 gets that inbox's
+ * banner (named, never inbox 1's state); with several inboxes and none visible there is no banner.
+ */
 export declare function WaBanner(): import("react").JSX.Element | null;
 export {};

package/dist-lib/types/inbox/useDirectory.d.ts

@@ -1,18 +1,40 @@
 import type { User } from '@ezychat/shared';
 import { type DirectoryUser } from '../api/queries';
+/**
+ * A team member as the inbox knows them: the directory row (agents), or the full user (admins read
+ * `GET /api/users`, where `inboxIds` is set for agents only). No `inboxIds` means every inbox only
+ * in a single-inbox install; with several inboxes it means no inbox (fail closed).
+ */
+export type DirectoryEntry = Omit<DirectoryUser, 'inboxIds'> & {
+    inboxIds?: DirectoryUser['inboxIds'];
+};
+/**
+ * The member may open chats of this inbox (admins and the AI member open every inbox). A row without
+ * `inboxIds` opens every inbox only when `multiInbox` is false (one inbox, no inbox UI).
+ */
+export declare function canOpenInbox(u: DirectoryEntry, inboxId: number, multiInbox?: boolean): boolean;
 export interface Directory {
     me: User | null;
     isAdmin: boolean;
-    byId: Map<number, DirectoryUser>;
-    /** Users that can be picked as assignee (active only). */
-    assignable: DirectoryUser[];
+    byId: Map<number, DirectoryEntry>;
+    /** Users that can be picked as assignee (active only; never a deleted AI agent). */
+    assignable: DirectoryEntry[];
+    /**
+     * The assign dropdown of a chat of this inbox: active people who may open it, and the AI agent
+     * that answers this inbox (no other AI agent: the server refuses it).
+     */
+    assignableFor(inboxId: number): DirectoryEntry[];
     /** Display name for a user id ("You" for the current user when `youLabel`). */
     nameOf(id: number | null | undefined, opts?: {
         youLabel?: boolean;
     }): string | null;
 }
 /** Pure builder (exported for tests). */
-export declare function buildDirectory(me: User | null, isAdmin: boolean, list: readonly DirectoryUser[] | undefined): Directory;
+export declare function buildDirectory(me: User | null, isAdmin: boolean, list: readonly DirectoryEntry[] | undefined, opts?: {
+    multiInbox?: boolean;
+    /** Inbox id -> the AI agent that answers it (`Inbox.aiAgentId`); unknown = no AI offered. */
+    inboxAgents?: ReadonlyMap<number, number | null>;
+}): Directory;
 /**
  * Team member lookup for the inbox. Admins use the full `GET /api/users`; every other role
  * uses the public `GET /api/users/directory` ({id, displayName, role, disabled}). Ids that are

package/dist-lib/types/inbox/useVisibleInboxes.d.ts

@@ -0,0 +1,12 @@
+import type { Inbox } from '@ezychat/shared';
+export { useInboxStatus } from '../api/queries';
+/**
+ * The active inboxes the signed-in user may open. The server already filters `GET /api/inboxes` by
+ * access, so there is no access logic here; removed inboxes (admins only) are left out.
+ */
+export declare function useVisibleInboxes(): Inbox[];
+/**
+ * The inbox chip of a chat: the chat's inbox while the user sees two or more inboxes, otherwise
+ * undefined (one inbox and Lite show no chip). Removed inboxes still name their read-only chats.
+ */
+export declare function useInboxOfChat(): (inboxId: number) => Inbox | undefined;

package/dist-lib/types/index.d.ts

@@ -3,7 +3,7 @@
  * without forking Lite or deep-importing its modules.
  */
 export { createInboxApp, type CreateInboxAppOptions } from './create-app';
-export { EXTENSION_NAME_PATTERN, WEB_EXTENSION_ADMIN_SECTIONS, WebExtensionError, extensionKeyPrefix, extensionPath, useExtensionTranslation, validateWebExtensions, type ExtensionTranslate, type WebExtension, type WebExtensionAdminSection, type WebExtensionAgent, type WebExtensionAgentSection, type WebExtensionCatalogs, type WebExtensionLockScreenProps, type WebExtensionNavBadge, type WebExtensionNavItem, type WebExtensionRoute, type WebExtensionSettingsSection, } from './extensions';
+export { EXTENSION_NAME_PATTERN, WEB_EXTENSION_ADMIN_SECTIONS, WebExtensionError, extensionKeyPrefix, extensionPath, useAgentSection, useExtensionTranslation, validateWebExtensions, type AgentSectionInfo, type ExtensionTranslate, type WebExtension, type WebExtensionAdminSection, type WebExtensionAgent, type WebExtensionAgentSection, type WebExtensionCatalogs, type WebExtensionLockScreenProps, type WebExtensionNavBadge, type WebExtensionNavItem, type WebExtensionRoute, type WebExtensionSettingsSection, } from './extensions';
 export { useAppLinks } from './lib/app-links';
 export { LITE_APP_LINKS, type AppLinks } from './lib/links';
 export { PausedScreen } from './access/AccessGate';

package/dist-lib/types/lib/whatsapp-format.d.ts

@@ -0,0 +1,5 @@
+import type React from 'react';
+/** A message body as WhatsApp shows it (React nodes for a `whitespace-pre-wrap` element). */
+export declare function formatWhatsApp(text: string): React.ReactNode[];
+/** The same text without the marks WhatsApp hides, for one-line previews (quotes, chat list). */
+export declare function plainWhatsApp(text: string): string;