@wirecat/drive-cli 0.3.0 → 0.5.0

package/dist/output.d.ts

@@ -0,0 +1,9 @@
+import type { ItemEnvelope, ListEnvelope } from "@wirecat/cli-base/standards";
+export declare const snakeKeys: (value: unknown, record?: boolean) => unknown;
+/** One invocation's standard envelope, shared by CLI output and the MCP executor. */
+export declare const answerOf: (value: unknown, context: {
+    startedAt: number;
+    runId?: string;
+    limit?: number;
+}) => ItemEnvelope<unknown> | ListEnvelope<unknown>;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAQ,MAAM,6BAA6B,CAAA;AAyBnF,eAAO,MAAM,SAAS,UAAW,OAAO,uBAAmB,OAS1D,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,QAAQ,UACZ,OAAO,WACL;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAC7D,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CA8B9C,CAAA"}

package/dist/output.js

@@ -0,0 +1,66 @@
+import { randomUUID } from "node:crypto";
+// Provider/user dictionaries retain their vocabulary; profile/model names are identifiers.
+const VERBATIM = new Set([
+    "frontMatter",
+    "front_matter",
+    "provider_metadata",
+    "metadata",
+    "headers",
+    "properties",
+    "appProperties",
+    "app_properties",
+    "request_schema",
+    "response_schema",
+    "body_schema",
+    "schema",
+    "inputSchema",
+    "input_schema",
+    "outputSchema",
+    "output_schema",
+]);
+const RECORDS = new Set(["profiles", "permissions", "models"]);
+const keyOf = (key) => /^[a-z][a-zA-Z0-9]*$/.test(key) ? key.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase() : key;
+export const snakeKeys = (value, record = false) => {
+    if (Array.isArray(value))
+        return value.map((item) => snakeKeys(item));
+    if (!value || typeof value !== "object" || value instanceof Date)
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+        record ? key : keyOf(key),
+        VERBATIM.has(key) ? item : snakeKeys(item, RECORDS.has(key)),
+    ]));
+};
+/** One invocation's standard envelope, shared by CLI output and the MCP executor. */
+export const answerOf = (value, context) => {
+    const data = snakeKeys(value);
+    const meta = {
+        run_id: context.runId ?? randomUUID(),
+        duration_ms: Math.max(0, Math.round(Date.now() - context.startedAt)),
+    };
+    // Rich results (search/context/config) stay together in an item, rather than losing their metadata.
+    const list = Array.isArray(data)
+        ? { items: data, has_more: false }
+        : data &&
+            typeof data === "object" &&
+            "items" in data &&
+            Array.isArray(data.items) &&
+            Object.keys(data).every((key) => ["items", "has_more", "next_offset"].includes(key))
+            ? data
+            : undefined;
+    if (!list)
+        return { item: data, meta };
+    const items = list.items;
+    const hasMore = "has_more" in list && list.has_more === true;
+    return {
+        items,
+        page: {
+            limit: context.limit ?? Math.max(1, items.length),
+            has_more: hasMore,
+            ...("next_offset" in list && list.next_offset !== null && list.next_offset !== undefined
+                ? { cursor: String(list.next_offset) }
+                : {}),
+        },
+        meta,
+    };
+};
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AACD,eAAO,MAAM,cAAc,QAAS,MAAM,CAAC,UAAU,WAAW,MAAM,UAAS,WAAW;;;CASzF,CAAA;AAID,eAAO,MAAM,gBAAgB,WAAY,MAAM,aAa9C,CAAA;AACD,eAAO,MAAM,WAAW,QACjB,MAAM,CAAC,UAAU,WACb,MAAM,OACV,MAAM,WACF,OAAO,UACT,WAAW,QACZ,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,kBAkBxC,CAAA;AACD,eAAO,MAAM,kBAAkB,GAAU,CAAC,OACnC,MAAM,CAAC,UAAU,WACb,MAAM,OACV,MAAM,OACN,MAAM,OAAO,CAAC,CAAC,CAAC,UACd,WAAW,QACZ,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KACtC,OAAO,CAAC,CAAC,CAoBX,CAAA"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AACD,eAAO,MAAM,cAAc,QAAS,MAAM,CAAC,UAAU,WAAW,MAAM,UAAS,WAAW;;;CASzF,CAAA;AAID,eAAO,MAAM,gBAAgB,WAAY,MAAM,aAa9C,CAAA;AACD,eAAO,MAAM,WAAW,QACjB,MAAM,CAAC,UAAU,WACb,MAAM,OACV,MAAM,WACF,OAAO,UACT,WAAW,QACZ,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,kBAqBxC,CAAA;AACD,eAAO,MAAM,kBAAkB,GAAU,CAAC,OACnC,MAAM,CAAC,UAAU,WACb,MAAM,OACV,MAAM,OACN,MAAM,OAAO,CAAC,CAAC,CAAC,UACd,WAAW,QACZ,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KACtC,OAAO,CAAC,CAAC,CAoBX,CAAA"}

package/dist/policy.js

@@ -1,6 +1,6 @@
 import { join } from "node:path";
 import { CliError } from "@wirecat/cli-base";
-import { guardedWrite, layerPermissions, levelFor, newOperationId, permissionOverrides, RecipientList, SendJournal, sendGuard, } from "@wirecat/cli-messaging/sends";
+import { guardedWrite, layerPermissions, levelFor, newOperationId, permissionOverrides, RecipientList, SendJournal, sendGuard, } from "@wirecat/cli-core/sends";
 import { operations } from "./api-contract.js";
 import { paths, readConfig } from "./config.js";
 import { VERSION } from "./version.js";
@@ -12,7 +12,7 @@ export const policySettings = (env, profile, flags = {}) => {
         ["profile", own?.permissions],
         ["defaults", config.defaults?.permissions],
     ]);
-    return { levels, readOnly: flags.readOnly === true || (own?.readOnly ?? config.defaults?.readOnly ?? false) };
+    return { levels, readOnly: flags.readOnly === true || (own?.read_only ?? config.defaults?.read_only ?? false) };
 };
 const defaults = Object.fromEntries(operations.filter((op) => op.effect === "destructive").map((op) => [`api.${op.id}`, "ask"]));
 export const methodPolicyKeys = (method) => {
@@ -33,7 +33,10 @@ export const checkPolicy = async (env, profile, key, mutates, flags = {}, ask) =
     const { levels, readOnly } = policySettings(env, profile, flags);
     const { level } = levelFor(levels, key, defaults);
     if (level === "deny" || (mutates && (readOnly || level === "readonly")))
-        throw new CliError("permission_error", "profile policy refuses this operation", { permission: key });
+        throw new CliError("permission_error", "profile policy refuses this operation", {
+            reason: "policy.denied",
+            permission: key,
+        });
     if (mutates && level === "ask" && !flags.dryRun) {
         const destructive = defaults[key] === "ask";
         if (destructive ? flags.allowDangerous : flags.yes)
@@ -42,7 +45,7 @@ export const checkPolicy = async (env, profile, key, mutates, flags = {}, ask) =
             return;
         throw new CliError("confirmation_required", destructive
             ? "this deletion requires --allow-dangerous or an explicit permission"
-            : "profile policy requires --yes or confirmation", { permission: key });
+            : "profile policy requires --yes or confirmation", { reason: "policy.confirm", permission: key });
     }
 };
 export const guardedGoogleWrite = async (env, profile, key, act, flags = {}, ask) => {

package/dist/policy.js.map

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

package/dist/profile-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profile-lock.d.ts","sourceRoot":"","sources":["../src/profile-lock.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAAe,MAAM,CAAC,UAAU,QAAQ,MAAM;;;EAuBrE,CAAA"}
+{"version":3,"file":"profile-lock.d.ts","sourceRoot":"","sources":["../src/profile-lock.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAAe,MAAM,CAAC,UAAU,QAAQ,MAAM;;;EA2BrE,CAAA"}

package/dist/profile-lock.js

@@ -16,12 +16,14 @@ export const lockProfile = async (env, name) => {
             release,
             assertHeld: () => {
                 if (compromised)
-                    throw new CliError("provider_unavailable", "profile lock was lost; retry the operation");
+                    throw new CliError("provider_unavailable", "profile lock was lost; retry the operation", {
+                        reason: "profile.locked",
+                    });
             },
         };
     }
     catch {
-        throw new CliError("provider_unavailable", "another sync or knowledge operation holds this profile's lock; retry later");
+        throw new CliError("provider_unavailable", "another sync or knowledge operation holds this profile's lock; retry later", { reason: "profile.locked" });
     }
 };
 //# sourceMappingURL=profile-lock.js.map

package/dist/profile-lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile-lock.js","sourceRoot":"","sources":["../src/profile-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,QAAQ,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,GAAsB,EAAE,IAAY,EAAE,EAAE;IACxE,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC3B,IAAI,WAAW,GAAG,KAAK,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE;YACzD,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,GAAG,EAAE;gBAClB,WAAW,GAAG,IAAI,CAAA;YACpB,CAAC;SACF,CAAC,CAAA;QACF,OAAO;YACL,OAAO;YACP,UAAU,EAAE,GAAG,EAAE;gBACf,IAAI,WAAW;oBAAE,MAAM,IAAI,QAAQ,CAAC,sBAAsB,EAAE,4CAA4C,CAAC,CAAA;YAC3G,CAAC;SACF,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,4EAA4E,CAC7E,CAAA;IACH,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"profile-lock.js","sourceRoot":"","sources":["../src/profile-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,QAAQ,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,GAAsB,EAAE,IAAY,EAAE,EAAE;IACxE,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC3B,IAAI,WAAW,GAAG,KAAK,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE;YACzD,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,GAAG,EAAE;gBAClB,WAAW,GAAG,IAAI,CAAA;YACpB,CAAC;SACF,CAAC,CAAA;QACF,OAAO;YACL,OAAO;YACP,UAAU,EAAE,GAAG,EAAE;gBACf,IAAI,WAAW;oBACb,MAAM,IAAI,QAAQ,CAAC,sBAAsB,EAAE,4CAA4C,EAAE;wBACvF,MAAM,EAAE,gBAAgB;qBACzB,CAAC,CAAA;YACN,CAAC;SACF,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,4EAA4E,EAC5E,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAC7B,CAAA;IACH,CAAC;AACH,CAAC,CAAA"}

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,YAAY,EAEjB,KAAK,OAAO,EAEb,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAAE,OAAO,EAAsC,MAAM,WAAW,CAAA;AAIvE,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,iBAAiB,CAAA;AAE5D,OAAO,EAAa,KAAK,SAAS,EAAa,MAAM,iBAAiB,CAAA;AAGtE,OAAO,EAAE,KAAK,aAAa,EAAU,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAW1E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IACnD,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAA;CAC7C;AAWD,eAAO,MAAM,aAAa,aAAa,cAAc,KAAQ,OAooB5D,CAAA"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,YAAY,EAEjB,KAAK,OAAO,EAEb,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAAE,OAAO,EAAsC,MAAM,WAAW,CAAA;AAgBvE,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,iBAAiB,CAAA;AAE5D,OAAO,EAAa,KAAK,SAAS,EAAa,MAAM,iBAAiB,CAAA;AAGtE,OAAO,EAAE,KAAK,aAAa,EAAU,KAAK,YAAY,EAA0B,MAAM,YAAY,CAAA;AAYlG,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IACnD,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAA;CAC7C;AAWD,eAAO,MAAM,aAAa,aAAa,cAAc,KAAQ,OAqsB5D,CAAA"}

package/dist/program.js

@@ -2,17 +2,19 @@ import { readFileSync, writeFileSync } from "node:fs";
 import { CliError, createDeadline, createOutputBuffer, createRenderer, processStreams, visibleControls, } from "@wirecat/cli-base";
 import { annotate, describeOptions, flatten, metaOf } from "@wirecat/cli-base/commands";
 import { formatSuggestions, suggest } from "@wirecat/cli-base/completion";
-import { commandWords, liftProfile, parseDuration, refuseCommandName } from "@wirecat/cli-messaging/cli";
+import { commandWords, liftProfile, parseDuration, refuseCommandName } from "@wirecat/cli-core/cli";
 import { Command, Help, InvalidArgumentError, Option } from "commander";
 import { validateRequest } from "./api-contract.js";
-import { activeProfile, application, checkTextLimit, fileId, profileName, readConfig, writeConfig } from "./config.js";
+import { installCatalogCommands } from "./catalog-commands.js";
+import { activeProfile, application, checkTextLimit, configKey, fileId, pictureSearch, profileName, readConfig, SETTING_NAMES, writeConfig, } from "./config.js";
 import { googleError } from "./errors.js";
 import { memoryModel } from "./extraction.js";
-import { googleSource } from "./google.js";
+import { googleSource, MAX_ENTRIES } from "./google.js";
 import { apiMethod, googleApi } from "./google-api.js";
 import { installKnowledgeCommands } from "./knowledge-commands.js";
 import { login } from "./login.js";
-import { FOLDER } from "./model.js";
+import { FOLDER, metadataJson, skipJson } from "./model.js";
+import { answerOf } from "./output.js";
 import { checkPolicy, guardedGoogleWrite, methodPolicyKeys } from "./policy.js";
 import { lockProfile } from "./profile-lock.js";
 import { ACCOUNT_FREE_COMMANDS, commandsDocument, describeDriveProgram, examples } from "./registry.js";
@@ -35,6 +37,7 @@ const offset = (input) => {
     return n;
 };
 export const createProgram = (options = {}) => {
+    const startedAt = Date.now();
     const env = options.env ?? process.env;
     const streams = options.streams ?? processStreams;
     const program = new Command("drive")
@@ -46,6 +49,7 @@ export const createProgram = (options = {}) => {
         .option("--jsonl", "print machine-readable JSON lines")
         .option("--agent-json", "show control and direction characters visibly in machine output")
         .option("--quiet", "suppress optional diagnostics")
+        .option("--debug", "on failure, show the full error record: cause and stack")
         .option("--timeout <duration>", "whole-command deadline, e.g. 30s", (raw) => parseDuration(raw, "--timeout"))
         .option("--max-output-bytes <n>", "largest result to print, in bytes; 0 for no limit", offset, 4 * 1024 * 1024)
         .option("--read-only", "refuse local and remote mutations")
@@ -68,7 +72,7 @@ export const createProgram = (options = {}) => {
             throw new CliError("validation_error", "choose a profile explicitly: drive <profile> <command> or drive --profile <name> <command>; " +
                 (choices.length
                     ? `configured profiles: ${choices.join(", ")}`
-                    : "no profiles configured; connect with drive personal session start"), { profiles: choices });
+                    : "no profiles configured; connect with drive personal session start"), { reason: "profile.required", profiles: choices });
         }
         return profileName(name);
     };
@@ -98,6 +102,7 @@ export const createProgram = (options = {}) => {
         return value;
     };
     const output = (value) => {
+        const result = currentAction?.name() === "commands" ? value : answerOf(value, { startedAt, limit: currentAction?.opts().limit });
         const buffer = createOutputBuffer({ maxOutputBytes: program.opts().maxOutputBytes });
         createRenderer({
             format: program.opts().jsonl
@@ -108,7 +113,7 @@ export const createProgram = (options = {}) => {
             color: false,
             streams: { ...streams, data: (text) => buffer.data(text) },
             quiet: program.opts().quiet === true,
-        }).result(program.opts().agentJson ? safeForAgent(value) : value);
+        }).result(program.opts().agentJson ? safeForAgent(result) : result);
         buffer.flush((text) => streams.data(text));
     };
     const source = async () => {
@@ -159,7 +164,7 @@ export const createProgram = (options = {}) => {
         scope: "all-configured-profiles",
         items: Object.entries(readConfig(env).profiles).map(([name, p]) => ({
             profile: name,
-            selectedFolders: p.roots.length,
+            selected_folders: p.roots.length,
             storage: p.storage,
         })),
     }));
@@ -172,7 +177,7 @@ export const createProgram = (options = {}) => {
         credentials(env, profile.storage, options.keyring).remove(name);
         // Preserve the principal and roots so reauthorization resumes the same source identities.
         writeConfig(env, config);
-        output({ profile: name, signedOut: true, cachedData: "retained" });
+        output({ profile: name, signed_out: true, cached_data: "retained" });
     });
     const folders = program.command("folders").description("choose the Google Drive folders that sync imports");
     const folderArgument = "folder id or Google Drive URL";
@@ -209,7 +214,11 @@ export const createProgram = (options = {}) => {
         writeConfig(env, config);
         output({ id, removed: true, next: `run drive ${name} sync to reconcile cached sources` });
     });
-    examples(program.command("sync").description("import what changed in the chosen folders, and finish an unfinished sync"), ["drive personal sync", "drive personal sync --rescan --limit 500"])
+    examples(program
+        .command("sync")
+        .summary("import what changed in the chosen folders, and finish an unfinished sync")
+        .description("import what changed in the chosen folders, and finish an unfinished sync; " +
+        `one sync reads at most ${MAX_ENTRIES} entries under the chosen folders, and as many changes`), ["drive personal sync", "drive personal sync --rescan --limit 500"])
         .option("--limit <n>", "how many documents to read from Google in this run", positive, 200)
         .option("--rescan", "read every chosen folder again instead of only what changed")
         .option("--embed", "also index pending text for meaning search, with a model already downloaded")
@@ -223,7 +232,9 @@ export const createProgram = (options = {}) => {
         if (result.errors.length || result.pending)
             streams.diagnostic(`${result.pending} source operations remain; run drive ${selected()} sync again\n`);
         if (result.errors.length)
-            throw new CliError("provider_error", "sync completed partially; failed operations remain pending");
+            throw new CliError("provider_error", "sync completed partially; failed operations remain pending", {
+                reason: "sync.partial",
+            });
     });
     examples(program.command("status").description("show the last sync, imported documents and pending work"), [
         "drive personal status",
@@ -233,13 +244,13 @@ export const createProgram = (options = {}) => {
         const state = readState(env, name, profile.principal);
         output({
             profile: name,
-            selectedFolders: profile.roots,
+            selected_folders: profile.roots,
             documents: Object.keys(state.documents).length,
             pending: state.pending?.jobs.length ?? 0,
-            skipped: state.skipped,
-            lastSync: state.lastSync ?? null,
+            skipped: state.skipped.map(skipJson),
+            last_sync: state.lastSync ?? null,
             coverage: "Google Docs and Markdown/TXT; native export tab fidelity and assets are not verified",
-            remoteChecked: false,
+            remote_checked: false,
         });
     });
     const documents = program.command("documents").description("read imported documents and Google Docs");
@@ -266,7 +277,7 @@ export const createProgram = (options = {}) => {
             });
         output({
             items: docs.map((doc) => ({
-                ...doc.metadata,
+                ...metadataJson(doc.metadata),
                 reference: doc.reference,
                 tabs: doc.tabs,
             })),
@@ -277,7 +288,9 @@ export const createProgram = (options = {}) => {
         const profile = activeProfile(env, selected());
         const state = readState(env, selected(), profile.principal);
         if (!state.documents[id])
-            throw new CliError("not_found", "this source is not imported in the selected profile");
+            throw new CliError("not_found", "this source is not imported in the selected profile", {
+                reason: "document.not-imported",
+            });
         const doc = state.documents[id];
         return { id, ref: doc.reference, hash: doc.hash, snapshot: readSnapshot(env, selected(), id) };
     };
@@ -286,7 +299,12 @@ export const createProgram = (options = {}) => {
         .argument("<document>", documentArgument)
         .description("show an imported document's text, tabs and metadata"), ["drive personal documents show DOC_ID"]).action((input) => {
         const { snapshot } = imported(input);
-        output({ metadata: snapshot.metadata, text: snapshot.text, tabs: snapshot.tabs });
+        output({
+            metadata: metadataJson(snapshot.metadata),
+            text: snapshot.text,
+            tabs: snapshot.tabs,
+            ...(snapshot.notRead ? { not_read: snapshot.notRead } : {}),
+        });
     });
     examples(documents
         .command("export")
@@ -295,7 +313,17 @@ export const createProgram = (options = {}) => {
         .requiredOption("--out <file>", "path of the Markdown file to write; an existing file is refused")
         .action((input, args) => {
         const { id, snapshot } = imported(input);
-        writeFileSync(args.out, snapshot.markdown, { flag: "wx", mode: 0o600 });
+        try {
+            writeFileSync(args.out, snapshot.markdown, { flag: "wx", mode: 0o600 });
+        }
+        catch (error) {
+            if (error.code === "EEXIST")
+                throw new CliError("validation_error", "the output file already exists; choose another --out", {
+                    reason: "export.exists",
+                    param: "--out",
+                });
+            throw error;
+        }
         output({ id, path: args.out, format: "markdown" });
     });
     examples(program
@@ -305,7 +333,12 @@ export const createProgram = (options = {}) => {
         .option("--limit <n>", "how many results to return", positive, 20)
         .option("--offset <n>", "how many results to skip", offset, 0)
         .option("--exact", "match the words exactly: no word forms, no meaning")
-        .action(async (query, args) => output(await withIndex((index) => index.search(activeProfile(env, selected()).principal, query, { ...args, exact: args.exact ?? false }))));
+        .action(async (query, args) => output(await withIndex((index) => index.search(activeProfile(env, selected()).principal, query, {
+        ...args,
+        exact: args.exact ?? false,
+        ...(pictureSearch(env, selected()) ? { pictures: true } : {}),
+    }))));
+    installCatalogCommands(program, { env, selected, output, positive, offset, withIndex });
     installKnowledgeCommands(program, {
         document: imported,
         output,
@@ -315,12 +348,14 @@ export const createProgram = (options = {}) => {
         run: async (input, fn) => {
             const lock = await lockProfile(env, selected());
             try {
-                const { ref } = imported(input);
                 return await withIndex(async (index) => {
                     lock.assertHeld();
                     if (!index.knowledge)
                         throw new CliError("configuration_error", "index has no shared knowledge adapter");
-                    const result = await fn(index.knowledge, activeProfile(env, selected()).principal, ref);
+                    const principal = activeProfile(env, selected()).principal;
+                    const found = await index.catalog?.get(principal, fileId(input));
+                    const ref = found?.ref ?? imported(input).ref;
+                    const result = await fn(index.knowledge, principal, ref);
                     lock.assertHeld();
                     return result;
                 });
@@ -333,7 +368,18 @@ export const createProgram = (options = {}) => {
     installRemoteCommands(program, {
         output,
         positive,
-        readBody: options.readBody ?? ((path) => readFileSync(path, "utf8")),
+        readBody: options.readBody ??
+            ((path) => {
+                try {
+                    return readFileSync(path, "utf8");
+                }
+                catch {
+                    throw new CliError("validation_error", "the request body file could not be read", {
+                        reason: "body.unreadable",
+                        param: "--body-file",
+                    });
+                }
+            }),
         call: async (method, params, body) => {
             const descriptor = apiMethod(method);
             validateRequest(method, params, body);
@@ -341,14 +387,16 @@ export const createProgram = (options = {}) => {
             for (const key of methodPolicyKeys(method))
                 await checkPolicy(env, selected(), key, descriptor.mutates, flags, askOnce);
             if (flags.offline)
-                throw new CliError("permission_error", "this operation needs Google; --offline was requested");
+                throw new CliError("permission_error", "this operation needs Google; --offline was requested", {
+                    reason: "offline.refused",
+                });
             if (flags.dryRun)
                 return {
-                    dryRun: true,
+                    dry_run: true,
                     method,
                     mutates: descriptor.mutates,
                     parameters: params,
-                    bodyProvided: body !== undefined,
+                    body_provided: body !== undefined,
                 };
             const act = async () => {
                 try {
@@ -370,13 +418,14 @@ export const createProgram = (options = {}) => {
         "drive personal config show",
     ]).action(() => output(readConfig(env)));
     examples(config.command("set").description("set one setting of this profile, or of the defaults"), [
-        "drive personal config set readOnly true",
+        "drive personal config set read_only true",
         `drive personal config set permissions.files '"readonly"' --defaults`,
     ])
-        .argument("<key>", "readOnly, maxTextChars, permissions.<key> or models.<purpose>.<field>")
+        .argument("<key>", "read_only, max_text_chars, picture_search, shared AI settings, permissions.<key> or models.<purpose>.<field>")
         .argument("<json-value>", "the new value, as JSON")
         .option("--defaults", "change the defaults instead of this profile")
-        .action((key, raw, args) => {
+        .action((rawKey, raw, args) => {
+        const key = configKey(rawKey);
         const value = readConfig(env);
         if (args.defaults)
             value.defaults ??= {};
@@ -386,9 +435,9 @@ export const createProgram = (options = {}) => {
         if (!args.defaults)
             value.profiles[selected()] = target;
         const [head, ...parts] = key.split(".");
-        if (!["readOnly", "permissions", "models", "maxTextChars"].includes(head ?? "") ||
+        if (!SETTING_NAMES.has(head ?? "") ||
             parts.some((part) => ["__proto__", "prototype", "constructor"].includes(part)))
-            throw new CliError("validation_error", "config set accepts readOnly, permissions, models or maxTextChars");
+            throw new CliError("validation_error", "config set accepts profile settings and shared AI settings");
         let parsed;
         try {
             parsed = JSON.parse(raw);
@@ -396,8 +445,13 @@ export const createProgram = (options = {}) => {
         catch {
             throw new CliError("validation_error", "setting value must be JSON");
         }
-        if (head === "maxTextChars" && !parts.length)
-            target.maxTextChars = checkTextLimit(parsed);
+        if (head === "picture_search") {
+            if (args.defaults || parts.length || typeof parsed !== "boolean")
+                throw new CliError("validation_error", "picture_search is true or false, set per profile");
+            target.picture_search = parsed;
+        }
+        else if (head === "max_text_chars" && !parts.length)
+            target.max_text_chars = checkTextLimit(parsed);
         else if (!parts.length)
             Object.assign(target, { [key]: parsed });
         else if (head === "permissions") {
@@ -448,7 +502,7 @@ export const createProgram = (options = {}) => {
         config.defaults.models[args.purpose] = {
             provider: args.provider,
             ...(args.model ? { model: args.model } : {}),
-            ...(args.baseUrl ? { baseUrl: args.baseUrl } : {}),
+            ...(args.baseUrl ? { base_url: args.baseUrl } : {}),
         };
         writeConfig(env, config);
         output({ purpose: args.purpose, configured: true });
@@ -465,7 +519,7 @@ export const createProgram = (options = {}) => {
             output({
                 items: mcpTools({ ...options, env }, selected(), policyFlags()).map(({ name, schema, command }) => ({
                     name,
-                    inputSchema: schema,
+                    input_schema: schema,
                     mutates: command.mutates,
                 })),
             });
@@ -521,7 +575,8 @@ export const createProgram = (options = {}) => {
         annotate(command, {
             origin: metaOf(command).origin ?? "handwritten",
             mutates: metaOf(command).mutates ?? (localWrites.includes(name) || remoteWrites.includes(name)),
-            local: localWrites.includes(name) && name !== "session start" && name !== "memories extract",
+            local: metaOf(command).local ??
+                (localWrites.includes(name) && name !== "session start" && name !== "memories extract"),
             state: "beta",
         });
     }
@@ -553,13 +608,15 @@ export const createProgram = (options = {}) => {
         const flags = policyFlags();
         const metadata = metaOf(action);
         const rawMethod = words === "api call" ? action.args[0] : undefined;
-        const method = metadata.operationId ?? rawMethod;
+        const method = metadata.operation_id ?? rawMethod;
         if (rawMethod) {
             const descriptor = apiMethod(rawMethod);
             if (descriptor.mutates && !action.opts().allowWrite)
-                throw new CliError("permission_error", "this method changes Google data; pass --allow-write");
+                throw new CliError("permission_error", "this method changes Google data; pass --allow-write", {
+                    reason: "write.not-allowed",
+                });
             if (descriptor.destructive && !action.opts().allowDelete && !flags.allowDangerous)
-                throw new CliError("permission_error", "this method deletes Google data; pass --allow-delete or --allow-dangerous");
+                throw new CliError("permission_error", "this method deletes Google data; pass --allow-delete or --allow-dangerous", { reason: "delete.not-allowed" });
             if (flags.allowDangerous)
                 action.setOptionValue("allowDelete", true);
         }
@@ -580,12 +637,14 @@ export const createProgram = (options = {}) => {
                     "memories extract",
                     "sync",
                 ].includes(words)))
-            throw new CliError("permission_error", "this command may require network access; --offline was requested");
+            throw new CliError("permission_error", "this command may require network access; --offline was requested", {
+                reason: "offline.refused",
+            });
         if (flags.dryRun &&
             path[0] !== "api" &&
             !["files", "comments", "permissions", "revisions", "shared-drives"].includes(path[0] ?? "") &&
             !["documents get", "documents create", "documents update", "documents history"].includes(words)) {
-            output({ dryRun: true, command: words, mutates, local: metadata.local === true });
+            output({ dry_run: true, command: words, mutates, local: metadata.local === true });
             throw new Preview();
         }
         if (words === "session start")