@declarion/react 0.44.0 → 0.47.0

package/dist-lib/api/agents.d.ts

@@ -57,13 +57,38 @@ export interface AgentMessage {
     created_at: string;
     streaming?: boolean;
 }
-export type AgentInvocationStatus = "proposed" | "pending_approval" | "approved" | "rejected" | "running" | "succeeded" | "failed" | "canceled" | "interrupted";
-export interface AgentToolInvocation {
+export type AgentTurnStatus = "queued" | "running" | "waiting" | "completed" | "failed" | "canceled";
+export interface AgentTurn {
     id: string;
     conversation_id: string;
+    trigger_message_id: string;
+    runnable_message_seq: number;
+    status: AgentTurnStatus;
+    model_step: number;
+    reserved_assistant_message_id?: string | null;
+    error_code?: string | null;
+    error_details?: unknown;
+}
+export type AgentInvocationStatus = "proposed" | "pending_input" | "pending_approval" | "approved" | "rejected" | "running" | "succeeded" | "failed" | "canceled" | "interrupted" | "outcome_unknown";
+export type AgentInvocationKind = "action" | "input_request" | "tool";
+export interface AgentToolInvocation {
+    id: string;
+    conversation_id: string | null;
     message_id: string | null;
+    kind: AgentInvocationKind;
+    turn_id: string | null;
+    assistant_message_id: string | null;
+    response_message_id: string | null;
+    provider_call_id: string | null;
+    call_ordinal: number | null;
+    server_code: string;
     tool_code: string;
     params: Record<string, unknown>;
+    question?: {
+        key?: string;
+        message?: string;
+        schema?: Record<string, unknown>;
+    };
     status: AgentInvocationStatus;
     approval?: {
         decided_by?: string;
@@ -71,6 +96,7 @@ export interface AgentToolInvocation {
         reason?: string;
         edits?: Record<string, unknown>;
     };
+    confirmation_mode?: "never" | "once_per_conversation" | "always";
     result?: unknown;
     audit_operation_id?: string;
     reason?: string;
@@ -101,12 +127,18 @@ export declare function createConversation(input: {
     agent_id?: string;
     context?: Record<string, unknown>;
 }): Promise<AgentConversation>;
-export declare function sendMessage(text: string, conversationId: string, _seq?: number): Promise<AgentMessage>;
-export declare function sendElicitResponse(conversationId: string, _seq: number | undefined, toolUseId: string, data: Record<string, unknown>): Promise<AgentMessage>;
-export declare function approveInvocation(id: string, edits?: Record<string, unknown>): Promise<void>;
+export declare function sendMessage(text: string, conversationId: string): Promise<AgentMessage>;
+export declare function answerQuestion(invocationId: string, answer: Record<string, unknown>): Promise<void>;
+export declare function sendElicitResponse(_conversationId: string, invocationId: string, data: Record<string, unknown>): Promise<void>;
+/** What a person permitted: this call alone, or the action for the rest of
+ *  the conversation. Absent means this call alone - the safe reading, and
+ *  what every row written before the choice existed means. */
+export type ApprovalScope = "call" | "conversation";
+export declare function approveInvocation(id: string, scope?: ApprovalScope): Promise<void>;
 export declare function rejectInvocation(id: string, note?: string): Promise<void>;
+export declare function cancelInvocation(id: string): Promise<void>;
 export declare function cancelConversation(id: string): Promise<void>;
 export declare function listConversations(): Promise<AgentConversation[]>;
-export declare function rerunMessageTurn(conversationId: string): Promise<void>;
-export declare function listPendingInvocations(conversationId: string): Promise<AgentToolInvocation[]>;
+export declare function loadConversationTurns(conversationId: string): Promise<AgentTurn[]>;
+export declare function loadConversationInvocations(conversationId: string): Promise<AgentToolInvocation[]>;
 export declare function loadHistory(conversationId: string): Promise<AgentMessage[]>;

package/dist-lib/components/agents/AgentChatPanel.d.ts

@@ -3,5 +3,10 @@ export interface AgentChatPanelProps {
     onClose: () => void;
     context?: string;
     title?: string;
+    /** A question typed somewhere else - the command palette - to send once
+     *  the panel opens. The palette promises "Press Enter to ask"; without
+     *  this it opened the panel and threw the question away. */
+    askOnOpen?: string;
 }
-export declare function AgentChatPanel({ open, onClose, context, title }: AgentChatPanelProps): import("react").JSX.Element | null;
+export declare function AgentChatPanel({ open, onClose, context, title, askOnOpen }: AgentChatPanelProps): import("react").JSX.Element | null;
+export declare function proposalFallback(code: string): string;

package/dist-lib/components/agents/transcript-runs.d.ts

@@ -0,0 +1,29 @@
+import type { AgentMessage, AgentToolInvocation } from "../../api/agents";
+export type TranscriptItem = {
+    kind: "message";
+    message: AgentMessage;
+} | {
+    kind: "run";
+    id: string;
+    calls: TranscriptCall[];
+};
+/** One call, with its result folded in when it has arrived. */
+export type TranscriptCall = {
+    /** The durable invocation id, when this call was persisted by the harness. */
+    id: string;
+    name: string;
+    input: unknown;
+    /** Absent until the platform answers. Absence means still running. */
+    output?: unknown;
+    isError?: boolean;
+    messageId: string;
+    status?: AgentToolInvocation["status"];
+};
+/**
+ * fold turns a message list into what the transcript renders.
+ *
+ * Calls come from transcript blocks, while their state and result come from
+ * the exact durable invocation row. A run keeps the id of its FIRST message
+ * so expansion state survives later calls joining it.
+ */
+export declare function fold(messages: AgentMessage[], invocations?: AgentToolInvocation[]): TranscriptItem[];

package/dist-lib/components/file-widgets/host.d.ts

@@ -22,4 +22,5 @@ export declare function renderSchemaField(props: {
     locale: string;
     fieldId?: string;
     labelId?: string;
+    structure?: string;
 }): ReactNode;

package/dist-lib/components/list/QuickPeek.d.ts

@@ -17,7 +17,7 @@ export interface QuickPeekFileFieldSpec {
 }
 export type QuickPeekFieldSpec = QuickPeekRegularFieldSpec | QuickPeekFileFieldSpec;
 export interface QuickPeekProps<R extends Record<string, unknown> = Record<string, unknown>> {
-    entity: Pick<Entity, "fields" | "files">;
+    entity: Pick<Entity, "fields" | "files" | "variants">;
     entityCode?: string;
     record: R;
     title: string;

package/dist-lib/components/pages/exportRequest.d.ts

@@ -1,9 +1,9 @@
-import type { FilterNodeParam } from "../../types/api";
+import type { FilterNode } from "../../lib/filters";
 /** ExportQuery mirrors the Go ExportQuery struct (server/handlers/data_export.go).
  *  Field order matches; semantics match parseListParams 1:1. */
 export interface ExportQuery {
     screen?: string;
-    filters?: FilterNodeParam[];
+    filters?: FilterNode[];
     search?: string;
     sort?: string;
     include_deleted?: boolean;
@@ -34,7 +34,7 @@ export interface ListViewState {
     /** Active screen code, when the list is rendered through a screen. */
     screenCode?: string;
     /** JSON filter tree (the same shape sent in the `filters` URL param). */
-    jsonFilters?: FilterNodeParam[];
+    jsonFilters?: FilterNode[];
     /** Debounced search value from the toolbar. */
     search?: string;
     /** "field:asc" / "field:desc" sort spec. */

package/dist-lib/components/pages/list/ListFloatbar.d.ts

@@ -1,6 +1,6 @@
 import { type ResolvedActionLayoutNode } from "../../../lib/actions";
 import { type WidgetContext } from "../../../components/shared/ResponsiveActionBar";
-import type { Action } from "../../../types/schema";
+import type { Action, Entity, Screen } from "../../../types/schema";
 export interface ListFloatbarProps {
     selectedIds: string[];
     /** Actions whose visibility includes `list_floatbar` - the floatbar slot.
@@ -19,9 +19,11 @@ export interface ListFloatbarProps {
     data: Record<string, unknown>[];
     rowKey: (row: Record<string, unknown>) => string;
     entityCode?: string;
+    entity?: Entity;
+    screen?: Screen;
     onClear: () => void;
     onActionSuccess: () => void;
     /** Dispatch surface threaded into ResponsiveActionBar (plan §8 Task 10). */
     widgetContext: WidgetContext;
 }
-export declare function ListFloatbar({ selectedIds, floatbarActions, screenActionLayout, entityActionLayout, data, rowKey, entityCode, onClear, onActionSuccess, widgetContext, }: ListFloatbarProps): import("react").JSX.Element | null;
+export declare function ListFloatbar({ selectedIds, floatbarActions, screenActionLayout, entityActionLayout, data, rowKey, entityCode, entity, screen, onClear, onActionSuccess, widgetContext, }: ListFloatbarProps): import("react").JSX.Element | null;

package/dist-lib/components/pages/list/cardProjection.d.ts

@@ -28,7 +28,7 @@ export interface ResolveCardArgs {
     screen: Screen | undefined;
     savedViewColumns?: readonly string[];
 }
-export type ProjectionReason = "render" | "display" | "display_template" | "condition" | "identity" | "sort" | "detail_handoff" | "quick_peek" | "ref_expand" | "status_expand" | "property_expand" | "evidence_expand" | "file_metadata";
+export type ProjectionReason = "render" | "display" | "display_template" | "condition" | "variant" | "identity" | "sort" | "detail_handoff" | "quick_peek" | "ref_expand" | "status_expand" | "property_expand" | "evidence_expand" | "file_metadata";
 export interface ProjectionReasons {
     fields: Record<string, ProjectionReason[]>;
     expand: Record<string, ProjectionReason[]>;
@@ -62,5 +62,6 @@ export interface ResolveListProjectionArgs {
 }
 export declare function resolveCard(args: ResolveCardArgs): ResolvedCard;
 export declare function resolveListProjection(args: ResolveListProjectionArgs): ResolvedListProjection;
+export declare function resolveVariantRenderFields(entity: Entity | undefined, screen: Screen | undefined, savedViewColumns?: readonly string[]): string[];
 export declare function resolveQuickPeekFieldNames(entity: Entity | undefined, screen: Screen | undefined, screens: Schema["screens"] | undefined): string[];
 export declare function extractDisplayTemplateFields(template: string | undefined): string[];

package/dist-lib/components/pages/list/filter-meta.d.ts

@@ -1,10 +1,24 @@
-import type { Entity, ScreenFilterSpecialValues } from "../../../types/schema";
+import type { Entity, Screen, ScreenFilterSpecialValues } from "../../../types/schema";
 import type { FilterFieldMeta } from "../../../components/filters/FilterDrawer";
-import type { FilterOp } from "../../../lib/filters";
-/** Build FilterFieldMeta array from screen + entity for the FilterDrawer. */
-export declare function buildFilterFieldMeta(screen: {
-    filters?: string[];
+/**
+ * Build FilterFieldMeta array from screen + entity for the FilterDrawer.
+ *
+ * The per-type operator lists come from the server (`screen.filter_operators`),
+ * never from a table here. The client used to keep its own map and it had
+ * already diverged: array, multilang, json and bytes fields fell through to
+ * `["eq","not_eq","is_empty","is_not_empty"]`, offering two operators the query
+ * builder rejects and hiding `contains`, the one that works. The server owns
+ * the field-type -> operator mapping because the server is what enforces it.
+ *
+ * A field the server published no operators for is OMITTED rather than given a
+ * guessed list: an operator the builder rejects is worse than an absent field,
+ * because the user only finds out after building the filter.
+ *
+ * Which fields appear at all is SCREEN-SCOPED - `screen.filters` when declared,
+ * every entity field otherwise. That is a UI affordance, not an access control:
+ * the server applies no screen scoping to caller filters.
+ */
+export declare function buildFilterFieldMeta(screen: (Pick<Screen, "filters"> & {
     filter_special_values?: Record<string, ScreenFilterSpecialValues>;
-} | undefined, entity: Pick<Entity, "fields" | "status_groups" | "properties"> | undefined, entities?: Record<string, Entity>): FilterFieldMeta[];
-/** Map field type to available filter operators. */
-export declare function fieldTypeToOperators(type: string): FilterOp[];
+    filter_operators?: Record<string, string[]>;
+}) | undefined, entity: Pick<Entity, "fields" | "status_groups" | "properties"> | undefined, entities?: Record<string, Entity>): FilterFieldMeta[];

package/dist-lib/components/shared/RowActionsKebab.d.ts

@@ -1,4 +1,4 @@
-import { type Action } from "../../types/schema";
+import { type Action, type Entity } from "../../types/schema";
 interface RowActionsKebabProps {
     actions: Array<{
         code: string;
@@ -6,6 +6,7 @@ interface RowActionsKebabProps {
     }>;
     objectIds: string[];
     row?: Record<string, unknown>;
+    entity?: Entity;
     onSuccess?: () => void;
     /** Pre-menu slot for host-specific items (Edit, Delete, etc). */
     preMenu?: React.ReactNode;
@@ -15,5 +16,5 @@ interface RowActionsKebabProps {
     size?: number;
     align?: "start" | "end";
 }
-export declare function RowActionsKebab({ actions, objectIds, row, onSuccess, preMenu, divider, size, align, }: RowActionsKebabProps): import("react").JSX.Element | null;
+export declare function RowActionsKebab({ actions, objectIds, row, entity, onSuccess, preMenu, divider, size, align, }: RowActionsKebabProps): import("react").JSX.Element | null;
 export {};

package/dist-lib/components/views/ViewSwitcher.d.ts

@@ -1,10 +1,11 @@
+import type { FilterNode } from "../../lib/filters";
 export interface ViewItem {
     id: string;
     name: Record<string, string>;
     icon?: string;
     source: "system" | "personal" | "shared";
     is_default?: boolean;
-    filters?: unknown[];
+    filters?: FilterNode[];
     columns?: string[];
     sort?: string;
 }

package/dist-lib/hooks/useAgentConversation.d.ts

@@ -1,37 +1,25 @@
-import { type AgentConversation, type AgentMessage } from "../api/agents";
+import { type ApprovalScope, type AgentConversation, type AgentMessage, type AgentToolInvocation, type AgentTurn } from "../api/agents";
 export interface AgentTurnState {
-    pendingTools: Array<{
-        id: string;
-        name: string;
-        params: Record<string, unknown>;
-        reason?: string;
-        confidence?: number;
-    }>;
-    elicits: Array<{
-        id: string;
-        message: string;
-        schema: Record<string, unknown>;
-    }>;
+    streaming: boolean;
     hints: Array<{
         kind: string;
         target?: unknown;
         ttlMs?: number;
     }>;
-    streaming: boolean;
-    error?: string;
 }
 export declare function useAgentConversation(initialConversationId?: string): {
     conversationId: string | undefined;
     messages: AgentMessage[];
     turn: AgentTurnState;
+    turns: AgentTurn[];
+    invocations: AgentToolInvocation[];
     conversations: AgentConversation[];
     send: (text: string, context?: Record<string, unknown>) => Promise<void>;
-    approve: (invocationId: string, edits?: Record<string, unknown>) => Promise<void>;
+    approve: (invocationId: string, scope?: ApprovalScope) => Promise<void>;
     reject: (invocationId: string, note?: string) => Promise<void>;
-    submitElicit: (toolUseId: string, data: Record<string, unknown>) => Promise<void>;
-    cancelElicit: (toolUseId: string) => Promise<void>;
+    submitInput: (invocationId: string, data: Record<string, unknown>) => Promise<void>;
+    cancelInput: (invocationId: string) => Promise<void>;
     cancel: () => Promise<void>;
-    retry: () => Promise<void>;
     refreshConversations: () => Promise<void>;
     startNew: () => void;
     setConversationId: (id: string | undefined) => void;

package/dist-lib/hooks/useCursorEntityData.d.ts

@@ -1,5 +1,6 @@
 import { type QueryKey } from "@tanstack/react-query";
-import type { FilterNodeParam, Refs, V2Meta } from "../types/api";
+import type { Refs, V2Meta } from "../types/api";
+import type { FilterNode } from "../lib/filters";
 /**
  * Query-key root for the cursor (infinite) entity list. Distinct from the
  * offset list's `"entity-data"` so the SSE handler can RESET it (drop pages,
@@ -22,7 +23,7 @@ export declare function cursorEntityStableKey(params: CursorEntityDataParams): s
 export declare function cursorEntityDataQueryKey(entity: string | undefined, params: CursorEntityDataParams): QueryKey;
 export interface CursorEntityDataParams {
     sort?: string;
-    filters?: FilterNodeParam[];
+    filters?: FilterNode[];
     search?: string;
     select?: string[];
     expand?: string[];

package/dist-lib/hooks/useFilters.d.ts

@@ -5,6 +5,7 @@ import { type FilterNode } from "../lib/filters";
  */
 export declare function useFilters(): {
     filters: FilterNode[];
+    filterError: string | null;
     activeCount: number;
     setFilters: (newFilters: FilterNode[]) => void;
     clearFilters: () => void;

package/dist-lib/icons.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./DynamicIcon-DeRpAaXm.js";
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./DynamicIcon-Dc2j-rg_.js";
 export { o as DynamicIcon, a as Icon, n as LucideIcon, i as getIcon, t as getIconRegistryVersion, e as setIconRegistry, r as subscribeIconRegistry };

package/dist-lib/index.d.ts

@@ -43,6 +43,7 @@ export type { CustomScreenProps } from "./stores/screen-registry";
 export { setIconRegistry, getIcon } from "./stores/icon-registry";
 export type { IconDef } from "./stores/icon-registry";
 export { registerLayoutWidget, getLayoutWidget, hasLayoutWidget, type LayoutWidget, type LayoutWidgetProps, } from "./components/detail-layout/widgets/registry";
+export { useUserLocale } from "./hooks/useUserLocale";
 export { useTabStore, type TabItem, type ReturnTarget } from "./stores/tabs";
 export { useTabNavigate } from "./hooks/useTabNavigate";
 export { useScreenBack } from "./hooks/useScreenBack";
@@ -129,7 +130,13 @@ export * from "./api/agents";
 export { Breadcrumbs } from "./components/shared/Breadcrumbs";
 export type { BreadcrumbsProps, Crumb } from "./components/shared/Breadcrumbs";
 export type { FilterNode, FilterOp } from "./lib/filters";
-export { parseFiltersFromURL, setFiltersInURL, hasOrGroups, countActiveFilters, OP_LABELS, NO_VALUE_OPS, } from "./lib/filters";
+export type { FilterURLState } from "./lib/filters";
+export type { FilterRecord, FilterRecordField, FilterRecordFields } from "./lib/filter-evaluator";
+export { parseFiltersFromURL, parseFilterURLState, setFiltersInURL, hasOrGroups, countActiveFilters, OP_LABELS, NO_VALUE_OPS, } from "./lib/filters";
+export { evaluateFilterTree } from "./lib/filter-evaluator";
+export { resolveEntityVariantCode } from "./lib/variants";
+export { variantActionCodesForRecord, commonVariantActionCodes } from "./lib/variants";
+export { resolveScreenVariantCode, effectiveScreenForRecord } from "./lib/variants";
 export { formatCount, formatExactCount, formatEstimatedCount } from "./lib/format-count";
 export type { MassEditTarget, MassEditTargetKind } from "./lib/mass-edit";
 export { buildMassEditTargets, parseTargetFilter } from "./lib/mass-edit";