@wirecat/cli-core 0.265.0 → 0.267.0

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

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import * as v from "valibot";
-import { listed } from "../../cli/paging.js";
+import { itemOf, listOf, snakeKeys } from "../../cli/envelope.js";
 import { servicesFor, storedDeps } from "../../services/index.js";
 import { READ, tool } from "../tool.js";
 const person = v.pipe(v.string(), v.minLength(1));
@@ -13,57 +13,63 @@ export const privatePeopleTools = (messenger) => ({
         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),
+        stored: async (store, account, args, defaults) => itemOf(snakeKeys(await 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),
+        stored: async (store, account, args, defaults) => itemOf(snakeKeys(await 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),
+        output: { entity: "contact_note", list: true },
+        stored: async (store, account, args, defaults) => {
+            const items = await servicesFor(storedDeps(messenger, store, account, defaults.guard)).privatePeople.notes(args.person);
+            return listOf("contacts notes list", { items, limit: Math.max(1, items.length), has_more: false });
+        },
     }),
     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),
+        output: { entity: "contact_note", list: false },
+        stored: async (store, account, args, defaults) => itemOf(await 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),
+        output: { entity: "contact_note", list: false },
+        stored: async (store, account, args, defaults) => itemOf(await 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),
+        output: { entity: "contact_note", list: false },
+        stored: async (store, account, args, defaults) => itemOf(await 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),
+        stored: async (store, account, args, defaults) => itemOf(snakeKeys(await 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),
+        stored: async (store, account, args, defaults) => itemOf(snakeKeys(await servicesFor(storedDeps(messenger, store, account, defaults.guard)).metadata.get(args.chat))),
     }),
     metadata_refresh: tool({
         title: "Refresh channel metadata",
@@ -78,7 +84,7 @@ export const privatePeopleTools = (messenger) => ({
                 offline: defaults.settings.offline ?? false,
                 withConnection: connect,
             };
-            return { items: [await servicesFor(deps).metadata.refresh(args.chat)], hasMore: false };
+            return itemOf(snakeKeys({ chats: [await servicesFor(deps).metadata.refresh(args.chat)], has_more: false }));
         },
     }),
     tags_auto: tool({
@@ -97,12 +103,12 @@ export const privatePeopleTools = (messenger) => ({
                 offline: args.refresh_metadata ? (defaults.settings.offline ?? false) : true,
                 withConnection: connect,
             };
-            return servicesFor(deps).metadata.auto({
+            return itemOf(snakeKeys(await servicesFor(deps).metadata.auto({
                 chats: args.chats,
                 limit: args.limit,
                 refresh: args.refresh_metadata,
                 dryRun: args.dry_run,
-            });
+            })));
         },
     }),
 });

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

@@ -1 +1 @@
-{"version":3,"file":"private-people.js","sourceRoot":"","sources":["../../../src/mcp/tools/private-people.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"private-people.js","sourceRoot":"","sources":["../../../src/mcp/tools/private-people.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEjE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAgB,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAErD,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;AACjD,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;AAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;AACrE,MAAM,KAAK,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAA;AAE3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IACpF,kBAAkB,EAAE,IAAI,CAAC;QACvB,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,0FAA0F;QACvG,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACxF,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QACvE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAC/C,MAAM,CACJ,SAAS,CACP,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAC1F,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,CACX,CACF,CACF;KACJ,CAAC;IACF,iBAAiB,EAAE,IAAI,CAAC;QACtB,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE,yCAAyC;QACtD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;QACtE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAC/C,MAAM,CACJ,SAAS,CACP,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAC1F,IAAI,CAAC,MAAM,EACX,IAAI,CACL,CACF,CACF;KACJ,CAAC;IACF,mBAAmB,EAAE,IAAI,CAAC;QACxB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,sGAAsG;QACnH,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;QAC9C,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE;QAC9C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YAC/C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CACxG,IAAI,CAAC,MAAM,CACZ,CAAA;YACD,OAAO,MAAM,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;QACpG,CAAC;KACF,CAAC;IACF,mBAAmB,EAAE,IAAI,CAAC;QACxB,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,gDAAgD;QAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC/B,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;QAC9C,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE;QAC/C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAC/C,MAAM,CACJ,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CACzF,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,EAAE,CACR,CACF;KACJ,CAAC;IACF,kBAAkB,EAAE,IAAI,CAAC;QACvB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,+EAA+E;QAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;QACxE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE;QAC/C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAC/C,MAAM,CACJ,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CACxF,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,IAAI,CACV,CACF;KACJ,CAAC;IACF,mBAAmB,EAAE,IAAI,CAAC;QACxB,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,oEAAoE;QACjF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE;QACvE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE;QAC/C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAC/C,MAAM,CACJ,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CACzF,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,QAAQ,CACd,CACF;KACJ,CAAC;IACF,qBAAqB,EAAE,IAAI,CAAC;QAC1B,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,wEAAwE;QACrF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC/B,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE;QACvE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAC/C,MAAM,CACJ,SAAS,CACP,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAC3F,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,EAAE,CACR,CACF,CACF;KACJ,CAAC;IACF,YAAY,EAAE,IAAI,CAAC;QACjB,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,kFAAkF;QAC/F,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACjC,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;QAC9C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAC/C,MAAM,CACJ,SAAS,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAC5G;KACJ,CAAC;IACF,gBAAgB,EAAE,IAAI,CAAC;QACrB,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,+FAA+F;QAC5G,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACjC,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QACvE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;YACxD,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,qCAAqC,CAAC,CAAA;YAC3F,MAAM,IAAI,GAAG;gBACX,GAAG,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;gBACxD,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,IAAI,KAAK;gBAC3C,cAAc,EAAE,OAAO;aACxB,CAAA;YACD,OAAO,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QAC7G,CAAC;KACF,CAAC;IACF,SAAS,EAAE,IAAI,CAAC;QACd,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,6IAA6I;QAC/I,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,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,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACjC,CAAC;QACF,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QACvE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;YACxD,MAAM,IAAI,GAAG;gBACX,GAAG,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC;gBACxD,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC5E,cAAc,EAAE,OAAO;aACxB,CAAA;YACD,OAAO,MAAM,CACX,SAAS,CACP,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACpC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,gBAAgB;gBAC9B,MAAM,EAAE,IAAI,CAAC,OAAO;aACrB,CAAC,CACH,CACF,CAAA;QACH,CAAC;KACF,CAAC;CACH,CAAC,CAAA"}

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

@@ -1 +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"}
+{"version":3,"file":"rankings.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/rankings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAQ/D,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,YAAY,CAAA;AAwCrD,eAAO,MAAM,YAAY,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAwFzE,CAAA"}

package/dist/mcp/tools/rankings.js

@@ -1,5 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import * as v from "valibot";
+import { evidenceAnswer, rankingAnswer } from "../../cli/messenger/stats-answers.js";
 import { AUTHOR_MEASURES, MESSAGE_MEASURES } from "../../domain/rankings-options.js";
 import { assertRetentionEvidenceRead } from "../../sends/permissions.js";
 import { isAdminSelection } from "../../services/admin-statistics.js";
@@ -46,9 +47,10 @@ export const rankingTools = (messenger) => {
     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.",
+            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 { item: { population, eligible, excluded, rows } }: each row has its score components and the selection its evidence takes; next names the top row's evidence; missing names what the store does not hold. No sends or mark-read; optional sync_first has separate write permissions.",
             input: topInput(target),
             annotations: { ...READ, openWorldHint: false },
+            output: { entity: "ranking", list: 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;
@@ -67,38 +69,42 @@ export const rankingTools = (messenger) => {
                     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, {
+                return rankingAnswer(await 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.",
+            description: "Page through contributing messages, question/answer pairs or retention cohort members from a row's 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; page.cursor continues, and next has the call for the next page.",
             input: evidenceInput(target),
             annotations: { ...READ, openWorldHint: false },
-            stored: (store, account, args, defaults) => {
+            output: { entity: "evidence", list: true },
+            stored: async (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)
+                const limit = args.limit ?? 20;
+                const found = await (isRetentionSelection(args.selection)
                     ? services.retention
                     : isAdminSelection(args.selection)
                         ? services.adminStatistics
                         : services.rankings).evidence(target, reference, args.selection, {
                     component: args.component,
-                    limit: args.limit ?? 20,
+                    limit,
                     ...(args.cursor ? { cursor: args.cursor } : {}),
                     signal: defaults.signal,
                 });
+                const selection = typeof args.selection === "string" ? args.selection : JSON.stringify(args.selection);
+                return evidenceAnswer(`stats ${target} evidence`, found, { [target === "messages" ? "message" : "person"]: reference, selection, component: args.component }, limit);
             },
         });
     }

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

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

@@ -1 +1 @@
-{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/reactions.ts"],"names":[],"mappings":"AAGA,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,CAoC1E,CAAA"}
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/reactions.ts"],"names":[],"mappings":"AAEA,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,CAoC1E,CAAA"}

package/dist/mcp/tools/reactions.js

@@ -1,6 +1,5 @@
 import * as v from "valibot";
-import { itemOf } from "../../cli/envelope.js";
-import { snakeKeys } from "../../cli/messenger/chat-answers.js";
+import { itemOf, snakeKeys } from "../../cli/envelope.js";
 import { onlineDeps, servicesFor } from "../../services/index.js";
 import { chatOf, message, tool, WRITE } from "../tool.js";
 /** Offered with `--allow-send`, under the `reaction` permission. */

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

@@ -1 +1 @@
-{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../../../src/mcp/tools/reactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAI/D,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,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CACzC,MAAM,CACJ,SAAS,CACP,MAAM,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,CACpG,CACF;SACJ,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,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CACzC,MAAM,CACJ,SAAS,CAAC,MAAM,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,CAAC,CACzG;SACJ,CAAC;KACH,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../../../src/mcp/tools/reactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAIzD,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,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CACzC,MAAM,CACJ,SAAS,CACP,MAAM,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,CACpG,CACF;SACJ,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,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CACzC,MAAM,CACJ,SAAS,CAAC,MAAM,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,CAAC,CACzG;SACJ,CAAC;KACH,CAAA;AACH,CAAC,CAAA"}

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

@@ -1 +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"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/review.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAI/D,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,YAAY,CAAA;AAGrD,eAAO,MAAM,WAAW,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAwFvE,CAAA"}

package/dist/mcp/tools/review.js

@@ -1,23 +1,23 @@
 import { CliError } from "@wirecat/cli-base";
 import * as v from "valibot";
+import { catchUpQuery, REVIEW_QUERY, reviewAnswer } from "../../cli/messenger/catch-up-answers.js";
 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 { 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 the owner owes and what others owe. Without a date in \`query\`, 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.",
+            "chats are left out unless they mention the owner, or `all` is set. Items are messages, oldest first, each " +
+            "naming its chat. The first next step, review.next, is the query the next review starts from; chats cut short, " +
+            "skipped or left out are `missing` entries.",
         input: v.object({
-            since_time: v.optional(v.pipe(v.string(), v.description("where the last review ended: ISO 8601, or 2h / 1d ago"))),
+            query: v.optional(v.pipe(v.string(), v.description('where the last review ended and which chat: date>"2026-10-01T09:00:00Z", chat:"Book club"'))),
             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"))),
@@ -25,10 +25,12 @@ export const reviewTools = (messenger) => ({
             model: v.optional(v.pipe(v.string(), v.minLength(1), v.description("which downloaded speech model hears them, with transcribe"))),
         }),
         annotations: READ,
+        output: { entity: "message.summary", list: true },
         served: async (services, args, defaults, connect) => {
-            if (args.new && (args.since_time !== undefined || args.unanswered !== undefined)) {
+            const { since: from, chat } = catchUpQuery(args.query, REVIEW_QUERY, "review");
+            if (args.new && (from !== 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");
+                throw new CliError("validation_error", "new keeps its own point — not with a date or unanswered");
             }
             const saved = args.new
                 ? checkPoints(messenger.app, {
@@ -42,9 +44,9 @@ export const reviewTools = (messenger) => ({
             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"),
+                since: from ?? saved?.first ?? reviewStart(),
                 ...(saved === undefined ? {} : { points: saved.chats }),
-                ...(args.chat === undefined ? {} : { chat: args.chat }),
+                ...(chat === undefined ? {} : { chat }),
                 ...(args.kinds === undefined ? {} : { kinds: args.kinds }),
                 ...(args.all ? { all: true } : {}),
                 ...(args.unanswered === undefined ? {} : { unansweredAfterHours: args.unanswered }),
@@ -57,14 +59,9 @@ export const reviewTools = (messenger) => ({
                     };
                 },
             });
+            const answer = reviewAnswer({ ...found, complete: found.complete && (hearing?.unheard.length ?? 0) === 0 }, hearing, await services.messages.reader(), { transcribe, fresh: saved !== undefined, ...(chat === undefined ? {} : { chat }) });
             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 }),
-            };
+            return answer;
         },
     }),
 });

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

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

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

@@ -1 +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"}
+{"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;AAK/D,OAAO,EAAE,KAAK,OAAO,EAAqB,MAAM,YAAY,CAAA;AAkB5D,sFAAsF;AACtF,eAAO,MAAM,WAAW,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA6KvE,CAAA"}

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

@@ -1,18 +1,16 @@
 import * as v from "valibot";
-import { SAVE_NEXT_STEPS } from "../../meetings/index.js";
-import { atDetail } from "../../output-detail.js";
+import { allAnswer, notesAnswer, offsetOf } from "../../cli/messenger/search-answers.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";
+import { answerMessagesSearch, backendArgs, backendInputs, MESSAGES_SEARCH_DESCRIPTION, mailSearchInput, messagesSearchInput, page, } 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 " +
@@ -22,19 +20,19 @@ export const searchTools = (messenger) => ({
             "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 " +
+            "field one kind lacks skips that kind and meta.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 " +
+            "them, and meta.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.",
+            "summaries join in as kind meeting, with offset_ms into the meeting, and a null timestamp " +
+            "when the start is unknown; otherwise meta.skipped says meetings were not searched. Returns { items, page, next?, " +
+            "missing?, meta }; meta.accounts lists every account read as provider:account; a missing entry says when a " +
+            "bounded meeting scan stopped before it could tell whether more match.",
         input: v.object({
             // Typed as present so the answer code reads them; offered only where the server can search.
             ...(messenger.serverSearch ? backendInputs : {}),
             text,
-            offset,
+            page,
             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)"))),
@@ -43,86 +41,109 @@ export const searchTools = (messenger) => ({
             limit,
         }),
         annotations: { ...READ, openWorldHint: Boolean(messenger.serverSearch) },
-        stored: (store, account, args, defaults, connect) => {
+        output: { entity: "hit", list: true },
+        stored: async (store, account, args, defaults, connect) => {
             const network = Boolean(messenger.serverSearch) && args.backend !== "archive";
             const services = searchServices(messenger, store, account, defaults, network ? connect : undefined);
+            const size = args.limit ?? defaults.limit;
+            const offset = offsetOf(args.page, size);
             const request = {
                 text: args.text,
-                limit: args.limit ?? defaults.limit,
-                ...(args.offset === undefined ? {} : { offset: args.offset }),
+                limit: size,
+                ...(offset === undefined ? {} : { 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({
+            const found = await services.messages.searchAllWithMeetings({
                 ...request,
                 ...(args.only === undefined ? {} : { only: args.only }),
                 ...(args.source === undefined ? {} : { source: args.source }),
                 ...(args.max_meetings === undefined ? {} : { maxMeetings: args.max_meetings }),
             });
+            const again = {
+                query: args.text,
+                ...(args.only === undefined ? {} : { only: args.only.join(",") }),
+                ...(args.source === undefined ? {} : { source: args.source }),
+                ...(args.max_meetings === undefined ? {} : { max_meetings: args.max_meetings }),
+                ...(args.exact ? { exact: true } : {}),
+                ...(args.timezone === undefined ? {} : { timezone: args.timezone }),
+            };
+            return allAnswer("search all", found, { limit: size, page: args.page ?? 1, again }, args.exact === true);
         },
     }),
     search_messages: tool({
-        nextSteps: SAVE_NEXT_STEPS,
         title: "Search messenger messages",
         description: MESSAGES_SEARCH_DESCRIPTION,
         input: messagesSearchInput(messenger),
         annotations: { ...READ, openWorldHint: Boolean(messenger.serverSearch) },
+        output: { entity: "message.hit", list: true },
         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));
+            return answerMessagesSearch(services.messages, args, defaults, services.searches);
         },
     }),
     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),
+            "or a list with group:<name>; an entry naming no mailbox is in meta.skipped. chat: narrows to one thread, by id or " +
+            "subject. Returns { items, page, next?, missing?, meta }; meta.accounts lists the mailboxes read.",
+        input: mailSearchInput(),
         annotations: { ...READ, openWorldHint: false },
+        output: { entity: "message.hit", list: true },
         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));
+            return answerMessagesSearch(services.messages, args, defaults, undefined, "mail");
         },
     }),
     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 }.",
+            "model, by meaning. Each item says which found it (found_by) and what it links to (links). `source` narrows " +
+            "which: notes:internal for notes written in memo, notes:<folder id> as an item's folder_id shows it, or a list " +
+            "with group:<name>; an entry naming none is in meta.skipped. `filter` is a query every item must also match, " +
+            "tag:work among them, and leaves the search by meaning as it is. Returns { items, page, next?, missing?, meta }.",
         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))),
+            page,
             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 }),
-        }),
+        output: { entity: "note.hit", list: true },
+        stored: async (store, account, args, defaults) => {
+            const size = args.limit ?? defaults.limit;
+            const offset = offsetOf(args.page, size);
+            const found = await searchNotesOf(store, account, args.text, {
+                limit: size,
+                command: messenger.app.command,
+                env: defaults.env,
+                ...(offset === undefined ? {} : { offset }),
+                ...(args.type === undefined ? {} : { source: args.type }),
+                ...(args.source === undefined ? {} : { accounts: args.source }),
+                app: messenger.app,
+                ...(args.filter === undefined ? {} : { filter: args.filter }),
+                ...(args.exact ? { exact: true } : {}),
+                ...(args.timezone === undefined ? {} : { timezone: args.timezone }),
+            });
+            const again = {
+                query: args.text,
+                ...(args.type === undefined ? {} : { type: args.type }),
+                ...(args.source === undefined ? {} : { source: args.source }),
+                ...(args.filter === undefined ? {} : { filter: args.filter }),
+                ...(args.exact ? { exact: true } : {}),
+                ...(args.timezone === undefined ? {} : { timezone: args.timezone }),
+            };
+            return notesAnswer("search notes", found, { limit: size, page: args.page ?? 1, again }, args.exact === true);
+        },
     }),
 });
 //# sourceMappingURL=search-tools.js.map