{"openapi":"3.0.0","paths":{"/handbook-api/health":{"get":{"operationId":"AppController_getHealthCheck","parameters":[],"responses":{"200":{"description":""}},"tags":["App"]}},"/handbook-api/handbook-entry":{"post":{"operationId":"HandbookEntryController_createHandbookEntry","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookEntryDto"}}}},"responses":{"201":{"description":"The handbook entry has been successfully created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookEntry"}}}}},"security":[{"bearer":[]}],"summary":"Create a new handbook entry","tags":["Handbook Entries"]},"get":{"operationId":"HandbookEntryController_findAllHandbookEntries","parameters":[],"responses":{"200":{"description":"Returns all handbook entries","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HandbookEntry"}}}}}},"security":[{"bearer":[]}],"summary":"Get all handbook entries","tags":["Handbook Entries"]}},"/handbook-api/handbook-entry/overview/{app}":{"get":{"operationId":"HandbookEntryController_findAllHandbookEntriesForOverview","parameters":[{"name":"app","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Returns all handbook entries for overview","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookOverviewResponse"}}}}},"security":[{"bearer":[]}],"summary":"Get all handbook entries for overview","tags":["Handbook Entries"]}},"/handbook-api/handbook-entry/tags":{"get":{"operationId":"HandbookEntryController_findAllTags","parameters":[{"name":"searchQuery","required":true,"in":"query","description":"The search query to filter handbook tags","schema":{"example":"meet","type":"string"}}],"responses":{"200":{"description":"Returns all tags from handbook entries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookTagsResponse"}}}}},"security":[{"bearer":[]}],"summary":"Get all tags from handbook entries","tags":["Handbook Entries"]}},"/handbook-api/handbook-entry/{id}":{"get":{"operationId":"HandbookEntryController_findHandbookEntryById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Returns the handbook entry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookEntry"}}}}},"security":[{"bearer":[]}],"summary":"Get a handbook entry by ID","tags":["Handbook Entries"]},"put":{"operationId":"HandbookEntryController_updateHandbookEntry","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookEntryDto"}}}},"responses":{"200":{"description":"The handbook entry has been successfully updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookEntry"}}}}},"security":[{"bearer":[]}],"summary":"Update a handbook entry","tags":["Handbook Entries"]},"delete":{"operationId":"HandbookEntryController_deleteHandbookEntry","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"The handbook entry has been successfully deleted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookEntry"}}}}},"security":[{"bearer":[]}],"summary":"Delete a handbook entry","tags":["Handbook Entries"]}},"/handbook-api/handbook-entry/get-text-from-voice":{"post":{"operationId":"HandbookEntryController_getTextFromVoice","parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/VoiceHandbookEntryDto"}}}},"responses":{"201":{"description":"The text has been successfully extracted from voice.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookVoiceResponse"}}}}},"security":[{"bearer":[]}],"summary":"Get text from voice recording","tags":["Handbook Entries"]}},"/handbook-api/handbook-entry/generate-from-text":{"post":{"operationId":"HandbookEntryController_generateHandbookFromText","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceHandbookEntryDto"}}}},"responses":{"201":{"description":"The handbook entry has been successfully generated from voice text.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookEntry"}}}}},"security":[{"bearer":[]}],"summary":"Generate handbook entry from voice text","tags":["Handbook Entries"]}},"/handbook-api/handbook-entry/generate-from-voice":{"post":{"operationId":"HandbookEntryController_generateHandbook","parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/VoiceHandbookEntryDto"}}}},"responses":{"201":{"description":"The handbook entry has been successfully generated from voice.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandbookEntry"}}}}},"security":[{"bearer":[]}],"summary":"Generate handbook entry from voice recording","tags":["Handbook Entries"]}},"/handbook-api/conversation":{"get":{"operationId":"ConversationController_conversation","parameters":[{"name":"question","required":false,"in":"query","description":"The question to search for","schema":{"example":"How do I submit a vacation request?","type":"string"}},{"name":"threadId","required":false,"in":"query","description":"The thread ID of the search","schema":{"example":"123e4567-e89b-12d3-a456-426614174000","type":"string"}},{"name":"app","required":false,"in":"query","description":"The app to use for the search","schema":{"example":"szales","type":"string"}},{"name":"currentUrlPath","required":false,"in":"query","description":"The current URL path","schema":{"example":"/szales/products/123","type":"string"}}],"responses":{"200":{"description":"Returns answer based on search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResult"}}}}},"security":[{"bearer":[]}],"summary":"Ask AI","tags":["Conversation"]}},"/handbook-api/conversation/overview":{"get":{"operationId":"ConversationController_getConversationOverview","parameters":[],"responses":{"200":{"description":"Returns overview of all conversations","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConversationOverviewResult"}}}}}},"security":[{"bearer":[]}],"summary":"Get conversation overview","tags":["Conversation"]}},"/handbook-api/conversation/context":{"post":{"operationId":"ConversationController_getRelevantContext","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextDto"}}}},"responses":{"200":{"description":"Returns relevant document context based on query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextResult"}}}}},"security":[{"bearer":[]}],"summary":"Get relevant context for a query","tags":["Conversation"]}},"/handbook-api/conversation/{id}/detail":{"get":{"operationId":"ConversationController_getConversationDetail","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Returns detailed conversation history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationDetailResult"}}}}},"security":[{"bearer":[]}],"summary":"Get conversation detail","tags":["Conversation"]}},"/handbook-api/lichtbot/import-history":{"get":{"operationId":"LichtbotController_getImportHistory","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Lichtbot"]}},"/handbook-api/lichtbot/import-adresses":{"get":{"operationId":"LichtbotController_getImportAdresses","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Lichtbot"]}},"/handbook-api/lichtbot/join":{"post":{"description":"Allows a user to add the LichtBOT to the client Chat Room. Note: This is a mock endpoint for prototyping only and is not functional.","operationId":"LichtbotController_joinRoom","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinLichtbotDto"}}}},"responses":{"200":{"description":"Successfully joined the chat room","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinLichtbotDto"}}}},"400":{"description":"Invalid request"}},"security":[{"bearer":[]}],"summary":"Add the LichtBOT to the client Chat Room","tags":["Lichtbot"]}},"/handbook-api/lichtbot/leave":{"post":{"description":"Allows a user to remove the LichtBOT from the client Chat Room. Note: This is a mock endpoint for prototyping only and is not functional.","operationId":"LichtbotController_leaveRoom","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaveLichtbotDto"}}}},"responses":{"200":{"description":"Successfully removed the LichtBOT from the chat room","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaveLichtbotDto"}}}},"400":{"description":"Invalid request"}},"security":[{"bearer":[]}],"summary":"Remove the LichtBOT from the client Chat Room","tags":["Lichtbot"]}},"/handbook-api/lichtbot/message":{"post":{"description":"Sends a client message to LichtBOT in a chat room. Note: This is a mock endpoint for prototyping only and is not functional.","operationId":"LichtbotController_reciveMessage","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LichtbotClientMessageDto"}}}},"responses":{"200":{"description":"Message successfully sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LichtbotClientMessageDto"}}}},"400":{"description":"Invalid request"}},"security":[{"bearer":[]}],"summary":"Send a message to LichtBOT","tags":["Lichtbot"]}},"/handbook-api/presidio/analyze":{"post":{"operationId":"PresidioController_analyzeText","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnonymizeTextDto"}}}},"responses":{"200":{"description":"Returns analyze results with PII locations"}},"summary":"Analyze text for PII","tags":["presidio"]}},"/handbook-api/presidio/anonymize":{"post":{"operationId":"PresidioController_anonymizeText","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnonymizeTextDto"}}}},"responses":{"200":{"description":"Returns anonymized text"}},"summary":"Anonymize text containing PII","tags":["presidio"]}},"/handbook-api/presidio/test":{"post":{"operationId":"PresidioController_test","parameters":[],"responses":{"200":{"description":"Returns test results"}},"summary":"Test endpoint for smoke testing","tags":["presidio"]}},"/handbook-api/sethub-app/{appId}/daily-sections":{"get":{"operationId":"SethubAppsController_getDailySections","parameters":[{"name":"appId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Returns today's page entries organized into three sections","content":{"application/json":{"schema":{"type":"object"}}}}},"summary":"Get daily sections","tags":["SethubApps"]}},"/handbook-api/sethub-app/{appId}/summary":{"get":{"operationId":"SethubAppsController_summary","parameters":[{"name":"appId","required":true,"in":"path","schema":{"type":"string"}},{"name":"templateId","required":true,"in":"query","description":"The template ID of the summary","schema":{"example":"507f1f77bcf86cd799439011","type":"string"}},{"name":"documentId","required":true,"in":"query","description":"The document ID of the summary","schema":{"example":"507f1f77bcf86cd799439011","type":"string"}},{"name":"threadId","required":false,"in":"query","description":"The thread ID of the summary","schema":{"example":"123e4567-e89b-12d3-a456-426614174000","type":"string"}}],"responses":{"200":{"description":"Returns summary of content","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryResult"}}}}},"summary":"Summarize content","tags":["SethubApps"]}},"/handbook-api/sethub-app/context":{"post":{"operationId":"SethubAppsController_getRelevantContext","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SethubAppContextDto"}}}},"responses":{"200":{"description":"Returns relevant document context based on keywords","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SethubAppContextResult"}}}}},"summary":"Get relevant context for keywords","tags":["SethubApps"]}},"/handbook-api/sethub-app/{appId}":{"get":{"operationId":"SethubAppsController_conversation","parameters":[{"name":"appId","required":true,"in":"path","schema":{"type":"string"}},{"name":"question","required":true,"in":"query","description":"The question to search for","schema":{"example":"How do I submit a vacation request?","type":"string"}},{"name":"lastOpenedEntryTitle","required":false,"in":"query","description":"The title of the last opened entry","schema":{"example":"Vacation Request Process","type":"string"}},{"name":"threadId","required":false,"in":"query","description":"The thread ID of the search","schema":{"example":"123e4567-e89b-12d3-a456-426614174000","type":"string"}}],"responses":{"200":{"description":"Returns answer based on search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SethubAppChatResult"}}}}},"summary":"Ask AI","tags":["SethubApps"]}},"/handbook-api/sethub-nav/{appId}/request":{"post":{"description":"Processes a navigation request and returns helpful guidance with possible navigation paths.","operationId":"SethubNavController_processNavRequest","parameters":[{"name":"appId","required":true,"in":"path","schema":{"type":"string"}},{"name":"sessionId","required":true,"in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SethubNavRequestDto"}}}},"responses":{"200":{"description":"Navigation request processed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SethubNavRequestResponse"}}}},"400":{"description":"Invalid request data"}},"summary":"Process navigation request","tags":["Sethub Nav"]}},"/handbook-api/sethub-products/{appId}/{pageId}/{areaId}":{"post":{"operationId":"SethubProductsController_getProductList","parameters":[{"name":"appId","required":true,"in":"path","schema":{"type":"string"}},{"name":"pageId","required":true,"in":"path","schema":{"type":"string"}},{"name":"areaId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SethubProductListDto"}}}},"responses":{"200":{"description":"Product mapping list and total count","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SethubProductListResponse"}}}}},"summary":"Get product mapping list for a product search","tags":["Sethub Products"]}},"/handbook-api/sethub-products/search/{appId}/{productSearchId}":{"get":{"operationId":"SethubProductsController_getProductSearch","parameters":[{"name":"appId","required":true,"in":"path","schema":{"type":"string"}},{"name":"productSearchId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Product search","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SethubProductSearchResponse"}}}}},"summary":"Get product search","tags":["Sethub Products"]}},"/handbook-api/sethub-user-action/comment":{"post":{"operationId":"SethubUserActionController_generateActionComment","parameters":[{"name":"sessionId","required":true,"in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserActionDto"}}}},"responses":{"200":{"description":""}},"tags":["SethubUserAction"]}}},"info":{"title":"Handbook-API","description":"The Handbook-API description","version":"1.0","contact":{}},"tags":[],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"HandbookEntryDto":{"type":"object","properties":{"title":{"type":"string","description":"Optional title for the handbook entry","example":"Meeting Notes - Project Kickoff"},"content":{"type":"string","description":"The content of the handbook entry. IS ONLY OPTIONAL when using voice input.","example":"This is the content of the handbook entry"},"active":{"type":"boolean","description":"Whether the entry is active","example":false},"app":{"type":"string","description":"The app associated with this entry","example":"szales"},"tags":{"description":"The tags associated with this entry","example":["meeting","project","kickoff"],"type":"array","items":{"type":"string"}},"importId":{"type":"string","description":"The import ID of the handbook entry, used to idenfity entries imported from sethub langauge content","example":"6336ae44dace2c2aef00870f"}},"required":["title","active","app"]},"HandbookEntry":{"type":"object","properties":{"_id":{"type":"string","description":"The ID of the handbook entry","example":"65c4e1f5e4b0a1234567890a"},"title":{"type":"string","description":"The title of the handbook entry","example":"Getting Started"},"content":{"type":"string","description":"The content of the handbook entry in markdown format","example":"# Getting Started\n\nThis guide will help you..."},"tags":{"description":"Tags associated with this entry","example":["setup","configuration"],"type":"array","items":{"type":"string"}},"active":{"type":"boolean","description":"Whether the entry is active","example":false},"milvusIds":{"description":"The Milvus IDs of the entry","example":["1234567890","1234567891"],"type":"array","items":{"type":"string"}},"s3FilePath":{"type":"string","description":"The S3 file path of the entry","example":"audio/1234567890.mp3"},"s3FileType":{"type":"string","description":"The S3 file type of the entry","example":"audio/mpeg"},"app":{"type":"string","description":"The app associated with this entry","example":"szales"},"createdAt":{"type":"string","description":"Creation timestamp","example":"2024-03-20T10:00:00Z"},"updatedAt":{"type":"string","description":"Last update timestamp","example":"2024-03-20T10:00:00Z"},"importId":{"type":"string","description":"The import ID of the handbook entry, used to idenfity entries imported from sethub langauge content","example":"6336ae44dace2c2aef00870f"}},"required":["_id","title","content","tags","active","milvusIds","s3FilePath","s3FileType","app","createdAt","updatedAt","importId"]},"HandbookOverviewEntry":{"type":"object","properties":{"_id":{"type":"string","description":"The ID of the handbook entry","example":"65c4e1f5e4b0a1234567890a"},"title":{"type":"string","description":"The title of the handbook entry","example":"Meeting Notes - Project Kickoff"},"app":{"type":"string","description":"The app associated with this entry","example":"szales","enum":["szales","sethub","admin"]},"tags":{"description":"The tags associated with this entry","example":["meeting","project","kickoff"],"type":"array","items":{"type":"string"}}},"required":["_id","title","app","tags"]},"HandbookOverviewResponse":{"type":"object","properties":{"entries":{"description":"List of handbook entries","type":"array","items":{"$ref":"#/components/schemas/HandbookOverviewEntry"}}},"required":["entries"]},"HandbookTagsResponse":{"type":"object","properties":{"tags":{"description":"The tags associated with this entry","example":["meeting","project","kickoff"],"type":"array","items":{"type":"string"}}},"required":["tags"]},"VoiceHandbookEntryDto":{"type":"object","properties":{"title":{"type":"string","description":"Optional title for the handbook entry","example":"Meeting Notes - Project Kickoff"},"content":{"type":"string","description":"The content of the handbook entry. IS ONLY OPTIONAL when using voice input.","example":"This is the content of the handbook entry"},"active":{"type":"boolean","description":"Whether the entry is active","example":false},"app":{"type":"string","description":"The app associated with this entry","example":"szales"},"tags":{"description":"The tags associated with this entry","example":["meeting","project","kickoff"],"type":"array","items":{"type":"string"}},"importId":{"type":"string","description":"The import ID of the handbook entry, used to idenfity entries imported from sethub langauge content","example":"6336ae44dace2c2aef00870f"},"links":{"type":"string","description":"The links associated with this entry","example":"[{ title: 'Getting Started', url: 'https://example.com' }]"},"s3FilePath":{"type":"string","description":"The S3 file path of the entry. Will be set automatically by the backend.","example":"audio/1234567890.mp3"},"s3FileType":{"type":"string","description":"The S3 file type of the entry. Will be set automatically by the backend.","example":"audio/mpeg"},"editedText":{"type":"string","description":"The text from voice that was edited by the user and is now used as entry text.","example":"Meeting Notes - Project Kickoff"},"file":{"type":"string","description":"The file associated with this entry","format":"binary"}},"required":["title","active","app","links"]},"HandbookVoiceResponse":{"type":"object","properties":{"text":{"type":"string","description":"The text of the recorded voice","example":"Meeting Notes - Project Kickoff"}},"required":["text"]},"ChatResult":{"type":"object","properties":{"answer":{"type":"string","description":"The answer generated from the search results","example":"Based on the handbook entries, the process for submitting a vacation request is..."},"threadId":{"type":"string","description":"The thread ID of the search","example":"123e4567-e89b-12d3-a456-426614174000"},"possibleQuestions":{"description":"The possible next actions","example":["View product","View article","View FAQ"],"type":"array","items":{"type":"string"}}},"required":["answer","threadId"]},"ConversationOverviewResult":{"type":"object","properties":{"threadId":{"type":"string","description":"Unique identifier for the conversation thread","example":"123e4567-e89b-12d3-a456-426614174000"},"lastMessage":{"type":"string","description":"Last message in the conversation thread, truncated to 100 characters if needed","example":"Hello, how can I help you today?"},"messageCount":{"type":"number","description":"Total number of messages in the conversation thread","example":5},"updatedAt":{"type":"string","description":"Timestamp of when the conversation was last updated","example":"2023-12-25T12:00:00Z"}},"required":["threadId","lastMessage","messageCount","updatedAt"]},"ContextDto":{"type":"object","properties":{"keywords":{"description":"The query to search for relevant documents","example":"How do I submit a vacation request?","type":"array","items":{"type":"string"}},"app":{"type":"string","description":"The app to use for the search","example":"szales"}},"required":["keywords"]},"ContextResult":{"type":"object","properties":{"context":{"type":"string","description":"The raw context built from relevant document chunks","example":"Document 1 content...\n\nDocument 2 content..."}},"required":["context"]},"ConversationMessage":{"type":"object","properties":{"role":{"type":"string","description":"Role of the message sender","example":"user"},"content":{"type":"string","description":"Content of the message","example":"Hello, how can I help you today?"},"createdAt":{"type":"string","description":"Timestamp when the message was created","example":"2023-12-25T12:00:00Z"}},"required":["role","content","createdAt"]},"ConversationDetailResult":{"type":"object","properties":{"threadId":{"type":"string","description":"Unique identifier for the conversation thread","example":"123e4567-e89b-12d3-a456-426614174000"},"messages":{"description":"List of messages in the conversation","type":"array","items":{"$ref":"#/components/schemas/ConversationMessage"}}},"required":["threadId","messages"]},"JoinLichtbotDto":{"type":"object","properties":{"roomToken":{"type":"string","description":"The unique token identifying the chat room that LichtBOT should join"}},"required":["roomToken"]},"LeaveLichtbotDto":{"type":"object","properties":{"roomToken":{"type":"string","description":"The unique token identifying the chat room that LichtBOT should leave"}},"required":["roomToken"]},"AdvisorsStatus":{"type":"string","enum":["online","offline","busy"],"description":"Status of the client advisors"},"LichtbotClientMessageDto":{"type":"object","properties":{"roomToken":{"type":"string","description":"Token of the chat room. Used to identify the chat room. Is equal in all messages of the same chat room."},"message":{"type":"string","description":"Content of the message"},"status":{"description":"Status of the client advisors","allOf":[{"$ref":"#/components/schemas/AdvisorsStatus"}]}},"required":["roomToken","message","status"]},"AnonymizeTextDto":{"type":"object","properties":{"text":{"type":"string","description":"The text to analyze/anonymize","example":"My name is John Doe and my phone number is 123-456-7890"}},"required":["text"]},"SummaryResult":{"type":"object","properties":{"summary":{"type":"string","description":"The summary of the content","example":"This is the summary of the content"}},"required":["summary"]},"SethubAppContextDto":{"type":"object","properties":{"keywords":{"description":"The keywords to search for relevant documents","example":["vacation","request","process"],"type":"array","items":{"type":"string"}},"appId":{"type":"string","description":"The app ID to search in","example":"my-app-123"}},"required":["keywords"]},"SethubAppContextResult":{"type":"object","properties":{"context":{"type":"string","description":"The raw context built from relevant document chunks","example":"Document 1 content...\n\nDocument 2 content..."}},"required":["context"]},"StructuredAnswerEntry":{"type":"object","properties":{"title":{"type":"string","description":"The title of the entry","example":"Vacation Request Process"},"shortDescription":{"type":"string","description":"Optional short description of the entry","example":"Step-by-step guide for submitting vacation requests"},"templateId":{"type":"string","description":"The template ID of the entry","example":"vacation-request-template-123"},"slug":{"type":"string","description":"Optional slug for the entry","example":"vacation-request-process"}},"required":["title","templateId"]},"StructuredAnswer":{"type":"object","properties":{"answer":{"type":"string","description":"The main answer text","example":"Based on the handbook entries, the process for submitting a vacation request is..."},"entries":{"description":"Array of structured answer entries","type":"array","items":{"$ref":"#/components/schemas/StructuredAnswerEntry"}}},"required":["answer","entries"]},"SethubAppChatResult":{"type":"object","properties":{"answer":{"type":"string","description":"The answer generated from the search results","example":"Based on the handbook entries, the process for submitting a vacation request is..."},"structuredAnswer":{"description":"The structured answer","example":{"answer":"Based on the handbook entries, the process for submitting a vacation request is...","entries":[{"title":"Vacation Request","templateId":"123"}]},"allOf":[{"$ref":"#/components/schemas/StructuredAnswer"}]},"threadId":{"type":"string","description":"The thread ID of the search","example":"123e4567-e89b-12d3-a456-426614174000"},"possibleNextQuestions":{"description":"The possible next questions","example":["What is the process for submitting a vacation request?","What is the process for submitting a vacation request?"],"type":"array","items":{"type":"string"}}},"required":["answer","structuredAnswer","threadId","possibleNextQuestions"]},"SethubNavPageDto":{"type":"object","properties":{"description":{"type":"string","description":"Description of the current page.","example":"This page shows the dashboard overview."},"title":{"type":"string","description":"Title of the current page.","example":"Dashboard"},"path":{"type":"string","description":"Path of the current page.","example":"/dashboard"},"searchQuery":{"type":"string","description":"Optional search query related to the current page.","example":"user statistics"}},"required":["description","title","path"]},"SethubNavRequestDto":{"type":"object","properties":{"currentPage":{"description":"The current page context.","allOf":[{"$ref":"#/components/schemas/SethubNavPageDto"}]},"question":{"type":"string","description":"Optional user question for navigation.","example":"How do I access my profile settings?"}},"required":["currentPage"]},"SethubNavRequestResponse":{"type":"object","properties":{"answer":{"type":"string","description":"The answer generated for the navigation request.","example":"You can find your profile settings under the \"Account\" section."},"navigationPath":{"type":"string","description":"The navigation path as a string of page titles or identifiers.","example":"/home"},"productSearchId":{"type":"string","description":"The ID of the product search.","example":"123"},"possibleQuestions":{"description":"Possible follow-up questions or suggestions for the user.","example":["Show me my account details","How do I change my password?"],"type":"array","items":{"type":"string"}}},"required":["answer"]},"SethubProductListDto":{"type":"object","properties":{"skip":{"type":"number","description":"Number of items to skip","example":0,"minimum":0},"limit":{"type":"number","description":"Maximum number of items to return","example":20,"minimum":1},"productSearchId":{"type":"string","description":"ID of the product search","example":"64e8b7c2f1a2b3c4d5e6f7a8"}},"required":["skip","limit","productSearchId"]},"SethubProductListResponse":{"type":"object","properties":{"mapping":{"type":"object","description":"List of product mappings, keyed by lcId."},"total":{"type":"number","description":"Total number of products in the search."}},"required":["mapping","total"]},"SethubProductSearchResponse":{"type":"object","properties":{"aiText":{"type":"string","description":"The AI text of the product search.","example":"The AI text of the product search."},"possibleQuestions":{"description":"The possible questions of the product search.","example":["The possible questions of the product search."],"type":"array","items":{"type":"string"}}},"required":["aiText","possibleQuestions"]},"SethubProductVectorDto":{"type":"object","properties":{}},"SethubProductsDto":{"type":"object","properties":{}},"UserActionDto":{"type":"object","properties":{}}}}}