@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/mcp/tools/polls.js

@@ -0,0 +1,108 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { capability } from "../../cli/messenger/port.js";
+import { closeAfterOf, guardedClose, guardedCreatePoll, guardedVote, pollVoters, quizOf } from "../../sends/polls.js";
+import { chatOf, limit, message, READ, tool, WRITE } from "../tool.js";
+const answerId = v.pipe(v.string(), v.minLength(1), v.description("an answer id, as polls_show gives it"));
+export const pollReadTools = (messenger) => ({
+    ...(messenger.pollVoters
+        ? {
+            polls_voters: tool({
+                title: "Who voted in a poll",
+                description: "Who voted for what in a poll that is not anonymous, newest first: { chatId, messageId, total, items: " +
+                    "[{ person, answers, votedAt }], hasMore }. answer keeps those who chose it. Reading changes nothing.",
+                input: v.object({ chat: chatOf(messenger), message, answer: v.optional(answerId), limit }),
+                annotations: { ...READ, idempotentHint: true },
+                online: (adapter, args, defaults) => pollVoters(adapter, {
+                    chat: args.chat,
+                    message: args.message,
+                    limit: args.limit ?? defaults.limit,
+                    ...(args.answer === undefined ? {} : { answer: args.answer }),
+                }),
+            }),
+        }
+        : {}),
+    polls_show: tool({
+        title: "Show a poll",
+        description: "A poll as the message carries it now: its question, and each answer with the id a vote names.",
+        input: v.object({ chat: chatOf(messenger), message }),
+        annotations: { ...READ, idempotentHint: true },
+        online: async (adapter, args) => {
+            const poll = capability(adapter, "poll", "read a poll");
+            return poll((await adapter.resolve(args.chat)).id, args.message);
+        },
+    }),
+});
+/** Offered with `--allow-send`, each under the permission its guard kind names. */
+export const pollWriteTools = (messenger) => {
+    const chat = chatOf(messenger);
+    return {
+        polls_vote: tool({
+            title: "Vote in a poll",
+            description: "Vote as the owner, by answer ids from polls_show; an empty list takes the vote back. The others see it " +
+                "unless the poll is anonymous. Only when the owner asked for this vote.",
+            input: v.object({ chat, message, answers: v.array(answerId) }),
+            annotations: WRITE,
+            permission: "reaction",
+            online: (adapter, args, { guard }) => guardedVote(guard, adapter, { chat: args.chat, message: args.message, answers: args.answers }),
+        }),
+        polls_close: tool({
+            title: "Close a poll",
+            description: "Close the owner's own poll; it cannot be reopened. Only when the owner asked for it.",
+            input: v.object({ chat, message }),
+            annotations: WRITE,
+            permission: "edit",
+            online: (adapter, args, { guard }) => guardedClose(guard, adapter, { chat: args.chat, message: args.message }),
+        }),
+        polls_create: tool({
+            title: "Create a poll",
+            description: "Send a poll as the owner: public unless anonymous is true. Only when the owner asked for this exact poll " +
+                "in this exact chat. On outcome_unknown, retry with the send_id it returns, never a new one.",
+            input: v.object({
+                chat,
+                text: v.pipe(v.string(), v.minLength(1), v.description("the question")),
+                answers: v.pipe(v.array(v.pipe(v.string(), v.minLength(1))), v.minLength(2)),
+                multiple: v.optional(v.boolean()),
+                anonymous: v.optional(v.boolean()),
+                revote: v.optional(v.pipe(v.boolean(), v.description("people may change their vote; without it they cannot"))),
+                topic: v.optional(v.pipe(v.string(), v.minLength(1), v.description("the forum topic id; unsupported without topics"))),
+                send_as: v.optional(v.pipe(v.string(), v.minLength(1), v.description("an id from chats_send_as to post as; required where the chat posts as someone else by default"))),
+                send_id: v.optional(v.pipe(v.string(), v.minLength(1), v.description("from an earlier outcome_unknown"))),
+                quiz: v.optional(v.pipe(v.boolean(), v.description("a quiz: one answer is right, and a vote is final; where the messenger makes them"))),
+                correct: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.description("with quiz: the right answer's position, from 1"))),
+                solution: v.optional(v.pipe(v.string(), v.minLength(1), v.description("with quiz: what people see once they answered"))),
+                close_time: v.optional(v.pipe(v.string(), v.minLength(1), v.description("it closes by itself this long after sending, like 90s or 5m; where the messenger can"))),
+            }),
+            annotations: WRITE,
+            permission: "send",
+            online: async (adapter, args, { guard }) => {
+                if (args.quiz === true && !messenger.pollQuiz)
+                    throw new CliError("validation_error", "this messenger makes no quizzes");
+                const asQuiz = quizOf({
+                    ...(args.quiz === undefined ? {} : { quiz: args.quiz }),
+                    ...(args.correct === undefined ? {} : { correct: args.correct }),
+                    ...(args.solution === undefined ? {} : { solution: args.solution }),
+                });
+                const closeAfter = closeAfterOf(args.close_time, messenger.pollCloseSeconds);
+                const sent = await guardedCreatePoll(guard, adapter, {
+                    chat: args.chat,
+                    poll: {
+                        question: args.text,
+                        answers: args.answers,
+                        multiple: args.multiple === true,
+                        anonymous: args.anonymous === true,
+                        revote: args.revote === true,
+                        ...(asQuiz === undefined ? {} : { quiz: asQuiz }),
+                        ...(closeAfter === undefined ? {} : { closeAfter }),
+                    },
+                    silent: false,
+                    ...(args.send_id === undefined ? {} : { sendId: args.send_id }),
+                    ...(args.topic === undefined ? {} : { threadId: args.topic }),
+                    ...(args.send_as === undefined ? {} : { sendAs: args.send_as }),
+                });
+                return { sendId: sent.sendId, operationId: sent.operationId, message: sent.message };
+            },
+        }),
+    };
+};
+//# sourceMappingURL=polls.js.map

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

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

package/dist/mcp/tools/private-people.d.ts

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

package/dist/mcp/tools/private-people.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-people.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/private-people.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAG/D,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,YAAY,CAAA;AAOrD,eAAO,MAAM,kBAAkB,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAiH9E,CAAA"}

package/dist/mcp/tools/private-people.js

@@ -0,0 +1,109 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { listed } from "../../cli/paging.js";
+import { servicesFor, storedDeps } from "../../services/index.js";
+import { READ, tool } from "../tool.js";
+const person = v.pipe(v.string(), v.minLength(1));
+const id = v.pipe(v.string(), v.minLength(1));
+const text = v.pipe(v.string(), v.minLength(1), v.maxLength(100_000));
+const LOCAL = { readOnlyHint: false, openWorldHint: false };
+export const privatePeopleTools = (messenger) => ({
+    contacts_alias_set: tool({
+        title: "Set a private contact alias",
+        description: "Set a display name only in this account's local store; never rename a messenger contact.",
+        input: v.object({ person, alias: v.pipe(v.string(), v.minLength(1), v.maxLength(200)) }),
+        annotations: { ...LOCAL, idempotentHint: true, destructiveHint: false },
+        stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).privatePeople.alias(args.person, args.alias),
+    }),
+    contacts_alias_rm: tool({
+        title: "Remove a private contact alias",
+        description: "Remove only this account's local alias.",
+        input: v.object({ person }),
+        annotations: { ...LOCAL, idempotentHint: true, destructiveHint: true },
+        stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).privatePeople.alias(args.person, null),
+    }),
+    contacts_notes_list: tool({
+        title: "Private notes on a contact",
+        description: "User-authored notes stored locally for this account; they are separate from the person's public bio.",
+        input: v.object({ person }),
+        annotations: { ...READ, openWorldHint: false },
+        stored: async (store, account, args, defaults) => listed((await servicesFor(storedDeps(messenger, store, account, defaults.guard)).privatePeople.show(args.person))
+            .notes),
+    }),
+    contacts_notes_show: tool({
+        title: "Read a private contact note",
+        description: "Read one account-scoped note and its revision.",
+        input: v.object({ person, id }),
+        annotations: { ...READ, openWorldHint: false },
+        stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).privatePeople.note(args.person, args.id),
+    }),
+    contacts_notes_add: tool({
+        title: "Add a private contact note",
+        description: "Save the user's note locally with a stable id; nothing is sent to the person.",
+        input: v.object({ person, text }),
+        annotations: { ...LOCAL, idempotentHint: false, destructiveHint: false },
+        stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).privatePeople.add(args.person, args.text),
+    }),
+    contacts_notes_edit: tool({
+        title: "Edit a private contact note",
+        description: "Replace note text only if its revision still matches the one read.",
+        input: v.object({ person, id, text, revision: v.pipe(v.number(), v.integer(), v.minValue(1)) }),
+        annotations: { ...LOCAL, idempotentHint: false, destructiveHint: true },
+        stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).privatePeople.edit(args.person, args.id, args.text, args.revision),
+    }),
+    contacts_notes_remove: tool({
+        title: "Delete a private contact note",
+        description: "Delete this local note's text; the contact and source messages remain.",
+        input: v.object({ person, id }),
+        annotations: { ...LOCAL, idempotentHint: false, destructiveHint: true },
+        stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).privatePeople.remove(args.person, args.id),
+    }),
+    metadata_get: tool({
+        title: "Cached channel metadata",
+        description: "Read locally stored group/channel title, username, description and refresh time.",
+        input: v.object({ chat: person }),
+        annotations: { ...READ, openWorldHint: false },
+        stored: (store, account, args, defaults) => servicesFor(storedDeps(messenger, store, account, defaults.guard)).metadata.get(args.chat),
+    }),
+    metadata_refresh: tool({
+        title: "Refresh channel metadata",
+        description: "Read a group/channel description from the messenger and cache it locally. No remote mutation.",
+        input: v.object({ chat: person }),
+        annotations: { ...LOCAL, idempotentHint: true, destructiveHint: false },
+        stored: async (store, account, args, defaults, connect) => {
+            if (!connect)
+                throw new CliError("validation_error", "metadata refresh needs a connection");
+            const deps = {
+                ...storedDeps(messenger, store, account, defaults.guard),
+                offline: defaults.settings.offline ?? false,
+                withConnection: connect,
+            };
+            return { items: [await servicesFor(deps).metadata.refresh(args.chat)], hasMore: false };
+        },
+    }),
+    tags_auto: tool({
+        title: "Classify cached channels",
+        description: "Derive local keyword tags from title, username and description, preserving manual tags. Refresh is explicit. Dry-run uses cached data only.",
+        input: v.object({
+            chats: v.optional(v.array(person)),
+            limit: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(500))),
+            refresh_metadata: v.optional(v.boolean()),
+            dry_run: v.optional(v.boolean()),
+        }),
+        annotations: { ...LOCAL, idempotentHint: true, destructiveHint: false },
+        stored: async (store, account, args, defaults, connect) => {
+            const deps = {
+                ...storedDeps(messenger, store, account, defaults.guard),
+                offline: args.refresh_metadata ? (defaults.settings.offline ?? false) : true,
+                withConnection: connect,
+            };
+            return servicesFor(deps).metadata.auto({
+                chats: args.chats,
+                limit: args.limit,
+                refresh: args.refresh_metadata,
+                dryRun: args.dry_run,
+            });
+        },
+    }),
+});
+//# sourceMappingURL=private-people.js.map

package/dist/mcp/tools/private-people.js.map

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

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

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

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

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

package/dist/mcp/tools/rankings.js

@@ -0,0 +1,107 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { AUTHOR_MEASURES, MESSAGE_MEASURES } from "../../domain/rankings-options.js";
+import { assertRetentionEvidenceRead } from "../../sends/permissions.js";
+import { isAdminSelection } from "../../services/admin-statistics.js";
+import { isRetentionSelection } from "../../services/retention.js";
+import { searchServices, syncInputs } from "../search-sync.js";
+import { READ, tool } from "../tool.js";
+import { syncArgs } from "./search.js";
+const commonTop = {
+    ...syncInputs,
+    text: v.optional(v.string()),
+    ast: v.optional(v.unknown()),
+    chat: v.optional(v.string()),
+    source: v.optional(v.string()),
+    timezone: v.optional(v.string()),
+    exact: v.optional(v.boolean()),
+    saved: v.optional(v.string()),
+    weights: v.optional(v.union([v.string(), v.record(v.string(), v.number())])),
+    message_kind: v.optional(v.picklist(["all", "posts", "comments"])),
+    limit: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100))),
+};
+const topInput = (target) => target === "messages"
+    ? v.object({
+        ...commonTop,
+        measure: v.optional(v.picklist(MESSAGE_MEASURES)),
+        score: v.optional(v.picklist(["engaging"])),
+    })
+    : v.object({
+        ...commonTop,
+        measure: v.optional(v.picklist(AUTHOR_MEASURES)),
+        score: v.optional(v.picklist(["helpful", "active", "engaging"])),
+        min_messages: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1))),
+    });
+const commonEvidence = {
+    selection: v.union([v.string(), v.record(v.string(), v.unknown())]),
+    component: v.string(),
+    limit: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100))),
+    cursor: v.optional(v.pipe(v.string(), v.maxLength(4096))),
+};
+const evidenceInput = (target) => target === "messages"
+    ? v.object({ ...commonEvidence, message: v.string() })
+    : v.object({ ...commonEvidence, person: v.string() });
+export const rankingTools = (messenger) => {
+    const definitions = {};
+    for (const target of ["messages", "contacts"]) {
+        definitions[`stats_${target}_top`] = tool({
+            title: `Rank ${target === "messages" ? "messages" : "authors"}`,
+            description: "Rank the local matching population by a measure or explainable score; limit is applied after normalization. Unknown counters are not zero. Per-counter observation freshness is disclosed and counts are cumulative snapshots; graph counts describe stored events in the query period. Returns coverage, exclusions, score components and a resolved drilldown selection. No sends or mark-read; optional sync_first has separate write permissions.",
+            input: topInput(target),
+            annotations: { ...READ, openWorldHint: false },
+            stored: async (store, account, args, defaults, connect) => {
+                const services = searchServices(messenger, store, account, defaults, args.sync_first ? connect : undefined);
+                const min_messages = "min_messages" in args && typeof args.min_messages === "number" ? args.min_messages : undefined;
+                const { message_kind, saved, sync_first: _sync, sync_time: _time, max_chats: _chats, max_messages: _messages, ...plain } = args;
+                let params = {
+                    ...plain,
+                    ...(min_messages === undefined ? {} : { minMessages: min_messages }),
+                    ...(message_kind === undefined ? {} : { messageKind: message_kind }),
+                };
+                if (saved !== undefined) {
+                    if (args.ast !== undefined)
+                        throw new CliError("validation_error", "with saved, give extra query words rather than an AST");
+                    params = (await services.searches.resolve(saved, params)).params;
+                }
+                if (params.target !== undefined && params.target !== target)
+                    throw new CliError("validation_error", "saved ranking belongs to a different target");
+                if (params.regex || params.language === "legacy" || params.newest || params.context)
+                    throw new CliError("validation_error", "saved ranking must use strict Lucene without regex/newest/context modes");
+                return services.rankings.top(target, {
+                    ...params,
+                    ...syncArgs(args),
+                    language: "lucene",
+                    limit: params.limit ?? defaults.limit,
+                    signal: defaults.signal,
+                    ...(saved ? { saved } : {}),
+                });
+            },
+        });
+        definitions[`stats_${target}_evidence`] = tool({
+            title: `Inspect ${target} ranking evidence`,
+            description: "Page through contributing messages, question/answer pairs or retention cohort members from a resolved drilldown selection. Never fetches, sends, marks read or records evidence bodies. A cursor binds the component, selection and contributing stored rows; changed evidence requires a restart. JSON items are bounded to 64 KiB; total, included and nextCursor describe continuation.",
+            input: evidenceInput(target),
+            annotations: { ...READ, openWorldHint: false },
+            stored: (store, account, args, defaults) => {
+                const services = searchServices(messenger, store, account, defaults);
+                if (isRetentionSelection(args.selection))
+                    assertRetentionEvidenceRead(defaults.settings.permissions ?? {});
+                const reference = "message" in args ? args.message : args.person;
+                if (reference === undefined)
+                    throw new CliError("validation_error", "ranking evidence needs its exact message or person reference");
+                return (isRetentionSelection(args.selection)
+                    ? services.retention
+                    : isAdminSelection(args.selection)
+                        ? services.adminStatistics
+                        : services.rankings).evidence(target, reference, args.selection, {
+                    component: args.component,
+                    limit: args.limit ?? 20,
+                    ...(args.cursor ? { cursor: args.cursor } : {}),
+                    signal: defaults.signal,
+                });
+            },
+        });
+    }
+    return definitions;
+};
+//# sourceMappingURL=rankings.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+/** Offered with `--allow-send`, under the `reaction` permission. */
+export declare const reactionTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=reactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/reactions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAI/D,OAAO,EAAE,KAAK,OAAO,EAAgC,MAAM,YAAY,CAAA;AAEvE,oEAAoE;AACpE,eAAO,MAAM,aAAa,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA8B1E,CAAA"}

package/dist/mcp/tools/reactions.js

@@ -0,0 +1,32 @@
+import * as v from "valibot";
+import { onlineDeps, servicesFor } from "../../services/index.js";
+import { chatOf, message, tool, WRITE } from "../tool.js";
+/** Offered with `--allow-send`, under the `reaction` permission. */
+export const reactionTools = (messenger) => {
+    const chat = chatOf(messenger);
+    const messages = (adapter, guard) => servicesFor(onlineDeps(messenger, adapter, guard)).messages;
+    return {
+        reactions_add: tool({
+            title: "React to a message",
+            description: "Put the owner's reaction on one message; it replaces the one there was. The sender sees it. " +
+                "Only when the owner asked for this reaction on this message.",
+            input: v.object({
+                chat,
+                message,
+                emoji: v.pipe(v.string(), v.minLength(1), v.description("one emoji, for example 👍")),
+            }),
+            annotations: WRITE,
+            permission: "reaction",
+            online: (adapter, args, { guard }) => messages(adapter, guard).react({ chat: args.chat, message: args.message, emoji: args.emoji }),
+        }),
+        reactions_remove: tool({
+            title: "Take a reaction off",
+            description: "Take the owner's reaction off one message. Only when the owner asked for it.",
+            input: v.object({ chat, message }),
+            annotations: WRITE,
+            permission: "reaction",
+            online: (adapter, args, { guard }) => messages(adapter, guard).react({ chat: args.chat, message: args.message, emoji: null }),
+        }),
+    };
+};
+//# sourceMappingURL=reactions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../../../src/mcp/tools/reactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAgB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvE,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAoB,EAA2B,EAAE;IAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IAC9B,MAAM,QAAQ,GAAG,CAAC,OAAyB,EAAE,KAAgB,EAAE,EAAE,CAC/D,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC7D,OAAO;QACL,aAAa,EAAE,IAAI,CAAC;YAClB,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EACT,8FAA8F;gBAC9F,8DAA8D;YAChE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;gBACd,IAAI;gBACJ,OAAO;gBACP,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;aACtF,CAAC;YACF,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CACnC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;SAChG,CAAC;QACF,gBAAgB,EAAE,IAAI,CAAC;YACrB,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EAAE,8EAA8E;YAC3F,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAClC,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CACnC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SAC1F,CAAC;KACH,CAAA;AACH,CAAC,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/review.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAK/D,OAAO,EAAE,KAAK,OAAO,EAAsB,MAAM,YAAY,CAAA;AAG7D,eAAO,MAAM,WAAW,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAoFvE,CAAA"}

package/dist/mcp/tools/review.js

@@ -0,0 +1,71 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { checkPoints } from "../../cli/messenger/points.js";
+import { REVIEW_DAYS, reviewStart, UNANSWERED_HOURS } from "../../services/inbox.js";
+import { momentOf } from "../../services/moment.js";
+import { heard, hearForTool, modelWith } from "../../speech/hearing.js";
+import { chatOf, READ, tool } from "../tool.js";
+import { kindsInput } from "./inbox.js";
+export const reviewTools = (messenger) => ({
+    review: tool({
+        title: "Review who owes what",
+        description: "Every message, the owner's too (outgoing: true), in each chat that changed since a point — for sorting out " +
+            `what the owner owes and what others owe. Without \`since_time\`, the last ${REVIEW_DAYS} days; with \`new\`, ` +
+            "what changed since the last call with new, from points this tool keeps apart from the owner's own. Muted and archived " +
+            "chats are left out unless they mention the owner, or `all` is set. Returns { since, until, complete, chats: " +
+            "[{ id, title, messages, more }], skipped, partial, quiet }; when complete, the next review starts at until.",
+        input: v.object({
+            since_time: v.optional(v.pipe(v.string(), v.description("where the last review ended: ISO 8601, or 2h / 1d ago"))),
+            new: v.optional(v.pipe(v.boolean(), v.description("what changed since the last call with new"))),
+            chat: v.optional(chatOf(messenger)),
+            kinds: kindsInput,
+            unanswered: v.optional(v.pipe(v.number(), v.minValue(0), v.description(`only questions nobody answered, asked at least this many hours ago (${UNANSWERED_HOURS} is usual)`))),
+            all: v.optional(v.pipe(v.boolean(), v.description("muted and archived chats too"))),
+            transcribe: v.optional(v.pipe(v.boolean(), v.description("turn voice messages not heard yet into text; can take minutes"))),
+            model: v.optional(v.pipe(v.string(), v.minLength(1), v.description("which downloaded speech model hears them, with transcribe"))),
+        }),
+        annotations: READ,
+        served: async (services, args, defaults, connect) => {
+            if (args.new && (args.since_time !== undefined || args.unanswered !== undefined)) {
+                // An open question stays open: moving past it would drop it from the next review.
+                throw new CliError("validation_error", "new keeps its own point — not with since_time or unanswered");
+            }
+            const saved = args.new
+                ? checkPoints(messenger.app, {
+                    command: "mcp-review",
+                    profile: defaults.settings.profile,
+                    env: defaults.env,
+                    firstLookMs: REVIEW_DAYS * 86_400_000,
+                })
+                : undefined;
+            const model = modelWith(args.transcribe, args.model);
+            let hearing;
+            const transcribe = args.transcribe === true;
+            const found = await services.inbox.review({
+                since: args.since_time === undefined ? (saved?.first ?? reviewStart()) : momentOf(args.since_time, "since_time"),
+                ...(saved === undefined ? {} : { points: saved.chats }),
+                ...(args.chat === undefined ? {} : { chat: args.chat }),
+                ...(args.kinds === undefined ? {} : { kinds: args.kinds }),
+                ...(args.all ? { all: true } : {}),
+                ...(args.unanswered === undefined ? {} : { unansweredAfterHours: args.unanswered }),
+                enrich: async (raw) => {
+                    hearing = await hearForTool(messenger, connect, raw.chats.flatMap((chat) => chat.messages), transcribe, defaults, model);
+                    return {
+                        ...raw,
+                        complete: raw.complete && (hearing?.unheard.length ?? 0) === 0,
+                        chats: raw.chats.map((chat) => ({ ...chat, messages: heard(chat.messages, hearing) })),
+                    };
+                },
+            });
+            saved?.save(found.checked ?? {});
+            return {
+                ...found,
+                complete: found.complete && (hearing?.unheard.length ?? 0) === 0,
+                chats: found.chats.map((chat) => ({ ...chat, messages: heard(chat.messages, hearing) })),
+                unheard: hearing?.unheard ?? [],
+                ...(hearing?.problem === undefined ? {} : { transcribeProblem: hearing.problem }),
+            };
+        },
+    }),
+});
+//# sourceMappingURL=review.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../src/mcp/tools/review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAgB,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACrF,OAAO,EAAgB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC7E,MAAM,EAAE,IAAI,CAAC;QACX,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,6GAA6G;YAC7G,6EAA6E,WAAW,uBAAuB;YAC/G,wHAAwH;YACxH,8GAA8G;YAC9G,6GAA6G;QAC/G,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,UAAU,EAAE,CAAC,CAAC,QAAQ,CACpB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,uDAAuD,CAAC,CAAC,CAC3F;YACD,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,2CAA2C,CAAC,CAAC,CAAC;YAChG,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACnC,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,CAAC,CAAC,QAAQ,CACpB,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EACb,CAAC,CAAC,WAAW,CACX,uEAAuE,gBAAgB,YAAY,CACpG,CACF,CACF;YACD,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,8BAA8B,CAAC,CAAC,CAAC;YACnF,UAAU,EAAE,CAAC,CAAC,QAAQ,CACpB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,+DAA+D,CAAC,CAAC,CACpG;YACD,KAAK,EAAE,CAAC,CAAC,QAAQ,CACf,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,2DAA2D,CAAC,CAAC,CAC/G;SACF,CAAC;QACF,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;YAClD,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,EAAE,CAAC;gBACjF,kFAAkF;gBAClF,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,6DAA6D,CAAC,CAAA;YACvG,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG;gBACpB,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE;oBACzB,OAAO,EAAE,YAAY;oBACrB,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO;oBAClC,GAAG,EAAE,QAAQ,CAAC,GAAG;oBACjB,WAAW,EAAE,WAAW,GAAG,UAAU;iBACtC,CAAC;gBACJ,CAAC,CAAC,SAAS,CAAA;YACb,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;YACpD,IAAI,OAA4B,CAAA;YAChC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,KAAK,IAAI,CAAA;YAC3C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxC,KAAK,EACH,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;gBAC3G,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;gBACvD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACvD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC1D,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClC,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;gBACnF,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;oBACpB,OAAO,GAAG,MAAM,WAAW,CACzB,SAAS,EACT,OAAO,EACP,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAC1C,UAAU,EACV,QAAQ,EACR,KAAK,CACN,CAAA;oBACD,OAAO;wBACL,GAAG,GAAG;wBACN,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC;wBAC9D,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;qBACvF,CAAA;gBACH,CAAC;aACF,CAAC,CAAA;YACF,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;YAChC,OAAO;gBACL,GAAG,KAAK;gBACR,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC;gBAChE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;gBACxF,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE;gBAC/B,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;aAClF,CAAA;QACH,CAAC;KACF,CAAC;CACH,CAAC,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/runs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAG/D,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,YAAY,CAAA;AAErD,eAAO,MAAM,SAAS,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAwBrE,CAAA"}

package/dist/mcp/tools/runs.js

@@ -0,0 +1,28 @@
+import * as v from "valibot";
+import { runsDirFor } from "../../cli/runs/run.js";
+import { searchRuns } from "../../cli/runs/search.js";
+import { READ, tool } from "../tool.js";
+export const runsTools = (messenger) => ({
+    runs_search: tool({
+        title: "Search recorded diagnostic logs",
+        description: "Search this profile's run metadata and safe diagnostic events, including partial batches and failed IDs. No message contents, tokens or raw job logs. Literal query plus status, error_code, operation and since_time filters; paged results. Does not connect or record its own search. Returns items, page, limit, hasMore; each run has at most100 matched events with eventsTruncated.",
+        key: null,
+        annotations: { ...READ, openWorldHint: false },
+        input: v.object({
+            query: v.optional(v.string()),
+            status: v.optional(v.picklist(["success", "failed", "partial", "running"])),
+            error_code: v.optional(v.string()),
+            operation: v.optional(v.string()),
+            since_time: v.optional(v.string()),
+            limit: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100))),
+            page: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1))),
+        }),
+        local: async (args, defaults) => searchRuns(runsDirFor(messenger.app, defaults.env), {
+            ...args,
+            errorCode: args.error_code,
+            since: args.since_time,
+            profile: defaults.settings.profile ?? "default",
+        }),
+    }),
+});
+//# sourceMappingURL=runs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../../src/mcp/tools/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAgB,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAErD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,WAAW,EAAE,IAAI,CAAC;QAChB,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,4XAA4X;QAC9X,GAAG,EAAE,IAAI;QACT,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;QAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;YAC3E,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAClC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACjC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAClC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAClF,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;SACjE,CAAC;QACF,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAC9B,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;YAClD,GAAG,IAAI;YACP,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,KAAK,EAAE,IAAI,CAAC,UAAU;YACtB,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,IAAI,SAAS;SAChD,CAAC;KACL,CAAC;CACH,CAAC,CAAA"}

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

@@ -0,0 +1,5 @@
+import type { Messenger } from "../../cli/messenger/context.js";
+import { type AnyTool } from "../tool.js";
+/** One tool per `search` leaf; `search_all` is the one an agent reaches for first. */
+export declare const searchTools: (messenger: Messenger) => Record<string, AnyTool>;
+//# sourceMappingURL=search-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAM/D,OAAO,EAAE,KAAK,OAAO,EAAqB,MAAM,YAAY,CAAA;AAkB5D,sFAAsF;AACtF,eAAO,MAAM,WAAW,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA4JvE,CAAA"}