@myagentroam/marctl 0.10.4 → 0.10.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/src/i18n/en-US.mjs +57 -2
- package/src/i18n/zh-CN.mjs +54 -2
package/package.json
CHANGED
package/src/i18n/en-US.mjs
CHANGED
|
@@ -42,8 +42,63 @@ Notes:
|
|
|
42
42
|
Each alias shows only its own command help. Use marctl help <command> for details.
|
|
43
43
|
Remote access uses authorized Node Terminal transport, not system SSH or SCP.`,
|
|
44
44
|
commandHelp: Object.freeze({
|
|
45
|
-
sessions:
|
|
46
|
-
|
|
45
|
+
sessions: `{program} — Coordinate Sessions in the current MAR Workspace
|
|
46
|
+
|
|
47
|
+
Usage:
|
|
48
|
+
{program} current [--json]
|
|
49
|
+
{program} list [--cursor <cursor>] [--limit <1..100>] [--json]
|
|
50
|
+
{program} show <session-id> [--json]
|
|
51
|
+
{program} history <session-id>
|
|
52
|
+
[--cursor <cursor>] [--limit <1..100>] [--json]
|
|
53
|
+
|
|
54
|
+
{program} start --runner <runner>
|
|
55
|
+
[-m <text> | --message-file <file|->] [--image <path> ...]
|
|
56
|
+
[--model <id>] [--title <name>]
|
|
57
|
+
[--client-message-id <id>] [--json]
|
|
58
|
+
|
|
59
|
+
{program} send <session-id>
|
|
60
|
+
[-m <text> | --message-file <file|->] [--image <path> ...]
|
|
61
|
+
[--delivery send|queue|replace-current]
|
|
62
|
+
[--client-message-id <id>] [--json]
|
|
63
|
+
|
|
64
|
+
{program} stop <session-id> [--run <run-id>] [--json]
|
|
65
|
+
{program} goal get|clear <session-id> [--json]
|
|
66
|
+
{program} goal set <session-id>
|
|
67
|
+
(-m <text> | --message-file <file|->) [--json]
|
|
68
|
+
{program} wait <session-id>
|
|
69
|
+
--run <run-id> --timeout <30s|5m> [--json]
|
|
70
|
+
|
|
71
|
+
Input:
|
|
72
|
+
Runners: mar-agent, codex, claude-code, opencode; actual capabilities apply.
|
|
73
|
+
-m / --message supplies text; it is mutually exclusive with --message-file.
|
|
74
|
+
Files use UTF-8; - reads stdin. Repeat --image for PNG/JPEG/GIF/WebP files.
|
|
75
|
+
Start/send allow image-only input: up to 5 images, 5 MiB each, 10 MiB total.
|
|
76
|
+
Goal set accepts text only.
|
|
77
|
+
|
|
78
|
+
Delivery and waiting:
|
|
79
|
+
Start/send return a clientMessageId.
|
|
80
|
+
Send defaults to non-interrupting delivery. Queued runId may identify another
|
|
81
|
+
active input: correlate queueItemId/clientMessageId with visible history.
|
|
82
|
+
Wait observes the specified Run through Watch. Timeout does not stop it;
|
|
83
|
+
Run success is not proof of task success.
|
|
84
|
+
Completion never wakes a Coordinator.
|
|
85
|
+
On an unknown delivery outcome, inspect state/history; do not blindly resend.
|
|
86
|
+
|
|
87
|
+
Credentials and scope:
|
|
88
|
+
Credentials expire 24 hours after issue without automatic renewal.
|
|
89
|
+
Scope is bound by MAR to the current Node/Workspace;
|
|
90
|
+
there are no scope override options.
|
|
91
|
+
|
|
92
|
+
Workers:
|
|
93
|
+
Create workers as needed, e.g. --title "fixer#42 Handle empty totals" or
|
|
94
|
+
--title "reviewer#42 Review empty totals". Titles are not routing identities;
|
|
95
|
+
record returned Session IDs. Put task/role instructions in the first message.
|
|
96
|
+
Sessions share files and the Git index; no automatic worktree or worker pool.
|
|
97
|
+
|
|
98
|
+
Exit codes:
|
|
99
|
+
1 failure, 2 input, 3 authorization, 4 unsupported, 5 timeout,
|
|
100
|
+
6 unknown outcome, 130 cancelled wait.
|
|
101
|
+
--json prints one result/error object.`,
|
|
47
102
|
nodes: `{program} — List accessible Nodes
|
|
48
103
|
|
|
49
104
|
Usage:
|
package/src/i18n/zh-CN.mjs
CHANGED
|
@@ -41,8 +41,60 @@ ${configurationHelp}
|
|
|
41
41
|
快捷命令仅显示对应操作的帮助。用 marctl help <子命令> 查看详细说明。
|
|
42
42
|
远程访问使用授权的 Node Terminal 传输，不是系统 SSH 或 SCP 协议。`,
|
|
43
43
|
commandHelp: Object.freeze({
|
|
44
|
-
sessions:
|
|
45
|
-
|
|
44
|
+
sessions: `{program} — 协调当前 MAR 工作区中的会话
|
|
45
|
+
|
|
46
|
+
用法：
|
|
47
|
+
{program} current [--json]
|
|
48
|
+
{program} list [--cursor <cursor>] [--limit <1..100>] [--json]
|
|
49
|
+
{program} show <session-id> [--json]
|
|
50
|
+
{program} history <session-id>
|
|
51
|
+
[--cursor <cursor>] [--limit <1..100>] [--json]
|
|
52
|
+
|
|
53
|
+
{program} start --runner <runner>
|
|
54
|
+
[-m <text> | --message-file <file|->] [--image <path> ...]
|
|
55
|
+
[--model <id>] [--title <name>]
|
|
56
|
+
[--client-message-id <id>] [--json]
|
|
57
|
+
|
|
58
|
+
{program} send <session-id>
|
|
59
|
+
[-m <text> | --message-file <file|->] [--image <path> ...]
|
|
60
|
+
[--delivery send|queue|replace-current]
|
|
61
|
+
[--client-message-id <id>] [--json]
|
|
62
|
+
|
|
63
|
+
{program} stop <session-id> [--run <run-id>] [--json]
|
|
64
|
+
{program} goal get|clear <session-id> [--json]
|
|
65
|
+
{program} goal set <session-id>
|
|
66
|
+
(-m <text> | --message-file <file|->) [--json]
|
|
67
|
+
{program} wait <session-id>
|
|
68
|
+
--run <run-id> --timeout <30s|5m> [--json]
|
|
69
|
+
|
|
70
|
+
输入：
|
|
71
|
+
Runner：mar-agent、codex、claude-code、opencode，操作以实际能力为准。
|
|
72
|
+
-m / --message 直接传文本，与 --message-file 互斥；
|
|
73
|
+
文件用 UTF-8，- 从 stdin 读取。
|
|
74
|
+
start/send 可重复 --image 传 PNG/JPEG/GIF/WebP 图片，也可只发送图片。
|
|
75
|
+
最多 5 张，单张 5 MiB、合计 10 MiB；goal set 只接受文本。
|
|
76
|
+
|
|
77
|
+
投递与等待：
|
|
78
|
+
start/send 返回 clientMessageId。
|
|
79
|
+
send 默认不打断；排队回执的 runId 可能属于其他活动输入，
|
|
80
|
+
需按 queueItemId/clientMessageId 与可见历史核对。
|
|
81
|
+
wait 通过 Watch 等待指定 Run；超时不会停止任务，
|
|
82
|
+
Run 成功不等于业务完成。Worker 完成不自动唤醒 Coordinator。
|
|
83
|
+
投递结果未知时先查状态/历史，不盲目重发。
|
|
84
|
+
|
|
85
|
+
凭据与范围：
|
|
86
|
+
凭据自签发起 24 小时到期，不自动续签。
|
|
87
|
+
MAR 绑定当前 Node/Workspace，不提供覆盖范围的参数。
|
|
88
|
+
|
|
89
|
+
Worker：
|
|
90
|
+
按任务需要创建会话，例如 --title "fixer#42 Handle empty totals" 或
|
|
91
|
+
--title "reviewer#42 Review empty totals"；标题不是寻址身份，
|
|
92
|
+
保存返回的会话 ID。角色和任务要求放入首条普通消息。
|
|
93
|
+
会话共享文件与 Git 索引，不自动隔离工作目录或维护池。
|
|
94
|
+
|
|
95
|
+
退出码：
|
|
96
|
+
1 失败，2 参数，3 授权，4 不支持，5 超时，6 结果未知，130 取消等待。
|
|
97
|
+
--json 只输出一个结果或错误对象。`,
|
|
46
98
|
nodes: `{program} — 列出有权限的节点
|
|
47
99
|
|
|
48
100
|
用法：
|