@swmansion/argent 0.18.1-next.12 → 0.18.1-next.14
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/dist/cli-cmds.mjs +65 -16
- package/dist/cli.js +7 -6
- package/dist/cli.js.map +1 -1
- package/dist/installer-help.d.ts +13 -2
- package/dist/installer-help.js +41 -2
- package/dist/installer-help.js.map +1 -1
- package/package.json +1 -1
package/dist/cli-cmds.mjs
CHANGED
|
@@ -8465,6 +8465,12 @@ function isJsonField(prop) {
|
|
|
8465
8465
|
function flagNameFor(name, prop) {
|
|
8466
8466
|
return isJsonField(prop) ? `--${name}-json` : `--${name}`;
|
|
8467
8467
|
}
|
|
8468
|
+
function booleanLiteral(raw) {
|
|
8469
|
+
const value = raw.trim().toLowerCase();
|
|
8470
|
+
if (value === "true" || value === "1") return true;
|
|
8471
|
+
if (value === "false" || value === "0") return false;
|
|
8472
|
+
return void 0;
|
|
8473
|
+
}
|
|
8468
8474
|
function coerceScalar(raw, type, field) {
|
|
8469
8475
|
if (type === "number") {
|
|
8470
8476
|
if (raw.trim() === "")
|
|
@@ -8482,9 +8488,9 @@ function coerceScalar(raw, type, field) {
|
|
|
8482
8488
|
return n2;
|
|
8483
8489
|
}
|
|
8484
8490
|
if (type === "boolean") {
|
|
8485
|
-
|
|
8486
|
-
if (
|
|
8487
|
-
throw new FlagParseException(`--${field} expected true/false, got "${raw}"`);
|
|
8491
|
+
const value = booleanLiteral(raw);
|
|
8492
|
+
if (value !== void 0) return value;
|
|
8493
|
+
throw new FlagParseException(`--${field} expected true/false (or 1/0), got "${raw}"`);
|
|
8488
8494
|
}
|
|
8489
8495
|
return raw;
|
|
8490
8496
|
}
|
|
@@ -8561,6 +8567,12 @@ function parseFlags(argv, schema) {
|
|
|
8561
8567
|
if (inlineValue !== void 0) {
|
|
8562
8568
|
throw new FlagParseException(`--no-${fieldName} does not take a value`);
|
|
8563
8569
|
}
|
|
8570
|
+
const following = i2 + 1 < argv.length ? booleanLiteral(argv[i2 + 1]) : void 0;
|
|
8571
|
+
if (following !== void 0) {
|
|
8572
|
+
throw new FlagParseException(
|
|
8573
|
+
`--no-${fieldName} does not take a value; use --${fieldName} ${following}`
|
|
8574
|
+
);
|
|
8575
|
+
}
|
|
8564
8576
|
args[fieldName] = false;
|
|
8565
8577
|
continue;
|
|
8566
8578
|
}
|
|
@@ -8569,6 +8581,12 @@ function parseFlags(argv, schema) {
|
|
|
8569
8581
|
if (propSchema?.type === "boolean") {
|
|
8570
8582
|
if (inlineValue !== void 0) {
|
|
8571
8583
|
args[flag] = coerceScalar(inlineValue, "boolean", flag);
|
|
8584
|
+
continue;
|
|
8585
|
+
}
|
|
8586
|
+
const next = i2 + 1 < argv.length ? booleanLiteral(argv[i2 + 1]) : void 0;
|
|
8587
|
+
if (next !== void 0) {
|
|
8588
|
+
args[flag] = next;
|
|
8589
|
+
i2 += 1;
|
|
8572
8590
|
} else {
|
|
8573
8591
|
args[flag] = true;
|
|
8574
8592
|
}
|
|
@@ -8626,6 +8644,12 @@ function formatSchemaUsage(schema) {
|
|
|
8626
8644
|
const desc = prop.description ? ` ${prop.description}` : "";
|
|
8627
8645
|
lines.push(` ${flag} ${typeLabel}${req}${desc}`);
|
|
8628
8646
|
}
|
|
8647
|
+
if (entries.some(([, prop]) => prop.type === "boolean")) {
|
|
8648
|
+
lines.push(
|
|
8649
|
+
"",
|
|
8650
|
+
" Booleans: --flag, --flag true, or --flag 1 sets true; --flag false, --flag 0, --flag=false, or --no-flag sets false."
|
|
8651
|
+
);
|
|
8652
|
+
}
|
|
8629
8653
|
return lines.join("\n");
|
|
8630
8654
|
}
|
|
8631
8655
|
function renderFlagName(name, prop) {
|
|
@@ -8924,6 +8948,11 @@ Examples:
|
|
|
8924
8948
|
printToolHelp(meta);
|
|
8925
8949
|
return;
|
|
8926
8950
|
}
|
|
8951
|
+
if (parsed.positional.length > 0) {
|
|
8952
|
+
console.error(
|
|
8953
|
+
`Note: ignoring unused argument(s): ${parsed.positional.join(", ")}. Pass values as --flag <value> or --flag=<value>.`
|
|
8954
|
+
);
|
|
8955
|
+
}
|
|
8927
8956
|
let payload = {};
|
|
8928
8957
|
if (parsed.rawArgs !== null) {
|
|
8929
8958
|
let rawJson = parsed.rawArgs;
|
|
@@ -9081,6 +9110,12 @@ function parseRunArgs(argv) {
|
|
|
9081
9110
|
};
|
|
9082
9111
|
const noValue = (name) => {
|
|
9083
9112
|
if (inline !== void 0) throw new FlagParseException(`${name} does not take a value`);
|
|
9113
|
+
const next = argv[i2 + 1]?.trim().toLowerCase();
|
|
9114
|
+
if (next === "true" || next === "false") {
|
|
9115
|
+
throw new FlagParseException(
|
|
9116
|
+
`${name} does not take a value \u2014 it is a switch; omit it to leave the option off`
|
|
9117
|
+
);
|
|
9118
|
+
}
|
|
9084
9119
|
};
|
|
9085
9120
|
if (flag === "--update-baselines") {
|
|
9086
9121
|
noValue("--update-baselines");
|
|
@@ -9363,10 +9398,27 @@ ${sorted.length} tools. Run \`argent tools describe <name>\` for details.`);
|
|
|
9363
9398
|
console.log(formatSchemaUsage(meta.inputSchema));
|
|
9364
9399
|
if (meta.outputHint) console.log(`
|
|
9365
9400
|
Output hint: ${meta.outputHint}`);
|
|
9401
|
+
}
|
|
9402
|
+
function printUsage3() {
|
|
9403
|
+
console.log(`Usage:
|
|
9404
|
+
argent tools List available tools
|
|
9405
|
+
argent tools describe <name> Show one tool's flags and description
|
|
9406
|
+
|
|
9407
|
+
Options:
|
|
9408
|
+
--json Print machine-readable JSON
|
|
9409
|
+
--help, -h Show this help
|
|
9410
|
+
|
|
9411
|
+
Listing tools contacts the argent tool-server, starting one if none is running.
|
|
9412
|
+
`);
|
|
9366
9413
|
}
|
|
9367
9414
|
const json = argv.includes("--json");
|
|
9368
|
-
const
|
|
9415
|
+
const isHelpFlag = (a2) => a2 === "--help" || a2 === "-h";
|
|
9416
|
+
const positional = argv.filter((a2) => !a2.startsWith("--") || isHelpFlag(a2));
|
|
9369
9417
|
const sub = positional[0];
|
|
9418
|
+
if (sub !== void 0 && isHelpFlag(sub)) {
|
|
9419
|
+
printUsage3();
|
|
9420
|
+
return;
|
|
9421
|
+
}
|
|
9370
9422
|
if (!sub) {
|
|
9371
9423
|
await listTools(json);
|
|
9372
9424
|
return;
|
|
@@ -9380,16 +9432,6 @@ Output hint: ${meta.outputHint}`);
|
|
|
9380
9432
|
await describeTool(name, json);
|
|
9381
9433
|
return;
|
|
9382
9434
|
}
|
|
9383
|
-
if (sub === "--help" || sub === "-h") {
|
|
9384
|
-
console.log(`Usage:
|
|
9385
|
-
argent tools List available tools
|
|
9386
|
-
argent tools describe <name> Show one tool's flags and description
|
|
9387
|
-
|
|
9388
|
-
Options:
|
|
9389
|
-
--json Print machine-readable JSON
|
|
9390
|
-
`);
|
|
9391
|
-
return;
|
|
9392
|
-
}
|
|
9393
9435
|
console.error(`Unknown subcommand: tools ${sub}`);
|
|
9394
9436
|
process.exit(1);
|
|
9395
9437
|
}
|
|
@@ -10444,8 +10486,15 @@ function parseArgs(argv) {
|
|
|
10444
10486
|
for (let i2 = 0; i2 < argv.length; i2++) {
|
|
10445
10487
|
const tok = argv[i2];
|
|
10446
10488
|
if (tok === "--help" || tok === "-h") help = true;
|
|
10447
|
-
else if (tok === "--forget")
|
|
10448
|
-
|
|
10489
|
+
else if (tok === "--forget") {
|
|
10490
|
+
forget = true;
|
|
10491
|
+
const next = argv[i2 + 1]?.trim().toLowerCase();
|
|
10492
|
+
if (next === "true" || next === "false") {
|
|
10493
|
+
process.stderr.write(`lens: --forget does not take a value; omit it to keep the state
|
|
10494
|
+
`);
|
|
10495
|
+
process.exit(2);
|
|
10496
|
+
}
|
|
10497
|
+
} else if (tok === "--terminal" || tok === "-t") {
|
|
10449
10498
|
const v = argv[++i2];
|
|
10450
10499
|
if (v === "iterm" || v === "terminal") terminal = v;
|
|
10451
10500
|
else {
|
package/dist/cli.js
CHANGED
|
@@ -65,7 +65,7 @@ argent v${version}
|
|
|
65
65
|
Usage: argent <command> [options]
|
|
66
66
|
|
|
67
67
|
Commands:
|
|
68
|
-
mcp
|
|
68
|
+
mcp ${installerHelpEntry("mcp")}
|
|
69
69
|
init ${installerHelpEntry("init")}
|
|
70
70
|
install ${installerHelpEntry("install")}
|
|
71
71
|
update ${installerHelpEntry("update")}
|
|
@@ -106,11 +106,12 @@ async function loadCli() {
|
|
|
106
106
|
return (await import("./cli-cmds.mjs"));
|
|
107
107
|
}
|
|
108
108
|
async function main() {
|
|
109
|
-
//
|
|
110
|
-
//
|
|
111
|
-
//
|
|
112
|
-
//
|
|
113
|
-
//
|
|
109
|
+
// Some subcommands never look at their own argv: the installers forward it
|
|
110
|
+
// to side-effecting functions that ignore `--help` (so `argent uninstall
|
|
111
|
+
// --help` would run the real, destructive command), and `mcp` is handed no
|
|
112
|
+
// argv at all, so a help flag there starts the stdio server and blocks
|
|
113
|
+
// reading JSON-RPC from stdin. Intercept help for that set before
|
|
114
|
+
// dispatching. Every other subcommand parses `--help` itself.
|
|
114
115
|
if (installerHelpRequested(command, rest)) {
|
|
115
116
|
// installerHelpRequested only returns true for an InstallerCommand.
|
|
116
117
|
printInstallerHelp(command);
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,uEAAuE;QACvE,oDAAoD;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACxE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAC;QACjF,OAAO,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,EAAE,AAAD,EAAG,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAC5C,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,CAAC;AAEtC,oBAAoB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;AAEtC,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,aAAa;AACb,SAAS,kBAAkB,CAAC,OAAyB;IACnD,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvF,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,OAAO,GAAG,mBAAmB,EAAE,IAAI,SAAS,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC;UACJ,OAAO
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
package/dist/installer-help.d.ts
CHANGED
|
@@ -18,8 +18,13 @@
|
|
|
18
18
|
* help text: the top-level `argent --help` table in cli.ts reads the summary
|
|
19
19
|
* and detail lines from `INSTALLER_COMMAND_META` so the two can't drift.
|
|
20
20
|
*/
|
|
21
|
-
/**
|
|
22
|
-
|
|
21
|
+
/**
|
|
22
|
+
* Subcommands whose argv never reaches a `--help` handler. The installers
|
|
23
|
+
* forward theirs to side-effecting functions that do not check it; `mcp` is
|
|
24
|
+
* handed no argv at all — `startMcpServer` takes only its paths — so a help
|
|
25
|
+
* flag there starts the stdio server and blocks reading JSON-RPC from stdin.
|
|
26
|
+
*/
|
|
27
|
+
export declare const INSTALLER_COMMANDS: readonly ["init", "install", "update", "uninstall", "remove", "mcp"];
|
|
23
28
|
export type InstallerCommand = (typeof INSTALLER_COMMANDS)[number];
|
|
24
29
|
export declare function isInstallerCommand(command: string | undefined): command is InstallerCommand;
|
|
25
30
|
/**
|
|
@@ -63,6 +68,12 @@ interface InstallerCommandMeta {
|
|
|
63
68
|
* the option descriptions instead.
|
|
64
69
|
*/
|
|
65
70
|
details?: string[];
|
|
71
|
+
/**
|
|
72
|
+
* Prose rendered under the summary in this command's own `--help` only —
|
|
73
|
+
* the mirror of `details`, which appears only in the top-level table. Used
|
|
74
|
+
* where the option list cannot carry what the reader needs to know.
|
|
75
|
+
*/
|
|
76
|
+
notes?: string[];
|
|
66
77
|
/** Usage line, e.g. `argent init [options]`. */
|
|
67
78
|
usage: string;
|
|
68
79
|
/** Real flags this command parses. Empty for aliases (see `aliasOf`). */
|
package/dist/installer-help.js
CHANGED
|
@@ -18,8 +18,20 @@
|
|
|
18
18
|
* help text: the top-level `argent --help` table in cli.ts reads the summary
|
|
19
19
|
* and detail lines from `INSTALLER_COMMAND_META` so the two can't drift.
|
|
20
20
|
*/
|
|
21
|
-
/**
|
|
22
|
-
|
|
21
|
+
/**
|
|
22
|
+
* Subcommands whose argv never reaches a `--help` handler. The installers
|
|
23
|
+
* forward theirs to side-effecting functions that do not check it; `mcp` is
|
|
24
|
+
* handed no argv at all — `startMcpServer` takes only its paths — so a help
|
|
25
|
+
* flag there starts the stdio server and blocks reading JSON-RPC from stdin.
|
|
26
|
+
*/
|
|
27
|
+
export const INSTALLER_COMMANDS = [
|
|
28
|
+
"init",
|
|
29
|
+
"install",
|
|
30
|
+
"update",
|
|
31
|
+
"uninstall",
|
|
32
|
+
"remove",
|
|
33
|
+
"mcp",
|
|
34
|
+
];
|
|
23
35
|
export function isInstallerCommand(command) {
|
|
24
36
|
return INSTALLER_COMMANDS.includes(command);
|
|
25
37
|
}
|
|
@@ -51,6 +63,9 @@ export const VALUE_TAKING_FLAGS = {
|
|
|
51
63
|
update: ["--version", "--project-root"],
|
|
52
64
|
uninstall: [],
|
|
53
65
|
remove: [],
|
|
66
|
+
// `mcp` parses nothing, so no argument can be a flag's value and a bareword
|
|
67
|
+
// `help` anywhere is unambiguously a help request.
|
|
68
|
+
mcp: [],
|
|
54
69
|
};
|
|
55
70
|
/**
|
|
56
71
|
* True when `command` is an installer subcommand and `rest` requests help. Pure
|
|
@@ -166,6 +181,28 @@ export const INSTALLER_COMMAND_META = {
|
|
|
166
181
|
options: [],
|
|
167
182
|
aliasOf: "uninstall",
|
|
168
183
|
},
|
|
184
|
+
mcp: {
|
|
185
|
+
// Byte-identical to the row the top-level table printed by hand, so moving
|
|
186
|
+
// that row onto this meta changes no output.
|
|
187
|
+
summary: "Start the MCP stdio server (used by editors)",
|
|
188
|
+
usage: "argent mcp",
|
|
189
|
+
notes: [
|
|
190
|
+
"Speaks the Model Context Protocol over stdio: JSON-RPC requests on stdin,",
|
|
191
|
+
"responses on stdout. Editors launch it themselves — `argent init` writes the",
|
|
192
|
+
"`argent mcp` entry into the editor's MCP config — and start one server per",
|
|
193
|
+
"session. Run by hand it waits for JSON-RPC on stdin and looks like it has",
|
|
194
|
+
"hung; Ctrl-C to quit.",
|
|
195
|
+
"",
|
|
196
|
+
"It takes no options and owns stdout, so diagnostics go to stderr. Calls are",
|
|
197
|
+
"logged to ~/.argent/mcp-calls.log (override with ARGENT_MCP_LOG). Tools are",
|
|
198
|
+
"served by the argent tool-server, spawned on demand unless ARGENT_TOOLS_URL",
|
|
199
|
+
"or `argent link` points at one already running.",
|
|
200
|
+
"",
|
|
201
|
+
"To drive the same tools from a terminal, use `argent tools` and",
|
|
202
|
+
"`argent run <tool>`.",
|
|
203
|
+
],
|
|
204
|
+
options: [{ flag: "--help, -h", description: "Show this help." }],
|
|
205
|
+
},
|
|
169
206
|
};
|
|
170
207
|
/**
|
|
171
208
|
* Print the usage block for an installer subcommand — usage line, summary, the
|
|
@@ -175,6 +212,8 @@ export const INSTALLER_COMMAND_META = {
|
|
|
175
212
|
export function printInstallerHelp(command) {
|
|
176
213
|
const meta = INSTALLER_COMMAND_META[command];
|
|
177
214
|
const lines = ["", `Usage: ${meta.usage}`, "", `${meta.summary}.`];
|
|
215
|
+
if (meta.notes)
|
|
216
|
+
lines.push("", ...meta.notes);
|
|
178
217
|
if (meta.aliasOf) {
|
|
179
218
|
lines.push("", `Run \`argent ${meta.aliasOf} --help\` to see its options.`);
|
|
180
219
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"installer-help.js","sourceRoot":"","sources":["../src/installer-help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH
|
|
1
|
+
{"version":3,"file":"installer-help.js","sourceRoot":"","sources":["../src/installer-help.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED