openclaw/packages/gateway-protocol/src/questions-validators.test.ts

import { Value } from "typebox/value";
import { describe, expect, it } from "vitest";
import {
  QuestionRecordSchema,
  validateQuestionRequestParams,
  validateQuestionResolveParams,
  validateQuestionWaitAnswerParams,
} from "./index.js";

const question = {
  questionId: "choice",
  header: "Choice",
  question: "Which option?",
  options: [{ label: "One", description: "First" }, { label: "Two" }],
  multiSelect: false,
  isOther: true,
  isSecret: false,
};
const answers = { answers: { choice: ["Two"] } };

describe("question protocol validators", () => {
  it("validates method params", () => {
    expect(
      validateQuestionRequestParams({
        id: "client-question-id",
        runId: "agent-run-id",
        questions: [question],
        timeoutMs: 100,
      }),
    ).toBe(true);
    expect(validateQuestionWaitAnswerParams({ id: "question-uuid", timeoutMs: 50 })).toBe(true);
    expect(validateQuestionResolveParams({ id: "question-uuid", answers })).toBe(true);
    expect(validateQuestionResolveParams({ id: "question-uuid", cancel: true })).toBe(true);
    expect(
      Value.Check(QuestionRecordSchema, {
        id: "client-question-id",
        runId: "agent-run-id",
        questions: [question],
        createdAtMs: 1,
        expiresAtMs: 2,
        status: "pending",
      }),
    ).toBe(true);
  });

  it("enforces the shared question header cap", () => {
    expect(
      validateQuestionRequestParams({
        questions: [{ ...question, header: "longer than twelve" }],
      }),
    ).toBe(false);
    expect(validateQuestionRequestParams({ questions: [] })).toBe(false);
    expect(
      validateQuestionRequestParams({ questions: [question, question, question, question] }),
    ).toBe(false);
  });
});