@wirecat/cli-core 0.306.0 → 0.307.0

package/dist/store/vectors.d.ts

@@ -0,0 +1,109 @@
+import type { Id } from "../domain/models.js";
+import { type MailStore } from "./sqlite/emails.js";
+import * as imageChunks from "./sqlite/image-chunks.js";
+import type { StoreContext } from "./sqlite/open.js";
+import type { ChunkToEmbed } from "./sqlite/vectors.js";
+import type { AccountKey, ConversationHit, PictureInput, StoredReadiness } from "./types.js";
+export interface AccountVectors {
+    /** Chunks of the chat's current build with no vector of `model`, by hash after `after` (phase 5). */
+    chunksToEmbed(key: AccountKey, chatId: Id, model: string, options: {
+        after?: string;
+        limit: number;
+    }): Promise<ChunkToEmbed[]>;
+    /** The chat's live image attachments with the messages around each, and the chunk each already has. */
+    imagesToDescribe(key: AccountKey, chatId: Id, window: {
+        messages: number;
+        withinMs: number;
+    }): Promise<imageChunks.ImageInput[]>;
+    /** Makes these the chunks of their images, and drops the chat's image chunks not in `keep` (attachment pks). */
+    saveImageChunks(key: AccountKey, chatId: Id, chunks: imageChunks.ImageChunk[], keep: number[]): Promise<void>;
+    /** The images nearest in meaning to `query` by the text around them, as their message in its conversation. */
+    nearestImages(key: AccountKey, options: {
+        chatId?: Id;
+        model: string;
+        since?: string;
+        limit: number;
+        query: Float32Array;
+    }): Promise<ConversationHit[]>;
+    /** Live image attachments with no picture vector yet, in attachment order after `after`; `chatId` narrows it. */
+    picturesToEmbed(key: AccountKey, options: {
+        chatId?: Id;
+        after?: number;
+        limit: number;
+    }): Promise<PictureInput[]>;
+    /** Keeps each picture's vector of `model` and makes its hash the image's picture chunk. */
+    savePictures(key: AccountKey, model: string, dims: number, pictures: {
+        attachmentPk: number;
+        hash: string;
+        bytes: number;
+        occurredAt: number;
+        vector: Float32Array;
+    }[]): Promise<void>;
+    /** The images nearest to `query` by their picture vector of `model`, best first, as their message. */
+    nearestPictures(key: AccountKey, options: {
+        chatId?: Id;
+        model: string;
+        since?: string;
+        limit: number;
+        query: Float32Array;
+    }): Promise<{
+        chatId: Id;
+        messageId: Id;
+        score: number;
+    }[]>;
+    /** The current build's distinct chunks, and how many have a vector of `model`. */
+    vectorStatus(key: AccountKey, chatId: Id, model: string): Promise<{
+        chunks: number;
+        embedded: number;
+    }>;
+    /** Drops the chat's vectors, or one model's; a vector another chat's chunk shares stays. */
+    clearVectors(key: AccountKey, chatId: Id, model?: string): Promise<number>;
+    /** The conversations nearest in meaning to `query`, in one chat or every one of the account, best first. */
+    nearestConversations(key: AccountKey, options: {
+        chatId?: Id;
+        model: string;
+        since?: string;
+        limit: number;
+        query: Float32Array;
+        exclude?: string;
+        conversations?: string[];
+        scope?: "personal" | "work";
+        projectId?: string;
+        personId?: string;
+        before?: string;
+    }): Promise<ConversationHit[]>;
+    /**
+     * A conversation of the current build: how many chunks it has, and the vectors of `model` of those whose
+     * messages did not change since — none when it is not the account's or not current.
+     */
+    conversationVectors(key: AccountKey, id: string, model: string): Promise<{
+        chunks: number;
+        vectors: Float32Array[];
+    }>;
+    /**
+     * How fresh each built chat's conversations and `model`'s vectors are — one chat, or every chat whose
+     * conversations were ever built. A chat never built answers `builtAt: null`.
+     */
+    readiness(key: AccountKey, options: {
+        chatId?: Id;
+        model: string;
+    }): Promise<StoredReadiness[]>;
+    /** Group chats with stored messages whose conversations were never built, the newest message first. */
+    unbuiltGroups(key: AccountKey): Promise<Id[]>;
+    /** Chats in scope embedded with another model and not with `model`, which a search with it cannot see. */
+    embeddedOnlyElsewhere(key: AccountKey, options: {
+        chatId?: Id;
+        model: string;
+    }): Promise<Id[]>;
+}
+export interface VectorsStore extends AccountVectors {
+    saveVectors(model: string, dims: number, vectors: {
+        hash: string;
+        vector: Float32Array;
+    }[]): Promise<void>;
+    /** Which of these chunk hashes already have a vector of `model`. */
+    embeddedHashes(model: string, hashes: string[]): Promise<Set<string>>;
+}
+export declare const accountVectorsOver: (context: StoreContext, mail: () => MailStore) => AccountVectors;
+export declare const vectorsStoreOver: (context: StoreContext, keyed: AccountVectors) => VectorsStore;
+//# sourceMappingURL=vectors.d.ts.map

package/dist/store/vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../../src/store/vectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAG7C,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,oBAAoB,CAAA;AACvE,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5F,MAAM,WAAW,cAAc;IAC7B,qGAAqG;IACrG,aAAa,CACX,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,EAAE,EACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC1B,uGAAuG;IACvG,gBAAgB,CACd,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,EAAE,EACV,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAA;IACpC,gHAAgH;IAChH,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7G,8GAA8G;IAC9G,aAAa,CACX,GAAG,EAAE,UAAU,EACf,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,GAC1F,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IAC7B,iHAAiH;IACjH,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAClH,2FAA2F;IAC3F,YAAY,CACV,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,EAAE,GAC1G,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,sGAAsG;IACtG,eAAe,CACb,GAAG,EAAE,UAAU,EACf,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,GAC1F,OAAO,CAAC;QAAE,MAAM,EAAE,EAAE,CAAC;QAAC,SAAS,EAAE,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;IAC1D,kFAAkF;IAClF,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACvG,4FAA4F;IAC5F,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1E,4GAA4G;IAC5G,oBAAoB,CAClB,GAAG,EAAE,UAAU,EACf,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,EAAE,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,YAAY,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;QACxB,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GACA,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IAC7B;;;OAGG;IACH,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAA;IACrH;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IAC/F,uGAAuG;IACvG,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;IAC7C,0GAA0G;IAC1G,qBAAqB,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;CAC/F;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1G,oEAAoE;IACpE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;CACtE;AAED,eAAO,MAAM,kBAAkB,YAAa,YAAY,QAAQ,MAAM,SAAS,KAAG,cAoOjF,CAAA;AAED,eAAO,MAAM,gBAAgB,YAAa,YAAY,SAAS,cAAc,KAAG,YAM9E,CAAA"}

package/dist/store/vectors.js

@@ -0,0 +1,221 @@
+import { keysOver } from "./keys.js";
+import * as conversationQueries from "./sqlite/conversations.js";
+import { threadConversation } from "./sqlite/emails.js";
+import * as imageChunks from "./sqlite/image-chunks.js";
+import { write } from "./sqlite/transaction.js";
+import * as vectors from "./sqlite/vectors.js";
+export const accountVectorsOver = (context, mail) => {
+    const { database } = context;
+    const { findAccountPk, findChatPk, chatKeyOf } = keysOver(context);
+    return {
+        chunksToEmbed: async (key, chatId, model, options) => {
+            const chatKey = chatKeyOf(key, chatId);
+            return chatKey === undefined ? [] : vectors.chunksToEmbed(context, chatKey, model, options);
+        },
+        imagesToDescribe: async (key, chatId, window) => {
+            const chatKey = chatKeyOf(key, chatId);
+            return chatKey === undefined ? [] : imageChunks.imagesOfChat(context, chatKey, window);
+        },
+        saveImageChunks: async (key, chatId, chunks, keep) => {
+            const accountPk = findAccountPk(key);
+            const chatKey = chatKeyOf(key, chatId);
+            if (accountPk === undefined || chatKey === undefined)
+                return;
+            write(database, () => imageChunks.saveImageChunks(context, accountPk, chatKey, chunks, keep));
+        },
+        nearestImages: async (key, { chatId, model, since, limit, query }) => {
+            const accountPk = findAccountPk(key);
+            if (accountPk === undefined)
+                return [];
+            const chatKey = chatId === undefined ? undefined : chatKeyOf(key, chatId);
+            if (chatId !== undefined && chatKey === undefined)
+                return [];
+            const nearest = imageChunks.nearestImages(context, accountPk, {
+                ...(chatKey === undefined ? {} : { chatKey }),
+                ...(since === undefined ? {} : { since: Date.parse(since) }),
+                model,
+                limit,
+                query,
+            });
+            const hits = [];
+            for (const { chatId: chat, messageId, score } of nearest) {
+                const chatPk = findChatPk(accountPk, chat);
+                const conversation = chatPk === undefined ? undefined : conversationQueries.conversationOf(context, chatPk, messageId);
+                const summary = conversation === undefined
+                    ? undefined
+                    : conversationQueries.summariesOf(context, accountPk, [Number(conversation)]).get(Number(conversation));
+                if (summary)
+                    hits.push({
+                        summary,
+                        chunk: { firstMessageId: messageId, lastMessageId: messageId },
+                        score,
+                        stale: false,
+                        matchedIn: "context",
+                    });
+            }
+            return hits;
+        },
+        picturesToEmbed: async (key, { chatId, after, limit }) => {
+            const accountPk = findAccountPk(key);
+            if (accountPk === undefined)
+                return [];
+            const chatKey = chatId === undefined ? undefined : chatKeyOf(key, chatId);
+            if (chatId !== undefined && chatKey === undefined)
+                return [];
+            return imageChunks.picturesToEmbed(context, accountPk, {
+                ...(chatKey === undefined ? {} : { chatKey }),
+                ...(after === undefined ? {} : { after }),
+                limit,
+            });
+        },
+        savePictures: async (key, model, dims, pictures) => {
+            const accountPk = findAccountPk(key);
+            if (accountPk === undefined)
+                return;
+            write(database, () => {
+                vectors.saveVectors(context, model, dims, pictures.map(({ hash, vector }) => ({ hash, vector })));
+                imageChunks.savePictureChunks(context, accountPk, pictures);
+            });
+        },
+        nearestPictures: async (key, { chatId, model, since, limit, query }) => {
+            const accountPk = findAccountPk(key);
+            if (accountPk === undefined)
+                return [];
+            const chatKey = chatId === undefined ? undefined : chatKeyOf(key, chatId);
+            if (chatId !== undefined && chatKey === undefined)
+                return [];
+            return imageChunks.nearestImages(context, accountPk, {
+                ...(chatKey === undefined ? {} : { chatKey }),
+                ...(since === undefined ? {} : { since: Date.parse(since) }),
+                model,
+                limit,
+                query,
+                position: imageChunks.PICTURE_POSITION,
+            });
+        },
+        vectorStatus: async (key, chatId, model) => {
+            const chatKey = chatKeyOf(key, chatId);
+            return chatKey === undefined ? { chunks: 0, embedded: 0 } : vectors.vectorStatus(context, chatKey, model);
+        },
+        clearVectors: async (key, chatId, model) => {
+            const chatKey = chatKeyOf(key, chatId);
+            if (chatKey === undefined)
+                return 0;
+            let cleared = 0;
+            write(database, () => {
+                cleared = vectors.clearVectors(context, chatKey, model);
+            });
+            return cleared;
+        },
+        nearestConversations: async (key, { chatId, model, since, limit, query, exclude, conversations, scope, projectId, personId, before }) => {
+            const accountPk = findAccountPk(key);
+            if (accountPk === undefined)
+                return [];
+            const chatKey = chatId === undefined ? undefined : chatKeyOf(key, chatId);
+            const mailToo = key.provider === "email" &&
+                conversations === undefined &&
+                scope === undefined &&
+                projectId === undefined &&
+                personId === undefined &&
+                before === undefined;
+            const mailHits = async () => mailToo
+                ? (await mail().nearest(model, query, {
+                    accountId: accountPk,
+                    limit,
+                    ...(chatId === undefined ? {} : { threadExternalId: chatId }),
+                    ...(since === undefined ? {} : { since: Date.parse(since) }),
+                })).map((hit) => ({
+                    summary: threadConversation(hit, context.now()),
+                    chunk: { firstMessageId: hit.externalId, lastMessageId: hit.externalId },
+                    score: hit.score,
+                    stale: false,
+                }))
+                : [];
+            if (chatId !== undefined && chatKey === undefined)
+                return mailHits();
+            const nearest = vectors.nearestChunks(context, accountPk, {
+                ...(chatKey === undefined ? {} : { chatKey }),
+                ...(since === undefined ? {} : { since: Date.parse(since) }),
+                ...(exclude === undefined ? {} : { exclude: Number(exclude) }),
+                model,
+                limit,
+                query,
+                ...(conversations === undefined ? {} : { conversations }),
+                ...(scope === undefined ? {} : { scope }),
+                ...(projectId === undefined ? {} : { projectId: Number(projectId) }),
+                ...(personId === undefined ? {} : { personId: Number(personId) }),
+                ...(before === undefined ? {} : { before: Date.parse(before) }),
+            });
+            const found = conversationQueries.summariesOf(context, accountPk, nearest.map(({ conversationPk }) => conversationPk));
+            const ids = vectors.messageIds(context, nearest.flatMap(({ firstMessagePk, lastMessagePk }) => [firstMessagePk, lastMessagePk]));
+            const messageHits = nearest.flatMap((chunk) => {
+                const summary = found.get(chunk.conversationPk);
+                const first = ids.get(chunk.firstMessagePk);
+                const last = ids.get(chunk.lastMessagePk);
+                const freshness = vectors.chunkFreshness(context, chunk);
+                return summary && first && last && freshness !== "deleted"
+                    ? [
+                        {
+                            summary,
+                            chunk: { firstMessageId: first, lastMessageId: last },
+                            score: chunk.score,
+                            stale: freshness === "stale",
+                        },
+                    ]
+                    : [];
+            });
+            if (!mailToo)
+                return messageHits;
+            return [...messageHits, ...(await mailHits())].sort((a, b) => b.score - a.score).slice(0, limit);
+        },
+        conversationVectors: async (key, id, model) => {
+            const accountPk = findAccountPk(key);
+            const pk = Number(id);
+            if (accountPk === undefined || !conversationQueries.summariesOf(context, accountPk, [pk]).has(pk)) {
+                return { chunks: 0, vectors: [] };
+            }
+            return vectors.conversationVectors(context, pk, model);
+        },
+        readiness: async (key, { chatId, model }) => {
+            const accountPk = findAccountPk(key);
+            if (accountPk === undefined)
+                return [];
+            const chats = chatId === undefined
+                ? vectors.builtChats(context, accountPk)
+                : [{ chatKey: chatKeyOf(key, chatId), id: chatId }].flatMap(({ chatKey, id }) => chatKey === undefined ? [] : [{ chatKey, id }]);
+            return chats.map(({ chatKey, id }) => {
+                const found = vectors.readiness(context, chatKey, model);
+                return found
+                    ? { chatId: id, ...found, builtAt: new Date(found.builtAt).toISOString() }
+                    : {
+                        chatId: id,
+                        builtAt: null,
+                        algorithmVersion: null,
+                        pending: { new: 0, edited: 0, deleted: 0 },
+                        vectors: { chunks: 0, embedded: 0, current: 0, stale: 0, missing: 0 },
+                    };
+            });
+        },
+        unbuiltGroups: async (key) => {
+            const accountPk = findAccountPk(key);
+            return accountPk === undefined ? [] : vectors.unbuiltGroups(context, accountPk);
+        },
+        embeddedOnlyElsewhere: async (key, { chatId, model }) => {
+            const accountPk = findAccountPk(key);
+            if (accountPk === undefined)
+                return [];
+            const chatKey = chatId === undefined ? undefined : chatKeyOf(key, chatId);
+            if (chatId !== undefined && chatKey === undefined)
+                return [];
+            return vectors.embeddedOnlyElsewhere(context, accountPk, { ...(chatKey === undefined ? {} : { chatKey }), model });
+        },
+    };
+};
+export const vectorsStoreOver = (context, keyed) => ({
+    ...keyed,
+    saveVectors: async (model, dims, rows) => {
+        write(context.database, () => vectors.saveVectors(context, model, dims, rows));
+    },
+    embeddedHashes: async (model, hashes) => imageChunks.embeddedHashes(context, model, hashes),
+});
+//# sourceMappingURL=vectors.js.map

package/dist/store/vectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.js","sourceRoot":"","sources":["../../src/store/vectors.ts"],"names":[],"mappings":"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"}

package/dist/update/index.d.ts

@@ -0,0 +1,52 @@
+import type { FetchLike } from "@wirecat/cli-base/http";
+import { type Installer } from "@wirecat/cli-base/update";
+/** npm, the clock, the terminal and the package manager as `<app> upgrade` sees them — faked in a test. */
+export interface UpdateEnvironment {
+    fetch?: FetchLike;
+    now?: () => number;
+    stderrIsTTY?: boolean;
+    scriptPath?: string;
+    /** Runs the update and answers its exit code; its output goes to stderr. */
+    spawn?: (argv: string[]) => number;
+}
+/** Words after which a line on stderr would land in a machine's answer, or would only repeat the command. */
+export declare const QUIET_WORDS: readonly string[];
+export interface AppUpdateOptions {
+    packageName: string;
+    /** The command a person types: `max`, `memo`. */
+    command: string;
+    version: string;
+    /**
+     * The app's own file, as `import.meta.url`: its installer is read from where it really lives. cli-core's own
+     * path would not do — a checkout or an npx cache puts the two apart.
+     */
+    entry: string;
+    /** The file the last answer from npm is kept in, in the app's state directory. */
+    statePath: (env: NodeJS.ProcessEnv) => string;
+    /** The app's setting; a config that cannot be read turns the check off. */
+    enabled: (env: NodeJS.ProcessEnv) => boolean;
+    /** Variables that turn it off besides `CI` and `NO_UPDATE_NOTIFIER`: `MAX_NO_UPDATE_CHECK`. */
+    offVariables: readonly string[];
+    /** `QUIET_WORDS` unless the app has its own; a word also counts as `--word=value`. */
+    quietWords?: readonly string[];
+}
+export interface NoticeOptions {
+    /** Whether stdout is a terminal; `process.stdout.isTTY` when not given. */
+    tty?: boolean;
+    environment?: UpdateEnvironment;
+    env?: NodeJS.ProcessEnv;
+}
+/** What `upgrade` and the daily notice need of one app: its installer, npm's latest version, the update itself. */
+export declare const appUpdate: (app: AppUpdateOptions) => {
+    installer: ({ scriptPath }?: UpdateEnvironment) => Installer;
+    latest: (environment?: UpdateEnvironment) => Promise<string | undefined>;
+    /** The package manager's output goes to stderr, so stdout stays one result. */
+    runUpdate: (argv: string[], environment?: UpdateEnvironment) => number;
+    /**
+     * The daily "a newer version exists" line, or `undefined`. Started beside the command and awaited
+     * after it, so asking npm costs the command nothing; any failure is silence, never an error.
+     */
+    updateNotice: (argv: readonly string[], { tty, environment, env }?: NoticeOptions) => Promise<string | undefined>;
+};
+export type AppUpdate = ReturnType<typeof appUpdate>;
+//# sourceMappingURL=index.d.ts.map

package/dist/update/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/update/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,0BAA0B,CAAA;AAEjC,2GAA2G;AAC3G,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAA;CACnC;AAED,6GAA6G;AAC7G,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAUxC,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,kFAAkF;IAClF,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,MAAM,CAAA;IAC7C,2EAA2E;IAC3E,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAA;IAC5C,+FAA+F;IAC/F,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,sFAAsF;IACtF,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CACxB;AAED,mHAAmH;AACnH,eAAO,MAAM,SAAS,QAAS,gBAAgB;iCAEV,iBAAiB,KAAQ,SAAS;2BAW7C,iBAAiB;IAEvC,+EAA+E;sBAC7D,MAAM,EAAE,gBAAe,iBAAiB,KAAQ,MAAM;IAExE;;;OAGG;yBAEK,SAAS,MAAM,EAAE,8BACuB,aAAa,KAC1D,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CA8BjC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/update/index.js

@@ -0,0 +1,68 @@
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { installerOf, latestVersion, runUpdate as runPackageManager, updateNotice as sharedNotice, } from "@wirecat/cli-base/update";
+/** Words after which a line on stderr would land in a machine's answer, or would only repeat the command. */
+export const QUIET_WORDS = [
+    "--help",
+    "-h",
+    "--version",
+    "-V",
+    "--json",
+    "--jsonl",
+    "--dry-run",
+    "--timeout",
+    "commands",
+];
+/** What `upgrade` and the daily notice need of one app: its installer, npm's latest version, the update itself. */
+export const appUpdate = (app) => {
+    const quietWords = app.quietWords ?? QUIET_WORDS;
+    const installer = ({ scriptPath } = {}) => installerOf(scriptPath ?? realpathSync(fileURLToPath(app.entry)));
+    const enabled = (env) => {
+        try {
+            return app.enabled(env);
+        }
+        catch {
+            return false;
+        }
+    };
+    return {
+        installer,
+        latest: (environment = {}) => latestVersion(app.packageName, environment.fetch ?? fetch, { timeoutMs: 3000 }),
+        /** The package manager's output goes to stderr, so stdout stays one result. */
+        runUpdate: (argv, environment = {}) => environment.spawn ? environment.spawn(argv) : runPackageManager(argv),
+        /**
+         * The daily "a newer version exists" line, or `undefined`. Started beside the command and awaited
+         * after it, so asking npm costs the command nothing; any failure is silence, never an error.
+         */
+        updateNotice: (argv, { tty, environment = {}, env = process.env } = {}) => {
+            try {
+                const delimiter = argv.indexOf("--");
+                const options = argv.slice(0, delimiter < 0 ? undefined : delimiter);
+                const quiet = options.some((word) => quietWords.some((quietWord) => word === quietWord || word.startsWith(`${quietWord}=`)));
+                if (quiet)
+                    return Promise.resolve(undefined);
+                const pretty = !argv.includes("--json") && !argv.includes("--jsonl") && (tty ?? process.stdout.isTTY === true);
+                return sharedNotice({
+                    argv,
+                    packageName: app.packageName,
+                    command: app.command,
+                    version: app.version,
+                    statePath: app.statePath(env),
+                    fetch: environment.fetch ?? fetch,
+                    ...(environment.now ? { now: environment.now } : {}),
+                    format: pretty ? "pretty" : "json",
+                    stderrIsTTY: environment.stderrIsTTY ?? process.stderr.isTTY === true,
+                    quiet: argv.includes("--quiet"),
+                    enabled: enabled(env),
+                    installer: installer(environment),
+                    env,
+                    offVariables: app.offVariables,
+                });
+            }
+            catch {
+                return Promise.resolve(undefined);
+            }
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/update/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/update/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.306.0",
+  "version": "0.307.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -119,6 +119,10 @@
     "./speech/wav": {
       "types": "./dist/speech/wav.d.ts",
       "default": "./dist/speech/wav.js"
+    },
+    "./update": {
+      "types": "./dist/update/index.d.ts",
+      "default": "./dist/update/index.js"
     }
   },
   "scripts": {