@revenexx/studio-integrations 3.4.0 → 3.5.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @revenexx/studio-integrations
 
+## 3.5.0
+
+### Minor Changes
+
+- 06a52b1: The studio takes `@revenexx/studio-shared` 0.4.1, so the filter menu of every list counts each option over the rows the other applied filters leave — a count is what a click on it will show — and a list with no filters draws no Filter button.
+  
+  Two more things change with that release:
+  
+  - Every tab bar — a workflow's Editor, History and Runs, the node dialog, the create-workflow and credential dialogs, Runs and Missed runs — is now a set of real tabs: a screen reader announces them as tabs, and the arrow keys move between them.
+  - The Missed runs tab no longer shows how many firings are waiting, because the shared tab bar shows no counts on tabs. The dashboard's Needs attention panel still does.
+
+### Patch Changes
+
+- fa29ad1: The studio takes `@revenexx/studio-shared` 0.4.2, so after a page loads the first Tab reaches *Skip to content* again. With 0.4.1 the sidebar scrolled to the current page in a way that, in Chrome, sent the first Tab past the skip link to the sidebar link after the current page, or into the page.
+
+## 3.4.1
+
+### Patch Changes
+
+- 3e92677: The "Use revenexx API Keys" panel now shows the cockpit's active tenant — the project chosen in its top bar — and no longer lets it be changed. The cockpit mints a key only under that tenant, so picking another one used to label the credential with a tenant the key did not belong to. With no active tenant the panel says to choose a project first and offers no key to mint. The SFTP offer keeps its free tenant choice.
+
 ## 3.4.0
 
 ### Minor Changes

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@revenexx/studio-integrations",
   "configKey": "studioIntegrations",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "unknown"

package/dist/runtime/components/Integrations/CredentialRevenexxSource.vue

@@ -85,7 +85,8 @@ async function ensureLists() {
   loadingList.value = true;
   try {
     await loadTenants();
-    if (!tenant.value) tenant.value = onlyTenantSlug.value ?? tenants.value[0]?.slug ?? null;
+    if (kind.value === "api") tenant.value = onlyTenantSlug.value;
+    else if (!tenant.value) tenant.value = onlyTenantSlug.value ?? tenants.value[0]?.slug ?? null;
     if (kind.value === "sftp") await sftp.load(tenant.value);
     else if (kind.value === "smtp") {
       const list = await mail.listCredentials();
@@ -179,6 +180,9 @@ function onSelect(id) {
   if (kind.value === "sftp") void applySftp();
   else if (kind.value === "smtp") void applySmtp();
 }
+watch(onlyTenantSlug, (slug) => {
+  if (active.value && kind.value === "api") tenant.value = slug;
+});
 watch([tenant, marketCode], () => {
   if (active.value && kind.value === "api" && apiKeyReady.value) {
     emit("apply", { tenant: tenant.value ?? "", market: marketSlug() });
@@ -303,8 +307,8 @@ function submitCreate() {
       <!-- Tenant (preselected) -->
       <div class="space-y-1.5">
         <Label :for="`${uid}-tenant`">{{ t("integration.credentials.revenexxSource.field.tenant.label") }}</Label>
-        <Select :model-value="tenant ?? ''" @update:model-value="(v) => tenant = v">
-          <SelectTrigger :id="`${uid}-tenant`" class="bg-white">
+        <Select :model-value="tenant ?? ''" :disabled="kind === 'api'" @update:model-value="(v) => tenant = v">
+          <SelectTrigger :id="`${uid}-tenant`" class="bg-white" :aria-describedby="kind === 'api' ? `${uid}-tenant-hint` : void 0">
             <SelectValue :placeholder="t('integration.credentials.revenexxSource.field.tenant.placeholder')" />
           </SelectTrigger>
           <SelectContent>
@@ -313,6 +317,9 @@ function submitCreate() {
             </SelectItem>
           </SelectContent>
         </Select>
+        <p v-if="kind === 'api'" :id="`${uid}-tenant-hint`" class="text-xs text-muted-foreground">
+          {{ tenant ? t("integration.credentials.revenexxSource.field.tenant.hint.api") : t("integration.credentials.revenexxSource.field.tenant.hint.apiNone") }}
+        </p>
       </div>
 
       <!-- Market scope — only the Revenexx API credential is market-scoped -->

package/dist/runtime/components/Integrations/NodeInspector.vue

@@ -28,7 +28,7 @@ import {
   ToggleGroupItem
 } from "@revenexx/studio";
 import EventTypeCombobox from "./EventTypeCombobox.vue";
-import { findManifest, nodeCategoryLabel, isVersionExecutable, newestExecutableVersion, executableVersionsOf, newerExecutableVersions } from "../../data/integrationNodeCatalog";
+import { channelManifestOf, findManifest, isChannelPin, nodeCategoryLabel, isVersionExecutable, newestExecutableVersion, executableVersionsOf, newerExecutableVersions } from "../../data/integrationNodeCatalog";
 import NodeVersionMoveDialog from "./NodeVersionMoveDialog.vue";
 import {
   collectUpstreamNodes,
@@ -131,6 +131,7 @@ const newerVersions = computed(() => {
 const canMoveVersion = computed(() => {
   const wn = draftNode.value;
   if (!wn) return false;
+  if (isChannelPin(wn.nodeVersion)) return true;
   const runnable = executableVersionsOf(wn.nodeSlug);
   if (!runnable.length) return false;
   return runnable.length > 1 || runnable[0]?.version !== wn.nodeVersion;
@@ -151,6 +152,10 @@ const namePlaceholder = computed(() => {
 });
 const subtitleText = computed(() => {
   const wn = draftNode.value;
+  if (wn && isChannelPin(wn.nodeVersion)) {
+    const current = channelManifestOf(wn.nodeSlug)?.version;
+    return wn.nodeSlug + " \xB7 " + (current ? t("integration.common.nodeVersion.channelCurrent", { version: current }) : t("integration.common.nodeVersion.channel"));
+  }
   if (wn) return wn.nodeSlug + "@" + wn.nodeVersion;
   return t("integration.nodeInspector.trigger.placeholder", { type: TRIGGER_LABELS.value[draftTrigger.value?.type ?? "manual"] });
 });
@@ -1387,7 +1392,9 @@ async function runTestStep() {
           v-if="isNode && !versionExecutable"
           class="mx-4 mb-1 shrink-0 rounded-md border border-rose-200 bg-rose-50 px-2.5 py-1.5 text-sm text-rose-700"
         >
-          {{ readyVersion ? t("integration.nodeInspector.notice.versionNotReady.upgrade", { version: draftNode?.nodeVersion ?? "", ready: readyVersion }) : t("integration.nodeInspector.notice.versionNotReady.none", { version: draftNode?.nodeVersion ?? "" }) }}
+          <!-- A step on the channel has no number to name: what it lacks is a
+               version on the channel (MAR-4075). -->
+          {{ isChannelPin(draftNode?.nodeVersion ?? "") ? t("integration.nodeInspector.version.move.channelUnavailable") : readyVersion ? t("integration.nodeInspector.notice.versionNotReady.upgrade", { version: draftNode?.nodeVersion ?? "", ready: readyVersion }) : t("integration.nodeInspector.notice.versionNotReady.none", { version: draftNode?.nodeVersion ?? "" }) }}
           <!-- The sentence named a version and led nowhere (PO-339). It leads
                here now; where the node has no runnable version at all there is
                still nothing to offer, and the notice stays the statement it

package/dist/runtime/components/Integrations/NodePalette.vue

@@ -3,7 +3,7 @@ import { computed, ref, watch } from "vue";
 import { AltArrowLeft as ArrowLeft, Bolt as Zap, Magnifier as Search } from "#solar-icons";
 import { triggerGlyph } from "../../data/triggerGlyphs";
 import * as Lucide from "lucide-vue-next";
-import { INTEGRATION_NODE_CATALOG, isOffered, NODE_CATEGORIES, TRIGGER_TEMPLATES } from "../../data/integrationNodeCatalog";
+import { CHANNEL_VERSION, channelManifestOf, INTEGRATION_NODE_CATALOG, isCandidate, isChannelPin, isOffered, NODE_CATEGORIES, offersChannel, TRIGGER_TEMPLATES } from "../../data/integrationNodeCatalog";
 import { resolveLocalized, studioLocale } from "../../utils/localize";
 import { orderFolderLeaves, orderFolders } from "../../utils/paletteOrder";
 import { declaredFolderIcon } from "../../utils/folderMark";
@@ -93,6 +93,7 @@ const latestManifests = computed(() => {
   const out = [];
   for (const m of INTEGRATION_NODE_CATALOG) {
     if (seen.has(m.slug) || !isExecutable(m)) continue;
+    if (isCandidate(m) && INTEGRATION_NODE_CATALOG.some((o) => o.slug === m.slug && isExecutable(o) && !isCandidate(o))) continue;
     seen.add(m.slug);
     out.push(m);
   }
@@ -117,13 +118,18 @@ function setSelectedVersion(slug, version) {
 }
 function effVersion(m) {
   const sel = selectedVersion.value[m.slug];
+  if (isChannelPin(sel)) return offersChannel(m.slug) ? CHANNEL_VERSION : m.version;
   return sel && versionsOf(m.slug).some((v) => v.version === sel) ? sel : m.version;
 }
 function effManifest(m) {
   const v = effVersion(m);
+  if (isChannelPin(v)) return channelManifestOf(m.slug) ?? m;
   if (v === m.version) return m;
   return versionsOf(m.slug).find((x) => x.version === v) ?? m;
 }
+function versionOptionLabel(v) {
+  return isCandidate(v) ? t("integration.common.nodeVersion.candidate", { version: v.version }) : `v${v.version}`;
+}
 const tree = computed(() => {
   const apps = makeGroup("Integrations");
   const core = makeGroup("Core");
@@ -264,7 +270,7 @@ function onVersionSelectLeave(ev) {
 function onManifestDragStart(leaf, ev) {
   if (!ev.dataTransfer) return;
   const m = effManifest(leaf);
-  ev.dataTransfer.setData("application/integration-node", JSON.stringify({ kind: "manifest", slug: m.slug, version: m.version }));
+  ev.dataTransfer.setData("application/integration-node", JSON.stringify({ kind: "manifest", slug: m.slug, version: effVersion(leaf) }));
   ev.dataTransfer.effectAllowed = "move";
   setCustomDragImage(ev, resolveLocalized(m.name), logoSrcOf(m), "#8b5cf6");
   nodeDrag.start({ kind: "manifest", manifest: m });
@@ -281,7 +287,7 @@ function onDragEnd() {
 }
 function insertManifest(leaf) {
   const m = effManifest(leaf);
-  emit("insert", { kind: "manifest", slug: m.slug, version: m.version });
+  emit("insert", { kind: "manifest", slug: m.slug, version: effVersion(leaf) });
 }
 function insertTrigger(tpl) {
   emit("insert", { kind: "trigger", type: tpl.type });
@@ -408,9 +414,10 @@ const searching = computed(() => search.value.trim().length > 0);
                         @focus="paletteDragEnabled = false"
                         @blur="paletteDragEnabled = true"
                       >
-                        <option v-for="v in versionsOf(hit.manifest.slug)" :key="v.version" :value="v.version">v{{ v.version }}</option>
+                        <option v-if="offersChannel(hit.manifest.slug)" :value="CHANNEL_VERSION">{{ t("integration.common.nodeVersion.channel") }}</option>
+                        <option v-for="v in versionsOf(hit.manifest.slug)" :key="v.version" :value="v.version">{{ versionOptionLabel(v) }}</option>
                       </select>
-                      <span v-else class="shrink-0 text-xs tabular-nums text-muted-foreground/60">v{{ hit.manifest.version }}</span>
+                      <span v-else class="shrink-0 text-xs tabular-nums text-muted-foreground/60">{{ versionOptionLabel(hit.manifest) }}</span>
                     </div>
                     <div class="text-xs leading-snug text-muted-foreground">{{ resolveLocalized(hit.manifest.description) }}</div>
                     <div class="truncate text-xs text-muted-foreground/70">{{ hit.path.join(" \u203A ") }}</div>
@@ -546,9 +553,10 @@ const searching = computed(() => search.value.trim().length > 0);
                     @focus="paletteDragEnabled = false"
                     @blur="paletteDragEnabled = true"
                   >
-                    <option v-for="v in versionsOf(m.slug)" :key="v.version" :value="v.version">v{{ v.version }}</option>
+                    <option v-if="offersChannel(m.slug)" :value="CHANNEL_VERSION">{{ t("integration.common.nodeVersion.channel") }}</option>
+                    <option v-for="v in versionsOf(m.slug)" :key="v.version" :value="v.version">{{ versionOptionLabel(v) }}</option>
                   </select>
-                  <span v-else class="shrink-0 text-xs tabular-nums text-muted-foreground/60">v{{ m.version }}</span>
+                  <span v-else class="shrink-0 text-xs tabular-nums text-muted-foreground/60">{{ versionOptionLabel(m) }}</span>
                 </div>
                 <div class="text-xs leading-snug text-muted-foreground">{{ resolveLocalized(m.description) }}</div>
               </div>

package/dist/runtime/components/Integrations/NodeVersionMoveDialog.vue

@@ -9,7 +9,16 @@ import {
   AlertDialogTitle,
   Button
 } from "@revenexx/studio";
-import { executableVersionsOf, findManifest, newestExecutableVersion } from "../../data/integrationNodeCatalog";
+import {
+  CHANNEL_VERSION,
+  channelManifestOf,
+  executableVersionsOf,
+  findManifest,
+  isCandidate,
+  isChannelPin,
+  newestExecutableVersion,
+  offersChannel
+} from "../../data/integrationNodeCatalog";
 import { planVersionMove } from "../../data/nodeVersionMove";
 import { resolveLocalized } from "../../utils/localize";
 const open = defineModel("open", { type: Boolean, ...{ default: false } });
@@ -22,9 +31,25 @@ const versions = computed(() => props.node ? executableVersionsOf(props.node.nod
 const target = ref("");
 watch(open, (isOpen) => {
   if (!isOpen || !props.node) return;
+  if (isChannelPin(props.node.nodeVersion)) {
+    target.value = CHANNEL_VERSION;
+    return;
+  }
   const newest = newestExecutableVersion(props.node.nodeSlug);
   target.value = newest && newest !== props.node.nodeVersion ? newest : props.node.nodeVersion;
 });
+const channelManifest = computed(() => props.node ? channelManifestOf(props.node.nodeSlug) : null);
+const targetManifest = computed(() => props.node ? findManifestExact(props.node.nodeSlug, target.value) : null);
+const channelOffered = computed(() => !!props.node && (offersChannel(props.node.nodeSlug) || isChannelPin(props.node.nodeVersion)));
+const channelUnavailable = computed(() => isChannelPin(target.value) && channelManifest.value === null);
+function versionLabel(version) {
+  if (!isChannelPin(version)) return `v${version}`;
+  const current = channelManifest.value?.version;
+  return current ? t("integration.common.nodeVersion.channelCurrent", { version: current }) : t("integration.common.nodeVersion.channel");
+}
+function optionLabel(m) {
+  return isCandidate(m) ? t("integration.common.nodeVersion.candidate", { version: m.version }) : `v${m.version}`;
+}
 const plan = computed(() => {
   const n = props.node;
   if (!n) return null;
@@ -35,16 +60,18 @@ const plan = computed(() => {
   );
 });
 function findManifestExact(slug, version) {
+  if (isChannelPin(version)) return channelManifestOf(slug);
   const m = findManifest(slug, version);
   return m && m.version === version ? m : null;
 }
 const unchanged = computed(() => !props.node || target.value === props.node.nodeVersion);
+const blocked = computed(() => unchanged.value || channelUnavailable.value);
 function labelOf(entry) {
   return resolveLocalized(entry.field?.label) || entry.key;
 }
 function confirm() {
   const p = plan.value;
-  if (!props.node || !p || unchanged.value) return;
+  if (!props.node || !p || blocked.value) return;
   emit("move", { version: target.value, config: p.nextConfig });
   open.value = false;
 }
@@ -64,19 +91,32 @@ function confirm() {
 
       <div v-if="props.node && plan" class="space-y-3 text-sm">
         <div class="flex items-center gap-2">
-          <span class="tabular-nums text-muted-foreground">v{{ props.node.nodeVersion }}</span>
+          <span class="tabular-nums text-muted-foreground">{{ versionLabel(props.node.nodeVersion) }}</span>
           <span aria-hidden="true">→</span>
           <select
             v-model="target"
             class="rounded border border-black/10 bg-white px-1.5 py-0.5 tabular-nums"
             :aria-label="t('integration.nodeInspector.version.move.targetAria')"
           >
+            <option v-if="channelOffered" :value="CHANNEL_VERSION">
+              {{ t("integration.common.nodeVersion.channel") }}
+            </option>
             <option v-for="m in versions" :key="m.version" :value="m.version">
-              v{{ m.version }}
+              {{ optionLabel(m) }}
             </option>
           </select>
         </div>
 
+        <p v-if="channelUnavailable" class="text-amber-600">
+          {{ t("integration.nodeInspector.version.move.channelUnavailable") }}
+        </p>
+        <p v-else-if="isChannelPin(target) && !unchanged" class="text-muted-foreground">
+          {{ t("integration.nodeInspector.version.move.channelHint") }}
+        </p>
+        <p v-else-if="!isChannelPin(target) && isCandidate(targetManifest)" class="text-amber-600">
+          {{ t("integration.nodeInspector.version.move.candidateHint") }}
+        </p>
+
         <!-- A version the catalogue no longer carries cannot be compared against,
              so the lists below are what arrives rather than what was checked. Said
              once, here, instead of marking every setting as suspect. -->
@@ -88,7 +128,7 @@ function confirm() {
           {{ t("integration.nodeInspector.version.move.same") }}
         </p>
 
-        <template v-else>
+        <template v-else-if="!channelUnavailable">
           <p v-if="plan.lossless" class="text-muted-foreground">
             {{ t("integration.nodeInspector.version.move.lossless") }}
           </p>
@@ -124,7 +164,7 @@ function confirm() {
         <Button variant="outline" @click="open = false">
           {{ t("integration.common.action.cancel") }}
         </Button>
-        <Button :disabled="unchanged" @click="confirm">
+        <Button :disabled="blocked" @click="confirm">
           {{ t("integration.nodeInspector.version.move.confirm") }}
         </Button>
       </AlertDialogFooter>

package/dist/runtime/components/Integrations/WorkflowEditor.vue

@@ -49,7 +49,7 @@ import { toast } from "vue-sonner";
 import WorkflowEdgeView from "./WorkflowEdgeView.vue";
 import { layoutWorkflowNodes } from "./workflowLayout";
 import { defaultsFor } from "../../utils/configDefaults";
-import { TRIGGER_TEMPLATES, findManifest, triggerTypeLabel } from "../../data/integrationNodeCatalog";
+import { CHANNEL_VERSION, TRIGGER_TEMPLATES, findManifest, isChannelPin, triggerTypeLabel } from "../../data/integrationNodeCatalog";
 import { collectUpstreamNodes, isTerminalManifest, portsForNode } from "../../data/nodeInputData";
 import { computeLoopBodies, iteratorNodeIds, nodeLoopData } from "../../data/loopBody";
 import { canvasShapes } from "../../data/canvasShapes";
@@ -1111,7 +1111,7 @@ function addFromPayload(payload, pos) {
   blob.value.nodes.push({
     id,
     nodeSlug: manifest.slug,
-    nodeVersion: manifest.version,
+    nodeVersion: pinnedVersion(payload.version, manifest),
     config: defaultsFor(manifest.config ?? []),
     position: at
   });
@@ -1156,7 +1156,7 @@ function onPaletteInsert(payload) {
     blob.value.nodes.push({
       id,
       nodeSlug: manifest.slug,
-      nodeVersion: manifest.version,
+      nodeVersion: pinnedVersion(payload.version, manifest),
       config: defaultsFor(manifest.config ?? []),
       position: { x: pc.pos.x, y: pc.pos.y }
     });
@@ -1194,6 +1194,9 @@ function primaryOutputName(slug, version) {
   const m = findManifest(slug, version);
   return (m?.outputs ?? []).find((o) => o.name && o.kind !== "error")?.name ?? "default";
 }
+function pinnedVersion(chosen, manifest) {
+  return isChannelPin(chosen) ? CHANNEL_VERSION : manifest.version;
+}
 function spliceIntoEdge(edgeId, payload) {
   const edge = blob.value.edges.find((e) => e.id === edgeId);
   const manifest = findManifest(payload.slug, payload.version);
@@ -1208,7 +1211,7 @@ function spliceIntoEdge(edgeId, payload) {
   const inserted = {
     id,
     nodeSlug: manifest.slug,
-    nodeVersion: manifest.version,
+    nodeVersion: pinnedVersion(payload.version, manifest),
     config: defaultsFor(manifest.config ?? []),
     position: { x: snap((a.x + b.x) / 2), y: snap((a.y + b.y) / 2) }
   };

package/dist/runtime/components/Integrations/WorkflowNodeView.vue

@@ -4,7 +4,7 @@ import { Handle, Position, useVueFlow } from "@vue-flow/core";
 import { NodeToolbar } from "@vue-flow/node-toolbar";
 import * as Lucide from "lucide-vue-next";
 import { Copy, DangerTriangle as AlertTriangle, RefreshCircle as Loader2, Repeat, TrashBinMinimalistic as TrashBin } from "#solar-icons";
-import { NODE_CATEGORIES, findManifest, isVersionExecutable } from "../../data/integrationNodeCatalog";
+import { NODE_CATEGORIES, channelManifestOf, findManifest, isChannelPin, isVersionExecutable } from "../../data/integrationNodeCatalog";
 import { inputHandleId, outputHandleId } from "../../data/handleId";
 import { branchLineText } from "../../data/canvasShapes";
 import { joinRefusalText } from "../../data/refusalMessage";
@@ -23,6 +23,11 @@ defineOptions({ inheritAttrs: false });
 defineEmits(["updateNodeInternals"]);
 const t = useIntegrationsT();
 const manifest = computed(() => findManifest(props.data.nodeSlug, props.data.nodeVersion));
+const versionChip = computed(() => {
+  if (!isChannelPin(props.data.nodeVersion)) return `v${props.data.nodeVersion}`;
+  const channel = channelManifestOf(props.data.nodeSlug);
+  return channel ? t("integration.canvas.node.meta.channel", { version: channel.version }) : t("integration.canvas.node.meta.channelNone");
+});
 const category = computed(() => NODE_CATEGORIES.find((c) => c.key === manifest.value?.category));
 const title = computed(() => nodeDisplayName(props.data));
 const fromPackage = computed(() => manifest.value?.__package ? packageLabel(manifest.value.__package) : null);
@@ -584,7 +589,7 @@ function remove() {
           <span
             class="shrink-0 text-[10px] font-medium leading-none tabular-nums text-muted-foreground/55"
             :title="t('integration.canvas.node.meta.versionTitle', { version: data.nodeVersion })"
-          >v{{ data.nodeVersion }}</span>
+          >{{ versionChip }}</span>
         </div>
       </div>
     </div>

package/dist/runtime/composables/useIntegrationsNodes.js

@@ -54,7 +54,12 @@ export function useIntegrationsNodes() {
         __retired: n.retired === true,
         // The package's own order, which the palette falls back to inside a
         // folder (PO-537). Null and absent both mean "not recorded".
-        __packagePosition: typeof n.package_position === "number" ? n.package_position : void 0
+        __packagePosition: typeof n.package_position === "number" ? n.package_position : void 0,
+        // Where the version stands in its approval, and whether the tenant's
+        // release channel runs it (MAR-4075). Missing fields = released, and
+        // the catalogue works out the channel's version on its own.
+        __releaseState: n.release_state === "candidate" || n.release_state === "approved" ? n.release_state : null,
+        __channelVersion: n.channel_version === true ? true : void 0
       }));
       applyNodeCatalog(manifests);
       level.value = request === "summary" && res?.fields === "summary" ? "summary" : "full";

package/dist/runtime/data/integrationNodeCatalog.d.ts

@@ -59,6 +59,36 @@ export declare const TRIGGER_TYPE_WORDS: readonly ["manual", "schedule", "webhoo
  * key itself on screen, because a missing message resolves to its own name.
  */
 export declare function triggerTypeLabel(type: TriggerType | string | null | undefined): string;
+/**
+ * The pin a step carries to follow the tenant's release channel instead of a
+ * version number (MAR-4075). The platform resolves it per tenant when it builds
+ * the workflow; the definition keeps saying `channel`.
+ */
+export declare const CHANNEL_VERSION = "channel";
+/** Whether a step's version is the channel pin rather than a number. */
+export declare function isChannelPin(version: string | null | undefined): boolean;
+/**
+ * Whether this version is a candidate: built, and only given to tenants on the
+ * candidate release channel while it is tested (MAR-4075). A host that names no
+ * state reads as released.
+ */
+export declare function isCandidate(m: NodeManifest | null | undefined): boolean;
+/**
+ * The version a step pinned to `channel` runs for this tenant, or `null` when the
+ * catalogue has none.
+ *
+ * The platform marks it (`channel_version`). A host that does not falls back to
+ * the rule the platform itself falls back to: the newest offered version that is
+ * not a candidate.
+ */
+export declare function channelManifestOf(slug: string): NodeManifest | null;
+/**
+ * Whether the release channel is a choice to offer for this node: the platform
+ * marked which version a `channel` step runs. A platform that marks none
+ * predates the channel pin and would refuse a save carrying it, so the studio
+ * offers it nowhere (MAR-4075).
+ */
+export declare function offersChannel(slug: string): boolean;
 /**
  * Whether this exact node version can be executed — its code was built, so
  * `execute:test` and `config:resolve` will not be refused (PO-338).
@@ -87,6 +117,10 @@ export declare function isOffered(m: NodeManifest): boolean;
  * within a slug, so the first executable entry is the newest one. `null` where the
  * whole node is unusable — then there is nothing to point at and the surface says
  * only what is wrong.
+ *
+ * A candidate is never what a surface suggests (MAR-4075): it is a version under
+ * test, chosen deliberately or not at all. Only where a node has nothing but
+ * candidates is the newest of them the answer.
  */
 export declare function newestExecutableVersion(slug: string): string | null;
 /**

package/dist/runtime/data/integrationNodeCatalog.js

@@ -26,7 +26,26 @@ export function triggerTypeLabel(type) {
   if (!TRIGGER_TYPE_WORD_SET.has(kind)) return kind;
   return useIntegrationsT()(`integration.common.triggerType.${kind}`);
 }
+export const CHANNEL_VERSION = "channel";
+export function isChannelPin(version) {
+  return version === CHANNEL_VERSION;
+}
+export function isCandidate(m) {
+  return m?.__releaseState === "candidate";
+}
+export function channelManifestOf(slug) {
+  const versions = INTEGRATION_NODE_CATALOG.filter((m) => m.slug === slug);
+  return versions.find((m) => m.__channelVersion === true) ?? versions.find((m) => isOffered(m) && !isCandidate(m)) ?? null;
+}
+export function offersChannel(slug) {
+  return INTEGRATION_NODE_CATALOG.some((m) => m.slug === slug && m.__channelVersion === true && isOffered(m));
+}
 export function isVersionExecutable(slug, version) {
+  if (isChannelPin(version)) {
+    if (!INTEGRATION_NODE_CATALOG.some((m) => m.slug === slug)) return true;
+    const channel = channelManifestOf(slug);
+    return channel ? channel.__hasBundle !== false : false;
+  }
   const exact = INTEGRATION_NODE_CATALOG.find((m) => m.slug === slug && m.version === version);
   return exact ? exact.__hasBundle !== false : true;
 }
@@ -34,20 +53,22 @@ export function isOffered(m) {
   return m.__hasBundle !== false && m.__retired !== true;
 }
 export function newestExecutableVersion(slug) {
-  const hit = INTEGRATION_NODE_CATALOG.find((m) => m.slug === slug && isOffered(m));
-  return hit?.version ?? null;
+  const offered = INTEGRATION_NODE_CATALOG.filter((m) => m.slug === slug && isOffered(m));
+  return (offered.find((m) => !isCandidate(m)) ?? offered[0])?.version ?? null;
 }
 export function executableVersionsOf(slug) {
   return INTEGRATION_NODE_CATALOG.filter((m) => m.slug === slug && isOffered(m));
 }
 export function newerExecutableVersions(slug, version) {
+  if (isChannelPin(version)) return [];
   const built = INTEGRATION_NODE_CATALOG.filter((m) => m.slug === slug && m.__hasBundle !== false);
   const at = built.findIndex((m) => m.version === version);
-  return at < 0 ? [] : built.slice(0, at).filter(isOffered);
+  return at < 0 ? [] : built.slice(0, at).filter((m) => isOffered(m) && !isCandidate(m));
 }
 export function findManifest(slug, version) {
   const matches = INTEGRATION_NODE_CATALOG.filter((m) => m.slug === slug);
   if (!matches.length) return null;
+  if (isChannelPin(version)) return channelManifestOf(slug) ?? matches[0] ?? null;
   if (version) return matches.find((m) => m.version === version) ?? matches[0] ?? null;
   return matches[0] ?? null;
 }

package/dist/runtime/i18n/messages/de.json

@@ -94,6 +94,8 @@
   "integration.canvas.node.handle.virtualConverging": "Zusammenführung, nur gezeichnet: der Zweig, der ankommt",
   "integration.canvas.node.handle.virtualMerger": "Merger, nur gezeichnet: wartet auf alle Zweige",
   "integration.canvas.node.meta.versionTitle": "Version {version}",
+  "integration.canvas.node.meta.channel": "Kanal · v{version}",
+  "integration.canvas.node.meta.channelNone": "Kanal · keine Version",
   "integration.canvas.node.note.heading": "Notiz",
   "integration.canvas.node.port.outputFallback": "Ausgang",
   "integration.canvas.node.port.resolving": "Ports",
@@ -170,6 +172,9 @@
   "integration.common.triggerType.manual": "Manuell",
   "integration.common.triggerType.schedule": "Zeitplan",
   "integration.common.triggerType.webhook": "Webhook",
+  "integration.common.nodeVersion.channel": "Kanal (folgt dem Release-Kanal)",
+  "integration.common.nodeVersion.candidate": "v{version} (Kandidat)",
+  "integration.common.nodeVersion.channelCurrent": "Kanal · derzeit v{version}",
   "integration.credentials.createDialog.action.changeType": "Typ ändern",
   "integration.credentials.createDialog.description": "Erstellen Sie Zugangsdaten für diesen Node, ohne den Editor zu verlassen.",
   "integration.credentials.createDialog.error.create": "Zugangsdaten konnten nicht erstellt werden.",
@@ -252,6 +257,8 @@
   "integration.credentials.revenexxSource.field.resource.placeholder": "Auswählen",
   "integration.credentials.revenexxSource.field.resource.sftpLabel": "SFTP-Konto",
   "integration.credentials.revenexxSource.field.tenant.label": "Mandant",
+  "integration.credentials.revenexxSource.field.tenant.hint.api": "Das Cockpit erstellt den Key für das oben in der Leiste gewählte Projekt, daher lässt sich der Mandant hier nicht ändern.",
+  "integration.credentials.revenexxSource.field.tenant.hint.apiNone": "Bitte zuerst oben in der Cockpit-Leiste ein Projekt wählen — der Key wird für dieses Projekt erstellt.",
   "integration.credentials.revenexxSource.field.tenant.placeholder": "Mandant auswählen",
   "integration.credentials.revenexxSource.hint.available": "Eine vorhandene revenexx-Ressource wiederverwenden, statt Zugangsdaten von Hand einzugeben.",
   "integration.credentials.revenexxSource.hint.unavailable": "Hier nicht verfügbar — die verwalteten revenexx-Ressourcen befinden sich im Cockpit. Bitte stattdessen die Zugangsdaten von Hand eingeben.",
@@ -905,6 +912,9 @@
   "integration.nodeInspector.version.move.targetAria": "Version, auf die dieser Schritt wechselt",
   "integration.nodeInspector.version.move.title": "Version dieses Schritts wechseln",
   "integration.nodeInspector.version.moveTo": "Auf Version {version} wechseln",
+  "integration.nodeInspector.version.move.candidateHint": "Diese Version ist ein Kandidat und wird noch getestet. Nur Mandanten im Kandidaten-Kanal erhalten sie. Wählen Sie sie nur, wenn Sie sie gezielt ausprobieren möchten.",
+  "integration.nodeInspector.version.move.channelHint": "Der Schritt läuft dann mit der Version, die der Release-Kanal Ihres Mandanten vorgibt, und wechselt mit, wenn sich der Kanal ändert. Die Einstellungen werden mit der Version verglichen, die der Kanal heute vorgibt.",
+  "integration.nodeInspector.version.move.channelUnavailable": "Auf Ihrem Release-Kanal ist noch keine Version dieses Nodes verfügbar, deshalb kann der Schritt ihm nicht folgen.",
   "integration.nodes.category.action": "Aktionen",
   "integration.nodes.category.control": "Ablaufsteuerung",
   "integration.nodes.category.io": "I/O",

package/dist/runtime/i18n/messages/en.json

@@ -94,6 +94,8 @@
   "integration.canvas.node.handle.virtualConverging": "Converging input, drawn only: whichever of these branches arrives",
   "integration.canvas.node.handle.virtualMerger": "Merger, drawn only: waits for every branch",
   "integration.canvas.node.meta.versionTitle": "Version {version}",
+  "integration.canvas.node.meta.channel": "channel · v{version}",
+  "integration.canvas.node.meta.channelNone": "channel · no version",
   "integration.canvas.node.note.heading": "Note",
   "integration.canvas.node.port.outputFallback": "out",
   "integration.canvas.node.port.resolving": "Ports",
@@ -170,6 +172,9 @@
   "integration.common.triggerType.manual": "Manual",
   "integration.common.triggerType.schedule": "Schedule",
   "integration.common.triggerType.webhook": "Webhook",
+  "integration.common.nodeVersion.channel": "Channel (follows release channel)",
+  "integration.common.nodeVersion.candidate": "v{version} (candidate)",
+  "integration.common.nodeVersion.channelCurrent": "Channel · currently v{version}",
   "integration.credentials.createDialog.action.changeType": "Change type",
   "integration.credentials.createDialog.description": "Create a credential for this node without leaving the editor.",
   "integration.credentials.createDialog.error.create": "Could not create credential.",
@@ -252,6 +257,8 @@
   "integration.credentials.revenexxSource.field.resource.placeholder": "Select one",
   "integration.credentials.revenexxSource.field.resource.sftpLabel": "SFTP account",
   "integration.credentials.revenexxSource.field.tenant.label": "Tenant",
+  "integration.credentials.revenexxSource.field.tenant.hint.api": "The cockpit creates the key for the project chosen in its top bar, so this tenant cannot be changed here.",
+  "integration.credentials.revenexxSource.field.tenant.hint.apiNone": "Choose a project in the cockpit’s top bar first — the key is created for that project.",
   "integration.credentials.revenexxSource.field.tenant.placeholder": "Select tenant",
   "integration.credentials.revenexxSource.hint.available": "Reuse an existing revenexx resource instead of typing access data by hand.",
   "integration.credentials.revenexxSource.hint.unavailable": "Not available here — the managed revenexx resources live in the cockpit. Enter the access data by hand instead.",
@@ -905,6 +912,9 @@
   "integration.nodeInspector.version.move.targetAria": "Version to change this step to",
   "integration.nodeInspector.version.move.title": "Change this step's version",
   "integration.nodeInspector.version.moveTo": "Change to version {version}",
+  "integration.nodeInspector.version.move.candidateHint": "This version is a candidate: it is still being tested and only reaches tenants on the candidate release channel. Pin it only to try it out.",
+  "integration.nodeInspector.version.move.channelHint": "The step will run whichever version your tenant's release channel gives it, and move along when the channel changes. The settings are compared against the version the channel runs today.",
+  "integration.nodeInspector.version.move.channelUnavailable": "No version of this node is available on your release channel yet, so the step cannot follow it.",
   "integration.nodes.category.action": "Actions",
   "integration.nodes.category.control": "Control flow",
   "integration.nodes.category.io": "I/O",

package/dist/runtime/pages/integrations/runs.vue

@@ -14,7 +14,6 @@ const { runs, loading, error, load, query, setQuery, narrowedTotal } = useIntegr
 const {
   globalItems: missed,
   globalLoading: missedLoading,
-  pendingCount,
   globalPage: missedPage,
   globalLastPage: missedLastPage,
   goGlobalPage,
@@ -54,7 +53,7 @@ const tab = ref(route.query.tab === "missed" ? "missed" : "runs");
 const tabs = computed(() => [
   { key: "runs", label: t("integration.runs.tabs.runs.label") },
   // "Missed runs": trigger firings that never became a run (dead letters).
-  { key: "missed", label: t("integration.deadLetters.tabs.missed.label"), badge: pendingCount.value || null }
+  { key: "missed", label: t("integration.deadLetters.tabs.missed.label") }
 ]);
 const POLL_MS = 3e3;
 const hasActiveRuns = computed(() => runs.value.some((r) => r.status === "running" || r.status === "queued"));

package/dist/runtime/types/integrations.d.ts

@@ -465,6 +465,20 @@ export interface NodeManifest {
      * platform refuses a save that newly uses it.
      */
     __retired?: boolean;
+    /**
+     * Where this version stands in its package's approval (editor-side enrichment
+     * from `GET /nodes`; not manifest data, MAR-4075): `candidate` for a build only
+     * tenants on the candidate release channel are given, `approved` for a released
+     * one. Absent or `null` on a host that does not report it, which reads as
+     * released.
+     */
+    __releaseState?: 'approved' | 'candidate' | null;
+    /**
+     * Whether this is the version a step pinned to `channel` runs for the tenant
+     * (editor-side enrichment from `GET /nodes`, MAR-4075). Absent on a host that
+     * does not report it; the catalogue then works the answer out itself.
+     */
+    __channelVersion?: boolean;
 }
 export interface SecretRecord {
     key: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revenexx/studio-integrations",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "type": "module",
   "description": "Integration Studio (core: workflows, node editor, runs, schedules, credentials, secrets, audit) as a standalone, publishable Nuxt module.",
   "repository": {
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "@nuxt/kit": "^4.0.0",
-    "@revenexx/studio-shared": "^0.3.2",
+    "@revenexx/studio-shared": "^0.4.2",
     "@solar-icons/nuxt": "^1.2.0",
     "@solar-icons/vue": "^1.2.0",
     "dompurify": "^3.4.16",