@codeguide/core 0.0.29 → 0.0.35

package/index.ts

@@ -19,6 +19,9 @@ export type {
   GetProjectsRequest,
   PaginatedProjectsRequest,
   PaginatedProjectsResponse,
+  AITool,
+  GetAiToolsRequest,
+  GetAiToolsResponse,
 } from './services/projects/project-types'
 export type {
   CreateCodespaceTaskRequestV2 as CreateCodespaceTaskRequest,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeguide/core",
-  "version": "0.0.29",
+  "version": "0.0.35",
   "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/chat/chat-service.ts

@@ -0,0 +1,110 @@
+import { BaseService } from '../base/base-service'
+import {
+  GetDocumentTypesRequest,
+  GetDocumentTypesResponse,
+  GetChatsByDocumentTypeRequest,
+  GetChatsByDocumentTypeResponse,
+  GetChatHistoryRequest,
+  GetChatHistoryResponse,
+  ListDocumentChatsRequest,
+  ListDocumentChatsResponse,
+  GetChatByDocumentIdRequest,
+  GetChatByDocumentIdResponse,
+} from './chat-types'
+
+export class ChatService extends BaseService {
+  /**
+   * 1. GET /chat/document/types/{project_id}
+   * Get document types for UI grouping
+   *
+   * @param request - Project ID to get document types for
+   * @returns Document types available for the project
+   */
+  async getDocumentTypes(request: GetDocumentTypesRequest): Promise<GetDocumentTypesResponse> {
+    return this.get<GetDocumentTypesResponse>(`/chat/document/types/${request.project_id}`)
+  }
+
+  /**
+   * 2. GET /chat/document/by-type/{project_id}/{document_type}
+   * List all chats for a specific document type (PRIMARY endpoint for UI)
+   *
+   * @param request - Filter parameters for document type chats
+   * @returns Paginated list of document chats for the specified type
+   */
+  async getChatsByDocumentType(
+    request: GetChatsByDocumentTypeRequest
+  ): Promise<GetChatsByDocumentTypeResponse> {
+    const { project_id, document_type, chat_status = 'active', limit = 50, offset = 0 } = request
+
+    // Build query parameters
+    const params = new URLSearchParams()
+    if (chat_status) params.append('chat_status', chat_status)
+    if (limit !== undefined) params.append('limit', limit.toString())
+    if (offset !== undefined) params.append('offset', offset.toString())
+
+    const queryString = params.toString()
+    const url = `/chat/document/by-type/${project_id}/${document_type}${queryString ? `?${queryString}` : ''}`
+
+    return this.get<GetChatsByDocumentTypeResponse>(url)
+  }
+
+  /**
+   * 3. GET /chat/document/history/{conversation_id}
+   * Get full chat history with messages
+   *
+   * @param request - Conversation ID to get history for
+   * @returns Conversation details with all messages
+   */
+  async getChatHistory(request: GetChatHistoryRequest): Promise<GetChatHistoryResponse> {
+    return this.get<GetChatHistoryResponse>(`/chat/document/history/${request.conversation_id}`)
+  }
+
+  /**
+   * 4. GET /chat/document/list
+   * List all chats for current user (with optional filters)
+   *
+   * @param request - Filter parameters for listing chats
+   * @returns Paginated list of all document chats for the user
+   */
+  async listDocumentChats(
+    request: ListDocumentChatsRequest = {}
+  ): Promise<ListDocumentChatsResponse> {
+    const {
+      project_id,
+      document_type,
+      template,
+      chat_status = 'active',
+      limit = 50,
+      offset = 0,
+    } = request
+
+    // Build query parameters
+    const params = new URLSearchParams()
+    if (project_id) params.append('project_id', project_id)
+    if (document_type) params.append('document_type', document_type)
+    if (template) params.append('template', template)
+    if (chat_status) params.append('chat_status', chat_status)
+    if (limit !== undefined) params.append('limit', limit.toString())
+    if (offset !== undefined) params.append('offset', offset.toString())
+
+    const queryString = params.toString()
+    const url = `/chat/document/list${queryString ? `?${queryString}` : ''}`
+
+    return this.get<ListDocumentChatsResponse>(url)
+  }
+
+  /**
+   * 5. GET /chat/document/by-document/{document_id}
+   * Get chat by specific document version ID (Legacy)
+   *
+   * @param request - Document ID to get chat for
+   * @returns Conversation and messages for the specific document
+   */
+  async getChatByDocumentId(
+    request: GetChatByDocumentIdRequest
+  ): Promise<GetChatByDocumentIdResponse> {
+    return this.get<GetChatByDocumentIdResponse>(
+      `/chat/document/by-document/${request.document_id}`
+    )
+  }
+}

package/services/chat/chat-types.ts

@@ -0,0 +1,145 @@
+// ============================================================================
+// Document Chat GET Endpoint Types
+// ============================================================================
+
+// ============================================================================
+// 1. GET /chat/document/types/{project_id}
+// Get document types for UI grouping
+// ============================================================================
+
+export interface GetDocumentTypesRequest {
+  project_id: string
+}
+
+export interface GetDocumentTypesResponse {
+  project_id: string
+  project_name: string
+  document_types: DocumentType[]
+}
+
+export type DocumentType =
+  | 'project_requirements_document'
+  | 'app_flow_document'
+  | 'tech_stack_document'
+  | 'frontend_guidelines_document'
+  | 'database_schema_document'
+  | 'api_documentation_document'
+  | 'deployment_document'
+  | 'testing_document'
+  | 'custom_document'
+
+// ============================================================================
+// 2. GET /chat/document/by-type/{project_id}/{document_type}
+// List all chats for a specific document type (PRIMARY endpoint for UI)
+// ============================================================================
+
+export interface GetChatsByDocumentTypeRequest {
+  project_id: string
+  document_type: DocumentType
+  chat_status?: ChatStatus
+  limit?: number
+  offset?: number
+}
+
+export interface GetChatsByDocumentTypeResponse {
+  chats: DocumentChatSummary[]
+  count: number
+  project_id: string
+  document_type: DocumentType
+  limit: number
+  offset: number
+}
+
+// ============================================================================
+// 3. GET /chat/document/history/{conversation_id}
+// Get full chat history with messages
+// ============================================================================
+
+export interface GetChatHistoryRequest {
+  conversation_id: string
+}
+
+export interface GetChatHistoryResponse {
+  conversation: DocumentConversation
+  messages: ChatMessage[]
+}
+
+// ============================================================================
+// 4. GET /chat/document/list
+// List all chats for current user (with optional filters)
+// ============================================================================
+
+export interface ListDocumentChatsRequest {
+  project_id?: string
+  document_type?: DocumentType
+  template?: 'blueprint' | 'wireframe'
+  chat_status?: ChatStatus
+  limit?: number
+  offset?: number
+}
+
+export interface ListDocumentChatsResponse {
+  chats: DocumentChatSummary[]
+  count: number
+  limit: number
+  offset: number
+}
+
+// ============================================================================
+// 5. GET /chat/document/by-document/{document_id}
+// Get chat by specific document version ID (Legacy)
+// ============================================================================
+
+export interface GetChatByDocumentIdRequest {
+  document_id: string
+}
+
+export interface GetChatByDocumentIdResponse {
+  conversation: DocumentConversation
+  messages: ChatMessage[]
+}
+
+// ============================================================================
+// Common Types
+// ============================================================================
+
+export type ChatStatus = 'active' | 'archived' | 'deleted'
+
+export interface DocumentChatSummary {
+  id: string
+  project_id: string
+  document_type: DocumentType
+  title: string
+  template: 'blueprint' | 'wireframe'
+  status: ChatStatus
+  last_message_at: string
+  metadata?: Record<string, any>
+}
+
+export interface DocumentConversation {
+  id: string
+  project_id: string
+  document_type: DocumentType
+  title: string
+  template: 'blueprint' | 'wireframe'
+  status: ChatStatus
+  created_at: string
+  last_message_at: string
+}
+
+export interface ChatMessage {
+  id: string
+  role: 'user' | 'assistant' | 'system'
+  content: string
+  tool_calls?: ChatToolCall[]
+  created_at: string
+}
+
+export interface ChatToolCall {
+  id: string
+  type: string
+  function?: {
+    name: string
+    arguments: string
+  }
+}

package/services/chat/index.ts

@@ -0,0 +1,2 @@
+export { ChatService } from './chat-service'
+export * from './chat-types'

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/generation/generation-service.ts

@@ -18,9 +18,21 @@ import {
   GenerateMultipleDocumentsResponse,
   GenerateMissingDocumentsRequest,
   GenerateMissingDocumentsResponse,
+  GenerateTechSpecRequest,
+  CustomDocumentResponse,
   BackgroundGenerationRequest,
   BackgroundGenerationResponse,
   BackgroundGenerationStatusResponse,
+  GenerateAnswersRequest,
+  GenerateAnswersResponse,
+  GenerateProjectOutlineRequest,
+  GenerateProjectOutlineResponse,
+  GenerateCoreFeaturesRequest,
+  GenerateCoreFeaturesResponse,
+  GenerateTechStackRequest,
+  GenerateTechStackResponse,
+  GenerateAppFlowRequest,
+  GenerateAppFlowResponse,
 } from './generation-types'
 
 export class GenerationService extends BaseService {
@@ -78,4 +90,32 @@ export class GenerationService extends BaseService {
   async getBackgroundGenerationStatus(jobId: string): Promise<BackgroundGenerationStatusResponse> {
     return this.get<BackgroundGenerationStatusResponse>(`/generate/background/${jobId}/status`)
   }
+
+  async generateTechSpec(request: GenerateTechSpecRequest): Promise<CustomDocumentResponse> {
+    return this.post<CustomDocumentResponse>('/generate/tech-spec', request)
+  }
+
+  async generateAnswers(request: GenerateAnswersRequest): Promise<GenerateAnswersResponse> {
+    return this.post<GenerateAnswersResponse>('/generate/answers', request)
+  }
+
+  async generateProjectOutline(
+    request: GenerateProjectOutlineRequest
+  ): Promise<GenerateProjectOutlineResponse> {
+    return this.post<GenerateProjectOutlineResponse>('/generate/project-outline', request)
+  }
+
+  async generateCoreFeatures(
+    request: GenerateCoreFeaturesRequest
+  ): Promise<GenerateCoreFeaturesResponse> {
+    return this.post<GenerateCoreFeaturesResponse>('/generate/core-features', request)
+  }
+
+  async generateTechStack(request: GenerateTechStackRequest): Promise<GenerateTechStackResponse> {
+    return this.post<GenerateTechStackResponse>('/generate/tech-stack', request)
+  }
+
+  async generateAppFlow(request: GenerateAppFlowRequest): Promise<GenerateAppFlowResponse> {
+    return this.post<GenerateAppFlowResponse>('/generate/app-flow', request)
+  }
 }

package/services/generation/generation-types.ts

@@ -65,6 +65,7 @@ export interface GenerateOutlineResponse {
 }
 
 export interface GenerateDocumentRequest {
+  project_id?: string
   project_type?: string
   description: string
   selected_tools: string[]
@@ -129,3 +130,112 @@ export interface GenerateMissingDocumentsResponse {
   error?: string
   generated_documents?: string[]
 }
+
+export interface GenerateTechSpecRequest {
+  project_id: string
+}
+
+export interface CustomDocumentResponse {
+  content: string
+}
+
+export interface GenerateAnswersRequest {
+  title: string
+  description: string
+  questions: Array<{
+    question: string
+    answer: string
+  }>
+}
+
+export interface GenerateAnswersResponse {
+  answers: Array<{
+    question: string
+    answer: string
+  }>
+}
+
+export interface GenerateProjectOutlineRequest {
+  description: string
+  project_type: string
+  title?: string
+  selected_tools?: string[]
+  answers?: Record<string, any>
+  project_id?: string
+  category_id?: string
+}
+
+export interface GenerateProjectOutlineResponse {
+  outline: string
+  project_id: string
+  project_created: boolean
+}
+
+export interface CoreFeature {
+  id: number
+  title: string
+  description: string
+  icon_key: string
+}
+
+export interface GenerateCoreFeaturesRequest {
+  context: string
+  project_id?: string
+  existing_features?: Array<{
+    id: number
+    title: string
+    description: string
+  }>
+}
+
+export interface GenerateCoreFeaturesResponse {
+  core_features: CoreFeature[]
+  project_id: string | null
+}
+
+export interface TechStackItem {
+  id: number
+  type: string
+  name: string
+  icon_key: string
+}
+
+export interface GenerateTechStackRequest {
+  context: string
+  project_id?: string
+  existing_items?: Array<{
+    id: number
+    type: string
+    name: string
+  }>
+}
+
+export interface GenerateTechStackResponse {
+  tech_stack: TechStackItem[]
+  project_id: string | null
+}
+
+export interface AppFlowItem {
+  id: number
+  title: string
+  page: string
+  description: string
+  index: number
+  icon_key: string
+}
+
+export interface GenerateAppFlowRequest {
+  context: string
+  project_id?: string
+  existing_items?: Array<{
+    id: number
+    title: string
+    page: string
+    description: string
+  }>
+}
+
+export interface GenerateAppFlowResponse {
+  app_flow: AppFlowItem[]
+  project_id: string | null
+}

package/services/index.ts

@@ -21,6 +21,8 @@ export { ExternalTokenService } from './external-tokens'
 export { SecurityKeysService } from './security-keys'
 export { UserService } from './users'
 export { StarterKitsService } from './starter-kits'
+export { StreamingService } from './streaming'
+export { ChatService } from './chat'
 
 // Re-export all types for convenience
 export * from './generation'
@@ -36,3 +38,5 @@ export * from './external-tokens'
 export * from './security-keys'
 export * from './users'
 export * from './starter-kits'
+export * from './streaming'
+export * from './chat'

package/services/projects/README.md

@@ -122,6 +122,60 @@ interface Project {
 }
 ```
 
+### Project Creation
+
+#### `CreateProjectRequest`
+
+```typescript
+interface CreateProjectRequest {
+  title?: string // Optional - will be auto-generated if not provided
+  description: string
+  status?: 'prompt' | 'draft' | 'in_progress' | 'completed'
+  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
+}
+```
+
+#### Automatic Title Generation
+
+The API now supports automatic title generation when creating projects without a title. The system generates titles using this priority order:
+
+1. **Project description** (highest priority)
+2. **AI questionnaire** responses
+3. **Project outline** information
+4. **"Untitled Project"** (fallback when no context is available)
+
+#### Usage Examples
+
+```typescript
+// Create project without title - API will auto-generate
+const newProject = await codeGuide.project.createProject({
+  description: "A todo app built with React and Node.js",
+  tools_selected: ["React", "Node.js", "MongoDB"]
+})
+
+// The API will generate a title like "React Node.js Todo Application"
+console.log(newProject.title) // Auto-generated title
+```
+
+#### Generated Title Examples
+
+- Input: "A todo app built with React and Node.js" → "React Node.js Todo Application"
+- Input: "Mobile banking app with biometric authentication" → "Mobile Banking App Biometric Authentication"
+- Empty description with questionnaire → "Untitled Project" (fallback)
+
 ## Usage Examples
 
 ### Basic Filtering

package/services/projects/project-service.ts

@@ -12,6 +12,8 @@ import {
   GetProjectDocumentsResponse,
   ConnectRepositoryRequest,
   ConnectRepositoryResponse,
+  GetAiToolsRequest,
+  GetAiToolsResponse,
 } from './project-types'
 
 export class ProjectService extends BaseService {
@@ -49,7 +51,7 @@ export class ProjectService extends BaseService {
   }
 
   async createProject(request: CreateProjectRequest): Promise<Project> {
-    const response = await this.post<ProjectResponse>('/projects', request)
+    const response = await this.post<ProjectResponse>('/projects/', request)
     return response.data
   }
 
@@ -76,6 +78,13 @@ export class ProjectService extends BaseService {
     return this.get<GetProjectDocumentsResponse>(url)
   }
 
+  async getDocumentsByType(
+    projectId: string,
+    documentType: string
+  ): Promise<GetProjectDocumentsResponse> {
+    return this.get<GetProjectDocumentsResponse>(`/projects/${projectId}/documents/type/${documentType}`)
+  }
+
   async connectRepository(
     projectId: string,
     request: ConnectRepositoryRequest
@@ -110,4 +119,14 @@ export class ProjectService extends BaseService {
       throw new Error('GitHub token must be a valid personal access token')
     }
   }
+
+  async getAiTools(params?: GetAiToolsRequest): Promise<GetAiToolsResponse> {
+    const queryParams = new URLSearchParams()
+
+    if (params?.key) queryParams.append('key', params.key)
+    if (params?.category) queryParams.append('category', params.category)
+
+    const url = `/ai-tools${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+    return this.get<GetAiToolsResponse>(url)
+  }
 }