@w6w/cli 0.9.16 → 0.9.23

package/README.md

@@ -31,6 +31,8 @@ printf '%s' "$W6W_TOKEN" | w6w auth login -   # preferred: keeps the token out o
 w6w auth login <token>                         # also works, but the token lands in history and `ps`
 w6w auth status                                # base URL, where it came from, masked token
 w6w auth logout
+w6w config get-base-url                        # effective base URL and its source
+w6w config set-base-url https://w6w.example.com  # save it (tokens are per host: auth login again)
 ```
 
 The token is stored per user (`~/.config/w6w/config.json`, or `$XDG_CONFIG_HOME/w6w/…`;
@@ -60,6 +62,7 @@ server reachable, which is exactly when people need them most.
 w6w me                        # who am I, and which CLI version is this? (alias: info)
 
 # Discover what you can run — a `conn_…`, `wf_…`, `fn_…` or `ep_…` id.
+w6w ls workflows              # also: ls integrations | functions | endpoints (endpoints is unstable)
 w6w connections list          # short forms: `w6w conn ls`, `w6w wf ls`, `w6w docs ls`
 w6w workflows list
 w6w functions list

package/dist/mod.d.ts

@@ -86,7 +86,7 @@ export interface CommandContext {
     readonly env: EnvReader;
     /** The stored per-user config, read once before the handler runs (nothing stored by default). */
     readonly stored: StoredConfig;
-    /** Where the config is persisted. Only the `auth` commands write through it. */
+    /** Where the config is persisted. Only the `auth` and `config` commands write through it. */
     readonly store: ConfigStore;
     /** Standard input, for `auth login -`. */
     readonly stdin: StdinSource;

package/dist/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../mod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../mod.ts"],"names":[],"mappings":"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"}

package/dist/mod.js

@@ -53,7 +53,7 @@ export { COMMAND_PATHS, EXIT_CODES, GLOBAL_FLAGS, HELP_TREE } from "./src/help.g
  * The explicit `: string` annotation is required, not decorative: JSR publishes
  * this file as TypeScript source and rejects inferred public types.
  */
-export const VERSION = "0.9.16";
+export const VERSION = "0.9.23";
 /** `w6w help <command>` is accepted as an alias for `w6w <command> --help`. */
 const HELP_COMMAND = "help";
 /**

package/dist/src/args.d.ts

@@ -50,6 +50,8 @@ export interface Invocation {
     globals: GlobalOptions;
     /** Non-global flags, keyed by camelCased name. Empty unless `flags` was passed. */
     options: Record<string, string | boolean>;
+    /** Every value of a repeatable flag (see {@linkcode REPEATABLE_FLAGS}), in order, by camelCased name. */
+    lists?: Record<string, string[]>;
 }
 /** What `parse()` returns: a parsed command line, or a usage error to report. */
 export type ParseResult = {
@@ -67,6 +69,11 @@ export interface ParseOptions {
     /** The command paths that exist. Defaults to the generated contract's. */
     commands?: readonly (readonly string[])[];
 }
+/**
+ * Flags that may be given more than once. Their values accumulate in
+ * `Invocation.lists`; `options` still holds the last one, as for every flag.
+ */
+export declare const REPEATABLE_FLAGS: ReadonlySet<string>;
 /**
  * Short spellings for a group name — pure typing convenience, not a second
  * command. `w6w conn list` and `w6w connections list` resolve to the exact same
@@ -87,7 +94,7 @@ export declare const SUBCOMMAND_ALIASES: Record<string, string>;
  *
  * Accepted forms: `--flag`, `--flag value`, `--flag=value`, a short alias
  * (`-h`, `-v`), and `--` to end flag parsing. A repeated flag keeps the last
- * value. An unknown flag, a missing value, or a value handed to a boolean flag
+ * value (a repeatable one also accumulates all of them). An unknown flag, a missing value, or a value handed to a boolean flag
  * are all reported as usage errors.
  */
 export declare function parse(argv: string[], options?: ParseOptions): ParseResult;

package/dist/src/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,QAAQ,EAIrC,CAAC;AAEJ,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CAC3C;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEtD,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CAC3C;AAmCD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIhD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAErD,CAAC;AAuBF;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CA6E7E"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,QAAQ,EAIrC,CAAC;AAEJ,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAC1C,yGAAyG;IACzG,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEtD,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CAC3C;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAuB,CAAC;AAmCzE;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIhD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAErD,CAAC;AAuBF;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CAmF7E"}

package/dist/src/args.js

@@ -26,6 +26,11 @@ export const GLOBAL_FLAG_SPECS = GLOBAL_FLAGS.map((flag) => ({
     alias: flag.alias,
     type: flag.type,
 }));
+/**
+ * Flags that may be given more than once. Their values accumulate in
+ * `Invocation.lists`; `options` still holds the last one, as for every flag.
+ */
+export const REPEATABLE_FLAGS = new Set(["--stop"]);
 /** `--base-url` → `baseUrl`. */
 function optionKey(flagName) {
     return flagName.replace(/^--/, "").replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
@@ -99,7 +104,7 @@ function normalizeAliases(operands) {
  *
  * Accepted forms: `--flag`, `--flag value`, `--flag=value`, a short alias
  * (`-h`, `-v`), and `--` to end flag parsing. A repeated flag keeps the last
- * value. An unknown flag, a missing value, or a value handed to a boolean flag
+ * value (a repeatable one also accumulates all of them). An unknown flag, a missing value, or a value handed to a boolean flag
  * are all reported as usage errors.
  */
 export function parse(argv, options = {}) {
@@ -108,6 +113,12 @@ export function parse(argv, options = {}) {
     const byName = new Map(specs.map((spec) => [spec.name, spec]));
     const byAlias = new Map(specs.filter((spec) => spec.alias).map((spec) => [spec.alias, spec]));
     const values = {};
+    const lists = {};
+    const record = (name, value) => {
+        values[optionKey(name)] = value;
+        if (REPEATABLE_FLAGS.has(name))
+            (lists[optionKey(name)] ??= []).push(value);
+    };
     const operands = [];
     const fail = (message) => ({
         ok: false,
@@ -137,14 +148,14 @@ export function parse(argv, options = {}) {
             continue;
         }
         if (inlineValue !== null) {
-            values[optionKey(spec.name)] = inlineValue;
+            record(spec.name, inlineValue);
             continue;
         }
         const next = argv[i + 1];
         if (next === undefined || (next.startsWith("-") && next !== "-")) {
             return fail(`flag ${spec.name} requires a value`);
         }
-        values[optionKey(spec.name)] = next;
+        record(spec.name, next);
         i++;
     }
     const { command, positionals } = splitCommand(normalizeAliases(operands), commands);
@@ -168,6 +179,7 @@ export function parse(argv, options = {}) {
                 help: values.help === true,
             },
             options: extras,
+            lists,
         },
     };
 }

package/dist/src/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAY7E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAe,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvE,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,IAAI,EAAE,IAAI,CAAC,IAAI;CAChB,CAAC,CAAC,CAAC;AAwCJ;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEzE,gCAAgC;AAChC,SAAS,SAAS,CAAC,QAAgB;IACjC,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAChG,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,YAAY,CACnB,QAAkB,EAClB,QAAwC;IAExC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACnE,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3C,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CACxE,CAAC;QACF,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,iFAAiF;AACjF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,WAAW;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,EAAE,EAAE,MAAM;CACX,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3C,MAAM,UAAU,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IACjC,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,UAAU,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,IAAc,EAAE,UAAwB,EAAE;IAC9D,MAAM,KAAK,GAAe,CAAC,GAAG,iBAAiB,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAe,EAAE,IAAI,CAAC,CAAC,CAC/E,CAAC;IAEF,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;QAC7C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;QAChC,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9E,CAAC,CAAC;IACF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,OAAe,EAAe,EAAE,CAAC,CAAC;QAC9C,EAAE,EAAE,KAAK;QACT,OAAO;QACP,OAAO,EAAE,YAAY,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO;KACpE,CAAC,CAAC;IAEH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEnF,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;QAEnD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,WAAW,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,iBAAiB,CAAC,CAAC;YAC1E,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YACpC,SAAS;QACX,CAAC;QAED,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,mBAAmB,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC,EAAE,CAAC;IACN,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAChD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,UAAU,EAAE;YACV,OAAO;YACP,WAAW;YACX,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACxE,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAClE,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;gBAC1B,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;gBAChC,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;gBAChC,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;aAC3B;YACD,OAAO,EAAE,MAAM;YACf,KAAK;SACN;KACF,CAAC;AACJ,CAAC"}

package/dist/src/commands/agents-studio.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `w6w skills|context|agents …` — the agent-authoring surface at the command line.
+ *
+ * Seventeen commands, **one SDK call each**. Skill upload is deliberately not
+ * here: it is `w6w assets upload --purpose skill`.
+ *
+ * Two write paths carry optimistic concurrency — `agents update` and
+ * `context entries-update`. Both send the body `revision` and, when given, the
+ * `--if-unmodified-since` precondition. A `409` is re-thrown as an `ApiError`
+ * with a message naming the **current revision** and what to do next; a `428`
+ * says the precondition is required. Both keep their status, so the exit code is
+ * the API-error code and a script can tell the write was refused. A uniform
+ * `404` needs no handling at all: `main()` prints the server's one-line message
+ * and exits, never a stack trace.
+ *
+ * Only flags the user typed reach the wire, so an omitted `--description` leaves
+ * the field alone and `--description ""` clears it.
+ *
+ * @module
+ */
+import type { CommandRegistry } from "../../mod.ts";
+/** Keys are the help tree's command paths (`naming.cli`). */
+export declare const AGENT_STUDIO_COMMANDS: CommandRegistry;
+//# sourceMappingURL=agents-studio.d.ts.map

package/dist/src/commands/agents-studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-studio.d.ts","sourceRoot":"","sources":["../../../src/commands/agents-studio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAkC,eAAe,EAAE,MAAM,cAAc,CAAC;AA+hBpF,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,EAAE,eAyBnC,CAAC"}

package/dist/src/commands/agents-studio.js

@@ -0,0 +1,431 @@
+/**
+ * `w6w skills|context|agents …` — the agent-authoring surface at the command line.
+ *
+ * Seventeen commands, **one SDK call each**. Skill upload is deliberately not
+ * here: it is `w6w assets upload --purpose skill`.
+ *
+ * Two write paths carry optimistic concurrency — `agents update` and
+ * `context entries-update`. Both send the body `revision` and, when given, the
+ * `--if-unmodified-since` precondition. A `409` is re-thrown as an `ApiError`
+ * with a message naming the **current revision** and what to do next; a `428`
+ * says the precondition is required. Both keep their status, so the exit code is
+ * the API-error code and a script can tell the write was refused. A uniform
+ * `404` needs no handling at all: `main()` prints the server's one-line message
+ * and exits, never a stack trace.
+ *
+ * Only flags the user typed reach the wire, so an omitted `--description` leaves
+ * the field alone and `--description ""` clears it.
+ *
+ * @module
+ */
+import { ApiError } from "@w6w/sdk";
+import { argument, noExtraArguments, requiredFlag, table, textFlag, usageError } from "./shared.js";
+/** A positive-integer flag, or `undefined` when absent. */
+function count(context, name) {
+    const value = textFlag(context, name);
+    if (value === undefined)
+        return undefined;
+    if (!/^[0-9]+$/.test(value) || Number(value) < 1) {
+        throw usageError(context, `\`--${name}\` must be a positive integer.`);
+    }
+    return Number(value);
+}
+/** A non-negative integer flag that must be present (a revision may be `0`). */
+function revision(context) {
+    const value = requiredFlag(context, "revision", "--revision <n>");
+    if (!/^[0-9]+$/.test(value)) {
+        throw usageError(context, "`--revision` must be a non-negative integer.");
+    }
+    return Number(value);
+}
+function includeArchived(context) {
+    return context.invocation.options.includeArchived === true ? { includeArchived: true } : {};
+}
+function tags(context) {
+    const value = textFlag(context, "tags");
+    if (value === undefined)
+        return undefined;
+    return value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+}
+/** A flag whose value is a JSON array of pins. */
+function jsonList(context, name) {
+    const value = textFlag(context, name);
+    if (value === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw usageError(context, `\`--${name}\` must be valid JSON (an array).`);
+    }
+    if (!Array.isArray(parsed))
+        throw usageError(context, `\`--${name}\` must be a JSON array.`);
+    return parsed;
+}
+function visibility(context) {
+    const value = textFlag(context, "visibility");
+    if (value === undefined)
+        return undefined;
+    if (value !== "private" && value !== "project" && value !== "account") {
+        throw usageError(context, "`--visibility` must be private, project or account.");
+    }
+    return value;
+}
+const cell = (value) => value === null || value === undefined || value === "" ? "-" : String(value);
+/**
+ * Run a precondition write, turning a 409 / 428 into an actionable message.
+ *
+ * The thrown error is still an `ApiError` with the original status, code and
+ * body, so the exit code and `--json` consumers are unchanged; only the sentence
+ * a human reads is replaced.
+ */
+async function guarded(what, refetch, run) {
+    try {
+        return await run();
+    }
+    catch (err) {
+        if (err instanceof ApiError && err.status === 409) {
+            const current = err.raw?.error
+                ?.currentRevision;
+            const at = current === undefined ? "" : ` (current revision: ${current})`;
+            throw new ApiError(409, err.code, `Conflict: ${what} changed since you read it${at}. ` +
+                `Re-read it with \`${refetch}\` and retry with the new revision.`, err.raw);
+        }
+        if (err instanceof ApiError && err.status === 428) {
+            throw new ApiError(428, err.code, `Precondition required: ${what} can only be updated with a precondition. ` +
+                `Pass \`--if-unmodified-since <ts>\` (the updatedAt you read).`, err.raw);
+        }
+        throw err;
+    }
+}
+const precondition = (context) => ({
+    ifUnmodifiedSince: textFlag(context, "ifUnmodifiedSince"),
+});
+// ---------------------------------------------------------------- skills
+const skillRow = (s) => [s.id, s.name, cell(s.activeVersionId), cell(s.archivedAt)];
+const skillsList = async (context) => {
+    noExtraArguments(context, 0);
+    const rows = await context.client().skills.list({
+        ...includeArchived(context),
+        limit: count(context, "limit"),
+    });
+    context.out.emit(rows, (styles) => rows.length === 0
+        ? styles.dim("No skills.")
+        : table(["ID", "NAME", "ACTIVE VERSION", "ARCHIVED"], rows.map(skillRow), styles));
+};
+const skillsGet = async (context) => {
+    const id = argument(context, 0, "a skill id (see: `w6w skills list`)");
+    noExtraArguments(context, 1);
+    const skill = await context.client().skills.get(id);
+    context.out.emit(skill, (styles) => table(["ID", "NAME", "ACTIVE VERSION", "ARCHIVED"], [skillRow(skill)], styles));
+};
+const skillsVersions = async (context) => {
+    const id = argument(context, 0, "a skill id (see: `w6w skills list`)");
+    noExtraArguments(context, 1);
+    const rows = await context.client().skills.versions(id);
+    const row = (v) => {
+        const r = v;
+        return [cell(r.id), cell(r.version), cell(r.createdAt)];
+    };
+    context.out.emit(rows, (styles) => rows.length === 0
+        ? styles.dim("No versions.")
+        : table(["ID", "VERSION", "CREATED"], rows.map(row), styles));
+};
+const skillsArchive = async (context) => {
+    const id = argument(context, 0, "a skill id (see: `w6w skills list`)");
+    noExtraArguments(context, 1);
+    const skill = await context.client().skills.archive(id);
+    context.out.emit(skill, (styles) => `Archived ${styles.bold(skill.name)} ${styles.dim(`(${id})`)}`);
+};
+// --------------------------------------------------------------- context
+const collectionRow = (c) => [
+    c.id,
+    c.name,
+    c.tags.join(",") || "-",
+    c.visibility,
+    cell(c.archivedAt),
+];
+const COLLECTION_HEAD = ["ID", "NAME", "TAGS", "VISIBILITY", "ARCHIVED"];
+const contextList = async (context) => {
+    noExtraArguments(context, 0);
+    const rows = await context.client().context.list({
+        ...includeArchived(context),
+        limit: count(context, "limit"),
+    });
+    context.out.emit(rows, (styles) => rows.length === 0
+        ? styles.dim("No context collections.")
+        : table(COLLECTION_HEAD, rows.map(collectionRow), styles));
+};
+const contextCreate = async (context) => {
+    const name = argument(context, 0, "a collection name");
+    noExtraArguments(context, 1);
+    const created = await context.client().context.create({
+        name,
+        description: textFlag(context, "description"),
+        tags: tags(context),
+        visibility: visibility(context),
+    });
+    context.out.emit(created, (styles) => `Created ${styles.bold(created.name)} ${styles.dim(`(${created.id})`)}`);
+};
+const contextGet = async (context) => {
+    const id = argument(context, 0, "a collection id (see: `w6w context list`)");
+    noExtraArguments(context, 1);
+    const found = await context.client().context.get(id);
+    context.out.emit(found, (styles) => table(COLLECTION_HEAD, [collectionRow(found)], styles));
+};
+/** A patch: only the typed flags are sent (collection edits are last-write-wins). */
+const contextUpdate = async (context) => {
+    const id = argument(context, 0, "a collection id (see: `w6w context list`)");
+    noExtraArguments(context, 1);
+    const patch = {};
+    const name = textFlag(context, "name");
+    if (name !== undefined)
+        patch.name = name;
+    const description = textFlag(context, "description");
+    if (description !== undefined)
+        patch.description = description;
+    const tagList = tags(context);
+    if (tagList !== undefined)
+        patch.tags = tagList;
+    const updated = await context.client().context.update(id, patch);
+    context.out.emit(updated, (styles) => `Updated ${styles.bold(updated.name)} ${styles.dim(`(${id})`)}`);
+};
+const contextArchive = async (context) => {
+    const id = argument(context, 0, "a collection id (see: `w6w context list`)");
+    noExtraArguments(context, 1);
+    const archived = await context.client().context.archive(id);
+    context.out.emit(archived, (styles) => `Archived ${styles.bold(archived.name)} ${styles.dim(`(${id})`)}`);
+};
+const entryRow = (e) => [
+    e.id,
+    e.name,
+    e.mediaType,
+    cell(e.revision),
+    cell(e.archivedAt),
+];
+const ENTRY_HEAD = ["ID", "NAME", "TYPE", "REVISION", "ARCHIVED"];
+const entriesList = async (context) => {
+    const id = argument(context, 0, "a collection id (see: `w6w context list`)");
+    noExtraArguments(context, 1);
+    const rows = await context.client().context.entries.list(id, includeArchived(context));
+    context.out.emit(rows, (styles) => rows.length === 0 ? styles.dim("No entries.") : table(ENTRY_HEAD, rows.map(entryRow), styles));
+};
+const entriesCreate = async (context) => {
+    const id = argument(context, 0, "a collection id (see: `w6w context list`)");
+    const name = argument(context, 1, "an entry name");
+    noExtraArguments(context, 2);
+    const entry = await context.client().context.entries.create(id, {
+        name,
+        text: requiredFlag(context, "text", "--text <text>"),
+    });
+    context.out.emit(entry, (styles) => `Created ${styles.bold(entry.name)} ${styles.dim(`(${entry.id}, revision ${entry.revision})`)}`);
+};
+const entriesUpdate = async (context) => {
+    const id = argument(context, 0, "a collection id (see: `w6w context list`)");
+    const entryId = argument(context, 1, "an entry id (see: `w6w context entries-list`)");
+    noExtraArguments(context, 2);
+    const text = requiredFlag(context, "text", "--text <text>");
+    const rev = revision(context);
+    const entry = await guarded("the entry", `w6w context entries-list ${id}`, () => context.client().context.entries.update(id, entryId, { text, revision: rev }, precondition(context)));
+    context.out.emit(entry, (styles) => `Updated ${styles.bold(entry.name)} ${styles.dim(`(${entry.id}, revision ${entry.revision})`)}`);
+};
+// ------------------------------------------------------- context-entries
+const topEntryRow = (e) => [
+    e.id,
+    e.name,
+    cell(e.mediaType),
+    cell(e.revision),
+];
+const TOP_ENTRY_HEAD = ["ID", "NAME", "TYPE", "REVISION"];
+const ceList = async (context) => {
+    noExtraArguments(context, 0);
+    const rows = await context.client().contextEntries.list({
+        ...includeArchived(context),
+        collectionId: textFlag(context, "collectionId"),
+        project: textFlag(context, "project"),
+    });
+    context.out.emit(rows, (styles) => rows.length === 0
+        ? styles.dim("No context entries.")
+        : table(TOP_ENTRY_HEAD, rows.map(topEntryRow), styles));
+};
+const ceCreate = async (context) => {
+    const name = argument(context, 0, "an entry name");
+    noExtraArguments(context, 1);
+    const ids = textFlag(context, "collectionId");
+    const collectionIds = ids === undefined
+        ? undefined
+        : ids.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+    const entry = await context.client().contextEntries.create({
+        name,
+        text: requiredFlag(context, "text", "--text <text>"),
+        visibility: visibility(context),
+        ...(collectionIds ? { collectionIds } : {}),
+    });
+    context.out.emit(entry, (styles) => `Created ${styles.bold(entry.name)} ${styles.dim(`(${entry.id}, revision ${entry.revision})`)}`);
+};
+const ceGet = async (context) => {
+    const id = argument(context, 0, "an entry id (see: `w6w context-entries list`)");
+    noExtraArguments(context, 1);
+    const entry = await context.client().contextEntries.get(id);
+    context.out.emit(entry, (styles) => table(TOP_ENTRY_HEAD, [topEntryRow(entry)], styles));
+};
+const ceUpdate = async (context) => {
+    const id = argument(context, 0, "an entry id (see: `w6w context-entries list`)");
+    noExtraArguments(context, 1);
+    const text = requiredFlag(context, "text", "--text <text>");
+    const rev = revision(context);
+    const entry = await guarded("the entry", `w6w context-entries get ${id}`, () => context.client().contextEntries.update(id, { text, revision: rev }, precondition(context)));
+    context.out.emit(entry, (styles) => `Updated ${styles.bold(entry.name)} ${styles.dim(`(${entry.id}, revision ${entry.revision})`)}`);
+};
+const ceArchive = async (context) => {
+    const id = argument(context, 0, "an entry id (see: `w6w context-entries list`)");
+    noExtraArguments(context, 1);
+    const entry = await context.client().contextEntries.archive(id);
+    context.out.emit(entry, (styles) => `Archived ${styles.bold(entry.name)} ${styles.dim(`(${id})`)}`);
+};
+const ceAdd = async (context) => {
+    const id = argument(context, 0, "an entry id (see: `w6w context-entries list`)");
+    const collection = argument(context, 1, "a collection id (see: `w6w context list`)");
+    noExtraArguments(context, 2);
+    const entry = await context.client().contextEntries.addToCollection(id, collection);
+    context.out.emit(entry, (styles) => `Added ${styles.bold(entry.name)} to ${styles.dim(collection)}`);
+};
+const ceRemove = async (context) => {
+    const id = argument(context, 0, "an entry id (see: `w6w context-entries list`)");
+    const collection = argument(context, 1, "a collection id (see: `w6w context list`)");
+    noExtraArguments(context, 2);
+    const entry = await context.client().contextEntries.removeFromCollection(id, collection);
+    context.out.emit(entry, (styles) => `Removed ${styles.bold(entry.name)} from ${styles.dim(collection)}`);
+};
+// ---------------------------------------------------------------- agents
+const agentRow = (a) => [
+    a.id,
+    cell(a.name),
+    cell(a.modelRouteId),
+    String(a.revision),
+    a.archived ? "yes" : "no",
+    "no",
+];
+const AGENT_HEAD = ["ID", "NAME", "MODEL ROUTE", "REVISION", "ARCHIVED", "RUNNABLE"];
+const agentsList = async (context) => {
+    noExtraArguments(context, 0);
+    const rows = await context.client().agents.list(includeArchived(context));
+    context.out.emit(rows, (styles) => rows.length === 0 ? styles.dim("No agents.") : table(AGENT_HEAD, rows.map(agentRow), styles));
+};
+/** The fields `agents create|update` share, only those typed. */
+function agentFields(context) {
+    const fields = {};
+    const name = textFlag(context, "name");
+    if (name !== undefined)
+        fields.name = name;
+    const instructions = textFlag(context, "instructions");
+    if (instructions !== undefined)
+        fields.instructions = instructions;
+    const route = textFlag(context, "modelRouteId");
+    if (route !== undefined)
+        fields.modelRouteId = route;
+    const skills = jsonList(context, "skills");
+    if (skills !== undefined)
+        fields.skills = skills;
+    const pins = jsonList(context, "context");
+    if (pins !== undefined)
+        fields.context = pins;
+    const vis = visibility(context);
+    if (vis !== undefined)
+        fields.visibility = vis;
+    const project = textFlag(context, "project");
+    if (project !== undefined)
+        fields.project = project;
+    const modelOptions = modelOptionFlags(context);
+    if (modelOptions !== undefined)
+        fields.modelOptions = modelOptions;
+    return fields;
+}
+/** `--temperature`, `--top-p`, `--max-output-tokens` and the repeatable `--stop`. */
+function modelOptionFlags(context) {
+    const options = {};
+    const number = (name, min, max, integer) => {
+        const raw = textFlag(context, name);
+        if (raw === undefined)
+            return undefined;
+        const value = Number(raw);
+        if (raw.trim() === "" || !Number.isFinite(value) || value < min || value > max ||
+            (integer && !Number.isInteger(value))) {
+            throw usageError(context, `\`--${name}\` must be ${integer ? "an integer" : "a number"} from ${min} to ${max}.`);
+        }
+        return value;
+    };
+    const temperature = number("temperature", 0, 2, false);
+    if (temperature !== undefined)
+        options.temperature = temperature;
+    const topP = number("topP", 0, 1, false);
+    if (topP !== undefined)
+        options.topP = topP;
+    const max = number("maxOutputTokens", 1, 1_000_000, true);
+    if (max !== undefined)
+        options.maxOutputTokens = max;
+    const stop = context.invocation.lists?.stop;
+    if (stop !== undefined)
+        options.stop = stop;
+    return Object.keys(options).length > 0 ? options : undefined;
+}
+const agentsCreate = async (context) => {
+    noExtraArguments(context, 0);
+    const agent = await context.client().agents.create(agentFields(context));
+    context.out.emit(agent, (styles) => `Created ${styles.bold(cell(agent.name))} ${styles.dim(`(${agent.id}, revision ${agent.revision})`)}`);
+};
+const agentsGet = async (context) => {
+    const id = argument(context, 0, "an agent id (see: `w6w agents list`)");
+    noExtraArguments(context, 1);
+    const agent = await context.client().agents.get(id);
+    context.out.emit(agent, (styles) => {
+        const issues = agent.validation.map((v) => `  ! ${JSON.stringify(v)}`);
+        return [
+            table(AGENT_HEAD, [agentRow(agent)], styles),
+            ...(agent.instructions.length > 0 ? ["", agent.instructions] : []),
+            ...(issues.length > 0 ? ["", "Validation:", ...issues] : []),
+        ].join("\n");
+    });
+};
+const agentsUpdate = async (context) => {
+    const id = argument(context, 0, "an agent id (see: `w6w agents list`)");
+    noExtraArguments(context, 1);
+    const patch = { ...agentFields(context), revision: revision(context) };
+    const agent = await guarded("the agent", `w6w agents get ${id}`, () => context.client().agents.update(id, patch, precondition(context)));
+    context.out.emit(agent, (styles) => `Updated ${styles.bold(cell(agent.name))} ${styles.dim(`(${id}, revision ${agent.revision})`)}`);
+};
+const agentsArchive = async (context) => {
+    const id = argument(context, 0, "an agent id (see: `w6w agents list`)");
+    noExtraArguments(context, 1);
+    const agent = await context.client().agents.archive(id);
+    context.out.emit(agent, (styles) => `Archived ${styles.bold(cell(agent.name))} ${styles.dim(`(${id})`)}`);
+};
+/** Keys are the help tree's command paths (`naming.cli`). */
+export const AGENT_STUDIO_COMMANDS = {
+    "skills list": skillsList,
+    "skills get": skillsGet,
+    "skills versions": skillsVersions,
+    "skills archive": skillsArchive,
+    "context list": contextList,
+    "context create": contextCreate,
+    "context get": contextGet,
+    "context update": contextUpdate,
+    "context archive": contextArchive,
+    "context entries-list": entriesList,
+    "context entries-create": entriesCreate,
+    "context entries-update": entriesUpdate,
+    "context-entries list": ceList,
+    "context-entries create": ceCreate,
+    "context-entries get": ceGet,
+    "context-entries update": ceUpdate,
+    "context-entries archive": ceArchive,
+    "context-entries add-to-collection": ceAdd,
+    "context-entries remove-from-collection": ceRemove,
+    "agents list": agentsList,
+    "agents create": agentsCreate,
+    "agents get": agentsGet,
+    "agents update": agentsUpdate,
+    "agents archive": agentsArchive,
+};
+//# sourceMappingURL=agents-studio.js.map