import { Bus } from "@/bus" import { BusEvent } from "@/bus/bus-event" import { Identifier } from "@/id/id" import { Instance } from "@/project/instance" import { Log } from "@/util/log" import z from "zod" export namespace Question { const log = Log.create({ service: "question" }) export const Option = z .object({ label: z.string().describe("Display text (1-5 words, concise)"), description: z.string().describe("Explanation of choice"), }) .meta({ ref: "QuestionOption", }) export type Option = z.infer export const Info = z .object({ question: z.string().describe("Complete question"), header: z.string().max(12).describe("Very short label (max 12 chars)"), options: z.array(Option).describe("Available choices"), multiple: z.boolean().optional().describe("Allow selecting multiple choices"), custom: z.boolean().optional().describe("Allow typing a custom answer (default: true)"), }) .meta({ ref: "QuestionInfo", }) export type Info = z.infer export const Request = z .object({ id: Identifier.schema("question"), sessionID: Identifier.schema("session"), questions: z.array(Info).describe("Questions to ask"), tool: z .object({ messageID: z.string(), callID: z.string(), }) .optional(), }) .meta({ ref: "QuestionRequest", }) export type Request = z.infer export const Answer = z.array(z.string()).meta({ ref: "QuestionAnswer", }) export type Answer = z.infer export const Reply = z.object({ answers: z .array(Answer) .describe("User answers in order of questions (each answer is an array of selected labels)"), }) export type Reply = z.infer export const Event = { Asked: BusEvent.define("question.asked", Request), Replied: BusEvent.define( "question.replied", z.object({ sessionID: z.string(), requestID: z.string(), answers: z.array(Answer), }), ), Rejected: BusEvent.define( "question.rejected", z.object({ sessionID: z.string(), requestID: z.string(), }), ), } const state = Instance.state(async () => { const pending: Record< string, { info: Request resolve: (answers: Answer[]) => void reject: (e: any) => void } > = {} return { pending, } }) export async function ask(input: { sessionID: string questions: Info[] tool?: { messageID: string; callID: string } }): Promise { const s = await state() const id = Identifier.ascending("question") log.info("asking", { id, questions: input.questions.length }) return new Promise((resolve, reject) => { const info: Request = { id, sessionID: input.sessionID, questions: input.questions, tool: input.tool, } s.pending[id] = { info, resolve, reject, } Bus.publish(Event.Asked, info) }) } export async function reply(input: { requestID: string; answers: Answer[] }): Promise { const s = await state() const existing = s.pending[input.requestID] if (!existing) { log.warn("reply for unknown request", { requestID: input.requestID }) return } delete s.pending[input.requestID] log.info("replied", { requestID: input.requestID, answers: input.answers }) Bus.publish(Event.Replied, { sessionID: existing.info.sessionID, requestID: existing.info.id, answers: input.answers, }) existing.resolve(input.answers) } export async function reject(requestID: string): Promise { const s = await state() const existing = s.pending[requestID] if (!existing) { log.warn("reject for unknown request", { requestID }) return } delete s.pending[requestID] log.info("rejected", { requestID }) Bus.publish(Event.Rejected, { sessionID: existing.info.sessionID, requestID: existing.info.id, }) existing.reject(new RejectedError()) } export class RejectedError extends Error { constructor() { super("The user dismissed this question") } } export async function list() { return state().then((x) => Object.values(x.pending).map((x) => x.info)) } }