@wirecat/cli-core 0.425.0 → 0.427.0

package/dist/cli/store-info.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "commander";
+import type * as v from "valibot";
+import type { storeInfo as storeInfoEntity } from "../entities/store-maintenance.js";
+export type StoreInfo = v.InferOutput<typeof storeInfoEntity>;
+/**
+ * The shared store as this build sees it, for any WireCat tool. Opened read-only: it never migrates, never sets a
+ * journal mode, and answers for a file newer than this build instead of refusing it.
+ */
+export declare const storeInfo: (env: NodeJS.ProcessEnv) => Promise<StoreInfo>;
+export declare const storeInfoCommand: () => Command;
+/** `store info` for a tool with no `store` command of its own. */
+export declare const sharedStoreCommand: () => Command;

package/dist/cli/store-info.js

@@ -0,0 +1,72 @@
+import { existsSync, statSync } from "node:fs";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { compatibilityOf, fileSchemaOf } from "../store/compatibility.js";
+import { storePath } from "../store/path.js";
+import { fileFacts, openSqlite, pendingNormalization, rowCounts, searchIndexState, stemsState, storeClients, storeContents, } from "../store/store.js";
+import { environmentOf, outputFor } from "./context.js";
+import { LOCAL_READ } from "./effects.js";
+import { itemOf, renderAnswer, snakeKeys } from "./envelope.js";
+/** Before version 6 the column does not exist, and a file behind this build is not migrated here. */
+const pendingIfKnown = (database) => database.prepare("SELECT 1 FROM pragma_table_info('messages') WHERE name = 'normalized_text'").get()
+    ? pendingNormalization(database)
+    : null;
+const bytesOf = (path) => (existsSync(path) ? statSync(path).size : 0);
+const messageOf = (error) => (error instanceof Error ? error.message : String(error));
+/** A file this build may not open may have renamed what the counts read, so only its schema is reported. */
+const contentsOf = (database, version, writable) => version > 0 && writable
+    ? {
+        rows: rowCounts(database),
+        pendingNormalization: pendingIfKnown(database),
+        wordIndex: searchIndexState(database) ?? null,
+        stemIndex: stemsState(database) ?? null,
+        ...storeContents(database),
+    }
+    : { rows: {}, pendingNormalization: null, wordIndex: null, stemIndex: null };
+/**
+ * The shared store as this build sees it, for any WireCat tool. Opened read-only: it never migrates, never sets a
+ * journal mode, and answers for a file newer than this build instead of refusing it.
+ */
+export const storeInfo = async (env) => {
+    const path = storePath(env);
+    if (!existsSync(path))
+        return snakeKeys({ path, exists: false, schema: compatibilityOf(undefined) });
+    let schema = compatibilityOf(undefined);
+    try {
+        const { database } = await openSqlite(path, { readOnly: true });
+        try {
+            schema = compatibilityOf(fileSchemaOf(database));
+            const answer = {
+                path,
+                exists: true,
+                ...fileFacts(database, path),
+                bytes: { file: bytesOf(path), wal: bytesOf(`${path}-wal`) },
+                schema,
+                clients: storeClients(database).map(({ seenAt, ...client }) => ({
+                    ...client,
+                    seenAt: new Date(seenAt).toISOString(),
+                })),
+                ...contentsOf(database, schema.version, schema.writable),
+            };
+            return snakeKeys(answer);
+        }
+        finally {
+            database.close();
+        }
+    }
+    catch (error) {
+        const { speaks } = schema;
+        return snakeKeys({ path, exists: true, opens: false, error: messageOf(error), schema: { speaks } });
+    }
+};
+export const storeInfoCommand = () => annotate(new Command("info"), { output: { entity: "store_info" }, effects: LOCAL_READ })
+    .summary("the shared store's format, size and contents, and whether this tool can read it")
+    .description("the store file: where it is, its size, its schema against the one this tool speaks, which tools used it and how many rows it holds, by provider, chat kind, account, year (UTC) and attachment kind, over every account; changes nothing")
+    .action(async function () {
+    const answer = await storeInfo(environmentOf(this).env ?? process.env);
+    renderAnswer(this, outputFor(this), itemOf(answer));
+});
+/** `store info` for a tool with no `store` command of its own. */
+export const sharedStoreCommand = () => annotate(new Command("store"), { effects: LOCAL_READ })
+    .description("the shared local store every WireCat tool reads")
+    .addCommand(storeInfoCommand());

package/dist/entities/index.d.ts

@@ -75,6 +75,7 @@ import { savedSearch, searchHistoryClear } from "./saved-search.js";
 import { sendAttempt } from "./send-attempt.js";
 import { storeBackup, storeCheck, storeCopyRemoval, storeDecrypt, storeInfo, storeMigration, storeReindex, storeRepair, storeReset, storeRestore } from "./store-maintenance.js";
 import { storeChatStatus, storeClear, storeExport, storeGapPlan, storeGapRepair, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry } from "./store-records.js";
+import { storeTable } from "./store-table.js";
 import { automaticTags, tagChange } from "./tag-change.js";
 import { tagging } from "./tagging.js";
 import { task } from "./task.js";
@@ -86,7 +87,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, 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 { 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, storeTable, 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>]>;
@@ -9430,11 +9431,25 @@ export declare const ENTITIES: {
     readonly store_info: v.UnionSchema<[v.StrictObjectSchema<{
         readonly path: v.StringSchema<undefined>;
         readonly exists: v.LiteralSchema<false, undefined>;
+        readonly schema: v.StrictObjectSchema<{
+            readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly writable: v.BooleanSchema<undefined>;
+            readonly speaks: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly reason: v.PicklistSchema<["missing", "older", "current", "newer", "too_new"], undefined>;
+            readonly upgrade: v.NullableSchema<v.StrictObjectSchema<{
+                readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            }, undefined>, undefined>;
+        }, undefined>;
     }, undefined>, v.StrictObjectSchema<{
-        path: v.StringSchema<undefined>;
-        exists: v.LiteralSchema<true, undefined>;
-        opens: v.LiteralSchema<false, undefined>;
-        error: v.StringSchema<undefined>;
+        readonly path: v.StringSchema<undefined>;
+        readonly exists: v.LiteralSchema<true, undefined>;
+        readonly opens: v.LiteralSchema<false, undefined>;
+        readonly error: v.StringSchema<undefined>;
+        readonly schema: v.StrictObjectSchema<{
+            readonly speaks: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, 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>]>;
@@ -9478,12 +9493,40 @@ export declare const ENTITIES: {
             readonly file: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
             readonly wal: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         }, undefined>;
+        readonly journal_mode: v.StringSchema<undefined>;
+        readonly pages: v.StrictObjectSchema<{
+            readonly size: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly free: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, undefined>;
+        readonly migrations: v.ArraySchema<v.StrictObjectSchema<{
+            readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly applied_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>, undefined>;
+        readonly backup: v.NullableSchema<v.StrictObjectSchema<{
+            readonly 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 file: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly checked: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
         readonly schema: v.StrictObjectSchema<{
             readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
             readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
             readonly writable: v.BooleanSchema<undefined>;
             readonly speaks: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly reason: v.PicklistSchema<["missing", "older", "current", "newer", "too_new"], undefined>;
+            readonly upgrade: v.NullableSchema<v.StrictObjectSchema<{
+                readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            }, undefined>, undefined>;
         }, undefined>;
+        readonly clients: v.ArraySchema<v.StrictObjectSchema<{
+            readonly command: v.StringSchema<undefined>;
+            readonly version: v.StringSchema<undefined>;
+            readonly core: v.StringSchema<undefined>;
+            readonly speaks: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly seen_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>, undefined>;
         readonly rows: Omit<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>]>;
@@ -9809,6 +9852,12 @@ export declare const ENTITIES: {
             readonly rows: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         }, undefined>;
     }, undefined>;
+    readonly store_table: v.StrictObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly kind: v.PicklistSchema<readonly ["data", "search_index", "search_index_part", "internal"], undefined>;
+        readonly rows: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly bytes: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+    }, undefined>;
     readonly agenda: v.StrictObjectSchema<{
         readonly 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 account: v.StringSchema<undefined>;

package/dist/entities/index.js

@@ -81,6 +81,7 @@ import { savedSearch, searchHistoryClear } from "./saved-search.js";
 import { sendAttempt } from "./send-attempt.js";
 import { storeBackup, storeCheck, storeCopyRemoval, storeDecrypt, storeInfo, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, } from "./store-maintenance.js";
 import { storeChatStatus, storeClear, storeExport, storeGapPlan, storeGapRepair, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, syncProgress, } from "./store-records.js";
+import { storeTable } from "./store-table.js";
 import { automaticTags, tagChange } from "./tag-change.js";
 import { tagging } from "./tagging.js";
 import { task } from "./task.js";
@@ -92,7 +93,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, 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 { 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, storeTable, 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,
@@ -291,6 +292,7 @@ export const ENTITIES = {
     store_reset: storeReset,
     store_repair: storeRepair,
     store_copy_removal: storeCopyRemoval,
+    store_table: storeTable,
     agenda,
     model,
     chat_group_change: chatGroupChange,

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

@@ -2,11 +2,25 @@ import * as v from "valibot";
 export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
     readonly path: v.StringSchema<undefined>;
     readonly exists: v.LiteralSchema<false, undefined>;
+    readonly schema: v.StrictObjectSchema<{
+        readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly writable: v.BooleanSchema<undefined>;
+        readonly speaks: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly reason: v.PicklistSchema<["missing", "older", "current", "newer", "too_new"], undefined>;
+        readonly upgrade: v.NullableSchema<v.StrictObjectSchema<{
+            readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, undefined>, undefined>;
+    }, undefined>;
 }, undefined>, v.StrictObjectSchema<{
-    path: v.StringSchema<undefined>;
-    exists: v.LiteralSchema<true, undefined>;
-    opens: v.LiteralSchema<false, undefined>;
-    error: v.StringSchema<undefined>;
+    readonly path: v.StringSchema<undefined>;
+    readonly exists: v.LiteralSchema<true, undefined>;
+    readonly opens: v.LiteralSchema<false, undefined>;
+    readonly error: v.StringSchema<undefined>;
+    readonly schema: v.StrictObjectSchema<{
+        readonly speaks: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, 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>]>;
@@ -50,12 +64,42 @@ export declare const storeInfo: v.UnionSchema<[v.StrictObjectSchema<{
         readonly file: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly wal: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     }, undefined>;
+    readonly journal_mode: v.StringSchema<undefined>;
+    /** `free` pages hold nothing; a `VACUUM` would give them back. */
+    readonly pages: v.StrictObjectSchema<{
+        readonly size: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly free: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>;
+    readonly migrations: v.ArraySchema<v.StrictObjectSchema<{
+        readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly applied_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>, undefined>;
+    /** From the marker a backup job leaves in `backups/last.json` beside the store; null without one. */
+    readonly backup: v.NullableSchema<v.StrictObjectSchema<{
+        readonly 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 file: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly checked: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
     readonly schema: v.StrictObjectSchema<{
         readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly writable: v.BooleanSchema<undefined>;
         readonly speaks: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly reason: v.PicklistSchema<["missing", "older", "current", "newer", "too_new"], undefined>;
+        readonly upgrade: v.NullableSchema<v.StrictObjectSchema<{
+            readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly min_compatible: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, undefined>, undefined>;
     }, undefined>;
+    readonly clients: v.ArraySchema<v.StrictObjectSchema<{
+        readonly command: v.StringSchema<undefined>;
+        readonly version: v.StringSchema<undefined>;
+        readonly core: v.StringSchema<undefined>;
+        readonly speaks: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly seen_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>, undefined>;
     readonly rows: Omit<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>]>;

package/dist/entities/store-maintenance.js

@@ -2,6 +2,12 @@ import * as v from "valibot";
 import { count, text, time } from "./fields.js";
 const absent = v.strictObject({ path: text, exists: v.literal(false) });
 const schema = v.strictObject({ version: count, min_compatible: count, writable: v.boolean(), speaks: count });
+const infoSchema = v.strictObject({
+    ...schema.entries,
+    reason: v.picklist(["missing", "older", "current", "newer", "too_new"]),
+    upgrade: v.nullable(v.strictObject({ version: count, min_compatible: count })),
+});
+const client = v.strictObject({ command: text, version: text, core: text, speaks: count, seen_at: time });
 const wordIndex = v.strictObject({
     watermark: count,
     filled_through: count,
@@ -47,13 +53,20 @@ const contents = {
     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),
+    v.strictObject({ ...absent.entries, schema: infoSchema }),
+    v.strictObject({ ...readFailure, schema: v.strictObject({ speaks: count }) }),
     v.strictObject({
         path: text,
         exists: v.literal(true),
         bytes: v.strictObject({ file: count, wal: count }),
-        schema,
+        journal_mode: text,
+        /** `free` pages hold nothing; a `VACUUM` would give them back. */
+        pages: v.strictObject({ size: count, count, free: count }),
+        migrations: v.array(v.strictObject({ version: count, min_compatible: count, applied_at: time })),
+        /** From the marker a backup job leaves in `backups/last.json` beside the store; null without one. */
+        backup: v.nullable(v.strictObject({ at: time, file: v.nullable(text), checked: v.nullable(text) })),
+        schema: infoSchema,
+        clients: v.array(client),
         rows,
         pending_normalization: v.nullable(count),
         word_index: v.nullable(wordIndex),

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

@@ -0,0 +1,8 @@
+import * as v from "valibot";
+export declare const TABLE_KINDS: readonly ["data", "search_index", "search_index_part", "internal"];
+export declare const storeTable: v.StrictObjectSchema<{
+    readonly name: v.StringSchema<undefined>;
+    readonly kind: v.PicklistSchema<readonly ["data", "search_index", "search_index_part", "internal"], undefined>;
+    readonly rows: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    readonly bytes: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+}, undefined>;

package/dist/entities/store-table.js

@@ -0,0 +1,9 @@
+import * as v from "valibot";
+import { count, text } from "./fields.js";
+export const TABLE_KINDS = ["data", "search_index", "search_index_part", "internal"];
+export const storeTable = v.strictObject({
+    name: text,
+    kind: v.picklist(TABLE_KINDS),
+    rows: v.nullable(count),
+    bytes: v.optional(v.nullable(count)),
+});

package/dist/meetings/mcp/index.d.ts

@@ -38,6 +38,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -53,11 +54,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -75,11 +76,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -101,7 +102,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,6 +188,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -203,11 +204,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -225,11 +226,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -251,7 +252,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,6 +338,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -353,11 +354,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -375,11 +376,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -401,7 +402,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,6 +488,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -503,11 +504,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -525,11 +526,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -551,7 +552,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,6 +638,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -653,11 +654,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -675,11 +676,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -701,7 +702,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

package/dist/store/compatibility.d.ts

@@ -0,0 +1,28 @@
+import type { CacheDatabase } from "./driver.js";
+import { type Migration } from "./migrations.js";
+export declare const SPEAKS: number;
+export interface FileSchema {
+    version: number;
+    minCompatible: number;
+}
+/** Where the file stands against this build: `missing` and `older` are what this build's next run migrates. */
+export type SchemaReason = "missing" | "older" | "current" | "newer" | "too_new";
+/** An empty file is normal: `openStore` creates it before the first migration runs. */
+export declare const fileSchemaOf: (database: CacheDatabase) => FileSchema;
+/** The negation of `migrate`'s refusal: a newer file stays open to this build until its minimum passes it. */
+export declare const writableBy: ({ version, minCompatible }: FileSchema, speaks?: number) => boolean;
+/**
+ * What this build makes of the file, and what its next run would leave behind: `upgrade.minCompatible` is the
+ * minimum the file will demand afterwards, so a caller can name every other tool that will then refuse it.
+ */
+export declare const compatibilityOf: (file: FileSchema | undefined, migrations?: readonly Migration[]) => {
+    version: number;
+    minCompatible: number;
+    speaks: number;
+    writable: boolean;
+    reason: SchemaReason;
+    upgrade: {
+        version: number;
+        minCompatible: number;
+    } | null;
+};

package/dist/store/compatibility.js

@@ -0,0 +1,41 @@
+import { MIGRATIONS } from "./migrations.js";
+export const SPEAKS = MIGRATIONS.at(-1)?.version ?? 0;
+/** An empty file is normal: `openStore` creates it before the first migration runs. */
+export const fileSchemaOf = (database) => {
+    const tracked = database.prepare("SELECT 1 FROM sqlite_master WHERE name = 'schema_migrations'").get();
+    const row = tracked
+        ? database.prepare("SELECT version, min_compatible FROM schema_migrations ORDER BY version DESC LIMIT 1").get()
+        : undefined;
+    return { version: Number(row?.version ?? 0), minCompatible: Number(row?.min_compatible ?? 0) };
+};
+/** The negation of `migrate`'s refusal: a newer file stays open to this build until its minimum passes it. */
+export const writableBy = ({ version, minCompatible }, speaks = SPEAKS) => version <= speaks || minCompatible <= speaks;
+/**
+ * What this build makes of the file, and what its next run would leave behind: `upgrade.minCompatible` is the
+ * minimum the file will demand afterwards, so a caller can name every other tool that will then refuse it.
+ */
+export const compatibilityOf = (file, migrations = MIGRATIONS) => {
+    const speaks = migrations.at(-1)?.version ?? 0;
+    const { version, minCompatible } = file ?? { version: 0, minCompatible: 0 };
+    const writable = writableBy({ version, minCompatible }, speaks);
+    const reason = !file
+        ? "missing"
+        : version < speaks
+            ? "older"
+            : version === speaks
+                ? "current"
+                : writable
+                    ? "newer"
+                    : "too_new";
+    const raisedTo = migrations
+        .filter((migration) => migration.version > version)
+        .reduce((highest, migration) => Math.max(highest, migration.minCompatible), minCompatible);
+    return {
+        version,
+        minCompatible,
+        speaks,
+        writable,
+        reason,
+        upgrade: version < speaks ? { version: speaks, minCompatible: raisedTo } : null,
+    };
+};