@attraccess/plugin-wago 0.1.0-nightly.1005.1 → 0.1.0-nightly.1009.1

package/dist/index.js

@@ -48140,12 +48140,12 @@ var require_auditTime = __commonJS({
     var async_1 = require_async();
     var audit_1 = require_audit();
     var timer_1 = require_timer();
-    function auditTime(duration, scheduler) {
+    function auditTime(duration2, scheduler) {
       if (scheduler === void 0) {
         scheduler = async_1.asyncScheduler;
       }
       return audit_1.audit(function() {
-        return timer_1.timer(duration, scheduler);
+        return timer_1.timer(duration2, scheduler);
       });
     }
     exports2.auditTime = auditTime;
@@ -49118,9 +49118,9 @@ var require_delay = __commonJS({
       if (scheduler === void 0) {
         scheduler = async_1.asyncScheduler;
       }
-      var duration = timer_1.timer(due, scheduler);
+      var duration2 = timer_1.timer(due, scheduler);
       return delayWhen_1.delayWhen(function() {
-        return duration;
+        return duration2;
       });
     }
     exports2.delay = delay;
@@ -49546,13 +49546,13 @@ var require_groupBy = __commonJS({
     var Subject_1 = require_Subject();
     var lift_1 = require_lift();
     var OperatorSubscriber_1 = require_OperatorSubscriber();
-    function groupBy(keySelector, elementOrOptions, duration, connector) {
+    function groupBy(keySelector, elementOrOptions, duration2, connector) {
       return lift_1.operate(function(source, subscriber) {
         var element;
         if (!elementOrOptions || typeof elementOrOptions === "function") {
           element = elementOrOptions;
         } else {
-          duration = elementOrOptions.duration, element = elementOrOptions.element, connector = elementOrOptions.connector;
+          duration2 = elementOrOptions.duration, element = elementOrOptions.element, connector = elementOrOptions.connector;
         }
         var groups = /* @__PURE__ */ new Map();
         var notify = function(cb) {
@@ -49574,14 +49574,14 @@ var require_groupBy = __commonJS({
               groups.set(key_1, group_1 = connector ? connector() : new Subject_1.Subject());
               var grouped = createGroupedObservable(key_1, group_1);
               subscriber.next(grouped);
-              if (duration) {
+              if (duration2) {
                 var durationSubscriber_1 = OperatorSubscriber_1.createOperatorSubscriber(group_1, function() {
                   group_1.complete();
                   durationSubscriber_1 === null || durationSubscriber_1 === void 0 ? void 0 : durationSubscriber_1.unsubscribe();
                 }, void 0, void 0, function() {
                   return groups.delete(key_1);
                 });
-                groupBySourceSubscriber.add(innerFrom_1.innerFrom(duration(grouped)).subscribe(durationSubscriber_1));
+                groupBySourceSubscriber.add(innerFrom_1.innerFrom(duration2(grouped)).subscribe(durationSubscriber_1));
               }
             }
             group_1.next(element ? element(value) : value);
@@ -51102,11 +51102,11 @@ var require_throttleTime = __commonJS({
     var async_1 = require_async();
     var throttle_1 = require_throttle();
     var timer_1 = require_timer();
-    function throttleTime(duration, scheduler, config) {
+    function throttleTime(duration2, scheduler, config) {
       if (scheduler === void 0) {
         scheduler = async_1.asyncScheduler;
       }
-      var duration$ = timer_1.timer(duration, scheduler);
+      var duration$ = timer_1.timer(duration2, scheduler);
       return throttle_1.throttle(function() {
         return duration$;
       }, config);
@@ -52496,8 +52496,8 @@ function supportsOutputAction(channel, action) {
 }
 function pulseBehaviorError(capabilities, pulse) {
   if (!capabilities.includes("pulse") && pulse === void 0) return void 0;
-  const duration = pulse && typeof pulse === "object" && !Array.isArray(pulse) ? pulse.durationMs : void 0;
-  if (!capabilities.includes("output") || !capabilities.includes("pulse") || typeof duration !== "number" || !Number.isSafeInteger(duration) || duration <= 0)
+  const duration2 = pulse && typeof pulse === "object" && !Array.isArray(pulse) ? pulse.durationMs : void 0;
+  if (!capabilities.includes("output") || !capabilities.includes("pulse") || typeof duration2 !== "number" || !Number.isSafeInteger(duration2) || duration2 <= 0)
     return "Pulsed behavior requires output and pulse capabilities and a positive integer durationMs.";
   return void 0;
 }
@@ -52952,7 +52952,13 @@ function validateModbus(value) {
     });
   });
   config.devices.forEach((d, i) => {
-    keys(d, ["id", "name", "connectionId", "unitId", "profileId", "profileVersion"], `modbus.devices[${i}]`);
+    keys(
+      d,
+      ["id", "name", "connectionId", "unitId", "profileId", "profileVersion", "pollIntervalMs"],
+      `modbus.devices[${i}]`
+    );
+    if (d.pollIntervalMs !== void 0 && !integer(d.pollIntervalMs, 100, 36e5))
+      fail(`modbus.devices[${i}].pollIntervalMs`, "device polling interval must be 100..3600000 ms");
     if (!name(d.name) || !integer(d.unitId, 1, 247) || !config.connections.some((c) => c.id === d.connectionId) || !findProfile(config, d))
       fail(`modbus.devices[${i}]`, "device requires name, unit 1..247, existing connection and exact profile version");
   });
@@ -53146,6 +53152,7 @@ function validateSnapshot(snapshot) {
         "physicalPointId",
         "profile",
         "capabilities",
+        "invert",
         "disconnectPolicy",
         "range",
         "pulse",
@@ -53159,6 +53166,12 @@ function validateSnapshot(snapshot) {
       errors.push(referenceError(`${path}.physicalPointId`, "physical point", channel.physicalPointId));
     enumValue(channel.profile, `${path}.profile`, CHANNEL_PROFILES, errors);
     const capabilities = capabilityList(channel.capabilities, `${path}.capabilities`, errors);
+    if (channel.invert !== void 0 && (typeof channel.invert !== "boolean" || !capabilities.has("input")))
+      errors.push({
+        path: `${path}.invert`,
+        code: "invalid_invert",
+        message: "invert requires a boolean and an input channel"
+      });
     validateDisconnectPolicy(channel.disconnectPolicy, `${path}.disconnectPolicy`, errors);
     validateRange(channel.range, `${path}.range`, capabilities, errors);
     validatePulse(channel.pulse, `${path}.pulse`, capabilities, errors);
@@ -53210,7 +53223,7 @@ function exactKeys(value, path, allowed, errors, optional = []) {
     })
   );
   allowed.filter(
-    (key) => !["range", "pulse", "guard", "feedback", "measurement", ...optional].includes(key) && !(key in value)
+    (key) => !["range", "pulse", "guard", "feedback", "measurement", "invert", ...optional].includes(key) && !(key in value)
   ).forEach(
     (key) => errors.push({
       path: path === "$" ? key : `${path}.${key}`,
@@ -53418,13 +53431,18 @@ function wagoAuditDetails(input) {
   for (const key of ["revision", "sourceRevision"]) {
     if (positiveInteger(input[key])) details[key] = input[key];
   }
-  if (typeof input.profileId === "string" && input.profileId.length <= 160 && input.profileId.trim()) details.profileId = input.profileId;
-  if (positiveInteger(input.profileVersion) && input.profileVersion <= 1e6) details.profileVersion = input.profileVersion;
+  if (typeof input.profileId === "string" && input.profileId.length <= 160 && input.profileId.trim())
+    details.profileId = input.profileId;
+  if (positiveInteger(input.profileVersion) && input.profileVersion <= 1e6)
+    details.profileVersion = input.profileVersion;
   if (WAGO_PRESETS.some((preset) => preset.id === input.presetId)) details.presetId = input.presetId;
-  if (typeof input.channelId === "string" && /^[a-zA-Z0-9_-]{1,64}$/.test(input.channelId)) details.channelId = input.channelId;
-  if (typeof input.commandId === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(input.commandId)) details.commandId = input.commandId;
-  if (["set", "pulse"].includes(input.operation)) details.operation = input.operation;
-  if (["dispatched", "acknowledged", "rejected", "timeout", "transport_failure"].includes(input.result)) details.result = input.result;
+  if (typeof input.channelId === "string" && /^[a-zA-Z0-9_-]{1,64}$/.test(input.channelId))
+    details.channelId = input.channelId;
+  if (typeof input.commandId === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(input.commandId))
+    details.commandId = input.commandId;
+  if (["set", "pulse", "release"].includes(input.operation)) details.operation = input.operation;
+  if (["dispatched", "acknowledged", "rejected", "timeout", "transport_failure"].includes(input.result))
+    details.result = input.result;
   for (const side of ["before", "after"]) {
     for (const key of ["physicalPointCount", "logicalChannelCount"]) {
       const count = input[side]?.[key];
@@ -53452,12 +53470,15 @@ var WagoAudit = class {
   }
   /** For owners with asynchronous dispatch/ack lifecycles. Finish exactly once after the true outcome. */
   begin(principal, controllerId, action, details = {}) {
-    if (!positiveInteger(controllerId) || !WAGO_AUDIT_ACTIONS.includes(action)) throw new import_common2.BadRequestException("Invalid WAGO audit subject or action");
-    const actor = wagoAuditPrincipal({ user: {
-      id: principal.userId,
-      authenticationMethod: principal.authenticationMethod,
-      apiTokenId: principal.apiTokenId
-    } });
+    if (!positiveInteger(controllerId) || !WAGO_AUDIT_ACTIONS.includes(action))
+      throw new import_common2.BadRequestException("Invalid WAGO audit subject or action");
+    const actor = wagoAuditPrincipal({
+      user: {
+        id: principal.userId,
+        authenticationMethod: principal.authenticationMethod,
+        apiTokenId: principal.apiTokenId
+      }
+    });
     const operationId = (0, import_node_crypto3.randomUUID)();
     const initial = wagoAuditDetails(details);
     let attempted;
@@ -53911,6 +53932,66 @@ WagoConfigurationRevision = __decorateClass([
 // backend/wago-command-handler.ts
 var import_node_crypto4 = require("node:crypto");
 var import_plugins_backend_sdk7 = require("@attraccess/plugins-backend-sdk");
+
+// backend/wago-flow-preview.ts
+var WAGO_FLOW_PREVIEW_SCHEMA = { dynamic: true, type: "object", properties: {}, preview: [] };
+function wagoFlowPreview(config, kind, controller, snapshot, names) {
+  const english = localizedPreview(config, kind, controller, snapshot, names, false);
+  const german = localizedPreview(config, kind, controller, snapshot, names, true);
+  return english.map((row, index) => ({ ...row, translations: { de: german[index] } }));
+}
+function localizedPreview(config, kind, controller, snapshot, names, german) {
+  const text = (english, translated) => german ? translated : english;
+  const channel = snapshot?.logicalChannels.find((item) => item.id === config.channelId);
+  const point = snapshot?.physicalPoints?.find((item) => item.id === channel?.physicalPointId);
+  let channelName = channel ? typeof names[channel.id] === "string" ? String(names[channel.id]) : channel.id : typeof config.channelId === "string" ? `${config.channelId} (${text("unavailable", "nicht verf\xFCgbar")})` : text("Not selected", "Nicht ausgew\xE4hlt");
+  if (point?.modbus) {
+    const device = snapshot?.modbus?.devices.find((item) => item.id === point.modbus?.deviceId);
+    if (device) channelName = `${channelName} \xB7 ${device.name}`;
+  } else if (point?.hardwareProfile === "751-9301") {
+    const terminal = DIGITAL_TERMINALS.find((item) => item.channel === point.channel)?.label;
+    if (terminal && !channelName.includes(terminal)) channelName += ` \xB7 ${terminal}`;
+  }
+  const rows = [
+    {
+      label: text("Device", "Ger\xE4t"),
+      value: controller?.name || controller?.hardwareId || (typeof config.controllerId === "number" ? `Controller ${config.controllerId} (${text("unavailable", "nicht verf\xFCgbar")})` : text("Not selected", "Nicht ausgew\xE4hlt"))
+    },
+    { label: text("Channel", "Kanal"), value: channelName }
+  ];
+  if (kind === "command") {
+    const action = config.action === "set" ? config.value === true ? text("Turn ON", "Einschalten") : config.value === false ? text("Turn OFF", "Ausschalten") : text("Select ON/OFF", "EIN/AUS ausw\xE4hlen") : config.action === "pulse" ? `${text("Pulse", "Impuls")}${channel?.pulse ? ` \xB7 ${duration(channel.pulse.durationMs)}` : ""}` : text("Not selected", "Nicht ausgew\xE4hlt");
+    return [...rows, { label: text("Action", "Aktion"), value: action }];
+  }
+  const category = config.category === "measurement" ? text("Measurement", "Messwert") : config.category === "fault" ? text("Fault", "Fehler") : config.category === "state" ? channel?.capabilities.includes("input") ? text("Input state", "Eingangszustand") : text("Output state", "Ausgangszustand") : void 0;
+  if (kind === "event")
+    return [
+      ...rows,
+      {
+        label: text("When", "Wenn"),
+        value: category ? `${category} ${text("received", "empfangen")}` : text("Not selected", "Nicht ausgew\xE4hlt")
+      }
+    ];
+  if (kind === "read")
+    return [...rows, { label: text("Read", "Lesen"), value: category ?? text("Not selected", "Nicht ausgew\xE4hlt") }];
+  const expected = typeof config.equals === "boolean" ? config.equals ? text("ON", "EIN") : text("OFF", "AUS") : typeof config.equals === "number" && Number.isFinite(config.equals) ? `${config.equals} (${text("wire value", "Rohwert")})` : text("Not set", "Nicht festgelegt");
+  return [
+    ...rows,
+    {
+      label: text("Wait for", "Warten auf"),
+      value: `${category ?? text("Not selected", "Nicht ausgew\xE4hlt")} = ${expected}`
+    },
+    {
+      label: text("Timeout", "Zeitlimit"),
+      value: duration(typeof config.timeoutMs === "number" ? config.timeoutMs : 3e4)
+    }
+  ];
+}
+function duration(milliseconds) {
+  return milliseconds < 1e3 ? `${milliseconds} ms` : `${milliseconds / 1e3} s`;
+}
+
+// backend/wago-command-handler.ts
 var DEFAULT_COMMAND_TIMEOUT_SECONDS = 30;
 var MAX_COMMAND_TIMEOUT_SECONDS = 300;
 var WagoCommandError = class extends Error {
@@ -53925,10 +54006,10 @@ var WagoCommandHandler = class {
     __publicField(this, "dependencies", dependencies);
     __publicField(this, "pending", /* @__PURE__ */ new Map());
   }
-  async channelNames(controllerId, revision2) {
+  async channelNames(controllerId, revision2, appliedOnly = false) {
     let names = {};
     if (controllerId) {
-      const draft = await this.dependencies.context.getRepository(WagoConfigurationDraft).findOneBy({ controllerId });
+      const draft = appliedOnly ? null : await this.dependencies.context.getRepository(WagoConfigurationDraft).findOneBy({ controllerId });
       try {
         const storedNames = JSON.parse(revision2?.presetProvenance ?? draft?.presetProvenance ?? "null")?.editor?.names;
         if (storedNames && typeof storedNames === "object" && !Array.isArray(storedNames)) names = storedNames;
@@ -53937,14 +54018,30 @@ var WagoCommandHandler = class {
     }
     return names;
   }
-  async schema(config, resourceId) {
-    const controllers = await this.dependencies.controllers().find({ where: { trustState: "claimed" }, order: { name: "ASC" } });
+  async schema(config, resourceId, previewOnly = false) {
     const controllerId = positiveInteger2(config.controllerId);
+    const controllers = previewOnly && !controllerId ? [] : await this.dependencies.controllers().find({
+      where: { trustState: "claimed", ...previewOnly ? { id: controllerId } : {} },
+      order: { name: "ASC" }
+    });
     const revision2 = controllerId ? await this.dependencies.appliedRevision(controllerId) : null;
     const snapshot = revision2 ? JSON.parse(revision2.snapshot) : null;
     const channelId2 = typeof config.channelId === "string" ? config.channelId : void 0;
     const outputChannels = snapshot?.logicalChannels.filter((item) => item.capabilities.includes("output")) ?? [];
-    const names = await this.channelNames(controllerId, revision2);
+    const names = await this.channelNames(controllerId, revision2, previewOnly);
+    if (previewOnly)
+      return {
+        dynamic: true,
+        type: "object",
+        properties: {},
+        preview: wagoFlowPreview(
+          config,
+          "command",
+          controllers.find((item) => item.id === controllerId),
+          snapshot,
+          names
+        )
+      };
     const channel = outputChannels.find((item) => item.id === channelId2);
     const references = channelId2 && controllerId ? await this.references(controllerId, channelId2, resourceId) : [];
     const properties = {
@@ -54024,6 +54121,13 @@ var WagoCommandHandler = class {
     return {
       dynamic: true,
       type: "object",
+      preview: wagoFlowPreview(
+        config,
+        "command",
+        controllers.find((item) => item.id === controllerId),
+        snapshot,
+        names
+      ),
       properties,
       required: [
         .../* @__PURE__ */ new Set([
@@ -54036,8 +54140,8 @@ var WagoCommandHandler = class {
       ]
     };
   }
-  async validate(config, validationContext = /* @__PURE__ */ new Map()) {
-    const parsed = this.parse(config);
+  async validate(config, validationContext = /* @__PURE__ */ new Map(), manual = false) {
+    const parsed = this.parse(config, manual);
     if ("errors" in parsed) return parsed.errors;
     const { controllerId, channelId: channelId2, action, expectedConfigurationRevision } = parsed.value;
     const controller = await this.cached(
@@ -54065,7 +54169,7 @@ var WagoCommandHandler = class {
     if (!channel) return [{ field: "channelId", message: "The selected Logical Channel no longer exists." }];
     if (!channel.capabilities.includes("output"))
       return [{ field: "channelId", message: "The selected Logical Channel no longer supports output commands." }];
-    if (!supportsOutputAction(channel, action))
+    if (action !== "release" && !supportsOutputAction(channel, action))
       return [
         {
           field: "action",
@@ -54074,11 +54178,11 @@ var WagoCommandHandler = class {
       ];
     return [];
   }
-  async execute(config, commandId = (0, import_node_crypto4.randomUUID)()) {
-    const errors = await this.validate(config);
+  async execute(config, commandId = (0, import_node_crypto4.randomUUID)(), source) {
+    const errors = await this.validate(config, /* @__PURE__ */ new Map(), source === "manual");
     if (errors.length)
       throw new WagoCommandError(errors.map((error) => error.message).join(" "), "controller-rejection");
-    const parsed = this.parse(config);
+    const parsed = this.parse(config, source === "manual");
     if ("errors" in parsed)
       throw new WagoCommandError(parsed.errors.map((error) => error.message).join(" "), "controller-rejection");
     const {
@@ -54102,6 +54206,7 @@ var WagoCommandHandler = class {
       channelId: channelId2,
       action,
       ...action === "set" ? { value } : {},
+      ...source ? { source } : {},
       expectedConfigurationRevision
     });
     const acknowledgement = completionBehavior === "acknowledged" ? this.waitForAcknowledgement(id, controllerId, acknowledgementTimeoutSeconds) : void 0;
@@ -54170,12 +54275,12 @@ var WagoCommandHandler = class {
     const nodes = await this.dependencies.context.dataSource.getRepository(import_plugins_backend_sdk7.ResourceFlowNode).createQueryBuilder("node").select(["node.id", "node.resourceId"]).where("node.type = :type", { type: "plugin.wago.command" }).andWhere("node.resourceId <> :resourceId", { resourceId }).andWhere("node.data ->> 'controllerId' = :controllerId", { controllerId }).andWhere("node.data ->> 'channelId' = :channelId", { channelId: channelId2 }).getMany();
     return nodes.map((node) => `resource ${node.resourceId} / node ${node.id}`);
   }
-  parse(config) {
+  parse(config, manual = false) {
     const errors = [];
     const controllerId = positiveInteger2(config.controllerId);
     const expectedConfigurationRevision = positiveInteger2(config.expectedConfigurationRevision);
     const channelId2 = typeof config.channelId === "string" && config.channelId.trim() ? config.channelId : void 0;
-    const action = config.action === "set" || config.action === "pulse" ? config.action : void 0;
+    const action = config.action === "set" || config.action === "pulse" || manual && config.action === "release" ? config.action : void 0;
     const completionBehavior = config.completionBehavior === "dispatch" ? "dispatch" : "acknowledged";
     const parsedTimeout = positiveInteger2(config.acknowledgementTimeoutSeconds);
     const acknowledgementTimeoutSeconds = parsedTimeout ?? DEFAULT_COMMAND_TIMEOUT_SECONDS;
@@ -54375,7 +54480,9 @@ var faultCodes = /* @__PURE__ */ new Set([
   "measurement_read_failed",
   "device_write_failed",
   "feedback_mismatch",
-  "feedback_read_failed"
+  "feedback_read_failed",
+  "modbus_read_failed",
+  "digital_read_failed"
 ]);
 function identifier(value) {
   return typeof value === "string" && value.trim().length > 0 && value.length <= 256 && !Array.from(value).some((character) => character.charCodeAt(0) < 32);
@@ -54384,6 +54491,8 @@ function isObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function validStatePayload(data, kind, canonical) {
+  if (kind === "state" && data.manualOutputChannelIds !== void 0 && (!Array.isArray(data.manualOutputChannelIds) || data.manualOutputChannelIds.length > MAX_CHANNELS || !data.manualOutputChannelIds.every(identifier)))
+    return false;
   if (canonical && kind === "state" && data.readiness !== void 0 && (!isObject(data.readiness) || data.readiness.hardwareAvailable !== void 0 && typeof data.readiness.hardwareAvailable !== "boolean"))
     return false;
   if (canonical && kind === "state" && !(data.contentHash === null || typeof data.contentHash === "string" && /^[0-9a-f]{64}$/i.test(data.contentHash)))
@@ -54556,6 +54665,7 @@ var WagoDiagnosticsStore = class {
         state.rejection = void 0;
         state.hardwareAvailable = void 0;
         state.stateSourceAt = void 0;
+        state.manualOutputChannelIds = void 0;
         state.revision = void 0;
         state.contentHash = void 0;
       }
@@ -54586,6 +54696,7 @@ var WagoDiagnosticsStore = class {
     state.contentHash = contentHash;
     state.hardwareAvailable = hardwareAvailable;
     state.stateSourceAt = canonical ? data.timestamp : void 0;
+    state.manualOutputChannelIds = canonical && Array.isArray(data.manualOutputChannelIds) ? data.manualOutputChannelIds : void 0;
     if (data.outputs && typeof data.outputs === "object" && !Array.isArray(data.outputs)) {
       for (const [channelId2, value] of Object.entries(data.outputs).slice(0, MAX_CHANNELS)) {
         if (identifier(channelId2) && typeof value === "boolean")
@@ -54597,6 +54708,9 @@ var WagoDiagnosticsStore = class {
         if (identifier(channelId2) && typeof value === "boolean")
           state.inputs[channelId2] = { kind: "input", value, ...metadata2 };
       }
+    for (const id of [...Object.keys(state.outputs), ...Object.keys(state.inputs)]) {
+      if (["modbus_read_failed", "digital_read_failed"].includes(state.faults[id]?.code)) delete state.faults[id];
+    }
   }
   applyEvents(id, state, kind, data, canonical, metadata2) {
     const { receivedAt } = metadata2;
@@ -54708,8 +54822,8 @@ var WagoService = class {
     if (this.subscriptionRetryTimer) clearTimeout(this.subscriptionRetryTimer);
     this.commands.destroy();
   }
-  async commandSchema(config, resourceId) {
-    return this.commands.schema(config, resourceId);
+  async commandSchema(config, resourceId, previewOnly = false) {
+    return this.commands.schema(config, resourceId, previewOnly);
   }
   async validateCommandConfig(config, validationContext = /* @__PURE__ */ new Map()) {
     return this.commands.validate(config, validationContext);
@@ -54724,7 +54838,7 @@ var WagoService = class {
     if (typeof input.channelId !== "string" || !/^[A-Za-z0-9_-]{1,64}$/.test(input.channelId))
       throw new import_common3.BadRequestException("Invalid Logical Channel");
     const config = { ...input, controllerId, completionBehavior: "acknowledged" };
-    const errors = await this.commands.validate(config);
+    const errors = await this.commands.validate(config, /* @__PURE__ */ new Map(), true);
     if (errors.length) throw new import_common3.BadRequestException("Manual command does not match the applied configuration");
     const commandId = (0, import_node_crypto5.randomUUID)();
     const details = { commandId, channelId: input.channelId, operation: input.action };
@@ -54732,7 +54846,7 @@ var WagoService = class {
     await lifecycle.attempt();
     let result;
     try {
-      await this.commands.execute(config, commandId);
+      await this.commands.execute(config, commandId, "manual");
       result = "acknowledged";
     } catch (error) {
       result = error instanceof WagoCommandError ? error.kind === "controller-rejection" ? "rejected" : error.kind === "acknowledgement-timeout" ? "timeout" : "transport_failure" : "transport_failure";
@@ -56645,11 +56759,11 @@ async function commissionClock(execute, confirmInstall, report, now = Date.now,
     const start = monotonic();
     const observed = parseSample(await execute(CLOCK_INSPECTION_SCRIPT, CLOCK_LIMITS));
     const received = now();
-    const duration = monotonic() - start;
-    if (!validEpoch(Math.floor(received / 1e3)) || duration < 0 || duration > 4e3 || Math.abs(received - hostStarted - (monotonic() - started)) > 1e3)
+    const duration2 = monotonic() - start;
+    if (!validEpoch(Math.floor(received / 1e3)) || duration2 < 0 || duration2 > 4e3 || Math.abs(received - hostStarted - (monotonic() - started)) > 1e3)
       throw new Error("Application clock changed or controller clock observation expired.");
-    const host = received - duration / 2;
-    const uncertaintySeconds = Math.ceil(duration / 2e3) + 1;
+    const host = received - duration2 / 2;
+    const uncertaintySeconds = Math.ceil(duration2 / 2e3) + 1;
     const skew = observed.epoch - Math.floor(host / 1e3);
     if (Math.abs(skew) > MAX_SKEW_SECONDS)
       throw new Error("Controller clock skew exceeds the supported ten-year bound.");
@@ -62407,6 +62521,11 @@ var WagoDiagnosticsService = class {
       incompatible: !!controller.compatibilityError,
       ...runtimeStreamSummary(runtime),
       configuration: configurationSummary(draft, latest, applied, runtime, revisionMismatch),
+      manualOutputChannelIds: connected && !revisionMismatch && freshness(runtime.stateSourceAt) === "fresh" ? (runtime.manualOutputChannelIds ?? []).filter(
+        (id) => appliedSnapshot?.logicalChannels.some(
+          (channel) => channel.id === id && channel.capabilities.includes("output")
+        )
+      ) : [],
       hardwareReadiness: "unknown",
       hardwareReadinessReason: "Reported hardware availability is shown when supplied; it does not prove physical I/O readiness. Applied configuration and cached output state are not physical proof.",
       channels: ((appliedSnapshot ?? snapshot)?.logicalChannels ?? []).slice(0, 256).map((channel) => {
@@ -62486,10 +62605,11 @@ function createWagoCommandNode(service) {
     type: WAGO_COMMAND_NODE_TYPE,
     label: "WAGO command",
     description: "Control a configured WAGO Logical Channel.",
+    configSchema: WAGO_FLOW_PREVIEW_SCHEMA,
     inputs: ["input"],
     outputs: ["output", "failure"],
     isOutput: true,
-    resolveConfigSchema: (config, schemaContext) => service().commandSchema(config, schemaContext.resourceId),
+    resolveConfigSchema: (config, schemaContext) => service().commandSchema(config, schemaContext.resourceId, schemaContext.purpose === "preview"),
     validateConfig: (config, validationContext) => service().validateCommandConfig(config, validationContext),
     getFailureBehavior: (config) => service().commandFailureBehavior(config),
     getFailureKind: (error) => service().commandFailureKind(error),
@@ -62511,19 +62631,21 @@ function createWagoStateNodes(service) {
       type: WAGO_EVENT_NODE_TYPE,
       label: "WAGO event received",
       description: "Start a flow when a channel reports state, a measurement, or a fault. Data is available in wago.",
+      configSchema: WAGO_FLOW_PREVIEW_SCHEMA,
       isInput: true,
       inputs: [],
       outputs: ["output"],
-      resolveConfigSchema: (config) => service().resolveConfigSchema(config, "event"),
+      resolveConfigSchema: (config, context) => service().resolveConfigSchema(config, "event", void 0, context.purpose === "preview"),
       validateConfig: (config, context) => service().validateConfig(config, "event", context)
     },
     {
       type: "plugin.wago.read-state",
       label: "WAGO read state",
       description: "Read the latest channel state or measurement into wago. Unavailable data uses the unavailable output.",
+      configSchema: WAGO_FLOW_PREVIEW_SCHEMA,
       inputs: ["input"],
       outputs: ["output", "unavailable"],
-      resolveConfigSchema: (config) => service().resolveConfigSchema(config, "read"),
+      resolveConfigSchema: (config, context) => service().resolveConfigSchema(config, "read", void 0, context.purpose === "preview"),
       validateConfig: (config, context) => service().validateConfig(config, "read", context),
       execute: async (node, input) => {
         const state = service().read(node.data);
@@ -62535,9 +62657,10 @@ function createWagoStateNodes(service) {
       type: "plugin.wago.wait-for-state",
       label: "WAGO wait for state",
       description: "Wait for an available channel value to match, then continue with the value in wago.",
+      configSchema: WAGO_FLOW_PREVIEW_SCHEMA,
       inputs: ["input"],
       outputs: ["output", "timeout"],
-      resolveConfigSchema: (config) => service().resolveConfigSchema(config, "wait"),
+      resolveConfigSchema: (config, context) => service().resolveConfigSchema(config, "wait", void 0, context.purpose === "preview"),
       validateConfig: (config, context) => service().validateConfig(config, "wait", context),
       execute: async (node, input) => {
         const state = await service().wait(node.data);
@@ -62669,11 +62792,15 @@ var WagoFlowService = class {
     this.subscriptions.push(...replacements);
     this.controllerByHardwareId = controllerByHardwareId;
   }
-  async resolveConfigSchema(config, kind, validationContext = /* @__PURE__ */ new Map()) {
+  async resolveConfigSchema(config, kind, validationContext = /* @__PURE__ */ new Map(), previewOnly = false) {
+    const controllerCacheKey = previewOnly ? `wago-flow-controllers:preview:${config.controllerId}` : "wago-flow-controllers";
     const controllers = await this.cached(
       validationContext,
-      "wago-flow-controllers",
-      () => this.controllers.find({ where: { trustState: "claimed" }, order: { name: "ASC" } })
+      controllerCacheKey,
+      () => previewOnly && typeof config.controllerId !== "number" ? Promise.resolve([]) : this.controllers.find({
+        where: { trustState: "claimed", ...previewOnly ? { id: config.controllerId } : {} },
+        order: { name: "ASC" }
+      })
     );
     const selected = typeof config.controllerId === "number" ? controllers.find((controller) => controller.id === config.controllerId) : void 0;
     const revision2 = selected ? await this.cached(validationContext, `wago-applied-revision:${selected.id}`, async () => {
@@ -62684,12 +62811,19 @@ var WagoFlowService = class {
       });
       return latest ?? null;
     }) : null;
-    const channels = revision2 ? JSON.parse(revision2.snapshot).logicalChannels : [];
+    const snapshot = revision2 ? JSON.parse(revision2.snapshot) : null;
+    const channels = snapshot?.logicalChannels ?? [];
     let names = {};
     try {
       names = JSON.parse(revision2?.presetProvenance ?? "null")?.editor?.names ?? {};
     } catch {
     }
+    if (previewOnly) return {
+      dynamic: true,
+      type: "object",
+      properties: {},
+      preview: wagoFlowPreview(config, kind, selected, snapshot, names)
+    };
     const channel = channels.find((item) => item.id === config.channelId);
     const properties = {
       controllerId: {
@@ -62745,6 +62879,7 @@ var WagoFlowService = class {
     return {
       dynamic: true,
       type: "object",
+      preview: wagoFlowPreview(config, kind, selected, snapshot, names),
       properties,
       required: ["controllerId", "channelId", "category", ...kind === "wait" ? ["equals", "timeoutMs"] : []]
     };
@@ -63128,7 +63263,7 @@ var controllerActions = [
     details: {
       channelId,
       commandId: { type: "string", pattern: uuidPattern2 },
-      operation: { type: "string", oneOf: ["set", "pulse"] },
+      operation: { type: "string", oneOf: ["set", "pulse", "release"] },
       result: { type: "string", oneOf: ["dispatched", "acknowledged", "rejected", "timeout", "transport_failure"] }
     }
   }