@modelprofile.com/authswitch 3.2.0 → 4.0.0

package/dist_ts/classes.cli.d.ts

@@ -19,14 +19,21 @@ export declare class AuthSwitchCli {
      * Decide what happens to the harness's own running instances before its credential file changes.
      *
      * The switch itself no longer depends on this: it writes atomically and re-saves the outgoing
-     * login either way. What a running instance still costs is durability -- it holds the previous
-     * login in memory and can write it back at its next refresh -- so the instances are named and
-     * stopping them is offered, never assumed. Without a terminal and without a flag nothing is
-     * signalled, and only pids enumerated here for this user are ever signalled at all.
+     * login either way. A harness that picks up swaps live needs nothing here, so its instances are
+     * only stopped on an explicit --stop or --force-stop. Any other running instance still costs
+     * durability -- it holds the previous login in memory and can write it back at its next refresh --
+     * so the instances are named and stopping them is offered, never assumed. Without a terminal and
+     * without a flag nothing is signalled, and only pids enumerated here for this user are ever
+     * signalled at all.
      */
     private settleRunningInstances;
     private commandLogin;
     private commandPreuse;
+    /**
+     * Watch usage and switch automatically; see `AuthSwitchWatch`. SIGINT and SIGTERM end it cleanly with status 0.
+     * `--once` runs one check and exits 1 when a switch it attempted did not complete.
+     */
+    private commandWatch;
     private selectHarness;
     private runInteractive;
     /** Offer a verified save before presenting the switch picker; declining never switches. */
@@ -36,13 +43,28 @@ export declare class AuthSwitchCli {
     private selectActive;
     private reportOutcome;
     /**
-     * The condensed views are projections of the same read-only account list, so a provider is queried
-     * once, per account, with the same bounded timeouts and per-account failure isolation as `list`.
+     * The condensed views are projections of the same account list, which never changes which account is in
+     * use, so a provider is queried once, per account, with the same bounded timeouts and per-account failure
+     * isolation as `list`.
      */
     private commandCondensed;
     private commandList;
-    private printAccount;
     private resolveAccount;
+    /**
+     * Activate a saved account and report what is now active with its badge.
+     *
+     * The badge is read once per command through the bounded status read: the chooser reads it before it
+     * offers the accounts and the report repeats it, while a target named on the command line is read only
+     * after its switch, so nothing waits on it. A read that fails or does not answer in time leaves the name
+     * alone and never decides the outcome.
+     */
     private commandUse;
+    /**
+     * A switch target named on the command line; its badge is not read here, so the switch never waits on it.
+     *
+     * The reference already resolved to this id, so the name is presentation only: a state read that fails
+     * names the account by its id and leaves the switch, which reports any real credential problem, to run.
+     */
+    private namedAccount;
     private promptForAccount;
 }