Add AI-assisted world and character drafting flows

apps/web/server/api/v1/coauthor/sessions/[id].get.ts

@@ -5,7 +5,7 @@ export default defineEventHandler(async (event) => {
     const user = await requireStageTwoUser(event)
     const id = stageTwoUuid(getRouterParam(event, 'id'))
     const sessions = await stageTwoDatabase<Array<Record<string, unknown>>>(
-      `coauthor_sessions?select=id,status,messages,generated_world,confirmed_world_id,created_at,updated_at&id=eq.${id}&owner_id=eq.${user.id}&limit=1`,
+      `coauthor_sessions?select=id,status,messages,current_question,generated_world,confirmed_world_id,created_at,updated_at&id=eq.${id}&owner_id=eq.${user.id}&limit=1`,
     )
     if (!sessions[0]) throw createError({ statusCode: 404, statusMessage: 'Coauthor session not found.' })
     return { session: { ...sessions[0], generatedWorld: sessions[0].generated_world ?? null } }

apps/web/server/api/v1/coauthor/sessions/[id]/respond.post.ts

@@ -7,13 +7,18 @@ const QuestionSchema = z.object({
   question: z.string().trim().min(5).max(300),
   options: z.array(z.string().trim().min(1).max(100)).length(3),
 })
+const StoredQuestionSchema = z.object({
+  id: z.string().trim().min(1).max(80),
+  label: z.string().trim().min(5).max(300),
+  options: z.array(z.string().trim().min(1).max(100)).length(3),
+})
 
 export default defineEventHandler(async (event) => {
   try {
     const user = await requireStageTwoUser(event)
     const sessionId = stageTwoUuid(getRouterParam(event, 'id'), 'session id')
-    const sessions = await stageTwoDatabase<Array<{ status: string; messages: unknown }>>(
-      `coauthor_sessions?select=status,messages&id=eq.${sessionId}&owner_id=eq.${user.id}&limit=1`,
+    const sessions = await stageTwoDatabase<Array<{ status: string; messages: unknown; current_question: unknown }>>(
+      `coauthor_sessions?select=status,messages,current_question&id=eq.${sessionId}&owner_id=eq.${user.id}&limit=1`,
     )
     const session = sessions[0]
     if (!session) throw createError({ statusCode: 404, statusMessage: 'Coauthor session not found.' })
@@ -21,6 +26,9 @@ export default defineEventHandler(async (event) => {
     const messages = z.array(MessageSchema).min(1).max(12).parse(session.messages)
     const answerCount = Math.max(0, messages.filter(message => message.role === 'user').length - 1)
     if (answerCount >= 4) return { readyToGenerate: true }
+    if (session.current_question) {
+      return { readyToGenerate: false, question: StoredQuestionSchema.parse(session.current_question) }
+    }
 
     const completion = buildJsonCompletion(useRuntimeConfig(), {
       system: `You are the Dungeons & Ground coauthor. Based only on this conversation, ask one focused question that makes the original TTRPG world more playable. This is clarification ${answerCount + 1} of 4. Do not repeat a topic already answered. Adapt to the requested genre. Provide exactly three concise, mutually distinct answer options. Keep everything suitable for ages 13+.`,
@@ -41,12 +49,17 @@ export default defineEventHandler(async (event) => {
     if (!response.ok) throw createError({ statusCode: 502, statusMessage: 'The coauthor is temporarily unavailable.' })
     const question = QuestionSchema.parse(parseJsonCompletion(await response.json()))
     requireStageTwoSafeText([question.question, ...question.options].join('\n'))
-    await stageTwoRpc('stage_two_append_coauthor_assistant_message', {
-      p_session_id: sessionId, p_owner_id: user.id, p_content: question.question,
+    const storedQuestion = StoredQuestionSchema.parse({
+      id: `question-${answerCount + 1}`,
+      label: question.question,
+      options: question.options,
+    })
+    await stageTwoRpc('stage_four_set_coauthor_question', {
+      p_session_id: sessionId, p_owner_id: user.id, p_question: storedQuestion,
     })
     return {
       readyToGenerate: false,
-      question: { id: `question-${messages.length}`, label: question.question, options: question.options },
+      question: storedQuestion,
     }
   } catch (error) {
     stageTwoApiError(error)

apps/web/server/api/v1/coauthor/sessions/index.get.ts

@@ -4,7 +4,7 @@ export default defineEventHandler(async (event) => {
   try {
     const user = await requireStageTwoUser(event)
     const sessions = await stageTwoDatabase<Array<Record<string, unknown>>>(
-      `coauthor_sessions?select=id,status,messages,generated_world,confirmed_world_id,created_at,updated_at&owner_id=eq.${user.id}&order=updated_at.desc`,
+      `coauthor_sessions?select=id,status,messages,current_question,generated_world,confirmed_world_id,created_at,updated_at&owner_id=eq.${user.id}&status=in.(collecting,generating,ready,failed)&order=updated_at.desc`,
     )
     return { sessions }
   } catch (error) {