@datatechsolutions/ui 2.11.92 → 3.1.0

package/dist/{workflow-api-client-wLoap-tt.d.mts → workflow-api-client-DoYj7nHz.d.mts}

@@ -1,5 +1,5 @@
 import { WorkflowGraph, WorkflowRun, AgentRule, WorkflowTool, AgentTool, Workflow, VariableValue, AgentModel } from './astrlabe/contracts.mjs';
-import { A as AgentWithPrompts } from './index-AioB90qq.mjs';
+import { A as AgentWithPrompts } from './index-VI9gyJXl.mjs';
 import { AgentPrompt } from '@datatechsolutions/shared-domain/ports/workflow';
 import { AgentConfigLike, DataSource } from '@datatechsolutions/shared-domain/common';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -183,10 +183,26 @@ interface ModelProviderConnection {
     updatedAt?: string;
 }
 declare function listModelProviderConnections(): Promise<ModelProviderConnection[]>;
+/**
+ * One model family record joined onto a provider in the catalog.
+ * Mirrors the `FamilyView` shape returned by `agents_providers.rs`.
+ */
+type ModelFamilyCatalogEntry = {
+    id: string;
+    slug: string;
+    name: string;
+    modelIds: string[];
+    maxTokens?: number | null;
+    contextWindow?: string | null;
+    supportsTools?: boolean | null;
+    supportsVision?: boolean | null;
+    costTier?: string | null;
+};
 /**
  * Catalog of supported LLM providers. Previously hard-coded in the
- * connections modal; now backed by `astrlabe.model_providers` so new
- * providers can be added server-side without a frontend release.
+ * connections modal; now backed by `astrlabe.model_providers` +
+ * `astrlabe.model_families` so new providers can be added server-side
+ * without a frontend release.
  */
 type ModelProviderCatalogEntry = {
     id: string;
@@ -198,8 +214,15 @@ type ModelProviderCatalogEntry = {
     logoUrl?: string | null;
     docsUrl?: string | null;
     authType?: string | null;
+    /**
+     * Full family records joined from `model_families`. Empty array if no
+     * families are seeded for this provider (`custom`, where the operator
+     * supplies the model id at node-config time).
+     */
+    families: ModelFamilyCatalogEntry[];
+    /** @deprecated — array of family slugs only. New callers read `families`. */
     supportedModelFamilies?: unknown;
-    regions?: unknown;
+    regions?: string[] | null;
     enabled: boolean;
 };
 declare function listModelProviderCatalog(): Promise<ModelProviderCatalogEntry[]>;
@@ -358,34 +381,15 @@ declare function deleteUpload(objectKey: string): Promise<{
 }>;
 type RunEvent = {
     /**
-     * Discriminator for the event payload. Wire format is snake_case
-     * because the Rust engine's `ExecutionEvent.kind` (in
-     * `lambda-rs/.../engine/events.rs`) is set as `node_started` /
-     * `run_completed` / `ui_render` / etc. The `serde(rename = "type")`
-     * keeps the JSON key as `type` but the *value* stays snake_case
-     * end-to-end through Redis pub/sub and the SSE handler. Matches
-     * `WorkflowEventType` in `@datatechsolutions/shared-domain`.
-     *
-     * `ui_render` is the per-section generative-UI event — the agent's
-     * tool_use block content lives in `outputs.section`. `run_paused`
-     * is the human_approval pause, with `outputs.prompt` + `outputs.payload`.
+     * Discriminator for the event payload. The set is open-ended on purpose
+     * — Phase 2/3 of the generative-UI work adds `ui-render` (per-section
+     * progressive rendering) and `run-paused` (operator-input pause) without
+     * a breaking change.
      */
-    type: 'run_started' | 'node_started' | 'node_completed' | 'node_failed' | 'node_error' | 'run_completed' | 'run_failed' | 'run_paused' | 'ui_render' | 'log';
+    type: 'run-started' | 'node-started' | 'node-completed' | 'node-failed' | 'run-completed' | 'run-failed' | 'run-paused' | 'ui-render' | 'log';
     runId: string;
-    workflowId?: string;
     nodeId?: string;
-    nodeType?: string;
-    status?: string;
-    /**
-     * Engine attaches the executor's output here. For `node_completed`
-     * this is the node's full output; for `ui_render` it carries
-     * `{ section, toolName, toolUseId }`; for `run_paused` it carries
-     * `{ prompt, payload, kind, nodeId }` — the human_approval sentinel.
-     */
-    outputs?: Record<string, unknown>;
-    error?: string;
-    durationMs?: number;
-    /** RFC 3339. */
+    data?: Record<string, unknown>;
     timestamp: string;
 };
 type PublicSampleWorkflow = {
@@ -423,7 +427,34 @@ type ApprovalResponse = {
  * inputs, and re-executes — see #457.
  */
 declare function submitApproval(runId: string, nodeId: string, decision: ApprovalDecision): Promise<ApprovalResponse>;
-declare function subscribeToRunEvents(runId: string, onEvent: (event: RunEvent) => void, onError?: (error: Event) => void): () => void;
+/**
+ * Connection state for {@link subscribeToRunEvents}. UI consumers can
+ * surface this — e.g. show "reconnecting…" badge — by passing an
+ * `onState` callback.
+ */
+type RunSubscriptionState = 'live' | 'reconnecting' | 'polling' | 'closed';
+/**
+ * Subscribe to a run's event stream with auto-reconnect + polling fallback.
+ *
+ * The default `EventSource` drops silently on idle proxies / cold-restarts
+ * (CloudFront + Lambda Function URL combo at customer scale will close
+ * an idle connection after ~30–60s). When that happens the run viewer
+ * looks frozen with no signal to the user.
+ *
+ * Lifecycle:
+ *  1. Open SSE. On `open`, state = `live`.
+ *  2. On `error`, close the source and exponential-backoff (1s → 2s → 4s
+ *     → 8s → 16s, with jitter). State = `reconnecting`.
+ *  3. After {@link SSE_MAX_RECONNECT_ATTEMPTS} failures, fall back to
+ *     polling `GET /workflow-runs/{runId}` every 5s. State = `polling`.
+ *  4. On terminal event (`run-completed` / `run-failed`) or terminal
+ *     polled status (completed/failed/cancelled), close + state = `closed`.
+ *  5. Returned disposer also flips to `closed`; idempotent.
+ *
+ * Backwards-compatible with the previous 3-arg signature; pass `onState`
+ * as a 4th arg if you want to render connection-state UI.
+ */
+declare function subscribeToRunEvents(runId: string, onEvent: (event: RunEvent) => void, onError?: (error: Event) => void, onState?: (state: RunSubscriptionState) => void): () => void;
 declare function getAgentConfigsWithPrompts(): Promise<AgentWithPrompts[]>;
 declare function getDatasources(): Promise<DataSource[]>;
 declare function createDatasource(data: DatasourceFormData): Promise<DataSource>;
@@ -434,4 +465,4 @@ declare function getDatasourceSchema(datasourceId: string, table: string): Promi
     nullable?: boolean;
 }>>;
 
-export { getAnalyticsSummary as $, type AnalyticsSummary as A, createDatasource as B, createModelProviderConnection as C, type DatasourceFormData as D, createWorkflow as E, createWorkflowFromTemplate as F, deleteAgentConfig as G, deleteAgentPrompt as H, deleteAgentRule as I, deleteAgentTool as J, deleteAgentToolDefinition as K, deleteModelProviderConnection as L, type ModelProviderConnection as M, type NodeMetrics as N, deleteUpload as O, type PresignUploadInput as P, deleteWorkflow as Q, type RunTimelineEntry as R, executeAgentRule as S, executeWorkflow as T, getAgentConfigsWithPrompts as U, getAgentModels as V, type WorkflowRunListParams as W, getAgentPrompts as X, getAgentRules as Y, getAgentToolDefinitions as Z, getAgentTools as _, DIALECT_CATEGORIES as a, getCurrentAccessToken as a0, getDatasourceSchema as a1, getDatasourceTables as a2, getDatasources as a3, getPublicSampleWorkflow as a4, getRunTimeline as a5, getUploadDownloadUrl as a6, getWorkflowById as a7, getWorkflowRunById as a8, getWorkflowRuns as a9, getWorkflows as aa, listModelProviderCatalog as ab, listModelProviderConnections as ac, listWorkflowRuns as ad, listWorkflowTemplates as ae, presignUpload as af, publishWorkflow as ag, replayWorkflowRun as ah, saveWorkflowDraft as ai, setAccessTokenProvider as aj, setAuthenticatedFetch as ak, submitApproval as al, subscribeToRunEvents as am, updateAgentConfig as an, updateAgentPrompt as ao, updateAgentRule as ap, updateAgentTool as aq, updateAgentToolDefinition as ar, updateModelProviderConnection as as, updateWorkflowSettings as at, DatasourceFormModal as b, type DatasourceFormModalProps as c, DatasourceModal as d, type DatasourceModalProps as e, findCategory as f, findDialect as g, type AiGenerateResponse as h, type AiValidateResponse as i, type ApprovalDecision as j, type ApprovalResponse as k, type ModelProviderCatalogEntry as l, type NodeValidationIssue as m, type PresignedUpload as n, type PublicSampleWorkflow as o, type RunEvent as p, type WorkflowTemplateSummary as q, aiGenerateWorkflow as r, aiValidateWorkflow as s, buildAuthenticatedApiUrl as t, cancelWorkflowRun as u, createAgentConfig as v, createAgentPrompt as w, createAgentRule as x, createAgentTool as y, createAgentToolDefinition as z };
+export { getAgentToolDefinitions as $, type AnalyticsSummary as A, createAgentTool as B, createAgentToolDefinition as C, type DatasourceFormData as D, createDatasource as E, createModelProviderConnection as F, createWorkflow as G, createWorkflowFromTemplate as H, deleteAgentConfig as I, deleteAgentPrompt as J, deleteAgentRule as K, deleteAgentTool as L, type ModelProviderConnection as M, type NodeMetrics as N, deleteAgentToolDefinition as O, type PresignUploadInput as P, deleteModelProviderConnection as Q, type RunTimelineEntry as R, deleteUpload as S, deleteWorkflow as T, executeAgentRule as U, executeWorkflow as V, type WorkflowRunListParams as W, getAgentConfigsWithPrompts as X, getAgentModels as Y, getAgentPrompts as Z, getAgentRules as _, DIALECT_CATEGORIES as a, getAgentTools as a0, getAnalyticsSummary as a1, getCurrentAccessToken as a2, getDatasourceSchema as a3, getDatasourceTables as a4, getDatasources as a5, getPublicSampleWorkflow as a6, getRunTimeline as a7, getUploadDownloadUrl as a8, getWorkflowById as a9, getWorkflowRunById as aa, getWorkflowRuns as ab, getWorkflows as ac, listModelProviderCatalog as ad, listModelProviderConnections as ae, listWorkflowRuns as af, listWorkflowTemplates as ag, presignUpload as ah, publishWorkflow as ai, replayWorkflowRun as aj, saveWorkflowDraft as ak, setAccessTokenProvider as al, setAuthenticatedFetch as am, submitApproval as an, subscribeToRunEvents as ao, updateAgentConfig as ap, updateAgentPrompt as aq, updateAgentRule as ar, updateAgentTool as as, updateAgentToolDefinition as at, updateModelProviderConnection as au, updateWorkflowSettings as av, DatasourceFormModal as b, type DatasourceFormModalProps as c, DatasourceModal as d, type DatasourceModalProps as e, findCategory as f, findDialect as g, type AiGenerateResponse as h, type AiValidateResponse as i, type ApprovalDecision as j, type ApprovalResponse as k, type ModelFamilyCatalogEntry as l, type ModelProviderCatalogEntry as m, type NodeValidationIssue as n, type PresignedUpload as o, type PublicSampleWorkflow as p, type RunEvent as q, type RunSubscriptionState as r, type WorkflowTemplateSummary as s, aiGenerateWorkflow as t, aiValidateWorkflow as u, buildAuthenticatedApiUrl as v, cancelWorkflowRun as w, createAgentConfig as x, createAgentPrompt as y, createAgentRule as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datatechsolutions/ui",
-  "version": "2.11.92",
+  "version": "3.1.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -125,6 +125,11 @@
       "import": "./dist/platform/settings/index.mjs",
       "require": "./dist/platform/settings/index.js"
     },
+    "./platform/telemetry": {
+      "types": "./dist/platform/telemetry/index.d.ts",
+      "import": "./dist/platform/telemetry/index.mjs",
+      "require": "./dist/platform/telemetry/index.js"
+    },
     "./styles": "./src/styles/liquid-glass.css",
     "./styles/*": "./src/styles/*"
   },
@@ -149,6 +154,7 @@
     "@radix-ui/react-progress": "^1.1.8",
     "@radix-ui/react-tabs": "^1.1.13",
     "next-intl": "4.8.3",
+    "posthog-js": "^1.207.0",
     "typescript": "^5.3.0"
   },
   "peerDependencies": {