src/types/history.d.ts

Rama main · réplica de lectura del repositorio original.

// ========= Copyright 2025-2026 @ Eigent.ai All Rights Reserved. =========
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ========= Copyright 2025-2026 @ Eigent.ai All Rights Reserved. =========

import type { SkipReason } from './index';

// History API types for project-grouped structure

export interface HistoryTask {
  id: number;
  task_id: string;
  project_id: string;
  space_id?: string;
  run_id?: string;
  question: string;
  language: string;
  model_platform: string;
  model_type: string;
  api_key?: string;
  api_url?: string;
  max_retries: number;
  file_save_path?: string;
  installed_mcp?: string;
  project_name?: string;
  summary?: string;
  tokens: number;
  status: number;
  skip_reason?: SkipReason;
  created_at?: string;
  updated_at?: string;
}

export interface ProjectGroup {
  project_id: string;
  space_id?: string;
  project_name?: string;
  /** Client only: the Session meta's `metadata.nameSource`, set when the
   * name was chosen rather than defaulted. */
  nameSource?: unknown;
  total_tokens: number;
  task_count: number;
  total_triggers: number;
  latest_task_date: string;
  last_prompt: string;
  tasks: HistoryTask[];
  // Additional project-level metadata
  total_completed_tasks: number;
  total_ongoing_tasks: number;
  average_tokens_per_task: number;
}

export interface GroupedHistoryResponse {
  projects: ProjectGroup[];
  total_projects: number;
  total_tasks: number;
  total_tokens: number;
}

// Legacy flat response for backward compatibility
export interface FlatHistoryResponse {
  items: HistoryTask[];
  total: number;
  page: number;
  size: number;
}

export interface HistoryApiOptions {
  grouped?: boolean; // New parameter to control response format
  include_tasks?: boolean; // Whether to include individual tasks in groups
}