@elevasis/ui 2.59.0 → 2.60.1

package/dist/features/public-agent-chat/index.d.ts

@@ -82,6 +82,25 @@ type MessageEvent = {
     error?: string;
 };
 
+/**
+ * A single intake field definition stored in agent_access_grants.capture_fields.
+ *
+ * - key: machine identifier (e.g. "name", "company")
+ * - label: display label shown to the visitor
+ * - type: input type hint; defaults to "text" when absent
+ * - required: whether the visitor must fill this field; defaults to false
+ */
+declare const CaptureFieldSchema: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        text: "text";
+        tel: "tel";
+    }>>;
+    required: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type CaptureField = z.infer<typeof CaptureFieldSchema>;
 /**
  * The public-facing grant shape returned by /authorize and /metadata endpoints.
  *
@@ -162,7 +181,32 @@ interface PublicAgentChatConnectionState {
 
 /**
  * Context passed to the `renderIntro` render-prop. Provides the start action,
- * loading state, resolved display strings, raw branding, and the agent slug.
+ * loading state, resolved display strings, raw branding, the agent slug, and the
+ * grant's intake (`captureFields`) surface so a custom intro can render the same
+ * welcome form the default intro draws.
+ *
+ * A minimal custom intro that renders the intake form looks like:
+ *
+ * ```tsx
+ * renderIntro={({ start, starting, captureFields, intakeValues, setIntakeValue }) => (
+ *   <Stack>
+ *     <Title>Welcome!</Title>
+ *     {captureFields.map((field) => (
+ *       <TextInput
+ *         key={field.key}
+ *         label={field.label}
+ *         required={field.required ?? false}
+ *         value={intakeValues[field.key] ?? ''}
+ *         onChange={(e) => setIntakeValue(field.key, e.currentTarget.value)}
+ *       />
+ *     ))}
+ *     <Button onClick={start} loading={starting}>Start</Button>
+ *   </Stack>
+ * )}
+ * ```
+ *
+ * Values written via `setIntakeValue` flow into the session `metadata` on `start()`
+ * exactly as the default intro's form does (so `name` titles the session).
  */
 interface PublicAgentIntroRenderContext {
     /** Begins the authorize → session flow (the same action the default CTA runs). */
@@ -175,6 +219,12 @@ interface PublicAgentIntroRenderContext {
     /** Raw grant branding record, so a custom intro can still read intro/instructions/etc. if it wants. */
     branding: Record<string, unknown>;
     slug: string;
+    /** The grant's resolved, validated intake fields (`[]` when none). Map these to inputs. */
+    captureFields: CaptureField[];
+    /** Current collected intake values, keyed by `CaptureField.key`. */
+    intakeValues: Record<string, string>;
+    /** Writes a single intake value; flows into session metadata on `start()`. */
+    setIntakeValue: (key: string, value: string) => void;
 }
 interface PublicAgentChatProps {
     apiUrl: string;
@@ -232,4 +282,4 @@ declare const publicAgentChatKeys: {
 };
 
 export { PublicAgentChat, PublicAgentChatRoutePage, publicAgentChatKeys, usePublicAgentChatMessages, usePublicAgentChatWebSocket };
-export type { PublicAgentChatAuthorizeResponse, PublicAgentChatConnectionState, PublicAgentChatGrant, PublicAgentChatMessagesResponse, PublicAgentChatMetadataResponse, PublicAgentChatProps, PublicAgentChatRoutePageProps, PublicAgentChatSessionResponse, PublicAgentIntroRenderContext };
+export type { CaptureField, PublicAgentChatAuthorizeResponse, PublicAgentChatConnectionState, PublicAgentChatGrant, PublicAgentChatMessagesResponse, PublicAgentChatMetadataResponse, PublicAgentChatProps, PublicAgentChatRoutePageProps, PublicAgentChatSessionResponse, PublicAgentIntroRenderContext };

package/dist/features/public-agent-chat/index.js

@@ -462,6 +462,9 @@ function PublicAgentChatFrame({
     }
   );
 }
+function mergeIntakeMetadata(metadata, intakeValues) {
+  return Object.keys(intakeValues).length > 0 ? { ...intakeValues, ...metadata } : metadata;
+}
 function PublicAgentChat({
   apiUrl,
   slug,
@@ -483,6 +486,9 @@ function PublicAgentChat({
   const [input, setInput] = useState("");
   const [isCreatingSession, setIsCreatingSession] = useState(false);
   const [intakeValues, setIntakeValues] = useState({});
+  const setIntakeValue = useCallback((key, value) => {
+    setIntakeValues((prev) => ({ ...prev, [key]: value }));
+  }, []);
   const autoStartedRef = useRef(false);
   const greetingTimeRef = useRef(/* @__PURE__ */ new Date());
   const displayTitle = resolveAgentTitle(title, slug, grant);
@@ -525,7 +531,7 @@ function PublicAgentChat({
   }, [apiUrl, slug, renderIntro]);
   const pendingFirstMessageRef = useRef(null);
   const authorize = useCallback(
-    async (code) => {
+    async (code, onSuccessStatus = "ready") => {
       if (!grant) return;
       try {
         setError(null);
@@ -542,7 +548,7 @@ function PublicAgentChat({
           }
         );
         setCapabilityToken(authorization.capabilityToken);
-        setStatus("ready");
+        setStatus(onSuccessStatus);
       } catch (requestError) {
         setError(requestError instanceof Error ? requestError.message : "Unable to start agent chat");
         setStatus(grant.requiresCode ? "code-required" : "error");
@@ -552,6 +558,7 @@ function PublicAgentChat({
   );
   const createSession = useCallback(
     async (boundCapabilityToken) => {
+      const mergedMetadata = mergeIntakeMetadata(metadata, intakeValues);
       const createdSession = await fetchJson(
         `${apiUrl}/api/public/agent-chat/${encodeURIComponent(slug)}/sessions`,
         {
@@ -559,7 +566,7 @@ function PublicAgentChat({
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({
             capabilityToken: boundCapabilityToken,
-            ...metadata ? { metadata } : {}
+            ...mergedMetadata ? { metadata: mergedMetadata } : {}
           })
         }
       );
@@ -568,7 +575,7 @@ function PublicAgentChat({
       onSessionReady?.(createdSession);
       return createdSession;
     },
-    [apiUrl, slug, metadata, onSessionReady]
+    [apiUrl, slug, metadata, intakeValues, onSessionReady]
   );
   const startSession = useCallback(
     async (code) => {
@@ -588,7 +595,7 @@ function PublicAgentChat({
           }
         );
         setCapabilityToken(authorization.capabilityToken);
-        const mergedMetadata = Object.keys(intakeValues).length > 0 ? { ...intakeValues, ...metadata } : metadata;
+        const mergedMetadata = mergeIntakeMetadata(metadata, intakeValues);
         const createdSession = await fetchJson(
           `${apiUrl}/api/public/agent-chat/${encodeURIComponent(slug)}/sessions`,
           {
@@ -611,6 +618,21 @@ function PublicAgentChat({
     },
     [apiUrl, grant, intakeValues, metadata, onSessionReady, slug, visitorId]
   );
+  const beginSession = useCallback(async () => {
+    if (capabilityToken) {
+      try {
+        setError(null);
+        setStatus("authorizing");
+        await createSession(capabilityToken);
+        setStatus("ready");
+      } catch (requestError) {
+        setError(requestError instanceof Error ? requestError.message : "Unable to start agent chat");
+        setStatus(grant?.requiresCode ? "code-required" : "error");
+      }
+      return;
+    }
+    await startSession();
+  }, [capabilityToken, createSession, startSession, grant]);
   useEffect(() => {
     if (!grant || grant.requiresCode || renderIntro || hasIntroContent(grant) || resolveCaptureFields(grant).length > 0 || autoStartedRef.current) {
       return;
@@ -696,7 +718,9 @@ function PublicAgentChat({
               {
                 onSubmit: (event) => {
                   event.preventDefault();
-                  void startSession(accessCode);
+                  if (!grant) return;
+                  const next = renderIntro || hasIntroContent(grant) || resolveCaptureFields(grant).length > 0 ? "intro" : "ready";
+                  void authorize(accessCode, next);
                 },
                 children: /* @__PURE__ */ jsxs(Stack, { children: [
                   /* @__PURE__ */ jsxs(Group, { gap: "xs", children: [
@@ -728,13 +752,16 @@ function PublicAgentChat({
     if (renderIntro) {
       const ctx = {
         start: () => {
-          void startSession();
+          void beginSession();
         },
         starting: status === "authorizing",
         title: displayTitle,
         subtitle: displaySubtitle,
         branding,
-        slug
+        slug,
+        captureFields: resolveCaptureFields(grant),
+        intakeValues,
+        setIntakeValue
       };
       return /* @__PURE__ */ jsx(
         PublicAgentChatFrame,
@@ -784,10 +811,7 @@ function PublicAgentChat({
                   type: field.type ?? "text",
                   required: field.required ?? false,
                   value: intakeValues[field.key] ?? "",
-                  onChange: (event) => {
-                    const value = event.currentTarget.value;
-                    setIntakeValues((prev) => ({ ...prev, [field.key]: value }));
-                  },
+                  onChange: (event) => setIntakeValue(field.key, event.currentTarget.value),
                   autoComplete: field.type === "email" ? "email" : field.type === "tel" ? "tel" : "off"
                 },
                 field.key
@@ -796,7 +820,7 @@ function PublicAgentChat({
                 Button,
                 {
                   onClick: () => {
-                    void startSession();
+                    void beginSession();
                   },
                   leftSection: /* @__PURE__ */ jsx(IconSend, { size: 16 }),
                   children: ctaLabel

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/ui",
-  "version": "2.59.0",
+  "version": "2.60.1",
   "description": "UI components and platform-aware hooks for building custom frontends on the Elevasis platform",
   "type": "module",
   "license": "MIT",
@@ -276,8 +276,8 @@
     "vitest": "^3.2.4",
     "@elevasis/sdk": "1.36.5",
     "@repo/core": "0.52.0",
-    "@repo/elevasis-core": "1.0.0",
     "@repo/typescript-config": "0.0.0",
+    "@repo/elevasis-core": "1.0.0",
     "@repo/eslint-config": "0.0.0"
   },
   "dependencies": {