@codeguide/core 0.0.29 → 0.0.35

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 = {
@@ -329,7 +326,7 @@ describe('UsageService', () => {
       expect(result.data.subscription).not.toBeNull()
       expect(result.data.subscription?.plan_name).toBe('Monthly Plan')
       expect(result.data.codespace_task_limit).toBeNull()
-      expect(result.data.plan_limits.limits.codespace_tasks.is_unlimited).toBe(true)
+      expect(result.data.plan_limits?.limits.codespace_tasks.is_unlimited).toBe(true)
     })
   })
 
@@ -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,32 +700,44 @@ 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 = {
         status: 'success',
         data: {
-          current_period: {
+          period: {
+            start: '2024-01-25',
+            end: '2024-01-31',
+          },
+          usage: {
             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
+          breakdown: {
+            docs: 5230,
+            chat: 4120,
+            codespace_task: 4520,
           },
-          billing_cycle: {
-            total_allotted: 50000,
-            total_consumed: 28450,
-            remaining_credits: 21550
-          },
-          utilization_percentage: 56.9,
-          remaining_credits: 21550,
-          daily_average: 1981.43,
-          projected_monthly: 59443
-        }
+          service_breakdown: [
+            {
+              service_type: 'docs',
+              credits_consumed: 5230,
+              requests_count: 58,
+            },
+            {
+              service_type: 'chat',
+              credits_consumed: 4120,
+              requests_count: 47,
+            },
+            {
+              service_type: 'codespace_task',
+              credits_consumed: 4520,
+              requests_count: 37,
+            },
+          ],
+        },
       }
 
       mockAxios.onGet('/usage/dashboard/summary?period=7d').reply(200, response)
@@ -747,35 +750,49 @@ 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 = {
         status: 'success',
         data: {
-          current_period: {
+          period: {
+            start: '2024-01-01',
+            end: '2024-01-31',
+          },
+          usage: {
             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
+          breakdown: {
+            docs: 10000,
+            chat: 8000,
+            codespace_task: 7000,
           },
-          billing_cycle: {
-            total_allotted: 50000,
-            total_consumed: 47000,
-            remaining_credits: 3000
-          },
-          utilization_percentage: 94.0,
-          remaining_credits: 3000,
-          daily_average: 806.45,
-          projected_monthly: 25000
-        }
+          service_breakdown: [
+            {
+              service_type: 'docs',
+              credits_consumed: 10000,
+              requests_count: 120,
+            },
+            {
+              service_type: 'chat',
+              credits_consumed: 8000,
+              requests_count: 95,
+            },
+            {
+              service_type: 'codespace_task',
+              credits_consumed: 7000,
+              requests_count: 85,
+            },
+          ],
+        },
       }
 
-      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 +803,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 +812,7 @@ describe('UsageService', () => {
           period: {
             start: '2024-01-25',
             end: '2024-01-31',
-            label: '7d'
+            label: '7d',
           },
           services: [
             {
@@ -804,7 +821,7 @@ describe('UsageService', () => {
               percentage: 37.71,
               cost_usd: 15.69,
               requests_count: 58,
-              trend: 12.5
+              trend: 12.5,
             },
             {
               service_type: 'chat',
@@ -812,12 +829,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 +847,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 +856,7 @@ describe('UsageService', () => {
           period: {
             start: '2024-01-01',
             end: '2024-01-31',
-            label: 'custom'
+            label: 'custom',
           },
           services: [
             {
@@ -848,15 +865,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 +889,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/codeguide.ts

@@ -20,6 +20,7 @@ import {
   SecurityKeysService,
   UserService,
   StarterKitsService,
+  ChatService,
 } from './services'
 import { APIServiceConfig, CodeGuideOptions } from './types'
 
@@ -37,6 +38,7 @@ export class CodeGuide {
   public securityKeys: SecurityKeysService
   public users: UserService
   public starterKits: StarterKitsService
+  public chat: ChatService
   private options: CodeGuideOptions
 
   constructor(config: APIServiceConfig, options: CodeGuideOptions = {}) {
@@ -56,6 +58,7 @@ export class CodeGuide {
     this.securityKeys = new SecurityKeysService(config)
     this.users = new UserService(config)
     this.starterKits = new StarterKitsService(config)
+    this.chat = new ChatService(config)
   }
 
   // Convenience method for backward compatibility

package/dist/codeguide.d.ts

@@ -1,4 +1,4 @@
-import { GenerationService, ProjectService, UsageService, RepositoryAnalysisService, TaskService, ApiKeyEnhancedService, SubscriptionService, CancellationFunnelService, CodespaceService, ExternalTokenService, SecurityKeysService, UserService, StarterKitsService } from './services';
+import { GenerationService, ProjectService, UsageService, RepositoryAnalysisService, TaskService, ApiKeyEnhancedService, SubscriptionService, CancellationFunnelService, CodespaceService, ExternalTokenService, SecurityKeysService, UserService, StarterKitsService, ChatService } from './services';
 import { APIServiceConfig, CodeGuideOptions } from './types';
 export declare class CodeGuide {
     generation: GenerationService;
@@ -14,6 +14,7 @@ export declare class CodeGuide {
     securityKeys: SecurityKeysService;
     users: UserService;
     starterKits: StarterKitsService;
+    chat: ChatService;
     private options;
     constructor(config: APIServiceConfig, options?: CodeGuideOptions);
     getGuidance(prompt: string): Promise<any>;

package/dist/codeguide.js

@@ -29,6 +29,7 @@ class CodeGuide {
         this.securityKeys = new services_1.SecurityKeysService(config);
         this.users = new services_1.UserService(config);
         this.starterKits = new services_1.StarterKitsService(config);
+        this.chat = new services_1.ChatService(config);
     }
     // Convenience method for backward compatibility
     async getGuidance(prompt) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { CodeGuide } from './codeguide';
 export * from './services';
 export * from './types';
-export type { ConnectRepositoryRequest, ConnectRepositoryResponse, ProjectRepository, GetProjectsRequest, PaginatedProjectsRequest, PaginatedProjectsResponse, } from './services/projects/project-types';
+export type { ConnectRepositoryRequest, ConnectRepositoryResponse, ProjectRepository, GetProjectsRequest, PaginatedProjectsRequest, PaginatedProjectsResponse, AITool, GetAiToolsRequest, GetAiToolsResponse, } from './services/projects/project-types';
 export type { CreateCodespaceTaskRequestV2 as CreateCodespaceTaskRequest, CreateCodespaceTaskResponseV2 as CreateCodespaceTaskResponse, CreateBackgroundCodespaceTaskRequest, CreateBackgroundCodespaceTaskResponse, ModelApiKey, Attachment, GetCodespaceTaskResponse, CodespaceTaskData, TechnicalDocument, GetProjectTasksByCodespaceResponse, } from './services/codespace/codespace-types';
 export type { StoreExternalTokenRequest, StoreExternalTokenResponse, ListTokensQuery, ListTokensResponse, ValidateTokenRequest, ValidateTokenResponse, FindBestMatchRequest, FindBestMatchResponse, Platform, TokenType, } from './services/external-tokens/external-tokens-types';
 export type { StarterKit, StarterKitMetadata, GetStarterKitsRequest, GetStarterKitsResponse, } from './services/starter-kits/starter-kits-types';