@marketrix.ai/widget 3.8.117 → 3.8.134

package/dist/src/sdk/contract.d.ts

@@ -388,7 +388,7 @@ export declare const widgetContract: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;
@@ -419,7 +419,7 @@ export declare const widgetContract: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;

package/dist/src/sdk/contracts/entities.d.ts

@@ -16,20 +16,13 @@ export declare const KnowledgeSourceSchema: z.ZodEnum<{
     research: "research";
 }>;
 export type KnowledgeSource = z.infer<typeof KnowledgeSourceSchema>;
-export declare const QAFlowStatusSchema: z.ZodEnum<{
-    pending: "pending";
-    processing: "processing";
-    waiting_review: "waiting_review";
-    completed: "completed";
-    failed: "failed";
-}>;
 export declare const SimulationStatusSchema: z.ZodEnum<{
-    completed: "completed";
-    failed: "failed";
     queued: "queued";
     running: "running";
     creating_knowledge: "creating_knowledge";
     has_question: "has_question";
+    completed: "completed";
+    failed: "failed";
     stopped: "stopped";
 }>;
 export type SimulationStatus = z.infer<typeof SimulationStatusSchema>;
@@ -39,9 +32,9 @@ export type SimulationStatus = z.infer<typeof SimulationStatusSchema>;
  * `simulation/graph-updated` app event.
  */
 export declare const GraphStatusSchema: z.ZodEnum<{
-    pending: "pending";
     completed: "completed";
     failed: "failed";
+    pending: "pending";
     generating: "generating";
 }>;
 export declare const ApplicationTypeSchema: z.ZodEnum<{
@@ -172,15 +165,20 @@ export declare const KnowledgeEntitySchema: z.ZodObject<{
 }, z.core.$strip>;
 export type KnowledgeData = z.infer<typeof KnowledgeEntitySchema>;
 /**
- * QA verdict entity schemas — LLM evaluator output per (qa_run, qa_test_case).
- * Independent of simulation task status (which keeps raw execution semantics).
+ * Device viewport — the only device dimension (Chrome-only). A simulation runs at exactly
+ * one viewport; selecting N viewports fans out into N simulations (one per viewport).
+ * Defined here (the widget/root import closure) so SSE + simulation + qa contracts can share it.
  */
-export declare const QAVerdictSchema: z.ZodEnum<{
-    failed: "failed";
-    passed: "passed";
-    needs_healing: "needs_healing";
+export declare const ViewportNameSchema: z.ZodEnum<{
+    desktop: "desktop";
+    tablet: "tablet";
+    mobile: "mobile";
+}>;
+export type ViewportName = z.infer<typeof ViewportNameSchema>;
+export declare const VIEWPORT_DIMENSIONS: Record<ViewportName, {
+    width: number;
+    height: number;
 }>;
-export type QAVerdict = z.infer<typeof QAVerdictSchema>;
 export declare const QAProcessResponseSchema: z.ZodObject<{
     ultimate_goal: z.ZodString;
     test_cases: z.ZodArray<z.ZodObject<{
@@ -218,11 +216,11 @@ export declare const SimulationTaskEntrySchema: z.ZodObject<{
     title: z.ZodString;
     instructions: z.ZodString;
     status: z.ZodEnum<{
-        pending: "pending";
-        failed: "failed";
         running: "running";
         has_question: "has_question";
+        failed: "failed";
         stopped: "stopped";
+        pending: "pending";
         passed: "passed";
         skipped: "skipped";
     }>;
@@ -240,6 +238,62 @@ export declare const SimulationTaskEntrySchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type SimulationTaskEntry = z.infer<typeof SimulationTaskEntrySchema>;
+export declare const SentimentSchema: z.ZodEnum<{
+    positive: "positive";
+    neutral: "neutral";
+    negative: "negative";
+}>;
+export declare const StepReactionSchema: z.ZodObject<{
+    step_index: z.ZodNumber;
+    screenshot_ref: z.ZodNullable<z.ZodString>;
+    reaction: z.ZodString;
+    sentiment: z.ZodNullable<z.ZodEnum<{
+        positive: "positive";
+        neutral: "neutral";
+        negative: "negative";
+    }>>;
+}, z.core.$strip>;
+export declare const JourneyReactionSchema: z.ZodObject<{
+    reaction: z.ZodString;
+    sentiment: z.ZodEnum<{
+        positive: "positive";
+        neutral: "neutral";
+        negative: "negative";
+    }>;
+}, z.core.$strip>;
+export declare const PersonaSimReactionEntitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    run_id: z.ZodNullable<z.ZodNumber>;
+    persona_id: z.ZodNullable<z.ZodNumber>;
+    user_index: z.ZodNullable<z.ZodNumber>;
+    simulation_id: z.ZodNullable<z.ZodNumber>;
+    study_variant_id: z.ZodNullable<z.ZodNumber>;
+    journey_reaction: z.ZodNullable<z.ZodString>;
+    journey_sentiment: z.ZodNullable<z.ZodEnum<{
+        positive: "positive";
+        neutral: "neutral";
+        negative: "negative";
+    }>>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        pending: "pending";
+    }>;
+    step_reactions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        step_index: z.ZodNumber;
+        screenshot_ref: z.ZodNullable<z.ZodString>;
+        reaction: z.ZodString;
+        sentiment: z.ZodNullable<z.ZodEnum<{
+            positive: "positive";
+            neutral: "neutral";
+            negative: "negative";
+        }>>;
+    }, z.core.$strip>>>;
+    question_answers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        study_question_id: z.ZodNumber;
+        answer: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export declare const SimulationEntitySchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodNumber>;
     created_at: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -248,17 +302,25 @@ export declare const SimulationEntitySchema: z.ZodObject<{
     job_id: z.ZodString;
     browser_session_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodEnum<{
-        completed: "completed";
-        failed: "failed";
         queued: "queued";
         running: "running";
         creating_knowledge: "creating_knowledge";
         has_question: "has_question";
+        completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>;
     status_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instructions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        direct: "direct";
+        uxr: "uxr";
+        survey: "survey";
+        ab: "ab";
+        qa: "qa";
+    }>>>;
     pinned: z.ZodOptional<z.ZodBoolean>;
     source: z.ZodOptional<z.ZodEnum<{
         direct: "direct";
@@ -271,11 +333,11 @@ export declare const SimulationEntitySchema: z.ZodObject<{
         title: z.ZodString;
         instructions: z.ZodString;
         status: z.ZodEnum<{
-            pending: "pending";
-            failed: "failed";
             running: "running";
             has_question: "has_question";
+            failed: "failed";
             stopped: "stopped";
+            pending: "pending";
             passed: "passed";
             skipped: "skipped";
         }>;
@@ -293,17 +355,59 @@ export declare const SimulationEntitySchema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
     graph_status: z.ZodOptional<z.ZodEnum<{
-        pending: "pending";
         completed: "completed";
         failed: "failed";
+        pending: "pending";
         generating: "generating";
     }>>;
     graph_steps_processed: z.ZodOptional<z.ZodNumber>;
     graph_steps_total: z.ZodOptional<z.ZodNumber>;
     graph_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_by_user_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    persona_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     has_question: z.ZodOptional<z.ZodBoolean>;
+    participants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        persona_id: z.ZodNumber;
+        user_count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    reactions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        run_id: z.ZodNullable<z.ZodNumber>;
+        persona_id: z.ZodNullable<z.ZodNumber>;
+        user_index: z.ZodNullable<z.ZodNumber>;
+        simulation_id: z.ZodNullable<z.ZodNumber>;
+        study_variant_id: z.ZodNullable<z.ZodNumber>;
+        journey_reaction: z.ZodNullable<z.ZodString>;
+        journey_sentiment: z.ZodNullable<z.ZodEnum<{
+            positive: "positive";
+            neutral: "neutral";
+            negative: "negative";
+        }>>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            pending: "pending";
+        }>;
+        step_reactions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            step_index: z.ZodNumber;
+            screenshot_ref: z.ZodNullable<z.ZodString>;
+            reaction: z.ZodString;
+            sentiment: z.ZodNullable<z.ZodEnum<{
+                positive: "positive";
+                neutral: "neutral";
+                negative: "negative";
+            }>>;
+        }, z.core.$strip>>>;
+        question_answers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            study_question_id: z.ZodNumber;
+            answer: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    driver_persona_id: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    viewport: z.ZodDefault<z.ZodEnum<{
+        desktop: "desktop";
+        tablet: "tablet";
+        mobile: "mobile";
+    }>>;
 }, z.core.$strip>;
 export type SimulationData = z.infer<typeof SimulationEntitySchema>;
 export declare const ApplicationEntitySchema: z.ZodObject<{
@@ -481,21 +585,31 @@ export declare const StateTriggerEntitySchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StateTriggerData = z.infer<typeof StateTriggerEntitySchema>;
 /**
- * QA run derived status — set by `deriveQARunStats` based on aggregated
- * task states. Emitted by the API on `qa-run/updated` events and returned
- * in QA run oRPC payloads.
- *
- * Canonical wire vocabulary; `deriveQARunStats` returns `'running'` directly.
- * `'pending'` is the empty-task initial state.
+ * QA run status — first-class TEXT+CHECK column on qa_run (no longer derived).
+ * `synthesizing` = all sims terminal but per-journey verdicts still completing (QA has no
+ * run-level rollup like studies). Canonical wire vocabulary.
  */
 export declare const QARunStatusSchema: z.ZodEnum<{
-    pending: "pending";
+    running: "running";
     completed: "completed";
     failed: "failed";
-    running: "running";
     stopped: "stopped";
+    synthesizing: "synthesizing";
 }>;
 export type QARunStatus = z.infer<typeof QARunStatusSchema>;
+/** QA verdict per (run, persona, journey, viewport) — DATA-derived by the api from qa_verdict; NOT a wire status. */
+export declare const QARunVerdictStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    passed: "passed";
+    indecisive: "indecisive";
+}>;
+export type QARunVerdictStatus = z.infer<typeof QARunVerdictStatusSchema>;
+/** A human resolution of an indecisive verdict — resolves to a decision, so no `indecisive`. */
+export declare const HumanRulingSchema: z.ZodEnum<{
+    failed: "failed";
+    passed: "passed";
+}>;
+export type HumanRuling = z.infer<typeof HumanRulingSchema>;
 export declare const ActionLogTypeSchema: z.ZodEnum<{
     user_login: "user_login";
     url_visit: "url_visit";
@@ -664,12 +778,12 @@ export declare const SuggestedSimulationSchema: z.ZodObject<{
     simulation_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        completed: "completed";
-        failed: "failed";
         queued: "queued";
         running: "running";
         creating_knowledge: "creating_knowledge";
         has_question: "has_question";
+        completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>>>;
 }, z.core.$strip>;

package/dist/src/sdk/contracts/widget.d.ts

@@ -366,10 +366,10 @@ export declare const WidgetEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"task/status">;
     status: z.ZodEnum<{
-        completed: "completed";
-        failed: "failed";
         running: "running";
         has_question: "has_question";
+        completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>;
     message: z.ZodOptional<z.ZodString>;
@@ -850,7 +850,7 @@ export declare const widgetStream: import("@orpc/contract").ContractProcedureBui
     error: string;
 } | {
     type: "task/status";
-    status: "completed" | "failed" | "running" | "has_question" | "stopped";
+    status: "running" | "has_question" | "completed" | "failed" | "stopped";
     message?: string | undefined;
     task_id?: string | undefined;
     timestamp?: number | undefined;
@@ -881,7 +881,7 @@ export declare const widgetStream: import("@orpc/contract").ContractProcedureBui
     error: string;
 } | {
     type: "task/status";
-    status: "completed" | "failed" | "running" | "has_question" | "stopped";
+    status: "running" | "has_question" | "completed" | "failed" | "stopped";
     message?: string | undefined;
     task_id?: string | undefined;
     timestamp?: number | undefined;
@@ -1360,7 +1360,7 @@ export declare const widgetRoutes: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;
@@ -1391,7 +1391,7 @@ export declare const widgetRoutes: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;

package/dist/src/sdk/index.d.ts

@@ -393,7 +393,7 @@ export declare const sdk: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;
@@ -424,7 +424,7 @@ export declare const sdk: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;