@wisdomai/react 0.0.8 → 0.0.10

package/AGENTS.md

@@ -8,13 +8,16 @@ and interactive filtering. This file is a condensed, actionable companion to
 ## Install
 
 ```bash
-npm install @wisdomai/react
+npm install @wisdomai/react \
+  @mui/material@^7 @mui/x-date-pickers@^7 \
+  @emotion/react@^11 @emotion/styled@^11 \
+  highcharts@^12 highcharts-react-official@^3 \
+  graphql@^16 luxon@^3
 ```
 
-The host app must provide these peer dependencies: `react` (>=18), `react-dom`
-(>=18), `@mui/material` (^7), `@mui/x-date-pickers` (^7), `@emotion/react` (^11),
-`@emotion/styled` (^11), `highcharts` (^12), `highcharts-react-official` (^3),
-`graphql` (^16), `luxon` (^3).
+Keep the version pins — an unpinned `npm install @mui/material …` resolves to
+the latest major and fails `ERESOLVE` against the SDK's peer ranges. The host
+app must additionally provide `react` (>=18) and `react-dom` (>=18).
 
 `@wisdomai/react` is **ESM-only**. Pure-CommonJS callers must use dynamic
 `import()`.

package/README.md

@@ -20,10 +20,14 @@ The layout, data, and filter specs come from the dashboard you built in Wisdom;
 ## Installation
 
 ```bash
-npm install @wisdomai/react
+npm install @wisdomai/react \
+  @mui/material@^7 @mui/x-date-pickers@^7 \
+  @emotion/react@^11 @emotion/styled@^11 \
+  highcharts@^12 highcharts-react-official@^3 \
+  graphql@^16 luxon@^3
 ```
 
-Provide these peer dependencies from your app: `react` (>=18), `react-dom` (>=18), `@mui/material` (^7), `@mui/x-date-pickers` (^7), `@emotion/react` (^11), `@emotion/styled` (^11), `highcharts` (^12), `highcharts-react-official` (^3), `graphql` (^16), `luxon` (^3).
+Keep the version pins — installing these peers unpinned resolves to their latest majors and fails `ERESOLVE` against the SDK's peer ranges. Your app must additionally provide `react` (>=18) and `react-dom` (>=18).
 
 > Using an AI coding agent? The package ships an [`AGENTS.md`](./AGENTS.md) with condensed, copy-ready setup steps — point your agent at it to scaffold the integration.
 
@@ -223,3 +227,15 @@ All errors thrown by the client extend `WisdomError`:
 - `WisdomAuthError` — JWT rejected or expired (HTTP 401/403, or GraphQL `UNAUTHENTICATED` / `INVALID_TOKEN`). Consumers should call `refresh()` to re-fetch a token.
 - `WisdomDashboardNotFoundError` — `dashboards.get(id)` could not return a dashboard because the ID does not exist or the caller lacks access (server emits `NOT_FOUND` or `FORBIDDEN`).
 - `WisdomError` — everything else (network failure, 5xx, malformed response, uncategorized backend errors). Carries an optional `cause` and, for GraphQL-level failures, an `errors` array.
+
+## Releasing
+
+The SDK ships a frozen set of GraphQL operations to consumers who cannot re-run codegen, so a backend schema change that removes a field one of those operations uses will hard-fail every dashboard with HTTP 400. To guard against that, the published operation set is snapshotted to `published-operations.graphql` and the `sdk-schema-compat` CI gate validates it against the live app-server schema on every change.
+
+When cutting a release, after bumping the version:
+
+```bash
+pnpm run sdk:snapshot-operations   # from the javascript/ root — refreshes published-operations.graphql
+```
+
+Commit the refreshed snapshot alongside the version bump, then publish. Skipping this only weakens protection for newly-added operations; it never produces a false CI failure.

package/dist/SdkErrorBoundary.d.ts

@@ -0,0 +1,20 @@
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+interface SdkErrorBoundaryProps {
+    /** Rendered in place of the children after a render error. */
+    fallback: (error: Error) => ReactNode;
+    children: ReactNode;
+}
+interface SdkErrorBoundaryState {
+    error: Error | null;
+}
+/**
+ * Internal boundary so a render error in one SDK widget degrades to an error
+ * card instead of unmounting the embedding host's entire React tree.
+ */
+export declare class SdkErrorBoundary extends Component<SdkErrorBoundaryProps, SdkErrorBoundaryState> {
+    state: SdkErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): SdkErrorBoundaryState;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};

package/dist/dashboard/DashboardWidget.d.ts

@@ -3,4 +3,4 @@ export interface DashboardWidgetProps {
     /** Optional — when omitted, reads the id from `<DashboardProvider>`. */
     dashboardId?: string;
 }
-export declare function DashboardWidget({ widgetId, dashboardId: dashboardIdProp }: DashboardWidgetProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function DashboardWidget(props: DashboardWidgetProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/generated/graphql/graphql.d.ts

@@ -4154,6 +4154,8 @@ export declare enum FilterType {
 }
 export type Folder = {
     __typename?: 'Folder';
+    accessLevel: FolderScope;
+    canManage: Scalars['Boolean']['output'];
     createdAt: Scalars['DateTime']['output'];
     deletedAt?: Maybe<Scalars['DateTime']['output']>;
     folderType: FolderType;
@@ -4198,6 +4200,11 @@ export declare enum FolderResourceType {
     DASHBOARD = "DASHBOARD",
     DOMAIN = "DOMAIN"
 }
+export declare enum FolderScope {
+    EDITOR = "EDITOR",
+    NO_ACCESS = "NO_ACCESS",
+    VIEWER = "VIEWER"
+}
 export type FolderTreeNode = {
     __typename?: 'FolderTreeNode';
     children: Array<FolderTreeNode>;
@@ -6133,6 +6140,7 @@ export type Mutation = {
     triggerQueryHistoryMining: TriggerQueryHistoryMiningResponse;
     triggerSSOSync: ResponseStatus;
     triggerSchedule: TriggerScheduleResponse;
+    triggerUserAuthoredContextVerify: TriggerUserAuthoredContextVerifyResult;
     unarchiveWorkspace: ResponseStatus;
     unassignRole: UnassignRoleResponse;
     undoModelingSuggestions: Array<ApplyModelingSuggestionResult>;
@@ -7395,6 +7403,10 @@ export type MutationTriggerScheduleArgs = {
     parameterValueSets?: InputMaybe<Array<AgentParameterValueSetInput>>;
     parameterValues?: InputMaybe<Array<AgentParameterValueInput>>;
 };
+export type MutationTriggerUserAuthoredContextVerifyArgs = {
+    contextId: Scalars['String']['input'];
+    domainId: Scalars['String']['input'];
+};
 export type MutationUnarchiveWorkspaceArgs = {
     input: UnarchiveWorkspaceInput;
 };
@@ -8462,6 +8474,7 @@ export type Query = {
      * the user has access to. Optional domainId narrows the result to a single domain.
      */
     currentUserReviewedQueries: Array<UserReviewedQueryItemWithDomainContext>;
+    currentUserRootFolder: Folder;
     dashboard: Dashboard;
     dashboardAppWidgetData?: Maybe<Scalars['JSON']['output']>;
     dashboardBundle: DataBundle;
@@ -8549,6 +8562,7 @@ export type Query = {
     expandVirtualDomainId: Array<Scalars['String']['output']>;
     fileBlueprints: Array<FileBlueprint>;
     filesForDataset: Array<DatasetFile>;
+    folderBreadcrumb: Array<Folder>;
     folderContents: FolderWithContents;
     folderContentsPage: FolderContentsResponse;
     folderTree: Array<FolderTreeNode>;
@@ -8575,6 +8589,7 @@ export type Query = {
     getReviewedQueryItemsCount: Scalars['Int']['output'];
     getScheduleOverride: ScheduleOverrideResponse;
     getSynonymSets: SynonymSetsResponse;
+    getUserAuthoredContextVerifyStatus: UserAuthoredContextVerifyStatus;
     getVerboseSemanticEngineRuntimeInfo: Scalars['String']['output'];
     hitsForContainer: Array<Hit>;
     impersonateUser: Scalars['String']['output'];
@@ -8716,9 +8731,9 @@ export type Query = {
     workspace: Workspace;
     workspaceExists: Scalars['Boolean']['output'];
     workspaces: Array<Workspace>;
-    writableFolderDestinationsForCreate: Array<Folder>;
-    writableFolderDestinationsForFolderMove: Array<Folder>;
-    writableFolderDestinationsForResourceMove: Array<Folder>;
+    writableFolderDestinationsForCreate: Array<WritableFolderDestination>;
+    writableFolderDestinationsForFolderMove: Array<WritableFolderDestination>;
+    writableFolderDestinationsForResourceMove: Array<WritableFolderDestination>;
 };
 export type QueryAdminConversationsArgs = {
     filter?: InputMaybe<AllConversationFilterInput>;
@@ -8861,6 +8876,10 @@ export type QueryCreateVisualizationArgs = {
 export type QueryCurrentUserReviewedQueriesArgs = {
     domainId?: InputMaybe<Scalars['ID']['input']>;
 };
+export type QueryCurrentUserRootFolderArgs = {
+    resourceScope: FolderResourceType;
+    workspaceID?: InputMaybe<Scalars['ID']['input']>;
+};
 export type QueryDashboardArgs = {
     id: Scalars['String']['input'];
     scope: DashboardScope;
@@ -9084,6 +9103,10 @@ export type QueryFilesForDatasetArgs = {
     domainId: Scalars['ID']['input'];
     prefixSearch?: InputMaybe<Scalars['String']['input']>;
 };
+export type QueryFolderBreadcrumbArgs = {
+    folderID: Scalars['ID']['input'];
+    workspaceID?: InputMaybe<Scalars['ID']['input']>;
+};
 export type QueryFolderContentsArgs = {
     folderID: Scalars['ID']['input'];
     workspaceID?: InputMaybe<Scalars['ID']['input']>;
@@ -9173,6 +9196,9 @@ export type QueryGetSynonymSetsArgs = {
     domainId: Scalars['String']['input'];
     draftId?: InputMaybe<Scalars['ID']['input']>;
 };
+export type QueryGetUserAuthoredContextVerifyStatusArgs = {
+    domainId: Scalars['String']['input'];
+};
 export type QueryGetVerboseSemanticEngineRuntimeInfoArgs = {
     columnFilters?: InputMaybe<Array<Scalars['String']['input']>>;
     domainId: Scalars['ID']['input'];
@@ -9595,10 +9621,9 @@ export type RefreshBundleResponse = {
 };
 export type RefreshContextStalenessResult = {
     __typename?: 'RefreshContextStalenessResult';
+    jobRunId: Scalars['String']['output'];
     previousStaleMeasureCount: Scalars['Int']['output'];
     previousStaleQueryCount: Scalars['Int']['output'];
-    staleMeasureCount: Scalars['Int']['output'];
-    staleQueryCount: Scalars['Int']['output'];
 };
 export type RefreshWidgetTrajectoryMutationInput = {
     dashboardId: Scalars['String']['input'];
@@ -9722,6 +9747,7 @@ export declare enum RequestChannelType {
     DOMAIN_HEALTH = "DOMAIN_HEALTH",
     DOMAIN_KNOWLEDGE_AGENT = "DOMAIN_KNOWLEDGE_AGENT",
     EMBEDDED_IFRAMES = "EMBEDDED_IFRAMES",
+    EVAL_JOB = "EVAL_JOB",
     MCP = "MCP",
     REPORT_WRITER = "REPORT_WRITER",
     SCHEDULED_CONVERSATION = "SCHEDULED_CONVERSATION",
@@ -10482,14 +10508,16 @@ export type SqlServerConnectionConfig = {
     host: Scalars['String']['output'];
     password: Scalars['String']['output'];
     port: Scalars['Int']['output'];
+    servicePrincipalClientSecretAuth?: Maybe<AzureServicePrincipalClientSecretAuth>;
     username: Scalars['String']['output'];
 };
 export type SqlServerConnectionConfigInput = {
     databaseFilters?: InputMaybe<Array<Scalars['String']['input']>>;
     host: Scalars['String']['input'];
-    password: Scalars['String']['input'];
+    password?: InputMaybe<Scalars['String']['input']>;
     port: Scalars['Int']['input'];
-    username: Scalars['String']['input'];
+    servicePrincipalClientSecretAuth?: InputMaybe<AzureServicePrincipalClientSecretAuthInput>;
+    username?: InputMaybe<Scalars['String']['input']>;
 };
 export type SshTunnelConfig = {
     __typename?: 'SshTunnelConfig';
@@ -10633,6 +10661,7 @@ export type SubscriptionRunAgentAnalysisArgs = {
     agentInput?: InputMaybe<Scalars['String']['input']>;
     auth: SubscriptionAuthInput;
     inlineAnalysisTask: AnalysisScheduleTaskInput;
+    parameterValues?: InputMaybe<Array<AgentParameterValueInput>>;
 };
 export type SubscriptionStreamAgentPreviewRunArgs = {
     auth: SubscriptionAuthInput;
@@ -11129,6 +11158,12 @@ export type TriggerScheduleResponse = {
     message: Scalars['String']['output'];
     runId?: Maybe<Scalars['String']['output']>;
 };
+export type TriggerUserAuthoredContextVerifyResult = {
+    __typename?: 'TriggerUserAuthoredContextVerifyResult';
+    jobRunId?: Maybe<Scalars['String']['output']>;
+    message: Scalars['String']['output'];
+    status: UserAuthoredContextVerifyTriggerStatus;
+};
 export type TrinoConnectionConfig = {
     __typename?: 'TrinoConnectionConfig';
     catalogSchemaFilters?: Maybe<Array<CatalogSchemaFilterKv>>;
@@ -11449,6 +11484,26 @@ export type UserAuthoredContextVerificationSourceInfo = {
     newContextId: Scalars['String']['output'];
     rationale: Scalars['String']['output'];
 };
+export type UserAuthoredContextVerifyRun = {
+    __typename?: 'UserAuthoredContextVerifyRun';
+    contextId: Scalars['String']['output'];
+    /** True for a recently-failed run (show 'couldn't complete'); false while verifying. */
+    failed: Scalars['Boolean']['output'];
+    jobRunId: Scalars['String']['output'];
+    progressDone: Scalars['Int']['output'];
+    progressTotal: Scalars['Int']['output'];
+};
+export type UserAuthoredContextVerifyStatus = {
+    __typename?: 'UserAuthoredContextVerifyStatus';
+    /** The domain's single in-flight (or failed) verification, if any. */
+    activeRun?: Maybe<UserAuthoredContextVerifyRun>;
+};
+export declare enum UserAuthoredContextVerifyTriggerStatus {
+    USER_AUTHORED_CONTEXT_VERIFY_TRIGGER_STATUS_ERROR = "USER_AUTHORED_CONTEXT_VERIFY_TRIGGER_STATUS_ERROR",
+    USER_AUTHORED_CONTEXT_VERIFY_TRIGGER_STATUS_INVALID_INPUT = "USER_AUTHORED_CONTEXT_VERIFY_TRIGGER_STATUS_INVALID_INPUT",
+    USER_AUTHORED_CONTEXT_VERIFY_TRIGGER_STATUS_OK = "USER_AUTHORED_CONTEXT_VERIFY_TRIGGER_STATUS_OK",
+    USER_AUTHORED_CONTEXT_VERIFY_TRIGGER_STATUS_UNSPECIFIED = "USER_AUTHORED_CONTEXT_VERIFY_TRIGGER_STATUS_UNSPECIFIED"
+}
 /** One entry per FE inline-edit save. Lives inside EditableStringFieldHistory on each editable leaf task. */
 export type UserEditEvent = {
     __typename?: 'UserEditEvent';
@@ -11881,6 +11936,11 @@ export type WorkspacesFilterInput = {
     statusFilter?: InputMaybe<Array<WorkspaceStatus>>;
     uris?: InputMaybe<Array<Scalars['String']['input']>>;
 };
+export type WritableFolderDestination = {
+    __typename?: 'WritableFolderDestination';
+    folder: Folder;
+    selectable: Scalars['Boolean']['output'];
+};
 export type SdkColumnFragmentFragment = {
     __typename?: 'DataframeColumn';
     name: string;

package/dist/index.js

@@ -737,6 +737,27 @@ var WisdomClient = class {
   }
 };
 
+// src/SdkErrorBoundary.tsx
+import { Component } from "react";
+var SdkErrorBoundary = class extends Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    console.error("[@wisdomai/react] Render error caught by SDK boundary:", error, info.componentStack);
+  }
+  render() {
+    if (this.state.error) {
+      return this.props.fallback(this.state.error);
+    }
+    return this.props.children;
+  }
+};
+
 // src/dashboard/DashboardContext.tsx
 import { createContext, useContext } from "react";
 var DashboardContext = createContext(null);
@@ -19762,7 +19783,20 @@ function WisdomVisualization({ visualization, fetchMore }) {
 
 // src/dashboard/DashboardWidget.tsx
 import { jsx as jsx32 } from "@emotion/react/jsx-runtime";
-function DashboardWidget({ widgetId, dashboardId: dashboardIdProp }) {
+function DashboardWidget(props) {
+  return (
+    // Keyed by widget identity so swapping widgets clears a prior error.
+    /* @__PURE__ */ jsx32(
+      SdkErrorBoundary,
+      {
+        fallback: () => /* @__PURE__ */ jsx32(WidgetCard, { title: "", children: /* @__PURE__ */ jsx32(WidgetErrorBody, { message: "Something went wrong rendering this widget" }) }),
+        children: /* @__PURE__ */ jsx32(DashboardWidgetBody, { ...props })
+      },
+      props.widgetId
+    )
+  );
+}
+function DashboardWidgetBody({ widgetId, dashboardId: dashboardIdProp }) {
   const { status: dashboardStatus, error: dashboardError, dashboard } = useDashboard();
   const { widget, status, error, fetchMore } = useDashboardWidget(widgetId, dashboardIdProp);
   const captureRef = useRef6(null);
@@ -19896,10 +19930,21 @@ function DashboardLayout() {
   ] });
 }
 function Dashboard(props) {
-  if (props.dashboardId !== void 0) {
-    return /* @__PURE__ */ jsx34(DashboardProvider, { dashboardId: props.dashboardId, scope: props.scope, children: /* @__PURE__ */ jsx34(DashboardLayout, {}) });
-  }
-  return /* @__PURE__ */ jsx34(DashboardProvider, { dashboard: props.dashboard, children: /* @__PURE__ */ jsx34(DashboardLayout, {}) });
+  const dashboardKey = props.dashboardId ?? props.dashboard.id;
+  return (
+    // Keyed by dashboard identity so switching dashboards clears a prior error.
+    /* @__PURE__ */ jsx34(
+      SdkErrorBoundary,
+      {
+        fallback: (error) => /* @__PURE__ */ jsxs20("p", { role: "alert", style: { color: "crimson", margin: 0 }, children: [
+          "Failed to render dashboard: ",
+          error.message
+        ] }),
+        children: props.dashboardId !== void 0 ? /* @__PURE__ */ jsx34(DashboardProvider, { dashboardId: props.dashboardId, scope: props.scope, children: /* @__PURE__ */ jsx34(DashboardLayout, {}) }) : /* @__PURE__ */ jsx34(DashboardProvider, { dashboard: props.dashboard, children: /* @__PURE__ */ jsx34(DashboardLayout, {}) })
+      },
+      dashboardKey
+    )
+  );
 }
 
 // src/dashboard/useDashboardsList.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wisdomai/react",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "Wisdom AI React SDK",
   "license": "MIT",
   "type": "module",
@@ -45,8 +45,8 @@
     "react-markdown": "^9.0.1",
     "react-resizable": "^3.0.5",
     "remark-gfm": "^4.0.0",
-    "@wisdomai/visualization": "^0.3.3",
-    "@wisdomai/ui-kit": "^0.1.8"
+    "@wisdomai/ui-kit": "^0.1.10",
+    "@wisdomai/visualization": "^0.3.5"
   },
   "devDependencies": {
     "esbuild": "^0.27.0"