react-semaphor 0.1.539 → 0.1.541

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/dist/types/shared/dashboard-authoring/card-query-request.d.ts

@@ -70,7 +70,27 @@ export type CardQueryRequestExtras = {
         pageSize: number;
     };
     tableTotalsRequest?: TableTotalsRequest;
+    /** Strict table print only; never sent with `pagination`. */
+    sourceRowProbe?: CardQuerySourceRowProbe;
 };
+/**
+ * Ask acquisition whether the source had more rows than `limit`, counted
+ * before any Python step or pivot (report attachment delivery RA-D15, RA-D17).
+ */
+export type CardQuerySourceRowProbe = {
+    limit: number;
+};
+/**
+ * What acquisition reports for a `CardQuerySourceRowProbe`: `true` when the
+ * source had more rows than the limit, `false` when not. Absent when nobody
+ * asked or the answer is unknown, and never read as `false`.
+ */
+export type CardQuerySourceRowEvidence = {
+    sourceRowOverflow?: boolean;
+};
+type DecidedExtrasField = 'pagination' | 'tableTotalsRequest' | 'sourceRowProbe';
+/** Every extras field is parsed here and built by `resolveCardRequestExtras`. */
+export type CardQueryRequestExtrasDecided = AssertNever<Exclude<keyof CardQueryRequestExtras, DecidedExtrasField>>;
 /** The context fields any query body may carry, checked the same way for every reader. */
 export type CardQueryRequestContext = Pick<CardQueryRequest, 'calendarContext' | 'resolvedPrimaryDateField' | 'globalDateComparison'>;
 /**

package/dist/types/shared/format-utils/attachment-filter-line.d.ts

@@ -0,0 +1,14 @@
+import { FilterLineValue } from './filter-line.js';
+/**
+ * The filter values a scheduled attachment's filter line is made of, read
+ * from its saved settings: values with a name and a values list, each saved
+ * relative date read through the shared reader (a malformed one is dropped so
+ * the value keeps its fixed dates, as the dashboard's own replay does).
+ *
+ * One owner for the run's PDF header (semaphor-app `buildRunFilterLine`) and
+ * the schedule dialog. It ignores `includeFilters`: that switch only hides the
+ * printed line, and the filters still apply to the data.
+ */
+export declare function readAttachmentFilterLineValues(settings: {
+    filterValues?: readonly unknown[];
+} | undefined): FilterLineValue[];

package/dist/types/shared/format-utils/filter-line.d.ts

@@ -13,6 +13,13 @@ export type FilterLineValue = {
 };
 type FormatFilterLineOptions = {
     timezone?: string;
+    /**
+     * 'label': every relative window prints by its label ("Last 7 days"), for a
+     * reader that shows saved values rather than a run's resolved dates (the
+     * schedule dialog). Absent: quarter, year and latest-data windows print by
+     * name and every other window prints its dates, as a run's PDF header does.
+     */
+    relativeDates?: 'label';
 };
 type FormatFilterConditionOptions = FormatFilterLineOptions & {
     /** The filter's display name; defaults to its column name in title case. */

package/dist/types/shared/format-utils/index.d.ts

@@ -31,6 +31,7 @@ export * from './raw-temporal.js';
 export * from './temporal-input-presentation.js';
 export * from './flat-table-export-totals.js';
 export * from './filter-line.js';
+export * from './attachment-filter-line.js';
 export { describeFilterValueInFullDetail, type FullDetailFilterValue, } from './filter-value-text.js';
 export { describeConditionInFullDetail, type FilterClauseText } from './filter-detail.js';
 export { formatCanonicalComparisonRange } from '../../lib/utils/comparison-window-caption.js';

package/dist/types/shared/format-utils/pdf-export-policy.d.ts

@@ -12,6 +12,15 @@ export declare const FAST_PDF_POLICY: Readonly<{
     maxOutputBytes: 52428800;
 }>;
 export declare const PDF_SAFETY_LIMIT_EXCEEDED: "PDF_SAFETY_LIMIT_EXCEEDED";
+/**
+ * Card types a PDF prints as a table, across pages, in table mode. The one
+ * list every reader uses: the interactive download and export dialog, the
+ * fast path, the print views and scheduled attachments (report attachment
+ * delivery RA-D1).
+ */
+export declare const PDF_TABLE_CARD_TYPES: readonly ["table", "detailTable", "aggregateTable", "pivotTable"];
+export type PdfTableCardType = (typeof PDF_TABLE_CARD_TYPES)[number];
+export declare function isPdfTableCardType(cardType: unknown): cardType is PdfTableCardType;
 /** Exact UTF-8 bytes used by the structured POST body. */
 export declare function getUtf8ByteLength(value: string): number;
 export declare function isFastPdfRowCountEligible(rowCount: number): boolean;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.539",
+  "version": "0.1.541",
   "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",

package/dist/chunks/add-to-dashboard-CxtTfISD.js

@@ -1,56 +0,0 @@
-import { k as t } from "./context-HD9usB1P.js";
-function a(e) {
-  if (e.kind === "text") return { type: "text", text: e.text };
-  const { kind: n, ...i } = e;
-  return {
-    type: `data-${n}`,
-    ...e.kind === "stage" ? { id: e.stageId } : {},
-    data: i
-  };
-}
-function s(e, n) {
-  return e.kind !== "text" ? [a(e)] : [
-    { type: "text-start", id: n },
-    { type: "text-delta", id: n, delta: e.text },
-    { type: "text-end", id: n }
-  ];
-}
-function d(e) {
-  if (e === "failed" || e === "interrupted")
-    return { kind: "refusal", code: "model_unavailable", message: t.model_unavailable };
-  if (e === "running")
-    return { kind: "refusal", code: "turn_in_progress", message: t.turn_in_progress };
-}
-function u(e) {
-  if (e.kind === "semantic") return JSON.stringify(["semantic", e.domainId, e.datasetName]);
-  if (e.kind === "sql") return JSON.stringify(["sql", e.connectionId]);
-}
-function l(e) {
-  return e.label ?? (e.kind === "semantic" ? e.datasetName : e.kind === "physical" ? e.tableName : "SQL");
-}
-function o(e) {
-  return {
-    columns: e.columns,
-    records: e.records,
-    rowCount: e.rowCount,
-    governed: e.status.governed,
-    complete: e.status.complete,
-    truncated: e.status.truncated
-  };
-}
-const c = {
-  number: "kpi",
-  line: "line",
-  bar: "bar",
-  stackedBar: "stackedBar",
-  table: "table"
-};
-export {
-  c as A,
-  s as a,
-  u as b,
-  l as c,
-  d as s,
-  a as t,
-  o as v
-};