@declarion/react 0.1.65 → 0.1.68

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

@@ -1,10 +1,16 @@
 import { type AgentConversation, type AgentMessage } from "../api/agents";
 export interface AgentTurnState {
-    streamingText: string;
     pendingTools: Array<{
         id: string;
         name: string;
         params: Record<string, unknown>;
+        reason?: string;
+        confidence?: number;
+    }>;
+    elicits: Array<{
+        id: string;
+        message: string;
+        schema: Record<string, unknown>;
     }>;
     hints: Array<{
         kind: string;
@@ -22,6 +28,8 @@ export declare function useAgentConversation(initialConversationId?: string): {
     send: (text: string, context?: Record<string, unknown>) => Promise<void>;
     approve: (invocationId: string, edits?: Record<string, unknown>) => Promise<void>;
     reject: (invocationId: string, note?: string) => Promise<void>;
+    submitElicit: (toolUseId: string, data: Record<string, unknown>) => Promise<void>;
+    cancelElicit: (toolUseId: string) => Promise<void>;
     cancel: () => Promise<void>;
     retry: () => Promise<void>;
     refreshConversations: () => Promise<void>;

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

@@ -0,0 +1,23 @@
+/**
+ * useImpersonation centralizes the three lifecycle calls (start, stop,
+ * revoke) and re-hydrates auth state on success so the topbar / banner /
+ * viewport frame react in lockstep.
+ *
+ * isImpersonating is derived from auth.me's impersonation field which the
+ * server populates only when the request was issued under an active
+ * impersonation session. Direct human action and agent flows (without an
+ * impersonation channel) leave it null.
+ */
+export declare function useImpersonation(): {
+    info: import("../types/api").ImpersonationInfo | null;
+    isImpersonating: boolean;
+    start: import("@tanstack/react-query").UseMutateFunction<import("../api/auth").ImpersonationStartResponse, Error, {
+        targetUserId: string;
+        reason: string;
+        durationMinutes?: number;
+    }, unknown>;
+    stop: import("@tanstack/react-query").UseMutateFunction<import("..").LoginResponse, Error, void, unknown>;
+    revoke: import("@tanstack/react-query").UseMutateFunction<void, Error, string, unknown>;
+    isStarting: boolean;
+    isStopping: boolean;
+};

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

@@ -1,2 +1,43 @@
+import type { ParamLookup } from "../types/api";
 export declare function usePublicParams(): import("@tanstack/react-query").UseQueryResult<import("../types/api").PublicParamsResponse, Error>;
-export declare function useResolvedParam(code: string): import("@tanstack/react-query").UseQueryResult<import("../types/api").ResolvedParam, Error>;
+/**
+ * Looks up the platform's record for a parameter without a default.
+ * Returns the full ParamLookup envelope (`found`, `value`, `source`).
+ * Prefer `useParam` for typical reads where the call site has a default.
+ */
+export declare function useResolvedParam(code: string): import("@tanstack/react-query").UseQueryResult<ParamLookup, Error>;
+/**
+ * Reads a parameter and substitutes a caller-supplied default when the
+ * platform has no value for it. The default never crosses the wire; the
+ * server only answers "do you have a value for code X?".
+ *
+ * Behaviour:
+ *   - Platform has a value     -> `value` is the resolved value.
+ *   - Platform reports no value -> `value` is `defaultValue`. Not an error.
+ *   - Network / auth failure    -> `error` is set; `value` is `defaultValue`
+ *     so the UI has something to render during a partial outage.
+ *
+ * Important: this React hook intentionally diverges from the Go-side
+ * contract. In Go (`params.Get[T]`), a transport error propagates and
+ * the default is NEVER used for broken infrastructure. In React, the
+ * hook returns the default AND surfaces the error so a component can
+ * still mount during a brownout. Callers whose parameter controls
+ * security-sensitive behaviour (a feature gate that hides admin UI,
+ * a permission flag, etc.) MUST check `error` and refuse to render
+ * the protected branch when set - do not rely on `value` alone.
+ *
+ * Devs may call useParam with a code that is not yet declared in YAML;
+ * the platform reports not-found and the default applies. That is by
+ * design: knobs become declarable later as ops asks for tunability.
+ *
+ * Type T is enforced by the caller. The hook does not coerce - if the
+ * stored value's shape is incompatible with T, that is a programming
+ * bug at the call site to be fixed.
+ */
+export declare function useParam<T>(code: string, defaultValue: T): {
+    value: T;
+    found: boolean;
+    source: ParamLookup["source"] | undefined;
+    loading: boolean;
+    error: Error | null;
+};

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

@@ -0,0 +1 @@
+export declare function useUserLocale(): string;

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

@@ -0,0 +1,30 @@
+/**
+ * useVersionWatcher — staleness watchdog for the SPA.
+ *
+ * Wires three layers of detection (in defense-in-depth order):
+ *
+ *   1. Header-based detection (in apiFetch via versionTracker.observe)
+ *      — instant, runs on every API response, no extra round-trip.
+ *
+ *   2. Periodic /api/version probe — caps drift latency at 60s for
+ *      idle tabs. Fires on:
+ *        • window focus            (debounced to ≥5s)
+ *        • online reconnect
+ *        • document.visibilitychange → visible
+ *        • 60s interval while visible
+ *      Backs off exponentially on failure (1s → 5min cap) so a 5xx
+ *      doesn't error-loop.
+ *
+ *   3. (future) SSE `version-changed` from the realtime role —
+ *      handled by useSSE; kicks fetchProbe() on receipt.
+ *
+ * On drift the tracker classifies the delta:
+ *   • schema-only      → silent React Query invalidation of ["schema"]
+ *   • asset-or-binary  → persistent toast: "Reload now" / "Later"
+ *   • unknown          → same as asset/binary (conservative reload)
+ *
+ * Safe to call exactly once at the App root. Subsequent calls are
+ * harmless (subscribe is idempotent through the tracker's drift-
+ * debounce flag), but the probes would compound — keep it to one.
+ */
+export declare function useVersionWatcher(): void;

package/dist-lib/index.d.ts

@@ -14,7 +14,7 @@ export { useEntityData } from "./hooks/useEntityData";
 export { useEntityItem } from "./hooks/useEntityItem";
 export { useCreateEntity, useUpdateEntity, useDeleteEntity } from "./hooks/useMutations";
 export { useDebounce } from "./hooks/useDebounce";
-export { usePublicParams, useResolvedParam } from "./hooks/useParams";
+export { usePublicParams, useResolvedParam, useParam } from "./hooks/useParams";
 export { useSetStatus } from "./hooks/useObjectStatus";
 export { useSetProperty, useDeleteProperty } from "./hooks/useProperties";
 export { useFilters } from "./hooks/useFilters";
@@ -53,6 +53,7 @@ export type { DetailPageProps as ShellDetailPageProps, DetailMode } from "./comp
 export { SignIn } from "./components/pages/auth/SignIn";
 export { SignUp } from "./components/pages/auth/SignUp";
 export { Forgot } from "./components/pages/auth/Forgot";
+export { Reset } from "./components/pages/auth/Reset";
 export { TwoFA } from "./components/pages/auth/TwoFA";
 export { AuthShell } from "./components/pages/auth/AuthShell";
 export type { AuthShellProps } from "./components/pages/auth/AuthShell";
@@ -65,6 +66,8 @@ export { JobsStub } from "./components/pages/jobs/Jobs";
 export { ChangePasswordDialog } from "./components/shared/ChangePasswordDialog";
 export type { ChangePasswordDialogProps } from "./components/shared/ChangePasswordDialog";
 export * from "./components/primitives";
+export { SquareImage, CircleImage, WideBanner, registerFileWidget, getFileWidget, hasFileWidget, uploadFile, discardFile, validateClientSide, formatBytes, UploadError, setImageCropper, getImageCropper, FileDraftScope, useFileDraftScope, useDraftRegistration, } from "./components/file-widgets";
+export type { FileFieldDef, FileFieldDisplay, FileFieldMode, FileWidget, FileWidgetProps, HydratedFile, UploadProgress, UploadedFile, ImageCropper, CropperOptions, CropperResult, FileDraftScopeApi, DraftEntry, } from "./components/file-widgets";
 export { Rail } from "./components/layout/Rail";
 export type { RailProps, RailAreaItem } from "./components/layout/Rail";
 export { Sidebar, buildSections } from "./components/layout/Sidebar";
@@ -75,6 +78,10 @@ export { TenantChip, envTone } from "./components/layout/TenantChip";
 export type { TenantChipProps } from "./components/layout/TenantChip";
 export { TabStrip } from "./components/layout/TabStrip";
 export type { TabStripProps } from "./components/layout/TabStrip";
+export { ImpersonationBanner } from "./components/layout/ImpersonationBanner";
+export { ImpersonationFrame } from "./components/layout/ImpersonationFrame";
+export { ImpersonationStartModal } from "./components/layout/ImpersonationStartModal";
+export { useImpersonation } from "./hooks/useImpersonation";
 export { CommandPalette } from "./components/shell/CommandPalette";
 export type { CommandPaletteProps, CommandAction, CommandActionType, } from "./components/shell/CommandPalette";
 export { AgentChatPanel } from "./components/agents/AgentChatPanel";