@leemour/cli-messaging 0.119.0 → 0.121.0

package/dist/parity/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/parity/pages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,YAAY,EAAY,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAIpF;;;;GAIG;AACH,eAAO,MAAM,YAAY,SAAU,MAAM,OAAO,GAAG,YAAY,QAAQ,WAAW,YAAY,KAAG,MAAM,EA2BtG,CAAA"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/parity/pages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,YAAY,EAAY,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAIpF;;;;GAIG;AACH,eAAO,MAAM,YAAY,SAAU,MAAM,OAAO,GAAG,YAAY,QAAQ,WAAW,YAAY,KAAG,MAAM,EA6BtG,CAAA"}

package/dist/parity/pages.js

@@ -13,6 +13,8 @@ export const pageProblems = (page, cli, manifest, program) => {
     };
     program.commands.forEach(walk);
     const globals = new Set(program.globalOptions.flatMap((option) => optionsOf(option.flags)));
+    // Commander adds this automatically; command introspection lists only explicit options.
+    globals.add("--help");
     const problems = [];
     const line = new RegExp(`\\b${cli} ((?:[a-z][a-z-]* ?)+)([^\\n\`#|]*)`, "g");
     for (const [, words, rest] of page.matchAll(line)) {

package/dist/parity/pages.js.map

@@ -1 +1 @@
-{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/parity/pages.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,QAAQ,EAAiB,MAAM,eAAe,CAAA;AAEpF,MAAM,SAAS,GAAG,CAAC,KAAa,EAAY,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAA;AAEnF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,GAAQ,EAAE,QAAkB,EAAE,OAAqB,EAAY,EAAE;IAC1G,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC/C,MAAM,IAAI,GAAG,CAAC,OAAoB,EAAE,EAAE;QACpC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3G,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC,CAAA;IACD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAE3F,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,qCAAqC,EAAE,GAAG,CAAC,CAAA;IAC5E,KAAK,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC7C,mDAAmD;QACnD,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACpC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;aACvG,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;QACrC,IAAI,OAAO,KAAK,SAAS;YAAE,SAAQ;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,IAAI,EAAE,CAAA;QACzD,KAAK,MAAM,MAAM,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3E,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAQ;YACvE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;YAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK;gBAAE,SAAQ;YACnE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA"}
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/parity/pages.ts"],"names":[],"mappings":"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"}

package/dist/terminal/prompt.d.ts

@@ -5,6 +5,8 @@ export interface SecretInput {
     output?: NodeJS.WritableStream;
     /** For a phone number or an SMS code, which a person needs to see while typing. */
     echo?: boolean;
+    /** Cancels pending input without closing the caller's stream. */
+    signal?: AbortSignal;
 }
 /**
  * One line of secret, taken without a file and without argv.
@@ -16,5 +18,5 @@ export interface SecretInput {
  * The prompt goes to **stderr**, not stdout, so that `session start --json` still writes one JSON
  * value and nothing else.
  */
-export declare const readSecret: (prompt: string, { input, output, echo }?: SecretInput) => Promise<string>;
+export declare const readSecret: (prompt: string, { input, output, echo, signal }?: SecretInput) => Promise<string>;
 //# sourceMappingURL=prompt.d.ts.map

package/dist/terminal/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/terminal/prompt.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC9B,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,WACb,MAAM,4BACoD,WAAW,KAC5E,OAAO,CAAC,MAAM,CA+BhB,CAAA"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/terminal/prompt.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC9B,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,WACb,MAAM,oCAC4D,WAAW,KACpF,OAAO,CAAC,MAAM,CA6DhB,CAAA"}

package/dist/terminal/prompt.js

@@ -11,8 +11,36 @@ import { CliError } from "@leemour/cli-core";
  * The prompt goes to **stderr**, not stdout, so that `session start --json` still writes one JSON
  * value and nothing else.
  */
-export const readSecret = async (prompt, { input = process.stdin, output = process.stderr, echo = false } = {}) => {
+export const readSecret = async (prompt, { input = process.stdin, output = process.stderr, echo = false, signal } = {}) => {
+    const cancelled = () => new CliError("cancelled", "cancelled — nothing was stored");
+    if (signal?.aborted)
+        throw cancelled();
     if (!input.isTTY) {
+        if (signal) {
+            return new Promise((resolve, reject) => {
+                const chunks = [];
+                const cleanup = () => {
+                    input.off("data", data).off("end", end).off("error", error).off("close", abort);
+                    signal.removeEventListener("abort", abort);
+                };
+                const data = (chunk) => chunks.push(Buffer.from(chunk));
+                const end = () => {
+                    cleanup();
+                    resolve(Buffer.concat(chunks).toString("utf8").trim());
+                };
+                const error = (cause) => {
+                    cleanup();
+                    reject(cause);
+                };
+                const abort = () => {
+                    cleanup();
+                    input.pause();
+                    reject(cancelled());
+                };
+                input.on("data", data).once("end", end).once("error", error).once("close", abort);
+                signal.addEventListener("abort", abort, { once: true });
+            });
+        }
         const chunks = [];
         for await (const chunk of input)
             chunks.push(Buffer.from(chunk));
@@ -27,19 +55,22 @@ export const readSecret = async (prompt, { input = process.stdin, output = proce
         },
     });
     const reader = createInterface({ input, output: shim, terminal: true });
+    const abort = () => reader.close();
     try {
         // Ctrl-C and a closed terminal would otherwise leave this waiting for ever, and Node exits
         // on the unsettled promise with a warning and a code nobody documents.
         const answer = await new Promise((resolve, reject) => {
-            const cancel = () => reject(new CliError("cancelled", "cancelled — nothing was stored"));
+            const cancel = () => reject(cancelled());
             reader.once("SIGINT", cancel);
             reader.once("close", cancel);
+            signal?.addEventListener("abort", abort, { once: true });
             reader.question(prompt, resolve);
             muted = !echo;
         });
         return answer.trim();
     }
     finally {
+        signal?.removeEventListener("abort", abort);
         reader.close();
         output.write("\n");
     }

package/dist/terminal/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/terminal/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAS5C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,MAAc,EACd,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,GAAgB,EAAE,EACjE,EAAE;IACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAChE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IACtD,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,CAAA;IACjB,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC;QACxB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI;YAC1B,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC/B,IAAI,EAAE,CAAA;QACR,CAAC;KACF,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IACvE,IAAI,CAAC;QACH,2FAA2F;QAC3F,uEAAuE;QACvE,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3D,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,gCAAgC,CAAC,CAAC,CAAA;YACxF,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAC5B,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YAChC,KAAK,GAAG,CAAC,IAAI,CAAA;QACf,CAAC,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAA;QACd,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/terminal/prompt.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leemour/cli-messaging",
-  "version": "0.119.0",
+  "version": "0.121.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "MIT",
   "author": "Viacheslav Ptsarev",

package/parity.json

@@ -20,6 +20,10 @@
       "value": "<time>",
       "meaning": "read what came after this ISO 8601 time, or 2h / 1d ago; not with --after-id or the --before pair"
     },
+    "--agent": {
+      "value": "<agent>",
+      "meaning": "install the skill for this agent; asks at a terminal, otherwise none"
+    },
     "--all": {
       "meaning": "every row, no paging"
     },
@@ -257,6 +261,10 @@
       "value": "<on|off>",
       "meaning": "members may see the invite link"
     },
+    "--method": {
+      "value": "<method>",
+      "meaning": "how to log in when there is no session"
+    },
     "--model": {
       "value": "<id>",
       "meaning": "which downloaded speech model hears them; `models audio list` shows them",
@@ -875,14 +883,6 @@
         "--types": "all"
       }
     },
-    "cache": {
-      "in": [],
-      "planned": {
-        "max": "T6"
-      },
-      "reason": "max drops its per-profile cache in favor of the shared store",
-      "subtree": true
-    },
     "chats": {
       "in": "all"
     },
@@ -1699,13 +1699,7 @@
         "--reply-to": "all",
         "--send-id": "all",
         "--silent": "all",
-        "--topic": {
-          "in": [],
-          "planned": {
-            "max": "adopt the shared topic option; the MAX adapter explicitly refuses forum addressing",
-            "tg": "adopt the shared topic option with Telegram adapter validation and mapping"
-          }
-        },
+        "--topic": "all",
         "--voice": "all"
       }
     },
@@ -1772,13 +1766,7 @@
         "--revote": "all",
         "--send-id": "all",
         "--silent": "all",
-        "--topic": {
-          "in": [],
-          "planned": {
-            "max": "adopt the shared topic option; the MAX adapter explicitly refuses forum addressing",
-            "tg": "adopt the shared topic option with Telegram adapter validation and mapping"
-          }
-        }
+        "--topic": "all"
       }
     },
     "polls show": {
@@ -1941,6 +1929,43 @@
         }
       }
     },
+    "setup": {
+      "in": [],
+      "planned": {
+        "tg": "guided first-run onboarding",
+        "max": "guided first-run onboarding"
+      },
+      "options": {
+        "--agent": {
+          "in": [],
+          "planned": {
+            "tg": "guided first-run onboarding",
+            "max": "guided first-run onboarding"
+          }
+        },
+        "--app": {
+          "in": [],
+          "planned": {
+            "tg": "guided first-run onboarding"
+          },
+          "reason": "Telegram requires an application from my.telegram.org; MAX has no application registration step"
+        },
+        "--method": {
+          "in": [],
+          "planned": {
+            "tg": "guided first-run onboarding",
+            "max": "guided first-run onboarding"
+          }
+        },
+        "--qr-file": {
+          "in": [],
+          "planned": {
+            "tg": "guided first-run onboarding"
+          },
+          "reason": "Telegram can expose its temporary QR login token as a PNG"
+        }
+      }
+    },
     "skill": {
       "in": "all"
     },