@myagentroam/marctl 0.11.5 → 0.11.7

package/package.json

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

package/src/i18n/en-US.mjs

@@ -46,7 +46,7 @@ Notes:
 
 Usage:
   {program} start [-m <text> | --message-file <file|->] [--image <path> ...]
-    [--runner <runner>] [--parent <id>] [--model <id>] [--effort <value>]
+    [--runner <runner>] [--parent <id>] [--model-id <id>] [--effort <value>]
     [--title <name>] [--goal <objective> | --clear-goal]
     [--client-message-id <id>] [--json]
   {program} send <id> [-m <text> | --message-file <file|->]
@@ -65,7 +65,7 @@ Usage:
     [--limit <1..100>] [--json]
 
 Management:
-  {program} config [<id>] [--model <id>] [--effort <value>] [--json]
+  {program} config [<id>] [--model-id <id>] [--effort <value>] [--json]
   {program} rename [<id>] --title <name> [--json]
   {program} prompt get|clear [<id>] [--json]
   {program} prompt set [<id>] (-m <text> | --message-file <file|->) [--json]
@@ -86,7 +86,7 @@ Input and results:
   Start defaults to the current Session Runner; a terminal without a current
   Session must specify --runner or --parent. Profile lists configured models,
   not guaranteed account availability. Start returns without waiting.
-  Send appends by default; --steer replaces and --queue defers.
+  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.
   Wait defaults to direct-child completion and 30s; 0ms is a snapshot.
@@ -95,11 +95,11 @@ Input and results:
   -m and --message-file are exclusive; files use UTF-8 and - reads stdin.
   List exposes current identity and bounded pages; nextCursor marks more.
   Configuration and prompt changes apply to future executions.
-  Prefer --steer for timely coordination and for
-  results the recipient is waiting for; Node may switch the current execution.
-  Use --queue only for deliberately deferred follow-up work;
-  it waits for that execution and earlier queued work. Use --steer instead when
-  a result cannot wait until the current Goal exits.
+  Prefer --steer for timely communication or course correction.
+  Use --queue only for deliberately deferred input: it is consumed after
+  current work and earlier queued inputs finish. With an active Goal it is
+  not consumed until that Goal exits.
+  Acceptance does not guarantee immediate processing.
 
   show --json includes session.status, session.model, session.effort,
   session.title, session.runId, session.recentTools, session.queuedCount and

package/src/i18n/zh-CN.mjs

@@ -45,7 +45,7 @@ ${configurationHelp}
 
 用法：
   {program} start [-m <text> | --message-file <file|->] [--image <path> ...]
-    [--runner <runner>] [--parent <id>] [--model <id>] [--effort <value>]
+    [--runner <runner>] [--parent <id>] [--model-id <id>] [--effort <value>]
     [--title <name>] [--goal <objective> | --clear-goal]
     [--client-message-id <id>] [--json]
   {program} send <id> [-m <text> | --message-file <file|->]
@@ -64,7 +64,7 @@ ${configurationHelp}
     [--limit <1..100>] [--json]
 
 管理：
-  {program} config [<id>] [--model <id>] [--effort <value>] [--json]
+  {program} config [<id>] [--model-id <id>] [--effort <value>] [--json]
   {program} rename [<id>] --title <name> [--json]
   {program} prompt get|clear [<id>] [--json]
   {program} prompt set [<id>] (-m <text> | --message-file <file|->) [--json]
@@ -84,16 +84,16 @@ ${configurationHelp}
 输入与结果：
   start 默认当前会话的 Runner；没有当前会话的终端须指定 --runner 或
   --parent。profile 显示已配置模型，不代表账号实时可用。start 不等待。
-  send 默认追加；--steer 替换，--queue 排队。--goal 设置或替换目标，
+  send 默认追加；--steer 优先补充，--queue 排队。--goal 设置或替换目标，
   --clear-goal 清除目标；send 可仅更新目标，省略则不修改。
   stop 清除目标会话的 Goal。wait 默认等待直接子会话终态 30 秒，
   0ms 为快照；正数小于 10 秒按 10 秒等待，最多 5 分钟。等待不会停止任务。
   可只传图片：最多 5 张，单张 5 MiB、总计 10 MiB。-m 与 --message-file
   互斥；文件使用 UTF-8，- 从 stdin 读取。list 返回当前身份和分页结果，
   nextCursor 表示还有后续页面。配置和持久提示从后续执行生效。
-  及时协作优先使用 --steer，包括对方正在等待的结果；Node 可能切换当前执行。
-  仅明确要延后执行的后续工作使用 --queue，它会等待当前执行和前面的队列项；
-  无法等待 Goal 退出的结果应使用 --steer。
+  即时沟通或纠偏优先使用 --steer。
+  仅明确要延后处理的输入使用 --queue：当前工作及前面的队列项结束后才消费，
+  有活动 Goal 时，必须等到该 Goal 退出才消费。已接收不保证立即处理。
 
   show --json 包含 session.status、session.model、session.effort、
   session.title、session.runId、session.recentTools、session.queuedCount 和

package/src/session-args.mjs

@@ -11,7 +11,7 @@ const commands = {
   history: ['cursor', 'limit'],
   start: [
     'runner',
-    'model',
+    'model-id',
     'effort',
     'title',
     'message',
@@ -22,7 +22,7 @@ const commands = {
     'goal',
     'clear-goal'
   ],
-  config: ['model', 'effort'],
+  config: ['model-id', 'effort'],
   rename: ['title'],
   'prompt.get': [],
   'prompt.set': ['message', 'message-file'],
@@ -51,6 +51,7 @@ const commands = {
   wait: ['timeout', 'wait-for', 'mode', 'agent', 'run', 'until']
 };
 const fieldNames = {
+  'model-id': 'modelId',
   parent: 'parentSessionId',
   'expected-revision': 'expectedRevision',
   'message-file': 'messageFile',
@@ -225,10 +226,11 @@ export function parseSessionArgs(argv, translate = createTranslator()) {
     );
   if (action === 'rename' && args.title !== undefined) args.title = args.title.trim();
   if (args.title !== undefined && args.title.length > 160) throw invalid();
-  if (args.model !== undefined && (args.model.trim().length === 0 || args.model.length > 120))
+  if (args.modelId !== undefined && (args.modelId.trim().length === 0 || args.modelId.length > 120))
     throw invalid();
   if (args.effort !== undefined && args.effort.length > 120) throw invalid();
-  if (action === 'config' && args.model === undefined && args.effort === undefined) throw invalid();
+  if (action === 'config' && args.modelId === undefined && args.effort === undefined)
+    throw invalid();
   if (action === 'rename') {
     if (args.title === undefined || args.title.trim().length === 0) throw invalid();
   }

package/src/session-prepare.mjs

@@ -8,7 +8,7 @@ export async function prepareAgentNetworkRequest({ args, stdin, translate, sessi
   const input = {};
   for (const name of [
     'runner',
-    'model',
+    'modelId',
     'effort',
     'title',
     'cursor',
@@ -55,7 +55,7 @@ export async function prepareSessionRequest({ args, env, stdin, translate, sessi
     'sessionId',
     'parentSessionId',
     'runner',
-    'model',
+    'modelId',
     'effort',
     'title',
     'cursor',