@wirecat/cli-core 0.424.0 → 0.425.0

package/dist/cli/preview.d.ts

@@ -3,13 +3,51 @@ import { type PermissionKey } from "../sends/permissions.js";
 import type { Settings } from "./settings.js";
 export declare class PreviewComplete extends Error {
 }
-export declare const preview: (command: Command, settings: Pick<Settings, "permissions" | "permissionSources" | "configPath" | "savedPermissions" | "profile">, tool: string, keyOf?: (path: readonly string[]) => PermissionKey | null | undefined) => {
+export declare const preview: (command: Command, settings: Pick<Settings, "permissions" | "permissionSources" | "configPath" | "savedPermissions" | "profile">, tool: string, keyOf?: (path: readonly string[]) => PermissionKey | null | undefined, messenger?: boolean) => {
     preview: boolean;
     path: string[];
-    permission: {
-        key: string | null;
-        level: "allow" | "ask" | "readonly";
+    permission?: {
+        key: PermissionKey | null;
+        level: string;
+    } | undefined;
+    validation: {
+        arguments: string;
+        permissions: string;
+        targets: string;
+        businessRules: string;
+    };
+    effects: {
+        actionInvoked: boolean;
+        writeReserved: boolean;
+        messengerContacted?: boolean | undefined;
+        serviceContacted: boolean;
+        configurationRead: boolean;
     };
+    arguments: ({
+        name: string;
+        reference: string;
+    } | {
+        name: string;
+        supplied: boolean;
+        bytes: number | undefined;
+    })[];
+    options: string[];
+    trust: string;
+};
+/**
+ * `messenger_contacted` stays for the messengers, whose callers may read it; `service_contacted` says the same
+ * for every tool. Without `permission` nothing was checked: a host that is not `run` has no settings to check.
+ */
+export declare const previewBody: (command: Command, permission: {
+    key: PermissionKey | null;
+    level: string;
+} | undefined, messenger: boolean) => {
+    preview: boolean;
+    path: string[];
+    permission?: {
+        key: PermissionKey | null;
+        level: string;
+    } | undefined;
     validation: {
         arguments: string;
         permissions: string;
@@ -19,7 +57,8 @@ export declare const preview: (command: Command, settings: Pick<Settings, "permi
     effects: {
         actionInvoked: boolean;
         writeReserved: boolean;
-        messengerContacted: boolean;
+        messengerContacted?: boolean | undefined;
+        serviceContacted: boolean;
         configurationRead: boolean;
     };
     arguments: ({

package/dist/cli/preview.js

@@ -6,11 +6,11 @@ import { commandPathOf } from "./command-contract.js";
 import { refuseUnknownPermissionKeys } from "./permission-keys.js";
 export class PreviewComplete extends Error {
 }
-export const preview = (command, settings, tool, keyOf) => {
+export const preview = (command, settings, tool, keyOf, messenger = true) => {
     const path = commandPathOf(command);
     const { permissions } = settings;
     refuseUnknownPermissionKeys(command, settings, tool, keyOf && ((one) => keyOf(commandPathOf(one))));
-    const key = keyForCommand(path);
+    const key = keyOf?.(path) ?? keyForCommand(path);
     const level = key ? levelFor(permissions, key).level : "allow";
     for (const source of readKeysForCommand(path)) {
         if (levelFor(permissions, source).level === "deny")
@@ -21,18 +21,36 @@ export const preview = (command, settings, tool, keyOf) => {
         (key !== null && key !== undefined && WRITE_KEYS.includes(key));
     if (level === "deny" || (writes && level === "readonly"))
         throw new CliError("permission_error", `this profile does not permit ${path.join(" ")}`, { permission: key });
-    const targets = new Set(["chat", "message", "person", "profile"]);
+    return previewBody(command, { key: key ?? null, level }, messenger);
+};
+const TARGETS = new Set(["chat", "message", "person", "profile"]);
+/**
+ * `messenger_contacted` stays for the messengers, whose callers may read it; `service_contacted` says the same
+ * for every tool. Without `permission` nothing was checked: a host that is not `run` has no settings to check.
+ */
+export const previewBody = (command, permission, messenger) => {
     return {
         preview: true,
-        path,
-        permission: { key: key ?? null, level },
-        validation: { arguments: "parsed", permissions: "checked", targets: "unresolved", businessRules: "not-executed" },
-        effects: { actionInvoked: false, writeReserved: false, messengerContacted: false, configurationRead: true },
+        path: commandPathOf(command),
+        ...(permission ? { permission } : {}),
+        validation: {
+            arguments: "parsed",
+            permissions: permission ? "checked" : "not-checked",
+            targets: "unresolved",
+            businessRules: "not-executed",
+        },
+        effects: {
+            actionInvoked: false,
+            writeReserved: false,
+            ...(messenger ? { messengerContacted: false } : {}),
+            serviceContacted: false,
+            configurationRead: permission !== undefined,
+        },
         arguments: command.registeredArguments.map((argument, at) => {
             const value = command.processedArgs[at];
             return {
                 name: argument.name(),
-                ...(targets.has(argument.name()) && typeof value === "string"
+                ...(TARGETS.has(argument.name()) && typeof value === "string"
                     ? { reference: value }
                     : { supplied: value !== undefined, bytes: typeof value === "string" ? Buffer.byteLength(value) : undefined }),
             };

package/dist/cli/program.js

@@ -10,6 +10,7 @@ import { isCliFailure, isCommanderFailure } from "../errors/failures.js";
 import { failureContext } from "../errors/reasons.js";
 import { envName, readOnlyLockOf, readOnlyRefusal } from "../ports/app.js";
 import { recorded, wasSettled } from "../runs/recording.js";
+import { runContextOf } from "../runs/run-context.js";
 import { processRun, useAsProcessRun } from "../runs/scope.js";
 import { AUTHORITY_KEY, BOT_API_KEY, isBotApi, keyForCommand } from "../sends/permissions.js";
 import { logParsedArgv, logVersion } from "./argv-log.js";
@@ -191,6 +192,7 @@ const runOnce = async (argv, definition, options) => {
     const exit = {};
     const environment = {
         ...options,
+        argv,
         streams: control.streams,
         signal: options.signal ? AbortSignal.any([control.signal, options.signal]) : control.signal,
         commandSignal: control.signal,
@@ -267,16 +269,18 @@ const runOnce = async (argv, definition, options) => {
         const path = commandPathOf(action);
         const lock = readOnlyLockOf(definition.app, commandEnv);
         const input = options.stdin ?? process.stdin;
-        await setupAtStart({
-            command,
-            env: commandEnv,
-            contentLanguages: definition.app.contentLanguages,
-            path,
-            headless,
-            readOnlyLock: lock,
-            input,
-            terminal: !options.streams && input.isTTY === true && process.stderr.isTTY === true,
-        });
+        // The first-run questions write the shared config; a dry run writes nothing.
+        if (!flags.dryRun)
+            await setupAtStart({
+                command,
+                env: commandEnv,
+                contentLanguages: definition.app.contentLanguages,
+                path,
+                headless,
+                readOnlyLock: lock,
+                input,
+                terminal: !options.streams && input.isTTY === true && process.stderr.isTTY === true,
+            });
         if (lock && isLogin(action) && !flags.dryRun)
             throw readOnlyRefusal(lock, "log in or out");
         if (lock && isStoreChange(action) && !flags.dryRun)
@@ -385,7 +389,7 @@ const runOnce = async (argv, definition, options) => {
                 configPath: resolved.configPath ?? "",
                 profile: resolved.profile,
                 ...(resolved.savedPermissions ? { savedPermissions: resolved.savedPermissions } : {}),
-            }, command, definition.configuration?.permissionKey);
+            }, command, definition.configuration?.permissionKey, definition.app.messenger !== false);
             renderAnswer(action, outputFor(action), itemOf(snakeKeys(previewed)));
             throw new PreviewComplete();
         }
@@ -412,7 +416,7 @@ const runOnce = async (argv, definition, options) => {
             refuseJoinedPath(program, words.filter((word) => !word.startsWith("-")), profile !== undefined && !/\s/.test(profile) ? [profile] : []);
     }
     catch (failure) {
-        const settled = await settleFailure(failure, { definition, program, rest: lifted, profile, options });
+        const settled = await settleFailure(failure, { definition, program, rest: lifted, argv, profile, options });
         return report(streams, reporting, failed(definition, program, lifted, failure, settled, debug));
     }
     if (profile !== undefined)
@@ -427,7 +431,7 @@ const runOnce = async (argv, definition, options) => {
         const message = `"${profile}" is not a command, so it was read as a profile name — and no command followed it. ` +
             `Run \`${command} --help\` for the commands, or \`${command} ${profile} account show\` if "${profile}" is your profile.`;
         const failure = new CliError("validation_error", message, { param: "profile" });
-        const settled = await settleFailure(failure, { definition, program, rest, profile, options });
+        const settled = await settleFailure(failure, { definition, program, rest, argv, profile, options });
         return report(streams, reporting, failed(definition, program, rest, failure, settled, debug));
     }
     try {
@@ -472,10 +476,10 @@ const runOnce = async (argv, definition, options) => {
                 message += ` — "${profile}" is not a command, so it was read as a profile name — which left "${rest[0]}" to be one.`;
             }
             const failure = new CliError("validation_error", message);
-            const settled = await settleFailure(failure, { definition, program, rest, profile, options });
+            const settled = await settleFailure(failure, { definition, program, rest, argv, profile, options });
             return report(streams, reporting, failed(definition, program, rest, failure, settled, debug));
         }
-        const settled = await settleFailure(error, { definition, program, rest, profile, options });
+        const settled = await settleFailure(error, { definition, program, rest, argv, profile, options });
         const exit = report(streams, reporting, failed(definition, program, rest, error, settled, debug));
         return signalExit ?? exit;
     }
@@ -562,9 +566,9 @@ const settleFailure = async (failure, state) => {
 /**
  * **Every failure is kept as a run** — a usage error, a configuration that will not load, a command
  * that never opens a run — unless recording was turned off. One its own run already kept is skipped.
- * Only the command's words are named, never its arguments: those can be a message.
+ * Its arguments are kept masked (`maskArgv`): a value that can be a message never is.
  */
-const keepFailure = async (failure, { definition, program, rest, profile, options }) => {
+const keepFailure = async (failure, { definition, program, rest, argv, profile, options }) => {
     if (wasSettled(failure))
         return;
     const env = options.env ?? process.env;
@@ -577,9 +581,17 @@ const keepFailure = async (failure, { definition, program, rest, profile, option
     catch {
         // A configuration that will not load is a failure worth keeping too; the flags are all there is to go on.
     }
+    const command = `${options.agent ? "mcp " : ""}${path || definition.app.command}`;
     await recorded({
         app: definition.app,
-        command: `${options.agent ? "mcp " : ""}${path || definition.app.command}`,
+        command,
+        context: runContextOf({
+            bin: definition.app.command,
+            command: path ? command : options.agent ? "mcp" : "",
+            program,
+            argv,
+            env,
+        }),
         profile: settings ? namedProfile(settings) : profile,
         record: false,
         keepFailed: settings?.keepFailedRuns ?? !rest.includes("--no-record"),

package/dist/cli/runs/search.js

@@ -8,6 +8,8 @@ const FIELDS = [
     "opcode",
     "seq",
     "status",
+    "method",
+    "endpoint_template",
     "bytes",
     "ids",
     "counts",

package/dist/cli/settings.js

@@ -7,7 +7,7 @@ import { envName, readOnlyLockOf } from "../ports/app.js";
 import { assertOverridesTighten, CEILING_KEY, LEVELS, layerPermissions, permissionOverrides, RESOURCES, } from "../sends/permissions.js";
 import { storePath } from "../store/path.js";
 import { sharedConfigPath } from "../store/shared-config.js";
-import { issueMessage, parseConfigText, publicIssue, savedPermissionKeys, schemaIssues, withoutIssues, } from "./config-issues.js";
+import { checkConfigText, issueMessage, parseConfigText, publicIssue, savedPermissionKeys, schemaIssues, } from "./config-issues.js";
 import { DEFAULT_CONFIG, ensureDefaultConfig } from "./default-config.js";
 import { profilesHere } from "./messenger/accounts.js";
 import { usableProfileName } from "./profile.js";
@@ -157,14 +157,15 @@ export const settingsFor = (app, extension = {}) => {
     };
     /** The file with every problem found; what loads is the file without the settings they name. */
     const loadConfig = (path) => {
-        const read = readRaw(path);
-        if ("issue" in read)
-            return { config: { profiles: {} }, issues: [read.issue], raw: undefined };
-        if (read.raw === undefined)
-            return { config: { profiles: {} }, issues: [], raw: undefined };
-        const issues = schemaIssues(read.raw, readSchema, context(path));
-        const parsed = v.safeParse(readSchema, withoutIssues(read.raw, issues));
-        return { config: (parsed.success ? parsed.output : { profiles: {} }), issues, raw: read.raw };
+        let text;
+        try {
+            text = readFileSync(path, "utf8");
+        }
+        catch {
+            return { config: { profiles: {} }, issues: [] };
+        }
+        const { config, issues } = checkConfigText(text, { file: path, tool: app.command, schema: readSchema });
+        return { config: (config ?? { profiles: {} }), issues };
     };
     /**
      * A lock pins a process to one profile: the owner sets it where an agent runs, and a first word
@@ -207,7 +208,7 @@ export const settingsFor = (app, extension = {}) => {
         }
         const loaded = loadConfig(configPath);
         if (loaded.issues.length > 0 && !options.withIssues)
-            throw new CliError("configuration_error", issueMessage(loaded.issues.map(publicIssue)));
+            throw new CliError("configuration_error", issueMessage(loaded.issues));
         const { config } = loaded;
         const lock = given(env[PROFILE_LOCK]);
         const named = first([
@@ -330,7 +331,7 @@ export const settingsFor = (app, extension = {}) => {
             },
             configured,
             shared,
-            configIssues: loaded.issues.map(publicIssue),
+            configIssues: loaded.issues,
             savedPermissions: savedPermissionKeys(config),
         };
         // The file was checked by the schema; a flag was not, and `--limit abc` is `NaN` by the time it
@@ -351,7 +352,7 @@ export const settingsFor = (app, extension = {}) => {
     const configuredProfiles = (options = {}) => {
         const { config, issues } = loadConfig(configPathFor(options));
         if (issues.length > 0 && !options.withIssues)
-            throw new CliError("configuration_error", issueMessage(issues.map(publicIssue)));
+            throw new CliError("configuration_error", issueMessage(issues));
         return namedProfiles(config);
     };
     /**

package/dist/cli/shared-command-exports.js

@@ -5,6 +5,7 @@ import { botMcpCommand as botMcpCommandDefinition } from "./bot/mcp.js";
 import { botMessagesCommand as botMessagesCommandDefinition } from "./bot/messages.js";
 import { commandsCommand as commandsCommandDefinition } from "./commands-command.js";
 import { configCommand as configCommandDefinition } from "./config-command.js";
+import { honoursDryRun } from "./dry-run-guard.js";
 import { guideCommand as guideCommandDefinition } from "./guide.js";
 import { addMeetingBatchCommand as addMeetingBatchCommandDefinition } from "./meeting-batch.js";
 import { addMeetingPreparationCommand as addMeetingPreparationCommandDefinition } from "./meeting-preparation-command.js";
@@ -48,9 +49,10 @@ import { tasksCommand as tasksCommandDefinition, tasksStatsCommand as tasksStats
 import { topicsCommand as topicsCommandDefinition } from "./messenger/topics-command.js";
 import { watchCommand as watchCommandDefinition } from "./messenger/watch-command.js";
 import { runsCommand as runsCommandDefinition } from "./runs/command.js";
-import { sharedCommand } from "./shared-contracts.js";
+import { sharedCommand as protectedCommand } from "./shared-contracts.js";
 import { skillCommand as skillCommandDefinition } from "./skill-command.js";
 import { upgradeCommand as upgradeCommandDefinition } from "./upgrade-command.js";
+const sharedCommand = (factory) => honoursDryRun(protectedCommand(factory));
 export const botAdminsCommand = sharedCommand(botAdminsCommandDefinition);
 export const botMembersCommand = sharedCommand(botMembersCommandDefinition);
 export const generatedApiCommand = sharedCommand(generatedApiCommandDefinition);

package/dist/entities/index.d.ts

@@ -7016,6 +7016,34 @@ export declare const ENTITIES: {
         readonly operations: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly codes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly trace_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly cli_command: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly argv: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly unknown_command: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly agent: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly kind: v.StringSchema<undefined>;
+            readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly error: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly class: v.StringSchema<undefined>;
+            readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly reason: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly message: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly operation: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly http: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly method: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly endpoint_template: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly status: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            }, undefined>, undefined>;
+            readonly provider: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly key: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly code: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly causes: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly class: v.StringSchema<undefined>;
+                readonly message: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
+            readonly stack: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
         readonly directory: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly event_count: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly events: v.OptionalSchema<v.ArraySchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
@@ -7050,6 +7078,34 @@ export declare const ENTITIES: {
         readonly operations: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly codes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly trace_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly cli_command: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly argv: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly unknown_command: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly agent: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly kind: v.StringSchema<undefined>;
+            readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly error: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly class: v.StringSchema<undefined>;
+            readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly reason: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly message: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly operation: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly http: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly method: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly endpoint_template: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly status: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            }, undefined>, undefined>;
+            readonly provider: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly key: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly code: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly causes: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly class: v.StringSchema<undefined>;
+                readonly message: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
+            readonly stack: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
         readonly directory: v.StringSchema<undefined>;
         readonly event_count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly events: v.ArraySchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
@@ -7083,6 +7139,34 @@ export declare const ENTITIES: {
         readonly operations: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly codes: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly trace_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly cli_command: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly argv: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly unknown_command: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly agent: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly kind: v.StringSchema<undefined>;
+            readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly error: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly class: v.StringSchema<undefined>;
+            readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly reason: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly message: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly operation: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly http: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly method: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly endpoint_template: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly status: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            }, undefined>, undefined>;
+            readonly provider: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly key: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly code: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly causes: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly class: v.StringSchema<undefined>;
+                readonly message: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
+            readonly stack: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
         readonly events: v.ArraySchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         readonly events_truncated: v.BooleanSchema<undefined>;
     }, undefined>;
@@ -9352,6 +9436,42 @@ export declare const ENTITIES: {
         opens: v.LiteralSchema<false, undefined>;
         error: v.StringSchema<undefined>;
     }, undefined>, v.StrictObjectSchema<{
+        readonly by_provider: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly chats: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly emails: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly documents: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly provider: v.StringSchema<undefined>;
+            readonly accounts: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, undefined>, undefined>, undefined>;
+        readonly by_chat_kind: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly provider: v.StringSchema<undefined>;
+            readonly kind: v.StringSchema<undefined>;
+            readonly chats: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, undefined>, undefined>, undefined>;
+        readonly by_account: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly chats: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly emails: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly documents: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly provider: v.StringSchema<undefined>;
+            readonly account_id: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly by_year: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly provider: v.StringSchema<undefined>;
+            readonly year: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, undefined>, undefined>, undefined>;
+        readonly by_attachment_kind: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly type: v.StringSchema<undefined>;
+            readonly kind: v.StringSchema<undefined>;
+            readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, undefined>, undefined>, undefined>;
         readonly path: v.StringSchema<undefined>;
         readonly exists: v.LiteralSchema<true, undefined>;
         readonly bytes: v.StrictObjectSchema<{
@@ -9368,6 +9488,10 @@ export declare const ENTITIES: {
             readonly accounts: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
             readonly chats: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
             readonly messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly emails: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly documents: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly events: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
             readonly attachments: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
             readonly identities: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -9375,6 +9499,10 @@ export declare const ENTITIES: {
                 readonly accounts: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
                 readonly chats: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
                 readonly messages: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly emails: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly documents: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly meetings: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly events: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
                 readonly attachments: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
                 readonly identities: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
             };
@@ -9382,12 +9510,20 @@ export declare const ENTITIES: {
                 accounts?: number | undefined;
                 chats?: number | undefined;
                 messages?: number | undefined;
+                emails?: number | undefined;
+                documents?: number | undefined;
+                meetings?: number | undefined;
+                events?: number | undefined;
                 attachments?: number | undefined;
                 identities?: number | undefined;
             }, {
                 accounts?: number | undefined;
                 chats?: number | undefined;
                 messages?: number | undefined;
+                emails?: number | undefined;
+                documents?: number | undefined;
+                meetings?: number | undefined;
+                events?: number | undefined;
                 attachments?: number | undefined;
                 identities?: number | undefined;
             }>;
@@ -9395,6 +9531,10 @@ export declare const ENTITIES: {
                 accounts?: number | undefined;
                 chats?: number | undefined;
                 messages?: number | undefined;
+                emails?: number | undefined;
+                documents?: number | undefined;
+                meetings?: number | undefined;
+                events?: number | undefined;
                 attachments?: number | undefined;
                 identities?: number | undefined;
             }, v.IntegerIssue<number> | v.MinValueIssue<number, 0> | v.NumberIssue | v.StrictObjectIssue>;
@@ -9403,6 +9543,10 @@ export declare const ENTITIES: {
                     accounts?: number | undefined;
                     chats?: number | undefined;
                     messages?: number | undefined;
+                    emails?: number | undefined;
+                    documents?: number | undefined;
+                    meetings?: number | undefined;
+                    events?: number | undefined;
                     attachments?: number | undefined;
                     identities?: number | undefined;
                 };
@@ -9410,6 +9554,10 @@ export declare const ENTITIES: {
                     accounts?: number | undefined;
                     chats?: number | undefined;
                     messages?: number | undefined;
+                    emails?: number | undefined;
+                    documents?: number | undefined;
+                    meetings?: number | undefined;
+                    events?: number | undefined;
                     attachments?: number | undefined;
                     identities?: number | undefined;
                 };