@ai-matrx/records-ui 0.65.0 → 0.66.0

package/dist/index.d.cts

@@ -108,6 +108,12 @@ interface RecordChatContext {
     /** The whole door answer, for a host that wants the history or the relations. */
     scope: RecordScopeContext;
 }
+/**
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `chat` on
+ * `<RecordsUiProvider>` with the host's own chat surface — in AI Matrx that is
+ * `AgentConversationColumn`, launched through a Mandate. This package
+ * deliberately ships no second chat UI.
+ */
 declare const NO_CHAT_REASON: string;
 interface RecordChatProps {
     tableId: Uuid;
@@ -138,6 +144,12 @@ interface EnrichOutcome {
         says?: string;
     }>;
 }
+/**
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `enrich` on
+ * `<RecordsUiProvider>` with a call to the server's own `records` tool (action
+ * `enrich_propose`). Only the server may write a value as an agent — a browser
+ * stamping itself `agent` would be a browser claiming to be one.
+ */
 declare const NO_ENRICH_REASON: string;
 /** Which of the four things this cell is. One place, so nothing can disagree. */
 declare function cellState(cell: EnrichCell | undefined): "none" | "agent" | "yours" | "unsure";
@@ -487,17 +499,52 @@ interface PendingCapture {
     attempts: number;
     lastRefusal?: string | null;
 }
-/** The sentence the notify editor shows when no saved-view port is bound. */
+/**
+ * The sentence the notify editor shows when no saved-view port is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `savedViews` on
+ * `<RecordsUiProvider>` with the host's own list of `platform.saved_view` rows —
+ * the record store has no door onto them — and the picker appears.
+ */
 declare const NO_SAVED_VIEWS_REASON: string;
-/** The sentence a person question shows when no membership port is bound. */
+/**
+ * The sentence a person question shows when no membership port is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `members` on
+ * `<RecordsUiProvider>` with the host's own roster. Who is in an organization is
+ * the platform's answer, not the record store's, so this package will not guess.
+ */
 declare const NO_MEMBERS_REASON: string;
-/** The sentence shown when no share dialog is bound. */
+/**
+ * The sentence shown when no share dialog is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `share` on
+ * `<RecordsUiProvider>` with the app's own sharing dialog. AI Matrx has exactly
+ * one, and this package deliberately does not ship a second.
+ */
 declare const NO_SHARE_REASON: string;
-/** The sentence a canvas shows when nothing is bound to open the records behind a number. */
+/**
+ * The sentence a canvas shows when nothing is bound to open the records behind a number.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `openRecords` on
+ * `<RecordsUiProvider>`. Where this app puts its grid is the host's routing, not
+ * this package's, so it will not guess an address.
+ */
 declare const NO_OPEN_RECORDS_REASON: string;
-/** The sentence the re-ask box shows when no agent is bound. */
+/**
+ * The sentence the re-ask box shows when no agent is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `onReask` on
+ * `<RecordsUiProvider>`; it drives `dashboard_propose` on the server's `records`
+ * tool with this dashboard's id. Only the server can honestly speak as an agent.
+ */
 declare const NO_REASK_REASON: string;
-/** The sentence an attachment question shows when no file store is bound. */
+/**
+ * The sentence an attachment question shows when no file store is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `upload` on
+ * `<RecordsUiProvider>` with the host's file service and the chooser appears.
+ */
 declare const NO_UPLOAD_REASON: string;
 declare function RecordsUiProvider({ value, children }: {
     value: RecordsUiHost;
@@ -549,6 +596,28 @@ declare function isMachineIdentity(text: string): boolean;
  * the suite to say WHAT it found rather than only that it found something.
  */
 declare function machineIdentityIn(text: string): string[];
+/**
+ * 🚨 A HINT THIS PACKAGE OR ITS CLIENT WROTE IS NOT A PERSON'S REMEDY.
+ *
+ * `refusalForAPerson` prefers the DOOR's own hint over the table above, because
+ * the door that refused knows more about the way out than a code does. That is
+ * right — but it assumed every hint came from the store. It did not: until
+ * `@ai-matrx/records` 0.47.0 the client appended its OWN note to `hint` when it
+ * met a SQLSTATE it did not know, and the machine-identity filter let it
+ * through whenever the code was not exactly five characters (an empty code from
+ * a dropped connection, or an HTTP status like `404`). So the Checklists tab of
+ * a plumbing company's jobs table told its owner:
+ *
+ *     @ai-matrx/records did not recognise SQLSTATE from checklistTemplates
+ *
+ * The client no longer writes there. This is the guard on the other side, by
+ * SHAPE and not by that one sentence: a hint that talks about a package, a
+ * SQLSTATE, or a `camelCaseDoor` is engineer text wherever it came from, and it
+ * joins the engineer's line instead of a person's screen.
+ */
+declare const ENGINEER_TEXT: RegExp[];
+/** Whether this sentence was written for whoever maintains the code. */
+declare function isEngineerText(text: string): boolean;
 /** The one shape every screen in this package renders a refusal from. */
 interface PlainRefusal {
     /** The heading. Never the store's code. */
@@ -2553,6 +2622,11 @@ declare function nextInWords(page: Pick<BookingSummary, "next_at" | "timezone" |
 /** The three things a phone captures. Each one writes the SAME kind of record. */
 declare const CAPTURE_MODES: readonly ["reading", "photo", "voice"];
 type CaptureMode = (typeof CAPTURE_MODES)[number];
+/**
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `captureQueue` on
+ * `<RecordsUiProvider>` with the host's own durable store — IndexedDB in a
+ * browser — and a queued capture survives the tab, the reload and the flight.
+ */
 declare const IN_MEMORY_QUEUE_REASON: string;
 interface CaptureSheetProps {
     /**
@@ -2799,6 +2873,31 @@ interface TablePageProps {
      * copy it out of the address bar afterwards.
      */
     onViewChanged?: ((view: PageView) => void) | undefined;
+    /**
+     * WHICH FIELD THE ADDRESS WANTS THE BOARD'S COLUMNS TO BE, for this visit.
+     *
+     * 🚨 THIS IS HOW A DASHBOARD NUMBER CLICKS THROUGH (lane TAILS-6, 2026-09-22).
+     * Until today the canvas told the owner of the business to "bind `openRecords`
+     * on <RecordsUiProvider>" — a developer's sentence on a customer's screen —
+     * because nothing in this app routed a bar or a slice anywhere. The store has
+     * no door that returns the ROWS behind an aggregate filter, so a click cannot
+     * honestly promise a narrowed list; what it CAN do is open this table's board
+     * with its columns set to the very field the chart grouped by, where the
+     * column the person clicked is right there and every card in it is real.
+     *
+     * It overrides the saved view's own `groupField` for this visit only, exactly
+     * as `activeView` overrides its layout, and it is never written back.
+     */
+    activeGroupField?: string | null | undefined;
+    /**
+     * WHAT THE PERSON CLICKED TO GET HERE — "Jobs by stage · Awaiting parts".
+     *
+     * Present, the board says where they came from AND says plainly that it is
+     * showing every record grouped by that field rather than only the ones the
+     * number counted. A screen that quietly showed more rows than the number
+     * promised would be the number lying twice.
+     */
+    cameFrom?: string | null | undefined;
     className?: string | undefined;
 }
 /**
@@ -2817,6 +2916,16 @@ interface TablePageProps {
  * whether the table exists: this person cannot see it, and which of the two it
  * is is not theirs to learn.
  */
+/**
+ * WHAT THE BOARD SAYS TO SOMEBODY A DASHBOARD NUMBER SENT HERE.
+ *
+ * It says two things and neither is optional: which number they clicked, and
+ * that this is every record grouped by that field rather than only the ones the
+ * number counted. The store has no door that returns the rows behind an
+ * aggregate filter, so claiming a narrowed list would be a lie — and showing a
+ * wider one silently would be the same lie with nobody told.
+ */
+declare function cameFromLine(label: string, groupField: string | null): string;
 declare const TABLE_NOT_REACHABLE: string;
 /**
  * THE VIEW EVERY TABLE HAS, AND WHY IT IS NOT OPTIONAL.
@@ -2925,7 +3034,7 @@ declare function openingView(activeView: string | null | undefined, activeDashbo
     layout: ViewLayout | null;
     unknown: string | null;
 };
-declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, className, }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, className, }: TablePageProps): react.JSX.Element;
 
 /** What the roster can tell us about a user id. `null` when it cannot. */
 type ResolveName = (userId: Uuid$1) => string | null;
@@ -3103,4 +3212,4 @@ interface PipelineBoardProps {
 }
 declare function PipelineBoard({ tableId, rows, measure, onMeasureChange, onOpenRecord, onMoved, className, }: PipelineBoardProps): react.JSX.Element;
 
-export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SERIES_COLORS, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, type WhoChanged, WhoChangedSource, actorBadge, actorWords, addFields, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isId, isMachineIdentity, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, memberName, nextInWords, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, recordName, recordNameIn, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, rowNameIn, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, tokenFor, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };
+export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SERIES_COLORS, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, type WhoChanged, WhoChangedSource, actorBadge, actorWords, addFields, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cameFromLine, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isEngineerText, isId, isMachineIdentity, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, memberName, nextInWords, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, recordName, recordNameIn, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, rowNameIn, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, tokenFor, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };

package/dist/index.d.ts

@@ -108,6 +108,12 @@ interface RecordChatContext {
     /** The whole door answer, for a host that wants the history or the relations. */
     scope: RecordScopeContext;
 }
+/**
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `chat` on
+ * `<RecordsUiProvider>` with the host's own chat surface — in AI Matrx that is
+ * `AgentConversationColumn`, launched through a Mandate. This package
+ * deliberately ships no second chat UI.
+ */
 declare const NO_CHAT_REASON: string;
 interface RecordChatProps {
     tableId: Uuid;
@@ -138,6 +144,12 @@ interface EnrichOutcome {
         says?: string;
     }>;
 }
+/**
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `enrich` on
+ * `<RecordsUiProvider>` with a call to the server's own `records` tool (action
+ * `enrich_propose`). Only the server may write a value as an agent — a browser
+ * stamping itself `agent` would be a browser claiming to be one.
+ */
 declare const NO_ENRICH_REASON: string;
 /** Which of the four things this cell is. One place, so nothing can disagree. */
 declare function cellState(cell: EnrichCell | undefined): "none" | "agent" | "yours" | "unsure";
@@ -487,17 +499,52 @@ interface PendingCapture {
     attempts: number;
     lastRefusal?: string | null;
 }
-/** The sentence the notify editor shows when no saved-view port is bound. */
+/**
+ * The sentence the notify editor shows when no saved-view port is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `savedViews` on
+ * `<RecordsUiProvider>` with the host's own list of `platform.saved_view` rows —
+ * the record store has no door onto them — and the picker appears.
+ */
 declare const NO_SAVED_VIEWS_REASON: string;
-/** The sentence a person question shows when no membership port is bound. */
+/**
+ * The sentence a person question shows when no membership port is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `members` on
+ * `<RecordsUiProvider>` with the host's own roster. Who is in an organization is
+ * the platform's answer, not the record store's, so this package will not guess.
+ */
 declare const NO_MEMBERS_REASON: string;
-/** The sentence shown when no share dialog is bound. */
+/**
+ * The sentence shown when no share dialog is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `share` on
+ * `<RecordsUiProvider>` with the app's own sharing dialog. AI Matrx has exactly
+ * one, and this package deliberately does not ship a second.
+ */
 declare const NO_SHARE_REASON: string;
-/** The sentence a canvas shows when nothing is bound to open the records behind a number. */
+/**
+ * The sentence a canvas shows when nothing is bound to open the records behind a number.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `openRecords` on
+ * `<RecordsUiProvider>`. Where this app puts its grid is the host's routing, not
+ * this package's, so it will not guess an address.
+ */
 declare const NO_OPEN_RECORDS_REASON: string;
-/** The sentence the re-ask box shows when no agent is bound. */
+/**
+ * The sentence the re-ask box shows when no agent is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `onReask` on
+ * `<RecordsUiProvider>`; it drives `dashboard_propose` on the server's `records`
+ * tool with this dashboard's id. Only the server can honestly speak as an agent.
+ */
 declare const NO_REASK_REASON: string;
-/** The sentence an attachment question shows when no file store is bound. */
+/**
+ * The sentence an attachment question shows when no file store is bound.
+ *
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `upload` on
+ * `<RecordsUiProvider>` with the host's file service and the chooser appears.
+ */
 declare const NO_UPLOAD_REASON: string;
 declare function RecordsUiProvider({ value, children }: {
     value: RecordsUiHost;
@@ -549,6 +596,28 @@ declare function isMachineIdentity(text: string): boolean;
  * the suite to say WHAT it found rather than only that it found something.
  */
 declare function machineIdentityIn(text: string): string[];
+/**
+ * 🚨 A HINT THIS PACKAGE OR ITS CLIENT WROTE IS NOT A PERSON'S REMEDY.
+ *
+ * `refusalForAPerson` prefers the DOOR's own hint over the table above, because
+ * the door that refused knows more about the way out than a code does. That is
+ * right — but it assumed every hint came from the store. It did not: until
+ * `@ai-matrx/records` 0.47.0 the client appended its OWN note to `hint` when it
+ * met a SQLSTATE it did not know, and the machine-identity filter let it
+ * through whenever the code was not exactly five characters (an empty code from
+ * a dropped connection, or an HTTP status like `404`). So the Checklists tab of
+ * a plumbing company's jobs table told its owner:
+ *
+ *     @ai-matrx/records did not recognise SQLSTATE from checklistTemplates
+ *
+ * The client no longer writes there. This is the guard on the other side, by
+ * SHAPE and not by that one sentence: a hint that talks about a package, a
+ * SQLSTATE, or a `camelCaseDoor` is engineer text wherever it came from, and it
+ * joins the engineer's line instead of a person's screen.
+ */
+declare const ENGINEER_TEXT: RegExp[];
+/** Whether this sentence was written for whoever maintains the code. */
+declare function isEngineerText(text: string): boolean;
 /** The one shape every screen in this package renders a refusal from. */
 interface PlainRefusal {
     /** The heading. Never the store's code. */
@@ -2553,6 +2622,11 @@ declare function nextInWords(page: Pick<BookingSummary, "next_at" | "timezone" |
 /** The three things a phone captures. Each one writes the SAME kind of record. */
 declare const CAPTURE_MODES: readonly ["reading", "photo", "voice"];
 type CaptureMode = (typeof CAPTURE_MODES)[number];
+/**
+ * FOR WHOEVER MAINTAINS THIS APP (never on the screen): bind `captureQueue` on
+ * `<RecordsUiProvider>` with the host's own durable store — IndexedDB in a
+ * browser — and a queued capture survives the tab, the reload and the flight.
+ */
 declare const IN_MEMORY_QUEUE_REASON: string;
 interface CaptureSheetProps {
     /**
@@ -2799,6 +2873,31 @@ interface TablePageProps {
      * copy it out of the address bar afterwards.
      */
     onViewChanged?: ((view: PageView) => void) | undefined;
+    /**
+     * WHICH FIELD THE ADDRESS WANTS THE BOARD'S COLUMNS TO BE, for this visit.
+     *
+     * 🚨 THIS IS HOW A DASHBOARD NUMBER CLICKS THROUGH (lane TAILS-6, 2026-09-22).
+     * Until today the canvas told the owner of the business to "bind `openRecords`
+     * on <RecordsUiProvider>" — a developer's sentence on a customer's screen —
+     * because nothing in this app routed a bar or a slice anywhere. The store has
+     * no door that returns the ROWS behind an aggregate filter, so a click cannot
+     * honestly promise a narrowed list; what it CAN do is open this table's board
+     * with its columns set to the very field the chart grouped by, where the
+     * column the person clicked is right there and every card in it is real.
+     *
+     * It overrides the saved view's own `groupField` for this visit only, exactly
+     * as `activeView` overrides its layout, and it is never written back.
+     */
+    activeGroupField?: string | null | undefined;
+    /**
+     * WHAT THE PERSON CLICKED TO GET HERE — "Jobs by stage · Awaiting parts".
+     *
+     * Present, the board says where they came from AND says plainly that it is
+     * showing every record grouped by that field rather than only the ones the
+     * number counted. A screen that quietly showed more rows than the number
+     * promised would be the number lying twice.
+     */
+    cameFrom?: string | null | undefined;
     className?: string | undefined;
 }
 /**
@@ -2817,6 +2916,16 @@ interface TablePageProps {
  * whether the table exists: this person cannot see it, and which of the two it
  * is is not theirs to learn.
  */
+/**
+ * WHAT THE BOARD SAYS TO SOMEBODY A DASHBOARD NUMBER SENT HERE.
+ *
+ * It says two things and neither is optional: which number they clicked, and
+ * that this is every record grouped by that field rather than only the ones the
+ * number counted. The store has no door that returns the rows behind an
+ * aggregate filter, so claiming a narrowed list would be a lie — and showing a
+ * wider one silently would be the same lie with nobody told.
+ */
+declare function cameFromLine(label: string, groupField: string | null): string;
 declare const TABLE_NOT_REACHABLE: string;
 /**
  * THE VIEW EVERY TABLE HAS, AND WHY IT IS NOT OPTIONAL.
@@ -2925,7 +3034,7 @@ declare function openingView(activeView: string | null | undefined, activeDashbo
     layout: ViewLayout | null;
     unknown: string | null;
 };
-declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, className, }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, activeView, onViewChanged, activeGroupField, cameFrom, className, }: TablePageProps): react.JSX.Element;
 
 /** What the roster can tell us about a user id. `null` when it cannot. */
 type ResolveName = (userId: Uuid$1) => string | null;
@@ -3103,4 +3212,4 @@ interface PipelineBoardProps {
 }
 declare function PipelineBoard({ tableId, rows, measure, onMeasureChange, onOpenRecord, onMoved, className, }: PipelineBoardProps): react.JSX.Element;
 
-export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SERIES_COLORS, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, type WhoChanged, WhoChangedSource, actorBadge, actorWords, addFields, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isId, isMachineIdentity, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, memberName, nextInWords, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, recordName, recordNameIn, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, rowNameIn, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, tokenFor, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };
+export { ABSENCE_WORD_LABEL, ABSENCE_WORD_VALUES, ACTION_KINDS, type AbsenceWord, ActionInbox, type ActionInboxProps, type ActionKind, type AgentBuildAsk, BOOKING_PAGE_STATE_LABEL, BOOKING_PAGE_STATE_VALUES, BookingBuilder, type BookingBuilderProps, type BookingPageState, BookingSlots, type BookingSlotsProps, BuildOrAsk, type BuildOrAskProps, type BuildableKind, CAPTURE_MODES, CHART_KINDS, CHART_KIND_LABEL, CHART_NEEDS, CHECKLIST_REQUIREMENT_KINDS, CHECKLIST_REQUIREMENT_LABEL, CONDITION_OPS, CONTEXT_POLICY_LABEL, type Capability, type CaptureMode, type CaptureQueuePort, CaptureRun, type CaptureRunProps, CaptureSheet, type CaptureSheetProps, type CellAddress, type CellRefusal, type CellState, ChartBlock, type ChartBlockProps, type ChartConfig, ChartFrame, type ChartKind, ChartLegendContent, type ChartSpec, ChartTooltipContent, ChecklistRunner, type ChecklistRunnerProps, ChecklistTemplateEditor, ChecklistsPanel, type ChecklistsPanelProps, CommentThread, type CommentThreadProps, type ConditionField, ConditionGroup, type ConditionGroupProps, ConditionRow, type ConditionRowProps, CustomFieldsSection, type CustomFieldsSectionProps, DEFAULT_FIELDS, DEFAULT_VIEW_NAME, DUE_STATE_LABEL, DashboardCanvas, type DashboardCanvasProps, type DeclareResult, DigestScheduler, type DigestSchedulerProps, DocRender, type DocRenderProps, DocTemplate, type DocTemplateProps, type DocTemplateSpec, EMPTY_PRESENTATION, ENGINEER_TEXT, type EditorKind, EmbedFrame, type EmbedFrameProps, type EnrichAsk, EnrichBadge, type EnrichBadgeProps, type EnrichOutcome, EnrichPanel, type EnrichPanelProps, ExportMenu, type ExportMenuProps, FIELD_RULE_KIND_LABEL, FIELD_RULE_KIND_VALUES, FIELD_SENSITIVITY_LABEL, FIELD_TYPE_CHOICES, FIELD_TYPE_GROUPS, FORMULA_OP_JOINS, FORMULA_OP_LABEL, FORMULA_OP_VALUES, FORM_FLOWS, FROZEN_COLUMN_WIDTH, FieldControl, FieldEditor, type FieldEditorControlProps, type FieldEditorProps, FieldHistoryPanel, type FieldHistoryPanelProps, FieldLabel, type FieldProposalRow, type FieldRuleKindValue, type FieldTypeChoice, FormBuilder, type FormBuilderProps, type FormFlow, type FormQuestionSpec, FormRunner, type FormRunnerProps, type FormSpec, type FormSubmitOutcome, type FormTheme, FormsPanel, type FormsPanelProps, type FormulaOp, Grid, GridCell, type GridEditing, type GridGrouping, type GridPresentation, type GridProps, HistoryPanel, type HistoryPanelProps, IN_MEMORY_QUEUE_REASON, ImportWizard, type ImportWizardProps, KERNEL_REASON, LANE_EMPTY, LANE_TITLE, LAYOUT_FIELD_KIND, LAYOUT_LABEL, LAYOUT_NEEDS, LAYOUT_NO_FIELD, LEVEL_WORD, type LabelLookup, MACHINE_IDENTITY, MAX_ROW_HEIGHT, MIN_ROW_HEIGHT, type MainView, MyChecklistSteps, NEEDS_A_SENTENCE, NOT_ANSWERED_YET, NOT_DRAWN_HERE, NO_AGENT_PORT, NO_CHAT_REASON, NO_COLUMNS_WHY, NO_COLUMNS_YET, NO_ENRICH_REASON, NO_MEMBERS_REASON, NO_OPEN_RECORDS_REASON, NO_REASK_REASON, NO_RIGHTS, NO_RULES_YET, NO_SAVED_VIEWS_REASON, NO_SHARE_REASON, NO_UPLOAD_REASON, type NewFieldSpec, type NewTableSpec, NotifyRuleEditor, type NotifyRuleEditorProps, type NotifyRuleSpec, type OpenRecordsAsk, type OrganizationMember, PAGE_VIEWS, PAGE_VIEW_LABEL, PARITY_LABEL, PARITY_MADE_OF, PROPOSED_CHANGE_ACT_LABEL, PROPOSED_CHANGE_ACT_VALUES, type PageView, Peek, type PeekProps, type PendingCapture, PersonPicker, type PersonPickerProps, type PickableFieldType, PipelineBoard, type PipelineBoardProps, type PlainFieldType, type PlainRefusal, type PortalAnswer, PortalBuilder, type PortalBuilderProps, PortalCardView, type PortalCardViewProps, PortalShell, type PortalShellProps, PortalsPanel, type PortalsPanelProps, type ProposalOutcome, ProposalRow, type ProposalRowProps, type ProposedChange, type ProposedChangeAct, ProvenanceBadge, PublicViewPage, type PublicViewPageProps, ROLLUP_AGG_LABEL, ROLLUP_AGG_VALUES, type ReaskContext, RecordChat, type RecordChatContext, type RecordChatEntry, type RecordChatProps, type RecordChatWithheld, RecordChip, RecordForm, type RecordFormProps, RecordLabelProvider, RecordValue, RecordsMount, type RecordsMountProps, type RecordsUiHost, RecordsUiProvider, ReferenceBuilder, type ReferenceBuilderProps, type ReferenceChoice, RefusalLine, RefusalNotice, type RelationFieldType, RelationPicker, type RelationPickerProps, type ResolveName, type RollupAgg, SAVED_VIEWS_UNAVAILABLE, SAY_WHAT_YOU_ARE_WAITING_FOR_AFTER_MS, SERIES_COLORS, SOMEBODY, STAGE_RULE_ON_FAIL_LABEL, STORE_ANSWERS_THESE, STORE_DECIDES_REASON, SUBSCRIPTION_CADENCES, SUBSCRIPTION_CADENCE_LABEL, SUBSCRIPTION_CHANNEL_LABEL, SUBSCRIPTION_CHANNEL_VALUES, type SavedDashboard, type SavedForm, type SavedView, type SavedViewSpec, ShareControl, type ShareControlProps, type ShareSubject, SignBlock, type SignBlockProps, StageRulesSection, type StageRulesSectionProps, StepRow, type SubscriptionChannel, SubscriptionsPanel, type SubscriptionsPanelProps, type Surface, type SurfacePress, type SystemFieldSpec, type SystemTableSpec, TABLE_LANES, TABLE_NOT_REACHABLE, THE_SYSTEM, type TableLane, TablePage, type TablePageProps, type TableRights, TableSettings, type TableSettingsProps, TablesHome, type TablesHomeProps, type TrackedVersion, type UseSystemTableState, VIEW_LAYOUTS, VIEW_NOT_SAVED_YET, VIEW_TABLE, ViewBar, type ViewBarProps, type ViewLayout, type ViewSort, ViewSwitcher, type ViewSwitcherProps, WITHHELD_RECORD_LABEL, WORK_DUE_STATES, WORK_INBOX_KINDS, WORK_INBOX_KIND_LABEL, type WhatYouMayDo, type WhoChanged, WhoChangedSource, actorBadge, actorWords, addFields, askableFields, blockFromSpec, bodyForReading, bodyFromKeys, cameFromLine, cellState, chooseSurface, colorFromTheValue, columnForField, conditionInWords, conditionIsDrawable, conditionIsSimple, conditionValue, controlFor, currencyCodeFor, dashboardDeclareArgs, dashboardFromSummary, declareTable, editorKindFor, ensureSystemTable, envelopeFor, fieldDeclarationFor, fieldIsEditable, fieldName, fieldToken, fieldTypeChoice, fieldTypeLabel, formDeclareArgs, formFromSummary, formPresentation, formatForField, groupLabel, hintForAPerson, hintIsMachineIdentity, humanize, idsOf, isEngineerText, isId, isMachineIdentity, isPlainFieldType, isRelationFieldType, isSignatureField, keyFor, laneFor, lastChangeSentence, looksLikeId, machineIdentityIn, memberName, nextInWords, openingRail, openingView, pageViewFromParam, parityTypesWithNoExplanation, parseGridPresentation, personActor, personRecordForMember, pointsAtRecords, presentationDocument, presentationIsEmpty, previewLine, previewWords, publiclyAnswerable, recordName, recordNameIn, recordsDataSource, refusalForAPerson, refusalLineForAPerson, renderValue, revokeConsequence, rowName, rowNameIn, scalarText, shareUnavailableReason, specFromBlock, storeDecidesRights, submissionStamp, surfaceChosen, tableName, tableRightsAt, tokenFor, unknownViewLine, useCanShare, useEmbedHandshake, useEnrichCells, useGridEditing, useLabelWait, useMeasuredWidth, useMyChecklistSteps, useRecordLabels, useRecordRights, useRecordsUi, useRowRights, useSystemTable, useTableRights, useViewRecords, useWhoChanged, viewDocument, viewFromRecord, viewPatchDocument, whatIsMissing, whatYouMayDo, whatYouMayDoWithTable, whenWords, whyNotAskable };

package/dist/index.js

@@ -80,12 +80,12 @@ var NO_RIGHTS = tableRights(NOT_ANSWERED_YET);
 function tableRightsAt(level) {
   return tableRights(whatYouMayDo(level, true));
 }
-var NO_SAVED_VIEWS_REASON = "No saved-view port is bound, so there is nothing here to subscribe to. A subscription points at a `platform.saved_view`, which the record store has no door onto \u2014 bind `savedViews` on <RecordsUiProvider> with your host's own list and the picker appears.";
-var NO_MEMBERS_REASON = "No membership port is bound, so this question cannot offer anybody. A person field points at the kernel Person Table, and who is in this organization is the platform's answer rather than the record store's \u2014 bind `members` on <RecordsUiProvider> with your host's own roster and the picker appears.";
-var NO_SHARE_REASON = "No share dialog is bound, so this screen offers no Share button rather than one that opens nothing. Bind `share` on <RecordsUiProvider> with the app's own sharing dialog \u2014 AI Matrx has exactly one (features/sharing), and this package deliberately does not ship a second.";
-var NO_OPEN_RECORDS_REASON = "These numbers do not click through yet. Every one of them is a count of real records, and where this app puts its grid is the host's routing rather than this package's \u2014 bind `openRecords` on <RecordsUiProvider> and a bar, a slice or a row opens the records it counted.";
-var NO_REASK_REASON = "Asking for a change in words needs an agent, and this package deliberately reaches one through the host rather than calling a model itself. Bind `onReask` on <RecordsUiProvider> \u2014 it drives `dashboard_propose` on the server's `records` tool with this dashboard's id \u2014 and this box works.";
-var NO_UPLOAD_REASON = "No file store is bound, so this question cannot take a file. Bind `upload` on <RecordsUiProvider> with your host's file service and the chooser appears.";
+var NO_SAVED_VIEWS_REASON = "There are no saved views here yet, so there is nothing to be told about. Save a view of this table first and it will be offered here.";
+var NO_MEMBERS_REASON = "This app cannot offer the people in your organization on this screen yet, so there is nobody to pick. Type the person's name into a text field for now, and tell us \u2014 it is on our list, not yours.";
+var NO_SHARE_REASON = "Sharing is not available on this screen, so there is no Share button here rather than one that opens nothing. Share this table from the tables list instead.";
+var NO_OPEN_RECORDS_REASON = "These numbers do not click through yet. Every one of them is a count of real records \u2014 open the records view and group it by the same field to see them. It is on our list, not yours.";
+var NO_REASK_REASON = "Changing this dashboard by describing it is not switched on here yet, so this box is off rather than one that goes nowhere. Add and remove the blocks by hand above. It is on our list, not yours.";
+var NO_UPLOAD_REASON = "This screen cannot take a file yet, so there is no chooser here rather than one that loses what you pick. Put a link to the file in a text field for now. It is on our list, not yours.";
 var HostContext = createContext(null);
 function RecordsUiProvider({ value, children }) {
   const bound = useMemo(() => value, [value]);
@@ -160,6 +160,10 @@ var TITLE = {
   not_supported: "That cannot be done here",
   store_limit: "This has got as big as it can",
   store_not_served: "This organization does not keep its data here",
+  unreachable: "We could not reach your data",
+  needs_approval: "This is waiting on someone's approval",
+  stale_read: "Your view of this is a moment behind",
+  timed_out: "That took too long to answer",
   internal: "Something went wrong at our end"
 };
 var REMEDY = {
@@ -174,8 +178,35 @@ var REMEDY = {
   not_supported: "There is another way to do this \u2014 ask, and we will point you at it.",
   store_limit: "Split it up, or ask us to raise the ceiling for your organization.",
   store_not_served: "An administrator of this organization turns the record store on from the data settings screen.",
+  // 🚨 NOTHING WAS WRITTEN AND NOTHING WAS REFUSED (lane TAILS-6). The call
+  // never arrived, so "try again" is the honest instruction rather than a
+  // consolation — and saying nothing changed is the half a person actually
+  // worries about.
+  unreachable: "Nothing was changed. Check your connection and open this again.",
+  needs_approval: "Nothing was changed yet. The people who can approve it have been asked.",
+  stale_read: "Open this again in a moment and it will be up to date.",
+  timed_out: "Nothing was changed. Try a smaller page, or try again in a moment.",
   internal: "Nothing you did caused this. Try again, and tell us if it keeps happening."
 };
+var ENGINEER_TEXT = [
+  /@ai-matrx\//,
+  /\bSQLSTATE\b/i,
+  /\bPostgREST\b/i,
+  /\bIndexedDB\b/i,
+  // `<RecordsUiProvider>` — a component, on a screen.
+  /<\/?[A-Z][A-Za-z0-9]*\s*\/?>/,
+  // `savedViews`, `openRecords`, `onReask` — an identifier, however it is
+  // quoted. English does not write camelCase; code does.
+  /\b[a-z][a-z0-9]*[A-Z][A-Za-z0-9]*\b/,
+  // A backticked token is a thing you type into an editor, not a thing you do.
+  /`[A-Za-z_][A-Za-z0-9_.]*`/,
+  // "bind X on Y", "pass X", "import X" — an instruction to whoever maintains
+  // the app, arriving on the screen of somebody who cannot act on it.
+  /\bbind\s+[`'"A-Za-z]/i
+];
+function isEngineerText(text) {
+  return ENGINEER_TEXT.some((shape) => shape.test(text));
+}
 function withoutMachineClauses(sentence2) {
   const dropped = [];
   const footnotes = [];
@@ -213,11 +244,17 @@ function refusalForAPerson(error) {
   const message = plainSentence(String(error.message ?? ""));
   const hint = plainSentence(String(error.hint ?? ""));
   const title = TITLE[code] ?? "The store refused this";
-  const remedy = hint.kept ?? REMEDY[code] ?? REMEDY["internal"];
-  const said = (message.kept ?? "").trim();
+  const hintIsForEngineers = isEngineerText(String(error.hint ?? ""));
+  const remedy = (hintIsForEngineers ? null : hint.kept) ?? REMEDY[code] ?? REMEDY["internal"];
+  const messageIsForEngineers = isEngineerText(String(error.message ?? ""));
+  const said = (messageIsForEngineers ? "" : message.kept ?? "").trim();
   const forEngineers = [
     error.sqlstate ? `SQLSTATE ${error.sqlstate}.` : null,
-    error.hint && hint.kept !== error.hint ? `Hint: ${error.hint}` : null,
+    // The client's own note about a class it did not recognise, or a call that
+    // never reached the store. It is rendered out of sight, never as a sentence.
+    error.diagnostic ? error.diagnostic : null,
+    messageIsForEngineers ? `Message: ${error.message}` : null,
+    error.hint && (hintIsForEngineers || hint.kept !== error.hint) ? `Hint: ${error.hint}` : null,
     message.dropped.length > 0 || hint.dropped.length > 0 ? `Dropped from the person's view: ${[...message.dropped, ...hint.dropped].join(" | ")}` : null
   ].filter(Boolean).join(" ");
   return {
@@ -2482,7 +2519,7 @@ import {
   cn as cn8
 } from "@ai-matrx/design-system";
 import { Fragment as Fragment4, jsx as jsx11, jsxs as jsxs7 } from "react/jsx-runtime";
-var NO_ENRICH_REASON = "No enrich port is bound, so this panel does not offer to fill a column it cannot fill. The value has to be written by the SERVER with actor `agent` on behalf of you \u2014 a browser that stamped itself `agent` would be a browser claiming to be one \u2014 so bind `enrich` on <RecordsUiProvider> with a call to the server's own `records` tool (action `enrich_propose`). Everything else on this panel works without it.";
+var NO_ENRICH_REASON = "Having an agent fill this column is not switched on here yet, so this panel does not offer it rather than offering something that cannot happen. Everything else on this panel works. It is on our list, not yours.";
 function cellState(cell) {
   if (!cell || !cell.agent_owned) return "none";
   if (cell.pinned) return "yours";
@@ -5816,7 +5853,7 @@ import { useEffect as useEffect9, useMemo as useMemo14, useState as useState18 }
 import { useRecordsClient as useRecordsClient12 } from "@ai-matrx/records/react";
 import { Skeleton as Skeleton4, cn as cn16 } from "@ai-matrx/design-system";
 import { jsx as jsx21, jsxs as jsxs17 } from "react/jsx-runtime";
-var NO_CHAT_REASON = "No chat port is bound, so this panel is absent rather than showing a composer that goes nowhere. Bind `chat` on <RecordsUiProvider> with your host's own chat surface \u2014 in AI Matrx that is `AgentConversationColumn`, launched through a Mandate \u2014 and this panel becomes that surface with this record as its context. This package deliberately ships no second chat UI.";
+var NO_CHAT_REASON = "Chatting about this record is not switched on here yet, so this panel is empty rather than showing a box that goes nowhere. It is on our list, not yours.";
 function RecordChat({ tableId, recordId, className }) {
   const client = useRecordsClient12();
   const host = useRecordsUi();
@@ -13810,7 +13847,7 @@ function CaptureRun({ sheetId, face: given, className }) {
 // src/CaptureSheet.tsx
 import { Fragment as Fragment25, jsx as jsx52, jsxs as jsxs48 } from "react/jsx-runtime";
 var CAPTURE_MODES = ["reading", "photo", "voice"];
-var IN_MEMORY_QUEUE_REASON = "No capture queue is bound, so anything that cannot be sent right now is held in this page's memory and is lost if the page closes. Bind `captureQueue` on <RecordsUiProvider> with your host's own durable store (IndexedDB in a browser) and a queued capture survives the tab, the reload and the flight. It is said here rather than discovered later.";
+var IN_MEMORY_QUEUE_REASON = "Anything you capture while offline is held only in this page until it can be sent, and it is lost if you close the tab. Keep this page open until you are back on a connection. It is said here rather than discovered later.";
 function mintClientKey() {
   const c = globalThis.crypto;
   if (typeof c?.randomUUID === "function") return `capture:${c.randomUUID()}`;
@@ -14686,6 +14723,10 @@ import { useCallback as useCallback37, useEffect as useEffect41, useState as use
 import { useRecordsClient as useRecordsClient43, useTable as useTable22 } from "@ai-matrx/records/react";
 import { Button as Button48, Separator as Separator12, Skeleton as Skeleton34, cn as cn51 } from "@ai-matrx/design-system";
 import { Fragment as Fragment28, jsx as jsx58, jsxs as jsxs53 } from "react/jsx-runtime";
+function cameFromLine(label, groupField) {
+  const grouped = groupField ? `grouped into the same columns the chart used` : `for this table`;
+  return `You came here from \u201C${label}\u201D. This is every record ${grouped} \u2014 not only the ones that number counted \u2014 so the column you clicked is here with the rest beside it.`;
+}
 var TABLE_NOT_REACHABLE = "This table is not in the organization you are working in, so there is nothing here to show. Switch to the organization that owns it and open it again \u2014 or it may have been deleted.";
 var DEFAULT_VIEW_NAME = "All records";
 var VIEW_NOT_SAVED_YET = "This table has no saved view yet, so the layout you pick here is not being kept. Save one from the bar above and it is remembered.";
@@ -14729,6 +14770,8 @@ function TablePage({
   activeRecordId,
   activeView,
   onViewChanged,
+  activeGroupField,
+  cameFrom,
   className
 }) {
   const client = useRecordsClient43();
@@ -14922,10 +14965,24 @@ function TablePage({
       ] }),
       main === "dashboards" ? /* @__PURE__ */ jsx58(DashboardCanvas, { tableId, activeDashboardId: activeDashboardId ?? null }) : /* @__PURE__ */ jsxs53(Fragment28, { children: [
         opened.unknown ? /* @__PURE__ */ jsx58("p", { className: "rounded-md border border-amber-600/40 bg-amber-500/5 px-3 py-2 text-xs leading-relaxed text-amber-700 dark:border-amber-400/40 dark:text-amber-300", children: unknownViewLine(opened.unknown) }) : null,
+        cameFrom ? /* @__PURE__ */ jsx58(
+          "p",
+          {
+            "data-testid": "came-from-a-number",
+            className: "rounded-md border px-3 py-2 text-xs leading-relaxed text-muted-foreground",
+            children: cameFromLine(cameFrom, activeGroupField ?? null)
+          }
+        ) : null,
         /* @__PURE__ */ jsx58(
           ViewSwitcher,
           {
-            view: { ...view ?? defaultView(tableId), layout: shownLayout },
+            view: {
+              ...view ?? defaultView(tableId),
+              layout: shownLayout,
+              // The address's field wins for this visit; silence keeps the
+              // saved view's own choice, exactly as it always did.
+              ...activeGroupField ? { groupField: activeGroupField } : {}
+            },
             pageSize,
             onLayoutChange: (layout) => {
               setLayoutFromLink(layout);
@@ -15065,6 +15122,7 @@ export {
   DocRender,
   DocTemplate,
   EMPTY_PRESENTATION,
+  ENGINEER_TEXT,
   EmbedFrame,
   EnrichBadge,
   EnrichPanel,
@@ -15188,6 +15246,7 @@ export {
   blockFromSpec,
   bodyForReading,
   bodyFromKeys,
+  cameFromLine,
   cellState,
   chooseSurface,
   colorFromTheValue,
@@ -15219,6 +15278,7 @@ export {
   hintIsMachineIdentity,
   humanize,
   idsOf,
+  isEngineerText,
   isId,
   isMachineIdentity,
   isPlainFieldType,