@elevasis/ui 2.59.0 → 2.60.0

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

@@ -483,6 +483,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);
@@ -734,7 +737,10 @@ function PublicAgentChat({
         title: displayTitle,
         subtitle: displaySubtitle,
         branding,
-        slug
+        slug,
+        captureFields: resolveCaptureFields(grant),
+        intakeValues,
+        setIntakeValue
       };
       return /* @__PURE__ */ jsx(
         PublicAgentChatFrame,
@@ -784,10 +790,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/ui",
-  "version": "2.59.0",
+  "version": "2.60.0",
   "description": "UI components and platform-aware hooks for building custom frontends on the Elevasis platform",
   "type": "module",
   "license": "MIT",
@@ -274,11 +274,11 @@
     "typescript": "5.9.2",
     "vite": "^7.0.0",
     "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/eslint-config": "0.0.0"
+    "@repo/eslint-config": "0.0.0",
+    "@elevasis/sdk": "1.36.5"
   },
   "dependencies": {
     "@dagrejs/dagre": "^1.1.4",