react-semaphor 0.1.539 → 0.1.540

package/dist/surfboard/index.js

@@ -1,4 +1,4 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-CWhSbc5_.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-neMDolLg.js";
 import { C as f, E as D } from "../chunks/common-types-CUf03Htv.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,

package/dist/types/components/assistant/assistant-entry-points.d.ts

@@ -1,5 +1,8 @@
+import { AssistantLayout } from '../../shared/assistant-protocol/conversation.js';
 /** Where the panel is: beside a dashboard, or on a page with no dashboard in view. */
 export type AssistantPanelSurface = 'dashboard' | 'none';
+/** Where the panel shows now: the viewer's layout, or beside the asked-about card (Phase 10, D10-1). */
+export type AssistantPlacement = AssistantLayout | 'beside-card';
 /** Opens and closes the panel. Named after the assistant; no other wording. */
 export declare function AssistantToolbarButton(): import("react").JSX.Element | null;
 /**

package/dist/types/components/assistant/assistant-store.d.ts

@@ -24,23 +24,71 @@ export type AssistantPanelState = {
     layout: AssistantLayout;
     /** The docked panel's width in pixels: the viewer's saved choice, else the default. */
     width: number;
+    /**
+     * Asked from a card's own controls with the panel closed: shown beside that
+     * card until left (Phase 10, D10-1, D10-7). Never saved, never a layout.
+     */
+    beside: boolean;
+    /** The size beside a card: the viewer's saved choice, else the default (D10-4). */
+    besideSize: AssistantBesideSize;
+    /**
+     * The Ask that moved the panel beside another card, by `askCount`: the
+     * conversation there starts afresh (D10-6). The chat reacts to it once.
+     */
+    freshConversationAt: number | undefined;
+};
+export type AssistantBesideSize = {
+    width: number;
+    height: number;
 };
 export type AssistantStore = {
     store: StoreApi<AssistantPanelState>;
     toggle(): void;
     close(): void;
-    askAbout(focus: AssistantFocus): void;
+    /**
+     * `beside`: from the card's own controls (D10-5). With the panel closed it
+     * opens beside the card; beside another card it moves; open in a layout,
+     * the panel takes the question as without it.
+     */
+    askAbout(focus: AssistantFocus, options?: {
+        beside?: boolean;
+    }): void;
+    /** Ends asking beside the card (Open in assistant, Show all, the card leaving the view): the stored layout from here on. */
+    leaveBeside(): void;
+    /** Also ends asking beside the card: there is no card to be beside. */
     clearFocus(): void;
     setLayout(layout: AssistantLayout): void;
     /** Sets the docked width, clamped; `save` keeps it in this browser (at the end of a drag, on each key). */
     setWidth(width: number, options?: {
         save?: boolean;
     }): void;
+    /** Sets the size beside a card, clamped; `save` keeps it in this browser. */
+    setBesideSize(size: AssistantBesideSize, options?: {
+        save?: boolean;
+    }): void;
 };
 /** The viewer's layout choice, kept in this browser (AG-D21). */
 export declare const ASSISTANT_LAYOUT_STORAGE_KEY = "semaphor.assistant.layout";
 /** The viewer's docked width, kept in this browser. */
 export declare const ASSISTANT_WIDTH_STORAGE_KEY = "semaphor.assistant.width";
+/** The viewer's size beside a card, kept in this browser (D10-4). */
+export declare const ASSISTANT_BESIDE_SIZE_STORAGE_KEY = "semaphor.assistant.besideSize";
+/** The size beside a card: the default, and the range a viewer can resize it within (D10-4). */
+export declare const ASSISTANT_BESIDE_SIZE: {
+    readonly default: {
+        readonly width: 360;
+        readonly height: 440;
+    };
+    readonly min: {
+        readonly width: 320;
+        readonly height: 280;
+    };
+    readonly max: {
+        readonly width: 560;
+        readonly height: 640;
+    };
+};
+export declare function clampAssistantBesideSize(size: AssistantBesideSize): AssistantBesideSize;
 /** The docked panel's width: the default, and the range a viewer can resize it within. */
 export declare const ASSISTANT_WIDTH: {
     readonly default: 360;

package/dist/types/components/assistant/use-assistant.d.ts

@@ -26,7 +26,10 @@ export type UseAssistantResult = {
     toggle(): void;
     close(): void;
     setLayout(layout: AssistantLayout): void;
-    askAbout(cardId: string): void;
+    /** `beside`: the card's own controls ask beside the card (Phase 10, D10-5); a host's call without it opens the panel. */
+    askAbout(cardId: string, options?: {
+        beside?: boolean;
+    }): void;
     clearSelectedCard(): void;
 };
 /** Read where there is no provider; never written. */
@@ -36,3 +39,9 @@ export declare const NO_ASSISTANT_STORE: import('zustand').StoreApi<import('./as
  * is unavailable, `available` is false and every entry point renders nothing.
  */
 export declare function useAssistant(): UseAssistantResult;
+/**
+ * Whether the assistant is asking beside a card in this frame (Phase 10,
+ * AG-D26): the frame shows a quiet outline, so the conversation reads as
+ * about it. False outside a provider.
+ */
+export declare function useAssistantBesideFrame(cardIds: readonly string[]): boolean;

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

@@ -177,6 +177,26 @@ export type AssistantContextChange = {
     kind: 'inputs_changed';
     inputIds: string[];
 };
+/** One field of a card's description; a question's tags (Phase 11) are the same shape. */
+export declare const assistantCardFieldSchema: z.ZodObject<{
+    role: z.ZodEnum<["row", "column", "measure", "detail"]>;
+    label: z.ZodString;
+    name: z.ZodString;
+    aggregate: z.ZodOptional<z.ZodString>;
+    granularity: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    label: string;
+    name: string;
+    role: "measure" | "row" | "detail" | "column";
+    granularity?: string | undefined;
+    aggregate?: string | undefined;
+}, {
+    label: string;
+    name: string;
+    role: "measure" | "row" | "detail" | "column";
+    granularity?: string | undefined;
+    aggregate?: string | undefined;
+}>;
 /** The strict schema the server parses a turn's context with. */
 export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
     version: z.ZodLiteral<1>;
@@ -315,11 +335,11 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 omittedValues: z.ZodOptional<z.ZodNumber>;
             }, "strict", z.ZodTypeAny, {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }, {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }>, "many">;
             controls: z.ZodArray<z.ZodObject<{
@@ -359,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" | "drillSteps" | "comparisons" | "sqlParameters", z.ZodOptional<z.ZodNumber>>, "strict", z.ZodTypeAny, {
+            omitted: z.ZodOptional<z.ZodObject<Record<"filters" | "controls" | "fields" | "comparisons" | "drillSteps" | "sqlParameters", z.ZodOptional<z.ZodNumber>>, "strict", z.ZodTypeAny, {
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             }, {
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             }>>;
         }, "strict", z.ZodTypeAny, {
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -405,15 +425,15 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         }, {
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -440,8 +460,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         }>, z.ZodObject<{
@@ -467,7 +487,7 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -494,8 +514,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -504,8 +524,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             message?: string | undefined;
         };
         title: string;
-        visualType: string;
         fingerprint: string;
+        visualType: string;
         source?: SemaphorSourceRef | undefined;
     }, {
         id: string;
@@ -513,7 +533,7 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -540,8 +560,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -550,8 +570,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             message?: string | undefined;
         };
         title: string;
-        visualType: string;
         fingerprint: string;
+        visualType: string;
         source?: SemaphorSourceRef | undefined;
     }>>;
     editing: z.ZodOptional<z.ZodObject<{
@@ -561,14 +581,14 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
     }, {
         mode: "sql" | "visual";
     }>>;
-    omitted: z.ZodOptional<z.ZodObject<Record<"cards" | "activeInputs" | "otherSheets", z.ZodOptional<z.ZodNumber>>, "strict", z.ZodTypeAny, {
+    omitted: z.ZodOptional<z.ZodObject<Record<"cards" | "otherSheets" | "activeInputs", z.ZodOptional<z.ZodNumber>>, "strict", z.ZodTypeAny, {
         cards?: number | undefined;
-        activeInputs?: number | undefined;
         otherSheets?: number | undefined;
+        activeInputs?: number | undefined;
     }, {
         cards?: number | undefined;
-        activeInputs?: number | undefined;
         otherSheets?: number | undefined;
+        activeInputs?: number | undefined;
     }>>;
     timeZone: z.ZodString;
 }, "strict", z.ZodTypeAny, {
@@ -581,6 +601,10 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         source?: SemaphorSourceRef | undefined;
     }[];
     surface: "none" | "dashboard" | "editor";
+    otherSheets: {
+        id: string;
+        title: string;
+    }[];
     activeInputs: {
         value: {
             kind: "set";
@@ -595,10 +619,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         inputId: string;
         globalDate?: true | undefined;
     }[];
-    otherSheets: {
-        id: string;
-        title: string;
-    }[];
     sheet?: {
         id: string;
         title: string;
@@ -608,13 +628,18 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         title: string;
         unsavedEdits: boolean;
     } | undefined;
+    omitted?: {
+        cards?: number | undefined;
+        otherSheets?: number | undefined;
+        activeInputs?: number | undefined;
+    } | undefined;
     selectedCard?: {
         id: string;
         description: {
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -641,8 +666,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -651,15 +676,10 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             message?: string | undefined;
         };
         title: string;
-        visualType: string;
         fingerprint: string;
+        visualType: string;
         source?: SemaphorSourceRef | undefined;
     } | undefined;
-    omitted?: {
-        cards?: number | undefined;
-        activeInputs?: number | undefined;
-        otherSheets?: number | undefined;
-    } | undefined;
     editing?: {
         mode: "sql" | "visual";
     } | undefined;
@@ -673,6 +693,10 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         source?: SemaphorSourceRef | undefined;
     }[];
     surface: "none" | "dashboard" | "editor";
+    otherSheets: {
+        id: string;
+        title: string;
+    }[];
     activeInputs: {
         value: {
             kind: "set";
@@ -687,10 +711,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         inputId: string;
         globalDate?: true | undefined;
     }[];
-    otherSheets: {
-        id: string;
-        title: string;
-    }[];
     sheet?: {
         id: string;
         title: string;
@@ -700,13 +720,18 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         title: string;
         unsavedEdits: boolean;
     } | undefined;
+    omitted?: {
+        cards?: number | undefined;
+        otherSheets?: number | undefined;
+        activeInputs?: number | undefined;
+    } | undefined;
     selectedCard?: {
         id: string;
         description: {
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -733,8 +758,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -743,15 +768,10 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             message?: string | undefined;
         };
         title: string;
-        visualType: string;
         fingerprint: string;
+        visualType: string;
         source?: SemaphorSourceRef | undefined;
     } | undefined;
-    omitted?: {
-        cards?: number | undefined;
-        activeInputs?: number | undefined;
-        otherSheets?: number | undefined;
-    } | undefined;
     editing?: {
         mode: "sql" | "visual";
     } | undefined;
@@ -765,6 +785,10 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         source?: SemaphorSourceRef | undefined;
     }[];
     surface: "none" | "dashboard" | "editor";
+    otherSheets: {
+        id: string;
+        title: string;
+    }[];
     activeInputs: {
         value: {
             kind: "set";
@@ -779,10 +803,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         inputId: string;
         globalDate?: true | undefined;
     }[];
-    otherSheets: {
-        id: string;
-        title: string;
-    }[];
     sheet?: {
         id: string;
         title: string;
@@ -792,13 +812,18 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         title: string;
         unsavedEdits: boolean;
     } | undefined;
+    omitted?: {
+        cards?: number | undefined;
+        otherSheets?: number | undefined;
+        activeInputs?: number | undefined;
+    } | undefined;
     selectedCard?: {
         id: string;
         description: {
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -825,8 +850,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -835,15 +860,10 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             message?: string | undefined;
         };
         title: string;
-        visualType: string;
         fingerprint: string;
+        visualType: string;
         source?: SemaphorSourceRef | undefined;
     } | undefined;
-    omitted?: {
-        cards?: number | undefined;
-        activeInputs?: number | undefined;
-        otherSheets?: number | undefined;
-    } | undefined;
     editing?: {
         mode: "sql" | "visual";
     } | undefined;
@@ -857,6 +877,10 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         source?: SemaphorSourceRef | undefined;
     }[];
     surface: "none" | "dashboard" | "editor";
+    otherSheets: {
+        id: string;
+        title: string;
+    }[];
     activeInputs: {
         value: {
             kind: "set";
@@ -871,10 +895,6 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         inputId: string;
         globalDate?: true | undefined;
     }[];
-    otherSheets: {
-        id: string;
-        title: string;
-    }[];
     sheet?: {
         id: string;
         title: string;
@@ -884,13 +904,18 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
         title: string;
         unsavedEdits: boolean;
     } | undefined;
+    omitted?: {
+        cards?: number | undefined;
+        otherSheets?: number | undefined;
+        activeInputs?: number | undefined;
+    } | undefined;
     selectedCard?: {
         id: string;
         description: {
             status: "described";
             filters: {
                 text: string;
-                origin: "card" | "selection" | "drill" | "dashboard_input" | "card_input";
+                origin: "card" | "selection" | "dashboard_input" | "card_input" | "drill";
                 omittedValues?: number | undefined;
             }[];
             controls: {
@@ -917,8 +942,8 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
                 filters?: number | undefined;
                 controls?: number | undefined;
                 fields?: number | undefined;
-                drillSteps?: number | undefined;
                 comparisons?: number | undefined;
+                drillSteps?: number | undefined;
                 sqlParameters?: number | undefined;
             } | undefined;
         } | {
@@ -927,15 +952,10 @@ export declare const assistantContextSchema: z.ZodEffects<z.ZodObject<{
             message?: string | undefined;
         };
         title: string;
-        visualType: string;
         fingerprint: string;
+        visualType: string;
         source?: SemaphorSourceRef | undefined;
     } | undefined;
-    omitted?: {
-        cards?: number | undefined;
-        activeInputs?: number | undefined;
-        otherSheets?: number | undefined;
-    } | undefined;
     editing?: {
         mode: "sql" | "visual";
     } | undefined;
@@ -948,5 +968,7 @@ export declare function compareAssistantContexts(previous: AssistantContext | un
  * since the last turn. Never a card config or rows.
  */
 export declare function renderContextForModel(context: AssistantContext, changes: AssistantContextChange[], addedSources: SemaphorSourceRef[]): string;
+/** One field of a card, as the model reads it: the card's description and a question's tags (Phase 11) both use it. */
+export declare function describeCardField(field: AssistantCardField): string;
 /** A source in words, with the identifiers the tools take. */
 export declare function describeSource(source: SemaphorSourceRef): string;

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

@@ -1,5 +1,6 @@
 import { SemaphorSourceRef } from '../analytics-protocol/contracts.js';
 import { AssistantPart } from './parts.js';
+import { AssistantCardField } from './context.js';
 /** How a stored turn ended; `running` while it is answering, `interrupted` when its process died. */
 export type TurnOutcome = 'running' | 'completed' | 'stopped' | 'failed' | 'refused' | 'interrupted';
 /** For the full page: one of the caller's conversations from the last 24 hours. */
@@ -24,6 +25,8 @@ export type AssistantConversationDetail = {
         turnId: string;
         startedAt: string;
         message: string;
+        /** Fields tagged in the question (Phase 11), shown as chips with it. */
+        taggedFields?: AssistantCardField[];
         /** Shown through the one stored-part mapping the stream uses (D3c-6, `transcript.ts`). */
         parts: AssistantPart[];
         outcome: TurnOutcome;

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

@@ -6,6 +6,7 @@
 export * from './request.js';
 export { assistantJsonBytes, fitAssistantText, AssistantContextTooLargeError, } from './limits.js';
 export * from './context.js';
+export * from './tagged-fields.js';
 export * from './availability.js';
 export * from './parts.js';
 export * from './conversation.js';

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

@@ -18,6 +18,8 @@ export declare const ASSISTANT_LIMITS: {
     readonly inputValues: 50;
     readonly addedSources: 50;
     readonly cardFields: 60;
+    /** Fields of the asked-about card tagged in one question (Phase 11). */
+    readonly taggedFields: 5;
     readonly cardFilters: 40;
     readonly cardControls: 40;
     readonly drillSteps: 10;

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

@@ -1,7 +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 { AssistantContext } from './context.js';
+import { AssistantCardField, AssistantContext } from './context.js';
 export { ASSISTANT_LIMITS } from './limits.js';
 /**
  * The assistant's turn request (analytics agent Plan 1, spec 2.1). The browser
@@ -32,6 +32,11 @@ export type AssistantTurnRequest = {
      * about or why it cannot run.
      */
     selectedCardUnavailable?: AssistantCardUnavailable;
+    /**
+     * Fields of the asked-about card tagged in this question (Phase 11,
+     * `tagged-fields.ts`): each one of the fields its description lists.
+     */
+    taggedFields?: AssistantCardField[];
 };
 /**
  * Why a card has no request to replay: the reasons the external path's saved

package/dist/types/shared/assistant-protocol/tagged-fields.d.ts

@@ -0,0 +1,29 @@
+import { AssistantCardField, AssistantContext } from './context.js';
+/**
+ * Fields tagged in a question (analytics agent Plan 1, Phase 11, AG-D27): a
+ * person points at a field of the card they are asking about instead of
+ * typing its name. A tag is one of the fields the asked-about card's
+ * description lists, by the description's own identity (role, name,
+ * aggregate, date grain), never a card config (AG-INV-5). Only a card with
+ * described fields can be tagged: a SQL card's columns have no fields here,
+ * so a question about one is plain words, which the model reads beside the
+ * card's SQL (D11-1). One owner of the rule, used by the browser before it
+ * sends and by the server's turn parser.
+ */
+/** The same field of a card: everything that tells two fields apart but the label. */
+export declare function sameCardField(left: AssistantCardField, right: AssistantCardField): boolean;
+/**
+ * The fields a question about this context can tag: the asked-about card's
+ * described fields, else none. A card that runs SQL, or a draft in SQL mode,
+ * has none (D11-1): what it returns is its SQL's columns, and the visual
+ * shelves it may still carry (a draft keeps the other mode's) are not run.
+ */
+export declare function taggableFields(context: AssistantContext): AssistantCardField[];
+/** What is wrong with a question's tags against the context it is sent with; empty when they hold. */
+export declare function taggedFieldIssues(context: AssistantContext, tags: AssistantCardField[]): string[];
+/**
+ * The question as the model reads it: the tagged fields first, described as
+ * the card's description describes them, then the words. The one writer for
+ * the question being asked and for the conversation's history.
+ */
+export declare function questionForModel(message: string, tags: AssistantCardField[] | undefined): string;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.539",
+  "version": "0.1.540",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -152,6 +152,7 @@
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
+    "@floating-ui/react-dom": "^2.1.8",
     "@headlessui/react": "^2.2.0",
     "@lexical/history": "^0.43.0",
     "@lexical/link": "^0.43.0",