@nmakarov/cli-toolkit 0.69.0 → 0.71.0

package/dist/cli-runner.js

@@ -94,9 +94,48 @@ var init_components = __esm({
   }
 });
 
+// src/screen/scrollbar.js
+function scrollbarGlyphs(viewportRows, totalLines, scrollTop) {
+  const view = Math.max(1, Math.floor(viewportRows));
+  const total = Math.max(0, Math.floor(totalLines));
+  if (total <= view) return null;
+  const maxScroll = total - view;
+  const thumbSize = Math.max(1, Math.round(view / total * view));
+  const travel = Math.max(0, view - thumbSize);
+  const s = Math.min(Math.max(0, Math.floor(scrollTop)), maxScroll);
+  const thumbStart = maxScroll === 0 ? 0 : Math.round(s / maxScroll * travel);
+  const glyphs = [];
+  for (let i = 0; i < view; i++) {
+    glyphs.push(i >= thumbStart && i < thumbStart + thumbSize ? BAR_THUMB : BAR_TRACK);
+  }
+  return glyphs;
+}
+var BAR_THUMB, BAR_TRACK, PAGE_SCROLL_KEY_BINDINGS;
+var init_scrollbar = __esm({
+  "src/screen/scrollbar.js"() {
+    BAR_THUMB = "#";
+    BAR_TRACK = "|";
+    PAGE_SCROLL_KEY_BINDINGS = [
+      { key: "upArrow", meta: true, caption: "page", action: "pageUp", order: 0 },
+      { key: "downArrow", meta: true, caption: "page", action: "pageDown", order: 0 },
+      { key: "upArrow", ctrl: true, caption: "page", action: "pageUp", order: 0 },
+      { key: "downArrow", ctrl: true, caption: "page", action: "pageDown", order: 0 },
+      { key: "pageUp", caption: "page", action: "pageUp", order: 0 },
+      { key: "pageDown", caption: "page", action: "pageDown", order: 0 }
+    ];
+  }
+});
+
 // src/screen/list-components.js
 import React, { useState, useEffect, useRef, createElement } from "react";
 import { Box as Box2, Text as Text2 } from "ink";
+function clipNameForScrollbar(name, needsBar) {
+  if (!needsBar || name == null) return name;
+  const s = String(name);
+  if (s.length <= 1) return s;
+  if (/\s$/.test(s)) return s.slice(0, -1);
+  return s;
+}
 function MultiColumnListComponent({ items, ctx, selectedIndexRef }) {
   const [, forceUpdate] = useState({});
   const termWidth = (process.stdout.columns || 80) - 8;
@@ -310,17 +349,42 @@ function ListComponent({ items, ctx, selectedIndexRef, renderItem, getTitle, sor
     });
     ctx.setAction("scrollUp", () => {
       const { scrollOffset: currentScrollOffset } = scrollStateRef.current;
-      const newScrollOffset = Math.max(0, currentScrollOffset - 1);
-      setScrollOffset(newScrollOffset);
+      setScrollOffset(Math.max(0, currentScrollOffset - 1));
       forceUpdate({});
     });
     ctx.setAction("scrollDown", () => {
       const { scrollOffset: currentScrollOffset, maxHeight: currentMaxHeight, totalItems } = scrollStateRef.current;
       const currentMaxScrollOffset = Math.max(0, totalItems - currentMaxHeight);
-      const newScrollOffset = Math.min(currentMaxScrollOffset, currentScrollOffset + 1);
-      setScrollOffset(newScrollOffset);
+      setScrollOffset(Math.min(currentMaxScrollOffset, currentScrollOffset + 1));
+      forceUpdate({});
+    });
+    ctx.setAction("pageUp", () => {
+      const { maxHeight: vh } = scrollStateRef.current;
+      const page = Math.max(1, vh || 1);
+      const newIndex = Math.max(0, selectedIndexRef.current - page);
+      selectedIndexRef.current = newIndex;
+      const list = displayItemsRef.current;
+      onSelectionChangeRef.current?.(newIndex, list[newIndex]);
+      setScrollOffset(newIndex);
+      forceUpdate({});
+    });
+    ctx.setAction("pageDown", () => {
+      const { maxHeight: vh, totalItems } = scrollStateRef.current;
+      const page = Math.max(1, vh || 1);
+      const maxIndex = Math.max(0, totalItems - 1);
+      const newIndex = Math.min(maxIndex, selectedIndexRef.current + page);
+      selectedIndexRef.current = newIndex;
+      const list = displayItemsRef.current;
+      onSelectionChangeRef.current?.(newIndex, list[newIndex]);
+      const maxScroll = Math.max(0, totalItems - page);
+      setScrollOffset(Math.min(maxScroll, Math.max(0, newIndex - page + 1)));
       forceUpdate({});
     });
+    const navBindings = [
+      { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
+      { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 },
+      ...PAGE_SCROLL_KEY_BINDINGS
+    ];
     if (sortable) {
       ctx.setAction("toggleSort", () => {
         const nextSort = sortOrder === "none" ? "asc" : sortOrder === "asc" ? "desc" : "none";
@@ -367,8 +431,7 @@ function ListComponent({ items, ctx, selectedIndexRef, renderItem, getTitle, sor
         }
       };
       ctx.setKeyBinding([
-        { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
-        { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 },
+        ...navBindings,
         {
           key: "s",
           caption: sortCaption,
@@ -378,47 +441,47 @@ function ListComponent({ items, ctx, selectedIndexRef, renderItem, getTitle, sor
       ]);
       ctx.update();
     } else {
-      ctx.setKeyBinding([
-        { key: "upArrow", caption: "navigate", action: "moveUp", order: 0 },
-        { key: "downArrow", caption: "navigate", action: "moveDown", order: 0 }
-      ]);
+      ctx.setKeyBinding(navBindings);
     }
   }, [sortOrder, sortable]);
   const selectedIndex = selectedIndexRef.current;
+  const needsBar = displayItems.length > effectiveMaxHeight;
+  const barGlyphs = needsBar ? scrollbarGlyphs(effectiveMaxHeight, displayItems.length, clampedScrollOffset) : null;
+  const appendBar = (rowContent, displayIndex) => {
+    if (!barGlyphs) return rowContent;
+    const glyph = barGlyphs[displayIndex] ?? BAR_TRACK;
+    return h2(
+      Box2,
+      { flexDirection: "row" },
+      rowContent,
+      h2(Text2, { color: glyph === BAR_THUMB ? "cyan" : "gray" }, glyph)
+    );
+  };
   const defaultRenderItem = (item, isSelected, displayIndex, actualIndex) => {
     const isFirstVisible = displayIndex === 0;
     const isLastVisible = displayIndex === visibleItems.length - 1;
-    let arrowPrefix = "";
-    let selectionPrefix = "";
-    if (isFirstVisible && canScrollUp) {
-      arrowPrefix = "\u2191 ";
-    } else if (isLastVisible && canScrollDown) {
-      arrowPrefix = "\u2193 ";
-    } else {
-      arrowPrefix = "  ";
-    }
-    if (isSelected) {
-      selectionPrefix = selectionMarker;
-    } else {
-      selectionPrefix = " ".repeat(selectionMarker.length);
+    let arrowPrefix = "  ";
+    if (!needsBar) {
+      if (isFirstVisible && canScrollUp) arrowPrefix = "\u2191 ";
+      else if (isLastVisible && canScrollDown) arrowPrefix = "\u2193 ";
     }
+    const selectionPrefix = isSelected ? selectionMarker : " ".repeat(selectionMarker.length);
+    const label = clipNameForScrollbar(item.name, needsBar);
     return h2(
       Box2,
       { flexDirection: "row" },
-      // Arrow (clickable if functional, not highlighted)
-      h2(Text2, {
-        key: `arrow-${actualIndex}`,
-        color: "white"
-      }, arrowPrefix),
-      // Selection marker space (always same width, not highlighted) 
+      h2(Text2, { key: `arrow-${actualIndex}`, color: "white" }, arrowPrefix),
       h2(Text2, { key: `marker-${actualIndex}`, color: "white" }, selectionPrefix),
-      // Item name (highlighted if selected)
-      h2(Text2, {
-        key: `name-${actualIndex}`,
-        color: isSelected ? "black" : "white",
-        backgroundColor: isSelected ? "cyan" : void 0,
-        bold: isSelected
-      }, item.name)
+      h2(
+        Text2,
+        {
+          key: `name-${actualIndex}`,
+          color: isSelected ? "black" : "white",
+          backgroundColor: isSelected ? "cyan" : void 0,
+          bold: isSelected
+        },
+        label
+      )
     );
   };
   const itemRenderer = renderItem || defaultRenderItem;
@@ -431,42 +494,32 @@ function ListComponent({ items, ctx, selectedIndexRef, renderItem, getTitle, sor
       if (renderItem) {
         const isFirstVisible = displayIndex === 0;
         const isLastVisible = displayIndex === visibleItems.length - 1;
-        let arrowPrefix = "";
-        let selectionPrefix = "";
-        if (isFirstVisible && canScrollUp) {
-          arrowPrefix = "\u2191 ";
-        } else if (isLastVisible && canScrollDown) {
-          arrowPrefix = "\u2193 ";
-        } else {
-          arrowPrefix = "  ";
-        }
-        if (isSelected) {
-          selectionPrefix = selectionMarker;
-        } else {
-          selectionPrefix = " ".repeat(selectionMarker.length);
+        let arrowPrefix = "  ";
+        if (!needsBar) {
+          if (isFirstVisible && canScrollUp) arrowPrefix = "\u2191 ";
+          else if (isLastVisible && canScrollDown) arrowPrefix = "\u2193 ";
         }
+        const selectionPrefix = isSelected ? selectionMarker : " ".repeat(selectionMarker.length);
+        const clipped = needsBar ? { ...item, name: clipNameForScrollbar(item.name, true) } : item;
+        const row = h2(
+          Box2,
+          { flexDirection: "row" },
+          h2(Text2, { key: `arrow-${actualIndex}`, color: "white" }, arrowPrefix),
+          h2(Text2, { key: `marker-${actualIndex}`, color: "white" }, selectionPrefix),
+          renderItem(clipped, isSelected, displayIndex)
+        );
         return h2(ScreenRow, {
           key: `item-${actualIndex}`,
-          children: h2(
-            Box2,
-            { flexDirection: "row" },
-            // Arrow (clickable if functional, not highlighted)
-            h2(Text2, {
-              key: `arrow-${actualIndex}`,
-              color: "white"
-            }, arrowPrefix),
-            // Selection marker space (always same width, not highlighted) 
-            h2(Text2, { key: `marker-${actualIndex}`, color: "white" }, selectionPrefix),
-            // Custom rendered content
-            renderItem(item, isSelected, displayIndex)
-          )
-        });
-      } else {
-        return h2(ScreenRow, {
-          key: `item-${actualIndex}`,
-          children: itemRenderer(item, isSelected, displayIndex, actualIndex)
+          children: appendBar(row, displayIndex)
         });
       }
+      return h2(ScreenRow, {
+        key: `item-${actualIndex}`,
+        children: appendBar(
+          itemRenderer(item, isSelected, displayIndex, actualIndex),
+          displayIndex
+        )
+      });
     })
   );
 }
@@ -474,6 +527,7 @@ var h2;
 var init_list_components = __esm({
   "src/screen/list-components.js"() {
     init_components();
+    init_scrollbar();
     h2 = createElement;
   }
 });
@@ -968,21 +1022,6 @@ function wrapTextLines(text, cols) {
   }
   return out;
 }
-function scrollbarGlyphs(viewportRows, totalLines, scrollTop) {
-  const view = Math.max(1, Math.floor(viewportRows));
-  const total = Math.max(0, Math.floor(totalLines));
-  if (total <= view) return null;
-  const maxScroll = total - view;
-  const thumbSize = Math.max(1, Math.round(view / total * view));
-  const travel = Math.max(0, view - thumbSize);
-  const s = Math.min(Math.max(0, Math.floor(scrollTop)), maxScroll);
-  const thumbStart = maxScroll === 0 ? 0 : Math.round(s / maxScroll * travel);
-  const glyphs = [];
-  for (let i = 0; i < view; i++) {
-    glyphs.push(i >= thumbStart && i < thumbStart + thumbSize ? BAR_THUMB : BAR_TRACK);
-  }
-  return glyphs;
-}
 function padEndVisible(s, w) {
   const t = String(s ?? "");
   if (t.length >= w) return t.slice(0, w);
@@ -1083,22 +1122,17 @@ function ScrollableText({
     ...rowNodes
   );
 }
-var h5, BAR_THUMB, BAR_TRACK, SCROLL_KEYS;
+var h5, SCROLL_KEYS;
 var init_scrollable_text = __esm({
   "src/screen/scrollable-text.js"() {
     init_components();
+    init_scrollbar();
+    init_scrollbar();
     h5 = createElement2;
-    BAR_THUMB = "#";
-    BAR_TRACK = "|";
     SCROLL_KEYS = [
       { key: "upArrow", caption: "scroll", action: "scrollUp", order: 0 },
       { key: "downArrow", caption: "scroll", action: "scrollDown", order: 0 },
-      { key: "upArrow", meta: true, caption: "page", action: "pageUp", order: 0 },
-      { key: "downArrow", meta: true, caption: "page", action: "pageDown", order: 0 },
-      { key: "upArrow", ctrl: true, caption: "page", action: "pageUp", order: 0 },
-      { key: "downArrow", ctrl: true, caption: "page", action: "pageDown", order: 0 },
-      { key: "pageUp", caption: "page", action: "pageUp", order: 0 },
-      { key: "pageDown", caption: "page", action: "pageDown", order: 0 }
+      ...PAGE_SCROLL_KEY_BINDINGS
     ];
   }
 });
@@ -1234,6 +1268,8 @@ var init_footer_builder = __esm({
 // src/screen/index.js
 var screen_exports = {};
 __export(screen_exports, {
+  BAR_THUMB: () => BAR_THUMB,
+  BAR_TRACK: () => BAR_TRACK,
   Box: () => Box5,
   Divider: () => Divider,
   FooterPresets: () => FooterPresets,
@@ -1243,6 +1279,7 @@ __export(screen_exports, {
   ListItem: () => ListItem,
   MultiColumnListComponent: () => MultiColumnListComponent,
   MultiColumnListWithPreviewComponent: () => MultiColumnListWithPreviewComponent,
+  PAGE_SCROLL_KEY_BINDINGS: () => PAGE_SCROLL_KEY_BINDINGS,
   React: () => React2,
   ScreenBody: () => ScreenBody,
   ScreenContainer: () => ScreenContainer,
@@ -1298,6 +1335,7 @@ var init_screen = __esm({
     init_components();
     init_ui_elements();
     init_scrollable_text();
+    init_scrollbar();
     init_key_bindings();
     init_utils();
     init_footer_builder();
@@ -4150,12 +4188,13 @@ function tasksSchemaSpec(queueName = "tasks") {
     }
   };
 }
-function taskHistoryInsertFromQueueRow(row, overrides) {
+function taskHistoryInsertFromQueueRow(row, overrides = {}) {
   const { id, ...snapshot } = row;
-  void id;
+  const opid = overrides.opid !== void 0 ? overrides.opid : snapshot.opid != null && String(snapshot.opid).trim() !== "" ? snapshot.opid : id;
   return {
     ...snapshot,
-    ...overrides
+    ...overrides,
+    opid
   };
 }
 async function ensureTaskTables(context, options = {}) {
@@ -6455,69 +6494,6 @@ var TaskStopRunner = class extends AbstractTask {
   }
 };
 
-// src/tasks/coreTasks/TaskGetLogs.js
-var TaskGetLogs = class extends AbstractTask {
-  /**
-   * @param {object} context
-   * @param {Record<string, unknown>} [overrides]
-   * @returns {Promise<{ source: string, resource: string, tail: number, afterTs?: string }>}
-   */
-  static async resolveCustomParams(context, overrides = {}) {
-    const merged = AbstractTask._mergeTypedParams(context, "task-get-logs", {
-      source: "string",
-      resource: "string",
-      tail: "number default 100",
-      afterTs: "string"
-    }, overrides);
-    const source = typeof merged.source === "string" ? merged.source.trim() : "";
-    const resource = typeof merged.resource === "string" ? merged.resource.trim() : "";
-    if (!source) throw new ParamError('getLogs: param "source" is required');
-    if (!resource) throw new ParamError('getLogs: param "resource" is required');
-    let tail = Number(merged.tail);
-    if (!Number.isFinite(tail) || tail < 1) tail = 100;
-    tail = Math.min(1e4, Math.max(1, Math.floor(tail)));
-    const out = { source, resource, tail };
-    if (typeof merged.afterTs === "string" && merged.afterTs.trim()) {
-      out.afterTs = merged.afterTs.trim();
-    }
-    return out;
-  }
-  /**
-   * @param {unknown} _reportProgress Unused (single-shot read, no progress events).
-   * @returns {Promise<{ success: boolean, results: unknown }>}
-   */
-  async run(_reportProgress) {
-    const p = this.task.params ?? {};
-    const source = String(p.source ?? "").trim();
-    const resource = String(p.resource ?? "").trim();
-    const tail = Math.max(1, Math.min(1e4, Number(p.tail) > 0 ? Number(p.tail) : 100));
-    const afterTs = p.afterTs != null && String(p.afterTs).trim() ? String(p.afterTs).trim() : null;
-    if (!source || !resource) {
-      return {
-        success: false,
-        results: { error: 'getLogs requires params "source" and "resource"' }
-      };
-    }
-    try {
-      const { records, latestTs } = await readTaskIpcLogsSnapshot(this.context, {
-        source,
-        resource,
-        tail,
-        afterTs
-      });
-      return {
-        success: true,
-        results: { records, latestTs, source, resource }
-      };
-    } catch (e) {
-      return {
-        success: false,
-        results: { error: e?.message ?? String(e) }
-      };
-    }
-  }
-};
-
 // src/tasks/runtimeParams.js
 var LOOP_RUNTIME_KEYS = ["maxParallel", "pollMs", "claimJitterMs", "scanLimit"];
 var LOGGER_RUNTIME_KEYS = [
@@ -6531,7 +6507,69 @@ var LOGGER_RUNTIME_KEYS = [
   "progressWithTimes",
   "progressThrottleMs"
 ];
-var CONTROL_LANE_TASK_NAMES = ["stopRunner", "stop", "setRuntimeParam", "setRunnerParam"];
+var DEFAULT_RUNTIME_PARAM_SPECS = [
+  {
+    key: "maxParallel",
+    type: "number",
+    label: "Max parallel",
+    description: "Worker-lane concurrency (how many tasks claim at once)"
+  },
+  {
+    key: "pollMs",
+    type: "number",
+    label: "Poll ms",
+    description: "Idle poll interval between claim attempts"
+  },
+  {
+    key: "claimJitterMs",
+    type: "number",
+    label: "Claim jitter ms",
+    description: "Random delay before worker claims (0 = off)"
+  },
+  {
+    key: "scanLimit",
+    type: "number",
+    label: "Scan limit",
+    description: "Max idle rows scanned per claim attempt"
+  }
+];
+function mergeRuntimeParamSpecs(extra) {
+  const byKey = new Map(DEFAULT_RUNTIME_PARAM_SPECS.map((s) => [s.key, { ...s }]));
+  if (Array.isArray(extra)) {
+    for (const raw of extra) {
+      if (!raw || typeof raw !== "object") continue;
+      const key = String(raw.key ?? "").trim();
+      if (!key) continue;
+      const prev = byKey.get(key) ?? {};
+      const type = ["number", "boolean", "string"].includes(raw.type) ? raw.type : prev.type ?? "string";
+      byKey.set(key, {
+        key,
+        type,
+        label: String(raw.label ?? prev.label ?? key),
+        description: raw.description != null ? String(raw.description) : prev.description != null ? String(prev.description) : void 0
+      });
+    }
+  }
+  return Array.from(byKey.values());
+}
+function runtimeValuesForSpecs(context, specs = DEFAULT_RUNTIME_PARAM_SPECS) {
+  const rt = ensureTasksRuntime(context);
+  const out = {};
+  for (const s of specs) {
+    if (rt[s.key] !== void 0) out[s.key] = rt[s.key];
+  }
+  return out;
+}
+var CONTROL_LANE_TASK_NAMES = [
+  "stopRunner",
+  "stop",
+  "pauseRunner",
+  "pause",
+  "unpauseRunner",
+  "unpause",
+  "setRuntimeParam",
+  "setRunnerParam"
+];
 function controlLaneTaskNames(extra) {
   const names = [...CONTROL_LANE_TASK_NAMES];
   if (extra == null || extra === "") return names;
@@ -6594,6 +6632,7 @@ function ensureTasksRuntime(context, seed = {}) {
   if (rt.pollMs === void 0) rt.pollMs = seed.pollMs ?? 1e3;
   if (rt.claimJitterMs === void 0) rt.claimJitterMs = seed.claimJitterMs ?? 0;
   if (rt.scanLimit === void 0) rt.scanLimit = seed.scanLimit ?? 100;
+  if (rt.paused === void 0) rt.paused = seed.paused === true;
   return rt;
 }
 async function applyRuntimeParam(context, key, value) {
@@ -6617,12 +6656,15 @@ async function applyRuntimeParam(context, key, value) {
   const reg = context.servicesRegistry;
   if (reg?.rowId && reg?.registryTable) {
     try {
-      const loopSnapshot = {};
+      const specs = Array.isArray(context.tasksRuntimeParamSpecs) ? context.tasksRuntimeParamSpecs : DEFAULT_RUNTIME_PARAM_SPECS;
+      const runtimeSnapshot = runtimeValuesForSpecs(context, specs);
       for (const lk of LOOP_RUNTIME_KEYS) {
-        if (runtime[lk] !== void 0) loopSnapshot[lk] = runtime[lk];
+        if (runtime[lk] !== void 0 && runtimeSnapshot[lk] === void 0) {
+          runtimeSnapshot[lk] = runtime[lk];
+        }
       }
       await updateServicesRegistryMetadata(context, reg, {
-        runtime: loopSnapshot,
+        runtime: runtimeSnapshot,
         runtimeUpdatedAt: (/* @__PURE__ */ new Date()).toISOString()
       });
       applied.push("servicesRegistry");
@@ -6658,6 +6700,140 @@ function readLoopRuntime(context) {
   };
 }
 
+// src/tasks/coreTasks/TaskPauseRunner.js
+async function applyRunnerPaused(context, paused) {
+  const runtime = ensureTasksRuntime(context);
+  const was = runtime.paused === true;
+  runtime.paused = paused === true;
+  const registry = context.servicesRegistry;
+  if (registry && typeof registry === "object") {
+    await updateServicesRegistryMetadata(context, registry, {
+      paused: runtime.paused,
+      pausedAt: runtime.paused ? (/* @__PURE__ */ new Date()).toISOString() : null
+    });
+  }
+  const message = runtime.paused ? was ? "Runner already paused (no new worker tasks)." : "Runner paused: finishing in-flight work; no new worker tasks until unpause." : was ? "Runner unpaused: claiming worker tasks again." : "Runner already running (not paused).";
+  context.logger?.warn?.(
+    runtime.paused ? `[TaskPauseRunner] ${message}` : `[TaskUnpauseRunner] ${message}`
+  );
+  return {
+    success: true,
+    results: {
+      paused: runtime.paused,
+      message
+    }
+  };
+}
+var TaskPauseRunner = class extends AbstractTask {
+  static taskName = "pauseRunner";
+  static description = "Pause a runner: finish in-flight tasks, claim no new worker tasks until unpaused";
+  static aliases = ["pause"];
+  static defaultWaitForResult = true;
+  /**
+   * @param {object} context
+   * @param {Record<string, unknown>} [overrides]
+   * @returns {Promise<object>}
+   */
+  static async resolveParams(context, overrides = {}) {
+    const main = await super.resolveParams(context, overrides);
+    if (!main.serviceName) {
+      throw new ParamError(
+        "pause/pauseRunner requires --serviceName (registry instance name; optional --serviceGroup, --instanceNumber, --serverName to narrow targeting)"
+      );
+    }
+    return main;
+  }
+  async run() {
+    return applyRunnerPaused(this.context, true);
+  }
+};
+var TaskUnpauseRunner = class extends AbstractTask {
+  static taskName = "unpauseRunner";
+  static description = "Unpause a runner: resume claiming worker tasks";
+  static aliases = ["unpause"];
+  static defaultWaitForResult = true;
+  /**
+   * @param {object} context
+   * @param {Record<string, unknown>} [overrides]
+   * @returns {Promise<object>}
+   */
+  static async resolveParams(context, overrides = {}) {
+    const main = await super.resolveParams(context, overrides);
+    if (!main.serviceName) {
+      throw new ParamError(
+        "unpause/unpauseRunner requires --serviceName (registry instance name; optional --serviceGroup, --instanceNumber, --serverName to narrow targeting)"
+      );
+    }
+    return main;
+  }
+  async run() {
+    return applyRunnerPaused(this.context, false);
+  }
+};
+
+// src/tasks/coreTasks/TaskGetLogs.js
+var TaskGetLogs = class extends AbstractTask {
+  /**
+   * @param {object} context
+   * @param {Record<string, unknown>} [overrides]
+   * @returns {Promise<{ source: string, resource: string, tail: number, afterTs?: string }>}
+   */
+  static async resolveCustomParams(context, overrides = {}) {
+    const merged = AbstractTask._mergeTypedParams(context, "task-get-logs", {
+      source: "string",
+      resource: "string",
+      tail: "number default 100",
+      afterTs: "string"
+    }, overrides);
+    const source = typeof merged.source === "string" ? merged.source.trim() : "";
+    const resource = typeof merged.resource === "string" ? merged.resource.trim() : "";
+    if (!source) throw new ParamError('getLogs: param "source" is required');
+    if (!resource) throw new ParamError('getLogs: param "resource" is required');
+    let tail = Number(merged.tail);
+    if (!Number.isFinite(tail) || tail < 1) tail = 100;
+    tail = Math.min(1e4, Math.max(1, Math.floor(tail)));
+    const out = { source, resource, tail };
+    if (typeof merged.afterTs === "string" && merged.afterTs.trim()) {
+      out.afterTs = merged.afterTs.trim();
+    }
+    return out;
+  }
+  /**
+   * @param {unknown} _reportProgress Unused (single-shot read, no progress events).
+   * @returns {Promise<{ success: boolean, results: unknown }>}
+   */
+  async run(_reportProgress) {
+    const p = this.task.params ?? {};
+    const source = String(p.source ?? "").trim();
+    const resource = String(p.resource ?? "").trim();
+    const tail = Math.max(1, Math.min(1e4, Number(p.tail) > 0 ? Number(p.tail) : 100));
+    const afterTs = p.afterTs != null && String(p.afterTs).trim() ? String(p.afterTs).trim() : null;
+    if (!source || !resource) {
+      return {
+        success: false,
+        results: { error: 'getLogs requires params "source" and "resource"' }
+      };
+    }
+    try {
+      const { records, latestTs } = await readTaskIpcLogsSnapshot(this.context, {
+        source,
+        resource,
+        tail,
+        afterTs
+      });
+      return {
+        success: true,
+        results: { records, latestTs, source, resource }
+      };
+    } catch (e) {
+      return {
+        success: false,
+        results: { error: e?.message ?? String(e) }
+      };
+    }
+  }
+};
+
 // src/tasks/coreTasks/TaskSetRuntimeParam.js
 var TaskSetRuntimeParam = class extends AbstractTask {
   static defaultWaitForResult = true;
@@ -6813,7 +6989,7 @@ var TasksRegistry = class _TasksRegistry {
    * @returns {TasksRegistry}
    */
   static withCoreTasks() {
-    return new _TasksRegistry().add("ping", TaskPing).add("sampleProcess", TaskSampleProcess).add("shellCommand", TaskShellCommand).add("systemInfo", TaskSystemInfo).add("info", TaskSystemInfo).add("taskSumAB", TaskSumAB).add("stopRunner", TaskStopRunner).add("stop", TaskStopRunner).add("getLogs", TaskGetLogs).add("setRuntimeParam", TaskSetRuntimeParam).add("setRunnerParam", TaskSetRuntimeParam);
+    return new _TasksRegistry().add("ping", TaskPing).add("sampleProcess", TaskSampleProcess).add("shellCommand", TaskShellCommand).add("systemInfo", TaskSystemInfo).add("info", TaskSystemInfo).add("taskSumAB", TaskSumAB).add("stopRunner", TaskStopRunner).add("stop", TaskStopRunner).add("pauseRunner", TaskPauseRunner).add("pause", TaskPauseRunner).add("unpauseRunner", TaskUnpauseRunner).add("unpause", TaskUnpauseRunner).add("getLogs", TaskGetLogs).add("setRuntimeParam", TaskSetRuntimeParam).add("setRunnerParam", TaskSetRuntimeParam);
   }
   /**
    * Register a single task class under a name. Overwrites any previous entry.
@@ -7171,17 +7347,25 @@ async function runTasksLoop(context, options) {
   if (hbGroup) {
     const hbIntervalMs = options.runnerHeartbeatIntervalMs ?? 1e4;
     const staleMs = options.runnerHeartbeatStaleMs ?? 45e3;
-    const loop0 = readLoopRuntime(context);
+    const runtimeParamSpecs = mergeRuntimeParamSpecs(options.runnerRuntimeParams);
+    context.tasksRuntimeParamSpecs = runtimeParamSpecs;
     const defaultMeta = {
       component: "tasks-runner",
       allowedTasks: allowedTasks?.length ? allowedTasks.join(",") : "all",
-      runtime: {
-        maxParallel: loop0.maxParallel,
-        pollMs: loop0.pollMs,
-        claimJitterMs: loop0.claimJitterMs,
-        scanLimit: loop0.scanLimit
-      }
+      paused: false,
+      runtimeParams: runtimeParamSpecs,
+      runtime: runtimeValuesForSpecs(context, runtimeParamSpecs)
+    };
+    const metadata = {
+      ...defaultMeta,
+      ...options.runnerMetadata && typeof options.runnerMetadata === "object" ? options.runnerMetadata : {}
     };
+    if (!Array.isArray(metadata.runtimeParams) || metadata.runtimeParams.length === 0) {
+      metadata.runtimeParams = defaultMeta.runtimeParams;
+    }
+    if (!metadata.runtime || typeof metadata.runtime !== "object") {
+      metadata.runtime = defaultMeta.runtime;
+    }
     registryReg = await registerInServicesRegistry(context, {
       queueName,
       target,
@@ -7191,7 +7375,7 @@ async function runTasksLoop(context, options) {
       staleMs,
       groupMaxInstances: options.runnerGroupMaxInstances,
       enforceMaxInstances: options.runnerEnforceMaxInstances ?? true,
-      metadata: options.runnerMetadata ?? defaultMeta
+      metadata
     });
     context.servicesRegistry = registryReg;
     runnerIdentity = {
@@ -7241,28 +7425,38 @@ async function runTasksLoop(context, options) {
       if (claimJitterMs > 0) {
         await sleepMs(Math.floor(Math.random() * (claimJitterMs + 1)));
       }
-      while (runningPromises.size < maxParallel) {
-        const claimed = await claimNextRunnableTask(
-          context,
-          tasksTable,
-          target,
-          registry,
-          scanLimit,
-          allowedTasks,
-          runnerIdentity
-        );
-        if (!claimed) break;
-        const p = executeClaimedTask(context, tasksTable, historyTable, claimed, registry, runningTaskInstances).then(async (outcome) => {
-          if (outcome.stopRunnerRequested && !stopRequested) {
-            stopRequested = true;
-            stopAllowanceMs = outcome.stopAllowanceMs || stopAllowanceMs;
-            context.tasksRunnerStop = true;
-            await signalRunningTasksStop(context, runningTaskInstances, stopAllowanceMs);
-          }
-        }).finally(() => {
-          runningPromises.delete(p);
-        });
-        runningPromises.add(p);
+      const paused = context.tasksRuntime?.paused === true;
+      if (!paused) {
+        while (runningPromises.size < maxParallel) {
+          const claimed = await claimNextRunnableTask(
+            context,
+            tasksTable,
+            target,
+            registry,
+            scanLimit,
+            allowedTasks,
+            runnerIdentity
+          );
+          if (!claimed) break;
+          const p = executeClaimedTask(
+            context,
+            tasksTable,
+            historyTable,
+            claimed,
+            registry,
+            runningTaskInstances
+          ).then(async (outcome) => {
+            if (outcome.stopRunnerRequested && !stopRequested) {
+              stopRequested = true;
+              stopAllowanceMs = outcome.stopAllowanceMs || stopAllowanceMs;
+              context.tasksRunnerStop = true;
+              await signalRunningTasksStop(context, runningTaskInstances, stopAllowanceMs);
+            }
+          }).finally(() => {
+            runningPromises.delete(p);
+          });
+          runningPromises.add(p);
+        }
       }
       const wakePromises = [...runningPromises];
       if (runningControlPromise) {