@inkeep/cxkit-primitives 0.0.0-dev-20250221234142

package/dist/components/intelligent-form/actions/qa-model-messages.cjs

@@ -0,0 +1,27 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=e=>{const o=JSON.stringify(e,null,2);return[{id:`${Date.now()}1`,role:"system",content:`
+        <guidance>
+          <rule>
+            <name>Direct Answer Provision</name>
+            <conditions>
+              <condition>When responding to form field inputs</condition>
+            </conditions>
+            <actions>
+              <action>
+                **Provide direct, complete answers** based solely on the form fields provided. Never ask follow-up questions or request additional information.
+
+                ✅ Good Example:
+                "Based on the provided information, the issue appears to be X. Here's how to resolve it..."
+
+                ❌ Bad Example:
+                "Could you provide more details about...?" or "Would you like me to explain...?"
+
+                Guidelines:
+                - Always provide the best possible answer with available information
+                - Never use phrases like "would you like" or "do you need"
+                - Focus on actionable solutions rather than gathering more information
+                - Maintain a professional, direct tone throughout the response
+              </action>
+            </actions>
+          </rule>
+        </guidance>
+      `},{id:`${Date.now()}2`,role:"user",content:`${o}`}]};exports.getQAModelMessages=i;

package/dist/components/intelligent-form/actions/qa-model-messages.d.cts

@@ -0,0 +1,2 @@
+import { Message } from '@inkeep/cxkit-types';
+export declare const getQAModelMessages: (primaryFieldValues: Record<string, unknown>) => Message[];

package/dist/components/intelligent-form/actions/qa-model-messages.d.ts

@@ -0,0 +1,2 @@
+import { Message } from '@inkeep/cxkit-types';
+export declare const getQAModelMessages: (primaryFieldValues: Record<string, unknown>) => Message[];

package/dist/components/intelligent-form/actions/qa-model-messages.js

@@ -0,0 +1,45 @@
+"use client";
+const n = (e) => {
+  const o = JSON.stringify(e, null, 2);
+  return [
+    {
+      id: `${Date.now()}1`,
+      role: "system",
+      content: `
+        <guidance>
+          <rule>
+            <name>Direct Answer Provision</name>
+            <conditions>
+              <condition>When responding to form field inputs</condition>
+            </conditions>
+            <actions>
+              <action>
+                **Provide direct, complete answers** based solely on the form fields provided. Never ask follow-up questions or request additional information.
+
+                ✅ Good Example:
+                "Based on the provided information, the issue appears to be X. Here's how to resolve it..."
+
+                ❌ Bad Example:
+                "Could you provide more details about...?" or "Would you like me to explain...?"
+
+                Guidelines:
+                - Always provide the best possible answer with available information
+                - Never use phrases like "would you like" or "do you need"
+                - Focus on actionable solutions rather than gathering more information
+                - Maintain a professional, direct tone throughout the response
+              </action>
+            </actions>
+          </rule>
+        </guidance>
+      `
+    },
+    {
+      id: `${Date.now()}2`,
+      role: "user",
+      content: `${o}`
+    }
+  ];
+};
+export {
+  n as getQAModelMessages
+};

package/dist/components/intelligent-form/actions/qa-model-response.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("./escalation-schema.cjs"),p=async(o,i,n)=>{const t=await i.chat.completions.create({model:"inkeep-qa-expert",messages:o,tools:[{type:"function",function:{name:"provideAIAnnotations",description:"Provides AI confidence levels for the response",parameters:l.escalationSchema}},{type:"function",function:{name:"provideRecordsConsidered",description:"Provides records considered in generating the response",parameters:{type:"object"}}}],tool_choice:"auto"},n?{headers:n}:void 0),c=t.choices[0]?.message?.content;let s,r;const a=t.choices[0]?.message?.tool_calls||[];for(const e of a)e.function.name==="provideAIAnnotations"&&(s=JSON.parse(e.function.arguments).aiAnnotations),e.function.name==="provideRecordsConsidered"&&(r=JSON.parse(e.function.arguments).recordsConsidered??[]);return{answer:c||null,aiAnnotations:s,recordsConsidered:r,messages:o}};exports.generateQAModelResponse=p;

package/dist/components/intelligent-form/actions/qa-model-response.d.cts

@@ -0,0 +1,14 @@
+import { default as OpenAI } from 'openai';
+import { AnswerConfidence, Message, SourceItem } from '@inkeep/cxkit-types';
+export interface QAModelInput {
+    primaryFieldValues: Record<string, unknown>;
+}
+export interface QAModelResponse {
+    answer: string | null;
+    aiAnnotations?: {
+        answerConfidence: AnswerConfidence;
+    };
+    recordsConsidered?: SourceItem[];
+    messages: Message[];
+}
+export declare const generateQAModelResponse: (messages: Message[], openai: OpenAI, headers?: Record<string, string>) => Promise<QAModelResponse>;

package/dist/components/intelligent-form/actions/qa-model-response.d.ts

@@ -0,0 +1,14 @@
+import { default as OpenAI } from 'openai';
+import { AnswerConfidence, Message, SourceItem } from '@inkeep/cxkit-types';
+export interface QAModelInput {
+    primaryFieldValues: Record<string, unknown>;
+}
+export interface QAModelResponse {
+    answer: string | null;
+    aiAnnotations?: {
+        answerConfidence: AnswerConfidence;
+    };
+    recordsConsidered?: SourceItem[];
+    messages: Message[];
+}
+export declare const generateQAModelResponse: (messages: Message[], openai: OpenAI, headers?: Record<string, string>) => Promise<QAModelResponse>;

package/dist/components/intelligent-form/actions/qa-model-response.js

@@ -0,0 +1,46 @@
+"use client";
+import { escalationSchema as l } from "./escalation-schema.js";
+const f = async (o, i, n) => {
+  const t = await i.chat.completions.create(
+    {
+      model: "inkeep-qa-expert",
+      messages: o,
+      tools: [
+        {
+          type: "function",
+          function: {
+            name: "provideAIAnnotations",
+            description: "Provides AI confidence levels for the response",
+            parameters: l
+          }
+        },
+        {
+          type: "function",
+          function: {
+            name: "provideRecordsConsidered",
+            description: "Provides records considered in generating the response",
+            parameters: {
+              type: "object"
+              // No need for properties as it's all defined in the backend
+            }
+          }
+        }
+      ],
+      tool_choice: "auto"
+    },
+    n ? { headers: n } : void 0
+  ), c = t.choices[0]?.message?.content;
+  let s, r;
+  const a = t.choices[0]?.message?.tool_calls || [];
+  for (const e of a)
+    e.function.name === "provideAIAnnotations" && (s = JSON.parse(e.function.arguments).aiAnnotations), e.function.name === "provideRecordsConsidered" && (r = JSON.parse(e.function.arguments).recordsConsidered ?? []);
+  return {
+    answer: c || null,
+    aiAnnotations: s,
+    recordsConsidered: r,
+    messages: o
+  };
+};
+export {
+  f as generateQAModelResponse
+};

package/dist/components/intelligent-form/intelligent-form-provider.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react/jsx-runtime"),r=require("react"),s=require("./use-inkeep-intelligent-form.cjs"),u=require("../../providers/conversation-provider.cjs"),c=require("../../providers/chat-events-provider.cjs"),n=r.createContext(void 0),o=({children:e,formConfig:i})=>{const l=s.useInkeepIntelligentForm({formConfig:i});return t.jsx(n.Provider,{value:l,children:e})},m=e=>t.jsx(u.InkeepConversationProvider,{children:t.jsx(c.ChatEventsProviderWithBase,{children:t.jsx(o,{...e})})}),v=()=>{const e=r.useContext(n);if(!e)throw new Error("useIntelligentForm must be used within a IntelligentFormProvider");return e};exports.IntelligentFormProvider=m;exports.IntelligentFormProviderImpl=o;exports.useIntelligentForm=v;

package/dist/components/intelligent-form/intelligent-form-provider.d.cts

@@ -0,0 +1,29 @@
+import { useInkeepIntelligentForm, AIResponse } from './use-inkeep-intelligent-form';
+import { IntelligentFormConfig } from '@inkeep/cxkit-types';
+import { Control, FieldErrors, Message } from 'react-hook-form';
+import { Dispatch, SetStateAction } from 'react';
+export type IntelligentFormContextValue = ReturnType<typeof useInkeepIntelligentForm>;
+export interface IntelligentFormProviderProps {
+    children: React.ReactNode;
+    formConfig: IntelligentFormConfig;
+}
+export declare const IntelligentFormProviderImpl: React.FC<IntelligentFormProviderProps>;
+export declare const IntelligentFormProvider: React.FC<IntelligentFormProviderProps>;
+export declare const useIntelligentForm: () => {
+    formConfig: IntelligentFormConfig;
+    control: Control<Record<string, any>, any>;
+    errors: FieldErrors<Record<string, any>>;
+    isSubmitSuccessful: boolean;
+    isSubmitting: boolean;
+    handleSubmit: (e?: React.BaseSyntheticEvent) => Promise<void>;
+    loading: boolean;
+    formError: Partial<{
+        type: string | number;
+        message: Message;
+    }> | undefined;
+    submittedPrimaryForm: boolean;
+    handleSubmitPrimaryForm: () => Promise<void>;
+    aiResponse: AIResponse;
+    showSecondaryFields: boolean;
+    setShowSecondaryFields: Dispatch<SetStateAction<boolean>>;
+};

package/dist/components/intelligent-form/intelligent-form-provider.d.ts

@@ -0,0 +1,29 @@
+import { useInkeepIntelligentForm, AIResponse } from './use-inkeep-intelligent-form';
+import { IntelligentFormConfig } from '@inkeep/cxkit-types';
+import { Control, FieldErrors, Message } from 'react-hook-form';
+import { Dispatch, SetStateAction } from 'react';
+export type IntelligentFormContextValue = ReturnType<typeof useInkeepIntelligentForm>;
+export interface IntelligentFormProviderProps {
+    children: React.ReactNode;
+    formConfig: IntelligentFormConfig;
+}
+export declare const IntelligentFormProviderImpl: React.FC<IntelligentFormProviderProps>;
+export declare const IntelligentFormProvider: React.FC<IntelligentFormProviderProps>;
+export declare const useIntelligentForm: () => {
+    formConfig: IntelligentFormConfig;
+    control: Control<Record<string, any>, any>;
+    errors: FieldErrors<Record<string, any>>;
+    isSubmitSuccessful: boolean;
+    isSubmitting: boolean;
+    handleSubmit: (e?: React.BaseSyntheticEvent) => Promise<void>;
+    loading: boolean;
+    formError: Partial<{
+        type: string | number;
+        message: Message;
+    }> | undefined;
+    submittedPrimaryForm: boolean;
+    handleSubmitPrimaryForm: () => Promise<void>;
+    aiResponse: AIResponse;
+    showSecondaryFields: boolean;
+    setShowSecondaryFields: Dispatch<SetStateAction<boolean>>;
+};

package/dist/components/intelligent-form/intelligent-form-provider.js

@@ -0,0 +1,23 @@
+"use client";
+import { jsx as t } from "react/jsx-runtime";
+import { createContext as i, useContext as l } from "react";
+import { useInkeepIntelligentForm as m } from "./use-inkeep-intelligent-form.js";
+import { InkeepConversationProvider as s } from "../../providers/conversation-provider.js";
+import { ChatEventsProviderWithBase as c } from "../../providers/chat-events-provider.js";
+const r = i(void 0), u = ({
+  children: e,
+  formConfig: o
+}) => {
+  const n = m({ formConfig: o });
+  return /* @__PURE__ */ t(r.Provider, { value: n, children: e });
+}, F = (e) => /* @__PURE__ */ t(s, { children: /* @__PURE__ */ t(c, { children: /* @__PURE__ */ t(u, { ...e }) }) }), a = () => {
+  const e = l(r);
+  if (!e)
+    throw new Error("useIntelligentForm must be used within a IntelligentFormProvider");
+  return e;
+};
+export {
+  F as IntelligentFormProvider,
+  u as IntelligentFormProviderImpl,
+  a as useIntelligentForm
+};

package/dist/components/intelligent-form/use-inkeep-intelligent-form.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const D=require("openai"),t=require("react"),J=require("react-hook-form"),X=require("../../utils/form.cjs"),z=require("./actions/qa-model-response.cjs"),W=require("./actions/context-model-response.cjs"),Y=require("../../providers/config-provider.cjs"),Z=require("../../providers/conversation-provider.cjs"),ee=require("../../providers/chat-events-provider.cjs"),se=require("./actions/qa-model-messages.cjs"),re=require("../embedded-chat/use-captcha.cjs"),ne="root.serverError",I=async(f,r)=>{if(r)return;const i=await re.fetchAndSolveChallenge(`${f}/v1/challenge`);if(i)return{"X-INKEEP-CHALLENGE-SOLUTION":btoa(JSON.stringify(i))}},oe=f=>{const{formConfig:r}=f,{baseSettings:i}=Y.useInkeepConfig(),{conversation:n}=Z.useInkeepConversation(),{logEvent:a}=ee.useChatEvents(),{baseUrl:d,bypassChallenge:v}=i,y=t.useMemo(()=>new D({baseURL:`${d}/v1`,apiKey:i.apiKey,dangerouslyAllowBrowser:!0}),[i.apiKey,d]),[R,S]=t.useState(!1),[M,V]=t.useState(!1),[F,p]=t.useState(!1),[N,_]=t.useState({}),l=t.useMemo(()=>{const{primary:o,secondary:u}=r;return X.getFormDefaultValues([...o.fields,...u.fields])},[r]),{control:b,handleSubmit:A,formState:{errors:h,isSubmitting:P,isSubmitSuccessful:O},reset:C,trigger:k,setValue:x,setError:H}=J.useForm({defaultValues:l});t.useEffect(()=>{l&&C(l)},[C,l]);const L=async o=>{const u=typeof window>"u"?"":window.location.href;try{await r.onSubmit({values:o,conversation:n,client:{currentUrl:u}}),a({eventName:"intelligent_form_submitted",properties:{conversationId:n.id,values:o}})}catch(c){H(ne,{message:c instanceof Error?c.message:"Something went wrong."}),a({eventName:"intelligent_form_submission_error",properties:{conversationId:n.id,error:c instanceof Error?c.message:"Something went wrong."}})}},K=async()=>{const o=r.primary.fields.map(e=>e.name);if(!await k(o))return;V(!0),S(!0);const c=b._formValues,E=r.primary.fields.reduce((e,m)=>(e[m.name]=c[m.name],e),{}),G=r.secondary.fields.filter(e=>e.aiGenerated!==!1),q=se.getQAModelMessages(E);a({eventName:"intelligent_form_primary_submitted",properties:{conversationId:n.id,fields:o,messages:q}});try{const e=await I(d,v),m=await I(d,v),[s,g]=await Promise.all([z.generateQAModelResponse(q,y,e),W.generateContextModelResponse({primaryFieldValues:E,fieldsToGenerate:G},y,m)]);if(a({eventName:"intelligent_form_qa_response",properties:{conversationId:n.id,messages:s.messages,answer:s.answer??"",confidence:s.aiAnnotations?.answerConfidence,recordsConsidered:s.recordsConsidered}}),g.suggestedValues){for(const[$,B]of Object.entries(g.suggestedValues))x($,B);a({eventName:"intelligent_form_context_suggestions",properties:{conversationId:n.id,suggestedFields:Object.keys(g.suggestedValues)}})}const w=s.aiAnnotations?.answerConfidence,T=w&&["very_confident","somewhat_confident"].includes(w),Q=s.recordsConsidered&&s.recordsConsidered.length>0;T&&Q&&s.answer?_({answer:s.answer,answerConfidence:w,recordsConsidered:s.recordsConsidered}):(p(!0),_({answer:null,recordsConsidered:s.recordsConsidered,suggestedValues:g.suggestedValues}))}catch(e){console.error(e),p(!0),a({eventName:"intelligent_form_ai_error",properties:{conversationId:n.id,error:e instanceof Error?e.message:"Something went wrong."}})}finally{S(!1)}},U=A(L),j=h?.root?.serverError;return{formConfig:r,control:b,errors:h,isSubmitSuccessful:O,isSubmitting:P,handleSubmit:U,loading:R,formError:j,submittedPrimaryForm:M,handleSubmitPrimaryForm:K,aiResponse:N,showSecondaryFields:F,setShowSecondaryFields:p}};exports.useInkeepIntelligentForm=oe;

package/dist/components/intelligent-form/use-inkeep-intelligent-form.d.cts

@@ -0,0 +1,30 @@
+import { AnswerConfidence, IntelligentFormConfig, SourceItem } from '@inkeep/cxkit-types';
+import { Control, FieldErrors, Message } from 'react-hook-form';
+import { Dispatch, SetStateAction } from 'react';
+export interface InkeepIntelligentFormConfig {
+    formConfig: IntelligentFormConfig;
+}
+export interface AIResponse {
+    answer?: string | null;
+    answerConfidence?: AnswerConfidence;
+    recordsConsidered?: SourceItem[];
+    suggestedValues?: Record<string, unknown>;
+}
+export declare const useInkeepIntelligentForm: (props: InkeepIntelligentFormConfig) => {
+    formConfig: IntelligentFormConfig;
+    control: Control<Record<string, any>, any>;
+    errors: FieldErrors<Record<string, any>>;
+    isSubmitSuccessful: boolean;
+    isSubmitting: boolean;
+    handleSubmit: (e?: React.BaseSyntheticEvent) => Promise<void>;
+    loading: boolean;
+    formError: Partial<{
+        type: string | number;
+        message: Message;
+    }> | undefined;
+    submittedPrimaryForm: boolean;
+    handleSubmitPrimaryForm: () => Promise<void>;
+    aiResponse: AIResponse;
+    showSecondaryFields: boolean;
+    setShowSecondaryFields: Dispatch<SetStateAction<boolean>>;
+};

package/dist/components/intelligent-form/use-inkeep-intelligent-form.d.ts

@@ -0,0 +1,30 @@
+import { AnswerConfidence, IntelligentFormConfig, SourceItem } from '@inkeep/cxkit-types';
+import { Control, FieldErrors, Message } from 'react-hook-form';
+import { Dispatch, SetStateAction } from 'react';
+export interface InkeepIntelligentFormConfig {
+    formConfig: IntelligentFormConfig;
+}
+export interface AIResponse {
+    answer?: string | null;
+    answerConfidence?: AnswerConfidence;
+    recordsConsidered?: SourceItem[];
+    suggestedValues?: Record<string, unknown>;
+}
+export declare const useInkeepIntelligentForm: (props: InkeepIntelligentFormConfig) => {
+    formConfig: IntelligentFormConfig;
+    control: Control<Record<string, any>, any>;
+    errors: FieldErrors<Record<string, any>>;
+    isSubmitSuccessful: boolean;
+    isSubmitting: boolean;
+    handleSubmit: (e?: React.BaseSyntheticEvent) => Promise<void>;
+    loading: boolean;
+    formError: Partial<{
+        type: string | number;
+        message: Message;
+    }> | undefined;
+    submittedPrimaryForm: boolean;
+    handleSubmitPrimaryForm: () => Promise<void>;
+    aiResponse: AIResponse;
+    showSecondaryFields: boolean;
+    setShowSecondaryFields: Dispatch<SetStateAction<boolean>>;
+};

package/dist/components/intelligent-form/use-inkeep-intelligent-form.js

@@ -0,0 +1,157 @@
+"use client";
+import J from "openai";
+import { useMemo as V, useState as u, useEffect as X } from "react";
+import { useForm as z } from "react-hook-form";
+import { getFormDefaultValues as W } from "../../utils/form.js";
+import { generateQAModelResponse as Y } from "./actions/qa-model-response.js";
+import { generateContextModelResponse as Z } from "./actions/context-model-response.js";
+import { useInkeepConfig as ee } from "../../providers/config-provider.js";
+import { useInkeepConversation as re } from "../../providers/conversation-provider.js";
+import { useChatEvents as se } from "../../providers/chat-events-provider.js";
+import { getQAModelMessages as oe } from "./actions/qa-model-messages.js";
+import { fetchAndSolveChallenge as ne } from "../embedded-chat/use-captcha.js";
+const te = "root.serverError", R = async (g, s) => {
+  if (s) return;
+  const t = await ne(`${g}/v1/challenge`);
+  if (t)
+    return {
+      "X-INKEEP-CHALLENGE-SOLUTION": btoa(JSON.stringify(t))
+    };
+}, ye = (g) => {
+  const { formConfig: s } = g, { baseSettings: t } = ee(), { conversation: o } = re(), { logEvent: i } = se(), { baseUrl: d, bypassChallenge: y } = t, v = V(
+    () => new J({
+      baseURL: `${d}/v1`,
+      apiKey: t.apiKey,
+      dangerouslyAllowBrowser: !0
+    }),
+    [t.apiKey, d]
+  ), [N, S] = u(!1), [A, F] = u(!1), [M, p] = u(!1), [O, _] = u({}), c = V(() => {
+    const { primary: n, secondary: l } = s;
+    return W([...n.fields, ...l.fields]);
+  }, [s]), {
+    control: C,
+    handleSubmit: x,
+    formState: { errors: b, isSubmitting: L, isSubmitSuccessful: P },
+    reset: h,
+    trigger: k,
+    setValue: H,
+    setError: K
+  } = z({
+    defaultValues: c
+  });
+  X(() => {
+    c && h(c);
+  }, [h, c]);
+  const U = async (n) => {
+    const l = typeof window > "u" ? "" : window.location.href;
+    try {
+      await s.onSubmit({
+        values: n,
+        conversation: o,
+        client: { currentUrl: l }
+      }), i({
+        eventName: "intelligent_form_submitted",
+        properties: {
+          conversationId: o.id,
+          values: n
+        }
+      });
+    } catch (a) {
+      K(te, {
+        message: a instanceof Error ? a.message : "Something went wrong."
+      }), i({
+        eventName: "intelligent_form_submission_error",
+        properties: {
+          conversationId: o.id,
+          error: a instanceof Error ? a.message : "Something went wrong."
+        }
+      });
+    }
+  }, q = async () => {
+    const n = s.primary.fields.map((e) => e.name);
+    if (!await k(n)) return;
+    F(!0), S(!0);
+    const a = C._formValues, E = s.primary.fields.reduce(
+      (e, m) => (e[m.name] = a[m.name], e),
+      {}
+    ), Q = s.secondary.fields.filter(
+      (e) => e.aiGenerated !== !1
+    ), I = oe(E);
+    i({
+      eventName: "intelligent_form_primary_submitted",
+      properties: {
+        conversationId: o.id,
+        fields: n,
+        messages: I
+      }
+    });
+    try {
+      const e = await R(d, y), m = await R(d, y), [r, f] = await Promise.all([
+        Y(I, v, e),
+        Z(
+          { primaryFieldValues: E, fieldsToGenerate: Q },
+          v,
+          m
+        )
+      ]);
+      if (i({
+        eventName: "intelligent_form_qa_response",
+        properties: {
+          conversationId: o.id,
+          messages: r.messages,
+          answer: r.answer ?? "",
+          confidence: r.aiAnnotations?.answerConfidence,
+          recordsConsidered: r.recordsConsidered
+        }
+      }), f.suggestedValues) {
+        for (const [B, D] of Object.entries(f.suggestedValues))
+          H(B, D);
+        i({
+          eventName: "intelligent_form_context_suggestions",
+          properties: {
+            conversationId: o.id,
+            suggestedFields: Object.keys(f.suggestedValues)
+          }
+        });
+      }
+      const w = r.aiAnnotations?.answerConfidence, T = w && ["very_confident", "somewhat_confident"].includes(w), $ = r.recordsConsidered && r.recordsConsidered.length > 0;
+      T && $ && r.answer ? _({
+        answer: r.answer,
+        answerConfidence: w,
+        recordsConsidered: r.recordsConsidered
+      }) : (p(!0), _({
+        answer: null,
+        recordsConsidered: r.recordsConsidered,
+        suggestedValues: f.suggestedValues
+      }));
+    } catch (e) {
+      console.error(e), p(!0), i({
+        eventName: "intelligent_form_ai_error",
+        properties: {
+          conversationId: o.id,
+          error: e instanceof Error ? e.message : "Something went wrong."
+        }
+      });
+    } finally {
+      S(!1);
+    }
+  }, G = x(U), j = b?.root?.serverError;
+  return {
+    formConfig: s,
+    control: C,
+    errors: b,
+    isSubmitSuccessful: P,
+    isSubmitting: L,
+    handleSubmit: G,
+    loading: N,
+    formError: j,
+    submittedPrimaryForm: A,
+    handleSubmitPrimaryForm: q,
+    aiResponse: O,
+    showSecondaryFields: M,
+    setShowSecondaryFields: p
+  };
+};
+export {
+  ye as useInkeepIntelligentForm
+};

package/dist/components/intelligent-form.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react/jsx-runtime"),t=require("./factory.cjs"),F=require("react"),y=require("react-textarea-autosize"),Ae=require("@radix-ui/react-select"),je=require("@radix-ui/react-checkbox"),m=require("./intelligent-form/intelligent-form-provider.cjs"),Te=require("@radix-ui/react-scroll-area"),p=require("../atoms/icons/built-in-icon-renderer.cjs"),c=require("../utils/misc.cjs"),Be=require("react-hook-form"),I=require("../providers/intelligent-form-field-provider.cjs"),Ee=require("../atoms/icons/checkbox-icon.cjs"),x=require("../providers/config-provider.cjs"),h=require("../providers/source-item-provider.cjs"),He=require("../atoms/link.cjs"),Le=require("../atoms/markdown/index.cjs"),S=require("../utils/compose-refs.cjs"),u=require("../utils/compose-event-handlers.cjs");function k(i){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(i){for(const n in i)if(n!=="default"){const r=Object.getOwnPropertyDescriptor(i,n);Object.defineProperty(e,n,r.get?r:{enumerable:!0,get:()=>i[n]})}}return e.default=i,Object.freeze(e)}const g=k(Ae),R=k(je),P=k(Te),Ve=t.ikp("form",{_id:"intelligentForm__Root"}),w=i=>{const{onSubmit:e,...n}=i,{handleSubmit:r}=m.useIntelligentForm();return o.jsx(Ve,{onSubmit:u.composeEventHandlers(e,r),...n})},A=t.ikp("h2",{_id:"intelligentForm__Heading",children:"Contact Support"}),j=t.ikp("div",{_id:"intelligentForm__Content"}),T=t.ikp(P.Root,{_id:"intelligentForm__Content__ScrollArea"}),qe=t.ikp(P.Viewport,{_id:"intelligentForm__Content__ScrollAreaViewport"}),B=i=>{const{children:e,...n}=i;return o.jsx(qe,{children:o.jsx("div",{"data-part":"grid",style:{display:"grid"},children:e}),...n})},E=t.ikp(P.ScrollAreaScrollbar,{_id:"intelligentForm__Content__ScrollAreaScrollbar"}),H=t.ikp(P.ScrollAreaThumb,{_id:"intelligentForm__Content__ScrollAreaThumb"}),L=t.ikp(P.Corner,{_id:"intelligentForm__Content__ScrollAreaCorner"}),De=t.ikp("div",{_id:"intelligentForm__Success"}),V=i=>{const{children:e,...n}=i,{isSubmitSuccessful:r}=m.useIntelligentForm();return r?o.jsx(De,{...n,children:e}):null},Ne=t.ikp(p.BuiltInIconRenderer,{_id:"intelligentForm__SuccessIcon"}),q=i=>{const{formConfig:{successView:e}}=m.useIntelligentForm();return o.jsx(Ne,{iconSettings:e.icon??{builtIn:"LuCircleCheck"},...i})},Oe=t.ikp("h2",{_id:"intelligentForm__SuccessHeading"}),D=i=>{const{formConfig:{successView:e}}=m.useIntelligentForm();return o.jsx(Oe,{children:e.heading,...i})},Me=t.ikp("p",{_id:"intelligentForm__SuccessMessage"}),N=i=>{const{formConfig:{successView:e}}=m.useIntelligentForm();return o.jsx(Me,{children:e.message,...i})},O=t.ikp("div",{_id:"intelligentForm__PrimaryForm"}),ze=t.ikp("div",{_id:"intelligentForm__PrimaryFormFields"}),Ue=t.ikp("p",{_id:"intelligentForm__PrimaryForm__Description"}),M=i=>{const{formConfig:{primary:e}}=m.useIntelligentForm();return e.description?o.jsx(Ue,{children:e.description,...i}):null},z=i=>{const{children:e,...n}=i,{formConfig:{primary:r}}=m.useIntelligentForm();return o.jsx(ze,{children:c.maybeRender(e,r.fields),...n})},Xe=t.ikp("button",{_id:"intelligentForm__PrimaryFormSubmit",type:"button",children:"Next"}),U=i=>{const{onClick:e,...n}=i,{submittedPrimaryForm:r,handleSubmitPrimaryForm:l}=m.useIntelligentForm();return o.jsx(Xe,{"data-submitted":c.dataAttr(r),onClick:u.composeEventHandlers(e,l),...n})},Qe=t.ikp("div",{_id:"intelligentForm__Field"}),X=i=>{const{field:e,autoFocus:n,...r}=i,{control:l,errors:s}=m.useIntelligentForm();return o.jsx(Be.Controller,{name:e.name,control:l,rules:{required:e.required?`${e.label} is required.`:void 0},render:({field:d})=>{const a=d.value!==void 0||e.inputType==="FILE";return o.jsx(I.IntelligentFormFieldProvider,{"data-invalid":c.dataAttr(!!s[e.name]),field:e,fieldProps:d,autoFocus:n,children:a&&o.jsx(Qe,{"data-input-type":e.inputType,"data-hidden":c.dataAttr(e.isHidden),...r})})}})},We=t.ikp("label",{_id:"intelligentForm__FieldLabel"}),Q=i=>{const{field:e}=I.useIntelligentFormField();return o.jsx(We,{"data-required":c.dataAttr(e.required),htmlFor:e.name,children:e.label,...i})},$e=t.ikp("input",{_id:"intelligentForm__FieldText",type:"text"}),f=F.forwardRef((i,e)=>{const{field:n,error:r,fieldProps:{onChange:l,onBlur:s,ref:d,...a},autoFocus:v}=I.useIntelligentFormField(),_=S.useComposedRefs(e,d);return o.jsx($e,{asChild:n.inputType==="TEXTAREA",ref:_,id:n.name,autoFocus:v,placeholder:"placeholder"in n?n.placeholder:void 0,"data-invalid":c.dataAttr(!!r),onChange:u.composeEventHandlers(i.onChange,l),onBlur:u.composeEventHandlers(i.onBlur,s),...a,...i,children:n.inputType==="TEXTAREA"?o.jsx(y,{minRows:3,maxRows:10}):null})}),W=t.ikp(f,{_id:"intelligentForm__FieldEmail",type:"email"}),Ge=t.ikp("input",{_id:"intelligentForm__FieldFile",type:"file",multiple:!0}),$=i=>{const{field:e,error:n,fieldProps:{value:r,onChange:l,onBlur:s,...d},autoFocus:a}=I.useIntelligentFormField(),{onChange:v,onBlur:_,...b}=i,C=Re=>{const we=Re.target.files;l(we)};return o.jsx(Ge,{id:e.name,autoFocus:a,"data-value":r,"data-invalid":c.dataAttr(!!n),...b,...d,onChange:u.composeEventHandlers(v,C),onBlur:u.composeEventHandlers(_,s)})},G=t.ikp(f,{_id:"intelligentForm__FieldTextArea",type:"textarea",asChild:!0,children:o.jsx(y,{rows:1,maxRows:8})}),Je=t.ikp(R.Root,{_id:"intelligentForm__FieldCheckbox"}),J=i=>{const{field:e,error:n,fieldProps:r,autoFocus:l}=I.useIntelligentFormField(),{onCheckedChange:s,...d}=i;return o.jsx(Je,{id:e.name,name:e.name,autoFocus:l,"data-invalid":c.dataAttr(!!n),checked:r.value,onCheckedChange:u.composeEventHandlers(s,r.onChange),...d})},K=t.ikp(R.Indicator,{_id:"intelligentForm__FieldCheckboxIndicator",children:o.jsx(Ee.CheckboxIcon,{})}),Ke=t.ikp(g.Root,{_id:"intelligentForm__FieldSelect"}),Y=i=>{const{field:e,error:n,fieldProps:r}=I.useIntelligentFormField(),{onValueChange:l,...s}=i;return o.jsx(Ke,{name:e.name,"data-invalid":c.dataAttr(!!n),value:r.value,onValueChange:u.composeEventHandlers(l,r.onChange),...s})},Z=t.ikp(g.Trigger,{_id:"intelligentForm__FieldSelect__Trigger"}),Ye=t.ikp(g.Value,{_id:"intelligentForm__FieldSelect__Value"}),ee=i=>{const{field:e}=I.useIntelligentFormField();return o.jsx(Ye,{placeholder:"placeholder"in e?e.placeholder:void 0,...i})},ie=t.ikp(g.Icon,{_id:"intelligentForm__FieldSelect__Icon",asChild:!0,children:o.jsx(p.BuiltInIconRenderer,{iconSettings:{builtIn:"LuChevronDown"}})}),te=t.ikp(g.Content,{_id:"intelligentForm__FieldSelect__Content",position:"popper"}),ne=t.ikp(g.Viewport,{_id:"intelligentForm__FieldSelect__Viewport"}),re=t.ikp(g.Item,{_id:"intelligentForm__FieldSelect__Item"}),oe=t.ikp(g.ItemText,{_id:"intelligentForm__FieldSelect__ItemText"}),le=t.ikp(g.ItemIndicator,{_id:"intelligentForm__FieldSelect__ItemIndicator",asChild:!0,children:o.jsx(p.BuiltInIconRenderer,{iconSettings:{builtIn:"LuCheck"}})}),Ze=t.ikp("span",{_id:"intelligentForm__FieldError"}),me=i=>{const{error:e}=I.useIntelligentFormField();return e?o.jsx(Ze,{children:e.message?.toString(),...i}):null},se=t.ikp("div",{_id:"intelligentForm__BotHeading"}),ce=t.ikp(p.BuiltInIconRenderer,{_id:"intelligentForm__BotHeading__Icon",iconSettings:{builtIn:"LuSparkles"}}),ei=t.ikp("div",{_id:"intelligentForm__BotHeading__Name"}),de=i=>{const{baseSettings:e}=x.useInkeepConfig(),{organizationDisplayName:n}=e??{},{formConfig:{botName:r}}=m.useIntelligentForm();return o.jsx(ei,{children:r??n,...i})},ii=t.ikp("div",{_id:"intelligentForm__Loading"}),Fe=F.forwardRef(({...i},e)=>{const{loading:n}=m.useIntelligentForm(),r=F.useRef(null),l=S.useComposedRefs(e,r);return F.useEffect(()=>{n&&r.current&&r.current.scrollIntoView({behavior:"smooth",block:"nearest",inline:"nearest"})},[n]),n?o.jsx(ii,{ref:l,...i}):null}),ti=t.ikp("div",{_id:"intelligentForm__ConfidentResponse"}),ae=F.forwardRef(({...i},e)=>{const{aiResponse:n,loading:r}=m.useIntelligentForm(),l=F.useRef(null),s=S.useComposedRefs(e,l);return F.useEffect(()=>{!r&&n.answerConfidence&&l.current&&l.current.scrollIntoView({behavior:"smooth",block:"nearest",inline:"nearest"})},[r,n.answerConfidence]),n.answerConfidence?o.jsx(ti,{ref:s,...i}):null}),ni=t.ikp(Le.Markdown,{_id:"intelligentForm__ConfidentAnswer"}),ue=i=>{const{aiResponse:e}=m.useIntelligentForm();return o.jsx(ni,{shouldOpenLinksInNewTab:!0,children:e.answer,...i})},ri=t.ikp("button",{_id:"intelligentForm__ConfidentResponseButton",type:"button"}),ge=i=>{const{onClick:e,...n}=i,{showSecondaryFields:r,setShowSecondaryFields:l}=m.useIntelligentForm(),s=()=>{l(!0)};return o.jsx(ri,{"data-escalated":c.dataAttr(r),onClick:u.composeEventHandlers(e,s),...n})},Ie=t.ikp(p.BuiltInIconRenderer,{_id:"intelligentForm__ConfidentResponseButton__Icon",iconSettings:{builtIn:"LuUser"}}),_e=t.ikp("span",{_id:"intelligentForm__ConfidentResponseButton__Label",children:"Escalate to human"}),oi=t.ikp("div",{_id:"intelligentForm__SecondaryForm"}),pe=F.forwardRef(({...i},e)=>{const{showSecondaryFields:n}=m.useIntelligentForm(),r=F.useRef(null),l=S.useComposedRefs(e,r);return F.useEffect(()=>{n&&r.current&&r.current.scrollIntoView({behavior:"smooth",block:"nearest",inline:"nearest"})},[n]),n?o.jsx(oi,{ref:l,...i}):null}),li=t.ikp("p",{_id:"intelligentForm__SecondaryForm__Description"}),ve=i=>{const{formConfig:{secondary:e},aiResponse:{answerConfidence:n}}=m.useIntelligentForm();if(!e.description)return null;const r=typeof e.description=="string"?e.description:n?e.description.confident:e.description.default;return o.jsx(li,{children:r,...i})},mi=t.ikp("div",{_id:"intelligentForm__SecondaryFormFields"}),Pe=i=>{const{children:e,...n}=i,{formConfig:{secondary:r}}=m.useIntelligentForm();return o.jsx(mi,{children:c.maybeRender(e,r.fields),...n})},Se=t.ikp("button",{_id:"intelligentForm__SecondaryFormSubmit",type:"submit",children:"Submit"}),si=t.ikp("span",{_id:"intelligentForm__Error"}),fe=i=>{const{formError:e}=m.useIntelligentForm();return e?o.jsx(si,{children:e.message,...i}):null},Ce=t.ikp("div",{_id:"intelligentForm__Sources"}),he=t.ikp("p",{_id:"intelligentForm__SourcesCaption",children:"Here are the sources I considered:"}),ci=t.ikp("div",{_id:"intelligentForm__SourcesList"}),ke=i=>{const{children:e,...n}=i,{baseSettings:{transformSource:r,organizationDisplayName:l}}=x.useInkeepConfig(),{aiResponse:{recordsConsidered:s}}=m.useIntelligentForm();if(!s)return null;const d=s.reduce((a,v)=>{const _=r(v,"intelligentFormSource",{organizationDisplayName:l});return a.some(C=>C.url===_.url)||a.push(_),a},[]);return o.jsx(ci,{children:c.maybeRender(e,d),...n})},di=t.ikp(He.LinkWithQueryParams,{_id:"intelligentForm__Source"}),be=i=>{const{source:e,...n}=i;return o.jsx(h.SourceItemProvider,{source:{...e,isExternal:!!e.shouldOpenInNewTab},children:o.jsx(di,{"data-type":e.type,appendToUrl:e.appendToUrl,href:e.url,isExternal:e.shouldOpenInNewTab!==!1,...n})})},Fi=t.ikp(p.BuiltInIconRenderer,{_id:"intelligentForm__SourceIcon"}),ye=i=>{const{source:e}=h.useSourceItem();return o.jsx(Fi,{iconSettings:e.icon,"data-type":e.type,...i})},ai=t.ikp("span",{_id:"intelligentForm__SourceTitle"}),xe=i=>{const{source:e}=h.useSourceItem();return o.jsx(ai,{"data-type":e.type,children:e.title,...i})};exports.Provider=m.IntelligentFormProvider;exports.BotHeading=se;exports.BotHeadingIcon=ce;exports.BotHeadingName=de;exports.ConfidentAnswer=ue;exports.ConfidentResponse=ae;exports.ConfidentResponseButton=ge;exports.ConfidentResponseButtonIcon=Ie;exports.ConfidentResponseButtonLabel=_e;exports.Content=j;exports.ContentScrollArea=T;exports.ContentScrollAreaCorner=L;exports.ContentScrollAreaScrollbar=E;exports.ContentScrollAreaThumb=H;exports.ContentScrollAreaViewport=B;exports.Error=fe;exports.FormField=X;exports.FormFieldCheckbox=J;exports.FormFieldCheckboxIndicator=K;exports.FormFieldEmail=W;exports.FormFieldError=me;exports.FormFieldFile=$;exports.FormFieldLabel=Q;exports.FormFieldSelect=Y;exports.FormFieldSelectContent=te;exports.FormFieldSelectIcon=ie;exports.FormFieldSelectItem=re;exports.FormFieldSelectItemIndicator=le;exports.FormFieldSelectItemText=oe;exports.FormFieldSelectTrigger=Z;exports.FormFieldSelectValue=ee;exports.FormFieldSelectViewport=ne;exports.FormFieldText=f;exports.FormFieldTextArea=G;exports.Heading=A;exports.IntelligentFormPrimitiveBotHeading=se;exports.IntelligentFormPrimitiveBotHeadingIcon=ce;exports.IntelligentFormPrimitiveBotHeadingName=de;exports.IntelligentFormPrimitiveConfidentAnswer=ue;exports.IntelligentFormPrimitiveConfidentResponse=ae;exports.IntelligentFormPrimitiveConfidentResponseButton=ge;exports.IntelligentFormPrimitiveConfidentResponseButtonIcon=Ie;exports.IntelligentFormPrimitiveConfidentResponseButtonLabel=_e;exports.IntelligentFormPrimitiveContent=j;exports.IntelligentFormPrimitiveContentScrollArea=T;exports.IntelligentFormPrimitiveContentScrollAreaCorner=L;exports.IntelligentFormPrimitiveContentScrollAreaScrollbar=E;exports.IntelligentFormPrimitiveContentScrollAreaThumb=H;exports.IntelligentFormPrimitiveContentScrollAreaViewport=B;exports.IntelligentFormPrimitiveFormError=fe;exports.IntelligentFormPrimitiveFormField=X;exports.IntelligentFormPrimitiveFormFieldCheckbox=J;exports.IntelligentFormPrimitiveFormFieldCheckboxIndicator=K;exports.IntelligentFormPrimitiveFormFieldEmail=W;exports.IntelligentFormPrimitiveFormFieldError=me;exports.IntelligentFormPrimitiveFormFieldFile=$;exports.IntelligentFormPrimitiveFormFieldLabel=Q;exports.IntelligentFormPrimitiveFormFieldSelect=Y;exports.IntelligentFormPrimitiveFormFieldSelectContent=te;exports.IntelligentFormPrimitiveFormFieldSelectIcon=ie;exports.IntelligentFormPrimitiveFormFieldSelectItem=re;exports.IntelligentFormPrimitiveFormFieldSelectItemIndicator=le;exports.IntelligentFormPrimitiveFormFieldSelectItemText=oe;exports.IntelligentFormPrimitiveFormFieldSelectTrigger=Z;exports.IntelligentFormPrimitiveFormFieldSelectValue=ee;exports.IntelligentFormPrimitiveFormFieldSelectViewport=ne;exports.IntelligentFormPrimitiveFormFieldText=f;exports.IntelligentFormPrimitiveFormFieldTextArea=G;exports.IntelligentFormPrimitiveHeading=A;exports.IntelligentFormPrimitiveLoading=Fe;exports.IntelligentFormPrimitivePrimaryForm=O;exports.IntelligentFormPrimitivePrimaryFormDescription=M;exports.IntelligentFormPrimitivePrimaryFormFields=z;exports.IntelligentFormPrimitivePrimaryFormSubmit=U;exports.IntelligentFormPrimitiveRoot=w;exports.IntelligentFormPrimitiveSecondaryForm=pe;exports.IntelligentFormPrimitiveSecondaryFormDescription=ve;exports.IntelligentFormPrimitiveSecondaryFormFields=Pe;exports.IntelligentFormPrimitiveSecondaryFormSubmit=Se;exports.IntelligentFormPrimitiveSource=be;exports.IntelligentFormPrimitiveSourceIcon=ye;exports.IntelligentFormPrimitiveSourceTitle=xe;exports.IntelligentFormPrimitiveSources=Ce;exports.IntelligentFormPrimitiveSourcesCaption=he;exports.IntelligentFormPrimitiveSourcesList=ke;exports.IntelligentFormPrimitiveSuccess=V;exports.IntelligentFormPrimitiveSuccessHeading=D;exports.IntelligentFormPrimitiveSuccessIcon=q;exports.IntelligentFormPrimitiveSuccessMessage=N;exports.Loading=Fe;exports.PrimaryForm=O;exports.PrimaryFormDescription=M;exports.PrimaryFormFields=z;exports.PrimaryFormSubmit=U;exports.Root=w;exports.SecondaryForm=pe;exports.SecondaryFormDescription=ve;exports.SecondaryFormFields=Pe;exports.SecondaryFormSubmit=Se;exports.Source=be;exports.SourceIcon=ye;exports.SourceTitle=xe;exports.Sources=Ce;exports.SourcesCaption=he;exports.SourcesList=ke;exports.Success=V;exports.SuccessHeading=D;exports.SuccessIcon=q;exports.SuccessMessage=N;