@wirecat/max-cli 0.0.0 → 0.43.0

package/dist/commands/messages.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const messagesCommand: () => Command;
+//# sourceMappingURL=messages.d.ts.map

package/dist/commands/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,eAAO,MAAM,eAAe,QAAO,OAgGlC,CAAA"}

package/dist/commands/messages.js

@@ -0,0 +1,105 @@
+import { CliError } from "@wirecat/cli-core";
+import { deleteCommand, editCommand, forwardCommand, pinCommand, sendCommand, messagesCommand as sharedMessagesCommand, unpinCommand, } from "@wirecat/cli-messaging/cli";
+import { Command } from "commander";
+import { maxMessenger, sharedSubcommand } from "../messenger.js";
+import { maxRecord } from "../record.js";
+import { notDownloaded, transcribe } from "../transcribe/index.js";
+import { isInstalled, modelsDirectory } from "../transcribe/install.js";
+import { speechModel } from "../transcribe/models.js";
+import { forCommand } from "./context.js";
+export const messagesCommand = () => {
+    const command = new Command("messages").description("read and send messages in a chat");
+    const shared = sharedMessagesCommand(maxMessenger);
+    for (const name of ["list", "show", "context", "links"])
+        command.addCommand(sharedSubcommand(shared, name));
+    const list = command.commands.find((one) => one.name() === "list");
+    // MAX has no forum topics.
+    if (list)
+        Object.assign(list, { options: list.options.filter((option) => option.attributeName() !== "topic") });
+    const localLinks = sharedMessagesCommand({ ...maxMessenger, history: "store" });
+    command.addCommand(sharedSubcommand(localLinks, "link"));
+    const download = sharedSubcommand(shared, "download")
+        .option("--output <dir>", "compatibility alias for --output-dir")
+        .hook("preAction", (action) => {
+        const { output, outputDir } = action.opts();
+        if (output === undefined)
+            return;
+        if (action.getOptionValueSource("outputDir") !== "default" && outputDir !== output) {
+            throw new CliError("validation_error", "--output and --output-dir must name the same directory");
+        }
+        action.setOptionValue("outputDir", output);
+    });
+    command.addCommand(download);
+    command.addCommand(sharedSubcommand(shared, "evidence"));
+    /**
+     * **On this machine, and only with a model the owner downloaded** (`NEED-231`). The recording is
+     * fetched, the connection closed, and then the model runs — up to a minute for five minutes of
+     * speech, which should not hold a socket open.
+     */
+    command
+        .command("transcribe")
+        .argument("<chat>", "chat id, or part of a chat name")
+        .argument("<message>", "id of a voice message")
+        .description("turn a voice message into text, on this machine — the recording goes nowhere")
+        .option("--model <id>", "which downloaded speech model to use; `max models audio list` shows them")
+        .action(async function (chat, messageId) {
+        const { model: wanted } = this.opts();
+        const context = forCommand(this);
+        const { renderer, format, streams, settings, createClient, run } = context;
+        const model = speechModel(wanted ?? settings.transcribeModel);
+        const directory = modelsDirectory();
+        await run("messages transcribe", async (events) => {
+            const client = createClient({ events });
+            const record = maxRecord({ account: () => context.store.readState().viewerId });
+            try {
+                const chatId = await client.chats.resolve(chat);
+                if (!isInstalled(model, directory)) {
+                    const kept = await record.transcript(chatId, messageId.trim());
+                    if (kept?.source !== model.id)
+                        throw notDownloaded(model);
+                }
+                const transcript = await transcribe(client, chatId, messageId.trim(), {
+                    ...context.hearing,
+                    model,
+                    directory,
+                    record,
+                    release: async () => {
+                        await client.close();
+                        renderer.note(`transcribing with ${model.id} on this machine`);
+                    },
+                });
+                if (format === "pretty")
+                    streams.data(`${transcript.text}\n`);
+                else
+                    renderer.result(transcript);
+            }
+            finally {
+                try {
+                    await client.close();
+                }
+                finally {
+                    await record.close();
+                }
+            }
+        });
+    });
+    const send = sendCommand(maxMessenger);
+    Object.assign(send, {
+        options: send.options.filter((option) => !["spoiler", "captionAbove", "commentTo"].includes(option.attributeName())),
+    });
+    command.addCommand(send);
+    command.addCommand(sharedSubcommand(shared, "scheduled"));
+    command.addCommand(editCommand(maxMessenger));
+    const remove = deleteCommand(maxMessenger);
+    remove.registeredArguments[1]?.argParser((value, previous = []) => [
+        ...previous,
+        ...value.split(",").map((id) => id.trim()),
+    ]);
+    command.addCommand(remove);
+    command.addCommand(forwardCommand(maxMessenger));
+    command.addCommand(pinCommand(maxMessenger));
+    command.addCommand(unpinCommand(maxMessenger));
+    command.addCommand(sharedSubcommand(shared, "press"));
+    return command;
+};
+//# sourceMappingURL=messages.js.map

package/dist/commands/messages.js.map

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

package/dist/commands/models.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare const modelsCommand: () => Command;
+//# sourceMappingURL=models.d.ts.map

package/dist/commands/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/commands/models.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,eAAO,MAAM,aAAa,QAAO,OAA4C,CAAA"}

package/dist/commands/models.js

@@ -0,0 +1,4 @@
+import { modelsCommand as sharedModelsCommand } from "@wirecat/cli-messaging/cli";
+import { maxMessenger } from "../messenger.js";
+export const modelsCommand = () => sharedModelsCommand(maxMessenger);
+//# sourceMappingURL=models.js.map

package/dist/commands/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/commands/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAA"}

package/dist/commands/paging.d.ts

@@ -0,0 +1,59 @@
+import { type Renderer, type RenderFormat, type Streams } from "@wirecat/cli-core";
+import type { Command } from "commander";
+import type { Settings } from "../config.js";
+import type { Page } from "../domain/models.js";
+/** Checked while parsing, so the error can quote what was typed rather than the `NaN` it became. */
+export declare const wholeNumber: (flag: string) => (value: string) => number;
+/**
+ * The three flags every listing shares, so no command invents its own spelling of them.
+ *
+ * ⚠ **None of them gets a `default`.** With one, commander reports the flag as always given and a
+ * configured `limit` could never win it; the number lives once, in `resolveSettings`.
+ */
+export declare const withPaging: (command: Command) => Command;
+/**
+ * Which rows to ask the store for. `--all` means no limit, which the store reads as "everything".
+ *
+ * ⚠ **A page number over a live list can repeat or skip a row.** The order is most-recent-first,
+ * so a message arriving between page one and page two pushes somebody across the boundary. Every
+ * CLI that pages this way has this; it is in `--help` rather than engineered away.
+ */
+export declare const window: ({ limit, page, all }: Settings) => {
+    limit?: number;
+    offset: number;
+};
+/**
+ * A list with no pages — folders, members, runs, everything a bot lists — in the envelope a paged
+ * one uses (`NEED-358`), so an agent reads one shape. `--jsonl` streams it and a person gets the table.
+ * `extra` goes beside it: a Bot API list paged by `marker` carries its marker and `hasMore`.
+ */
+export declare const renderList: (renderer: Renderer, format: RenderFormat, items: readonly unknown[], extra?: {
+    hasMore?: boolean;
+} & Record<string, unknown>) => void;
+export declare const listed: (items: readonly unknown[]) => {
+    items: readonly unknown[];
+    page: number;
+    limit: number;
+    hasMore: boolean;
+};
+/**
+ * **One shape for every listing**, and the caller never has to work out which one it got.
+ *
+ * In the machine modes stdout carries the envelope. For a person it carries the table it always
+ * did, and the line about there being another page goes to **stderr** as a note — stdout is data
+ * in every mode, and a pager's hint is not data.
+ *
+ * It is a helper each command calls rather than something inside `renderer.result`, because
+ * `account show` and `session start` are not lists and keep answering a bare object.
+ */
+export declare const renderPage: <T>({ renderer, format, settings, streams, }: {
+    renderer: Renderer;
+    format: RenderFormat;
+    settings: Settings;
+    streams: Streams;
+}, { items, hasMore }: Page<T>, view?: (items: T[]) => string, 
+/** What to type for the rest, when the listing is not paged by `--page`. */
+more?: (items: T[]) => string, 
+/** Fields beside the page in `--json`. */
+extra?: object) => void;
+//# sourceMappingURL=paging.d.ts.map

package/dist/commands/paging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paging.d.ts","sourceRoot":"","sources":["../../src/commands/paging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAE/C,oGAAoG;AACpG,eAAO,MAAM,WAAW,SACf,MAAM,aACL,MAAM,KAAG,MAKhB,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,UAAU,YAAa,OAAO,KAAG,OAIF,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,yBAA0B,QAAQ,KAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAC3B,CAAA;AAE7D;;;;GAIG;AACH,eAAO,MAAM,UAAU,aACX,QAAQ,UACV,YAAY,SACb,SAAS,OAAO,EAAE,UAClB;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACrD,IAGF,CAAA;AAED,eAAO,MAAM,MAAM,UAAW,SAAS,OAAO,EAAE;;;;;CAA8D,CAAA;AAE9G;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,4CAMvB;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,sBACjE,IAAI,CAAC,CAAC,CAAC,SACpB,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,MAAM;AAC7B,4EAA4E;OACrE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,MAAM;AAC7B,0CAA0C;QACnC,MAAM,KACZ,IAuBF,CAAA"}

package/dist/commands/paging.js

@@ -0,0 +1,77 @@
+import { CliError } from "@wirecat/cli-core";
+/** Checked while parsing, so the error can quote what was typed rather than the `NaN` it became. */
+export const wholeNumber = (flag) => (value) => {
+    if (!/^\d+$/.test(value.trim()) || Number(value) < 1) {
+        throw new CliError("validation_error", `${flag} takes a whole number from 1 upwards, not "${value}"`);
+    }
+    return Number(value);
+};
+/**
+ * The three flags every listing shares, so no command invents its own spelling of them.
+ *
+ * ⚠ **None of them gets a `default`.** With one, commander reports the flag as always given and a
+ * configured `limit` could never win it; the number lives once, in `resolveSettings`.
+ */
+export const withPaging = (command) => command
+    .option("--limit <n>", "how many to show", wholeNumber("--limit"))
+    .option("--page <n>", "which page, starting at 1", wholeNumber("--page"))
+    .option("--all", "every row, no paging");
+/**
+ * Which rows to ask the store for. `--all` means no limit, which the store reads as "everything".
+ *
+ * ⚠ **A page number over a live list can repeat or skip a row.** The order is most-recent-first,
+ * so a message arriving between page one and page two pushes somebody across the boundary. Every
+ * CLI that pages this way has this; it is in `--help` rather than engineered away.
+ */
+export const window = ({ limit, page, all }) => all ? { offset: 0 } : { limit, offset: (page - 1) * limit };
+/**
+ * A list with no pages — folders, members, runs, everything a bot lists — in the envelope a paged
+ * one uses (`NEED-358`), so an agent reads one shape. `--jsonl` streams it and a person gets the table.
+ * `extra` goes beside it: a Bot API list paged by `marker` carries its marker and `hasMore`.
+ */
+export const renderList = (renderer, format, items, extra = {}) => {
+    if (format === "json")
+        renderer.result({ ...listed(items), ...extra });
+    else
+        renderer.stream(items);
+};
+export const listed = (items) => ({ items, page: 1, limit: items.length, hasMore: false });
+/**
+ * **One shape for every listing**, and the caller never has to work out which one it got.
+ *
+ * In the machine modes stdout carries the envelope. For a person it carries the table it always
+ * did, and the line about there being another page goes to **stderr** as a note — stdout is data
+ * in every mode, and a pager's hint is not data.
+ *
+ * It is a helper each command calls rather than something inside `renderer.result`, because
+ * `account show` and `session start` are not lists and keep answering a bare object.
+ */
+export const renderPage = ({ renderer, format, settings, streams, }, { items, hasMore }, view, 
+/** What to type for the rest, when the listing is not paged by `--page`. */
+more, 
+/** Fields beside the page in `--json`. */
+extra = {}) => {
+    if (format === "jsonl") {
+        renderer.stream(items);
+        if (!settings.all && hasMore)
+            renderer.note(more ? more(items) : `more — \`--page ${settings.page + 1}\` for the next`);
+        return;
+    }
+    if (format !== "pretty") {
+        renderer.result({
+            items,
+            page: settings.all ? 1 : settings.page,
+            limit: settings.all ? items.length : settings.limit,
+            hasMore: settings.all ? false : hasMore,
+            ...extra,
+        });
+        return;
+    }
+    if (view)
+        streams.data(view(items));
+    else
+        renderer.result(items);
+    if (!settings.all && hasMore)
+        renderer.note(more ? more(items) : `page ${settings.page} of more — \`--page ${settings.page + 1}\` for the next`);
+};
+//# sourceMappingURL=paging.js.map

package/dist/commands/paging.js.map

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

package/dist/commands/recipients.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+/**
+ * The chats this profile may send to. Off until the first `add`; `off` turns it off again.
+ *
+ * Scripts may change it too (`NEED-159` answers): the list stops a model that a message talked
+ * into writing somewhere, not an agent set on getting around it.
+ */
+export declare const recipientsCommand: () => Command;
+//# sourceMappingURL=recipients.d.ts.map

package/dist/commands/recipients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipients.d.ts","sourceRoot":"","sources":["../../src/commands/recipients.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKnC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAAO,OA8DpC,CAAA"}

package/dist/commands/recipients.js

@@ -0,0 +1,74 @@
+import { CliError } from "@wirecat/cli-core";
+import { annotate } from "@wirecat/cli-core/commands";
+import { Command } from "commander";
+import { recipientListFor } from "../sends.js";
+import { forCommand } from "./context.js";
+import { renderList } from "./paging.js";
+/**
+ * The chats this profile may send to. Off until the first `add`; `off` turns it off again.
+ *
+ * Scripts may change it too (`NEED-159` answers): the list stops a model that a message talked
+ * into writing somewhere, not an agent set on getting around it.
+ */
+export const recipientsCommand = () => {
+    const command = new Command("recipients").description("the chats this profile may send to, when the list is on");
+    command
+        .command("list")
+        .description("the chats on the list; empty and off until the first add")
+        .action(async function () {
+        const { settings, renderer, format, run } = forCommand(this);
+        await run("recipients list", async () => {
+            const chats = recipientListFor(settings.profile).read();
+            renderList(renderer, format, chats ?? []);
+            if (!chats)
+                renderer.note("the recipient list is off — this profile may send to any chat");
+            else if (chats.length === 0)
+                renderer.note("the recipient list is on and empty — this profile may send nowhere");
+        });
+    });
+    annotate(command.command("add"), { mutates: true, local: true })
+        .argument("<chat>", "chat id, or part of a chat name")
+        .description("allow sending to this chat; the first add turns the list on")
+        .action(async function (chat) {
+        const { settings, renderer, createClient, run } = forCommand(this);
+        await run("recipients add", async (events) => {
+            const client = createClient({ events });
+            try {
+                const found = await client.chats.show(chat);
+                const partnerId = found.kind === "dialog" ? await client.chats.partner(found.id) : undefined;
+                const added = recipientListFor(settings.profile).add({
+                    id: found.id,
+                    title: found.title,
+                    ...(partnerId ? { partnerId } : {}),
+                    addedAt: new Date().toISOString(),
+                });
+                renderer.result({ id: found.id, title: found.title, added });
+            }
+            finally {
+                await client.close();
+            }
+        });
+    });
+    annotate(command.command("remove"), { mutates: true, local: true })
+        .argument("<chat>", "chat id, or the title as the list shows it")
+        .description("stop allowing this chat; the list stays on")
+        .action(async function (chat) {
+        const { settings, renderer, run } = forCommand(this);
+        await run("recipients remove", async () => {
+            const gone = recipientListFor(settings.profile).remove(chat);
+            if (!gone)
+                throw new CliError("not_found", `${chat.trim()} is not on the recipient list of ${settings.profile}`);
+            renderer.result({ id: gone.id, title: gone.title, removed: true });
+        });
+    });
+    annotate(command.command("clear"), { mutates: true, local: true })
+        .description("empty the list and turn it off: this profile may send to any chat again")
+        .action(async function () {
+        const { settings, renderer, run } = forCommand(this);
+        await run("recipients clear", async () => {
+            renderer.result({ cleared: true, wasOn: recipientListFor(settings.profile).off() });
+        });
+    });
+    return command;
+};
+//# sourceMappingURL=recipients.js.map

package/dist/commands/recipients.js.map

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

package/dist/commands/runs.d.ts

@@ -0,0 +1,2 @@
+export declare const runsCommand: () => import("commander").Command;
+//# sourceMappingURL=runs.d.ts.map

package/dist/commands/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/commands/runs.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,mCAAmC,CAAA"}

package/dist/commands/runs.js

@@ -0,0 +1,4 @@
+import { runsCommand as sharedRunsCommand } from "@wirecat/cli-messaging/cli";
+import { MAX_APP } from "../app.js";
+export const runsCommand = () => sharedRunsCommand(MAX_APP);
+//# sourceMappingURL=runs.js.map

package/dist/commands/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/commands/runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAA"}

package/dist/commands/sends.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare const sendsCommand: () => Command;
+//# sourceMappingURL=sends.d.ts.map

package/dist/commands/sends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sends.d.ts","sourceRoot":"","sources":["../../src/commands/sends.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,eAAO,MAAM,YAAY,QAAO,OAA2C,CAAA"}

package/dist/commands/sends.js

@@ -0,0 +1,4 @@
+import { sendsCommand as sharedSendsCommand } from "@wirecat/cli-messaging/cli";
+import { maxMessenger } from "../messenger.js";
+export const sendsCommand = () => sharedSendsCommand(maxMessenger);
+//# sourceMappingURL=sends.js.map

package/dist/commands/sends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sends.js","sourceRoot":"","sources":["../../src/commands/sends.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAG,GAAY,EAAE,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAA"}

package/dist/commands/serve-members.d.ts

@@ -0,0 +1,14 @@
+import type { MaxClient } from "../client.js";
+import type { SessionStore } from "../session/store.js";
+export declare const serveMembers: ({ client, store, note, env, firstMs, everyMs, }: {
+    client: () => MaxClient | undefined;
+    store: SessionStore;
+    note: (line: string) => void;
+    env?: NodeJS.ProcessEnv;
+    firstMs?: number;
+    everyMs?: number;
+}) => {
+    start: () => void;
+    stop: () => Promise<void>;
+};
+//# sourceMappingURL=serve-members.d.ts.map

package/dist/commands/serve-members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-members.d.ts","sourceRoot":"","sources":["../../src/commands/serve-members.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAI7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,eAAO,MAAM,YAAY,oDAOtB;IACD,MAAM,EAAE,MAAM,SAAS,GAAG,SAAS,CAAA;IACnC,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;IAkCG,KAAK;IACL,IAAI;CAUP,CAAA"}

package/dist/commands/serve-members.js

@@ -0,0 +1,54 @@
+import { CliError } from "@wirecat/cli-core";
+import { memberFetches } from "@wirecat/cli-messaging/cli";
+import { chatsService, onlineDeps } from "@wirecat/cli-messaging/services";
+import { openStore } from "@wirecat/cli-messaging/store";
+import { maxAdapter } from "../adapter/max-adapter.js";
+import { resolveSettings } from "../config.js";
+import { maxMessenger } from "../messenger.js";
+import { assertReadable } from "../permissions.js";
+export const serveMembers = ({ client, store, note, env = process.env, firstMs, everyMs, }) => {
+    let opened;
+    const worker = memberFetches({
+        ...(firstMs === undefined ? {} : { firstMs }),
+        ...(everyMs === undefined ? {} : { everyMs }),
+        withStore: async (work) => {
+            const account = store.readState().viewerId;
+            if (!account)
+                throw new CliError("authentication_error", "the server has no account");
+            opened ??= openStore({ env });
+            return work(await opened, { provider: "max", account });
+        },
+        fetch: async (db, account, chatId) => {
+            assertReadable(resolveSettings({ profile: store.profile }, { env }), "chats.members.fetch");
+            const held = client();
+            if (!held)
+                throw new CliError("network_error", "the server is disconnected");
+            if (store.readState().viewerId !== account.account)
+                throw new CliError("authentication_error", "the server account changed");
+            // Reads use the held connection; the worker must never open its own login.
+            const guard = {
+                check: () => {
+                    throw new CliError("permission_error", "member fetching cannot write");
+                },
+                record: () => { },
+            };
+            const deps = onlineDeps(maxMessenger, maxAdapter(held, store), guard, { profile: store.profile, env });
+            await chatsService({ ...deps, account: async () => account, store: async () => db }).fetchMembers(chatId, {});
+        },
+        // Provider errors may contain names or message text; only the category belongs in the log.
+        warn: () => note("daily member fetching failed; retry with `chats members fetch` or check server connectivity and permissions"),
+    });
+    return {
+        start: worker.start,
+        stop: async () => {
+            await worker.stop();
+            if (opened) {
+                const db = opened;
+                opened = undefined;
+                const connection = await db.catch(() => undefined);
+                await connection?.close();
+            }
+        },
+    };
+};
+//# sourceMappingURL=serve-members.js.map

package/dist/commands/serve-members.js.map

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

package/dist/commands/serve-stems.d.ts

@@ -0,0 +1,9 @@
+/** Needs no MAX connection, so it runs beside the server rather than inside it. */
+export declare const serveStems: ({ note, env }: {
+    note: (line: string) => void;
+    env?: NodeJS.ProcessEnv;
+}) => {
+    start: () => void;
+    stop: () => Promise<void>;
+};
+//# sourceMappingURL=serve-stems.d.ts.map

package/dist/commands/serve-stems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-stems.d.ts","sourceRoot":"","sources":["../../src/commands/serve-stems.ts"],"names":[],"mappings":"AAGA,mFAAmF;AACnF,eAAO,MAAM,UAAU,kBAAiC;IAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE;IAU7G,KAAK;IACL,IAAI;CAUP,CAAA"}

package/dist/commands/serve-stems.js

@@ -0,0 +1,26 @@
+import { stemFills } from "@wirecat/cli-messaging/cli";
+import { openStore } from "@wirecat/cli-messaging/store";
+/** Needs no MAX connection, so it runs beside the server rather than inside it. */
+export const serveStems = ({ note, env = process.env }) => {
+    let opened;
+    const worker = stemFills({
+        withStore: async (work) => {
+            opened ??= openStore({ env });
+            return work(await opened);
+        },
+        warn: () => note("filling search stems failed; `max store migrate` finishes them"),
+    });
+    return {
+        start: worker.start,
+        stop: async () => {
+            await worker.stop();
+            if (opened) {
+                const db = opened;
+                opened = undefined;
+                const connection = await db.catch(() => undefined);
+                await connection?.close();
+            }
+        },
+    };
+};
+//# sourceMappingURL=serve-stems.js.map

package/dist/commands/serve-stems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-stems.js","sourceRoot":"","sources":["../../src/commands/serve-stems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAqB,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE3E,mFAAmF;AACnF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAA6D,EAAE,EAAE;IACnH,IAAI,MAAyC,CAAA;IAC7C,MAAM,MAAM,GAAG,SAAS,CAAC;QACvB,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACxB,MAAM,KAAK,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;YAC7B,OAAO,IAAI,CAAC,MAAM,MAAM,CAAC,CAAA;QAC3B,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,gEAAgE,CAAC;KACnF,CAAC,CAAA;IACF,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YACnB,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,EAAE,GAAG,MAAM,CAAA;gBACjB,MAAM,GAAG,SAAS,CAAA;gBAClB,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;gBAClD,MAAM,UAAU,EAAE,KAAK,EAAE,CAAA;YAC3B,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+/**
+ * `max serve` — stays up, holding one logged-in connection, until Ctrl-C (`MAX-16`).
+ *
+ * Typed by hand it runs in the foreground until stopped. **Any command that needs MAX starts one
+ * in the background when none is running** (`serve` setting, `--no-serve` to decline), and that
+ * one is given `--idle`, so it does not outlive the work that started it.
+ */
+export declare const serveCommand: () => Command;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAW3C;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,QAAO,OA6D1B,CAAA"}