react-semaphor 0.1.551 → 0.1.552

package/dist/surfboard/index.js

@@ -1,4 +1,4 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-DAQEooIW.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-C0uGI0v7.js";
 import { C as f, E as D } from "../chunks/table-settings-WysCBj62.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,

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

@@ -14,6 +14,29 @@ import { AssistantPart } from './parts.js';
 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>;
+/**
+ * Where each part kind shows in an answer (assistant joins and panel H-1): in
+ * its body, in order (the words that aren't working notes, the blocks); in its
+ * details (steps, what it used, the trace); or nowhere (the conversation's id,
+ * a proposal's operations). The transcript and the copied text both read it,
+ * and a new part kind doesn't compile until it has a place here.
+ */
+export declare const ANSWER_PART_PLACEMENT: {
+    readonly conversation: "nowhere";
+    readonly text: "body";
+    readonly stage: "details";
+    readonly using: "details";
+    readonly clarify: "body";
+    readonly artifact: "body";
+    readonly refusal: "body";
+    readonly trace: "details";
+    readonly proposal: "body";
+    readonly proposal_operations: "nowhere";
+    readonly proposal_refused: "body";
+    readonly model_change: "body";
+};
+/** Whether a part kind shows in an answer's body; a kind this build doesn't know (a newer server's) doesn't. */
+export declare function showsInAnswerBody(kind: string): boolean;
 /** 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. */

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

@@ -0,0 +1,29 @@
+import { AssistantConversationDetail } from './conversation.js';
+/**
+ * What the copy does with every field of a conversation and of a turn
+ * (assistant joins and panel H-1, P3-08): a field added to either type
+ * doesn't compile until it is shown or left out here on purpose.
+ */
+export declare const COPIED_CONVERSATION_FIELDS: {
+    readonly conversationId: "with tool calls";
+    readonly addedSources: "left out";
+    readonly allows: "left out";
+    readonly turns: "shown";
+};
+export declare const COPIED_TURN_FIELDS: {
+    readonly turnId: "left out";
+    readonly startedAt: "shown";
+    readonly message: "shown";
+    readonly taggedFields: "shown";
+    readonly parts: "shown";
+    readonly outcome: "shown";
+    readonly toolCalls: "with tool calls";
+    readonly model: "with tool calls";
+    readonly instructionsVersion: "with tool calls";
+};
+export declare function conversationText(detail: AssistantConversationDetail, options: {
+    assistantName: string;
+    toolCalls?: boolean;
+}): string;
+/** A tool's name without the product prefix (AJ-INV-8). */
+export declare function toolName(tool: string): string;

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

@@ -1,5 +1,5 @@
 import { SemaphorSourceRef } from '../analytics-protocol/contracts.js';
-import { AssistantPart } from './parts.js';
+import { AssistantCallerAllows, 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';
@@ -15,12 +15,15 @@ export type AssistantConversationSummary = {
 };
 /**
  * What opening a conversation returns (Phase 3c, D3c-5): the turns as the
- * transcript shows them. Never the context, tool calls, card request,
- * executed queries or provider replay (AG-INV-5).
+ * transcript shows them. Never the context, card request, executed queries
+ * or provider replay (AG-INV-5); tool calls only when an organization user
+ * asks for them to copy (AJ-D11).
  */
 export type AssistantConversationDetail = {
     conversationId: string;
     addedSources: SemaphorSourceRef[];
+    /** What the caller may do (AJ-D14). Absent from a server before it. */
+    allows?: AssistantCallerAllows;
     turns: Array<{
         turnId: string;
         startedAt: string;
@@ -30,8 +33,26 @@ export type AssistantConversationDetail = {
         /** Shown through the one stored-part mapping the stream uses (D3c-6, `transcript.ts`). */
         parts: AssistantPart[];
         outcome: TurnOutcome;
+        /**
+         * Only when asked for and only for an organization user (AJ-D11,
+         * AJ-INV-4): each tool call's name, input, row count, time and outcome, never its
+         * result, and the model and instructions that answered.
+         */
+        toolCalls?: AssistantToolCallRecord[];
+        model?: string;
+        instructionsVersion?: string;
     }>;
 };
+/** One tool call as a stored turn keeps it: never its result (it can hold customer rows). */
+export type AssistantToolCallRecord = {
+    tool: string;
+    input: unknown;
+    ok: boolean;
+    /** How many rows a query call returned, from its own result (never the rows). */
+    rowCount?: number;
+    durationMs?: number;
+    error?: string;
+};
 export declare const ASSISTANT_LAYOUTS: readonly ["docked-right", "docked-left", "centered", "full-page"];
 /** Where the assistant opens. Token config `assistant.layout` sets the embed default (AG-D21). */
 export type AssistantLayout = (typeof ASSISTANT_LAYOUTS)[number];

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

@@ -11,8 +11,10 @@ export * from './availability.js';
 export * from './parts.js';
 export * from './conversation.js';
 export * from './transcript.js';
+export * from './conversation-text.js';
 export * from './answer-text.js';
 export * from './sources.js';
 export * from './token-config.js';
 export * from './artifact.js';
 export * from './add-to-dashboard.js';
+export * from './model-change.js';

package/dist/types/shared/assistant-protocol/model-change.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Adding a relationship the assistant proposed (assistant joins and panel
+ * AJ-D17): what the apply route answers, and the panel's words for each way
+ * it can refuse. The route sends the change store's own codes; the person
+ * reads these words, never the store's messages (written for agents) and
+ * never the product's name (AJ-INV-8).
+ */
+/** `POST /api/v1/assistant/proposals/{proposalId}/apply`, answered 200: the relationship is in the domain (or already was). */
+export type AssistantModelChangeApplied = {
+    applied: true;
+    replayed: boolean;
+};
+/** The route's refusal body: a change store code and the store's message (for logs, not for the person). */
+export type AssistantModelChangeRefusal = {
+    code: string;
+    message: string;
+};
+/** The panel's words for a refusal code; any other code (a validation failure, a server error) is "couldn't be added". */
+export declare function modelChangeRefusalMessage(code: unknown): string;

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

@@ -10,10 +10,20 @@ import { CreatedEntity, DashboardOperation, OperationContext } from '../dashboar
  * Artifacts from Phase 4; proposals in Phase 7.
  */
 export declare const ASSISTANT_PARTS_VERSION: 1;
+/**
+ * What the person asking may do here, from the server's own caller (assistant
+ * joins and panel AJ-D14): whether a copy may include the tool calls
+ * (organization users). Fixed for a conversation; the browser decides nothing
+ * from the token itself.
+ */
+export type AssistantCallerAllows = {
+    toolCalls: boolean;
+};
 export type AssistantPart = {
     kind: 'conversation';
     conversationId: string;
     expiresAt: string;
+    allows?: AssistantCallerAllows;
 } | {
     kind: 'text';
     text: string;
@@ -28,7 +38,7 @@ export type AssistantPart = {
     kind: 'refusal';
     code: AssistantRefusalCode;
     message: string;
-} | AssistantTracePart | AssistantProposalPart | AssistantProposalOperationsPart;
+} | AssistantTracePart | AssistantProposalPart | AssistantProposalOperationsPart | AssistantProposalRefusedPart | AssistantModelChangePart;
 /**
  * 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
@@ -61,6 +71,34 @@ export type AssistantProposalOperationsPart = {
     operations: DashboardOperation[];
     context: OperationContext;
 };
+/**
+ * A change the assistant asked for and nothing landed, for a reason the
+ * person should see (assistant joins and panel AJ-D8): today only a card
+ * whose datasets the domain doesn't relate. Stored with the turn; the model
+ * gets the refusal as before. `message` is the change problem's own
+ * sentence, safe to show an end user.
+ */
+export type AssistantProposalRefusedPart = {
+    kind: 'proposal_refused';
+    code: 'relationship_missing';
+    message: string;
+};
+/**
+ * A relationship the assistant proposes adding to a domain (assistant joins
+ * and panel AJ-D16): what it does in plain sentences, stored with the turn.
+ * The assistant never adds it; the person does, by click, through the apply
+ * route (AJ-D17, AJ-INV-6).
+ */
+export type AssistantModelChangePart = {
+    kind: 'model_change';
+    proposalId: string;
+    domainId: string;
+    /** The domain's label: "Every dashboard on the {domainLabel} domain can use it." */
+    domainLabel: string;
+    /** One per change (`relationship.add`) and its sentence, as propose returned them. */
+    changes: AssistantProposalChange[];
+    warnings: ChangeDiagnostic[];
+};
 /**
  * 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
@@ -76,6 +114,12 @@ export type AssistantClarifyPart = {
         label: string;
         description?: string;
     }>;
+    /**
+     * The choices can be carried out together (assistant joins and panel
+     * AJ-D20, AJ-D21): the person ticks any of them and sends them at once.
+     * Absent for one answer; a client before it shows the rows as one answer.
+     */
+    multiple?: true;
 };
 export type AssistantStagePart = {
     kind: 'stage';

package/dist/types/shared/dashboard-authoring/changes/dashboard-change.d.ts

@@ -7815,7 +7815,11 @@ export declare const MAX_PROPOSED_CHANGES = 20;
 export type ProposeChangeCaller = {
     /** Dashboard changes (card.*, filter.*). False for a tenant VIEWER: the tool isn't listed at all. */
     dashboards: boolean;
-    /** relationship.add: org interactive callers only. */
+    /**
+     * relationship.add: an org Author or higher, on any credential (assistant
+     * joins and panel AJ-D15, AJ-D19). On screen, only for the in-product
+     * assistant, whose person adds it by click (AJ-D16).
+     */
     domains: boolean;
     /** dashboard.generate: callers who may create dashboards. */
     generate: boolean;
@@ -7824,8 +7828,9 @@ export type ProposeChangeCaller = {
     /**
      * A session that changes the dashboard on the user's screen (a live token,
      * Semaphor's own assistant): it changes only the open dashboard, in place,
-     * so `saveAs`, `preview` and `domainId` are not offered and, since the schema
-     * is strict, are refused if sent (embedded live changes LC-D17).
+     * so `saveAs` and `preview` are not offered and, since the schema is
+     * strict, are refused if sent (embedded live changes LC-D17). `domainId`
+     * is offered only with `domains`, for `relationship.add` (AJ-D16).
      */
     onScreen: boolean;
 };

package/dist/types/shared/dashboard-authoring/changes/diagnostics.d.ts

@@ -4,7 +4,13 @@
  * warnings. Messages are one sentence a person can read and never name the
  * product; `fix` tells the agent what to do next.
  */
-export type ChangeProblemCode = 'invalid_change' | 'invalid_change_target' | 'copy_required' | 'not_permitted' | 'change_not_allowed_for_credential' | 'dashboard_not_found' | 'card_not_found' | 'filter_not_found' | 'sheet_not_found' | 'sheet_required' | 'sheet_not_a_grid' | 'field_not_found' | 'card_not_editable' | 'type_not_supported' | 'query_form_mismatch' | 'capability_required' | 'handle_unknown' | 'too_many_changes'
+export type ChangeProblemCode = 'invalid_change' | 'invalid_change_target' | 'copy_required' | 'not_permitted' | 'dashboard_not_found' | 'card_not_found' | 'filter_not_found' | 'sheet_not_found' | 'sheet_required' | 'sheet_not_a_grid' | 'field_not_found'
+/**
+ * The card's datasets aren't joined by the domain's relationships, so the
+ * card can't run (assistant joins and panel AJ-D4). Details name the base
+ * dataset and the ones it can't reach.
+ */
+ | 'relationship_missing' | 'card_not_editable' | 'type_not_supported' | 'query_form_mismatch' | 'capability_required' | 'handle_unknown' | 'too_many_changes'
 /** filter.update or filter.bind on a filter the outline marks read only. */
  | 'filter_not_editable'
 /** The changed dashboard fails the save's own validation (propose or apply). */

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.551",
+  "version": "0.1.552",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",

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

@@ -1,102 +0,0 @@
-import { A as s, h as u, m as d } from "./context-BerEBuFR.js";
-function o(e, t) {
-  return e.role === t.role && e.name === t.name && e.aggregate === t.aggregate && e.granularity === t.granularity;
-}
-function l(e) {
-  var n, a;
-  const t = (n = e.selectedCard) == null ? void 0 : n.description;
-  return (t == null ? void 0 : t.status) !== "described" || t.sql || ((a = e.editing) == null ? void 0 : a.mode) === "sql" ? [] : t.fields;
-}
-function S(e, t) {
-  if (t.length === 0) return [];
-  if (t.length > s.taggedFields)
-    return [`taggedFields: at most ${s.taggedFields}`];
-  const n = l(e);
-  return t.flatMap((a, i) => n.some((r) => o(r, a)) ? t.slice(0, i).some((r) => o(r, a)) ? [`taggedFields.${i}: tagged twice`] : [] : [`taggedFields.${i}: not a field of the card the context asks about`]);
-}
-function k(e, t) {
-  return t != null && t.length ? `Fields of the asked-about card the user tagged in this question: ${t.map(u).join("; ")}.
-
-${e}` : e;
-}
-function f(e) {
-  if (e.kind === "text") return { type: "text", text: e.text };
-  const { kind: t, ...n } = e;
-  return {
-    type: `data-${t}`,
-    ...e.kind === "stage" ? { id: e.stageId } : {},
-    data: n
-  };
-}
-function b(e, t) {
-  return e.kind !== "text" ? [f(e)] : [
-    { type: "text-start", id: t },
-    { type: "text-delta", id: t, delta: e.text },
-    { type: "text-end", id: t }
-  ];
-}
-function h(e) {
-  if (e === "failed" || e === "interrupted")
-    return { kind: "refusal", code: "model_unavailable", message: d.model_unavailable };
-  if (e === "running")
-    return { kind: "refusal", code: "turn_in_progress", message: d.turn_in_progress };
-}
-function c(e, t) {
-  let n = -1;
-  e.forEach((i, r) => {
-    t(i) === "text" && (n = r);
-  });
-  let a = -1;
-  return e.forEach((i, r) => {
-    r < n && t(i) === "step" && (a = r);
-  }), new Set(e.filter((i, r) => r < a && t(i) === "text"));
-}
-function g(e) {
-  return e.kind === "text" ? "text" : e.kind === "stage" && !e.change ? "step" : "other";
-}
-function x(e) {
-  const t = c(e, g);
-  return e.flatMap((n) => n.kind === "text" && !t.has(n) ? [n.text] : []).filter((n) => n.trim().length > 0).join(`
-
-`);
-}
-function T(e) {
-  if (e.kind === "semantic") return JSON.stringify(["semantic", e.domainId, e.datasetName]);
-  if (e.kind === "sql") return JSON.stringify(["sql", e.connectionId]);
-}
-function F(e) {
-  return e.label ?? (e.kind === "semantic" ? e.datasetName : e.kind === "physical" ? e.tableName : "SQL");
-}
-function y(e) {
-  return {
-    columns: e.columns,
-    records: e.records,
-    rowCount: e.rowCount,
-    governed: e.status.governed,
-    complete: e.status.complete,
-    truncated: e.status.truncated
-  };
-}
-const A = {
-  number: "kpi",
-  line: "line",
-  bar: "bar",
-  stackedBar: "stackedBar",
-  table: "table"
-};
-export {
-  A,
-  l as a,
-  f as b,
-  b as c,
-  h as d,
-  g as e,
-  x as f,
-  T as g,
-  F as h,
-  k as q,
-  o as s,
-  S as t,
-  y as v,
-  c as w
-};