diff --git a/README.md b/README.md
index 0c1d28c..e24b3cb 100644
--- a/README.md
+++ b/README.md
@@ -11,5 +11,7 @@ Our experimental design involves two phases: one for artists and another for the
 
 We plan to continue this research in a second part through a longitudinal field study.
 
+Developer documentation for the creator dataset is in [`src/pages/artist/README.md`](src/pages/artist/README.md).
+
 1. Kwan, L. Y. -Y., Leung, A. K. -y., & Liou, S. (2018). Culture, creativity, and innovation. Journal of Cross-Cultural Psychology, 49(2), 165–170. https://doi.org/10.1177/0022022117753306s
 2. Elisondo, R. (2016). Creativity is Always a Social Process. Creativity. Theories – Research - Applications, 3(2), 2016. 194-210. https://doi.org/10.1515/ctra-2016-0013
diff --git a/server/api/routes/firebaseAPI.ts b/server/api/routes/firebaseAPI.ts
index 5fbc4aa..6f257ac 100644
--- a/server/api/routes/firebaseAPI.ts
+++ b/server/api/routes/firebaseAPI.ts
@@ -11,9 +11,23 @@ const ASSIGNMENT_COLLECTION = "artistAssignment";
 
 router.post("/artist-assignment", async (req, res) => {
   try {
-    const { sessionId, passageId, prolificPid } = req.body;
-    if (!sessionId || !passageId) {
-      return res.status(400).json({ error: "Missing sessionId or passageId" });
+    const {
+      sessionId,
+      passageId,
+      tutorialPassageId,
+      passagePoolVersion,
+      prolificPid,
+    } = req.body;
+    if (
+      !sessionId ||
+      !passageId ||
+      !tutorialPassageId ||
+      !passagePoolVersion
+    ) {
+      return res.status(400).json({
+        error:
+          "Missing sessionId, passageId, tutorialPassageId, or passagePoolVersion",
+      });
     }
 
     const assignmentRef = db.collection(ASSIGNMENT_COLLECTION).doc(sessionId);
@@ -21,8 +35,40 @@ router.post("/artist-assignment", async (req, res) => {
       const existingAssignment = await transaction.get(assignmentRef);
       if (existingAssignment.exists) {
         const existing = existingAssignment.data()!;
+        const taskPassageId = String(
+          existing.taskPassageId ?? existing.passageId,
+        );
+        const resolvedTutorialPassageId = String(
+          existing.tutorialPassageId ??
+            (tutorialPassageId === taskPassageId
+              ? passageId
+              : tutorialPassageId),
+        );
+        const resolvedPassagePoolVersion = String(
+          existing.passagePoolVersion ?? "legacy-creator-passages",
+        );
+
+        if (
+          !existing.taskPassageId ||
+          !existing.tutorialPassageId ||
+          !existing.passagePoolVersion
+        ) {
+          transaction.set(
+            assignmentRef,
+            {
+              taskPassageId,
+              tutorialPassageId: resolvedTutorialPassageId,
+              passagePoolVersion: resolvedPassagePoolVersion,
+            },
+            { merge: true },
+          );
+        }
+
         return {
-          passageId: existing.passageId as string,
+          passageId: taskPassageId,
+          taskPassageId,
+          tutorialPassageId: resolvedTutorialPassageId,
+          passagePoolVersion: resolvedPassagePoolVersion,
           condition: existing.condition as "LLM" | "NO_AI",
           strategy: existing.strategy as string,
         };
@@ -36,12 +82,22 @@ router.post("/artist-assignment", async (req, res) => {
         sessionId,
         prolificPid: prolificPid || null,
         passageId: String(passageId),
+        taskPassageId: String(passageId),
+        tutorialPassageId: String(tutorialPassageId),
+        passagePoolVersion: String(passagePoolVersion),
         condition,
         strategy,
         assignedAt: FieldValue.serverTimestamp(),
       });
 
-      return { passageId: String(passageId), condition, strategy };
+      return {
+        passageId: String(passageId),
+        taskPassageId: String(passageId),
+        tutorialPassageId: String(tutorialPassageId),
+        passagePoolVersion: String(passagePoolVersion),
+        condition,
+        strategy,
+      };
     });
 
     res.json(assignment);
diff --git a/src/components/chatbot/Chatbot.tsx b/src/components/chatbot/Chatbot.tsx
index dc36fd5..5895ffe 100644
--- a/src/components/chatbot/Chatbot.tsx
+++ b/src/components/chatbot/Chatbot.tsx
@@ -10,18 +10,21 @@ import { FiSend } from "react-icons/fi";
 import { Button, Textarea } from "@chakra-ui/react";
 import { nanoid } from "nanoid";
 import type {
-  ChatOpening,
+  ChatAvailability,
+  ChatInputActivity,
+  ChatInputSource as ChatInputSourceType,
   LlmRequestLog,
   Message,
   Stage,
 } from "../../types";
-import { Role } from "../../types";
+import { ChatInputSource, MessageKind, Role } from "../../types";
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
 import { DataContext } from "../../App";
 import {
   createAssistantMessage,
   IDLE_NUDGE_MESSAGES,
+  STAGE_OPENING_MESSAGES,
 } from "../../consts/chatMessages";
 
 interface ChatTabProps {
@@ -31,12 +34,14 @@ interface ChatTabProps {
   selectedWordIndexes?: number[];
   passage: string;
   chatReady?: boolean;
-  onChatOpened?: (opening: ChatOpening) => void;
+  initialInputActivity?: ChatInputActivity;
+  onChatAvailable?: (availability: ChatAvailability) => void;
+  onInputActivityUpdate?: (activity: ChatInputActivity) => void;
   onRequestUpdate?: (request: LlmRequestLog) => void;
 }
 
 export const BLACKOUT_ASSISTANT_PROMPT_VERSION =
-  "blackout-assistant-2026-08-04-v1";
+  "blackout-assistant-2026-08-05-v2";
 
 /**
  * Keep the locator-excerpt convention identical across both stages so users
@@ -50,9 +55,10 @@ Blackout poetry: the poet starts with an existing passage and creates a poem by
 
 Grounding:
 - Work only with the passage provided below. Never reference or substitute any other text.
-- When you point to a specific passage word, show it in a short excerpt containing two or three nearby passage words in total when available. Bold only the word you are pointing to. The unbolded words are only a locator to help the user find it; they are not part of the suggestion.
+- When you point to a specific passage word, show it in a short excerpt containing two or three nearby passage words in total when available. Bold only the word you are pointing to and italicize every surrounding locator word. For example: “*nights are* **clear**” or “*sharp,* **glittering** *sunshine*”. The italicized words are only locators to help the user find the bolded word; they are not part of the suggestion.
 - Quote passage words exactly as written, keep multiple suggested words in passage order, and point to at most five words in a single response.
 - Use bold only for passage words you are pointing to, never for general emphasis.
+- Use italics only for the surrounding locator words in these excerpts, never for general emphasis.
 - Never suggest a word that does not appear in the passage.
 
 Style and behavior:
@@ -161,7 +167,9 @@ export default function ChatTab({
   stage,
   passage,
   chatReady = true,
-  onChatOpened,
+  initialInputActivity,
+  onChatAvailable,
+  onInputActivityUpdate,
   onRequestUpdate,
 }: ChatTabProps) {
   const context = useContext(DataContext);
@@ -171,7 +179,18 @@ export default function ChatTab({
   const chatContainerRef = useRef<HTMLDivElement>(null);
   const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const stageStartMessageCountRef = useRef(messages.length);
-  const hasLoggedOpeningRef = useRef(false);
+  const hasLoggedAvailabilityRef = useRef(false);
+  const inputRef = useRef("");
+  const hasDraftRef = useRef(false);
+  const inputActivityRef = useRef<ChatInputActivity>(
+    initialInputActivity ?? {
+      stage,
+      focusCount: 0,
+      draftStartCount: 0,
+      abandonedDraftCount: 0,
+      hasUnsentDraft: false,
+    },
+  );
 
   const [isLLMLoading, setIsLLMLoading] = useState(false);
   const [input, setInput] = useState("");
@@ -205,10 +224,29 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
   }, [passage, selectedWordIndexes, stage]);
 
   useEffect(() => {
-    if (!chatReady || hasLoggedOpeningRef.current) return;
-    hasLoggedOpeningRef.current = true;
-    onChatOpened?.({ stage, timestamp: new Date() });
-  }, [chatReady, onChatOpened, stage]);
+    if (!chatReady || hasLoggedAvailabilityRef.current) return;
+    hasLoggedAvailabilityRef.current = true;
+
+    const availableAt = new Date();
+    setMessages((previousMessages) => {
+      const alreadyHasOpening = previousMessages.some(
+        (message) =>
+          message.stage === stage &&
+          message.kind === MessageKind.STAGE_OPENING,
+      );
+      return alreadyHasOpening
+        ? previousMessages
+        : [
+            ...previousMessages,
+            createAssistantMessage(
+              STAGE_OPENING_MESSAGES[stage],
+              stage,
+              MessageKind.STAGE_OPENING,
+            ),
+          ];
+    });
+    onChatAvailable?.({ stage, availableAt });
+  }, [chatReady, onChatAvailable, setMessages, stage]);
 
   useEffect(() => {
     const element = chatContainerRef.current;
@@ -226,7 +264,11 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
     timeoutRef.current = setTimeout(() => {
       setMessages((previousMessages) => [
         ...previousMessages,
-        createAssistantMessage(IDLE_NUDGE_MESSAGES[stage]),
+        createAssistantMessage(
+          IDLE_NUDGE_MESSAGES[stage],
+          stage,
+          MessageKind.IDLE_NUDGE,
+        ),
       ]);
       setHasShownIdleNudge(true);
     }, 40000);
@@ -245,8 +287,66 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
     stage,
   ]);
 
-  const sendMessage = async (messageContent?: string) => {
-    const content = messageContent || input;
+  const publishInputActivity = (activity: ChatInputActivity) => {
+    inputActivityRef.current = activity;
+    onInputActivityUpdate?.(activity);
+  };
+
+  const handleInputFocus = () => {
+    const activity = inputActivityRef.current;
+    publishInputActivity({
+      ...activity,
+      firstFocusedAt: activity.firstFocusedAt ?? new Date(),
+      focusCount: activity.focusCount + 1,
+    });
+  };
+
+  const handleInputChange = (value: string) => {
+    const hadDraft = hasDraftRef.current;
+    const hasDraft = Boolean(value.trim());
+    inputRef.current = value;
+    hasDraftRef.current = hasDraft;
+    setInput(value);
+
+    if (!hadDraft && hasDraft) {
+      const activity = inputActivityRef.current;
+      publishInputActivity({
+        ...activity,
+        firstTypedAt: activity.firstTypedAt ?? new Date(),
+        draftStartCount: activity.draftStartCount + 1,
+        hasUnsentDraft: true,
+      });
+    } else if (hadDraft && !hasDraft) {
+      const activity = inputActivityRef.current;
+      publishInputActivity({
+        ...activity,
+        abandonedDraftCount: activity.abandonedDraftCount + 1,
+        hasUnsentDraft: false,
+      });
+    }
+  };
+
+  const markDraftSubmittedOrReplaced = (
+    inputSource: ChatInputSourceType,
+  ) => {
+    if (!hasDraftRef.current) return;
+
+    hasDraftRef.current = false;
+    const activity = inputActivityRef.current;
+    publishInputActivity({
+      ...activity,
+      abandonedDraftCount:
+        activity.abandonedDraftCount +
+        (inputSource === ChatInputSource.SUGGESTION ? 1 : 0),
+      hasUnsentDraft: false,
+    });
+  };
+
+  const sendMessage = async (
+    messageContent?: string,
+    inputSource: ChatInputSourceType = ChatInputSource.TYPED,
+  ) => {
+    const content = messageContent ?? inputRef.current;
     if (!content.trim() || isLLMLoading) return;
 
     if (timeoutRef.current) {
@@ -259,6 +359,9 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
       role: Role.ARTIST,
       content,
       timestamp: new Date(),
+      stage,
+      kind: MessageKind.USER_MESSAGE,
+      inputSource,
     };
     const requestId = nanoid();
     let requestLog: LlmRequestLog = {
@@ -268,6 +371,7 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
       userMessageContent: content,
       requestedAt: new Date(),
       status: "STARTED",
+      inputSource,
       systemPrompt: systemMessage.content,
       promptVersion: BLACKOUT_ASSISTANT_PROMPT_VERSION,
     };
@@ -281,6 +385,8 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
     setMarkdownOutput("");
     setSendError(null);
     setMessages((prev) => [...prev, artistMessage]);
+    markDraftSubmittedOrReplaced(inputSource);
+    inputRef.current = "";
     setInput("");
     setIsLLMLoading(true);
 
@@ -320,6 +426,8 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
         role: Role.LLM,
         content: fullText,
         timestamp: new Date(),
+        stage,
+        kind: MessageKind.LLM_RESPONSE,
       };
       requestLog = {
         ...requestLog,
@@ -347,9 +455,15 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
       setMessages((previousMessages) =>
         previousMessages.filter((message) => message.id !== artistMessage.id),
       );
-      setInput((currentInput) =>
-        currentInput.trim() ? currentInput : content,
-      );
+      if (!inputRef.current.trim()) {
+        inputRef.current = content;
+        hasDraftRef.current = true;
+        setInput(content);
+        publishInputActivity({
+          ...inputActivityRef.current,
+          hasUnsentDraft: true,
+        });
+      }
     } finally {
       setIsLLMLoading(false);
     }
@@ -363,7 +477,7 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
   };
 
   const handlePromptSelection = (prompt: string) => {
-    sendMessage(prompt);
+    sendMessage(prompt, ChatInputSource.SUGGESTION);
   };
 
   return (
@@ -447,7 +561,8 @@ CURRENT SELECTED WORDS (in passage order): ${selectedWords || "none yet"}`,
           >
             <Textarea
               value={input}
-              onChange={(e) => setInput(e.target.value)}
+              onFocus={handleInputFocus}
+              onChange={(e) => handleInputChange(e.target.value)}
               onKeyDown={handleKeyDown}
               placeholder="Type a message..."
               className="text-main bg-white flex-1 px-3 py-2 border rounded-md focus:outline-none focus:ring-2 focus:ring-grey"
diff --git a/src/components/shared/pages/multiPage.tsx b/src/components/shared/pages/multiPage.tsx
index 8678f89..6da1f50 100644
--- a/src/components/shared/pages/multiPage.tsx
+++ b/src/components/shared/pages/multiPage.tsx
@@ -2,7 +2,8 @@ import { useState, useRef, useEffect, useCallback } from "react";
 import { Textarea, Button } from "@chakra-ui/react";
 import ChatTab from "../../chatbot/Chatbot";
 import type {
-  ChatOpening,
+  ChatAvailability,
+  ChatInputActivity,
   LlmRequestLog,
   Message,
   Stage,
@@ -29,7 +30,9 @@ interface PageTemplateProps {
   setNotes: React.Dispatch<React.SetStateAction<string>>;
   passage: string;
   selectedWordIndexes?: number[];
-  onChatOpened?: (opening: ChatOpening) => void;
+  initialInputActivity?: ChatInputActivity;
+  onChatAvailable?: (availability: ChatAvailability) => void;
+  onInputActivityUpdate?: (activity: ChatInputActivity) => void;
   onRequestUpdate?: (request: LlmRequestLog) => void;
 }
 
@@ -55,7 +58,9 @@ function MultiPageTemplate({
   setNotes,
   selectedWordIndexes,
   passage,
-  onChatOpened,
+  initialInputActivity,
+  onChatAvailable,
+  onInputActivityUpdate,
   onRequestUpdate,
 }: PageTemplateProps) {
   const [leftWidth, setLeftWidth] = useState(70); // %
@@ -299,7 +304,9 @@ function MultiPageTemplate({
                 passage={passage}
                 selectedWordIndexes={selectedWordIndexes}
                 chatReady={chatReady}
-                onChatOpened={onChatOpened}
+                initialInputActivity={initialInputActivity}
+                onChatAvailable={onChatAvailable}
+                onInputActivityUpdate={onInputActivityUpdate}
                 onRequestUpdate={onRequestUpdate}
               />
             </div>
diff --git a/src/consts/chatMessages.ts b/src/consts/chatMessages.ts
index 3f4058d..24fbbd0 100644
--- a/src/consts/chatMessages.ts
+++ b/src/consts/chatMessages.ts
@@ -1,5 +1,5 @@
 import { nanoid } from "nanoid";
-import type { Message, Stage } from "../types";
+import type { Message, MessageKind, Stage } from "../types";
 import { Role } from "../types";
 
 export const STAGE_OPENING_MESSAGES: Record<Stage, string> = {
@@ -16,9 +16,15 @@ export const IDLE_NUDGE_MESSAGES: Record<Stage, string> = {
     "If you're stuck, tell me the feeling you're going for, or ask me to point out a few usable words.",
 };
 
-export const createAssistantMessage = (content: string): Message => ({
+export const createAssistantMessage = (
+  content: string,
+  stage: Stage,
+  kind: MessageKind,
+): Message => ({
   id: nanoid(),
   role: Role.LLM,
   content,
   timestamp: new Date(),
+  stage,
+  kind,
 });
diff --git a/src/consts/dataLogging.ts b/src/consts/dataLogging.ts
new file mode 100644
index 0000000..88ea2c5
--- /dev/null
+++ b/src/consts/dataLogging.ts
@@ -0,0 +1 @@
+export const ARTIST_DATA_LOGGING_VERSION = "artist-data-2026-08-05-v2";
diff --git a/src/consts/passages.tsx b/src/consts/passages.tsx
index 2d7cd6c..ebdcb03 100644
--- a/src/consts/passages.tsx
+++ b/src/consts/passages.tsx
@@ -1,46 +1,87 @@
 import type { Passage } from "../types";
 
+export const CREATOR_PASSAGE_POOL_VERSION =
+  "creator-passages-2026-08-05-v1";
+
 export const Passages: Passage[] = [
-  // {
-  //   id: "1",
-  //   text: `The wind swept in soft big breaths down from the moor and was strange with a wild clear scented sweetness. Colin kept lifting his thin chest to draw it in, and his big eyes looked as if it were they which were listening - listening, instead of his ears. "There are so many sounds of singing and humming and calling out," he said. "What is that scent the puffs of wind bring?" "It's gorse on th' moor that's openin' out" answered Dickon. "Eh! th' bees are at it wonderful to-day." Not a human creature was to be caught sight of in the paths they took. In fact every gardener or gardener's lad had been witched away. But they wound in and out among the shrubbery and out and round the fountain beds, following their carefully planned route for the mere mysterious pleasure of it. But when at last they turned into the Long Walk by the ivied walls the excited sense of an approaching thrill made them, for some curious reason they could not have explained, begin to speak in whispers. "This is it" breathed Mary. "This is where I used to walk up and down and wonder and wonder".`,
-  //   author: "Frances Hodson Burnett",
-  //   title: "The Secret Garden",
-  // },
-  // {
-  //   id: "2",
-  //   text: "Two days later they arrived on the Common. The doctors had arranged to have Sylvia in the cottage, and had got permission from a farmer for the girls to camp in the field of a farm nearby. They had fixed that they should come every day for their middle-day meal at the cottage, for which Pauline was to pay a pound a week. For breakfast, tea, and supper they were to cook and cater for themselves. Perhaps it was because they were not expecting a holiday at all, or perhaps because it was Pauline’s holiday which she had paid for, but there was not one second which they did not find perfect. They took turns to cook, and it was lovely waking in the mornings to hear the cows mooing, and the cocks crowing, and to turn over and prod the day’s cook to get up and deal with breakfast. The palliasses stuffed with straw they found gloriously comfortable, and it was the height of luxury to lie on them sniffing the first smoke of the fire through the open flap of the tent before jumping up to race down to the stream in a bathing dress for a wash before breakfast. ",
-  //   author: "Noel Streatfeild",
-  //   title: "Ballet Shoes",
-  // },
-  // {
-  //   id: "3",
-  //   text: "The food varied a lot with who was cooking and catering. Eggs were the easiest things for breakfast, because they bought them from the farm; but for supper they had all sorts of things — sausages when Petrova was in charge, and two courses at least from Pauline. When Posy was catering, a great deal of cake got into the menu. The weather was not too good, but the farmer lent them a large barn for wet days, in which they practised every morning, wet or shine, as they had, of course, their ballet shoes with them; here, when it rained, they played a new and glorious kind of hide-and-seek. It consisted in the hiders burying themselves in the straw, which the nervous seeker had to prod. If the hider could grab any part of the seeker, she won; but if the seeker could see a movement in the hay, and lay a hand on the place, and say ‘One of you is here’, then she won. The game was such a thrilling one that when it was wet Sylvia and the two doctors usually came and played too.",
-  //   author: "Noel Streatfeild",
-  //   title: "Ballet Shoes",
-  // },
+  {
+    id: "3",
+    text: "The wind swept in soft big breaths down from the moor and was strange with a wild clear scented sweetness. Colin kept lifting his thin chest to draw it in, and his big eyes looked as if it were they which were listening - listening, instead of his ears. \"There are so many sounds of singing and humming and calling out,\" he said. \"What is that scent the puffs of wind bring?\" \"It's gorse on th' moor that's openin' out\" answered Dickon. \"Eh! th' bees are at it wonderful to-day.\" Not a human creature was to be caught sight of in the paths they took. In fact every gardener or gardener's lad had been witched away. But they wound in and out among the shrubbery and out and round the fountain beds, following their carefully planned route for the mere mysterious pleasure of it. But when at last they turned into the Long Walk by the ivied walls the excited sense of an approaching thrill made them, for some curious reason they could not have explained, begin to speak in whispers.",
+    author: "Frances Hodson Burnett",
+    title: "The Secret Garden",
+  },
+  {
+    id: "4",
+    text: "Two days later they arrived on the Common. The doctors had arranged to have Sylvia in the cottage, and had got permission from a farmer for the girls to camp in the field of a farm nearby. They had fixed that they should come every day for their middle-day meal at the cottage, for which Pauline was to pay a pound a week. For breakfast, tea, and supper they were to cook and cater for themselves. Perhaps it was because they were not expecting a holiday at all, or perhaps because it was Pauline’s holiday which she had paid for, but there was not one second which they did not find perfect. They took turns to cook, and it was lovely waking in the mornings to hear the cows mooing, and the cocks crowing, and to turn over and prod the day’s cook to get up and deal with breakfast.",
+    author: "Noel Streatfeild",
+    title: "Ballet Shoes",
+  },
   {
     id: "2",
-    text: `"Look at that arch of pale green sky over those houses and picture to yourself what it must look like over the purply-dark beech-woods back of Avonlea." "What are you going to wear for commencement, Jane?" asked Ruby practically. Jane and Josie both answered at once and the chatter drifted into a side eddy of fashions. But Anne, with her elbows on the window sill, her soft cheek laid against her clasped hands, and her eyes filled with visions, looked out unheedingly across city roof and spire to that glorious dome of sunset sky and wove her dreams of a possible future from the golden tissue of youth's own optimism.`,
+    text: "\"Next to trying and winning, the best thing is trying and failing. Girls, don't talk about exams! Look at that arch of pale green sky over those houses and picture to yourself what it must look like over the purply-dark beech-woods back of Avonlea.\" \"What are you going to wear for commencement, Jane?\" asked Ruby practically. Jane and Josie both answered at once and the chatter drifted into a side eddy of fashions. But Anne, with her elbows on the window sill, her soft cheek laid against her clasped hands, and her eyes filled with visions, looked out unheedingly across city roof and spire to that glorious dome of sunset sky and wove her dreams of a possible future from the golden tissue of youth's own optimism. All the Beyond was hers with its possibilities lurking rosily in the oncoming years — each year a rose of promise to be woven into an immortal chaplet.",
     author: "Lucy Maud Montgomery",
     title: "Anne of Green Gables",
   },
-  // {
-  //   id: "5",
-  //   text: `A woman who was so hard on herself and others could be sweet and smiling with Clara and at times, by extension, with Blanca. Only with Clara did she allow herself the luxury of giving in to her overwhelming desire to serve and be loved; with her, however slyly, she was able to express the secret, most delicate yearnings of her soul. e long years of solitude and unhappiness had distilled her emotions and purified her feelings down to a few terrible, magnificent passions, which possessed her totally. She had no gift for small perturbations, mean-spirited resentments, concealed envies, works of charity, faded endearments, ordinary friendly politeness, or day-to-day acts of kindness. She was one of those people who are born for the greatness of a single love, for exaggerated hatred, for apocalyptic vengeance, and for the most sublime forms of heroism, but she was unable to shape her fate to the dimensions of her amorous vocation, so it was lived out as something flat and gray trapped between her mother’s sickroom walls, wretched tenements, and the tortured confessions with which this large, opulent, hot-blooded woman—made for maternity, abundance, action, and ardor—was consuming herself.`,
-  //   author: "Isabel Allende",
-  //   title: "The House of Spirits",
-  // },
   {
     id: "1",
-    text: `The nights are clear, but suffused with sloth and sullen expectation. But by early June the southwest monsoon breaks and there are three months of wind and water with short spells of sharp, glittering sunshine that thrilled children snatch to play with. The countryside turns an immodest green. Boundaries blur as tapioca fences take root and bloom. Brick walls turn moss green. Pepper vines snake up electric poles. Wild creepers burst through laterite banks and spill across flooded roads. Boats ply in the bazaars. And small fish appear in the puddles that fill the PWD potholes on the highways. It was raining when Rahel came back to Ayemenem. Slanting silver ropes slammed into loose earth, plowing it up like gunfire. The old house on the hill wore its steep, gabled roof pulled over its ears like a low hat. The walls, streaked with moss, had grown soft, and bulged a little with dampness that seeped up from the ground. The wild, overgrown garden was full of the whisper and scurry of small lives. In the undergrowth a rat snake rubbed itself against a glistening stone. Hopeful yellow bullfrogs cruised the scummy pond for mates. A drenched mongoose flashed across the leaf-strewn driveway.`,
+    text: "The nights are clear, but suffused with sloth and sullen expectation. But by early June the southwest monsoon breaks and there are three months of wind and water with short spells of sharp, glittering sunshine that thrilled children snatch to play with. The countryside turns an immodest green. Boundaries blur as tapioca fences take root and bloom. Brick walls turn moss green. Pepper vines snake up electric poles. Wild creepers burst through laterite banks and spill across flooded roads. Boats ply in the bazaars. And small fish appear in the puddles that fill the PWD potholes on the highways. It was raining when Rahel came back to Ayemenem. Slanting silver ropes slammed into loose earth, plowing it up like gunfire. The old house on the hill wore its steep, gabled roof pulled over its ears like a low hat. The walls, streaked with moss, had grown soft, and bulged a little with dampness that seeped up from the ground.",
     author: "Arundhati Roy",
     title: "The God of Small Things",
   },
-  // {
-  //   id: "7",
-  //   text: `The house itself looked empty. The doors and windows were locked. The front verandah bare. Unfurnished. But the skyblue Plymouth with chrome tailfins was still parked outside, and inside, Baby Kochamma was still alive. She was Rahel’s baby grandaunt, her grandfather’s younger sister. Her name was really Navomi, Navomi Ipe, but everybody called her Baby. She became Baby Kochamma when she was old enough to be an aunt. Rahel hadn’t come to see her, though. Neither niece nor baby grandaunt labored under any illusions on that account. Rahel had come to see her brother, Estha. They were two-egg twins. “Dizygotic” doctors called them. Born from separate but simultaneously fertilized eggs. Estha—Esthappen was the older by eighteen minutes. They never did look much like each other, Estha and Rahel, and even when they were thin-armed children, flat-chested, wormridden and Elvis Presley-puffed, there was none of the usual “Who is who?” and “Which is which?” from oversmiling relatives or the Syrian Orthodox bishops who frequently visited the Ayemenem House for donations. The confusion lay in a deeper, more secret place.`,
-  //   author: "Arundhati Roy",
-  //   title: "The God of Small Things",
-  // },
+  {
+    id: "5",
+    text: "Only with Clara did she allow herself the luxury of giving in to her overwhelming desire to serve and be loved; with her, however slyly, she was able to express the secret, most delicate yearnings of her soul. The long years of solitude and unhappiness had distilled her emotions and purified her feelings down to a few terrible, magnificent passions, which possessed her totally. She had no gift for small perturbations, mean-spirited resentments, concealed envies, works of charity, faded endearments, ordinary friendly politeness, or day-to-day acts of kindness. She was one of those people who are born for the greatness of a single love, for exaggerated hatred, for apocalyptic vengeance, and for the most sublime forms of heroism, but she was unable to shape her fate to the dimensions of her amorous vocation, so it was lived out as something flat and gray trapped between her mother’s sickroom walls, wretched tenements, and the tortured confessions with which this large, opulent, hot-blooded woman—made for maternity, abundance, action, and ardor—was consuming herself.",
+    author: "Isabel Allende",
+    title: "The House of Spirits",
+  },
+  {
+    id: "nyt-1",
+    text: "Zooming through a Stockholm intersection on his bicycle one morning, 18-year-old Max Tegmark never saw the truck that hit him. The blast of a horn, the screech of tires and a sickening thud followed in quick succession, extinguishing a young life filled with promise. It never happened, of course. As the adult Dr. Tegmark, now 46, relates in the opening pages of this provocative new book, young Max swerved at the last instant and continued on to school — and an academic career that eventually took him to the faculty of M.I.T. and the top ranks of the world’s cosmologists. But wait: That fatal accident did happen, Dr. Tegmark writes. Yes, he came through unscathed that day, but he was also killed, and he was severely injured, and slightly injured. He endured every possible outcome, happy and unhappy, that can befall a bicyclist who encounters a speeding truck.",
+    author: "Amir Alexander",
+    title: "If It's Possible, It Happened",
+    publication: "The New York Times",
+  },
+  {
+    id: "nyt-2",
+    text: "Thermal, Calif. — “People are getting more brave, which I love, just embracing it,” said Kelson Berkus, 30, a marketing executive in Los Angeles, nodding approvingly as he surveyed the Lacoste party, clad in aqua giraffe print swim trunks (source: “probably Fred Segal”). A few steps away, Ryan Greeley, 28, a former model who works in retail in Long Beach, Calif., stepped out of the pool and pulled what appeared to be a large piece of cheesecloth (it was actually vintage, from Buffalo Exchange) close to his chest. “I call it a shawl, but that’s just because it’s a cardigan that’s mesh,” Mr. Greeley said. It was the first weekend of the Coachella Valley Music and Arts Festival, and around him, hundreds of young men milled about, clad in sleeveless shirts and short shorts, hoisting up vodka sodas enthusiastically (“Let’s do this, bro!”), reliving the previous night’s excesses (“Ugh, the ceiling was spinning”) and puffing up their pecs as they strutted around the private estate here.",
+    author: "Sheila Marikar",
+    title: "At Coachella, It's A Guy Thing",
+    publication: "The New York Times",
+  },
+  {
+    id: "nyt-3",
+    text: "How do events from our childhood shape our adult preferences? I recently studied this question using a classic American example: baseball. I tested how a team’s performance at every age of our childhood affects which team we root for as adults. From Facebook’s publicly available advertising platform, I downloaded data on how many fans every baseball team has, broken out by gender and age. (Facebook estimates whether someone is a fan of a team based on both “likes” and posts.) This data is not perfect, but it does correlate pretty well with previous polling. According to Facebook, the most popular teams are the Yankees, Red Sox, Mets, Cardinals and Braves; there are 1.65 Yankees fans for every Mets fan. Facebook data can reveal patterns that polls generally do not have large enough sample sizes to detect. For example, Facebook tells us that among men, the ratio of Yankees fans to Mets fans fluctuates enormously depending on when those men were born.",
+    author: "Seth Stephens-Davidowitz",
+    title: "They Hook You When You're Young",
+    publication: "The New York Times",
+  },
+  {
+    id: "nyt-4",
+    text: "By what metric are we to determine whether a model is “super”? If it is name recognition, Forbes list position, magazines covered, campaigns fronted or some algorithm of them all, Kate Upton probably qualifies. In 2013 Ms. Upton, a 21-year-old from Melbourne, Fla., was named model of the year and appeared on the cover of the Sports Illustrated swimsuit issue for the second straight year. This year she was demoted to the inside cover, pictured wearing a bikini in zero gravity. As a model she floats off the page, but she’s also a performer, with videos of her dancing going crash the Internet viral. So, all aboard the Hollywood starship express. In “The Other Woman,” due Friday, Ms. Upton will appear alongside Cameron Diaz and Leslie Mann. It is Ms. Upton’s third and by far most substantial screen credit. In her debut, the surprisingly pleasant “Tower Heist,” she played a mistress in what was by definition no more than a cameo.",
+    author: "Christopher Wallace",
+    title: "Yet Another Pretty Face",
+    publication: "The New York Times",
+  },
 ];
+
+export interface PassagePair {
+  tutorialPassage: Passage;
+  taskPassage: Passage;
+}
+
+export const sampleDistinctPassages = (
+  random: () => number = Math.random,
+): PassagePair => {
+  if (Passages.length < 2) {
+    throw new Error("At least two passages are required for assignment");
+  }
+
+  const tutorialIndex = Math.floor(random() * Passages.length);
+  const taskOffset = Math.floor(random() * (Passages.length - 1));
+  const taskIndex = taskOffset >= tutorialIndex ? taskOffset + 1 : taskOffset;
+
+  return {
+    tutorialPassage: Passages[tutorialIndex],
+    taskPassage: Passages[taskIndex],
+  };
+};
diff --git a/src/consts/surveyQuestions.tsx b/src/consts/surveyQuestions.tsx
index f5abac4..43bc951 100644
--- a/src/consts/surveyQuestions.tsx
+++ b/src/consts/surveyQuestions.tsx
@@ -104,7 +104,7 @@ export const ArtistPreSurveyQuestions: SurveyDefinition = {
 };
 
 export const ArtistPostSurveyQuestions: SurveyDefinition = {
-  id: "artist-post-survey-v2",
+  id: "artist-post-survey-v3",
   title: "Creator post-task survey",
   sections: [
     {
@@ -260,25 +260,6 @@ export const ArtistPostSurveyQuestions: SurveyDefinition = {
         },
       ],
     },
-    {
-      id: "llm-attribution",
-      title: "AI contribution",
-      conditions: ["LLM"],
-      questions: [
-        {
-          id: "llm_contribution_attribution",
-          type: "multipleChoice",
-          question: "During the blackout-poem process, I felt that…",
-          options: [
-            "I was creating the poem and AI was assisting me.",
-            "AI was creating the poem and I was assisting it.",
-            "AI and I contributed approximately equally.",
-            "I did not use the AI tool.",
-          ],
-          required: true,
-        },
-      ],
-    },
     {
       id: "outside-tools",
       title: "Outside tools",
diff --git a/src/pages/Captcha.tsx b/src/pages/Captcha.tsx
index 2fe4257..e7dd7f7 100644
--- a/src/pages/Captcha.tsx
+++ b/src/pages/Captcha.tsx
@@ -6,7 +6,13 @@ import { toaster } from "../components/ui/toaster";
 import { DataContext } from "../App";
 import { ArtistCondition } from "../types";
 import type { ArtistAssignment, Poem } from "../types";
-import { Passages } from "../consts/passages";
+import { ARTIST_DATA_LOGGING_VERSION } from "../consts/dataLogging";
+import {
+  CREATOR_PASSAGE_POOL_VERSION,
+  Passages,
+  sampleDistinctPassages,
+  type PassagePair,
+} from "../consts/passages";
 import type { ChangeEvent, KeyboardEvent } from "react";
 
 const TEST_CAPTCHA = "TEST";
@@ -84,6 +90,7 @@ const Captcha = () => {
   const makePoem = (passageId = "1"): Poem => {
     const passage = Passages.find((p) => p.id === passageId) ?? Passages[0];
     return {
+      loggingSchemaVersion: ARTIST_DATA_LOGGING_VERSION,
       passageId: passage.id,
       passage,
       text: [],
@@ -93,22 +100,31 @@ const Captcha = () => {
       writeNotes: "",
       poemSnapshot: [],
       taskTiming: { phases: {} },
-      llmUsage: { chatOpenings: [], requests: [] },
+      llmUsage: {
+        chatAvailability: [],
+        inputActivity: [],
+        requests: [],
+      },
     };
   };
 
   const startArtist = (
     condition: ArtistCondition,
-    passageId = "1",
+    passages: PassagePair = sampleDistinctPassages(),
     strategy: ArtistAssignment["strategy"] = "TEST_OVERRIDE",
+    passagePoolVersion = CREATOR_PASSAGE_POOL_VERSION,
   ) => {
+    const { tutorialPassage, taskPassage } = passages;
     addUserData({ role: "artist" });
     addRoleSpecificData({
       condition,
-      poem: makePoem(passageId),
+      poem: makePoem(taskPassage.id),
       assignment: {
         strategy,
-        passageId,
+        passageId: taskPassage.id,
+        tutorialPassageId: tutorialPassage.id,
+        taskPassageId: taskPassage.id,
+        passagePoolVersion,
         condition,
         assignedAt: new Date(),
       },
@@ -144,14 +160,15 @@ const Captcha = () => {
 
       setIsAssigning(true);
       try {
-        const proposedPassage =
-          Passages[Math.floor(Math.random() * Passages.length)];
+        const proposedPassages = sampleDistinctPassages();
         const response = await fetch("/api/firebase/artist-assignment", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({
             sessionId,
-            passageId: proposedPassage.id,
+            passageId: proposedPassages.taskPassage.id,
+            tutorialPassageId: proposedPassages.tutorialPassage.id,
+            passagePoolVersion: CREATOR_PASSAGE_POOL_VERSION,
             prolificPid: prolific?.prolificPid ?? null,
           }),
         });
@@ -160,14 +177,27 @@ const Captcha = () => {
         }
         const assignment = (await response.json()) as {
           passageId: string;
+          tutorialPassageId: string;
+          taskPassageId: string;
+          passagePoolVersion: string;
           condition: ArtistCondition;
           strategy: ArtistAssignment["strategy"];
         };
         const hasValidStrategy =
           assignment.strategy === "INDEPENDENT_RANDOM_1_TO_1" ||
           assignment.strategy === "PASSAGE_STRATIFIED_1_TO_1";
+        const tutorialPassage = Passages.find(
+          (passage) => passage.id === assignment.tutorialPassageId,
+        );
+        const taskPassage = Passages.find(
+          (passage) => passage.id === assignment.taskPassageId,
+        );
         if (
-          !Passages.some((passage) => passage.id === assignment.passageId) ||
+          !tutorialPassage ||
+          !taskPassage ||
+          tutorialPassage.id === taskPassage.id ||
+          assignment.passageId !== taskPassage.id ||
+          !assignment.passagePoolVersion ||
           !Object.values(ArtistCondition).includes(assignment.condition) ||
           !hasValidStrategy
         ) {
@@ -176,8 +206,9 @@ const Captcha = () => {
 
         startArtist(
           assignment.condition,
-          assignment.passageId,
+          { tutorialPassage, taskPassage },
           assignment.strategy,
+          assignment.passagePoolVersion,
         );
         navigate("/consent");
       } catch (error) {
diff --git a/src/pages/artist/PostSurvey.tsx b/src/pages/artist/PostSurvey.tsx
index b073ca5..c2bde58 100644
--- a/src/pages/artist/PostSurvey.tsx
+++ b/src/pages/artist/PostSurvey.tsx
@@ -47,7 +47,11 @@ const ArtistPostSurvey = () => {
     };
 
     const poemData = {
+      loggingSchemaVersion: poem.loggingSchemaVersion,
       passageId: poem.passageId,
+      tutorialPassageId: artistData.assignment?.tutorialPassageId,
+      taskPassageId:
+        artistData.assignment?.taskPassageId ?? poem.passageId,
       passage: poem.passage,
       text: poem.text,
       selectedWordIndexes: poem.text,
diff --git a/src/pages/artist/README.md b/src/pages/artist/README.md
new file mode 100644
index 0000000..107453d
--- /dev/null
+++ b/src/pages/artist/README.md
@@ -0,0 +1,205 @@
+# Artist-side data logging
+
+This document is the source of truth for data collected during the artist/creator flow. The current schema version is `artist-data-2026-08-05-v2`, stored as `poem.loggingSchemaVersion` and copied to the final `poem` document.
+
+## Storage flow
+
+1. The client initializes an `Artist` record and an empty `Poem` after assignment.
+2. Page transitions append to `artistData.timeStamps`. The SPARK and WRITE pages additionally store structured `taskTiming` records.
+3. SPARK and WRITE interaction data is accumulated in React refs so high-frequency interaction logging does not cause UI rerenders. It is copied into the poem when that stage completes.
+4. `addRoleSpecificData` updates the in-memory record and schedules a 500 ms autosave to `artistIncompleteSession/{sessionId}`.
+5. Post-survey submission commits one atomic batch containing linked `artist`, `artistSurvey`, and `poem` documents, then deletes the incomplete-session document.
+
+Consequently, the final dataset contains complete stage data for submitted sessions. If someone closes the page before a stage completes, interactions that occurred during that unfinished stage may not be present in the last autosave. `sessionStorage.userDataSnapshot` is only a best-effort local backup on unload; it is not part of the analysis dataset.
+
+All JavaScript `Date` values become ISO date strings when sent as JSON. Analysis code should parse them as timestamps.
+
+## Final Firestore records
+
+### `artist`
+
+| Field | Meaning |
+| --- | --- |
+| `condition` | `LLM` or `NO_AI`. |
+| `assignment` | Condition strategy, task/tutorial passage IDs, passage-pool version, and assignment time. |
+| `surveyResponse` | Reference to the corresponding `artistSurvey` document. |
+| `poem` | Reference to the corresponding `poem` document. |
+| `timestamps` | General route/progress timestamps retained for compatibility. Prefer `poem.taskTiming` for phase-duration analysis. |
+| `prolific` | Prolific identifiers when the session originated on Prolific. |
+
+### `artistSurvey`
+
+Stores the exact pre- and post-survey definitions alongside `preSurveyAnswers` and `postSurveyAnswers`. Keeping the definitions makes each response interpretable if question wording or scales change later.
+
+### `poem`
+
+| Field | Meaning |
+| --- | --- |
+| `loggingSchemaVersion` | Artist logging schema used by the record. |
+| `passageId`, `taskPassageId` | Passage used for the measured poem task. |
+| `tutorialPassageId` | Passage sampled for the tutorial. |
+| `passage` | Full task passage and attribution metadata. |
+| `text`, `selectedWordIndexes` | Final selected zero-based word indexes. These are duplicate names retained for compatibility. |
+| `finalPoem` | Final selected words joined in passage order. |
+| `snapshot`, `editHistory` | Full word-selection event history. These are duplicate names retained for compatibility. |
+| `sparkNotes`, `writeNotes` | Notes at the end of each phase. |
+| `sparkConversation` | Chat transcript as of the end of SPARK. |
+| `writeConversation` | Running chat transcript as of the end of WRITE; it includes earlier SPARK messages. Use message IDs to deduplicate if combining both arrays. |
+| `taskTiming` | SPARK, WRITE, and total task timestamps/durations. |
+| `llmUsage` | Availability, input activity, and request-level logs described below. |
+| `derivedMetrics` | Analysis-ready measures calculated at final submission. |
+| `random` | Server-generated random value used for random ordering/sampling. |
+
+## Poem editing log
+
+Each entry in `snapshot`/`editHistory` contains:
+
+| Field | Values and meaning |
+| --- | --- |
+| `action` | `ADD` or `REMOVE`. |
+| `index` | Zero-based index of the affected passage word. |
+| `timestamp` | Client event time. |
+| `source` | `DIRECT`, `UNDO`, or `REDO`. |
+
+The final `text` indexes are the authoritative final state. The event history is used for process measures such as additions, removals, reversals, undo/redo use, and time to first/final edit.
+
+## Chat transcript
+
+Every new message has the following provenance fields in addition to `id`, `role`, `content`, and `timestamp`:
+
+| Field | Values and meaning |
+| --- | --- |
+| `stage` | `SPARK` or `WRITE`. |
+| `kind` | `USER_MESSAGE`, `LLM_RESPONSE`, `STAGE_OPENING`, or `IDLE_NUDGE`. |
+| `inputSource` | Present on user messages: `TYPED` or `SUGGESTION`. |
+
+`STAGE_OPENING` is added when the instructions close and the chat becomes usable. It is no longer created while the instructions are still covering the page. `IDLE_NUDGE` is added after 40 seconds without a user message in that stage. These messages are generated locally and do not create LLM API requests.
+
+The explicit `kind` and `stage` fields are authoritative for determining whether the SPARK/WRITE opening or idle-nudge message was shown. Do not identify automated messages by matching their text; copy can change between deployments.
+
+## `llmUsage`
+
+### `chatAvailability`
+
+One record per reached LLM-enabled stage:
+
+```ts
+{
+  stage: "SPARK" | "WRITE";
+  availableAt: Date;
+}
+```
+
+This replaces the misleading `chatOpenings` name. It means the always-visible chat panel became usable after the instructions closed; it does not mean the participant clicked or opened the panel.
+
+### `inputActivity`
+
+One privacy-preserving aggregate per stage:
+
+| Field | Meaning |
+| --- | --- |
+| `stage` | `SPARK` or `WRITE`. |
+| `firstFocusedAt` | First time the participant focused the chat textarea. Missing if never focused. |
+| `focusCount` | Number of textarea focus events. This can include keyboard tabbing and should not alone be treated as substantive engagement. |
+| `firstTypedAt` | First transition from blank/whitespace-only input to nonblank input. Missing if no nonblank draft was started. |
+| `draftStartCount` | Number of blank-to-nonblank draft starts. Sending a typed message resets the draft, so later typing begins another draft. |
+| `abandonedDraftCount` | Drafts cleared without typed submission. This includes replacing an existing typed draft by clicking a suggested prompt. |
+| `hasUnsentDraft` | Whether nonblank text remained in the textarea at the last stage save. In a completed stage, this means the stage ended with an unsent draft. |
+
+No keystroke stream and no unsent/deleted draft text is stored. Submitted message text remains available in the transcript and request log.
+
+### `requests`
+
+One record per attempted LLM request. The same `id` is updated as the request moves through its lifecycle.
+
+| Field | Meaning |
+| --- | --- |
+| `id`, `userMessageId`, `assistantMessageId` | IDs linking request and transcript messages. `assistantMessageId` exists only after success. |
+| `stage` | Stage in which the request was made. |
+| `inputSource` | `TYPED` or `SUGGESTION`. This is recorded even when the request fails. |
+| `userMessageContent` | Submitted content only; never an abandoned draft. |
+| `requestedAt`, `completedAt`, `failedAt` | Request lifecycle timestamps. |
+| `status` | `STARTED`, `COMPLETED`, or `FAILED`. |
+| `systemPrompt`, `promptVersion` | Exact prompt and version used for reproducibility. |
+| `model`, `modelVersion`, `generationParameters` | Server-returned generation metadata when available. |
+| `error` | Failure text when the request fails. |
+
+Failed optimistic user messages are removed from the displayed transcript and restored to the textarea for retry, while the failed request remains in `llmUsage.requests`.
+
+## Derived metrics
+
+`deriveArtistMetrics` creates the following fields at final submission.
+
+### Poem process and timing
+
+| Metric | Definition |
+| --- | --- |
+| `selectedWordCount` | Number of unique final selected indexes. |
+| `additionCount`, `removalCount` | Counts of `ADD` and `REMOVE` edit events. |
+| `reversalCount` | Number of times the same word's action changes between consecutive actions on that word. |
+| `undoCount`, `redoCount` | Edit events generated by undo/redo. |
+| `totalEditingActivity` | Total edit-event count. |
+| `timeToFirstSelectionMs` | WRITE start to first `ADD`; otherwise `null`. |
+| `timeToFinalEditMs` | WRITE start to last edit; otherwise `null`. |
+| `totalTaskTimeMs`, `sparkTimeMs`, `writeTimeMs` | Stored phase durations; otherwise `null`. |
+
+### LLM use
+
+| Metric | Definition |
+| --- | --- |
+| `llmUptake` | At least one completed LLM request. |
+| `llmTurnCount` | Completed request count. |
+| `llmAttemptCount` | All request attempts, including failures. |
+| `llmTypedAttemptCount` | Attempts submitted from typed input. |
+| `llmSuggestionAttemptCount` | Attempts submitted by clicking a suggested prompt. |
+| `chatAvailableStageCount` | Number of stages in which chat became usable. It is exposure, not engagement. |
+
+### Chat engagement and automated messages
+
+The following fields exist separately with `spark` and `write` prefixes:
+
+| Suffix | Definition |
+| --- | --- |
+| `ChatAvailable` | Chat became usable in that stage. |
+| `ChatFocusCount` | Textarea focus count. |
+| `ChatEverTyped` | A nonblank draft was started. |
+| `ChatDraftStartCount` | Blank-to-nonblank draft starts. |
+| `ChatAbandonedDraftCount` | Drafts cleared or replaced without typed submission. |
+| `ChatEndedWithUnsentDraft` | Stage ended with a nonblank unsent draft. |
+| `TimeFromChatAvailableToFirstFocusMs` | Availability to first focus; `null` if either timestamp is absent. |
+| `TimeFromChatAvailableToFirstTypingMs` | Availability to first nonblank input; `null` if either timestamp is absent. |
+| `StageOpeningShown` | Transcript contains that stage's typed `STAGE_OPENING` message. |
+| `IdleNudgeShown` | Transcript contains that stage's typed `IDLE_NUDGE` message. |
+
+The aggregate fields `chatFocusCount`, `chatDraftStartCount`, and `chatAbandonedDraftCount` sum SPARK and WRITE.
+
+For the `NO_AI` condition, current-schema chat measures are false or zero because chat is not available. Analyses of chat behavior should ordinarily be restricted to the `LLM` condition.
+
+## Versioning and legacy data
+
+Records should be grouped or filtered using `loggingSchemaVersion` before comparing logging-dependent metrics.
+
+- Current records use `artist-data-2026-08-05-v2`.
+- Older `chatOpenings` records are read as `chatAvailability` so the exposure timestamp remains usable.
+- Older messages do not have `stage`/`kind`, and older requests do not have `inputSource`. The new provenance, input-activity, and automated-message derived metrics are therefore emitted as `null` for records without the current schema version; `null` means unmeasured, not zero.
+
+## Analysis guidance
+
+- Use `ChatEverTyped`, request counts, and message provenance as the primary engagement measures. Treat focus counts as weaker evidence because focus can occur without intentional use.
+- Use `llmAttemptCount` when studying attempted reliance and `llmTurnCount` when studying completed exchanges.
+- Use `inputSource` to separate participant-authored requests from interface-suggested requests.
+- Use `IdleNudgeShown` when estimating effects of the nudge; it is post-treatment and depends on 40 seconds of no submitted user message.
+- Use `passagePoolVersion`, task passage ID, and condition in all passage- or condition-sensitive analyses.
+- Deduplicate combined transcript arrays by `message.id`, because `writeConversation` already carries the SPARK history forward.
+
+## Implementation map
+
+- Types and schema: `src/types.ts`
+- Schema-version constant: `src/consts/dataLogging.ts`
+- Automated message creation: `src/consts/chatMessages.ts`
+- Chat collection logic: `src/components/chatbot/Chatbot.tsx`
+- SPARK/WRITE stage aggregation: `src/pages/artist/step1/Step1.tsx` and `src/pages/artist/step2/Step2.tsx`
+- Final export: `src/pages/artist/PostSurvey.tsx`
+- Derived measures: `src/utils/artistMetrics.ts`
+- Legacy `chatOpenings` conversion: `src/utils/llmUsage.ts`
+- Firestore autosave/commit: `src/App.tsx` and `server/api/routes/firebaseAPI.ts`
diff --git a/src/pages/artist/instructions/Instructions.tsx b/src/pages/artist/instructions/Instructions.tsx
index 3f2152d..638976e 100644
--- a/src/pages/artist/instructions/Instructions.tsx
+++ b/src/pages/artist/instructions/Instructions.tsx
@@ -38,6 +38,8 @@ const ArtistInstructions = () => {
           existing passage of text.
         </p>
 
+        <p className="text-main font-semibold">Your final poem will be read by others.</p>
+
         <Image
           alt="Blackout Example"
           src={BlackoutExample}
diff --git a/src/pages/artist/step1/Step1.tsx b/src/pages/artist/step1/Step1.tsx
index b0bd8b7..34b7bff 100644
--- a/src/pages/artist/step1/Step1.tsx
+++ b/src/pages/artist/step1/Step1.tsx
@@ -4,7 +4,8 @@ import MultiPageTemplate from "../../../components/shared/pages/multiPage";
 import { ArtistCondition } from "../../../types";
 import { Stage } from "../../../types";
 import type {
-  ChatOpening,
+  ChatAvailability,
+  ChatInputActivity,
   LlmRequestLog,
   Message,
   Poem,
@@ -14,10 +15,7 @@ import { DataContext } from "../../../App";
 import type { Artist, Passage } from "../../../types";
 import { Button } from "@chakra-ui/react";
 import StarIcon from "../../../assets/star.svg";
-import {
-  createAssistantMessage,
-  STAGE_OPENING_MESSAGES,
-} from "../../../consts/chatMessages";
+import { getChatAvailability } from "../../../utils/llmUsage";
 
 const ArtistStep1 = () => {
   const navigate = useNavigate();
@@ -40,15 +38,14 @@ const ArtistStep1 = () => {
   const llmRequestsRef = useRef<LlmRequestLog[]>(
     existingPoem?.llmUsage?.requests ?? [],
   );
-  const chatOpeningsRef = useRef<ChatOpening[]>(
-    existingPoem?.llmUsage?.chatOpenings ?? [],
+  const chatAvailabilityRef = useRef<ChatAvailability[]>(
+    getChatAvailability(existingPoem?.llmUsage),
   );
-
-  const [sparkMessages, setSparkMessages] = useState<Message[]>(() =>
-    isLLM
-      ? [createAssistantMessage(STAGE_OPENING_MESSAGES[Stage.SPARK])]
-      : [],
+  const inputActivityRef = useRef<ChatInputActivity[]>(
+    existingPoem?.llmUsage?.inputActivity ?? [],
   );
+
+  const [sparkMessages, setSparkMessages] = useState<Message[]>([]);
   const [sparkNotes, setSparkNotes] = useState<string>("");
 
   // 0 = brainstorm instructions (all users), 1 = LLM assistant info (LLM only), done
@@ -56,13 +53,27 @@ const ArtistStep1 = () => {
   const totalPopups = isLLM ? 2 : 1;
   const showingPopup = popupStep < totalPopups;
 
-  const handleChatOpened = useCallback((opening: ChatOpening) => {
-    const alreadyLogged = chatOpeningsRef.current.some(
-      (item) => item.stage === opening.stage,
+  const handleChatAvailable = useCallback((availability: ChatAvailability) => {
+    const alreadyLogged = chatAvailabilityRef.current.some(
+      (item) => item.stage === availability.stage,
     );
-    if (!alreadyLogged) chatOpeningsRef.current.push(opening);
+    if (!alreadyLogged) chatAvailabilityRef.current.push(availability);
   }, []);
 
+  const handleInputActivityUpdate = useCallback(
+    (activity: ChatInputActivity) => {
+      const existingIndex = inputActivityRef.current.findIndex(
+        (item) => item.stage === activity.stage,
+      );
+      if (existingIndex >= 0) {
+        inputActivityRef.current[existingIndex] = activity;
+      } else {
+        inputActivityRef.current.push(activity);
+      }
+    },
+    [],
+  );
+
   const handleRequestUpdate = useCallback((request: LlmRequestLog) => {
     const existingIndex = llmRequestsRef.current.findIndex(
       (item) => item.id === request.id,
@@ -94,7 +105,8 @@ const ArtistStep1 = () => {
         },
       },
       llmUsage: {
-        chatOpenings: chatOpeningsRef.current,
+        chatAvailability: chatAvailabilityRef.current,
+        inputActivity: inputActivityRef.current,
         requests: llmRequestsRef.current,
       },
     };
@@ -182,7 +194,13 @@ const ArtistStep1 = () => {
         setMessages={setSparkMessages}
         notes={sparkNotes}
         setNotes={setSparkNotes}
-        onChatOpened={isLLM ? handleChatOpened : undefined}
+        initialInputActivity={inputActivityRef.current.find(
+          (activity) => activity.stage === Stage.SPARK,
+        )}
+        onChatAvailable={isLLM ? handleChatAvailable : undefined}
+        onInputActivityUpdate={
+          isLLM ? handleInputActivityUpdate : undefined
+        }
         onRequestUpdate={isLLM ? handleRequestUpdate : undefined}
       >
         <div
@@ -202,7 +220,11 @@ const ArtistStep1 = () => {
 
             <p className="text-xs text-grey text-left pt-2">
               <span className="italic">{'"' + passage.title + '"'}</span>
-              <span>{", " + passage.author + " from The New York Times"}</span>
+              <span>
+                {", " +
+                  passage.author +
+                  (passage.publication ? `, ${passage.publication}` : "")}
+              </span>
             </p>
           </div>
         </div>
diff --git a/src/pages/artist/step2/Step2.tsx b/src/pages/artist/step2/Step2.tsx
index 4da710e..dcb8879 100644
--- a/src/pages/artist/step2/Step2.tsx
+++ b/src/pages/artist/step2/Step2.tsx
@@ -5,7 +5,8 @@ import BlackoutPoetry from "../../../components/blackout/Blackout";
 import type {
   Artist,
   ArtistCondition,
-  ChatOpening,
+  ChatAvailability,
+  ChatInputActivity,
   LlmRequestLog,
   Message,
   PoemSnapshot,
@@ -14,10 +15,7 @@ import { useContext } from "react";
 import { DataContext } from "../../../App";
 import { Stage } from "../../../types";
 import { Button } from "@chakra-ui/react";
-import {
-  createAssistantMessage,
-  STAGE_OPENING_MESSAGES,
-} from "../../../consts/chatMessages";
+import { getChatAvailability } from "../../../utils/llmUsage";
 
 const ArtistStep2 = () => {
   const navigate = useNavigate();
@@ -40,31 +38,43 @@ const ArtistStep2 = () => {
   const llmRequestsRef = useRef<LlmRequestLog[]>(
     artistPoem?.llmUsage?.requests ?? [],
   );
-  const chatOpeningsRef = useRef<ChatOpening[]>(
-    artistPoem?.llmUsage?.chatOpenings ?? [],
+  const chatAvailabilityRef = useRef<ChatAvailability[]>(
+    getChatAvailability(artistPoem?.llmUsage),
+  );
+  const inputActivityRef = useRef<ChatInputActivity[]>(
+    artistPoem?.llmUsage?.inputActivity ?? [],
   );
   const [writeNotes, setWriteNotes] = useState(
     artistData?.poem?.sparkNotes || "",
   );
-  const [writeMessages, setWriteMessages] = useState<Message[]>(() =>
-    userType === "LLM"
-      ? [
-          ...(artistPoem?.sparkConversation ?? []),
-          createAssistantMessage(STAGE_OPENING_MESSAGES[Stage.WRITE]),
-        ]
-      : [...(artistPoem?.sparkConversation ?? [])],
-  );
+  const [writeMessages, setWriteMessages] = useState<Message[]>(() => [
+    ...(artistPoem?.sparkConversation ?? []),
+  ]);
   const [selectedWordIndexes, setSelectedWordIndexes] = useState<number[]>([]);
   const [poemSnapshots, setPoemSnapshots] = useState<PoemSnapshot[]>([]);
   const [showPopup, setShowPopup] = useState(true);
 
-  const handleChatOpened = useCallback((opening: ChatOpening) => {
-    const alreadyLogged = chatOpeningsRef.current.some(
-      (item) => item.stage === opening.stage,
+  const handleChatAvailable = useCallback((availability: ChatAvailability) => {
+    const alreadyLogged = chatAvailabilityRef.current.some(
+      (item) => item.stage === availability.stage,
     );
-    if (!alreadyLogged) chatOpeningsRef.current.push(opening);
+    if (!alreadyLogged) chatAvailabilityRef.current.push(availability);
   }, []);
 
+  const handleInputActivityUpdate = useCallback(
+    (activity: ChatInputActivity) => {
+      const existingIndex = inputActivityRef.current.findIndex(
+        (item) => item.stage === activity.stage,
+      );
+      if (existingIndex >= 0) {
+        inputActivityRef.current[existingIndex] = activity;
+      } else {
+        inputActivityRef.current.push(activity);
+      }
+    },
+    [],
+  );
+
   const handleRequestUpdate = useCallback((request: LlmRequestLog) => {
     const existingIndex = llmRequestsRef.current.findIndex(
       (item) => item.id === request.id,
@@ -101,7 +111,8 @@ const ArtistStep2 = () => {
         },
       },
       llmUsage: {
-        chatOpenings: chatOpeningsRef.current,
+        chatAvailability: chatAvailabilityRef.current,
+        inputActivity: inputActivityRef.current,
         requests: llmRequestsRef.current,
       },
     };
@@ -170,7 +181,15 @@ const ArtistStep2 = () => {
         notes={writeNotes}
         setNotes={setWriteNotes}
         selectedWordIndexes={selectedWordIndexes}
-        onChatOpened={userType === "LLM" ? handleChatOpened : undefined}
+        initialInputActivity={inputActivityRef.current.find(
+          (activity) => activity.stage === Stage.WRITE,
+        )}
+        onChatAvailable={
+          userType === "LLM" ? handleChatAvailable : undefined
+        }
+        onInputActivityUpdate={
+          userType === "LLM" ? handleInputActivityUpdate : undefined
+        }
         onRequestUpdate={userType === "LLM" ? handleRequestUpdate : undefined}
       >
         <div className="h-max w-full flex flex-col justify-between">
diff --git a/src/pages/artist/tutorial/Tutorial.tsx b/src/pages/artist/tutorial/Tutorial.tsx
index 4580eba..f91e6b4 100644
--- a/src/pages/artist/tutorial/Tutorial.tsx
+++ b/src/pages/artist/tutorial/Tutorial.tsx
@@ -4,7 +4,7 @@ import { DataContext } from "../../../App";
 import FullPageTemplate from "../../../components/shared/pages/fullScrollPage";
 import BlackoutPoetry from "../../../components/blackout/Blackout";
 import { Button } from "@chakra-ui/react";
-import type { PoemSnapshot } from "../../../types";
+import type { Artist, PoemSnapshot } from "../../../types";
 import { Passages } from "../../../consts/passages";
 
 const STEPS = [
@@ -33,8 +33,14 @@ const ArtistTutorial = () => {
     throw new Error("Component must be used within a DataContext.Provider");
   }
   const { userData, addRoleSpecificData } = context;
+  const artistData = userData?.data as Artist;
+  const passage = Passages.find(
+    (candidate) => candidate.id === artistData.assignment?.tutorialPassageId,
+  );
 
-  const passage = Passages.find((p) => p.id === "2")!;
+  if (!passage) {
+    throw new Error("Tutorial passage assignment is missing or invalid");
+  }
 
   const [selectedWordIndexes, setSelectedWordIndexes] = useState<number[]>([]);
   const [, setPoemSnapshots] = useState<PoemSnapshot[]>([]);
@@ -54,7 +60,7 @@ const ArtistTutorial = () => {
     }
 
     prevCountRef.current = count;
-  }, [selectedWordIndexes]);
+  }, [selectedWordIndexes, step]);
 
   const handleContinue = () => {
     addRoleSpecificData({
@@ -102,7 +108,11 @@ const ArtistTutorial = () => {
 
         <p className="text-xs text-grey">
           <span className="italic">{'"' + passage.title + '"'}</span>
-          <span>{", " + passage.author}</span>
+          <span>
+            {", " +
+              passage.author +
+              (passage.publication ? `, ${passage.publication}` : "")}
+          </span>
         </p>
 
         {/* Continue — only shown on final step */}
diff --git a/src/types.ts b/src/types.ts
index 37dbcdd..5fdf1ad 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -13,6 +13,9 @@ export interface ArtistAssignment {
     | "PASSAGE_STRATIFIED_1_TO_1"
     | "TEST_OVERRIDE";
   passageId: string;
+  tutorialPassageId: string;
+  taskPassageId: string;
+  passagePoolVersion: string;
   condition: ArtistCondition;
   assignedAt: Date;
 }
@@ -32,6 +35,7 @@ export interface ArtistSurvey {
 // }
 
 export interface Poem {
+  loggingSchemaVersion: string;
   passageId: string; // passageId in Passage.id
   passage: Passage;
   text: number[]; // this array holds the indexes of each word chosen from the passage
@@ -49,6 +53,9 @@ export interface Message {
   role: Role;
   content: string;
   timestamp: Date;
+  stage: Stage;
+  kind: MessageKind;
+  inputSource?: ChatInputSource;
 }
 
 export interface PhaseTiming {
@@ -67,11 +74,41 @@ export interface TaskTiming {
   };
 }
 
-export interface ChatOpening {
+export interface ChatAvailability {
+  stage: Stage;
+  availableAt: Date;
+}
+
+export interface LegacyChatOpening {
   stage: Stage;
   timestamp: Date;
 }
 
+export interface ChatInputActivity {
+  stage: Stage;
+  firstFocusedAt?: Date;
+  focusCount: number;
+  firstTypedAt?: Date;
+  draftStartCount: number;
+  abandonedDraftCount: number;
+  hasUnsentDraft: boolean;
+}
+
+export const ChatInputSource = {
+  TYPED: "TYPED",
+  SUGGESTION: "SUGGESTION",
+} as const;
+export type ChatInputSource =
+  (typeof ChatInputSource)[keyof typeof ChatInputSource];
+
+export const MessageKind = {
+  USER_MESSAGE: "USER_MESSAGE",
+  LLM_RESPONSE: "LLM_RESPONSE",
+  STAGE_OPENING: "STAGE_OPENING",
+  IDLE_NUDGE: "IDLE_NUDGE",
+} as const;
+export type MessageKind = (typeof MessageKind)[keyof typeof MessageKind];
+
 export interface LlmRequestLog {
   id: string;
   stage: Stage;
@@ -82,6 +119,7 @@ export interface LlmRequestLog {
   completedAt?: Date;
   failedAt?: Date;
   status: "STARTED" | "COMPLETED" | "FAILED";
+  inputSource: ChatInputSource;
   systemPrompt: string;
   promptVersion: string;
   model?: string;
@@ -91,8 +129,11 @@ export interface LlmRequestLog {
 }
 
 export interface LlmUsage {
-  chatOpenings: ChatOpening[];
+  chatAvailability: ChatAvailability[];
+  inputActivity: ChatInputActivity[];
   requests: LlmRequestLog[];
+  /** @deprecated Kept only so older saved records remain readable. */
+  chatOpenings?: LegacyChatOpening[];
 }
 
 export interface Passage {
@@ -100,6 +141,7 @@ export interface Passage {
   text: string;
   title: string;
   author: string;
+  publication?: string;
 }
 
 export const Stage = {
diff --git a/src/utils/artistMetrics.ts b/src/utils/artistMetrics.ts
index 92ba416..957c7a0 100644
--- a/src/utils/artistMetrics.ts
+++ b/src/utils/artistMetrics.ts
@@ -1,8 +1,64 @@
-import type { Poem } from "../types";
+import type { ChatInputActivity, Message, Poem, Stage } from "../types";
+import { ChatInputSource, MessageKind, Stage as StageValue } from "../types";
+import { ARTIST_DATA_LOGGING_VERSION } from "../consts/dataLogging";
+import { getChatAvailability } from "./llmUsage";
 
 const toMillis = (value: Date | string | undefined) =>
   value ? new Date(value).getTime() : undefined;
 
+const elapsedMs = (
+  start: Date | string | undefined,
+  end: Date | string | undefined,
+) => {
+  const startMs = toMillis(start);
+  const endMs = toMillis(end);
+  return startMs !== undefined && endMs !== undefined
+    ? Math.max(0, endMs - startMs)
+    : null;
+};
+
+const getUniqueConversationMessages = (poem: Poem) => {
+  const messagesById = new Map<string, Message>();
+  [...(poem.sparkConversation ?? []), ...(poem.writeConversation ?? [])].forEach(
+    (message) => messagesById.set(message.id, message),
+  );
+  return [...messagesById.values()];
+};
+
+const getStageChatMetrics = (
+  stage: Stage,
+  chatAvailability: ReturnType<typeof getChatAvailability>,
+  inputActivity: ChatInputActivity[],
+  messages: Message[],
+) => {
+  const availability = chatAvailability.find((item) => item.stage === stage);
+  const activity = inputActivity.find((item) => item.stage === stage);
+  const stageMessages = messages.filter((message) => message.stage === stage);
+
+  return {
+    chatAvailable: Boolean(availability),
+    chatFocusCount: activity?.focusCount ?? 0,
+    chatEverTyped: Boolean(activity?.firstTypedAt),
+    chatDraftStartCount: activity?.draftStartCount ?? 0,
+    chatAbandonedDraftCount: activity?.abandonedDraftCount ?? 0,
+    chatEndedWithUnsentDraft: activity?.hasUnsentDraft ?? false,
+    timeFromChatAvailableToFirstFocusMs: elapsedMs(
+      availability?.availableAt,
+      activity?.firstFocusedAt,
+    ),
+    timeFromChatAvailableToFirstTypingMs: elapsedMs(
+      availability?.availableAt,
+      activity?.firstTypedAt,
+    ),
+    stageOpeningShown: stageMessages.some(
+      (message) => message.kind === MessageKind.STAGE_OPENING,
+    ),
+    idleNudgeShown: stageMessages.some(
+      (message) => message.kind === MessageKind.IDLE_NUDGE,
+    ),
+  };
+};
+
 export const getFinalPoemText = (poem: Poem) => {
   const words = poem.passage.text.split(" ");
   return [...new Set(poem.text)]
@@ -28,6 +84,24 @@ export const deriveArtistMetrics = (poem: Poem) => {
   const completedRequests = (poem.llmUsage?.requests ?? []).filter(
     (request) => request.status === "COMPLETED",
   );
+  const requests = poem.llmUsage?.requests ?? [];
+  const hasDetailedChatLogging =
+    poem.loggingSchemaVersion === ARTIST_DATA_LOGGING_VERSION;
+  const chatAvailability = getChatAvailability(poem.llmUsage);
+  const inputActivity = poem.llmUsage?.inputActivity ?? [];
+  const conversationMessages = getUniqueConversationMessages(poem);
+  const sparkChat = getStageChatMetrics(
+    StageValue.SPARK,
+    chatAvailability,
+    inputActivity,
+    conversationMessages,
+  );
+  const writeChat = getStageChatMetrics(
+    StageValue.WRITE,
+    chatAvailability,
+    inputActivity,
+    conversationMessages,
+  );
 
   return {
     selectedWordCount: new Set(poem.text).size,
@@ -54,7 +128,85 @@ export const deriveArtistMetrics = (poem: Poem) => {
     writeTimeMs: poem.taskTiming?.phases?.write?.durationMs ?? null,
     llmUptake: completedRequests.length > 0,
     llmTurnCount: completedRequests.length,
-    llmAttemptCount: poem.llmUsage?.requests?.length ?? 0,
-    chatOpeningCount: poem.llmUsage?.chatOpenings?.length ?? 0,
+    llmAttemptCount: requests.length,
+    llmTypedAttemptCount: hasDetailedChatLogging
+      ? requests.filter(
+          (request) => request.inputSource === ChatInputSource.TYPED,
+        ).length
+      : null,
+    llmSuggestionAttemptCount: hasDetailedChatLogging
+      ? requests.filter(
+          (request) => request.inputSource === ChatInputSource.SUGGESTION,
+        ).length
+      : null,
+    chatAvailableStageCount: new Set(
+      chatAvailability.map((availability) => availability.stage),
+    ).size,
+    chatFocusCount: hasDetailedChatLogging
+      ? sparkChat.chatFocusCount + writeChat.chatFocusCount
+      : null,
+    chatDraftStartCount: hasDetailedChatLogging
+      ? sparkChat.chatDraftStartCount + writeChat.chatDraftStartCount
+      : null,
+    chatAbandonedDraftCount: hasDetailedChatLogging
+      ? sparkChat.chatAbandonedDraftCount +
+        writeChat.chatAbandonedDraftCount
+      : null,
+    sparkChatAvailable: sparkChat.chatAvailable,
+    sparkChatFocusCount: hasDetailedChatLogging
+      ? sparkChat.chatFocusCount
+      : null,
+    sparkChatEverTyped: hasDetailedChatLogging
+      ? sparkChat.chatEverTyped
+      : null,
+    sparkChatDraftStartCount: hasDetailedChatLogging
+      ? sparkChat.chatDraftStartCount
+      : null,
+    sparkChatAbandonedDraftCount: hasDetailedChatLogging
+      ? sparkChat.chatAbandonedDraftCount
+      : null,
+    sparkChatEndedWithUnsentDraft: hasDetailedChatLogging
+      ? sparkChat.chatEndedWithUnsentDraft
+      : null,
+    sparkTimeFromChatAvailableToFirstFocusMs: hasDetailedChatLogging
+      ? sparkChat.timeFromChatAvailableToFirstFocusMs
+      : null,
+    sparkTimeFromChatAvailableToFirstTypingMs: hasDetailedChatLogging
+      ? sparkChat.timeFromChatAvailableToFirstTypingMs
+      : null,
+    sparkStageOpeningShown: hasDetailedChatLogging
+      ? sparkChat.stageOpeningShown
+      : null,
+    sparkIdleNudgeShown: hasDetailedChatLogging
+      ? sparkChat.idleNudgeShown
+      : null,
+    writeChatAvailable: writeChat.chatAvailable,
+    writeChatFocusCount: hasDetailedChatLogging
+      ? writeChat.chatFocusCount
+      : null,
+    writeChatEverTyped: hasDetailedChatLogging
+      ? writeChat.chatEverTyped
+      : null,
+    writeChatDraftStartCount: hasDetailedChatLogging
+      ? writeChat.chatDraftStartCount
+      : null,
+    writeChatAbandonedDraftCount: hasDetailedChatLogging
+      ? writeChat.chatAbandonedDraftCount
+      : null,
+    writeChatEndedWithUnsentDraft: hasDetailedChatLogging
+      ? writeChat.chatEndedWithUnsentDraft
+      : null,
+    writeTimeFromChatAvailableToFirstFocusMs: hasDetailedChatLogging
+      ? writeChat.timeFromChatAvailableToFirstFocusMs
+      : null,
+    writeTimeFromChatAvailableToFirstTypingMs: hasDetailedChatLogging
+      ? writeChat.timeFromChatAvailableToFirstTypingMs
+      : null,
+    writeStageOpeningShown: hasDetailedChatLogging
+      ? writeChat.stageOpeningShown
+      : null,
+    writeIdleNudgeShown: hasDetailedChatLogging
+      ? writeChat.idleNudgeShown
+      : null,
   };
 };
diff --git a/src/utils/llmUsage.ts b/src/utils/llmUsage.ts
new file mode 100644
index 0000000..239e29e
--- /dev/null
+++ b/src/utils/llmUsage.ts
@@ -0,0 +1,12 @@
+import type { ChatAvailability, LlmUsage } from "../types";
+
+export const getChatAvailability = (
+  llmUsage: LlmUsage | undefined,
+): ChatAvailability[] => {
+  if (llmUsage?.chatAvailability) return llmUsage.chatAvailability;
+
+  return (llmUsage?.chatOpenings ?? []).map((opening) => ({
+    stage: opening.stage,
+    availableAt: opening.timestamp,
+  }));
+};