Files
Moltbot/src/gateway/server-methods/wizard.ts
2026-02-16 01:08:36 +00:00

134 lines
4.2 KiB
TypeScript

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<T> = ((params: unknown) => params is T) & {
errors?: ErrorObject[] | null;
};
function assertValidParams<T>(
params: unknown,
validate: Validator<T>,
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);
},
};