@codeguide/core 0.0.29 → 0.0.33

package/__tests__/services/codespace/codespace-v2.test.ts

@@ -3,6 +3,8 @@ import {
   CreateCodespaceTaskRequestV2,
   CreateBackgroundCodespaceTaskRequest,
   ModelApiKey,
+  GetCodespaceProjectSummaryRequest,
+  GetCodespaceProjectSummaryResponse,
 } from '../../../services/codespace/codespace-types'
 import { APIServiceConfig } from '../../../types'
 import axios from 'axios'
@@ -268,4 +270,55 @@ describe('CodespaceService - V2 Task Endpoints', () => {
       expect(result).toEqual(mockResponse)
     })
   })
+
+  describe('getCodespaceProjectSummary', () => {
+    it('should get project codespace summary successfully', async () => {
+      const request: GetCodespaceProjectSummaryRequest = {
+        project_id: 'project-123',
+      }
+
+      const mockResponse: GetCodespaceProjectSummaryResponse = {
+        status: 'success',
+        data: {
+          project_id: 'project-123',
+          total_codespace_tasks: 25,
+          status_summary: {
+            pending: 5,
+            in_progress: 8,
+            completed: 10,
+            failed: 2,
+            blocked: 0,
+          },
+          latest_task_created_at: '2025-11-16T10:30:00Z',
+        },
+        message: 'Retrieved summary for 25 codespace tasks in project project-123',
+      }
+
+      mockAxios.onGet('/codespace/project/project-123/summary').reply(200, mockResponse)
+
+      const result = await codespaceService.getCodespaceProjectSummary(request)
+
+      expect(result).toEqual(mockResponse)
+    })
+
+    it('should throw error when project_id is missing', async () => {
+      const invalidRequest = {} as GetCodespaceProjectSummaryRequest
+
+      await expect(
+        codespaceService.getCodespaceProjectSummary(invalidRequest)
+      ).rejects.toThrow('project_id is required')
+    })
+
+    it('should handle API errors properly', async () => {
+      const request: GetCodespaceProjectSummaryRequest = {
+        project_id: 'project-123',
+      }
+
+      mockAxios.onGet('/codespace/project/project-123/summary').reply(404, {
+        detail: 'Project not found',
+      })
+
+      await expect(codespaceService.getCodespaceProjectSummary(request)).rejects.toThrow()
+    })
+  })
 })

package/__tests__/services/usage/usage-service.test.ts

@@ -146,9 +146,7 @@ describe('UsageService', () => {
         model_key: 'gpt-4',
       }
 
-      mockAxios
-        .onGet('/usage/credit-check?model_key=gpt-4&input_tokens=100')
-        .reply(200, response)
+      mockAxios.onGet('/usage/credit-check?model_key=gpt-4&input_tokens=100').reply(200, response)
 
       const result = await usageService.checkCredits(params)
 
@@ -156,7 +154,6 @@ describe('UsageService', () => {
     })
   })
 
-  
   describe('getAuthorization', () => {
     it('should get authorization info successfully', async () => {
       const response: AuthorizationResponse = {
@@ -417,26 +414,12 @@ describe('UsageService', () => {
   describe('getCodespaceTaskUsage', () => {
     it('should get codespace task usage successfully', async () => {
       const response: CodespaceTaskUsageResponse = {
-        codespace_task_id: 'task123',
-        total_usage: {
-          total_input_tokens: 200,
-          total_output_tokens: 100,
-          total_call_seconds: 4,
-          total_cost: 0.1,
+        status: 'success',
+        data: {
+          total_records: 2,
+          total_credits_consumed: 49.428799,
+          latest_usage: '2025-11-24T07:50:58.150274+00:00',
         },
-        usage_records: [
-          {
-            id: 'usage123',
-            codespace_task_id: 'task123',
-            user_id: 'user123',
-            model_key: 'gpt-4',
-            input_tokens: 100,
-            output_tokens: 50,
-            call_seconds: 2,
-            cost_amount: 0.05,
-            created_at: '2024-01-01T00:00:00Z',
-          },
-        ],
       }
 
       mockAxios.onGet('/usage/codespace/task/task123').reply(200, response)
@@ -485,7 +468,7 @@ describe('UsageService', () => {
   describe('getDashboardAnalytics', () => {
     it('should get dashboard analytics with period parameter', async () => {
       const params: DashboardAnalyticsRequest = {
-        period: '7d'
+        period: '7d',
       }
 
       const response: DashboardAnalyticsResponse = {
@@ -494,7 +477,7 @@ describe('UsageService', () => {
           period: {
             start: '2024-01-25',
             end: '2024-01-31',
-            label: '7d'
+            label: '7d',
           },
           daily_usage: [
             {
@@ -502,30 +485,30 @@ describe('UsageService', () => {
               credits_consumed: 1250,
               cost_usd: 3.75,
               requests_count: 15,
-              average_credits_per_request: 83.33
-            }
+              average_credits_per_request: 83.33,
+            },
           ],
           totals: {
             credits_consumed: 13870,
             cost_usd: 41.61,
-            requests_count: 142
+            requests_count: 142,
           },
           averages: {
             daily_credits: 1981.43,
-            daily_requests: 20.29
+            daily_requests: 20.29,
           },
           trends: {
             credits_consumed: 15.7,
-            requests_count: 8.3
+            requests_count: 8.3,
           },
           top_services: [
             {
               service_type: 'docs',
               credits_consumed: 5230,
-              requests_count: 58
-            }
-          ]
-        }
+              requests_count: 58,
+            },
+          ],
+        },
       }
 
       mockAxios.onGet('/usage/dashboard/analytics?period=7d').reply(200, response)
@@ -539,7 +522,7 @@ describe('UsageService', () => {
       const params: DashboardAnalyticsRequest = {
         start_date: '2024-01-01',
         end_date: '2024-01-31',
-        service_type: 'docs'
+        service_type: 'docs',
       }
 
       const response: DashboardAnalyticsResponse = {
@@ -548,33 +531,37 @@ describe('UsageService', () => {
           period: {
             start: '2024-01-01',
             end: '2024-01-31',
-            label: 'custom'
+            label: 'custom',
           },
           daily_usage: [],
           totals: {
             credits_consumed: 5000,
             cost_usd: 15.0,
-            requests_count: 45
+            requests_count: 45,
           },
           averages: {
             daily_credits: 161.29,
-            daily_requests: 1.45
+            daily_requests: 1.45,
           },
           trends: {
             credits_consumed: 12.5,
-            requests_count: 5.2
+            requests_count: 5.2,
           },
           top_services: [
             {
               service_type: 'docs',
               credits_consumed: 5000,
-              requests_count: 45
-            }
-          ]
-        }
+              requests_count: 45,
+            },
+          ],
+        },
       }
 
-      mockAxios.onGet('/usage/dashboard/analytics?start_date=2024-01-01&end_date=2024-01-31&service_type=docs').reply(200, response)
+      mockAxios
+        .onGet(
+          '/usage/dashboard/analytics?start_date=2024-01-01&end_date=2024-01-31&service_type=docs'
+        )
+        .reply(200, response)
 
       const result = await usageService.getDashboardAnalytics(params)
 
@@ -588,24 +575,24 @@ describe('UsageService', () => {
           period: {
             start: '2024-01-01',
             end: '2024-01-07',
-            label: '7d'
+            label: '7d',
           },
           daily_usage: [],
           totals: {
             credits_consumed: 1000,
             cost_usd: 3.0,
-            requests_count: 10
+            requests_count: 10,
           },
           averages: {
             daily_credits: 142.86,
-            daily_requests: 1.43
+            daily_requests: 1.43,
           },
           trends: {
             credits_consumed: 5.0,
-            requests_count: 2.0
+            requests_count: 2.0,
           },
-          top_services: []
-        }
+          top_services: [],
+        },
       }
 
       mockAxios.onGet('/usage/dashboard/analytics').reply(200, response)
@@ -622,7 +609,7 @@ describe('UsageService', () => {
         page: 1,
         page_size: 25,
         sort_by: 'credits_consumed',
-        sort_order: 'desc'
+        sort_order: 'desc',
       }
 
       const response: UsageDetailsResponse = {
@@ -636,8 +623,8 @@ describe('UsageService', () => {
             usage_type: 'output_tokens',
             units_consumed: 1250,
             credits_consumed: 156,
-            cost_amount: 0.468
-          }
+            cost_amount: 0.468,
+          },
         ],
         pagination: {
           page: 1,
@@ -645,17 +632,21 @@ describe('UsageService', () => {
           total_count: 142,
           total_pages: 6,
           has_next: true,
-          has_prev: false
+          has_prev: false,
         },
         filters: {
           period: null,
           start_date: null,
           end_date: null,
-          service_type: null
-        }
+          service_type: null,
+        },
       }
 
-      mockAxios.onGet('/usage/dashboard/details?page=1&page_size=25&sort_by=credits_consumed&sort_order=desc').reply(200, response)
+      mockAxios
+        .onGet(
+          '/usage/dashboard/details?page=1&page_size=25&sort_by=credits_consumed&sort_order=desc'
+        )
+        .reply(200, response)
 
       const result = await usageService.getUsageDetails(params)
 
@@ -665,7 +656,7 @@ describe('UsageService', () => {
     it('should get usage details with filtering parameters', async () => {
       const params: UsageDetailsRequest = {
         period: '1m',
-        service_type: 'chat'
+        service_type: 'chat',
       }
 
       const response: UsageDetailsResponse = {
@@ -679,8 +670,8 @@ describe('UsageService', () => {
             usage_type: 'input_tokens',
             units_consumed: 890,
             credits_consumed: 89,
-            cost_amount: null
-          }
+            cost_amount: null,
+          },
         ],
         pagination: {
           page: 1,
@@ -688,14 +679,14 @@ describe('UsageService', () => {
           total_count: 25,
           total_pages: 1,
           has_next: false,
-          has_prev: false
+          has_prev: false,
         },
         filters: {
           period: '1m',
           start_date: null,
           end_date: null,
-          service_type: 'chat'
-        }
+          service_type: 'chat',
+        },
       }
 
       mockAxios.onGet('/usage/dashboard/details?period=1m&service_type=chat').reply(200, response)
@@ -709,7 +700,7 @@ describe('UsageService', () => {
   describe('getUsageSummary', () => {
     it('should get usage summary dashboard with period parameter', async () => {
       const params = {
-        period: '7d' as const
+        period: '7d' as const,
       }
 
       const response: UsageSummaryResponse = {
@@ -718,23 +709,23 @@ describe('UsageService', () => {
           current_period: {
             credits_consumed: 13870,
             cost_usd: 41.61,
-            requests_count: 142
+            requests_count: 142,
           },
           previous_period: {
             credits_consumed: 11990,
             cost_usd: 35.97,
-            requests_count: 131
+            requests_count: 131,
           },
           billing_cycle: {
             total_allotted: 50000,
             total_consumed: 28450,
-            remaining_credits: 21550
+            remaining_credits: 21550,
           },
           utilization_percentage: 56.9,
           remaining_credits: 21550,
           daily_average: 1981.43,
-          projected_monthly: 59443
-        }
+          projected_monthly: 59443,
+        },
       }
 
       mockAxios.onGet('/usage/dashboard/summary?period=7d').reply(200, response)
@@ -747,7 +738,7 @@ describe('UsageService', () => {
     it('should get usage summary dashboard with custom date range', async () => {
       const params = {
         start_date: '2024-01-01',
-        end_date: '2024-01-31'
+        end_date: '2024-01-31',
       }
 
       const response: UsageSummaryResponse = {
@@ -756,26 +747,28 @@ describe('UsageService', () => {
           current_period: {
             credits_consumed: 25000,
             cost_usd: 75.0,
-            requests_count: 300
+            requests_count: 300,
           },
           previous_period: {
             credits_consumed: 22000,
             cost_usd: 66.0,
-            requests_count: 275
+            requests_count: 275,
           },
           billing_cycle: {
             total_allotted: 50000,
             total_consumed: 47000,
-            remaining_credits: 3000
+            remaining_credits: 3000,
           },
           utilization_percentage: 94.0,
           remaining_credits: 3000,
           daily_average: 806.45,
-          projected_monthly: 25000
-        }
+          projected_monthly: 25000,
+        },
       }
 
-      mockAxios.onGet('/usage/dashboard/summary?start_date=2024-01-01&end_date=2024-01-31').reply(200, response)
+      mockAxios
+        .onGet('/usage/dashboard/summary?start_date=2024-01-01&end_date=2024-01-31')
+        .reply(200, response)
 
       const result = await usageService.getUsageSummary(params)
 
@@ -786,7 +779,7 @@ describe('UsageService', () => {
   describe('getServiceBreakdown', () => {
     it('should get service breakdown with period parameter', async () => {
       const params: ServiceBreakdownRequest = {
-        period: '7d'
+        period: '7d',
       }
 
       const response: ServiceBreakdownResponse = {
@@ -795,7 +788,7 @@ describe('UsageService', () => {
           period: {
             start: '2024-01-25',
             end: '2024-01-31',
-            label: '7d'
+            label: '7d',
           },
           services: [
             {
@@ -804,7 +797,7 @@ describe('UsageService', () => {
               percentage: 37.71,
               cost_usd: 15.69,
               requests_count: 58,
-              trend: 12.5
+              trend: 12.5,
             },
             {
               service_type: 'chat',
@@ -812,12 +805,12 @@ describe('UsageService', () => {
               percentage: 29.71,
               cost_usd: 12.36,
               requests_count: 47,
-              trend: -5.2
-            }
+              trend: -5.2,
+            },
           ],
           total_credits: 13870,
-          total_cost: 41.61
-        }
+          total_cost: 41.61,
+        },
       }
 
       mockAxios.onGet('/usage/dashboard/services?period=7d').reply(200, response)
@@ -830,7 +823,7 @@ describe('UsageService', () => {
     it('should get service breakdown with custom date range', async () => {
       const params: ServiceBreakdownRequest = {
         start_date: '2024-01-01',
-        end_date: '2024-01-31'
+        end_date: '2024-01-31',
       }
 
       const response: ServiceBreakdownResponse = {
@@ -839,7 +832,7 @@ describe('UsageService', () => {
           period: {
             start: '2024-01-01',
             end: '2024-01-31',
-            label: 'custom'
+            label: 'custom',
           },
           services: [
             {
@@ -848,15 +841,17 @@ describe('UsageService', () => {
               percentage: 60.0,
               cost_usd: 45.0,
               requests_count: 25,
-              trend: 28.4
-            }
+              trend: 28.4,
+            },
           ],
           total_credits: 25000,
-          total_cost: 75.0
-        }
+          total_cost: 75.0,
+        },
       }
 
-      mockAxios.onGet('/usage/dashboard/services?start_date=2024-01-01&end_date=2024-01-31').reply(200, response)
+      mockAxios
+        .onGet('/usage/dashboard/services?start_date=2024-01-01&end_date=2024-01-31')
+        .reply(200, response)
 
       const result = await usageService.getServiceBreakdown(params)
 
@@ -870,21 +865,21 @@ describe('UsageService', () => {
           period: {
             start: '2024-01-01',
             end: '2024-01-07',
-            label: '7d'
+            label: '7d',
           },
           services: [
             {
               service_type: 'api',
               credits_consumed: 700,
               percentage: 100.0,
-              cost_usd: 2.10,
+              cost_usd: 2.1,
               requests_count: 5,
-              trend: 0.0
-            }
+              trend: 0.0,
+            },
           ],
           total_credits: 700,
-          total_cost: 2.10
-        }
+          total_cost: 2.1,
+        },
       }
 
       mockAxios.onGet('/usage/dashboard/services').reply(200, response)

package/dist/services/codespace/codespace-service.d.ts

@@ -1,5 +1,5 @@
 import { BaseService } from '../base/base-service';
-import { GenerateTaskTitleRequest, GenerateTaskTitleResponse, CreateCodespaceTaskRequest, CreateCodespaceTaskResponse, CreateCodespaceTaskRequestV2, CreateCodespaceTaskResponseV2, CreateBackgroundCodespaceTaskRequest, CreateBackgroundCodespaceTaskResponse, GetCodespaceTaskResponse, GetProjectTasksByCodespaceResponse, GetCodespaceTasksByProjectRequest, GetCodespaceTasksByProjectResponse, CodespaceTaskDetailedResponse, CodespaceQuestionnaireRequest, CodespaceQuestionnaireResponse, GetCodespaceModelsQuery, GetCodespaceModelsResponse, GetCodespaceModelResponse, GetLLMModelProvidersResponse, GetLLMModelProviderResponse, GetModelsByProviderResponse, GetCodespaceTasksRequest, GetCodespaceTasksResponse, GetTasksByCodespaceIdRequest, GetTasksByCodespaceIdResponse, UpdateFinalReportPopupStateRequest, UpdateFinalReportPopupStateResponse, GetCodespaceTaskLogsRequest, CodespaceTaskLogsResponse, StreamCodespaceTaskLogsRequest, CodespaceLogStreamEvent } from './codespace-types';
+import { GenerateTaskTitleRequest, GenerateTaskTitleResponse, CreateCodespaceTaskRequest, CreateCodespaceTaskResponse, CreateCodespaceTaskRequestV2, CreateCodespaceTaskResponseV2, CreateBackgroundCodespaceTaskRequest, CreateBackgroundCodespaceTaskResponse, GetCodespaceTaskResponse, GetProjectTasksByCodespaceResponse, GetCodespaceTasksByProjectRequest, GetCodespaceTasksByProjectResponse, CodespaceTaskDetailedResponse, CodespaceQuestionnaireRequest, CodespaceQuestionnaireResponse, GetCodespaceModelsQuery, GetCodespaceModelsResponse, GetCodespaceModelResponse, GetLLMModelProvidersResponse, GetLLMModelProviderResponse, GetModelsByProviderResponse, GetCodespaceTasksRequest, GetCodespaceTasksResponse, GetTasksByCodespaceIdRequest, GetTasksByCodespaceIdResponse, UpdateFinalReportPopupStateRequest, UpdateFinalReportPopupStateResponse, GetCodespaceTaskLogsRequest, CodespaceTaskLogsResponse, StreamCodespaceTaskLogsRequest, CodespaceLogStreamEvent, GetCodespaceProjectSummaryRequest, GetCodespaceProjectSummaryResponse } from './codespace-types';
 export declare class CodespaceService extends BaseService {
     generateTaskTitle(request: GenerateTaskTitleRequest): Promise<GenerateTaskTitleResponse>;
     generateQuestionnaire(request: CodespaceQuestionnaireRequest): Promise<CodespaceQuestionnaireResponse>;
@@ -9,6 +9,15 @@ export declare class CodespaceService extends BaseService {
     getCodespaceTask(codespaceTaskId: string): Promise<GetCodespaceTaskResponse>;
     getProjectTasksByCodespace(codespaceTaskId: string): Promise<GetProjectTasksByCodespaceResponse>;
     getCodespaceTasksByProject(params: GetCodespaceTasksByProjectRequest): Promise<GetCodespaceTasksByProjectResponse>;
+    /**
+     * Get aggregated statistics for all codespace tasks within a project
+     *
+     * GET /codespace/project/{project_id}/summary
+     *
+     * @param params - Request parameters including project_id
+     * @returns Promise resolving to aggregated task statistics by status
+     */
+    getCodespaceProjectSummary(params: GetCodespaceProjectSummaryRequest): Promise<GetCodespaceProjectSummaryResponse>;
     getCodespaceTaskDetailed(codespaceTaskId: string): Promise<CodespaceTaskDetailedResponse>;
     /**
      * Get tasks by codespace task ID with optional pagination and sorting
@@ -31,7 +40,7 @@ export declare class CodespaceService extends BaseService {
     /**
      * Update the final report popup state for a codespace task
      *
-     * PATCH /task/{codespace_task_id}/final-report-popup-state
+     * PATCH /codespace/task/{codespace_task_id}/final-report-popup-state
      *
      * @param codespaceTaskId - The ID of the codespace task
      * @param request - The request body containing the new popup state

package/dist/services/codespace/codespace-service.js

@@ -51,6 +51,21 @@ class CodespaceService extends base_service_1.BaseService {
         const url = `/codespace/tasks/project/${params.project_id}${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
         return this.get(url);
     }
+    /**
+     * Get aggregated statistics for all codespace tasks within a project
+     *
+     * GET /codespace/project/{project_id}/summary
+     *
+     * @param params - Request parameters including project_id
+     * @returns Promise resolving to aggregated task statistics by status
+     */
+    async getCodespaceProjectSummary(params) {
+        if (!params.project_id) {
+            throw new Error('project_id is required');
+        }
+        const url = `/codespace/project/${params.project_id}/summary`;
+        return this.get(url);
+    }
     async getCodespaceTaskDetailed(codespaceTaskId) {
         if (!codespaceTaskId) {
             throw new Error('codespace_task_id is required');
@@ -82,7 +97,7 @@ class CodespaceService extends base_service_1.BaseService {
         if (params.sort_order) {
             queryParams.append('sort_order', params.sort_order);
         }
-        const url = `/tasks/by-codespace-id/${params.codespace_task_id}${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        const url = `/codespace/tasks/by-codespace-id/${params.codespace_task_id}${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
         return this.get(url);
     }
     /**
@@ -126,7 +141,7 @@ class CodespaceService extends base_service_1.BaseService {
     /**
      * Update the final report popup state for a codespace task
      *
-     * PATCH /task/{codespace_task_id}/final-report-popup-state
+     * PATCH /codespace/task/{codespace_task_id}/final-report-popup-state
      *
      * @param codespaceTaskId - The ID of the codespace task
      * @param request - The request body containing the new popup state
@@ -140,7 +155,7 @@ class CodespaceService extends base_service_1.BaseService {
         if (!['not_ready', 'open', 'closed'].includes(request.final_report_popup_state)) {
             throw new Error('final_report_popup_state must be "not_ready", "open", or "closed"');
         }
-        return this.patch(`/task/${codespaceTaskId}/final-report-popup-state`, request);
+        return this.patch(`/codespace/task/${codespaceTaskId}/final-report-popup-state`, request);
     }
     // ============================================================================
     // Codespace Task Logs Methods

package/dist/services/codespace/codespace-types.d.ts

@@ -390,3 +390,24 @@ export interface StreamErrorEvent {
     };
 }
 export type CodespaceLogStreamEvent = StreamLogEvent | StreamHeartbeatEvent | StreamCompleteEvent | StreamTimeoutEvent | StreamErrorEvent;
+export interface GetCodespaceProjectSummaryRequest {
+    project_id: string;
+}
+export interface CodespaceStatusSummary {
+    pending: number;
+    in_progress: number;
+    completed: number;
+    failed: number;
+    blocked: number;
+}
+export interface CodespaceProjectSummaryData {
+    project_id: string;
+    total_codespace_tasks: number;
+    status_summary: CodespaceStatusSummary;
+    latest_task_created_at: string;
+}
+export interface GetCodespaceProjectSummaryResponse {
+    status: string;
+    data: CodespaceProjectSummaryData;
+    message: string;
+}

package/dist/services/codespace/index.d.ts

@@ -1,3 +1,3 @@
 export { CodespaceService } from './codespace-service';
 export * from './codespace-types';
-export type { CreateCodespaceTaskRequestV2 as CreateCodespaceTaskRequest, CreateCodespaceTaskResponseV2 as CreateCodespaceTaskResponse, CreateBackgroundCodespaceTaskRequest, CreateBackgroundCodespaceTaskResponse, ModelApiKey, Attachment, GetCodespaceTaskResponse, CodespaceTaskData, TechnicalDocument, GetProjectTasksByCodespaceResponse, CodespaceProjectTask, CodespaceProjectTaskListResponse, CodespaceQuestionnaireRequest, CodespaceQuestionnaireResponse, LLMModelProviderInDB, CodespaceModelInDB, CodespaceModelWithProvider, GetCodespaceModelsQuery, GetCodespaceModelsResponse, GetCodespaceModelResponse, GetLLMModelProvidersResponse, GetLLMModelProviderResponse, GetModelsByProviderResponse, CodespaceModelsError, UpdateFinalReportPopupStateRequest, UpdateFinalReportPopupStateResponse, GetCodespaceTaskLogsRequest, CodespaceTaskLogsResponse, StreamCodespaceTaskLogsRequest, CodespaceTaskLog, CodespaceLogType, CodespaceLogStreamEvent, GetTasksByCodespaceIdRequest, GetTasksByCodespaceIdResponse } from './codespace-types';
+export type { CreateCodespaceTaskRequestV2 as CreateCodespaceTaskRequest, CreateCodespaceTaskResponseV2 as CreateCodespaceTaskResponse, CreateBackgroundCodespaceTaskRequest, CreateBackgroundCodespaceTaskResponse, ModelApiKey, Attachment, GetCodespaceTaskResponse, CodespaceTaskData, TechnicalDocument, GetProjectTasksByCodespaceResponse, CodespaceProjectTask, CodespaceProjectTaskListResponse, CodespaceQuestionnaireRequest, CodespaceQuestionnaireResponse, LLMModelProviderInDB, CodespaceModelInDB, CodespaceModelWithProvider, GetCodespaceModelsQuery, GetCodespaceModelsResponse, GetCodespaceModelResponse, GetLLMModelProvidersResponse, GetLLMModelProviderResponse, GetModelsByProviderResponse, CodespaceModelsError, UpdateFinalReportPopupStateRequest, UpdateFinalReportPopupStateResponse, GetCodespaceTaskLogsRequest, CodespaceTaskLogsResponse, StreamCodespaceTaskLogsRequest, CodespaceTaskLog, CodespaceLogType, CodespaceLogStreamEvent, GetTasksByCodespaceIdRequest, GetTasksByCodespaceIdResponse, GetCodespaceProjectSummaryRequest, GetCodespaceProjectSummaryResponse, CodespaceStatusSummary, CodespaceProjectSummaryData } from './codespace-types';

package/dist/services/subscriptions/subscription-service.d.ts

@@ -1,7 +1,12 @@
 import { BaseService } from '../base/base-service';
-import { CurrentSubscriptionResponse, UserSubscriptionsResponse, CancelSubscriptionRequest, CancelSubscriptionResponse } from '../../types';
+import { CurrentSubscriptionResponse, UserSubscriptionsResponse, CancelSubscriptionRequest, CancelSubscriptionResponse, SubscriptionProductsResponse, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse } from '../../types';
 export declare class SubscriptionService extends BaseService {
     constructor(config: any);
+    /**
+     * Create a Stripe checkout session for subscription purchase
+     * POST /subscriptions/create-checkout-session
+     */
+    createCheckoutSession(request: CreateCheckoutSessionRequest): Promise<CreateCheckoutSessionResponse>;
     /**
      * Get the currently active subscription for the authenticated user
      * GET /subscriptions/current
@@ -12,6 +17,11 @@ export declare class SubscriptionService extends BaseService {
      * GET /subscriptions/
      */
     getAllSubscriptions(): Promise<UserSubscriptionsResponse>;
+    /**
+     * Get all available subscription products and their prices
+     * GET /subscriptions/products
+     */
+    getSubscriptionProducts(): Promise<SubscriptionProductsResponse>;
     /**
      * Cancel subscription but keep it active until the end of the current billing period
      * POST /subscriptions/{subscription_id}/cancel

package/dist/services/subscriptions/subscription-service.js

@@ -6,6 +6,13 @@ class SubscriptionService extends base_service_1.BaseService {
     constructor(config) {
         super(config);
     }
+    /**
+     * Create a Stripe checkout session for subscription purchase
+     * POST /subscriptions/create-checkout-session
+     */
+    async createCheckoutSession(request) {
+        return this.post('/subscriptions/create-checkout-session', request);
+    }
     /**
      * Get the currently active subscription for the authenticated user
      * GET /subscriptions/current
@@ -20,6 +27,13 @@ class SubscriptionService extends base_service_1.BaseService {
     async getAllSubscriptions() {
         return this.get('/subscriptions/');
     }
+    /**
+     * Get all available subscription products and their prices
+     * GET /subscriptions/products
+     */
+    async getSubscriptionProducts() {
+        return this.get('/subscriptions/products');
+    }
     /**
      * Cancel subscription but keep it active until the end of the current billing period
      * POST /subscriptions/{subscription_id}/cancel

package/dist/services/usage/usage-types.d.ts

@@ -143,25 +143,24 @@ export interface TrackCodespaceUsageResponse {
     cost_amount: number;
     created_at: string;
 }
+export interface CodespaceTaskUsageData {
+    total_records: number;
+    total_credits_consumed: number;
+    latest_usage: string;
+}
 export interface CodespaceTaskUsageResponse {
-    codespace_task_id: string;
-    total_usage: {
-        total_input_tokens: number;
-        total_output_tokens: number;
-        total_call_seconds: number;
-        total_cost: number;
-    };
-    usage_records: TrackCodespaceUsageResponse[];
+    status: string;
+    data: CodespaceTaskUsageData;
 }
 export interface HealthResponse {
     status: string;
     timestamp: string;
     version: string;
 }
-export type PeriodType = "7d" | "1w" | "1m" | "3m";
-export type ServiceType = "docs" | "chat" | "codespace_task" | "api";
-export type SortOrder = "asc" | "desc";
-export type SortByField = "created_at" | "credits_consumed" | "cost_amount";
+export type PeriodType = '7d' | '1w' | '1m' | '3m';
+export type ServiceType = 'docs' | 'chat' | 'codespace_task' | 'api';
+export type SortOrder = 'asc' | 'desc';
+export type SortByField = 'created_at' | 'credits_consumed' | 'cost_amount';
 export interface DashboardAnalyticsRequest {
     period?: PeriodType;
     start_date?: string;

package/dist/types.d.ts

@@ -108,8 +108,8 @@ export interface Product {
     id: string;
     active: boolean;
     name: string;
-    description: string;
-    image: string;
+    description: string | null;
+    image: string | null;
     metadata: Record<string, any>;
     marketing_features: string[];
     live_mode: boolean;
@@ -140,6 +140,13 @@ export interface UserSubscriptionsResponse {
     status: string;
     data: Subscription[];
 }
+export interface SubscriptionProductsResponse {
+    status: string;
+    data: Array<{
+        product: Product;
+        prices: Price[];
+    }>;
+}
 export interface CancelSubscriptionRequest {
     cancel_at_period_end: boolean;
 }
@@ -148,6 +155,15 @@ export interface CancelSubscriptionResponse {
     message: string;
     data: Subscription;
 }
+export interface CreateCheckoutSessionRequest {
+    price_id: string;
+    success_url: string;
+    cancel_url: string;
+}
+export interface CreateCheckoutSessionResponse {
+    status: string;
+    checkout_url: string;
+}
 export interface CancellationFunnelInitiateRequest {
     subscription_id: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeguide/core",
-  "version": "0.0.29",
+  "version": "0.0.33",
   "description": "Core package for code guidance with programmatic API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,6 +18,7 @@
     "test": "jest --config=jest.config.json",
     "test:watch": "jest --config=jest.config.json --watch",
     "test:coverage": "jest --config=jest.config.json --coverage",
+    "dev:link": "npm run build && npm link",
     "docs:dev": "cd docs && npm run dev",
     "docs:build": "cd docs && npm run build",
     "docs:preview": "cd docs && npm run preview",

package/services/codespace/codespace-service.ts

@@ -36,6 +36,9 @@ import {
   CodespaceTaskLogsResponse,
   StreamCodespaceTaskLogsRequest,
   CodespaceLogStreamEvent,
+  // Project Summary Types
+  GetCodespaceProjectSummaryRequest,
+  GetCodespaceProjectSummaryResponse,
 } from './codespace-types'
 
 export class CodespaceService extends BaseService {
@@ -107,6 +110,25 @@ export class CodespaceService extends BaseService {
     return this.get<GetCodespaceTasksByProjectResponse>(url)
   }
 
+  /**
+   * Get aggregated statistics for all codespace tasks within a project
+   *
+   * GET /codespace/project/{project_id}/summary
+   *
+   * @param params - Request parameters including project_id
+   * @returns Promise resolving to aggregated task statistics by status
+   */
+  async getCodespaceProjectSummary(
+    params: GetCodespaceProjectSummaryRequest
+  ): Promise<GetCodespaceProjectSummaryResponse> {
+    if (!params.project_id) {
+      throw new Error('project_id is required')
+    }
+
+    const url = `/codespace/project/${params.project_id}/summary`
+    return this.get<GetCodespaceProjectSummaryResponse>(url)
+  }
+
   async getCodespaceTaskDetailed(codespaceTaskId: string): Promise<CodespaceTaskDetailedResponse> {
     if (!codespaceTaskId) {
       throw new Error('codespace_task_id is required')
@@ -145,7 +167,7 @@ export class CodespaceService extends BaseService {
       queryParams.append('sort_order', params.sort_order)
     }
 
-    const url = `/tasks/by-codespace-id/${params.codespace_task_id}${
+    const url = `/codespace/tasks/by-codespace-id/${params.codespace_task_id}${
       queryParams.toString() ? `?${queryParams.toString()}` : ''
     }`
 
@@ -193,7 +215,7 @@ export class CodespaceService extends BaseService {
   /**
    * Update the final report popup state for a codespace task
    *
-   * PATCH /task/{codespace_task_id}/final-report-popup-state
+   * PATCH /codespace/task/{codespace_task_id}/final-report-popup-state
    *
    * @param codespaceTaskId - The ID of the codespace task
    * @param request - The request body containing the new popup state
@@ -213,7 +235,7 @@ export class CodespaceService extends BaseService {
     }
 
     return this.patch<UpdateFinalReportPopupStateResponse>(
-      `/task/${codespaceTaskId}/final-report-popup-state`,
+      `/codespace/task/${codespaceTaskId}/final-report-popup-state`,
       request
     )
   }

package/services/codespace/codespace-types.ts

@@ -497,3 +497,36 @@ export type CodespaceLogStreamEvent =
   | 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

@@ -40,5 +40,10 @@ export type {
   CodespaceLogStreamEvent,
   // GET /tasks/by-codespace-id Types
   GetTasksByCodespaceIdRequest,
-  GetTasksByCodespaceIdResponse
+  GetTasksByCodespaceIdResponse,
+  // Project Summary Types
+  GetCodespaceProjectSummaryRequest,
+  GetCodespaceProjectSummaryResponse,
+  CodespaceStatusSummary,
+  CodespaceProjectSummaryData
 } from './codespace-types'

package/services/subscriptions/subscription-service.ts

@@ -4,6 +4,9 @@ import {
   UserSubscriptionsResponse,
   CancelSubscriptionRequest,
   CancelSubscriptionResponse,
+  SubscriptionProductsResponse,
+  CreateCheckoutSessionRequest,
+  CreateCheckoutSessionResponse,
 } from '../../types'
 
 export class SubscriptionService extends BaseService {
@@ -11,6 +14,16 @@ export class SubscriptionService extends BaseService {
     super(config)
   }
 
+  /**
+   * Create a Stripe checkout session for subscription purchase
+   * POST /subscriptions/create-checkout-session
+   */
+  async createCheckoutSession(
+    request: CreateCheckoutSessionRequest
+  ): Promise<CreateCheckoutSessionResponse> {
+    return this.post<CreateCheckoutSessionResponse>('/subscriptions/create-checkout-session', request)
+  }
+
   /**
    * Get the currently active subscription for the authenticated user
    * GET /subscriptions/current
@@ -27,6 +40,14 @@ export class SubscriptionService extends BaseService {
     return this.get<UserSubscriptionsResponse>('/subscriptions/')
   }
 
+  /**
+   * Get all available subscription products and their prices
+   * GET /subscriptions/products
+   */
+  async getSubscriptionProducts(): Promise<SubscriptionProductsResponse> {
+    return this.get<SubscriptionProductsResponse>('/subscriptions/products')
+  }
+
   /**
    * Cancel subscription but keep it active until the end of the current billing period
    * POST /subscriptions/{subscription_id}/cancel
@@ -35,10 +56,7 @@ export class SubscriptionService extends BaseService {
     subscriptionId: string,
     request: CancelSubscriptionRequest
   ): Promise<CancelSubscriptionResponse> {
-    return this.post<CancelSubscriptionResponse>(
-      `/subscriptions/${subscriptionId}/cancel`,
-      request
-    )
+    return this.post<CancelSubscriptionResponse>(`/subscriptions/${subscriptionId}/cancel`, request)
   }
 
   /**
@@ -144,4 +162,4 @@ export class SubscriptionService extends BaseService {
   }> {
     return this.get(`/subscriptions/${subscriptionId}/history`)
   }
-}
+}

package/services/usage/usage-types.ts

@@ -45,7 +45,6 @@ export interface CreditCheckResponse {
   model_key: string
 }
 
-
 export interface CreditBalance {
   total_allotted: number
   total_consumed: number
@@ -161,15 +160,15 @@ export interface TrackCodespaceUsageResponse {
   created_at: string
 }
 
+export interface CodespaceTaskUsageData {
+  total_records: number
+  total_credits_consumed: number
+  latest_usage: string
+}
+
 export interface CodespaceTaskUsageResponse {
-  codespace_task_id: string
-  total_usage: {
-    total_input_tokens: number
-    total_output_tokens: number
-    total_call_seconds: number
-    total_cost: number
-  }
-  usage_records: TrackCodespaceUsageResponse[]
+  status: string
+  data: CodespaceTaskUsageData
 }
 
 export interface HealthResponse {
@@ -179,10 +178,10 @@ export interface HealthResponse {
 }
 
 // Dashboard Analytics Types
-export type PeriodType = "7d" | "1w" | "1m" | "3m"
-export type ServiceType = "docs" | "chat" | "codespace_task" | "api"
-export type SortOrder = "asc" | "desc"
-export type SortByField = "created_at" | "credits_consumed" | "cost_amount"
+export type PeriodType = '7d' | '1w' | '1m' | '3m'
+export type ServiceType = 'docs' | 'chat' | 'codespace_task' | 'api'
+export type SortOrder = 'asc' | 'desc'
+export type SortByField = 'created_at' | 'credits_consumed' | 'cost_amount'
 
 export interface DashboardAnalyticsRequest {
   period?: PeriodType

package/types.ts

@@ -136,8 +136,8 @@ export interface Product {
   id: string
   active: boolean
   name: string
-  description: string
-  image: string
+  description: string | null
+  image: string | null
   metadata: Record<string, any>
   marketing_features: string[]
   live_mode: boolean
@@ -172,6 +172,14 @@ export interface UserSubscriptionsResponse {
   data: Subscription[]
 }
 
+export interface SubscriptionProductsResponse {
+  status: string
+  data: Array<{
+    product: Product
+    prices: Price[]
+  }>
+}
+
 export interface CancelSubscriptionRequest {
   cancel_at_period_end: boolean
 }
@@ -182,6 +190,18 @@ export interface CancelSubscriptionResponse {
   data: Subscription
 }
 
+// Checkout Session Types
+export interface CreateCheckoutSessionRequest {
+  price_id: string
+  success_url: string
+  cancel_url: string
+}
+
+export interface CreateCheckoutSessionResponse {
+  status: string
+  checkout_url: string
+}
+
 // Cancellation Funnel Types
 export interface CancellationFunnelInitiateRequest {
   subscription_id: string