@aiqa/sdk 2.2.0 → 2.3.0-develop.1

package/README.md

@@ -129,6 +129,7 @@ going so far.
     agent_id: string;
     agent_first_name: string;
     agent_last_name: string;
+    external_status?: string;
     verification?: ApplicationVerificationSummary;
   }
   ```
@@ -140,6 +141,12 @@ going so far.
   [Reading `verification`](#reading-verification) for the exception.
   `agent_first_name` and `agent_last_name` come back empty; use
   `updateConversation({ agentName })` if you need to record an agent's name.
+  `external_status` is the value you last sent with
+  `updateConversation({ externalStatus })`, lowercased — one of
+  [`ExternalStatus`](#externalstatus) — and is **missing** until you send one.
+  Read it to recover the status after a reconnect instead of keeping your own
+  copy. It is the one field here that never comes from the authentication
+  snapshot, so on the fallback path it is absent rather than stale.
 
 ```typescript
 const application = await sdk.getApplication();
@@ -296,6 +303,8 @@ a timeout, a rejected payload.
     question: string;
     expected_answer: any;
     answer_format: { type: "STRING" }
+    /** Optional (default: `false`). Use `true` when the fact was collected before the conversation started. It is stored, not verified. */
+    prefilled?: boolean
     /**
      * Optional. Your own identifiers for this fact — a form field ID, a
      * section name, anything that lets your UI map the result back to the
@@ -506,6 +515,8 @@ Rules:
   `unmatched`). Show progress from the `FACT_VERIFIED` event, show the final
   result from the Promise.
 - **Handle a `verification_status` you don't recognize as `processing`.**
+- **A fact sent with `prefilled: true` is never verified**, so it gets no
+  `verification_status` and no `FACT_VERIFIED` event.
 - **`pending_confirmation_*` is never final.** The answer can still change,
   so don't show it as a decision.
 - **A fact can be revised after `addFact()` has resolved.** If you keep its
@@ -527,6 +538,10 @@ type Application = {
   agent_id: string;
   agent_first_name: string; // comes back empty
   agent_last_name: string; // comes back empty
+  // The externalStatus you last sent, lowercased. Missing until you send one
+  // — not the same as "draft". Never in the authentication snapshot, so on the
+  // fallback path below it is absent, not stale.
+  external_status?: ExternalStatus | (string & {});
   // Missing when there is no summary for the call — not the same as zeros.
   // See "Reading verification" above.
   verification?: ApplicationVerificationSummary;
@@ -725,6 +740,8 @@ type ApplicationFactInput = {
   // and one of them sets status to "critical_errors".
   critical?: boolean;
   is_skipped?: boolean;
+  /** Optional (default: `false`). Use `true` when the fact was collected before the conversation started. It is stored, not verified. */
+  prefilled?: boolean;
   /**
    * Optional. Your own identifiers for this fact — a form field ID, a section
    * name, anything that lets your UI map the result back to the right place.

package/dist/browser/browser.d.ts

@@ -56,6 +56,17 @@ type Application = {
     agent_first_name: string;
     /** Comes back empty. Set an agent name with `updateConversation()`. */
     agent_last_name: string;
+    /**
+     * The status you last reported with `updateConversation({ externalStatus })`,
+     * folded to lowercase by the server. Missing when you never reported one —
+     * which is not the same as `"draft"`. Unlike the fields above it is never in
+     * the authentication snapshot, so on the fallback path described under
+     * `verification` it is absent rather than stale.
+     *
+     * Same open union as the input side: the members autocomplete, and a status
+     * the server learns before this package does still type-checks.
+     */
+    external_status?: ExternalStatus | (string & {});
     /**
      * How the call is going so far. When it is missing there is no summary —
      * which is not the same as all zeros — and the fields above may then be the
@@ -170,6 +181,8 @@ type ApplicationFactInput = {
      */
     critical?: boolean;
     is_skipped?: boolean;
+    /** Optional (default: `false`). Use `true` when the fact was collected before the conversation started. It is stored, not verified. */
+    prefilled?: boolean;
     /**
      * Your own identifiers for this fact — a form field ID, a section name,
      * anything that lets your UI map the result back to the right place.
@@ -217,6 +230,7 @@ interface AddFactResult {
     answer_type?: string;
     agent_answer?: string;
     ai_answer?: string;
+    /** `false` for a fact that was never verified, such as a prefilled one. */
     is_valid_answer: boolean;
     question_asked?: boolean;
     /**

package/dist/browser/browser.js

@@ -3406,7 +3406,7 @@ var compareVersions = (left, right) => {
 // package.json
 var package_default = {
   name: "@aiqa/sdk",
-  version: "2.2.0-develop.1",
+  version: "2.2.0-develop.3",
   main: "dist/node/node.js",
   module: "dist/node/node.js",
   types: "dist/node/node.d.ts",