@wirecat/zoom-cli 0.2.2 → 0.3.0

package/dist/meeting-semantic-commands.js

@@ -0,0 +1,98 @@
+import { annotate } from "@wirecat/cli-core/commands";
+import { ZoomError } from "./errors.js";
+import { bytes } from "./execution.js";
+const bounded = (value, maximum) => value === undefined || (Number.isSafeInteger(value) && value > 0 && value <= maximum);
+export const validateMeetingModel = (options) => {
+    if (typeof options.model !== "string" || !options.model.trim() || options.model.length > 1000)
+        throw new ZoomError("validation_error", "select an explicit embedding model");
+    if (options.baseUrl === undefined) {
+        if (options.dims !== undefined)
+            throw new ZoomError("validation_error", "dimensions require an explicit remote base URL");
+        return;
+    }
+    let url;
+    try {
+        url = new URL(options.baseUrl);
+    }
+    catch {
+        throw new ZoomError("validation_error", "embedding base URL must be an HTTP or HTTPS URL");
+    }
+    if (!["http:", "https:"].includes(url.protocol) ||
+        url.username ||
+        url.password ||
+        url.search ||
+        url.hash ||
+        !/^[\w./:-]{1,200}$/.test(options.model) ||
+        options.dims === undefined ||
+        !bounded(options.dims, 8192))
+        throw new ZoomError("validation_error", "remote embeddings require an HTTP base URL without credentials and explicit dimensions");
+};
+export const validateMeetingSemantic = (query, options) => {
+    validateMeetingModel(options);
+    if (typeof query !== "string" ||
+        !query.trim() ||
+        Buffer.byteLength(query, "utf8") > 65536 ||
+        !bounded(options.limit, 1000) ||
+        !bounded(options.maxChunks, 10000) ||
+        !bounded(options.afterChunkId, Number.MAX_SAFE_INTEGER) ||
+        !bounded(options.maxRows, 100000) ||
+        !bounded(options.maxTextBytes, 64 * 1024 * 1024))
+        throw new ZoomError("validation_error", "meeting semantic search requires a nonempty bounded query and positive limits");
+};
+export const validateMeetingEmbeddings = (options) => {
+    validateMeetingModel(options);
+    if (!bounded(options.limit, 1000) ||
+        !bounded(options.afterTranscriptId, Number.MAX_SAFE_INTEGER) ||
+        !bounded(options.maxRows, 100000) ||
+        !bounded(options.maxTextBytes, 64 * 1024 * 1024) ||
+        (options.afterHash !== undefined && !/^[a-f0-9]{64}$/.test(options.afterHash)))
+        throw new ZoomError("validation_error", "meeting embedding generation requires valid bounded limits and cursors");
+};
+export const addMeetingSemanticCommands = (program, deps) => {
+    const meetings = program.commands.find((command) => command.name() === "meetings");
+    if (!meetings)
+        throw new ZoomError("configuration_error", "meeting command group is unavailable");
+    const model = (command) => command
+        .requiredOption("--model <id>", "explicit installed local model ID, or model served at --base-url")
+        .option("--base-url <url>", "explicit remote endpoint; OpenAI uses OPENAI_API_KEY")
+        .option("--dims <count>", "remote embedding vector dimensions", bytes);
+    const budget = (command) => command
+        .option("--limit <count>", "bounded batch/result count from 1 through 1000", bytes)
+        .option("--max-rows <count>", "transcript cue read limit from 1 through 100000", bytes)
+        .option("--max-text-bytes <count>", "aggregate transcript text read byte limit (default 4 MiB)", bytes);
+    annotate(budget(model(meetings
+        .command("semantic")
+        .description("search stored meeting vectors with an explicit query model; ranks only scanned candidates")
+        .argument("<query>")))
+        .option("--max-chunks <count>", "embedded candidate scan bound", bytes)
+        .option("--after-chunk-id <id>", "candidate scan continuation; not globally ranked result pagination", bytes)
+        .action(async (query, options) => {
+        validateMeetingSemantic(query, options);
+        if (options.baseUrl !== undefined && deps.offline())
+            throw new ZoomError("configuration_error", "remote embeddings require network access; remove --offline");
+        const api = await deps.capabilities();
+        deps.output(await api.search(query, { ...options, signal: deps.signal() }));
+    }), {
+        origin: "handwritten",
+        mutates: false,
+        examples: ['zm meetings semantic "example plan" --model e5-small --json'],
+    });
+    annotate(budget(model(meetings
+        .command("embeddings")
+        .description("preview meeting vector generation; --yes explicitly rebuilds and embeds one bounded batch")))
+        .option("--after-transcript-id <id>", "transcript chunk rebuild continuation", bytes)
+        .option("--after-hash <hash>", "missing embedding batch continuation")
+        .option("--yes", "apply chunk rebuild and embedding generation; preview otherwise")
+        .action(async (options) => {
+        validateMeetingEmbeddings(options);
+        if (options.baseUrl !== undefined && deps.offline())
+            throw new ZoomError("configuration_error", "remote embeddings require network access; remove --offline");
+        const api = await deps.capabilities();
+        const result = await api.generate({ ...options, signal: deps.signal() });
+        if (options.yes)
+            await deps.receipt(result);
+        else
+            deps.output(result);
+    }), { origin: "handwritten", mutates: true, local: true, examples: ["zm meetings embeddings --model e5-small --json"] });
+};
+//# sourceMappingURL=meeting-semantic-commands.js.map

package/dist/meeting-semantic-commands.js.map

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

package/dist/meeting-semantic.d.ts

@@ -0,0 +1,10 @@
+import type { MeetingVectors } from "@wirecat/cli-messaging/store";
+import { type MeetingSemanticCapabilities } from "./meeting-semantic-commands.js";
+type ProducerSemanticApi = Pick<typeof import("@wirecat/cli-messaging/services"), "meetingEmbeddingModel" | "createMeetingRemoteModel" | "openMeetingEmbedder" | "readMeetingSemantic" | "proposeMeetingEmbedding" | "applyMeetingEmbedding">;
+/** The connection selects the account; explicit command options select the model. */
+export declare const createMeetingSemanticCapabilities: (vectors: MeetingVectors, accountId: number, options?: {
+    env?: NodeJS.ProcessEnv;
+    load?: () => Promise<ProducerSemanticApi>;
+}) => MeetingSemanticCapabilities;
+export {};
+//# sourceMappingURL=meeting-semantic.d.ts.map

package/dist/meeting-semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meeting-semantic.d.ts","sourceRoot":"","sources":["../src/meeting-semantic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAElE,OAAO,EAGL,KAAK,2BAA2B,EAGjC,MAAM,gCAAgC,CAAA;AAEvC,KAAK,mBAAmB,GAAG,IAAI,CAC7B,cAAc,iCAAiC,CAAC,EAC9C,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,qBAAqB,GACrB,yBAAyB,GACzB,uBAAuB,CAC1B,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,iCAAiC,YACnC,cAAc,aACZ,MAAM,YACR;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAA;CAAE,KAC9E,2BA+DF,CAAA"}

package/dist/meeting-semantic.js

@@ -0,0 +1,70 @@
+import { checkCancelled, ZoomError } from "./errors.js";
+import { validateMeetingEmbeddings, validateMeetingSemantic, } from "./meeting-semantic-commands.js";
+const loadProducer = async () => import("@wirecat/cli-messaging/services");
+/** The connection selects the account; explicit command options select the model. */
+export const createMeetingSemanticCapabilities = (vectors, accountId, options = {}) => {
+    if (!Number.isSafeInteger(accountId) || accountId < 1)
+        throw new ZoomError("validation_error", "meeting vectors require a selected positive account ID");
+    const load = options.load ?? loadProducer;
+    const choice = (api, input) => input.baseUrl === undefined
+        ? input.model
+        : { remote: api.createMeetingRemoteModel({ model: input.model, baseUrl: input.baseUrl, dims: input.dims }) };
+    return {
+        search: async (query, input) => {
+            validateMeetingSemantic(query, input);
+            checkCancelled(input.signal);
+            const api = await load();
+            checkCancelled(input.signal);
+            const selected = choice(api, input);
+            const embedder = await api.openMeetingEmbedder(selected, { env: options.env, signal: input.signal });
+            try {
+                return await api.readMeetingSemantic(vectors, accountId, query, embedder, {
+                    limit: input.limit,
+                    maxChunks: input.maxChunks,
+                    afterChunkId: input.afterChunkId,
+                    maxRows: input.maxRows,
+                    maxTextBytes: input.maxTextBytes,
+                    signal: input.signal,
+                });
+            }
+            finally {
+                await embedder.close();
+            }
+        },
+        generate: async (input) => {
+            validateMeetingEmbeddings(input);
+            checkCancelled(input.signal);
+            const api = await load();
+            checkCancelled(input.signal);
+            const selected = choice(api, input);
+            const descriptor = api.meetingEmbeddingModel(selected);
+            if (input.yes !== true)
+                return api.proposeMeetingEmbedding(vectors, accountId, descriptor, { signal: input.signal });
+            const embedder = await api.openMeetingEmbedder(selected, { env: options.env, signal: input.signal });
+            try {
+                checkCancelled(input.signal);
+                const rebuild = await vectors.rebuild({
+                    accountId,
+                    limit: input.limit,
+                    afterTranscriptId: input.afterTranscriptId,
+                    maxRows: input.maxRows,
+                    maxTextBytes: input.maxTextBytes,
+                    signal: input.signal,
+                });
+                checkCancelled(input.signal);
+                const result = await api.applyMeetingEmbedding(vectors, accountId, embedder, {
+                    maxChunks: input.limit,
+                    afterHash: input.afterHash,
+                    maxRows: input.maxRows,
+                    maxTextBytes: input.maxTextBytes,
+                    signal: input.signal,
+                });
+                return { ...result, applied: true, model: descriptor, rebuild };
+            }
+            finally {
+                await embedder.close();
+            }
+        },
+    };
+};
+//# sourceMappingURL=meeting-semantic.js.map

package/dist/meeting-semantic.js.map

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

package/dist/ordinary-file.d.ts

@@ -0,0 +1,4 @@
+import { type FileHandle } from "node:fs/promises";
+/** Check the opened object before reading: Windows has no O_NOFOLLOW support. */
+export declare const openOrdinaryFile: (path: string) => Promise<FileHandle>;
+//# sourceMappingURL=ordinary-file.d.ts.map

package/dist/ordinary-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinary-file.d.ts","sourceRoot":"","sources":["../src/ordinary-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,kBAAkB,CAAA;AAM/D,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,SAAgB,MAAM,KAAG,OAAO,CAAC,UAAU,CA0CvE,CAAA"}

package/dist/ordinary-file.js

@@ -0,0 +1,51 @@
+import { constants } from "node:fs";
+import { lstat, open } from "node:fs/promises";
+import { ZoomError } from "./errors.js";
+// Node 22's Windows path stat uses a 64-bit volume serial; handle stat uses its low DWORD.
+const deviceOf = (dev) => (process.platform === "win32" ? BigInt.asUintN(32, dev) : dev);
+/** Check the opened object before reading: Windows has no O_NOFOLLOW support. */
+export const openOrdinaryFile = async (path) => {
+    const before = await lstat(path, { bigint: true });
+    if (before.isSymbolicLink())
+        throw new ZoomError("validation_error", "archive path must be an ordinary file without a symlink");
+    if (!before.isFile())
+        throw new ZoomError("validation_error", "archive path must be an ordinary file");
+    const flags = process.platform === "win32"
+        ? constants.O_RDONLY
+        : constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0);
+    const file = await open(path, flags);
+    try {
+        const opened = await file.stat({ bigint: true });
+        const after = await lstat(path, { bigint: true });
+        if (!opened.isFile() || !after.isFile() || before.ino !== opened.ino || before.ino !== after.ino)
+            throw new ZoomError("validation_error", "archive file changed while opening");
+        if (process.platform === "win32" && before.dev === 0n && after.dev === 0n) {
+            // Older Windows path stats omit the device; compare two handles before any content read.
+            const witness = await open(path, flags);
+            try {
+                const identified = await witness.stat({ bigint: true });
+                const final = await lstat(path, { bigint: true });
+                if (opened.dev === 0n ||
+                    !identified.isFile() ||
+                    !final.isFile() ||
+                    deviceOf(identified.dev) !== deviceOf(opened.dev) ||
+                    identified.ino !== opened.ino ||
+                    final.ino !== before.ino ||
+                    (final.dev !== 0n && deviceOf(final.dev) !== deviceOf(opened.dev)))
+                    throw new ZoomError("validation_error", "archive file changed while opening");
+            }
+            finally {
+                await witness.close();
+            }
+        }
+        else if (deviceOf(before.dev) !== deviceOf(opened.dev) || deviceOf(before.dev) !== deviceOf(after.dev)) {
+            throw new ZoomError("validation_error", "archive file changed while opening");
+        }
+        return file;
+    }
+    catch (error) {
+        await file.close();
+        throw error;
+    }
+};
+//# sourceMappingURL=ordinary-file.js.map

package/dist/ordinary-file.js.map

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

package/dist/program.d.ts

@@ -1,18 +1,26 @@
 import { type SleepLike } from "@wirecat/cli-core";
-import { type MeetingSource, type MeetingStore } from "@wirecat/cli-meetings";
+import { type MeetingSource, type MeetingStore, type MeetingTranscriptStore } from "@wirecat/cli-meetings";
 import { Command } from "commander";
 import { type ArchiveService, type ArchiveTranscriptService, type RecordingsService, type RemoteMeetingsService } from "./archive-commands.js";
 import { readDownloadedFiles } from "./files.js";
+import type { MeetingContextCapabilities } from "./meeting-context.js";
+import { type MeetingModelOptions, type MeetingSemanticCapabilities } from "./meeting-semantic-commands.js";
 import type { TokenManager } from "./tokens.js";
+import { type UnifiedSearch } from "./unified-search.js";
 export interface StoreConnection {
     store: MeetingStore;
     accountId: number;
     close: () => Promise<void>;
+    appendTranscripts?: MeetingTranscriptStore["appendTranscripts"];
+    unifiedSearch?: UnifiedSearch;
+    meetingContext?: MeetingContextCapabilities;
+    meetingSemantic?: MeetingSemanticCapabilities;
 }
 export interface StoreConnectRequest {
     profile: string;
     externalId: string;
     intent: "read" | "ingestion";
+    capability?: "transcript-append";
 }
 export interface ProgramDeps {
     configPath: string;
@@ -21,6 +29,10 @@ export interface ProgramDeps {
     store?: MeetingStore;
     accountId?: number;
     connectStore?: (request: StoreConnectRequest) => Promise<StoreConnection>;
+    transcriptStore?: MeetingTranscriptStore;
+    unifiedSearch?: UnifiedSearch;
+    meetingContext?: MeetingContextCapabilities;
+    meetingSemantic?: MeetingSemanticCapabilities;
     source?: MeetingSource;
     recordings?: RecordingsService;
     remoteMeetings?: RemoteMeetingsService;
@@ -46,6 +58,9 @@ export interface ProgramDeps {
     serveMcp?: (options: {
         signal: AbortSignal;
         maxResultBytes?: number;
+        includeUnifiedSearch?: boolean;
+        includeMeetingContext?: boolean;
+        semanticModel?: MeetingModelOptions;
     }) => Promise<void>;
     streamData?: (text: string, signal: AbortSignal) => Promise<void>;
 }

package/dist/program.d.ts.map

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

package/dist/program.js

@@ -1,20 +1,25 @@
 import { CliError, createDeadline, createRenderer, exitCodeFor, fieldsOf, GENERIC_FAILURE, projectFields, realSleep, } from "@wirecat/cli-core";
-import { importFiles, listed, MeetingError, pull } from "@wirecat/cli-meetings";
+import { importFiles, listed, MeetingError, pull, } from "@wirecat/cli-meetings";
 import { addMeetingCommands } from "@wirecat/cli-meetings/cli";
 import { Command, CommanderError } from "commander";
 import { addZoomSkillCommands } from "./agent-skill.js";
 import { ZoomApiSource } from "./api.js";
 import { addArchiveCommands, } from "./archive-commands.js";
+import { applyArchiveImport, preflightArchiveImport } from "./archive-import.js";
 import { readArchiveTranscripts, searchArchiveTranscripts } from "./archive-transcripts.js";
 import { addStandardCommands, annotateMeetingCommands } from "./commands.js";
 import { profileAccountKey, readConfig, setConfig } from "./config.js";
 import { checkCancelled, ZoomError } from "./errors.js";
 import { bytes, duration, resetCliOptions, startExecution } from "./execution.js";
 import { FilesSource, importFile, readDownloadedFiles, validateDownloadedFiles } from "./files.js";
+import { addIngestionSearchCommands } from "./ingestion-search-commands.js";
 import { login } from "./login.js";
+import { addMeetingContextCommands } from "./meeting-context-commands.js";
+import { addMeetingSemanticCommands, validateMeetingModel, } from "./meeting-semantic-commands.js";
 import { getZoomProfile, inspectArchive, inspectArchiveLocks, recoverArchiveLocks, verifyArchive, ZoomRecordings, } from "./recordings.js";
 import { ZoomRemoteMeetings } from "./remote-meetings.js";
 import { emitReceipt } from "./streaming.js";
+import { runUnifiedSearch } from "./unified-search.js";
 import { VERSION } from "./version.js";
 import { addWatchCommand } from "./watch-commands.js";
 const unavailable = async () => {
@@ -35,7 +40,7 @@ const unavailableStore = {
     cursor: unavailable,
     setCursor: unavailable,
 };
-const render = (value, format, deps, fields) => {
+const render = (value, format, deps, fields, preserveEnvelope = false) => {
     if (fields)
         value = projectFields(value, fields);
     const chunks = [];
@@ -44,7 +49,8 @@ const render = (value, format, deps, fields) => {
         color: false,
         streams: { data: (text) => chunks.push(`${text}\n`), diagnostic: deps.diagnostic },
     });
-    if (format === "jsonl" &&
+    if (!preserveEnvelope &&
+        format === "jsonl" &&
         typeof value === "object" &&
         value !== null &&
         "items" in value &&
@@ -143,7 +149,10 @@ export const createProgram = (deps) => {
             "serve",
             "skill",
             "watch",
-        ].includes(family.name()))
+            "search",
+        ].includes(family.name()) ||
+            (family.name() === "meetings" &&
+                ["evidence", "context", "task-proposal", "semantic", "embeddings"].includes(action.name())))
             return;
         const config = getConfig();
         if (opts.offline && action.name() === "pull" && config.source === "api" && !deps.source)
@@ -357,7 +366,7 @@ export const createProgram = (deps) => {
     let watchSince;
     const watchSleep = deps.sleep;
     const receipt = async (value) => {
-        const text = render(value, program.opts().jsonl ? "jsonl" : "text", deps, fields);
+        const text = render(value, program.opts().jsonl ? "jsonl" : program.opts().json ? "json" : "text", deps, fields);
         const operation = signal();
         const grace = operation.aborted ? createDeadline({ timeoutMs: 1000 }) : undefined;
         try {
@@ -564,13 +573,122 @@ export const createProgram = (deps) => {
         .command("serve")
         .description("serve read-only meeting tools over MCP stdio")
         .requiredOption("--mcp", "use the MCP JSON-RPC protocol")
-        .action(async () => {
+        .option("--unified-search", "include selected-profile meetings-only unified search")
+        .option("--meeting-context", "include account-fixed evidence, person context and task proposals")
+        .option("--semantic", "include read-only meeting vector search with an explicit query model")
+        .option("--model <id>", "explicit installed query model, or remote model at --base-url")
+        .option("--base-url <url>", "explicit remote embedding endpoint for semantic queries")
+        .option("--dims <count>", "remote embedding dimensions", bytes)
+        .action(async (options) => {
         const opts = program.opts();
         if (opts.json || opts.jsonl || opts.fields)
             throw new ZoomError("validation_error", "MCP stdio controls its own output; omit --json, --jsonl and --fields");
         if (!deps.serveMcp)
             throw new ZoomError("configuration_error", "the MCP server adapter is not available");
-        await deps.serveMcp({ signal: signal(), maxResultBytes: program.opts().maxOutputBytes });
+        if (options.semantic)
+            validateMeetingModel({ model: options.model ?? "", baseUrl: options.baseUrl, dims: options.dims });
+        else if (options.model !== undefined || options.baseUrl !== undefined || options.dims !== undefined)
+            throw new ZoomError("validation_error", "MCP model options require --semantic");
+        if (options.semantic && options.baseUrl !== undefined && opts.offline)
+            throw new ZoomError("configuration_error", "remote embeddings require network access; remove --offline");
+        await deps.serveMcp({
+            signal: signal(),
+            maxResultBytes: program.opts().maxOutputBytes,
+            ...(options.unifiedSearch ? { includeUnifiedSearch: true } : {}),
+            ...(options.meetingContext ? { includeMeetingContext: true } : {}),
+            ...(options.semantic
+                ? { semanticModel: { model: options.model ?? "", baseUrl: options.baseUrl, dims: options.dims } }
+                : {}),
+        });
+    });
+    addIngestionSearchCommands(program, {
+        signal,
+        output: (value) => buffer(render(value, program.opts().jsonl ? "jsonl" : program.opts().json ? "json" : "text", deps, fields, true)),
+        outputItems,
+        receipt,
+        preflight: preflightArchiveImport,
+        apply: async function* (plan) {
+            if (plan.occurrences === 0)
+                return;
+            let store = deps.transcriptStore;
+            let accountId = selectedAccountId;
+            if (!store) {
+                const config = getConfig();
+                if (!config.accountProfile || !deps.connectStore)
+                    throw new ZoomError("configuration_error", "select a local profile with an available transcript append store");
+                connection = await deps.connectStore({
+                    profile: config.accountProfile,
+                    externalId: profileAccountKey(config.accountProfile),
+                    intent: "ingestion",
+                    capability: "transcript-append",
+                });
+                accountId = connection.accountId;
+                if (!connection.appendTranscripts)
+                    throw new ZoomError("configuration_error", "the installed meeting store does not support transcript append");
+                store = { appendTranscripts: connection.appendTranscripts };
+            }
+            for await (const item of applyArchiveImport(plan, store, {
+                accountId: accountId ?? 0,
+                now: deps.now?.(),
+                signal: signal(),
+            }))
+                yield item;
+        },
+        search: async (request) => {
+            if (deps.unifiedSearch)
+                return runUnifiedSearch(deps.unifiedSearch, request);
+            const config = getConfig();
+            if (!config.accountProfile || !deps.connectStore)
+                throw new ZoomError("configuration_error", "select a stored local profile for unified search");
+            connection = await deps.connectStore({
+                profile: config.accountProfile,
+                externalId: profileAccountKey(config.accountProfile),
+                intent: "read",
+            });
+            if (!connection.unifiedSearch)
+                throw new ZoomError("configuration_error", "unified search is unavailable in this store connector");
+            return runUnifiedSearch(connection.unifiedSearch, request);
+        },
+    });
+    addMeetingContextCommands(program, {
+        signal,
+        output: (value) => buffer(render(value, program.opts().jsonl ? "jsonl" : program.opts().json ? "json" : "text", deps, fields, true)),
+        context: async () => {
+            if (deps.meetingContext)
+                return deps.meetingContext;
+            const config = getConfig();
+            if (!config.accountProfile || !deps.connectStore)
+                throw new ZoomError("configuration_error", "select a stored local profile for meeting context");
+            connection = await deps.connectStore({
+                profile: config.accountProfile,
+                externalId: profileAccountKey(config.accountProfile),
+                intent: "read",
+            });
+            if (!connection.meetingContext)
+                throw new ZoomError("configuration_error", "meeting context is unavailable in this store connector");
+            return connection.meetingContext;
+        },
+    });
+    addMeetingSemanticCommands(program, {
+        signal,
+        offline: () => Boolean(program.opts().offline),
+        receipt,
+        output: (value) => buffer(render(value, program.opts().jsonl ? "jsonl" : program.opts().json ? "json" : "text", deps, fields, true)),
+        capabilities: async () => {
+            if (deps.meetingSemantic)
+                return deps.meetingSemantic;
+            const config = getConfig();
+            if (!config.accountProfile || !deps.connectStore)
+                throw new ZoomError("configuration_error", "select a stored local profile for meeting vectors");
+            connection = await deps.connectStore({
+                profile: config.accountProfile,
+                externalId: profileAccountKey(config.accountProfile),
+                intent: "read",
+            });
+            if (!connection.meetingSemantic)
+                throw new ZoomError("configuration_error", "meeting vector capabilities are unavailable in this store connector");
+            return connection.meetingSemantic;
+        },
     });
     annotateMeetingCommands(program);
     const parseAsync = program.parseAsync.bind(program);
@@ -650,8 +768,19 @@ export const run = async (args, deps) => {
             ["commander.helpDisplayed", "commander.help", "commander.version"].includes(String(error.code)))
             return 0;
         const typed = error instanceof CliError || error instanceof MeetingError;
-        const code = typed ? error.code : error instanceof CommanderError ? "validation_error" : "generic_failure";
-        const message = typed ? error.message : "command failed; use --help for usage";
+        const unknownOutcome = error instanceof Error && "code" in error && error.code === "outcome_unknown";
+        const code = typed
+            ? error.code
+            : unknownOutcome
+                ? "outcome_unknown"
+                : error instanceof CommanderError
+                    ? "validation_error"
+                    : "generic_failure";
+        const message = typed
+            ? error.message
+            : unknownOutcome
+                ? "operation outcome is unknown; verify stored state before retrying"
+                : "command failed; use --help for usage";
         deps.diagnostic(`${JSON.stringify({ error: { code, message } })}\n`);
         return code === "generic_failure" ? GENERIC_FAILURE : exitCodeFor(code);
     }