@codeguide/core 0.0.33 → 0.0.36

package/services/data-management/data-management-types.ts

@@ -0,0 +1,163 @@
+/**
+ * Data Management Service Types
+ *
+ * Provides interfaces for viewing data statistics and bulk deleting user data
+ */
+
+/**
+ * Response structure for GET /data/stats endpoint
+ * Contains aggregate counts of all user data across the platform
+ */
+export interface DataStatsResponse {
+  status: string
+  data: DataStats
+}
+
+/**
+ * Aggregate statistics for all user data entities
+ */
+export interface DataStats {
+  projects: number
+  project_documents: number
+  project_repositories: number
+  project_tasks: number
+  task_groups: number
+  chat_conversations: number
+  chat_messages: number
+  codespace_tasks: number
+}
+
+/**
+ * Request structure for DELETE /data/all endpoint
+ * Requires explicit confirmation to prevent accidental data loss
+ */
+export interface DeleteAllDataRequest {
+  confirm: boolean
+}
+
+/**
+ * Response structure for DELETE /data/all endpoint
+ * Provides summary of deleted data counts
+ */
+export interface DeleteAllDataResponse {
+  status: string
+  message: string
+  deleted: DataStats
+}
+
+/**
+ * Response structure for GET /data/export endpoint
+ * Contains complete export of all user data
+ */
+export interface DataExportResponse {
+  status: string
+  exported_at: string
+  user_id: string
+  data: ExportedData
+}
+
+/**
+ * Complete exported data containing all user entities
+ */
+export interface ExportedData {
+  projects: ExportedProject[]
+  project_documents: ExportedProjectDocument[]
+  project_repositories: ExportedProjectRepository[]
+  project_tasks: ExportedProjectTask[]
+  task_groups: ExportedTaskGroup[]
+  chat_conversations: ExportedChatConversation[]
+  chat_messages: ExportedChatMessage[]
+  codespace_tasks: ExportedCodespaceTask[]
+}
+
+/**
+ * Exported project entity
+ */
+export interface ExportedProject {
+  id: string
+  title: string
+  description: string
+  status: string
+  user_id: string
+  created_at: string
+  updated_at: string
+  project_outline?: Record<string, any>
+  ai_questionaire?: Record<string, any>
+}
+
+/**
+ * Exported project document entity
+ */
+export interface ExportedProjectDocument {
+  id: string
+  project_id: string
+  content: string
+  custom_document_type: string
+  is_current_version: boolean
+  created_at: string
+}
+
+/**
+ * Exported project repository entity
+ */
+export interface ExportedProjectRepository {
+  id: string
+  project_id: string
+  repo_url: string
+  created_at: string
+}
+
+/**
+ * Exported project task entity
+ */
+export interface ExportedProjectTask {
+  id: string
+  project_id: string
+  title: string
+  status: string
+  priority: string
+  created_at: string
+}
+
+/**
+ * Exported task group entity
+ */
+export interface ExportedTaskGroup {
+  id: string
+  project_id: string
+  name: string
+  created_at: string
+}
+
+/**
+ * Exported chat conversation entity
+ */
+export interface ExportedChatConversation {
+  id: string
+  title: string
+  model: string
+  created_at: string
+  last_message_at: string
+}
+
+/**
+ * Exported chat message entity
+ */
+export interface ExportedChatMessage {
+  id: string
+  conversation_id: string
+  role: 'user' | 'assistant'
+  content: string
+  token_count: number
+  created_at: string
+}
+
+/**
+ * Exported codespace task entity
+ */
+export interface ExportedCodespaceTask {
+  id: string
+  project_id: string
+  status: string
+  created_at: string
+}

package/services/data-management/index.ts

@@ -0,0 +1,2 @@
+export { DataManagementService } from './data-management-service'
+export * from './data-management-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,142 @@ 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 type ProjectMode = 'prd_only' | 'full_application' | 'prototype' | 'mvp'
+
+export interface ProjectOutline {
+  core_features: Array<{
+    id: number
+    title: string
+    description: string
+    icon_key: string
+  }>
+  app_flow: Array<{
+    id: number
+    title: string
+    description: string
+  }>
+  tech_stack: Array<{
+    id: number
+    type: string
+    name: string
+    icon_key: string
+  }>
+  document_types: Array<{
+    id: number
+    name: string
+    description: string
+  }>
+  is_generated: boolean
+  project_mode: ProjectMode
+}
+
+export interface GenerateProjectOutlineRequest {
+  description: string
+  project_type: string
+  project_mode?: ProjectMode
+  title?: string
+  selected_tools?: string[]
+  answers?: Record<string, any>
+  project_id?: string
+  category_id?: string
+}
+
+export interface GenerateProjectOutlineResponse {
+  project_outline: ProjectOutline
+  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,10 @@ 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'
+export { DataManagementService } from './data-management'
+export { PromptGenerationsService } from './prompt-generations'
 
 // Re-export all types for convenience
 export * from './generation'
@@ -36,3 +40,7 @@ export * from './external-tokens'
 export * from './security-keys'
 export * from './users'
 export * from './starter-kits'
+export * from './streaming'
+export * from './chat'
+export * from './data-management'
+export * from './prompt-generations'

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)
+  }
 }

package/services/projects/project-types.ts

@@ -32,8 +32,26 @@ export interface Project {
   }
   tools_selected?: string[]
   project_outline?: {
-    features?: string[]
-    architecture?: string
+    core_features?: Array<{
+      id?: number
+      title?: string
+      description?: string
+      icon_key?: string
+    }>
+    app_flow?: Array<{
+      id?: number
+      title?: string
+      description?: string
+    }>
+    tech_stack?: Array<{
+      id?: number
+      type?: string
+      name?: string
+      icon_key?: string
+    }>
+    document_types?: string[]
+    is_generated?: boolean
+    project_mode?: 'prd_only' | 'full_application' | 'prototype' | 'mvp'
   }
   codie_tool_id?: string
   existing_project_repo_url?: string | null
@@ -95,8 +113,9 @@ export interface StarterKitReference {
 }
 
 export interface CreateProjectRequest {
-  title: string
-  description: string
+  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?: {
@@ -106,8 +125,26 @@ export interface CreateProjectRequest {
   }
   tools_selected?: string[]
   project_outline?: {
-    features?: string[]
-    architecture?: string
+    core_features?: Array<{
+      id?: number
+      title?: string
+      description?: string
+      icon_key?: string
+    }>
+    app_flow?: Array<{
+      id?: number
+      title?: string
+      description?: string
+    }>
+    tech_stack?: Array<{
+      id?: number
+      type?: string
+      name?: string
+      icon_key?: string
+    }>
+    document_types?: string[]
+    is_generated?: boolean
+    project_mode?: 'prd_only' | 'full_application' | 'prototype' | 'mvp'
   }
   codie_tool_id?: string
   existing_project_repo_url?: string
@@ -126,8 +163,26 @@ export interface UpdateProjectRequest {
   }
   tools_selected?: string[]
   project_outline?: {
-    features?: string[]
-    architecture?: string
+    core_features?: Array<{
+      id?: number
+      title?: string
+      description?: string
+      icon_key?: string
+    }>
+    app_flow?: Array<{
+      id?: number
+      title?: string
+      description?: string
+    }>
+    tech_stack?: Array<{
+      id?: number
+      type?: string
+      name?: string
+      icon_key?: string
+    }>
+    document_types?: string[]
+    is_generated?: boolean
+    project_mode?: 'prd_only' | 'full_application' | 'prototype' | 'mvp'
   }
   codie_tool_id?: string
   existing_project_repo_url?: string
@@ -178,3 +233,28 @@ export interface ConnectRepositoryResponse {
   data: ProjectRepository
 }
 
+export interface AITool {
+  id: string
+  created_at: string
+  name: string
+  description: string
+  logo_src: string | null
+  is_active: boolean
+  key: string
+  ordinal: number | null
+  metadata: Record<string, any> | null
+  detailed_description: string | null
+  category: string | null
+  doc_type: string
+}
+
+export interface GetAiToolsRequest {
+  key?: string
+  category?: string
+}
+
+export interface GetAiToolsResponse {
+  status: string
+  data: AITool[]
+}
+

package/services/prompt-generations/index.ts

@@ -0,0 +1,2 @@
+export { PromptGenerationsService } from './prompt-generations-service'
+export * from './prompt-generations-types'

package/services/prompt-generations/prompt-generations-service.ts

@@ -0,0 +1,75 @@
+import { BaseService } from '../base/base-service'
+import {
+  CreatePromptGenerationRequest,
+  CreatePromptGenerationResponse,
+  ListPromptGenerationsResponse,
+  GetPromptGenerationResponse,
+  DeletePromptGenerationResponse,
+} from './prompt-generations-types'
+
+export class PromptGenerationsService extends BaseService {
+  /**
+   * Create a new AI system prompt generation
+   *
+   * Generates a new AI system prompt based on user input using GPT-5.1.
+   *
+   * POST /prompt-generations/
+   *
+   * @param request - The prompt generation request parameters
+   * @returns Promise resolving to the created prompt generation data
+   */
+  async createPromptGeneration(
+    request: CreatePromptGenerationRequest
+  ): Promise<CreatePromptGenerationResponse> {
+    return this.post<CreatePromptGenerationResponse>('/prompt-generations/', request)
+  }
+
+  /**
+   * List all prompt generations for the authenticated user
+   *
+   * Retrieves all prompt generations that belong to the current user.
+   *
+   * GET /prompt-generations/
+   *
+   * @returns Promise resolving to an array of prompt generations
+   */
+  async listPromptGenerations(): Promise<ListPromptGenerationsResponse> {
+    return this.get<ListPromptGenerationsResponse>('/prompt-generations/')
+  }
+
+  /**
+   * Get a specific prompt generation by ID
+   *
+   * Retrieves detailed information about a single prompt generation.
+   *
+   * GET /prompt-generations/{generation_id}
+   *
+   * @param generationId - The UUID of the prompt generation to retrieve
+   * @returns Promise resolving to the prompt generation data
+   */
+  async getPromptGeneration(
+    generationId: string
+  ): Promise<GetPromptGenerationResponse> {
+    return this.get<GetPromptGenerationResponse>(
+      `/prompt-generations/${generationId}`
+    )
+  }
+
+  /**
+   * Delete a specific prompt generation by ID
+   *
+   * Permanently removes a prompt generation from the database.
+   *
+   * DELETE /prompt-generations/{generation_id}
+   *
+   * @param generationId - The UUID of the prompt generation to delete
+   * @returns Promise resolving to the deleted prompt generation data
+   */
+  async deletePromptGeneration(
+    generationId: string
+  ): Promise<DeletePromptGenerationResponse> {
+    return this.delete<DeletePromptGenerationResponse>(
+      `/prompt-generations/${generationId}`
+    )
+  }
+}