Method handleApproval

packages/acp-adapter/src/session.ts:1229–1270

* Bridge an SDK ApprovalRequest through the ACP reverse-RPC * `session/request_permission`. * * Flow: * 1. Build the wire-level ToolCallUpdate so the client can * correlate the prompt with the tool card it already rendered * (uses the prefixed `${turnId}:${

(req: ApprovalRequest)

   * needs human authorization to proceed with a tool call.
   */
  private async handleApproval(req: ApprovalRequest): Promise<ApprovalResponse> {
    const toolCall = buildPermissionToolCallUpdate(this.currentTurnId, req);
    const options = approvalRequestToPermissionOptions(req);
    // Phase 13.2 telemetry breadcrumb: how many discrete options does
    // the plan_review surface carry? PII-free (just a count), matches
    // the Phase 11.2 telemetry discipline.
    if (req.display.kind === 'plan_review') {
      const count = req.display.options?.length ?? 0;
      this.emitTelemetry('plan_review_options_count', { count });
    }
    try {
      // `requestPermission` is an awaitable JSON-RPC request (unlike
      // the fire-and-forget `sessionUpdate` notifications elsewhere in
      // this file), so the SDK call site naturally blocks on the
      // user's decision before the tool runs.
      const response = await this.conn.requestPermission({
        sessionId: this.id,
        options: [...options],
        toolCall,
      });
      // Map the discriminator first (pure mapper, easy to unit-test),
      // then stitch the matched option's human-readable name as
      // `selectedLabel` so the SDK can surface "approved as
      // 'Approve once'" in subsequent reasoning. `attachSelectedLabel`
      // is a no-op for `cancelled` outcomes, unknown optionIds, and
      // plan_* optionIds (Phase 13.2 — the plan_review branch attaches
      // selectedLabel inside `permissionResponseToApprovalResponse`).
      return attachSelectedLabel(
        response,
        permissionResponseToApprovalResponse(req, response),
        options,
      );
    } catch (err) {
      log.warn('acp: requestPermission failed; rejecting', {
        sessionId: this.id,
        toolCallId: req.toolCallId,
        toolName: req.toolName,
        error: err instanceof Error ? err.message : String(err),
      });
      return { decision: 'rejected' };
    }
  }

  /**
   * Bridge an SDK {@link QuestionRequest} (the AskUserQuestion tool's