Update TypeSpec definitions to match backend API implementation (#13775)

* Update TypeSpec definitions to match backend API implementation

- Updated TenantID union with all 10 tenant IDs from Go backend
- Updated Source union with all 25 data sources from Go backend
- Fixed Intention model to include all fields (spec_type, needs_rag_processing, question_scope, service_type)
- Added missing fields to CompletionRequest (intention) and CompletionResponse (reasoning_progress, route_tenant)
- Fixed authentication: changed from X-API-Key to optional Bearer token
- Added package.json and tspconfig.yaml to enable TypeSpec compilation
- Added .gitignore to exclude node_modules and tsp-output

* update server link

* Fix ErrorResponse model to match APIError structure from Go backend

* Add SimpleErrorResponse for feedback API.

* update package.json

* merge main and adopt authoring  code change

---------

Co-authored-by: Renhe Li <renhel@microsoft.com>
Co-authored-by: ReleaseHelper <ReleaseHelper>

Author: lirenhe

tools/sdk-ai-bots/azure-sdk-qa-bot-backend/tsp/.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+tsp-output/

tools/sdk-ai-bots/azure-sdk-qa-bot-backend/tsp/main.tsp

@@ -11,10 +11,10 @@ using TypeSpec.Versioning;
 
 @service({
   title: "Azure SDK QA Assistant Service",
-  version: "0.0.1"
 })
-@server("https://azuresdkbot-azuresdkbot-dev-czhxctdndmfdb5hq.eastasia-01.azurewebsites.net", "Development server")
-@server("https://azuresdkbot-dqh7g6btekbfa3hh.eastasia-01.azurewebsites.net", "Production server")
+@server("https://azuresdkqabot-dev-server-hrcrckaad5gcedcv.westus2-01.azurewebsites.net", "Development server")
+@server("https://azuresdkqabot-test-server-cbdbh2gva6h7hrfr.westus2-01.azurewebsites.net", "Testing server")
+@server("https://azuresdkqabot-server-c8czabhzhweadwgu.westus2-01.azurewebsites.net", "Production server")
 @versioned(Versions)
 namespace AzureSDK.QAAssistant;
 

tools/sdk-ai-bots/azure-sdk-qa-bot-backend/tsp/model.tsp

@@ -8,14 +8,38 @@ namespace AzureSDK.QAAssistant;
 
 @doc("Available tenant IDs for the QA bot service")
 union TenantID {
-  @doc("Default TypeSpec QA bot")
-  TypespecQABot: "typespec_qa_bot",
+  @doc("Default Azure SDK QA bot")
+  AzureSDKQaBot: "azure_sdk_qa_bot",
 
   @doc("TypeSpec extension bot")
   TypeSpecExtension: "typespec_extension",
 
   @doc("Python channel QA bot")
   PythonChannelQaBot: "python_channel_qa_bot",
+  
+  @doc(".NET channel QA bot")
+  DotnetChannelQaBot: "dotnet_channel_qa_bot",
+  
+  @doc("Azure SDK onboarding bot")
+  AzureSDKOnboarding: "azure_sdk_onboarding",
+  
+  @doc("Golang channel QA bot")
+  GolangChannelQaBot: "golang_channel_qa_bot",
+  
+  @doc("Java channel QA bot")
+  JavaChannelQaBot: "java_channel_qa_bot",
+  
+  @doc("JavaScript channel QA bot")
+  JavaScriptChannelQaBot: "javascript_channel_qa_bot",
+  
+  @doc("General QA bot")
+  GeneralQaBot: "general_qa_bot",
+  
+  @doc("API spec review bot")
+  APISpecReviewBot: "api_spec_review_bot",
+  
+  @doc("Azure TypeSpec authoring bot")
+  AzureTypespecAuthoring: "azure_typespec_authoring",
 }
 
 @doc("Available data sources for knowledge retrieval")
@@ -43,6 +67,51 @@ union Source {
 
   @doc("Azure Resource Manager RPC")
   AzureResourceManagerRPC: "azure_resource_manager_rpc",
+  
+  @doc("TypeSpec migration documentation")
+  TypeSpecMigration: "static_typespec_migration_docs",
+  
+  @doc("Azure SDK documentation engineering")
+  AzureSDKDocsEng: "azure-sdk-docs-eng",
+  
+  @doc("Azure SDK internal wiki")
+  AzureSDKInternalWiki: "azure-sdk-internal-wiki",
+  
+  @doc("Azure SDK guidelines")
+  AzureSDKGuidelines: "azure-sdk-guidelines",
+  
+  @doc("TypeSpec Azure HTTP specs")
+  TypeSpecAzureHttpSpecs: "typespec_azure_http_specs",
+  
+  @doc("TypeSpec HTTP specs")
+  TypeSpecHttpSpecs: "typespec_http_specs",
+  
+  @doc("Azure SDK for Go documentation")
+  AzureSDKForGoDocs: "azure_sdk_for_go_docs",
+  
+  @doc("Static Azure documentation")
+  StaticAzureDocs: "static_azure_docs",
+  
+  @doc("TypeSpec to Swagger mapping")
+  StaticTypeSpecToSwaggerMapping: "static_typespec_to_swagger_mapping",
+  
+  @doc("Azure SDK for Java documentation")
+  AzureSDKForJavaDocs: "azure_sdk_for_java_docs",
+  
+  @doc("Azure SDK for Java wiki")
+  AzureSDKForJavaWiki: "azure_sdk_for_java_wiki",
+  
+  @doc("Autorest Java documentation")
+  AutorestJavaDocs: "autorest_java_docs",
+  
+  @doc("Azure SDK for JavaScript documentation")
+  AzureSDKForJavaScriptDocs: "azure_sdk_for_js_docs",
+  
+  @doc("Azure SDK for JavaScript wiki")
+  AzureSDKForJavaScriptWiki: "azure_sdk_for_js_wiki",
+  
+  @doc("Azure SDK for .NET documentation")
+  AzureSDKForNetDocs: "azure_sdk_for_net_docs",
 }
 
 @doc("Message roles in the conversation")
@@ -64,6 +133,9 @@ union AdditionalInfoType {
 
   @doc("Image content")
   Image: "image",
+  
+  @doc("Text content")
+  Text: "text",
 }
 
 @doc("User reaction types for feedback")
@@ -75,9 +147,9 @@ union Reaction {
   Bad: "bad",
 }
 
-@doc("Question categorization for intent analysis")
-union QuestionCategory {
-  @doc("Unknown category")
+@doc("Question scope for intent analysis")
+union QuestionScope {
+  @doc("Unknown scope")
   Unknown: "unknown",
 
   @doc("Branded question (specific to Azure/Microsoft products)")
@@ -87,6 +159,18 @@ union QuestionCategory {
   Unbranded: "unbranded",
 }
 
+@doc("Service type for filtering")
+union ServiceType {
+  @doc("Unknown service type")
+  Unknown: "unknown",
+  
+  @doc("Data plane service")
+  DataPlane: "data-plane",
+  
+  @doc("Management plane service")
+  ManagementPlane: "management-plane",
+}
+
 @doc("A message in the conversation")
 model Message {
   @doc("The role of the message sender")
@@ -95,9 +179,6 @@ model Message {
   @doc("The content of the message")
   content: string;
 
-  @doc("The raw content of the message, used for searching")
-  raw_content?: string;
-  
   @doc("The name of the message sender, used for system messages")
   name?: string;
 }
@@ -130,25 +211,31 @@ model AdditionalInfo {
 }
 
 @doc("Intent analysis result for the question")
-model IntensionResult {
+model Intention {
   @doc("The question to ask the agent")
   question: string;
 
   @doc("The category of the question")
-  category: QuestionCategory;
+  category: string;
+  
+  @doc("The type of the spec, such as typespec, azure rest api, etc.")
+  spec_type?: string;
+  
+  @doc("Whether to invoke RAG workflow")
+  needs_rag_processing: boolean;
+  
+  @doc("The scope of the question")
+  question_scope?: QuestionScope;
+  
+  @doc("The service type for filtering")
+  service_type?: ServiceType;
 }
 
 @doc("Request for chat completion")
 model CompletionRequest {
   @doc("The tenant ID of the agent")
   tenant_id: TenantID;
 
-  @doc("The prompt template to use for the agent")
-  prompt_template?: string;
-  
-  @doc("The arguments to use for the prompt template")
-  prompt_template_arguments?: string;
-  
   @doc("The number of top K documents to search for the answer. Default is 10")
   top_k?: int32;
 
@@ -169,6 +256,9 @@ model CompletionRequest {
 
   @doc("Additional information to provide to the agent, such as links or images")
   additional_infos?: AdditionalInfo[];
+  
+  @doc("Optional intention fields that override LLM intention recognition results")
+  intention?: Intention;
 }
 
 @doc("Response from chat completion")
@@ -189,7 +279,13 @@ model CompletionResponse {
   full_context?: string;
 
   @doc("The intention analysis of the question")
-  intension?: IntensionResult;
+  intention?: Intention;
+  
+  @doc("The reasoning progress of generating the answer")
+  reasoning?: string;
+  
+  @doc("The tenant ID the question is routed to")
+  route_tenant?: TenantID;
 }
 
 @doc("Request for submitting feedback")
@@ -224,23 +320,90 @@ model FeedbackResponse {
   // Empty response model
 }
 
-@doc("Error response")
+@doc("Simple error response used by feedback API")
 @error
-model ErrorResponse {
+model SimpleErrorResponse {
   @doc("Error message")
   error: string;
 }
 
-@doc("Unauthorized error response")
-@error
-model UnauthorizedError {
-  @doc("Error message indicating authentication failure")
-  error: "Unauthorized - API key is missing or invalid";
+@doc("Error codes for the service")
+union ErrorCode {
+  // Client Error Codes (4xx)
+  @doc("Invalid request format or parameters")
+  InvalidRequest: "INVALID_REQUEST",
+  
+  @doc("Message field is missing")
+  MissingMessage: "MISSING_MESSAGE",
+  
+  @doc("Message content is empty")
+  EmptyContent: "EMPTY_CONTENT",
+  
+  @doc("Invalid tenant ID provided")
+  InvalidTenantID: "INVALID_TENANT_ID",
+  
+  @doc("Authentication failed")
+  Unauthorized: "UNAUTHORIZED",
+  
+  // Server Error Codes (5xx)
+  @doc("Service initialization failed")
+  ServiceInitFailure: "SERVICE_INIT_FAILURE",
+  
+  @doc("LLM service call failed")
+  LLMServiceFailure: "LLM_SERVICE_FAILURE",
+  
+  @doc("LLM rate limit exceeded")
+  LLMRateLimitFailure: "LLM_RATE_LIMIT_FAILURE",
+  
+  @doc("Search service call failed")
+  SearchFailure: "SEARCH_FAILURE",
+  
+  @doc("Internal server error")
+  InternalError: "INTERNAL_ERROR",
+}
+
+@doc("Error category for monitoring and alerting")
+union ErrorCategory {
+  @doc("Validation error")
+  Validation: "validation",
+  
+  @doc("Authentication error")
+  Authentication: "authentication",
+  
+  @doc("Authorization error")
+  Authorization: "authorization",
+  
+  @doc("Rate limit error")
+  RateLimit: "rate limit",
+  
+  @doc("Service error")
+  Service: "service",
+  
+  @doc("Dependency error")
+  Dependency: "dependency",
+  
+  @doc("Internal error")
+  Internal: "internal",
 }
 
-@doc("API Key authentication scheme")
-model ApiKeyAuth {
-  @doc("API key for authentication")
-  @header("X-API-Key")
-  apiKey: string;
+@doc("Structured API error response")
+@error
+model ErrorResponse {
+  @doc("Error code identifying the type of error")
+  code: ErrorCode;
+  
+  @doc("Human-readable error message")
+  message: string;
+  
+  @doc("Error category for monitoring and alerting")
+  category: ErrorCategory;
+  
+  @doc("Additional error details")
+  details?: unknown;
+  
+  @doc("Request ID for tracing")
+  request_id?: string;
+  
+  @doc("Timestamp when the error occurred")
+  timestamp?: string;
 }