@burdenoff/fluidgrids-fe-sdk 2026.1105.4 → 2026.1107.1

package/dist/workflow-builder-C-ekFbwR.d.ts

@@ -1,1210 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ApolloClient } from '@apollo/client/core';
-import { ReactNode } from 'react';
-import { Edge, Node, NodeChange, EdgeChange, Connection } from '@xyflow/react';
-import * as zustand from 'zustand';
-
-/** Version of the host event contract. See the module note for the rules. */
-declare const FLUIDGRIDS_EVENTS_VERSION = "1.0.0";
-/** Where an `error` event came from. */
-type FluidGridsErrorSource = "workflow:save" | "workflow:activate" | "run:start";
-/**
- * Every host event and its payload.
- *
- * - `workflow:saved` — a save reached `wspace-workflow-svc` (create, update or
- *   new version). `id` is the saved definition's database id.
- * - `workflow:activated` — a version was activated (published).
- * - `run:started` — the backend accepted a run: builder test runs, run from a
- *   node, a followed webhook test event, triggers, replays and retries.
- *   `mode` is the run mode when the SDK knows it (`TEST`, `PRODUCTION`, …).
- * - `run:completed` — a run the builder is following reached a terminal
- *   status (`COMPLETED`, `FAILED`, `CANCELLED`, `TERMINATED`). Emitted once
- *   per run id.
- * - `node:selected` — the selection on the builder canvas changed to exactly
- *   one node. `nodeId: null` means the selection was cleared. Selecting
- *   several nodes at once emits nothing. Emitted by the full builder and by
- *   the standalone `WorkflowBuilder` / `WorkflowBuilderCore` canvas.
- * - `error` — a save, an activation or a run start failed. `message` is the
- *   user-presentable message; `code` is the gateway error code when present.
- * - `auth:failed` — the SDK could not get a fresh token after an expired-token
- *   response (the `auth.onTokenExpired` callback rejected or returned no
- *   token). Emitted once per failed refresh attempt: requests that were
- *   already in flight when it failed surface their original error without a
- *   second callback call or event. The failed request surfaces its original
- *   error.
- *
- * Standalone builder: `WorkflowBuilder` / `WorkflowBuilderCore` (the
- * lightweight local canvas) only hand the workflow to `onSave` and a
- * client-generated id to `onExecute`; they never call the backend. A save
- * there is not persisted by the SDK and no run exists yet, so they emit only
- * `node:selected` — never `workflow:saved`, `run:started` or `error`. The full
- * builder (`FluidGridsRoot`, `WorkflowBuilderPage`) emits every event above.
- */
-interface FluidGridsEventMap {
-    "workflow:saved": {
-        workflowKey: string;
-        version?: string;
-        id?: string;
-    };
-    "workflow:activated": {
-        workflowKey: string;
-        version?: string;
-    };
-    "run:started": {
-        runId: string;
-        workflowKey?: string;
-        mode?: string;
-    };
-    "run:completed": {
-        runId: string;
-        status: string;
-        workflowKey?: string;
-    };
-    "node:selected": {
-        nodeId: string | null;
-        nodeType?: string;
-    };
-    error: {
-        source: FluidGridsErrorSource;
-        message: string;
-        code?: string;
-    };
-    "auth:failed": {
-        message: string;
-    };
-}
-/** Name of a host event. */
-type FluidGridsEventName = keyof FluidGridsEventMap;
-/** Payload of the host event `K`. */
-type FluidGridsEventPayload<K extends FluidGridsEventName> = FluidGridsEventMap[K];
-/** Every host event name, in documentation order. */
-declare const FLUIDGRIDS_EVENT_NAMES: readonly FluidGridsEventName[];
-/** `[name, payload]` pairs, one per event: lets `name` narrow `payload`. */
-type FluidGridsEventArgs = {
-    [K in FluidGridsEventName]: [name: K, payload: FluidGridsEventMap[K]];
-}[FluidGridsEventName];
-/**
- * Host event callback. Checking `name` narrows `payload`:
- *
- * ```ts
- * const onEvent: FluidGridsEventHandler = (name, payload) => {
- *   if (name === "run:completed") console.log(payload.runId, payload.status);
- * };
- * ```
- */
-type FluidGridsEventHandler = (...args: FluidGridsEventArgs) => void;
-
-/**
- * Embed theming (BOFF-9961).
- *
- * A host themes the embedded SDK with a {@link FluidGridsTheme}: either the
- * `"light"` / `"dark"` shortcut, or an object that picks a mode and overrides
- * individual design tokens (colours, radii, fonts). Each token key maps to one
- * or more fe-libs semantic CSS variables ({@link FLUIDGRIDS_THEME_TOKEN_MAP}),
- * so the whole builder, its dialogs and its popovers pick the values up.
- *
- * The theme is DOCUMENT-WIDE. The SDK renders into the host's document and
- * Radix portals render under `body`, and the fe-libs alias tokens
- * (`--color-primary`, `--color-background`, …) are declared on `:root` as
- * references to the semantic tokens, so an override on a wrapper element would
- * not reach them. The variables are therefore written as inline custom
- * properties on `document.documentElement`, and the previous inline values
- * are restored when the theme is removed. A host that wants its own chrome to
- * keep a different look should scope its own styles, not the SDK's.
- *
- * @module theme/fluidgridsTheme
- */
-/** Colour mode of the SDK UI. */
-type FluidGridsThemeMode = "light" | "dark";
-/** Colour overrides. Each value is a CSS colour such as `#2563eb` or `oklch(62% 0.2 250)`. */
-interface FluidGridsThemeColors {
-    /** Page / canvas background. */
-    bgCanvas?: string;
-    /** Cards, panels and the canvas frame. */
-    bgSurface?: string;
-    /** Dialogs, popovers and menus. */
-    bgElevated?: string;
-    /** Inset areas: inputs, code blocks, wells. */
-    bgSunken?: string;
-    /** Main text. */
-    textPrimary?: string;
-    /** Secondary text. */
-    textSecondary?: string;
-    /** Hints, captions and placeholders. */
-    textMuted?: string;
-    /** Default borders. */
-    borderDefault?: string;
-    /** Hairlines and dividers. */
-    borderSubtle?: string;
-    /** Emphasised borders. */
-    borderStrong?: string;
-    /** Brand / primary action colour (buttons, focus, selection). */
-    primary?: string;
-    /** Primary action hover. Derived from `primary` when omitted. */
-    primaryHover?: string;
-    /** Primary action pressed. Derived from `primary` when omitted. */
-    primaryActive?: string;
-    /** Text on the primary colour. Picked for contrast when omitted. */
-    primaryText?: string;
-    /** Success status colour. */
-    success?: string;
-    /** Warning status colour. */
-    warning?: string;
-    /** Error status colour. */
-    error?: string;
-    /** Info status colour. */
-    info?: string;
-}
-/** Corner-radius overrides. Each value is a CSS length (`8px`, `0.5rem`). */
-interface FluidGridsThemeRadius {
-    /** Base radius most components scale from. */
-    base?: string;
-    /** Cards and panels. */
-    card?: string;
-    /** Buttons. */
-    button?: string;
-    /** Inputs and selects. */
-    input?: string;
-}
-/** Font overrides. Each value is a CSS `font-family` list. */
-interface FluidGridsThemeFont {
-    /** Body text. */
-    body?: string;
-    /** Headings. */
-    heading?: string;
-    /** Code, ids and JSON. */
-    mono?: string;
-}
-/** Full theme object. Every field is optional. */
-interface FluidGridsThemeTokens {
-    /** Force light or dark. Omit to keep the host's / visitor's mode. */
-    mode?: FluidGridsThemeMode;
-    colors?: FluidGridsThemeColors;
-    radius?: FluidGridsThemeRadius;
-    font?: FluidGridsThemeFont;
-}
-/**
- * Theme for the embedded SDK: `"light"` / `"dark"` (shortcut for
- * `{ mode }`), or a token object.
- */
-type FluidGridsTheme = FluidGridsThemeMode | FluidGridsThemeTokens;
-/** Kind of value a token accepts; decides how the value is validated. */
-type FluidGridsThemeValueKind = "color" | "length" | "font";
-/** One row of {@link FLUIDGRIDS_THEME_TOKEN_MAP}. */
-interface FluidGridsThemeTokenMapping {
-    kind: FluidGridsThemeValueKind;
-    /** CSS custom properties the token sets, in order. */
-    cssVariables: readonly string[];
-}
-/** Dotted key of every theme token: `colors.primary`, `radius.card`, … */
-type FluidGridsThemeTokenKey = `colors.${keyof FluidGridsThemeColors & string}` | `radius.${keyof FluidGridsThemeRadius & string}` | `font.${keyof FluidGridsThemeFont & string}`;
-/**
- * Theme token → the fe-libs semantic CSS variables it sets. This table is the
- * public contract: a token keeps its variables across minor releases.
- */
-declare const FLUIDGRIDS_THEME_TOKEN_MAP: Readonly<Record<FluidGridsThemeTokenKey, FluidGridsThemeTokenMapping>>;
-/**
- * Turn a theme into the CSS custom properties it sets. Pure: no DOM access.
- *
- * Values that are not plain CSS values of the token's kind (anything with
- * `;`, `{`, `}`, `url(`, `expression(`, quotes other than single-quoted font
- * names, …) are dropped with a console warning. Unknown keys are dropped the
- * same way. When `colors.primary` is set, the hover / pressed shades and the
- * text colour are derived from it unless they are set explicitly; the text
- * colour is picked for contrast when `primary` is a hex colour.
- */
-declare function themeToCssVariables(theme: FluidGridsTheme | null | undefined): Record<string, string>;
-/**
- * Apply a theme to the document and return a function that removes it again.
- *
- * Sets each variable from {@link themeToCssVariables} as an inline custom
- * property on `document.documentElement`, and for a mode sets `data-theme`
- * and the `.dark` class. While applied, the values are re-forced if something
- * else (a host ThemeProvider) rewrites them. Disposing restores the inline
- * values and mode the document had (including any change the host made in
- * between). When several themes are applied, the most recent one wins.
- * Calling the returned function more than once is safe. Without a DOM
- * (server rendering) it does nothing.
- */
-declare function applyFluidGridsTheme(theme: FluidGridsTheme | null | undefined): () => void;
-
-/**
- * Configuration module for FluidGrids SDK
- */
-/** Result passed to the onWorkflowSaved callback after a successful save */
-interface WorkflowSavedResult {
-    /** Database row ID of the saved workflow definition */
-    dbId: string;
-    /** Human-readable workflow key (e.g., "github_user_profile") */
-    workflowKey: string;
-    /** Semantic version string (e.g., "v1", "v2") */
-    version: string;
-    /** Display name of the workflow */
-    name: string;
-    /** Optional description */
-    description?: string;
-    /** What kind of save operation occurred */
-    operation: "created" | "updated" | "versioned";
-}
-/**
- * Tokens returned by {@link FluidGridsAuthConfig.onTokenExpired}. Return only
- * the ones that changed; a missing field keeps its current value.
- */
-interface FluidGridsRefreshedTokens {
-    /** New user / app token, sent as `authorization: Bearer …`. */
-    authToken?: string;
-    /** New workspace token, sent as `x-workspace-authorization: Bearer …`. */
-    workspaceToken?: string;
-}
-/** Authentication hooks for embedders. */
-interface FluidGridsAuthConfig {
-    /**
-     * Called when a request fails because the session expired (HTTP 401, a
-     * GraphQL `UNAUTHENTICATED` error, or an expired / revoked credential
-     * reported by the gateway). Resolve with a fresh token — a string is the
-     * new `authToken`, an object can also replace the `workspaceToken`. The SDK
-     * stores it in the config, retries the failed request once, and shares one
-     * call between requests that fail at the same time.
-     *
-     * Reject, or resolve with an empty token, when no fresh token is available:
-     * the SDK then emits `auth:failed` on `onEvent` and the request fails with
-     * its original error. The SDK never retries a request twice.
-     */
-    onTokenExpired?: () => Promise<string | FluidGridsRefreshedTokens>;
-}
-interface FluidGridsConfig {
-    /** GraphQL endpoint URL (workspace gateway) */
-    apiGatewayUrl: string;
-    /** GraphQL endpoint URL (global gateway) */
-    globalApiUrl?: string;
-    /** Auth token for API calls */
-    authToken?: string;
-    /** Current workspace ID */
-    workspaceId: string;
-    /**
-     * Workspace access token of the current workspace. Store queries send it as
-     * `x-workspace-authorization` so the global gateway can derive a verified
-     * workspace for them: the public gateway never trusts a client-sent
-     * `x-workspace-id`, and the store lists the durable-function nodes only to a
-     * workspace with durable functions on (BOFF-9905).
-     */
-    workspaceToken?: string;
-    /** Current tenant ID */
-    tenantId?: string;
-    /** Organization ID */
-    organizationId?: string;
-    /**
-     * @deprecated Never read. Share/Embed links used to be built from this
-     * value, which no host ever set, so they shipped as `undefined/...`
-     * (BOFF-7753). Kept only so existing host configs still type-check.
-     */
-    fluidgridFrontendUrl?: string;
-    /** Product ID for workflow isolation (e.g., 'bigconsole', 'botmanor', 'fluidgrids') */
-    productId?: string;
-    /** Product name for display purposes */
-    productName?: string;
-    /** Optional allowlist for host origins embedding the SDK */
-    trustedOrigins?: string[];
-    /**
-     * Callback invoked after a workflow is successfully saved to wspace-workflow-svc.
-     * Host apps (BigConsole, BotManor) can use this to sync metadata to their own backends.
-     * Errors thrown by this callback are caught and logged — they never block the save.
-     */
-    onWorkflowSaved?: (result: WorkflowSavedResult) => void | Promise<void>;
-    /**
-     * Theme for the embedded UI: `"light"`, `"dark"`, or a token object.
-     * Setting it (here, or with the `theme` prop of `FluidGridsProvider`)
-     * applies it document-wide right away — see `applyFluidGridsTheme`;
-     * setting `undefined` or resetting the config removes it.
-     */
-    theme?: FluidGridsTheme;
-    /** Authentication hooks: token refresh on expiry. */
-    auth?: FluidGridsAuthConfig;
-    /**
-     * Host event callback: workflow saved / activated, run started / completed,
-     * node selected, errors and auth failures. See `FluidGridsEventMap`.
-     * Exceptions thrown by the handler are caught and logged.
-     */
-    onEvent?: FluidGridsEventHandler;
-}
-/**
- * Get current configuration via proxy for live access
- */
-declare const config: FluidGridsConfig;
-/**
- * Get the full configuration object
- */
-declare function getFluidGridsConfig(): FluidGridsConfig;
-/**
- * Set runtime configuration
- */
-declare function setFluidGridsConfig(newConfig: Partial<FluidGridsConfig>): void;
-/**
- * Reset configuration to defaults
- */
-declare function resetFluidGridsConfig(): void;
-/**
- * Get the GraphQL endpoint URL
- */
-declare function getGraphQLEndpoint(baseUrl?: string): string;
-/** Clear user execution state only when a host session ends or changes identity. */
-declare function resetFluidGridsExecutionState(): void;
-
-interface FluidGridsProviderProps {
-    /** API Gateway URL (workspace gateway) */
-    apiGatewayUrl?: string;
-    /** Global API Gateway URL (for store operations) */
-    globalApiUrl?: string;
-    /** Auth token */
-    authToken?: string;
-    /** Workspace token for x-workspace-authorization header */
-    workspaceToken?: string;
-    /** Workspace ID */
-    workspaceId: string;
-    /** Owning product namespace. */
-    productId?: string;
-    /** Authenticated actor identity; supply this when accounts can switch in-place. */
-    userId?: string;
-    /** Optional host allowlist for embedded deployments */
-    trustedOrigins?: string[];
-    /** Tenant ID */
-    tenantId?: string;
-    /** Organization ID */
-    organizationId?: string;
-    /** Optional: provide your own workspace Apollo client */
-    workspaceClient?: ApolloClient;
-    /** Optional: provide your own global Apollo client */
-    globalClient?: ApolloClient;
-    /** @deprecated Use workspaceClient instead */
-    apolloClient?: ApolloClient;
-    /**
-     * Optional host translator: `(key, englishFallback) => string`.
-     *
-     * When omitted (standalone embedders), every string renders its English
-     * fallback — the SDK never requires an i18n provider to be mounted.
-     */
-    t?: (key: string, fallback: string) => string;
-    /**
-     * Theme: `"light"`, `"dark"`, or a token object (colours, radii, fonts).
-     * Applied document-wide while the provider is mounted and restored on
-     * unmount. See `FluidGridsTheme` and `FLUIDGRIDS_THEME_TOKEN_MAP`.
-     */
-    theme?: FluidGridsTheme;
-    /**
-     * Authentication hooks. `auth.onTokenExpired` is called when a request
-     * fails with an expired session; resolve with a fresh token and the SDK
-     * retries the request once.
-     */
-    auth?: FluidGridsAuthConfig;
-    /** Host event callback. See `FluidGridsEventMap`. */
-    onEvent?: FluidGridsEventHandler;
-    /** Children */
-    children: ReactNode;
-}
-interface FluidGridsContextValue {
-    apiGatewayUrl?: string;
-    globalApiUrl?: string;
-    authToken?: string;
-    workspaceId: string;
-    productId?: string;
-    userId?: string;
-    trustedOrigins?: string[];
-    tenantId?: string;
-    organizationId?: string;
-    workspaceClient?: ApolloClient;
-    globalClient?: ApolloClient;
-    /** Host translator, consumed by `useTr()`. */
-    t?: (key: string, fallback: string) => string;
-}
-declare function FluidGridsProvider({ apiGatewayUrl, globalApiUrl, authToken, workspaceToken, workspaceId, productId, userId, trustedOrigins, tenantId, organizationId, t, theme, auth, onEvent, workspaceClient: externalWorkspaceClient, globalClient: externalGlobalClient, apolloClient: legacyClient, children, }: FluidGridsProviderProps): react_jsx_runtime.JSX.Element;
-declare function useFluidGridsContext(): FluidGridsContextValue;
-
-type ExtendedNodeType = "trigger:api" | "end" | "internal:if" | "internal:switch" | "internal:loop" | "internal:merge" | "internal:set" | "internal:filter" | "internal:aggregate" | "internal:wait" | "internal:noop" | "internal:subworkflow" | string;
-interface FlowNodeData {
-    label: string;
-    deletable?: boolean;
-    nodeType?: string;
-    config?: Record<string, unknown>;
-    /** When true, the node is dimmed on the canvas and the worker executor
-     *  skips it entirely at runtime — its input passes through unchanged as
-     *  its output, and its edges stay intact (BOFF-7510). */
-    disabled?: boolean;
-    /**
-     * Node-level retry/timeout/error-branch settings (BOFF-7512). Read by the
-     * deployed worker executor as the second precedence slot
-     * (`node.errorConfig ?? node.data.errorConfig ?? node.data.args.state.errorConfig`)
-     * — the frontend deliberately writes here rather than fighting `Node<T>`
-     * typing for the node's own top-level field; `use-save-workflow.ts`
-     * flattens `data.*` onto the saved node's root too, so this still reaches
-     * the primary slot once persisted.
-     */
-    errorConfig?: INodeErrorConfig;
-    /** Free-text note a builder leaves on a node (BOFF-7512). */
-    notes?: string;
-    /**
-     * `alwaysOutputData` / `executeOnce` (BOFF-7512) — NOT part of
-     * `INodeErrorConfig`; the deployed executor does not enforce these yet,
-     * only `errorConfig` is engine-enforced right now. Wired for persistence
-     * ahead of that.
-     */
-    executionSettings?: INodeExecutionSettings;
-    [key: string]: unknown;
-}
-interface FlowNode extends Node {
-    type: ExtendedNodeType;
-    data: FlowNodeData;
-    deletable?: boolean;
-}
-interface FlowEdge extends Edge {
-    type?: "deletable" | "smoothstep" | "default" | string;
-    condition?: EdgeCondition;
-    mapping?: EdgeMapping;
-}
-interface EdgeCondition {
-    rules: ConditionRule[];
-    logic: "and" | "or";
-}
-interface ConditionRule {
-    field: string;
-    operator: string;
-    value: string;
-}
-type MappingValue = string | number | boolean | null | MappingValue[] | {
-    [key: string]: MappingValue;
-};
-interface EdgeMapping {
-    definition: Record<string, MappingValue>;
-    comment?: string;
-}
-interface NodeAdapterManifest {
-    name: string;
-    required?: boolean;
-    type?: string;
-    maxConnections?: number | null;
-    filter?: {
-        kind?: string[];
-        excludeNodes?: string[];
-    };
-}
-interface NodeManifest {
-    nodeType: string;
-    name: string;
-    description?: string;
-    kind?: string[];
-    version: string;
-    operations?: {
-        operations?: unknown[];
-    };
-    icon?: string;
-    category?: string;
-    /** Adapter ports for this node (e.g., Chat Model, Memory, Tool slots on AI Agent) */
-    nodeAdapters?: NodeAdapterManifest[];
-    /** When true, this node can connect to adapter ports on other nodes */
-    supportsAdapterMode?: boolean;
-    /** The adapter type this node satisfies when used as a sub-node */
-    adapterOutputType?: string;
-    /**
-     * Optional external documentation URL for this node (BOFF-7512). Not all
-     * nodes declare one — render nothing when absent, never require it.
-     */
-    docsUrl?: string;
-}
-interface NodeEndpointConfig {
-    id: string;
-    nodeType: string;
-    name: string;
-    description?: string;
-    icon?: string;
-    category?: string;
-    manifest?: NodeManifest;
-}
-
-/**
- * Node-level error/retry/timeout handling configuration.
- *
- * Mirrors `INodeErrorConfig` in `fluidgrids-workers/src/types/workflow.types.ts`
- * and `wspace-workflow-svc/src/modules/main/types/workflow.types.ts` — the
- * DEPLOYED worker executor reads this shape directly off a node's top-level
- * `errorConfig` field (BOFF-7512).
- */
-interface INodeRetryConfig {
-    /** Maximum number of retry attempts (default: 0 = no retry). */
-    maxRetries: number;
-    /** Initial delay between retries in ms (default: 1000). */
-    retryDelay: number;
-    /** Backoff multiplier for exponential backoff (default: 2). */
-    backoffMultiplier?: number;
-    /** Maximum delay between retries in ms (default: 30000). */
-    maxDelay?: number;
-    /** Error types that should trigger a retry (empty/unset = all errors, incl. TIMEOUT). */
-    retryOnErrorTypes?: string[];
-}
-interface INodeTimeoutConfig {
-    /** Execution timeout in ms. */
-    duration: number;
-    /** What to do when the node times out (default: falls through to onError/retryConfig). */
-    onTimeout?: "stop" | "continue" | "branch";
-    /** Target node ID when onTimeout is 'branch'. */
-    timeoutBranchId?: string;
-}
-interface INodeErrorConfig {
-    /** 'stop' (default) | 'continue' | 'branch'. */
-    onError?: "stop" | "continue" | "branch";
-    /** Target node ID when onError is 'branch'. */
-    errorBranchId?: string;
-    retryConfig?: INodeRetryConfig;
-    timeout?: INodeTimeoutConfig;
-}
-/**
- * `alwaysOutputData` / `executeOnce` node settings (BOFF-7512). A NEW
- * sibling object next to `errorConfig` on `FlowNodeData` — NOT part of
- * `INodeErrorConfig`. The deployed worker executor does not enforce either
- * flag yet; only `errorConfig` is engine-enforced right now.
- */
-interface INodeExecutionSettings {
-    alwaysOutputData?: boolean;
-    executeOnce?: boolean;
-    /**
-     * Where the node runs. Absent = FluidGrids Cloud. A runner = the customer's
-     * self-hosted runner (fluidgrids-workers reads exactly this shape).
-     */
-    runOn?: {
-        kind: "runner";
-        runnerId: string;
-    };
-}
-/** Which finished runs of a workflow keep their data (BOFF-7514). */
-interface WorkflowDataSaving {
-    saveSuccessExecutions?: boolean;
-    saveFailedExecutions?: boolean;
-    saveManualExecutions?: boolean;
-}
-/**
- * What a workflow's runs may store (BOFF-9752). Enforced by wspace-workflow-svc
- * (`run-data-privacy.ts`); there is no workspace-level default.
- */
-interface WorkflowDataPrivacy {
-    /**
-     * Keep only the run summary (status, timings, node statuses, error types): trigger data and
-     * node inputs/outputs are dropped when the run finishes, log lines keep their message only.
-     */
-    doNotStoreRunData?: boolean;
-    /**
-     * Field names (matched at any depth) or dotted paths (matched from the top, `*` for any key,
-     * a number for an array item) replaced with [REDACTED] in run logs and stored run data.
-     */
-    redactFields?: string[];
-}
-/** How long a workflow's finished runs are kept (BOFF-7514). */
-interface WorkflowRetention {
-    /** Delete finished runs older than this many days. */
-    maxAgeDays?: number;
-    /** Keep at most this many finished runs. */
-    maxRuns?: number;
-}
-/**
- * Workflow-level execution configuration (BOFF-7512): a workflow's `definitionJson.config`.
- *
- * Mirrors `IWorkflowConfig` in `wspace-workflow-svc/src/modules/main/types/workflow.types.ts`
- * (`timeout` in SECONDS). The per-workflow Settings page edits this same type.
- */
-interface IWorkflowConfig {
-    /** Max parallel executions. */
-    maxParallelism?: number;
-    /** Execution timeout in SECONDS (matches the backend interface's unit). */
-    timeout?: number;
-    retry?: {
-        maxAttempts: number;
-        backoffMultiplier?: number;
-        initialDelay?: number;
-    };
-    onError?: "stop" | "continue" | "retry";
-    /** workflowKey to start (at its Error Trigger) when a production run of this workflow fails. */
-    errorWorkflowKey?: string;
-    /** Overrides the workspace's run-data settings; an unset field follows the workspace (BOFF-7514). */
-    dataSaving?: WorkflowDataSaving;
-    /** Overrides the workspace's retention; an unset field follows the workspace (BOFF-7514). */
-    retention?: WorkflowRetention;
-    /** "Do not store run data" and redacted fields (BOFF-9752). */
-    dataPrivacy?: WorkflowDataPrivacy;
-}
-interface WorkflowDefinition {
-    id: string;
-    workflowKey: string;
-    version: string;
-    name: string;
-    description?: string;
-    alias?: string;
-    status?: "draft" | "active" | "archived";
-    definitionJson?: WorkflowDefinitionJson;
-    createdAt?: string;
-    updatedAt?: string;
-    createdBy?: string;
-    /**
-     * Optimistic-concurrency counter (BOFF-9725): saves send it back so a change
-     * made elsewhere since the version was loaded is refused, not overwritten.
-     */
-    revision?: number;
-    /** Who last changed this version, when known. */
-    updatedById?: string | null;
-}
-interface WorkflowDefinitionJson {
-    key: string;
-    name: string;
-    description?: string;
-    workflow_type?: string;
-    data: WorkflowData;
-    meta?: Record<string, unknown>;
-    tags?: string[];
-    /** Workflow-level execution config (BOFF-7512) — sibling of `data`, matching the backend's `IWorkflowDefinitionJson.config`. */
-    config?: IWorkflowConfig;
-}
-interface WorkflowData {
-    id: string;
-    workflowKey: string;
-    name: string;
-    version: string;
-    alias?: string;
-    nodes: FlowNode[];
-    edges: FlowEdge[];
-    sidebar: SidebarState;
-}
-interface SidebarState {
-    active: "node-properties" | "store-browse" | "none";
-    panels: {
-        nodeProperties: {
-            selectedNode: {
-                id: string;
-                type: string;
-            } | null;
-        };
-    };
-}
-interface Tag {
-    value: string;
-    label: string;
-    color: string;
-}
-
-type RunStatus = "pending" | "running" | "completed" | "failed" | "cancelled" | "timeout";
-type NodeStatus = "idle" | "pending" | "running" | "success" | "error" | "skipped";
-type ErrorType = "validation" | "execution" | "timeout" | "cancelled" | "unknown";
-interface WorkflowRun {
-    id: string;
-    workflowKey: string;
-    workflowVersion: string;
-    workflowName?: string;
-    status: RunStatus;
-    startedAt: string;
-    completedAt?: string;
-    duration?: number;
-    triggeredBy?: string;
-    triggerType?: string;
-    error?: WorkflowError;
-    nodeStates?: NodeState[];
-    inputData?: Record<string, unknown>;
-    outputData?: Record<string, unknown>;
-    parentRunId?: string;
-    isSubWorkflowRun?: boolean;
-    subworkflowDepth?: number;
-    rootRunId?: string;
-    childRuns?: WorkflowRun[];
-}
-interface NodeState {
-    id: string;
-    nodeId: string;
-    nodeType: string;
-    nodeName?: string;
-    status: NodeStatus;
-    startedAt?: string;
-    completedAt?: string;
-    duration?: number;
-    inputData?: Record<string, unknown>;
-    outputData?: Record<string, unknown>;
-    error?: string;
-    itemCount?: number;
-    childRunId?: string;
-}
-interface WorkflowError {
-    type: ErrorType;
-    message: string;
-    nodeId?: string;
-    stack?: string;
-}
-/**
- * The backend's immutable plan for one `executeStep` TEST run. Keeping it with
- * the execution slice lets the node detail view explain which data was reused
- * rather than inferring it after polling starts.
- */
-interface StepExecutionPlan {
-    runId: string;
-    targetNodeId: string;
-    sourceRunId: string | null;
-    reusedNodeIds: string[];
-    pinnedNodeIds: string[];
-    executeNodeIds: string[];
-    initialNodeIds: string[];
-    blockers: string[];
-}
-/**
- * Workflow identity captured with the run currently loaded in the builder.
- * Continuation must never reuse logs from a different workflow version.
- */
-interface ExecutionRunMetadata {
-    runId: string;
-    workflowKey: string;
-    version: string;
-    /** Source runs used for continuation must be TEST runs. */
-    sourceMode?: "TEST" | "PRODUCTION";
-}
-interface ExecutionLog {
-    id: string;
-    runId: string;
-    nodeId: string;
-    nodeType: string;
-    nodeName: string;
-    status: "pending" | "running" | "completed" | "failed";
-    inputArgs: Record<string, unknown> | null;
-    output: Record<string, unknown> | null;
-    error: string | null;
-    duration: number | null;
-    startTime: string;
-    endTime: string | null;
-    /**
-     * True when this node's output came from pinned data instead of a real
-     * call (BOFF-7511). Always false/undefined outside a TEST run.
-     */
-    usedPinnedData?: boolean;
-    /**
-     * Set when this node's state was reused from an earlier run by
-     * `runFromNode` instead of being executed in this run (BOFF-7511).
-     */
-    reusedFromRunId?: string | null;
-}
-interface ExecutionsFilter {
-    status?: RunStatus[];
-    workflowKey?: string;
-    dateRange?: {
-        start: string;
-        end: string;
-    };
-    triggeredBy?: string;
-}
-interface ExecutionsPagination {
-    page: number;
-    pageSize: number;
-    total: number;
-}
-declare const RUN_STATUS_CONFIG: Record<RunStatus, {
-    label: string;
-    color: string;
-    bgColor: string;
-}>;
-declare const NODE_STATUS_CONFIG: Record<NodeStatus, {
-    label: string;
-    color: string;
-    bgColor: string;
-}>;
-
-interface WorkflowBuilderCoreProps {
-    /** Initial workflow data to render */
-    workflow?: WorkflowData;
-    /** Readonly mode - disables editing */
-    readonly?: boolean;
-    /** Hide the header toolbar */
-    hideHeader?: boolean;
-    /** Hide the sidebar */
-    hideSidebar?: boolean;
-    /** Hide the logs panel */
-    hideLogsPanel?: boolean;
-    /**
-     * Called with the edited workflow when the user clicks Save. This component
-     * does not persist anything itself: storing the workflow is the host's
-     * job, so no `workflow:saved` host event is emitted for it.
-     */
-    onSave?: (workflow: WorkflowData) => void;
-    /**
-     * Called when the user clicks Run, with a client-generated id
-     * (`run-<timestamp>`) the host may use to label the run it starts. No
-     * backend run exists yet, so no `run:started` host event is emitted.
-     */
-    onExecute?: (runId: string) => void;
-    /** Callback when a node is clicked */
-    onNodeClick?: (node: FlowNode) => void;
-    /** Callback when back button is clicked */
-    onBack?: () => void;
-    /** Custom className */
-    className?: string;
-}
-/**
- * Lightweight, local-only workflow canvas.
- *
- * Host events (`FluidGridsEventMap`): reports `node:selected` exactly like the
- * full builder canvas. Save and Run only hand data to `onSave` / `onExecute`
- * and call no backend, so it emits no `workflow:saved`, `run:started` or
- * `error` events: the host performs those actions and already knows their
- * outcome. Works without a host `ThemeProvider`.
- */
-declare function WorkflowBuilderCore(props: WorkflowBuilderCoreProps): react_jsx_runtime.JSX.Element;
-
-interface WorkflowBuilderProps extends Omit<WorkflowBuilderCoreProps, "workflow"> {
-    /** Workflow ID to load */
-    workflowId?: string;
-    /** Workflow version to load */
-    workflowVersion?: string;
-    /** Initial workflow data (bypasses API fetch) */
-    initialWorkflow?: WorkflowData;
-    /** Workspace API Gateway URL */
-    apiGatewayUrl?: string;
-    /** Global API Gateway URL (for store operations) */
-    globalApiUrl?: string;
-    /** Authentication token */
-    authToken?: string;
-    /** Current workspace ID */
-    workspaceId: string;
-    /** Product namespace, actor identity and workspace authentication. */
-    productId?: string;
-    userId?: string;
-    workspaceToken?: string;
-    /** Current tenant ID */
-    tenantId?: string;
-    /** Organization ID */
-    organizationId?: string;
-    /** Optional: Provide your own workspace Apollo client */
-    workspaceClient?: ApolloClient;
-    /** Optional: Provide your own global Apollo client */
-    globalClient?: ApolloClient;
-    /** Theme: `"light"`, `"dark"` or a token object. See `FluidGridsTheme`. */
-    theme?: FluidGridsProviderProps["theme"];
-    /** Authentication hooks (`onTokenExpired`). */
-    auth?: FluidGridsProviderProps["auth"];
-    /** Host event callback. See `FluidGridsEventMap`. */
-    onEvent?: FluidGridsProviderProps["onEvent"];
-}
-/**
- * WorkflowBuilder - Standalone workflow builder component with Apollo client support
- *
- * Use this component when you want to embed the workflow builder in any React app.
- * You can either:
- * 1. Provide pre-configured Apollo clients (workspaceClient + globalClient) - Recommended
- * 2. Provide URLs and let the component create clients internally
- *
- * It needs no host `ThemeProvider` (one is mounted only when the page has
- * none). Host events: `onEvent` receives `node:selected`; Save and Run are
- * local (they call `onSave` / `onExecute` and no backend), so they emit no
- * `workflow:saved` / `run:started`. See `WorkflowBuilderCore`.
- *
- * @example Dual Client Injection (Recommended)
- * ```tsx
- * import { createFluidGridsClients } from '@fluidgrids/fe-sdk';
- *
- * const { workspaceClient, globalClient } = createFluidGridsClients({
- *   workspaceApiUrl: 'http://localhost:4000/workspaces/graphql',
- *   globalApiUrl: 'http://localhost:4000/global/graphql',
- *   authToken: token,
- *   workspaceId: 'ws-123',
- * });
- *
- * <WorkflowBuilder
- *   workspaceClient={workspaceClient}
- *   globalClient={globalClient}
- *   workspaceId="ws-123"
- *   onSave={(workflow) => console.log(workflow)}
- * />
- * ```
- *
- * @example URL-based (Simpler, less flexible)
- * ```tsx
- * <WorkflowBuilder
- *   apiGatewayUrl="http://localhost:4000/workspaces/graphql"
- *   globalApiUrl="http://localhost:4000/global/graphql"
- *   authToken={token}
- *   workspaceId="ws-123"
- *   onSave={(workflow) => console.log(workflow)}
- * />
- * ```
- */
-declare function WorkflowBuilder$1({ workflowId, workflowVersion, initialWorkflow, apiGatewayUrl, globalApiUrl, authToken, workspaceId, tenantId, productId, userId, workspaceToken, organizationId, workspaceClient, globalClient, theme, auth, onEvent, ...coreProps }: WorkflowBuilderProps): react_jsx_runtime.JSX.Element;
-
-/**
- * WorkflowBuilder page with ErrorBoundary for graceful crash recovery.
- * If the builder throws (React Flow error, node rendering crash, etc.),
- * the user sees a recovery UI instead of a blank screen.
- */
-declare function WorkflowBuilder(): react_jsx_runtime.JSX.Element;
-
-/**
- * Global search indexes WorkflowDefinition by its database id, but the
- * builder route (`workflow/:workflowKey/:version`) is keyed by workflowKey +
- * version. This page bridges the two: it resolves the id to its current
- * workflowKey/version and redirects there.
- */
-declare function WorkflowSearchRedirect(): react_jsx_runtime.JSX.Element;
-
-interface ExecutionState {
-    isExecuting: boolean;
-    executingNodeId: string | null;
-    currentRunId: string | null;
-    /** Identity of the run whose logs are currently loaded/reusable. */
-    sourceRun: ExecutionRunMetadata | null;
-    stepPlan: StepExecutionPlan | null;
-    logs: ExecutionLog[];
-    selectedLogId: string | null;
-    panelExpanded: boolean;
-    nodeStatuses: Record<string, "idle" | "running" | "success" | "error">;
-    nodeItemCounts: Record<string, number>;
-    /**
-     * A run the editor did not start itself (a webhook test event, BOFF-7513)
-     * waiting to be followed on the canvas. Consumed by `WebhookRunFollower`,
-     * which outlives the panel that requested it.
-     */
-    followRequest: {
-        runId: string;
-        triggerNodeId: string;
-    } | null;
-}
-interface CustomEdgeProps extends Edge {
-    condition?: EdgeCondition;
-    mapping?: EdgeMapping;
-}
-/** A point-in-time snapshot of canvas structure for undo/redo. */
-interface HistorySnapshot {
-    nodes: Node[];
-    edges: CustomEdgeProps[];
-}
-/** Undo/redo stacks for the currently open workflow. */
-interface HistoryState {
-    past: HistorySnapshot[];
-    future: HistorySnapshot[];
-}
-interface State {
-    nodes: Node[];
-    edges: CustomEdgeProps[];
-    /** Node currently open in the n8n-style 3-pane Node Detail View modal. */
-    ndv?: {
-        nodeId: string;
-        type: ExtendedNodeType;
-        /** The tab to show first; the code-workflow node's Source tab, say. */
-        tab?: "source";
-    } | null;
-    /** Node currently in inline-rename edit mode (F2 or double-click on its
-     *  title). Only one node can be renamed at a time. */
-    renamingNodeId?: string | null;
-    /**
-     * Node currently open in the single-click floating quick-config panel
-     * (Make-style, attached beside the node). The panel derives its own screen
-     * position from the node's live rect, so no anchor is stored here.
-     */
-    quickConfig?: {
-        nodeId: string;
-        type: ExtendedNodeType;
-    } | null;
-    /**
-     * Source handle awaiting attachment via the Node Store (the n8n-style "+"
-     * button on an output handle). While set, clicking an operation in the
-     * store panel creates the node and wires it to this handle.
-     */
-    pendingConnection?: {
-        nodeId: string;
-        handleId: string;
-    } | null;
-    sidebar: {
-        active: "node-properties" | "store-browse" | "none";
-        panels: {
-            nodeProperties: {
-                selectedNode: {
-                    id: string;
-                    type: ExtendedNodeType;
-                } | null | undefined;
-            };
-        };
-    };
-}
-interface Actions {
-    actions: {
-        saveWorkflow: () => {
-            id: string;
-            name: string;
-            version: string;
-            alias?: string;
-            dbId?: string;
-            status?: string;
-            nodes: Node[];
-            edges: Edge[];
-        };
-        setWorkflow: (workflow: Partial<IFlowState["workflow"]>) => void;
-        resetWorkflow: () => void;
-        history: {
-            undo: () => void;
-            redo: () => void;
-            /** Wipe both stacks — called when a (different) workflow is loaded so
-             *  undo can never reach back into a previously open workflow. */
-            clear: () => void;
-        };
-        nodes: {
-            onNodesChange: (changes: NodeChange[]) => void;
-            /** `historyKind` groups rapid same-kind writes (e.g. keystrokes in one
-             *  field) into a single undo step; `skipHistory` opts a caller out of
-             *  history entirely (e.g. transient UI-only patches). */
-            setNodes: (nodes: Node[], opts?: {
-                historyKind?: string;
-                skipHistory?: boolean;
-            }) => void;
-            deleteNode: (node: Node) => void;
-            /** Bulk delete (multi-select) — one undo step for the whole selection. */
-            deleteNodes: (nodes: Node[]) => void;
-            /** Clone the given nodes (+ edges strictly between them) with fresh ids,
-             *  offset on the canvas, and select only the clones. */
-            duplicateNodes: (nodeIds: string[]) => void;
-            /** Insert a clipboard payload (possibly from another workflow/tab):
-             *  fresh ids, offset, selects the pasted nodes. */
-            pasteNodes: (payload: {
-                nodes: Node[];
-                edges: Edge[];
-            }) => void;
-            toggleDisabled: (nodeId: string) => boolean;
-            renameNode: (nodeId: string, label: string) => void;
-            startRename: (nodeId: string) => void;
-            endRename: () => void;
-        };
-        edges: {
-            onEdgesChange: (changes: EdgeChange[]) => void;
-            onConnect: (connection: Connection) => void;
-            setEdges: (edges: Edge[], opts?: {
-                historyKind?: string;
-                skipHistory?: boolean;
-            }) => void;
-            deleteEdge: (edge: Edge) => void;
-        };
-        ndv: {
-            open: (node: {
-                nodeId: string;
-                type: ExtendedNodeType;
-                tab?: "source";
-            }) => void;
-            close: () => void;
-        };
-        quickConfig: {
-            open: (node: {
-                nodeId: string;
-                type: ExtendedNodeType;
-            }) => void;
-            close: () => void;
-        };
-        pendingConnection: {
-            /** Arm attach mode for a source handle and open the Node Store panel. */
-            start: (connection: {
-                nodeId: string;
-                handleId: string;
-            }) => void;
-            clear: () => void;
-        };
-        sidebar: {
-            setActivePanel: (panel: "node-properties" | "store-browse" | "none") => void;
-            showNodePropertiesOf: (node: {
-                id: string;
-                type: ExtendedNodeType;
-                block?: string;
-            }) => void;
-            panels: {
-                nodeProperties: {
-                    setSelectedNode: (node: {
-                        id: string;
-                        type: ExtendedNodeType;
-                    } | undefined | null) => void;
-                };
-                tags: {
-                    setTags: (tags: Tag[]) => void;
-                    createTag: (tag: Tag) => void;
-                    deleteTag: (tag: Tag) => void;
-                    updateTag: (tag: Tag, newTag: Tag) => void;
-                };
-            };
-        };
-    };
-}
-interface IFlowState {
-    tags: Tag[];
-    /** Undo/redo stacks — canvas structure (nodes/edges) AND parameter edits,
-     *  since both flow through the same `setNodes`/`setEdges` writes. */
-    history: HistoryState;
-    /**
-     * Bumped by every user edit (each undo checkpoint, undo, redo, rename or
-     * alias change). Autosave (BOFF-9724) reads it to tell an edit from the
-     * canvas settling right after a load.
-     */
-    editRevision: number;
-    /**
-     * Bumped by `resetWorkflow`, i.e. whenever another workflow (or version) is
-     * about to load. A save or baseline taken under an older generation belongs
-     * to a workflow that is no longer open.
-     */
-    loadGeneration: number;
-    workflow: {
-        id: string;
-        workflowKey: string;
-        name: string;
-        version: string;
-        alias?: string;
-        /** Database row ID (used for updateWorkflowDefinition) */
-        dbId?: string;
-        /** Current workflow status: DRAFT | ACTIVE | ARCHIVED | DEPRECATED */
-        status?: string;
-        /**
-         * The build this version runs (`definitionJson.code.buildId`), when it
-         * runs code. Such a version is immutable: saving keeps the edits as a new
-         * version (spec code-first 06 §1).
-         */
-        codeBuildId?: string;
-        /**
-         * Pinned/mock output data, keyed by nodeId (BOFF-7511). Mirrors
-         * `WorkflowDefinition.pinnedNodeData` — hydrated on load, kept in sync by
-         * the NDV's pin/unpin actions so the canvas never shows a stale pin
-         * badge after a mutation round-trips.
-         */
-        pinnedNodeData?: Record<string, {
-            data: Record<string, unknown>;
-            pinnedAt?: string;
-            pinnedBy?: string;
-        }>;
-    } & State;
-    execution: ExecutionState;
-    actions: Actions["actions"] & {
-        execution: {
-            startExecution: (nodeId: string, runId: string, metadata?: Omit<ExecutionRunMetadata, "runId">) => void;
-            setRunMetadata: (metadata: ExecutionRunMetadata) => void;
-            setStepPlan: (plan: StepExecutionPlan) => void;
-            addLog: (log: ExecutionLog) => void;
-            updateLog: (logId: string, updates: Partial<ExecutionLog>) => void;
-            setNodeStatus: (nodeId: string, status: "idle" | "running" | "success" | "error") => void;
-            setNodeItemCount: (nodeId: string, count: number) => void;
-            selectLog: (logId: string | null) => void;
-            togglePanel: () => void;
-            clearLogs: () => void;
-            completeExecution: () => void;
-            /**
-             * Debug-in-editor (BOFF-7511): load a PAST run's node states onto the
-             * canvas as if they'd just executed, without marking anything as
-             * "running". Each node shows what it actually produced in `runId`, and
-             * `currentRunId` becomes that run's id so "Run from this node" knows
-             * which run to reuse upstream outputs from.
-             */
-            loadDebugRun: (runId: string, logs: ExecutionLog[], metadata?: Omit<ExecutionRunMetadata, "runId">) => void;
-            /** Ask the canvas to follow a run started outside the editor. */
-            requestFollowRun: (runId: string, triggerNodeId: string) => void;
-            clearFollowRequest: () => void;
-        };
-    };
-}
-declare const useFlowStore: zustand.UseBoundStore<zustand.StoreApi<IFlowState>>;
-
-/**
- * Refetch all nodes by re-running initializeNodeConfigs.
- * Called after installing/uninstalling a store node.
- *
- * Resets the initialization guard and all derived arrays so
- * initializeNodeConfigs() runs a fresh fetch instead of returning early.
- */
-declare function refetchStoreNodes(): Promise<void>;
-
-export { type WorkflowError as $, type FluidGridsThemeRadius as A, type FluidGridsThemeTokenKey as B, type ConditionRule as C, type FluidGridsThemeTokenMapping as D, type EdgeCondition as E, FLUIDGRIDS_EVENTS_VERSION as F, type FluidGridsThemeTokens as G, type FluidGridsThemeValueKind as H, type IFlowState as I, type NodeEndpointConfig as J, type NodeManifest as K, type NodeState as L, type MappingValue as M, NODE_STATUS_CONFIG as N, type NodeStatus as O, type RunStatus as P, WorkflowBuilder as Q, RUN_STATUS_CONFIG as R, type SidebarState as S, type Tag as T, WorkflowBuilderCore as U, type WorkflowBuilderCoreProps as V, WorkflowBuilder$1 as W, type WorkflowBuilderProps as X, type WorkflowData as Y, type WorkflowDefinition as Z, type WorkflowDefinitionJson as _, type EdgeMapping as a, type WorkflowRun as a0, type WorkflowSavedResult as a1, WorkflowSearchRedirect as a2, applyFluidGridsTheme as a3, config as a4, getFluidGridsConfig as a5, getGraphQLEndpoint as a6, refetchStoreNodes as a7, resetFluidGridsConfig as a8, resetFluidGridsExecutionState as a9, setFluidGridsConfig as aa, themeToCssVariables as ab, useFlowStore as ac, useFluidGridsContext as ad, type ErrorType as b, type ExecutionLog as c, type ExecutionsFilter as d, type ExecutionsPagination as e, type ExtendedNodeType as f, FLUIDGRIDS_EVENT_NAMES as g, FLUIDGRIDS_THEME_TOKEN_MAP as h, type FlowEdge as i, type FlowNode as j, type FlowNodeData as k, type FluidGridsAuthConfig as l, type FluidGridsConfig as m, type FluidGridsErrorSource as n, type FluidGridsEventArgs as o, type FluidGridsEventHandler as p, type FluidGridsEventMap as q, type FluidGridsEventName as r, type FluidGridsEventPayload as s, FluidGridsProvider as t, type FluidGridsProviderProps as u, type FluidGridsRefreshedTokens as v, type FluidGridsTheme as w, type FluidGridsThemeColors as x, type FluidGridsThemeFont as y, type FluidGridsThemeMode as z };