@codeguide/core 0.0.28 → 0.0.33

package/services/codespace/codespace-types.ts

@@ -93,11 +93,17 @@ export interface TechnicalDocument {
   }
 }
 
+export interface TaskMetadata {
+  job_id?: string
+  completed_at?: string
+  processing_duration_ms?: number
+}
+
 export interface CodespaceTaskData {
   id: string
   codespace_task_id: string | null
   project_id: string
-  project_repository_id: string
+  project_repository_id: string | null
   user_id: string
   status: string
   progress: string
@@ -115,14 +121,18 @@ export interface CodespaceTaskData {
   work_completed_at: string | null
   estimated_completion_time: string | null
   ai_implementation_plan: string | null
-  metadata: any
+  metadata: TaskMetadata | null
   model_id: string | null
   execution_mode: string
   context_data: any
-  final_report_popup_state: string
+  final_report_popup_state: 'not_ready' | 'open' | 'closed'
   technical_document: TechnicalDocument | null
-  model: any
-  task_models: any[]
+  ai_questionnaire: Record<string, string> | null
+  model: TaskModel | null
+  task_models: TaskModelEntry[]
+  docs_url: string | null
+  github_token: string | null
+  attachments: TaskAttachment[] | null
 }
 
 export interface GetCodespaceTaskResponse {
@@ -130,11 +140,31 @@ export interface GetCodespaceTaskResponse {
   data: CodespaceTaskData
 }
 
-export interface GetProjectTasksByCodespaceResponse {
+// Codespace Project Task interface for the response structure
+export interface CodespaceProjectTask {
+  id: string
+  title: string
+  description: string
+  details: string
+  status: string
+  test_strategy: string
+  priority: string
+  ordinal: number
+  task_group_id: string
+  parent_task_id: string
+  ai_result: string
+  created_at: string
+  user_id: string
+  subtasks: CodespaceProjectTask[]
+}
+
+export interface CodespaceProjectTaskListResponse {
   status: string
-  data: any[] // Will be defined based on the actual response structure
+  data: CodespaceProjectTask[]
 }
 
+export interface GetProjectTasksByCodespaceResponse extends CodespaceProjectTaskListResponse {}
+
 export interface CreateBackgroundCodespaceTaskRequest extends CreateCodespaceTaskRequestV2 {}
 
 export interface CreateBackgroundCodespaceTaskResponse extends CreateCodespaceTaskResponseV2 {}
@@ -150,12 +180,7 @@ export interface GetCodespaceTasksByProjectRequest {
 }
 
 // Response for getting codespace tasks by project
-export interface GetCodespaceTasksByProjectResponse {
-  status: string
-  data: CodespaceTaskData[]
-  total_count: number
-  message: string
-}
+export interface GetCodespaceTasksByProjectResponse extends GetCodespaceTasksCommonResponse {}
 
 // Response for getting detailed codespace task with relations
 export interface CodespaceTaskDetailedResponse {
@@ -248,3 +273,260 @@ export type CodespaceModelsError =
   | CodespaceModelNotFoundError
   | AuthenticationRequiredError
   | CodespaceModelsFetchError
+
+// ============================================================================
+// Codespace Tasks with Model Information Types
+// ============================================================================
+
+export interface AttachmentResponse {
+  id: string
+  filename: string
+  file_data: string
+  mime_type: string
+  file_size: number
+  description?: string
+  created_at: string
+}
+
+export interface CodespaceTaskModelInDB {
+  id: string
+  created_at: string
+  codespace_task_id: string
+  model_id: string
+  model_name?: string
+  model_key?: string
+  provider_id?: string
+  provider_name?: string
+  execution_mode?: string
+}
+
+export interface CodespaceTasksListResponse extends GetCodespaceTasksCommonResponse {}
+
+// Common response interface for all paginated codespace task lists
+export interface GetCodespaceTasksCommonResponse {
+  status: string
+  data: CodespaceTaskData[]
+  total_count: number
+  message: string
+}
+
+
+// ============================================================================
+// GET /codespace/tasks Endpoint Types
+// ============================================================================
+
+// Request parameters for getting codespace tasks
+export interface GetCodespaceTasksRequest {
+  task_status?: 'completed' | 'in_progress' | 'failed'
+  project_id?: string
+  limit?: number
+  offset?: number
+  sort_by?: 'created_at' | 'updated_at' | 'status' | 'title'
+  sort_order?: 'asc' | 'desc'
+}
+
+// Attachment data structure for task response
+export interface TaskAttachment {
+  id: string
+  codespace_task_id: string
+  filename: string
+  file_url: string
+  file_type: string
+  file_size: number
+  created_at: string
+}
+
+// Model information for task response
+export interface TaskModel {
+  id: string
+  created_at: string
+  key: string
+  name: string
+  provider_id: string
+  base_url: string | null
+  completion_base_url: string | null
+  execution_mode: string
+  logo_src: string | null
+  provider: {
+    id: string
+    created_at: string
+    name: string
+    key: string
+    logo_src: string | null
+  }
+}
+
+// Task model junction table entry
+export interface TaskModelEntry {
+  id: string
+  codespace_task_id: string
+  codespace_model_id: string
+  created_at: string
+}
+
+// Main task data structure for /codespace/tasks response
+// Uses the same CodespaceTaskData interface defined above
+
+// Response for GET /codespace/tasks endpoint
+export interface GetCodespaceTasksResponse extends GetCodespaceTasksCommonResponse {}
+
+// ============================================================================
+// GET /tasks/by-codespace-id/{codespace_task_id} Endpoint Types
+// ============================================================================
+
+// Request parameters for GET /tasks/by-codespace-id/{codespace_task_id} endpoint
+export interface GetTasksByCodespaceIdRequest {
+  codespace_task_id: string
+  limit?: number // Maximum number of tasks to return (default: 50, max: 100)
+  offset?: number // Number of tasks to skip for pagination (default: 0)
+  sort_by?: 'created_at' | 'updated_at' | 'status' | 'title' // Field to sort by (default: created_at)
+  sort_order?: 'asc' | 'desc' // Sort order (default: desc)
+}
+
+// Response for GET /tasks/by-codespace-id/{codespace_task_id} endpoint
+export interface GetTasksByCodespaceIdResponse {
+  status: string
+  data: CodespaceTaskData[]
+  total_count: number
+  message: string
+}
+
+// ============================================================================
+// Final Report Popup State Types
+// ============================================================================
+
+export interface UpdateFinalReportPopupStateRequest {
+  final_report_popup_state: 'not_ready' | 'open' | 'closed'
+}
+
+export interface UpdateFinalReportPopupStateResponse {
+  status: string
+  message: string
+  codespace_task_id: string
+  final_report_popup_state: 'not_ready' | 'open' | 'closed'
+}
+
+// ============================================================================
+// Codespace Task Logs Types
+// ============================================================================
+
+// Log type union for type safety
+export type CodespaceLogType = 'thinking' | 'coding' | 'info' | 'error' | 'success'
+
+// Single log entry structure
+export interface CodespaceTaskLog {
+  id: string
+  codespace_task_id: string
+  step_name: string
+  log_type: CodespaceLogType
+  message: string
+  created_at: string // ISO timestamp
+  progress_percentage?: number // 0-100
+  metadata?: Record<string, any>
+}
+
+// Request parameters for getting paginated logs
+export interface GetCodespaceTaskLogsRequest {
+  codespace_task_id: string
+  limit?: number // 1-500, default: 50
+  offset?: number // default: 0
+  log_type?: CodespaceLogType // Filter by log type
+  step_name?: string // Filter by step name (partial matching)
+  search?: string // Search in message content
+  sort_by?: 'created_at' | 'step_name' | 'log_type' // Sort field, default: created_at
+  sort_order?: 'asc' | 'desc' // Sort order, default: desc
+  since?: string // Get logs after timestamp (ISO format)
+}
+
+// Response for paginated logs request
+export interface CodespaceTaskLogsResponse {
+  status: string
+  data: CodespaceTaskLog[]
+  total_count: number
+  has_more: boolean
+  next_offset?: number
+  message: string
+}
+
+// Request parameters for streaming logs
+export interface StreamCodespaceTaskLogsRequest {
+  codespace_task_id: string
+  since?: string // Start from timestamp (ISO format)
+  timeout?: number // Stream timeout in seconds (30-1800, default: 300)
+}
+
+// Event types for streaming (for TypeScript interfaces)
+export interface StreamLogEvent {
+  event: 'log'
+  data: CodespaceTaskLog
+}
+
+export interface StreamHeartbeatEvent {
+  event: 'heartbeat'
+  data: {
+    timestamp: string
+  }
+}
+
+export interface StreamCompleteEvent {
+  event: 'complete'
+  data: {
+    message: string
+  }
+}
+
+export interface StreamTimeoutEvent {
+  event: 'timeout'
+  data: {
+    message: string
+  }
+}
+
+export interface StreamErrorEvent {
+  event: 'error'
+  data: {
+    error: string
+  }
+}
+
+// Union type for all possible stream events
+export type CodespaceLogStreamEvent =
+  | StreamLogEvent
+  | StreamHeartbeatEvent
+  | StreamCompleteEvent
+  | StreamTimeoutEvent
+  | StreamErrorEvent
+
+// ============================================================================
+// Project Summary Endpoint Types
+// ============================================================================
+
+// Request parameters for project codespace summary
+export interface GetCodespaceProjectSummaryRequest {
+  project_id: string
+}
+
+// Status summary interface
+export interface CodespaceStatusSummary {
+  pending: number
+  in_progress: number
+  completed: number
+  failed: number
+  blocked: number
+}
+
+// Response data structure for project summary
+export interface CodespaceProjectSummaryData {
+  project_id: string
+  total_codespace_tasks: number
+  status_summary: CodespaceStatusSummary
+  latest_task_created_at: string
+}
+
+// Response for project codespace summary endpoint
+export interface GetCodespaceProjectSummaryResponse {
+  status: string
+  data: CodespaceProjectSummaryData
+  message: string
+}
+

package/services/codespace/index.ts

@@ -13,6 +13,8 @@ export type {
   CodespaceTaskData,
   TechnicalDocument,
   GetProjectTasksByCodespaceResponse,
+  CodespaceProjectTask,
+  CodespaceProjectTaskListResponse,
   CodespaceQuestionnaireRequest,
   CodespaceQuestionnaireResponse,
   // Codespace Models Types
@@ -25,5 +27,23 @@ export type {
   GetLLMModelProvidersResponse,
   GetLLMModelProviderResponse,
   GetModelsByProviderResponse,
-  CodespaceModelsError
+  CodespaceModelsError,
+  // Final Report Popup State Types
+  UpdateFinalReportPopupStateRequest,
+  UpdateFinalReportPopupStateResponse,
+  // Codespace Task Logs Types
+  GetCodespaceTaskLogsRequest,
+  CodespaceTaskLogsResponse,
+  StreamCodespaceTaskLogsRequest,
+  CodespaceTaskLog,
+  CodespaceLogType,
+  CodespaceLogStreamEvent,
+  // GET /tasks/by-codespace-id Types
+  GetTasksByCodespaceIdRequest,
+  GetTasksByCodespaceIdResponse,
+  // Project Summary Types
+  GetCodespaceProjectSummaryRequest,
+  GetCodespaceProjectSummaryResponse,
+  CodespaceStatusSummary,
+  CodespaceProjectSummaryData
 } from './codespace-types'

package/services/index.ts

@@ -20,6 +20,7 @@ export { CodespaceService } from './codespace'
 export { ExternalTokenService } from './external-tokens'
 export { SecurityKeysService } from './security-keys'
 export { UserService } from './users'
+export { StarterKitsService } from './starter-kits'
 
 // Re-export all types for convenience
 export * from './generation'
@@ -34,3 +35,4 @@ export * from './codespace'
 export * from './external-tokens'
 export * from './security-keys'
 export * from './users'
+export * from './starter-kits'

package/services/projects/README.md

@@ -72,14 +72,20 @@ interface PaginatedProjectsRequest {
 ```typescript
 interface ProjectRepository {
   id: string
-  project_id: string
+  name: string
   repo_url: string
   branch: string
+  project_id: string
+  user_id: string
+  files_processed: number
+  total_characters: number
+  total_lines: number
+  total_files_found: number
+  total_directories: number
   author: string
-  name: string
-  connection_status: 'pending' | 'connected' | 'failed'
+  estimated_tokens: number
+  estimated_size_bytes: number
   created_at: string
-  updated_at: string
 }
 ```
 
@@ -90,18 +96,29 @@ interface Project {
   id: string
   title: string
   description: string
-  user_id: string
+  status: string
+  category_id: string
+  starter_kit_id?: string
+  ai_questionaire?: {
+    experience_level?: string
+    timeline?: string
+    team_size?: number
+  }
+  tools_selected?: string[]
+  project_outline?: {
+    features?: string[]
+    architecture?: string
+  }
+  codie_tool_id?: string
+  existing_project_repo_url?: string | null
   created_at: string
   updated_at: string
+  user_id: string
   project_documents: ProjectDocument[]
-  project_repositories: ProjectRepository[] // Added for repository information
   category?: Category
+  starter_kit?: StarterKitReference
   codie_tool?: CodieTool
-  github_url?: string
-  status?: string
-  tools_selected?: string[]
-  ai_questionaire?: Record<string, any>
-  project_outline?: Record<string, any>
+  project_repositories: ProjectRepository[]
 }
 ```
 
@@ -171,33 +188,89 @@ const isProjectInFilteredResults = updatedProjects.some(
 
 ## Response Format
 
-The API response includes project data with repository information:
+The API response includes comprehensive project data with repository information, categories, starter kits, and codie tools:
 
 ```json
 {
   "status": "success",
-  "data": [
-    {
-      "id": "project-uuid",
-      "title": "My Project",
-      "description": "Project description",
-      "project_repositories": [
-        {
-          "id": "repo-uuid",
-          "project_id": "project-uuid",
-          "repo_url": "https://github.com/user/repo",
-          "branch": "main",
-          "author": "user",
-          "name": "repo",
-          "connection_status": "connected",
-          "created_at": "2023-01-01T00:00:00Z",
-          "updated_at": "2023-01-01T00:00:00Z"
-        }
-      ],
-      "created_at": "2023-01-01T00:00:00Z",
-      "updated_at": "2023-01-01T00:00:00Z"
-    }
-  ]
+  "data": {
+    "id": "550e8400-e29b-41d4-a716-446655440000",
+    "title": "E-commerce Platform",
+    "description": "A full-stack e-commerce platform with React and Node.js",
+    "status": "in_progress",
+    "category_id": "cat_123",
+    "starter_kit_id": "starter_456",
+    "ai_questionaire": {
+      "experience_level": "intermediate",
+      "timeline": "3 months",
+      "team_size": 2
+    },
+    "tools_selected": ["react", "nodejs", "postgresql", "docker"],
+    "project_outline": {
+      "features": ["user authentication", "product catalog", "shopping cart", "payment integration"],
+      "architecture": "microservices"
+    },
+    "codie_tool_id": "tool_789",
+    "existing_project_repo_url": null,
+    "created_at": "2023-10-01T10:00:00Z",
+    "updated_at": "2023-10-15T14:30:00Z",
+    "user_id": "user_abc123",
+    "project_documents": [
+      {
+        "id": "doc_111",
+        "project_id": "550e8400-e29b-41d4-a716-446655440000",
+        "user_id": "user_abc123",
+        "title": "API Documentation",
+        "document_type": "api",
+        "description": "REST API endpoints documentation",
+        "content": "## API Documentation\n\n### Authentication\n...",
+        "custom_document_type": "api_docs",
+        "last_action": "document_creation",
+        "is_current_version": true,
+        "status": "completed",
+        "created_at": "2023-10-05T09:00:00Z",
+        "updated_at": "2023-10-05T09:00:00Z"
+      }
+    ],
+    "category": {
+      "id": "cat_123",
+      "name": "Web Development",
+      "description": "Full-stack web application projects"
+    },
+    "starter_kit": {
+      "id": "starter_456",
+      "name": "React E-commerce Starter",
+      "description": "A complete e-commerce starter kit with React, Node.js, and PostgreSQL"
+    },
+    "codie_tool": {
+      "id": "tool_789",
+      "name": "Code Generator Pro",
+      "description": "AI-powered code generation tool",
+      "type": "code_generator",
+      "api_endpoint": "https://api.example.com/generate",
+      "created_at": "2023-09-01T00:00:00Z",
+      "updated_at": "2023-09-15T12:00:00Z"
+    },
+    "project_repositories": [
+      {
+        "id": "repo_333",
+        "name": "ecommerce-platform",
+        "repo_url": "https://github.com/user/ecommerce-platform",
+        "branch": "main",
+        "project_id": "550e8400-e29b-41d4-a716-446655440000",
+        "user_id": "user_abc123",
+        "files_processed": 150,
+        "total_characters": 125000,
+        "total_lines": 4500,
+        "total_files_found": 180,
+        "total_directories": 25,
+        "author": "John Doe",
+        "estimated_tokens": 150000,
+        "estimated_size_bytes": 512000,
+        "created_at": "2023-10-02T11:00:00Z"
+      }
+    ]
+  }
 }
 ```