@wirecat/cli-core 0.19.4 → 0.262.0

package/dist/mcp/tools/search-tools.js

@@ -0,0 +1,128 @@
+import * as v from "valibot";
+import { SAVE_NEXT_STEPS } from "../../meetings/index.js";
+import { atDetail } from "../../output-detail.js";
+import { searchNotesOf } from "../../services/notes-search.js";
+import { RESOURCES_SEARCHED_WITH_MEETINGS } from "../../services/search-all-meetings.js";
+import { searchServices } from "../search-sync.js";
+import { limit, READ, tool } from "../tool.js";
+import { answerMessagesSearch, backendArgs, backendInputs, MESSAGES_SEARCH_DESCRIPTION, mailSearchInput, messagesSearchInput, offset, } from "./search.js";
+const text = v.pipe(v.string(), v.minLength(1), v.description("the query, in the strict Lucene language"));
+const exact = v.optional(v.pipe(v.boolean(), v.description("bare words and quotes match their exact form only; meaning is not searched")));
+const timezone = v.optional(v.pipe(v.string(), v.description("the IANA timezone for calendar date boundaries")));
+/** One tool per `search` leaf; `search_all` is the one an agent reaches for first. */
+export const searchTools = (messenger) => ({
+    search_all: tool({
+        nextSteps: SAVE_NEXT_STEPS,
+        title: "Search messages, mail and notes",
+        description: "Messenger messages, mail and notes held in the local store, merged best first — only these three kinds, and " +
+            "one meeting account when `source` names it; tasks, people, memories, projects, organizations and decisions are not " +
+            "searched here. Use it when you do not know where something was written. When you know the kind, call its own " +
+            "tool: search_mail (with from:, to:, cc:, subject:, mailbox:, is:unread), search_messages, search_notes, or " +
+            "search_conversations to find by meaning. An empty answer means none of the three holds it: try the kind's own " +
+            "tool, looser words or search by meaning before you conclude it was never written. Where the messenger's server can search, it is asked for messages too, as search_messages asks it " +
+            "(backend=both by default; archive for the local store only; server for the server's hits only) — mail and " +
+            "notes are local only. Each item says its kind (message, mail, note), ref (msg:… or note:…), provider and account. A query " +
+            "field one kind lacks skips that kind and `skipped` says why; `only` narrows the kinds. `source` names the " +
+            "accounts: provider:account as an item shows it, a provider, a kind or group:<name>; each kind reads its own of " +
+            "them, and `skipped` names an entry no kind reads. Meetings are read only when `source` names one meeting " +
+            "account (zoom:<account>, zoom, meetings, or all when one account holds meetings): its transcripts, chat and " +
+            "summaries join in as kind meeting, with meetingId, scope, id and startMs instead of a ref, and a null timestamp " +
+            "when the start is unknown; otherwise `skipped` says meetings were not searched. Returns { query, items, hasMore, searched, accounts, skipped, notes?, " +
+            "meetings?, server? }; accounts lists every account read as { resource, provider, account }; " +
+            "hasMore is null when a bounded meeting scan could not tell.",
+        input: v.object({
+            // Typed as present so the answer code reads them; offered only where the server can search.
+            ...(messenger.serverSearch ? backendInputs : {}),
+            text,
+            offset,
+            only: v.optional(v.pipe(v.array(v.picklist(RESOURCES_SEARCHED_WITH_MEETINGS)), v.minLength(1), v.description("only these kinds: messages, mail, notes; meetings when `source` names a meeting account"))),
+            source: v.optional(v.pipe(v.string(), v.minLength(1), v.description("only these accounts, comma-separated: provider:account as an item shows it, a provider, a kind or group:<name>"))),
+            max_meetings: v.optional(v.pipe(v.union([v.pipe(v.number(), v.integer(), v.minValue(1)), v.literal("all")]), v.description("how many of the meeting account's meetings to look through, newest first, or all (default 100)"))),
+            exact,
+            timezone,
+            limit,
+        }),
+        annotations: { ...READ, openWorldHint: Boolean(messenger.serverSearch) },
+        stored: (store, account, args, defaults, connect) => {
+            const network = Boolean(messenger.serverSearch) && args.backend !== "archive";
+            const services = searchServices(messenger, store, account, defaults, network ? connect : undefined);
+            const request = {
+                text: args.text,
+                limit: args.limit ?? defaults.limit,
+                ...(args.offset === undefined ? {} : { offset: args.offset }),
+                ...(args.exact ? { exact: true } : {}),
+                ...(args.timezone === undefined ? {} : { timezone: args.timezone }),
+                ...backendArgs(args),
+                env: defaults.env,
+                ...(defaults.signal === undefined ? {} : { signal: defaults.signal }),
+            };
+            return services.messages.searchAllWithMeetings({
+                ...request,
+                ...(args.only === undefined ? {} : { only: args.only }),
+                ...(args.source === undefined ? {} : { source: args.source }),
+                ...(args.max_meetings === undefined ? {} : { maxMeetings: args.max_meetings }),
+            });
+        },
+    }),
+    search_messages: tool({
+        nextSteps: SAVE_NEXT_STEPS,
+        title: "Search messenger messages",
+        description: MESSAGES_SEARCH_DESCRIPTION,
+        input: messagesSearchInput(messenger),
+        annotations: { ...READ, openWorldHint: Boolean(messenger.serverSearch) },
+        stored: (store, account, args, defaults, connect) => {
+            const network = args.sync_first || (Boolean(messenger.serverSearch) && args.backend !== "archive");
+            const services = searchServices(messenger, store, account, defaults, network ? connect : undefined);
+            return answerMessagesSearch(services.messages, args, defaults, services.searches).then((found) => atDetail(found, args.detail));
+        },
+    }),
+    search_mail: tool({
+        nextSteps: SAVE_NEXT_STEPS,
+        title: "Search mail",
+        description: "Search the mail imported into the local store (memo sync --mail), in the same query language as " +
+            "search_messages; one mail thread is one chat. It reads every mail account; `source` narrows it: email:<address>, " +
+            "or a list with group:<name>; an entry naming no mailbox is in `skipped`. Returns { items, page, limit, hasMore, " +
+            "completeness, query, accounts, skipped? }; accounts lists the mailboxes read as { resource, provider, account }.",
+        input: mailSearchInput(messenger),
+        annotations: { ...READ, openWorldHint: false },
+        stored: (store, account, args, defaults) => {
+            const services = searchServices(messenger, store, account, defaults);
+            return answerMessagesSearch(services.messages, args, defaults, undefined, "mail").then((found) => atDetail(found, args.detail));
+        },
+    }),
+    search_notes: tool({
+        nextSteps: SAVE_NEXT_STEPS,
+        title: "Search notes",
+        description: "Search the notes — written in memo, or imported from a notes folder — by words and, with the local text " +
+            "model, by meaning. Each hit says which found it (foundBy) and what it links to; `linked` lists the people, " +
+            "entities and notes the hits link most. `source` narrows which: notes:internal for notes written in memo, " +
+            "notes:<folder id> as a hit's folderId shows it, or a list with group:<name>; an entry naming none is in " +
+            "`skipped`. Returns { query, by, meaningSkipped?, hits, hasMore, nextOffset?, linked, accounts, skipped }.",
+        input: v.object({
+            text,
+            type: v.optional(v.pipe(v.picklist(["internal", "file"]), v.description("internal: written in memo; file: from a notes folder"))),
+            source: v.optional(v.pipe(v.string(), v.minLength(1), v.description("only these notes accounts, comma-separated: notes:internal, notes:<folder id>, or group:<name>"))),
+            tag: v.optional(v.pipe(v.string(), v.description("only notes with this tag"))),
+            filter: v.optional(v.pipe(v.string(), v.description("a query every hit must also match"))),
+            offset: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(1000))),
+            exact,
+            timezone,
+            limit,
+        }),
+        annotations: { ...READ, openWorldHint: false },
+        stored: (store, account, args, defaults) => searchNotesOf(store, account, args.text, {
+            limit: args.limit ?? defaults.limit,
+            command: messenger.app.command,
+            env: defaults.env,
+            ...(args.offset === undefined ? {} : { offset: args.offset }),
+            ...(args.type === undefined ? {} : { source: args.type }),
+            ...(args.source === undefined ? {} : { accounts: args.source }),
+            app: messenger.app,
+            ...(args.tag === undefined ? {} : { tag: args.tag }),
+            ...(args.filter === undefined ? {} : { filter: args.filter }),
+            ...(args.exact ? { exact: true } : {}),
+            ...(args.timezone === undefined ? {} : { timezone: args.timezone }),
+        }),
+    }),
+});
+//# sourceMappingURL=search-tools.js.map

package/dist/mcp/tools/search-tools.js.map

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

package/dist/mcp/tools/search.d.ts

@@ -0,0 +1,136 @@
+import * as v from "valibot";
+import type { Messenger } from "../../cli/messenger/context.js";
+import type { MessagesService } from "../../services/messages.js";
+import type { SearchKind } from "../../services/search-kind.js";
+import type { SearchesService } from "../../services/searches.js";
+export declare const MESSAGES_SEARCH_DESCRIPTION = "Use discover=true for partial lexical evidence and eligible replies to natural questions in the local archive, without model downloads; inspect each hit\u2019s discovery.missingTerms and surrounding messages before answering. Explicit syntax stays strict, and ranking is not answer confidence. Search the local store, and the messenger's server where it can search, using the Lucene 9.12.3 profile, default AND, with strict Boolean matching. Legacy discovery is explicit with language=legacy. Text or a versioned AST, account-scoped filters, calendar timezone, term/body regex and candidate presets use one service. Empty hits still report archive coverage. `saved` runs a saved search (searches_list) or an earlier run (searches_history). With sync_first, first fetch new messages within max_chats (5), sync_time (30s), max_messages (500), under messages.sync-first permission. A failed or bounded refresh keeps local results with stale coverage and refreshed details. thread=true attaches each hit's bounded parent/reply graph, with provenance and stale-edge labels; thread_hops, thread_messages, thread_bytes, thread_within set its separate bounds. Guide: https://github.com/WireCatLabs/cli-core/blob/main/docs/search/query-language.md. Text words and quoted phrases match every form of their words (Snowball stems, exact forms ranked first, query.stemming says how); exact:word, or exact=true, matches the exact form only. A bare word also matches voice transcripts, file names and file text; each hit's matchedIn says where (text, transcript, filename, file) and its excerpt comes from there; text:, transcript:, content: (file text), filename: narrow to one place. Without discover=true, where the messenger's server can search, it is also asked by default (backend=both; archive for the local store only) within server_time (5s), under messages.server-search: its hits are saved and re-checked by the same strict query, each hit says its source (archive, server, both), and server says what the server step did. coverage says what the archive held: messages and chats searched, chats never fetched or behind, up to ten attention chats, and next \u2014 the command that would improve the answer; when next is set and nothing was found, run it (or ask the owner) before concluding the message does not exist. Returns { items, page, limit, hasMore, corrections, completeness, wordsReady, stemsReady, query, coverage, server? }.";
+export declare const backendInputs: {
+    backend: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["archive", "server", "both"], undefined>, v.DescriptionAction<"archive" | "both" | "server", "both (default), archive, or the messenger's server; server hits are saved and re-checked by the same strict query, each hit says its source; needs messages.server-search">]>, undefined>;
+    server_time: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "how long to wait for the server, default 5s, at most 60s">]>, undefined>;
+};
+export declare const backendArgs: (args: {
+    backend?: "archive" | "server" | "both";
+    server_time?: string;
+}) => {
+    backend?: "archive" | "both" | "server" | undefined;
+    server?: {
+        timeMs: number;
+    } | undefined;
+};
+export declare const offset: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>, v.DescriptionAction<number, "skip this many hits: the nextOffset of the page before">]>, undefined>;
+export declare const messagesSearchInput: (messenger: Messenger) => v.ObjectSchema<{
+    readonly sync_first: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "first fetch new messages within the bounds">]>, undefined>;
+    readonly max_chats: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>]>, undefined>;
+    readonly sync_time: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "fetch time budget, default 30s">]>, undefined>;
+    readonly max_messages: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 10000, undefined>]>, undefined>;
+    readonly thread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly thread_hops: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 50, undefined>]>, undefined>;
+    readonly thread_messages: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 500, undefined>]>, undefined>;
+    readonly thread_bytes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1048576, undefined>]>, undefined>;
+    readonly thread_within: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly backend: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["archive", "server", "both"], undefined>, v.DescriptionAction<"archive" | "both" | "server", "both (default), archive, or the messenger's server; server hits are saved and re-checked by the same strict query, each hit says its source; needs messages.server-search">]>, undefined>;
+    readonly server_time: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "how long to wait for the server, default 5s, at most 60s">]>, undefined>;
+    readonly offset: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>, v.DescriptionAction<number, "skip this many hits: the nextOffset of the page before">]>, undefined>;
+    readonly detail: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<readonly ["brief", "full"], undefined>, v.DescriptionAction<"brief" | "full", string>]>, undefined>;
+    readonly text: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "the query: Lucene text or explicit legacy syntax">]>, undefined>;
+    readonly ast: v.OptionalSchema<v.UnknownSchema, undefined>;
+    readonly discover: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "partial lexical discovery with eligible replies in the local archive; use for questions when wording is uncertain; hits are evidence, not confirmed answers">]>, undefined>;
+    readonly language: v.OptionalSchema<v.PicklistSchema<["lucene", "legacy"], undefined>, undefined>;
+    readonly timezone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly chat: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, string>]>, undefined>;
+    readonly source: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, "a messenger held on this machine; personal, bots or all — as in: in text">]>, undefined>;
+    readonly type: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<["text", "voice", "file"], undefined>, v.DescriptionAction<"file" | "text" | "voice", "only messages of this type: text alone, a voice message, or a file">]>, undefined>;
+    readonly newest: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "newest first instead of best first">]>, undefined>;
+    readonly exact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "bare words and quotes match their exact form only, as exact:word does; not with an AST">]>, undefined>;
+    readonly context: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 20, undefined>, v.DescriptionAction<number, "messages around each hit">]>, undefined>;
+    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>, v.DescriptionAction<number, "how many">]>, undefined>;
+    readonly saved: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, "run a saved search (name) or an earlier run (id); text is AND-ed to it, other arguments replace its own">]>, undefined>;
+}, undefined>;
+/** `search_mail`: the mailboxes in the local store; no server, no fetching, no saved searches. */
+export declare const mailSearchInput: (messenger: Messenger) => v.ObjectSchema<{
+    readonly offset: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>, v.DescriptionAction<number, "skip this many hits: the nextOffset of the page before">]>, undefined>;
+    readonly detail: v.OptionalSchema<v.SchemaWithPipe<readonly [v.PicklistSchema<readonly ["brief", "full"], undefined>, v.DescriptionAction<"brief" | "full", string>]>, undefined>;
+    readonly text: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "the query, in the strict Lucene language">]>, undefined>;
+    readonly ast: v.OptionalSchema<v.UnknownSchema, undefined>;
+    readonly timezone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly chat: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, string>]>, undefined>;
+    readonly source: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, "only these mail accounts, comma-separated: email:<address>, or group:<name>; every one when unset">]>, undefined>;
+    readonly newest: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "newest first instead of best first">]>, undefined>;
+    readonly exact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "bare words and quotes match their exact form only, as exact:word does; not with an AST">]>, undefined>;
+    readonly context: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 20, undefined>, v.DescriptionAction<number, "messages around each hit">]>, undefined>;
+    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>, v.DescriptionAction<number, "how many">]>, undefined>;
+}, undefined>;
+export declare const syncArgs: (args: {
+    sync_first?: boolean;
+    max_chats?: number;
+    sync_time?: string;
+    max_messages?: number;
+}) => {
+    syncFirst: {
+        maxChats?: number | undefined;
+        timeMs?: number | undefined;
+        maxMessages?: number | undefined;
+    };
+} | {
+    syncFirst?: undefined;
+};
+export type MessagesSearchArgs = v.InferOutput<ReturnType<typeof messagesSearchInput>>;
+export declare const answerMessagesSearch: (messages: Pick<MessagesService, "search">, given: MessagesSearchArgs, defaults: {
+    limit: number;
+    signal?: AbortSignal;
+}, searches?: Pick<SearchesService, "resolve">, kind?: SearchKind) => Promise<{
+    items: import("../../services/messages.js").FoundMessage[];
+    hasMore: boolean;
+    nextOffset?: number;
+    refreshed?: import("../../services/search-refresh.js").SearchRefreshed;
+    server?: import("../../services/server-search.js").ServerSearched;
+    query?: import("../../services/messages-search.js").QueryMetadata;
+    coverage?: import("../../services/messages-search.js").SearchCoverage;
+    skipped?: import("../../search/account-list.js").SkippedSource[];
+    accounts?: {
+        resource: "mail";
+        provider: string;
+        account: string;
+    }[];
+    corrections: {
+        from: string;
+        to: string[];
+    }[];
+    completeness: (import("../../store/store.js").ChatCompleteness & import("../../store/store.js").AccountKey)[];
+    wordsReady: boolean;
+    stemsReady?: boolean;
+    page: number;
+    limit: number;
+}>;
+export declare const MESSAGES_STATS_DESCRIPTION = "Count what a strict Lucene query matches in the local store, by chat, sender, calendar day or hour (in the timezone). Each message is counted once; no text means every stored message. Words match every form, as in search_messages; exact=true counts exact forms only. Counts are lower bounds where coverage is not complete. sync_first optionally refreshes within max_chats, sync_time and max_messages; failed refreshes keep counts with stale coverage and refreshed details. Returns { by, items: [{ key, name, account?, count }], total, hasMore, page, limit, query, coverage, completeness }.";
+export declare const messagesStatsInput: (messenger: Messenger) => v.ObjectSchema<{
+    readonly sync_first: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "first fetch new messages within the bounds">]>, undefined>;
+    readonly max_chats: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>]>, undefined>;
+    readonly sync_time: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "fetch time budget, default 30s">]>, undefined>;
+    readonly max_messages: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 10000, undefined>]>, undefined>;
+    readonly text: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, "a strict Lucene query; omit to count all">]>, undefined>;
+    readonly ast: v.OptionalSchema<v.UnknownSchema, undefined>;
+    readonly exact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "bare words and quotes match their exact form only, as exact:word does; not with an AST">]>, undefined>;
+    readonly by: v.OptionalSchema<v.PicklistSchema<["chat", "sender", "day", "hour"], undefined>, undefined>;
+    readonly timezone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly chat: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, string>]>, undefined>;
+    readonly source: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, "a messenger held on this machine; personal, bots or all — as in: in text">]>, undefined>;
+    readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>, v.DescriptionAction<number, "how many">]>, undefined>;
+    readonly saved: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.DescriptionAction<string, "run a saved search (name) or an earlier run (id); text is AND-ed to it, other arguments replace its own">]>, undefined>;
+}, undefined>;
+export declare const answerMessagesStats: (messages: Pick<MessagesService, "stats">, args: v.InferOutput<ReturnType<typeof messagesStatsInput>>, defaults: {
+    limit: number;
+    signal?: AbortSignal;
+}, searches?: Pick<SearchesService, "resolve">) => Promise<{
+    refreshed?: import("../../services/search-refresh.js").SearchRefreshed;
+    by: import("../../services/messages-search.js").StatsGrouping;
+    items: import("../../services/messages-search.js").StatsRow[];
+    total: number;
+    hasMore: boolean;
+    query: import("../../services/messages-search.js").QueryMetadata;
+    coverage: import("../../services/messages-search.js").SearchCoverage;
+    completeness: (import("../../store/store.js").ChatCompleteness & import("../../store/store.js").AccountKey)[];
+    page: number;
+    limit: number;
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/mcp/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAG/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,4BAA4B,CAAA;AAO/E,eAAO,MAAM,2BAA2B,o4EACi1E,CAAA;AAEz3E,eAAO,MAAM,aAAa;IACxB,OAAO;IAQP,WAAW;CAGZ,CAAA;AAED,eAAO,MAAM,WAAW,SAAU;IAAE,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;CAGjG,CAAA;AAEF,eAAO,MAAM,MAAM,mSAQlB,CAAA;AAED,eAAO,MAAM,mBAAmB,cAAe,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;aAyDpD,CAAA;AAEJ,kGAAkG;AAClG,eAAO,MAAM,eAAe,cAAe,SAAS;;;;;;;;;;;;aA+BhD,CAAA;AAEJ,eAAO,MAAM,QAAQ,SAAU;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;;;;;;;;CASO,CAAA;AAER,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAA;AAyBtF,eAAO,MAAM,oBAAoB,aACrB,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,SAClC,kBAAkB,YACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,aACtC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,SACrC,UAAU;;;;;;;;;;;;;;;;;;;;;;;EAuDjB,CAAA;AAED,eAAO,MAAM,0BAA0B,klBAC0iB,CAAA;AAEjlB,eAAO,MAAM,kBAAkB,cAAe,SAAS;;;;;;;;;;;;;;aA0BnD,CAAA;AAEJ,eAAO,MAAM,mBAAmB,aACpB,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,QAClC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,YAChD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,aACtC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC;;;;;;;;;;;EAyB5C,CAAA"}

package/dist/mcp/tools/search.js

@@ -0,0 +1,169 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { parseDuration } from "../../cli/settings.js";
+import { DETAILS } from "../../output-detail.js";
+import { MAX_SEARCH_OFFSET } from "../../services/messages.js";
+import { syncInputs } from "../search-sync.js";
+import { threadArgs, threadInputs } from "../thread-options.js";
+import { chatOf, limit } from "../tool.js";
+const EXACT = "bare words and quotes match their exact form only, as exact:word does; not with an AST";
+export const MESSAGES_SEARCH_DESCRIPTION = "Use discover=true for partial lexical evidence and eligible replies to natural questions in the local archive, without model downloads; inspect each hit’s discovery.missingTerms and surrounding messages before answering. Explicit syntax stays strict, and ranking is not answer confidence. Search the local store, and the messenger's server where it can search, using the Lucene 9.12.3 profile, default AND, with strict Boolean matching. Legacy discovery is explicit with language=legacy. Text or a versioned AST, account-scoped filters, calendar timezone, term/body regex and candidate presets use one service. Empty hits still report archive coverage. `saved` runs a saved search (searches_list) or an earlier run (searches_history). With sync_first, first fetch new messages within max_chats (5), sync_time (30s), max_messages (500), under messages.sync-first permission. A failed or bounded refresh keeps local results with stale coverage and refreshed details. thread=true attaches each hit's bounded parent/reply graph, with provenance and stale-edge labels; thread_hops, thread_messages, thread_bytes, thread_within set its separate bounds. Guide: https://github.com/WireCatLabs/cli-core/blob/main/docs/search/query-language.md. Text words and quoted phrases match every form of their words (Snowball stems, exact forms ranked first, query.stemming says how); exact:word, or exact=true, matches the exact form only. A bare word also matches voice transcripts, file names and file text; each hit's matchedIn says where (text, transcript, filename, file) and its excerpt comes from there; text:, transcript:, content: (file text), filename: narrow to one place. Without discover=true, where the messenger's server can search, it is also asked by default (backend=both; archive for the local store only) within server_time (5s), under messages.server-search: its hits are saved and re-checked by the same strict query, each hit says its source (archive, server, both), and server says what the server step did. coverage says what the archive held: messages and chats searched, chats never fetched or behind, up to ten attention chats, and next — the command that would improve the answer; when next is set and nothing was found, run it (or ask the owner) before concluding the message does not exist. Returns { items, page, limit, hasMore, corrections, completeness, wordsReady, stemsReady, query, coverage, server? }.";
+export const backendInputs = {
+    backend: v.optional(v.pipe(v.picklist(["archive", "server", "both"]), v.description("both (default), archive, or the messenger's server; server hits are saved and re-checked by the same strict query, each hit says its source; needs messages.server-search"))),
+    server_time: v.optional(v.pipe(v.string(), v.description("how long to wait for the server, default 5s, at most 60s"))),
+};
+export const backendArgs = (args) => ({
+    ...(args.backend === undefined ? {} : { backend: args.backend }),
+    ...(args.server_time === undefined ? {} : { server: { timeMs: parseDuration(args.server_time, "server_time") } }),
+});
+export const offset = v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(MAX_SEARCH_OFFSET), v.description("skip this many hits: the nextOffset of the page before")));
+export const messagesSearchInput = (messenger) => v.object({
+    offset,
+    detail: v.optional(v.pipe(v.picklist(DETAILS), v.description("brief: reference, title, time, sender and excerpt only; full: the whole text and every provider field; " +
+        "unset: people, thread, labels and an excerpt"))),
+    // Typed as present so the answer code reads them; offered only where the server can search.
+    ...(messenger.serverSearch ? backendInputs : {}),
+    ...threadInputs,
+    ...syncInputs,
+    text: v.optional(v.pipe(v.string(), v.description("the query: Lucene text or explicit legacy syntax"))),
+    ast: v.optional(v.unknown()),
+    discover: v.optional(v.pipe(v.boolean(), v.description("partial lexical discovery with eligible replies in the local archive; use for questions when wording is uncertain; hits are evidence, not confirmed answers"))),
+    language: v.optional(v.picklist(["lucene", "legacy"])),
+    timezone: v.optional(v.string()),
+    chat: v.optional(chatOf(messenger)),
+    source: v.optional(v.pipe(v.string(), v.minLength(1), v.description("a messenger held on this machine; personal, bots or all — as in: in text"))),
+    type: v.optional(v.pipe(v.picklist(["text", "voice", "file"]), v.description("only messages of this type: text alone, a voice message, or a file"))),
+    newest: v.optional(v.pipe(v.boolean(), v.description("newest first instead of best first"))),
+    exact: v.optional(v.pipe(v.boolean(), v.description(EXACT))),
+    context: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(20), v.description("messages around each hit"))),
+    limit,
+    saved: v.optional(v.pipe(v.string(), v.minLength(1), v.description("run a saved search (name) or an earlier run (id); text is AND-ed to it, other arguments replace its own"))),
+});
+/** `search_mail`: the mailboxes in the local store; no server, no fetching, no saved searches. */
+export const mailSearchInput = (messenger) => v.object({
+    offset,
+    detail: v.optional(v.pipe(v.picklist(DETAILS), v.description("brief: reference, title, time, sender and excerpt only; full: the whole text and every provider field; " +
+        "unset: people, thread, labels and an excerpt"))),
+    text: v.optional(v.pipe(v.string(), v.description("the query, in the strict Lucene language"))),
+    ast: v.optional(v.unknown()),
+    timezone: v.optional(v.string()),
+    chat: v.optional(chatOf(messenger)),
+    source: v.optional(v.pipe(v.string(), v.minLength(1), v.description("only these mail accounts, comma-separated: email:<address>, or group:<name>; every one when unset"))),
+    newest: v.optional(v.pipe(v.boolean(), v.description("newest first instead of best first"))),
+    exact: v.optional(v.pipe(v.boolean(), v.description(EXACT))),
+    context: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(20), v.description("messages around each hit"))),
+    limit,
+});
+export const syncArgs = (args) => args.sync_first
+    ? {
+        syncFirst: {
+            ...(args.max_chats === undefined ? {} : { maxChats: args.max_chats }),
+            ...(args.sync_time === undefined ? {} : { timeMs: parseDuration(args.sync_time, "sync_time") }),
+            ...(args.max_messages === undefined ? {} : { maxMessages: args.max_messages }),
+        },
+    }
+    : {};
+const typedOf = (args) => Object.fromEntries(["text", "discover", "language", "timezone", "chat", "source", "newest", "exact", "context", "limit", "by"].flatMap((key) => (args[key] === undefined ? [] : [[key, args[key]]])));
+/** `saved` needs the searches service; a host that mounts the tool without it refuses `saved` rather than ignore it. */
+const resolveSaved = async (searches, args) => {
+    if (args.saved === undefined)
+        return undefined;
+    if (!searches)
+        throw new CliError("validation_error", "saved searches are not available on this server");
+    if (args.ast !== undefined)
+        throw new CliError("validation_error", "with saved, give more words as text, not an AST");
+    return searches.resolve(args.saved, typedOf(args));
+};
+const TYPES = { text: "NOT has:attachment", voice: "has:voice", file: "has:file" };
+const withType = (text, type) => type === undefined ? text : text === undefined ? TYPES[type] : `(${text}) AND ${TYPES[type]}`;
+export const answerMessagesSearch = async (messages, given, defaults, searches, kind = "messages") => {
+    if (given.type !== undefined && given.ast !== undefined)
+        throw new CliError("validation_error", "type narrows text; an AST names its own fields");
+    const text = withType(given.text, given.type);
+    const args = { ...given, ...(text === undefined ? {} : { text }) };
+    const resolved = await resolveSaved(searches, args);
+    if (resolved) {
+        const { params, pattern } = resolved;
+        const size = params.limit ?? defaults.limit;
+        const found = await messages.search({
+            kind,
+            ...syncArgs(args),
+            ...backendArgs(args),
+            ...threadArgs(args),
+            ...(pattern ? { pattern } : params.text === undefined ? {} : { text: params.text }),
+            ...(params.ast === undefined ? {} : { ast: params.ast }),
+            ...(params.discover === undefined ? {} : { discover: params.discover }),
+            language: params.language ?? (pattern ? "legacy" : "lucene"),
+            signal: defaults.signal,
+            ...(params.timezone === undefined ? {} : { timezone: params.timezone }),
+            limit: size,
+            ...(args.offset === undefined ? {} : { offset: args.offset }),
+            newest: params.newest === true,
+            ...(params.exact ? { exact: true } : {}),
+            context: params.context ?? 0,
+            ...(params.chat === undefined ? {} : { chat: params.chat }),
+            ...(params.source === undefined ? {} : { source: params.source }),
+            saved: resolved.id,
+        });
+        return { ...found, page: 1, limit: size };
+    }
+    if (args.text === undefined && args.ast === undefined)
+        throw new CliError("validation_error", "give search text, a versioned AST, or saved");
+    const size = args.limit ?? defaults.limit;
+    const found = await messages.search({
+        kind,
+        ...syncArgs(args),
+        ...backendArgs(args),
+        ...threadArgs(args),
+        ...(args.text === undefined ? {} : { text: args.text }),
+        ...(args.ast === undefined ? {} : { ast: args.ast }),
+        ...(args.discover === undefined ? {} : { discover: args.discover }),
+        language: args.language ?? "lucene",
+        signal: defaults.signal,
+        ...(args.timezone === undefined ? {} : { timezone: args.timezone }),
+        limit: size,
+        ...(args.offset === undefined ? {} : { offset: args.offset }),
+        newest: args.newest === true,
+        ...(args.exact ? { exact: true } : {}),
+        context: args.context ?? 0,
+        ...(args.chat === undefined ? {} : { chat: args.chat }),
+        ...(args.source === undefined ? {} : { source: args.source }),
+    });
+    return { ...found, page: 1, limit: size };
+};
+export const MESSAGES_STATS_DESCRIPTION = "Count what a strict Lucene query matches in the local store, by chat, sender, calendar day or hour (in the timezone). Each message is counted once; no text means every stored message. Words match every form, as in search_messages; exact=true counts exact forms only. Counts are lower bounds where coverage is not complete. sync_first optionally refreshes within max_chats, sync_time and max_messages; failed refreshes keep counts with stale coverage and refreshed details. Returns { by, items: [{ key, name, account?, count }], total, hasMore, page, limit, query, coverage, completeness }.";
+export const messagesStatsInput = (messenger) => v.object({
+    ...syncInputs,
+    text: v.optional(v.pipe(v.string(), v.minLength(1), v.description("a strict Lucene query; omit to count all"))),
+    ast: v.optional(v.unknown()),
+    exact: v.optional(v.pipe(v.boolean(), v.description(EXACT))),
+    by: v.optional(v.picklist(["chat", "sender", "day", "hour"])),
+    timezone: v.optional(v.string()),
+    chat: v.optional(chatOf(messenger)),
+    source: v.optional(v.pipe(v.string(), v.minLength(1), v.description("a messenger held on this machine; personal, bots or all — as in: in text"))),
+    limit,
+    saved: v.optional(v.pipe(v.string(), v.minLength(1), v.description("run a saved search (name) or an earlier run (id); text is AND-ed to it, other arguments replace its own"))),
+});
+export const answerMessagesStats = async (messages, args, defaults, searches) => {
+    const resolved = await resolveSaved(searches, args);
+    const params = resolved?.params ?? args;
+    if (params.regex || params.language === "legacy")
+        throw new CliError("validation_error", "stats messages show counts strict Lucene queries; this saved search is legacy");
+    const size = params.limit ?? defaults.limit;
+    const stats = await messages.stats({
+        ...syncArgs(args),
+        ...(params.text === undefined ? {} : { text: params.text }),
+        ...(params.ast === undefined ? {} : { ast: params.ast }),
+        by: params.by ?? "chat",
+        language: "lucene",
+        ...(params.exact ? { exact: true } : {}),
+        signal: defaults.signal,
+        ...(params.timezone === undefined ? {} : { timezone: params.timezone }),
+        limit: size,
+        ...(params.chat === undefined ? {} : { chat: params.chat }),
+        ...(params.source === undefined ? {} : { source: params.source }),
+        ...(resolved ? { saved: resolved.id } : {}),
+    });
+    return { ...stats, page: 1, limit: size };
+};
+//# sourceMappingURL=search.js.map

package/dist/mcp/tools/search.js.map

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

package/dist/mcp/tools/searches.d.ts

@@ -0,0 +1,4 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+export declare const searchesTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=searches.d.ts.map

package/dist/mcp/tools/searches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searches.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/searches.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAO/D,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,YAAY,CAAA;AAUpE,eAAO,MAAM,aAAa,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA+F1E,CAAA"}

package/dist/mcp/tools/searches.js

@@ -0,0 +1,91 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { listed } from "../../cli/paging.js";
+import { isAdminSelection } from "../../services/admin-statistics.js";
+import { servicesFor, storedDeps } from "../../services/index.js";
+import { readRankingSelection } from "../../services/rankings-selection.js";
+import { chatOf, limit, READ, tool } from "../tool.js";
+const LOCAL = { readOnlyHint: false, openWorldHint: false };
+const ROW = "{ id, name, command, params, language, version, fieldsVersion, createdAt, lastRunAt, runs }";
+const reference = v.pipe(v.string(), v.minLength(1), v.description("a saved search's name, or the id of any row of searches_history"));
+export const searchesTools = (messenger) => {
+    const services = (store, account, guard) => servicesFor(storedDeps(messenger, store, account, guard));
+    return {
+        searches_list: tool({
+            title: "List saved searches",
+            description: `The saved searches, by name; search_messages and stats_messages_show run one with \`saved\`. Returns { items: [${ROW}], page, limit, hasMore }.`,
+            input: v.object({}),
+            annotations: { ...READ, openWorldHint: false },
+            stored: async (store, account, _args, defaults) => listed(await services(store, account, defaults.guard).searches.list()),
+        }),
+        searches_history: tool({
+            title: "Search history",
+            description: "The searches and counts that ran, newest first, saved ones included: the query and options as given, " +
+                `never the results. \`saved\` with an id runs one again. Returns { items: [${ROW}], page, limit, hasMore }.`,
+            input: v.object({ limit }),
+            annotations: { ...READ, openWorldHint: false },
+            stored: async (store, account, args, defaults) => {
+                const size = args.limit ?? defaults.limit;
+                return { ...(await services(store, account, defaults.guard).searches.history(size)), page: 1, limit: size };
+            },
+        }),
+        searches_create: tool({
+            title: "Save a search",
+            description: "Saves a search under a name without running it; the query is checked against today's fields. Takes " +
+                "search_messages's arguments, plus `by` for stats_messages_show. A taken name is refused unless `replace`. " +
+                `Writes only to the local store. Returns ${ROW}.`,
+            input: v.object({
+                name: v.pipe(v.string(), v.minLength(1), v.description("up to 64 letters a–z, digits and hyphens")),
+                text: v.optional(v.pipe(v.string(), v.minLength(1), v.description("the query: Lucene text or legacy syntax"))),
+                ast: v.optional(v.unknown()),
+                language: v.optional(v.picklist(["lucene", "legacy"])),
+                timezone: v.optional(v.string()),
+                chat: v.optional(chatOf(messenger)),
+                source: v.optional(v.pipe(v.string(), v.minLength(1), v.description("a messenger held on this machine"))),
+                newest: v.optional(v.boolean()),
+                context: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(20))),
+                limit,
+                by: v.optional(v.picklist(["chat", "sender", "day", "hour"])),
+                selection: v.optional(v.union([v.string(), v.record(v.string(), v.unknown())])),
+                replace: v.optional(v.pipe(v.boolean(), v.description("overwrite a saved search of the same name"))),
+            }),
+            annotations: { ...LOCAL, destructiveHint: false, idempotentHint: false },
+            stored: async (store, account, { name, replace, ...params }, defaults) => {
+                if (params.selection !== undefined) {
+                    if (Object.entries(params).some(([key, value]) => key !== "selection" && value !== undefined))
+                        throw new CliError("validation_error", "with selection, save the resolved ranking query without additional options");
+                    if (isAdminSelection(params.selection))
+                        return services(store, account, defaults.guard).searches.create(name, params, { replace: replace === true });
+                    const selection = await readRankingSelection(store, params.selection);
+                    return services(store, account, defaults.guard).searches.create(name, {
+                        selection,
+                        target: selection.target,
+                        ...selection.options,
+                        timezone: selection.timezone,
+                        language: "lucene",
+                    }, { replace: replace === true });
+                }
+                return services(store, account, defaults.guard).searches.create(name, params, { replace: replace === true });
+            },
+        }),
+        searches_delete: tool({
+            title: "Delete a saved search",
+            description: `Deletes a saved search, or one run from the history. Writes only to the local store. Returns ${ROW}.`,
+            input: v.object({ name: reference }),
+            annotations: { ...LOCAL, destructiveHint: true, idempotentHint: false },
+            stored: async (store, account, args, defaults) => {
+                return services(store, account, defaults.guard).searches.delete(args.name);
+            },
+        }),
+        searches_clear: tool({
+            title: "Clear search history",
+            description: "Empties the search history; saved searches stay. Writes only to the local store. Returns { cleared }.",
+            input: v.object({}),
+            annotations: { ...LOCAL, destructiveHint: true, idempotentHint: true },
+            stored: async (store, account, _args, defaults) => {
+                return services(store, account, defaults.guard).searches.clear();
+            },
+        }),
+    };
+};
+//# sourceMappingURL=searches.js.map