@leemour/cli-messaging 0.85.0 → 0.86.0

package/dist/mcp/tools/contacts-write.js

@@ -0,0 +1,37 @@
+import * as v from "valibot";
+import { onlineDeps, servicesFor } from "../../services/index.js";
+import { APPROVE, tool, WRITE } from "../tool.js";
+const person = v.pipe(v.string(), v.minLength(1), v.description("person id, or part of a known name"));
+/** The address book's writes. `contacts import` has no tool: it takes phone numbers, from a file the owner names. */
+export const contactWriteTools = (messenger) => {
+    const people = (adapter, guard) => servicesFor(onlineDeps(messenger, adapter, guard)).people;
+    const simple = (name, title, description) => tool({
+        title,
+        description: `${description} Only when the owner asked, for this person.`,
+        input: v.object({ person }),
+        annotations: WRITE,
+        _meta: APPROVE,
+        permission: "contacts",
+        online: (adapter, args, { guard }) => people(adapter, guard)[name](args.person),
+    });
+    return {
+        contacts_add: simple("add", "Add a contact", "Add a person to the owner's contacts."),
+        contacts_remove: simple("remove", "Remove a contact", "Remove a person from the owner's contacts; the chat stays."),
+        contacts_block: simple("block", "Block a person", "Stop a person from writing to the owner."),
+        contacts_unblock: simple("unblock", "Unblock a person", "Let a blocked person write to the owner again."),
+        contacts_rename: tool({
+            title: "Rename a contact",
+            description: "Give a person a name only the owner sees. Only when the owner asked for this name.",
+            input: v.object({
+                person,
+                first_name: v.pipe(v.string(), v.minLength(1)),
+                last_name: v.optional(v.string()),
+            }),
+            annotations: WRITE,
+            _meta: APPROVE,
+            permission: "contacts",
+            online: (adapter, args, { guard }) => people(adapter, guard).rename(args.person, args.first_name, args.last_name),
+        }),
+    };
+};
+//# sourceMappingURL=contacts-write.js.map

package/dist/mcp/tools/contacts-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts-write.js","sourceRoot":"","sources":["../../../src/mcp/tools/contacts-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAgB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC,CAAA;AAEtG,qHAAqH;AACrH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAoB,EAA2B,EAAE;IACjF,MAAM,MAAM,GAAG,CAAC,OAAyB,EAAE,KAAgB,EAAE,EAAE,CAC7D,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;IAC3D,MAAM,MAAM,GAAG,CAAC,IAA4C,EAAE,KAAa,EAAE,WAAmB,EAAW,EAAE,CAC3G,IAAI,CAAC;QACH,KAAK;QACL,WAAW,EAAE,GAAG,WAAW,8CAA8C;QACzE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,WAAW,EAAE,KAAK;QAClB,KAAK,EAAE,OAAO;QACd,UAAU,EAAE,UAAU;QACtB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;KAChF,CAAC,CAAA;IACJ,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,uCAAuC,CAAC;QACrF,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,kBAAkB,EAAE,4DAA4D,CAAC;QACnH,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,0CAA0C,CAAC;QAC7F,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,kBAAkB,EAAE,gDAAgD,CAAC;QACzG,eAAe,EAAE,IAAI,CAAC;YACpB,KAAK,EAAE,kBAAkB;YACzB,WAAW,EAAE,oFAAoF;YACjG,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;gBACd,MAAM;gBACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC9C,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aAClC,CAAC;YACF,WAAW,EAAE,KAAK;YAClB,KAAK,EAAE,OAAO;YACd,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC;SAClH,CAAC;KACH,CAAA;AACH,CAAC,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmBxC;;;GAGG;AACH,eAAO,MAAM,SAAS,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAWrE,CAAA;AAEF,0GAA0G;AAC1G,eAAO,MAAM,aAAa,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAA8B,CAAA;AAEzG,kHAAkH;AAClH,eAAO,MAAM,WAAW,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAkC,CAAA;AAE3G,oFAAoF;AACpF,eAAO,MAAM,SAAS,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAOrE,CAAA"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoBxC;;;GAGG;AACH,eAAO,MAAM,SAAS,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAWrE,CAAA;AAEF,0GAA0G;AAC1G,eAAO,MAAM,aAAa,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAA8B,CAAA;AAEzG,kHAAkH;AAClH,eAAO,MAAM,WAAW,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAkC,CAAA;AAE3G,oFAAoF;AACpF,eAAO,MAAM,SAAS,cAAe,SAAS,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAQrE,CAAA"}

package/dist/mcp/tools.js

@@ -3,6 +3,7 @@ import { adminTools } from "./tools/admin.js";
 import { chatsTools } from "./tools/chats.js";
 import { chatsReadTools } from "./tools/chats-read.js";
 import { contactsTools } from "./tools/contacts.js";
+import { contactWriteTools } from "./tools/contacts-write.js";
 import { folderTools } from "./tools/folders.js";
 import { inboxTools } from "./tools/inbox.js";
 import { messagesTools } from "./tools/messages.js";
@@ -39,6 +40,7 @@ export const deleteTools = (messenger) => messageDeleteTools(messenger);
 export const sendTools = (messenger) => ({
     ...adminTools(messenger),
     ...folderTools(messenger),
+    ...contactWriteTools(messenger),
     ...messageSendTools(messenger),
     ...messageActionTools(messenger),
     ...reactionTools(messenger),

package/dist/mcp/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,YAAY,CAAC,SAAS,CAAC;IAC1B,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,uBAAuB,CAAC,SAAS,CAAC;CACtC,CAAC,CAAA;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;AAEzG,kHAAkH;AAClH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAA;AAE3G,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,gBAAgB,CAAC,SAAS,CAAC;IAC9B,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,cAAc,CAAC,SAAS,CAAC;CAC7B,CAAC,CAAA"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,YAAY,CAAC,SAAS,CAAC;IAC1B,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,uBAAuB,CAAC,SAAS,CAAC;CACtC,CAAC,CAAA;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;AAEzG,kHAAkH;AAClH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAA;AAE3G,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,iBAAiB,CAAC,SAAS,CAAC;IAC/B,GAAG,gBAAgB,CAAC,SAAS,CAAC;IAC9B,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,cAAc,CAAC,SAAS,CAAC;CAC7B,CAAC,CAAA"}

package/dist/services/people.d.ts

@@ -1,4 +1,5 @@
-import type { Contact, Member, Page, PersonCard } from "../domain/models.js";
+import type { Contact, Id, Member, Page, PersonCard, PhoneBookEntry } from "../domain/models.js";
+import { type Operated } from "../sends/guarded.js";
 import type { PageWindow } from "./chats.js";
 import { type ServiceDeps } from "./deps.js";
 export interface ContactSync {
@@ -21,6 +22,26 @@ export interface PeopleService {
     lookup(phone: string): Promise<Member>;
     /** The whole contact list from the messenger into the store: what was new, what changed. */
     sync(): Promise<ContactSync>;
+    add(person: string): Promise<Operated<{
+        person: Member;
+    }>>;
+    remove(person: string): Promise<Operated<{
+        personId: Id;
+    }>>;
+    block(person: string): Promise<Operated<{
+        personId: Id;
+    }>>;
+    unblock(person: string): Promise<Operated<{
+        personId: Id;
+    }>>;
+    rename(person: string, firstName: string, lastName?: string): Promise<Operated<{
+        person: Member;
+    }>>;
+    /** Only counts and the people recognised: never a number. */
+    import(entries: PhoneBookEntry[]): Promise<Operated<{
+        sent: number;
+        recognised: Member[];
+    }>>;
 }
 export declare const peopleService: (deps: ServiceDeps) => PeopleService;
 /** Digits, with the `+` and the spaces, dashes and brackets people type dropped. */

package/dist/services/people.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/services/people.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGlF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,WAAW,CAAA;AAEzD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IACjG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACzC,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtC,4FAA4F;IAC5F,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CAC7B;AAED,eAAO,MAAM,aAAa,SAAU,WAAW,KAAG,aA2ChD,CAAA;AAEF,oFAAoF;AACpF,eAAO,MAAM,OAAO,UAAW,MAAM,KAAG,MAMvC,CAAA"}
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/services/people.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEtG,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAGjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,WAAW,CAAA;AAEzD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IACjG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACzC,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtC,4FAA4F;IAC5F,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;IAC5B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC1D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,QAAQ,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC,CAAA;IAC3D,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,QAAQ,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC,CAAA;IAC1D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,QAAQ,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC,CAAA;IAC5D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IACnG,6DAA6D;IAC7D,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC,CAAA;CAC7F;AAID,eAAO,MAAM,aAAa,SAAU,WAAW,KAAG,aAqHjD,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,OAAO,UAAW,MAAM,KAAG,MAMvC,CAAA"}

package/dist/services/people.js

@@ -1,51 +1,102 @@
 import { CliError } from "@leemour/cli-core";
 import { capability } from "../cli/messenger/port.js";
 import { pickPerson } from "../resolve.js";
+import { guardedWrite } from "../sends/guarded.js";
+import { newOperationId } from "../sends/send-id.js";
 import { storeIfOpen } from "./deps.js";
-export const peopleService = (deps) => ({
-    list: async (options) => {
-        // The chats first: a messenger whose login brings its people writes them before the store is asked.
-        const chats = deps.offline ? undefined : (await (await deps.connection()).chats({ offset: 0 })).items;
-        const held = deps.offline ? { store: await deps.store(), account: await deps.account() } : await storeIfOpen(deps);
-        if (held && (await held.store.countContacts(held.account)) > 0)
-            return storedContacts(held.store, held.account, options);
-        return contactsIn(chats ?? (await (await deps.store()).chats(await deps.account(), {})).items, options);
-    },
-    show: async (person) => {
-        if (deps.offline) {
+export const peopleService = (deps) => {
+    const online = async (command) => {
+        if (deps.offline)
+            throw new CliError("validation_error", `\`${command}\` changes the address book; not with --offline`);
+        return deps.connection();
+    };
+    const change = async (action, person, act) => {
+        const connection = await online(`contacts ${action.slice("contact-".length)}`);
+        const [personId] = await capability(connection, "people", "find people")([person]);
+        const operationId = newOperationId();
+        const done = await guardedWrite(deps.guard, { operationId, chatId: null, kind: "account", action }, () => act(connection, personId));
+        return { operationId, personId: personId, done };
+    };
+    return {
+        list: async (options) => {
+            // The chats first: a messenger whose login brings its people writes them before the store is asked.
+            const chats = deps.offline ? undefined : (await (await deps.connection()).chats({ offset: 0 })).items;
+            const held = deps.offline ? { store: await deps.store(), account: await deps.account() } : await storeIfOpen(deps);
+            if (held && (await held.store.countContacts(held.account)) > 0)
+                return storedContacts(held.store, held.account, options);
+            return contactsIn(chats ?? (await (await deps.store()).chats(await deps.account(), {})).items, options);
+        },
+        show: async (person) => {
+            if (deps.offline) {
+                const store = await deps.store();
+                const account = await deps.account();
+                const found = pickPerson(person, await store.people(account.provider, { account: account.account }));
+                return { ...found, chats: await sharedChats(store, account, found.id) };
+            }
+            const card = await (await deps.connection()).contact(person);
+            if (card.chats.length > 0)
+                return card;
+            const held = await storeIfOpen(deps);
+            return held ? { ...card, chats: await sharedChats(held.store, held.account, card.id) } : card;
+        },
+        lookup: async (phone) => capability(await deps.connection(), "lookup", "find a person by phone")(phone),
+        sync: async () => {
+            if (deps.offline) {
+                throw new CliError("validation_error", "`contacts sync` takes the list from the messenger; not with --offline");
+            }
+            const people = await capability(await deps.connection(), "addressBook", "list its contacts")();
             const store = await deps.store();
             const account = await deps.account();
-            const found = pickPerson(person, await store.people(account.provider, { account: account.account }));
-            return { ...found, chats: await sharedChats(store, account, found.id) };
-        }
-        const card = await (await deps.connection()).contact(person);
-        if (card.chats.length > 0)
-            return card;
-        const held = await storeIfOpen(deps);
-        return held ? { ...card, chats: await sharedChats(held.store, held.account, card.id) } : card;
-    },
-    lookup: async (phone) => capability(await deps.connection(), "lookup", "find a person by phone")(phone),
-    sync: async () => {
-        if (deps.offline) {
-            throw new CliError("validation_error", "`contacts sync` takes the list from the messenger; not with --offline");
-        }
-        const people = await capability(await deps.connection(), "addressBook", "list its contacts")();
-        const store = await deps.store();
-        const account = await deps.account();
-        const before = await store.people(account.provider, { account: account.account });
-        let added = 0;
-        let changed = 0;
-        for (const person of people) {
-            const known = before.get(person.id);
-            if (!known)
-                added += 1;
-            else if (known.name !== person.name || known.username !== person.username)
-                changed += 1;
-        }
-        await store.savePeople(account, people);
-        return { added, changed, known: (await store.people(account.provider, { account: account.account })).all().length };
-    },
-});
+            const before = await store.people(account.provider, { account: account.account });
+            let added = 0;
+            let changed = 0;
+            for (const person of people) {
+                const known = before.get(person.id);
+                if (!known)
+                    added += 1;
+                else if (known.name !== person.name || known.username !== person.username)
+                    changed += 1;
+            }
+            await store.savePeople(account, people);
+            return {
+                added,
+                changed,
+                known: (await store.people(account.provider, { account: account.account })).all().length,
+            };
+        },
+        add: async (person) => {
+            const { operationId, done } = await change("contact-add", person, (connection, id) => capability(connection, "addContact", "add a contact")(id));
+            return { operationId, person: done };
+        },
+        remove: async (person) => {
+            const { operationId, personId } = await change("contact-remove", person, (connection, id) => capability(connection, "removeContact", "remove a contact")(id));
+            return { operationId, personId };
+        },
+        block: async (person) => {
+            const { operationId, personId } = await change("contact-block", person, (connection, id) => capability(connection, "block", "block a person")(id));
+            return { operationId, personId };
+        },
+        unblock: async (person) => {
+            const { operationId, personId } = await change("contact-unblock", person, (connection, id) => capability(connection, "unblock", "unblock a person")(id));
+            return { operationId, personId };
+        },
+        rename: async (person, firstName, lastName) => {
+            if (firstName.trim() === "")
+                throw new CliError("validation_error", "a name cannot be empty");
+            const { operationId, done } = await change("contact-rename", person, (connection, id) => capability(connection, "renameContact", "rename a contact")(id, firstName.trim(), lastName?.trim()));
+            return { operationId, person: done };
+        },
+        import: async (entries) => {
+            if (entries.length === 0)
+                throw new CliError("validation_error", "the file names nobody");
+            const connection = await online("contacts import");
+            const importing = capability(connection, "importContacts", "import contacts");
+            const operationId = newOperationId();
+            const recognised = await guardedWrite(deps.guard, { operationId, chatId: null, kind: "account", action: "contact-import", count: entries.length }, () => importing(entries));
+            return { operationId, sent: entries.length, recognised };
+        },
+    };
+};
 /** Digits, with the `+` and the spaces, dashes and brackets people type dropped. */
 export const phoneOf = (typed) => {
     const digits = typed.replace(/[\s()+-]/g, "");

package/dist/services/people.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leemour/cli-messaging",
-  "version": "0.85.0",
+  "version": "0.86.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "MIT",
   "author": "Viacheslav Ptsarev",

package/parity.json

@@ -6,7 +6,8 @@
     },
     "--after": {
       "value": "<id-or-time>",
-      "meaning": "read what came after this message id, this ISO 8601 time, or 2h / 1d ago; not with --before"
+      "meaning": "read what came after this message id, this ISO 8601 time, or 2h / 1d ago; not with --before",
+      "note": "`messages context --after <n>` is a count, not a position (e1)"
     },
     "--all": {
       "meaning": "every row, no paging"
@@ -55,7 +56,7 @@
     "--before": {
       "value": "<id-or-time>",
       "meaning": "read what came before this message id, this ISO 8601 time, or 2h / 1d ago",
-      "note": "tg's `messages list` spells the value `<id>`"
+      "note": "`messages context --before <n>` is a count, not a position (e1); tg's `messages list` takes `<id>` only (e7)"
     },
     "--bot": {
       "meaning": "the bot section of the profile's settings, rather than the personal account's"
@@ -70,7 +71,7 @@
     "--chat": {
       "value": "<chat>",
       "meaning": "a chat, by id or name; repeat it for more",
-      "note": "tg's `messages search` spells the value `<id>`; rule 6 says `<chat>`"
+      "note": "max's `messages search` takes `<id>` only, since searching never connects to resolve a name; rule 6 says `<chat>` (e8)"
     },
     "--check": {
       "meaning": "say whether a newer version exists, and install nothing"
@@ -96,13 +97,15 @@
     },
     "--event": {
       "value": "<names>",
-      "meaning": "only these events, comma-separated, as the messenger names them"
+      "meaning": "only these events, comma-separated, as the messenger names them",
+      "note": "differs by one letter from `watch --events`, a switch with an unrelated meaning (e12)"
     },
     "--events": {
-      "meaning": "also print edits, deletions and reactions; every line then names its event"
+      "meaning": "also print edits, deletions and reactions; every line then names its event",
+      "note": "differs by one letter from `chats events --event`, a filter with an unrelated meaning (e12)"
     },
     "--file": {
-      "value": "<path>",
+      "value": "<file>",
       "meaning": "attach a file; images go as a photo, videos as a video. Repeat it for more"
     },
     "--first-name": {
@@ -114,14 +117,15 @@
     },
     "--format": {
       "value": "<format>",
-      "meaning": "jsonl or md"
+      "meaning": "jsonl, one message per line, or a markdown transcript",
+      "note": "the shared `store export` takes `jsonl` or `markdown`, max's own takes `jsonl` or `md` (e4)"
     },
     "--history": {
       "meaning": "the people added also see the messages from before they came"
     },
     "--idle": {
       "value": "<duration>",
-      "meaning": "stop after this long with nobody using it — 15m, 1h is 60m"
+      "meaning": "stop after this long with nobody using it — 15m, 1h"
     },
     "--json": {
       "meaning": "machine-readable output: one JSON value on stdout, nothing else"
@@ -131,8 +135,7 @@
     },
     "--kind": {
       "value": "<kind>",
-      "meaning": "only chats of this kind: dialog, group or channel",
-      "note": "max spells the value `<dialog|group|channel>`; the choices belong in the description"
+      "meaning": "only chats of this kind: dialog, group, channel or saved"
     },
     "--last": {
       "value": "<n>",
@@ -164,8 +167,8 @@
     },
     "--max-pages": {
       "value": "<n>",
-      "meaning": "at most this many pages of 100 messages in one run",
-      "default": "10"
+      "meaning": "at most this many pages in one run; a page is one request, and each messenger sets the default",
+      "note": "a page is 100 messages in tg and 30 in max — the same number fetches a different amount (e3)"
     },
     "--md": {
       "meaning": "read **bold**, _italic_, ~~struck~~ and `code` in the text; \\ keeps a mark literal"
@@ -224,7 +227,7 @@
     "--output": {
       "meaning": "where to write: a directory for `messages download`, a file for `store export`",
       "default": ".",
-      "note": "clash: `<dir>` in one command, `<file>` in another"
+      "note": "`<dir>` in `messages download`, `<file>` in `store export` (e10)"
     },
     "--page": {
       "value": "<n>",
@@ -240,8 +243,7 @@
     },
     "--photo": {
       "value": "<file>",
-      "meaning": "an image file — a profile photo in `account update`, a photo to send in `messages send`",
-      "note": "tg's `messages send --photo` takes `<path>`; rule 6 says `<file>`"
+      "meaning": "an image file — a profile photo in `account update`, a photo to send in `messages send`"
     },
     "--qr-file": {
       "value": "<png>",
@@ -280,8 +282,7 @@
     },
     "--send-id": {
       "value": "<id>",
-      "meaning": "reuse the id of an earlier send whose outcome is unknown; the messenger drops the duplicate",
-      "note": "max spells the value `<n>`"
+      "meaning": "reuse the id of an earlier send whose outcome is unknown; the messenger drops the duplicate"
     },
     "--serve": {
       "meaning": "start `serve` in the background if it is not running (the default)"
@@ -295,7 +296,7 @@
     "--since": {
       "value": "<id-or-time>",
       "meaning": "from this message id, an ISO 8601 time, or 2h / 1d ago; each command says its default",
-      "note": "the shared `chats events`, `store fetch`, `store export`, `inbox` and `review` take `<time>` only, never a message id: a Telegram id is a counter within one chat"
+      "note": "max takes a message id too; the shared `chats events`, `store fetch`, `store export`, `inbox` and `review` take a time only — a Telegram id is a counter within one chat (e6)"
     },
     "--stop": {
       "meaning": "stop this profile's server — the same as `server stop`"
@@ -319,8 +320,10 @@
       "meaning": "hear voice messages not heard yet, on this machine; slow, the model must be downloaded"
     },
     "--unanswered": {
-      "value": "[hours]",
-      "meaning": "only questions to you or a group's admins that nobody answered, asked at least this long ago; 24 hours if not given"
+      "value": "[duration]",
+      "meaning": "only questions to you or a group's admins that nobody answered, asked at least this long ago — 4h, 1d",
+      "note": "max's own `review` still takes bare hours until T6 moves it (e2)",
+      "default": "24h"
     },
     "--unread": {
       "meaning": "only chats with unread messages"
@@ -338,8 +341,7 @@
     },
     "--voice": {
       "value": "<file>",
-      "meaning": "send an Ogg Opus file as a voice message, alone, with no text",
-      "note": "max spells the value `<path>`; rule 6 says `<file>`"
+      "meaning": "send an Ogg Opus file as a voice message, alone, with no text"
     },
     "--yes": {
       "meaning": "go ahead without the question an ask level puts before a write"
@@ -423,16 +425,12 @@
     },
     "bot": {
       "state": "planned",
-      "by": "tg bot — not scheduled",
+      "by": "P8",
       "subtree": true
     },
     "cache": {
-      "state": "planned",
-      "by": "T6"
-    },
-    "cache clear": {
-      "state": "planned",
-      "by": "T6"
+      "state": "max-only",
+      "reason": "max's local cache, removed when the store replaces it (T6 group 6); tg never had one"
     },
     "chats": {
       "state": "both"
@@ -467,43 +465,26 @@
       }
     },
     "chats folders": {
-      "state": "planned",
-      "by": "P2"
+      "state": "both"
     },
     "chats folders create": {
-      "state": "planned",
-      "by": "P2",
+      "state": "both",
       "options": {
-        "--chat": {
-          "state": "planned",
-          "by": "P2"
-        }
+        "--chat": "both"
       }
     },
     "chats folders delete": {
-      "state": "planned",
-      "by": "P2"
+      "state": "both"
     },
     "chats folders list": {
-      "state": "planned",
-      "by": "P2"
+      "state": "both"
     },
     "chats folders update": {
-      "state": "planned",
-      "by": "P2",
+      "state": "both",
       "options": {
-        "--add": {
-          "state": "planned",
-          "by": "P2"
-        },
-        "--remove": {
-          "state": "planned",
-          "by": "P2"
-        },
-        "--title": {
-          "state": "planned",
-          "by": "P2"
-        }
+        "--add": "both",
+        "--remove": "both",
+        "--title": "both"
       }
     },
     "chats inspect": {
@@ -649,12 +630,12 @@
       "options": {
         "--bot": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         },
         "--defaults": "both",
         "--personal": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         }
       }
     },
@@ -663,7 +644,7 @@
       "options": {
         "--bot": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         }
       }
     },
@@ -672,12 +653,12 @@
       "options": {
         "--bot": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         },
         "--defaults": "both",
         "--personal": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         }
       }
     },