Method finalizeAgentTaskReport

src/node/services/taskService.ts:9371–9613

(
    childWorkspaceId: string,
    childEntry: { projectPath: string; workspace: WorkspaceConfigEntry } | null | undefined,
    rawReportArgs: {
      reportMarkdown: string;
      title?: string;
      structuredOutput?: unknown;
      planFilePath?: string;
    }
  )

  }

  private async finalizeAgentTaskReport(
    childWorkspaceId: string,
    childEntry: { projectPath: string; workspace: WorkspaceConfigEntry } | null | undefined,
    rawReportArgs: {
      reportMarkdown: string;
      title?: string;
      structuredOutput?: unknown;
      planFilePath?: string;
    }
  ): Promise<AgentReportFinalizationResult> {
    this.markTaskForegroundRelevant(childWorkspaceId);

    assert(
      childWorkspaceId.length > 0,
      "finalizeAgentTaskReport: childWorkspaceId must be non-empty"
    );
    assert(
      typeof rawReportArgs.reportMarkdown === "string" && rawReportArgs.reportMarkdown.length > 0,
      "finalizeAgentTaskReport: reportMarkdown must be non-empty"
    );

    const cfgBeforeReport = this.config.loadConfigOrDefault();
    const latestEntryBeforeReport =
      findWorkspaceEntry(cfgBeforeReport, childWorkspaceId) ?? childEntry;
    const statusBefore = latestEntryBeforeReport?.workspace.taskStatus;
    if (statusBefore === "reported") {
      return { finalized: true };
    }

    const allowLegacyInvalidOutputSchema = await this.shouldAllowLegacyInvalidWorkflowOutputSchema(
      childWorkspaceId,
      latestEntryBeforeReport
    );
    const reportArgs = normalizeWorkflowAgentReportArgsForWorkflowTask(
      latestEntryBeforeReport?.workspace.workflowTask,
      rawReportArgs
    );
    const validationMessage = validateWorkflowAgentReportStructuredOutput({
      workflowTask: latestEntryBeforeReport?.workspace.workflowTask,
      reportArgs,
      allowLegacyInvalidOutputSchema,
    });
    if (validationMessage != null) {
      log.warn("Rejecting invalid workflow agent_report structured output", {
        childWorkspaceId,
        workflowTask: latestEntryBeforeReport?.workspace.workflowTask,
        message: validationMessage,
      });
      if (statusBefore === "interrupted") {
        return {
          finalized: false,
          reason: "terminal_interrupted",
          message: validationMessage,
        };
      }

      await this.editWorkspaceEntry(
        childWorkspaceId,