@quillsql/admin 1.8.6 → 1.8.8

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default, { CSSProperties, ForwardRefExoticComponent, RefAttributes } from 'react';
-import { EventTracking, InternalFilter, QuillReport as QuillReport$1, QuillTheme as QuillTheme$1 } from '@quillsql/react';
+import { EventTracking, InternalFilter, QuillResults, QuillReport as QuillReport$1, QuillTheme as QuillTheme$1, ChangelogEntry } from '@quillsql/react';
 
 type QuillTenant = {
     name: string;
@@ -101,16 +101,18 @@ interface BaseQuillProviderProps {
 }
 interface QuillCloudProviderProps extends BaseQuillProviderProps {
     queryEndpoint: never;
+    streamEndpoint: never;
     queryHeaders?: never;
     withCredentials?: never;
 }
 interface SelfHostedProviderProps extends BaseQuillProviderProps {
     queryEndpoint: string;
+    streamEndpoint?: string;
     queryHeaders?: object;
     withCredentials?: boolean;
 }
 type QuillProviderProps = QuillCloudProviderProps | SelfHostedProviderProps;
-declare function AdminProvider({ children, publicKey, queryEndpoint, queryHeaders, withCredentials, clerkOrgId, onOnboardComplete, flagsList, getAuthorizationToken, theme, eventTracking, onRequestAddVirtualTable, hideEnvDropdown, }: QuillProviderProps): react_jsx_runtime.JSX.Element;
+declare function AdminProvider({ children, publicKey, queryEndpoint, streamEndpoint, queryHeaders, withCredentials, clerkOrgId, onOnboardComplete, flagsList, getAuthorizationToken, theme, eventTracking, onRequestAddVirtualTable, hideEnvDropdown, }: QuillProviderProps): react_jsx_runtime.JSX.Element;
 
 interface QuillFetchOptions {
     client: Pick<QuillProviderClient, 'clientId' | 'queryEndpoint' | 'queryHeaders' | 'withCredentials'>;
@@ -123,13 +125,6 @@ interface QuillFetchOptions {
     getToken: () => Promise<string>;
     adminMode?: boolean;
 }
-interface QuillResults {
-    data?: any;
-    queries?: any;
-    status?: string;
-    error?: string;
-    message?: string;
-}
 
 interface ColumnsByTable {
     tableName: string;
@@ -163,6 +158,7 @@ type Table = {
     isSelectStar: boolean;
     displayName: string;
     name: string;
+    description?: string;
     columns: ColumnInternal[];
     viewQuery: string;
     customFieldInfo: any;
@@ -335,6 +331,7 @@ interface State {
     loading: boolean;
     publicKey: string;
     queryEndpoint: string;
+    streamEndpoint?: string;
     queryHeaders: object | undefined;
     withCredentials: boolean | undefined;
     client: any;
@@ -376,7 +373,12 @@ interface State {
         tenantField: string;
         tenantIds: (string | number)[];
     }[] | (string | number)[];
-    activeSandboxId?: string | null;
+    /** Source (live) client id when viewing a sandbox environment. */
+    sandboxParentClientId: string | null;
+    /** Agent sandbox client id from the client task response. */
+    sandboxClientId: string | null;
+    /** Agent sandbox session id from the client task response. */
+    sandboxSessionId: string | null;
     /**
      * When true, dashboard / virtual-table surfaces omit the in-page environment
      * selector (e.g. when the host app renders env selection in a global header).
@@ -392,6 +394,12 @@ type Action = {
 } | {
     type: 'SET_CLIENTS';
     payload: any[];
+} | {
+    type: 'PATCH_CLIENT_NAME';
+    payload: {
+        clientId: string;
+        name: string;
+    };
 } | {
     type: 'UPDATE_CLIENTS';
     payload: any;
@@ -478,8 +486,12 @@ type Action = {
     type: 'SET_ALL_STATE';
     payload: any;
 } | {
-    type: 'SET_ACTIVE_SANDBOX_ID';
-    payload: string | null;
+    type: 'SET_SANDBOX_FIELDS';
+    payload: {
+        sandboxParentClientId: string | null;
+        sandboxClientId: string | null;
+        sandboxSessionId: string | null;
+    };
 } | {
     type: 'SET_HIDE_ENV_DROPDOWN';
     payload: boolean;
@@ -495,7 +507,8 @@ declare const useAdmin: () => {
     state: State;
     dispatch: React.Dispatch<Action>;
     clientLoading: boolean;
-    setClient: (client: QuillProviderClient, fetchTenantInfo?: boolean, preserveSelectedDashboard?: boolean) => void;
+    setClient: (client: QuillProviderClient, fetchTenantInfo?: boolean, preserveSelectedDashboard?: boolean, resetSandbox?: boolean, forceRefresh?: boolean) => void;
+    refreshClientsList: (clientId?: string) => Promise<any[]>;
     getToken: () => Promise<string>;
     quillFetchWithToken: (options: Omit<QuillFetchOptions, "getToken">) => Promise<QuillResults>;
     eventTracking: EventTracking | null;
@@ -508,8 +521,7 @@ declare function DashboardManager({ navigateToVirtualTableManager: navigateToVir
     containerStyle?: CSSProperties;
 }): react_jsx_runtime.JSX.Element;
 
-declare function ChartQueryBuilder({ activeComponent, onExit, containerStyle, destinationDashboard, }: {
-    activeComponent: string;
+declare function ChartQueryBuilder({ onExit, containerStyle, destinationDashboard, }: {
     onExit?: (report?: QuillReport$1) => void;
     containerStyle?: CSSProperties;
     destinationDashboard: string;
@@ -528,10 +540,11 @@ declare function CreateEnvironment({ onOnboardComplete, containerStyle, }: {
 
 interface EnvSelectPopoverProps {
     clients: any[];
-    setClient: (client: any) => void;
+    setClient: (client: any, refreshTenants?: boolean) => void;
     client: any;
     theme: any;
-    onSelectedEditEnvironment?: (environment: string) => void;
+    /** Open edit-environment UI (caller should expect `state.client` to become the active sandbox first). */
+    onSelectedEditEnvironment?: () => void;
     parentRef: React.RefObject<HTMLDivElement | null>;
     isLoading?: boolean;
     onCreateNewEnvironment?: () => void;
@@ -587,7 +600,7 @@ declare function QuillSelectComponentWithCombo({ options, value, width, onChange
 declare function EditEnvironmentModal({ isOpen, setIsOpen, onSave, ModalComponent, TextInputComponent, ButtonComponent, HeaderComponent, SecondaryButtonComponent, }: {
     isOpen: boolean;
     setIsOpen: (isOpen: boolean) => void;
-    onSave: () => void;
+    onSave: () => void | Promise<void>;
     ModalComponent: any;
     TextInputComponent: ForwardRefExoticComponent<TextInputPrimitiveProps & RefAttributes<HTMLInputElement>> | ((props: TextInputPrimitiveProps) => React__default.JSX.Element);
     ButtonComponent: any;
@@ -676,19 +689,31 @@ interface AgentChatState {
     setMessages: React.Dispatch<React.SetStateAction<ChatMessage[]>>;
     session: SessionInfo | null;
     setSession: React.Dispatch<React.SetStateAction<SessionInfo | null>>;
-    sessionInitializedForClientId: string | null;
-    setSessionInitializedForClientId: React.Dispatch<React.SetStateAction<string | null>>;
     showToolOutputs: boolean;
     setShowToolOutputs: React.Dispatch<React.SetStateAction<boolean>>;
+    changelogEntries: ChangelogEntry[];
+    setChangelogEntries: (entries: ChangelogEntry[]) => void;
+    clearChangelogEntries: () => void;
+    /** Widgets + app-data refresh; only for fetch-changelog-list results. */
+    applyFetchChangelogListResult?: (entries: ChangelogEntry[]) => Promise<void>;
 }
 declare function useAgentChat(): AgentChatState;
 
 declare function exportChatAsMarkdown(messages: ChatMessage[]): void;
 
+declare function useSandboxSession(): {
+    sessionId: string | null;
+    sandboxClientId: string | null;
+    sourceClientId: string | null;
+    session: SessionInfo | null;
+};
+
+declare function clearQuillSandboxStorage(): void;
+
 /**
  * Environment selector plus create / edit environment modals.
  * Used in GlobalHeader and can be mounted in host app nav when managers use hideEnvDropdown.
  */
 declare function EnvironmentSwitcherWithModals(): react_jsx_runtime.JSX.Element;
 
-export { AdminProvider, AgentChat, AgentChatPanel, type AgentChatProps, ButtonPrimitive, ChartQueryBuilder as ChartBuilder, type ChatMessage, CreateEnvironment, CreateEnvironmentModal, DashboardManager, EditEnvironmentModal, EnvSelectPopover, EnvironmentSwitcherWithModals, HeaderPrimitive, ModalPrimitive, QuillSelectComponentWithCombo, SecondaryButtonPrimitive, type SessionInfo, TextInputPrimitive, type ToolCall, VirtualTableManager, exportChatAsMarkdown, useAdmin, useAgentChat };
+export { AdminProvider, AgentChat, AgentChatPanel, type AgentChatProps, ButtonPrimitive, ChartQueryBuilder as ChartBuilder, type ChatMessage, CreateEnvironment, CreateEnvironmentModal, DashboardManager, EditEnvironmentModal, EnvSelectPopover, EnvironmentSwitcherWithModals, HeaderPrimitive, ModalPrimitive, QuillSelectComponentWithCombo, SecondaryButtonPrimitive, type SessionInfo, TextInputPrimitive, type ToolCall, VirtualTableManager, clearQuillSandboxStorage, exportChatAsMarkdown, useAdmin, useAgentChat, useSandboxSession };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default, { CSSProperties, ForwardRefExoticComponent, RefAttributes } from 'react';
-import { EventTracking, InternalFilter, QuillReport as QuillReport$1, QuillTheme as QuillTheme$1 } from '@quillsql/react';
+import { EventTracking, InternalFilter, QuillResults, QuillReport as QuillReport$1, QuillTheme as QuillTheme$1, ChangelogEntry } from '@quillsql/react';
 
 type QuillTenant = {
     name: string;
@@ -101,16 +101,18 @@ interface BaseQuillProviderProps {
 }
 interface QuillCloudProviderProps extends BaseQuillProviderProps {
     queryEndpoint: never;
+    streamEndpoint: never;
     queryHeaders?: never;
     withCredentials?: never;
 }
 interface SelfHostedProviderProps extends BaseQuillProviderProps {
     queryEndpoint: string;
+    streamEndpoint?: string;
     queryHeaders?: object;
     withCredentials?: boolean;
 }
 type QuillProviderProps = QuillCloudProviderProps | SelfHostedProviderProps;
-declare function AdminProvider({ children, publicKey, queryEndpoint, queryHeaders, withCredentials, clerkOrgId, onOnboardComplete, flagsList, getAuthorizationToken, theme, eventTracking, onRequestAddVirtualTable, hideEnvDropdown, }: QuillProviderProps): react_jsx_runtime.JSX.Element;
+declare function AdminProvider({ children, publicKey, queryEndpoint, streamEndpoint, queryHeaders, withCredentials, clerkOrgId, onOnboardComplete, flagsList, getAuthorizationToken, theme, eventTracking, onRequestAddVirtualTable, hideEnvDropdown, }: QuillProviderProps): react_jsx_runtime.JSX.Element;
 
 interface QuillFetchOptions {
     client: Pick<QuillProviderClient, 'clientId' | 'queryEndpoint' | 'queryHeaders' | 'withCredentials'>;
@@ -123,13 +125,6 @@ interface QuillFetchOptions {
     getToken: () => Promise<string>;
     adminMode?: boolean;
 }
-interface QuillResults {
-    data?: any;
-    queries?: any;
-    status?: string;
-    error?: string;
-    message?: string;
-}
 
 interface ColumnsByTable {
     tableName: string;
@@ -163,6 +158,7 @@ type Table = {
     isSelectStar: boolean;
     displayName: string;
     name: string;
+    description?: string;
     columns: ColumnInternal[];
     viewQuery: string;
     customFieldInfo: any;
@@ -335,6 +331,7 @@ interface State {
     loading: boolean;
     publicKey: string;
     queryEndpoint: string;
+    streamEndpoint?: string;
     queryHeaders: object | undefined;
     withCredentials: boolean | undefined;
     client: any;
@@ -376,7 +373,12 @@ interface State {
         tenantField: string;
         tenantIds: (string | number)[];
     }[] | (string | number)[];
-    activeSandboxId?: string | null;
+    /** Source (live) client id when viewing a sandbox environment. */
+    sandboxParentClientId: string | null;
+    /** Agent sandbox client id from the client task response. */
+    sandboxClientId: string | null;
+    /** Agent sandbox session id from the client task response. */
+    sandboxSessionId: string | null;
     /**
      * When true, dashboard / virtual-table surfaces omit the in-page environment
      * selector (e.g. when the host app renders env selection in a global header).
@@ -392,6 +394,12 @@ type Action = {
 } | {
     type: 'SET_CLIENTS';
     payload: any[];
+} | {
+    type: 'PATCH_CLIENT_NAME';
+    payload: {
+        clientId: string;
+        name: string;
+    };
 } | {
     type: 'UPDATE_CLIENTS';
     payload: any;
@@ -478,8 +486,12 @@ type Action = {
     type: 'SET_ALL_STATE';
     payload: any;
 } | {
-    type: 'SET_ACTIVE_SANDBOX_ID';
-    payload: string | null;
+    type: 'SET_SANDBOX_FIELDS';
+    payload: {
+        sandboxParentClientId: string | null;
+        sandboxClientId: string | null;
+        sandboxSessionId: string | null;
+    };
 } | {
     type: 'SET_HIDE_ENV_DROPDOWN';
     payload: boolean;
@@ -495,7 +507,8 @@ declare const useAdmin: () => {
     state: State;
     dispatch: React.Dispatch<Action>;
     clientLoading: boolean;
-    setClient: (client: QuillProviderClient, fetchTenantInfo?: boolean, preserveSelectedDashboard?: boolean) => void;
+    setClient: (client: QuillProviderClient, fetchTenantInfo?: boolean, preserveSelectedDashboard?: boolean, resetSandbox?: boolean, forceRefresh?: boolean) => void;
+    refreshClientsList: (clientId?: string) => Promise<any[]>;
     getToken: () => Promise<string>;
     quillFetchWithToken: (options: Omit<QuillFetchOptions, "getToken">) => Promise<QuillResults>;
     eventTracking: EventTracking | null;
@@ -508,8 +521,7 @@ declare function DashboardManager({ navigateToVirtualTableManager: navigateToVir
     containerStyle?: CSSProperties;
 }): react_jsx_runtime.JSX.Element;
 
-declare function ChartQueryBuilder({ activeComponent, onExit, containerStyle, destinationDashboard, }: {
-    activeComponent: string;
+declare function ChartQueryBuilder({ onExit, containerStyle, destinationDashboard, }: {
     onExit?: (report?: QuillReport$1) => void;
     containerStyle?: CSSProperties;
     destinationDashboard: string;
@@ -528,10 +540,11 @@ declare function CreateEnvironment({ onOnboardComplete, containerStyle, }: {
 
 interface EnvSelectPopoverProps {
     clients: any[];
-    setClient: (client: any) => void;
+    setClient: (client: any, refreshTenants?: boolean) => void;
     client: any;
     theme: any;
-    onSelectedEditEnvironment?: (environment: string) => void;
+    /** Open edit-environment UI (caller should expect `state.client` to become the active sandbox first). */
+    onSelectedEditEnvironment?: () => void;
     parentRef: React.RefObject<HTMLDivElement | null>;
     isLoading?: boolean;
     onCreateNewEnvironment?: () => void;
@@ -587,7 +600,7 @@ declare function QuillSelectComponentWithCombo({ options, value, width, onChange
 declare function EditEnvironmentModal({ isOpen, setIsOpen, onSave, ModalComponent, TextInputComponent, ButtonComponent, HeaderComponent, SecondaryButtonComponent, }: {
     isOpen: boolean;
     setIsOpen: (isOpen: boolean) => void;
-    onSave: () => void;
+    onSave: () => void | Promise<void>;
     ModalComponent: any;
     TextInputComponent: ForwardRefExoticComponent<TextInputPrimitiveProps & RefAttributes<HTMLInputElement>> | ((props: TextInputPrimitiveProps) => React__default.JSX.Element);
     ButtonComponent: any;
@@ -676,19 +689,31 @@ interface AgentChatState {
     setMessages: React.Dispatch<React.SetStateAction<ChatMessage[]>>;
     session: SessionInfo | null;
     setSession: React.Dispatch<React.SetStateAction<SessionInfo | null>>;
-    sessionInitializedForClientId: string | null;
-    setSessionInitializedForClientId: React.Dispatch<React.SetStateAction<string | null>>;
     showToolOutputs: boolean;
     setShowToolOutputs: React.Dispatch<React.SetStateAction<boolean>>;
+    changelogEntries: ChangelogEntry[];
+    setChangelogEntries: (entries: ChangelogEntry[]) => void;
+    clearChangelogEntries: () => void;
+    /** Widgets + app-data refresh; only for fetch-changelog-list results. */
+    applyFetchChangelogListResult?: (entries: ChangelogEntry[]) => Promise<void>;
 }
 declare function useAgentChat(): AgentChatState;
 
 declare function exportChatAsMarkdown(messages: ChatMessage[]): void;
 
+declare function useSandboxSession(): {
+    sessionId: string | null;
+    sandboxClientId: string | null;
+    sourceClientId: string | null;
+    session: SessionInfo | null;
+};
+
+declare function clearQuillSandboxStorage(): void;
+
 /**
  * Environment selector plus create / edit environment modals.
  * Used in GlobalHeader and can be mounted in host app nav when managers use hideEnvDropdown.
  */
 declare function EnvironmentSwitcherWithModals(): react_jsx_runtime.JSX.Element;
 
-export { AdminProvider, AgentChat, AgentChatPanel, type AgentChatProps, ButtonPrimitive, ChartQueryBuilder as ChartBuilder, type ChatMessage, CreateEnvironment, CreateEnvironmentModal, DashboardManager, EditEnvironmentModal, EnvSelectPopover, EnvironmentSwitcherWithModals, HeaderPrimitive, ModalPrimitive, QuillSelectComponentWithCombo, SecondaryButtonPrimitive, type SessionInfo, TextInputPrimitive, type ToolCall, VirtualTableManager, exportChatAsMarkdown, useAdmin, useAgentChat };
+export { AdminProvider, AgentChat, AgentChatPanel, type AgentChatProps, ButtonPrimitive, ChartQueryBuilder as ChartBuilder, type ChatMessage, CreateEnvironment, CreateEnvironmentModal, DashboardManager, EditEnvironmentModal, EnvSelectPopover, EnvironmentSwitcherWithModals, HeaderPrimitive, ModalPrimitive, QuillSelectComponentWithCombo, SecondaryButtonPrimitive, type SessionInfo, TextInputPrimitive, type ToolCall, VirtualTableManager, clearQuillSandboxStorage, exportChatAsMarkdown, useAdmin, useAgentChat, useSandboxSession };