react-semaphor 0.1.545 → 0.1.547

package/dist/types/shared/analytics-protocol/time-window-schema.d.ts

@@ -160,7 +160,7 @@ export declare function semaphorTimeWindowSchemas(options?: {
         start: string;
         end: string;
     }>;
-    timeWindow: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
+    timeWindow: z.ZodUnion<readonly [z.ZodEffects<z.ZodObject<{
         kind: z.ZodOptional<z.ZodLiteral<"relative">>;
         unit: z.ZodEnum<["second", "minute", "hour", "day", "week", "month", "quarter", "year"]>;
         value: z.ZodNumber;

package/dist/types/shared/analytics-protocol/time-window.d.ts

@@ -1,4 +1,5 @@
-import { SemaphorRelativeTimeWindow, SemaphorTimeGrain } from './contracts.js';
+import { SemaphorCalendarTimeWindow, SemaphorRelativeTimeWindow, SemaphorTimeGrain, SemaphorTimeWindow } from './contracts.js';
+import { RelativeDateFilter } from './relative-date-filter.js';
 /** Units a calendar window ("this month", "previous quarter") can name. */
 export declare const SEMAPHOR_CALENDAR_TIME_WINDOW_UNITS: readonly ["day", "week", "month", "quarter", "year"];
 export declare const SEMAPHOR_CALENDAR_TIME_WINDOW_PERIODS: readonly ["this", "previous"];
@@ -11,3 +12,41 @@ export declare const SEMAPHOR_TIME_WINDOW_MAX_VALUE: Readonly<Record<SemaphorTim
  * latest available data; a saved card that should keep rolling states "now".
  */
 export declare function resolveTimeWindowAnchor(timeWindow: Pick<SemaphorRelativeTimeWindow, 'anchor'>): 'now' | 'latest_available';
+/** A rolling "last N units" window (`kind` "relative" or omitted). */
+export declare function isRelativeTimeWindow(timeWindow: SemaphorTimeWindow | null | undefined): timeWindow is SemaphorRelativeTimeWindow;
+/** A whole calendar period, such as this month or the previous quarter. */
+export declare function isCalendarTimeWindow(timeWindow: SemaphorTimeWindow | null | undefined): timeWindow is SemaphorCalendarTimeWindow;
+/**
+ * A window as a dashboard filter's default. Filter defaults run to now (the
+ * editor's presets and the filter runtime have no latest-data anchor), so a
+ * rolling window without an anchor is anchored at now, and one anchored to
+ * the latest available data is not a filter default (null), never quietly
+ * moved to now. The one conversion every writer and checker of a filter
+ * default uses.
+ */
+export declare function timeWindowToFilterDefault(timeWindow: SemaphorTimeWindow): RelativeDateFilter | null;
+/** A rolling week, month, quarter or year that includes the current, partial one: no filter preset holds it. */
+export declare function isPartialRollingPeriod(timeWindow: SemaphorTimeWindow): boolean;
+/**
+ * The time window a filter default states, the inverse of
+ * `timeWindowToFilterDefault`, so what an agent reads back is what it would
+ * write: the last N days with today (`between` days from 1-N to 0), complete
+ * periods, this or the previous period; a rolling window saved before is
+ * read as rolling. Null for any other stored default, such as `between` on
+ * whole weeks or months, which no time window states.
+ */
+export declare function filterDefaultToTimeWindow(meta: RelativeDateFilter): SemaphorTimeWindow | null;
+/**
+ * The relative date an agent time window persists as (plan D10, amended by
+ * analytics kernel K11), or null when it can't stay relative: absolute
+ * windows, second units, and complete minute or hour periods. A window
+ * anchored to the latest available data (an omitted anchor included) counts
+ * back from its own field's data anchor (`relativeTo: 'latest_data'`).
+ * `completeness` is the completeness the run used, when it was inferred.
+ * Moved from semaphor-app's query-spec-filters so a card's date window and a
+ * dashboard filter's default period convert through one owner (MCP dashboard
+ * editing, ledger P3-04).
+ */
+export declare function timeWindowToRelativeDateFilter(timeWindow: SemaphorTimeWindow, options?: {
+    completeness?: 'include_partial' | 'complete_periods';
+}): RelativeDateFilter | null;

package/dist/types/shared/assistant-context/saved-dashboard-context.d.ts

@@ -35,7 +35,9 @@ export declare function projectSavedDashboardContext(input: {
 /**
  * What a browser opening the saved dashboard at `place` sends with a message:
  * the context and, for an asked-about card, its replay fields, both from the
- * one snapshot (ledger P3-92). The regression set sends exactly this.
+ * one snapshot (ledger P3-92), and the dashboard it projected, which a person
+ * who may change it sends as `openDashboard` (Phase 7, D7-29). The regression
+ * set sends exactly this.
  */
 export declare function projectSavedDashboardTurn(input: {
     dashboard: TDashboard;
@@ -45,6 +47,7 @@ export declare function projectSavedDashboardTurn(input: {
 }): {
     context: AssistantContext;
     cardReplay?: AssistantCardReplayFields;
+    openDashboard: TDashboard;
 };
 /** The turn request's fields for an asked-about card: its request, or why it has none. */
 export type AssistantCardReplayFields = {

package/dist/types/shared/assistant-protocol/answer-text.d.ts

@@ -0,0 +1,20 @@
+import { AssistantPart } from './parts.js';
+/**
+ * Which of an answer's text is the answer (analytics agent Plan 1, P7-23):
+ * its last run of text, the text after the last step that more text follows.
+ * Text the model wrote before such a step ("Need the domain and fields.") is
+ * a working note: the transcript shows it while the assistant works, and not
+ * as the answer once more text follows a later step. An answer followed by a
+ * last query and nothing after it keeps its text, so no answer that wrote
+ * anything comes out empty. A step is a stage that reads data (a query, a
+ * lookup); a change to the dashboard, showing a result or asking the person a
+ * question is not one, so an answer written before its change stays the
+ * answer (P7-45). One rule for the transcript, the turn record and the eval.
+ */
+export type AnswerPartKind = 'text' | 'step' | 'other';
+/** The parts that are working notes: text before the last step that comes before the answer's last text. */
+export declare function workingNotesOf<T>(parts: readonly T[], kindOf: (part: T) => AnswerPartKind): ReadonlySet<T>;
+/** A stored part's kind for `workingNotesOf`. */
+export declare function storedPartKind(part: AssistantPart): AnswerPartKind;
+/** A stored answer's text: its text parts after the last step, a paragraph each. */
+export declare function answerTextOf(parts: readonly AssistantPart[]): string;

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

@@ -247,14 +247,14 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             kind: "set";
             text: string;
             fingerprint: string;
-            omittedValues?: number | undefined;
             notApplied?: "opened_from_another_dashboard" | undefined;
+            omittedValues?: number | undefined;
         }, {
             kind: "set";
             text: string;
             fingerprint: string;
-            omittedValues?: number | undefined;
             notApplied?: "opened_from_another_dashboard" | undefined;
+            omittedValues?: number | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"varies">;
         }, "strict", z.ZodTypeAny, {
@@ -268,8 +268,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             kind: "set";
             text: string;
             fingerprint: string;
-            omittedValues?: number | undefined;
             notApplied?: "opened_from_another_dashboard" | undefined;
+            omittedValues?: number | undefined;
         } | {
             kind: "varies";
         };
@@ -281,8 +281,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             kind: "set";
             text: string;
             fingerprint: string;
-            omittedValues?: number | undefined;
             notApplied?: "opened_from_another_dashboard" | undefined;
+            omittedValues?: number | undefined;
         } | {
             kind: "varies";
         };
@@ -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;
         } | {
@@ -610,8 +610,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             kind: "set";
             text: string;
             fingerprint: string;
-            omittedValues?: number | undefined;
             notApplied?: "opened_from_another_dashboard" | undefined;
+            omittedValues?: number | undefined;
         } | {
             kind: "varies";
         };
@@ -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;
         } | {
@@ -702,8 +702,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             kind: "set";
             text: string;
             fingerprint: string;
-            omittedValues?: number | undefined;
             notApplied?: "opened_from_another_dashboard" | undefined;
+            omittedValues?: number | undefined;
         } | {
             kind: "varies";
         };
@@ -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;
         } | {
@@ -794,8 +794,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             kind: "set";
             text: string;
             fingerprint: string;
-            omittedValues?: number | undefined;
             notApplied?: "opened_from_another_dashboard" | undefined;
+            omittedValues?: number | undefined;
         } | {
             kind: "varies";
         };
@@ -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;
         } | {
@@ -886,8 +886,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             kind: "set";
             text: string;
             fingerprint: string;
-            omittedValues?: number | undefined;
             notApplied?: "opened_from_another_dashboard" | undefined;
+            omittedValues?: number | undefined;
         } | {
             kind: "varies";
         };
@@ -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 {};