@myagentroam/marctl 0.10.7 → 0.10.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/marctl",
-  "version": "0.10.7",
+  "version": "0.10.9",
   "description": "MyAgentRoam command-line interface for authorized Node access.",
   "license": "Apache-2.0",
   "type": "module",

package/src/i18n/en-US.mjs

@@ -80,11 +80,21 @@ Input:
   Config requires model or effort; other fields and permissions are unchanged.
   Use --effort "" for the Runner default. Active execution is not restarted.
 
+Reading JSON:
+  show: session.activity, session.model, session.effort,
+    session.customTitle / session.runnerTitle, runs[] (id/status),
+    queue.items[], goal.status (goal may be null).
+  history: segments[].items[]; select kind === "assistant_message",
+    read payload.text.
+
 Delivery and waiting:
   Start/send return a clientMessageId.
   Send requires exactly one of --steer or --queue, even when idle.
-  When useful, --steer adds gentle context to an in-progress task.
-  --queue places input in a subsequent turn.
+  --steer prioritizes new context and may switch the current execution.
+    Node decides from actual state; reserve it for updates
+    affecting current work.
+  --queue schedules a subsequent turn; an active Goal can delay it
+    until the Goal exits.
   Example:
     marctl sessions send <session-id> --steer \\
       -m "Additional context: focus on the resume path." --json

package/src/i18n/zh-CN.mjs

@@ -79,11 +79,19 @@ ${configurationHelp}
   config 至少指定 model 或 effort；未指定字段和权限不变。
   --effort "" 使用 Runner 默认值，不重启当前执行。
 
+读取 JSON：
+  show：session.activity、session.model、session.effort、
+    session.customTitle / session.runnerTitle、runs[]（id/status）、
+    queue.items[]、goal.status（goal 可为空）。
+  history：segments[].items[] 中按 kind === "assistant_message"
+    筛选，读取 payload.text。
+
 投递与等待：
   start/send 返回 clientMessageId。
   send 必须二选一：--steer 或 --queue，空闲时也需指定。
-  --steer 在必要时为正在进行的任务补充温和的新信息。
-  --queue 将输入排入后续轮次。
+  --steer 优先补充新信息，可能切换当前执行；
+    Node 按实际状态裁决，仅用于影响当前工作的必要更新。
+  --queue 排入后续轮次；有活动 Goal 时可能等待 Goal 退出才处理。
   示例：
     marctl sessions send <session-id> --steer \\
       -m "Additional context: focus on the resume path." --json

package/src/sessions.mjs

@@ -161,6 +161,8 @@ export async function runSessionCommand({ args, client, env, stdin, WebSocketCla
   if (args.action === 'current' && env.MAR_CTL_SESSION_ID) body.sessionId = env.MAR_CTL_SESSION_ID;
   if (args.action === 'start' && env.MAR_CTL_SESSION_ID)
     body.parentSessionId = env.MAR_CTL_SESSION_ID;
+  if (['start', 'send'].includes(args.action) && env.MAR_CTL_SESSION_ID)
+    body.sourceSessionId = env.MAR_CTL_SESSION_ID;
   if (args.messageFile !== undefined || args.message !== undefined)
     body.content = await messageContent(
       args,