@hydranium/glsp-server 1.0.0-next.31 → 1.0.0-next.315

package/lib/command/hydranium-glsp-recording-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydranium-glsp-recording-command.d.ts","sourceRoot":"","sources":["../../src/command/hydranium-glsp-recording-command.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAE5F;;;;;;;;;GASG;AACH,MAAM,MAAM,2BAA2B,CAAC,YAAY,SAAS,SAAS,IAAI,0BAA0B,CAAC,OAAO,EAAE,YAAY,CAAC,GACxH,cAAc,CAAC,YAAY,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,6BAA6B,CAAC,YAAY,SAAS,SAAS,CAAE,SAAQ,oBAAoB,CAAC,YAAY,CAAC;IA0B/G,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM;IAEhC;uEACmE;IACnE,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAE,MAAM,YAAY,CAAC,IAAI,CAAC;IACxD,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAE,MAAM,YAAY,CAAC,IAAI,CAAC;IAhC3D,UAAkB,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAExE;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;;;;OAQG;IACH,SAAS,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC;IACxC,SAAS,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;gBAGpC,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC;IACrD,mFAAmF;IAChE,KAAK,EAAE,MAAM,EAChC,SAAS,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC;IACnC;uEACmE;IAChD,UAAU,CAAC,GAAE,MAAM,YAAY,CAAC,IAAI,CAAC,aAAA;IACxD,gEAAgE;IAC7C,UAAU,CAAC,GAAE,MAAM,YAAY,CAAC,IAAI,CAAC,aAAA;IAK3D;;;;;;;;;;OAUG;IACY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAavC;;;;;;;;;OASG;cACgB,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC;IAIzE;;;;;;;;;;;OAWG;IACY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBpC;;;;OAIG;IACY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAgBtC"}
+{"version":3,"file":"hydranium-glsp-recording-command.d.ts","sourceRoot":"","sources":["../../src/command/hydranium-glsp-recording-command.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,6BAA6B,EAAiC,MAAM,uCAAuC,CAAC;AAErH;;;;;;;;;GASG;AACH,MAAM,MAAM,2BAA2B,CAAC,YAAY,SAAS,SAAS,IAAI,0BAA0B,CAAC,OAAO,EAAE,YAAY,CAAC,GACxH,cAAc,CAAC,YAAY,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,6BAA6B,CAAC,YAAY,SAAS,SAAS,CAAE,SAAQ,oBAAoB,CAAC,YAAY,CAAC;IAQ/G,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM;IAEhC;uEACmE;IACnE,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAE,MAAM,YAAY,CAAC,IAAI,CAAC;IACxD,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAE,MAAM,YAAY,CAAC,IAAI,CAAC;IAd3D,UAAkB,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAExE,uEAAuE;IACvE,SAAS,CAAC,YAAY,CAAC,EAAE,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAErE,YACG,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC;IACrD,mFAAmF;IAChE,KAAK,EAAE,MAAM,EAChC,SAAS,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC;IACnC;uEACmE;IAChD,UAAU,CAAC,GAAE,MAAM,YAAY,CAAC,IAAI,CAAC,aAAA;IACxD,0DAA0D;IACvC,UAAU,CAAC,GAAE,MAAM,YAAY,CAAC,IAAI,CAAC,aAAA,EAG1D;IAEc,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CActC;IAED,sFAAsF;IACtF,UAAmB,UAAU,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAE3D;IAED;;;OAGG;IACY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAInC;IAED,8DAA8D;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAInC;CACH"}

package/lib/command/hydranium-glsp-recording-command.js

@@ -7,153 +7,76 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 import { JsonRecordingCommand } from '@eclipse-glsp/server';
+import { HydraniumGlspOperationCommand, openOperationOf, runOperation } from './hydranium-glsp-operation-command.js';
 /**
- * GLSP {@link JsonRecordingCommand} base shared by all hydranium adopters.
- * Adds two things on top of GLSP's class:
- *
- *  1. A **time-labelled execute wrapper** so log lines record how long a
- *     user-facing operation takes end-to-end — including the `postChange`
- *     source-model update that re-parses the document. Otherwise the diff +
- *     patch + persist work happens silently and is hard to attribute when
- *     something is slow.
- *  2. A typed `state` field that exposes `updateSourceModel` for the
- *     `postChange` bridge AND the framework `logger` for time-labelled
- *     logging. GLSP's base class only types `modelState: JsonModelState`,
- *     which lacks the framework's logger surface.
+ * GLSP {@link JsonRecordingCommand} base shared by all hydranium adopters: a
+ * handler mutates `sourceRoot` in the command's runnable, and the operation
+ * the command executes in writes the result once when it ends.
  *
  * **Optional undo/redo bridge hooks.** An adopter command can supply
- * `undoAction` / `redoAction` callbacks invoked alongside the patch apply, to
- * re-emit a side-effect the patch itself does not carry. Provided as optional
- * constructor args so adopters get that composition surface without
- * subclassing. Operation handlers that don't need bridge callbacks omit them.
+ * `undoAction` / `redoAction` callbacks, run when the operation is undone or
+ * redone and when a failed operation rolls back, to re-emit a side effect the
+ * model does not carry. During an undo or redo they run against throwaway
+ * copies, and a recording command executed there throws.
  *
- * **postChange semantics.** GLSP's `JsonRecordingCommand.postChange` calls
- * `modelState.updateSourceModel(newModel)` with the model only. The
- * framework lift overrides `postChange` so it also threads the based-on
- * version captured at command start — letting the downstream
- * `ModelService.update` opt into the `ConflictError` gate. Undo / redo
- * postChange calls run with version `undefined` (no gating): the user
- * authored against the recorded patch, not against a specific server
- * version, so re-applying it should succeed regardless of intervening
- * edits. The recorded patch itself encodes the semantic intent.
+ * A command executed outside an operation opens one of its own through
+ * `runExclusive`, so executing it from inside the boundary with no operation
+ * open deadlocks. Its undo and redo then undo and redo that operation without
+ * taking the boundary, which the caller holds, as the framework's undo handler
+ * does; taking it there would deadlock under that handler.
  */
 export class HydraniumGlspRecordingCommand extends JsonRecordingCommand {
     label;
     undoAction;
     redoAction;
-    /**
-     * Based-on version captured at {@link execute} start; threaded into
-     * {@link postChange} so {@link AbstractHydraniumGlspState.updateSourceModel}
-     * sees the version the user authored against. Cleared after `execute`
-     * returns so undo / redo paths fall through to `updateSourceModel`
-     * without a version (no gating).
-     */
-    activeVersion;
-    /**
-     * Source-model snapshots captured at {@link execute} — the state the
-     * command left ({@link afterSnapshot}) and the state it started from
-     * ({@link beforeSnapshot}). {@link undo} / {@link redo} reconcile the
-     * recorded transition against the *current* source model via the state's
-     * {@link AbstractHydraniumGlspState.conflictResolver}, so under the default
-     * reconciling policy a concurrent edit to another field survives and a
-     * same-field collision is dropped rather than clobbered.
-     */
-    beforeSnapshot;
-    afterSnapshot;
+    /** The operation this command opened, when it executed outside one. */
+    ownOperation;
     constructor(modelState, 
     /** Human-readable label for the operation; appears in the timing-pair log line. */
     label, doExecute, 
-    /** Optional bridge invoked alongside undo patch application; for adopters
-     *  that need to re-emit a side-effect the patch does not carry. */
+    /** Optional bridge invoked when the command is undone; for adopters
+     *  that need to re-emit a side-effect the model does not carry. */
     undoAction, 
-    /** Optional bridge invoked alongside redo patch application. */
+    /** Optional bridge invoked when the command is redone. */
     redoAction) {
         super(modelState, doExecute);
         this.label = label;
         this.undoAction = undoAction;
         this.redoAction = redoAction;
     }
-    /**
-     * Time-label the full execute path: pre-state snapshot + `doExecute` +
-     * post-state snapshot + patch-derive + `postChange` (which writes back
-     * via {@link AbstractHydraniumGlspState.updateSourceModel}). The label combines
-     * the operation name with the source-uri-stamped logger.
-     *
-     * Captures {@link AbstractHydraniumGlspState.version} at start so {@link postChange}
-     * can thread the based-on version into `updateSourceModel`. The capture
-     * is `try`/`finally`-scoped so undo / redo paths invoked later do not
-     * see a stale captured version.
-     */
     async execute() {
-        const logger = this.modelState.logger.for('HydraniumGlspRecordingCommand');
-        this.activeVersion = this.modelState.version;
-        logger.debug(`Executing '${this.label}' (based-on doc.version=v${this.activeVersion})`);
-        this.beforeSnapshot = this.deepClone(await this.getJsonObject());
-        try {
-            await this.modelState.tracer.for('HydraniumGlspRecordingCommand').time(`Execute command '${this.label}'`, () => super.execute());
-        }
-        finally {
-            this.activeVersion = undefined;
+        const open = openOperationOf(this.modelState);
+        if (!open) {
+            const operation = new HydraniumGlspOperationCommand(this.modelState);
+            if ((await this.modelState.runExclusive(() => runOperation(operation, () => this))) === 'executed') {
+                this.ownOperation = operation;
+            }
+            return;
         }
-        this.afterSnapshot = this.deepClone(await this.getJsonObject());
+        open.assertNotDuringUndoRedo(this.label);
+        const tracer = this.modelState.tracer.for('HydraniumGlspRecordingCommand');
+        tracer.debug(`Executing '${this.label}' (base version v${this.modelState.version})`);
+        await tracer.time(`Execute command '${this.label}'`, () => super.execute());
+        open.recordExecuted({ undo: () => this.undoAction?.(), redo: () => this.redoAction?.() });
     }
-    /**
-     * Override of GLSP's {@link JsonRecordingCommand.postChange} so the
-     * call to {@link AbstractHydraniumGlspState.updateSourceModel} threads the
-     * captured based-on version alongside the new model.
-     *
-     * During {@link execute} the version is the snapshot captured at
-     * command start; during {@link undo} / {@link redo} it is `undefined`
-     * — replaying a recorded patch does not author against a specific
-     * server version, so no gate applies.
-     */
-    postChange(newModel) {
-        return this.modelState.updateSourceModel(newModel, this.activeVersion);
+    /** Writes nothing: the operation the command executes in writes once when it ends. */
+    postChange(_newModel) {
+        // Written by the operation.
     }
     /**
-     * Reconcile the recorded `after → before` transition against the
-     * *current* source model via the state's
-     * {@link AbstractHydraniumGlspState.conflictResolver}, invoke the optional adopter
-     * `undoAction`, and persist via `postChange`. Under the default reconciling
-     * policy the revert is replayed guarded by `test` ops, so a concurrent edit
-     * to another field is preserved (merged) and a same-field collision is
-     * dropped rather than clobbered; a force policy clobbers (last-writer-wins).
-     * On anything but a clean merge the undo is a logged no-op — the side-effect
-     * bridge and `postChange` only run on a merged result, preserving a
-     * "bridge before commit" order.
+     * Inside an open operation does nothing: the operation runs the bridge, once
+     * for every recording command that executed.
      */
     async undo() {
-        if (!this.undoPatch || this.beforeSnapshot === undefined || this.afterSnapshot === undefined) {
-            return;
+        if (!openOperationOf(this.modelState)) {
+            await this.ownOperation?.undo();
         }
-        const logger = this.modelState.logger.for('HydraniumGlspRecordingCommand');
-        logger.debug(`Undoing '${this.label}' at doc.version=v${this.modelState.version}`);
-        const outcome = await this.modelState.conflictResolver.resolve(this.afterSnapshot, this.beforeSnapshot, async () => this.getJsonObject());
-        if (outcome.status !== 'merged') {
-            logger.warn(`Undo '${this.label}' skipped (${outcome.status}); a foreign edit changed a shared field since the command ran`);
-            return;
-        }
-        await this.undoAction?.();
-        await this.postChange?.(outcome.merged);
     }
-    /**
-     * Reconcile the recorded `before → after` transition against the current
-     * source model, invoke the optional adopter `redoAction`, and persist via
-     * `postChange`. Same guarded merge / drop semantics as {@link undo}.
-     */
+    /** Inside an open operation does nothing, as {@link undo}. */
     async redo() {
-        if (!this.redoPatch || this.beforeSnapshot === undefined || this.afterSnapshot === undefined) {
-            return;
-        }
-        const logger = this.modelState.logger.for('HydraniumGlspRecordingCommand');
-        logger.debug(`Redoing '${this.label}' at doc.version=v${this.modelState.version}`);
-        const outcome = await this.modelState.conflictResolver.resolve(this.beforeSnapshot, this.afterSnapshot, async () => this.getJsonObject());
-        if (outcome.status !== 'merged') {
-            logger.warn(`Redo '${this.label}' skipped (${outcome.status}); a foreign edit changed a shared field since the undo`);
-            return;
+        if (!openOperationOf(this.modelState)) {
+            await this.ownOperation?.redo();
         }
-        await this.redoAction?.();
-        await this.postChange?.(outcome.merged);
     }
 }
 //# sourceMappingURL=hydranium-glsp-recording-command.js.map

package/lib/command/hydranium-glsp-recording-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"hydranium-glsp-recording-command.js","sourceRoot":"","sources":["../../src/command/hydranium-glsp-recording-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hydranium-glsp-recording-command.js","sourceRoot":"","sources":["../../src/command/hydranium-glsp-recording-command.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAuC,oBAAoB,EAAqB,MAAM,sBAAsB,CAAC;AAGpH,OAAO,EAAE,6BAA6B,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAerH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,6BAA8D,SAAQ,oBAAkC;IAS5F,KAAK;IAIL,UAAU;IAEV,UAAU;IAZhC,uEAAuE;IAC7D,YAAY,CAA+C;IAErE,YACG,UAAqD;IACrD,mFAAmF;IAChE,KAAa,EAChC,SAAmC;IACnC;uEACmE;IAChD,UAAqC;IACxD,0DAA0D;IACvC,UAAqC;QAExD,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;qBARV,KAAK;0BAIL,UAAU;0BAEV,UAAU;IAGhC,CAAC;IAEQ,KAAK,CAAC,OAAO;QACnB,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAe,IAAI,CAAC,UAAU,CAAC,CAAC;YACnF,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;gBAClG,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YACjC,CAAC;YACD,OAAO;QACV,CAAC;QACD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,KAAK,oBAAoB,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;QACrF,MAAM,MAAM,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,sFAAsF;IACnE,UAAU,CAAC,SAAuB;QAClD,4BAA4B;IAC/B,CAAC;IAED;;;OAGG;IACM,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC;IACJ,CAAC;IAED,8DAA8D;IACrD,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC;IACJ,CAAC;CACH"}

package/lib/command/hydranium-glsp-undo-redo-action-handler.d.ts

@@ -0,0 +1,23 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { type Action, UndoRedoActionHandler } from '@eclipse-glsp/server';
+import { type AstNode } from '@hydranium/langium';
+import { type AbstractHydraniumGlspState } from '../state/abstract-hydranium-glsp-state.js';
+/**
+ * GLSP's undo and redo handler inside the state's `runExclusive`. GLSP's
+ * command stack moves its position before it undoes or redoes the entry, so
+ * the boundary covers the whole action: taken around the undo or redo alone,
+ * an undo arriving while an operation runs would move the position past an
+ * entry it then cannot undo.
+ */
+export declare class HydraniumGlspUndoRedoActionHandler extends UndoRedoActionHandler {
+    protected readonly modelState: AbstractHydraniumGlspState<AstNode, unknown>;
+    execute(action: Action): Promise<Action[]>;
+}
+//# sourceMappingURL=hydranium-glsp-undo-redo-action-handler.d.ts.map

package/lib/command/hydranium-glsp-undo-redo-action-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-glsp-undo-redo-action-handler.d.ts","sourceRoot":"","sources":["../../src/command/hydranium-glsp-undo-redo-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,MAAM,EAAc,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAE5F;;;;;;GAMG;AACH,qBACa,kCAAmC,SAAQ,qBAAqB;IACtD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAG,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAExF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAElD;CACH"}

package/lib/command/hydranium-glsp-undo-redo-action-handler.js

@@ -0,0 +1,41 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { ModelState, UndoRedoActionHandler } from '@eclipse-glsp/server';
+import { inject, injectable } from 'inversify';
+/**
+ * GLSP's undo and redo handler inside the state's `runExclusive`. GLSP's
+ * command stack moves its position before it undoes or redoes the entry, so
+ * the boundary covers the whole action: taken around the undo or redo alone,
+ * an undo arriving while an operation runs would move the position past an
+ * entry it then cannot undo.
+ */
+let HydraniumGlspUndoRedoActionHandler = class HydraniumGlspUndoRedoActionHandler extends UndoRedoActionHandler {
+    modelState;
+    execute(action) {
+        return this.modelState.runExclusive(() => super.execute(action));
+    }
+};
+__decorate([
+    inject(ModelState),
+    __metadata("design:type", Function)
+], HydraniumGlspUndoRedoActionHandler.prototype, "modelState", void 0);
+HydraniumGlspUndoRedoActionHandler = __decorate([
+    injectable()
+], HydraniumGlspUndoRedoActionHandler);
+export { HydraniumGlspUndoRedoActionHandler };
+//# sourceMappingURL=hydranium-glsp-undo-redo-action-handler.js.map

package/lib/command/hydranium-glsp-undo-redo-action-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-glsp-undo-redo-action-handler.js","sourceRoot":"","sources":["../../src/command/hydranium-glsp-undo-redo-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;;;;AAElF,OAAO,EAAe,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG/C;;;;;;GAMG;AAEI,IAAM,kCAAkC,GAAxC,MAAM,kCAAmC,SAAQ,qBAAqB;IACnC,UAAU,CAAgD;IAExF,OAAO,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;CACH,CAAA;AALyC;IAAtC,MAAM,CAAC,UAAU,CAAC;;sEAA8E;AADvF,kCAAkC;IAD9C,UAAU,EAAE;GACA,kCAAkC,CAM9C"}

package/lib/command/index.d.ts

@@ -7,4 +7,9 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 export * from './hydranium-glsp-recording-command.js';
+export * from './hydranium-glsp-command-stack.js';
+export * from './hydranium-glsp-operation-action-handler.js';
+export { HydraniumGlspOperationCommand, type OperationSideEffect, type OperationTransition, type UndoRedoDirection } from './hydranium-glsp-operation-command.js';
+export * from './hydranium-glsp-undo-redo-action-handler.js';
+export * from './diagram-edit-dropped-error.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/command/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,uCAAuC,CAAC;AACtD,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,OAAO,EACJ,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACxB,MAAM,uCAAuC,CAAC;AAC/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iCAAiC,CAAC"}

package/lib/command/index.js

@@ -7,4 +7,9 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 export * from './hydranium-glsp-recording-command.js';
+export * from './hydranium-glsp-command-stack.js';
+export * from './hydranium-glsp-operation-action-handler.js';
+export { HydraniumGlspOperationCommand } from './hydranium-glsp-operation-command.js';
+export * from './hydranium-glsp-undo-redo-action-handler.js';
+export * from './diagram-edit-dropped-error.js';
 //# sourceMappingURL=index.js.map

package/lib/command/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,uCAAuC,CAAC;AACtD,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,OAAO,EACJ,6BAA6B,EAI/B,MAAM,uCAAuC,CAAC;AAC/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iCAAiC,CAAC"}

package/lib/computed-bounds/hydranium-glsp-computed-bounds-action-handler.d.ts

@@ -23,7 +23,7 @@ import { type HydraniumGlspSubmissionHandler } from '../submission/hydranium-gls
  * very first `computedBounds` arrives with a revision the server has already
  * bumped, the subsequent `SetModelAction` response never fires and the diagram
  * stays stuck at "model loading…". Adopters need this initial-handshake case
- * surfaced as a warning so the failure mode is visible in logs.
+ * logged as an error: the diagram stays empty, so the requested load failed.
  *
  * **Handshake detection** uses
  * {@link HydraniumGlspSubmissionHandler.hasPendingInitialRequest} — true

package/lib/computed-bounds/hydranium-glsp-computed-bounds-action-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydranium-glsp-computed-bounds-action-handler.d.ts","sourceRoot":"","sources":["../../src/computed-bounds/hydranium-glsp-computed-bounds-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,2BAA2B,EAC3B,KAAK,UAAU,EACf,KAAK,YAAY,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,KAAK,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AAEzG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,wCAAyC,SAAQ,2BAA2B;IACtF,mBAA2B,UAAU,EAAE,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpF,mBAA2B,iBAAiB,EAAE,8BAA8B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEtF,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;IAqBtE;;;;;;;;;;;;;;;OAeG;cACgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI;CAatF"}
+{"version":3,"file":"hydranium-glsp-computed-bounds-action-handler.d.ts","sourceRoot":"","sources":["../../src/computed-bounds/hydranium-glsp-computed-bounds-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,2BAA2B,EAC3B,KAAK,UAAU,EACf,KAAK,YAAY,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,KAAK,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AAEzG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,wCAAyC,SAAQ,2BAA2B;IACtF,mBAA2B,UAAU,EAAE,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpF,mBAA2B,iBAAiB,EAAE,8BAA8B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEtF,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAmBrE;IAED;;;;;;;;;;;;;;;OAeG;IACH,UAAmB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAYnF;CACH"}

package/lib/computed-bounds/hydranium-glsp-computed-bounds-action-handler.js

@@ -27,7 +27,7 @@ import { injectable } from 'inversify';
  * very first `computedBounds` arrives with a revision the server has already
  * bumped, the subsequent `SetModelAction` response never fires and the diagram
  * stays stuck at "model loading…". Adopters need this initial-handshake case
- * surfaced as a warning so the failure mode is visible in logs.
+ * logged as an error: the diagram stays empty, so the requested load failed.
  *
  * **Handshake detection** uses
  * {@link HydraniumGlspSubmissionHandler.hasPendingInitialRequest} — true
@@ -46,7 +46,7 @@ let HydraniumGlspComputedBoundsActionHandler = class HydraniumGlspComputedBounds
         const model = this.modelState.root;
         if (action.revision !== model.revision) {
             if (this.submissionHandler.hasPendingInitialRequest()) {
-                this.modelState.logger.warn(`ComputedBounds rejected (initial handshake): action.revision=${action.revision} model.revision=${model.revision} — ` +
+                this.modelState.logger.error(`ComputedBounds rejected (initial handshake): action.revision=${action.revision} model.revision=${model.revision} — ` +
                     'initial SetModelAction will not fire (empty diagram)');
             }
             else {

package/lib/computed-bounds/hydranium-glsp-computed-bounds-action-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"hydranium-glsp-computed-bounds-action-handler.js","sourceRoot":"","sources":["../../src/computed-bounds/hydranium-glsp-computed-bounds-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;AAElF,OAAO,EAGJ,2BAA2B,EAG7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAIvC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEI,IAAM,wCAAwC,GAA9C,MAAM,wCAAyC,SAAQ,2BAA2B;IAI7E,OAAO,CAAC,MAA4B;QAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,gEAAgE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChH,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACnC,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,EAAE,CAAC;gBACrD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CACxB,gEAAgE,MAAM,CAAC,QAAQ,mBAAmB,KAAK,CAAC,QAAQ,KAAK;oBAClH,sDAAsD,CAC3D,CAAC;YACL,CAAC;iBAAM,CAAC;gBACL,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CACzB,mDAAmD,MAAM,CAAC,QAAQ,mBAAmB,KAAK,CAAC,QAAQ,KAAK;oBACrG,sDAAsD,CAC3D,CAAC;YACL,CAAC;YACD,OAAO,EAAE,CAAC;QACb,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,MAAM,CAAC,QAAQ,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3H,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACgB,WAAW,CAAC,IAAgB,EAAE,MAA4B;QAC1E,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YACtC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1F,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CACzB,0BAA0B,OAAO,IAAI,QAAQ,uEAAuE,CACtH,CAAC;YACL,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;CACH,CAAA;AAtDY,wCAAwC;IADpD,UAAU,EAAE;GACA,wCAAwC,CAsDpD"}
+{"version":3,"file":"hydranium-glsp-computed-bounds-action-handler.js","sourceRoot":"","sources":["../../src/computed-bounds/hydranium-glsp-computed-bounds-action-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;AAElF,OAAO,EAGJ,2BAA2B,EAG7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAIvC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEI,IAAM,wCAAwC,GAA9C,MAAM,wCAAyC,SAAQ,2BAA2B;IAI7E,OAAO,CAAC,MAA4B;QAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,gEAAgE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChH,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACnC,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,EAAE,CAAC;gBACrD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CACzB,gEAAgE,MAAM,CAAC,QAAQ,mBAAmB,KAAK,CAAC,QAAQ,KAAK;oBAClH,sDAAsD,CAC3D,CAAC;YACL,CAAC;iBAAM,CAAC;gBACL,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CACzB,mDAAmD,MAAM,CAAC,QAAQ,mBAAmB,KAAK,CAAC,QAAQ,KAAK;oBACrG,sDAAsD,CAC3D,CAAC;YACL,CAAC;YACD,OAAO,EAAE,CAAC;QACb,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,MAAM,CAAC,QAAQ,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3H,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACgB,WAAW,CAAC,IAAgB,EAAE,MAA4B;QAC1E,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YACtC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1F,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CACzB,0BAA0B,OAAO,IAAI,QAAQ,uEAAuE,CACtH,CAAC;YACL,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;CACH,CAAA;AAtDY,wCAAwC;IADpD,UAAU,EAAE;GACA,wCAAwC,CAsDpD"}

package/lib/dispatcher/server-action-dispatcher.d.ts

@@ -6,47 +6,48 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import { type Action, DefaultActionDispatcher } from '@eclipse-glsp/server';
+import { type Action, CheckEdgeResultAction, DefaultActionDispatcher } from '@eclipse-glsp/server';
 import { type Tracer } from '@hydranium/protocol';
-import { type GlspClientLogger } from '../logging/glsp-client-logger.js';
 /**
- * Server-side action dispatcher with built-in traffic observability:
- * every {@link DefaultActionDispatcher.dispatch} call is wrapped in a
- * {@link Tracer.time} pair that records the dispatch direction
- * (`→ client` vs `→ server`) and timing.
+ * Server-side action dispatcher with built-in traffic observability: while
+ * debug is enabled, each {@link DefaultActionDispatcher.dispatch} call runs
+ * inside {@link Tracer.time}, which logs it with its direction (`→ client` vs
+ * `→ server`) and timing only when it is slow or fails, and an action that
+ * {@link summarize} details gets its own debug line whatever its duration.
  *
  * **Why this lives in the framework (vs left as an adopter override).**
  * Debugging GLSP state, storage, and submission flows depends heavily on
- * seeing each action with timing and direction — especially when bringing
- * up a new adopter against an empty/partial diagram before its submission
- * flow is complete. Providing this dispatcher in the framework gives every
- * adopter the same observability primitive from the very first GLSP-head
- * launch.
+ * seeing slow or failing actions with timing and direction — especially when
+ * bringing up a new adopter against an empty/partial diagram before its
+ * submission flow is complete. Providing this dispatcher in the framework
+ * gives every adopter the same observability primitive from the very first
+ * GLSP-head launch.
  *
  * **Extension points.**
  * - {@link loggedKinds} — if set, filter the log lines (the dispatch
- *   still happens; only the bracketed timing line is suppressed). Default
- *   `undefined` means **every** action's dispatch is timed and logged.
- * - {@link summarize} — return a non-empty string to append `[summary]`
- *   to the log line; default returns `''` (no extra bracket).
- *
- * Adopters bind it in a per-diagram module, as the `ActionDispatcher` service.
+ *   still happens; only its timing and summary lines are suppressed).
+ *   Default `undefined` times every action's dispatch while debug is enabled.
+ * - {@link summarize} — return a non-empty string to log it as a debug line
+ *   for the dispatch; `''` logs none.
  */
 export declare class HydraniumGlspServerActionDispatcher extends DefaultActionDispatcher {
-    /** Narrowed from `Logger`; DI binds {@link GlspClientLogger}. */
-    protected readonly logger: GlspClientLogger;
     /** Caller-tagged tracer (auto-componented with this class name, like the logger). */
     protected readonly tracer: Tracer;
     /**
-     * If set, the timing log line is emitted only when `action.kind` is in
-     * this set. Subclasses override via field reassignment.
+     * If set, the timing and summary lines are emitted only when `action.kind`
+     * is in this set. Subclasses override via field reassignment.
      */
     protected readonly loggedKinds: ReadonlySet<string> | undefined;
     /**
-     * Override to enrich the log line with payload-specific detail. Return an
-     * empty string to suppress the bracket. Default returns `''`.
+     * Payload detail logged at debug before the dispatch, as
+     * `Dispatch action '<kind>' <direction> [<summary>]`, on every dispatch,
+     * fast or slow; `''` logs no line. The default details only an action whose
+     * outcome the log otherwise loses, each through a `format*` method. Called
+     * only when debug is enabled, so it may serialise the payload.
      */
-    protected summarize(_action: Action): string;
+    protected summarize(action: Action): string;
+    /** An edge check's verdict, so the log shows whether the server let an edge tool connect. */
+    protected formatEdgeCheck(action: CheckEdgeResultAction): string;
     dispatch(action: Action): Promise<void>;
 }
 //# sourceMappingURL=server-action-dispatcher.d.ts.map

package/lib/dispatcher/server-action-dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-action-dispatcher.d.ts","sourceRoot":"","sources":["../../src/dispatcher/server-action-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,MAAM,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,mCAAoC,SAAQ,uBAAuB;IAC7E,iEAAiE;IACjE,mBAA2B,MAAM,EAAE,gBAAgB,CAAC;IAEpD,qFAAqF;IACtD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAC;IAElE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAa;IAE5E;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAInC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWlD"}
+{"version":3,"file":"server-action-dispatcher.d.ts","sourceRoot":"","sources":["../../src/dispatcher/server-action-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,MAAM,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEnG,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,mCAAoC,SAAQ,uBAAuB;IAC7E,qFAAqF;IACtD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAC;IAElE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAa;IAE5E;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1C;IAED,6FAA6F;IAC7F,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAE/D;IAEQ,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/C;CACH"}

package/lib/dispatcher/server-action-dispatcher.js

@@ -15,57 +15,69 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { DefaultActionDispatcher } from '@eclipse-glsp/server';
+import { CheckEdgeResultAction, DefaultActionDispatcher } from '@eclipse-glsp/server';
 import { inject, injectable } from 'inversify';
+import { Logger } from '@hydranium/protocol';
 import { HydraniumTypes } from '../state/hydranium-shared-core-services.js';
 /**
- * Server-side action dispatcher with built-in traffic observability:
- * every {@link DefaultActionDispatcher.dispatch} call is wrapped in a
- * {@link Tracer.time} pair that records the dispatch direction
- * (`→ client` vs `→ server`) and timing.
+ * Server-side action dispatcher with built-in traffic observability: while
+ * debug is enabled, each {@link DefaultActionDispatcher.dispatch} call runs
+ * inside {@link Tracer.time}, which logs it with its direction (`→ client` vs
+ * `→ server`) and timing only when it is slow or fails, and an action that
+ * {@link summarize} details gets its own debug line whatever its duration.
  *
  * **Why this lives in the framework (vs left as an adopter override).**
  * Debugging GLSP state, storage, and submission flows depends heavily on
- * seeing each action with timing and direction — especially when bringing
- * up a new adopter against an empty/partial diagram before its submission
- * flow is complete. Providing this dispatcher in the framework gives every
- * adopter the same observability primitive from the very first GLSP-head
- * launch.
+ * seeing slow or failing actions with timing and direction — especially when
+ * bringing up a new adopter against an empty/partial diagram before its
+ * submission flow is complete. Providing this dispatcher in the framework
+ * gives every adopter the same observability primitive from the very first
+ * GLSP-head launch.
  *
  * **Extension points.**
  * - {@link loggedKinds} — if set, filter the log lines (the dispatch
- *   still happens; only the bracketed timing line is suppressed). Default
- *   `undefined` means **every** action's dispatch is timed and logged.
- * - {@link summarize} — return a non-empty string to append `[summary]`
- *   to the log line; default returns `''` (no extra bracket).
- *
- * Adopters bind it in a per-diagram module, as the `ActionDispatcher` service.
+ *   still happens; only its timing and summary lines are suppressed).
+ *   Default `undefined` times every action's dispatch while debug is enabled.
+ * - {@link summarize} — return a non-empty string to log it as a debug line
+ *   for the dispatch; `''` logs none.
  */
 let HydraniumGlspServerActionDispatcher = class HydraniumGlspServerActionDispatcher extends DefaultActionDispatcher {
     /** Caller-tagged tracer (auto-componented with this class name, like the logger). */
     tracer;
     /**
-     * If set, the timing log line is emitted only when `action.kind` is in
-     * this set. Subclasses override via field reassignment.
+     * If set, the timing and summary lines are emitted only when `action.kind`
+     * is in this set. Subclasses override via field reassignment.
      */
     loggedKinds = undefined;
     /**
-     * Override to enrich the log line with payload-specific detail. Return an
-     * empty string to suppress the bracket. Default returns `''`.
+     * Payload detail logged at debug before the dispatch, as
+     * `Dispatch action '<kind>' <direction> [<summary>]`, on every dispatch,
+     * fast or slow; `''` logs no line. The default details only an action whose
+     * outcome the log otherwise loses, each through a `format*` method. Called
+     * only when debug is enabled, so it may serialise the payload.
      */
-    summarize(_action) {
+    summarize(action) {
+        if (CheckEdgeResultAction.is(action)) {
+            return this.formatEdgeCheck(action);
+        }
         return '';
     }
+    /** An edge check's verdict, so the log shows whether the server let an edge tool connect. */
+    formatEdgeCheck(action) {
+        return `edgeType=${action.edgeType} source=${action.sourceElementId} target=${action.targetElementId ?? 'none'} isValid=${action.isValid}`;
+    }
     dispatch(action) {
-        if (this.loggedKinds && !this.loggedKinds.has(action.kind)) {
+        if (!Logger.isLevelEnabled('debug') || (this.loggedKinds && !this.loggedKinds.has(action.kind))) {
             return super.dispatch(action);
         }
         const direction = this.clientActionForwarder.shouldForwardToClient(action) ? '→ client' : '→ server';
+        const label = `Dispatch action '${action.kind}' ${direction}`;
         const summary = this.summarize(action);
-        const label = summary
-            ? `Dispatch action '${action.kind}' ${direction} [${summary}]`
-            : `Dispatch action '${action.kind}' ${direction}`;
-        return this.tracer.time(label, () => super.dispatch(action));
+        if (summary) {
+            // Its own line: `time` is silent on a fast success.
+            this.tracer.debug(`${label} [${summary}]`);
+        }
+        return this.tracer.time(label, () => super.dispatch(action), 'debug');
     }
 };
 __decorate([

package/lib/dispatcher/server-action-dispatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-action-dispatcher.js","sourceRoot":"","sources":["../../src/dispatcher/server-action-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;;;;AAElF,OAAO,EAAe,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEI,IAAM,mCAAmC,GAAzC,MAAM,mCAAoC,SAAQ,uBAAuB;IAI7E,qFAAqF;IACnC,MAAM,CAAU;IAElE;;;OAGG;IACgB,WAAW,GAAoC,SAAS,CAAC;IAE5E;;;OAGG;IACO,SAAS,CAAC,OAAe;QAChC,OAAO,EAAE,CAAC;IACb,CAAC;IAEQ,QAAQ,CAAC,MAAc;QAC7B,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACrG,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO;YAClB,CAAC,CAAC,oBAAoB,MAAM,CAAC,IAAI,KAAK,SAAS,KAAK,OAAO,GAAG;YAC9D,CAAC,CAAC,oBAAoB,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;CACH,CAAA;AA3BoD;IAAjD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC;;mEAAoC;AALxD,mCAAmC;IAD/C,UAAU,EAAE;GACA,mCAAmC,CAgC/C"}
+{"version":3,"file":"server-action-dispatcher.js","sourceRoot":"","sources":["../../src/dispatcher/server-action-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;;;;;;;;;;AAElF,OAAO,EAAe,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEI,IAAM,mCAAmC,GAAzC,MAAM,mCAAoC,SAAQ,uBAAuB;IAC7E,qFAAqF;IACnC,MAAM,CAAU;IAElE;;;OAGG;IACgB,WAAW,GAAoC,SAAS,CAAC;IAE5E;;;;;;OAMG;IACO,SAAS,CAAC,MAAc;QAC/B,IAAI,qBAAqB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,EAAE,CAAC;IACb,CAAC;IAED,6FAA6F;IACnF,eAAe,CAAC,MAA6B;QACpD,OAAO,YAAY,MAAM,CAAC,QAAQ,WAAW,MAAM,CAAC,eAAe,WAAW,MAAM,CAAC,eAAe,IAAI,MAAM,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9I,CAAC;IAEQ,QAAQ,CAAC,MAAc;QAC7B,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC/F,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACrG,MAAM,KAAK,GAAG,oBAAoB,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,OAAO,EAAE,CAAC;YACX,oDAAoD;YACpD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,KAAK,OAAO,GAAG,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CACH,CAAA;AAxCoD;IAAjD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC;;mEAAoC;AAFxD,mCAAmC;IAD/C,UAAU,EAAE;GACA,mCAAmC,CA0C/C"}

package/lib/index.d.ts

@@ -12,6 +12,7 @@ export * from './dispatcher/index.js';
 export * from './launcher/index.js';
 export * from './logging/index.js';
 export * from './state/index.js';
+export * from './status/index.js';
 export * from './storage/index.js';
 export * from './submission/index.js';
 export * from './util/index.js';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/lib/index.js

@@ -13,6 +13,7 @@ export * from './dispatcher/index.js';
 export * from './launcher/index.js';
 export * from './logging/index.js';
 export * from './state/index.js';
+export * from './status/index.js';
 export * from './storage/index.js';
 export * from './submission/index.js';
 export * from './util/index.js';

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,2EAA2E;AAC3E,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,2EAA2E;AAC3E,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}