@wirecat/tg-cli 0.0.0 → 0.43.1

package/dist/program.js

@@ -0,0 +1,138 @@
+import { appendFileSync } from "node:fs";
+import { exitCodeFor, processStreams } from "@wirecat/cli-core";
+import { accountCommand, attachmentsCommand, botCommand, chatsCommand, commandsCommand, completeCommand, configCommand, contactsCommand, conversationsCommand, createProgram as create, doctorCommand, floodCommand, inboxCommand, mcpCommand, messagesCommand, metadataCommand, modelsCommand, pollsCommand, reactionsCommand, recipientsCommand, repliesCommand, reviewCommand, run as runCli, runsCommand, searchCommand, searchesCommand, sendsCommand, serveCommand, serverCommand, skillCommand, statsCommand, storeCommand, tagsCommand, tasksCommand, topicsCommand, watchCommand, } from "@wirecat/cli-messaging/cli";
+import { CONFIG, TG } from "./app.js";
+import { TELEGRAM_BOT } from "./commands/bot.js";
+import { telegramBotApiCommand } from "./commands/bot-api.js";
+import { SKILL, TELEGRAM } from "./commands/context.js";
+import { withProxySecrets } from "./commands/proxy-config.js";
+import { sessionCommand } from "./commands/session.js";
+import { setupCommand } from "./commands/setup.js";
+import { upgradeCommand } from "./commands/update.js";
+import { updateNotice } from "./update.js";
+/** A revoked or missing login fails the same on every retry; serve reports a locked keyring with another code. */
+export const NO_RESTART_ON = [exitCodeFor("authentication_error")];
+const definition = {
+    app: TG,
+    configuration: CONFIG,
+    configure: (program) => {
+        program.addHelpText("after", "\nGetting started after installation:\n" +
+            "  tg setup                    Guided first run; allow about 5 minutes\n" +
+            "  tg setup --agent codex      Log in and install your agent's skill\n" +
+            "  tg setup --help             Login choices, examples and Windows instructions\n" +
+            "\nFor agents:\n" +
+            "  tg skill show               Read the bundled instructions before using Telegram\n" +
+            "  tg commands --json          Discover commands, arguments and flags\n" +
+            "\nSetup checks five chats. Choose a chat before downloading its history.\n");
+        program.commands
+            .find((command) => command.name() === "skill")
+            ?.addHelpText("after", "\nBefore the first login, an agent can read `tg skill show`; no session is needed.\n" +
+            "Run `tg setup --agent codex` for guided login and skill installation.\n" +
+            "To install instructions separately: `tg skill install --for all`.\n");
+        const contacts = program.commands.find((command) => command.name() === "contacts");
+        const check = contacts?.commands.find((command) => command.name() === "check");
+        const registries = check?.options.find((option) => option.long === "--no-registries");
+        if (registries)
+            registries.description = "skip public ban lists; still ask Telegram for the profile and photos unless --offline";
+        contacts?.commands
+            .find((command) => command.name() === "context")
+            ?.description("what the local store holds about a person; --chat --refresh explicitly asks Telegram first");
+        const audit = program.commands
+            .find((command) => command.name() === "chats")
+            ?.commands.find((command) => command.name() === "members")
+            ?.commands.find((command) => command.name() === "audit");
+        audit?.description("members that look like bots, each with its reasons, from the member list and local store; " +
+            "--deep checks selected people individually; removes nobody");
+        const deep = audit?.options.find((option) => option.long === "--deep");
+        if (deep)
+            deep.description =
+                "also check the top n profiles, oldest photos, up to 1,000 stored messages each and public ban lists, " +
+                    "which are sent their ids — one person a second";
+    },
+    commands: () => loggingArgv([
+        sessionCommand(),
+        setupCommand(),
+        accountCommand(TELEGRAM),
+        chatsCommand(TELEGRAM),
+        contactsCommand(TELEGRAM),
+        messagesCommand(TELEGRAM),
+        reactionsCommand(TELEGRAM),
+        pollsCommand(TELEGRAM),
+        modelsCommand(TELEGRAM),
+        inboxCommand(TELEGRAM),
+        reviewCommand(TELEGRAM),
+        topicsCommand(TELEGRAM),
+        watchCommand(TELEGRAM),
+        serveCommand(TELEGRAM),
+        serverCommand(TELEGRAM, { unit: { noRestartOn: NO_RESTART_ON } }),
+        storeCommand(TELEGRAM),
+        conversationsCommand(TELEGRAM),
+        attachmentsCommand(TELEGRAM),
+        tagsCommand(TELEGRAM),
+        metadataCommand(TELEGRAM),
+        statsCommand(TELEGRAM),
+        tasksCommand(TELEGRAM),
+        searchCommand(TELEGRAM, { topics: true }),
+        searchesCommand(TELEGRAM),
+        floodCommand(TELEGRAM),
+        repliesCommand(TELEGRAM),
+        recipientsCommand(TELEGRAM),
+        sendsCommand(TELEGRAM),
+        runsCommand(TG),
+        withProxySecrets(configCommand(TG, CONFIG)),
+        doctorCommand(TELEGRAM),
+        commandsCommand(TG),
+        completeCommand(TELEGRAM, CONFIG),
+        upgradeCommand(),
+        mcpCommand(TELEGRAM),
+        botCommand(TELEGRAM_BOT).addCommand(telegramBotApiCommand()),
+        skillCommand(TG, SKILL),
+    ]),
+};
+export const createProgram = () => create(definition);
+/** Never throws: every outcome is an exit code, and a failure is said once, on stderr. */
+export const run = async (argv, environment = {}) => {
+    const notice = updateNotice(argv, {
+        ...(environment.tty === undefined ? {} : { tty: environment.tty }),
+        ...(environment.update ? { environment: environment.update } : {}),
+        ...(environment.env ? { env: environment.env } : {}),
+    });
+    const code = await runCli(argv, definition, environment);
+    const line = await notice;
+    const argvLog = process.env.TG_TEST_ARGV_LOG;
+    // --version ends before any action, so the preAction hook never sees it.
+    if (argvLog && code === 0 && argv.some((word) => word === "--version" || word === "-V"))
+        appendFileSync(argvLog, `${JSON.stringify({ command: "", options: ["--version"] })}\n`);
+    if (line && code === 0)
+        (environment.streams ?? processStreams).diagnostic(line);
+    return code;
+};
+/**
+ * Under vitest only: which command a test drove and the option names it gave, never a value
+ * (`pnpm test:matrix`). The hook sits on each top-level command because the root program is built
+ * inside cli-messaging; commander runs an ancestor's preAction hook for every subcommand.
+ */
+function loggingArgv(commands) {
+    const file = process.env.TG_TEST_ARGV_LOG;
+    if (file)
+        for (const command of commands)
+            command.hook("preAction", (_self, action) => logParsed(file, action));
+    return commands;
+}
+const logParsed = (file, action) => {
+    const words = [];
+    const options = [];
+    for (let at = action; at; at = at.parent) {
+        if (at.parent)
+            words.unshift(at.name());
+        for (const option of at.options) {
+            const key = option.attributeName();
+            if (at.getOptionValueSource(key) !== "cli" || !option.long)
+                continue;
+            if (option.negate === (at.getOptionValue(key) === false))
+                options.push(option.long);
+        }
+    }
+    appendFileSync(file, `${JSON.stringify({ command: words.join(" "), options })}\n`);
+};
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/dist/proxy.d.ts

@@ -0,0 +1,31 @@
+import { CliError } from "@wirecat/cli-core";
+import * as v from "valibot";
+export type ProxyKind = "socks5" | "http" | "mtproxy";
+export interface ProxyServer {
+    kind: ProxyKind;
+    host: string;
+    port: number;
+    /** `https://`: the connection to the proxy itself is TLS. */
+    tls: boolean;
+    user?: string;
+    /** The proxy password, or the MTProxy secret. Never printed, never in the configuration file. */
+    secret?: string;
+}
+/**
+ * A proxy URL as tg reads it. ⚠ Every error names only where the value came from: the value can
+ * hold a password, and an error is printed, kept in a run record and pasted into issues.
+ */
+export declare const parseProxy: (text: string, from: string) => ProxyServer;
+/** The proxy with its password or secret left out: what the configuration file keeps and what tg prints. */
+export declare const proxyLabel: (proxy: ProxyServer) => string;
+/** Scheme, host and port only — for an HTTP agent, which takes the credentials apart from the address. */
+export declare const proxyAddress: (proxy: ProxyServer) => string;
+/** A proxy that refused or could not be reached — `configuration_error`, so it never reads as Telegram being down. */
+export declare const proxyError: (proxy: ProxyServer, reason: string) => CliError;
+/**
+ * The `proxy` setting. It holds no secret, as no setting does: `tg config set proxy` moves the
+ * password or the MTProxy secret to the OS keyring before the file is written, so this refuses only
+ * a file edited by hand.
+ */
+export declare const proxySetting: v.SchemaWithPipe<readonly [v.StringSchema<"has to be a proxy URL, in quotes">, v.CheckAction<string, "has to be socks5://host:port, http://host:port, https://host:port or an MTProxy link (tg://proxy?server=…), without its password or secret — `tg config set proxy -` keeps those in the OS keyring">]>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;AAErD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAKD;;;GAGG;AACH,eAAO,MAAM,UAAU,SAAU,MAAM,QAAQ,MAAM,KAAG,WAiCvD,CAAA;AA6BD,4GAA4G;AAC5G,eAAO,MAAM,UAAU,UAAW,WAAW,KAAG,MAI/C,CAAA;AAED,0GAA0G;AAC1G,eAAO,MAAM,YAAY,UAAW,WAAW,KAAG,MAIjD,CAAA;AAED,sHAAsH;AACtH,eAAO,MAAM,UAAU,UAAW,WAAW,UAAU,MAAM,KAAG,QAK7D,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,8SASxB,CAAA"}

package/dist/proxy.js

@@ -0,0 +1,99 @@
+import { CliError } from "@wirecat/cli-core";
+import * as v from "valibot";
+const SHAPES = "socks5://host:port, http://host:port, https://host:port or an MTProxy link (tg://proxy?server=…)";
+const TELEGRAM_HOSTS = new Set(["t.me", "telegram.me", "telegram.dog"]);
+/**
+ * A proxy URL as tg reads it. ⚠ Every error names only where the value came from: the value can
+ * hold a password, and an error is printed, kept in a run record and pasted into issues.
+ */
+export const parseProxy = (text, from) => {
+    const fail = (why) => {
+        throw new CliError("configuration_error", `${from} ${why} — it takes ${SHAPES}`);
+    };
+    let url;
+    try {
+        url = new URL(text.trim());
+    }
+    catch {
+        return fail("is not a URL");
+    }
+    const link = telegramLink(url);
+    if (link)
+        return fromLink(link.kind, url.searchParams, fail);
+    const port = (fallback) => {
+        const number = url.port === "" ? fallback : Number(url.port);
+        return number >= 1 && number <= 65_535 ? number : fail("has no valid port");
+    };
+    if (url.hostname === "")
+        fail("names no host");
+    const credentials = {
+        ...(url.username ? { user: decodeURIComponent(url.username) } : {}),
+        ...(url.password ? { secret: decodeURIComponent(url.password) } : {}),
+    };
+    const host = url.hostname.replace(/^\[(.*)\]$/, "$1");
+    switch (url.protocol) {
+        case "socks5:":
+        case "socks5h:":
+            return { kind: "socks5", host, port: port(1080), tls: false, ...credentials };
+        case "http:":
+            return { kind: "http", host, port: port(80), tls: false, ...credentials };
+        case "https:":
+            return { kind: "http", host, port: port(443), tls: true, ...credentials };
+        default:
+            return fail(`uses ${url.protocol.replace(/:$/, "")}, which tg does not speak`);
+    }
+};
+/** Telegram's own share links: `tg://proxy?…`, `tg://socks?…` and their `https://t.me/…` forms. */
+const telegramLink = (url) => {
+    const path = url.protocol === "tg:"
+        ? (url.hostname || url.pathname.replace(/^\/+/, "")).toLowerCase()
+        : (url.protocol === "https:" || url.protocol === "http:") && TELEGRAM_HOSTS.has(url.hostname.toLowerCase())
+            ? url.pathname.replace(/^\/+|\/+$/g, "").toLowerCase()
+            : undefined;
+    return path === "proxy" || path === "socks" ? { kind: path } : undefined;
+};
+const fromLink = (kind, query, fail) => {
+    const host = query.get("server") ?? fail("has no server");
+    const port = Number(query.get("port"));
+    if (!Number.isInteger(port) || port < 1 || port > 65_535)
+        fail("has no valid port");
+    const secret = query.get(kind === "proxy" ? "secret" : "pass") ?? undefined;
+    const user = kind === "socks" ? (query.get("user") ?? undefined) : undefined;
+    return {
+        kind: kind === "proxy" ? "mtproxy" : "socks5",
+        host,
+        port,
+        tls: false,
+        ...(user ? { user } : {}),
+        ...(secret ? { secret } : {}),
+    };
+};
+/** The proxy with its password or secret left out: what the configuration file keeps and what tg prints. */
+export const proxyLabel = (proxy) => {
+    if (proxy.kind === "mtproxy")
+        return `tg://proxy?server=${encodeURIComponent(proxy.host)}&port=${proxy.port}`;
+    const user = proxy.user === undefined ? "" : `${encodeURIComponent(proxy.user)}@`;
+    return proxyAddress(proxy).replace("://", `://${user}`);
+};
+/** Scheme, host and port only — for an HTTP agent, which takes the credentials apart from the address. */
+export const proxyAddress = (proxy) => {
+    const host = proxy.host.includes(":") ? `[${proxy.host}]` : proxy.host;
+    const scheme = proxy.kind === "socks5" ? "socks5" : proxy.tls ? "https" : "http";
+    return `${scheme}://${host}:${proxy.port}`;
+};
+/** A proxy that refused or could not be reached — `configuration_error`, so it never reads as Telegram being down. */
+export const proxyError = (proxy, reason) => new CliError("configuration_error", `the proxy ${proxyLabel(proxy)} ${reason} — check it, or change it with \`tg config set proxy\` or TG_PROXY`, { proxy: proxyLabel(proxy), retryable: true });
+/**
+ * The `proxy` setting. It holds no secret, as no setting does: `tg config set proxy` moves the
+ * password or the MTProxy secret to the OS keyring before the file is written, so this refuses only
+ * a file edited by hand.
+ */
+export const proxySetting = v.pipe(v.string("has to be a proxy URL, in quotes"), v.check((text) => {
+    try {
+        return parseProxy(text, "proxy").secret === undefined;
+    }
+    catch {
+        return false;
+    }
+}, `has to be ${SHAPES}, without its password or secret — \`tg config set proxy -\` keeps those in the OS keyring`));
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

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