@ora-ai/cli 0.27.0 → 0.29.0
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/command-tree.d.ts +5 -0
- package/dist/command-tree.d.ts.map +1 -1
- package/dist/command-tree.js +41 -6
- package/dist/command-tree.js.map +1 -1
- package/dist/core/body-flags.d.ts +39 -0
- package/dist/core/body-flags.d.ts.map +1 -0
- package/dist/core/body-flags.js +229 -0
- package/dist/core/body-flags.js.map +1 -0
- package/dist/core/body-help.d.ts +11 -0
- package/dist/core/body-help.d.ts.map +1 -0
- package/dist/core/body-help.js +78 -0
- package/dist/core/body-help.js.map +1 -0
- package/dist/core/body-values.d.ts +64 -0
- package/dist/core/body-values.d.ts.map +1 -0
- package/dist/core/body-values.js +250 -0
- package/dist/core/body-values.js.map +1 -0
- package/dist/core/cli-arguments.d.ts +1 -1
- package/dist/core/cli-arguments.d.ts.map +1 -1
- package/dist/core/cli-arguments.js.map +1 -1
- package/dist/core/run-operation.d.ts +2 -2
- package/dist/core/run-operation.d.ts.map +1 -1
- package/dist/core/run-operation.js +1 -1
- package/dist/core/run-operation.js.map +1 -1
- package/dist/generated/operations.d.ts +32 -1
- package/dist/generated/operations.d.ts.map +1 -1
- package/dist/generated/operations.js +7286 -84
- package/dist/generated/operations.js.map +1 -1
- package/dist/generated/types.d.ts +5 -0
- package/dist/generated/types.d.ts.map +1 -1
- package/dist/generated/types.js +1 -1
- package/dist/study-ci/ci-command.d.ts +3 -1
- package/dist/study-ci/ci-command.d.ts.map +1 -1
- package/dist/study-ci/ci-command.js +49 -14
- package/dist/study-ci/ci-command.js.map +1 -1
- package/dist/study-ci/ci-run.d.ts +28 -6
- package/dist/study-ci/ci-run.d.ts.map +1 -1
- package/dist/study-ci/ci-run.js +26 -3
- package/dist/study-ci/ci-run.js.map +1 -1
- package/dist/study-ci/create-body.d.ts +32 -0
- package/dist/study-ci/create-body.d.ts.map +1 -0
- package/dist/study-ci/create-body.js +70 -0
- package/dist/study-ci/create-body.js.map +1 -0
- package/dist/study-ci/run-command.d.ts +5 -0
- package/dist/study-ci/run-command.d.ts.map +1 -0
- package/dist/study-ci/run-command.js +85 -0
- package/dist/study-ci/run-command.js.map +1 -0
- package/dist/watch.d.ts +1 -1
- package/dist/watch.d.ts.map +1 -1
- package/dist/watch.js +6 -14
- package/dist/watch.js.map +1 -1
- package/package.json +1 -1
package/dist/command-tree.d.ts
CHANGED
|
@@ -14,6 +14,11 @@
|
|
|
14
14
|
* each also accepted as a hidden `--<name>`. The body is built from them (core/cli-arguments.ts), so a command whose
|
|
15
15
|
* arguments hold every required field needs no --file; a --file's other fields are kept, and an argument wins over
|
|
16
16
|
* the same field in it.
|
|
17
|
+
*
|
|
18
|
+
* Body flags: every field of a command's body is a flag (`--repeats 3`), read from the manifest's `bodyFlags`, and
|
|
19
|
+
* the document's short forms for its lists are flags too (`--agent codex/gpt-5.4-mini`): core/body-flags.ts. A flag
|
|
20
|
+
* wins over the same field of a --file, `--set path=value` changes one place inside the result, and `--print-body`
|
|
21
|
+
* prints the body and sends nothing.
|
|
17
22
|
*/
|
|
18
23
|
import { type Command } from "commander";
|
|
19
24
|
import { type CommandOperation } from "./core/operation-meta.js";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"command-tree.d.ts","sourceRoot":"","sources":["../src/command-tree.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"command-tree.d.ts","sourceRoot":"","sources":["../src/command-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAOjD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAOjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,WAAW,CAAC,GAAG,MAAM,CAG/F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC,GAAG,MAAM,CAI1H;AAED,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,UAAU,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAMzG;AAgBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,gBAAgB,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAKpH"}
|
package/dist/command-tree.js
CHANGED
|
@@ -14,8 +14,16 @@
|
|
|
14
14
|
* each also accepted as a hidden `--<name>`. The body is built from them (core/cli-arguments.ts), so a command whose
|
|
15
15
|
* arguments hold every required field needs no --file; a --file's other fields are kept, and an argument wins over
|
|
16
16
|
* the same field in it.
|
|
17
|
+
*
|
|
18
|
+
* Body flags: every field of a command's body is a flag (`--repeats 3`), read from the manifest's `bodyFlags`, and
|
|
19
|
+
* the document's short forms for its lists are flags too (`--agent codex/gpt-5.4-mini`): core/body-flags.ts. A flag
|
|
20
|
+
* wins over the same field of a --file, `--set path=value` changes one place inside the result, and `--print-body`
|
|
21
|
+
* prints the body and sends nothing.
|
|
17
22
|
*/
|
|
18
23
|
import { Option } from "commander";
|
|
24
|
+
import { readFileSync } from "node:fs";
|
|
25
|
+
import { applySets, attachBodyFlags, bodyFromFlags } from "./core/body-flags.js";
|
|
26
|
+
import { BodyValueError } from "./core/body-values.js";
|
|
19
27
|
import { argumentFlag, argumentValues, excessArgumentsMessage } from "./core/cli-arguments.js";
|
|
20
28
|
import { headerParamsOf } from "./core/operation-meta.js";
|
|
21
29
|
import { renderError } from "./core/output.js";
|
|
@@ -69,6 +77,14 @@ export function attachOperations(program, operations, deps) {
|
|
|
69
77
|
attachOperationAt(program, path, meta, deps, canonical);
|
|
70
78
|
}
|
|
71
79
|
}
|
|
80
|
+
/** The body `--set` writes into: the one the file and the flags made, or a new one. A body that is not an object has no places to set. */
|
|
81
|
+
function bodyForSets(body) {
|
|
82
|
+
if (body === undefined)
|
|
83
|
+
return {};
|
|
84
|
+
if (typeof body !== "object" || body === null || Array.isArray(body))
|
|
85
|
+
throw new BodyValueError("--set needs the body to be a JSON object");
|
|
86
|
+
return body;
|
|
87
|
+
}
|
|
72
88
|
function attachOperationAt(program, path, meta, deps, canonical) {
|
|
73
89
|
let node = program;
|
|
74
90
|
path.slice(0, -1).forEach((seg, i) => {
|
|
@@ -92,9 +108,12 @@ function attachOperationAt(program, path, meta, deps, canonical) {
|
|
|
92
108
|
}
|
|
93
109
|
if (meta.hasBody) {
|
|
94
110
|
// A body its arguments can carry is not required as a file: readBody names what is missing instead.
|
|
95
|
-
|
|
111
|
+
// …and neither is one whose fields are flags: the body is whatever the flags and the file make.
|
|
112
|
+
const required = meta.bodyRequired && !meta.cliArguments?.length && !meta.bodyFlags?.length ? " (required)" : "";
|
|
96
113
|
leaf.option("--file <path>", `JSON request body file, or "-" for stdin${required}`);
|
|
97
114
|
}
|
|
115
|
+
// Every body field as a flag, after the command's own flags: what was added is what the body is read from.
|
|
116
|
+
const bodyFlags = meta.hasBody ? attachBodyFlags(leaf, meta) : { bodyFlags: [], bodyShorthands: [] };
|
|
98
117
|
leaf.option("--json", "print the raw JSON response");
|
|
99
118
|
leaf.option("--plain", "force plain non-visual output");
|
|
100
119
|
leaf.option("--api-url <url>", "override the API base URL");
|
|
@@ -121,11 +140,27 @@ function attachOperationAt(program, path, meta, deps, canonical) {
|
|
|
121
140
|
process.exitCode = 2;
|
|
122
141
|
return;
|
|
123
142
|
}
|
|
124
|
-
const
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
143
|
+
const io = { read: (path) => readFileSync(path, "utf8") };
|
|
144
|
+
try {
|
|
145
|
+
// An argument, then a flag, then --set: each later one wins over the same place in the body.
|
|
146
|
+
const given = { ...argumentValues(meta, actionArgs.slice(meta.pathParams.length), opts), ...bodyFromFlags(bodyFlags, opts, io) };
|
|
147
|
+
const r = readBody(opts.file, meta, deps, mode, given);
|
|
148
|
+
if (r.kind === "error")
|
|
149
|
+
return; // readBody already reported + set exitCode
|
|
150
|
+
const sets = opts.set;
|
|
151
|
+
body = sets?.length ? applySets(bodyForSets(r.body), sets, io) : r.body;
|
|
152
|
+
}
|
|
153
|
+
catch (err) {
|
|
154
|
+
if (!(err instanceof BodyValueError))
|
|
155
|
+
throw err;
|
|
156
|
+
deps.errOut(renderError(err, { mode }));
|
|
157
|
+
process.exitCode = 2;
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
if (opts.printBody) {
|
|
161
|
+
deps.out(JSON.stringify(body ?? {}, null, 2));
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
129
164
|
}
|
|
130
165
|
const headers = buildHeaders(meta, opts);
|
|
131
166
|
const values = {
|
package/dist/command-tree.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"command-tree.js","sourceRoot":"","sources":["../src/command-tree.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"command-tree.js","sourceRoot":"","sources":["../src/command-tree.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A request body from flags. ONE reader for every command: what each flag is, and how its value is read, is the
|
|
3
|
+
* generated manifest's (`bodyFlags`, `bodyShorthands`: scripts/lib/body-flags.mjs), which is the API document's.
|
|
4
|
+
* Nothing here names a command or a field.
|
|
5
|
+
*
|
|
6
|
+
* WHAT WINS: a `--file` is the base, a flag replaces the same top-level field in it, and `--set path=value`
|
|
7
|
+
* changes one place inside the result, last. A short form (`--agent`) adds elements to its list; with the list's
|
|
8
|
+
* own flag (`--matrix`) on the same command line, both are kept, the list's own first. A short form of an OBJECT
|
|
9
|
+
* field is another way to write that field's own flag (`--run-counting influenced`), so there is nothing to order.
|
|
10
|
+
*
|
|
11
|
+
* Every refusal is a BodyValueError naming the flag: the caller reports it as a usage error (exit 2) before any
|
|
12
|
+
* request. Whether a body is VALID is the API's answer, never guessed here.
|
|
13
|
+
*/
|
|
14
|
+
import { type Command } from "commander";
|
|
15
|
+
import type { BodyFlagMeta, BodyShorthandMeta, OperationMeta } from "../generated/operations.js";
|
|
16
|
+
import { type ValueIo } from "./body-values.js";
|
|
17
|
+
type FlagsMeta = Pick<OperationMeta, "bodyFlags" | "bodyShorthands">;
|
|
18
|
+
/** The short forms given as flags of the command: those of a top-level list. */
|
|
19
|
+
export declare const topLevelShorthands: (meta: FlagsMeta) => readonly BodyShorthandMeta[];
|
|
20
|
+
/** The short form an object field's own flag also takes (`--run-counting influenced`), if the document has one. */
|
|
21
|
+
export declare const objectShorthandOf: (meta: FlagsMeta, flag: Pick<BodyFlagMeta, "name" | "flag">) => BodyShorthandMeta | undefined;
|
|
22
|
+
/** What a flag's value looks like in help: `<n>`, `<a,b>`, `<key=value,...>`. Empty for a boolean. */
|
|
23
|
+
export declare function valueFormOf(flag: Pick<BodyFlagMeta, "shape">): string;
|
|
24
|
+
/**
|
|
25
|
+
* Adds the body's flags to a command, and answers the ones it added: read the body with THAT (bodyFromFlags), so
|
|
26
|
+
* an option of the command's own that shares a body field's name (a hand-written command's `--series`) is never
|
|
27
|
+
* read as the field. They are hidden from commander's own option list: help prints them in a section of their
|
|
28
|
+
* own, with each field's description (core/body-help.ts).
|
|
29
|
+
*/
|
|
30
|
+
export declare function attachBodyFlags(leaf: Command, meta: FlagsMeta): Required<FlagsMeta>;
|
|
31
|
+
/**
|
|
32
|
+
* The top-level fields the flags name, or `{}` when none was given. Throws BodyValueError.
|
|
33
|
+
* `opts` is commander's parsed options for the command.
|
|
34
|
+
*/
|
|
35
|
+
export declare function bodyFromFlags(meta: FlagsMeta, opts: Readonly<Record<string, unknown>>, io: ValueIo): Record<string, unknown>;
|
|
36
|
+
/** Applies each `--set path=value` to the body, in order. A value is JSON when it reads as JSON, `@file` a file. */
|
|
37
|
+
export declare function applySets(body: Record<string, unknown>, sets: readonly string[] | undefined, io: ValueIo): Record<string, unknown>;
|
|
38
|
+
export {};
|
|
39
|
+
//# sourceMappingURL=body-flags.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"body-flags.d.ts","sourceRoot":"","sources":["../../src/core/body-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAYL,KAAK,OAAO,EACb,MAAM,kBAAkB,CAAC;AAE1B,KAAK,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,gBAAgB,CAAC,CAAC;AAMrE,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,KAAG,SAAS,iBAAiB,EACa,CAAC;AAE7F,mHAAmH;AACnH,eAAO,MAAM,iBAAiB,GAAI,MAAM,SAAS,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,KAAG,iBAAiB,GAAG,SACF,CAAC;AAKlH,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,MAAM,CAWrE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAwBnF;AAwHD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc5H;AAED,oHAAoH;AACpH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOlI"}
|
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A request body from flags. ONE reader for every command: what each flag is, and how its value is read, is the
|
|
3
|
+
* generated manifest's (`bodyFlags`, `bodyShorthands`: scripts/lib/body-flags.mjs), which is the API document's.
|
|
4
|
+
* Nothing here names a command or a field.
|
|
5
|
+
*
|
|
6
|
+
* WHAT WINS: a `--file` is the base, a flag replaces the same top-level field in it, and `--set path=value`
|
|
7
|
+
* changes one place inside the result, last. A short form (`--agent`) adds elements to its list; with the list's
|
|
8
|
+
* own flag (`--matrix`) on the same command line, both are kept, the list's own first. A short form of an OBJECT
|
|
9
|
+
* field is another way to write that field's own flag (`--run-counting influenced`), so there is nothing to order.
|
|
10
|
+
*
|
|
11
|
+
* Every refusal is a BodyValueError naming the flag: the caller reports it as a usage error (exit 2) before any
|
|
12
|
+
* request. Whether a body is VALID is the API's answer, never guessed here.
|
|
13
|
+
*/
|
|
14
|
+
import { Option } from "commander";
|
|
15
|
+
import { BodyValueError, mergeInto, readAssignments, readFileValue, readObject, readPattern, readValue, patternValues, setAt, splitOutside, } from "./body-values.js";
|
|
16
|
+
const collect = (value, previous) => [...(previous ?? []), value];
|
|
17
|
+
const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
|
|
18
|
+
const looksLikeJson = (text) => /^\s*[[{]/.test(text);
|
|
19
|
+
/** The short forms given as flags of the command: those of a top-level list. */
|
|
20
|
+
export const topLevelShorthands = (meta) => (meta.bodyShorthands ?? []).filter((s) => s.target !== "object" && !s.field.includes("."));
|
|
21
|
+
/** The short form an object field's own flag also takes (`--run-counting influenced`), if the document has one. */
|
|
22
|
+
export const objectShorthandOf = (meta, flag) => (meta.bodyShorthands ?? []).find((s) => s.target === "object" && s.field === flag.name && s.flag === flag.flag);
|
|
23
|
+
/** A value written as key=value pairs: its first piece starts with a key (a path) and `=`. */
|
|
24
|
+
const KEY_VALUE = /^\s*[A-Za-z_][A-Za-z0-9_.#[\]-]*\s*=/;
|
|
25
|
+
/** What a flag's value looks like in help: `<n>`, `<a,b>`, `<key=value,...>`. Empty for a boolean. */
|
|
26
|
+
export function valueFormOf(flag) {
|
|
27
|
+
const forms = {
|
|
28
|
+
string: "<text>",
|
|
29
|
+
number: "<n>",
|
|
30
|
+
boolean: "",
|
|
31
|
+
list: "<a,b,...>",
|
|
32
|
+
object: "<key=value,...>",
|
|
33
|
+
objects: "<key=value,...>",
|
|
34
|
+
json: "<json>",
|
|
35
|
+
};
|
|
36
|
+
return forms[flag.shape];
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Adds the body's flags to a command, and answers the ones it added: read the body with THAT (bodyFromFlags), so
|
|
40
|
+
* an option of the command's own that shares a body field's name (a hand-written command's `--series`) is never
|
|
41
|
+
* read as the field. They are hidden from commander's own option list: help prints them in a section of their
|
|
42
|
+
* own, with each field's description (core/body-help.ts).
|
|
43
|
+
*/
|
|
44
|
+
export function attachBodyFlags(leaf, meta) {
|
|
45
|
+
const has = (flag) => leaf.options.some((o) => o.long === `--${flag}` || o.long === `--no-${flag}`);
|
|
46
|
+
const bodyFlags = (meta.bodyFlags ?? []).filter((flag) => !has(flag.flag));
|
|
47
|
+
// A nested short form is a key inside its parent's value, never an option: it is kept whatever the command has.
|
|
48
|
+
const bodyShorthands = (meta.bodyShorthands ?? []).filter((short) => short.field.includes(".") || !has(short.flag));
|
|
49
|
+
const added = { bodyFlags, bodyShorthands };
|
|
50
|
+
for (const flag of bodyFlags) {
|
|
51
|
+
if (flag.shape === "boolean") {
|
|
52
|
+
leaf.addOption(new Option(`--${flag.flag}`).hideHelp());
|
|
53
|
+
leaf.addOption(new Option(`--no-${flag.flag}`).hideHelp());
|
|
54
|
+
}
|
|
55
|
+
else if (flag.shape === "list" || flag.shape === "object" || flag.shape === "objects") {
|
|
56
|
+
leaf.addOption(new Option(`--${flag.flag} <value>`).argParser(collect).hideHelp());
|
|
57
|
+
}
|
|
58
|
+
else {
|
|
59
|
+
leaf.addOption(new Option(`--${flag.flag} <value>`).hideHelp());
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
for (const short of topLevelShorthands(added)) {
|
|
63
|
+
leaf.addOption(new Option(`--${short.flag} <value>`).argParser(collect).hideHelp());
|
|
64
|
+
}
|
|
65
|
+
if (bodyFlags.length > 0) {
|
|
66
|
+
leaf.option("--set <path=value>", "set one place inside the body, after every other flag (repeatable): --set arms.1.label=Fast", collect);
|
|
67
|
+
leaf.option("--print-body", "print the request body these flags and --file make, and send nothing");
|
|
68
|
+
}
|
|
69
|
+
return added;
|
|
70
|
+
}
|
|
71
|
+
/** The nested short forms of one list's elements, by the key they are given under (`agent` → `cells`). */
|
|
72
|
+
function nestedKeysOf(meta, field, io) {
|
|
73
|
+
const nested = new Map();
|
|
74
|
+
for (const short of meta.bodyShorthands ?? []) {
|
|
75
|
+
const parent = short.field.split(".").slice(0, -1).join(".");
|
|
76
|
+
if (parent !== field)
|
|
77
|
+
continue;
|
|
78
|
+
const inner = short.field.split(".").at(-1);
|
|
79
|
+
nested.set(short.flag, {
|
|
80
|
+
// Inside its parent's value a short form is its head alone: the commas there belong to the parent.
|
|
81
|
+
read: (raw) => ({ field: inner, element: elementsOf(meta, short, raw, io, false)[0] }),
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
return nested;
|
|
85
|
+
}
|
|
86
|
+
/** `raw` as JSON when it is a JSON object or list, else undefined: a value that only starts like JSON is not one. */
|
|
87
|
+
function jsonElementsOf(raw) {
|
|
88
|
+
if (!looksLikeJson(raw))
|
|
89
|
+
return undefined;
|
|
90
|
+
try {
|
|
91
|
+
const value = JSON.parse(raw);
|
|
92
|
+
return Array.isArray(value) ? value : isRecord(value) ? [value] : undefined;
|
|
93
|
+
}
|
|
94
|
+
catch {
|
|
95
|
+
return undefined;
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* The elements one use of a short form names: usually one; several from a JSON list or a .json file holding one.
|
|
100
|
+
* A TEXT short form's value is the text, whatever it starts with (`--task "[Billing] How do I…"`): a whole element
|
|
101
|
+
* is given as @file.json, or with the list's own flag. A pattern's value is JSON only when it parses as an object
|
|
102
|
+
* or a list, so `--group "[Beta] docs"` is a label.
|
|
103
|
+
*/
|
|
104
|
+
function elementsOf(meta, short, raw, io, extras = true) {
|
|
105
|
+
const what = `--${short.flag}`;
|
|
106
|
+
if (raw.startsWith("@")) {
|
|
107
|
+
const value = readFileValue(raw.slice(1), io);
|
|
108
|
+
if (Array.isArray(value))
|
|
109
|
+
return value;
|
|
110
|
+
if (isRecord(value))
|
|
111
|
+
return [value];
|
|
112
|
+
if (short.text !== undefined)
|
|
113
|
+
return [{ ...structuredClone(short.defaults ?? {}), [short.text]: value }];
|
|
114
|
+
throw new BodyValueError(`${what}: ${raw.slice(1)} must hold a JSON object or list`);
|
|
115
|
+
}
|
|
116
|
+
// What the short form fills when the value does not say: a copy, so two elements never share one object.
|
|
117
|
+
const defaults = () => structuredClone(short.defaults ?? {});
|
|
118
|
+
if (short.text !== undefined)
|
|
119
|
+
return [{ ...defaults(), [short.text]: raw.startsWith("\\@") ? raw.slice(1) : raw }];
|
|
120
|
+
const asJson = jsonElementsOf(raw);
|
|
121
|
+
if (asJson)
|
|
122
|
+
return asJson;
|
|
123
|
+
const [head = "", ...rest] = extras ? splitOutside(raw, ",") : [raw];
|
|
124
|
+
const element = mergeInto(defaults(), readPattern(short.pattern ?? "", head.trim(), what));
|
|
125
|
+
if (rest.length > 0)
|
|
126
|
+
mergeInto(element, readAssignments(rest.join(","), short.keys, io, what, nestedKeysOf(meta, short.field, io)));
|
|
127
|
+
return [element];
|
|
128
|
+
}
|
|
129
|
+
function itemsOf(flag, raw, io) {
|
|
130
|
+
const what = `--${flag.flag}`;
|
|
131
|
+
if (raw.startsWith("@") || looksLikeJson(raw)) {
|
|
132
|
+
const value = readValue(raw, "json", io, what);
|
|
133
|
+
return Array.isArray(value) ? value : [value];
|
|
134
|
+
}
|
|
135
|
+
return splitOutside(raw, ",")
|
|
136
|
+
.filter((piece) => piece.trim() !== "")
|
|
137
|
+
.map((piece) => readValue(piece.trim(), flag.item ?? "string", io, what));
|
|
138
|
+
}
|
|
139
|
+
function elementsOfList(meta, flag, raw, io) {
|
|
140
|
+
const what = `--${flag.flag}`;
|
|
141
|
+
if (raw.startsWith("@") || looksLikeJson(raw)) {
|
|
142
|
+
const value = raw.startsWith("@") ? readFileValue(raw.slice(1), io) : readValue(raw, "json", io, what);
|
|
143
|
+
if (Array.isArray(value))
|
|
144
|
+
return value;
|
|
145
|
+
if (isRecord(value))
|
|
146
|
+
return [value];
|
|
147
|
+
throw new BodyValueError(`${what} takes key=value pairs, a JSON object or list, or @file.json`);
|
|
148
|
+
}
|
|
149
|
+
return [readAssignments(raw, flag.keys ?? [], io, what, nestedKeysOf(meta, flag.name, io))];
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* One value of an object flag. With a short form declared for the field, a value that is not key=value pairs, JSON
|
|
153
|
+
* or @file is read by it: one of its words is that word's fixed value (`count_all` → null), anything else is read
|
|
154
|
+
* by its pattern over the short form's defaults. Every other value is read as any object flag's is.
|
|
155
|
+
*/
|
|
156
|
+
function objectValueOf(meta, flag, raw, io) {
|
|
157
|
+
const what = `--${flag.flag}`;
|
|
158
|
+
const short = objectShorthandOf(meta, flag);
|
|
159
|
+
if (!short || raw.startsWith("@") || looksLikeJson(raw) || KEY_VALUE.test(raw))
|
|
160
|
+
return readObject(raw, flag.keys ?? [], io, what);
|
|
161
|
+
const word = raw.trim();
|
|
162
|
+
if (short.words && Object.prototype.hasOwnProperty.call(short.words, word))
|
|
163
|
+
return structuredClone(short.words[word]);
|
|
164
|
+
const defaults = structuredClone(short.defaults ?? {});
|
|
165
|
+
if (short.text !== undefined)
|
|
166
|
+
return { ...defaults, [short.text]: raw };
|
|
167
|
+
return mergeInto(defaults, patternValues(readPattern(short.pattern ?? "", word, what), short.keys));
|
|
168
|
+
}
|
|
169
|
+
/** One flag's field value, from what commander collected for it. `null` (a nullable field) is the word itself. */
|
|
170
|
+
function valueOf(meta, flag, given, io) {
|
|
171
|
+
const what = `--${flag.flag}`;
|
|
172
|
+
const uses = Array.isArray(given) ? given : [given];
|
|
173
|
+
if (flag.nullable && uses.length === 1 && uses[0] === "null")
|
|
174
|
+
return null;
|
|
175
|
+
switch (flag.shape) {
|
|
176
|
+
case "boolean":
|
|
177
|
+
return given === true;
|
|
178
|
+
case "string":
|
|
179
|
+
case "number":
|
|
180
|
+
case "json":
|
|
181
|
+
return readValue(uses.at(-1), flag.shape, io, what);
|
|
182
|
+
case "list":
|
|
183
|
+
return uses.flatMap((raw) => itemsOf(flag, raw, io));
|
|
184
|
+
case "object": {
|
|
185
|
+
const values = uses.map((raw) => objectValueOf(meta, flag, raw, io));
|
|
186
|
+
if (values.length === 1)
|
|
187
|
+
return values[0];
|
|
188
|
+
// Several uses merge into one object; a use that stands for null has nothing to merge with.
|
|
189
|
+
if (values.includes(null))
|
|
190
|
+
throw new BodyValueError(`${what}: a value that stands for null cannot be combined with another use of ${what}`);
|
|
191
|
+
return values.reduce((merged, value) => mergeInto(merged, value), {});
|
|
192
|
+
}
|
|
193
|
+
case "objects":
|
|
194
|
+
return uses.flatMap((raw) => elementsOfList(meta, flag, raw, io));
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
const wasGiven = (value) => value !== undefined && !(Array.isArray(value) && value.length === 0);
|
|
198
|
+
/**
|
|
199
|
+
* The top-level fields the flags name, or `{}` when none was given. Throws BodyValueError.
|
|
200
|
+
* `opts` is commander's parsed options for the command.
|
|
201
|
+
*/
|
|
202
|
+
export function bodyFromFlags(meta, opts, io) {
|
|
203
|
+
const fields = {};
|
|
204
|
+
for (const flag of meta.bodyFlags ?? []) {
|
|
205
|
+
const given = opts[flag.optionKey];
|
|
206
|
+
if (wasGiven(given))
|
|
207
|
+
fields[flag.name] = valueOf(meta, flag, given, io);
|
|
208
|
+
}
|
|
209
|
+
for (const short of topLevelShorthands(meta)) {
|
|
210
|
+
const given = opts[short.optionKey];
|
|
211
|
+
if (!wasGiven(given))
|
|
212
|
+
continue;
|
|
213
|
+
const elements = given.flatMap((raw) => elementsOf(meta, short, raw, io));
|
|
214
|
+
const held = fields[short.field];
|
|
215
|
+
fields[short.field] = [...(Array.isArray(held) ? held : []), ...elements];
|
|
216
|
+
}
|
|
217
|
+
return fields;
|
|
218
|
+
}
|
|
219
|
+
/** Applies each `--set path=value` to the body, in order. A value is JSON when it reads as JSON, `@file` a file. */
|
|
220
|
+
export function applySets(body, sets, io) {
|
|
221
|
+
for (const assignment of sets ?? []) {
|
|
222
|
+
const eq = assignment.indexOf("=");
|
|
223
|
+
if (eq <= 0)
|
|
224
|
+
throw new BodyValueError(`--set takes path=value, not '${assignment}'`);
|
|
225
|
+
setAt(body, assignment.slice(0, eq).trim(), readValue(assignment.slice(eq + 1), undefined, io, `--set ${assignment.slice(0, eq)}`));
|
|
226
|
+
}
|
|
227
|
+
return body;
|
|
228
|
+
}
|
|
229
|
+
//# sourceMappingURL=body-flags.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"body-flags.js","sourceRoot":"","sources":["../../src/core/body-flags.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What `--help` says about a command's body: each field as the flag it is (with the keys an object takes and the
|
|
3
|
+
* values each allows), the short forms the document declares, and how a value is written. Pure text, from the
|
|
4
|
+
* manifest alone.
|
|
5
|
+
*/
|
|
6
|
+
import type { OperationMeta } from "../generated/operations.js";
|
|
7
|
+
type BodyHelpMeta = Pick<OperationMeta, "bodyFields" | "bodyFlags" | "bodyShorthands">;
|
|
8
|
+
/** The body section of a command's help, or no lines for a command with no body field. */
|
|
9
|
+
export declare function bodyHelpLines(meta: BodyHelpMeta): string[];
|
|
10
|
+
export {};
|
|
11
|
+
//# sourceMappingURL=body-help.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"body-help.d.ts","sourceRoot":"","sources":["../../src/core/body-help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAA+D,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG7H,KAAK,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,WAAW,GAAG,gBAAgB,CAAC,CAAC;AAqCvF,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,CAwC1D"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What `--help` says about a command's body: each field as the flag it is (with the keys an object takes and the
|
|
3
|
+
* values each allows), the short forms the document declares, and how a value is written. Pure text, from the
|
|
4
|
+
* manifest alone.
|
|
5
|
+
*/
|
|
6
|
+
import { objectShorthandOf, topLevelShorthands, valueFormOf } from "./body-flags.js";
|
|
7
|
+
/** `{harness}/{provider?}/{model}` as a person reads it: `<harness>/[provider]/<model>`. */
|
|
8
|
+
const patternWords = (pattern) => pattern.replace(/\{([A-Za-z0-9]+)(\?)?\}/g, (_m, name, optional) => (optional ? `[${name}]` : `<${name}>`));
|
|
9
|
+
function typeOf(field, flag) {
|
|
10
|
+
if (field.enum?.length)
|
|
11
|
+
return field.enum.join("|");
|
|
12
|
+
if (flag?.shape === "list")
|
|
13
|
+
return `${flag.enum?.length ? flag.enum.join("|") : (flag.item ?? "string")} list`;
|
|
14
|
+
if (flag?.shape === "objects")
|
|
15
|
+
return "list of objects";
|
|
16
|
+
return flag?.shape ?? field.kind;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* One key as --help writes it: written as it is typed when the document lists its values (`policy=hold_back_screened`,
|
|
20
|
+
* `levels=aware|influenced`), and marked when it is a list (given once per item).
|
|
21
|
+
*/
|
|
22
|
+
const keyWords = (k) => `${k.path}${k.values?.length ? `=${k.values.join("|")}` : ""}${k.kind === "list" ? " (list)" : ""}`;
|
|
23
|
+
/** The keys an object flag takes, on a line of their own: the first few the document declares. */
|
|
24
|
+
function keysLine(flag, indent) {
|
|
25
|
+
const keys = flag?.keys ?? [];
|
|
26
|
+
if ((flag?.shape !== "object" && flag?.shape !== "objects") || keys.length === 0)
|
|
27
|
+
return [];
|
|
28
|
+
const shown = keys.slice(0, 10).map(keyWords);
|
|
29
|
+
return [`${indent}keys: ${shown.join(", ")}${keys.length > shown.length ? ", …" : ""}`];
|
|
30
|
+
}
|
|
31
|
+
/** A short form's value as --help writes it: its pattern (`[policy]:[screen]:<levels>`) or text, then its words. */
|
|
32
|
+
const shortValueWords = (s) => [s.pattern !== undefined ? patternWords(s.pattern) : `<${s.text}>`, ...Object.keys(s.words ?? {})].join(" | ");
|
|
33
|
+
/** The short form an object field's own flag also takes, on a line of its own under the field. */
|
|
34
|
+
function objectShortLine(meta, flag, indent) {
|
|
35
|
+
const short = flag && flag.shape === "object" ? objectShorthandOf(meta, flag) : undefined;
|
|
36
|
+
return short ? [`${indent}or: --${short.flag} ${shortValueWords(short)} — ${short.description}`] : [];
|
|
37
|
+
}
|
|
38
|
+
/** The body section of a command's help, or no lines for a command with no body field. */
|
|
39
|
+
export function bodyHelpLines(meta) {
|
|
40
|
+
const fields = meta.bodyFields ?? [];
|
|
41
|
+
if (fields.length === 0)
|
|
42
|
+
return [];
|
|
43
|
+
const flags = new Map((meta.bodyFlags ?? []).map((f) => [f.name, f]));
|
|
44
|
+
const label = (f) => {
|
|
45
|
+
const flag = flags.get(f.name);
|
|
46
|
+
if (!flag)
|
|
47
|
+
return `${f.name}${f.required ? "*" : ""}`;
|
|
48
|
+
const form = valueFormOf(flag);
|
|
49
|
+
// A boolean is set with --x and cleared with --no-x: the one way to turn off a field whose default is true.
|
|
50
|
+
const name = flag.shape === "boolean" ? `--[no-]${flag.flag}` : `--${flag.flag}`;
|
|
51
|
+
return `${name}${form ? ` ${form}` : ""}${f.required ? " *" : ""}`;
|
|
52
|
+
};
|
|
53
|
+
const width = Math.min(34, Math.max(...fields.map((f) => label(f).length)));
|
|
54
|
+
const pad = " ".repeat(width + 4);
|
|
55
|
+
const lines = ["", flags.size > 0 ? "Body fields, each a flag (* = required; a flag wins over the same field of --file):" : "Body fields (* = required):"];
|
|
56
|
+
for (const f of fields) {
|
|
57
|
+
const flag = flags.get(f.name);
|
|
58
|
+
const desc = f.description ? ` — ${f.description}` : "";
|
|
59
|
+
lines.push(` ${label(f).padEnd(width)} ${typeOf(f, flag)}${desc}`, ...keysLine(flag, pad), ...objectShortLine(meta, flag, pad));
|
|
60
|
+
}
|
|
61
|
+
const shorts = topLevelShorthands(meta);
|
|
62
|
+
if (shorts.length > 0) {
|
|
63
|
+
lines.push("", "Short forms (each use adds one element to its list):");
|
|
64
|
+
const shortLabel = (s) => `--${s.flag} ${s.pattern !== undefined ? patternWords(s.pattern) : `<${s.text}>`}`;
|
|
65
|
+
const shortWidth = Math.max(...shorts.map((s) => shortLabel(s).length));
|
|
66
|
+
for (const s of shorts) {
|
|
67
|
+
lines.push(` ${shortLabel(s).padEnd(shortWidth)} ${s.field} — ${s.description}`);
|
|
68
|
+
const inner = (meta.bodyShorthands ?? []).filter((n) => n.field.startsWith(`${s.field}.`));
|
|
69
|
+
for (const n of inner)
|
|
70
|
+
lines.push(` ${" ".repeat(shortWidth)} inside it: ${n.flag}=${n.pattern !== undefined ? patternWords(n.pattern) : `<${n.text}>`} adds to ${n.field.split(".").at(-1)}`);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
if (flags.size > 0) {
|
|
74
|
+
lines.push("", "Writing a value: an object is key=value,key=value (a key may be a path: params.temperature=0.2), or JSON, or", "@file.json. A list key is given once per item (levels=aware,levels=influenced) or as a JSON list. A list flag", "may be repeated. --set path=value changes one place last; --print-body shows the body and sends nothing.");
|
|
75
|
+
}
|
|
76
|
+
return lines;
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=body-help.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"body-help.js","sourceRoot":"","sources":["../../src/core/body-help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIrF,4FAA4F;AAC5F,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE,CAC/C,OAAO,CAAC,OAAO,CAAC,0BAA0B,EAAE,CAAC,EAAE,EAAE,IAAY,EAAE,QAAgB,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;AAE9H,SAAS,MAAM,CAAC,KAAoB,EAAE,IAA8B;IAClE,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,IAAI,EAAE,KAAK,KAAK,MAAM;QAAE,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC;IAC/G,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS;QAAE,OAAO,iBAAiB,CAAC;IACxD,OAAO,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,QAAQ,GAAG,CAAC,CAAc,EAAU,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAEjJ,kGAAkG;AAClG,SAAS,QAAQ,CAAC,IAA8B,EAAE,MAAc;IAC9D,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,QAAQ,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,MAAM,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,oHAAoH;AACpH,MAAM,eAAe,GAAG,CAAC,CAAoB,EAAU,EAAE,CACvD,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAEjH,kGAAkG;AAClG,SAAS,eAAe,CAAC,IAAkB,EAAE,IAA8B,EAAE,MAAc;IACzF,MAAM,KAAK,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,KAAK,CAAC,IAAI,IAAI,eAAe,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxG,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,aAAa,CAAC,IAAkB;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAU,EAAE;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,4GAA4G;QAC5G,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACjF,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACrE,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,qFAAqF,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;IAC3J,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACpI,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,sDAAsD,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,CAAC,CAA0B,EAAU,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QAC9I,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACnF,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC3F,KAAK,MAAM,CAAC,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnM,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CACR,EAAE,EACF,8GAA8G,EAC9G,+GAA+G,EAC/G,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* How text on a command line becomes a value of a request body. Pure: reading a file goes through `read`.
|
|
3
|
+
*
|
|
4
|
+
* ONE small language, used by every body flag of every command (core/body-flags.ts), so a caller learns it once:
|
|
5
|
+
*
|
|
6
|
+
* key=value,key=value an object. A key is a path (`params.temperature`, `addons.mcp#docs.url`); a key given
|
|
7
|
+
* twice builds a list where the document says the field is one.
|
|
8
|
+
* {"json": true} / [..] JSON, taken as written.
|
|
9
|
+
* @path the file's content: JSON when the file ends in .json, its text otherwise.
|
|
10
|
+
* \@text the text "@text" (a leading backslash keeps the @ literal).
|
|
11
|
+
*
|
|
12
|
+
* A value is read by the kind the DOCUMENT declares for its key (core/operation-meta BodyKeyMeta): `model=5` stays
|
|
13
|
+
* the string "5" and `params.temperature=0.2` is the number 0.2. Only a key the document does not declare (a
|
|
14
|
+
* record's key is its caller's) is read as JSON when it is JSON, and as text otherwise.
|
|
15
|
+
*
|
|
16
|
+
* A comma inside quotes, braces or brackets does not split, and `\,` is a literal comma.
|
|
17
|
+
*/
|
|
18
|
+
import type { BodyKeyMeta } from "../generated/operations.js";
|
|
19
|
+
export declare class BodyValueError extends Error {
|
|
20
|
+
}
|
|
21
|
+
export interface ValueIo {
|
|
22
|
+
/** The text of a file named after `@`. Throws when it cannot be read. */
|
|
23
|
+
read(path: string): string;
|
|
24
|
+
}
|
|
25
|
+
type Kind = BodyKeyMeta["kind"] | "object";
|
|
26
|
+
/** Splits on `separator` outside quotes, braces and brackets. A backslash keeps the next character. */
|
|
27
|
+
export declare function splitOutside(text: string, separator: string): string[];
|
|
28
|
+
/** The content named by `@path`: JSON for a .json file, the text (without its last line break) for any other. */
|
|
29
|
+
export declare function readFileValue(path: string, io: ValueIo): unknown;
|
|
30
|
+
/** One value, read as `kind`. `undefined` kind: the document does not declare it, so JSON when it is JSON. */
|
|
31
|
+
export declare function readValue(raw: string, kind: Kind | undefined, io: ValueIo, what: string): unknown;
|
|
32
|
+
/** Sets `value` at a dotted path inside `target`, creating objects on the way. `append` adds to a list there. */
|
|
33
|
+
export declare function setAt(target: Record<string, unknown>, path: string, value: unknown, append?: boolean): void;
|
|
34
|
+
/** Merges `patch` into `target`, object by object; anything else in `patch` replaces what `target` held. */
|
|
35
|
+
export declare function mergeInto(target: Record<string, unknown>, patch: Record<string, unknown>): Record<string, unknown>;
|
|
36
|
+
/** What a key inside an object means beyond a plain field: a nested short form (`agent=` adds to `cells`). */
|
|
37
|
+
export interface NestedKey {
|
|
38
|
+
/** Reads the value into one element and says which list of the object it joins. */
|
|
39
|
+
read(raw: string): {
|
|
40
|
+
field: string;
|
|
41
|
+
element: unknown;
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* `key=value,key=value` as an object. `keys` are the paths the document declares (their kinds); `nested` maps a
|
|
46
|
+
* key to a short form of a list inside the object. A piece with no `=` is refused, naming it.
|
|
47
|
+
*/
|
|
48
|
+
export declare function readAssignments(text: string, keys: readonly BodyKeyMeta[], io: ValueIo, what: string, nested?: ReadonlyMap<string, NestedKey>): Record<string, unknown>;
|
|
49
|
+
/** The object a flag's value names: JSON object, `@file`, or `key=value` pairs. */
|
|
50
|
+
export declare function readObject(raw: string, keys: readonly BodyKeyMeta[], io: ValueIo, what: string, nested?: ReadonlyMap<string, NestedKey>): Record<string, unknown>;
|
|
51
|
+
/**
|
|
52
|
+
* Reads the head of a short form by its pattern (`{harness}/{provider?}/{model}`): the text between two
|
|
53
|
+
* placeholders is the separator. With as many parts as REQUIRED placeholders, the optional ones are left out;
|
|
54
|
+
* each part more fills one optional placeholder, the ones nearest the end first (`{policy?}:{screen?}:{levels}`
|
|
55
|
+
* reads `a`, `s:a` and `p:s:a`); with more parts than placeholders, the last one takes what is left.
|
|
56
|
+
*/
|
|
57
|
+
export declare function readPattern(pattern: string, head: string, what: string): Record<string, string>;
|
|
58
|
+
/**
|
|
59
|
+
* What a short form's placeholders read, as the fields' values: a field the document declares a list takes its
|
|
60
|
+
* items joined by `,` or `+` (`aware,influenced`, `aware+influenced`); every other field takes the text.
|
|
61
|
+
*/
|
|
62
|
+
export declare function patternValues(read: Readonly<Record<string, string>>, keys: readonly BodyKeyMeta[]): Record<string, unknown>;
|
|
63
|
+
export {};
|
|
64
|
+
//# sourceMappingURL=body-values.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"body-values.d.ts","sourceRoot":"","sources":["../../src/core/body-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C,MAAM,WAAW,OAAO;IACtB,yEAAyE;IACzE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,KAAK,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;AAE3C,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BtE;AAYD,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAQhE;AAED,8GAA8G;AAC9G,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAqBjG;AAiBD,iHAAiH;AACjH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,IAAI,CAwBzG;AAED,4GAA4G;AAC5G,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMlH;AAED,8GAA8G;AAC9G,MAAM,WAAW,SAAS;IACxB,mFAAmF;IACnF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CACxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAa,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzB;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsB/F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa3H"}
|