@astralyn/pi 0.87.6 → 1.0.0

package/dist/extensions/question/results.js.map

@@ -1 +1 @@
-{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/extensions/question/results.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentToolResult } from \"../../core/extensions/types.ts\";\nimport { QUESTION_LIMITS, TRUNCATION_FOLLOW_UP } from \"./limits.ts\";\nimport type { QuestionAnswer, QuestionToolDetails, QuestionToolError } from \"./types.ts\";\n\nconst DECLINE_MESSAGE = \"User declined to answer the questions.\";\nconst CLARIFICATION_MESSAGE = \"The user wants to discuss these questions before choosing an answer.\";\nconst ENVELOPE_PREFIX = \"User decisions:\";\nconst ENVELOPE_SUFFIX = \"Continue with these decisions in mind.\";\n\nfunction buildToolResult(text: string, details: QuestionToolDetails): AgentToolResult<QuestionToolDetails> {\n\treturn {\n\t\tcontent: [{ type: \"text\", text }],\n\t\tdetails,\n\t};\n}\n\nfunction boundedText(text: string): string {\n\tif (text.length <= QUESTION_LIMITS.modelResultChars) return text;\n\tconst suffix = `\\n\\n[Question result truncated. ${TRUNCATION_FOLLOW_UP}]`;\n\treturn `${text.slice(0, Math.max(0, QUESTION_LIMITS.modelResultChars - suffix.length))}${suffix}`;\n}\n\nexport function errorResult(error: QuestionToolError, message: string): AgentToolResult<QuestionToolDetails> {\n\treturn buildToolResult(`Question tool error (${error}): ${message}`, {\n\t\tanswers: [],\n\t\toutcome: \"error\",\n\t\tcancelled: false,\n\t\terror,\n\t\tmessage,\n\t});\n}\n\nexport function answerScalar(answer: QuestionAnswer): string {\n\tif (answer.kind === \"multi\") return answer.selected?.length ? answer.selected.join(\", \") : \"(no input)\";\n\treturn answer.answer && answer.answer.length > 0 ? answer.answer : \"(no input)\";\n}\n\nfunction answerKindLabel(answer: QuestionAnswer): string {\n\tif (answer.kind === \"multi\") return \"Selections\";\n\treturn answer.kind === \"custom\" ? \"Custom answer\" : \"Selected option\";\n}\n\nfunction answerSegment(answer: QuestionAnswer): string {\n\tconst lines = [\n\t\t`${answer.questionIndex + 1}. [${answer.header}] ${answer.question}`,\n\t\t`   ${answerKindLabel(answer)}: ${answerScalar(answer)}`,\n\t];\n\tif (answer.preview) lines.push(\"   Preview: selected (kept in tool details)\");\n\tfor (const note of answer.notes ?? []) lines.push(`   Note for ${note.option}: ${note.text}`);\n\treturn lines.join(\"\\n\");\n}\n\nexport function successResult(answers: QuestionAnswer[]): AgentToolResult<QuestionToolDetails> {\n\tconst text = answers.length\n\t\t? boundedText(`${ENVELOPE_PREFIX}\\n${answers.map(answerSegment).join(\"\\n\\n\")}\\n\\n${ENVELOPE_SUFFIX}`)\n\t\t: DECLINE_MESSAGE;\n\treturn buildToolResult(text, {\n\t\tanswers,\n\t\toutcome: answers.length ? \"answered\" : \"cancelled\",\n\t\tcancelled: answers.length === 0,\n\t});\n}\n\nexport function cancelResult(answers: QuestionAnswer[] = []): AgentToolResult<QuestionToolDetails> {\n\tconst answered = answers.length ? `\\n\\nPartial answers so far:\\n${answers.map(answerSegment).join(\"\\n\\n\")}` : \"\";\n\treturn buildToolResult(boundedText(`${DECLINE_MESSAGE}${answered}`), {\n\t\tanswers,\n\t\toutcome: \"cancelled\",\n\t\tcancelled: true,\n\t});\n}\n\nexport function clarificationResult(answers: QuestionAnswer[] = []): AgentToolResult<QuestionToolDetails> {\n\tconst answered = answers.length ? ` Partial answers so far:\\n${answers.map(answerSegment).join(\"\\n\\n\")}` : \"\";\n\treturn buildToolResult(\n\t\tboundedText(\n\t\t\t`${CLARIFICATION_MESSAGE}${answered}\\n\\nExplain the trade-offs or ask what the user would like clarified.`,\n\t\t),\n\t\t{\n\t\t\tanswers,\n\t\t\toutcome: \"needs_clarification\",\n\t\t\tcancelled: false,\n\t\t},\n\t);\n}\n"]}
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/extensions/question/results.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentToolResult } from \"../../core/extensions/types.ts\";\nimport { truncateMiddle } from \"../../core/tools/truncate.ts\";\nimport { QUESTION_LIMITS, TRUNCATION_FOLLOW_UP } from \"./limits.ts\";\nimport type { QuestionAnswer, QuestionToolDetails, QuestionToolError } from \"./types.ts\";\n\nconst DECLINE_MESSAGE = \"User declined to answer the questions.\";\nconst CLARIFICATION_MESSAGE = \"The user wants to discuss these questions before choosing an answer.\";\nconst ENVELOPE_PREFIX = \"User decisions:\";\nconst ENVELOPE_SUFFIX = \"Continue with these decisions in mind.\";\nconst CLARIFICATION_FOLLOW_UP = \"Explain the trade-offs or ask what the user would like clarified.\";\nconst SHORTENED_NOTICE = `\\n\\n[Long answers or notes were shortened where marked \"chars truncated\". ${TRUNCATION_FOLLOW_UP}]`;\n\nfunction buildToolResult(text: string, details: QuestionToolDetails): AgentToolResult<QuestionToolDetails> {\n\treturn {\n\t\tcontent: [{ type: \"text\", text }],\n\t\tdetails,\n\t};\n}\n\n/** Largest per-text length that fits `budget`: short texts stay whole, long ones share what remains equally. */\nfunction fairShare(lengths: number[], budget: number): number {\n\tconst sorted = [...lengths].sort((a, b) => a - b);\n\tlet remaining = budget;\n\tfor (let index = 0; index < sorted.length; index++) {\n\t\tconst share = Math.floor(remaining / (sorted.length - index));\n\t\tif (sorted[index] > share) return Math.max(0, share);\n\t\tremaining -= sorted[index];\n\t}\n\treturn Number.POSITIVE_INFINITY;\n}\n\n/** Keep the start and end of `text` within `cap` characters. */\nfunction shorten(text: string, cap: number): string {\n\tif (text.length <= cap) return text;\n\t// A UTF-16 length never exceeds the UTF-8 byte count, so a byte budget bounds characters too.\n\tconst marker = `…${text.length} chars truncated…`;\n\treturn truncateMiddle(text, Math.max(0, cap - marker.length)).content;\n}\n\n/**\n * Fit answers inside `envelope` to the model-facing limit. Question lines, headers, and\n * the envelope always stay whole; only user-written text (answers, selections, notes) is\n * shortened, evenly and in place. The input limits keep the fixed parts well below the cap.\n */\nfunction boundedAnswers(answers: QuestionAnswer[], envelope: (body: string) => string): string {\n\tconst full = envelope(answers.map((answer) => answerSegment(answer, (text) => text)).join(\"\\n\\n\"));\n\tif (full.length <= QUESTION_LIMITS.modelResultChars) return full;\n\n\tconst lengths: number[] = [];\n\tfor (const answer of answers) {\n\t\tanswerSegment(answer, (text) => {\n\t\t\tlengths.push(text.length);\n\t\t\treturn text;\n\t\t});\n\t}\n\tconst fixed = full.length - lengths.reduce((sum, length) => sum + length, 0) + SHORTENED_NOTICE.length;\n\tconst cap = fairShare(lengths, QUESTION_LIMITS.modelResultChars - fixed);\n\tconst body = answers.map((answer) => answerSegment(answer, (text) => shorten(text, cap))).join(\"\\n\\n\");\n\treturn `${envelope(body)}${SHORTENED_NOTICE}`;\n}\n\nexport function errorResult(error: QuestionToolError, message: string): AgentToolResult<QuestionToolDetails> {\n\treturn buildToolResult(`Question tool error (${error}): ${message}`, {\n\t\tanswers: [],\n\t\toutcome: \"error\",\n\t\tcancelled: false,\n\t\terror,\n\t\tmessage,\n\t});\n}\n\nexport function answerScalar(answer: QuestionAnswer): string {\n\tif (answer.kind === \"multi\") return answer.selected?.length ? answer.selected.join(\", \") : \"(no input)\";\n\treturn answer.answer && answer.answer.length > 0 ? answer.answer : \"(no input)\";\n}\n\nfunction answerKindLabel(answer: QuestionAnswer): string {\n\tif (answer.kind === \"multi\") return \"Selections\";\n\treturn answer.kind === \"custom\" ? \"Custom answer\" : \"Selected option\";\n}\n\n/** Format one answer; `shape` receives each piece of user-written text and may shorten it. */\nfunction answerSegment(answer: QuestionAnswer, shape: (text: string) => string): string {\n\tconst response =\n\t\tanswer.kind === \"multi\" && answer.selected?.length\n\t\t\t? answer.selected.map(shape).join(\", \")\n\t\t\t: shape(answerScalar(answer));\n\tconst lines = [\n\t\t`${answer.questionIndex + 1}. [${answer.header}] ${answer.question}`,\n\t\t`   ${answerKindLabel(answer)}: ${response}`,\n\t];\n\tif (answer.preview) lines.push(\"   Preview: selected (kept in tool details)\");\n\tfor (const note of answer.notes ?? []) lines.push(`   Note for ${note.option}: ${shape(note.text)}`);\n\treturn lines.join(\"\\n\");\n}\n\nexport function successResult(answers: QuestionAnswer[]): AgentToolResult<QuestionToolDetails> {\n\tconst text = answers.length\n\t\t? boundedAnswers(answers, (body) => `${ENVELOPE_PREFIX}\\n${body}\\n\\n${ENVELOPE_SUFFIX}`)\n\t\t: DECLINE_MESSAGE;\n\treturn buildToolResult(text, {\n\t\tanswers,\n\t\toutcome: answers.length ? \"answered\" : \"cancelled\",\n\t\tcancelled: answers.length === 0,\n\t});\n}\n\nexport function cancelResult(answers: QuestionAnswer[] = []): AgentToolResult<QuestionToolDetails> {\n\tconst text = answers.length\n\t\t? boundedAnswers(answers, (body) => `${DECLINE_MESSAGE}\\n\\nPartial answers so far:\\n${body}`)\n\t\t: DECLINE_MESSAGE;\n\treturn buildToolResult(text, {\n\t\tanswers,\n\t\toutcome: \"cancelled\",\n\t\tcancelled: true,\n\t});\n}\n\nexport function clarificationResult(answers: QuestionAnswer[] = []): AgentToolResult<QuestionToolDetails> {\n\tconst envelope = (body: string) =>\n\t\t`${CLARIFICATION_MESSAGE}${body ? ` Partial answers so far:\\n${body}` : \"\"}\\n\\n${CLARIFICATION_FOLLOW_UP}`;\n\treturn buildToolResult(answers.length ? boundedAnswers(answers, envelope) : envelope(\"\"), {\n\t\tanswers,\n\t\toutcome: \"needs_clarification\",\n\t\tcancelled: false,\n\t});\n}\n"]}

package/dist/extensions/question/schema.d.ts

@@ -1,8 +1,20 @@
-import { Type } from "typebox";
-import type { Question, QuestionToolError } from "./types.ts";
-type QuestionArgs = {
-    questions: Question[];
-};
+import { type Static, Type } from "typebox";
+import type { QuestionToolError } from "./types.ts";
+declare const OptionSchema: Type.TObject<{
+    label: Type.TString;
+    description: Type.TString;
+    preview: Type.TOptional<Type.TString>;
+}>;
+declare const QuestionSchema: Type.TObject<{
+    question: Type.TString;
+    header: Type.TString;
+    options: Type.TArray<Type.TObject<{
+        label: Type.TString;
+        description: Type.TString;
+        preview: Type.TOptional<Type.TString>;
+    }>>;
+    multiSelect: Type.TOptional<Type.TBoolean>;
+}>;
 export declare const QuestionParams: Type.TObject<{
     questions: Type.TArray<Type.TObject<{
         question: Type.TString;
@@ -15,6 +27,9 @@ export declare const QuestionParams: Type.TObject<{
         multiSelect: Type.TOptional<Type.TBoolean>;
     }>>;
 }>;
+export type QuestionOption = Static<typeof OptionSchema>;
+export type Question = Static<typeof QuestionSchema>;
+type QuestionArgs = Static<typeof QuestionParams>;
 /**
  * Unambiguous argument normalizations applied before schema validation; the
  * schema itself stays a single object shape because strict constrained
@@ -33,7 +48,7 @@ export declare function normalizeQuestionArguments(raw: unknown): QuestionArgs;
  * Checks visible non-whitespace text and cross-field rules the schema cannot
  * express. Length and count limits remain enforced by `QuestionParams` first.
  */
-export declare function validateQuestions(questions: Question[]): {
+export declare function validateQuestions(questions: readonly Question[]): {
     ok: true;
 } | {
     ok: false;

package/dist/extensions/question/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/extensions/question/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAkB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9E,KAAK,YAAY,GAAG;IAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC;AAyD9C,eAAO,MAAM,cAAc;;;;;;;;;;;EAMzB,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAuCrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,QAAQ,EAAE,GACnB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiEzE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/extensions/question/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAUpD,QAAA,MAAM,YAAY;;;;EAoBhB,CAAC;AAEH,QAAA,MAAM,cAAc;;;;;;;;;EAuBlB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;EAMzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AACzD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AACrD,KAAK,YAAY,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAuCrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiEzE"}

package/dist/extensions/question/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/extensions/question/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAK9C,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,CAAU,CAAC;AAEnG,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACnE,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAEzE,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,eAAe,CAAC,gBAAgB;QAC3C,WAAW,EACV,oMAAoM;KACrM,CAAC;IACF,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;QACxB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,eAAe,CAAC,sBAAsB;QACjD,WAAW,EAAE,iFAAiF;KAC9F,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,CAAC;QACX,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,eAAe,CAAC,YAAY;QACvC,WAAW,EACV,0IAA0I;KAC3I,CAAC,CACF;CACD,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACrB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,eAAe,CAAC,aAAa;QACxC,WAAW,EACV,oHAAoH;KACrH,CAAC;IACF,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,eAAe,CAAC,WAAW;QACtC,WAAW,EAAE,2FAA2F;KACxG,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;QACjC,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE,4FAA4F;KACzG,CAAC;IACF,WAAW,EAAE,IAAI,CAAC,QAAQ,CACzB,IAAI,CAAC,OAAO,CAAC;QACZ,WAAW,EACV,yHAAyH;KAC1H,CAAC,CACF;CACD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;QACrC,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,kFAAkF;KAC/F,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAY;IACtD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAmB,CAAC;IAC9F,MAAM,IAAI,GAA4B,EAAE,GAAI,GAA+B,EAAE,CAAC;IAE9E,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC;YACJ,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACR,oDAAoD;QACrD,CAAC;IACF,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,MAAM,YAAY,GACjB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,IACC,YAAY,KAAK,SAAS;QAC1B,YAAY,KAAK,IAAI;QACrB,OAAO,YAAY,KAAK,QAAQ;QAChC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QAC3B,YAAwC,CAAC,QAAQ,KAAK,SAAS,EAC/D,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,GAAI,YAAwC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC,QAAQ,CAAC;QACrB,OAAO,IAAoB,CAAC;IAC7B,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9F,MAAM,QAAQ,GAA4B,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5F,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7D,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAC5E,OAAO,IAAI,CAAC,QAAQ,CAAC;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAoB,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAChC,SAAqB;IAErB,MAAM,eAAe,GAAG,CACvB,KAAc,EACd,IAAY,EAC2D,EAAE;QACzE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,4BAA4B,EAAE,CAAC;IACzF,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,KAAK,IAAI,aAAa,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC;QAC/E,MAAM,CAAC,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;QACnC,MAAM,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,QAAQ,EAAE,aAAa,aAAa,YAAY,CAAC,CAAC;QAC1F,IAAI,aAAa;YAAE,OAAO,aAAa,CAAC;QACxC,MAAM,WAAW,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,EAAE,aAAa,aAAa,UAAU,CAAC,CAAC;QACpF,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC;QAEpC,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;QAC5F,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE/B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,KAAK,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;YACzE,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAmB,CAAC;YACxD,MAAM,UAAU,GAAG,aAAa,aAAa,aAAa,WAAW,GAAG,CAAC;YACzE,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,UAAU,QAAQ,CAAC,CAAC;YACxE,IAAI,UAAU;gBAAE,OAAO,UAAU,CAAC;YAClC,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,UAAU,cAAc,CAAC,CAAC;YAC1F,IAAI,gBAAgB;gBAAE,OAAO,gBAAgB,CAAC;YAC9C,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,UAAU,UAAU,CAAC,CAAC;gBAC9E,IAAI,YAAY;oBAAE,OAAO,YAAY,CAAC;YACvC,CAAC;YAED,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvC,OAAO;oBACN,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,gBAAgB;oBACvB,OAAO,EAAE,6BAA6B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;iBACnE,CAAC;YACH,CAAC;YACD,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,OAAO;oBACN,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,wBAAwB;oBAC/B,OAAO,EAAE,gDAAgD;iBACzD,CAAC;YACH,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACjE,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,qBAAqB;gBAC5B,OAAO,EACN,kHAAkH;aACnH,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACrB,CAAC","sourcesContent":["import { Type } from \"typebox\";\nimport { QUESTION_LIMITS } from \"./limits.ts\";\nimport type { Question, QuestionOption, QuestionToolError } from \"./types.ts\";\n\ntype QuestionArgs = { questions: Question[] };\n\nconst MIN_OPTIONS = 2;\nconst MAX_OPTIONS = 4;\nconst MAX_QUESTIONS = 4;\nconst RESERVED_LABELS = [\"Other\", \"Type something\", \"Type something.\", \"Chat about this\"] as const;\n\nconst normalizeLabel = (text: string) => text.trim().toLowerCase();\nconst RESERVED_NORMALIZED = new Set(RESERVED_LABELS.map(normalizeLabel));\n\nconst OptionSchema = Type.Object({\n\tlabel: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: QUESTION_LIMITS.optionLabelChars,\n\t\tdescription:\n\t\t\t\"Short user-facing option label (1-5 words), distinct within the question. Reserved labels ('Other', 'Type something', 'Chat about this') are rejected — the UI adds the custom-answer path itself.\",\n\t}),\n\tdescription: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: QUESTION_LIMITS.optionDescriptionChars,\n\t\tdescription: \"One concise sentence explaining the option's meaning, consequence, or tradeoff.\",\n\t}),\n\tpreview: Type.Optional(\n\t\tType.String({\n\t\t\tminLength: 1,\n\t\t\tmaxLength: QUESTION_LIMITS.previewChars,\n\t\t\tdescription:\n\t\t\t\t\"Optional markdown preview shown only for focused single-select options; use for concrete snippets, layouts, copy, or config comparisons.\",\n\t\t}),\n\t),\n});\n\nconst QuestionSchema = Type.Object({\n\tquestion: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: QUESTION_LIMITS.questionChars,\n\t\tdescription:\n\t\t\t\"One clear, specific decision or preference question ending in a question mark. Ask only what is needed to proceed.\",\n\t}),\n\theader: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: QUESTION_LIMITS.headerChars,\n\t\tdescription: \"Very short decision label shown as a chip; aim for ~12 chars, max 32. E.g. 'Auth method'.\",\n\t}),\n\toptions: Type.Array(OptionSchema, {\n\t\tminItems: MIN_OPTIONS,\n\t\tmaxItems: MAX_OPTIONS,\n\t\tdescription: \"Mutually distinct options for this decision; do not include reserved custom-answer labels.\",\n\t}),\n\tmultiSelect: Type.Optional(\n\t\tType.Boolean({\n\t\t\tdescription:\n\t\t\t\t\"Allow selecting multiple options only when choices can be combined. Defaults to false for mutually exclusive decisions.\",\n\t\t}),\n\t),\n});\n\nexport const QuestionParams = Type.Object({\n\tquestions: Type.Array(QuestionSchema, {\n\t\tminItems: 1,\n\t\tmaxItems: MAX_QUESTIONS,\n\t\tdescription: \"Related decisions to ask now (1-4); ask only what is needed to unblock progress.\",\n\t}),\n});\n\n/**\n * Unambiguous argument normalizations applied before schema validation; the\n * schema itself stays a single object shape because strict constrained\n * sampling does not support object unions. Everything else is left for\n * validation to report.\n *\n * - a lone question written flat at the root ({question, header?, options,\n *   multiSelect?} with no questions) wraps into questions[0];\n * - a root-level question string fills a questions[0] object that lost its\n *   own question field to the root;\n * - a stringified questions array parses back into an array (a parse failure\n *   stays for validation to reject).\n */\nexport function normalizeQuestionArguments(raw: unknown): QuestionArgs {\n\tif (raw === null || typeof raw !== \"object\" || Array.isArray(raw)) return raw as QuestionArgs;\n\tconst args: Record<string, unknown> = { ...(raw as Record<string, unknown>) };\n\n\tif (typeof args.questions === \"string\") {\n\t\ttry {\n\t\t\tconst parsed: unknown = JSON.parse(args.questions);\n\t\t\tif (Array.isArray(parsed)) args.questions = parsed;\n\t\t} catch {\n\t\t\t// Leave the string for schema validation to reject.\n\t\t}\n\t}\n\n\tconst rootQuestion = typeof args.question === \"string\" ? args.question : undefined;\n\tconst onlyQuestion =\n\t\tArray.isArray(args.questions) && args.questions.length === 1 ? (args.questions[0] as unknown) : undefined;\n\tif (\n\t\trootQuestion !== undefined &&\n\t\tonlyQuestion !== null &&\n\t\ttypeof onlyQuestion === \"object\" &&\n\t\t!Array.isArray(onlyQuestion) &&\n\t\t(onlyQuestion as Record<string, unknown>).question === undefined\n\t) {\n\t\targs.questions = [{ ...(onlyQuestion as Record<string, unknown>), question: rootQuestion }];\n\t\tdelete args.question;\n\t\treturn args as QuestionArgs;\n\t}\n\n\tif (args.questions === undefined && rootQuestion !== undefined && args.options !== undefined) {\n\t\tconst question: Record<string, unknown> = { question: rootQuestion, options: args.options };\n\t\tif (args.header !== undefined) question.header = args.header;\n\t\tif (args.multiSelect !== undefined) question.multiSelect = args.multiSelect;\n\t\tdelete args.question;\n\t\tdelete args.options;\n\t\tdelete args.header;\n\t\tdelete args.multiSelect;\n\t\targs.questions = [question];\n\t}\n\treturn args as QuestionArgs;\n}\n\n/**\n * Checks visible non-whitespace text and cross-field rules the schema cannot\n * express. Length and count limits remain enforced by `QuestionParams` first.\n */\nexport function validateQuestions(\n\tquestions: Question[],\n): { ok: true } | { ok: false; error: QuestionToolError; message: string } {\n\tconst requireNonBlank = (\n\t\tvalue: unknown,\n\t\tpath: string,\n\t): { ok: false; error: QuestionToolError; message: string } | undefined => {\n\t\tif (typeof value === \"string\" && value.trim().length > 0) return undefined;\n\t\treturn { ok: false, error: \"blank_text\", message: `${path} must contain visible text` };\n\t};\n\n\tconst seenQuestions = new Set<string>();\n\tfor (let questionIndex = 0; questionIndex < questions.length; questionIndex++) {\n\t\tconst q = questions[questionIndex];\n\t\tconst questionError = requireNonBlank(q.question, `questions[${questionIndex}].question`);\n\t\tif (questionError) return questionError;\n\t\tconst headerError = requireNonBlank(q.header, `questions[${questionIndex}].header`);\n\t\tif (headerError) return headerError;\n\n\t\tconst questionKey = normalizeLabel(q.question);\n\t\tif (seenQuestions.has(questionKey)) {\n\t\t\treturn { ok: false, error: \"duplicate_question\", message: \"Question text must be unique\" };\n\t\t}\n\t\tseenQuestions.add(questionKey);\n\n\t\tconst seenLabels = new Set<string>();\n\t\tfor (let optionIndex = 0; optionIndex < q.options.length; optionIndex++) {\n\t\t\tconst option = q.options[optionIndex] as QuestionOption;\n\t\t\tconst optionPath = `questions[${questionIndex}].options[${optionIndex}]`;\n\t\t\tconst labelError = requireNonBlank(option.label, `${optionPath}.label`);\n\t\t\tif (labelError) return labelError;\n\t\t\tconst descriptionError = requireNonBlank(option.description, `${optionPath}.description`);\n\t\t\tif (descriptionError) return descriptionError;\n\t\t\tif (option.preview !== undefined) {\n\t\t\t\tconst previewError = requireNonBlank(option.preview, `${optionPath}.preview`);\n\t\t\t\tif (previewError) return previewError;\n\t\t\t}\n\n\t\t\tconst labelKey = normalizeLabel(option.label);\n\t\t\tif (RESERVED_NORMALIZED.has(labelKey)) {\n\t\t\t\treturn {\n\t\t\t\t\tok: false,\n\t\t\t\t\terror: \"reserved_label\",\n\t\t\t\t\tmessage: `Option label is reserved (${RESERVED_LABELS.join(\", \")})`,\n\t\t\t\t};\n\t\t\t}\n\t\t\tif (seenLabels.has(labelKey)) {\n\t\t\t\treturn {\n\t\t\t\t\tok: false,\n\t\t\t\t\terror: \"duplicate_option_label\",\n\t\t\t\t\tmessage: \"Option labels must be unique within a question\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tseenLabels.add(labelKey);\n\t\t}\n\n\t\tif (q.multiSelect && q.options.some((option) => option.preview)) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror: \"preview_multiselect\",\n\t\t\t\tmessage:\n\t\t\t\t\t\"Option previews are not supported on multiSelect questions; drop the previews or make the question single-select\",\n\t\t\t};\n\t\t}\n\t}\n\n\treturn { ok: true };\n}\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/extensions/question/schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Static, Type } from \"typebox\";\nimport { QUESTION_LIMITS } from \"./limits.ts\";\nimport type { QuestionToolError } from \"./types.ts\";\n\nconst MIN_OPTIONS = 2;\nconst MAX_OPTIONS = 4;\nconst MAX_QUESTIONS = 4;\nconst RESERVED_LABELS = [\"Other\", \"Type something\", \"Type something.\", \"Chat about this\"] as const;\n\nconst normalizeLabel = (text: string) => text.trim().toLowerCase();\nconst RESERVED_NORMALIZED = new Set(RESERVED_LABELS.map(normalizeLabel));\n\nconst OptionSchema = Type.Object({\n\tlabel: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: QUESTION_LIMITS.optionLabelChars,\n\t\tdescription:\n\t\t\t\"Short user-facing option label (1-5 words), distinct within the question. Reserved labels ('Other', 'Type something', 'Chat about this') are rejected — the UI adds the custom-answer path itself.\",\n\t}),\n\tdescription: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: QUESTION_LIMITS.optionDescriptionChars,\n\t\tdescription: \"One concise sentence explaining the option's meaning, consequence, or tradeoff.\",\n\t}),\n\tpreview: Type.Optional(\n\t\tType.String({\n\t\t\tminLength: 1,\n\t\t\tmaxLength: QUESTION_LIMITS.previewChars,\n\t\t\tdescription:\n\t\t\t\t\"Optional markdown preview shown only for focused single-select options; use for concrete snippets, layouts, copy, or config comparisons.\",\n\t\t}),\n\t),\n});\n\nconst QuestionSchema = Type.Object({\n\tquestion: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: QUESTION_LIMITS.questionChars,\n\t\tdescription:\n\t\t\t\"One clear, specific decision or preference question ending in a question mark. Ask only what is needed to proceed.\",\n\t}),\n\theader: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: QUESTION_LIMITS.headerChars,\n\t\tdescription: \"Very short decision label shown as a chip; aim for ~12 chars, max 32. E.g. 'Auth method'.\",\n\t}),\n\toptions: Type.Array(OptionSchema, {\n\t\tminItems: MIN_OPTIONS,\n\t\tmaxItems: MAX_OPTIONS,\n\t\tdescription: \"Mutually distinct options for this decision; do not include reserved custom-answer labels.\",\n\t}),\n\tmultiSelect: Type.Optional(\n\t\tType.Boolean({\n\t\t\tdescription:\n\t\t\t\t\"Allow selecting multiple options only when choices can be combined. Defaults to false for mutually exclusive decisions.\",\n\t\t}),\n\t),\n});\n\nexport const QuestionParams = Type.Object({\n\tquestions: Type.Array(QuestionSchema, {\n\t\tminItems: 1,\n\t\tmaxItems: MAX_QUESTIONS,\n\t\tdescription: \"Related decisions to ask now (1-4); ask only what is needed to unblock progress.\",\n\t}),\n});\n\nexport type QuestionOption = Static<typeof OptionSchema>;\nexport type Question = Static<typeof QuestionSchema>;\ntype QuestionArgs = Static<typeof QuestionParams>;\n\n/**\n * Unambiguous argument normalizations applied before schema validation; the\n * schema itself stays a single object shape because strict constrained\n * sampling does not support object unions. Everything else is left for\n * validation to report.\n *\n * - a lone question written flat at the root ({question, header?, options,\n *   multiSelect?} with no questions) wraps into questions[0];\n * - a root-level question string fills a questions[0] object that lost its\n *   own question field to the root;\n * - a stringified questions array parses back into an array (a parse failure\n *   stays for validation to reject).\n */\nexport function normalizeQuestionArguments(raw: unknown): QuestionArgs {\n\tif (raw === null || typeof raw !== \"object\" || Array.isArray(raw)) return raw as QuestionArgs;\n\tconst args: Record<string, unknown> = { ...(raw as Record<string, unknown>) };\n\n\tif (typeof args.questions === \"string\") {\n\t\ttry {\n\t\t\tconst parsed: unknown = JSON.parse(args.questions);\n\t\t\tif (Array.isArray(parsed)) args.questions = parsed;\n\t\t} catch {\n\t\t\t// Leave the string for schema validation to reject.\n\t\t}\n\t}\n\n\tconst rootQuestion = typeof args.question === \"string\" ? args.question : undefined;\n\tconst onlyQuestion =\n\t\tArray.isArray(args.questions) && args.questions.length === 1 ? (args.questions[0] as unknown) : undefined;\n\tif (\n\t\trootQuestion !== undefined &&\n\t\tonlyQuestion !== null &&\n\t\ttypeof onlyQuestion === \"object\" &&\n\t\t!Array.isArray(onlyQuestion) &&\n\t\t(onlyQuestion as Record<string, unknown>).question === undefined\n\t) {\n\t\targs.questions = [{ ...(onlyQuestion as Record<string, unknown>), question: rootQuestion }];\n\t\tdelete args.question;\n\t\treturn args as QuestionArgs;\n\t}\n\n\tif (args.questions === undefined && rootQuestion !== undefined && args.options !== undefined) {\n\t\tconst question: Record<string, unknown> = { question: rootQuestion, options: args.options };\n\t\tif (args.header !== undefined) question.header = args.header;\n\t\tif (args.multiSelect !== undefined) question.multiSelect = args.multiSelect;\n\t\tdelete args.question;\n\t\tdelete args.options;\n\t\tdelete args.header;\n\t\tdelete args.multiSelect;\n\t\targs.questions = [question];\n\t}\n\treturn args as QuestionArgs;\n}\n\n/**\n * Checks visible non-whitespace text and cross-field rules the schema cannot\n * express. Length and count limits remain enforced by `QuestionParams` first.\n */\nexport function validateQuestions(\n\tquestions: readonly Question[],\n): { ok: true } | { ok: false; error: QuestionToolError; message: string } {\n\tconst requireNonBlank = (\n\t\tvalue: unknown,\n\t\tpath: string,\n\t): { ok: false; error: QuestionToolError; message: string } | undefined => {\n\t\tif (typeof value === \"string\" && value.trim().length > 0) return undefined;\n\t\treturn { ok: false, error: \"blank_text\", message: `${path} must contain visible text` };\n\t};\n\n\tconst seenQuestions = new Set<string>();\n\tfor (let questionIndex = 0; questionIndex < questions.length; questionIndex++) {\n\t\tconst q = questions[questionIndex];\n\t\tconst questionError = requireNonBlank(q.question, `questions[${questionIndex}].question`);\n\t\tif (questionError) return questionError;\n\t\tconst headerError = requireNonBlank(q.header, `questions[${questionIndex}].header`);\n\t\tif (headerError) return headerError;\n\n\t\tconst questionKey = normalizeLabel(q.question);\n\t\tif (seenQuestions.has(questionKey)) {\n\t\t\treturn { ok: false, error: \"duplicate_question\", message: \"Question text must be unique\" };\n\t\t}\n\t\tseenQuestions.add(questionKey);\n\n\t\tconst seenLabels = new Set<string>();\n\t\tfor (let optionIndex = 0; optionIndex < q.options.length; optionIndex++) {\n\t\t\tconst option = q.options[optionIndex];\n\t\t\tconst optionPath = `questions[${questionIndex}].options[${optionIndex}]`;\n\t\t\tconst labelError = requireNonBlank(option.label, `${optionPath}.label`);\n\t\t\tif (labelError) return labelError;\n\t\t\tconst descriptionError = requireNonBlank(option.description, `${optionPath}.description`);\n\t\t\tif (descriptionError) return descriptionError;\n\t\t\tif (option.preview !== undefined) {\n\t\t\t\tconst previewError = requireNonBlank(option.preview, `${optionPath}.preview`);\n\t\t\t\tif (previewError) return previewError;\n\t\t\t}\n\n\t\t\tconst labelKey = normalizeLabel(option.label);\n\t\t\tif (RESERVED_NORMALIZED.has(labelKey)) {\n\t\t\t\treturn {\n\t\t\t\t\tok: false,\n\t\t\t\t\terror: \"reserved_label\",\n\t\t\t\t\tmessage: `Option label is reserved (${RESERVED_LABELS.join(\", \")})`,\n\t\t\t\t};\n\t\t\t}\n\t\t\tif (seenLabels.has(labelKey)) {\n\t\t\t\treturn {\n\t\t\t\t\tok: false,\n\t\t\t\t\terror: \"duplicate_option_label\",\n\t\t\t\t\tmessage: \"Option labels must be unique within a question\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tseenLabels.add(labelKey);\n\t\t}\n\n\t\tif (q.multiSelect && q.options.some((option) => option.preview)) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror: \"preview_multiselect\",\n\t\t\t\tmessage:\n\t\t\t\t\t\"Option previews are not supported on multiSelect questions; drop the previews or make the question single-select\",\n\t\t\t};\n\t\t}\n\t}\n\n\treturn { ok: true };\n}\n"]}

package/dist/extensions/question/state.d.ts

@@ -1,9 +1,11 @@
-import type { CustomAnswer, DisplayOption, Question, QuestionAnswer, QuestionState } from "./types.ts";
-export declare function newQuestionState(): QuestionState;
-export declare function selectedCustomAnswer(state: QuestionState): CustomAnswer | undefined;
-export declare function hasMultiAnswer(state: QuestionState): boolean;
-export declare function hasAnswer(state: QuestionState): boolean;
+import type { DisplayOption, Question, QuestionAnswer, QuestionState } from "./types.ts";
+export declare function newQuestionState(question: Question): QuestionState;
 export declare function displayOptions(question: Question): DisplayOption[];
-export declare function firstUnanswered(states: QuestionState[]): number | undefined;
-export declare function orderedAnswers(questions: Question[], states: QuestionState[]): QuestionAnswer[];
+export declare function hasAnswer(state: QuestionState): boolean;
+/** The saved custom text, whether or not it is currently selected. */
+export declare function customText(state: QuestionState): string | undefined;
+export declare function isSelected(state: QuestionState, option: DisplayOption): boolean;
+export declare function firstUnanswered(states: readonly QuestionState[]): number | undefined;
+/** Build the tool-facing answers for every answered question, in question order. */
+export declare function orderedAnswers(questions: readonly Question[], states: readonly QuestionState[]): QuestionAnswer[];
 //# sourceMappingURL=state.d.ts.map

package/dist/extensions/question/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/extensions/question/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGnH,wBAAgB,gBAAgB,IAAI,aAAa,CAMhD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,CAEnF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAEvD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,EAAE,CAKlE;AAWD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,GAAG,SAAS,CAM3E;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,cAAc,EAAE,CAmC/F"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/extensions/question/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGrG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAMlE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,EAAE,CAKlE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAIvD;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAInE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAO/E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,GAAG,SAAS,CAGpF;AAWD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,cAAc,EAAE,CAgCjH"}

package/dist/extensions/question/state.js

@@ -1,75 +1,84 @@
 import { OTHER_OPTION } from "./types.js";
-export function newQuestionState() {
+export function newQuestionState(question) {
     return {
-        optionIndex: 0,
-        multiSelected: new Set(),
-        notesByOption: new Map(),
+        focus: 0,
+        draft: question.multiSelect ? { kind: "multi", selected: new Set() } : { kind: "single" },
+        notes: new Map(),
     };
 }
-export function selectedCustomAnswer(state) {
-    return state.customAnswer?.selected ? state.customAnswer : undefined;
-}
-export function hasMultiAnswer(state) {
-    return state.multiSelected.size > 0 || selectedCustomAnswer(state) !== undefined;
-}
-export function hasAnswer(state) {
-    return Boolean(state.singleAnswer) || hasMultiAnswer(state);
-}
 export function displayOptions(question) {
     return [
         ...question.options.map((option, optionIndex) => ({ ...option, kind: "option", optionIndex })),
         OTHER_OPTION,
     ];
 }
-function noteEntries(state, allowedOptions) {
-    const allowed = new Set(allowedOptions);
-    const entries = [...state.notesByOption.entries()]
-        .filter(([option]) => allowed.has(option))
-        .filter(([, text]) => text.trim().length > 0)
-        .map(([option, text]) => ({ option, text: text.trim() }));
-    return entries.length ? entries : undefined;
+export function hasAnswer(state) {
+    const draft = state.draft;
+    if (draft.kind === "single")
+        return draft.choice !== undefined;
+    return draft.selected.size > 0 || draft.custom?.selected === true;
+}
+/** The saved custom text, whether or not it is currently selected. */
+export function customText(state) {
+    const draft = state.draft;
+    if (draft.kind === "multi")
+        return draft.custom?.text;
+    return draft.choice?.kind === "custom" ? draft.choice.text : undefined;
+}
+export function isSelected(state, option) {
+    const draft = state.draft;
+    if (draft.kind === "multi") {
+        return option.kind === "other" ? draft.custom?.selected === true : draft.selected.has(option.optionIndex);
+    }
+    if (option.kind === "other")
+        return draft.choice?.kind === "custom";
+    return draft.choice?.kind === "option" && draft.choice.index === option.optionIndex;
 }
 export function firstUnanswered(states) {
-    for (let i = 0; i < states.length; i++) {
-        const state = states[i];
-        if (!hasAnswer(state))
-            return i;
+    const index = states.findIndex((state) => !hasAnswer(state));
+    return index === -1 ? undefined : index;
+}
+function selectedNotes(question, state, indices) {
+    const notes = [];
+    for (const index of indices) {
+        const text = state.notes.get(index)?.trim();
+        if (text)
+            notes.push({ option: question.options[index].label, text });
     }
-    return undefined;
+    return notes.length ? notes : undefined;
 }
+/** Build the tool-facing answers for every answered question, in question order. */
 export function orderedAnswers(questions, states) {
     const answers = [];
-    for (let i = 0; i < questions.length; i++) {
-        const question = questions[i];
-        const state = states[i];
-        if (state.singleAnswer) {
-            const notes = state.singleAnswer.kind === "option" && state.singleAnswer.answer
-                ? noteEntries(state, [state.singleAnswer.answer])
-                : undefined;
-            answers.push(notes ? { ...state.singleAnswer, notes } : state.singleAnswer);
-            continue;
-        }
-        if (question.multiSelect && hasMultiAnswer(state)) {
-            const selected = [];
-            for (const idx of [...state.multiSelected].sort((a, b) => a - b)) {
-                const option = question.options[idx];
-                if (option)
-                    selected.push(option.label);
+    for (let questionIndex = 0; questionIndex < questions.length; questionIndex++) {
+        const question = questions[questionIndex];
+        const draft = states[questionIndex].draft;
+        const base = { questionIndex, question: question.question, header: question.header };
+        if (draft.kind === "single") {
+            const choice = draft.choice;
+            if (choice?.kind === "custom")
+                answers.push({ ...base, kind: "custom", answer: choice.text });
+            if (choice?.kind === "option") {
+                const option = question.options[choice.index];
+                const notes = selectedNotes(question, states[questionIndex], [choice.index]);
+                answers.push({
+                    ...base,
+                    kind: "option",
+                    answer: option.label,
+                    ...(option.preview ? { preview: option.preview } : {}),
+                    ...(notes ? { notes } : {}),
+                });
             }
-            const custom = selectedCustomAnswer(state);
-            if (custom)
-                selected.push(custom.text);
-            const notes = noteEntries(state, selected);
-            answers.push({
-                questionIndex: i,
-                question: question.question,
-                header: question.header,
-                kind: "multi",
-                answer: null,
-                selected,
-                ...(notes ? { notes } : {}),
-            });
+            continue;
         }
+        if (!hasAnswer(states[questionIndex]))
+            continue;
+        const indices = [...draft.selected].sort((a, b) => a - b);
+        const selected = indices.map((index) => question.options[index].label);
+        if (draft.custom?.selected)
+            selected.push(draft.custom.text);
+        const notes = selectedNotes(question, states[questionIndex], indices);
+        answers.push({ ...base, kind: "multi", answer: null, selected, ...(notes ? { notes } : {}) });
     }
     return answers;
 }

package/dist/extensions/question/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/extensions/question/state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnswerNote, CustomAnswer, DisplayOption, Question, QuestionAnswer, QuestionState } from \"./types.ts\";\nimport { OTHER_OPTION } from \"./types.ts\";\n\nexport function newQuestionState(): QuestionState {\n\treturn {\n\t\toptionIndex: 0,\n\t\tmultiSelected: new Set(),\n\t\tnotesByOption: new Map(),\n\t};\n}\n\nexport function selectedCustomAnswer(state: QuestionState): CustomAnswer | undefined {\n\treturn state.customAnswer?.selected ? state.customAnswer : undefined;\n}\n\nexport function hasMultiAnswer(state: QuestionState): boolean {\n\treturn state.multiSelected.size > 0 || selectedCustomAnswer(state) !== undefined;\n}\n\nexport function hasAnswer(state: QuestionState): boolean {\n\treturn Boolean(state.singleAnswer) || hasMultiAnswer(state);\n}\n\nexport function displayOptions(question: Question): DisplayOption[] {\n\treturn [\n\t\t...question.options.map((option, optionIndex) => ({ ...option, kind: \"option\" as const, optionIndex })),\n\t\tOTHER_OPTION,\n\t];\n}\n\nfunction noteEntries(state: QuestionState, allowedOptions: readonly string[]): AnswerNote[] | undefined {\n\tconst allowed = new Set(allowedOptions);\n\tconst entries = [...state.notesByOption.entries()]\n\t\t.filter(([option]) => allowed.has(option))\n\t\t.filter(([, text]) => text.trim().length > 0)\n\t\t.map(([option, text]) => ({ option, text: text.trim() }));\n\treturn entries.length ? entries : undefined;\n}\n\nexport function firstUnanswered(states: QuestionState[]): number | undefined {\n\tfor (let i = 0; i < states.length; i++) {\n\t\tconst state = states[i];\n\t\tif (!hasAnswer(state)) return i;\n\t}\n\treturn undefined;\n}\n\nexport function orderedAnswers(questions: Question[], states: QuestionState[]): QuestionAnswer[] {\n\tconst answers: QuestionAnswer[] = [];\n\tfor (let i = 0; i < questions.length; i++) {\n\t\tconst question = questions[i];\n\t\tconst state = states[i];\n\t\tif (state.singleAnswer) {\n\t\t\tconst notes =\n\t\t\t\tstate.singleAnswer.kind === \"option\" && state.singleAnswer.answer\n\t\t\t\t\t? noteEntries(state, [state.singleAnswer.answer])\n\t\t\t\t\t: undefined;\n\t\t\tanswers.push(notes ? { ...state.singleAnswer, notes } : state.singleAnswer);\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (question.multiSelect && hasMultiAnswer(state)) {\n\t\t\tconst selected: string[] = [];\n\t\t\tfor (const idx of [...state.multiSelected].sort((a, b) => a - b)) {\n\t\t\t\tconst option = question.options[idx];\n\t\t\t\tif (option) selected.push(option.label);\n\t\t\t}\n\t\t\tconst custom = selectedCustomAnswer(state);\n\t\t\tif (custom) selected.push(custom.text);\n\t\t\tconst notes = noteEntries(state, selected);\n\t\t\tanswers.push({\n\t\t\t\tquestionIndex: i,\n\t\t\t\tquestion: question.question,\n\t\t\t\theader: question.header,\n\t\t\t\tkind: \"multi\",\n\t\t\t\tanswer: null,\n\t\t\t\tselected,\n\t\t\t\t...(notes ? { notes } : {}),\n\t\t\t});\n\t\t}\n\t}\n\treturn answers;\n}\n"]}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/extensions/question/state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnswerNote, DisplayOption, Question, QuestionAnswer, QuestionState } from \"./types.ts\";\nimport { OTHER_OPTION } from \"./types.ts\";\n\nexport function newQuestionState(question: Question): QuestionState {\n\treturn {\n\t\tfocus: 0,\n\t\tdraft: question.multiSelect ? { kind: \"multi\", selected: new Set() } : { kind: \"single\" },\n\t\tnotes: new Map(),\n\t};\n}\n\nexport function displayOptions(question: Question): DisplayOption[] {\n\treturn [\n\t\t...question.options.map((option, optionIndex) => ({ ...option, kind: \"option\" as const, optionIndex })),\n\t\tOTHER_OPTION,\n\t];\n}\n\nexport function hasAnswer(state: QuestionState): boolean {\n\tconst draft = state.draft;\n\tif (draft.kind === \"single\") return draft.choice !== undefined;\n\treturn draft.selected.size > 0 || draft.custom?.selected === true;\n}\n\n/** The saved custom text, whether or not it is currently selected. */\nexport function customText(state: QuestionState): string | undefined {\n\tconst draft = state.draft;\n\tif (draft.kind === \"multi\") return draft.custom?.text;\n\treturn draft.choice?.kind === \"custom\" ? draft.choice.text : undefined;\n}\n\nexport function isSelected(state: QuestionState, option: DisplayOption): boolean {\n\tconst draft = state.draft;\n\tif (draft.kind === \"multi\") {\n\t\treturn option.kind === \"other\" ? draft.custom?.selected === true : draft.selected.has(option.optionIndex);\n\t}\n\tif (option.kind === \"other\") return draft.choice?.kind === \"custom\";\n\treturn draft.choice?.kind === \"option\" && draft.choice.index === option.optionIndex;\n}\n\nexport function firstUnanswered(states: readonly QuestionState[]): number | undefined {\n\tconst index = states.findIndex((state) => !hasAnswer(state));\n\treturn index === -1 ? undefined : index;\n}\n\nfunction selectedNotes(question: Question, state: QuestionState, indices: readonly number[]): AnswerNote[] | undefined {\n\tconst notes: AnswerNote[] = [];\n\tfor (const index of indices) {\n\t\tconst text = state.notes.get(index)?.trim();\n\t\tif (text) notes.push({ option: question.options[index].label, text });\n\t}\n\treturn notes.length ? notes : undefined;\n}\n\n/** Build the tool-facing answers for every answered question, in question order. */\nexport function orderedAnswers(questions: readonly Question[], states: readonly QuestionState[]): QuestionAnswer[] {\n\tconst answers: QuestionAnswer[] = [];\n\tfor (let questionIndex = 0; questionIndex < questions.length; questionIndex++) {\n\t\tconst question = questions[questionIndex];\n\t\tconst draft = states[questionIndex].draft;\n\t\tconst base = { questionIndex, question: question.question, header: question.header };\n\n\t\tif (draft.kind === \"single\") {\n\t\t\tconst choice = draft.choice;\n\t\t\tif (choice?.kind === \"custom\") answers.push({ ...base, kind: \"custom\", answer: choice.text });\n\t\t\tif (choice?.kind === \"option\") {\n\t\t\t\tconst option = question.options[choice.index];\n\t\t\t\tconst notes = selectedNotes(question, states[questionIndex], [choice.index]);\n\t\t\t\tanswers.push({\n\t\t\t\t\t...base,\n\t\t\t\t\tkind: \"option\",\n\t\t\t\t\tanswer: option.label,\n\t\t\t\t\t...(option.preview ? { preview: option.preview } : {}),\n\t\t\t\t\t...(notes ? { notes } : {}),\n\t\t\t\t});\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (!hasAnswer(states[questionIndex])) continue;\n\t\tconst indices = [...draft.selected].sort((a, b) => a - b);\n\t\tconst selected = indices.map((index) => question.options[index].label);\n\t\tif (draft.custom?.selected) selected.push(draft.custom.text);\n\t\tconst notes = selectedNotes(question, states[questionIndex], indices);\n\t\tanswers.push({ ...base, kind: \"multi\", answer: null, selected, ...(notes ? { notes } : {}) });\n\t}\n\treturn answers;\n}\n"]}

package/dist/extensions/question/types.d.ts

@@ -1,15 +1,5 @@
-export interface QuestionOption {
-    label: string;
-    description: string;
-    preview?: string;
-}
-export interface Question {
-    question: string;
-    header: string;
-    options: QuestionOption[];
-    multiSelect?: boolean;
-}
-export type InputMode = "custom" | "notes" | undefined;
+import type { QuestionOption } from "./schema.ts";
+export type { Question, QuestionOption } from "./schema.ts";
 export type QuestionToolError = "no_ui" | "blank_text" | "duplicate_question" | "duplicate_option_label" | "reserved_label" | "preview_multiselect";
 export interface AnswerNote {
     option: string;
@@ -33,21 +23,54 @@ export interface QuestionToolDetails {
     error?: QuestionToolError;
     message?: string;
 }
+/** A single-select choice: an authored option by index, or the user's own text. */
+export type SingleChoice = {
+    kind: "option";
+    index: number;
+} | {
+    kind: "custom";
+    text: string;
+};
 export interface CustomAnswer {
     text: string;
     selected: boolean;
 }
+export type AnswerDraft = {
+    kind: "single";
+    choice?: SingleChoice;
+} | {
+    kind: "multi";
+    selected: Set<number>;
+    custom?: CustomAnswer;
+};
 export interface QuestionState {
-    optionIndex: number;
-    singleAnswer?: QuestionAnswer;
-    multiSelected: Set<number>;
-    customAnswer?: CustomAnswer;
-    notesByOption: Map<string, string>;
+    /** Index of the focused row in `displayOptions()`. */
+    focus: number;
+    draft: AnswerDraft;
+    /** Notes keyed by authored option index. */
+    notes: Map<number, string>;
     warning?: string;
 }
+/**
+ * What the dialog is doing. A single-select notes session tentatively selects
+ * its option, so it remembers the choice to restore when left without saving.
+ */
+export type DialogMode = {
+    kind: "choose";
+} | {
+    kind: "chat";
+} | {
+    kind: "custom";
+} | {
+    kind: "notes";
+    option: number;
+    previous: SingleChoice | undefined;
+} | {
+    kind: "review";
+};
 export interface DialogResult {
     answers: QuestionAnswer[];
-    outcome: QuestionOutcome;
+    outcome: Exclude<QuestionOutcome, "error">;
 }
 export type DisplayOption = (QuestionOption & {
     kind: "option";

package/dist/extensions/question/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/question/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAC1B,OAAO,GACP,YAAY,GACZ,oBAAoB,GACpB,wBAAwB,GACxB,gBAAgB,GAChB,qBAAqB,CAAC;AAEzB,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,WAAW,GAAG,qBAAqB,GAAG,OAAO,CAAC;AAEzF,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GACtB,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,eAAO,MAAM,YAAY,EAAE,aAA0D,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/question/types.ts"],"names":[],"mappings":"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"}

package/dist/extensions/question/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extensions/question/types.ts"],"names":[],"mappings":"AAwEA,MAAM,CAAC,MAAM,YAAY,GAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["export interface QuestionOption {\n\tlabel: string;\n\tdescription: string;\n\tpreview?: string;\n}\n\nexport interface Question {\n\tquestion: string;\n\theader: string;\n\toptions: QuestionOption[];\n\tmultiSelect?: boolean;\n}\n\nexport type InputMode = \"custom\" | \"notes\" | undefined;\n\nexport type QuestionToolError =\n\t| \"no_ui\"\n\t| \"blank_text\"\n\t| \"duplicate_question\"\n\t| \"duplicate_option_label\"\n\t| \"reserved_label\"\n\t| \"preview_multiselect\";\n\nexport interface AnswerNote {\n\toption: string;\n\ttext: string;\n}\n\nexport interface QuestionAnswer {\n\tquestionIndex: number;\n\tquestion: string;\n\theader: string;\n\tkind: \"option\" | \"custom\" | \"multi\";\n\tanswer: string | null;\n\tselected?: string[];\n\tnotes?: AnswerNote[];\n\tpreview?: string;\n}\n\nexport type QuestionOutcome = \"answered\" | \"cancelled\" | \"needs_clarification\" | \"error\";\n\nexport interface QuestionToolDetails {\n\tanswers: QuestionAnswer[];\n\toutcome: QuestionOutcome;\n\tcancelled: boolean;\n\terror?: QuestionToolError;\n\tmessage?: string;\n}\n\nexport interface CustomAnswer {\n\ttext: string;\n\tselected: boolean;\n}\n\nexport interface QuestionState {\n\toptionIndex: number;\n\tsingleAnswer?: QuestionAnswer;\n\tmultiSelected: Set<number>;\n\tcustomAnswer?: CustomAnswer;\n\tnotesByOption: Map<string, string>;\n\twarning?: string;\n}\n\nexport interface DialogResult {\n\tanswers: QuestionAnswer[];\n\toutcome: QuestionOutcome;\n}\n\nexport type DisplayOption =\n\t| (QuestionOption & { kind: \"option\"; optionIndex: number })\n\t| { kind: \"other\"; label: string };\n\nexport const OTHER_OPTION: DisplayOption = { kind: \"other\", label: \"Type something\" };\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extensions/question/types.ts"],"names":[],"mappings":"AA+EA,MAAM,CAAC,MAAM,YAAY,GAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["import type { QuestionOption } from \"./schema.ts\";\n\nexport type { Question, QuestionOption } from \"./schema.ts\";\n\nexport type QuestionToolError =\n\t| \"no_ui\"\n\t| \"blank_text\"\n\t| \"duplicate_question\"\n\t| \"duplicate_option_label\"\n\t| \"reserved_label\"\n\t| \"preview_multiselect\";\n\nexport interface AnswerNote {\n\toption: string;\n\ttext: string;\n}\n\nexport interface QuestionAnswer {\n\tquestionIndex: number;\n\tquestion: string;\n\theader: string;\n\tkind: \"option\" | \"custom\" | \"multi\";\n\tanswer: string | null;\n\tselected?: string[];\n\tnotes?: AnswerNote[];\n\tpreview?: string;\n}\n\nexport type QuestionOutcome = \"answered\" | \"cancelled\" | \"needs_clarification\" | \"error\";\n\nexport interface QuestionToolDetails {\n\tanswers: QuestionAnswer[];\n\toutcome: QuestionOutcome;\n\tcancelled: boolean;\n\terror?: QuestionToolError;\n\tmessage?: string;\n}\n\n/** A single-select choice: an authored option by index, or the user's own text. */\nexport type SingleChoice = { kind: \"option\"; index: number } | { kind: \"custom\"; text: string };\n\nexport interface CustomAnswer {\n\ttext: string;\n\tselected: boolean;\n}\n\nexport type AnswerDraft =\n\t| { kind: \"single\"; choice?: SingleChoice }\n\t| { kind: \"multi\"; selected: Set<number>; custom?: CustomAnswer };\n\nexport interface QuestionState {\n\t/** Index of the focused row in `displayOptions()`. */\n\tfocus: number;\n\tdraft: AnswerDraft;\n\t/** Notes keyed by authored option index. */\n\tnotes: Map<number, string>;\n\twarning?: string;\n}\n\n/**\n * What the dialog is doing. A single-select notes session tentatively selects\n * its option, so it remembers the choice to restore when left without saving.\n */\nexport type DialogMode =\n\t| { kind: \"choose\" }\n\t| { kind: \"chat\" }\n\t| { kind: \"custom\" }\n\t| { kind: \"notes\"; option: number; previous: SingleChoice | undefined }\n\t| { kind: \"review\" };\n\nexport interface DialogResult {\n\tanswers: QuestionAnswer[];\n\toutcome: Exclude<QuestionOutcome, \"error\">;\n}\n\nexport type DisplayOption =\n\t| (QuestionOption & { kind: \"option\"; optionIndex: number })\n\t| { kind: \"other\"; label: string };\n\nexport const OTHER_OPTION: DisplayOption = { kind: \"other\", label: \"Type something\" };\n"]}

package/dist/extensions/statusline/index.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Fixed two-line footer, installed only in the interactive TUI.
+ * Rendering and active-branch accounting are owned by this extension.
+ */
 import type { ExtensionAPI } from "../../core/extensions/types.ts";
 export default function statusline(pi: ExtensionAPI): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/extensions/statusline/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/statusline/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gCAAgC,CAAC;AAyXrF,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA0FzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/statusline/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAInE,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAmCzD"}