react-semaphor 0.1.544 → 0.1.546

package/dist/types/shared/assistant-protocol/context.d.ts

@@ -335,11 +335,11 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 omittedValues: z.ZodOptional<z.ZodNumber>;
             }, "strict", z.ZodTypeAny, {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }, {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }>, "many">;
             controls: z.ZodArray<z.ZodObject<{
@@ -379,26 +379,26 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 text: string;
             }>>;
             comparisons: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            omitted: z.ZodOptional<z.ZodObject<Record<"filters" | "controls" | "fields" | "comparisons" | "drillSteps" | "sqlParameters", z.ZodOptional<z.ZodNumber>>, "strict", z.ZodTypeAny, {
+            omitted: z.ZodOptional<z.ZodObject<Record<"filters" | "controls" | "fields" | "drillSteps" | "comparisons" | "sqlParameters", z.ZodOptional<z.ZodNumber>>, "strict", z.ZodTypeAny, {
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             }, {
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             }>>;
         }, "strict", z.ZodTypeAny, {
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -425,15 +425,15 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         }, {
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -460,8 +460,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         }>, z.ZodObject<{
@@ -487,7 +487,7 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -514,8 +514,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -533,7 +533,7 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -560,8 +560,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -639,7 +639,7 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -666,8 +666,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -731,7 +731,7 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -758,8 +758,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -823,7 +823,7 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -850,8 +850,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -915,7 +915,7 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
+                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -942,8 +942,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                comparisons?: number | undefined;
                 drillSteps?: number | undefined;
+                comparisons?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {

package/dist/types/shared/assistant-protocol/index.d.ts

@@ -11,6 +11,7 @@ export * from './availability.js';
 export * from './parts.js';
 export * from './conversation.js';
 export * from './transcript.js';
+export * from './answer-text.js';
 export * from './sources.js';
 export * from './token-config.js';
 export * from './artifact.js';

package/dist/types/shared/assistant-protocol/limits.d.ts

@@ -9,8 +9,13 @@ export declare const ASSISTANT_LIMITS: {
     readonly messageChars: 4000;
     /** The whole serialized AssistantContext, in UTF-8 bytes. */
     readonly contextBytes: number;
-    /** The whole request body (context, message, added sources), in UTF-8 bytes. */
+    /** The whole request body (context, message, added sources) except `openDashboard`, in UTF-8 bytes. */
     readonly requestBytes: number;
+    /**
+     * The dashboard on screen sent with a question (Phase 7, D7-12), alone, in
+     * UTF-8 bytes of its JSON. Over it the browser sends the question without it.
+     */
+    readonly openDashboardBytes: number;
     readonly summaryCards: 30;
     readonly otherSheets: 50;
     readonly activeInputs: 50;

package/dist/types/shared/assistant-protocol/parts.d.ts

@@ -1,10 +1,13 @@
 import { SemaphorDialect, SemaphorSourceRef } from '../analytics-protocol/contracts.js';
 import { AssistantArtifact } from './artifact.js';
+import { ChangeDiagnostic } from '../dashboard-authoring/changes/diagnostics.js';
+import { CreatedEntity, DashboardOperation, OperationContext } from '../dashboard-authoring/operations/operation-types.js';
 /**
  * The parts of an answer (analytics agent Plan 1, spec 2.4). Streamed as AI
  * SDK `data-${kind}` parts (text uses the SDK's own text parts) and stored on
- * the turn as they are. Never a card config (AG-INV-5). Artifacts from
- * Phase 4; proposals in Phase 7.
+ * the turn as they are, except the trace and a proposal's operations, which
+ * are streamed and never stored. The model never reads a part (AG-INV-5).
+ * Artifacts from Phase 4; proposals in Phase 7.
  */
 export declare const ASSISTANT_PARTS_VERSION: 1;
 export type AssistantPart = {
@@ -25,7 +28,39 @@ export type AssistantPart = {
     kind: 'refusal';
     code: AssistantRefusalCode;
     message: string;
-} | AssistantTracePart;
+} | AssistantTracePart | AssistantProposalPart | AssistantProposalOperationsPart;
+/**
+ * A change the assistant made to the dashboard on screen (Phase 7, spec 8.1,
+ * D7-16): what it does in plain sentences, stored with the turn. Its
+ * operations come in the stream-only part beside it.
+ */
+export type AssistantProposalPart = {
+    kind: 'proposal';
+    proposalId: string;
+    dashboardId: string;
+    /** This answer's proposal it builds on; null: the dashboard sent with the question (D7-15). */
+    buildsOn: string | null;
+    /** One per change: its operation (`card.add`, `filter.update`...) and its sentence, as propose returned them. */
+    changes: AssistantProposalChange[];
+    warnings: ChangeDiagnostic[];
+    risk: 'low' | 'medium';
+    created: CreatedEntity[];
+};
+export type AssistantProposalChange = {
+    op: string;
+    sentence: string;
+};
+/**
+ * A proposal's operations, for the browser to apply to the dashboard it was
+ * built from (D7-16, D7-18). Written to the stream only and never stored,
+ * as the trace part: a reopened conversation has nothing to apply.
+ */
+export type AssistantProposalOperationsPart = {
+    kind: 'proposal_operations';
+    proposalId: string;
+    operations: DashboardOperation[];
+    context: OperationContext;
+};
 /**
  * A question the person answers with a click, ending the answer (ledger
  * D3d-1): the model's alternatives as data, never parsed from its text. Each
@@ -47,6 +82,11 @@ export type AssistantStagePart = {
     stageId: string;
     label: string;
     state: 'live' | 'done' | 'skipped';
+    /**
+     * A step that changes the dashboard on screen (Phase 7): what the model
+     * wrote before it is the answer, not a working note (P7-23, P7-45).
+     */
+    change?: true;
 };
 /**
  * Where one answer's time and tokens went (spec 3.9, AG-D25). The server

package/dist/types/shared/assistant-protocol/request.d.ts

@@ -1,6 +1,7 @@
 import { SemaphorSourceRef } from '../analytics-protocol/contracts.js';
 import { CardQueryRequestExtras, DashboardCardQueryRequestPayloadBase } from '../dashboard-authoring/card-query-request.js';
 import { DataSource } from '../../lib/types/explorer-types.js';
+import { TDashboard } from '../../lib/types/common-types.js';
 import { AssistantCardField, AssistantContext } from './context.js';
 export { ASSISTANT_LIMITS } from './limits.js';
 /**
@@ -37,6 +38,14 @@ export type AssistantTurnRequest = {
      * `tagged-fields.ts`): each one of the fields its description lists.
      */
     taggedFields?: AssistantCardField[];
+    /**
+     * The dashboard document on screen, as the store holds it (Phase 7,
+     * D7-11, D7-12): propose works from it, so a change is made to what the
+     * person sees, unsaved edits included. Sent on the dashboard surface where
+     * the person may change it (`useCanChangeOpenDashboard`). Outside
+     * `requestBytes`, with its own cap; never read by the model, never stored.
+     */
+    openDashboard?: TDashboard;
 };
 /**
  * Why a card has no request to replay: the reasons the external path's saved
@@ -73,9 +82,12 @@ export type AssistantTurnRequestParseResult = {
     code: 'context_too_large' | 'context_invalid';
     issues: string[];
 };
+/** The most a turn request body may be: the request and the dashboard on screen, each at its cap. */
+export declare const ASSISTANT_TURN_BODY_BYTES: number;
 /**
- * Parses a turn request body as received (text). Size first, before any
- * parsing: a body over `requestBytes` or a context over `contextBytes` is
+ * Parses a turn request body as received (text). Size first: a body over
+ * `ASSISTANT_TURN_BODY_BYTES`, an `openDashboard` over `openDashboardBytes`,
+ * the rest of the body over `requestBytes` or a context over `contextBytes` is
  * `context_too_large`. Then the schema (strict) and the context version: a
  * failure is `context_invalid`.
  */

package/dist/types/shared/dashboard-authoring/calculated-field-identity.d.ts

@@ -19,4 +19,7 @@ export declare function readExactDomainCalculatedFieldReference(field: Calculate
         resultRole?: string;
     };
 }): string | undefined;
+/** The field list group calculated fields are listed under (the editor's constants re-export these). */
+export declare const CALCULATED_FIELDS_GROUP_ID = "semaphor_calculated_fields";
+export declare const CALCULATED_FIELDS_GROUP_NAME = "calculated_fields";
 export {};