@aiqa/sdk 1.2.0 → 1.3.0

package/README.md

@@ -14,6 +14,7 @@ A TypeScript/JavaScript SDK for interacting with the AIQA WebSocket service. Thi
   - [Fact Management](#fact-management)
   - [Event Handling](#event-handling)
 - [Types](#types)
+  - [FlagFactResult](#flagfactresult)
 - [Examples](#examples)
 - [Error Handling](#error-handling)
 - [Semantic Versioning](#semantic-versioning)
@@ -175,6 +176,23 @@ facts.forEach((fact) => {
 });
 ```
 
+#### `flagFact(factId)`
+
+Flags a fact for human review. Creates a signal that allow AIQA to improve review quality.
+
+**Parameters:**
+
+- `factId: string` - the `id` of the fact to flag (must match the `id` used in `addFact()`)
+
+**Returns:**
+
+- `Promise<FlagFactResult>` — `{ success: boolean }`
+
+```typescript
+const result = await sdk.flagFact("fact-123");
+console.log(result.success); // true
+```
+
 ### Recording Management
 
 #### `startRecording()`
@@ -309,6 +327,16 @@ type ApplicationFactInput = {
 };
 ```
 
+### FlagFactResult
+
+Returned by `flagFact()`.
+
+```typescript
+type FlagFactResult = {
+  success: boolean;
+};
+```
+
 ### ConversationLanguage
 
 ```typescript

package/dist/browser/browser.d.ts

@@ -15,6 +15,7 @@ declare enum Methods {
     STOP_RECORDING = "STOP_RECORDING",
     IS_RECORDING = "IS_RECORDING",
     ADD_FACT = "ADD_FACT",
+    FLAG_FACT = "FLAG_FACT",
     SET_CONVERSATION_PRODUCT = "SET_CONVERSATION_PRODUCT",
     SET_CONVERSATION_LANGUAGE = "SET_CONVERSATION_LANGUAGE"
 }
@@ -75,7 +76,11 @@ interface AddFactResult {
     ai_answer?: string;
     is_valid_answer: boolean;
     question_asked?: boolean;
+    metadata?: Record<string, string>;
 }
+type FlagFactResult = {
+    success: boolean;
+};
 type SdkError = {
     code: "INVALID_CONFIG" | "CONNECTION_ERROR" | "TIMEOUT" | "SERVER_ERROR" | "UNEXPECTED_RESPONSE";
     message: string;
@@ -88,6 +93,7 @@ declare abstract class IAiqaSdk {
     abstract off(eventName: string): void;
     abstract getApplication(): Promise<Application>;
     abstract addFact(fact: ApplicationFactInput): Promise<AddFactResult>;
+    abstract flagFact(factId: string): Promise<FlagFactResult>;
     abstract getFacts(): Promise<ApplicationFact[]>;
     abstract setConversationProduct(product: string): Promise<SetConversationProductResult>;
     abstract setConversationLanguage(language: ConversationLanguage): Promise<SetConversationLanguageResult>;
@@ -110,6 +116,7 @@ declare class AiQaSdk implements IAiqaSdk {
     getApplication(): Promise<Application>;
     getFacts(): Promise<ApplicationFact[]>;
     addFact(fact: ApplicationFactInput): Promise<AddFactResult>;
+    flagFact(factId: string): Promise<FlagFactResult>;
     setConversationProduct(product: string): Promise<SetConversationProductResult>;
     setConversationLanguage(language: ConversationLanguage): Promise<SetConversationLanguageResult>;
     authenticate(): Promise<void>;
@@ -121,4 +128,4 @@ declare class AiQaSdk implements IAiqaSdk {
     private isManagerEvent;
 }
 
-export { type AddFactResult, AiQaSdk, type Application, type ApplicationFact, type ApplicationFactAnswerChoice, type ApplicationFactAnswerFormat, type ApplicationFactInput, ConversationLanguage, FactAnswerFormatType, IAiqaSdk, Methods, type QuestionStatus, type SdkError, type SdkEvent, type SetConversationLanguageResult, type SetConversationProductResult, type VerificationStatus };
+export { type AddFactResult, AiQaSdk, type Application, type ApplicationFact, type ApplicationFactAnswerChoice, type ApplicationFactAnswerFormat, type ApplicationFactInput, ConversationLanguage, FactAnswerFormatType, type FlagFactResult, IAiqaSdk, Methods, type QuestionStatus, type SdkError, type SdkEvent, type SetConversationLanguageResult, type SetConversationProductResult, type VerificationStatus };

package/dist/browser/browser.js

@@ -3345,6 +3345,7 @@ var Methods = /* @__PURE__ */ ((Methods2) => {
   Methods2["STOP_RECORDING"] = "STOP_RECORDING";
   Methods2["IS_RECORDING"] = "IS_RECORDING";
   Methods2["ADD_FACT"] = "ADD_FACT";
+  Methods2["FLAG_FACT"] = "FLAG_FACT";
   Methods2["SET_CONVERSATION_PRODUCT"] = "SET_CONVERSATION_PRODUCT";
   Methods2["SET_CONVERSATION_LANGUAGE"] = "SET_CONVERSATION_LANGUAGE";
   return Methods2;
@@ -3395,7 +3396,7 @@ var compareVersions = (left, right) => {
 // package.json
 var package_default = {
   name: "@aiqa/sdk",
-  version: "1.1.0-develop.1",
+  version: "1.2.0",
   main: "dist/node/node.js",
   module: "dist/node/node.js",
   types: "dist/node/node.d.ts",
@@ -3630,6 +3631,12 @@ var AiQaSdk = class {
     const result = await this.sendMessage("ADD_FACT" /* ADD_FACT */, payload);
     return result && result.data !== void 0 ? result.data : result;
   }
+  async flagFact(factId) {
+    const result = await this.sendMessage("FLAG_FACT" /* FLAG_FACT */, {
+      factId
+    });
+    return result && result.data !== void 0 ? result.data : result;
+  }
   async setConversationProduct(product) {
     const result = await this.sendMessage("SET_CONVERSATION_PRODUCT" /* SET_CONVERSATION_PRODUCT */, {
       product