cpi-saper-dev-mcp 0.9.0-beta.0 → 0.9.0-beta.1

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes of the `cpi-saper-dev-mcp` server. Versions follow [semantic versioning](https://semver.org/);
 before 1.0, names and behaviour may still change between versions.
 
+## 0.9.0-beta.1 (2026-11-04)
+
+### Added
+
+- `iflow_edit`: local integration processes: `add_local_process`, `remove_local_process`, Process Call and Looping
+  Process Call with `insert_step` `process` (and `loop` for the looping one); `layout` handles iFlows with several
+  processes (one pool per process, stacked); a branching edit lays out only its own process.
+- `iflow_validate`: calls pointing to no local process, a looping call without its loop, unquoted values in Camel loop
+  conditions.
+- `iflow_edit` `set_start`: timer start (scheduled iFlow) or back to a message start. The schedule is always
+  externalized (parameter of type `custom:schedule`): run once, every n minutes or hours, or a cron schedule, with
+  start, end and time zone. `params_set` and `cpi_config_set` take schedule objects; `iflow_validate` warns about a
+  timer whose schedule is not externalized.
+
 ## 0.9.0-beta.0 (2026-11-02)
 
 First public beta. **For development tenants only**: do not connect a production tenant (see the README).
@@ -39,6 +53,6 @@ Read-only and development roles per tenant, allowed packages, confirmation of ch
 
 - Tried against one tenant (a BTP trial); other tenants may answer differently in places
   ([docs/KNOWN_LIMITATIONS.md](docs/KNOWN_LIMITATIONS.md) lists every difference found).
-- iFlows with local integration processes cannot be laid out or branched by `iflow_edit`.
+- iFlows with local integration processes cannot be laid out or branched by `iflow_edit` (added in 0.9.0-beta.1).
 - Not offered by design: creating or deleting packages, editing message mappings, managing locks.
 - Planned: `lint`, PNG rendering, user roles for sender authorization.

package/README.md

@@ -62,7 +62,7 @@ adds no generic file tools.
 
 | Tool | What it does | Status |
 |---|---|---|
-| `iflow_edit` | Semantic edits in one all-or-nothing batch: insert a step from the catalog (with settings, headers, properties; for XSLT and message mappings the mapping file, for a Filter its XPath, for a script step a script from a script collection), remove a step, add or remove an adapter (sender to a start event or Poll Enrich, receiver from Request Reply, Send, Content Enricher or an end event; the Sender/Receiver box is reused or created, receivers drawn below their step), add or remove an exception subprocess (steps go inside like anywhere else), add routers (conditions, default route) and parallel or sequential multicasts with a Join, put steps on their routes, edit or remove them, lay out the process (branches in rows, exception subprocess below), change settings of steps, adapters or the iFlow (unknown keys refused), rename, edit Content Modifier headers and properties. Keeps SAP's formatting, lays out the diagram, refuses edits that would break the iFlow, supports a dry run | **Available** |
+| `iflow_edit` | Semantic edits in one all-or-nothing batch: insert a step from the catalog (with settings, headers, properties; for XSLT and message mappings the mapping file, for a Filter its XPath, for a script step a script from a script collection), remove a step, add or remove an adapter (sender to a start event or Poll Enrich, receiver from Request Reply, Send, Content Enricher or an end event; the Sender/Receiver box is reused or created, receivers drawn below their step), add or remove an exception subprocess (steps go inside like anywhere else), add routers (conditions, default route) and parallel or sequential multicasts with a Join, put steps on their routes, edit or remove them, add or remove local integration processes and call them (Process Call, Looping Process Call with its loop), make the start a timer (run once, every n minutes or hours, or cron; start and end, time zone; always externalized so the schedule can be configured), lay out the iFlow (branches in rows, exception subprocess below, one pool per process), change settings of steps, adapters or the iFlow (unknown keys refused), rename, edit Content Modifier headers and properties. Keeps SAP's formatting, lays out the diagram, refuses edits that would break the iFlow, supports a dry run | **Available** |
 | `params_set` | Declare, change or remove externalized parameters: `parameters.propdef` and `parameters.prop` kept consistent in the designer's format; shows where each `{{name}}` is used | **Available** |
 
 ### Check
@@ -92,7 +92,7 @@ development.**
 | `cpi_deploy` | Deploy the current version and wait; SAP's guideline check as an optional gate; errors are reported with step names, one line per problem. A failed deploy also stops the version that was running (Cloud Integration's behaviour), which the confirmation and result point out | **Available** |
 | `cpi_undeploy` | Remove a deployed iFlow or script collection from the runtime | **Available** |
 | `iflow_delete` | Delete an iFlow with its whole version history (for cleaning up test iFlows); refuses deployed iFlows and always asks for confirmation by default | **Available** |
-| `cpi_config_set` | Configure parameter values on the tenant like "Configure" in the designer (no new version; the running iFlow uses them after the next deploy); the local `parameters.prop` follows | **Available** |
+| `cpi_config_set` | Configure parameter values on the tenant like "Configure" in the designer (no new version; the running iFlow uses them after the next deploy), timer schedules as a schedule object; the local `parameters.prop` follows | **Available** |
 
 ### Script collections (development tenants only)
 
@@ -161,7 +161,7 @@ for every change instead of the service key's technical client.
 Requires Node.js 22 or later. The server is published on npm as
 [`cpi-saper-dev-mcp`](https://www.npmjs.com/package/cpi-saper-dev-mcp): your AI client starts it with `npx`, which
 downloads it on first use. During the beta the examples use `cpi-saper-dev-mcp@beta` (the newest beta); to pin one
-version, write for example `cpi-saper-dev-mcp@0.9.0-beta.0`.
+version, write for example `cpi-saper-dev-mcp@0.9.0-beta.1`.
 
 Create `.cpi/config.json` in your project folder ([docs/CONFIGURATION.md](docs/CONFIGURATION.md)), then connect the
 server to your AI client as shown below.

package/bundle/index.js

@@ -849,6 +849,24 @@ function validate(doc, { resourceFiles, declaredParameters } = {}) {
     const need = NEEDS_ADAPTER[cname];
     if (need && !adapterOn.has(el.getAttribute("id")))
       add(need.severity, "NO_ADAPTER", `${label} needs ${need.what} (iflow_edit add_adapter)`);
+    if (p.activityType === "ProcessCallElement") {
+      const target = p.processId ? byTag(doc, "process").find((x) => x.getAttribute("id") === p.processId) : void 0;
+      if (!p.processId?.trim())
+        add("error", "MISSING_SETTING", `${label}: processId is empty; set the local integration process to call (iflow_edit insert_step "process")`);
+      else if (!target)
+        add("error", "INVALID_SETTING", `${label}: calls ${p.processId}, which is not a process of this iFlow`);
+      else if (readProps(target).processType !== "directCall")
+        add("error", "INVALID_SETTING", `${label}: calls ${p.processId}, which is not a local integration process`);
+      if (p.subActivityType === "LoopingProcess") {
+        const loop = children(el, "standardLoopCharacteristics")[0];
+        if (!loop || loop.getAttribute("id") !== p.loopId)
+          add("error", "INVALID_SETTING", `${label}: the loop (standardLoopCharacteristics ${p.loopId ?? ""}) is missing; insert the step with "loop"`);
+        const cond = loop ? children(loop, "loopCondition")[0]?.textContent?.trim() ?? "" : "";
+        if (p.expressionType !== "XML" && /(?:<=|>=|!=|=|<|>)\s*(?!['"$])[^\s')]+/.test(cond)) {
+          add("error", "INVALID_SETTING", `${label}: loop condition "${cond}": put the compared value in quotes (e.g. < '3'); SAP's model check refuses it otherwise`);
+        }
+      }
+    }
     const version = parseVariant(p.cmdVariantUri).version ?? "";
     if (cname === "GroovyScript" && version.startsWith("2.") && p.script && !p.scriptBundleId?.trim() && !p.script.startsWith("v2/")) {
       add("error", "INVALID_SETTING", `${label}: a Groovy Script ${version} step takes its script from script/v2/; set script to "v2/${p.script}" and move the file there`);
@@ -868,6 +886,12 @@ function validate(doc, { resourceFiles, declaredParameters } = {}) {
       add("error", "INVALID_SETTING", `route ${f.getAttribute("id")} (${f.getAttribute("name") ?? ""}): condition "${cond.trim()}" uses ==; Camel Simple compares with = (also !=, >, >=, <, <=, contains, in, regex)`);
     }
   }
+  for (const t of byTag(doc, "timerEventDefinition")) {
+    const key = readProps(t).scheduleKey ?? "";
+    if (!/^\{\{[^{}]+\}\}$/.test(key.trim())) {
+      add("warning", "SCHEDULE_NOT_EXTERNALIZED", `${t.parentNode.getAttribute("id")}: the timer's schedule is not externalized; iflow_edit set_start writes it as a parameter`);
+    }
+  }
   const allowed = byTag(doc, "collaboration")[0] ? readProps(byTag(doc, "collaboration")[0]).allowedHeaderList : void 0;
   if (allowed?.includes(","))
     add("warning", "ALLOWED_HEADERS", `allowedHeaderList "${allowed}": headers are separated by | (with commas no header gets through): "${allowed.split(/\s*,\s*/).join("|")}"`);
@@ -1376,6 +1400,149 @@ async function listSecurityMaterial(client, now = /* @__PURE__ */ new Date()) {
   };
 }
 
+// ../core/dist/schedule.js
+var UTC_LABEL = "( UTC 0:00 ) Greenwich Mean Time(Etc/GMT)";
+var DESIGNER_ZONES = { NST: "( UTC 12:00 ) New Zealand Standard Time(NST)" };
+var DATE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/;
+function zoneLabel(id) {
+  if (id === "Etc/GMT")
+    return UTC_LABEL;
+  if (DESIGNER_ZONES[id])
+    return DESIGNER_ZONES[id];
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: id });
+  } catch {
+    throw new Error(`"${id}" is not a time zone id (use IANA ids such as Europe/Warsaw)`);
+  }
+  const part = (date, style) => new Intl.DateTimeFormat("en-US", { timeZone: id, timeZoneName: style }).formatToParts(date).find((p) => p.type === "timeZoneName").value;
+  const minutes = (o) => {
+    const m = o.match(/GMT([+-])(\d{2}):(\d{2})/);
+    return m ? (m[1] === "-" ? -1 : 1) * (Number(m[2]) * 60 + Number(m[3])) : 0;
+  };
+  const [jan, jul] = [new Date(Date.UTC(2026, 0, 15)), new Date(Date.UTC(2026, 6, 15))];
+  const std = minutes(part(jan, "longOffset")) <= minutes(part(jul, "longOffset")) ? jan : jul;
+  const off = minutes(part(std, "longOffset"));
+  const offText = `${off < 0 ? "-" : ""}${Math.floor(Math.abs(off) / 60)}:${String(Math.abs(off) % 60).padStart(2, "0")}`;
+  return `( UTC ${offText} ) ${part(std, "long")}(${id})`;
+}
+var RANGES = [["second", 0, 59], ["minute", 0, 59], ["hour", 0, 23], ["day of month", 1, 31], ["month", 1, 12], ["day of week", 1, 7], ["year", 1970, 2199]];
+var NAMES = { 4: /^(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)$/, 5: /^(SUN|MON|TUE|WED|THU|FRI|SAT)$/ };
+function cronFields(cron) {
+  const f = cron.trim().split(/\s+/);
+  if (f.length === 6)
+    f.push("*");
+  if (f.length !== 7)
+    throw new Error(`cron "${cron}" needs 6 or 7 fields: second minute hour day-of-month month day-of-week [year], e.g. "0 15 8 ? * MON-FRI"`);
+  f.forEach((field, i) => {
+    const [name, lo, hi] = RANGES[i];
+    const value = (v) => /^\d+$/.test(v) ? Number(v) >= lo && Number(v) <= hi : !!NAMES[i]?.test(v.toUpperCase());
+    const ok = field === "*" || field === "?" && (i === 3 || i === 5) || field.split(",").every((part) => {
+      const [base, step] = part.split("/");
+      if (step !== void 0 && !/^\d+$/.test(step))
+        return false;
+      if (base === "*")
+        return step !== void 0;
+      const [a, b] = base.split("-");
+      return value(a) && (b === void 0 || value(b)) || i === 3 && /^(L|LW|\d{1,2}W)$/.test(part) || i === 5 && /^[1-7A-Z]{1,3}(#\d|L)$/i.test(part);
+    });
+    if (!ok)
+      throw new Error(`cron "${cron}": "${field}" is not a valid ${name} (${lo}-${hi}, *, lists, ranges, steps like 0/15)`);
+  });
+  if (f[3] === "?" === (f[5] === "?"))
+    throw new Error(`cron "${cron}": exactly one of day-of-month and day-of-week must be "?"`);
+  return f;
+}
+function checkSchedule(s) {
+  if (s === "once")
+    return s;
+  const o = s ?? {};
+  if ("every" in o === "cron" in o)
+    throw new Error('a schedule is "once", {every, unit} (simple) or {cron} (advanced)');
+  if ("every" in o && o.unit !== "minutes" && o.unit !== "hours")
+    throw new Error('a simple schedule needs unit "minutes" or "hours"');
+  return o;
+}
+function window(s) {
+  for (const [k, v] of [["from", s.from], ["until", s.until]])
+    if (v !== void 0 && !DATE.test(v))
+      throw new Error(`${k} "${v}" must look like 2026-11-05T08:00:00`);
+  if (s.from && s.until && s.from >= s.until)
+    throw new Error(`until ${s.until} is not after from ${s.from}`);
+  const tz = s.timeZone ?? "Etc/GMT";
+  return { tz, label: zoneLabel(tz), from: s.from ?? "", until: s.until ?? "" };
+}
+function scheduleTable(input) {
+  const schedule = checkSchedule(input);
+  const esc = (v) => v.replace(/&/g, "&amp;");
+  let rows;
+  if (schedule === "once") {
+    rows = [
+      ["dateType", ""],
+      ["timeType", ""],
+      ["dayValue", ""],
+      ["monthValue", ""],
+      ["yearValue", ""],
+      ["onWeekly", ""],
+      ["onMonthly", ""],
+      ["OnEveryMinute", ""],
+      ["fromInterval", ""],
+      ["toInterval", ""],
+      ["timeZone", UTC_LABEL],
+      ["secondValue", "0"],
+      ["minutesValue", ""],
+      ["hourValue", ""],
+      ["triggerType", "simple"],
+      ["noOfSchedules", "1"],
+      ["schedule1", "fireNow=true"]
+    ];
+  } else {
+    const w = window(schedule);
+    const tail = `&trigger.timeZone=${w.tz}${w.from ? `&trigger.startAt=${w.from}` : ""}${w.until ? `&trigger.endAt=${w.until}` : ""}`;
+    let cron = ["*", "*", "*", "?", "*", "*", "*"];
+    let schedule1;
+    if ("every" in schedule) {
+      const max = schedule.unit === "minutes" ? 59 : 23;
+      if (!Number.isInteger(schedule.every) || schedule.every < 1 || schedule.every > max)
+        throw new Error(`every ${schedule.unit}: a whole number from 1 to ${max}`);
+      schedule1 = `simple.repeat=${schedule.unit === "minutes" ? "MINUTES" : "HOURS"}&simple.every=${schedule.every}${tail}`;
+    } else {
+      cron = cronFields(schedule.cron);
+      schedule1 = `${cron.join("+")}${tail}`;
+    }
+    rows = [
+      ["dateType", "every" in schedule ? "SIMPLE" : "ADVANCED"],
+      ["secondValue", "0"],
+      ["minutesValue", ""],
+      ["hourValue", ""],
+      ["toInterval", "1"],
+      ["fromInterval", "0"],
+      ["OnEveryMinute", "1"],
+      ["timeType", "TIME_INTERVAL"],
+      ["timeZone", w.label],
+      ["throwExceptionOnExpiry", "true"],
+      ["second", cron[0]],
+      ["minute", cron[1]],
+      ["hour", cron[2]],
+      ["day_of_month", cron[3]],
+      ["month", cron[4]],
+      ["dayOfWeek", cron[5]],
+      ["year", cron[6]],
+      ["startAt", w.from],
+      ["endAt", w.until],
+      ["attributeBehaviour", "isThrowExceptionOnExpiryVisible,isScheduleAdvancedVisible,isScheduleAdvancedStartEndVisible,isScheduleSimpleVisible"],
+      ["triggerType", "cron"],
+      ["noOfSchedules", "1"],
+      ["schedule1", schedule1]
+    ];
+  }
+  return rows.map(([k, v]) => `<row><cell>${k}</cell><cell>${esc(v)}</cell></row>`).join("");
+}
+function scheduleConfigValue(schedule) {
+  const w = window(schedule);
+  const head = "every" in schedule ? `simple.repeat=${schedule.unit === "minutes" ? "MINUTES" : "HOURS"} --simple.every=${schedule.every}` : cronFields(schedule.cron).join(" ");
+  return `${head} --tz=${w.tz}${w.from ? ` --startAt=${w.from}` : ""}${w.until ? ` --endAt=${w.until}` : ""}`;
+}
+
 // ../core/dist/iflow/edit.js
 var isEl3 = (n) => !!n && n.nodeType === 1;
 var fmt = (n) => Number.isInteger(n) ? `${n}.0` : String(n);
@@ -2173,6 +2340,153 @@ function removeGateway(doc, ref3) {
     edge.setAttribute("targetElement", `BPMNShape_${next.getAttribute("id")}`);
   return `removed ${gwId}${join15 ? ` and its Join ${join15.getAttribute("id")}` : ""} with ${routes.length} routes; ${inFlow.getAttribute("sourceRef")} leads to ${next.getAttribute("id")} again`;
 }
+function findLocalProcess(doc, ref3) {
+  const p = findProcess(doc, ref3);
+  if (readProps(p).processType !== "directCall")
+    throw new Error(`${p.getAttribute("id")} "${p.getAttribute("name")}" is not a local integration process`);
+  return p;
+}
+var plainEvent = (doc, tag2, id, name, flow) => {
+  const el = elementNS(doc, `bpmn2:${tag2}`, { id, name });
+  const ext = elementNS(doc, "bpmn2:extensionElements");
+  const cname = tag2 === "startEvent" ? "StartEvent" : "EndEvent";
+  ext.appendChild(iflProperty(doc, "cmdVariantUri", `ctype::FlowstepVariant/cname::${cname}`));
+  ext.appendChild(iflProperty(doc, "activityType", cname));
+  el.appendChild(ext);
+  el.appendChild(elementNS(doc, tag2 === "startEvent" ? "bpmn2:outgoing" : "bpmn2:incoming", {}, flow));
+  return el;
+};
+function addLocalProcess(doc, { name, processProps }) {
+  const index = idIndex(doc);
+  const collab = byTag(doc, "collaboration")[0];
+  const pools = children(collab, "participant").filter((p) => p.getAttribute("ifl:type") === "IntegrationProcess");
+  const names = new Set(byTag(doc, "process").map((p) => p.getAttribute("name")));
+  let procName2 = name;
+  for (let n = 1; !procName2; n++)
+    if (!names.has(`Local Integration Process ${n}`))
+      procName2 = `Local Integration Process ${n}`;
+  if (names.has(procName2))
+    throw new Error(`a process named "${procName2}" exists already`);
+  const processId = newId(index, "Process");
+  const startId = newId(index, "StartEvent");
+  const endId = newId(index, "EndEvent");
+  const flowId = newId(index, "SequenceFlow");
+  const poolId = `Participant_${processId}`;
+  index.set(poolId, null);
+  const participant = elementNS(doc, "bpmn2:participant", { id: poolId, "ifl:type": "IntegrationProcess", name: procName2, processRef: processId });
+  participant.appendChild(elementNS(doc, "bpmn2:extensionElements"));
+  insertAfterEl(collab, participant, pools.at(-1) ?? children(collab, "participant").at(-1));
+  const proc = withProps(doc, elementNS(doc, "bpmn2:process", { id: processId, name: procName2 }), processProps);
+  proc.appendChild(plainEvent(doc, "startEvent", startId, `Start ${procName2}`, flowId));
+  proc.appendChild(plainEvent(doc, "endEvent", endId, `End ${procName2}`, flowId));
+  proc.appendChild(flowEl(doc, flowId, startId, endId));
+  insertAfterEl(doc.documentElement, proc, byTag(doc, "process").at(-1));
+  const shapes = pools.map((p) => shapeOf(doc, p.getAttribute("id"))).filter((x2) => !!x2).map(bounds);
+  const x = shapes.length ? Math.min(...shapes.map((b) => b.x)) : 250;
+  const y = shapes.length ? Math.max(...byTag(doc, "BPMNShape", NS.bpmndi).map(bounds).map((b) => b.y + b.h)) + 60 : 60;
+  const plane = byTag(doc, "BPMNPlane", NS.bpmndi)[0];
+  let last = byTag(doc, "BPMNShape", NS.bpmndi).at(-1);
+  const put = (id, b) => {
+    const sh = elementNS(doc, "bpmndi:BPMNShape", { bpmnElement: id, id: `BPMNShape_${id}` });
+    sh.appendChild(elementNS(doc, "dc:Bounds", { height: fmt(b.h), width: fmt(b.w), x: fmt(b.x), y: fmt(b.y) }));
+    insertAfterEl(plane, sh, last);
+    last = sh;
+    return b;
+  };
+  put(poolId, { x, y, w: 540, h: 220 });
+  const sb = put(startId, { x: x + 42, y: y + 82, w: 32, h: 32 });
+  const eb = put(endId, { x: x + 453, y: y + 82, w: 32, h: 32 });
+  const edge = elementNS(doc, "bpmndi:BPMNEdge", { bpmnElement: flowId, id: `BPMNEdge_${flowId}`, sourceElement: `BPMNShape_${startId}`, targetElement: `BPMNShape_${endId}` });
+  for (const b of [sb, eb])
+    edge.appendChild(elementNS(doc, "di:waypoint", { x: fmt(b.x + b.w / 2), "xsi:type": "dc:Point", y: fmt(b.y + b.h / 2) }));
+  insertAfterEl(plane, edge, byTag(doc, "BPMNEdge", NS.bpmndi).at(-1) ?? last);
+  return { processId, startId, endId, name: procName2 };
+}
+function removeLocalProcess(doc, ref3) {
+  const proc = findLocalProcess(doc, ref3);
+  const id = proc.getAttribute("id");
+  const callers = byTag(doc, "callActivity").filter((c) => readProps(c).activityType === "ProcessCallElement" && readProps(c).processId === id);
+  if (callers.length)
+    throw new Error(`${id} is called by ${callers.map((c) => `${c.getAttribute("id")} "${c.getAttribute("name")}"`).join(", ")}; remove those calls first`);
+  const ids = /* @__PURE__ */ new Set();
+  const collect = (el) => {
+    const x = el.getAttribute("id");
+    if (x)
+      ids.add(x);
+    for (const c of children(el))
+      collect(c);
+  };
+  collect(proc);
+  const adapter = byTag(doc, "messageFlow").find((m) => ids.has(m.getAttribute("sourceRef")) || ids.has(m.getAttribute("targetRef")));
+  if (adapter)
+    throw new Error(`a step in ${id} has an adapter (${adapter.getAttribute("id")}); remove it first (remove_adapter)`);
+  const participant = children(byTag(doc, "collaboration")[0], "participant").find((p) => p.getAttribute("processRef") === id);
+  if (participant)
+    ids.add(participant.getAttribute("id"));
+  for (const di of [...byTag(doc, "BPMNShape", NS.bpmndi), ...byTag(doc, "BPMNEdge", NS.bpmndi)])
+    if (ids.has(di.getAttribute("bpmnElement")))
+      removeEl(di);
+  if (participant)
+    removeEl(participant);
+  removeEl(proc);
+  return `removed local integration process ${id} "${proc.getAttribute("name")}" with its content`;
+}
+function setLoop(el, { condition: condition2, max = 100 }) {
+  const doc = el.ownerDocument;
+  for (const old of children(el, "standardLoopCharacteristics"))
+    removeEl(old);
+  const stamp2 = Date.now();
+  const id = `StandardLoopCharacteristics_${stamp2}`;
+  const loop = elementNS(doc, "bpmn2:standardLoopCharacteristics", { id, loopMaximum: String(max) });
+  loop.appendChild(elementNS(doc, "bpmn2:loopCondition", { id: `FormalExpression_${stamp2}`, "xsi:type": "bpmn2:tFormalExpression" }, condition2));
+  insertAfterEl(el, loop, Array.from(el.childNodes).filter(isEl3).at(-1));
+  return id;
+}
+function setStart(doc, { process: process2, kind, schedule = "once", parameter }) {
+  const proc = findProcess(doc, process2);
+  if (readProps(proc).processType === "directCall")
+    throw new Error(`${proc.getAttribute("id")} is a local integration process: it is started by a Process Call`);
+  const starts = children(proc, "startEvent");
+  if (starts.length !== 1)
+    throw new Error(`${proc.getAttribute("id")} must have exactly one start event (has ${starts.length})`);
+  const start = starts[0];
+  const id = start.getAttribute("id");
+  const index = idIndex(doc);
+  const docEl = start.ownerDocument;
+  const timer = children(start, "timerEventDefinition")[0];
+  if (kind === "timer") {
+    const sender = byTag(doc, "messageFlow").find((m) => m.getAttribute("targetRef") === id);
+    if (sender)
+      throw new Error(`${id} has a sender adapter (${sender.getAttribute("id")} "${sender.getAttribute("name")}"); a scheduled iFlow has none: remove it first (remove_adapter)`);
+    const table = scheduleTable(schedule);
+    const existing = timer ? readProps(timer).scheduleKey?.match(/^\{\{([^{}]+)\}\}$/)?.[1] : void 0;
+    const name = parameter ?? existing ?? "timer_schedule";
+    if (/[{}]/.test(name) || !name.trim())
+      throw new Error(`"${name}" is not a usable parameter name`);
+    const what = schedule === "once" ? "runs once after deploy" : "every" in schedule ? `every ${schedule.every} ${schedule.unit}` : `cron ${schedule.cron}`;
+    const where = schedule !== "once" && schedule.timeZone ? ` (${schedule.timeZone})` : schedule === "once" ? "" : " (UTC)";
+    if (timer) {
+      setProperties(timer, { scheduleKey: `{{${name}}}` });
+      return { message: `${id}: schedule ${what}${where}, parameter ${name}`, parameter: { name, table } };
+    }
+    for (const c of [...children(start, "extensionElements"), ...children(start, "messageEventDefinition")])
+      removeEl(c);
+    const def = elementNS(docEl, "bpmn2:timerEventDefinition", { id: newId(index, "TimerEventDefinition") });
+    withProps(docEl, def, { scheduleKey: `{{${name}}}`, componentVersion: "1.4", cmdVariantUri: "ctype::FlowstepVariant/cname::intermediatetimer/version::1.4.0", activityType: "StartTimerEvent" });
+    insertAfterEl(start, def, Array.from(start.childNodes).filter(isEl3).at(-1));
+    return { message: `${id}: timer start, ${what}${where}, externalized as parameter ${name}`, parameter: { name, table } };
+  }
+  if (!timer)
+    return { message: `${id} is a message start already` };
+  removeEl(timer);
+  withProps(docEl, start, { cmdVariantUri: "ctype::FlowstepVariant/cname::MessageStartEvent/version::1.0", componentVersion: "1.0" });
+  const ext = children(start, "extensionElements")[0];
+  const inner = indentBefore(children(start, "outgoing")[0] ?? start);
+  start.insertBefore(docEl.createTextNode(inner), ext);
+  prettify(ext, inner.replace(/^\n/, ""));
+  insertAfterEl(start, elementNS(docEl, "bpmn2:messageEventDefinition"), Array.from(start.childNodes).filter(isEl3).at(-1));
+  return { message: `${id}: message start again; connect a sender with add_adapter (the schedule parameter stays in parameters.prop)` };
+}
 function findProcess(doc, ref3) {
   const processes = byTag(doc, "process");
   if (ref3) {
@@ -2377,11 +2691,129 @@ var isBranching = (doc, flowId) => {
   const src = f?.getAttribute("sourceRef");
   return !!src && byTag(doc, "sequenceFlow").filter((x) => x.getAttribute("sourceRef") === src).length > 1;
 };
+var poolShapeOf = (doc, proc) => {
+  const id = children(byTag(doc, "collaboration")[0], "participant").find((p) => p.getAttribute("processRef") === proc.getAttribute("id"))?.getAttribute("id");
+  return id ? shapeOf(doc, id) : void 0;
+};
+var procName = (proc) => `"${proc.getAttribute("name") ?? proc.getAttribute("id")}"`;
+var processesInOrder = (doc) => {
+  const all = byTag(doc, "process");
+  const local = (p) => readProps(p).processType === "directCall";
+  return [...all.filter((p) => !local(p)), ...all.filter(local)];
+};
+function moveProcess(doc, proc, dx, dy) {
+  if (!dx && !dy)
+    return;
+  const ids = /* @__PURE__ */ new Set();
+  const collect = (el) => {
+    const id = el.getAttribute("id");
+    if (id)
+      ids.add(id);
+    for (const c of children(el))
+      collect(c);
+  };
+  collect(proc);
+  const pool = poolShapeOf(doc, proc);
+  for (const sh of byTag(doc, "BPMNShape", NS.bpmndi)) {
+    if (sh !== pool && !ids.has(sh.getAttribute("bpmnElement")))
+      continue;
+    const b = bounds(sh);
+    b.el.setAttribute("x", fmt(b.x + dx));
+    b.el.setAttribute("y", fmt(b.y + dy));
+  }
+  for (const e of byTag(doc, "BPMNEdge", NS.bpmndi)) {
+    if (!ids.has(e.getAttribute("bpmnElement")))
+      continue;
+    for (const wp of children(e, "waypoint", NS.di)) {
+      wp.setAttribute("x", fmt(Number(wp.getAttribute("x")) + dx));
+      wp.setAttribute("y", fmt(Number(wp.getAttribute("y")) + dy));
+    }
+  }
+}
 function layoutStraight(doc) {
-  const processes = byTag(doc, "process");
-  if (processes.length !== 1)
-    throw new Error(`layout handles one integration process; this iFlow has ${processes.length} (local processes): use the designer`);
-  const proc = processes[0];
+  const procs = processesInOrder(doc);
+  if (!procs.length)
+    throw new Error("the iFlow has no integration process");
+  const lines = [];
+  let below;
+  let left;
+  for (const proc of procs) {
+    const pool = poolShapeOf(doc, proc);
+    if (!pool)
+      throw new Error(`process ${procName(proc)} has no pool in the diagram`);
+    if (below !== void 0) {
+      const b2 = bounds(pool);
+      moveProcess(doc, proc, left - b2.x, below + 60 - b2.y);
+    }
+    const msg = layoutProcess(doc, proc);
+    lines.push(procs.length > 1 ? `${procName(proc)}: ${msg}` : msg);
+    const b = bounds(pool);
+    const ids = /* @__PURE__ */ new Set();
+    const collect = (el) => {
+      const id = el.getAttribute("id");
+      if (id)
+        ids.add(id);
+      for (const c of children(el))
+        collect(c);
+    };
+    collect(proc);
+    const boxes = byTag(doc, "messageFlow").flatMap((m) => [m.getAttribute("sourceRef"), m.getAttribute("targetRef")].filter((x) => !ids.has(x)).filter(() => ids.has(m.getAttribute("sourceRef")) || ids.has(m.getAttribute("targetRef"))));
+    const boxBottoms = boxes.map((id) => shapeOf(doc, id)).filter((x) => !!x).map(bounds).map((x) => x.y + x.h);
+    below = Math.max(b.y + b.h, ...boxBottoms);
+    left ??= b.x;
+  }
+  routeAdapters(doc);
+  keepOnCanvas(doc);
+  return lines.join("; ");
+}
+function layoutAround(doc, elementId) {
+  let proc = idIndex(doc).get(elementId) ?? null;
+  while (proc && proc.localName !== "process")
+    proc = proc.parentNode;
+  if (!proc)
+    throw new Error(`${elementId} is not in a process`);
+  const pool = poolShapeOf(doc, proc);
+  if (!pool)
+    throw new Error(`process ${procName(proc)} has no pool in the diagram`);
+  const before = bounds(pool);
+  const mine = /* @__PURE__ */ new Set();
+  const collect = (el) => {
+    const id = el.getAttribute("id");
+    if (id)
+      mine.add(id);
+    for (const c of children(el))
+      collect(c);
+  };
+  collect(proc);
+  for (const mf of byTag(doc, "messageFlow")) {
+    const [a, b] = [mf.getAttribute("sourceRef"), mf.getAttribute("targetRef")];
+    if (mine.has(a) || mine.has(b)) {
+      mine.add(a);
+      mine.add(b);
+      mine.add(mf.getAttribute("id"));
+    }
+  }
+  const msg = layoutProcess(doc, proc);
+  const grow = bounds(pool).y + bounds(pool).h - (before.y + before.h);
+  if (grow > 0 && byTag(doc, "process").length > 1) {
+    for (const sh of byTag(doc, "BPMNShape", NS.bpmndi)) {
+      const b = bounds(sh);
+      if (sh !== pool && !mine.has(sh.getAttribute("bpmnElement")) && b.y >= before.y + before.h)
+        b.el.setAttribute("y", fmt(b.y + grow));
+    }
+    for (const e of byTag(doc, "BPMNEdge", NS.bpmndi)) {
+      if (mine.has(e.getAttribute("bpmnElement")))
+        continue;
+      for (const wp of children(e, "waypoint", NS.di))
+        if (Number(wp.getAttribute("y")) >= before.y + before.h)
+          wp.setAttribute("y", fmt(Number(wp.getAttribute("y")) + grow));
+    }
+  }
+  routeAdapters(doc);
+  keepOnCanvas(doc);
+  return msg;
+}
+function layoutProcess(doc, proc) {
   const subs = children(proc, "subProcess");
   const other = subs.find((x) => !isExceptionSub(x));
   if (other)
@@ -2390,7 +2822,7 @@ function layoutStraight(doc) {
   const byId = new Map(nodes.map((n) => [n.getAttribute("id"), n]));
   const starts = nodes.filter((n) => n.localName === "startEvent");
   if (starts.length !== 1)
-    throw new Error(`layout needs exactly one start event (has ${starts.length})`);
+    throw new Error(`layout needs exactly one start event in process ${procName(proc)} (has ${starts.length}): use the designer`);
   const flows = children(proc, "sequenceFlow");
   const out = (id) => {
     const order = children(byId.get(id), "outgoing").map((o) => o.textContent?.trim());
@@ -2457,10 +2889,9 @@ function layoutStraight(doc) {
     row2.set(id, used.indexOf(x));
   rows = used.length - 1;
   const collab = byTag(doc, "collaboration")[0];
-  const poolId = children(collab, "participant").find((p) => p.getAttribute("processRef") === proc.getAttribute("id"))?.getAttribute("id");
-  const poolShape = poolId ? shapeOf(doc, poolId) : void 0;
+  const poolShape = poolShapeOf(doc, proc);
   if (!poolShape)
-    throw new Error("the integration process has no diagram shape");
+    throw new Error(`process ${procName(proc)} has no diagram shape`);
   const shapeBounds = new Map(nodes.map((n) => {
     const sh = shapeOf(doc, n.getAttribute("id"));
     if (!sh)
@@ -2554,8 +2985,6 @@ function layoutStraight(doc) {
     placeBox(doc, box, { ...hit[1] }, hit[0].localName === "startEvent" && hit[0].parentNode === proc);
     boxes++;
   }
-  routeAdapters(doc);
-  keepOnCanvas(doc);
   const where = rows ? `in ${cols} columns and ${rows + 1} rows` : "in one row";
   return `laid out ${nodes.length} elements ${where}${inner ? ` and ${inner.chain.length} in the exception subprocess below` : ""} (pool width ${right + GAP - pool.x}), ${boxes} Sender/Receiver box(es) placed`;
 }
@@ -2617,7 +3046,7 @@ function expressionSettings(cname, expression, p) {
   return expression === void 0 ? {} : { wrapContent: expression };
 }
 var needsMappingFile = (cname, p) => cname === "XSLTMapping" && p.mappingSource === "mappingSrcIflow" || cname === "MessageMapping" && p.mappingReference === "static";
-function applyEdits(doc, ops, catalog) {
+function applyEdits(doc, ops, catalog, effects = { params: [] }) {
   const log = [];
   ops.forEach((op, i) => {
     const where = `operation ${i + 1} (${op.op})`;
@@ -2654,6 +3083,23 @@ function applyEdits(doc, ops, catalog) {
               throw new Error(`a script from collection ${op.scriptCollection} needs settings.script: its file name in the collection, e.g. "Utils.groovy"`);
             properties.scriptBundleId = op.scriptCollection;
           }
+          if (cname === "NonLoopingProcess" || cname === "LoopingProcess") {
+            if (!op.process)
+              throw new Error(`${entry.label} needs "process": the local integration process to call (add one with add_local_process)`);
+            const target = findLocalProcess(doc, op.process);
+            let own = findElement(doc, after);
+            while (own && own.localName !== "process")
+              own = own.parentNode;
+            if (own === target)
+              throw new Error(`a step in ${target.getAttribute("id")} cannot call its own process`);
+            properties.processId = target.getAttribute("id");
+            if (cname === "LoopingProcess") {
+              if (!op.loop?.condition)
+                throw new Error(`${entry.label} needs "loop": { condition (repeat while true), max (default 100) }`);
+              properties.expressionType = op.loop.expressionType === "XML" ? "XML" : "Non XML";
+            }
+          } else if (op.process || op.loop)
+            throw new Error('"process" and "loop" apply to Process Call and Looping Process Call steps only');
           if (cname === "GroovyScript" && version.startsWith("2.") && properties.script && !op.scriptCollection && !properties.script.startsWith("v2/")) {
             throw new Error(`a Groovy Script ${version} step takes its script from script/v2/: use settings.script "v2/${properties.script}" (and put the file there)`);
           }
@@ -2677,6 +3123,8 @@ function applyEdits(doc, ops, catalog) {
             ...onRoute ? { flowId: onRoute.getAttribute("id") } : {}
           });
           const el = findElement(doc, stepId);
+          if (op.loop && cname === "LoopingProcess")
+            setProperties(el, { loopId: setLoop(el, { condition: op.loop.condition, ...op.loop.max ? { max: op.loop.max } : {} }) });
           if (op.headers?.length)
             editTable(el, "headerTable", { set: op.headers });
           if (op.properties?.length)
@@ -2684,7 +3132,7 @@ function applyEdits(doc, ops, catalog) {
           log.push(`inserted ${stepId} "${op.name ?? entry.label}" (${entry.label} ${version}, ${reason}) ${onRoute ? `at the start of route ${onRoute.getAttribute("id")}` : `after ${after}`}`);
           if (onRoute) {
             try {
-              log.push(layoutStraight(doc));
+              log.push(layoutAround(doc, stepId));
             } catch (e) {
               log.push(`not laid out (${e.message}); the new step sits next to ${after}`);
             }
@@ -2734,6 +3182,22 @@ function applyEdits(doc, ops, catalog) {
           log.push(`removed exception subprocess ${removeExceptionSubprocess(doc, op.process)} with its content`);
           break;
         }
+        case "set_start": {
+          const r = setStart(doc, { ...op.process ? { process: op.process } : {}, kind: op.kind, ...op.schedule ? { schedule: op.schedule } : {}, ...op.parameter ? { parameter: op.parameter } : {} });
+          if (r.parameter)
+            effects.params.push({ name: r.parameter.name, value: r.parameter.table, type: "custom:schedule", description: "Schedule of the timer start" });
+          log.push(r.message);
+          break;
+        }
+        case "add_local_process": {
+          const r = addLocalProcess(doc, { ...op.name ? { name: op.name } : {}, processProps: catalogProps(catalog, "LocalIntegrationProcess", doc) });
+          log.push(`added local integration process ${r.processId} "${r.name}": ${r.startId} -> ${r.endId}; insert steps after ${r.startId}, call it with insert_step Process Call "process"`);
+          break;
+        }
+        case "remove_local_process": {
+          log.push(removeLocalProcess(doc, op.process));
+          break;
+        }
         case "add_router": {
           const after = findElement(doc, op.after).getAttribute("id");
           const r = addRouter(doc, after, {
@@ -2744,7 +3208,7 @@ function applyEdits(doc, ops, catalog) {
             endProps: catalogProps(catalog, "MessageEndEvent", doc)
           });
           log.push(`added router ${r.gatewayId} after ${after} with routes ${r.routeIds.join(", ")} (default ${r.routeIds[0]})${r.endIds.length ? `, End events ${r.endIds.join(", ")}` : ""}; insert steps on a route with insert_step "route"`);
-          log.push(layoutStraight(doc));
+          log.push(layoutAround(doc, r.gatewayId));
           break;
         }
         case "add_multicast": {
@@ -2760,7 +3224,7 @@ function applyEdits(doc, ops, catalog) {
             endProps: catalogProps(catalog, "MessageEndEvent", doc)
           });
           log.push(`added ${sequential ? "sequential" : "parallel"} multicast ${r.gatewayId} after ${after} with branches ${r.branchIds.join(", ")}${r.joinId ? `, joined in ${r.joinId}` : ""}${r.endIds.length ? `, End events ${r.endIds.join(", ")}` : ""}; insert steps on a branch with insert_step "route"`);
-          log.push(layoutStraight(doc));
+          log.push(layoutAround(doc, r.gatewayId));
           break;
         }
         case "set_route": {
@@ -2768,8 +3232,12 @@ function applyEdits(doc, ops, catalog) {
           break;
         }
         case "remove_gateway": {
+          let proc = findElement(doc, op.gateway);
+          while (proc && proc.localName !== "process")
+            proc = proc.parentNode;
           log.push(removeGateway(doc, op.gateway));
-          log.push(layoutStraight(doc));
+          if (proc)
+            log.push(layoutAround(doc, proc.getAttribute("id")));
           break;
         }
         case "layout": {
@@ -3539,7 +4007,7 @@ function readChangelog(path, max = 5) {
 // ../core/dist/params.js
 import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "node:fs";
 import { dirname as dirname5, join as join5 } from "node:path";
-var PARAM_TYPES = ["xsd:string", "xsd:integer", "xsd:long", "xsd:boolean", "xsd:date", "xsd:time", "xsd:dateTime"];
+var PARAM_TYPES = ["xsd:string", "xsd:integer", "xsd:long", "xsd:boolean", "xsd:date", "xsd:time", "xsd:dateTime", "custom:schedule"];
 var rx = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var blockOf = (name) => new RegExp(`<parameter>(?:(?!</parameter>)[\\s\\S])*?<name>${rx(escapeXml(name))}</name>[\\s\\S]*?</parameter>`);
 var unescapeXml = (s) => s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
@@ -4526,6 +4994,12 @@ var operation = z4.discriminatedUnion("op", [
     version: z4.string().optional().describe("Component version; default: the version this iFlow already uses, else the latest"),
     name: z4.string().optional().describe("Step name; default: the catalog label"),
     settings: kv.optional().describe('Settings to change from the catalog defaults; script steps need "script" (file under script/, v2/<name>.groovy for 2.x; with scriptCollection the file name in the collection)'),
+    process: z4.string().optional().describe("Process Call / Looping Process Call: the local integration process to call (id or name; add_local_process creates one)"),
+    loop: z4.object({
+      condition: z4.string().describe("Repeat while this holds, e.g. ${property.hasMore} = 'true'"),
+      max: z4.number().int().positive().optional().describe("At most this many times (default 100)"),
+      expressionType: z4.enum(["NonXML", "XML"]).optional().describe("NonXML: Camel Simple (default); XML: XPath")
+    }).optional().describe("Looping Process Call: the loop"),
     scriptCollection: z4.string().optional().describe('Groovy/JavaScript step: Id of a script collection of the same package the script comes from (settings.script = its file name, e.g. "Utils.groovy"); the manifest requirement is written'),
     mapping: z4.string().optional().describe('XSLT Mapping / Message Mapping: the file under src/main/resources, e.g. "mapping/orders.xsl" (a bare name means mapping/); sets mappinguri, mappingpath and mappingname as the designer does'),
     expression: z4.string().optional().describe(`Filter: the XPath of the nodes to keep, e.g. "/Orders/Order[region='EU']" (stored as wrapContent; xpathType is only the value type: Nodelist, Node, Boolean, Integer, String)`),
@@ -4549,6 +5023,22 @@ var operation = z4.discriminatedUnion("op", [
     name: z4.string().optional().describe('Default "Exception Subprocess 1"'),
     end: z4.enum(["error", "message"]).default("error").describe("error: Error Start -> Error End, the message fails and the sender gets the error; message: Error Start -> End, the subprocess sends the reply (set it with steps)")
   }).describe("Add an exception subprocess (one per process), drawn below the main flow; insert steps into it with insert_step after its Error Start"),
+  z4.object({ op: z4.literal("add_local_process"), name: z4.string().optional().describe('Default "Local Integration Process <n>"') }).describe('Add a local integration process (a pool below the others, Start -> End); insert steps after its start, call it with a Process Call step ("process")'),
+  z4.object({
+    op: z4.literal("set_start"),
+    process: z4.string().optional().describe("Integration process (id or name); default: the main one"),
+    kind: z4.enum(["timer", "message"]).describe("timer: a scheduled iFlow (no sender adapter; remove it first); message: started by a sender adapter again"),
+    schedule: z4.union([z4.literal("once"), z4.object({
+      every: z4.number().int().positive().optional().describe("Simple schedule: every n minutes (1-59) or hours (1-23)"),
+      unit: z4.enum(["minutes", "hours"]).optional(),
+      cron: z4.string().optional().describe('Advanced schedule instead: Quartz cron "second minute hour day-of-month month day-of-week [year]", e.g. "0 15 8 ? * MON-FRI" (weekdays 08:15)'),
+      from: z4.string().optional().describe("Not before, local time in timeZone: 2026-11-05T08:00:00"),
+      until: z4.string().optional().describe("Not after"),
+      timeZone: z4.string().optional().describe("IANA time zone id, e.g. Europe/Warsaw; default UTC")
+    })]).optional().describe('timer: "once" (run once after deploy, the default), a simple schedule {every, unit} or an advanced one {cron}; always externalized into parameters.prop'),
+    parameter: z4.string().optional().describe("timer: name of the schedule parameter (default: the existing one, else timer_schedule)")
+  }).describe("Make the start event a timer start (scheduled iFlow) or a message start"),
+  z4.object({ op: z4.literal("remove_local_process"), process: z4.string().describe("Id or name; refused while a Process Call calls it") }),
   z4.object({ op: z4.literal("remove_exception_subprocess"), process: z4.string().optional() }).describe("Remove the exception subprocess with all steps in it (they must not have adapters)"),
   z4.object({
     op: z4.literal("add_router"),
@@ -4614,7 +5104,7 @@ var clip2 = (s, max) => s.length > max ? `${s.slice(0, max)}
 function registerEditCheckTools(server2) {
   server2.registerTool("iflow_edit", {
     title: "Edit an iFlow",
-    description: `Apply semantic edits to a local iFlow in one batch: insert a step from the catalog (with settings, headers, properties), remove a step (its neighbours are reconnected), add or remove an adapter (with its Sender/Receiver box), add or remove an exception subprocess (insert steps into it after its Error Start), add a router or a parallel/sequential multicast (with Join) and put steps on its routes (insert_step "route"), change or remove routes and gateways, lay out the process (branches in rows), change settings of a step, adapter or the iFlow, rename, and add/change/remove Content Modifier headers and properties. All operations succeed or nothing is written; edits that would introduce structural errors are refused. New elements are formatted like SAP's designer writes them and the diagram is laid out. Returns what changed (as iflow_diff) and the new step ids. Script and mapping files are not created: write them yourself (missing ones are listed under "filesToCreate").`,
+    description: `Apply semantic edits to a local iFlow in one batch: insert a step from the catalog (with settings, headers, properties), remove a step (its neighbours are reconnected), add or remove an adapter (with its Sender/Receiver box), add or remove an exception subprocess (insert steps into it after its Error Start), add a router or a parallel/sequential multicast (with Join) and put steps on its routes (insert_step "route"), change or remove routes and gateways, add or remove local integration processes and call them (Process Call / Looping Process Call with "process", "loop"), make the start a timer or a message start (set_start), lay out the iFlow (one pool per process, branches in rows), change settings of a step, adapter or the iFlow, rename, and add/change/remove Content Modifier headers and properties. All operations succeed or nothing is written; edits that would introduce structural errors are refused. New elements are formatted like SAP's designer writes them and the diagram is laid out. Returns what changed (as iflow_diff) and the new step ids. Script and mapping files are not created: write them yourself (missing ones are listed under "filesToCreate").`,
     inputSchema: {
       iflow: iflowArg2,
       operations: z4.array(operation).min(1),
@@ -4627,7 +5117,10 @@ function registerEditCheckTools(server2) {
       const { located, doc } = localIflow(ctx, iflow);
       const before = parseIflw(serializeIflw(doc));
       const known = new Set(validate(before, located).map((i) => `${i.code} ${i.msg}`));
-      const log = applyEdits(doc, operations, catalogOf(ctx.config));
+      const effects = { params: [] };
+      const log = applyEdits(doc, operations, catalogOf(ctx.config), effects);
+      if (effects.params.length && !located.dir)
+        throw new Error("a timer schedule is externalized into parameters.prop: edit the iFlow folder, not a loose .iflw");
       const issues = validate(doc, located).filter((i) => !known.has(`${i.code} ${i.msg}`));
       const filesToCreate = issues.filter((i) => i.code === "MISSING_RESOURCE").map((i) => i.msg.replace(/^.* -> /, ""));
       const blocking = issues.filter((i) => i.severity === "error" && i.code !== "MISSING_RESOURCE" && !DEPLOY_CHECKS.has(i.code));
@@ -4638,6 +5131,7 @@ ${blocking.map((i) => `  ${i.code} ${i.msg}`).join("\n")}`);
       }
       if (!dryRun)
         writeFileSync6(located.iflwPath, serializeIflw(doc));
+      const paramChanges = !dryRun && effects.params.length ? setParams(located.dir, effects.params.map((p) => ({ name: p.name, value: p.value, type: p.type, description: p.description }))) : [];
       const manifest = !dryRun && syncCollectionRequirements(located, doc);
       const collections = collectionIssues(located, doc).map((i) => `${i.code} ${i.msg}`);
       const changes = diffIflows(describe(before, { maxLen: 0 }), describe(doc, { maxLen: 0 }), { docA: before, docB: doc });
@@ -4649,6 +5143,7 @@ ${blocking.map((i) => `  ${i.code} ${i.msg}`).join("\n")}`);
         filesToCreate,
         ...beforeDeploy.length ? { beforeDeploy } : {},
         ...manifest ? { manifest: "META-INF/MANIFEST.MF: Require-Capability updated for the script collections used" } : {},
+        ...paramChanges.length ? { parameters: paramChanges.map((c) => c.replace(/ = <row>.*$/, " = (schedule table)")) } : {},
         warnings: [...issues.filter((i) => i.severity === "warning" && !DEPLOY_CHECKS.has(i.code)).map((i) => `${i.code} ${i.msg}`), ...collections]
       });
     } catch (e) {
@@ -5542,9 +6037,17 @@ function registerParamTools(server2) {
       set: z8.array(z8.object({
         name: z8.string(),
         value: z8.string().optional(),
-        type: z8.enum(["xsd:string", "xsd:integer", "xsd:long", "xsd:boolean", "xsd:date", "xsd:time", "xsd:dateTime"]).optional().describe("Default xsd:string (kept when changing)"),
+        type: z8.enum(["xsd:string", "xsd:integer", "xsd:long", "xsd:boolean", "xsd:date", "xsd:time", "xsd:dateTime", "custom:schedule"]).optional().describe("Default xsd:string (kept when changing)"),
         required: z8.boolean().optional(),
-        description: z8.string().optional()
+        description: z8.string().optional(),
+        schedule: z8.union([z8.literal("once"), z8.object({
+          every: z8.number().int().positive().optional(),
+          unit: z8.enum(["minutes", "hours"]).optional(),
+          cron: z8.string().optional(),
+          from: z8.string().optional(),
+          until: z8.string().optional(),
+          timeZone: z8.string().optional()
+        })]).optional().describe('For a timer schedule parameter (type custom:schedule) instead of value: "once", {every, unit} or {cron}, with from, until, timeZone')
       })).default([]),
       remove: z8.array(z8.string()).default([]).describe("Parameter names to remove (declaration, value and the designer's references)")
     },
@@ -5555,7 +6058,8 @@ function registerParamTools(server2) {
       const { located, doc } = localIflow(ctx, iflow);
       if (!located.dir)
         throw new Error(`${iflow}: parameters belong to an iFlow folder (src/main/resources), not a loose .iflw`);
-      const log = set.length || remove.length ? setParams(located.dir, set, remove) : [];
+      const input = set.map(({ schedule, ...p }) => schedule !== void 0 ? { ...p, type: "custom:schedule", value: scheduleTable(checkSchedule(schedule)) } : p);
+      const log = (input.length || remove.length ? setParams(located.dir, input, remove) : []).map((l) => l.replace(/ = <row>.*$/, " = (schedule table)"));
       const used = uses(doc);
       const params = readParams(located.dir).map((p) => ({ ...p, usedBy: used.get(p.name) ?? [] }));
       const declared = new Set(params.map((p) => p.name));
@@ -5601,11 +6105,19 @@ function registerParamTools(server2) {
     description: `Set configured values of an iFlow's externalized parameters on a development tenant (allowed packages only), like "Configure" in the designer: no new version; the running iFlow uses them after the next deploy. Asks for confirmation when "config_set" is in "confirm". When the iFlow is pulled, its local parameters.prop is updated too (unless it has local changes, which a later cpi_push would upload over these values).`,
     inputSchema: {
       iflow: z8.string().describe("iFlow Id"),
-      values: z8.record(z8.string(), z8.string()).describe("Parameter name -> value"),
+      values: z8.record(z8.string(), z8.string()).default({}).describe("Parameter name -> value"),
+      schedules: z8.record(z8.string(), z8.object({
+        every: z8.number().int().positive().optional(),
+        unit: z8.enum(["minutes", "hours"]).optional(),
+        cron: z8.string().optional(),
+        from: z8.string().optional(),
+        until: z8.string().optional(),
+        timeZone: z8.string().optional()
+      })).default({}).describe("Schedule parameter name (type custom:schedule) -> {every, unit} or {cron}, with from, until, timeZone"),
       tenant: tenantArg5
     },
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }
-  }, async ({ iflow, values, tenant: tenantName }) => {
+  }, async ({ iflow, values: plain, schedules, tenant: tenantName }) => {
     const ctx = await context(server2).catch((e) => e);
     if (ctx instanceof Error)
       return toolError(ctx);
@@ -5614,6 +6126,15 @@ function registerParamTools(server2) {
       const info = await getIflow(api.client, iflow);
       await assertMayChange(api.client, api.tenant, info.packageId);
       const current = new Map((await getConfigurations(api.client, iflow)).map((v) => [v.key, v]));
+      const values = { ...plain };
+      for (const [k, sch] of Object.entries(schedules)) {
+        if (current.get(k) && current.get(k).type !== "custom:schedule")
+          throw new Error(`${k} is not a schedule parameter (${current.get(k).type})`);
+        values[k] = scheduleConfigValue(checkSchedule(sch));
+      }
+      for (const k of Object.keys(plain))
+        if (current.get(k)?.type === "custom:schedule")
+          throw new Error(`${k} is a schedule: pass it in "schedules" as {every, unit} or {cron}`);
       const keys = Object.keys(values);
       if (!keys.length)
         throw new Error("nothing to set: pass values");
@@ -5623,7 +6144,8 @@ function registerParamTools(server2) {
           throw new Error(`${iflow} has no parameter "${k}"; parameters: ${[...current.keys()].filter((x) => !x.startsWith("SAP_")).join(", ") || "none"}`);
         if (k.startsWith("SAP_"))
           throw new Error(`${k} is set by SAP, not configured`);
-        checkValue(k, c.type, values[k]);
+        if (c.type !== "custom:schedule")
+          checkValue(k, c.type, values[k]);
       }
       await confirmAction(server2, ctx.config, "config_set", `Configure ${iflow} on tenant "${api.tenant.name}"?
 ` + keys.map((k) => `${k}: ${current.get(k).value} -> ${values[k]}`).join("\n"));
@@ -6077,7 +6599,7 @@ function textconvFile(path) {
 }
 
 // dist/version.js
-var VERSION = "0.9.0-beta.0";
+var VERSION = "0.9.0-beta.1";
 
 // dist/index.js
 if (process.argv[2] === "textconv") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cpi-saper-dev-mcp",
-  "version": "0.9.0-beta.0",
+  "version": "0.9.0-beta.1",
   "description": "MCP server that lets an AI agent develop SAP Cloud Integration (CPI) content on development tenants: edit iFlows locally, check, push, deploy and test",
   "keywords": [
     "mcp",
@@ -49,6 +49,6 @@
     "saxon-js": "2.7.0"
   },
   "devDependencies": {
-    "@cpi-saper-dev-mcp/core": "0.9.0-beta.0"
+    "@cpi-saper-dev-mcp/core": "0.9.0-beta.1"
   }
 }