langflower 0.0.4 → 0.0.6

package/vendor/shared/dist/langflower-config/settings-draft.js

@@ -0,0 +1,143 @@
+/**
+ * Settings form draft helpers — layer config ↔ draft, save payload, equality.
+ * Used by UI and server session draft (protocol snapshots redact apiKey).
+ */
+import { formatDefaultChatModel, parseDefaultChatModel, } from './parse-default-chat-model.js';
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const providerBaseURL = (provider) => {
+    const options = provider['options'];
+    if (!isRecord(options)) {
+        return '';
+    }
+    return typeof options['baseURL'] === 'string' ? options['baseURL'] : '';
+};
+const providerHasApiKey = (provider) => provider['hasApiKey'] === true;
+export const configToDraft = (config) => {
+    const providers = Object.entries(config.provider ?? {}).map(([id, provider]) => ({
+        id,
+        name: provider.name,
+        baseURL: providerBaseURL(provider),
+        modelsText: (provider.models ?? []).join(', '),
+        apiKey: '',
+        hasApiKey: providerHasApiKey(provider),
+    }));
+    const serverLogs = config.serverLogs === true
+        ? 'on'
+        : config.serverLogs === false
+            ? 'off'
+            : 'default';
+    const parts = parseDefaultChatModel(config.model);
+    return {
+        defaultProviderId: parts?.providerId ?? '',
+        defaultModelId: parts?.model ?? '',
+        providers,
+        serverLogs,
+    };
+};
+/** Snapshot-safe draft — never echo secrets. */
+export const redactDraftSecrets = (draft) => ({
+    ...draft,
+    providers: draft.providers.map((row) => ({
+        ...row,
+        apiKey: '',
+    })),
+});
+const parseModelsText = (text) => text
+    .split(',')
+    .map((part) => part.trim())
+    .filter((part) => part.length > 0);
+const serverLogsToSave = (draft) => {
+    if (draft === 'on') {
+        return true;
+    }
+    if (draft === 'off') {
+        return false;
+    }
+    return null;
+};
+export const draftToSavePayload = (scope, draft) => {
+    const providerApiKeys = Object.fromEntries(draft.providers
+        .filter((row) => row.apiKey.trim().length > 0)
+        .map((row) => [row.id.trim(), row.apiKey.trim()]));
+    const provider = Object.fromEntries(draft.providers
+        .filter((row) => row.id.trim().length > 0)
+        .map((row) => {
+        const models = parseModelsText(row.modelsText);
+        const baseURL = row.baseURL.trim();
+        return [
+            row.id.trim(),
+            {
+                name: row.name.trim() || row.id.trim(),
+                ...(models.length > 0 ? { models } : {}),
+                ...(baseURL.length > 0 ? { options: { baseURL } } : {}),
+            },
+        ];
+    }));
+    // Always send `model` so clearing the selects removes it from the layer
+    // (omit would leave the previous disk value — Save looked like a no-op).
+    const model = formatDefaultChatModel(draft.defaultProviderId, draft.defaultModelId) ??
+        '';
+    return {
+        scope,
+        model,
+        provider,
+        providerApiKeys,
+        serverLogs: serverLogsToSave(draft.serverLogs),
+    };
+};
+export const sameDraft = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+/**
+ * Merge an incoming patch draft into the session draft while preserving
+ * write-only apiKey values when the patch sends an empty key field.
+ */
+export const mergeDraftPatch = (previous, patch) => ({
+    ...patch,
+    providers: patch.providers.map((row, index) => {
+        const prior = previous.providers[index];
+        const incomingKey = row.apiKey.trim();
+        if (incomingKey.length > 0) {
+            return row;
+        }
+        return {
+            ...row,
+            apiKey: prior?.apiKey ?? '',
+        };
+    }),
+});
+/**
+ * After a saved-layer baseline refresh:
+ * - pristine form → take the layer draft (apiKey always empty);
+ * - dirty form → clear write-only `apiKey`, refresh `hasApiKey` from the
+ *   layer, then fully align when non-secret fields already match (post-Save).
+ */
+export const draftAfterLayerSnapshot = (previousDraft, previousBaseline, nextBaseline) => {
+    if (sameDraft(previousDraft, previousBaseline)) {
+        return nextBaseline;
+    }
+    const cleared = {
+        ...previousDraft,
+        providers: previousDraft.providers.map((row) => {
+            const fromLayer = nextBaseline.providers.find((provider) => provider.id === row.id);
+            return {
+                ...row,
+                apiKey: '',
+                hasApiKey: fromLayer?.hasApiKey ?? false,
+            };
+        }),
+    };
+    return sameDraft(cleared, nextBaseline) ? nextBaseline : cleared;
+};
+/** Static model ids from the provider row matching `defaultProviderId`. */
+export const defaultProviderStaticModelIds = (draft) => {
+    const providerId = draft.defaultProviderId.trim();
+    if (providerId.length === 0) {
+        return [];
+    }
+    const row = draft.providers.find((provider) => provider.id === providerId);
+    if (row === undefined) {
+        return [];
+    }
+    return parseModelsText(row.modelsText);
+};
+/** Row key for connections map (stable for empty ids). */
+export const providerConnectionKey = (index) => String(index);

package/vendor/shared/dist/langflower.d.ts

@@ -11,9 +11,14 @@ export { langflowerWsConfig } from './langflower-bus-config.js';
  */
 export type { DividerPositions, ExecutionFeedSnapshotPayload, RunnerSnapshotPayload, SessionStateSnapshotPayload, ToolConfigSnapshotPayload, } from './types/langflower-bootstrap.js';
 export type { ProjectBootstrapResultPayload } from './types/langflower-project-bootstrap.js';
-export type { LangflowerConfig, LangflowerConfigSaveRequestedPayload, LangflowerConfigScope, LangflowerConfigSnapshotPayload, LangflowerHarnessConfig, LangflowerMcpConfig, LangflowerMcpHttpServerConfig, LangflowerMcpServerConfig, LangflowerMcpStdioServerConfig, LangflowerModelsCatalogSnapshotPayload, LangflowerProviderModelsCatalog, LangflowerPermissionConfig, LangflowerPermissionDecision, LangflowerPermissionToolConfig, LangflowerProviderConfig, LangflowerSkillConfig, LangflowerToolConfig, ProviderModelEntry, RunnerPermissionAskPayload, RunnerPermissionReplyPayload, } from './types/langflower-config.js';
+export type { LangflowerConfig, LangflowerConfigDraft, LangflowerConfigDraftDiscardRequestedPayload, LangflowerConfigDraftPatchRequestedPayload, LangflowerConfigDraftSnapshotPayload, LangflowerConfigSaveRequestedPayload, LangflowerConfigScope, LangflowerConfigSnapshotPayload, LangflowerHarnessConfig, LangflowerMcpConfig, LangflowerMcpHttpServerConfig, LangflowerMcpServerConfig, LangflowerMcpStdioServerConfig, LangflowerModelsCatalogSnapshotPayload, LangflowerProviderModelsCatalog, LangflowerPermissionConfig, LangflowerPermissionDecision, LangflowerPermissionToolConfig, LangflowerProviderConfig, LangflowerSkillConfig, LangflowerToolConfig, ProviderConnectionStatus, ProviderModelEntry, RunnerPermissionAskPayload, RunnerPermissionReplyPayload, } from './types/langflower-config.js';
 export { mergeLangflowerConfigLayers } from './langflower-config/merge-langflower-config-layers.js';
-export type { EditorAddEdgeRequestedPayload, EditorAddNodeRequestedPayload, EditorPasteRequestedPayload, EditorSelectedNodePayload, EditorSelectNodeRequestedPayload, EditorUpdateNodeRequestedPayload, } from './types/langflower-editor.js';
+export { defaultChatModelEmptyTitle, formatDefaultChatModel, parseDefaultChatModel, } from './langflower-config/parse-default-chat-model.js';
+export type { DefaultChatModelParts } from './langflower-config/parse-default-chat-model.js';
+export { configToDraft, defaultProviderStaticModelIds, draftAfterLayerSnapshot, draftToSavePayload, mergeDraftPatch, providerConnectionKey, redactDraftSecrets, sameDraft, } from './langflower-config/settings-draft.js';
+export type { ProviderDraft, ServerLogsDraft, SettingsDraft, } from './langflower-config/settings-draft.js';
+export { resolveServerLogsEnabled } from './langflower-config/resolve-server-logs-enabled.js';
+export type { EditorAddEdgeRequestedPayload, EditorAddNodeRequestedPayload, EditorPasteRequestedPayload, EditorSelectedNodePayload, EditorSelectNodeRequestedPayload, EditorSettingsRequestedPayload, EditorSettingsSnapshotPayload, EditorUpdateNodeRequestedPayload, } from './types/langflower-editor.js';
 export type { PaletteCompilationDiagnostic, PaletteConfigPayload, PaletteNodeDefinition, PaletteNodeSource, } from './types/langflower-palette.js';
 export type { CustomPaletteCompilationStatus, CustomPalettePackError, CustomPaletteSnapshotPayload, } from './types/langflower-custom-palette.js';
 export type { ExecutionProgressStatus, SessionReadyPayload, } from './types/langflower-server.js';

package/vendor/shared/dist/langflower.js

@@ -5,6 +5,9 @@ export { encodeMcpToolId, isMcpToolId, isValidMcpServerId, parseMcpToolId, } fro
 export { displayEnabledToolIds, HARNESS_BUILTIN_TOOL_OPTIONS, mergeEnabledToolIdsOnNewWires, resolveEnabledToolOptions, resolveMcpServerOptions, resolveWiredToolOptions, } from './langflower-config/resolve-wired-tool-options.js';
 export { langflowerWsConfig } from './langflower-bus-config.js';
 export { mergeLangflowerConfigLayers } from './langflower-config/merge-langflower-config-layers.js';
+export { defaultChatModelEmptyTitle, formatDefaultChatModel, parseDefaultChatModel, } from './langflower-config/parse-default-chat-model.js';
+export { configToDraft, defaultProviderStaticModelIds, draftAfterLayerSnapshot, draftToSavePayload, mergeDraftPatch, providerConnectionKey, redactDraftSecrets, sameDraft, } from './langflower-config/settings-draft.js';
+export { resolveServerLogsEnabled } from './langflower-config/resolve-server-logs-enabled.js';
 export { toCheckpointJsonValue } from './checkpoint/json-value.js';
 export { buildWorkflowFingerprint } from './checkpoint/workflow-fingerprint.js';
 export { deriveExecutionProgressStatus, formatRunSettleLine, terminalExecutionProgressStatus, } from './execution/derive-run-settle-outcome.js';

package/vendor/shared/dist/types/langflower-bootstrap.d.ts

@@ -1,7 +1,7 @@
 import type { RunId, RuntimeRunnerEvent, RuntimeRunnerStatus } from '@langflower/runtime';
 import type { ToolConfig } from './config.js';
 import type { LangflowerConfig } from './langflower-config.js';
-import type { EditorSelectedNodePayload } from './langflower-editor.js';
+import type { EditorSelectedNodePayload, EditorSettingsSnapshotPayload } from './langflower-editor.js';
 import type { ExecutionProgressStatus } from './langflower-server.js';
 /** Editor divider positions (sidebar + composer sizes in px). */
 export type DividerPositions = {
@@ -57,4 +57,9 @@ export type SessionStateSnapshotPayload = {
     readonly dividerPositions: DividerPositions;
     /** Currently selected canvas node (in memory, shared across tabs), or `null`. */
     readonly selectedNode: EditorSelectedNodePayload['node'];
+    /**
+     * Settings aside chrome (open + scope). Empty effective providers force
+     * `{ open: true, scope: 'global' }` on connect for bootstrap onboarding.
+     */
+    readonly settings: EditorSettingsSnapshotPayload;
 };

package/vendor/shared/dist/types/langflower-config.d.ts

@@ -114,6 +114,11 @@ export type LangflowerConfig = {
      * Inspector `enabledMcpIds` is the only enable gate.
      */
     readonly mcp?: LangflowerMcpConfig;
+    /**
+     * Bridge diagnostic JSONL logging under `.langflower/logs/`.
+     * Omit = inherit (Default in Settings); `true`/`false` set the scope.
+     */
+    readonly serverLogs?: boolean;
 };
 /** Settings / config save target layer. */
 export type LangflowerConfigScope = 'project' | 'global';
@@ -131,6 +136,11 @@ export type LangflowerConfigSaveRequestedPayload = {
     readonly model?: string;
     readonly provider?: Readonly<Record<string, LangflowerProviderConfig>>;
     readonly providerApiKeys?: Readonly<Record<string, string>>;
+    /**
+     * `true` / `false` persist the scope key; `null` clears it (Default).
+     * Omitted leaves the existing scope value unchanged.
+     */
+    readonly serverLogs?: boolean | null;
 };
 /** Server → client authoritative config slice (effective + editable layers). */
 export type LangflowerConfigSnapshotPayload = {
@@ -179,3 +189,58 @@ export type LangflowerProviderModelsCatalog = {
 export type LangflowerModelsCatalogSnapshotPayload = {
     readonly catalogs: Readonly<Record<string, LangflowerProviderModelsCatalog>>;
 };
+/**
+ * Per-provider connection probe status on the Settings draft snapshot.
+ * Keyed by draft row index string (`"0"`, `"1"`, …).
+ */
+export type ProviderConnectionStatus = {
+    readonly state: 'idle';
+} | {
+    readonly state: 'checking';
+} | {
+    readonly state: 'ok';
+    readonly modelCount: number;
+} | {
+    readonly state: 'error';
+    readonly message: string;
+};
+/**
+ * Redacted Settings form draft (same shape as UI/server session draft).
+ * `providers[].apiKey` is always empty on the wire.
+ */
+export type LangflowerConfigDraft = {
+    readonly defaultProviderId: string;
+    readonly defaultModelId: string;
+    readonly providers: readonly {
+        readonly id: string;
+        readonly name: string;
+        readonly baseURL: string;
+        readonly modelsText: string;
+        readonly apiKey: string;
+        readonly hasApiKey: boolean;
+    }[];
+    readonly serverLogs: 'off' | 'default' | 'on';
+};
+/**
+ * Server → client: authoritative unsaved Settings draft for one scope,
+ * including per-row connection status. Session memory; broadcast to all tabs.
+ */
+export type LangflowerConfigDraftSnapshotPayload = {
+    readonly scope: LangflowerConfigScope;
+    readonly draft: LangflowerConfigDraft;
+    readonly baseline: LangflowerConfigDraft;
+    readonly dirty: boolean;
+    readonly connections: Readonly<Record<string, ProviderConnectionStatus>>;
+};
+/**
+ * Client → server: replace the session draft for a scope (full draft).
+ * Empty `providers[].apiKey` means keep the session pending key / saved key.
+ */
+export type LangflowerConfigDraftPatchRequestedPayload = {
+    readonly scope: LangflowerConfigScope;
+    readonly draft: LangflowerConfigDraft;
+};
+/** Client → server: re-seed draft from the saved layer for a scope. */
+export type LangflowerConfigDraftDiscardRequestedPayload = {
+    readonly scope: LangflowerConfigScope;
+};

package/vendor/shared/dist/types/langflower-editor.d.ts

@@ -1,4 +1,5 @@
 import type { NodeId } from '@langflower/runtime';
+import type { LangflowerConfigScope } from './langflower-config.js';
 import type { PaletteNodeDefinition } from './langflower-palette.js';
 import type { WorkflowNodePersisted } from './langflower-workflow.js';
 /** Palette drop or explicit add-node intent — server assigns `nodeId`. */
@@ -65,6 +66,24 @@ export type EditorUpdateNodeRequestedPayload = {
 export type EditorSelectNodeRequestedPayload = {
     readonly nodeId: NodeId | null;
 };
+/**
+ * Authoritative Settings aside chrome — open/closed + active config scope.
+ * Session memory only (not persisted to `langflower.jsonc`).
+ */
+export type EditorSettingsSnapshotPayload = {
+    readonly open: boolean;
+    readonly scope: LangflowerConfigScope;
+};
+/**
+ * Intent to set Settings aside chrome.
+ *
+ * When `open: true`, `scope` is required. When `open: false`, server keeps the
+ * prior scope for the next open.
+ */
+export type EditorSettingsRequestedPayload = {
+    readonly open: boolean;
+    readonly scope?: LangflowerConfigScope;
+};
 /**
  * Rich selected-node projection for the Inspector — the existing persisted
  * node shape plus its palette definition, no parallel DTO. `null` when