@wirecat/zoom-cli 0.1.1 → 0.2.1

package/dist/archive-commands.js

@@ -0,0 +1,182 @@
+import { annotate } from "@wirecat/cli-core/commands";
+import { listed } from "@wirecat/cli-meetings";
+import { ZoomError } from "./errors.js";
+import { bytes } from "./execution.js";
+import { syncRecordingArchive } from "./recording-sync.js";
+const label = (command, example, mutation = "none") => annotate(command, {
+    origin: "handwritten",
+    mutates: mutation !== "none",
+    ...(mutation === "none" ? {} : { local: mutation === "local" }),
+    examples: [example],
+});
+const positive = (text) => {
+    const value = bytes(text);
+    if (value === 0)
+        throw new ZoomError("validation_error", "expected a positive number");
+    return value;
+};
+const change = (options) => Object.fromEntries(["topic", "startTime", "durationMinutes", "timezone", "agenda", "type"]
+    .filter((key) => options[key] !== undefined)
+    .map((key) => [key, options[key]]));
+const changes = (command) => command
+    .option("--topic <text>", "meeting topic")
+    .option("--start-time <timestamp>", "ISO start time with timezone")
+    .option("--duration-minutes <minutes>", "positive meeting duration in minutes", positive)
+    .option("--timezone <zone>", "IANA timezone")
+    .option("--agenda <text>", "meeting agenda")
+    .option("--type <type>", "instant (1) or scheduled (2)", positive)
+    .option("--yes", "apply the remote mutation once instead of previewing")
+    .option("--dry-run", "preview only, including when --yes is present");
+const mutation = (options, deps) => {
+    if (options.yes && !options.dryRun)
+        deps.api();
+    return { apply: options.yes, dryRun: options.dryRun, signal: deps.signal(), occurrenceId: options.occurrenceId };
+};
+export const addArchiveCommands = (program, deps) => {
+    const recordings = program.command("recordings").description("cloud recording assets and verified local archives");
+    label(recordings
+        .command("list")
+        .description("list cloud recording occurrences (last 30 days by default)")
+        .option("--from <date>", "first YYYY-MM-DD date")
+        .option("--to <date>", "last YYYY-MM-DD date")
+        .action(async (options) => {
+        deps.api();
+        const to = options.to ?? new Date(deps.now()).toISOString().slice(0, 10);
+        const end = Date.parse(`${to}T00:00:00Z`);
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(to) || !Number.isFinite(end) || new Date(end).toISOString().slice(0, 10) !== to)
+            throw new ZoomError("validation_error", "to must be a real YYYY-MM-DD date");
+        const from = options.from ?? new Date(end - 30 * 86400000).toISOString().slice(0, 10);
+        deps.output(listed(await deps.recordings().list({ from, to, signal: deps.signal() })));
+    }), "zm recordings list --from 2026-10-01 --to 2026-10-10 --json");
+    label(recordings
+        .command("sync")
+        .description("serial monthly recording archive synchronization with completed JSONL receipts")
+        .requiredOption("--from <date>", "first YYYY-MM-DD date")
+        .requiredOption("--to <date>", "last YYYY-MM-DD date (at most ten years)")
+        .requiredOption("--destination <directory>", "explicit archive directory")
+        .option("--max-bytes <bytes>", "maximum bytes per recording file", positive)
+        .action(async (options) => {
+        if (!program.opts().jsonl && !deps.outputIsTTY)
+            throw new ZoomError("validation_error", "headless recording sync requires --jsonl");
+        if (program.opts().json)
+            throw new ZoomError("validation_error", "recording sync streams receipts; use --jsonl");
+        deps.api();
+        for await (const receipt of syncRecordingArchive(deps.recordings(), { ...options, signal: deps.signal() }))
+            await deps.receipt(receipt);
+    }), "zm recordings sync --from 2026-01-01 --to 2026-10-10 --destination ./archive --jsonl", "local");
+    label(recordings
+        .command("show")
+        .description("show downloadable asset metadata without signed URLs")
+        .argument("<meeting>", "meeting id or occurrence UUID")
+        .action(async (id) => {
+        deps.api();
+        deps.output(await deps.recordings().show(id, { signal: deps.signal() }));
+    }), "zm recordings show example-occurrence --json");
+    label(recordings
+        .command("download")
+        .description("stream recording assets into a verified local archive")
+        .argument("<meeting>", "meeting id or occurrence UUID")
+        .requiredOption("--destination <directory>", "explicit archive directory")
+        .option("--file-ids <ids>", "comma-separated recording file ids")
+        .option("--max-bytes <bytes>", "per-file download byte limit (default 20 GiB)", positive)
+        .action(async (id, options) => {
+        deps.api();
+        deps.output(await deps.recordings().download(id, {
+            destination: options.destination,
+            fileIds: options.fileIds?.split(",").map((one) => one.trim()),
+            maxBytes: options.maxBytes,
+            signal: deps.signal(),
+        }));
+    }), "zm recordings download example-occurrence --destination ./zoom-archive --json", "local");
+    const archive = recordings.command("archive").description("inspect archives without Zoom or a database");
+    const transcriptOptions = (command) => command
+        .option("--uuid <uuid>", "select an occurrence UUID")
+        .option("--file-ids <ids>", "select comma-separated transcript asset ids")
+        .option("--max-bytes <bytes>", "maximum VTT bytes per file (default 8 MiB)", positive);
+    const selected = (options) => ({
+        uuid: options.uuid,
+        fileIds: options.fileIds?.split(",").map((id) => id.trim()),
+        maxBytes: options.maxBytes,
+        signal: deps.signal(),
+    });
+    label(transcriptOptions(archive
+        .command("transcript")
+        .description("read checksum-verified local VTT cues without Zoom or a database")
+        .argument("<directory>")).action(async (directory, options) => {
+        await deps.outputItems(deps.transcripts.read(directory, selected(options)));
+    }), "zm recordings archive transcript ./zoom-archive --uuid example-occurrence --json");
+    label(transcriptOptions(archive
+        .command("search")
+        .description("literal normalized text search across verified local VTT cues")
+        .argument("<directory>")
+        .argument("<query>"))
+        .option("--limit <matches>", "maximum matches from 1 through 1000 (default 100)", positive)
+        .action(async (directory, query, options) => {
+        deps.output(await deps.transcripts.search(directory, query, { ...selected(options), limit: options.limit }));
+    }), 'zm recordings archive search ./zoom-archive "example plan" --limit 10 --json');
+    label(archive
+        .command("inspect")
+        .description("read local transfer manifests")
+        .argument("<directory>")
+        .action(async (directory) => deps.output(listed(await deps.archive.inspect(directory, { signal: deps.signal() })))), "zm recordings archive inspect ./zoom-archive --json");
+    label(archive
+        .command("verify")
+        .description("verify local file sizes and checksums")
+        .argument("<directory>")
+        .action(async (directory) => deps.output(listed(await deps.archive.verify(directory, { signal: deps.signal() })))), "zm recordings archive verify ./zoom-archive --json");
+    label(archive
+        .command("locks")
+        .description("inspect active, stale or foreign archive locks")
+        .argument("<directory>")
+        .action(async (directory) => deps.output(listed(await deps.archive.locks(directory, { signal: deps.signal() })))), "zm recordings archive locks ./zoom-archive --json");
+    label(archive
+        .command("recover")
+        .description("preview recovery of recognized stale local locks")
+        .argument("<directory>")
+        .option("--yes", "remove recognized locks left by a dead local process")
+        .option("--dry-run", "preview only, including when --yes is present")
+        .action(async (directory, options) => deps.output(await deps.archive.recover(directory, {
+        apply: options.yes === true && !options.dryRun,
+        signal: deps.signal(),
+    }))), "zm recordings archive recover ./zoom-archive --dry-run --json", "local");
+    const remote = program
+        .command("remote-meetings")
+        .description("upcoming Zoom meetings; stored meeting reads remain under meetings");
+    label(remote
+        .command("list")
+        .description("list upcoming meetings")
+        .action(async () => {
+        deps.api();
+        deps.output(listed(await deps.remoteMeetings().list({ signal: deps.signal() })));
+    }), "zm remote-meetings list --json");
+    label(remote
+        .command("show")
+        .description("show an upcoming meeting")
+        .argument("<meeting>", "positive numeric Zoom meeting id")
+        .action(async (id) => {
+        deps.api();
+        deps.output(await deps.remoteMeetings().show(id, { signal: deps.signal() }));
+    }), "zm remote-meetings show 123456789 --json");
+    label(remote
+        .command("invitation")
+        .description("read invitation text")
+        .argument("<meeting>", "positive numeric Zoom meeting id")
+        .action(async (id) => {
+        deps.api();
+        deps.output(await deps.remoteMeetings().invitation(id, { signal: deps.signal() }));
+    }), "zm remote-meetings invitation 123456789 --json");
+    label(changes(remote.command("create").description("preview a meeting creation; --yes performs it once")).action(async (options) => deps.output(await deps.remoteMeetings().create(change(options), mutation(options, deps)))), 'zm remote-meetings create --topic "Example planning" --start-time 2026-10-10T15:30:00Z --dry-run --json', "remote");
+    label(changes(remote
+        .command("update")
+        .description("preview a meeting update; --yes performs it once")
+        .argument("<meeting>", "positive numeric Zoom meeting id")).action(async (id, options) => deps.output(await deps.remoteMeetings().update(id, change(options), mutation(options, deps)))), 'zm remote-meetings update 123456789 --topic "Example planning" --dry-run --json', "remote");
+    label(remote
+        .command("cancel")
+        .description("preview a cancellation; --yes performs it once")
+        .argument("<meeting>", "positive numeric Zoom meeting id")
+        .option("--occurrence-id <id>", "cancel one recurring occurrence")
+        .option("--yes", "apply cancellation once instead of previewing")
+        .option("--dry-run", "preview only, including when --yes is present")
+        .action(async (id, options) => deps.output(await deps.remoteMeetings().cancel(id, mutation(options, deps)))), "zm remote-meetings cancel 123456789 --dry-run --json", "remote");
+};
+//# sourceMappingURL=archive-commands.js.map

package/dist/archive-commands.js.map

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

package/dist/archive-transcripts.d.ts

@@ -0,0 +1,33 @@
+import { type TranscriptLine } from "@wirecat/cli-meetings";
+import { type ArchivedFile, type ArchiveManifest } from "./recording-archive.js";
+export interface ArchiveTranscriptOptions {
+    uuid?: string;
+    fileIds?: string[];
+    maxBytes?: number;
+    signal?: AbortSignal;
+}
+export interface ArchiveTranscript {
+    meeting: ArchiveManifest["meeting"];
+    asset: ArchivedFile;
+    cues: TranscriptLine[];
+}
+export interface ArchiveTranscriptSearchOptions extends ArchiveTranscriptOptions {
+    limit?: number;
+}
+export interface ArchiveTranscriptMatch extends TranscriptLine {
+    meeting: ArchiveManifest["meeting"];
+    asset: ArchivedFile;
+    /** Zero-based cue position in this asset, retaining the shared parser's file order. */
+    position: number;
+}
+export interface ArchiveTranscriptSearchReport {
+    items: ArchiveTranscriptMatch[];
+    page: 1;
+    limit: number;
+    hasMore: boolean;
+}
+/** Verified, bounded VTT assets in manifest/file order; each handle closes before its result is yielded. */
+export declare function readArchiveTranscripts(destination: string, options?: ArchiveTranscriptOptions): AsyncGenerator<ArchiveTranscript, void, void>;
+/** Literal text-only matching using NFC normalization and Unicode default lowercase on both sides. */
+export declare const searchArchiveTranscripts: (destination: string, query: string, options?: ArchiveTranscriptSearchOptions) => Promise<ArchiveTranscriptSearchReport>;
+//# sourceMappingURL=archive-transcripts.d.ts.map

package/dist/archive-transcripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-transcripts.d.ts","sourceRoot":"","sources":["../src/archive-transcripts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAErE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAkB,MAAM,wBAAwB,CAAA;AAEhG,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AACD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,cAAc,EAAE,CAAA;CACvB;AACD,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AACD,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,KAAK,EAAE,YAAY,CAAA;IACnB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAA;CACjB;AACD,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,sBAAsB,EAAE,CAAA;IAC/B,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB;AA6ED,4GAA4G;AAC5G,wBAAuB,sBAAsB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,wBAA6B,GACrC,cAAc,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,CA2B/C;AAED,sGAAsG;AACtG,eAAO,MAAM,wBAAwB,gBACtB,MAAM,SACZ,MAAM,YACJ,8BAA8B,KACtC,OAAO,CAAC,6BAA6B,CAiBvC,CAAA"}

package/dist/archive-transcripts.js

@@ -0,0 +1,131 @@
+import { createHash } from "node:crypto";
+import { constants } from "node:fs";
+import { open, realpath } from "node:fs/promises";
+import { join } from "node:path";
+import { parseVtt } from "@wirecat/cli-meetings";
+import { checkCancelled, ZoomError } from "./errors.js";
+import { inspectArchive } from "./recording-archive.js";
+const validate = (destination, options) => {
+    const maxBytes = options.maxBytes === undefined ? 8 * 1024 ** 2 : options.maxBytes;
+    if (typeof destination !== "string" || !destination.trim() || !Number.isSafeInteger(maxBytes) || maxBytes <= 0)
+        throw new ZoomError("validation_error", "archive destination and positive transcript byte limit are required");
+    if (options.uuid !== undefined && (typeof options.uuid !== "string" || !options.uuid.trim()))
+        throw new ZoomError("validation_error", "archive occurrence UUID must be nonempty");
+    if (options.fileIds !== undefined &&
+        (!Array.isArray(options.fileIds) ||
+            options.fileIds.length === 0 ||
+            options.fileIds.some((id) => typeof id !== "string" || !id.trim())))
+        throw new ZoomError("validation_error", "archive transcript selection must contain nonempty file ids");
+    return maxBytes;
+};
+const readTranscript = async (destination, asset, maxBytes, signal) => {
+    checkCancelled(signal);
+    if (asset.size > maxBytes)
+        throw new ZoomError("validation_error", "archive transcript exceeds the byte limit");
+    try {
+        const file = await open(join(destination, asset.path), constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        try {
+            checkCancelled(signal);
+            const stat = await file.stat();
+            if (!stat.isFile())
+                throw new ZoomError("validation_error", "archive transcript must be an ordinary file");
+            if (stat.size > maxBytes)
+                throw new ZoomError("validation_error", "archive transcript exceeds the byte limit");
+            if (stat.size !== asset.size)
+                throw new ZoomError("validation_error", "archive transcript failed size verification");
+            const hash = createHash("sha256");
+            const chunks = [];
+            let size = 0;
+            for (;;) {
+                checkCancelled(signal);
+                const buffer = Buffer.alloc(Math.min(65536, maxBytes - size + 1));
+                const { bytesRead } = await file.read(buffer, 0, buffer.length, null);
+                checkCancelled(signal);
+                if (bytesRead === 0)
+                    break;
+                size += bytesRead;
+                if (size > maxBytes)
+                    throw new ZoomError("validation_error", "archive transcript exceeds the byte limit");
+                const chunk = buffer.subarray(0, bytesRead);
+                hash.update(chunk);
+                chunks.push(chunk);
+            }
+            if (size !== asset.size || hash.digest("hex") !== asset.sha256)
+                throw new ZoomError("validation_error", "archive transcript failed checksum verification");
+            let text;
+            try {
+                text = new TextDecoder("utf-8", { fatal: true }).decode(Buffer.concat(chunks, size));
+            }
+            catch {
+                throw new ZoomError("validation_error", "archive transcript is not valid UTF-8");
+            }
+            try {
+                return parseVtt(text);
+            }
+            catch {
+                throw new ZoomError("validation_error", "archive transcript is not valid WebVTT");
+            }
+        }
+        finally {
+            await file.close();
+        }
+    }
+    catch (error) {
+        checkCancelled(signal);
+        if (error instanceof ZoomError)
+            throw error;
+        const code = typeof error === "object" && error !== null && "code" in error ? error.code : null;
+        if (code === "ENOENT")
+            throw new ZoomError("not_found", "archive transcript file was not found");
+        if (code === "ELOOP")
+            throw new ZoomError("validation_error", "archive transcript must not be a symlink");
+        throw new ZoomError("configuration_error", "archive transcript could not be read");
+    }
+};
+/** Verified, bounded VTT assets in manifest/file order; each handle closes before its result is yielded. */
+export async function* readArchiveTranscripts(destination, options = {}) {
+    const maxBytes = validate(destination, options);
+    checkCancelled(options.signal);
+    let root;
+    try {
+        root = await realpath(destination);
+    }
+    catch {
+        checkCancelled(options.signal);
+        throw new ZoomError("configuration_error", "archive destination could not be read");
+    }
+    const manifests = await inspectArchive(root, { signal: options.signal });
+    const selected = options.uuid === undefined ? manifests : manifests.filter((item) => item.meeting.uuid === options.uuid);
+    if (options.uuid !== undefined && selected.length === 0)
+        throw new ZoomError("not_found", "archive occurrence UUID was not found");
+    const transcripts = selected.flatMap((manifest) => manifest.files.filter((asset) => asset.format?.toLowerCase() === "vtt").map((asset) => ({ manifest, asset })));
+    if (options.fileIds?.some((id) => !transcripts.some((item) => item.asset.id === id)))
+        throw new ZoomError("not_found", "selected archive VTT file id was not found");
+    for (const { manifest, asset } of transcripts) {
+        checkCancelled(options.signal);
+        if (options.fileIds && !options.fileIds.includes(asset.id))
+            continue;
+        const cues = await readTranscript(root, asset, maxBytes, options.signal);
+        checkCancelled(options.signal);
+        yield { meeting: manifest.meeting, asset, cues };
+    }
+}
+/** Literal text-only matching using NFC normalization and Unicode default lowercase on both sides. */
+export const searchArchiveTranscripts = async (destination, query, options = {}) => {
+    const limit = options.limit === undefined ? 100 : options.limit;
+    if (typeof query !== "string" || !query.trim() || !Number.isSafeInteger(limit) || limit < 1 || limit > 1000)
+        throw new ZoomError("validation_error", "archive search requires nonempty text and an integer limit from 1 through 1000");
+    const needle = query.normalize("NFC").toLowerCase();
+    const matches = [];
+    for await (const transcript of readArchiveTranscripts(destination, options))
+        for (const [position, cue] of transcript.cues.entries()) {
+            checkCancelled(options.signal);
+            if (!cue.text.normalize("NFC").toLowerCase().includes(needle))
+                continue;
+            if (matches.length === limit)
+                return { items: matches, page: 1, limit, hasMore: true };
+            matches.push({ meeting: transcript.meeting, asset: transcript.asset, position, ...cue });
+        }
+    return { items: matches, page: 1, limit, hasMore: false };
+};
+//# sourceMappingURL=archive-transcripts.js.map

package/dist/archive-transcripts.js.map

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

package/dist/bin/zm.js

@@ -2,13 +2,35 @@
 import { spawn } from "node:child_process";
 import { join } from "node:path";
 import { createInterface } from "node:readline/promises";
-import { resolvePaths, systemKeyring } from "@wirecat/cli-core";
-import { readConfig } from "../config.js";
+import { CliError, resolvePaths, systemKeyring } from "@wirecat/cli-core";
+import { profileAccountKey, readConfig } from "../config.js";
+import { ZoomError } from "../errors.js";
+import { writeExportFile } from "../output-file.js";
 import { run } from "../program.js";
+import { createStoreConnector } from "../store-connection.js";
+import { writeStream } from "../streaming.js";
 import { TokenManager } from "../tokens.js";
 const paths = resolvePaths({ appName: "zm", env: process.env });
 const configPath = join(paths.config, "config.json");
+const cancellation = new AbortController();
+let brokenPipe = false;
+const cancel = () => cancellation.abort(new CliError("cancelled", "command cancelled"));
+const onPipeError = (error) => {
+    if (error.code === "EPIPE") {
+        brokenPipe = true;
+        cancellation.abort(new CliError("cancelled", "output pipe closed"));
+        process.exitCode = 0;
+    }
+    else {
+        cancellation.abort(new CliError("configuration_error", "could not write command output"));
+        process.exitCode = 3;
+    }
+};
+process.once("SIGINT", cancel);
+process.once("SIGTERM", cancel);
+process.stdout.on("error", onPipeError);
 try {
+    const connectStore = createStoreConnector({ env: process.env });
     const tokens = new TokenManager({
         get clientId() {
             return readConfig(configPath).clientId ?? "";
@@ -20,9 +42,31 @@ try {
     process.exitCode = await run(process.argv.slice(2), {
         configPath,
         tokens,
+        connectStore,
+        serveMcp: async (options) => {
+            const { serveMeetingMcp } = await import("../mcp-server.js");
+            await serveMeetingMcp({
+                ...options,
+                connectStore: async () => {
+                    const profile = readConfig(configPath).accountProfile;
+                    if (!profile)
+                        throw new ZoomError("configuration_error", "select a local profile with zm config set account.profile <label>");
+                    return connectStore({ profile, externalId: profileAccountKey(profile), intent: "read" });
+                },
+            });
+        },
         fetch,
+        interactive: Boolean(process.stdin.isTTY),
+        outputIsTTY: Boolean(process.stdout.isTTY),
+        env: process.env,
+        signal: cancellation.signal,
+        writeFile: writeExportFile,
+        streamData: (text, signal) => writeStream(process.stdout, text, signal),
         data: (text) => process.stdout.write(text),
-        diagnostic: (text) => process.stderr.write(text),
+        diagnostic: (text) => {
+            if (!brokenPipe)
+                process.stderr.write(text);
+        },
         openBrowser: (url, browser = "xdg-open") => new Promise((resolve, reject) => {
             const child = spawn(browser, [url], { detached: true, stdio: "ignore" });
             child.once("error", reject);
@@ -48,4 +92,10 @@ catch {
     process.stderr.write(`${JSON.stringify({ error: { code: "configuration_error", message: "could not load zm configuration" } })}\n`);
     process.exitCode = 3;
 }
+finally {
+    process.removeListener("SIGINT", cancel);
+    process.removeListener("SIGTERM", cancel);
+    if (brokenPipe)
+        process.exitCode = 0;
+}
 //# sourceMappingURL=zm.js.map

package/dist/bin/zm.js.map

@@ -1 +1 @@
-{"version":3,"file":"zm.js","sourceRoot":"","sources":["../../src/bin/zm.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;AACpD,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,IAAI,QAAQ;YACV,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAA;QAC9C,CAAC;QACD,OAAO,EAAE,aAAa;QACtB,OAAO,EAAE,YAAY,KAAK,CAAC,MAAM,EAAE;QACnC,KAAK;KACN,CAAC,CAAA;IACF,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAClD,UAAU;QACV,MAAM;QACN,KAAK;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAC1C,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAChD,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,EAAE,CACzC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;YACxE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,KAAK,CAAC,KAAK,EAAE,CAAA;gBACb,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC;QACJ,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;YAC5B,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBACf,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;gBAC/E,IAAI,CAAC;oBACH,OAAO,MAAM,KAAK,CAAC,QAAQ,CAAC,gEAAgE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC3G,CAAC;wBAAS,CAAC;oBACT,KAAK,CAAC,KAAK,EAAE,CAAA;gBACf,CAAC;YACH,CAAC;YACH,CAAC,CAAC,SAAS;KACd,CAAC,CAAA;AACJ,CAAC;AAAC,MAAM,CAAC;IACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,iCAAiC,EAAE,EAAE,CAAC,IAAI,CAC9G,CAAA;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC"}
+{"version":3,"file":"zm.js","sourceRoot":"","sources":["../../src/bin/zm.ts"],"names":[],"mappings":"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"}

package/dist/commands.d.ts

@@ -0,0 +1,12 @@
+import type { Command } from "commander";
+export interface StandardCommandsDeps {
+    output: (value: unknown) => void;
+    discovery: (value: unknown) => void;
+    fields: () => readonly string[] | undefined;
+    raw: (text: string) => void;
+    doctor: () => unknown;
+    sessionStatus: (check: boolean) => Promise<unknown>;
+}
+export declare const addStandardCommands: (program: Command, deps: StandardCommandsDeps) => void;
+export declare const annotateMeetingCommands: (program: Command) => void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAChC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACnC,MAAM,EAAE,MAAM,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC3C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAA;IACrB,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACpD;AACD,eAAO,MAAM,mBAAmB,YAAa,OAAO,QAAQ,oBAAoB,KAAG,IAqDlF,CAAA;AAED,eAAO,MAAM,uBAAuB,YAAa,OAAO,KAAG,IAkB1D,CAAA"}

package/dist/commands.js

@@ -0,0 +1,96 @@
+import { projectFields } from "@wirecat/cli-core";
+import { annotate, describeOptions, describeProgram, flatten, metaOf, } from "@wirecat/cli-core/commands";
+import { formatSuggestions, suggest } from "@wirecat/cli-core/completion";
+import { ZoomError } from "./errors.js";
+export const addStandardCommands = (program, deps) => {
+    annotate(program
+        .command("commands")
+        .description("discover commands, flags and examples, optionally scoped to a command path")
+        .argument("[path...]", "resource or command path")
+        .action((path) => {
+        const all = describeProgram(program);
+        const scoped = path.length ? flatten(all).filter((item) => item.path.join(" ") === path.join(" ")) : all;
+        if (path.length && !scoped.length)
+            throw new ZoomError("validation_error", "unknown command path; use zm commands --json");
+        const fields = deps.fields();
+        deps.discovery({
+            commands: fields ? projectDiscovery(scoped, fields) : scoped,
+            options: describeOptions(program),
+        });
+    }), { mutates: false, examples: ["zm commands --json"] });
+    annotate(program
+        .command("complete")
+        .description("answer shell completion requests")
+        .argument("[words...]", "shell words ending in the partial word")
+        .action((words) => {
+        const suggestions = suggest({
+            commands: describeProgram(program),
+            globalOptions: describeOptions(program),
+            words,
+        });
+        if (program.opts().json || program.opts().jsonl)
+            deps.output({ items: suggestions });
+        else
+            deps.raw(`${formatSuggestions(suggestions)}\n`);
+    }), { mutates: false, examples: ["zm complete -- meetings s"] });
+    annotate(program
+        .command("doctor")
+        .description("check local runtime and public config without a login or database")
+        .action(() => deps.output(deps.doctor())), { mutates: false, examples: ["zm doctor --json"] });
+    const session = program
+        .command("session")
+        .description("inspect the saved OAuth session separately from local data profiles");
+    annotate(session
+        .command("status")
+        .description("show cached login state; remote verification is explicit")
+        .option("--check", "verify the session with Zoom")
+        .action(async (options) => deps.output(await deps.sessionStatus(options.check === true))), { mutates: false, examples: ["zm session status --json", "zm session status --check --json"] });
+};
+export const annotateMeetingCommands = (program) => {
+    for (const item of flatten(describeProgram(program))) {
+        let command = program;
+        for (const part of item.path) {
+            const found = command.commands.find((child) => child.name() === part);
+            if (found)
+                command = found;
+        }
+        if (command.commands.length)
+            continue;
+        const path = item.path.join(" ");
+        const knownLocal = ["config set", "login", "pull", "import", "meetings export"].includes(path);
+        const mutates = knownLocal || metaOf(command).mutates === true;
+        annotate(command, {
+            origin: "handwritten",
+            mutates,
+            ...(knownLocal ? { local: true } : {}),
+            ...(item.examples ? {} : { examples: [exampleFor(path)] }),
+        });
+    }
+};
+const exampleFor = (path) => {
+    if (path === "serve")
+        return "zm serve --mcp";
+    if (path === "login")
+        return "zm login --interactive";
+    const argumentsByPath = {
+        "config set": "account.profile personal",
+        "meetings show": "1",
+        "meetings transcript": "1",
+        "meetings summary": "1",
+        "meetings export": "1 --format markdown",
+        "meetings search": '"example plan"',
+        "meetings people": '"Alice Example"',
+        import: "./downloaded-transcripts",
+    };
+    return `zm ${path}${argumentsByPath[path] ? ` ${argumentsByPath[path]}` : ""} --json`;
+};
+const projectDiscovery = (commands, fields) => commands.map((command) => ({
+    ...projectFields(command, fields),
+    path: command.path,
+    name: command.name,
+    origin: command.origin,
+    mutates: command.mutates,
+    local: command.local,
+    commands: projectDiscovery(command.commands, fields),
+}));
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/errors.d.ts

@@ -1,7 +1,8 @@
-export declare class ZoomError extends Error {
-    readonly code: "configuration_error" | "authentication_error" | "validation_error" | "provider_error" | "invalid_response";
-    constructor(code: "configuration_error" | "authentication_error" | "validation_error" | "provider_error" | "invalid_response", message: string);
+import { CliError, type ErrorCode } from "@wirecat/cli-core";
+export declare class ZoomError extends CliError {
+    constructor(code: ErrorCode, message: string);
 }
+export declare const checkCancelled: (signal?: AbortSignal) => void;
 export declare const object: (value: unknown) => Record<string, unknown>;
 export declare const string: (value: unknown) => string | null;
 export declare const number: (value: unknown) => number | null;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;IAEhC,QAAQ,CAAC,IAAI,EACT,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB;IANxB,YACW,IAAI,EACT,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,EACtB,OAAO,EAAE,MAAM,EAGhB;CACF;AACD,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAI7D,CAAA;AACD,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAAM,GAAG,IAAkE,CAAA;AACnH,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAAM,GAAG,IACmB,CAAA"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE5D,qBAAa,SAAU,SAAQ,QAAQ;IACrC,YAAY,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAE3C;CACF;AACD,eAAO,MAAM,cAAc,YAAa,WAAW,KAAG,IAKrD,CAAA;AACD,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAI7D,CAAA;AACD,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAAM,GAAG,IAAkE,CAAA;AACnH,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,MAAM,GAAG,IACmB,CAAA"}