@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/cli/messenger/review.js

@@ -0,0 +1,135 @@
+import { CliError } from "@wirecat/cli-base";
+import { Command } from "commander";
+import { renderMessages } from "../../render/messages.js";
+import { CHAT_KINDS } from "../../services/chats.js";
+import { kindsOf, REVIEW_DAYS, reviewStart, UNANSWERED_HOURS } from "../../services/inbox.js";
+import { momentOf } from "../../services/moment.js";
+import { modelWith } from "../../speech/hearing.js";
+import { parseDuration } from "../settings.js";
+import { MARK_READ_OPTION, markShown, marksRead, NO_MARK_READ_OPTION } from "./catch-up.js";
+import { messengerContext } from "./context.js";
+import { heardItems, hearForCommand, hearingFields, MODEL_OPTION, spokenItems, TRANSCRIBE_OPTION, } from "./hearing-command.js";
+import { PARTIAL_NOTE } from "./inbox.js";
+import { checkPoints } from "./points.js";
+/** `--unanswered` with no value is `true`. */
+export const unansweredHours = (value, flag = "--unanswered") => value === true ? UNANSWERED_HOURS : parseDuration(String(value), flag) / 3_600_000;
+/**
+ * **Everything said since a point, both sides, in every chat that changed** — the reading half of a
+ * review of who owes what (max-cli's `review`). Sorting it is the reader's job, person or agent.
+ * Nothing is marked read unless asked, and `inbox --new` keeps its point. The rules open and close
+ * tasks in the local store from what it read (`../../services/task-rules.ts`); nothing reaches the messenger.
+ */
+export const reviewCommand = (messenger) => new Command("review")
+    .description("every message, yours too, in chats that changed since a point — for reviewing who owes what")
+    .option("--since-time <time>", `where the last review ended — ISO 8601, or 2h / 1d ago; ${REVIEW_DAYS} days ago if not given`)
+    .option("--chat <chat>", `only this chat: ${messenger.chatArgument}`)
+    .option("--kind <kinds>", `only chats of these kinds, comma-separated: ${CHAT_KINDS.join(", ")}`)
+    .option("--unanswered [duration]", `only questions to you or a group's admins that nobody answered, asked at least this long ago — 4h, 1d; ${UNANSWERED_HOURS}h if not given`)
+    .option("--all", "muted and archived chats too — left out unless they mention you or reply to you")
+    .option(...TRANSCRIBE_OPTION)
+    .option(...MODEL_OPTION)
+    .option("--new", "what changed since the last `review --new`, a point per chat — for scheduled runs")
+    .option(...MARK_READ_OPTION)
+    .option(...NO_MARK_READ_OPTION)
+    .action(async function () {
+    const options = this.opts();
+    const hearWith = modelWith(options.transcribe, options.model);
+    const context = messengerContext(this, messenger);
+    const { settings, renderer, format, streams, env } = context;
+    if (options.new && (options.sinceTime !== undefined || options.unanswered !== undefined)) {
+        // An open question stays open: moving past it would drop it from the next review.
+        throw new CliError("validation_error", "--new keeps its own point — not with --since-time or --unanswered");
+    }
+    const saved = options.new
+        ? checkPoints(messenger.app, {
+            command: "review",
+            profile: settings.profile,
+            env,
+            firstLookMs: REVIEW_DAYS * 86_400_000,
+        })
+        : undefined;
+    const since = options.sinceTime !== undefined ? momentOf(options.sinceTime, "--since-time") : (saved?.first ?? reviewStart());
+    const marking = marksRead(options.markRead, settings);
+    const hours = options.unanswered === undefined ? undefined : unansweredHours(options.unanswered);
+    const kinds = options.kind === undefined ? undefined : kindsOf(options.kind);
+    let hearing;
+    const transcribe = options.transcribe === true;
+    const { found, marked } = await context.withServices(async (services, connect) => {
+        const found = await services.inbox.review({
+            since,
+            ...(saved === undefined ? {} : { points: saved.chats }),
+            ...(options.chat === undefined ? {} : { chat: options.chat }),
+            ...(kinds === undefined ? {} : { kinds }),
+            ...(options.all ? { all: true } : {}),
+            ...(hours === undefined ? {} : { unansweredAfterHours: hours }),
+            enrich: async (raw) => {
+                const read = raw.chats.flatMap((chat) => chat.messages);
+                hearing = await hearForCommand(context, messenger, read, transcribe, hearWith, connect);
+                return {
+                    ...raw,
+                    complete: raw.complete && (hearing?.unheard.length ?? 0) === 0,
+                    chats: raw.chats.map((chat) => ({ ...chat, messages: heardItems(chat.messages, hearing) })),
+                };
+            },
+        });
+        return { found, marked: marking ? await markShown(services, found.chats) : undefined };
+    });
+    const read = found.chats.flatMap((chat) => chat.messages.map((message) => ({ ...message, chatTitle: chat.title })));
+    const messages = heardItems(read, hearing);
+    found.complete &&= (hearing?.unheard.length ?? 0) === 0;
+    if (format === "jsonl")
+        renderer.stream(messages);
+    else if (format !== "pretty") {
+        renderer.result({
+            ...found,
+            ...(marked === undefined ? {} : { markedRead: marked }),
+            chats: found.chats.map((chat) => ({ ...chat, messages: heardItems(chat.messages, hearing) })),
+            ...hearingFields(hearing, true),
+        });
+    }
+    else if (messages.length > 0) {
+        streams.data(renderMessages(spokenItems(messages, hearing), {
+            color: context.color,
+            verbosity: settings.detail,
+            senderColors: settings.senderColors,
+            profile: context.profile,
+            provider: messenger.provider,
+            locale: messenger.app.locale,
+        }));
+    }
+    if (marked !== undefined)
+        renderer.note(`marked ${marked.length} chat(s) read up to the newest message shown`);
+    notes(found, messenger.app.command, saved !== undefined, renderer.note.bind(renderer));
+    saved?.save(found.checked ?? {});
+});
+const notes = (found, command, fresh, note) => {
+    for (const chat of found.chats) {
+        if (chat.more)
+            note(`${chat.title ?? chat.id}: cut short, only the newest — \`${command} messages list ${chat.id}\``);
+        if (chat.answeredBy === "owner")
+            note(`${chat.title ?? chat.id}: its admins are not known, so only your answers count`);
+    }
+    if (found.skipped.length > 0) {
+        const names = found.skipped.map((chat) => chat.title ?? chat.id).join(", ");
+        note(`skipped ${found.skipped.length} chats — too many at once: ${names}`);
+    }
+    if (found.tasks && found.tasks.added + found.tasks.closed > 0)
+        note(`tasks: ${found.tasks.added} opened, ${found.tasks.closed} closed by the rules`);
+    if (found.partial)
+        note(PARTIAL_NOTE);
+    if (found.quiet > 0)
+        note(`${found.quiet} muted or archived chats left out — --all reads them`);
+    if (found.unanswered) {
+        note(`questions from ${found.since} to ${found.until} still open after ${found.unanswered.olderThanHours} hours; ` +
+            "an answer after the review's end is not seen");
+        return;
+    }
+    if (fresh) {
+        note(`from ${found.since} to ${found.until} — the next \`review --new\` goes on from here, chat by chat`);
+        return;
+    }
+    note(found.complete
+        ? `from ${found.since} to ${found.until} — the next review starts with --since-time ${found.until}`
+        : `from ${found.since} to ${found.until}, incomplete — keep --since-time ${found.since} for the next review`);
+};
+//# sourceMappingURL=review.js.map

package/dist/cli/messenger/review.js.map

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

package/dist/cli/messenger/schedule-command.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+/**
+ * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
+ * (macOS) or Task Scheduler (Windows). Every timer runs `schedule exec <file>`; the schedule file holds
+ * the rest, so what runs and with which variables is the same on all three.
+ */
+export declare const scheduleCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=schedule-command.d.ts.map

package/dist/cli/messenger/schedule-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/schedule-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,OAAO,EAAU,MAAM,WAAW,CAAA;AAoBrD,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAiD/D;;;;GAIG;AACH,eAAO,MAAM,eAAe,cAAe,SAAS,KAAG,OAqLtD,CAAA"}

package/dist/cli/messenger/schedule-command.js

@@ -0,0 +1,214 @@
+import { existsSync, rmSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { CliError, resolvePaths, writeSecurely } from "@wirecat/cli-base";
+import { Argument, Command, Option } from "commander";
+import { describeWhen, findProgram, lastRun, listSchedules, runSchedule, scheduleFile, scheduleName, timerFor, } from "../../background/schedules.js";
+import { thisMachine } from "../../background/system.js";
+import { locationVariables } from "../../background/units.js";
+import { aheadOf } from "../../services/moment.js";
+import { storePath } from "../../store/path.js";
+import { environmentOf } from "../context.js";
+import { listed } from "../paging.js";
+import { parseDuration } from "../settings.js";
+import { messengerContext } from "./context.js";
+/** Each run of an agent is a paid model call that reads chats; keeping the store current is `serve`'s job. */
+const AGENT_MINIMUM_MINUTES = 60;
+const COMMAND_MINIMUM_MINUTES = 1;
+const HARNESSES = ["claude", "codex"];
+const whenOf = ({ every, at, once }, minimum) => {
+    if ([every ?? at, once].filter(Boolean).length !== 1) {
+        throw new CliError("validation_error", "say when: --every <30m|2h|1d>, --at HH:MM (daily), or --once <30m|2d|ISO time>");
+    }
+    if (once) {
+        const time = aheadOf(once, "--once");
+        if (time <= Date.now())
+            throw new CliError("validation_error", "--once is in the past");
+        return { once: new Date(time).toISOString() };
+    }
+    if (at) {
+        if (!/^([01]\d|2[0-3]):[0-5]\d$/.test(at))
+            throw new CliError("validation_error", `--at takes HH:MM, not "${at}"`);
+        if (every && parseDuration(every, "--every") !== 86_400_000) {
+            throw new CliError("validation_error", "--at runs once a day; leave out --every, or use --every 1d");
+        }
+        return { daily: at };
+    }
+    const minutes = parseDuration(every ?? "", "--every") / 60_000;
+    if (!Number.isInteger(minutes) || minutes < minimum) {
+        throw new CliError("validation_error", `--every is at least ${minimum} minute${minimum === 1 ? "" : "s"} here, in whole minutes`);
+    }
+    return { every: minutes };
+};
+const withWhen = (command) => command
+    .option("--every <duration>", "repeat: 30m, 2h, 1d")
+    .option("--at <HH:MM>", "every day at this local time")
+    .option("--once <when>", "one run: 30m, 2d from now, or an ISO time; the schedule removes itself after it");
+/**
+ * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
+ * (macOS) or Task Scheduler (Windows). Every timer runs `schedule exec <file>`; the schedule file holds
+ * the rest, so what runs and with which variables is the same on all three.
+ */
+export const scheduleCommand = (messenger) => {
+    const { app } = messenger;
+    const command = new Command("schedule").description(`run a ${app.command} command or an agent later or on a timer (systemd, launchd, Task Scheduler); an agent cannot send`);
+    const prepare = (self) => {
+        const context = messengerContext(self, messenger);
+        const system = environmentOf(self).system ?? thisMachine();
+        const state = resolvePaths({ appName: app.appName, prefix: app.envPrefix, env: context.env }).state;
+        const say = (value, lines) => {
+            if (context.format === "pretty")
+                context.streams.data(lines.join("\n"));
+            else
+                context.renderer.result(value);
+        };
+        const timer = () => timerFor(app, system, context.env);
+        const environment = () => ({
+            [`${app.envPrefix}_PROFILE`]: context.profile,
+            ...locationVariables(app, context.env),
+            // The timer starts with almost no PATH; an agent runs `max` and its own tools by name.
+            ...(context.env.PATH ? { PATH: context.env.PATH } : {}),
+        });
+        const save = async (schedule) => {
+            const file = scheduleFile(state, schedule.name);
+            const replaced = existsSync(file);
+            writeSecurely(file, `${JSON.stringify(schedule, null, 2)}\n`, 0o600);
+            await timer().install(schedule, [...system.entry, "schedule", "exec", file]);
+            say({ ...schedule, file, timer: timer().where(schedule.name), replaced }, [
+                `${replaced ? "Replaced" : "Added"} ${schedule.name}: ${describeWhen(schedule.when)}.`,
+                `It runs: ${schedule.kind === "agent" ? schedule.argv.join(" ") : `${app.command} ${schedule.argv.join(" ")}`}`,
+                `Output: ${join(dirname(file), "runs")} · now: ${app.command} schedule run ${schedule.name} · stop: ${app.command} schedule remove ${schedule.name}`,
+            ]);
+        };
+        return { context, system, state, say, timer, environment, save };
+    };
+    withWhen(command
+        .command("command")
+        .description(`run ${app.command} <args…> on a timer — reads save what they read, so this is how a chat's history fills the store`)
+        .argument("<name>", "lowercase letters, digits and dashes")
+        .argument("<args...>", `the ${app.command} command after its name, e.g. -- messages list <chat> --limit 50`)).action(async function (name, args) {
+        const { environment, save } = prepare(this);
+        if (args[0] === "schedule")
+            throw new CliError("validation_error", "a schedule cannot run schedule");
+        await save({
+            name: scheduleName(name),
+            kind: "command",
+            argv: args,
+            when: whenOf(this.opts(), COMMAND_MINIMUM_MINUTES),
+            environment: environment(),
+            createdAt: new Date().toISOString(),
+        });
+    });
+    withWhen(command
+        .command("agent")
+        .description(`start an agent (claude or codex) with a prompt on a timer; it runs with ${app.envPrefix}_READ_ONLY=1, so it reads and drafts and cannot send — its answer is kept and you are notified`)
+        .argument("<name>", "lowercase letters, digits and dashes")
+        .addArgument(new Argument("<harness>", "the agent to start").choices(HARNESSES))
+        .argument("<prompt>", `what to do, e.g. "run the daily follow-up review: ${app.command} skill show follow-ups"`)
+        .addOption(new Option("--max-cost <usd>", "claude only: stop a run that costs more than this, in US dollars").argParser(Number))).action(async function (name, harness, prompt) {
+        const { context, system, environment, save } = prepare(this);
+        const options = this.opts();
+        const program = findProgram(harness, context.env, system.platform);
+        if (!program)
+            throw new CliError("not_found", `${harness} is not on PATH`);
+        const paths = resolvePaths({ appName: app.appName, prefix: app.envPrefix, env: context.env });
+        const argv = harness === "claude"
+            ? [
+                program,
+                "-p",
+                prompt,
+                // The owner's own settings may let every tool run (bypassPermissions); here only the CLI may.
+                "--permission-mode",
+                "dontAsk",
+                "--allowedTools",
+                `Bash(${app.command}:*)`,
+                "--no-session-persistence",
+                ...(options.maxCost ? ["--max-budget-usd", String(options.maxCost)] : []),
+            ]
+            : [
+                program,
+                "exec",
+                "--skip-git-repo-check",
+                "--ephemeral",
+                "--sandbox",
+                "workspace-write",
+                // The CLI reaches the messenger and writes its store and state, and nothing else.
+                "-c",
+                "sandbox_workspace_write.network_access=true",
+                ...[dirname(storePath(context.env)), paths.state, paths.config, paths.cache].flatMap((dir) => [
+                    "--add-dir",
+                    dir,
+                ]),
+                prompt,
+            ];
+        await save({
+            name: scheduleName(name),
+            kind: "agent",
+            argv,
+            when: whenOf(options, AGENT_MINIMUM_MINUTES),
+            environment: environment(),
+            createdAt: new Date().toISOString(),
+        });
+    });
+    command
+        .command("list")
+        .description("the schedules, when they run and how their last run went")
+        .action(function () {
+        const { context, state } = prepare(this);
+        const rows = listSchedules(state).map((schedule) => ({
+            name: schedule.name,
+            kind: schedule.kind,
+            when: describeWhen(schedule.when),
+            last: lastRun(scheduleFile(state, schedule.name)) ?? null,
+        }));
+        if (context.format !== "pretty")
+            return context.renderer.result(listed(rows));
+        if (rows.length === 0)
+            return context.renderer.note(`no schedules — \`${app.command} schedule command|agent\` adds one`);
+        context.streams.data(rows
+            .map(({ name, kind, when, last }) => [
+            name,
+            kind,
+            when,
+            last ? `last ${last.at.slice(0, 16).replace("T", " ")} exit ${last.exitCode}` : "not run yet",
+        ].join("  "))
+            .join("\n"));
+    });
+    command
+        .command("run")
+        .description("run a schedule now, as its timer would, and wait for it")
+        .argument("<name>")
+        .action(async function (name) {
+        const { context, system, state, say, timer } = prepare(this);
+        const last = await runSchedule(app, system, context.env, scheduleFile(state, scheduleName(name)), {
+            timer: timer(),
+        });
+        say({ name, ...last }, [`${name}: exit ${last.exitCode} — ${last.output}`]);
+        if (last.exitCode !== 0)
+            process.exitCode = 1;
+    });
+    command
+        .command("remove")
+        .description("stop a schedule and remove its timer; its past output stays")
+        .argument("<name>")
+        .action(async function (name) {
+        const { state, say, timer } = prepare(this);
+        const file = scheduleFile(state, scheduleName(name));
+        if (!existsSync(file))
+            throw new CliError("not_found", `no schedule ${name} — \`${app.command} schedule list\``);
+        await timer().remove(name);
+        rmSync(file, { force: true });
+        say({ name, removed: true }, [`Removed ${name}.`]);
+    });
+    command
+        .command("exec")
+        .description("what a timer runs, given the schedule's file; to run one by hand, use run")
+        .argument("<file>")
+        .action(async function (file) {
+        const { context, system, timer } = prepare(this);
+        const last = await runSchedule(app, system, context.env, file, { timer: timer() });
+        if (last.exitCode !== 0)
+            process.exitCode = 1;
+    });
+    return command;
+};
+//# sourceMappingURL=schedule-command.js.map

package/dist/cli/messenger/schedule-command.js.map

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

package/dist/cli/messenger/search-backend-options.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from "commander";
+import type { Backend, ServerOptions, ServerSearched } from "../../services/server-search.js";
+import type { Messenger, MessengerContext } from "./context.js";
+/** Mounted only where the messenger's server can search messages. */
+export declare const backendOptions: (command: Command, messenger: Messenger) => Command;
+export declare const backendRequest: (command: Command) => {
+    backend?: Backend;
+    server?: ServerOptions;
+};
+export declare const noteServer: (context: MessengerContext, server: ServerSearched | undefined) => void;
+//# sourceMappingURL=search-backend-options.d.ts.map

package/dist/cli/messenger/search-backend-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-backend-options.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/search-backend-options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAE7F,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAQ/D,qEAAqE;AACrE,eAAO,MAAM,cAAc,YAAa,OAAO,aAAa,SAAS,KAAG,OAS3D,CAAA;AAEb,eAAO,MAAM,cAAc,YAAa,OAAO,KAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAM5F,CAAA;AAED,eAAO,MAAM,UAAU,YAAa,gBAAgB,UAAU,cAAc,GAAG,SAAS,KAAG,IAO1F,CAAA"}

package/dist/cli/messenger/search-backend-options.js

@@ -0,0 +1,29 @@
+import { CliError } from "@wirecat/cli-base";
+import { parseDuration } from "../settings.js";
+const backendOf = (value) => {
+    if (value !== "archive" && value !== "server" && value !== "both")
+        throw new CliError("validation_error", "--backend takes archive, server or both");
+    return value;
+};
+/** Mounted only where the messenger's server can search messages. */
+export const backendOptions = (command, messenger) => messenger.serverSearch
+    ? command
+        .option("--backend <archive|server|both>", "where to search: the local archive, the messenger's server, or both (default: both; message discovery uses archive only)", backendOf)
+        .option("--server-time <duration>", "stop waiting for the server after this long (default: 5s)")
+    : command;
+export const backendRequest = (command) => {
+    const { backend, serverTime } = command.opts();
+    return {
+        ...(backend === undefined ? {} : { backend }),
+        ...(serverTime === undefined ? {} : { server: { timeMs: parseDuration(serverTime, "--server-time") } }),
+    };
+};
+export const noteServer = (context, server) => {
+    if (!server)
+        return;
+    if (server.skipped)
+        context.renderer.note(`server search skipped: ${server.skipped} — the answer is the archive's`);
+    else if (!server.complete)
+        context.renderer.note(`server search incomplete${server.failed.length ? `: ${[...new Set(server.failed.map(({ reason }) => reason))].join(", ")}` : ""}`);
+};
+//# sourceMappingURL=search-backend-options.js.map

package/dist/cli/messenger/search-backend-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-backend-options.js","sourceRoot":"","sources":["../../../src/cli/messenger/search-backend-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAG9C,MAAM,SAAS,GAAG,CAAC,KAAa,EAAW,EAAE;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM;QAC/D,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,yCAAyC,CAAC,CAAA;IACnF,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAE,SAAoB,EAAW,EAAE,CAChF,SAAS,CAAC,YAAY;IACpB,CAAC,CAAC,OAAO;SACJ,MAAM,CACL,iCAAiC,EACjC,0HAA0H,EAC1H,SAAS,CACV;SACA,MAAM,CAAC,0BAA0B,EAAE,2DAA2D,CAAC;IACpG,CAAC,CAAC,OAAO,CAAA;AAEb,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAiD,EAAE;IAChG,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,EAA8C,CAAA;IAC1F,OAAO;QACL,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC;KACxG,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAyB,EAAE,MAAkC,EAAQ,EAAE;IAChG,IAAI,CAAC,MAAM;QAAE,OAAM;IACnB,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,OAAO,gCAAgC,CAAC,CAAA;SAC9G,IAAI,CAAC,MAAM,CAAC,QAAQ;QACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CACnB,2BAA2B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACnI,CAAA;AACL,CAAC,CAAA"}

package/dist/cli/messenger/search-command.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+/**
+ * `search <resource>`: every search of the tool, one leaf per resource (STANDARD.md, "Search
+ * hierarchy"). `topics` only where the CLI has forum topics.
+ */
+export declare const searchCommand: (messenger: Messenger, { topics }?: {
+    topics?: boolean;
+}) => Command;
+//# sourceMappingURL=search-command.d.ts.map

package/dist/cli/messenger/search-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/search-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAyL/D;;;GAGG;AACH,eAAO,MAAM,aAAa,cAAe,SAAS,eAAsB;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KAAQ,OAYnG,CAAA"}

package/dist/cli/messenger/search-command.js

@@ -0,0 +1,152 @@
+import { CliError, singleLine } from "@wirecat/cli-base";
+import { Command } from "commander";
+import { SAVE_HELP } from "../../meetings/index.js";
+import { searchNotesOf } from "../../services/notes-search.js";
+import { RESOURCES_SEARCHED_WITH_MEETINGS, } from "../../services/search-all-meetings.js";
+import { positiveCount } from "../paging.js";
+import { messengerContext } from "./context.js";
+import { conversationsSearchCommand } from "./conversations-command.js";
+import { messagesSearchCommand, wholeCount } from "./messages-search-command.js";
+import { backendOptions, backendRequest, noteServer } from "./search-backend-options.js";
+import { topicsSearchCommand } from "./topics-command.js";
+const onlyOf = (value) => {
+    const chosen = value.split(",").map((one) => one.trim());
+    const unknown = chosen.find((one) => !RESOURCES_SEARCHED_WITH_MEETINGS.includes(one));
+    if (unknown !== undefined || chosen.length === 0)
+        throw new CliError("validation_error", `--only takes ${RESOURCES_SEARCHED_WITH_MEETINGS.join(", ")}, separated by commas; meetings when --source names a meeting account`);
+    return [...new Set(chosen)];
+};
+const lineOf = (item) => item.kind === "meeting"
+    ? `meeting · ${item.provider} · ${singleLine(item.title ?? "")}  ${item.ref}\n  ${item.timestamp ?? "time unknown"}  ${singleLine(item.text).slice(0, 200)}\n`
+    : `${item.kind} · ${item.provider} · ${singleLine(item.title ?? "")}  ${item.ref}\n  ${item.timestamp}${item.from?.name ? `  ${singleLine(item.from.name)}` : ""}  ${singleLine(item.text)}\n`;
+const maxMeetingsOf = (value) => {
+    if (value === "all")
+        return "all";
+    if (!/^[1-9]\d*$/.test(value))
+        throw new CliError("validation_error", "--max-meetings takes a whole number from 1, or all");
+    return Number(value);
+};
+const noteTypeOf = (value) => {
+    if (value !== "internal" && value !== "file")
+        throw new CliError("validation_error", "--type takes internal (written in memo) or file (from a notes folder)");
+    return value;
+};
+const allCommand = (messenger) => {
+    const command = new Command("all")
+        .description((messenger.serverSearch
+        ? "search messenger messages, mail and notes in the local store, and the messenger's server for messages " +
+            "(--backend; mail and notes are local only)"
+        : "search messenger messages, mail and notes in the local store") +
+        ", and a meeting account's transcripts when --source names one — best match first; not tasks, people, memories or " +
+        "projects. Use it when you do not know where something was written; search mail, messages or notes reads one " +
+        "kind with all its fields")
+        .argument("<query...>", 'strict Lucene query: words, "phrases", AND/OR/NOT, field groups and date ranges')
+        .addHelpText("after", SAVE_HELP)
+        .addHelpText("after", `transcript: narrows a message search to voice transcripts, content: to the text of files, filename: to their names — \`${messenger.app.command} search all 'content:invoice'\`.
+--json: the list is items; each result's reference is ref, with its kind (search messages gives locator).`)
+        .option("--only <resources>", "only these resources, separated by commas: messages, mail, notes; meetings when --source names a meeting account", onlyOf)
+        .option("--source <accounts>", "only these accounts, separated by commas: provider:account as a hit shows it, a provider, a kind or " +
+        "group:<name>; each resource reads the ones of its kind, and meetings only when it names one")
+        .option("--max-meetings <n|all>", "how many of the meeting account's meetings to look through, newest first; all looks through every one (default 100)", maxMeetingsOf)
+        .option("--limit <n>", "how many", positiveCount("--limit"))
+        .option("--offset <n>", "skip this many, for the next page", wholeCount)
+        .option("--exact", "bare words and quotes match their exact form only, as exact:word does")
+        .option("--timezone <zone>", "the IANA timezone for calendar date boundaries");
+    return backendOptions(command, messenger).action(async function (words) {
+        const context = messengerContext(this, messenger);
+        const { only, source, maxMeetings, limit, offset, exact, timezone } = this.opts();
+        const found = await context.withServices((services) => services.messages.searchAllWithMeetings({
+            text: words.join(" "),
+            limit: limit ?? context.settings.limit,
+            ...(offset === undefined ? {} : { offset }),
+            ...(exact ? { exact: true } : {}),
+            ...(timezone === undefined ? {} : { timezone }),
+            ...backendRequest(this),
+            env: context.env,
+            ...(only === undefined ? {} : { only }),
+            ...(source === undefined ? {} : { source }),
+            ...(maxMeetings === undefined ? {} : { maxMeetings }),
+        }));
+        noteServer(context, found.server);
+        if (context.format === "pretty")
+            context.renderer.note(`searched: ${found.accounts.map(({ provider, account }) => `${provider}:${account}`).join(", ") || "nothing"}`);
+        for (const { resource, source, reason } of found.skipped)
+            context.renderer.note(`${resource ?? source} not searched: ${reason}`);
+        if (found.notes?.meaningSkipped)
+            context.renderer.note(`notes by words only: ${found.notes.meaningSkipped}`);
+        if (found.meetings?.complete === false)
+            context.renderer.note(`meetings: stopped after ${found.meetings.meetingsScanned} meetings; more may match — --max-meetings all looks through every one`);
+        if (context.format === "jsonl")
+            return context.renderer.stream(found.items);
+        if (context.format !== "pretty")
+            return context.renderer.result(found);
+        context.streams.data(found.items.map(lineOf).join(""));
+        if (found.items.length === 0)
+            context.renderer.note(found.server && !found.server.skipped
+                ? "nothing found in the local store or on the messenger's server"
+                : "nothing found in what the local store holds");
+    });
+};
+const notesCommand = (messenger) => new Command("notes")
+    .description("search the notes — written in memo, or imported from a notes folder — by words and, with the local " +
+    "text model, by meaning; each hit says which found it and what it links to")
+    .argument("<query...>", 'strict Lucene query: words, "phrases", AND/OR/NOT, tag: and date ranges')
+    .addHelpText("after", "--json: the list is hits, not items; each note's reference is ref.")
+    .option("--type <internal|file>", "only notes written in memo, or only notes from a folder", noteTypeOf)
+    .option("--source <accounts>", "only these notes accounts, separated by commas: notes:internal for notes written in memo, notes:<folder id> " +
+    "as a hit shows it, notes, documents or group:<name>")
+    .option("--tag <tag>", "only notes with this tag")
+    .option("--filter <query>", "a query every hit must also match; it does not change the search by meaning")
+    .option("--limit <n>", "how many", positiveCount("--limit"))
+    .option("--offset <n>", "skip this many, for the next page", (value) => Number(value))
+    .option("--exact", "words as written only; meaning is not searched")
+    .option("--timezone <zone>", "the IANA timezone for calendar date boundaries")
+    .action(async function (words) {
+    const context = messengerContext(this, messenger);
+    const options = this.opts();
+    const found = await context.withStore((store, account) => searchNotesOf(store, account, words.join(" "), {
+        limit: options.limit ?? context.settings.limit,
+        command: messenger.app.command,
+        env: context.env,
+        ...(options.offset === undefined ? {} : { offset: options.offset }),
+        ...(options.type === undefined ? {} : { source: options.type }),
+        ...(options.source === undefined ? {} : { accounts: options.source }),
+        app: messenger.app,
+        ...(options.tag === undefined ? {} : { tag: options.tag }),
+        ...(options.filter === undefined ? {} : { filter: options.filter }),
+        ...(options.exact ? { exact: true } : {}),
+        ...(options.timezone === undefined ? {} : { timezone: options.timezone }),
+    }));
+    if (context.format === "pretty")
+        context.renderer.note(`searched: ${found.accounts.map(({ account }) => `notes:${account}`).join(", ")}`);
+    for (const { source, reason } of found.skipped)
+        context.renderer.note(`${source} not searched: ${reason}`);
+    if (found.meaningSkipped)
+        context.renderer.note(`by words only: ${found.meaningSkipped}`);
+    if (context.format === "jsonl")
+        return context.renderer.stream(found.hits);
+    if (context.format !== "pretty")
+        return context.renderer.result(found);
+    context.streams.data(found.hits
+        .map((hit) => `${singleLine(hit.title ?? hit.path ?? hit.ref)}  ${hit.ref}  (${hit.foundBy.join(", ")})\n  ${singleLine(hit.line)}\n`)
+        .join(""));
+    if (found.hits.length === 0)
+        context.renderer.note("no note matches");
+});
+/**
+ * `search <resource>`: every search of the tool, one leaf per resource (STANDARD.md, "Search
+ * hierarchy"). `topics` only where the CLI has forum topics.
+ */
+export const searchCommand = (messenger, { topics = false } = {}) => {
+    const search = new Command("search").description("find things by text: one resource when you know it (mail, messages, notes), or search all across messages, mail and notes");
+    search
+        .addCommand(allCommand(messenger))
+        .addCommand(messagesSearchCommand(messenger, "messages"))
+        .addCommand(messagesSearchCommand(messenger, "mail"))
+        .addCommand(notesCommand(messenger))
+        .addCommand(conversationsSearchCommand(messenger));
+    if (topics)
+        search.addCommand(topicsSearchCommand(messenger));
+    return search;
+};
+//# sourceMappingURL=search-command.js.map