@ezychat/web 0.1.47 → 0.1.48

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/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/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,8 @@ 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: {
@@ -37,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<{
@@ -48,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>;
@@ -65,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;
@@ -88,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;
@@ -147,6 +169,8 @@ 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: {
@@ -172,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

@@ -16,10 +16,12 @@ export declare function useCreateInbox(): import("@tanstack/react-query").UseMut
         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;
@@ -37,6 +39,7 @@ export declare function useUpdateInbox(): import("@tanstack/react-query").UseMut
         lastError: string | null;
     };
     removed: boolean;
+    aiAgentId: number | null;
     memberIds?: number[] | undefined;
 }, Error, {
     id: number;
@@ -61,5 +64,7 @@ export declare function useSetUserInboxes(userId: number): import("@tanstack/rea
     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>;

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

@@ -68,6 +68,8 @@ 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<{
@@ -90,6 +92,8 @@ 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;
@@ -113,6 +117,8 @@ 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, {
@@ -460,6 +466,8 @@ 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`). */
@@ -479,6 +487,8 @@ export declare function useUserDirectory(opts?: {
     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;
@@ -491,6 +501,8 @@ 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;
@@ -509,6 +521,8 @@ 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;
@@ -555,6 +569,7 @@ export declare function useInboxes(opts?: {
             lastError: string | null;
         };
         removed: boolean;
+        aiAgentId: number | null;
         memberIds?: number[] | undefined;
     }[];
     maxInboxes: number;

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';