@widgetic/workflows 0.2.10 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +11 -13
  2. package/dist/api/workflowsApi.d.ts +9 -1
  3. package/dist/api/workflowsApi.js +2 -1
  4. package/dist/assistant/assistantEvents.d.ts +42 -0
  5. package/dist/assistant/assistantEvents.js +61 -0
  6. package/dist/assistant/assistantRemoteChange.d.ts +4 -0
  7. package/dist/assistant/assistantRemoteChange.js +8 -0
  8. package/dist/assistant/assistantSaveMode.d.ts +5 -0
  9. package/dist/assistant/assistantSaveMode.js +8 -0
  10. package/dist/assistant/assistantStream.d.ts +8 -0
  11. package/dist/assistant/assistantStream.js +140 -0
  12. package/dist/assistant/assistantTranscript.d.ts +11 -0
  13. package/dist/assistant/assistantTranscript.js +18 -0
  14. package/dist/assistant/types.d.ts +81 -0
  15. package/dist/assistant/types.js +1 -0
  16. package/dist/assistant/workflowPlanViewModel.d.ts +48 -0
  17. package/dist/assistant/workflowPlanViewModel.js +17 -0
  18. package/dist/components/Workflows.svelte +3 -1
  19. package/dist/components/WorkflowsEmptyState.svelte +15 -3
  20. package/dist/components/WorkflowsEmptyState.svelte.d.ts +2 -0
  21. package/dist/components/WorkflowsWorkspace.svelte +4 -0
  22. package/dist/components/WorkflowsWorkspace.svelte.d.ts +1 -0
  23. package/dist/components/assistant/WorkflowAssistantPanel.svelte +384 -0
  24. package/dist/components/assistant/WorkflowAssistantPanel.svelte.d.ts +8 -0
  25. package/dist/components/canvas/CompositionNodeView.svelte +5 -5
  26. package/dist/components/canvas/ConditionNodeView.svelte +4 -4
  27. package/dist/components/canvas/HandlePoint.svelte +1 -1
  28. package/dist/components/canvas/TriggerNodeView.svelte +5 -4
  29. package/dist/components/canvas/WorkflowCanvas.svelte +16 -6
  30. package/dist/components/canvas/WorkflowCanvas.svelte.d.ts +2 -2
  31. package/dist/components/editor/EditorCanvasArea.svelte +57 -2
  32. package/dist/components/editor/EditorCanvasArea.svelte.d.ts +8 -1
  33. package/dist/components/editor/EditorTabs.svelte +1 -2
  34. package/dist/components/editor/EditorTopBar.svelte +29 -21
  35. package/dist/components/editor/EditorTopBar.svelte.d.ts +3 -0
  36. package/dist/components/editor/RunsFlow.svelte +73 -23
  37. package/dist/components/editor/WorkflowEditor.svelte +31 -3
  38. package/dist/components/editor/WorkflowEditor.svelte.d.ts +5 -0
  39. package/dist/components/editor/WorkflowNameControl.svelte +136 -0
  40. package/dist/components/editor/WorkflowNameControl.svelte.d.ts +13 -0
  41. package/dist/components/list/WorkflowList.svelte +112 -60
  42. package/dist/components/list/WorkflowList.svelte.d.ts +2 -0
  43. package/dist/components/list/WorkflowRow.svelte +2 -0
  44. package/dist/components/panel/ConditionForm.svelte +7 -7
  45. package/dist/components/ui/Menu.svelte +31 -7
  46. package/dist/components/ui/Menu.svelte.d.ts +4 -0
  47. package/dist/components/ui/icons.d.ts +2 -0
  48. package/dist/components/ui/icons.js +3 -1
  49. package/dist/drafts/draftJournal.d.ts +59 -0
  50. package/dist/drafts/draftJournal.js +261 -0
  51. package/dist/drafts/workflowDraft.d.ts +72 -0
  52. package/dist/drafts/workflowDraft.js +151 -0
  53. package/dist/drafts/workflowListViewState.d.ts +30 -0
  54. package/dist/drafts/workflowListViewState.js +92 -0
  55. package/dist/editor/createBlankWorkflow.d.ts +30 -0
  56. package/dist/editor/createBlankWorkflow.js +37 -0
  57. package/dist/editor/editorState.svelte.d.ts +68 -2
  58. package/dist/editor/editorState.svelte.js +273 -0
  59. package/dist/editor/listState.svelte.d.ts +73 -36
  60. package/dist/editor/listState.svelte.js +260 -46
  61. package/dist/editor/presetChoice.d.ts +4 -4
  62. package/dist/editor/presetChoice.js +4 -4
  63. package/dist/editor/runsFlowBandLabel.d.ts +16 -0
  64. package/dist/editor/runsFlowBandLabel.js +34 -0
  65. package/dist/editor/runsFlowLayout.d.ts +24 -9
  66. package/dist/editor/runsFlowLayout.js +73 -28
  67. package/dist/editor/workflowNameCommit.d.ts +12 -0
  68. package/dist/editor/workflowNameCommit.js +11 -0
  69. package/dist/i18n/language.d.ts +3 -3
  70. package/dist/i18n/messages.d.ts +40 -26
  71. package/dist/i18n/messages.js +43 -30
  72. package/dist/types/index.d.ts +4 -0
  73. package/package.json +8 -1
  74. package/dist/components/list/CreateWorkflowDialog.svelte +0 -262
  75. package/dist/components/list/CreateWorkflowDialog.svelte.d.ts +0 -9
@@ -4,6 +4,8 @@ import { WorkflowsApiError, isCancelled } from '../api/workflowsApi.js';
4
4
  import { workflowsError, workflowsWarn } from '../utils/logger.js';
5
5
  import { pickApiErrorMessage } from './apiErrorText.js';
6
6
  import { createDraftSaver } from './autosave.js';
7
+ import { createDraftJournal } from '../drafts/draftJournal.js';
8
+ import { WORKFLOW_DRAFT_NAMESPACE, applyDraftRestoreRule, draftPayloadFromServerCopy, payloadsEqual, serverBaseRevision, KEEPALIVE_SAVE_MAX_BYTES, validateWorkflowEditorViewState, viewStateStorageKey, parseViewStateEntry, serializeViewState } from '../drafts/workflowDraft.js';
7
9
  import { toValidationContext } from './capabilityModel.js';
8
10
  import { EditLeaseController, NO_PRESENCE } from './editLeaseController.js';
9
11
  import { dropStrandedConnections, ensureOneStart, isSameGraph, listCompositionIds, makeEmptyGraph, planAddBlock, removeBlocks, removeConnections, setStartBlock } from './graphModel.js';
@@ -68,6 +70,12 @@ export class WorkflowEditorState {
68
70
  * list and comes back when the findings change or a publish is tried.
69
71
  */
70
72
  problemsPanelClosedFor = $state(null);
73
+ /** Which rule card is expanded in the condition side panel (accordion). */
74
+ expandedRuleId = $state(null);
75
+ /** The workflow name being typed in the header before it is committed. */
76
+ pendingWorkflowName = $state(null);
77
+ /** Last known canvas pan/zoom, restored after a reload when the canvas is ready. */
78
+ canvasViewport = $state.raw(null);
71
79
  // ---- versions ------------------------------------------------------------------------------------------------
72
80
  versions = $state.raw(null);
73
81
  versionsState = $state('idle');
@@ -100,6 +108,14 @@ export class WorkflowEditorState {
100
108
  leaseController = null;
101
109
  /** The latest look at the server's draft, after editing came back (see `catchUpAfterPause`): a newer look and leaving the screen cancel it. */
102
110
  catchUpController = null;
111
+ draftJournal;
112
+ onDraftRestored;
113
+ draftBaseRevision = null;
114
+ lastJournaledPayload = null;
115
+ leaveFlushDisposer = null;
116
+ viewStateStorage;
117
+ now;
118
+ viewStateWriteTimer = null;
103
119
  constructor(options) {
104
120
  this.workflowId = options.workflowId;
105
121
  this.api = options.api;
@@ -110,6 +126,26 @@ export class WorkflowEditorState {
110
126
  this.noticeMilliseconds = options.noticeMilliseconds ?? DEFAULT_NOTICE_MILLISECONDS;
111
127
  this.presenceWanted = options.presence === true;
112
128
  this.presenceOptions = options.presenceOptions;
129
+ this.onDraftRestored = options.onDraftRestored;
130
+ this.now = options.now ?? (() => Date.now());
131
+ this.viewStateStorage =
132
+ options.viewStateStorage !== undefined
133
+ ? options.viewStateStorage
134
+ : typeof sessionStorage !== 'undefined'
135
+ ? sessionStorage
136
+ : null;
137
+ if (options.draftJournal !== undefined) {
138
+ this.draftJournal = options.draftJournal;
139
+ }
140
+ else {
141
+ this.draftJournal = createDraftJournal(WORKFLOW_DRAFT_NAMESPACE, options.draftJournalOptions ?? {});
142
+ }
143
+ if (this.draftJournal) {
144
+ this.leaveFlushDisposer = this.draftJournal.installFlushOnLeave(() => {
145
+ this.flushDraftJournalNow();
146
+ this.tryKeepaliveSaveOnLeave();
147
+ });
148
+ }
113
149
  this.saver = createDraftSaver({
114
150
  readSnapshot: () => this.readSaveSnapshot(),
115
151
  send: (snapshot) => this.api.saveDraft(this.workflowId, this.toSaveInput(snapshot)),
@@ -217,6 +253,8 @@ export class WorkflowEditorState {
217
253
  this.options = optionsById;
218
254
  this.optionsReady = true;
219
255
  this.adoptServerDraft(detail);
256
+ this.tryApplyDraftAfterLoad(detail);
257
+ this.restoreEditorViewState();
220
258
  this.loadState = 'ready';
221
259
  }
222
260
  catch (error) {
@@ -233,6 +271,11 @@ export class WorkflowEditorState {
233
271
  this.loadController?.abort();
234
272
  this.catchUpController?.abort();
235
273
  this.saver.dispose();
274
+ this.leaveFlushDisposer?.();
275
+ this.leaveFlushDisposer = null;
276
+ if (this.viewStateWriteTimer !== null)
277
+ clearTimeout(this.viewStateWriteTimer);
278
+ this.viewStateWriteTimer = null;
236
279
  // The claim on editing is given up with the screen, so a teammate does not have to wait for it to run out.
237
280
  this.leaseController?.dispose();
238
281
  this.leaseController = null;
@@ -264,6 +307,8 @@ export class WorkflowEditorState {
264
307
  this.name = detail.name;
265
308
  this.timezone = detail.timezone;
266
309
  this.lastSaved = { graph: detail.graph, name: detail.name, timezone: detail.timezone };
310
+ this.draftBaseRevision = serverBaseRevision(detail.revision);
311
+ this.pendingWorkflowName = null;
267
312
  this.saver.reset();
268
313
  this.saveFailure = null;
269
314
  this.selectedNodeIds = [];
@@ -271,6 +316,7 @@ export class WorkflowEditorState {
271
316
  this.refusedIssues = [];
272
317
  this.problemsRevealed = false;
273
318
  this.testRun = null;
319
+ this.expandedRuleId = null;
274
320
  this.draftEpoch += 1;
275
321
  this.canvas?.loadGraph(graph);
276
322
  }
@@ -280,6 +326,29 @@ export class WorkflowEditorState {
280
326
  if (this.loadState === 'ready')
281
327
  this.showNotice('info', 'workflows.editor.reloaded');
282
328
  }
329
+ /** Opens another workflow (assistant created a new draft). */
330
+ goToWorkflow(workflowId) {
331
+ if (workflowId !== this.workflowId)
332
+ this.openWorkflow(workflowId);
333
+ }
334
+ /** After the workflows assistant saved remotely: reload when clean, otherwise use the existing conflict banner. */
335
+ async respondToAssistantWorkflowUpdate() {
336
+ if (this.disposed || this.loadState !== 'ready')
337
+ return;
338
+ const { decideAssistantRemoteChangeAction } = await import('../assistant/assistantRemoteChange.js');
339
+ const action = decideAssistantRemoteChangeAction(this.saveState);
340
+ if (action === 'noop')
341
+ return;
342
+ if (action === 'showConflict') {
343
+ this.followSaveState('conflict', new WorkflowsApiError('This workflow was changed somewhere else.', {
344
+ status: 409,
345
+ code: 'BUSINESS_STATE_CONFLICT',
346
+ details: { reason: 'revision_changed' },
347
+ }));
348
+ return;
349
+ }
350
+ await this.reloadDraft();
351
+ }
283
352
  // =================================================================================================================
284
353
  // Who else is editing
285
354
  // =================================================================================================================
@@ -439,6 +508,8 @@ export class WorkflowEditorState {
439
508
  if (this.testRun !== null)
440
509
  this.testRun = null;
441
510
  this.saver.markChanged();
511
+ this.journalDraftFromState();
512
+ this.schedulePersistViewState();
442
513
  }
443
514
  /** Replaces one block (the side panel changed it). */
444
515
  replaceBlock(node) {
@@ -516,6 +587,20 @@ export class WorkflowEditorState {
516
587
  if (this.panel === 'history' && this.viewing === null)
517
588
  this.panel = 'selection';
518
589
  }
590
+ this.schedulePersistViewState();
591
+ }
592
+ /** Pan/zoom of the canvas, for restoring view state after a reload. */
593
+ followViewport(viewport) {
594
+ this.canvasViewport = viewport;
595
+ this.schedulePersistViewState();
596
+ }
597
+ /** The workflow name being typed in the header before commit (journaled for refresh). */
598
+ setPendingWorkflowName(name) {
599
+ const next = name?.trim() === '' ? null : name;
600
+ if (this.pendingWorkflowName === next)
601
+ return;
602
+ this.pendingWorkflowName = next;
603
+ this.journalDraftFromState();
519
604
  }
520
605
  setName(name) {
521
606
  if (this.isReadOnly)
@@ -576,6 +661,7 @@ export class WorkflowEditorState {
576
661
  this.lastSaved = snapshot.next;
577
662
  if (this.workflow)
578
663
  this.workflow = { ...this.workflow, ...answer };
664
+ this.noteDraftAfterSuccessfulSave(snapshot);
579
665
  }
580
666
  followSaveState(state, error) {
581
667
  this.saveState = state;
@@ -704,11 +790,13 @@ export class WorkflowEditorState {
704
790
  this.panel = 'history';
705
791
  if (this.versions === null)
706
792
  void this.loadVersions();
793
+ this.schedulePersistViewState();
707
794
  }
708
795
  closeHistory() {
709
796
  if (this.viewing !== null)
710
797
  this.leaveVersion();
711
798
  this.panel = 'selection';
799
+ this.schedulePersistViewState();
712
800
  }
713
801
  /** Closes the Problems panel for the findings it lists now (see `problemsPanelClosedFor`). */
714
802
  closeProblemsPanel() {
@@ -810,10 +898,12 @@ export class WorkflowEditorState {
810
898
  openTestRun() {
811
899
  this.panel = 'test';
812
900
  this.testRun = startTestRun(this.graph);
901
+ this.schedulePersistViewState();
813
902
  }
814
903
  closeTestRun() {
815
904
  this.panel = 'selection';
816
905
  this.testRun = null;
906
+ this.schedulePersistViewState();
817
907
  }
818
908
  restartTestRun() {
819
909
  this.testRun = startTestRun(this.graph);
@@ -829,6 +919,189 @@ export class WorkflowEditorState {
829
919
  this.testRun = fireTestTrigger(this.graph, state, trigger, values);
830
920
  }
831
921
  // =================================================================================================================
922
+ // Draft journal and editor view state (refresh persistence)
923
+ // =================================================================================================================
924
+ selectTab(tab) {
925
+ if (tab !== 'editor' && this.viewing)
926
+ this.leaveVersion();
927
+ this.tab = tab;
928
+ this.schedulePersistViewState();
929
+ }
930
+ readDraftPayload() {
931
+ const payload = {
932
+ graph: this.graph,
933
+ name: this.name,
934
+ timezone: this.timezone
935
+ };
936
+ if (this.pendingWorkflowName !== null)
937
+ payload.pendingName = this.pendingWorkflowName;
938
+ return payload;
939
+ }
940
+ journalDraftFromState() {
941
+ if (!this.draftJournal || this.loadState !== 'ready' || this.isReadOnly)
942
+ return;
943
+ const payload = this.readDraftPayload();
944
+ this.lastJournaledPayload = payload;
945
+ this.draftJournal.write(this.workflowId, payload, this.draftBaseRevision);
946
+ }
947
+ flushDraftJournalNow() {
948
+ if (!this.draftJournal || this.loadState !== 'ready')
949
+ return;
950
+ const snapshot = this.readSaveSnapshot();
951
+ if (snapshot === null && this.pendingWorkflowName === null)
952
+ return;
953
+ const payload = this.readDraftPayload();
954
+ this.draftJournal.flushNow(this.workflowId, payload, this.draftBaseRevision);
955
+ }
956
+ tryKeepaliveSaveOnLeave() {
957
+ if (this.disposed || this.saveState === 'conflict' || this.loadState !== 'ready')
958
+ return;
959
+ const snapshot = this.readSaveSnapshot();
960
+ if (snapshot === null)
961
+ return;
962
+ const body = this.toSaveInput(snapshot);
963
+ let serialized = '';
964
+ try {
965
+ serialized = JSON.stringify(body);
966
+ }
967
+ catch {
968
+ return;
969
+ }
970
+ if (serialized.length > KEEPALIVE_SAVE_MAX_BYTES)
971
+ return;
972
+ void this.api.saveDraft(this.workflowId, body, { keepalive: true });
973
+ }
974
+ tryApplyDraftAfterLoad(detail) {
975
+ if (!this.draftJournal || this.disposed)
976
+ return;
977
+ const serverPayload = draftPayloadFromServerCopy({
978
+ graph: ensureOneStart(detail.graph),
979
+ name: detail.name,
980
+ timezone: detail.timezone
981
+ });
982
+ const serverRevision = serverBaseRevision(detail.revision);
983
+ const entry = this.draftJournal.read(this.workflowId);
984
+ const result = applyDraftRestoreRule({
985
+ entry,
986
+ serverRevision,
987
+ serverPayload,
988
+ journal: this.draftJournal,
989
+ workflowId: this.workflowId,
990
+ nowMs: this.now(),
991
+ logger: { debug: (message, detail) => workflowsWarn(message, detail) }
992
+ });
993
+ if (!result.applied || !entry)
994
+ return;
995
+ const payload = entry.payload;
996
+ const graph = ensureOneStart(payload.graph);
997
+ this.graph = graph;
998
+ this.name = payload.name;
999
+ this.timezone = payload.timezone;
1000
+ if (typeof payload.pendingName === 'string' && payload.pendingName.trim() !== '') {
1001
+ const trimmed = payload.pendingName.trim();
1002
+ if (trimmed !== this.name)
1003
+ this.name = trimmed;
1004
+ this.pendingWorkflowName = trimmed;
1005
+ }
1006
+ this.lastSaved = { graph: detail.graph, name: detail.name, timezone: detail.timezone };
1007
+ this.saver.markChanged();
1008
+ this.draftEpoch += 1;
1009
+ this.canvas?.loadGraph(graph);
1010
+ void this.refreshMissingCompositions();
1011
+ this.lastJournaledPayload = payload;
1012
+ this.journalDraftFromState();
1013
+ this.onDraftRestored?.({
1014
+ key: this.workflowId,
1015
+ savedAtMs: result.savedAtMs ?? entry.savedAtMs
1016
+ });
1017
+ }
1018
+ noteDraftAfterSuccessfulSave(_snapshot) {
1019
+ if (!this.draftJournal)
1020
+ return;
1021
+ this.draftBaseRevision = serverBaseRevision(this.revision);
1022
+ const currentPayload = this.readDraftPayload();
1023
+ if (this.readSaveSnapshot() === null) {
1024
+ const journaled = this.lastJournaledPayload;
1025
+ if (!journaled || payloadsEqual(journaled, currentPayload)) {
1026
+ this.draftJournal.clear(this.workflowId);
1027
+ this.lastJournaledPayload = null;
1028
+ }
1029
+ else {
1030
+ this.journalDraftFromState();
1031
+ }
1032
+ }
1033
+ else {
1034
+ this.journalDraftFromState();
1035
+ }
1036
+ }
1037
+ /** Queues writing editor view state to `sessionStorage` (selection, tab, viewport). */
1038
+ persistEditorViewState() {
1039
+ this.schedulePersistViewState();
1040
+ }
1041
+ schedulePersistViewState() {
1042
+ if (!this.viewStateStorage || this.loadState !== 'ready')
1043
+ return;
1044
+ if (this.viewStateWriteTimer !== null)
1045
+ clearTimeout(this.viewStateWriteTimer);
1046
+ this.viewStateWriteTimer = setTimeout(() => {
1047
+ this.viewStateWriteTimer = null;
1048
+ this.persistViewStateNow();
1049
+ }, 250);
1050
+ }
1051
+ persistViewStateNow() {
1052
+ const storage = this.viewStateStorage;
1053
+ if (!storage || this.loadState !== 'ready')
1054
+ return;
1055
+ const viewport = this.canvasViewport ?? (this.canvas ? this.canvas.viewport : null);
1056
+ const state = {
1057
+ v: 1,
1058
+ tab: this.tab,
1059
+ panel: this.panel,
1060
+ selectedNodeIds: [...this.selectedNodeIds],
1061
+ selectedEdgeIds: [...this.selectedEdgeIds],
1062
+ viewport,
1063
+ expandedRuleId: this.expandedRuleId
1064
+ };
1065
+ try {
1066
+ storage.setItem(viewStateStorageKey(this.workflowId), serializeViewState(state));
1067
+ }
1068
+ catch {
1069
+ // ignore quota errors for view state
1070
+ }
1071
+ }
1072
+ restoreEditorViewState() {
1073
+ const storage = this.viewStateStorage;
1074
+ if (!storage)
1075
+ return;
1076
+ let raw;
1077
+ try {
1078
+ raw = storage.getItem(viewStateStorageKey(this.workflowId));
1079
+ }
1080
+ catch {
1081
+ return;
1082
+ }
1083
+ const parsed = parseViewStateEntry(raw);
1084
+ if (!parsed)
1085
+ return;
1086
+ const nodeIds = new Set(this.graph.nodes.map((node) => node.id));
1087
+ const edgeIds = new Set(this.graph.edges.map((edge) => edge.id));
1088
+ const validated = validateWorkflowEditorViewState(parsed, nodeIds, edgeIds);
1089
+ if (!validated)
1090
+ return;
1091
+ this.tab = validated.tab;
1092
+ this.panel = validated.panel;
1093
+ this.selectedNodeIds = validated.selectedNodeIds;
1094
+ this.selectedEdgeIds = validated.selectedEdgeIds;
1095
+ this.expandedRuleId = validated.expandedRuleId ?? null;
1096
+ if (validated.viewport) {
1097
+ this.canvasViewport = validated.viewport;
1098
+ this.canvas?.setViewport(validated.viewport);
1099
+ }
1100
+ if (validated.selectedNodeIds.length > 0) {
1101
+ this.canvas?.selectNodes(validated.selectedNodeIds);
1102
+ }
1103
+ }
1104
+ // =================================================================================================================
832
1105
  // Saying what happened
833
1106
  // =================================================================================================================
834
1107
  showNotice(tone, messageKey, values) {