@wirecat/cli-template 0.13.1 → 0.14.0

package/dist/bundle/{chunk-35KYY65W.js → chunk-SOYOOU2D.js}

@@ -2,15 +2,15 @@ import { createRequire as __bundleRequire } from "node:module";
 const require = __bundleRequire(import.meta.url);
 import {
   unit
-} from "./chunk-QKWRL4OD.js";
+} from "./chunk-DQIBGCF3.js";
 import {
   CliError
-} from "./chunk-EFHLQXG6.js";
+} from "./chunk-IOJ2DTCY.js";
 import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/embeddings/remote.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/embeddings/remote.js
 import { setTimeout } from "node:timers/promises";
 var OPENAI_URL = "https://api.openai.com/v1";
 var OPENAI_MODELS = {

package/dist/bundle/{chunk-FDBINRWA.js → chunk-TJJ2XSJP.js}

@@ -2,21 +2,21 @@ import { createRequire as __bundleRequire } from "node:module";
 const require = __bundleRequire(import.meta.url);
 import {
   storePath
-} from "./chunk-IDWW4TU2.js";
+} from "./chunk-62JRF2JA.js";
 import {
   CliError,
   resolvePaths,
   singleLine
-} from "./chunk-EFHLQXG6.js";
+} from "./chunk-IOJ2DTCY.js";
 import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/store/shared-config.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/store/shared-config.js
 import { mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/domain/task-categories.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/domain/task-categories.js
 var DEFAULT_TASK_CATEGORIES = [
   {
     name: "taxes",
@@ -771,7 +771,7 @@ var storedTaskCategories = /* @__PURE__ */ __name((json) => {
   }
 }, "storedTaskCategories");
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/store/shared-config.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/store/shared-config.js
 var SECTION = "task_categories";
 var sharedConfigPath = /* @__PURE__ */ __name((store, env = process.env) => {
   const paths = resolvePaths({ appName: "WireCat", prefix: "WIRECAT", env });

package/dist/bundle/{chunk-O3UXNU3S.js → chunk-U6QD3J3F.js}

@@ -3,15 +3,15 @@ const require = __bundleRequire(import.meta.url);
 import {
   readSharedSection,
   writeSharedSection
-} from "./chunk-FDBINRWA.js";
+} from "./chunk-TJJ2XSJP.js";
 import {
   CliError
-} from "./chunk-EFHLQXG6.js";
+} from "./chunk-IOJ2DTCY.js";
 import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/cli/setup-answers.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/cli/setup-answers.js
 var PERMISSION_ANSWERS = ["readonly", "allow"];
 var QUESTIONS = ["languages", "tools", "permissions"];
 var SECTION = "setup";

package/dist/bundle/{chunk-YJNUDHJD.js → chunk-UT5TQ6MD.js}

@@ -7,25 +7,24 @@ import {
   agentJson,
   commandAvailability,
   failureContext
-} from "./chunk-4LURWBVV.js";
+} from "./chunk-HYTHTSJP.js";
 import {
   callerOf
-} from "./chunk-IBBN7Z3A.js";
+} from "./chunk-F34HGYWF.js";
 import {
+  QUERY_ARGUMENT,
   lentConnection,
   onlineDeps,
   refuseLacking,
   servicesFor,
   storeModeDeps
-} from "./chunk-FZZIU4B7.js";
+} from "./chunk-5SAF3XOL.js";
 import {
   MAX_BUFFERED_INPUT
-} from "./chunk-KJTNT4SW.js";
-import {
-  ENTITIES
-} from "./chunk-MUSYGFCY.js";
+} from "./chunk-2DAXUNTS.js";
 import {
   DEFAULT_OUTPUT_BYTES,
+  ENTITIES,
   LOCAL_WRITE,
   REMOTE_WRITE,
   answerSchema,
@@ -46,14 +45,18 @@ import {
   sealed,
   startRecording,
   traceOf
-} from "./chunk-QJ6XW4DM.js";
+} from "./chunk-RJ7AS7UB.js";
 import {
   currentCaller,
   keepsSuccess,
   runContextOf,
   withCaller
-} from "./chunk-MJRSEUKG.js";
+} from "./chunk-VXOR76ZL.js";
+import {
+  queryDescription
+} from "./chunk-YOJLIVGO.js";
 import {
+  COMPACT_FLAG,
   CliError,
   SNAKE_CASE,
   array,
@@ -94,15 +97,15 @@ import {
   unknown,
   word,
   writes
-} from "./chunk-EFHLQXG6.js";
+} from "./chunk-IOJ2DTCY.js";
 import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/mcp/agent.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/mcp/agent.js
 import { Readable } from "node:stream";
 
-// node_modules/.pnpm/@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/lint.js
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/lint.js
 var LINT_SEVERITIES = ["high", "medium", "low"];
 var lintRuleSchema = strictObject({
   id: word,
@@ -220,16 +223,17 @@ var LINT_RULES = defineLintRules([
   }
 ]);
 var baselineSchema = array(text);
-var overridesSchema = array(strictObject({
+var overrideSchema = strictObject({
   rule: word,
   target: text,
   reason: pipe(text, minLength(10, "say why, in a sentence")),
   /** A GitHub handle or a team, `@octocat`. */
   owner: pipe(string(), regex(/^@[\w.-]+(\/[\w.-]+)?$/, "a GitHub handle or team, such as @octocat")),
   review_after: pipe(string(), isoDate("a date, YYYY-MM-DD"))
-}));
+});
+var overridesSchema = array(overrideSchema);
 
-// node_modules/.pnpm/@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/audit.js
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/audit.js
 var auditRuleSchema = strictObject({ id: word, severity: picklist(LINT_SEVERITIES), summary: text });
 var defineAuditRules = /* @__PURE__ */ __name((input) => parseRegistry("audit rules", array(auditRuleSchema), input, (rules) => duplicates(rules.map((rule) => rule.id)).map((id) => `"${id}" is listed twice`)), "defineAuditRules");
 var AUDIT_RULES = defineAuditRules([
@@ -274,22 +278,49 @@ var parityGroupSchema = strictObject({
   /** Permanent differences, each with its reason; they count against the override budget of the group. */
   differences: array(strictObject({
     rule: word,
+    /** `<clis> <path> <flag>`; with `absent`, only `<path> <flag>`: the CLI list is whoever else has it. */
     target: text,
     expected: optional(text),
+    /** The CLI that lacks the path or flag by design; the rest must agree, so other CLIs joining do not stale it. */
+    absent: optional(word),
     reason: pipe(text, minLength(10, "say why, in a sentence"))
   }))
 });
 var defineParityGroups = /* @__PURE__ */ __name((input) => parseRegistry("parity groups", array(parityGroupSchema), input, (groups) => [
   ...duplicates(groups.map((group) => group.name)).map((name) => `"${name}" is listed twice`),
-  ...groups.flatMap((group) => duplicates(group.differences.map((entry) => `${entry.rule} ${entry.target}`)).map((both) => `${group.name}: "${both}" is listed twice`))
+  ...groups.flatMap((group) => [
+    ...duplicates(group.differences.map((entry) => `${entry.rule} ${entry.target}`)).map((both) => `${group.name}: "${both}" is listed twice`),
+    ...group.differences.filter((entry) => entry.absent && entry.expected).map((entry) => `${group.name}: "${entry.target}" has \`absent\`, which measures the values itself; drop \`expected\``)
+  ])
 ]), "defineParityGroups");
+var MEMO_HAS_NO_PROFILES = [
+  "mcp serve",
+  "mcp revoke",
+  "mcp server start",
+  "mcp server status",
+  "mcp server stop"
+].map((path) => ({
+  rule: "same-path-contract",
+  target: `${path} --profiles`,
+  absent: "memo",
+  reason: "memo has no profiles: it reads other CLIs' stores and selects their accounts with --source and --account (https://github.com/WireCatLabs/cli-base/issues/390)"
+}));
 var PARITY_GROUPS = defineParityGroups([
   { name: "messengers", members: ["tg", "max"], covers: "tree", differences: [] },
   {
     name: "all",
     members: ["tg", "max", "memo", "drive", "zm", "wa"],
     covers: ["commands", "doctor", "skill", "mcp", "upgrade", "search", "notes", "meetings"],
-    differences: []
+    differences: MEMO_HAS_NO_PROFILES
+  },
+  // mail's `search messages` is cli-core's mail search, not the messengers' command: --complete took their 20-odd
+  // differences as inherited (https://github.com/WireCatLabs/cli-base/issues/390). mail is compared everywhere else
+  // and moves back into "all" once its search is aligned with the messengers' or renamed.
+  {
+    name: "mail-shared",
+    members: ["tg", "max", "memo", "drive", "zm", "wa", "mail"],
+    covers: ["commands", "doctor", "skill", "mcp", "upgrade", "notes", "meetings"],
+    differences: MEMO_HAS_NO_PROFILES
   },
   // gcal is compared on what it already shares with every CLI; doctor, mcp, search and skill wait until the published
   // CLIs agree there (https://github.com/WireCatLabs/cli-base/issues/390), then gcal moves back into "all".
@@ -311,7 +342,7 @@ var REQUIRED_ROOTS = defineRequiredRoots([
   { path: ["upgrade"], meaning: "updates the CLI" }
 ]);
 
-// node_modules/.pnpm/@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/fields.js
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/fields.js
 var fieldRuleSchema = strictObject({ id: word, rule: text });
 var defineFieldRules = /* @__PURE__ */ __name((input) => parseRegistry("output field rules", array(fieldRuleSchema), input, (rules) => duplicates(rules.map((rule) => rule.id)).map((id) => `"${id}" is listed twice`)), "defineFieldRules");
 var FIELD_RULES = defineFieldRules([
@@ -327,7 +358,7 @@ var FIELD_RULES = defineFieldRules([
   }
 ]);
 
-// node_modules/.pnpm/@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/identifiers.js
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/identifiers.js
 var key = pipe(string(), regex(SNAKE_CASE, "a snake_case key"));
 var identifierSchema = strictObject({ key, meaning: text, replaces: optional(array(key)) });
 var defineIdentifiers = /* @__PURE__ */ __name((input) => parseRegistry("identifiers", array(identifierSchema), input, (identifiers) => {
@@ -349,7 +380,7 @@ var IDENTIFIERS = defineIdentifiers([
   { key: "trace_id", meaning: "the distributed trace a run belongs to, from `traceparent`" }
 ]);
 
-// node_modules/.pnpm/@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/flags-calendar.js
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/flags-calendar.js
 var CALENDAR_FLAGS = [
   { name: "--end-time", value: "<time>", role: "value", type: "time", meaning: "when it ends" },
   {
@@ -423,7 +454,7 @@ var CALENDAR_FLAGS = [
   }
 ];
 
-// node_modules/.pnpm/@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/flags-how.js
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/flags-how.js
 var HOW_FLAGS = [
   {
     name: "--limit",
@@ -510,6 +541,12 @@ var HOW_FLAGS = [
     type: "switch",
     meaning: "each item as its reference, title, time and excerpt only"
   },
+  {
+    name: COMPACT_FLAG,
+    role: "output",
+    type: "switch",
+    meaning: "one line per item, built from the same answer as --json, with its paging and next steps as # lines"
+  },
   {
     name: "--chart-kind",
     value: "<messages|active|membership>",
@@ -701,6 +738,7 @@ var HOW_FLAGS = [
     meaning: "refuse if what it names has changed since it was read",
     replaces: ["--expected"]
   },
+  { name: "--full-history", role: "mode", type: "switch", meaning: "keep a chat's whole history, past its limits" },
   {
     name: "--for-everyone",
     role: "mode",
@@ -801,6 +839,13 @@ var HOW_FLAGS = [
     type: "string",
     meaning: "the browser program to open for sign-in"
   },
+  {
+    name: "--credential-storage",
+    value: "<storage>",
+    role: "mode",
+    type: "choice",
+    meaning: "where a sign-in is kept: keyring, which falls back to a private file by itself, or file (WC-SECR-4)"
+  },
   { name: "--checkpoint", value: "<file>", role: "mode", type: "path", meaning: "keep resume progress in this file" },
   {
     name: "--expected-event-id",
@@ -1403,7 +1448,37 @@ var HOW_FLAGS = [
   }
 ];
 
-// node_modules/.pnpm/@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/flags-what.js
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/flags-mail.js
+var MAIL_FLAGS = [
+  {
+    name: "--cc",
+    value: "<address>",
+    role: "value",
+    type: "string",
+    meaning: "an e-mail address that gets a copy; repeat it for more"
+  },
+  {
+    name: "--bcc",
+    value: "<address>",
+    role: "value",
+    type: "string",
+    meaning: "an e-mail address that gets a blind copy; repeat it for more"
+  },
+  {
+    name: "--reply-all",
+    role: "value",
+    type: "switch",
+    meaning: "with --reply-to, an e-mail reply also goes to everyone the message went to"
+  },
+  {
+    name: "--trimmed",
+    role: "output",
+    type: "switch",
+    meaning: "each e-mail's own text, without the quoted earlier mail and the signature; refused with --full"
+  }
+];
+
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/flags-what.js
 var WHAT_FLAGS = [
   {
     name: "--analysis-provider",
@@ -1848,7 +1923,14 @@ var WHAT_FLAGS = [
     meaning: "keep a token an operation returns only in this bot profile's keyring; never print it"
   },
   { name: "--task", value: "<id>", role: "target", type: "id", meaning: "a task, by id" },
-  { name: "--to", value: "<chat>", role: "target", type: "id", meaning: "the chat it goes to" },
+  {
+    name: "--to",
+    value: "<chat>",
+    role: "target",
+    type: "id",
+    otherValues: ["address"],
+    meaning: "who it goes to: a chat in a messenger (<chat>), an e-mail address in mail (<address>, repeated for more)"
+  },
   {
     name: "--topic-name",
     value: "<name>",
@@ -2298,7 +2380,8 @@ var WHAT_FLAGS = [
     value: "<ref>",
     role: "value",
     type: "string",
-    meaning: "what it is about, as a reference",
+    otherValues: ["text"],
+    meaning: "what it is about: a reference in a note or task (<ref>), the subject line in mail (<text>)",
     replaces: ["--about"]
   },
   {
@@ -2393,7 +2476,7 @@ var WHAT_FLAGS = [
   }
 ];
 
-// node_modules/.pnpm/@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/vocabulary.js
+// node_modules/.pnpm/@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_typescript@7.0.2_vitest@5.0.5/node_modules/@wirecat/cli-base/dist/standards/vocabulary.js
 var FLAG_TYPES = [
   "switch",
   "count",
@@ -2435,6 +2518,11 @@ var flagSchema = strictObject({
   type: picklist(FLAG_TYPES),
   role: picklist(Object.keys(FLAG_ROLES)),
   meaning: text,
+  /**
+   * Value names a domain other than the main one gives the flag, such as mail's `--to <address>` beside the
+   * messengers' `<chat>`. The meaning for each says which is which. `flag-two-meanings` accepts these and no others.
+   */
+  otherValues: optional(array(pipe(string(), regex(/^[a-z][a-z0-9-]*$/, "a value name such as address")))),
   unit: optional(text),
   /** Other names for the same flag, which `flag-synonym` refuses. */
   replaces: optional(array(pipe(string(), regex(/^--[a-z][a-z0-9]*(-[a-z0-9]+)*$/, "a long flag"))))
@@ -2544,6 +2632,7 @@ var verbs = [
   ["vote", "answer a poll"],
   ["answer", "reply to a button someone pressed under a bot's message"],
   ["respond", "answer an invitation: accept, tentatively accept or decline it"],
+  ["remind", "tell the owner once about what starts soon: print it, or run the owner's own program for it"],
   ["press", "press a button under a bot's message; the bot sees who pressed it"],
   ["action", "show what a bot is doing in a chat, such as typing, for a few seconds"],
   ["watch", "follow new events as they come, and keep them"],
@@ -2571,6 +2660,10 @@ var verbs = [
   ["move", "move a thing to another place in the source: a file to a folder, an event to a calendar"],
   ["copy", "copy a file in the source"],
   ["run", "run a saved job once, now, as its timer would"],
+  ["exec", "what a timer itself starts: one saved schedule, from its file; a person uses run"],
+  // schedule's creators are named for what the timer starts; the owner kept these names over `create --kind`.
+  ["agent", "save a timer that starts an agent with a prompt, read-only; a verb under schedule, never a resource"],
+  ["command", "save a timer that runs one of this tool's own commands; a verb under schedule"],
   ["claim", "take a thing for a while so no other agent works it at once; the claim lapses by itself"],
   ["release", "give back what claim took, before it lapses"],
   ["merge", "fold a duplicate into the thing that stays; nothing is deleted"],
@@ -2598,6 +2691,7 @@ var collections = [
   ["chats", "conversations in a messenger"],
   ["contacts", "identities in a messenger's contact list"],
   ["messages", "posts in a messenger chat, or emails"],
+  ["drafts", "e-mails saved in a mailbox's Drafts folder, written and not sent"],
   ["polls", "polls in a chat"],
   ["reactions", "reactions to a message"],
   ["recipients", "who a message goes to"],
@@ -2640,6 +2734,10 @@ var collections = [
   ["recordings", "the files a provider recorded of a meeting"],
   ["jobs", "work this tool runs in the background or on a timer"],
   ["actions", "what an agent proposes to do; the owner confirms or rejects each"],
+  [
+    "findings",
+    "what an agent read in stored mail, staged in batches with citations; nothing is recorded until the owner confirms. What it proposes to do is actions"
+  ],
   ["agents", "the agents whose actions are recorded in the shared store"],
   ["reminders", "scheduled notices about stored work, claimed and acknowledged with delivery receipts"],
   ["key-documents", "selected source documents that a project keeps as its starting references"],
@@ -2681,7 +2779,11 @@ var singulars = [
   ["api", "the source's own API, one command per operation"],
   ["privacy", "who may find, see, call or add the account"],
   ["metadata", "a profile's cached source attributes"],
-  ["auth", "the credentials a bot profile uses: its token and the secrets beside it"]
+  ["auth", "the credentials a bot profile uses: its token and the secrets beside it"],
+  [
+    "schedule",
+    "a profile's timers the owner saved, each running a command of this tool or an agent; the tool's own background work is jobs"
+  ]
 ];
 var views = [
   ["tree", "the parent and child hierarchy of stored sources"],
@@ -2744,10 +2846,10 @@ var VOCABULARY = defineVocabulary({
   ],
   views: views.map(([entry, meaning]) => ({ word: entry, meaning })),
   roots: roots.map(([entry, meaning]) => ({ word: entry, meaning })),
-  flags: [...HOW_FLAGS, ...WHAT_FLAGS, ...CALENDAR_FLAGS]
+  flags: [...HOW_FLAGS, ...WHAT_FLAGS, ...CALENDAR_FLAGS, ...MAIL_FLAGS]
 });
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/mcp/agent.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/mcp/agent.js
 var TYPES = new Map(VOCABULARY.flags.map((flag) => [flag.name, flag.type]));
 var snake = /* @__PURE__ */ __name((name) => name.replaceAll("|", "_or_").replace(/[^a-z0-9]+/gi, "_"), "snake");
 var longOf = /* @__PURE__ */ __name((option) => option.flags.match(/--[a-z0-9][a-z0-9-]*/)?.[0], "longOf");
@@ -2806,8 +2908,10 @@ var optionField = /* @__PURE__ */ __name((option, long, negated) => {
     }, "argv")
   };
 }, "optionField");
-var argumentField = /* @__PURE__ */ __name((argument) => {
-  const one = argument.choices ? pipe(picklist(argument.choices), description(argument.description)) : text2(argument.description || argument.name);
+var argumentField = /* @__PURE__ */ __name((argument, query) => {
+  const own = argument.description || argument.name;
+  const about = query && argument.name === "query" ? own === QUERY_ARGUMENT ? queryDescription(query) : `${own}; ${queryDescription(query)}` : own;
+  const one = argument.choices ? pipe(picklist(argument.choices), description(argument.description)) : text2(about);
   return {
     name: snake(argument.name),
     required: argument.required,
@@ -2833,7 +2937,7 @@ var stdinField = /* @__PURE__ */ __name(({ name, description: description2, json
   argv: /* @__PURE__ */ __name(() => [], "argv")
 }), "stdinField");
 var fieldsOf = /* @__PURE__ */ __name((info, { omit = [], offline = false, stdin }) => {
-  const fields = info.arguments.map(argumentField);
+  const fields = info.arguments.map((argument) => argumentField(argument, info.query));
   const read = stdin?.(info.path);
   if (read)
     fields.push(stdinField(read));
@@ -2968,7 +3072,7 @@ var runCommandForAgent = /* @__PURE__ */ __name(async (program, path, input, ctx
   }
 }, "runCommandForAgent");
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/mcp/tool.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/mcp/tool.js
 var limit = optional(pipe(number(), integer(), minValue(1), maxValue(100), description("how many")));
 var page = optional(pipe(number(), integer(), minValue(1), description("which page, from 1")));
 var message = pipe(
@@ -3082,7 +3186,7 @@ var entryRunner = /* @__PURE__ */ __name((registration) => {
       ...outcomeOf(result),
       startedAt,
       finishedAt: Date.now()
-    })?.catch(() => void 0);
+    }, caller)?.catch(() => void 0);
     return result;
   };
 }, "entryRunner");
@@ -3227,7 +3331,7 @@ var failed = /* @__PURE__ */ __name((error, errors, effects) => {
   return mcpErrorResult(JSON.parse(agentJson(errorObjectOf(error, context))));
 }, "failed");
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/mcp/surface.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/mcp/surface.js
 import { randomUUID } from "node:crypto";
 var MATCHES = 8;
 var ANSWER = answerSchema();
@@ -3250,7 +3354,7 @@ var runnableOnly = /* @__PURE__ */ __name((result, offered) => {
   const body = result.structuredContent;
   if (result.isError || !Array.isArray(body?.next))
     return result;
-  const next = body.next.filter((step) => offered(step.command));
+  const next = body.next.filter((step) => step.command === void 0 || offered(step.command));
   const { next: _, ...rest } = body;
   const kept = next.length > 0 ? { ...rest, next } : rest;
   return {

package/dist/bundle/{chunk-VYSUKHKL.js → chunk-VOTEB3AN.js}

@@ -4,7 +4,7 @@ import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/background/processes.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/background/processes.js
 import { execFileSync } from "node:child_process";
 import { readdirSync, readFileSync, readlinkSync } from "node:fs";
 var alive = /* @__PURE__ */ __name((pid) => {

package/dist/bundle/{chunk-IN3FVRPK.js → chunk-VS5LGSTM.js}

@@ -4,7 +4,7 @@ import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.495.0_@wirecat+cli-base@0.65.0_commander@15.0.0_esbuild@0.28.2_type_24cca5e5c8b0984f2f26e7d1ba6b6d47/node_modules/@wirecat/cli-core/dist/mcp/stdio-wire.js
+// node_modules/.pnpm/@wirecat+cli-core@0.584.0_@wirecat+cli-base@0.77.1_commander@15.0.0_esbuild@0.28.2_type_ab8c0b68b8b4768d5b87d6e249ef10da/node_modules/@wirecat/cli-core/dist/mcp/stdio-wire.js
 import { PassThrough, Writable } from "node:stream";
 var lineReader = /* @__PURE__ */ __name((onMessage) => {
   let rest = "";