Method handleQuestion

packages/acp-adapter/src/session.ts:1295–1353

* Bridge an SDK QuestionRequest (the AskUserQuestion tool's * reverse-RPC) through the same ACP * `session/request_permission` surface used by approvals. * * ACP currently has no dedicated `session/request_question` method, so * the adapter re-uses `requestPermission` and tags

(req: QuestionRequest)

   * is strictly safer than fabricating an answer the user did not give.
   */
  private async handleQuestion(req: QuestionRequest): Promise<QuestionAnswers | null> {
    const questions = req.questions;
    if (questions.length === 0) {
      // Pathological input — log and dismiss. No telemetry: the SDK
      // would never emit an empty `questions` payload in practice.
      log.warn('acp: handleQuestion received empty questions array', {
        sessionId: this.id,
      });
      return null;
    }
    if (questions.length > 1) {
      log.warn('acp: handleQuestion degrading to first question only', {
        sessionId: this.id,
        dropped: questions.length - 1,
      });
      this.emitTelemetry('question_degraded', {
        reason: 'multi_question',
        dropped: questions.length - 1,
      });
    }
    const q = questions[0]!;
    if (q.multiSelect === true) {
      this.emitTelemetry('question_degraded', { reason: 'multi_select' });
    }
    const options = questionItemToPermissionOptions(q, 0);
    const rawToolCallId = req.toolCallId ?? 'ask-user';
    const toolCallId =
      this.currentTurnId !== undefined
        ? acpToolCallId(this.currentTurnId, rawToolCallId)
        : rawToolCallId;
    try {
      const response = await this.conn.requestPermission({
        sessionId: this.id,
        options: [...options],
        toolCall: {
          toolCallId,
          title: 'AskUserQuestion',
          content: [{ type: 'content', content: { type: 'text', text: q.question } }],
        },
      });
      const answer = outcomeToQuestionAnswer(q, response);
      if (answer === null) {
        // Dismissed via skip / cancel / unknown optionId — telemetry
        // matches the ask-user tool's existing `question_dismissed`
        // event so dashboards stay coherent.
        this.emitTelemetry('question_dismissed');
      } else {
        this.emitTelemetry('question_answered', { answered: Object.keys(answer).length });
      }
      return answer;
    } catch (err) {
      log.warn('acp: requestPermission (question) failed; dismissing', {
        sessionId: this.id,
        toolCallId: req.toolCallId,
        error: err instanceof Error ? err.message : String(err),
      });
      return null;
    }