@ezychat/web 0.1.54 → 0.1.55

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

@@ -0,0 +1,10 @@
+import { type BusinessTemplateId } from './business-templates';
+/**
+ * "Start from a business template": opens the template gallery. Apply fills the page's draft (the
+ * admin checks it and saves); `pendingItem` names the Business context item the next Save adds.
+ */
+export declare function BusinessTemplateCard({ disabled, pendingItem, onApply, }: {
+    disabled: boolean;
+    pendingItem: string | null;
+    onApply: (id: BusinessTemplateId) => void;
+}): import("react").JSX.Element;

package/dist-lib/types/admin/business-templates.d.ts

@@ -0,0 +1,111 @@
+import type { TFunction } from 'i18next';
+import { type LucideIcon } from 'lucide-react';
+import type { AiAgentPreset, AiContextTextBody } from '@ezychat/shared';
+/**
+ * Ready-made AI agents for common businesses. A template is the tested starting text of its agent
+ * type plus a short business part, its own hand-off rules and one Business context item of
+ * fill-in lines (a blank line gives the AI no fact, so it hands the chat over instead of guessing).
+ * Texts live in the catalogs (`ai.businessTemplates.<id>.*`), so each language gets its own copy.
+ */
+export declare const TEMPLATE_CATEGORIES: readonly ["health", "food", "services", "shops", "education"];
+export type TemplateCategory = (typeof TEMPLATE_CATEGORIES)[number];
+export declare const BUSINESS_TEMPLATES: readonly [{
+    readonly id: "clinic";
+    readonly preset: "faq";
+    readonly category: "health";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "dental";
+    readonly preset: "faq";
+    readonly category: "health";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "salon";
+    readonly preset: "sales";
+    readonly category: "health";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "gym";
+    readonly preset: "sales";
+    readonly category: "health";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "vet";
+    readonly preset: "faq";
+    readonly category: "health";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "restaurant";
+    readonly preset: "sales";
+    readonly category: "food";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "bakery";
+    readonly preset: "sales";
+    readonly category: "food";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "catering";
+    readonly preset: "sales";
+    readonly category: "food";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "carWorkshop";
+    readonly preset: "sales";
+    readonly category: "services";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "homeServices";
+    readonly preset: "sales";
+    readonly category: "services";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "property";
+    readonly preset: "sales";
+    readonly category: "services";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "insurance";
+    readonly preset: "faq";
+    readonly category: "services";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "travel";
+    readonly preset: "sales";
+    readonly category: "services";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "onlineShop";
+    readonly preset: "sales";
+    readonly category: "shops";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "retail";
+    readonly preset: "sales";
+    readonly category: "shops";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "phoneRepair";
+    readonly preset: "sales";
+    readonly category: "shops";
+    readonly icon: LucideIcon;
+}, {
+    readonly id: "tuition";
+    readonly preset: "sales";
+    readonly category: "education";
+    readonly icon: LucideIcon;
+}];
+export type BusinessTemplateId = (typeof BUSINESS_TEMPLATES)[number]['id'];
+export interface BusinessTemplateTexts {
+    preset: AiAgentPreset;
+    agentName: string;
+    instructions: string;
+    handoffRules: string;
+    contextItem: AiContextTextBody;
+}
+export declare function businessTemplate(id: BusinessTemplateId, t: TFunction<'admin'>): BusinessTemplateTexts;
+/**
+ * True when every word of `query` appears in the template's name, description or search words
+ * (the catalogs keep English words beside the translated ones, so either language finds it).
+ */
+export declare function templateMatches(id: BusinessTemplateId, query: string, t: TFunction<'admin'>): boolean;

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

@@ -362,3 +362,39 @@ export declare function useAiAgentAction(agentId: number | null): import("@tanst
         internal: boolean;
     }[];
 }, Error, AiAgentAction, unknown>;
+/**
+ * Adds a Business context text item to an agent by id: a business template's item, sent once the
+ * agent exists (right after create, or after the Save that applies the template).
+ */
+export declare function useAddAgentText(): import("@tanstack/react-query").UseMutationResult<{
+    agent: {
+        id: number;
+        userId: number;
+        displayName: string;
+        enabled: boolean;
+        preset: "sales" | "custom" | "faq";
+        inboxId: number | null;
+        documentCount: number;
+    };
+    settings: {
+        displayName: string;
+        mode: "api" | "chatgpt" | "claude";
+        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, {
+    agentId: number;
+    body: AiContextTextBody;
+}, unknown>;

package/dist-lib/types/components/app/UpgradeEnterprise.d.ts

@@ -1,6 +1,6 @@
 /**
  * The "Upgrade to Enterprise" address, or null when the product hides it: Lite links
- * ezychat.ai/#enterprise, another product passes `createInboxApp({ links: { upgrade: null } })`.
+ * ezychat.ai/#enterprise (with a campaign tag), another product passes `createInboxApp({ links: { upgrade: null } })`.
  */
 export declare function useUpgradeUrl(): string | null;
 /** An outline button that opens the Enterprise page in the browser; nothing when hidden. */

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

@@ -1909,6 +1909,201 @@ export declare const enResources: {
                 rule4: string;
             };
             openAgents: string;
+            businessTemplates: {
+                title: string;
+                hint: string;
+                applyHint: string;
+                apply: string;
+                applied: string;
+                pendingItem: string;
+                confirmTitle: string;
+                confirmBody: string;
+                clinic: {
+                    name: string;
+                    description: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                    keywords: string;
+                };
+                carWorkshop: {
+                    name: string;
+                    description: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                    keywords: string;
+                };
+                tuition: {
+                    name: string;
+                    description: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                    keywords: string;
+                };
+                browse: string;
+                galleryTitle: string;
+                galleryHint: string;
+                search: string;
+                searchPlaceholder: string;
+                categories: string;
+                category: {
+                    all: string;
+                    health: string;
+                    food: string;
+                    services: string;
+                    shops: string;
+                    education: string;
+                };
+                noMatch: string;
+                dental: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                salon: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                gym: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                vet: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                restaurant: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                bakery: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                catering: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                homeServices: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                property: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                insurance: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                travel: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                onlineShop: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                retail: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+                phoneRepair: {
+                    name: string;
+                    description: string;
+                    keywords: string;
+                    agentName: string;
+                    focus: string;
+                    handoffRules: string;
+                    contextName: string;
+                    contextText: string;
+                };
+            };
         };
         enrichment: {
             title: string;

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

@@ -30,8 +30,11 @@ export interface AppLinks {
     /** "Upgrade to Enterprise" page (Lite's limits, account menu, About); null hides every upgrade link. */
     upgrade: string | null;
 }
-/** The EzyChat Enterprise section of the website. */
-export declare const ENTERPRISE_UPGRADE_URL = "https://ezychat.ai/#enterprise";
+/**
+ * The EzyChat Enterprise section of the website. The campaign tag lets the website count upgrade
+ * visits from the app; the app itself sends nothing (no tracking in Lite).
+ */
+export declare const ENTERPRISE_UPGRADE_URL = "https://ezychat.ai/?utm_source=ezychat-lite&utm_medium=app&utm_campaign=upgrade#enterprise";
 /** Lite's links: GitHub repository and issues, feedback on ezychat.ai. */
 export declare const LITE_APP_LINKS: Readonly<AppLinks>;
 /** Lite's links with the given overrides (an explicit `null` hides that link). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezychat/web",
-  "version": "0.1.54",
+  "version": "0.1.55",
   "type": "module",
   "description": "EzyChat core: the team inbox web app (React) as a library, with createInboxApp and its extension API.",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "build:lib": "node ../../scripts/build-web-lib.mjs"
   },
   "dependencies": {
-    "@ezychat/shared": "0.1.54",
+    "@ezychat/shared": "0.1.55",
     "@fontsource-variable/inter": "^5.3.0",
     "@tanstack/react-query": "^5.104.5",
     "@types/react": "^19.3.0",