@leemour/cli-messaging 0.98.0 → 0.99.0

package/parity.json

@@ -20,6 +20,9 @@
     "--all": {
       "meaning": "every row, no paging"
     },
+    "--all-bots": {
+      "meaning": "also read every other bot's copy on this machine that readOtherBots allows"
+    },
     "--all-can-pin": {
       "value": "<on|off>",
       "meaning": "every member may pin messages"
@@ -80,9 +83,17 @@
       "value": "<time>",
       "meaning": "read what came before this ISO 8601 time, or 2h / 1d ago; not with --before-id"
     },
+    "--block": {
+      "value": "<value>",
+      "meaning": "Set to `true` if user should be blocked in chat."
+    },
     "--bot": {
       "meaning": "the bot section of the profile's settings, rather than the personal account's"
     },
+    "--bots": {
+      "value": "<profiles>",
+      "meaning": "also read these bots' copies, comma separated — each allowed by readOtherBots"
+    },
     "--can": {
       "value": "<rights>",
       "meaning": "what they may do, comma-separated: read, members, admins, info, pin, link, post, edit, delete",
@@ -97,12 +108,17 @@
       "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"
+      "meaning": "say whether a newer version exists, and install nothing",
+      "note": "`bot list --check` names the messenger until both CLIs take the release after 0.98.0, where it says \"the messenger\"; then this note goes"
     },
     "--confirm-send": {
       "meaning": "show the owner every write the MCP server offers, in a form to approve",
       "note": "max's own `mcp` is worded differently until the permission levels (P7) replace these flags there (e13)"
     },
+    "--context": {
+      "value": "<n>",
+      "meaning": "messages before and after each hit"
+    },
     "--defaults": {
       "meaning": "change what every profile gets, rather than this profile"
     },
@@ -147,9 +163,16 @@
       "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)"
     },
+    "--from": {
+      "value": "<value>",
+      "meaning": "Start time for requested messages - use after instead"
+    },
     "--history": {
       "meaning": "the people added also see the messages from before they came"
     },
+    "--html": {
+      "meaning": "the text is HTML: <b>, <i>, <a href>, <code>"
+    },
     "--idle": {
       "value": "<duration>",
       "meaning": "stop after this long with nobody using it — 15m, 1h"
@@ -192,6 +215,10 @@
     "--mark-read": {
       "meaning": "also mark the chat read up to the newest message shown; the other person sees it"
     },
+    "--marker": {
+      "value": "<value>",
+      "meaning": "Marker"
+    },
     "--max-actions": {
       "value": "<n>",
       "meaning": "at most this many actions in one run",
@@ -215,6 +242,12 @@
     "--new": {
       "meaning": "what arrived since the last check, each message once — for scheduled runs"
     },
+    "--newest": {
+      "meaning": "newest first instead of best first"
+    },
+    "--no-ban": {
+      "meaning": "remove without banning; by default a removed person cannot come back by the link"
+    },
     "--no-preview": {
       "meaning": "no preview card for a link in the text"
     },
@@ -224,6 +257,10 @@
     "--no-serve": {
       "meaning": "do not start it; log in on this command's own connection unless one is running"
     },
+    "--notification": {
+      "value": "<text>",
+      "meaning": "a note only the person who pressed sees"
+    },
     "--notify": {
       "meaning": "tell the chat's members about the pin"
     },
@@ -298,6 +335,9 @@
       "meaning": "keep this run under `runs` — ids and timings, never message content",
       "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13)"
     },
+    "--refresh": {
+      "meaning": "read the private chat with them from MAX first — one request"
+    },
     "--regex": {
       "meaning": "the words are one regular expression, case-insensitive, tested against every stored text"
     },
@@ -323,6 +363,9 @@
       "value": "<text>",
       "meaning": "only chats whose name contains this; at least 3 characters"
     },
+    "--secret-stdin": {
+      "meaning": "a secret MAX sends back in X-Max-Bot-Api-Secret — asked for, or read from a pipe"
+    },
     "--send-id": {
       "value": "<id>",
       "meaning": "reuse the id of an earlier send whose outcome is unknown; the messenger drops the duplicate"
@@ -349,6 +392,14 @@
       "value": "<n>",
       "meaning": "messages to answer per batch, 10–200; 50 by default"
     },
+    "--source": {
+      "value": "<messenger>",
+      "meaning": "every account of this messenger held in the store, or all of them — the same as in: in the query"
+    },
+    "--text": {
+      "value": "<text>",
+      "meaning": "the message's new text; - reads stdin"
+    },
     "--timeout": {
       "value": "<duration>",
       "meaning": "give up on the whole command after this — 30s, 2m, 500ms"
@@ -374,6 +425,10 @@
       "value": "<names>",
       "meaning": "only events of these types, comma-separated, as the messenger names them"
     },
+    "--types": {
+      "value": "<value>",
+      "meaning": "Comma separated list of update types your bot want to receive"
+    },
     "--unanswered": {
       "value": "[duration]",
       "meaning": "only questions to you or a group's admins that nobody answered, asked at least this long ago — 4h, 1d",
@@ -474,12 +529,530 @@
       }
     },
     "bot": {
+      "in": "all"
+    },
+    "bot api": {
+      "in": ["max"],
+      "reason": "MAX's own Bot API operations, generated from MAX's schema; a generated `bot api` for Telegram comes after P8"
+    },
+    "bot auth": {
+      "in": "all"
+    },
+    "bot auth remove": {
+      "in": "all"
+    },
+    "bot auth set": {
+      "in": "all"
+    },
+    "bot auth show": {
+      "in": "all"
+    },
+    "bot callbacks": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot callbacks answer": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--notification": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--text": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot chats": {
+      "in": "all"
+    },
+    "bot chats action": {
+      "in": "all"
+    },
+    "bot chats admins": {
+      "in": "all"
+    },
+    "bot chats admins add": {
+      "in": "all",
+      "options": {
+        "--can": "all",
+        "--title": "all"
+      }
+    },
+    "bot chats admins list": {
+      "in": "all"
+    },
+    "bot chats admins remove": {
+      "in": "all"
+    },
+    "bot chats check": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--allow-dangerous": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--dry-run": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--max-actions": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--no-ban": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--since": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot chats leave": {
+      "in": "all"
+    },
+    "bot chats list": {
+      "in": "all"
+    },
+    "bot chats members": {
+      "in": "all"
+    },
+    "bot chats members add": {
+      "in": ["max"],
+      "reason": "a Telegram bot cannot add people to a chat"
+    },
+    "bot chats members list": {
+      "in": ["max"],
+      "options": {
+        "--limit": {
+          "in": ["max"],
+          "reason": "Telegram's Bot API cannot list a chat's members, only its admins and a count"
+        },
+        "--marker": {
+          "in": ["max"],
+          "reason": "Telegram's Bot API cannot list a chat's members, only its admins and a count"
+        }
+      },
+      "reason": "Telegram's Bot API cannot list a chat's members, only its admins and a count"
+    },
+    "bot chats members remove": {
+      "in": "all",
+      "options": {
+        "--block": "all"
+      }
+    },
+    "bot chats rules": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot chats rules set": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot chats rules show": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot chats rules unset": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot chats show": {
+      "in": "all"
+    },
+    "bot commands": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot commands clear": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot commands list": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot commands set": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot comments": {
+      "in": ["max"],
+      "reason": "a Telegram channel's comments are messages in a separate discussion group, reached by ids only an update gives"
+    },
+    "bot list": {
+      "in": "all",
+      "options": {
+        "--check": "all"
+      }
+    },
+    "bot mcp": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--allow-delete": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--allow-moderate": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--allow-send": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--confirm-send": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot mcp config": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--allow-delete": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--allow-moderate": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--allow-send": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--confirm-send": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot me": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot messages": {
+      "in": "all"
+    },
+    "bot messages between": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--all-bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--limit": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot messages delete": {
+      "in": "all",
+      "options": {
+        "--allow-dangerous": "all"
+      }
+    },
+    "bot messages edit": {
+      "in": "all",
+      "options": {
+        "--html": "all",
+        "--md": "all"
+      }
+    },
+    "bot messages list": {
+      "in": "all",
+      "options": {
+        "--limit": "all"
+      }
+    },
+    "bot messages pin": {
+      "in": "all",
+      "options": {
+        "--notify": "all"
+      }
+    },
+    "bot messages search": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--all-bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--from": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--limit": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot messages send": {
+      "in": "all",
+      "options": {
+        "--allow-any-file": "all",
+        "--as-file": "all",
+        "--file": "all",
+        "--html": "all",
+        "--md": "all",
+        "--photo": "all",
+        "--reply-to": "all",
+        "--silent": "all",
+        "--voice": "all"
+      }
+    },
+    "bot messages show": {
+      "in": "all"
+    },
+    "bot messages unpin": {
+      "in": "all"
+    },
+    "bot people": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot people show": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--all-bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--limit": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--refresh": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot recipients": {
+      "in": "all"
+    },
+    "bot recipients add": {
+      "in": "all"
+    },
+    "bot recipients clear": {
+      "in": "all"
+    },
+    "bot recipients list": {
+      "in": "all"
+    },
+    "bot recipients remove": {
+      "in": "all"
+    },
+    "bot sends": {
+      "in": "all"
+    },
+    "bot sends list": {
+      "in": "all"
+    },
+    "bot updates": {
       "in": [],
       "planned": {
-        "max": "P8",
+        "max": "P8 B4: becomes bot watch",
+        "tg": "P8"
+      }
+    },
+    "bot updates watch": {
+      "in": [],
+      "planned": {
+        "max": "P8 B4: becomes bot watch",
         "tg": "P8"
       },
-      "subtree": true
+      "options": {
+        "--types": {
+          "in": [],
+          "planned": {
+            "max": "P8 B4: becomes bot watch",
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot uploads": {
+      "in": ["max"],
+      "reason": "Telegram has no upload-only step: a file goes up with the message that carries it"
+    },
+    "bot watch": {
+      "in": [],
+      "planned": {
+        "max": "P8 B4: max's bot watch comes with its move to the shared one",
+        "tg": "P8"
+      },
+      "options": {
+        "--events": {
+          "in": [],
+          "planned": {
+            "max": "P8 B4: max's bot watch comes with its move to the shared one",
+            "tg": "P8"
+          }
+        },
+        "--types": {
+          "in": [],
+          "planned": {
+            "max": "P8 B4: max's bot watch comes with its move to the shared one",
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot webhooks": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot webhooks delete": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot webhooks list": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot webhooks set": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--add": {
+          "in": ["max"],
+          "reason": "a Telegram bot holds one webhook address"
+        },
+        "--secret-stdin": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--types": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
     },
     "cache": {
       "in": ["max"],
@@ -1080,13 +1653,34 @@
       "in": "all",
       "options": {
         "--chat": "all",
+        "--context": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's cli-messaging bump with phase 2",
+            "tg": "each CLI's cli-messaging bump with phase 2"
+          }
+        },
         "--limit": "all",
+        "--newest": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's cli-messaging bump with phase 2",
+            "tg": "each CLI's cli-messaging bump with phase 2"
+          }
+        },
         "--regex": {
           "in": [],
           "planned": {
             "max": "T6",
             "tg": "T6"
           }
+        },
+        "--source": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's cli-messaging bump with phase 2",
+            "tg": "each CLI's cli-messaging bump with phase 2"
+          }
         }
       }
     },
@@ -1134,6 +1728,14 @@
     "models audio list": {
       "in": "all"
     },
+    "models text": {
+      "in": [],
+      "planned": {
+        "max": "storage phase 5: the cli-messaging bump after it ships",
+        "tg": "storage phase 5: the cli-messaging bump after it ships"
+      },
+      "subtree": true
+    },
     "polls": {
       "in": "all"
     },