@wirecat/cli-core 0.411.0 → 0.412.0

package/CHANGELOG.md

@@ -6,6 +6,24 @@ minor version may break callers, and says how under "Changed — may break calle
 shape of this file.
 
 
+## 0.412.0 — 24.10.2026
+
+### Added
+
+- **A stored provider registry** (available from cli-core 0.413.0). `registerProvider(store, { name, kind, aliases, command })` (from `@wirecat/cli-core/store`) writes a CLI's entry into `store_settings` under the key `providers`; every store handle loads the stored entries when it opens, so `kindOf`, `providerNamed` and `--source` in every CLI know a provider cli-core does not list. The built-ins stay the seed. `useProviders(entries)`, `kindIn(provider)`, `providerNamed`, `kindOf`, `providers()`, `KINDS` and `PROVIDERS` are exported from `@wirecat/cli-core`. Two entries that disagree on a kind, or an alias another provider has, are a `validation_error` naming both; a stored entry that clashes with a built-in is left out when the store opens, so it never stops the store opening.
+- **Knowledge lists filter at their native readers.** Organizations, projects, reminders and mail rules accept optional queries before SQL list bounds. Document tags and links accept native selectors, and meeting-link reads can select one URL before aggregation. Existing unfiltered calls keep their behavior.
+
+### Changed — may break callers
+
+- **A provider no registry entry names is skipped, never searched as messages** (available from cli-core 0.413.0). `search messages`, `search all` and `--source` lists report each of its accounts under `skipped` with the reason "unknown provider — run its CLI once" (code `not_found`). The account the search runs as is still read, whatever its provider. `kindOf` keeps its signature and its `messages` default; `kindIn` answers `undefined` for such a provider. `ListedAccount.kind` is now `Kind | undefined`.
+- **`KINDS` and `Kind` gain `events`** (available from cli-core 0.413.0). No search reads events yet; `--source events` says so.
+- **`bot store fetch` is now `bot messages sync`, and the `bot store` group is gone** (tg and max). It does what the personal `messages sync` does, so it carries the same name; `store` is for the local database. The old path answers with a pointer to the new one, and a saved `permissions.bot.store.fetch` is refused until it is renamed to `permissions.bot.messages.sync`. A CLI that customizes the command must move its override to the new path.
+
+### Fixed
+
+- **`config set` and `config unset` work while a moved permission key is saved.** Every other command still refuses the old key and names its replacement; `config unset permissions.<old>` and `config set permissions.<new>` now fix it instead of failing with the same error.
+- **`tasks update <task> --parent none` clears the parent.** The CLI keeps the sentinel through option parsing and converts it to null when building the plan, so Commander cannot turn it into an empty task id.
+
 ## 0.411.0 — 24.10.2026
 
 ### Added

package/dist/cli/bot/command.js

@@ -16,12 +16,12 @@ import { botExamples } from "./examples.js";
 import { BOT_CHATS_QUERY, BOT_PROFILES_QUERY, botChatFilter, botProfileName } from "./list-queries.js";
 import { botMcpCommand } from "./mcp.js";
 import { botCan, botIdOf, botMessagesCommand } from "./messages.js";
+import { botMessagesSyncCommand } from "./messages-sync.js";
 import { botModerateCommand, botRulesCommand } from "./moderation.js";
 import { addBotCopyReads, botContactsCommand, botSearchCommand } from "./people.js";
 import { BOT_ACTIONS } from "./port.js";
 import { registryProfiles } from "./registry.js";
 import { botCallbacksCommand, botMenuCommand, botWebhooksCommand } from "./setup.js";
-import { botStoreCommand } from "./store.js";
 import { BotTokenStore } from "./token.js";
 import { botWatchCommand } from "./watch.js";
 /** Where each of the messenger's other secrets comes from, `null` when it is not set; never the value. */
@@ -289,6 +289,8 @@ const chatsCommand = (bot) => {
  */
 const withCopyReads = (messages, bot) => {
     addBotCopyReads(messages, bot);
+    if (bot.fetching)
+        messages.addCommand(botMessagesSyncCommand(bot, bot.fetching));
     return messages;
 };
 export const botCommand = (bot) => {
@@ -310,7 +312,5 @@ export const botCommand = (bot) => {
         .addCommand(botContactsCommand(bot));
     if (bot.identity)
         command.addCommand(meCommand(bot));
-    if (bot.fetching)
-        command.addCommand(botStoreCommand(bot, bot.fetching));
     return bot.mcp ? command.addCommand(botMcpCommand(bot)) : command;
 };

package/dist/cli/bot/messages-sync.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+import type { BotMessenger } from "./port.js";
+/**
+ * `bot messages sync`: a chat's history into the bot's local copy, newest to oldest and resumable, as the
+ * personal `messages sync` does. Mounted for a messenger whose Bot API pages back through a chat.
+ */
+export declare const botMessagesSyncCommand: (bot: BotMessenger, fetching: NonNullable<BotMessenger["fetching"]>) => Command;

package/dist/cli/bot/{store.js → messages-sync.js}

@@ -16,12 +16,11 @@ const wholeNumber = (value) => {
     return parsed;
 };
 /**
- * `bot store fetch`: a chat's history into the bot's local copy, newest to oldest and resumable, as the
+ * `bot messages sync`: a chat's history into the bot's local copy, newest to oldest and resumable, as the
  * personal `messages sync` does. Mounted for a messenger whose Bot API pages back through a chat.
  */
-export const botStoreCommand = (bot, fetching) => {
-    const command = new Command("store").description("the bot's local copy on this machine");
-    const fetch = annotate(command.command("fetch"), { effects: FETCH })
+export const botMessagesSyncCommand = (bot, fetching) => {
+    const fetch = annotate(new Command("sync"), { effects: FETCH })
         .description("fetch a chat's history into the bot's local copy, newest first; run it again to continue")
         .argument("<chat>", "a chat id, or the title of a chat this bot has seen")
         .option("--limit <n>", `at most this many messages in this run; ${fetching.maxPages * fetching.page} if not given`, wholeNumber)
@@ -85,5 +84,5 @@ export const botStoreCommand = (bot, fetching) => {
             stop.release();
         }
     });
-    return command;
+    return fetch;
 };

package/dist/cli/bot/port.d.ts

@@ -53,7 +53,7 @@ export interface BotHistory {
         messages: Message[];
         more: boolean;
     }>;
-    /** One page back from `before` (or from now), newest first: what `bot store fetch` walks. */
+    /** One page back from `before` (or from now), newest first: what `bot messages sync` walks. */
     historyBefore(chat: BotChatRef, window: {
         limit: number;
         before?: string;
@@ -250,7 +250,7 @@ export interface BotNativeApi {
 export interface BotConnectOptions {
     stop?: AbortSignal;
     events?: EventSink;
-    /** Only `bot store fetch` asks for a history reader; other commands stay on the Bot API. */
+    /** Only `bot messages sync` asks for a history reader; other commands stay on the Bot API. */
     history?: {
         from?: string;
         pauseMs: number;
@@ -295,7 +295,7 @@ export interface BotMessenger {
     readSecret?: (command: Command, prompt: string) => Promise<string>;
     /** What kind of chat a stored message came from; without it a positive id is a dialog, a negative one a group. */
     chatKindOf?: (hit: StoredHit) => ChatKind;
-    /** How its history pages, for `bot store fetch`, which is mounted only when this is set. */
+    /** How its history pages, for `bot messages sync`, which is mounted only when this is set. */
     /** `from`: the help of `--until-id`, the message the fetch starts at; the option is mounted only when set. */
     fetching?: Fetching & {
         from?: string;

package/dist/cli/config-command.js

@@ -64,6 +64,7 @@ export const configCommand = (app, config, { permissionKey } = {}) => {
             const context = baseContext(this, (flags, options) => config.resolveSettings(flags, {
                 ...options,
                 needsProfile: !everyone && setting !== "default_profile" && !isStoreSetting(setting),
+                skipMovedPermissions: true,
             }));
             const { settings, renderer, env } = context;
             if (isStoreSetting(setting)) {

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -3,9 +3,9 @@ import type { CacheDatabase } from "../../store/driver.js";
 import type { Messenger } from "./context.js";
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
+    error?: undefined;
     path: string;
     exists: boolean;
-    error?: undefined;
 } | {
     path: string;
     exists: boolean;

package/dist/cli/messenger/tasks-command.js

@@ -111,7 +111,7 @@ const planFrom = (options) => {
     if (options.priority !== undefined)
         plan.priority = options.priority;
     if (options.parent !== undefined)
-        plan.parent = options.parent;
+        plan.parent = options.parent === "none" ? null : options.parent;
     if (options.category !== undefined)
         plan.category = options.category;
     if (options.title !== undefined)
@@ -203,7 +203,7 @@ export const tasksCommand = (messenger) => {
             throw new CliError("validation_error", "--priority takes 0 through 4");
         return Number(value);
     })
-        .option("--parent <id>", "parent task in the same project; none clears it", (value) => value === "none" ? null : value), "send Alex the API token").action(async function (id) {
+        .option("--parent <id>", "parent task in the same project; none clears it"), "send Alex the API token").action(async function (id) {
         const context = messengerContext(this, messenger);
         refuseLocalWrite(context, messenger.app.command, "tasks.update");
         const plan = planFrom(this.opts());

package/dist/cli/moved.js

@@ -32,6 +32,7 @@ export const RENAMED_COMMANDS = {
     "mcp setup": "mcp add",
     "mcp doctor": "mcp check",
     "commands schema": "commands info",
+    "bot store fetch": "bot messages sync",
     "store gaps plan": "store gaps show",
     "store reindex": "store rebuild",
     "stats messages counters refresh": "stats messages counters sync",

package/dist/cli/settings.d.ts

@@ -140,6 +140,8 @@ export interface ResolveOptions {
     needsProfile?: boolean;
     /** Read the config file without writing it: no default file. For a dry run. */
     readOnly?: boolean;
+    /** Skip moved permission keys instead of refusing them, so `config set` and `unset` can fix one. */
+    skipMovedPermissions?: boolean;
 }
 /** Where `profile` came from when none was named and the command needs none. */
 export declare const NONE_NAMED = "none named";

package/dist/cli/settings.js

@@ -4,6 +4,7 @@ import * as v from "valibot";
 import { AI_ENTRIES, resolveAISettings } from "../analysis/settings.js";
 import { parseDuration } from "../domain/duration.js";
 import { envName, readOnlyLockOf } from "../ports/app.js";
+import { canonicalPermissionKey } from "../sends/permission-aliases.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";
@@ -77,6 +78,7 @@ const SHARED_DEFAULTS_ONLY = {
     update_check: v.optional(flag),
     skill_hint: v.optional(flag),
 };
+const withoutMoved = (levels) => levels && Object.fromEntries(Object.entries(levels).filter(([key]) => canonicalPermissionKey(key) === key));
 /** Where `profile` came from when none was named and the command needs none. */
 export const NONE_NAMED = "none named";
 /** A name for a command that speaks for no account; never chosen for one that does. */
@@ -230,7 +232,9 @@ export const settingsFor = (app, extension = {}) => {
             : { value: false, from: "default" };
         const fileLayers = layers.map(([from, scope]) => [
             from,
-            scope?.permissions,
+            options.skipMovedPermissions
+                ? withoutMoved(scope?.permissions)
+                : scope?.permissions,
         ]);
         const overrides = permissionOverrides(flags.permission);
         assertOverridesTighten(overrides, layerPermissions(fileLayers).levels);

package/dist/domain/providers.d.ts

@@ -1,20 +1,42 @@
 import type { Provider } from "./models.js";
 /** What a search reads; the same names `--only`, `searched` and `skipped` use. */
-export declare const KINDS: readonly ["messages", "mail", "notes", "documents", "meetings"];
+export declare const KINDS: readonly ["messages", "mail", "notes", "documents", "meetings", "events"];
 export type Kind = (typeof KINDS)[number];
 export interface ProviderEntry {
     name: Provider;
     kind: Kind;
     aliases: readonly string[];
+    /** The CLI that wrote the entry (`zm`, `drive`). One CLI may write several providers, so it is not an alias. */
+    command?: string;
 }
-/** Adding a provider is one entry here; `--source` and every search read it. */
+/** The seed: what cli-core knows before any CLI has written its entry into the store. */
 export declare const PROVIDERS: readonly ProviderEntry[];
 /** The store keeps a notes folder as an `accounts` row of this provider; people call it `notes`. */
 export declare const FOLDER_PROVIDER = "folder";
 /** Notes written in memo have no account row; this is their account. */
 export declare const INTERNAL_NOTES = "internal";
+/** The reason a search gives for an account whose provider no entry names. */
+export declare const UNKNOWN_PROVIDER = "unknown provider \u2014 run its CLI once";
+/** An entry as a CLI or the store gives it, checked: anything else is a `validation_error`. */
+export declare const providerEntryOf: (value: unknown) => ProviderEntry;
+/** The built-ins and the entries the store or the CLI running gave; what `kindOf` and `providerNamed` read. */
+export declare const providers: () => readonly ProviderEntry[];
+/**
+ * Replaces the entries beyond the built-ins. Opening the store calls it with the stored entries; a test or a CLI
+ * with no store may call it too. Two entries that disagree on a kind, or one word naming two providers, throw.
+ */
+export declare const useProviders: (entries: readonly ProviderEntry[]) => void;
+/**
+ * Like `useProviders`, but an entry that clashes is left out instead of failing: what the store holds was written
+ * by CLIs of other versions, and one stale entry must not stop the store opening. Answers the entries left out.
+ */
+export declare const useStoredProviders: (entries: readonly unknown[]) => unknown[];
+/** Adds one entry to those in use, strictly: a clash throws and leaves the registry as it was. */
+export declare const addProvider: (entry: ProviderEntry) => void;
 export declare const isKind: (word: string) => word is Kind;
 /** The registry's provider a name or alias stands for. */
 export declare const providerNamed: (word: string) => ProviderEntry | undefined;
-/** A provider the registry does not list is a messenger: consumers define their own and tests use made-up ones. */
+/** The kind of a provider the registry knows; `undefined` for one no entry names, which a search skips. */
+export declare const kindIn: (provider: Provider) => Kind | undefined;
+/** A provider the registry does not list counts as a messenger here; a search asks `kindIn` and skips it. */
 export declare const kindOf: (provider: Provider) => Kind;

package/dist/domain/providers.js

@@ -1,6 +1,7 @@
+import { CliError } from "@wirecat/cli-base";
 /** What a search reads; the same names `--only`, `searched` and `skipped` use. */
-export const KINDS = ["messages", "mail", "notes", "documents", "meetings"];
-/** Adding a provider is one entry here; `--source` and every search read it. */
+export const KINDS = ["messages", "mail", "notes", "documents", "meetings", "events"];
+/** The seed: what cli-core knows before any CLI has written its entry into the store. */
 export const PROVIDERS = [
     { name: "telegram", kind: "messages", aliases: ["tg"] },
     { name: "telegram-bot", kind: "messages", aliases: ["tg-bot"] },
@@ -16,11 +17,94 @@ export const PROVIDERS = [
 export const FOLDER_PROVIDER = "folder";
 /** Notes written in memo have no account row; this is their account. */
 export const INTERNAL_NOTES = "internal";
+/** The reason a search gives for an account whose provider no entry names. */
+export const UNKNOWN_PROVIDER = "unknown provider — run its CLI once";
+const WORD = /^[a-z0-9][a-z0-9_-]*$/;
+const invalid = (message) => {
+    throw new CliError("validation_error", message);
+};
+const wordOf = (value, what) => typeof value === "string" && WORD.test(value)
+    ? value
+    : invalid(`${what} is lowercase letters, digits, - and _ — not ${JSON.stringify(value)}`);
+/** An entry as a CLI or the store gives it, checked: anything else is a `validation_error`. */
+export const providerEntryOf = (value) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return invalid("a provider entry is an object");
+    const { name, kind, aliases = [], command } = value;
+    const named = wordOf(name, "a provider's name");
+    if (typeof kind !== "string" || !KINDS.includes(kind))
+        invalid(`provider ${named}'s kind is one of ${KINDS.join(", ")} — not ${JSON.stringify(kind)}`);
+    if (!Array.isArray(aliases))
+        invalid(`provider ${named}'s aliases are a list`);
+    return {
+        name: named,
+        kind: kind,
+        aliases: [...new Set(aliases.map((alias) => wordOf(alias, `an alias of ${named}`)))],
+        ...(command === undefined ? {} : { command: wordOf(command, `the command of ${named}`) }),
+    };
+};
+const describe = ({ name, kind, command }) => `${name} (${kind}${command ? `, from ${command}` : ""})`;
+const wordsOf = ({ name, aliases }) => [name, ...aliases];
+/** `entry` joined to `known`: the same name keeps one entry with both entries' aliases; a clash is an error. */
+const joined = (known, entry) => {
+    const same = known.find(({ name }) => name === entry.name);
+    if (same && same.kind !== entry.kind)
+        invalid(`two provider entries disagree on the kind: ${describe(same)} and ${describe(entry)}`);
+    const merged = same
+        ? {
+            ...same,
+            aliases: [...new Set([...same.aliases, ...entry.aliases])],
+            ...(entry.command ? { command: entry.command } : {}),
+        }
+        : entry;
+    const others = known.filter((one) => one !== same);
+    for (const word of wordsOf(merged)) {
+        const owner = others.find((one) => wordsOf(one).includes(word));
+        if (owner)
+            invalid(`"${word}" names two providers: ${describe(owner)} and ${describe(merged)}`);
+    }
+    return same ? known.map((one) => (one === same ? merged : one)) : [...known, merged];
+};
+let registry = PROVIDERS;
+/** The built-ins and the entries the store or the CLI running gave; what `kindOf` and `providerNamed` read. */
+export const providers = () => registry;
+/**
+ * Replaces the entries beyond the built-ins. Opening the store calls it with the stored entries; a test or a CLI
+ * with no store may call it too. Two entries that disagree on a kind, or one word naming two providers, throw.
+ */
+export const useProviders = (entries) => {
+    registry = entries.map(providerEntryOf).reduce(joined, PROVIDERS);
+};
+/**
+ * Like `useProviders`, but an entry that clashes is left out instead of failing: what the store holds was written
+ * by CLIs of other versions, and one stale entry must not stop the store opening. Answers the entries left out.
+ */
+export const useStoredProviders = (entries) => {
+    const left = [];
+    registry = entries.reduce((known, entry) => {
+        try {
+            return joined(known, providerEntryOf(entry));
+        }
+        catch (error) {
+            if (!(error instanceof CliError))
+                throw error;
+            left.push(entry);
+            return known;
+        }
+    }, PROVIDERS);
+    return left;
+};
+/** Adds one entry to those in use, strictly: a clash throws and leaves the registry as it was. */
+export const addProvider = (entry) => {
+    registry = joined(registry, providerEntryOf(entry));
+};
 export const isKind = (word) => KINDS.includes(word.toLowerCase());
 /** The registry's provider a name or alias stands for. */
 export const providerNamed = (word) => {
     const wanted = word.toLowerCase();
-    return PROVIDERS.find(({ name, aliases }) => name === wanted || aliases.includes(wanted));
+    return registry.find((entry) => wordsOf(entry).includes(wanted));
 };
-/** A provider the registry does not list is a messenger: consumers define their own and tests use made-up ones. */
-export const kindOf = (provider) => provider === FOLDER_PROVIDER ? "notes" : (providerNamed(provider)?.kind ?? "messages");
+/** The kind of a provider the registry knows; `undefined` for one no entry names, which a search skips. */
+export const kindIn = (provider) => provider === FOLDER_PROVIDER ? "notes" : registry.find(({ name }) => name === provider)?.kind;
+/** A provider the registry does not list counts as a messenger here; a search asks `kindIn` and skips it. */
+export const kindOf = (provider) => kindIn(provider) ?? "messages";

package/dist/entities/index.d.ts

@@ -39,6 +39,7 @@ import { imageEmbedding } from "./image-embedding.js";
 import { inviteLink } from "./invite-link.js";
 import { job } from "./job.js";
 import { joinRequest } from "./join-request.js";
+import { organization, project, reminder } from "./knowledge-lists.js";
 import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory } from "./list-results.js";
 import { messageEvent, serveSummary, watchedMessage, watchItem } from "./listener.js";
 import { mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer } from "./media-archive.js";
@@ -85,7 +86,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactProfile, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, person, place, poll, pollChange, pollVote, ranking, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
+export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactProfile, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
 export declare const ENTITIES: {
     readonly meeting_ingestion: v.StrictObjectSchema<{
         readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -4742,6 +4743,33 @@ export declare const ENTITIES: {
         readonly account: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>;
+    readonly organization: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly kind: v.PicklistSchema<["company", "team", "family", "community"], undefined>;
+        readonly name: v.StringSchema<undefined>;
+        readonly scope: v.PicklistSchema<["personal", "work"], undefined>;
+        readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    }, undefined>;
+    readonly project: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly key: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        readonly type: v.PicklistSchema<["work", "client", "personal", "oss", "other"], undefined>;
+        readonly organization_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly scope: v.PicklistSchema<["personal", "work"], undefined>;
+        readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    }, undefined>;
+    readonly reminder: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly task: v.StringSchema<undefined>;
+        readonly due_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+        readonly timezone: v.StringSchema<undefined>;
+        readonly state: v.PicklistSchema<["pending", "leased", "delivered", "cancelled"], undefined>;
+        readonly revision: v.NumberSchema<undefined>;
+        readonly receipt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
     readonly bot_profile: v.StrictObjectSchema<{
         readonly name: v.StringSchema<undefined>;
         readonly token: v.StringSchema<undefined>;

package/dist/entities/index.js

@@ -41,6 +41,7 @@ import { imageEmbedding } from "./image-embedding.js";
 import { inviteLink } from "./invite-link.js";
 import { job } from "./job.js";
 import { joinRequest } from "./join-request.js";
+import { organization, project, reminder } from "./knowledge-lists.js";
 import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory, } from "./list-results.js";
 import { messageEvent, serveSummary, watchedMessage, watchItem } from "./listener.js";
 import { mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer } from "./media-archive.js";
@@ -91,7 +92,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactProfile, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, person, place, poll, pollChange, pollVote, ranking, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
+export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactProfile, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
 export const ENTITIES = {
     sync_progress: syncProgress,
     ...MEETING_RESULT_ENTITIES,
@@ -167,6 +168,9 @@ export const ENTITIES = {
     account_privacy: accountPrivacy,
     account_privacy_change: accountPrivacyChange,
     account_profile: accountProfile,
+    organization,
+    project,
+    reminder,
     bot_profile: botProfile,
     bot_template: botTemplate,
     bot_seen_chat: botSeenChat,

package/dist/entities/knowledge-lists.d.ts

@@ -0,0 +1,28 @@
+import * as v from "valibot";
+export declare const organization: v.StrictObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+    readonly kind: v.PicklistSchema<["company", "team", "family", "community"], undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly scope: v.PicklistSchema<["personal", "work"], undefined>;
+    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+}, undefined>;
+export declare const project: v.StrictObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+    readonly key: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly type: v.PicklistSchema<["work", "client", "personal", "oss", "other"], undefined>;
+    readonly organization_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    readonly scope: v.PicklistSchema<["personal", "work"], undefined>;
+    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+}, undefined>;
+export declare const reminder: v.StrictObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly task: v.StringSchema<undefined>;
+    readonly due_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    readonly timezone: v.StringSchema<undefined>;
+    readonly state: v.PicklistSchema<["pending", "leased", "delivered", "cancelled"], undefined>;
+    readonly revision: v.NumberSchema<undefined>;
+    readonly receipt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;

package/dist/entities/knowledge-lists.js

@@ -0,0 +1,29 @@
+import * as v from "valibot";
+import { id, reference, text, time } from "./fields.js";
+export const organization = v.strictObject({
+    id,
+    ref: reference,
+    kind: v.picklist(["company", "team", "family", "community"]),
+    name: text,
+    scope: v.picklist(["personal", "work"]),
+    created_at: time,
+});
+export const project = v.strictObject({
+    id,
+    ref: reference,
+    key: text,
+    name: text,
+    type: v.picklist(["work", "client", "personal", "oss", "other"]),
+    organization_id: v.nullable(id),
+    scope: v.picklist(["personal", "work"]),
+    created_at: time,
+});
+export const reminder = v.strictObject({
+    id,
+    task: text,
+    due_at: time,
+    timezone: text,
+    state: v.picklist(["pending", "leased", "delivered", "cancelled"]),
+    revision: v.number(),
+    receipt: v.nullable(text),
+});

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { parseMarkdownSpans } from "./domain/markdown-spans.js";
 export type { MessageLink, MessagePermalink } from "./domain/message-link.js";
 export type * from "./domain/models.js";
 export { countedPoll } from "./domain/polls.js";
+export { isKind, KINDS, type Kind, kindIn, kindOf, PROVIDERS, type ProviderEntry, providerNamed, providers, UNKNOWN_PROVIDER, useProviders, } from "./domain/providers.js";
 export type { RankingGraphEvidence, RankingGraphLink } from "./domain/rankings-graph.js";
 export type { RankingComponent, RankingInput, RankingMeasure, RankingOptions, RankingTarget, RankingWeights, ScorePreset, } from "./domain/rankings-options.js";
 export { rankingOptions } from "./domain/rankings-options.js";

package/dist/index.js

@@ -5,6 +5,7 @@ export { formatLocator, isLocator, parseLocator } from "./domain/locator.js";
 export { parseMarkdown } from "./domain/markdown.js";
 export { parseMarkdownSpans } from "./domain/markdown-spans.js";
 export { countedPoll } from "./domain/polls.js";
+export { isKind, KINDS, kindIn, kindOf, PROVIDERS, providerNamed, providers, UNKNOWN_PROVIDER, useProviders, } from "./domain/providers.js";
 export { rankingOptions } from "./domain/rankings-options.js";
 export { canonicalReference, formatReference, parseReference } from "./domain/references.js";
 export { normalizeTag, TAG_TYPES } from "./domain/tags.js";

package/dist/search/account-list.d.ts

@@ -24,9 +24,12 @@ export interface ListContext {
         command?: string;
     };
 }
-/** An account as `--source` and a hit name it: a notes folder is `notes:<its id>`, never the store's ulid. */
+/**
+ * An account as `--source` and a hit name it: a notes folder is `notes:<its id>`, never the store's ulid. The kind is
+ * `undefined` for a provider no registry entry names: no search reads it, and `fitting` reports it.
+ */
 export interface ListedAccount extends AccountKey {
-    kind: Kind;
+    kind: Kind | undefined;
 }
 /** One entry of the list as written, a group's member included, and the accounts it named. */
 export interface ListedEntry {