@ai-setting/roy-agent-cli 1.5.111 → 1.5.113

package/dist/bin/roy-agent.js

@@ -7427,7 +7427,7 @@ var require_dist = __commonJS((exports) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@ai-setting/roy-agent-cli",
-    version: "1.5.111",
+    version: "1.5.113",
     type: "module",
     description: "CLI for roy-agent - Non-interactive command execution",
     main: "./dist/index.js",
@@ -9270,6 +9270,7 @@ Task #${taskId}`;
       message += `
 结果: ${truncatedResult}`;
     }
+    message += this.appendSubSessionId(payload);
     return message;
   }
   formatTaskFailed(payload) {
@@ -9292,6 +9293,7 @@ Task #${taskId}`;
       message += `
 错误: ${truncatedError}`;
     }
+    message += this.appendSubSessionId(payload);
     return message;
   }
   formatTaskTimeout(payload) {
@@ -9308,6 +9310,7 @@ bgprocess: ${bgProcessId}`;
       message += `
 Task #${taskId}`;
     }
+    message += this.appendSubSessionId(payload);
     return message;
   }
   formatTaskStopped(payload) {
@@ -9324,8 +9327,16 @@ bgprocess: ${bgProcessId}`;
       message += `
 Task #${taskId}`;
     }
+    message += this.appendSubSessionId(payload);
     return message;
   }
+  appendSubSessionId(payload) {
+    if (payload.subSessionId) {
+      return `
+subSessionId: ${payload.subSessionId}`;
+    }
+    return "";
+  }
   formatGeneric(event) {
     return `${this.prefix} 收到事件: ${event.type}`;
   }
@@ -10810,11 +10821,169 @@ var InteractiveCommand = createInteractiveCommand();
 
 // src/commands/sessions/list.ts
 import chalk6 from "chalk";
+
+// src/commands/sessions/session-graph.ts
+function buildSessionTree(sessions) {
+  const byId = new Map;
+  const childrenByParent = new Map;
+  for (const s of sessions) {
+    byId.set(s.id, s);
+    const pid = s.parentSessionId;
+    if (pid !== null && pid !== undefined && pid !== "") {
+      const bucket = childrenByParent.get(pid);
+      if (bucket)
+        bucket.push(s);
+      else
+        childrenByParent.set(pid, [s]);
+    }
+  }
+  const cycleMembers = new Set;
+  const consumed = new Set;
+  function build(session, ancestorStack) {
+    const node = { session, children: [] };
+    const candidates = childrenByParent.get(session.id) ?? [];
+    for (const candidate of candidates) {
+      if (ancestorStack.has(candidate.id)) {
+        cycleMembers.add(candidate.id);
+        cycleMembers.add(session.id);
+        continue;
+      }
+      if (consumed.has(candidate.id)) {
+        continue;
+      }
+      consumed.add(candidate.id);
+      const nextStack = new Set(ancestorStack);
+      nextStack.add(session.id);
+      const child = build(candidate, nextStack);
+      node.children.push(child);
+    }
+    return node;
+  }
+  const roots = [];
+  const orphans = [];
+  for (const s of sessions) {
+    const parentId = s.parentSessionId;
+    const hasParentId = parentId !== null && parentId !== undefined && parentId !== "";
+    if (!hasParentId) {
+      if (consumed.has(s.id))
+        continue;
+      consumed.add(s.id);
+      const node = build(s, new Set([s.id]));
+      roots.push(node);
+    } else if (!byId.has(parentId)) {
+      orphans.push(s);
+    }
+  }
+  if (consumed.size + orphans.length < sessions.length) {
+    for (const s of sessions) {
+      if (consumed.has(s.id))
+        continue;
+      if (orphans.includes(s))
+        continue;
+      const visited = new Set;
+      let cur = s;
+      while (cur) {
+        if (visited.has(cur.id)) {
+          for (const v of visited)
+            cycleMembers.add(v);
+          cycleMembers.add(s.id);
+          break;
+        }
+        visited.add(cur.id);
+        const pid = cur.parentSessionId;
+        if (pid === null || pid === undefined || pid === "")
+          break;
+        cur = byId.get(pid);
+      }
+      consumed.add(s.id);
+      const node = build(s, new Set([s.id]));
+      roots.push(node);
+    }
+  }
+  return { roots, orphans, cycles: cycleMembers };
+}
+var TREE_BRANCH = "├── ";
+var TREE_LAST = "└── ";
+var TREE_VERTICAL = "│   ";
+var TREE_EMPTY = "    ";
+function renderSessionTree(tree, options = {}) {
+  if (tree.roots.length === 0 && tree.orphans.length === 0) {
+    return "No sessions.";
+  }
+  const lines = ["Session Tree"];
+  for (let i = 0;i < tree.roots.length; i++) {
+    const isLast = i === tree.roots.length - 1 && tree.orphans.length === 0;
+    renderNode(tree.roots[i], "", isLast, lines, tree.cycles, options);
+  }
+  if (tree.orphans.length > 0) {
+    for (let i = 0;i < tree.orphans.length; i++) {
+      const s = tree.orphans[i];
+      const isLast = i === tree.orphans.length - 1;
+      const branch = isLast ? TREE_LAST : TREE_BRANCH;
+      lines.push(`${branch}${formatNodeLabel(s, true, false, options)}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+function renderNode(node, prefix, isLast, lines, cycles, options) {
+  const branch = isLast ? TREE_LAST : TREE_BRANCH;
+  const isCycle = cycles.has(node.session.id);
+  lines.push(`${prefix}${branch}${formatNodeLabel(node.session, false, isCycle, options)}`);
+  const childPrefix = prefix + (isLast ? TREE_EMPTY : TREE_VERTICAL);
+  for (let i = 0;i < node.children.length; i++) {
+    const isChildLast = i === node.children.length - 1;
+    renderNode(node.children[i], childPrefix, isChildLast, lines, cycles, options);
+  }
+}
+function formatNodeLabel(session, isOrphan, isCycle = false, options = {}) {
+  const idStr = options.useShortId ? shortSessionId(session.id) : session.id;
+  const sourceLabel = inferSourceLabel(session);
+  const status = inferStatus(session);
+  const created = new Date(session.createdAt).toISOString().slice(0, 16).replace("T", " ");
+  const parts = [idStr, sourceLabel];
+  if (status)
+    parts.push(`(${status})`);
+  parts.push(created);
+  let label = parts.join(" ");
+  if (isOrphan)
+    label = `[orphan] ${label}`;
+  if (isCycle)
+    label = `[cycle] ${label}`;
+  return label;
+}
+function shortSessionId(id) {
+  const underscoreIdx = id.indexOf("_");
+  const stripped = underscoreIdx > 0 && underscoreIdx < id.length - 8 ? id.slice(underscoreIdx + 1) : id;
+  return stripped.length > 8 ? stripped.slice(0, 8) : stripped;
+}
+function inferSourceLabel(session) {
+  const meta = session.metadata;
+  const type = meta?.type;
+  if (type === "workflow") {
+    const name = meta?.workflowName;
+    return name ? `workflow/${name}` : "workflow";
+  }
+  if (type === "agent")
+    return "agent";
+  if (type === "subagent" || type === "sub-agent")
+    return "[subagent]";
+  return "chat";
+}
+function inferStatus(session) {
+  const meta = session.metadata;
+  const status = meta?.status;
+  if (typeof status === "string" && status.length > 0)
+    return status;
+  return null;
+}
+
+// src/commands/sessions/list.ts
 var ListCommand = {
   command: "list [options]",
   aliases: ["ls"],
   describe: "列出所有会话",
-  builder: (yargs) => yargs.option("limit", { alias: "n", type: "number", default: 20 }).option("offset", { type: "number", default: 0 }).option("sort", { type: "string", default: "updatedAt" }).option("order", { type: "string", default: "desc" }).option("json", { alias: "j", type: "boolean", default: false }).option("quiet", { alias: "q", type: "boolean", hidden: true }).option("id", { alias: "i", type: "boolean", default: false, description: "显示 Session ID" }).option("type", { alias: "t", type: "string", description: "按 session 类型过滤 (如 workflow)" }).option("status", { alias: "s", type: "string", description: "按状态过滤 (如 running, paused)" }),
+  builder: (yargs) => yargs.option("limit", { alias: "n", type: "number", default: 20 }).option("offset", { type: "number", default: 0 }).option("sort", { type: "string", default: "updatedAt" }).option("order", { type: "string", default: "desc" }).option("json", { alias: "j", type: "boolean", default: false }).option("quiet", { alias: "q", type: "boolean", hidden: true }).option("id", { alias: "i", type: "boolean", default: false, description: "显示 Session ID" }).option("type", { alias: "t", type: "string", description: "按 session 类型过滤 (如 workflow)" }).option("status", { alias: "s", type: "string", description: "按状态过滤 (如 running, paused)" }).option("graph", { alias: "g", type: "boolean", default: false, description: "以层次化树形结构展示 session 父子关系" }).option("short-id", { type: "boolean", default: false, description: "[graph] 用 8 字符截断 id 显示（默认显示完整 sessionId）" }),
   async handler(args) {
     const isQuiet = args.quiet === true;
     if (isQuiet) {
@@ -10855,6 +11024,11 @@ var ListCommand = {
       const sessions = await sessionComponent.list(listOptions);
       const totalCount = await sessionComponent.getCount();
       const activeSessionId = sessionComponent.getActiveSessionId();
+      if (args.graph) {
+        const tree = buildSessionTree(sessions);
+        output.log(renderSessionTree(tree, { useShortId: args.shortId === true }));
+        return;
+      }
       if (args.json) {
         output.json({
           total: sessions.length,
@@ -10869,6 +11043,8 @@ var ListCommand = {
               type: workflowMeta?.type || "chat",
               status: workflowMeta?.status,
               workflowName: workflowMeta?.workflowName,
+              parentSessionId: s.parentSessionId ?? null,
+              parentID: s.parentID ?? null,
               hasCheckpoint: !!s.metadata?.checkpoints?.checkpoints?.length,
               lastCheckpointAt: s.metadata?.checkpoints?.latestCheckpointId,
               createdAt: new Date(s.createdAt).toISOString(),
@@ -10886,6 +11062,7 @@ var ListCommand = {
           chalk6.bold("#"),
           chalk6.bold("Title"),
           chalk6.bold("ID"),
+          chalk6.bold("Parent"),
           hasTypeFilter || hasStatusFilter ? chalk6.bold("Status") : null,
           chalk6.bold("Msgs"),
           chalk6.bold("CP")
@@ -10895,8 +11072,9 @@ var ListCommand = {
           const hasCp = (s.metadata?.checkpoints?.checkpoints?.length ?? 0) > 0;
           const title = s.title.length > 20 ? s.title.slice(0, 17) + "..." : s.title;
           const idStr = s.id;
+          const useShortId = args.shortId === true;
+          const parentStr = s.parentSessionId ? chalk6.gray(useShortId ? shortSessionId(s.parentSessionId) : s.parentSessionId) : chalk6.gray("-");
           const workflowMeta = s.metadata?.type === "workflow" ? s.metadata : null;
-          const typeStr = workflowMeta?.type || "";
           const statusStr = workflowMeta?.status || "";
           let statusDisplay = "";
           if (hasTypeFilter || hasStatusFilter) {
@@ -10907,7 +11085,8 @@ var ListCommand = {
           const cells = [
             marker + " " + (args.offset + i + 1),
             title,
-            chalk6.gray(idStr)
+            chalk6.gray(idStr),
+            parentStr
           ];
           if (hasTypeFilter || hasStatusFilter) {
             cells.push(statusDisplay || chalk6.gray("-"));
@@ -19310,6 +19489,7 @@ import fs5 from "fs";
 import path8 from "path";
 import { createRunWorkflowTool } from "@ai-setting/roy-agent-core/env/workflow/tools";
 import { getTracerProvider as getTracerProvider4, propagation, wrapFunction } from "@ai-setting/roy-agent-core";
+import { isValidSessionId } from "@ai-setting/roy-agent-core/env/session";
 var runWorkflow = wrapFunction(async function runWorkflowImpl(args) {
   const output = new OutputService2;
   const envService = new EnvironmentService(output);
@@ -19381,6 +19561,14 @@ var runWorkflow = wrapFunction(async function runWorkflowImpl(args) {
       parallelLimit: args.parallelLimit,
       timeout: args.timeout
     };
+    const rawEnvParentId = process.env["ROY_PARENT_SESSION_ID"];
+    if (typeof rawEnvParentId === "string" && rawEnvParentId.length > 0) {
+      if (isValidSessionId(rawEnvParentId)) {
+        runOptions.parentSessionId = rawEnvParentId;
+      } else {
+        output.warn(`Ignoring malformed ROY_PARENT_SESSION_ID env value (must match /^[A-Za-z0-9_-]{8,128}$/)`);
+      }
+    }
     if (args.session) {
       const sessionId = args.session;
       output.log(chalk69.blue(`\uD83D\uDD04 Resuming workflow from session: ${sessionId}`));

package/dist/index.js

@@ -7426,7 +7426,7 @@ var require_dist = __commonJS((exports) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@ai-setting/roy-agent-cli",
-    version: "1.5.111",
+    version: "1.5.113",
     type: "module",
     description: "CLI for roy-agent - Non-interactive command execution",
     main: "./dist/index.js",
@@ -9269,6 +9269,7 @@ Task #${taskId}`;
       message += `
 结果: ${truncatedResult}`;
     }
+    message += this.appendSubSessionId(payload);
     return message;
   }
   formatTaskFailed(payload) {
@@ -9291,6 +9292,7 @@ Task #${taskId}`;
       message += `
 错误: ${truncatedError}`;
     }
+    message += this.appendSubSessionId(payload);
     return message;
   }
   formatTaskTimeout(payload) {
@@ -9307,6 +9309,7 @@ bgprocess: ${bgProcessId}`;
       message += `
 Task #${taskId}`;
     }
+    message += this.appendSubSessionId(payload);
     return message;
   }
   formatTaskStopped(payload) {
@@ -9323,8 +9326,16 @@ bgprocess: ${bgProcessId}`;
       message += `
 Task #${taskId}`;
     }
+    message += this.appendSubSessionId(payload);
     return message;
   }
+  appendSubSessionId(payload) {
+    if (payload.subSessionId) {
+      return `
+subSessionId: ${payload.subSessionId}`;
+    }
+    return "";
+  }
   formatGeneric(event) {
     return `${this.prefix} 收到事件: ${event.type}`;
   }
@@ -10809,11 +10820,169 @@ var InteractiveCommand = createInteractiveCommand();
 
 // src/commands/sessions/list.ts
 import chalk6 from "chalk";
+
+// src/commands/sessions/session-graph.ts
+function buildSessionTree(sessions) {
+  const byId = new Map;
+  const childrenByParent = new Map;
+  for (const s of sessions) {
+    byId.set(s.id, s);
+    const pid = s.parentSessionId;
+    if (pid !== null && pid !== undefined && pid !== "") {
+      const bucket = childrenByParent.get(pid);
+      if (bucket)
+        bucket.push(s);
+      else
+        childrenByParent.set(pid, [s]);
+    }
+  }
+  const cycleMembers = new Set;
+  const consumed = new Set;
+  function build(session, ancestorStack) {
+    const node = { session, children: [] };
+    const candidates = childrenByParent.get(session.id) ?? [];
+    for (const candidate of candidates) {
+      if (ancestorStack.has(candidate.id)) {
+        cycleMembers.add(candidate.id);
+        cycleMembers.add(session.id);
+        continue;
+      }
+      if (consumed.has(candidate.id)) {
+        continue;
+      }
+      consumed.add(candidate.id);
+      const nextStack = new Set(ancestorStack);
+      nextStack.add(session.id);
+      const child = build(candidate, nextStack);
+      node.children.push(child);
+    }
+    return node;
+  }
+  const roots = [];
+  const orphans = [];
+  for (const s of sessions) {
+    const parentId = s.parentSessionId;
+    const hasParentId = parentId !== null && parentId !== undefined && parentId !== "";
+    if (!hasParentId) {
+      if (consumed.has(s.id))
+        continue;
+      consumed.add(s.id);
+      const node = build(s, new Set([s.id]));
+      roots.push(node);
+    } else if (!byId.has(parentId)) {
+      orphans.push(s);
+    }
+  }
+  if (consumed.size + orphans.length < sessions.length) {
+    for (const s of sessions) {
+      if (consumed.has(s.id))
+        continue;
+      if (orphans.includes(s))
+        continue;
+      const visited = new Set;
+      let cur = s;
+      while (cur) {
+        if (visited.has(cur.id)) {
+          for (const v of visited)
+            cycleMembers.add(v);
+          cycleMembers.add(s.id);
+          break;
+        }
+        visited.add(cur.id);
+        const pid = cur.parentSessionId;
+        if (pid === null || pid === undefined || pid === "")
+          break;
+        cur = byId.get(pid);
+      }
+      consumed.add(s.id);
+      const node = build(s, new Set([s.id]));
+      roots.push(node);
+    }
+  }
+  return { roots, orphans, cycles: cycleMembers };
+}
+var TREE_BRANCH = "├── ";
+var TREE_LAST = "└── ";
+var TREE_VERTICAL = "│   ";
+var TREE_EMPTY = "    ";
+function renderSessionTree(tree, options = {}) {
+  if (tree.roots.length === 0 && tree.orphans.length === 0) {
+    return "No sessions.";
+  }
+  const lines = ["Session Tree"];
+  for (let i = 0;i < tree.roots.length; i++) {
+    const isLast = i === tree.roots.length - 1 && tree.orphans.length === 0;
+    renderNode(tree.roots[i], "", isLast, lines, tree.cycles, options);
+  }
+  if (tree.orphans.length > 0) {
+    for (let i = 0;i < tree.orphans.length; i++) {
+      const s = tree.orphans[i];
+      const isLast = i === tree.orphans.length - 1;
+      const branch = isLast ? TREE_LAST : TREE_BRANCH;
+      lines.push(`${branch}${formatNodeLabel(s, true, false, options)}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+function renderNode(node, prefix, isLast, lines, cycles, options) {
+  const branch = isLast ? TREE_LAST : TREE_BRANCH;
+  const isCycle = cycles.has(node.session.id);
+  lines.push(`${prefix}${branch}${formatNodeLabel(node.session, false, isCycle, options)}`);
+  const childPrefix = prefix + (isLast ? TREE_EMPTY : TREE_VERTICAL);
+  for (let i = 0;i < node.children.length; i++) {
+    const isChildLast = i === node.children.length - 1;
+    renderNode(node.children[i], childPrefix, isChildLast, lines, cycles, options);
+  }
+}
+function formatNodeLabel(session, isOrphan, isCycle = false, options = {}) {
+  const idStr = options.useShortId ? shortSessionId(session.id) : session.id;
+  const sourceLabel = inferSourceLabel(session);
+  const status = inferStatus(session);
+  const created = new Date(session.createdAt).toISOString().slice(0, 16).replace("T", " ");
+  const parts = [idStr, sourceLabel];
+  if (status)
+    parts.push(`(${status})`);
+  parts.push(created);
+  let label = parts.join(" ");
+  if (isOrphan)
+    label = `[orphan] ${label}`;
+  if (isCycle)
+    label = `[cycle] ${label}`;
+  return label;
+}
+function shortSessionId(id) {
+  const underscoreIdx = id.indexOf("_");
+  const stripped = underscoreIdx > 0 && underscoreIdx < id.length - 8 ? id.slice(underscoreIdx + 1) : id;
+  return stripped.length > 8 ? stripped.slice(0, 8) : stripped;
+}
+function inferSourceLabel(session) {
+  const meta = session.metadata;
+  const type = meta?.type;
+  if (type === "workflow") {
+    const name = meta?.workflowName;
+    return name ? `workflow/${name}` : "workflow";
+  }
+  if (type === "agent")
+    return "agent";
+  if (type === "subagent" || type === "sub-agent")
+    return "[subagent]";
+  return "chat";
+}
+function inferStatus(session) {
+  const meta = session.metadata;
+  const status = meta?.status;
+  if (typeof status === "string" && status.length > 0)
+    return status;
+  return null;
+}
+
+// src/commands/sessions/list.ts
 var ListCommand = {
   command: "list [options]",
   aliases: ["ls"],
   describe: "列出所有会话",
-  builder: (yargs) => yargs.option("limit", { alias: "n", type: "number", default: 20 }).option("offset", { type: "number", default: 0 }).option("sort", { type: "string", default: "updatedAt" }).option("order", { type: "string", default: "desc" }).option("json", { alias: "j", type: "boolean", default: false }).option("quiet", { alias: "q", type: "boolean", hidden: true }).option("id", { alias: "i", type: "boolean", default: false, description: "显示 Session ID" }).option("type", { alias: "t", type: "string", description: "按 session 类型过滤 (如 workflow)" }).option("status", { alias: "s", type: "string", description: "按状态过滤 (如 running, paused)" }),
+  builder: (yargs) => yargs.option("limit", { alias: "n", type: "number", default: 20 }).option("offset", { type: "number", default: 0 }).option("sort", { type: "string", default: "updatedAt" }).option("order", { type: "string", default: "desc" }).option("json", { alias: "j", type: "boolean", default: false }).option("quiet", { alias: "q", type: "boolean", hidden: true }).option("id", { alias: "i", type: "boolean", default: false, description: "显示 Session ID" }).option("type", { alias: "t", type: "string", description: "按 session 类型过滤 (如 workflow)" }).option("status", { alias: "s", type: "string", description: "按状态过滤 (如 running, paused)" }).option("graph", { alias: "g", type: "boolean", default: false, description: "以层次化树形结构展示 session 父子关系" }).option("short-id", { type: "boolean", default: false, description: "[graph] 用 8 字符截断 id 显示（默认显示完整 sessionId）" }),
   async handler(args) {
     const isQuiet = args.quiet === true;
     if (isQuiet) {
@@ -10854,6 +11023,11 @@ var ListCommand = {
       const sessions = await sessionComponent.list(listOptions);
       const totalCount = await sessionComponent.getCount();
       const activeSessionId = sessionComponent.getActiveSessionId();
+      if (args.graph) {
+        const tree = buildSessionTree(sessions);
+        output.log(renderSessionTree(tree, { useShortId: args.shortId === true }));
+        return;
+      }
       if (args.json) {
         output.json({
           total: sessions.length,
@@ -10868,6 +11042,8 @@ var ListCommand = {
               type: workflowMeta?.type || "chat",
               status: workflowMeta?.status,
               workflowName: workflowMeta?.workflowName,
+              parentSessionId: s.parentSessionId ?? null,
+              parentID: s.parentID ?? null,
               hasCheckpoint: !!s.metadata?.checkpoints?.checkpoints?.length,
               lastCheckpointAt: s.metadata?.checkpoints?.latestCheckpointId,
               createdAt: new Date(s.createdAt).toISOString(),
@@ -10885,6 +11061,7 @@ var ListCommand = {
           chalk6.bold("#"),
           chalk6.bold("Title"),
           chalk6.bold("ID"),
+          chalk6.bold("Parent"),
           hasTypeFilter || hasStatusFilter ? chalk6.bold("Status") : null,
           chalk6.bold("Msgs"),
           chalk6.bold("CP")
@@ -10894,8 +11071,9 @@ var ListCommand = {
           const hasCp = (s.metadata?.checkpoints?.checkpoints?.length ?? 0) > 0;
           const title = s.title.length > 20 ? s.title.slice(0, 17) + "..." : s.title;
           const idStr = s.id;
+          const useShortId = args.shortId === true;
+          const parentStr = s.parentSessionId ? chalk6.gray(useShortId ? shortSessionId(s.parentSessionId) : s.parentSessionId) : chalk6.gray("-");
           const workflowMeta = s.metadata?.type === "workflow" ? s.metadata : null;
-          const typeStr = workflowMeta?.type || "";
           const statusStr = workflowMeta?.status || "";
           let statusDisplay = "";
           if (hasTypeFilter || hasStatusFilter) {
@@ -10906,7 +11084,8 @@ var ListCommand = {
           const cells = [
             marker + " " + (args.offset + i + 1),
             title,
-            chalk6.gray(idStr)
+            chalk6.gray(idStr),
+            parentStr
           ];
           if (hasTypeFilter || hasStatusFilter) {
             cells.push(statusDisplay || chalk6.gray("-"));
@@ -19309,6 +19488,7 @@ import fs5 from "fs";
 import path8 from "path";
 import { createRunWorkflowTool } from "@ai-setting/roy-agent-core/env/workflow/tools";
 import { getTracerProvider as getTracerProvider4, propagation, wrapFunction } from "@ai-setting/roy-agent-core";
+import { isValidSessionId } from "@ai-setting/roy-agent-core/env/session";
 var runWorkflow = wrapFunction(async function runWorkflowImpl(args) {
   const output = new OutputService2;
   const envService = new EnvironmentService(output);
@@ -19380,6 +19560,14 @@ var runWorkflow = wrapFunction(async function runWorkflowImpl(args) {
       parallelLimit: args.parallelLimit,
       timeout: args.timeout
     };
+    const rawEnvParentId = process.env["ROY_PARENT_SESSION_ID"];
+    if (typeof rawEnvParentId === "string" && rawEnvParentId.length > 0) {
+      if (isValidSessionId(rawEnvParentId)) {
+        runOptions.parentSessionId = rawEnvParentId;
+      } else {
+        output.warn(`Ignoring malformed ROY_PARENT_SESSION_ID env value (must match /^[A-Za-z0-9_-]{8,128}$/)`);
+      }
+    }
     if (args.session) {
       const sessionId = args.session;
       output.log(chalk69.blue(`\uD83D\uDD04 Resuming workflow from session: ${sessionId}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-cli",
-  "version": "1.5.111",
+  "version": "1.5.113",
   "type": "module",
   "description": "CLI for roy-agent - Non-interactive command execution",
   "main": "./dist/index.js",