@myagentroam/marctl 0.11.10 → 0.11.11

package/package.json

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

package/src/i18n/en-US.mjs

@@ -55,11 +55,10 @@ Usage:
     [--client-message-id <id>] [--json]
   {program} wait [<id>] [--agent <id> ...] [--mode any|all]
     [--wait-for message|completion] [--timeout <duration>] [--json]
-  {program} stop <id> --execution <execution-id> [--json]
+  {program} stop <id> [--json]
   {program} list [--scope tree|active] [--query <title>]
     [--limit <1..100>] [--json]
-  {program} view [<id>] [--history] [--cursor <cursor>]
-    [--limit <1..100>] [--json]
+  {program} view [<id>] [--json]
 
 Management:
   {program} config [<id>] [--model-id <id>] [--effort <value>] [--json]
@@ -77,22 +76,26 @@ Management:
   {program} wait <id> --run <run-id> [--until approval] --timeout <duration>
   {program} goal get|clear <id> [--json]
   {program} goal set <id> (-m <text> | --message-file <file|->) [--json]
-  {program} current | show [<id>] | graph [<id>] | history [<id>]
+  {program} current | show [<id>] | graph [<id>]
+  {program} history [<id>] [--cursor <cursor>] [--limit <1..100>] [--json]
 
 Input and results:
   Start defaults to the current Session Runner; a terminal without a current
   Session must specify --runner or --parent. Start returns without waiting.
   Send appends by default; --steer provides timely input and --queue defers.
   --goal sets or replaces a Goal; --clear-goal clears it. Send can update a Goal
-  without text; omitted Goal is unchanged. Stop clears the target Session Goal.
+  without text; omitted Goal is unchanged. Stop targets the current execution
+  and clears the target Session Goal.
   Wait defaults to direct-child completion and 30s; 0ms is a snapshot.
-  Positive timeouts below 10s become 10s; maximum is 5m. Waiting does not stop.
+  Positive timeouts use the requested duration; maximum is 5m.
+  Waiting does not stop the task.
   -m and --message-file are exclusive; files use UTF-8 and - reads stdin.
   List defaults to the containing tree, including idle Sessions. Without a
   current Session it defaults to active; explicit tree requires a Session.
   Active includes running and sleeping Sessions in the current Workspace.
   List returns currentAgentId (null without a Session), flat sessions and
-  truncated. Limit defaults to 100, maximum 100; no cursor or pagination.
+  truncated. Limit defaults to 10, maximum 100; no cursor or pagination.
+  Active Sessions come first, then recent activity descending.
   Configuration and prompt changes apply to future executions.
   Prefer --steer for timely communication or course correction.
   Reserve --queue for explicitly requested deferred input: it is consumed after
@@ -106,8 +109,8 @@ Input and results:
 
   show --json includes session.status, session.modelId, session.effort,
   session.title, session.runId, session.recentTools, session.queuedCount and
-  session.latestMessage. List entries have id, parentSessionId, title, runner
-  and status; wait may include progress.
+  session.latestMessage. List entries have id, parentSessionId, title and
+  status; wait may include progress. View omits Run and Execution IDs.
   Status is RUNNING/IDLE/SLEEPING. In history, segments[].items[] with
   kind === "assistant_message" expose payload.text.
 

package/src/i18n/zh-CN.mjs

@@ -54,11 +54,10 @@ ${configurationHelp}
     [--client-message-id <id>] [--json]
   {program} wait [<id>] [--agent <id> ...] [--mode any|all]
     [--wait-for message|completion] [--timeout <duration>] [--json]
-  {program} stop <id> --execution <execution-id> [--json]
+  {program} stop <id> [--json]
   {program} list [--scope tree|active] [--query <title>]
     [--limit <1..100>] [--json]
-  {program} view [<id>] [--history] [--cursor <cursor>]
-    [--limit <1..100>] [--json]
+  {program} view [<id>] [--json]
 
 管理：
   {program} config [<id>] [--model-id <id>] [--effort <value>] [--json]
@@ -76,20 +75,22 @@ ${configurationHelp}
   {program} wait <id> --run <run-id> [--until approval] --timeout <duration>
   {program} goal get|clear <id> [--json]
   {program} goal set <id> (-m <text> | --message-file <file|->) [--json]
-  {program} current | show [<id>] | graph [<id>] | history [<id>]
+  {program} current | show [<id>] | graph [<id>]
+  {program} history [<id>] [--cursor <cursor>] [--limit <1..100>] [--json]
 
 输入与结果：
   start 默认当前会话的 Runner；没有当前会话的终端须指定 --runner 或
   --parent。start 不等待。
   send 默认追加；--steer 优先补充，--queue 排队。--goal 设置或替换目标，
   --clear-goal 清除目标；send 可仅更新目标，省略则不修改。
-  stop 清除目标会话的 Goal。wait 默认等待直接子会话终态 30 秒，
-  0ms 为快照；正数小于 10 秒按 10 秒等待，最多 5 分钟。等待不会停止任务。
+  stop 停止目标当前执行并清除 Goal。wait 默认等待直接子会话终态 30 秒，
+  0ms 为快照；正数按传入时长等待，最多 5 分钟。等待不会停止任务。
   -m 与 --message-file 互斥；文件使用 UTF-8，- 从 stdin 读取。
   list 默认查询所在会话树，包含空闲会话；
   没有当前会话时默认 active，显式 tree 须有会话上下文。active 包含当前
   Workspace 中运行及睡眠的会话。返回 currentAgentId（无会话时为 null）、
-  扁平 sessions 和 truncated。limit 默认及上限均为 100，无 cursor 或分页。
+  扁平 sessions 和 truncated。limit 默认 10、上限 100，无 cursor 或分页。
+  活跃会话优先，其后按最近活动时间倒序。
   配置和持久提示从后续执行生效。
   即时沟通或纠偏优先使用 --steer。
   建议仅将 --queue 用于明确要求延后的输入：当前工作及前面的队列项结束后才消费，
@@ -100,8 +101,8 @@ ${configurationHelp}
 
   show --json 包含 session.status、session.modelId、session.effort、
   session.title、session.runId、session.recentTools、session.queuedCount 和
-  session.latestMessage。list 每项仅含 id、parentSessionId、title、runner 和
-  status；wait 可能包含 progress；
+  session.latestMessage。list 每项仅含 id、parentSessionId、title 和 status；
+  wait 可能包含 progress；view 不公开 Run 或 Execution ID。
   状态为 RUNNING/IDLE/SLEEPING。历史中 segments[].items[] 的
   kind === "assistant_message" 包含 payload.text。
 

package/src/session-args.mjs

@@ -7,7 +7,7 @@ const commands = {
   list: ['scope', 'query', 'limit'],
   graph: ['limit'],
   show: [],
-  view: ['cursor', 'limit', 'history'],
+  view: [],
   history: ['cursor', 'limit'],
   start: [
     'runner',
@@ -42,7 +42,7 @@ const commands = {
     'approval',
     'decision'
   ],
-  stop: ['execution'],
+  stop: [],
   'goal.get': [],
   'goal.set': ['message', 'message-file'],
   'goal.clear': [],
@@ -57,7 +57,6 @@ const fieldNames = {
   run: 'runId',
   approval: 'approvalId',
   timeout: 'timeoutMs',
-  execution: 'executionId',
   'wait-for': 'waitFor',
   'clear-goal': 'clearGoal'
 };
@@ -112,11 +111,8 @@ export function parseSessionArgs(argv, translate = createTranslator()) {
       args[key] = true;
       continue;
     }
-    if (
-      (flag === '--clear-goal' && ['start', 'send'].includes(action)) ||
-      (flag === '--history' && action === 'view')
-    ) {
-      const key = flag === '--history' ? 'history' : 'clearGoal';
+    if (flag === '--clear-goal' && ['start', 'send'].includes(action)) {
+      const key = 'clearGoal';
       if (Object.hasOwn(args, key)) throw invalid();
       args[key] = true;
       continue;
@@ -180,7 +176,6 @@ export function parseSessionArgs(argv, translate = createTranslator()) {
     !['mar-agent', 'codex', 'claude-code', 'opencode'].includes(args.runner)
   )
     throw invalid();
-  if (action === 'stop' && !args.executionId) throw invalid();
   if (action === 'wait' && args.sessionId && args.agentIds?.length) throw invalid();
   if (
     args.until !== undefined &&

package/src/session-prepare.mjs

@@ -17,15 +17,13 @@ export async function prepareAgentNetworkRequest({ args, stdin, translate, sessi
     'parentSessionId',
     'scope',
     'waitFor',
-    'mode',
-    'executionId'
+    'mode'
   ])
     if (args[name] !== undefined) input[name] = args[name];
   if (['send', 'stop', 'view', 'wait'].includes(args.action) && sessionId)
     input.agentId = sessionId;
   if (args.action === 'wait' && args.agentIds?.length) input.agentIds = args.agentIds;
   if (args.action === 'wait' && args.timeoutMs !== undefined) input.waitMs = args.timeoutMs;
-  if (args.action === 'view' && args.history) input.includeHistory = true;
   if (args.message !== undefined || args.messageFile !== undefined)
     input.content = await messageContent(args, stdin, 100000, translate);
   if (args.goal !== undefined) input.goal = { objective: args.goal.trim() };