@leemour/cli-messaging 0.148.2 → 0.149.0

package/parity.json

@@ -59,6 +59,9 @@
     "--allow-writes": {
       "meaning": "acknowledge that the profile offers writing tools when installing local MCP"
     },
+    "--analyze": {
+      "meaning": "link conversation batches using the configured analysis provider, with remembered chat/provider consent"
+    },
     "--anonymous": {
       "meaning": "nobody sees who voted for what"
     },
@@ -74,6 +77,10 @@
       "value": "<time>",
       "meaning": "let the messenger send it later, even with this machine off: a local time like 2026-09-25T09:00, or 30m"
     },
+    "--attachment": {
+      "value": "<n>",
+      "meaning": "which file of the message, from 1; needed when it has more than one"
+    },
     "--background": {
       "meaning": "run as a job that outlives this command; `store jobs show` follows it"
     },
@@ -157,6 +164,9 @@
       "value": "<n>",
       "meaning": "remote: the vector size — needed with --base-url; shortens an OpenAI model's"
     },
+    "--download": {
+      "meaning": "first save, from the messenger, the files no download saved yet"
+    },
     "--dry-run": {
       "meaning": "judge and plan; do nothing"
     },
@@ -175,6 +185,10 @@
       "value": "<file>",
       "meaning": "attach a file; images go as a photo, videos as a video. Repeat it for more"
     },
+    "--filter": {
+      "value": "query",
+      "meaning": "Strict Lucene filter: any message in the conversation must match; the meaning query stays unchanged"
+    },
     "--first-name": {
       "value": "<name>",
       "meaning": "your first name"
@@ -264,16 +278,21 @@
     "--max-chats": {
       "value": "<n>",
       "meaning": "at most this many chats in one run",
-      "default": "20"
+      "default": "20",
+      "note": "local graph work defaults to 20; opt-in --sync-first network refresh defaults to 5, so help distinguishes the two uses"
     },
     "--max-chunks": {
       "value": "<n>",
       "meaning": "at most this many chunks embedded in one run",
       "default": "2000"
     },
+    "--max-messages": {
+      "value": "<n>",
+      "meaning": "fetch at most this many messages total (default: 500)"
+    },
     "--max-tokens": {
       "value": "<n>",
-      "meaning": "remote: stop before a run that could send more tokens than this"
+      "meaning": "remote embeddings: bound input tokens; analysis: reserve input and output tokens across this run"
     },
     "--md": {
       "meaning": "read this messenger's Markdown; see its formatting guide for supported syntax"
@@ -299,6 +318,9 @@
     "--multiple": {
       "meaning": "people may pick several answers"
     },
+    "--needs-text": {
+      "meaning": "only files saved here whose text nobody has yet: what an agent reads and writes back"
+    },
     "--new": {
       "meaning": "what arrived since the last check, each message once — for scheduled runs"
     },
@@ -362,7 +384,8 @@
     "--output-dir": {
       "value": "<dir>",
       "meaning": "the folder to write into, created if missing",
-      "default": "."
+      "default": ".",
+      "note": "`attachments extract` takes it only with --download, and has no default there, so extraction never fills the working folder unasked"
     },
     "--page": {
       "value": "<n>",
@@ -392,7 +415,7 @@
     },
     "--provider": {
       "value": "<provider>",
-      "meaning": "embed through a service with your key instead of on this machine: openai"
+      "meaning": "embedding provider: local or openai; analysis: agent, openai or anthropic; consents revoke: exact provider identity from the list"
     },
     "--public-url": {
       "value": "<url>",
@@ -486,6 +509,13 @@
       "value": "<profile>",
       "meaning": "keep a returned authentication token only in this bot profile's OS keyring; never print it"
     },
+    "--sync-first": {
+      "meaning": "first fetch new messages within the chat, time and message bounds"
+    },
+    "--sync-time": {
+      "value": "<duration>",
+      "meaning": "stop fetching after this long (default: 30s)"
+    },
     "--tag": {
       "value": "<tag>",
       "meaning": "only this tag"
@@ -494,6 +524,29 @@
       "value": "<text>",
       "meaning": "the message's new text; - reads stdin"
     },
+    "--text-file": {
+      "value": "<path>",
+      "meaning": "read the text from this file; - or none reads stdin"
+    },
+    "--thread": {
+      "meaning": "the stored reply chain and replies instead of time neighbours; falls back when no graph exists"
+    },
+    "--thread-bytes": {
+      "value": "<n>",
+      "meaning": "at most this many bytes of whole messages and links in each context (default: 65536)"
+    },
+    "--thread-hops": {
+      "value": "<n>",
+      "meaning": "at most this many links from the hit (default: 8)"
+    },
+    "--thread-messages": {
+      "value": "<n>",
+      "meaning": "at most this many messages in each thread context (default: 50)"
+    },
+    "--thread-within": {
+      "value": "<duration>",
+      "meaning": "messages within this long either side of the hit (default: 1d)"
+    },
     "--threads": {
       "value": "<n>",
       "meaning": "threads in all",
@@ -519,7 +572,7 @@
     },
     "--topic": {
       "value": "<id>",
-      "meaning": "send to this forum topic",
+      "meaning": "address this forum topic: send to it, or mark only it read",
       "note": "Telegram group forums only; MAX explicitly refuses this option before sending"
     },
     "--trace": {
@@ -639,6 +692,76 @@
         "--photo": "all"
       }
     },
+    "attachments": {
+      "in": [],
+      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+    },
+    "attachments extract": {
+      "in": [],
+      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" },
+      "options": {
+        "--chat": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--download": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--limit": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--output-dir": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        }
+      }
+    },
+    "attachments list": {
+      "in": [],
+      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" },
+      "options": {
+        "--all": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--chat": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--limit": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--needs-text": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--page": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        }
+      }
+    },
+    "attachments text": {
+      "in": [],
+      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+    },
+    "attachments text set": {
+      "in": [],
+      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" },
+      "options": {
+        "--attachment": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--text-file": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        }
+      }
+    },
     "bot": {
       "in": "all"
     },
@@ -1037,6 +1160,10 @@
     "chats mark-read": {
       "in": "all",
       "options": {
+        "--topic": {
+          "in": [],
+          "planned": { "max": "G2 feat/topic-mark-read", "tg": "G2 feat/topic-mark-read" }
+        },
         "--until": "all"
       }
     },
@@ -1253,25 +1380,17 @@
       "in": "all"
     },
     "contacts context": {
-      "in": [],
-      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" },
+      "in": "all",
       "options": {
-        "--limit": {
-          "in": [],
-          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
-        },
-        "--since-time": {
-          "in": [],
-          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
-        }
+        "--limit": "all",
+        "--since-time": "all"
       }
     },
     "contacts import": {
       "in": "all"
     },
     "contacts link": {
-      "in": [],
-      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+      "in": "all"
     },
     "contacts list": {
       "in": "all",
@@ -1302,8 +1421,7 @@
       "in": "all"
     },
     "contacts unlink": {
-      "in": [],
-      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+      "in": "all"
     },
     "conversations": {
       "in": "all"
@@ -1328,6 +1446,20 @@
     "conversations build": {
       "in": "all",
       "options": {
+        "--analyze": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--base-url": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
         "--chat": "all",
         "--max-chats": {
           "in": [],
@@ -1335,6 +1467,71 @@
             "max": "each CLI's next cli-messaging bump",
             "tg": "each CLI's next cli-messaging bump"
           }
+        },
+        "--max-tokens": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--model": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--provider": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--size": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        }
+      }
+    },
+    "conversations consents": {
+      "in": [],
+      "planned": {
+        "max": "each CLI's next cli-messaging bump",
+        "tg": "each CLI's next cli-messaging bump"
+      }
+    },
+    "conversations consents list": {
+      "in": [],
+      "planned": {
+        "max": "each CLI's next cli-messaging bump",
+        "tg": "each CLI's next cli-messaging bump"
+      }
+    },
+    "conversations consents revoke": {
+      "in": [],
+      "planned": {
+        "max": "each CLI's next cli-messaging bump",
+        "tg": "each CLI's next cli-messaging bump"
+      },
+      "options": {
+        "--chat": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--provider": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
         }
       }
     },
@@ -1484,6 +1681,13 @@
         "--base-url": "all",
         "--chat": "all",
         "--dims": "all",
+        "--filter": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
         "--limit": "all",
         "--max-chats": {
           "in": [],
@@ -1499,6 +1703,10 @@
             "tg": "each CLI's next cli-messaging bump"
           }
         },
+        "--max-messages": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
         "--model": "all",
         "--provider": "all",
         "--refresh": {
@@ -1508,7 +1716,29 @@
             "tg": "each CLI's next cli-messaging bump"
           }
         },
-        "--since-time": "all"
+        "--since-time": "all",
+        "--source": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--sync-first": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--sync-time": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--timezone": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        }
       }
     },
     "conversations show": {
@@ -1795,7 +2025,42 @@
       "in": "all",
       "options": {
         "--after-n": "all",
-        "--before-n": "all"
+        "--before-n": "all",
+        "--thread": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--thread-bytes": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--thread-hops": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--thread-messages": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--thread-within": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        }
       }
     },
     "messages delete": {
@@ -1879,6 +2144,14 @@
         "--context": "all",
         "--language": "all",
         "--limit": "all",
+        "--max-chats": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--max-messages": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
         "--newest": "all",
         "--regex": "all",
         "--saved": {
@@ -1886,6 +2159,49 @@
           "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
         },
         "--source": "all",
+        "--sync-first": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--sync-time": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--thread": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--thread-bytes": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--thread-hops": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--thread-messages": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
+        "--thread-within": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's next cli-messaging bump",
+            "tg": "each CLI's next cli-messaging bump"
+          }
+        },
         "--timezone": "all"
       }
     },
@@ -1925,6 +2241,14 @@
           "in": [],
           "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
         },
+        "--max-chats": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--max-messages": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
         "--saved": {
           "in": [],
           "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
@@ -1933,6 +2257,14 @@
           "in": [],
           "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
         },
+        "--sync-first": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
+        "--sync-time": {
+          "in": [],
+          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+        },
         "--timezone": {
           "in": [],
           "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
@@ -2036,28 +2368,28 @@
       "in": "all"
     },
     "replies": {
-      "in": [],
-      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+      "in": ["tg"],
+      "planned": { "max": "max's own serve does not run the reply rules yet" }
     },
     "replies pause": {
-      "in": [],
-      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+      "in": ["tg"],
+      "planned": { "max": "max's own serve does not run the reply rules yet" }
     },
     "replies resume": {
-      "in": [],
-      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+      "in": ["tg"],
+      "planned": { "max": "max's own serve does not run the reply rules yet" }
     },
     "replies status": {
-      "in": [],
-      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+      "in": ["tg"],
+      "planned": { "max": "max's own serve does not run the reply rules yet" }
     },
     "replies test": {
-      "in": [],
-      "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" },
+      "in": ["tg"],
+      "planned": { "max": "max's own serve does not run the reply rules yet" },
       "options": {
         "--since-time": {
-          "in": [],
-          "planned": { "max": "each CLI's next cli-messaging bump", "tg": "each CLI's next cli-messaging bump" }
+          "in": ["tg"],
+          "planned": { "max": "max's own serve does not run the reply rules yet" }
         }
       }
     },
@@ -2351,8 +2683,7 @@
       "planned": { "max": "max's next cli-messaging bump", "tg": "tg's next cli-messaging bump" }
     },
     "store copies delete": {
-      "in": [],
-      "planned": { "max": "max's next cli-messaging bump", "tg": "tg's next cli-messaging bump" }
+      "in": "all"
     },
     "store decrypt": {
       "in": "all",
@@ -2409,13 +2740,9 @@
       }
     },
     "store repair": {
-      "in": [],
-      "planned": { "max": "max's next cli-messaging bump", "tg": "tg's next cli-messaging bump" },
+      "in": "all",
       "options": {
-        "--dry-run": {
-          "in": [],
-          "planned": { "max": "max's next cli-messaging bump", "tg": "tg's next cli-messaging bump" }
-        }
+        "--dry-run": "all"
       }
     },
     "store restore": {

package/skills/link-conversations/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 A busy group mixes several conversations at once. `{{command}}` already links what it can without
 you: the messenger's own replies, mentions, and one person's messages in a row. You decide the rest:
 for each message, **which earlier message it answers**, or that it starts a new conversation. You
-read the messages; `{{command}}` checks and stores your answers. It never calls a model itself.
+read the messages; `{{command}}` checks and stores your answers. By default it leaves analysis to your agent. An explicit configured analysis provider can also process these batches through `conversations build --analyze`; that path asks for consent and validates the same answers.
 
 ## Before the first batch: say what it costs, and wait
 
@@ -75,3 +75,23 @@ was added or deleted inside it: ask for the next batch instead.
   touched.
 - See your answers in place: `{{command}} conversations show "<chat>" <message>` prints a
   conversation, and `{{command}} messages links "<chat>" <message>` says why a message sits where it does.
+
+
+## Through MCP
+
+Follow the same cost gate and loop using these tools instead of shell commands:
+
+| CLI operation | MCP tool |
+|---|---|
+| conversations build | {{command}}_conversations_build |
+| conversations batches status | {{command}}_conversations_batches_status |
+| conversations batches next | {{command}}_conversations_batches_next |
+| conversations links add | {{command}}_conversations_links_add |
+| conversations links clear | {{command}}_conversations_links_clear |
+| conversations show | {{command}}_conversations_show |
+
+Use `chat` for the chat reference, and `size` for the batch size (10–200, default 50).
+Send `batch`, `model`, `skill` and `answers` as the links-add tool's arguments.
+Next returns `{ "batch": null }` when finished. Build before status and once more after the last
+answer. The write tools need `permissions.conversations.links` set to `allow`; on `ask` they
+refuse and explain the setting. A read-only profile offers only status and next.