@agimon-ai/doompi-user-feedback 0.0.1-alpha.27 → 0.0.1-alpha.29

package/README.md

@@ -1,12 +1,10 @@
 # @agimon-ai/doompi-user-feedback
 
-Structured user questions that wait for an answer in interactive Pi sessions, with an autonomous
-Voice handoff.
+Ask structured questions in interactive Pi sessions, including sessions using autonomous Voice.
 
 Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
 
-The `ask_user_question` tool presents concrete options instead of asking the model to continue on a
-guess.
+The `ask_user_question` tool presents concrete options and waits for the user to choose. It does not let the model guess.
 
 > **Alpha:** tool and Voice-handoff contracts may change between releases.
 

package/dist/adapters/pi/rpcQuestionnaireAdapter.cjs

@@ -1,2 +1,2 @@
-const e=`Type something.`,t=`Next`;function n(e){return{answers:e,cancelled:!0}}async function r(e,t,n,r){let i=await e.ui.input(t.question,`Type your answer`,{signal:r});if(i!==void 0)return{questionIndex:n,question:t.question,kind:`custom`,answer:i}}async function i(t,n,i,a){let o=[...n.options.map(e=>e.label),e],s=await t.ui.select(n.question,o,{signal:a});if(s===void 0)return;if(s===e)return r(t,n,i,a);let c=n.options.find(e=>e.label===s);if(c)return{questionIndex:i,question:n.question,kind:`option`,answer:c.label,...c.preview?{preview:c.preview}:{}}}function a(n,r){return[...n.options.map(e=>`${r.has(e.label)?`[x]`:`[ ]`} ${e.label}`),e,t]}function o(e){return e.replace(/^\[[ x]\]\s/u,``)}async function s(n,i,s,c){let l=new Set;for(;!c?.aborted;){let u=await n.ui.select(`${i.question} (choose options, then Next)`,a(i,l),{signal:c});if(u===void 0)return;if(u===e)return r(n,i,s,c);if(u===t)return{questionIndex:s,question:i.question,kind:`multi`,answer:null,selected:[...l]};let d=o(u);i.options.some(e=>e.label===d)&&(l.has(d)?l.delete(d):l.add(d))}}async function c(e,t,r,a){let o=[];for(let c=0;c<t.questions.length;c+=1){if(r?.aborted)return n(o);let l=t.questions[c];if(!l)continue;let u=l.multiSelect?await s(e,l,c,r):await i(e,l,c,r);if(!u)return n(o);o.push(u),a?.({answers:o.map(e=>({...e})),cancelled:!1})}return{answers:o,cancelled:!1}}exports.runRpcQuestionnaire=c;
+const e=require("../../services/answerEnvelope.cjs"),t=require("../../types/askUserWire.cjs"),n=`Type something.`,r=`Next`;function i(e){return{answers:e,cancelled:!0}}function a(n,r){let i=t.decodeAnswerEnvelope(r);if(i.kind===`absent`)return!1;if(i.kind===`malformed`)return n.result={answers:[],cancelled:!0,error:`malformed_answers`},!0;let a=e.readAnswerEnvelope(i.payload,n.params);return n.result=a.ok?{answers:a.answers,cancelled:!1}:{answers:[],cancelled:!0,error:`malformed_answers`},!0}async function o(e,t,n,r){let i=await e.ui.input(t.question,`Type your answer`,{signal:r});if(i!==void 0)return{questionIndex:n,question:t.question,kind:`custom`,answer:i}}async function s(e,t,r,i,s){let c=[...t.options.map(e=>e.label),n],l=await e.ui.select(t.question,c,{signal:s});if(l===void 0||a(i,l))return;if(l===n)return o(e,t,r,s);let u=t.options.find(e=>e.label===l);if(u)return{questionIndex:r,question:t.question,kind:`option`,answer:u.label,...u.preview?{preview:u.preview}:{}}}function c(e,t){return[...e.options.map(e=>`${t.has(e.label)?`[x]`:`[ ]`} ${e.label}`),n,r]}function l(e){return e.replace(/^\[[ x]\]\s/u,``)}async function u(e,t,i,s,u){let d=new Set;for(;!u?.aborted;){let f=await e.ui.select(`${t.question} (choose options, then Next)`,c(t,d),{signal:u});if(f===void 0||a(s,f))return;if(f===n)return o(e,t,i,u);if(f===r)return{questionIndex:i,question:t.question,kind:`multi`,answer:null,selected:[...d]};let p=l(f);t.options.some(e=>e.label===p)&&(d.has(p)?d.delete(p):d.add(p))}}async function d(e,t,n,r){let a=[],o={params:t};for(let c=0;c<t.questions.length;c+=1){if(n?.aborted)return i(a);let l=t.questions[c];if(!l)continue;let d=l.multiSelect?await u(e,l,c,o,n):await s(e,l,c,o,n);if(o.result!==void 0){let e=o.result;return e.cancelled||r?.({...e,answers:e.answers.map(e=>({...e}))}),e}if(!d)return i(a);a.push(d),r?.({answers:a.map(e=>({...e})),cancelled:!1})}return{answers:a,cancelled:!1}}exports.runRpcQuestionnaire=d;
 //# sourceMappingURL=rpcQuestionnaireAdapter.cjs.map

package/dist/adapters/pi/rpcQuestionnaireAdapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rpcQuestionnaireAdapter.cjs","names":[],"sources":["../../../src/adapters/pi/rpcQuestionnaireAdapter.ts"],"sourcesContent":["import type { ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { QuestionData, QuestionParams } from '../../schemas/questionnaire.js';\nimport type { QuestionAnswer, QuestionnaireResult } from '../../types/questionnaire.js';\n\nconst CUSTOM_LABEL = 'Type something.';\nconst DONE_LABEL = 'Next';\n\nfunction cancelled(answers: QuestionAnswer[]): QuestionnaireResult {\n  return { answers, cancelled: true };\n}\n\nasync function askForCustomAnswer(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const answer = await context.ui.input(question.question, 'Type your answer', { signal });\n  if (answer === undefined) return undefined;\n  return {\n    questionIndex,\n    question: question.question,\n    kind: 'custom',\n    answer,\n  };\n}\n\nasync function askSingleChoice(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const labels = [...question.options.map((option) => option.label), CUSTOM_LABEL];\n  const selected = await context.ui.select(question.question, labels, { signal });\n  if (selected === undefined) return undefined;\n  if (selected === CUSTOM_LABEL) {\n    return askForCustomAnswer(context, question, questionIndex, signal);\n  }\n  const option = question.options.find((candidate) => candidate.label === selected);\n  if (!option) return undefined;\n  return {\n    questionIndex,\n    question: question.question,\n    kind: 'option',\n    answer: option.label,\n    ...(option.preview ? { preview: option.preview } : {}),\n  };\n}\n\nfunction multiChoiceLabels(question: QuestionData, selected: ReadonlySet<string>): string[] {\n  const options = question.options.map((option) => {\n    const marker = selected.has(option.label) ? '[x]' : '[ ]';\n    return `${marker} ${option.label}`;\n  });\n  return [...options, CUSTOM_LABEL, DONE_LABEL];\n}\n\nfunction stripSelectionMarker(value: string): string {\n  return value.replace(/^\\[[ x]\\]\\s/u, '');\n}\n\nasync function askMultipleChoice(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const selected = new Set<string>();\n  while (!signal?.aborted) {\n    const choice = await context.ui.select(\n      `${question.question} (choose options, then Next)`,\n      multiChoiceLabels(question, selected),\n      { signal },\n    );\n    if (choice === undefined) return undefined;\n    if (choice === CUSTOM_LABEL) {\n      return askForCustomAnswer(context, question, questionIndex, signal);\n    }\n    if (choice === DONE_LABEL) {\n      return {\n        questionIndex,\n        question: question.question,\n        kind: 'multi',\n        answer: null,\n        selected: [...selected],\n      };\n    }\n    const label = stripSelectionMarker(choice);\n    if (!question.options.some((option) => option.label === label)) continue;\n    if (selected.has(label)) selected.delete(label);\n    else selected.add(label);\n  }\n  return undefined;\n}\n\nexport async function runRpcQuestionnaire(\n  context: ExtensionContext,\n  params: QuestionParams,\n  signal?: AbortSignal,\n  reportProgress?: (result: QuestionnaireResult) => void,\n): Promise<QuestionnaireResult> {\n  const answers: QuestionAnswer[] = [];\n  for (let questionIndex = 0; questionIndex < params.questions.length; questionIndex += 1) {\n    if (signal?.aborted) return cancelled(answers);\n    const question = params.questions[questionIndex];\n    if (!question) continue;\n    const answer = question.multiSelect\n      ? await askMultipleChoice(context, question, questionIndex, signal)\n      : await askSingleChoice(context, question, questionIndex, signal);\n    if (!answer) return cancelled(answers);\n    answers.push(answer);\n    reportProgress?.({ answers: answers.map((item) => ({ ...item })), cancelled: false });\n  }\n  return { answers, cancelled: false };\n}\n"],"mappings":"AAIA,MAAM,EAAe,kBACf,EAAa,OAEnB,SAAS,EAAU,EAAgD,CACjE,MAAO,CAAE,UAAS,UAAW,EAAK,CACpC,CAEA,eAAe,EACb,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAS,MAAM,EAAQ,GAAG,MAAM,EAAS,SAAU,mBAAoB,CAAE,QAAO,CAAC,EACnF,OAAW,IAAA,GACf,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,SACN,QACF,CACF,CAEA,eAAe,EACb,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAS,CAAC,GAAG,EAAS,QAAQ,IAAK,GAAW,EAAO,KAAK,EAAG,CAAY,EACzE,EAAW,MAAM,EAAQ,GAAG,OAAO,EAAS,SAAU,EAAQ,CAAE,QAAO,CAAC,EAC9E,GAAI,IAAa,IAAA,GAAW,OAC5B,GAAI,IAAa,EACf,OAAO,EAAmB,EAAS,EAAU,EAAe,CAAM,EAEpE,IAAM,EAAS,EAAS,QAAQ,KAAM,GAAc,EAAU,QAAU,CAAQ,EAC3E,KACL,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,SACN,OAAQ,EAAO,MACf,GAAI,EAAO,QAAU,CAAE,QAAS,EAAO,OAAQ,EAAI,CAAC,CACtD,CACF,CAEA,SAAS,EAAkB,EAAwB,EAAyC,CAK1F,MAAO,CAAC,GAJQ,EAAS,QAAQ,IAAK,GAE7B,GADQ,EAAS,IAAI,EAAO,KAAK,EAAI,MAAQ,MACnC,GAAG,EAAO,OAEZ,EAAG,EAAc,CAAU,CAC9C,CAEA,SAAS,EAAqB,EAAuB,CACnD,OAAO,EAAM,QAAQ,eAAgB,EAAE,CACzC,CAEA,eAAe,EACb,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAW,IAAI,IACrB,KAAO,CAAC,GAAQ,SAAS,CACvB,IAAM,EAAS,MAAM,EAAQ,GAAG,OAC9B,GAAG,EAAS,SAAS,8BACrB,EAAkB,EAAU,CAAQ,EACpC,CAAE,QAAO,CACX,EACA,GAAI,IAAW,IAAA,GAAW,OAC1B,GAAI,IAAW,EACb,OAAO,EAAmB,EAAS,EAAU,EAAe,CAAM,EAEpE,GAAI,IAAW,EACb,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,QACN,OAAQ,KACR,SAAU,CAAC,GAAG,CAAQ,CACxB,EAEF,IAAM,EAAQ,EAAqB,CAAM,EACpC,EAAS,QAAQ,KAAM,GAAW,EAAO,QAAU,CAAK,IACzD,EAAS,IAAI,CAAK,EAAG,EAAS,OAAO,CAAK,EACzC,EAAS,IAAI,CAAK,EACzB,CAEF,CAEA,eAAsB,EACpB,EACA,EACA,EACA,EAC8B,CAC9B,IAAM,EAA4B,CAAC,EACnC,IAAK,IAAI,EAAgB,EAAG,EAAgB,EAAO,UAAU,OAAQ,GAAiB,EAAG,CACvF,GAAI,GAAQ,QAAS,OAAO,EAAU,CAAO,EAC7C,IAAM,EAAW,EAAO,UAAU,GAClC,GAAI,CAAC,EAAU,SACf,IAAM,EAAS,EAAS,YACpB,MAAM,EAAkB,EAAS,EAAU,EAAe,CAAM,EAChE,MAAM,EAAgB,EAAS,EAAU,EAAe,CAAM,EAClE,GAAI,CAAC,EAAQ,OAAO,EAAU,CAAO,EACrC,EAAQ,KAAK,CAAM,EACnB,IAAiB,CAAE,QAAS,EAAQ,IAAK,IAAU,CAAE,GAAG,CAAK,EAAE,EAAG,UAAW,EAAM,CAAC,CACtF,CACA,MAAO,CAAE,UAAS,UAAW,EAAM,CACrC"}
+{"version":3,"file":"rpcQuestionnaireAdapter.cjs","names":["decodeAnswerEnvelope","readAnswerEnvelope"],"sources":["../../../src/adapters/pi/rpcQuestionnaireAdapter.ts"],"sourcesContent":["import type { ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { QuestionData, QuestionParams } from '../../schemas/questionnaire.js';\nimport { readAnswerEnvelope } from '../../services/answerEnvelope.js';\nimport { decodeAnswerEnvelope } from '../../types/askUserWire.js';\nimport type { QuestionAnswer, QuestionnaireResult } from '../../types/questionnaire.js';\n\nconst CUSTOM_LABEL = 'Type something.';\nconst DONE_LABEL = 'Next';\n\nfunction cancelled(answers: QuestionAnswer[]): QuestionnaireResult {\n  return { answers, cancelled: true };\n}\n\n/**\n * What a rich client replied, when it replied with the whole questionnaire.\n *\n * A client that can see the whole call answers every question at once rather\n * than walking this loop, so any select response may be an envelope instead of\n * a label. A response that is not one leaves the loop exactly as it was, which\n * is what keeps a plain RPC client working unchanged.\n */\ninterface EnvelopeSink {\n  params: QuestionParams;\n  /** Set once a select response carried the whole questionnaire; the loop stops and returns it. */\n  result?: QuestionnaireResult;\n}\n\n/** True when this response was the whole set, in which case the sink now holds the answer. */\nfunction takeEnvelope(sink: EnvelopeSink, selected: string | undefined): boolean {\n  const read = decodeAnswerEnvelope(selected);\n  if (read.kind === 'absent') return false;\n  if (read.kind === 'malformed') {\n    sink.result = { answers: [], cancelled: true, error: 'malformed_answers' };\n    return true;\n  }\n  const envelope = readAnswerEnvelope(read.payload, sink.params);\n  sink.result = envelope.ok\n    ? { answers: envelope.answers, cancelled: false }\n    : { answers: [], cancelled: true, error: 'malformed_answers' };\n  return true;\n}\n\nasync function askForCustomAnswer(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const answer = await context.ui.input(question.question, 'Type your answer', { signal });\n  if (answer === undefined) return undefined;\n  return {\n    questionIndex,\n    question: question.question,\n    kind: 'custom',\n    answer,\n  };\n}\n\nasync function askSingleChoice(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  sink: EnvelopeSink,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const labels = [...question.options.map((option) => option.label), CUSTOM_LABEL];\n  const selected = await context.ui.select(question.question, labels, { signal });\n  if (selected === undefined) return undefined;\n  if (takeEnvelope(sink, selected)) return undefined;\n  if (selected === CUSTOM_LABEL) {\n    return askForCustomAnswer(context, question, questionIndex, signal);\n  }\n  const option = question.options.find((candidate) => candidate.label === selected);\n  if (!option) return undefined;\n  return {\n    questionIndex,\n    question: question.question,\n    kind: 'option',\n    answer: option.label,\n    ...(option.preview ? { preview: option.preview } : {}),\n  };\n}\n\nfunction multiChoiceLabels(question: QuestionData, selected: ReadonlySet<string>): string[] {\n  const options = question.options.map((option) => {\n    const marker = selected.has(option.label) ? '[x]' : '[ ]';\n    return `${marker} ${option.label}`;\n  });\n  return [...options, CUSTOM_LABEL, DONE_LABEL];\n}\n\nfunction stripSelectionMarker(value: string): string {\n  return value.replace(/^\\[[ x]\\]\\s/u, '');\n}\n\nasync function askMultipleChoice(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  sink: EnvelopeSink,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const selected = new Set<string>();\n  while (!signal?.aborted) {\n    const choice = await context.ui.select(\n      `${question.question} (choose options, then Next)`,\n      multiChoiceLabels(question, selected),\n      { signal },\n    );\n    if (choice === undefined) return undefined;\n    if (takeEnvelope(sink, choice)) return undefined;\n    if (choice === CUSTOM_LABEL) {\n      return askForCustomAnswer(context, question, questionIndex, signal);\n    }\n    if (choice === DONE_LABEL) {\n      return {\n        questionIndex,\n        question: question.question,\n        kind: 'multi',\n        answer: null,\n        selected: [...selected],\n      };\n    }\n    const label = stripSelectionMarker(choice);\n    if (!question.options.some((option) => option.label === label)) continue;\n    if (selected.has(label)) selected.delete(label);\n    else selected.add(label);\n  }\n  return undefined;\n}\n\nexport async function runRpcQuestionnaire(\n  context: ExtensionContext,\n  params: QuestionParams,\n  signal?: AbortSignal,\n  reportProgress?: (result: QuestionnaireResult) => void,\n): Promise<QuestionnaireResult> {\n  const answers: QuestionAnswer[] = [];\n  const sink: EnvelopeSink = { params };\n  for (let questionIndex = 0; questionIndex < params.questions.length; questionIndex += 1) {\n    if (signal?.aborted) return cancelled(answers);\n    const question = params.questions[questionIndex];\n    if (!question) continue;\n    const answer = question.multiSelect\n      ? await askMultipleChoice(context, question, questionIndex, sink, signal)\n      : await askSingleChoice(context, question, questionIndex, sink, signal);\n    // A client that answered everything at once ends the walk here; the loop\n    // is only how a client that can see one question at a time gets through.\n    if (sink.result !== undefined) {\n      const whole = sink.result;\n      if (!whole.cancelled) {\n        reportProgress?.({ ...whole, answers: whole.answers.map((item) => ({ ...item })) });\n      }\n      return whole;\n    }\n    if (!answer) return cancelled(answers);\n    answers.push(answer);\n    reportProgress?.({ answers: answers.map((item) => ({ ...item })), cancelled: false });\n  }\n  return { answers, cancelled: false };\n}\n"],"mappings":"8FAMM,EAAe,kBACf,EAAa,OAEnB,SAAS,EAAU,EAAgD,CACjE,MAAO,CAAE,UAAS,UAAW,EAAK,CACpC,CAiBA,SAAS,EAAa,EAAoB,EAAuC,CAC/E,IAAM,EAAOA,EAAAA,qBAAqB,CAAQ,EAC1C,GAAI,EAAK,OAAS,SAAU,MAAO,GACnC,GAAI,EAAK,OAAS,YAEhB,MADA,GAAK,OAAS,CAAE,QAAS,CAAC,EAAG,UAAW,GAAM,MAAO,mBAAoB,EAClE,GAET,IAAM,EAAWC,EAAAA,mBAAmB,EAAK,QAAS,EAAK,MAAM,EAI7D,MAHA,GAAK,OAAS,EAAS,GACnB,CAAE,QAAS,EAAS,QAAS,UAAW,EAAM,EAC9C,CAAE,QAAS,CAAC,EAAG,UAAW,GAAM,MAAO,mBAAoB,EACxD,EACT,CAEA,eAAe,EACb,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAS,MAAM,EAAQ,GAAG,MAAM,EAAS,SAAU,mBAAoB,CAAE,QAAO,CAAC,EACnF,OAAW,IAAA,GACf,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,SACN,QACF,CACF,CAEA,eAAe,EACb,EACA,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAS,CAAC,GAAG,EAAS,QAAQ,IAAK,GAAW,EAAO,KAAK,EAAG,CAAY,EACzE,EAAW,MAAM,EAAQ,GAAG,OAAO,EAAS,SAAU,EAAQ,CAAE,QAAO,CAAC,EAE9E,GADI,IAAa,IAAA,IACb,EAAa,EAAM,CAAQ,EAAG,OAClC,GAAI,IAAa,EACf,OAAO,EAAmB,EAAS,EAAU,EAAe,CAAM,EAEpE,IAAM,EAAS,EAAS,QAAQ,KAAM,GAAc,EAAU,QAAU,CAAQ,EAC3E,KACL,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,SACN,OAAQ,EAAO,MACf,GAAI,EAAO,QAAU,CAAE,QAAS,EAAO,OAAQ,EAAI,CAAC,CACtD,CACF,CAEA,SAAS,EAAkB,EAAwB,EAAyC,CAK1F,MAAO,CAAC,GAJQ,EAAS,QAAQ,IAAK,GAE7B,GADQ,EAAS,IAAI,EAAO,KAAK,EAAI,MAAQ,MACnC,GAAG,EAAO,OAEZ,EAAG,EAAc,CAAU,CAC9C,CAEA,SAAS,EAAqB,EAAuB,CACnD,OAAO,EAAM,QAAQ,eAAgB,EAAE,CACzC,CAEA,eAAe,EACb,EACA,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAW,IAAI,IACrB,KAAO,CAAC,GAAQ,SAAS,CACvB,IAAM,EAAS,MAAM,EAAQ,GAAG,OAC9B,GAAG,EAAS,SAAS,8BACrB,EAAkB,EAAU,CAAQ,EACpC,CAAE,QAAO,CACX,EAEA,GADI,IAAW,IAAA,IACX,EAAa,EAAM,CAAM,EAAG,OAChC,GAAI,IAAW,EACb,OAAO,EAAmB,EAAS,EAAU,EAAe,CAAM,EAEpE,GAAI,IAAW,EACb,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,QACN,OAAQ,KACR,SAAU,CAAC,GAAG,CAAQ,CACxB,EAEF,IAAM,EAAQ,EAAqB,CAAM,EACpC,EAAS,QAAQ,KAAM,GAAW,EAAO,QAAU,CAAK,IACzD,EAAS,IAAI,CAAK,EAAG,EAAS,OAAO,CAAK,EACzC,EAAS,IAAI,CAAK,EACzB,CAEF,CAEA,eAAsB,EACpB,EACA,EACA,EACA,EAC8B,CAC9B,IAAM,EAA4B,CAAC,EAC7B,EAAqB,CAAE,QAAO,EACpC,IAAK,IAAI,EAAgB,EAAG,EAAgB,EAAO,UAAU,OAAQ,GAAiB,EAAG,CACvF,GAAI,GAAQ,QAAS,OAAO,EAAU,CAAO,EAC7C,IAAM,EAAW,EAAO,UAAU,GAClC,GAAI,CAAC,EAAU,SACf,IAAM,EAAS,EAAS,YACpB,MAAM,EAAkB,EAAS,EAAU,EAAe,EAAM,CAAM,EACtE,MAAM,EAAgB,EAAS,EAAU,EAAe,EAAM,CAAM,EAGxE,GAAI,EAAK,SAAW,IAAA,GAAW,CAC7B,IAAM,EAAQ,EAAK,OAInB,OAHK,EAAM,WACT,IAAiB,CAAE,GAAG,EAAO,QAAS,EAAM,QAAQ,IAAK,IAAU,CAAE,GAAG,CAAK,EAAE,CAAE,CAAC,EAE7E,CACT,CACA,GAAI,CAAC,EAAQ,OAAO,EAAU,CAAO,EACrC,EAAQ,KAAK,CAAM,EACnB,IAAiB,CAAE,QAAS,EAAQ,IAAK,IAAU,CAAE,GAAG,CAAK,EAAE,EAAG,UAAW,EAAM,CAAC,CACtF,CACA,MAAO,CAAE,UAAS,UAAW,EAAM,CACrC"}

package/dist/adapters/pi/rpcQuestionnaireAdapter.mjs

@@ -1,2 +1,2 @@
-const e=`Type something.`,t=`Next`;function n(e){return{answers:e,cancelled:!0}}async function r(e,t,n,r){let i=await e.ui.input(t.question,`Type your answer`,{signal:r});if(i!==void 0)return{questionIndex:n,question:t.question,kind:`custom`,answer:i}}async function i(t,n,i,a){let o=[...n.options.map(e=>e.label),e],s=await t.ui.select(n.question,o,{signal:a});if(s===void 0)return;if(s===e)return r(t,n,i,a);let c=n.options.find(e=>e.label===s);if(c)return{questionIndex:i,question:n.question,kind:`option`,answer:c.label,...c.preview?{preview:c.preview}:{}}}function a(n,r){return[...n.options.map(e=>`${r.has(e.label)?`[x]`:`[ ]`} ${e.label}`),e,t]}function o(e){return e.replace(/^\[[ x]\]\s/u,``)}async function s(n,i,s,c){let l=new Set;for(;!c?.aborted;){let u=await n.ui.select(`${i.question} (choose options, then Next)`,a(i,l),{signal:c});if(u===void 0)return;if(u===e)return r(n,i,s,c);if(u===t)return{questionIndex:s,question:i.question,kind:`multi`,answer:null,selected:[...l]};let d=o(u);i.options.some(e=>e.label===d)&&(l.has(d)?l.delete(d):l.add(d))}}async function c(e,t,r,a){let o=[];for(let c=0;c<t.questions.length;c+=1){if(r?.aborted)return n(o);let l=t.questions[c];if(!l)continue;let u=l.multiSelect?await s(e,l,c,r):await i(e,l,c,r);if(!u)return n(o);o.push(u),a?.({answers:o.map(e=>({...e})),cancelled:!1})}return{answers:o,cancelled:!1}}export{c as runRpcQuestionnaire};
+import{readAnswerEnvelope as e}from"../../services/answerEnvelope.mjs";import{decodeAnswerEnvelope as t}from"../../types/askUserWire.mjs";const n=`Type something.`,r=`Next`;function i(e){return{answers:e,cancelled:!0}}function a(n,r){let i=t(r);if(i.kind===`absent`)return!1;if(i.kind===`malformed`)return n.result={answers:[],cancelled:!0,error:`malformed_answers`},!0;let a=e(i.payload,n.params);return n.result=a.ok?{answers:a.answers,cancelled:!1}:{answers:[],cancelled:!0,error:`malformed_answers`},!0}async function o(e,t,n,r){let i=await e.ui.input(t.question,`Type your answer`,{signal:r});if(i!==void 0)return{questionIndex:n,question:t.question,kind:`custom`,answer:i}}async function s(e,t,r,i,s){let c=[...t.options.map(e=>e.label),n],l=await e.ui.select(t.question,c,{signal:s});if(l===void 0||a(i,l))return;if(l===n)return o(e,t,r,s);let u=t.options.find(e=>e.label===l);if(u)return{questionIndex:r,question:t.question,kind:`option`,answer:u.label,...u.preview?{preview:u.preview}:{}}}function c(e,t){return[...e.options.map(e=>`${t.has(e.label)?`[x]`:`[ ]`} ${e.label}`),n,r]}function l(e){return e.replace(/^\[[ x]\]\s/u,``)}async function u(e,t,i,s,u){let d=new Set;for(;!u?.aborted;){let f=await e.ui.select(`${t.question} (choose options, then Next)`,c(t,d),{signal:u});if(f===void 0||a(s,f))return;if(f===n)return o(e,t,i,u);if(f===r)return{questionIndex:i,question:t.question,kind:`multi`,answer:null,selected:[...d]};let p=l(f);t.options.some(e=>e.label===p)&&(d.has(p)?d.delete(p):d.add(p))}}async function d(e,t,n,r){let a=[],o={params:t};for(let c=0;c<t.questions.length;c+=1){if(n?.aborted)return i(a);let l=t.questions[c];if(!l)continue;let d=l.multiSelect?await u(e,l,c,o,n):await s(e,l,c,o,n);if(o.result!==void 0){let e=o.result;return e.cancelled||r?.({...e,answers:e.answers.map(e=>({...e}))}),e}if(!d)return i(a);a.push(d),r?.({answers:a.map(e=>({...e})),cancelled:!1})}return{answers:a,cancelled:!1}}export{d as runRpcQuestionnaire};
 //# sourceMappingURL=rpcQuestionnaireAdapter.mjs.map

package/dist/adapters/pi/rpcQuestionnaireAdapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rpcQuestionnaireAdapter.mjs","names":[],"sources":["../../../src/adapters/pi/rpcQuestionnaireAdapter.ts"],"sourcesContent":["import type { ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { QuestionData, QuestionParams } from '../../schemas/questionnaire.js';\nimport type { QuestionAnswer, QuestionnaireResult } from '../../types/questionnaire.js';\n\nconst CUSTOM_LABEL = 'Type something.';\nconst DONE_LABEL = 'Next';\n\nfunction cancelled(answers: QuestionAnswer[]): QuestionnaireResult {\n  return { answers, cancelled: true };\n}\n\nasync function askForCustomAnswer(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const answer = await context.ui.input(question.question, 'Type your answer', { signal });\n  if (answer === undefined) return undefined;\n  return {\n    questionIndex,\n    question: question.question,\n    kind: 'custom',\n    answer,\n  };\n}\n\nasync function askSingleChoice(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const labels = [...question.options.map((option) => option.label), CUSTOM_LABEL];\n  const selected = await context.ui.select(question.question, labels, { signal });\n  if (selected === undefined) return undefined;\n  if (selected === CUSTOM_LABEL) {\n    return askForCustomAnswer(context, question, questionIndex, signal);\n  }\n  const option = question.options.find((candidate) => candidate.label === selected);\n  if (!option) return undefined;\n  return {\n    questionIndex,\n    question: question.question,\n    kind: 'option',\n    answer: option.label,\n    ...(option.preview ? { preview: option.preview } : {}),\n  };\n}\n\nfunction multiChoiceLabels(question: QuestionData, selected: ReadonlySet<string>): string[] {\n  const options = question.options.map((option) => {\n    const marker = selected.has(option.label) ? '[x]' : '[ ]';\n    return `${marker} ${option.label}`;\n  });\n  return [...options, CUSTOM_LABEL, DONE_LABEL];\n}\n\nfunction stripSelectionMarker(value: string): string {\n  return value.replace(/^\\[[ x]\\]\\s/u, '');\n}\n\nasync function askMultipleChoice(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const selected = new Set<string>();\n  while (!signal?.aborted) {\n    const choice = await context.ui.select(\n      `${question.question} (choose options, then Next)`,\n      multiChoiceLabels(question, selected),\n      { signal },\n    );\n    if (choice === undefined) return undefined;\n    if (choice === CUSTOM_LABEL) {\n      return askForCustomAnswer(context, question, questionIndex, signal);\n    }\n    if (choice === DONE_LABEL) {\n      return {\n        questionIndex,\n        question: question.question,\n        kind: 'multi',\n        answer: null,\n        selected: [...selected],\n      };\n    }\n    const label = stripSelectionMarker(choice);\n    if (!question.options.some((option) => option.label === label)) continue;\n    if (selected.has(label)) selected.delete(label);\n    else selected.add(label);\n  }\n  return undefined;\n}\n\nexport async function runRpcQuestionnaire(\n  context: ExtensionContext,\n  params: QuestionParams,\n  signal?: AbortSignal,\n  reportProgress?: (result: QuestionnaireResult) => void,\n): Promise<QuestionnaireResult> {\n  const answers: QuestionAnswer[] = [];\n  for (let questionIndex = 0; questionIndex < params.questions.length; questionIndex += 1) {\n    if (signal?.aborted) return cancelled(answers);\n    const question = params.questions[questionIndex];\n    if (!question) continue;\n    const answer = question.multiSelect\n      ? await askMultipleChoice(context, question, questionIndex, signal)\n      : await askSingleChoice(context, question, questionIndex, signal);\n    if (!answer) return cancelled(answers);\n    answers.push(answer);\n    reportProgress?.({ answers: answers.map((item) => ({ ...item })), cancelled: false });\n  }\n  return { answers, cancelled: false };\n}\n"],"mappings":"AAIA,MAAM,EAAe,kBACf,EAAa,OAEnB,SAAS,EAAU,EAAgD,CACjE,MAAO,CAAE,UAAS,UAAW,EAAK,CACpC,CAEA,eAAe,EACb,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAS,MAAM,EAAQ,GAAG,MAAM,EAAS,SAAU,mBAAoB,CAAE,QAAO,CAAC,EACnF,OAAW,IAAA,GACf,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,SACN,QACF,CACF,CAEA,eAAe,EACb,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAS,CAAC,GAAG,EAAS,QAAQ,IAAK,GAAW,EAAO,KAAK,EAAG,CAAY,EACzE,EAAW,MAAM,EAAQ,GAAG,OAAO,EAAS,SAAU,EAAQ,CAAE,QAAO,CAAC,EAC9E,GAAI,IAAa,IAAA,GAAW,OAC5B,GAAI,IAAa,EACf,OAAO,EAAmB,EAAS,EAAU,EAAe,CAAM,EAEpE,IAAM,EAAS,EAAS,QAAQ,KAAM,GAAc,EAAU,QAAU,CAAQ,EAC3E,KACL,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,SACN,OAAQ,EAAO,MACf,GAAI,EAAO,QAAU,CAAE,QAAS,EAAO,OAAQ,EAAI,CAAC,CACtD,CACF,CAEA,SAAS,EAAkB,EAAwB,EAAyC,CAK1F,MAAO,CAAC,GAJQ,EAAS,QAAQ,IAAK,GAE7B,GADQ,EAAS,IAAI,EAAO,KAAK,EAAI,MAAQ,MACnC,GAAG,EAAO,OAEZ,EAAG,EAAc,CAAU,CAC9C,CAEA,SAAS,EAAqB,EAAuB,CACnD,OAAO,EAAM,QAAQ,eAAgB,EAAE,CACzC,CAEA,eAAe,EACb,EACA,EACA,EACA,EACqC,CACrC,IAAM,EAAW,IAAI,IACrB,KAAO,CAAC,GAAQ,SAAS,CACvB,IAAM,EAAS,MAAM,EAAQ,GAAG,OAC9B,GAAG,EAAS,SAAS,8BACrB,EAAkB,EAAU,CAAQ,EACpC,CAAE,QAAO,CACX,EACA,GAAI,IAAW,IAAA,GAAW,OAC1B,GAAI,IAAW,EACb,OAAO,EAAmB,EAAS,EAAU,EAAe,CAAM,EAEpE,GAAI,IAAW,EACb,MAAO,CACL,gBACA,SAAU,EAAS,SACnB,KAAM,QACN,OAAQ,KACR,SAAU,CAAC,GAAG,CAAQ,CACxB,EAEF,IAAM,EAAQ,EAAqB,CAAM,EACpC,EAAS,QAAQ,KAAM,GAAW,EAAO,QAAU,CAAK,IACzD,EAAS,IAAI,CAAK,EAAG,EAAS,OAAO,CAAK,EACzC,EAAS,IAAI,CAAK,EACzB,CAEF,CAEA,eAAsB,EACpB,EACA,EACA,EACA,EAC8B,CAC9B,IAAM,EAA4B,CAAC,EACnC,IAAK,IAAI,EAAgB,EAAG,EAAgB,EAAO,UAAU,OAAQ,GAAiB,EAAG,CACvF,GAAI,GAAQ,QAAS,OAAO,EAAU,CAAO,EAC7C,IAAM,EAAW,EAAO,UAAU,GAClC,GAAI,CAAC,EAAU,SACf,IAAM,EAAS,EAAS,YACpB,MAAM,EAAkB,EAAS,EAAU,EAAe,CAAM,EAChE,MAAM,EAAgB,EAAS,EAAU,EAAe,CAAM,EAClE,GAAI,CAAC,EAAQ,OAAO,EAAU,CAAO,EACrC,EAAQ,KAAK,CAAM,EACnB,IAAiB,CAAE,QAAS,EAAQ,IAAK,IAAU,CAAE,GAAG,CAAK,EAAE,EAAG,UAAW,EAAM,CAAC,CACtF,CACA,MAAO,CAAE,UAAS,UAAW,EAAM,CACrC"}
+{"version":3,"file":"rpcQuestionnaireAdapter.mjs","names":[],"sources":["../../../src/adapters/pi/rpcQuestionnaireAdapter.ts"],"sourcesContent":["import type { ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport type { QuestionData, QuestionParams } from '../../schemas/questionnaire.js';\nimport { readAnswerEnvelope } from '../../services/answerEnvelope.js';\nimport { decodeAnswerEnvelope } from '../../types/askUserWire.js';\nimport type { QuestionAnswer, QuestionnaireResult } from '../../types/questionnaire.js';\n\nconst CUSTOM_LABEL = 'Type something.';\nconst DONE_LABEL = 'Next';\n\nfunction cancelled(answers: QuestionAnswer[]): QuestionnaireResult {\n  return { answers, cancelled: true };\n}\n\n/**\n * What a rich client replied, when it replied with the whole questionnaire.\n *\n * A client that can see the whole call answers every question at once rather\n * than walking this loop, so any select response may be an envelope instead of\n * a label. A response that is not one leaves the loop exactly as it was, which\n * is what keeps a plain RPC client working unchanged.\n */\ninterface EnvelopeSink {\n  params: QuestionParams;\n  /** Set once a select response carried the whole questionnaire; the loop stops and returns it. */\n  result?: QuestionnaireResult;\n}\n\n/** True when this response was the whole set, in which case the sink now holds the answer. */\nfunction takeEnvelope(sink: EnvelopeSink, selected: string | undefined): boolean {\n  const read = decodeAnswerEnvelope(selected);\n  if (read.kind === 'absent') return false;\n  if (read.kind === 'malformed') {\n    sink.result = { answers: [], cancelled: true, error: 'malformed_answers' };\n    return true;\n  }\n  const envelope = readAnswerEnvelope(read.payload, sink.params);\n  sink.result = envelope.ok\n    ? { answers: envelope.answers, cancelled: false }\n    : { answers: [], cancelled: true, error: 'malformed_answers' };\n  return true;\n}\n\nasync function askForCustomAnswer(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const answer = await context.ui.input(question.question, 'Type your answer', { signal });\n  if (answer === undefined) return undefined;\n  return {\n    questionIndex,\n    question: question.question,\n    kind: 'custom',\n    answer,\n  };\n}\n\nasync function askSingleChoice(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  sink: EnvelopeSink,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const labels = [...question.options.map((option) => option.label), CUSTOM_LABEL];\n  const selected = await context.ui.select(question.question, labels, { signal });\n  if (selected === undefined) return undefined;\n  if (takeEnvelope(sink, selected)) return undefined;\n  if (selected === CUSTOM_LABEL) {\n    return askForCustomAnswer(context, question, questionIndex, signal);\n  }\n  const option = question.options.find((candidate) => candidate.label === selected);\n  if (!option) return undefined;\n  return {\n    questionIndex,\n    question: question.question,\n    kind: 'option',\n    answer: option.label,\n    ...(option.preview ? { preview: option.preview } : {}),\n  };\n}\n\nfunction multiChoiceLabels(question: QuestionData, selected: ReadonlySet<string>): string[] {\n  const options = question.options.map((option) => {\n    const marker = selected.has(option.label) ? '[x]' : '[ ]';\n    return `${marker} ${option.label}`;\n  });\n  return [...options, CUSTOM_LABEL, DONE_LABEL];\n}\n\nfunction stripSelectionMarker(value: string): string {\n  return value.replace(/^\\[[ x]\\]\\s/u, '');\n}\n\nasync function askMultipleChoice(\n  context: ExtensionContext,\n  question: QuestionData,\n  questionIndex: number,\n  sink: EnvelopeSink,\n  signal?: AbortSignal,\n): Promise<QuestionAnswer | undefined> {\n  const selected = new Set<string>();\n  while (!signal?.aborted) {\n    const choice = await context.ui.select(\n      `${question.question} (choose options, then Next)`,\n      multiChoiceLabels(question, selected),\n      { signal },\n    );\n    if (choice === undefined) return undefined;\n    if (takeEnvelope(sink, choice)) return undefined;\n    if (choice === CUSTOM_LABEL) {\n      return askForCustomAnswer(context, question, questionIndex, signal);\n    }\n    if (choice === DONE_LABEL) {\n      return {\n        questionIndex,\n        question: question.question,\n        kind: 'multi',\n        answer: null,\n        selected: [...selected],\n      };\n    }\n    const label = stripSelectionMarker(choice);\n    if (!question.options.some((option) => option.label === label)) continue;\n    if (selected.has(label)) selected.delete(label);\n    else selected.add(label);\n  }\n  return undefined;\n}\n\nexport async function runRpcQuestionnaire(\n  context: ExtensionContext,\n  params: QuestionParams,\n  signal?: AbortSignal,\n  reportProgress?: (result: QuestionnaireResult) => void,\n): Promise<QuestionnaireResult> {\n  const answers: QuestionAnswer[] = [];\n  const sink: EnvelopeSink = { params };\n  for (let questionIndex = 0; questionIndex < params.questions.length; questionIndex += 1) {\n    if (signal?.aborted) return cancelled(answers);\n    const question = params.questions[questionIndex];\n    if (!question) continue;\n    const answer = question.multiSelect\n      ? await askMultipleChoice(context, question, questionIndex, sink, signal)\n      : await askSingleChoice(context, question, questionIndex, sink, signal);\n    // A client that answered everything at once ends the walk here; the loop\n    // is only how a client that can see one question at a time gets through.\n    if (sink.result !== undefined) {\n      const whole = sink.result;\n      if (!whole.cancelled) {\n        reportProgress?.({ ...whole, answers: whole.answers.map((item) => ({ ...item })) });\n      }\n      return whole;\n    }\n    if (!answer) return cancelled(answers);\n    answers.push(answer);\n    reportProgress?.({ answers: answers.map((item) => ({ ...item })), cancelled: false });\n  }\n  return { answers, cancelled: false };\n}\n"],"mappings":"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"}

package/dist/services/answerEnvelope.cjs

@@ -0,0 +1,2 @@
+const e=4e3,t=[`option`,`custom`,`multi`];function n(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function r(t){if(typeof t!=`string`)return;let n=t.trim();return n===``?void 0:n.slice(0,e)}function i(i,a,o){if(!n(i))return`an answer was not an object`;let s=i.questionIndex;if(typeof s!=`number`||!Number.isInteger(s))return`an answer carried no question index`;let c=a.questions[s];if(c===void 0)return`no question ${String(s)} was asked`;if(o.has(s))return`question ${String(s)} was answered twice`;o.add(s);let l=i.kind;if(typeof l!=`string`||!t.includes(l))return`question ${String(s)} carried an unknown answer kind`;let u=r(i.notes),d={questionIndex:s,question:c.question,...u===void 0?{}:{notes:u}};if(l===`multi`){let e=i.selected;if(!Array.isArray(e))return`question ${String(s)} selected nothing readable`;let t=e.filter(e=>typeof e==`string`);return t.length===e.length?t.some(e=>!c.options.some(t=>t.label===e))?`question ${String(s)} selected an option it was not offered`:{...d,kind:`multi`,answer:null,selected:[...new Set(t)]}:`question ${String(s)} selected a non-label`}if(l===`option`){let e=i.answer,t=typeof e==`string`?c.options.find(t=>t.label===e):void 0;return t===void 0?`question ${String(s)} chose an option it was not offered`:{...d,kind:`option`,answer:t.label,...t.preview?{preview:t.preview}:{}}}let f=i.answer;return typeof f==`string`?{...d,kind:`custom`,answer:f.slice(0,e)}:`question ${String(s)} typed nothing readable`}function a(e,t){if(!n(e)||!Array.isArray(e.answers)||e.answers.length===0)return{ok:!1,reason:`no answers were carried`};if(e.answers.length>t.questions.length)return{ok:!1,reason:`more answers than questions`};let r=new Set,a=[];for(let n of e.answers){let e=i(n,t,r);if(typeof e==`string`)return{ok:!1,reason:e};a.push(e)}return a.sort((e,t)=>e.questionIndex-t.questionIndex),{ok:!0,answers:a}}exports.MAX_ANSWER_TEXT_LENGTH=e,exports.readAnswerEnvelope=a;
+//# sourceMappingURL=answerEnvelope.cjs.map

package/dist/services/answerEnvelope.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerEnvelope.cjs","names":[],"sources":["../../src/services/answerEnvelope.ts"],"sourcesContent":["import type { QuestionData, QuestionParams } from '../schemas/questionnaire.js';\nimport type { AnswerKind, QuestionAnswer } from '../types/questionnaire.js';\n\n/**\n * Read a whole-questionnaire answer envelope back against the questions it claims to answer.\n *\n * The envelope arrives on a select response, which is reader input rather than\n * anything the tool authored, so nothing in it is taken on trust: an index has\n * to name a question that was asked, a chosen label has to be one that\n * question offered, and free text is capped. An envelope that fails is refused\n * rather than repaired, because a half-read answer set reaches the model as\n * the reader's decision and there is no way to tell from there that part of it\n * was invented.\n *\n * `preview` is the clearest case: it is read from the option the tool\n * declared, never from the wire, so the model cannot be shown a preview that\n * was never offered.\n *\n * Host-neutral by construction: the questions and the payload both arrive as\n * arguments, so the same arguments always produce the same result.\n */\nexport const MAX_ANSWER_TEXT_LENGTH = 4000;\n\nexport type AnswerEnvelopeResult =\n  | { readonly ok: true; readonly answers: QuestionAnswer[] }\n  | { readonly ok: false; readonly reason: string };\n\nconst ANSWER_KINDS: readonly string[] = ['option', 'custom', 'multi'] satisfies readonly AnswerKind[];\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction optionalNote(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  const trimmed = value.trim();\n  return trimmed === '' ? undefined : trimmed.slice(0, MAX_ANSWER_TEXT_LENGTH);\n}\n\n/** One answer, rebuilt from the question it names rather than copied off the wire. */\nfunction readAnswer(entry: unknown, params: QuestionParams, seen: Set<number>): QuestionAnswer | string {\n  if (!isRecord(entry)) return 'an answer was not an object';\n  const questionIndex = entry.questionIndex;\n  if (typeof questionIndex !== 'number' || !Number.isInteger(questionIndex)) {\n    return 'an answer carried no question index';\n  }\n  const question: QuestionData | undefined = params.questions[questionIndex];\n  if (question === undefined) return `no question ${String(questionIndex)} was asked`;\n  if (seen.has(questionIndex)) return `question ${String(questionIndex)} was answered twice`;\n  seen.add(questionIndex);\n\n  const kind = entry.kind;\n  if (typeof kind !== 'string' || !ANSWER_KINDS.includes(kind)) {\n    return `question ${String(questionIndex)} carried an unknown answer kind`;\n  }\n  const notes = optionalNote(entry.notes);\n  const base = { questionIndex, question: question.question, ...(notes === undefined ? {} : { notes }) };\n\n  if (kind === 'multi') {\n    const selected = entry.selected;\n    if (!Array.isArray(selected)) return `question ${String(questionIndex)} selected nothing readable`;\n    const labels = selected.filter((label): label is string => typeof label === 'string');\n    if (labels.length !== selected.length) return `question ${String(questionIndex)} selected a non-label`;\n    if (labels.some((label) => !question.options.some((option) => option.label === label))) {\n      return `question ${String(questionIndex)} selected an option it was not offered`;\n    }\n    return { ...base, kind: 'multi', answer: null, selected: [...new Set(labels)] };\n  }\n\n  if (kind === 'option') {\n    const label = entry.answer;\n    const chosen = typeof label === 'string' ? question.options.find((option) => option.label === label) : undefined;\n    if (chosen === undefined) return `question ${String(questionIndex)} chose an option it was not offered`;\n    // From the option the tool declared, so a preview the reader never saw\n    // cannot be put in the model's mouth.\n    return { ...base, kind: 'option', answer: chosen.label, ...(chosen.preview ? { preview: chosen.preview } : {}) };\n  }\n\n  const typed = entry.answer;\n  if (typeof typed !== 'string') return `question ${String(questionIndex)} typed nothing readable`;\n  return { ...base, kind: 'custom', answer: typed.slice(0, MAX_ANSWER_TEXT_LENGTH) };\n}\n\nexport function readAnswerEnvelope(payload: unknown, params: QuestionParams): AnswerEnvelopeResult {\n  if (!isRecord(payload) || !Array.isArray(payload.answers)) return { ok: false, reason: 'no answers were carried' };\n  if (payload.answers.length === 0) return { ok: false, reason: 'no answers were carried' };\n  if (payload.answers.length > params.questions.length) return { ok: false, reason: 'more answers than questions' };\n\n  const seen = new Set<number>();\n  const answers: QuestionAnswer[] = [];\n  for (const entry of payload.answers) {\n    const answer = readAnswer(entry, params, seen);\n    if (typeof answer === 'string') return { ok: false, reason: answer };\n    answers.push(answer);\n  }\n  // The model reads them in the order it asked, whatever order they arrived in.\n  answers.sort((left, right) => left.questionIndex - right.questionIndex);\n  return { ok: true, answers };\n}\n"],"mappings":"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"}

package/dist/services/answerEnvelope.mjs

@@ -0,0 +1,2 @@
+const e=4e3,t=[`option`,`custom`,`multi`];function n(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function r(t){if(typeof t!=`string`)return;let n=t.trim();return n===``?void 0:n.slice(0,e)}function i(i,a,o){if(!n(i))return`an answer was not an object`;let s=i.questionIndex;if(typeof s!=`number`||!Number.isInteger(s))return`an answer carried no question index`;let c=a.questions[s];if(c===void 0)return`no question ${String(s)} was asked`;if(o.has(s))return`question ${String(s)} was answered twice`;o.add(s);let l=i.kind;if(typeof l!=`string`||!t.includes(l))return`question ${String(s)} carried an unknown answer kind`;let u=r(i.notes),d={questionIndex:s,question:c.question,...u===void 0?{}:{notes:u}};if(l===`multi`){let e=i.selected;if(!Array.isArray(e))return`question ${String(s)} selected nothing readable`;let t=e.filter(e=>typeof e==`string`);return t.length===e.length?t.some(e=>!c.options.some(t=>t.label===e))?`question ${String(s)} selected an option it was not offered`:{...d,kind:`multi`,answer:null,selected:[...new Set(t)]}:`question ${String(s)} selected a non-label`}if(l===`option`){let e=i.answer,t=typeof e==`string`?c.options.find(t=>t.label===e):void 0;return t===void 0?`question ${String(s)} chose an option it was not offered`:{...d,kind:`option`,answer:t.label,...t.preview?{preview:t.preview}:{}}}let f=i.answer;return typeof f==`string`?{...d,kind:`custom`,answer:f.slice(0,e)}:`question ${String(s)} typed nothing readable`}function a(e,t){if(!n(e)||!Array.isArray(e.answers)||e.answers.length===0)return{ok:!1,reason:`no answers were carried`};if(e.answers.length>t.questions.length)return{ok:!1,reason:`more answers than questions`};let r=new Set,a=[];for(let n of e.answers){let e=i(n,t,r);if(typeof e==`string`)return{ok:!1,reason:e};a.push(e)}return a.sort((e,t)=>e.questionIndex-t.questionIndex),{ok:!0,answers:a}}export{e as MAX_ANSWER_TEXT_LENGTH,a as readAnswerEnvelope};
+//# sourceMappingURL=answerEnvelope.mjs.map

package/dist/services/answerEnvelope.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"answerEnvelope.mjs","names":[],"sources":["../../src/services/answerEnvelope.ts"],"sourcesContent":["import type { QuestionData, QuestionParams } from '../schemas/questionnaire.js';\nimport type { AnswerKind, QuestionAnswer } from '../types/questionnaire.js';\n\n/**\n * Read a whole-questionnaire answer envelope back against the questions it claims to answer.\n *\n * The envelope arrives on a select response, which is reader input rather than\n * anything the tool authored, so nothing in it is taken on trust: an index has\n * to name a question that was asked, a chosen label has to be one that\n * question offered, and free text is capped. An envelope that fails is refused\n * rather than repaired, because a half-read answer set reaches the model as\n * the reader's decision and there is no way to tell from there that part of it\n * was invented.\n *\n * `preview` is the clearest case: it is read from the option the tool\n * declared, never from the wire, so the model cannot be shown a preview that\n * was never offered.\n *\n * Host-neutral by construction: the questions and the payload both arrive as\n * arguments, so the same arguments always produce the same result.\n */\nexport const MAX_ANSWER_TEXT_LENGTH = 4000;\n\nexport type AnswerEnvelopeResult =\n  | { readonly ok: true; readonly answers: QuestionAnswer[] }\n  | { readonly ok: false; readonly reason: string };\n\nconst ANSWER_KINDS: readonly string[] = ['option', 'custom', 'multi'] satisfies readonly AnswerKind[];\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction optionalNote(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  const trimmed = value.trim();\n  return trimmed === '' ? undefined : trimmed.slice(0, MAX_ANSWER_TEXT_LENGTH);\n}\n\n/** One answer, rebuilt from the question it names rather than copied off the wire. */\nfunction readAnswer(entry: unknown, params: QuestionParams, seen: Set<number>): QuestionAnswer | string {\n  if (!isRecord(entry)) return 'an answer was not an object';\n  const questionIndex = entry.questionIndex;\n  if (typeof questionIndex !== 'number' || !Number.isInteger(questionIndex)) {\n    return 'an answer carried no question index';\n  }\n  const question: QuestionData | undefined = params.questions[questionIndex];\n  if (question === undefined) return `no question ${String(questionIndex)} was asked`;\n  if (seen.has(questionIndex)) return `question ${String(questionIndex)} was answered twice`;\n  seen.add(questionIndex);\n\n  const kind = entry.kind;\n  if (typeof kind !== 'string' || !ANSWER_KINDS.includes(kind)) {\n    return `question ${String(questionIndex)} carried an unknown answer kind`;\n  }\n  const notes = optionalNote(entry.notes);\n  const base = { questionIndex, question: question.question, ...(notes === undefined ? {} : { notes }) };\n\n  if (kind === 'multi') {\n    const selected = entry.selected;\n    if (!Array.isArray(selected)) return `question ${String(questionIndex)} selected nothing readable`;\n    const labels = selected.filter((label): label is string => typeof label === 'string');\n    if (labels.length !== selected.length) return `question ${String(questionIndex)} selected a non-label`;\n    if (labels.some((label) => !question.options.some((option) => option.label === label))) {\n      return `question ${String(questionIndex)} selected an option it was not offered`;\n    }\n    return { ...base, kind: 'multi', answer: null, selected: [...new Set(labels)] };\n  }\n\n  if (kind === 'option') {\n    const label = entry.answer;\n    const chosen = typeof label === 'string' ? question.options.find((option) => option.label === label) : undefined;\n    if (chosen === undefined) return `question ${String(questionIndex)} chose an option it was not offered`;\n    // From the option the tool declared, so a preview the reader never saw\n    // cannot be put in the model's mouth.\n    return { ...base, kind: 'option', answer: chosen.label, ...(chosen.preview ? { preview: chosen.preview } : {}) };\n  }\n\n  const typed = entry.answer;\n  if (typeof typed !== 'string') return `question ${String(questionIndex)} typed nothing readable`;\n  return { ...base, kind: 'custom', answer: typed.slice(0, MAX_ANSWER_TEXT_LENGTH) };\n}\n\nexport function readAnswerEnvelope(payload: unknown, params: QuestionParams): AnswerEnvelopeResult {\n  if (!isRecord(payload) || !Array.isArray(payload.answers)) return { ok: false, reason: 'no answers were carried' };\n  if (payload.answers.length === 0) return { ok: false, reason: 'no answers were carried' };\n  if (payload.answers.length > params.questions.length) return { ok: false, reason: 'more answers than questions' };\n\n  const seen = new Set<number>();\n  const answers: QuestionAnswer[] = [];\n  for (const entry of payload.answers) {\n    const answer = readAnswer(entry, params, seen);\n    if (typeof answer === 'string') return { ok: false, reason: answer };\n    answers.push(answer);\n  }\n  // The model reads them in the order it asked, whatever order they arrived in.\n  answers.sort((left, right) => left.questionIndex - right.questionIndex);\n  return { ok: true, answers };\n}\n"],"mappings":"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"}

package/dist/types/askUserWire.cjs

@@ -0,0 +1,2 @@
+function e(e){if(e===void 0||!e.startsWith(`doom-ask-user/v1:`))return{kind:`absent`};if(e.length>65536)return{kind:`malformed`};try{return{kind:`envelope`,payload:JSON.parse(e.slice(17))}}catch{return{kind:`malformed`}}}exports.ANSWER_ENVELOPE_PREFIX=`doom-ask-user/v1:`,exports.MAX_ENVELOPE_BYTES=65536,exports.decodeAnswerEnvelope=e;
+//# sourceMappingURL=askUserWire.cjs.map

package/dist/types/askUserWire.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUserWire.cjs","names":[],"sources":["../../src/types/askUserWire.ts"],"sourcesContent":["import type { QuestionAnswer } from './questionnaire.ts';\n\n/**\n * How a rich client answers the whole questionnaire in one reply.\n *\n * Pi's select request carries a title and a list of labels and nothing else,\n * so over RPC the questionnaire degrades into one request per question, asked\n * forwards only. A client that can already see the whole call (the cockpit\n * reads it from the tool's arguments) has no use for that: it renders every\n * question at once, lets the reader move between them, and replies once.\n *\n * The reply rides on the select response, because that is the only channel a\n * blocked extension has. An ordinary label is still an ordinary label, so a\n * client that knows nothing about this keeps the per-question flow exactly as\n * it was; only a response carrying the prefix is read as the whole set.\n *\n * It lives under src/types because that is the one server root a browser\n * bundle may read, so neither half can drift from the other.\n */\nexport const ANSWER_ENVELOPE_PREFIX = 'doom-ask-user/v1:';\n\n/** A response that claims the prefix but cannot be read is refused, never guessed at. */\nexport type AnswerEnvelopeRead =\n  | { readonly kind: 'absent' }\n  | { readonly kind: 'malformed' }\n  | { readonly kind: 'envelope'; readonly payload: unknown };\n\n/** Beyond this a response is not a questionnaire answer, whatever it claims. */\nexport const MAX_ENVELOPE_BYTES = 64 * 1024;\n\nexport function encodeAnswerEnvelope(answers: readonly QuestionAnswer[]): string {\n  return `${ANSWER_ENVELOPE_PREFIX}${JSON.stringify({ answers })}`;\n}\n\nexport function decodeAnswerEnvelope(value: string | undefined): AnswerEnvelopeRead {\n  if (value === undefined || !value.startsWith(ANSWER_ENVELOPE_PREFIX)) return { kind: 'absent' };\n  if (value.length > MAX_ENVELOPE_BYTES) return { kind: 'malformed' };\n  try {\n    return { kind: 'envelope', payload: JSON.parse(value.slice(ANSWER_ENVELOPE_PREFIX.length)) };\n  } catch {\n    // Unreadable JSON behind the prefix: the sender meant an envelope and got\n    // it wrong, which is a refusal rather than a label the model should see.\n    return { kind: 'malformed' };\n  }\n}\n"],"mappings":"AAkCA,SAAgB,EAAqB,EAA+C,CAClF,GAAI,IAAU,IAAA,IAAa,CAAC,EAAM,WAAA,mBAAiC,EAAG,MAAO,CAAE,KAAM,QAAS,EAC9F,GAAI,EAAM,OAAA,MAA6B,MAAO,CAAE,KAAM,WAAY,EAClE,GAAI,CACF,MAAO,CAAE,KAAM,WAAY,QAAS,KAAK,MAAM,EAAM,MAAM,EAA6B,CAAC,CAAE,CAC7F,MAAQ,CAGN,MAAO,CAAE,KAAM,WAAY,CAC7B,CACF"}

package/dist/types/askUserWire.mjs

@@ -0,0 +1,2 @@
+const e=`doom-ask-user/v1:`,t=65536;function n(e){if(e===void 0||!e.startsWith(`doom-ask-user/v1:`))return{kind:`absent`};if(e.length>65536)return{kind:`malformed`};try{return{kind:`envelope`,payload:JSON.parse(e.slice(17))}}catch{return{kind:`malformed`}}}export{e as ANSWER_ENVELOPE_PREFIX,t as MAX_ENVELOPE_BYTES,n as decodeAnswerEnvelope};
+//# sourceMappingURL=askUserWire.mjs.map

package/dist/types/askUserWire.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUserWire.mjs","names":[],"sources":["../../src/types/askUserWire.ts"],"sourcesContent":["import type { QuestionAnswer } from './questionnaire.ts';\n\n/**\n * How a rich client answers the whole questionnaire in one reply.\n *\n * Pi's select request carries a title and a list of labels and nothing else,\n * so over RPC the questionnaire degrades into one request per question, asked\n * forwards only. A client that can already see the whole call (the cockpit\n * reads it from the tool's arguments) has no use for that: it renders every\n * question at once, lets the reader move between them, and replies once.\n *\n * The reply rides on the select response, because that is the only channel a\n * blocked extension has. An ordinary label is still an ordinary label, so a\n * client that knows nothing about this keeps the per-question flow exactly as\n * it was; only a response carrying the prefix is read as the whole set.\n *\n * It lives under src/types because that is the one server root a browser\n * bundle may read, so neither half can drift from the other.\n */\nexport const ANSWER_ENVELOPE_PREFIX = 'doom-ask-user/v1:';\n\n/** A response that claims the prefix but cannot be read is refused, never guessed at. */\nexport type AnswerEnvelopeRead =\n  | { readonly kind: 'absent' }\n  | { readonly kind: 'malformed' }\n  | { readonly kind: 'envelope'; readonly payload: unknown };\n\n/** Beyond this a response is not a questionnaire answer, whatever it claims. */\nexport const MAX_ENVELOPE_BYTES = 64 * 1024;\n\nexport function encodeAnswerEnvelope(answers: readonly QuestionAnswer[]): string {\n  return `${ANSWER_ENVELOPE_PREFIX}${JSON.stringify({ answers })}`;\n}\n\nexport function decodeAnswerEnvelope(value: string | undefined): AnswerEnvelopeRead {\n  if (value === undefined || !value.startsWith(ANSWER_ENVELOPE_PREFIX)) return { kind: 'absent' };\n  if (value.length > MAX_ENVELOPE_BYTES) return { kind: 'malformed' };\n  try {\n    return { kind: 'envelope', payload: JSON.parse(value.slice(ANSWER_ENVELOPE_PREFIX.length)) };\n  } catch {\n    // Unreadable JSON behind the prefix: the sender meant an envelope and got\n    // it wrong, which is a refusal rather than a label the model should see.\n    return { kind: 'malformed' };\n  }\n}\n"],"mappings":"AAmBA,MAAa,EAAyB,oBASzB,EAAqB,MAMlC,SAAgB,EAAqB,EAA+C,CAClF,GAAI,IAAU,IAAA,IAAa,CAAC,EAAM,WAAA,mBAAiC,EAAG,MAAO,CAAE,KAAM,QAAS,EAC9F,GAAI,EAAM,OAAA,MAA6B,MAAO,CAAE,KAAM,WAAY,EAClE,GAAI,CACF,MAAO,CAAE,KAAM,WAAY,QAAS,KAAK,MAAM,EAAM,MAAM,EAA6B,CAAC,CAAE,CAC7F,MAAQ,CAGN,MAAO,CAAE,KAAM,WAAY,CAC7B,CACF"}

package/dist/types/questionnaire.d.cts

@@ -9,7 +9,9 @@ interface QuestionAnswer {
   notes?: string;
   preview?: string;
 }
-type QuestionnaireError = 'no_ui' | 'no_custom_ui' | 'no_questions' | 'empty_options' | 'too_many_questions' | 'duplicate_question' | 'duplicate_option_label' | 'reserved_label' | 'session_load_failed' | 'stale_module_cache';
+type QuestionnaireError = 'no_ui' | 'no_custom_ui' | 'no_questions' | 'empty_options' | 'too_many_questions' | 'duplicate_question' | 'duplicate_option_label' | 'reserved_label' | 'session_load_failed' | 'stale_module_cache' |
+/** A client replied with an answer envelope that did not match the questions asked. */
+'malformed_answers';
 interface QuestionnaireResult {
   answers: QuestionAnswer[];
   cancelled: boolean;

package/dist/types/questionnaire.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"questionnaire.d.cts","names":[],"sources":["../../src/types/questionnaire.ts"],"mappings":";KAAY;UAEK;EACf;EACA;EACA,MAAM;EACN;EACA;EACA;EACA;;KAGU;UAgBK;EACf,SAAS;EACT;EACA,QAAQ;EACR;EACA;EACA;;UAGe;EACf,SAAS;IAAQ;IAAc;;EAC/B,SAAS;EACT"}
+{"version":3,"file":"questionnaire.d.cts","names":[],"sources":["../../src/types/questionnaire.ts"],"mappings":";KAAY;UAEK;EACf;EACA;EACA,MAAM;EACN;EACA;EACA;EACA;;KAGU;;;UAkBK;EACf,SAAS;EACT;EACA,QAAQ;EACR;EACA;EACA;;UAGe;EACf,SAAS;IAAQ;IAAc;;EAC/B,SAAS;EACT"}

package/dist/types/questionnaire.d.mts

@@ -9,7 +9,9 @@ interface QuestionAnswer {
   notes?: string;
   preview?: string;
 }
-type QuestionnaireError = 'no_ui' | 'no_custom_ui' | 'no_questions' | 'empty_options' | 'too_many_questions' | 'duplicate_question' | 'duplicate_option_label' | 'reserved_label' | 'session_load_failed' | 'stale_module_cache';
+type QuestionnaireError = 'no_ui' | 'no_custom_ui' | 'no_questions' | 'empty_options' | 'too_many_questions' | 'duplicate_question' | 'duplicate_option_label' | 'reserved_label' | 'session_load_failed' | 'stale_module_cache' |
+/** A client replied with an answer envelope that did not match the questions asked. */
+'malformed_answers';
 interface QuestionnaireResult {
   answers: QuestionAnswer[];
   cancelled: boolean;

package/dist/types/questionnaire.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"questionnaire.d.mts","names":[],"sources":["../../src/types/questionnaire.ts"],"mappings":";KAAY;UAEK;EACf;EACA;EACA,MAAM;EACN;EACA;EACA;EACA;;KAGU;UAgBK;EACf,SAAS;EACT;EACA,QAAQ;EACR;EACA;EACA;;UAGe;EACf,SAAS;IAAQ;IAAc;;EAC/B,SAAS;EACT"}
+{"version":3,"file":"questionnaire.d.mts","names":[],"sources":["../../src/types/questionnaire.ts"],"mappings":";KAAY;UAEK;EACf;EACA;EACA,MAAM;EACN;EACA;EACA;EACA;;KAGU;;;UAkBK;EACf,SAAS;EACT;EACA,QAAQ;EACR;EACA;EACA;;UAGe;EACf,SAAS;IAAQ;IAAc;;EAC/B,SAAS;EACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/doompi-user-feedback",
-  "version": "0.0.1-alpha.27",
+  "version": "0.0.1-alpha.29",
   "description": "Structured user questions with interactive and autonomous Voice handoff for Pi agents.",
   "keywords": [
     "ai",
@@ -28,6 +28,8 @@
   "files": [
     "dist",
     "web",
+    "src/types/askUserWire.ts",
+    "src/types/questionnaire.ts",
     "README.md",
     "LICENSE",
     "package.json"
@@ -55,10 +57,10 @@
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "typebox": "1.3.16",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.38",
-    "@agimon-ai/doompi-ui": "0.0.1-alpha.38",
-    "@agimon-ai/doompi-web-components": "0.0.0",
-    "@agimon-ai/doompi-web-contracts": "0.0.1-alpha.1"
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.40",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.40",
+    "@agimon-ai/doompi-web-components": "0.0.1-alpha.1",
+    "@agimon-ai/doompi-web-contracts": "0.0.1-alpha.3"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.3",

package/src/types/askUserWire.ts

@@ -0,0 +1,45 @@
+import type { QuestionAnswer } from './questionnaire.ts';
+
+/**
+ * How a rich client answers the whole questionnaire in one reply.
+ *
+ * Pi's select request carries a title and a list of labels and nothing else,
+ * so over RPC the questionnaire degrades into one request per question, asked
+ * forwards only. A client that can already see the whole call (the cockpit
+ * reads it from the tool's arguments) has no use for that: it renders every
+ * question at once, lets the reader move between them, and replies once.
+ *
+ * The reply rides on the select response, because that is the only channel a
+ * blocked extension has. An ordinary label is still an ordinary label, so a
+ * client that knows nothing about this keeps the per-question flow exactly as
+ * it was; only a response carrying the prefix is read as the whole set.
+ *
+ * It lives under src/types because that is the one server root a browser
+ * bundle may read, so neither half can drift from the other.
+ */
+export const ANSWER_ENVELOPE_PREFIX = 'doom-ask-user/v1:';
+
+/** A response that claims the prefix but cannot be read is refused, never guessed at. */
+export type AnswerEnvelopeRead =
+  | { readonly kind: 'absent' }
+  | { readonly kind: 'malformed' }
+  | { readonly kind: 'envelope'; readonly payload: unknown };
+
+/** Beyond this a response is not a questionnaire answer, whatever it claims. */
+export const MAX_ENVELOPE_BYTES = 64 * 1024;
+
+export function encodeAnswerEnvelope(answers: readonly QuestionAnswer[]): string {
+  return `${ANSWER_ENVELOPE_PREFIX}${JSON.stringify({ answers })}`;
+}
+
+export function decodeAnswerEnvelope(value: string | undefined): AnswerEnvelopeRead {
+  if (value === undefined || !value.startsWith(ANSWER_ENVELOPE_PREFIX)) return { kind: 'absent' };
+  if (value.length > MAX_ENVELOPE_BYTES) return { kind: 'malformed' };
+  try {
+    return { kind: 'envelope', payload: JSON.parse(value.slice(ANSWER_ENVELOPE_PREFIX.length)) };
+  } catch {
+    // Unreadable JSON behind the prefix: the sender meant an envelope and got
+    // it wrong, which is a refusal rather than a label the model should see.
+    return { kind: 'malformed' };
+  }
+}

package/src/types/questionnaire.ts

@@ -0,0 +1,44 @@
+export type AnswerKind = 'option' | 'custom' | 'multi';
+
+export interface QuestionAnswer {
+  questionIndex: number;
+  question: string;
+  kind: AnswerKind;
+  answer: string | null;
+  selected?: string[];
+  notes?: string;
+  preview?: string;
+}
+
+export type QuestionnaireError =
+  | 'no_ui'
+  | 'no_custom_ui'
+  | 'no_questions'
+  | 'empty_options'
+  | 'too_many_questions'
+  | 'duplicate_question'
+  | 'duplicate_option_label'
+  | 'reserved_label'
+  | 'session_load_failed'
+  | 'stale_module_cache'
+  /** A client replied with an answer envelope that did not match the questions asked. */
+  | 'malformed_answers';
+
+export type ExternalEditResult =
+  | { readonly status: 'complete'; readonly content: string }
+  | { readonly status: 'failed'; readonly message: string };
+
+export interface QuestionnaireResult {
+  answers: QuestionAnswer[];
+  cancelled: boolean;
+  error?: QuestionnaireError;
+  delivery?: 'voice';
+  awaitingResponse?: boolean;
+  voicePrompt?: string;
+}
+
+export interface ToolTextResult {
+  content: Array<{ type: 'text'; text: string }>;
+  details: QuestionnaireResult;
+  terminate?: boolean;
+}

package/web/AskUserQuestionToolMessage.tsx

@@ -13,7 +13,9 @@ function AskUserQuestionBody({ result, output, running, isError }: ToolMessageRe
   if (running) {
     return (
       <MessageItemBody data-testid="tool-result-ask_user_question">
-        <MessageItemStatus tone="running">waiting for the user</MessageItemStatus>
+        {/* The questionnaire is below, where the input usually is; saying only
+            "waiting" would leave the reader looking for it. */}
+        <MessageItemStatus tone="running">answer below to continue</MessageItemStatus>
       </MessageItemBody>
     );
   }

package/web/QuestionnairePrompt.tsx

@@ -0,0 +1,336 @@
+import {
+  Badge,
+  Button,
+  Kbd,
+  Markdown,
+  OptionLabel,
+  OptionRow,
+  SectionLabel,
+  Separator,
+  Textarea,
+} from '@agimon-ai/doompi-web-components';
+import type { ToolPromptRenderProps } from '@agimon-ai/doompi-web-contracts';
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { encodeAnswerEnvelope } from '../src/types/askUserWire.ts';
+import {
+  chooseOption,
+  CUSTOM_LABEL,
+  draftAnswers,
+  draftEntry,
+  emptyDraft,
+  isAnswered,
+  isComplete,
+  nextUnanswered,
+  type PromptQuestion,
+  type QuestionnaireDraft,
+  readPromptQuestions,
+  setCustom,
+  setNotes,
+} from './questionnaireDraft.ts';
+
+/** The step bar: which questions are answered, which one is open, and a click back to any of them. */
+function StepBar({
+  questions,
+  draft,
+  current,
+  onPick,
+}: {
+  questions: readonly PromptQuestion[];
+  draft: QuestionnaireDraft;
+  current: number;
+  onPick: (index: number) => void;
+}) {
+  return (
+    <div data-testid="questionnaire-steps" className="flex min-w-0 flex-wrap items-center gap-1.5">
+      {questions.map((question, index) => {
+        const answered = isAnswered(draftEntry(draft, index));
+        const active = index === current;
+        return (
+          <Button
+            key={question.question}
+            variant="ghost"
+            size="xs"
+            data-testid={`questionnaire-step-${String(index)}`}
+            data-step-state={active ? 'current' : answered ? 'answered' : 'pending'}
+            onClick={() => onPick(index)}
+            className={`gap-1.5 rounded-full px-2.5 py-0.5 text-[10px] ${
+              active
+                ? 'bg-doom-selected text-doom-on-selected'
+                : answered
+                  ? 'text-doom-green hover:bg-doom-panel'
+                  : 'text-doom-faint hover:bg-doom-panel'
+            }`}
+          >
+            <span aria-hidden>{answered ? '✓' : '○'}</span>
+            {question.header || `question ${String(index + 1)}`}
+          </Button>
+        );
+      })}
+    </div>
+  );
+}
+
+/** One question's options, its typed-answer row, and the preview of whatever is focused. */
+function QuestionBody({
+  question,
+  index,
+  draft,
+  cursor,
+  onCursor,
+  onDraft,
+}: {
+  question: PromptQuestion;
+  index: number;
+  draft: QuestionnaireDraft;
+  cursor: number;
+  onCursor: (cursor: number) => void;
+  /** `settles` is true only for an edit that finishes the question, which is what may move on. */
+  onDraft: (draft: QuestionnaireDraft, settles: boolean) => void;
+}) {
+  const entry = draftEntry(draft, index);
+  const typing = entry.custom !== null;
+  const preview = question.options[cursor]?.preview;
+  return (
+    <div className="flex min-w-0 flex-col gap-2">
+      <p data-testid="questionnaire-question" className="break-words text-[13px] leading-relaxed text-doom-hi">
+        {question.question}
+      </p>
+
+      <div role="listbox" aria-label="options" className="flex min-w-0 flex-col">
+        {question.options.map((option, optionIndex) => {
+          const chosen = entry.selected.includes(option.label);
+          return (
+            <OptionRow
+              key={option.label}
+              active={optionIndex === cursor && !typing}
+              data-testid={`questionnaire-option-${String(optionIndex)}`}
+              data-chosen={chosen}
+              onMouseEnter={() => onCursor(optionIndex)}
+              // A multiSelect question is not finished by one click: moving on
+              // there would take the list away before a second option could be
+              // picked, which is the whole point of the question.
+              onClick={() =>
+                onDraft(chooseOption(draft, index, option.label, question.multiSelect), !question.multiSelect)
+              }
+              className="min-w-0 items-start gap-2.5 rounded-md px-2.5 py-1.5 whitespace-normal"
+            >
+              <span className={`mt-[2px] shrink-0 text-[11px] ${chosen ? 'text-doom-green' : 'text-doom-faint'}`}>
+                {question.multiSelect ? (chosen ? '[x]' : '[ ]') : chosen ? '●' : '○'}
+              </span>
+              <OptionLabel className="min-w-0 flex flex-col gap-0.5 text-left">
+                <span className={`break-words text-[12px] ${chosen ? 'text-doom-hi' : 'text-doom-text'}`}>
+                  {option.label}
+                </span>
+                {option.description ? (
+                  <span className="break-words text-[11px] leading-relaxed whitespace-normal text-doom-dim">
+                    {option.description}
+                  </span>
+                ) : null}
+              </OptionLabel>
+            </OptionRow>
+          );
+        })}
+
+        <OptionRow
+          active={typing}
+          data-testid="questionnaire-option-custom"
+          onClick={() => onDraft(setCustom(draft, index, entry.custom ?? ''), false)}
+          className="min-w-0 items-center gap-2.5 rounded-md px-2.5 py-1.5 whitespace-normal"
+        >
+          <span className="shrink-0 text-[11px] text-doom-faint">✎</span>
+          <OptionLabel className="min-w-0 text-[12px] whitespace-normal text-doom-text">{CUSTOM_LABEL}</OptionLabel>
+        </OptionRow>
+      </div>
+
+      {typing ? (
+        <div className="flex flex-col gap-1">
+          <SectionLabel>your answer</SectionLabel>
+          <Textarea
+            data-testid="questionnaire-custom"
+            autoFocus
+            rows={2}
+            value={entry.custom ?? ''}
+            placeholder="type your answer…"
+            onChange={(event) => onDraft(setCustom(draft, index, event.target.value), false)}
+            className="text-[12px]"
+          />
+        </div>
+      ) : null}
+
+      {preview ? (
+        <div data-testid="questionnaire-preview" className="flex flex-col gap-1">
+          <SectionLabel>preview</SectionLabel>
+          <div className="max-h-40 overflow-y-auto border-l-2 border-doom-edge-magenta pl-3 text-[11px] text-doom-dim">
+            <Markdown text={preview} />
+          </div>
+        </div>
+      ) : null}
+
+      <div className="flex flex-col gap-1">
+        <SectionLabel>note (optional)</SectionLabel>
+        <Textarea
+          data-testid="questionnaire-notes"
+          rows={1}
+          value={entry.notes}
+          placeholder="anything the options do not cover"
+          onChange={(event) => onDraft(setNotes(draft, index, event.target.value), false)}
+          className="text-[11px]"
+        />
+      </div>
+    </div>
+  );
+}
+
+/**
+ * The questionnaire, standing in for the composer input while the agent waits.
+ *
+ * Every question is here at once, because the cockpit can see the whole call
+ * even though the request it answers can only carry one question's labels.
+ * That is what makes the step bar honest: nothing is sent until the reader
+ * submits, so going back to a step is just moving a cursor, and the agent is
+ * asked exactly once.
+ */
+export function QuestionnairePrompt({ args, dialog, answer, cancel }: ToolPromptRenderProps) {
+  const questions = useMemo(() => readPromptQuestions(args), [args]);
+  const [draft, setDraft] = useState<QuestionnaireDraft>(() => emptyDraft(questions.length));
+  const [current, setCurrent] = useState(0);
+  const [cursor, setCursor] = useState(0);
+  const frame = useRef<HTMLDivElement>(null);
+
+  // A new request is a new questionnaire; nothing from the last one carries over.
+  useEffect(() => {
+    setDraft(emptyDraft(questions.length));
+    setCurrent(0);
+    setCursor(0);
+  }, [dialog.id, questions.length]);
+
+  // The agent is blocked on this, so it takes the keyboard the input had.
+  useEffect(() => frame.current?.focus(), [dialog.id]);
+
+  const question = questions[current];
+  const complete = isComplete(draft);
+
+  const move = (next: QuestionnaireDraft, answeredIndex: number, settles: boolean): void => {
+    setDraft(next);
+    // Follow the reader forwards the way the terminal does, but only on an
+    // edit that finished the question, and only while something is still
+    // unanswered: jumping after the last answer would take the step they just
+    // finished off the screen before they could look at it.
+    if (!settles) return;
+    const pending = nextUnanswered(next, answeredIndex);
+    if (pending >= 0 && pending !== answeredIndex) {
+      setCurrent(pending);
+      setCursor(0);
+    }
+  };
+
+  const show = (index: number): void => {
+    setCurrent(index);
+    setCursor(0);
+  };
+
+  const submit = (): void => {
+    if (!complete) return;
+    answer(encodeAnswerEnvelope(draftAnswers(questions, draft)));
+  };
+
+  if (question === undefined) {
+    return (
+      <div className="flex items-center justify-between gap-3 px-3.5 py-3">
+        <span data-testid="questionnaire-empty" className="text-[12px] text-doom-dim">
+          the agent asked something this cockpit could not read
+        </span>
+        <Button variant="outline" size="sm" data-testid="questionnaire-cancel" onClick={cancel}>
+          cancel
+        </Button>
+      </div>
+    );
+  }
+
+  const typing = draftEntry(draft, current).custom !== null;
+  return (
+    // The keys belong to the frame rather than to any row, so the reader can
+    // move between questions and options without tabbing through both.
+    <div
+      ref={frame}
+      tabIndex={-1}
+      data-testid="questionnaire"
+      className="flex min-w-0 flex-col overflow-hidden outline-none"
+      onKeyDown={(event) => {
+        if (event.key === 'Escape') {
+          event.preventDefault();
+          cancel();
+          return;
+        }
+        // While typing an answer the arrows belong to the textarea.
+        if (typing) return;
+        if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+          event.preventDefault();
+          const count = question.options.length;
+          setCursor((event.key === 'ArrowDown' ? cursor + 1 : cursor - 1 + count) % count);
+          return;
+        }
+        if (event.key === 'ArrowRight' || event.key === 'ArrowLeft') {
+          event.preventDefault();
+          const count = questions.length;
+          show((event.key === 'ArrowRight' ? current + 1 : current - 1 + count) % count);
+          return;
+        }
+        if (event.key === 'Enter') {
+          event.preventDefault();
+          const option = question.options[cursor];
+          if (event.metaKey || event.ctrlKey || option === undefined) {
+            submit();
+            return;
+          }
+          move(chooseOption(draft, current, option.label, question.multiSelect), current, !question.multiSelect);
+        }
+      }}
+    >
+      <div className="flex min-w-0 flex-wrap items-center gap-2 px-3 pt-2.5 pb-2 sm:gap-3 sm:px-3.5">
+        <StepBar questions={questions} draft={draft} current={current} onPick={show} />
+        <span className="min-w-0 flex-1" />
+        <Badge size="xs" className="shrink-0 border-transparent bg-doom-panel py-0.5 text-[9px] text-doom-dim">
+          question {current + 1} / {questions.length}
+        </Badge>
+      </div>
+
+      <Separator />
+
+      <div className="max-h-[46vh] min-w-0 overflow-x-hidden overflow-y-auto px-3 py-3 sm:px-3.5">
+        <QuestionBody
+          question={question}
+          index={current}
+          draft={draft}
+          cursor={cursor}
+          onCursor={setCursor}
+          onDraft={(next, settles) => move(next, current, settles)}
+        />
+      </div>
+
+      <Separator />
+
+      <div className="flex min-w-0 items-center gap-2 px-3 py-2 sm:px-3.5">
+        <span data-testid="questionnaire-hint" className="min-w-0 truncate text-[10px] text-doom-faint max-sm:hidden">
+          <Kbd>←→</Kbd> questions · <Kbd>↑↓</Kbd> options · <Kbd>enter</Kbd>{' '}
+          {question.multiSelect ? 'toggles' : 'selects'} · <Kbd>esc</Kbd> cancels
+        </span>
+        <span className="flex-1" />
+        <Button variant="outline" size="md" data-testid="questionnaire-cancel" onClick={cancel}>
+          cancel
+        </Button>
+        <Button
+          variant="primary"
+          size="md"
+          data-testid="questionnaire-submit"
+          onClick={submit}
+          disabled={!complete}
+          title={complete ? 'send every answer to the agent' : 'answer every question first'}
+          className="shrink-0 px-3 max-sm:max-w-32 max-sm:truncate sm:px-3.5"
+        >
+          submit answers
+        </Button>
+      </div>
+    </div>
+  );
+}

package/web/index.ts

@@ -1,13 +1,30 @@
 import { defineWebPlugin } from '@agimon-ai/doompi-web-contracts';
 import { AskUserQuestionToolMessage } from './AskUserQuestionToolMessage.tsx';
+import { QuestionnairePrompt } from './QuestionnairePrompt.tsx';
+import { readPromptQuestions } from './questionnaireDraft.ts';
 
 /**
  * This package's cockpit presence: the timeline card for ask_user_question,
- * the web half of the TUI's renderCall and renderResult. The questionnaire
- * itself reaches the cockpit as an extension UI dialog; this card is its
- * record in the transcript.
+ * the web half of the TUI's renderCall and renderResult, and the questionnaire
+ * itself, which stands in for the composer input while the agent waits.
+ *
+ * The request carries only the first question's labels, so the prompt claims
+ * it by matching the title against the questions the tool was actually called
+ * with. Anything else open at the same time belongs to somebody else and keeps
+ * the host's dialog.
  */
 export const webPlugin = defineWebPlugin({
   id: 'ask-user',
-  toolRenderers: [{ tools: ['ask_user_question'], message: AskUserQuestionToolMessage }],
+  toolRenderers: [
+    {
+      tools: ['ask_user_question'],
+      message: AskUserQuestionToolMessage,
+      prompt: {
+        claims: (dialog, args) =>
+          dialog.method === 'select' &&
+          readPromptQuestions(args).some((question) => dialog.title.startsWith(question.question)),
+        component: QuestionnairePrompt,
+      },
+    },
+  ],
 });

package/web/questionnaireDraft.ts

@@ -0,0 +1,149 @@
+/**
+ * The questionnaire the cockpit is filling in, as a value.
+ *
+ * Apart from React so the unit suite covers it without a DOM, the same way
+ * askUserText.ts is. The questions come from the running tool call's
+ * arguments, which are wire JSON: the shapes narrowed here mirror
+ * src/schemas/questionnaire.ts, which a browser module may not import.
+ *
+ * Everything is held here until the reader submits, which is the whole point.
+ * A step the reader goes back to still has what they chose, and the agent is
+ * asked once rather than once per question.
+ */
+import type { QuestionAnswer } from '../src/types/questionnaire.ts';
+
+/** The row every question gets, so a reader always has a way past a bad set of options. */
+export const CUSTOM_LABEL = 'Type something.';
+
+export interface PromptOption {
+  label: string;
+  description: string;
+  preview?: string;
+}
+
+export interface PromptQuestion {
+  question: string;
+  header: string;
+  multiSelect: boolean;
+  options: PromptOption[];
+}
+
+export interface QuestionDraft {
+  /** Chosen option labels: at most one unless the question is multiSelect. */
+  selected: string[];
+  /** Text typed in place of an option; null while the reader has not typed any. */
+  custom: string | null;
+  notes: string;
+}
+
+export type QuestionnaireDraft = readonly QuestionDraft[];
+
+const EMPTY_ENTRY: QuestionDraft = { selected: [], custom: null, notes: '' };
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function asString(value: unknown): string {
+  return typeof value === 'string' ? value : '';
+}
+
+function readOption(value: unknown): PromptOption | null {
+  if (!isRecord(value)) return null;
+  const label = asString(value.label);
+  if (label === '') return null;
+  const preview = asString(value.preview);
+  return { label, description: asString(value.description), ...(preview === '' ? {} : { preview }) };
+}
+
+/** The questions as the tool was called with them; an unreadable call yields none. */
+export function readPromptQuestions(args: Readonly<Record<string, unknown>>): PromptQuestion[] {
+  if (!Array.isArray(args.questions)) return [];
+  return args.questions.flatMap((entry) => {
+    if (!isRecord(entry)) return [];
+    const question = asString(entry.question);
+    if (question === '') return [];
+    const options = (Array.isArray(entry.options) ? entry.options : []).flatMap((option) => {
+      const read = readOption(option);
+      return read === null ? [] : [read];
+    });
+    return [{ question, header: asString(entry.header), multiSelect: entry.multiSelect === true, options }];
+  });
+}
+
+export function emptyDraft(count: number): QuestionnaireDraft {
+  return Array.from({ length: count }, () => EMPTY_ENTRY);
+}
+
+export function draftEntry(draft: QuestionnaireDraft, index: number): QuestionDraft {
+  return draft[index] ?? EMPTY_ENTRY;
+}
+
+function withEntry(draft: QuestionnaireDraft, index: number, patch: Partial<QuestionDraft>): QuestionnaireDraft {
+  if (index < 0 || index >= draft.length) return draft;
+  return draft.map((entry, position) => (position === index ? { ...entry, ...patch } : entry));
+}
+
+/**
+ * Picks an option. A single-select question replaces its choice; a multiSelect
+ * one toggles. Either way the typed answer is dropped, because an option and
+ * free text are two answers to the same question and only one can be sent.
+ */
+export function chooseOption(
+  draft: QuestionnaireDraft,
+  index: number,
+  label: string,
+  multiSelect: boolean,
+): QuestionnaireDraft {
+  const current = draftEntry(draft, index).selected;
+  const selected = multiSelect
+    ? current.includes(label)
+      ? current.filter((entry) => entry !== label)
+      : [...current, label]
+    : [label];
+  return withEntry(draft, index, { selected, custom: null });
+}
+
+/** Types an answer instead of choosing one; null returns to the options. */
+export function setCustom(draft: QuestionnaireDraft, index: number, custom: string | null): QuestionnaireDraft {
+  return withEntry(draft, index, { custom, selected: [] });
+}
+
+export function setNotes(draft: QuestionnaireDraft, index: number, notes: string): QuestionnaireDraft {
+  return withEntry(draft, index, { notes });
+}
+
+export function isAnswered(entry: QuestionDraft): boolean {
+  return entry.selected.length > 0 || (entry.custom !== null && entry.custom.trim() !== '');
+}
+
+/** The next question still needing an answer, searching after `from` first; -1 when none is left. */
+export function nextUnanswered(draft: QuestionnaireDraft, from: number): number {
+  const after = draft.findIndex((entry, index) => index > from && !isAnswered(entry));
+  return after >= 0 ? after : draft.findIndex((entry) => !isAnswered(entry));
+}
+
+export function isComplete(draft: QuestionnaireDraft): boolean {
+  return draft.length > 0 && draft.every(isAnswered);
+}
+
+/**
+ * The answers as the tool reads them back. `preview` is left off: the session
+ * half looks it up from the option it declared, so sending one here would only
+ * be a claim it has to ignore.
+ */
+export function draftAnswers(questions: readonly PromptQuestion[], draft: QuestionnaireDraft): QuestionAnswer[] {
+  return questions.flatMap((question, index): QuestionAnswer[] => {
+    const entry = draftEntry(draft, index);
+    if (!isAnswered(entry)) return [];
+    const notes = entry.notes.trim();
+    const base = { questionIndex: index, question: question.question, ...(notes === '' ? {} : { notes }) };
+    if (entry.custom !== null && entry.custom.trim() !== '') {
+      return [{ ...base, kind: 'custom' as const, answer: entry.custom }];
+    }
+    if (question.multiSelect) {
+      return [{ ...base, kind: 'multi' as const, answer: null, selected: [...entry.selected] }];
+    }
+    return [{ ...base, kind: 'option' as const, answer: entry.selected[0] ?? null }];
+  });
+}