@ezychat/web 0.1.46 → 0.1.48

package/dist-lib/types/admin/AdminLayout.d.ts

@@ -1,6 +1,9 @@
 import { type LucideIcon } from 'lucide-react';
 import { type WebExtension, type WebExtensionAdminSection } from '../extensions';
-/** `labelKey` is a translation key in the `admin` namespace. */
+/**
+ * Every core admin section. `labelKey` is a translation key in the `admin` namespace. WhatsApp and
+ * Inboxes never show together: see `visibleAdminNav`.
+ */
 export declare const ADMIN_NAV: readonly [{
     readonly to: "members";
     readonly labelKey: "nav.members";
@@ -13,6 +16,10 @@ export declare const ADMIN_NAV: readonly [{
     readonly to: "whatsapp";
     readonly labelKey: "nav.whatsapp";
     readonly icon: LucideIcon;
+}, {
+    readonly to: "inboxes";
+    readonly labelKey: "inboxes.title";
+    readonly icon: LucideIcon;
 }, {
     readonly to: "tunnel";
     readonly labelKey: "nav.tunnel";
@@ -26,6 +33,12 @@ export declare const ADMIN_NAV: readonly [{
     readonly labelKey: "nav.audit";
     readonly icon: LucideIcon;
 }];
+export type AdminNavItem = (typeof ADMIN_NAV)[number];
+/**
+ * The sections in the nav: **Inboxes** replaces **WhatsApp** only in an edition that allows more than
+ * one WhatsApp number (Lite allows one, so it keeps WhatsApp).
+ */
+export declare function visibleAdminNav(multiInbox: boolean): AdminNavItem[];
 /** The core section an extension admin route declares for this path (e.g. `members`). */
 export declare function extensionSectionOf(extensions: readonly WebExtension[], pathname: string): WebExtensionAdminSection | undefined;
 /**

package/dist-lib/types/admin/AiContextPanel.d.ts

@@ -1,11 +1,16 @@
+import type { TFunction } from 'i18next';
 import { type AiDocument } from '@ezychat/shared';
+/** An AI agent API error in the admin's language (`ai.agents.errors.*`); others as usual. */
+export declare function agentErrorMessage(error: unknown, t: TFunction<'admin'>): string;
 /**
- * Business context as a list of items (uploaded files and text content), like a project
- * knowledge panel: search, multi-select delete, and Add ▾ (upload or text). Items belong to the
- * AI member, so `ensureMember` saves a draft member first when there is none yet.
+ * The Business context of ONE agent as a list of items (uploaded files and text content), like a
+ * project knowledge panel: search, the Internal filter, multi-select delete, and Add ▾ (upload or
+ * text). An Internal item helps the agent decide and is never told to customers.
  */
-export declare function AiContextPanel({ documents, ensureMember, disabled, }: {
+export declare function AiContextPanel({ agentId, documents, disabled, }: {
+    agentId: number;
     documents: AiDocument[];
-    ensureMember: () => Promise<boolean>;
     disabled?: boolean;
 }): import("react").JSX.Element;
+/** "Internal" badge: used to decide, never told to customers. */
+export declare function InternalBadge(): import("react").JSX.Element;

package/dist-lib/types/admin/AiEditDialog.d.ts

@@ -1,13 +1,17 @@
-import { type AiEditField } from '@ezychat/shared';
+import { type AiAgentPreset, type AiEditField } from '@ezychat/shared';
 /**
  * Edit with AI: the admin describes a change to one box, reviews the suggested rewrite as a line
  * diff and applies it to the page's draft. Applying never saves; the page's Save does.
  */
-export declare function AiEditDialog({ field, current, open, onOpenChange, onApply, }: {
+export declare function AiEditDialog({ field, current, open, onOpenChange, onApply, agentId, preset, }: {
     field: AiEditField;
     /** The box's current (possibly unsaved) text. */
     current: string;
     open: boolean;
     onOpenChange: (open: boolean) => void;
     onApply: (text: string) => void;
+    /** The agent whose Business context informs the rewrite (none: the inbox-1 agent). */
+    agentId?: number;
+    /** The agent's preset, so a FAQ agent is not pushed toward sales. */
+    preset?: AiAgentPreset;
 }): import("react").JSX.Element;

package/dist-lib/types/admin/AiMemberPage.d.ts

@@ -1 +1,7 @@
+/**
+ * Members ▸ AI agent: `/admin/members/ai/:agentId` edits one agent; `/admin/members/ai/new?preset=`
+ * creates one. Name, starting point, Business context (with Internal items), Try it, the role and
+ * hand-over rules, the fixed safety rules, and in an edition with several inboxes the inbox and
+ * Delete.
+ */
 export declare function AiMemberPage(): import("react").JSX.Element;

package/dist-lib/types/admin/AiTryIt.d.ts

@@ -1,8 +1,13 @@
 import type { AiKnowledgeDraft } from './ai-status';
 /**
  * Asks the AI a test question with the page's current (possibly unsaved) name and instructions;
- * the server answers from the saved Business context items.
+ * the server answers from the saved Business context items of `agentId` (none: the inbox-1 agent).
+ * `ready` false: the AI connection does not work yet, so asking is off.
  */
-export declare function AiTryIt({ draft }: {
+export declare function AiTryIt({ draft, agentId, ready, onAnswered, }: {
     draft: AiKnowledgeDraft;
+    agentId?: number;
+    ready?: boolean;
+    /** Called after the model answered a test question (the agent page's Next steps). */
+    onAnswered?: () => void;
 }): import("react").JSX.Element;

package/dist-lib/types/admin/InboxAccess.d.ts

@@ -0,0 +1,9 @@
+import type { Inbox, User } from '@ezychat/shared';
+/**
+ * Members → Inbox access: which inboxes a member may open. Admins always see every inbox; an agent
+ * sees only the chats (and notifications) of the inboxes ticked here. `inboxes` are the active ones.
+ */
+export declare function InboxAccessCell({ user, inboxes }: Readonly<{
+    user: User;
+    inboxes: Inbox[];
+}>): import("react").JSX.Element;

package/dist-lib/types/admin/InboxesPage.d.ts

@@ -0,0 +1,3 @@
+import type React from 'react';
+/** Every linked WhatsApp number (inbox), with who may open it. Admin only; shown when maxInboxes > 1. */
+export declare function InboxesPage(): React.JSX.Element;

package/dist-lib/types/admin/PresetBadge.d.ts

@@ -0,0 +1,8 @@
+import { type LucideIcon } from 'lucide-react';
+import type { AiAgentPreset } from '@ezychat/shared';
+/** The icon of each agent preset (picker, badges). */
+export declare const PRESET_ICON: Record<AiAgentPreset, LucideIcon>;
+/** "Sales agent", "FAQ agent", "Custom agent". */
+export declare function PresetBadge({ preset }: Readonly<{
+    preset: AiAgentPreset;
+}>): import("react").JSX.Element;

package/dist-lib/types/admin/agent-path.d.ts

@@ -0,0 +1,6 @@
+import type { AiMemberStatus } from '@ezychat/shared';
+/**
+ * Where "set up the AI agent" links go: the only agent's page, a new agent while there is none, or
+ * Members (which lists every agent) when there are several.
+ */
+export declare function aiAgentsPath(status: Pick<AiMemberStatus, 'agents'>): string;

package/dist-lib/types/admin/ai-status.d.ts

@@ -1,4 +1,5 @@
-import type { AiDocument, AiMemberStatus, AiSettings } from '@ezychat/shared';
+import type { TFunction } from 'i18next';
+import { type AiAgentPreset, type AiDocument, type AiMemberStatus, type AiSettings } from '@ezychat/shared';
 /** Only the official ChatGPT sign-in hosts may be opened from the app. */
 export declare function officialLoginUrl(raw: string | null): string | null;
 /** The saved connection can answer customers right now. */
@@ -10,3 +11,16 @@ export type AiKnowledgeDraft = Pick<AiSettings, 'displayName' | 'instructions'>
 export declare function hasKnowledge(documents: readonly AiDocument[]): boolean;
 export type AiPill = 'off' | 'on' | 'needsConnection' | 'needsKnowledge';
 export declare function memberPill(status: AiMemberStatus): AiPill;
+export type PresetTexts = {
+    instructions: string;
+    handoffRules: string;
+};
+type PresetField = keyof PresetTexts;
+/** A preset's starting texts in the admin's language (`ai.defaults.<preset>.*`); Custom is blank. */
+export declare function presetDefaults(preset: AiAgentPreset, t: TFunction<'admin'>): PresetTexts;
+/**
+ * True when `text` is an unedited starting text of any preset: the English one the server keeps,
+ * or the copy in any language whose catalog is loaded. A blank text is never a default.
+ */
+export declare function isPresetDefault(text: string, field: PresetField): boolean;
+export {};

package/dist-lib/types/admin/inbox-status.d.ts

@@ -0,0 +1,16 @@
+import type { WaState } from '@ezychat/shared';
+import type { StatusTone } from '../components/app';
+/** What the inbox card says next to its status: scan the QR code, or the phone is offline. */
+export type InboxNotice = 'scan' | 'offline' | 'replaced' | null;
+export interface InboxCardStatus {
+    tone: StatusTone;
+    /** Translation key in the `admin` namespace. */
+    labelKey: string;
+    notice: InboxNotice;
+    /** The phone must scan a QR code (or enter a pairing code) before the inbox works. */
+    needsLink: boolean;
+}
+/** WhatsApp connection state of one inbox → the status its card shows. */
+export declare function inboxCardStatus(state: WaState): InboxCardStatus;
+/** Phone-number digits from WhatsApp (`60112233445`) → `+60112233445`; anything else as it is. */
+export declare function formatInboxNumber(number: string | null): string | null;

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

@@ -1,4 +1,6 @@
-import { type AiMemberBody, type AiConnectionBody, type AiContextPatchBody, type AiContextTextBody, type AiEditBody } from '@ezychat/shared';
+import { type QueryClient } from '@tanstack/react-query';
+import { z } from 'zod';
+import { type AiAgentBody, type AiMemberBody, type AiConnectionBody, type AiContextPatchBody, type AiContextTextBody, type AiEditBody } from '@ezychat/shared';
 export declare const aiMemberKey: readonly ["ai-member"];
 export declare function useAiMember(): import("@tanstack/react-query").UseQueryResult<{
     member: {
@@ -12,6 +14,9 @@ export declare function useAiMember(): import("@tanstack/react-query").UseQueryR
         locale: "en" | "ms" | "zh-CN" | null;
         kind?: "human" | "ai" | undefined;
         aiRole?: "sales" | undefined;
+        aiAgentId?: number | undefined;
+        aiDeleted?: boolean | undefined;
+        inboxIds?: number[] | undefined;
     } | null;
     settings: {
         displayName: string;
@@ -36,7 +41,18 @@ export declare function useAiMember(): import("@tanstack/react-query").UseQueryR
         characters: number;
         createdAt: number;
         updatedAt: number;
+        internal: boolean;
     }[];
+    agents: {
+        id: number;
+        userId: number;
+        displayName: string;
+        enabled: boolean;
+        preset: "sales" | "custom" | "faq";
+        inboxId: number | null;
+        documentCount: number;
+    }[];
+    maxAgents: number;
 }, Error>;
 /** One Business context item with its text (full for text items, a preview for files). */
 export declare function useAiDocument(id: number | null): import("@tanstack/react-query").UseQueryResult<{
@@ -47,6 +63,7 @@ export declare function useAiDocument(id: number | null): import("@tanstack/reac
     characters: number;
     createdAt: number;
     updatedAt: number;
+    internal: boolean;
     text: string;
     truncated: boolean;
 }, Error>;
@@ -64,14 +81,17 @@ export declare function useAiTest(): import("@tanstack/react-query").UseMutation
     reply: string | null;
     error: string | null;
 }, Error, void, unknown>;
-/** Try it: answers from the page's current knowledge; never touches chats or WhatsApp. */
+/**
+ * Try it: answers from the page's current knowledge; never touches chats or WhatsApp. With
+ * `agentId` the answer uses that agent's saved items (and its path); without, the inbox-1 agent.
+ */
 export declare function useAiTry(): import("@tanstack/react-query").UseMutationResult<{
     ok: boolean;
     reply: string | null;
     action: "answer" | "ask_resolution" | "resolve" | "handoff" | "no_reply" | null;
     model: string | null;
     error: string | null;
-    handoffReason?: "asked_for_human" | "missing_facts" | "sensitive" | "needs_action" | "business_rule" | "unsupported_message" | "ai_unavailable" | "lookup_failed" | null | undefined;
+    handoffReason?: "asked_for_human" | "missing_facts" | "sensitive" | "needs_action" | "business_rule" | "unsupported_message" | "ai_unavailable" | "lookup_failed" | "confidential_leak" | null | undefined;
     lookups?: {
         title: string;
         sourceLabel: string;
@@ -87,10 +107,13 @@ export declare function useAiTry(): import("@tanstack/react-query").UseMutationR
         instructions: string;
         handoffRules?: string | undefined;
     };
+    agentId?: number | undefined;
 }, unknown>;
-/** Edit with AI: a suggested rewrite of one box; nothing is saved (the page's Save does that). */
-/** Edit with AI. Pass a signal so closing the popup stops the (paid) model call. */
-export declare function useAiEdit(): import("@tanstack/react-query").UseMutationResult<{
+/**
+ * Edit with AI: a suggested rewrite of one box; nothing is saved (the page's Save does that).
+ * Pass a signal so closing the popup stops the (paid) model call. `agentId`: whose items inform it.
+ */
+export declare function useAiEdit(agentId?: number): import("@tanstack/react-query").UseMutationResult<{
     ok: boolean;
     text: string | null;
     error: string | null;
@@ -146,6 +169,9 @@ export declare function useAiMemberAction(): import("@tanstack/react-query").Use
         locale: "en" | "ms" | "zh-CN" | null;
         kind?: "human" | "ai" | undefined;
         aiRole?: "sales" | undefined;
+        aiAgentId?: number | undefined;
+        aiDeleted?: boolean | undefined;
+        inboxIds?: number[] | undefined;
     } | null;
     settings: {
         displayName: string;
@@ -170,5 +196,167 @@ export declare function useAiMemberAction(): import("@tanstack/react-query").Use
         characters: number;
         createdAt: number;
         updatedAt: number;
+        internal: boolean;
+    }[];
+    agents: {
+        id: number;
+        userId: number;
+        displayName: string;
+        enabled: boolean;
+        preset: "sales" | "custom" | "faq";
+        inboxId: number | null;
+        documentCount: number;
     }[];
+    maxAgents: number;
 }, Error, AiMemberAction, unknown>;
+/** `GET /api/ai/agents` and `DELETE /api/ai/agents/:agentId`: every agent and the edition limit. */
+export declare const AiAgentList: z.ZodObject<{
+    agents: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        userId: z.ZodNumber;
+        displayName: z.ZodString;
+        enabled: z.ZodBoolean;
+        preset: z.ZodEnum<{
+            sales: "sales";
+            custom: "custom";
+            faq: "faq";
+        }>;
+        inboxId: z.ZodNullable<z.ZodNumber>;
+        documentCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    maxAgents: z.ZodNumber;
+}, z.core.$strip>;
+export type AiAgentList = z.infer<typeof AiAgentList>;
+export declare const aiAgentsKey: readonly ["ai-agents"];
+export declare const aiAgentKey: (agentId: number) => readonly ["ai-agent", number];
+/** One item with its text, under its agent (the agent is part of the key and of the path). */
+export declare const aiAgentDocumentKey: (agentId: number, id: number) => readonly ["ai-document", number, number];
+export declare function useAiAgents(): import("@tanstack/react-query").UseQueryResult<{
+    agents: {
+        id: number;
+        userId: number;
+        displayName: string;
+        enabled: boolean;
+        preset: "sales" | "custom" | "faq";
+        inboxId: number | null;
+        documentCount: number;
+    }[];
+    maxAgents: number;
+}, Error>;
+/** One agent with its settings and items; `null` (a new agent) reads nothing. */
+export declare function useAiAgent(agentId: number | null): import("@tanstack/react-query").UseQueryResult<{
+    agent: {
+        id: number;
+        userId: number;
+        displayName: string;
+        enabled: boolean;
+        preset: "sales" | "custom" | "faq";
+        inboxId: number | null;
+        documentCount: number;
+    };
+    settings: {
+        displayName: string;
+        mode: "api" | "chatgpt";
+        enabled: boolean;
+        model: string;
+        instructions: string;
+        handoffRules?: string | undefined;
+    };
+    documents: {
+        id: number;
+        name: string;
+        kind: "text" | "file";
+        size: number;
+        characters: number;
+        createdAt: number;
+        updatedAt: number;
+        internal: boolean;
+    }[];
+}, Error>;
+/** One Business context item of an agent with its text (full for text, a preview for files). */
+export declare function useAiAgentDocument(agentId: number, id: number | null): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    name: string;
+    kind: "text" | "file";
+    size: number;
+    characters: number;
+    createdAt: number;
+    updatedAt: number;
+    internal: boolean;
+    text: string;
+    truncated: boolean;
+}, Error>;
+export type AiAgentAction = {
+    kind: 'create';
+    body: AiAgentBody;
+} | {
+    kind: 'save';
+    body: AiAgentBody;
+} | {
+    kind: 'delete';
+} | {
+    kind: 'upload';
+    file: File;
+    internal?: boolean;
+} | {
+    kind: 'addText';
+    body: AiContextTextBody;
+} | {
+    kind: 'updateText';
+    id: number;
+    body: AiContextPatchBody;
+} | {
+    kind: 'remove';
+    id: number;
+} | {
+    kind: 'removeMany';
+    ids: number[];
+}
+/** Binds the agent to an inbox (Admin → Inboxes' route); null frees the inbox it answers now. */
+ | {
+    kind: 'setInbox';
+    inboxId: number | null;
+};
+/** Everything that shows agents: the list, every agent, the old AI member view, members, inboxes. */
+export declare function refreshAgents(qc: QueryClient): void;
+/** Changes one agent (or creates one with `agentId` null) and its Business context items. */
+export declare function useAiAgentAction(agentId: number | null): import("@tanstack/react-query").UseMutationResult<{
+    agents: {
+        id: number;
+        userId: number;
+        displayName: string;
+        enabled: boolean;
+        preset: "sales" | "custom" | "faq";
+        inboxId: number | null;
+        documentCount: number;
+    }[];
+    maxAgents: number;
+} | {
+    agent: {
+        id: number;
+        userId: number;
+        displayName: string;
+        enabled: boolean;
+        preset: "sales" | "custom" | "faq";
+        inboxId: number | null;
+        documentCount: number;
+    };
+    settings: {
+        displayName: string;
+        mode: "api" | "chatgpt";
+        enabled: boolean;
+        model: string;
+        instructions: string;
+        handoffRules?: string | undefined;
+    };
+    documents: {
+        id: number;
+        name: string;
+        kind: "text" | "file";
+        size: number;
+        characters: number;
+        createdAt: number;
+        updatedAt: number;
+        internal: boolean;
+    }[];
+}, Error, AiAgentAction, unknown>;

package/dist-lib/types/api/inbox-mutations.d.ts

@@ -0,0 +1,70 @@
+import type { UpdateInboxBody } from '@ezychat/shared';
+import { type WaAction } from './queries';
+export declare function useCreateInbox(): import("@tanstack/react-query").UseMutationResult<{
+    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;
+}, Error, {
+    name: string;
+    memberIds?: number[] | undefined;
+    aiAgentId?: number | null | undefined;
+}, unknown>;
+export declare function useUpdateInbox(): import("@tanstack/react-query").UseMutationResult<{
+    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;
+}, Error, {
+    id: number;
+    body: UpdateInboxBody;
+}, unknown>;
+export declare function useRemoveInbox(): import("@tanstack/react-query").UseMutationResult<unknown, Error, number, unknown>;
+/** Log out, link again or take over the phone of one inbox. */
+export declare function useInboxWaAction(inboxId: number): import("@tanstack/react-query").UseMutationResult<unknown, Error, WaAction, unknown>;
+/** Link one inbox by phone number: the 8-character code to enter in WhatsApp → Linked devices. */
+export declare function useInboxPairingCode(inboxId: number): import("@tanstack/react-query").UseMutationResult<{
+    code: string;
+}, Error, string, unknown>;
+/** Members → Inbox access: the inboxes one agent may open. */
+export declare function useSetUserInboxes(userId: number): import("@tanstack/react-query").UseMutationResult<{
+    id: number;
+    username: string;
+    displayName: string;
+    role: "admin" | "agent";
+    mustChangePassword: boolean;
+    disabled: boolean;
+    createdAt: number;
+    locale: "en" | "ms" | "zh-CN" | null;
+    kind?: "human" | "ai" | undefined;
+    aiRole?: "sales" | undefined;
+    aiAgentId?: number | undefined;
+    aiDeleted?: boolean | undefined;
+    inboxIds?: number[] | undefined;
+}, Error, number[], unknown>;