import type { ErrorObject } from "ajv"; import { randomUUID } from "node:crypto"; import type { GatewayRequestHandlers, RespondFn } from "./types.js"; import { defaultRuntime } from "../../runtime.js"; import { WizardSession } from "../../wizard/session.js"; import { ErrorCodes, errorShape, formatValidationErrors, validateWizardCancelParams, validateWizardNextParams, validateWizardStartParams, validateWizardStatusParams, } from "../protocol/index.js"; import { formatForLog } from "../ws-log.js"; type Validator = ((params: unknown) => params is T) & { errors?: ErrorObject[] | null; }; function assertValidParams( params: unknown, validate: Validator, method: string, respond: RespondFn, ): params is T { if (validate(params)) { return true; } respond( false, undefined, errorShape( ErrorCodes.INVALID_REQUEST, `invalid ${method} params: ${formatValidationErrors(validate.errors)}`, ), ); return false; } function readWizardStatus(session: WizardSession) { return { status: session.getStatus(), error: session.getError(), }; } export const wizardHandlers: GatewayRequestHandlers = { "wizard.start": async ({ params, respond, context }) => { if (!assertValidParams(params, validateWizardStartParams, "wizard.start", respond)) { return; } const running = context.findRunningWizard(); if (running) { respond(false, undefined, errorShape(ErrorCodes.UNAVAILABLE, "wizard already running")); return; } const sessionId = randomUUID(); const opts = { mode: params.mode, workspace: typeof params.workspace === "string" ? params.workspace : undefined, }; const session = new WizardSession((prompter) => context.wizardRunner(opts, defaultRuntime, prompter), ); context.wizardSessions.set(sessionId, session); const result = await session.next(); if (result.done) { context.purgeWizardSession(sessionId); } respond(true, { sessionId, ...result }, undefined); }, "wizard.next": async ({ params, respond, context }) => { if (!assertValidParams(params, validateWizardNextParams, "wizard.next", respond)) { return; } const sessionId = params.sessionId; const session = context.wizardSessions.get(sessionId); if (!session) { respond(false, undefined, errorShape(ErrorCodes.INVALID_REQUEST, "wizard not found")); return; } const answer = params.answer as { stepId?: string; value?: unknown } | undefined; if (answer) { if (session.getStatus() !== "running") { respond(false, undefined, errorShape(ErrorCodes.INVALID_REQUEST, "wizard not running")); return; } try { await session.answer(String(answer.stepId ?? ""), answer.value); } catch (err) { respond(false, undefined, errorShape(ErrorCodes.INVALID_REQUEST, formatForLog(err))); return; } } const result = await session.next(); if (result.done) { context.purgeWizardSession(sessionId); } respond(true, result, undefined); }, "wizard.cancel": ({ params, respond, context }) => { if (!assertValidParams(params, validateWizardCancelParams, "wizard.cancel", respond)) { return; } const sessionId = params.sessionId; const session = context.wizardSessions.get(sessionId); if (!session) { respond(false, undefined, errorShape(ErrorCodes.INVALID_REQUEST, "wizard not found")); return; } session.cancel(); const status = readWizardStatus(session); context.wizardSessions.delete(sessionId); respond(true, status, undefined); }, "wizard.status": ({ params, respond, context }) => { if (!assertValidParams(params, validateWizardStatusParams, "wizard.status", respond)) { return; } const sessionId = params.sessionId; const session = context.wizardSessions.get(sessionId); if (!session) { respond(false, undefined, errorShape(ErrorCodes.INVALID_REQUEST, "wizard not found")); return; } const status = readWizardStatus(session); if (status.status !== "running") { context.wizardSessions.delete(sessionId); } respond(true, status, undefined); }, };