@wirecat/cli-core 0.424.0 → 0.426.0

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;
                 };

package/dist/entities/recorded-run.d.ts

@@ -28,6 +28,34 @@ export declare const recordedRun: v.StrictObjectSchema<{
     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>;
@@ -62,6 +90,34 @@ export declare const runDetails: v.StrictObjectSchema<{
     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>;
@@ -95,6 +151,34 @@ export declare const runHit: v.StrictObjectSchema<{
     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>;

package/dist/entities/recorded-run.js

@@ -25,6 +25,21 @@ export const recordedRun = v.strictObject({
     operations: v.optional(v.array(text)),
     codes: v.optional(v.array(text)),
     trace_id: v.optional(id),
+    cli_command: v.optional(text),
+    argv: v.optional(v.array(text)),
+    unknown_command: v.optional(text),
+    agent: v.optional(v.strictObject({ kind: text, session_id: v.nullable(text) })),
+    error: v.optional(v.strictObject({
+        class: text,
+        code: v.optional(text),
+        reason: v.optional(text),
+        message: v.optional(text),
+        operation: v.optional(text),
+        http: v.optional(v.strictObject({ method: v.optional(text), endpoint_template: v.optional(text), status: v.optional(count) })),
+        provider: v.optional(v.strictObject({ key: v.optional(text), code: v.optional(v.number()) })),
+        causes: v.optional(v.array(v.strictObject({ class: text, message: v.optional(text) }))),
+        stack: v.optional(v.array(text)),
+    })),
     directory: v.optional(text),
     event_count: v.optional(count),
     events: v.optional(events),

package/dist/entities/store-maintenance.d.ts

@@ -8,6 +8,42 @@ export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
     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<{
@@ -24,6 +60,10 @@ export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
         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"> & {
@@ -31,6 +71,10 @@ export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
             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>;
         };
@@ -38,12 +82,20 @@ export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
             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;
         }>;
@@ -51,6 +103,10 @@ export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
             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>;
@@ -59,6 +115,10 @@ export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
                 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;
             };
@@ -66,6 +126,10 @@ export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
                 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;
             };

package/dist/entities/store-maintenance.js

@@ -23,7 +23,29 @@ const stemIndex = v.strictObject({
     built_at: v.nullable(time),
 });
 const readFailure = { path: text, exists: v.literal(true), opens: v.literal(false), error: text };
-const rows = v.partial(v.strictObject({ accounts: count, chats: count, messages: count, attachments: count, identities: count }));
+const rows = v.partial(v.strictObject({
+    accounts: count,
+    chats: count,
+    messages: count,
+    emails: count,
+    documents: count,
+    meetings: count,
+    events: count,
+    attachments: count,
+    identities: count,
+}));
+const perAccount = { chats: count, messages: count, emails: count, documents: count, meetings: count };
+/** Over every account in the store; absent for a file with no schema yet. */
+const contents = {
+    by_provider: v.optional(v.array(v.strictObject({ provider: text, accounts: count, ...perAccount }))),
+    by_chat_kind: v.optional(v.array(v.strictObject({ provider: text, kind: text, chats: count, messages: count }))),
+    /** `name` is the one `account list` shows; the messenger's own id for the account is left out. */
+    by_account: v.optional(v.array(v.strictObject({ provider: text, account_id: count, name: v.nullable(text), ...perAccount }))),
+    /** Calendar years in UTC. */
+    by_year: v.optional(v.array(v.strictObject({ provider: text, year: count, messages: count }))),
+    /** `type` is what the file is attached to: a message, an email, a document… `bytes` counts the sizes known. */
+    by_attachment_kind: v.optional(v.array(v.strictObject({ type: text, kind: text, count, bytes: count }))),
+};
 export const storeInfo = v.union([
     absent,
     v.strictObject(readFailure),
@@ -36,6 +58,7 @@ export const storeInfo = v.union([
         pending_normalization: v.nullable(count),
         word_index: v.nullable(wordIndex),
         stem_index: v.nullable(stemIndex),
+        ...contents,
     }),
 ]);
 export const storeCheck = v.union([

package/dist/mcp/agent.js

@@ -127,8 +127,8 @@ export const toolsFromCommands = (commands, options = {}) => {
     const { root = [], exclude = [], levels, keyOf, authority, readOnly = false } = options;
     return flatten(commands)
         .filter((info) => 
-    // Only a group that declares effects can run without a leaf.
-    (info.commands.length === 0 || info.effects !== undefined) &&
+    // A group is offered only when it runs on its own; without an action it only prints its help.
+    (info.commands.length === 0 || info.runnable === true) &&
         info.path.length > root.length &&
         startsWith(info.path, root) &&
         !exclude.some((skipped) => startsWith(info.path.slice(root.length), skipped)) &&
@@ -184,8 +184,7 @@ const argvOf = (info, input, profile, stdin) => {
 export const runCommandForAgent = async (program, path, input, ctx) => {
     try {
         const info = flatten(program.commands).find((one) => one.path.length === path.length && startsWith(one.path, path));
-        // Runnable groups declare effects, as `toolsFromCommands` offers them.
-        if (!info || (info.commands.length > 0 && info.effects === undefined))
+        if (!info || (info.commands.length > 0 && info.runnable !== true))
             throw new CliError("validation_error", `no command "${path.join(" ")}" to run`);
         if (info.lifetime)
             throw new CliError("validation_error", `"${path.join(" ")}" runs until it is stopped; an agent call must return`);