@craftsamo/telegram-tools 0.1.0 → 0.3.0

package/dist/opencode.js

@@ -25,6 +25,21 @@ var PROJECT = {
   toolsets: ["account", "chats", "sync", "files", "sends", "actions"],
   /** The toolsets on when a setting names none. */
   defaultToolsets: ["account", "chats", "sync", "sends"],
+  /** The package's own settings, which the tools themselves read: each snake_case name and its type, with bounds when it needs them. */
+  options: {
+    /** Where every account's state lives. */
+    state_dir: "path",
+    /** Where received files are saved. */
+    download_dir: "path",
+    /** The largest received file a call may download, in megabytes. */
+    download_max_mb: { type: "number", integer: true, min: 1, max: 2e3 },
+    /** The directories files may be sent from, besides the working directory. */
+    send_dirs: "paths",
+    /** Whether messages that disappear are kept; read by the sync service's commands. */
+    keep_disappearing: "boolean",
+    /** Whether channels are listed and their messages received; read by the sync service's commands. */
+    channels: "boolean"
+  },
   /** The environment variables the tools read besides the settings, which Codex forwards to the server after them. */
   toolVariables: []
 };
@@ -5099,7 +5114,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve8) {
+function isRecursive(inst, stack, resolve6) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -5109,7 +5124,7 @@ function isRecursive(inst, stack, resolve8) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve8);
+      const answer = isRecursive(child, stack, resolve6);
       if (answer > result)
         result = answer;
     }
@@ -5120,7 +5135,7 @@ function isRecursive(inst, stack, resolve8) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve8) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve6) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -5184,7 +5199,7 @@ function isRecursive(inst, stack, resolve8) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve8 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve6 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -9382,8 +9397,8 @@ function ko_default() {
 }
 
 // node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/locales/lt.js
-var capitalizeFirstCharacter = (text) => {
-  return text.charAt(0).toUpperCase() + text.slice(1);
+var capitalizeFirstCharacter = (text2) => {
+  return text2.charAt(0).toUpperCase() + text2.slice(1);
 };
 function getUnitTypeFromNumber(number4) {
   const abs = Math.abs(number4);
@@ -19788,8 +19803,8 @@ function quoteBadLabel(value) {
   const truncated = value.length > MAX_BAD_LABEL_PREVIEW ? `${value.slice(0, MAX_BAD_LABEL_PREVIEW)}\u2026` : value;
   return JSON.stringify(truncated);
 }
-function isLabel(text) {
-  return typeof text === "string" && LABEL_PATTERN.test(text);
+function isLabel(text2) {
+  return typeof text2 === "string" && LABEL_PATTERN.test(text2);
 }
 function checkLabel(label) {
   if (!isLabel(label)) {
@@ -20008,6 +20023,7 @@ function lockHolder(path) {
 }
 
 // src/core/time.ts
+var MS_PER_S = 1e3;
 var MS_PER_MINUTE = 6e4;
 var MINUTES_PER_HOUR = 60;
 var localOffsetMinutes = (ms) => -new Date(ms).getTimezoneOffset();
@@ -20027,10 +20043,10 @@ var MILLISECOND_DIGITS = 3;
 var MIN_YEAR = 1e3;
 var MAX_HOUR = 23;
 var MAX_MINUTE = 59;
-function badTime(text, name) {
+function badTime(text2, name) {
   return new ToolError(
     "invalid_argument",
-    `${name} is not a time: ${JSON.stringify(text)}. Use RFC 3339 with an offset (2026-11-07T14:03:12+09:00), or a date or time without one (2026-11-07, 2026-11-07T14:03), which reads as local time.`
+    `${name} is not a time: ${JSON.stringify(text2)}. Use RFC 3339 with an offset (2026-11-07T14:03:12+09:00), or a date or time without one (2026-11-07, 2026-11-07T14:03), which reads as local time.`
   );
 }
 function isCalendarDay(year, month, day) {
@@ -20038,21 +20054,21 @@ function isCalendarDay(year, month, day) {
   date5.setUTCFullYear(year, month - 1, day);
   return date5.getUTCFullYear() === year && date5.getUTCMonth() === month - 1 && date5.getUTCDate() === day;
 }
-function parseTimeArgument(text, name) {
-  const match = TIME_PATTERN.exec(text.trim());
-  if (!match) throw badTime(text, name);
+function parseTimeArgument(text2, name) {
+  const match = TIME_PATTERN.exec(text2.trim());
+  if (!match) throw badTime(text2, name);
   const [, year, month, day, hour = "0", minute = "0", second = "0", fraction = "", zulu, sign, offsetHour, offsetMin] = match;
   const [y, mon, d, h, mi, s] = [year, month, day, hour, minute, second].map(Number);
   const ms = Number(fraction.padEnd(MILLISECOND_DIGITS, "0").slice(0, MILLISECOND_DIGITS));
   if (y < MIN_YEAR || !isCalendarDay(y, mon, d) || h > MAX_HOUR || mi > MAX_MINUTE || s > MAX_MINUTE) {
-    throw badTime(text, name);
+    throw badTime(text2, name);
   }
   if (sign === void 0 && zulu === void 0) return new Date(y, mon - 1, d, h, mi, s, ms).getTime();
   const wall = Date.UTC(y, mon - 1, d, h, mi, s, ms);
   if (zulu) return wall;
   const offsetH = Number(offsetHour);
   const offsetM = Number(offsetMin);
-  if (offsetH > MAX_HOUR || offsetM > MAX_MINUTE) throw badTime(text, name);
+  if (offsetH > MAX_HOUR || offsetM > MAX_MINUTE) throw badTime(text2, name);
   const offset = (offsetH * MINUTES_PER_HOUR + offsetM) * MS_PER_MINUTE;
   return sign === "-" ? wall + offset : wall - offset;
 }
@@ -20387,23 +20403,23 @@ function encodeCursor(value) {
 function notACursor(name) {
   return new ToolError("invalid_argument", `${name} is not a cursor this tool returned.`);
 }
-function decodeCursor(text, name) {
-  const bytes = Buffer3.from(text, "base64url");
-  if (bytes.toString("base64url") !== text) throw notACursor(name);
+function decodeCursor(text2, name) {
+  const bytes = Buffer3.from(text2, "base64url");
+  if (bytes.toString("base64url") !== text2) throw notACursor(name);
   try {
     return JSON.parse(bytes.toString("utf8"));
   } catch {
     throw notACursor(name);
   }
 }
-function readCursor(text, name, schema) {
-  const parsed = schema.safeParse(decodeCursor(text, name));
+function readCursor(text2, name, schema) {
+  const parsed = schema.safeParse(decodeCursor(text2, name));
   if (!parsed.success) throw notACursor(name);
   return parsed.data;
 }
 var HIGH_SURROGATE = /[\uD800-\uDBFF]$/;
-function cutText(text, keep) {
-  return text.length <= keep ? text : text.slice(0, keep).replace(HIGH_SURROGATE, "");
+function cutText(text2, keep) {
+  return text2.length <= keep ? text2 : text2.slice(0, keep).replace(HIGH_SURROGATE, "");
 }
 function jsonLength(value) {
   return JSON.stringify(value).length;
@@ -20493,15 +20509,15 @@ var ERROR_CODES = {
 function isErrorCode(value) {
   return typeof value === "string" && Object.hasOwn(ERROR_CODES, value);
 }
-function maskPhoneNumbers(text) {
-  return text.replace(PHONE_NUMBER, "[number]");
+function maskPhoneNumbers(text2) {
+  return text2.replace(PHONE_NUMBER, "[number]");
 }
 function cut(message) {
   return maskPhoneNumbers(message).trim().slice(0, MAX_DETAIL_LENGTH);
 }
 function detail(message) {
-  const text = cut(message);
-  return text ? `: ${text}` : "";
+  const text2 = cut(message);
+  return text2 ? `: ${text2}` : "";
 }
 function afterWriteError(method, effect, reason) {
   return effect === "write" ? new ToolError("uncertain", `${method} may have taken effect (${reason}). ${UNCERTAIN_ADVICE}`) : new ToolError("upstream_error", `${method} failed (${reason}).`);
@@ -20622,7 +20638,7 @@ function abortError(signal) {
 }
 function exec(argv, options) {
   const { signal } = options;
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve6, reject) => {
     if (signal?.aborted) {
       reject(abortError(signal));
       return;
@@ -20681,7 +20697,7 @@ function exec(argv, options) {
     }
     const finish = () => settle2(() => {
       const { code, killedBy } = exitedWith ?? { code: null, killedBy: null };
-      resolve8({
+      resolve6({
         code: code ?? -1,
         stdout,
         stderr,
@@ -20775,19 +20791,19 @@ var ServiceConnection = class _ServiceConnection {
     socket.on("error", (error62) => {
       this.endReason ??= `the connection to the service broke${error62.code ? ` (${error62.code})` : ""}`;
     });
-    this.closed = new Promise((resolve8) => {
+    this.closed = new Promise((resolve6) => {
       socket.once("close", () => {
         this.endReason ??= "the service closed the connection";
         const lost = { lost: this.endReason };
         for (const settle2 of [...this.pending.values()]) settle2(lost);
-        resolve8();
+        resolve6();
       });
     });
   }
   /** Connects to the service's socket; rejects as `upstream_error` when nothing is listening there. */
   static connect(socketPath, options = {}) {
     const { timeoutMs = DEFAULT_CONNECT_TIMEOUT_MS, signal, maxLineLength = DEFAULT_MAX_LINE_LENGTH } = options;
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve6, reject) => {
       if (signal?.aborted) {
         reject(abortError(signal));
         return;
@@ -20809,7 +20825,7 @@ var ServiceConnection = class _ServiceConnection {
       };
       const onConnect = () => {
         detach();
-        resolve8(new _ServiceConnection(socket, maxLineLength));
+        resolve6(new _ServiceConnection(socket, maxLineLength));
       };
       const onFailure = () => stop(new ToolError("upstream_error", NOT_RUNNING_MESSAGE));
       const onAbort = () => stop(abortError(signal));
@@ -20832,7 +20848,7 @@ var ServiceConnection = class _ServiceConnection {
    */
   call(method, params, options) {
     const { effect, timeoutMs = DEFAULT_CALL_TIMEOUT_MS, signal } = options;
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve6, reject) => {
       if (signal?.aborted) {
         reject(abortError(signal));
         return;
@@ -20861,7 +20877,7 @@ var ServiceConnection = class _ServiceConnection {
         clearTimeout(timer);
         signal?.removeEventListener("abort", onAbort);
         try {
-          resolve8(produce());
+          resolve6(produce());
         } catch (error62) {
           reject(error62);
         }
@@ -20934,7 +20950,6 @@ async function callService(socketPath, method, params, options) {
 // src/core/chat/live.ts
 var REFRESH_TIMEOUT_MS = 12e4;
 var FETCH_TIMEOUT_MS = 18e4;
-var MS_PER_S = 1e3;
 function requestHistory(socket, params, signal) {
   return callService(socket, SERVICE_REQUESTS.history, params, { effect: "read", signal });
 }
@@ -21062,113 +21077,6 @@ var messageEntry = external_exports.object({
   private_note: external_exports.string().optional()
 });
 
-// src/core/chat/schema.ts
-var METHODS = ["list", "view", "topics", "search", "around", "fetch"];
-var GENERAL_TOPIC2 = 1;
-var LIMITS = {
-  list: { default: 30, max: 200 },
-  view: { default: 50, max: 300 },
-  topics: { default: 30, max: TOPICS_LIMIT },
-  search: { default: 30, max: 200 }
-};
-var AROUND_COUNT = { default: 5, max: AROUND_LIMIT };
-var FETCH_PAGES = { default: 1, max: FETCH_PAGE_LIMIT };
-var accountArgument = external_exports.string().optional().describe("The account label; may be left out when only one account is logged in.");
-var input3 = external_exports.object({
-  method: external_exports.enum(METHODS).describe(
-    "`list` finds chats; `view` reads the newest messages of one chat between two times, oldest first; `topics` lists the topics of a forum chat; `search` finds messages in the mirror by words; `around` reads the messages around one; `fetch` adds older history of a mirrored chat to the mirror."
-  ),
-  account: accountArgument,
-  query: external_exports.string().optional().describe(
-    "list: only chats whose name or username holds this text; a leading @ is ignored. search (required): the words to look for, all of which a message must hold in its text, caption or file name, in any order. Both ignore case and letter width."
-  ),
-  unread: external_exports.boolean().optional().describe("list: only chats with unread messages."),
-  last: external_exports.boolean().optional().describe("list: add each chat's newest mirrored message as `last_message`."),
-  refresh: external_exports.boolean().optional().describe(
-    "list: first take the chat list from Telegram (needs the sync service), then read it, and report when in `refreshed_at`."
-  ),
-  chat: external_exports.string().optional().describe(
-    "view, topics, around, fetch (required) and search (optional, to search one chat): the chat id, from `list`, such as 123456789 or -1001234567890. A name, username or phone number is not a chat."
-  ),
-  topic: external_exports.number().int().positive().optional().describe(
-    `view, around: only messages of this topic of a forum chat (ids from \`topics\`); the General topic is ${GENERAL_TOPIC2}. Refused for a chat without topics.`
-  ),
-  after: external_exports.string().optional().describe(
-    "view, search: only messages after this time (exclusive): RFC 3339 with an offset, or a date or time without one, read as local time, such as 2026-11-07 or 2026-11-07T14:03."
-  ),
-  before: external_exports.string().optional().describe("view, search: only messages before this time (exclusive); the same forms as `after`."),
-  limit: external_exports.number().int().optional().describe(
-    `How many to return. list: default ${LIMITS.list.default}, at most ${LIMITS.list.max}. view: default ${LIMITS.view.default}, at most ${LIMITS.view.max} (${HISTORY_LIMIT} for a chat read live). topics: default ${LIMITS.topics.default}, at most ${LIMITS.topics.max}. search: default ${LIMITS.search.default}, at most ${LIMITS.search.max}. A larger value is lowered to the most; a result may hold fewer to stay a size a model can read.`
-  ),
-  cursor: external_exports.string().optional().describe("The `next` of the previous result, to continue where it stopped."),
-  id: external_exports.number().int().positive().optional().describe("around (required): the id of the message to read around."),
-  before_count: external_exports.number().int().optional().describe(
-    `around: how many older messages to return, default ${AROUND_COUNT.default}, at most ${AROUND_COUNT.max}; 0 asks for none.`
-  ),
-  after_count: external_exports.number().int().optional().describe(
-    `around: how many newer messages to return, default ${AROUND_COUNT.default}, at most ${AROUND_COUNT.max}; 0 asks for none.`
-  ),
-  pages: external_exports.number().int().optional().describe(
-    `fetch: how many pages of ${FETCH_PAGE_SIZE} older messages to add, default ${FETCH_PAGES.default}, at most ${FETCH_PAGES.max}.`
-  )
-});
-var nameCut = external_exports.literal(true).optional().describe("Set when the name was longer than the most a result carries and was cut.");
-var chatEntry2 = external_exports.object({
-  id: external_exports.string().describe("The chat id: Telegram's signed id as text, such as `123456789` or `-1001234567890`."),
-  kind: external_exports.enum(CHAT_KINDS).describe("`self` is Saved Messages."),
-  name: external_exports.string().nullable().describe("The person's or chat's name; null when none is known."),
-  name_cut: nameCut,
-  username: external_exports.string().optional(),
-  mirrored: external_exports.boolean().describe("Whether the mirror keeps this chat's messages."),
-  unread: external_exports.number().int().describe("Incoming messages not read yet."),
-  last_activity_at: localTimeSchema.nullable().describe("The latest message's time, in local time with offset; null when none is known."),
-  forum: external_exports.literal(true).optional().describe("Set for a supergroup with topics."),
-  archived: external_exports.literal(true).optional(),
-  left: external_exports.literal(true).optional().describe("Set for a group or channel the user has left or been removed from."),
-  can_send: external_exports.literal(false).optional().describe("Set when the user is known not to be able to write here."),
-  auto_delete_seconds: external_exports.number().int().optional().describe("The chat's auto-delete period, when on."),
-  last_message: messageEntry.nullable().optional().describe("With `last`: the newest mirrored message of the chat, or null when none is mirrored.")
-});
-var topicEntry = external_exports.object({
-  id: external_exports.number().int().describe(`The topic id, to pass as \`topic\` to \`view\`; ${GENERAL_TOPIC2} is the General topic.`),
-  title: external_exports.string().nullable().describe("The topic's title; null when none is known."),
-  closed: external_exports.literal(true).optional().describe("Set for a topic that is closed."),
-  pinned: external_exports.literal(true).optional().describe("Set for a topic that is pinned."),
-  unread: external_exports.number().int().describe("Messages in it not read yet."),
-  last_activity_at: localTimeSchema.nullable().describe("The newest message's time, in local time with offset; null when none is known.")
-});
-var output3 = external_exports.object({
-  chats: external_exports.array(chatEntry2).optional().describe("list: the chats, newest activity first."),
-  refreshed_at: localTimeSchema.optional().describe("list with `refresh`: when the chat list was taken from Telegram, in local time with offset."),
-  chat: chatEntry2.optional().describe("view, topics, around, fetch: the chat read."),
-  messages: external_exports.array(messageEntry).optional().describe("view, around: the messages, oldest first. search: the hits, newest first."),
-  live: external_exports.literal(true).optional().describe(
-    "view, around: set when the chat is not mirrored, so the messages were read from Telegram and stored nowhere."
-  ),
-  topics: external_exports.array(topicEntry).optional().describe("topics: the topics, most recently active first."),
-  anchor: external_exports.number().int().optional().describe("around: the id of the message read around, among `messages`."),
-  trimmed_before: external_exports.number().int().optional().describe(
-    "around: how many older messages were left out, farthest first, to keep the result a size that can be read."
-  ),
-  trimmed_after: external_exports.number().int().optional().describe(
-    "around: how many newer messages were left out, farthest first, to keep the result a size that can be read."
-  ),
-  scanned_to: localTimeSchema.optional().describe(
-    "search: set when the search stopped before the end of the history it covers: the time of the oldest message looked at, in local time with offset. `next` continues from there."
-  ),
-  scope: external_exports.string().optional().describe("search: what the search covers and what it does not."),
-  fetched: external_exports.object({
-    added: external_exports.number().int().describe("How many messages the mirror gained."),
-    pages: external_exports.number().int().describe("How many pages were read."),
-    complete: external_exports.boolean().describe("Whether Telegram has nothing older for this chat."),
-    oldest_at: localTimeSchema.nullable().describe(
-      "The time of the oldest message the mirror now holds of this chat, in local time with offset; null when none."
-    )
-  }).optional().describe("fetch: what the history fetch stored."),
-  next: external_exports.string().optional().describe("Pass back as `cursor` to continue; absent when there is no more."),
-  note: external_exports.string().describe("Says that what the result carries is data written by other people.")
-});
-
 // src/core/chat/message-rows.ts
 var MESSAGE_COLUMNS = "chat, id, topic, ts, from_me, sender, sender_name, kind, body, entities, media, action, reply, forward, grouped, reactions, edited, expires, view_once, self_destruct";
 function liveMessages(now) {
@@ -21176,7 +21084,7 @@ function liveMessages(now) {
 }
 function inTopic(topic) {
   return {
-    condition: topic === GENERAL_TOPIC2 ? "(topic IS NULL OR topic = ?)" : "topic = ?",
+    condition: topic === GENERAL_TOPIC ? "(topic IS NULL OR topic = ?)" : "topic = ?",
     params: [topic]
   };
 }
@@ -21289,10 +21197,10 @@ function replyTo(parsed, related) {
   if (reply.chat !== void 0) entry2.chat = reply.chat;
   if (reply.topic !== void 0) entry2.topic = reply.topic;
   if (reply.quote !== void 0) entry2.quote = reply.quote;
-  const text = repliedText(parsed, related)?.text;
-  if (text !== void 0) {
-    entry2.text = cutText(text, REPLY_TEXT_LENGTH);
-    if (entry2.text.length < text.length) entry2.text_cut = true;
+  const text2 = repliedText(parsed, related)?.text;
+  if (text2 !== void 0) {
+    entry2.text = cutText(text2, REPLY_TEXT_LENGTH);
+    if (entry2.text.length < text2.length) entry2.text_cut = true;
   }
   return entry2;
 }
@@ -21361,25 +21269,25 @@ function texts(entry2) {
   ];
 }
 function messageTextLength(entry2) {
-  return texts(entry2).reduce((total, text) => total + text.length, 0);
+  return texts(entry2).reduce((total, text2) => total + text2.length, 0);
 }
 function cutMessage(entry2, keep) {
   let room = keep;
   let cut3 = false;
-  const take = (text) => {
-    const kept = cutText(text, room);
-    room = Math.max(0, room - text.length);
-    if (kept.length < text.length) cut3 = true;
+  const take = (text2) => {
+    const kept = cutText(text2, room);
+    room = Math.max(0, room - text2.length);
+    if (kept.length < text2.length) cut3 = true;
     return kept;
   };
   const cutEntry = { ...entry2 };
   if (entry2.text !== void 0) cutEntry.text = take(entry2.text);
   if (entry2.reply_to) {
-    const { quote, text } = entry2.reply_to;
+    const { quote, text: text2 } = entry2.reply_to;
     cutEntry.reply_to = {
       ...entry2.reply_to,
       ...quote === void 0 ? {} : { quote: take(quote) },
-      ...text === void 0 ? {} : { text: take(text) }
+      ...text2 === void 0 ? {} : { text: take(text2) }
     };
   }
   if (entry2.earlier_versions)
@@ -21401,6 +21309,112 @@ var cuttableMessage = {
   drop: dropMetadata
 };
 
+// src/core/chat/schema.ts
+var METHODS = ["list", "view", "topics", "search", "around", "fetch"];
+var LIMITS = {
+  list: { default: 30, max: 200 },
+  view: { default: 50, max: 300 },
+  topics: { default: 30, max: TOPICS_LIMIT },
+  search: { default: 30, max: 200 }
+};
+var AROUND_COUNT = { default: 5, max: AROUND_LIMIT };
+var FETCH_PAGES = { default: 1, max: FETCH_PAGE_LIMIT };
+var accountArgument = external_exports.string().optional().describe("The account label; may be left out when only one account is logged in.");
+var input3 = external_exports.object({
+  method: external_exports.enum(METHODS).describe(
+    "`list` finds chats; `view` reads the newest messages of one chat between two times, oldest first; `topics` lists the topics of a forum chat; `search` finds messages in the mirror by words; `around` reads the messages around one; `fetch` adds older history of a mirrored chat to the mirror."
+  ),
+  account: accountArgument,
+  query: external_exports.string().optional().describe(
+    "list: only chats whose name or username holds this text; a leading @ is ignored. search (required): the words to look for, all of which a message must hold in its text, caption or file name, in any order. Both ignore case and letter width."
+  ),
+  unread: external_exports.boolean().optional().describe("list: only chats with unread messages."),
+  last: external_exports.boolean().optional().describe("list: add each chat's newest mirrored message as `last_message`."),
+  refresh: external_exports.boolean().optional().describe(
+    "list: first take the chat list from Telegram (needs the sync service), then read it, and report when in `refreshed_at`."
+  ),
+  chat: external_exports.string().optional().describe(
+    "view, topics, around, fetch (required) and search (optional, to search one chat): the chat id, from `list`, such as 123456789 or -1001234567890. A name, username or phone number is not a chat."
+  ),
+  topic: external_exports.number().int().positive().optional().describe(
+    `view, around: only messages of this topic of a forum chat (ids from \`topics\`); the General topic is ${GENERAL_TOPIC}. Refused for a chat without topics.`
+  ),
+  after: external_exports.string().optional().describe(
+    "view, search: only messages after this time (exclusive): RFC 3339 with an offset, or a date or time without one, read as local time, such as 2026-11-07 or 2026-11-07T14:03."
+  ),
+  before: external_exports.string().optional().describe("view, search: only messages before this time (exclusive); the same forms as `after`."),
+  limit: external_exports.number().int().optional().describe(
+    `How many to return. list: default ${LIMITS.list.default}, at most ${LIMITS.list.max}. view: default ${LIMITS.view.default}, at most ${LIMITS.view.max} (${HISTORY_LIMIT} for a chat read live). topics: default ${LIMITS.topics.default}, at most ${LIMITS.topics.max}. search: default ${LIMITS.search.default}, at most ${LIMITS.search.max}. A larger value is lowered to the most; a result may hold fewer to stay a size a model can read.`
+  ),
+  cursor: external_exports.string().optional().describe("The `next` of the previous result, to continue where it stopped."),
+  id: external_exports.number().int().positive().optional().describe("around (required): the id of the message to read around."),
+  before_count: external_exports.number().int().optional().describe(
+    `around: how many older messages to return, default ${AROUND_COUNT.default}, at most ${AROUND_COUNT.max}; 0 asks for none.`
+  ),
+  after_count: external_exports.number().int().optional().describe(
+    `around: how many newer messages to return, default ${AROUND_COUNT.default}, at most ${AROUND_COUNT.max}; 0 asks for none.`
+  ),
+  pages: external_exports.number().int().optional().describe(
+    `fetch: how many pages of ${FETCH_PAGE_SIZE} older messages to add, default ${FETCH_PAGES.default}, at most ${FETCH_PAGES.max}.`
+  )
+});
+var nameCut = external_exports.literal(true).optional().describe("Set when the name was longer than the most a result carries and was cut.");
+var chatEntry2 = external_exports.object({
+  id: external_exports.string().describe("The chat id: Telegram's signed id as text, such as `123456789` or `-1001234567890`."),
+  kind: external_exports.enum(CHAT_KINDS).describe("`self` is Saved Messages."),
+  name: external_exports.string().nullable().describe("The person's or chat's name; null when none is known."),
+  name_cut: nameCut,
+  username: external_exports.string().optional(),
+  mirrored: external_exports.boolean().describe("Whether the mirror keeps this chat's messages."),
+  unread: external_exports.number().int().describe("Incoming messages not read yet."),
+  last_activity_at: localTimeSchema.nullable().describe("The latest message's time, in local time with offset; null when none is known."),
+  forum: external_exports.literal(true).optional().describe("Set for a supergroup with topics."),
+  archived: external_exports.literal(true).optional(),
+  left: external_exports.literal(true).optional().describe("Set for a group or channel the user has left or been removed from."),
+  can_send: external_exports.literal(false).optional().describe("Set when the user is known not to be able to write here."),
+  auto_delete_seconds: external_exports.number().int().optional().describe("The chat's auto-delete period, when on."),
+  last_message: messageEntry.nullable().optional().describe("With `last`: the newest mirrored message of the chat, or null when none is mirrored.")
+});
+var topicEntry = external_exports.object({
+  id: external_exports.number().int().describe(`The topic id, to pass as \`topic\` to \`view\`; ${GENERAL_TOPIC} is the General topic.`),
+  title: external_exports.string().nullable().describe("The topic's title; null when none is known."),
+  closed: external_exports.literal(true).optional().describe("Set for a topic that is closed."),
+  pinned: external_exports.literal(true).optional().describe("Set for a topic that is pinned."),
+  unread: external_exports.number().int().describe("Messages in it not read yet."),
+  last_activity_at: localTimeSchema.nullable().describe("The newest message's time, in local time with offset; null when none is known.")
+});
+var output3 = external_exports.object({
+  chats: external_exports.array(chatEntry2).optional().describe("list: the chats, newest activity first."),
+  refreshed_at: localTimeSchema.optional().describe("list with `refresh`: when the chat list was taken from Telegram, in local time with offset."),
+  chat: chatEntry2.optional().describe("view, topics, around, fetch: the chat read."),
+  messages: external_exports.array(messageEntry).optional().describe("view, around: the messages, oldest first. search: the hits, newest first."),
+  live: external_exports.literal(true).optional().describe(
+    "view, around: set when the chat is not mirrored, so the messages were read from Telegram and stored nowhere."
+  ),
+  topics: external_exports.array(topicEntry).optional().describe("topics: the topics, most recently active first."),
+  anchor: external_exports.number().int().optional().describe("around: the id of the message read around, among `messages`."),
+  trimmed_before: external_exports.number().int().optional().describe(
+    "around: how many older messages were left out, farthest first, to keep the result a size that can be read."
+  ),
+  trimmed_after: external_exports.number().int().optional().describe(
+    "around: how many newer messages were left out, farthest first, to keep the result a size that can be read."
+  ),
+  scanned_to: localTimeSchema.optional().describe(
+    "search: set when the search stopped before the end of the history it covers: the time of the oldest message looked at, in local time with offset. `next` continues from there."
+  ),
+  scope: external_exports.string().optional().describe("search: what the search covers and what it does not."),
+  fetched: external_exports.object({
+    added: external_exports.number().int().describe("How many messages the mirror gained."),
+    pages: external_exports.number().int().describe("How many pages were read."),
+    complete: external_exports.boolean().describe("Whether Telegram has nothing older for this chat."),
+    oldest_at: localTimeSchema.nullable().describe(
+      "The time of the oldest message the mirror now holds of this chat, in local time with offset; null when none."
+    )
+  }).optional().describe("fetch: what the history fetch stored."),
+  next: external_exports.string().optional().describe("Pass back as `cursor` to continue; absent when there is no more."),
+  note: external_exports.string().describe("Says that what the result carries is data written by other people.")
+});
+
 // src/core/chat/around.ts
 var TRIMMED_RESERVE = 100;
 var NO_MESSAGE = "No message with this id in this chat.";
@@ -21522,8 +21536,8 @@ function fetchResult(read, stored) {
 }
 
 // src/core/fold.ts
-function foldCase(text) {
-  return text.normalize("NFKC").toUpperCase().toLowerCase().replace(/ς/g, "\u03C3");
+function foldCase(text2) {
+  return text2.normalize("NFKC").toUpperCase().toLowerCase().replace(/ς/g, "\u03C3");
 }
 
 // src/core/chat/filter.ts
@@ -21603,7 +21617,7 @@ function listChats(mirror, args, now) {
   return result;
 }
 
-// src/core/chat/open.ts
+// src/core/open.ts
 async function pickPaths(ctx, account2) {
   if (!ctx.stateDir) throw new ToolError("internal_error", "The entry point did not supply a state directory.");
   return pickLabel(ctx.stateDir, account2);
@@ -21662,8 +21676,8 @@ function foldedFileName(media) {
   return isRecord(info) && typeof info.name === "string" ? foldCase(info.name) : void 0;
 }
 function matchesAllWords(row, words2) {
-  const text = foldCase(row.body ?? "");
-  const unmatched = words2.filter((word) => !text.includes(word));
+  const text2 = foldCase(row.body ?? "");
+  const unmatched = words2.filter((word) => !text2.includes(word));
   if (unmatched.length === 0) return true;
   const name = row.media === null ? void 0 : foldedFileName(row.media);
   return name !== void 0 && unmatched.every((word) => name.includes(word));
@@ -22023,6 +22037,56 @@ var CHAT_FACT_TRANSLATIONS = {
   }
 };
 
+// src/core/chat/media-facts.ts
+var MEDIA_KIND_WORDS = {
+  photo: "Photo",
+  document: "Document",
+  audio: "Audio",
+  voice: "Voice message",
+  video: "Video",
+  sticker: "Sticker",
+  dice: "Dice",
+  contact: "Contact",
+  venue: "Venue",
+  geo: "Location",
+  geo_live: "Live location",
+  game: "Game",
+  invoice: "Invoice",
+  webpage: "Link preview",
+  poll: "Poll",
+  todo: "Checklist",
+  story: "Story",
+  paid: "Paid media",
+  unsupported: "Unsupported media"
+};
+function mediaKindValue(type) {
+  return Object.hasOwn(MEDIA_KIND_WORDS, type) ? { text: MEDIA_KIND_WORDS[type] } : type;
+}
+var MEDIA_FACT_TRANSLATIONS = {
+  ja: {
+    Media: "\u30E1\u30C7\u30A3\u30A2",
+    Photo: "\u5199\u771F",
+    Document: "\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8",
+    Audio: "\u97F3\u58F0",
+    "Voice message": "\u30DC\u30A4\u30B9\u30E1\u30C3\u30BB\u30FC\u30B8",
+    Video: "\u52D5\u753B",
+    Sticker: "\u30B9\u30BF\u30F3\u30D7",
+    Dice: "\u30B5\u30A4\u30B3\u30ED",
+    Contact: "\u9023\u7D61\u5148",
+    Venue: "\u5834\u6240",
+    Location: "\u4F4D\u7F6E\u60C5\u5831",
+    "Live location": "\u30E9\u30A4\u30D6\u4F4D\u7F6E\u60C5\u5831",
+    Game: "\u30B2\u30FC\u30E0",
+    Invoice: "\u8ACB\u6C42\u66F8",
+    "Link preview": "\u30EA\u30F3\u30AF\u306E\u30D7\u30EC\u30D3\u30E5\u30FC",
+    Poll: "\u6295\u7968",
+    Checklist: "\u30C1\u30A7\u30C3\u30AF\u30EA\u30B9\u30C8",
+    Story: "\u30B9\u30C8\u30FC\u30EA\u30FC",
+    "Paid media": "\u6709\u6599\u30E1\u30C7\u30A3\u30A2",
+    "Unsupported media": "\u672A\u5BFE\u5FDC\u306E\u30E1\u30C7\u30A3\u30A2"
+  }
+};
+
 // src/core/facts.ts
 function sizeFact(bytes) {
   return { label: "Size", value: { text: bytes === 1 ? "{bytes} byte" : "{bytes} bytes", values: { bytes } } };
@@ -22257,11 +22321,11 @@ var ANIMATED_STICKER = "an animated sticker (.tgs), which cannot be inspected";
 function unreadableArchive(label) {
   return `an archive that cannot be inspected (${label})`;
 }
-function words(text) {
-  return text.split(/\s+/).filter((word) => word !== "");
+function words(text2) {
+  return text2.split(/\s+/).filter((word) => word !== "");
 }
-function ascii(text) {
-  return Array.from(text, (character) => character.charCodeAt(0));
+function ascii(text2) {
+  return Array.from(text2, (character) => character.charCodeAt(0));
 }
 function at(offset, bytes) {
   return { offset, bytes };
@@ -22519,9 +22583,9 @@ function parseHeader(block) {
   }
   return { path, size: parseNumber(block.subarray(SIZE_START, SIZE_END)), type: block[TYPE_OFFSET] };
 }
-function parseDecimal(text) {
-  if (!/^[0-9]{1,15}$/.test(text)) return void 0;
-  return Number(text);
+function parseDecimal(text2) {
+  if (!/^[0-9]{1,15}$/.test(text2)) return void 0;
+  return Number(text2);
 }
 function parsePaxRecords(data, maxRecords = Infinity) {
   const records = [];
@@ -22711,8 +22775,8 @@ var EXTENSIONS = {
 };
 var KIND_PATTERN = /^[a-z]{1,16}$/;
 var UNKNOWN_KIND = "file";
-function byteLength(text) {
-  return Buffer5.byteLength(text);
+function byteLength(text2) {
+  return Buffer5.byteLength(text2);
 }
 function extensionOf2(type) {
   return type == null ? "" : EXTENSIONS[type.split(";")[0].trim().toLowerCase()] ?? "";
@@ -22981,8 +23045,8 @@ function fitListings(result) {
 var MAX_NAME_CHARACTERS = 255;
 var CUT_MARK = "\u2026";
 var HIDDEN_CHARACTERS = /[\u0000-\u001F\u007F-\u009F\u00AD\u034F\u061C\u115F\u1160\u17B4\u17B5\u180B-\u180F\u200B-\u200F\u2028-\u202E\u2060-\u206F\u3164\uFE00-\uFE0D\uFEFF\uFFA0\uFFF9-\uFFFC\u{1D173}-\u{1D17A}\u{E0000}-\u{E007F}]/gu;
-function cleanName(text) {
-  const cleaned = text.normalize("NFC").replace(HIDDEN_CHARACTERS, "?");
+function cleanName(text2) {
+  const cleaned = text2.normalize("NFC").replace(HIDDEN_CHARACTERS, "?");
   const characters = Array.from(cleaned);
   if (characters.length <= MAX_NAME_CHARACTERS) return cleaned;
   return characters.slice(0, MAX_NAME_CHARACTERS - CUT_MARK.length).join("") + CUT_MARK;
@@ -23155,9 +23219,9 @@ function decodeUtf8Lossy(bytes) {
   return LOSSY_UTF8.decode(bytes);
 }
 function decodeCp437(bytes) {
-  let text = "";
-  for (const byte of bytes) text += byte < ASCII_END ? String.fromCharCode(byte) : CP437_HIGH[byte - ASCII_END];
-  return text;
+  let text2 = "";
+  for (const byte of bytes) text2 += byte < ASCII_END ? String.fromCharCode(byte) : CP437_HIGH[byte - ASCII_END];
+  return text2;
 }
 
 // src/core/archive/tar.ts
@@ -23977,14 +24041,6 @@ function namesOf(file2, id) {
   const name = safeFileName(file2.name, { kind: file2.kind, id, type: file2.type });
   return { name, shown: file2.name === null ? file2.kind : name };
 }
-var FILE_KIND_WORDS = {
-  photo: "Photo",
-  document: "Document",
-  audio: "Audio",
-  voice: "Voice message",
-  video: "Video",
-  sticker: "Sticker"
-};
 function saveHeadline(file2, chat) {
   if (file2 !== void 0 && chat !== null) return { text: "About to save {file} from {chat}", values: { file: file2, chat } };
   if (chat !== null) return { text: "About to save a file from {chat}", values: { chat } };
@@ -23992,9 +24048,8 @@ function saveHeadline(file2, chat) {
   return void 0;
 }
 function fileFacts(media, unpack) {
-  const kind = media && Object.hasOwn(FILE_KIND_WORDS, media.type) ? FILE_KIND_WORDS[media.type] : void 0;
   return [
-    ...media ? [{ label: "File", value: kind ? { text: kind } : media.type }] : [],
+    ...media ? [{ label: "File", value: mediaKindValue(media.type) }] : [],
     ...unpack ? [{ label: "Unpack", value: { text: "Yes" } }] : [],
     ...media?.size !== void 0 && Number.isSafeInteger(media.size) && media.size > 0 ? [sizeFact(media.size)] : []
   ];
@@ -24225,14 +24280,14 @@ function storedReactions(json2) {
 function ownReaction(reactions) {
   return reactions.find((reaction2) => reaction2.mine)?.emoji;
 }
-function checkEditable({ kind, body, captioned }, text) {
+function checkEditable({ kind, body, captioned }, text2) {
   if (kind === "service" || body === null && !captioned) {
     throw new ToolError("invalid_argument", "This message has no text or caption to edit; nothing was edited.");
   }
-  if (body === text) {
+  if (body === text2) {
     throw new ToolError("invalid_argument", "The text is the same as the message's; nothing to edit.");
   }
-  if (captioned && text.length > CAPTION_MAX_UNITS) {
+  if (captioned && text2.length > CAPTION_MAX_UNITS) {
     throw new ToolError(
       "invalid_argument",
       `A caption must be at most ${CAPTION_MAX_UNITS} characters; nothing was edited.`
@@ -24241,8 +24296,8 @@ function checkEditable({ kind, body, captioned }, text) {
 }
 
 // src/core/message/arguments.ts
-function checkedText(text) {
-  const trimmed = text.trim();
+function checkedText(text2) {
+  const trimmed = text2.trim();
   if (trimmed === "") throw new ToolError("invalid_argument", "text is blank; give the text to send.");
   if (trimmed.length > TEXT_MAX_UNITS) {
     throw new ToolError(
@@ -24300,8 +24355,8 @@ var Window = class {
   get tail() {
     return this.#tail;
   }
-  sees(text) {
-    const all = this.#tail + text;
+  sees(text2) {
+    const all = this.#tail + text2;
     this.#tail = all.slice(-TAIL_LENGTH);
     return MARKER.test(all);
   }
@@ -24311,13 +24366,13 @@ var PrivateKeyScan = class {
   #withoutNuls;
   /** Feeds the next chunk; whether a marker starts anywhere in the bytes so far. */
   sees(chunk) {
-    const text = Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength).toString("latin1");
+    const text2 = Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength).toString("latin1");
     const before = this.#plain.tail;
-    const plain2 = this.#plain.sees(text);
-    if (this.#withoutNuls === void 0 && text.includes(NUL)) {
+    const plain2 = this.#plain.sees(text2);
+    if (this.#withoutNuls === void 0 && text2.includes(NUL)) {
       this.#withoutNuls = new Window(before);
     }
-    const stripped = this.#withoutNuls?.sees(text.replaceAll(NUL, "")) ?? false;
+    const stripped = this.#withoutNuls?.sees(text2.replaceAll(NUL, "")) ?? false;
     return plain2 || stripped;
   }
 };
@@ -24509,9 +24564,8 @@ async function checkArchive(path, format, limits, signal) {
 }
 
 // src/core/outgoing/limits.ts
-var BYTES_PER_MB2 = 1024 * 1024;
 var MAX_FILES = 10;
-var MAX_TOTAL_BYTES = 100 * BYTES_PER_MB2;
+var MAX_TOTAL_BYTES = 100 * BYTES_PER_MB;
 
 // src/core/file/send/constants.ts
 var SEND_FILES_TIMEOUT_MS = 30 * 60 * 1e3;
@@ -24944,12 +24998,12 @@ var DUPLICATE_NOTE = "An earlier delivery of this same call had already gone out
 var DUPLICATE_UNKNOWN_ID_NOTE = `${DUPLICATE_NOTE} Its id is not known yet; \`telegram_chat_read\` shows it once the service receives it.`;
 
 // src/core/message/uncertain.ts
-function sentLike(paths, chat, text, startedAt) {
+function sentLike(paths, chat, text2, startedAt) {
   const rows = readMirror(
     paths,
     (mirror) => mirror.prepare(
       "SELECT id, ts FROM messages WHERE chat = ? AND from_me = 1 AND body = ? AND ts >= ? ORDER BY ts DESC, id DESC LIMIT ?"
-    ).all(chat, text, startedAt - SENT_LOOKBACK_MS, MAX_SENT_LIKE)
+    ).all(chat, text2, startedAt - SENT_LOOKBACK_MS, MAX_SENT_LIKE)
   );
   return rows.map(({ id, ts }) => ({ id, time: formatLocalTime(ts) }));
 }
@@ -24969,8 +25023,8 @@ function withFound(error62, find, describe3) {
     details: { ...error62.details, sent_like_this: found }
   });
 }
-function withSentLike(error62, paths, chat, text, startedAt) {
-  return withFound(error62, () => sentLike(paths, chat, text, startedAt), sentence);
+function withSentLike(error62, paths, chat, text2, startedAt) {
+  return withFound(error62, () => sentLike(paths, chat, text2, startedAt), sentence);
 }
 
 // src/core/file/send/uncertain.ts
@@ -25107,17 +25161,17 @@ var MAX_HEADLINE_VALUES = 8;
 var MAX_HEADLINE_VALUE_LENGTH = 80;
 var MAX_PINS = 16;
 var HEADLINE_PLACEHOLDER = /\{([A-Za-z_][A-Za-z0-9_]*)\}/;
-function cut2(text, limit) {
-  const points = Array.from(text);
-  return points.length > limit ? `${points.slice(0, limit - 1).join("")}\u2026` : text;
+function cut2(text2, limit) {
+  const points = Array.from(text2);
+  return points.length > limit ? `${points.slice(0, limit - 1).join("")}\u2026` : text2;
 }
-function omittedBy(text, limit) {
-  const length = Array.from(text).length;
+function omittedBy(text2, limit) {
+  const length = Array.from(text2).length;
   return length > limit ? length - (limit - 1) : 0;
 }
-function templatePlaceholders(text) {
+function templatePlaceholders(text2) {
   const names = /* @__PURE__ */ new Set();
-  const parts = text.split(HEADLINE_PLACEHOLDER);
+  const parts = text2.split(HEADLINE_PLACEHOLDER);
   for (const [index, part] of parts.entries()) {
     if (index % 2 === 1) names.add(part);
     else if (/[{}]/.test(part)) return void 0;
@@ -25135,10 +25189,10 @@ function valueEntries(values) {
   const entries = Object.entries(values);
   return entries.length > MAX_HEADLINE_VALUES ? void 0 : entries;
 }
-function isTemplate(text, limit, entries) {
-  if (text.trim() === "" || Array.from(text).length > limit) return false;
+function isTemplate(text2, limit, entries) {
+  if (text2.trim() === "" || Array.from(text2).length > limit) return false;
   const given = new Set(entries.map(([name]) => name));
-  const placeholders2 = templatePlaceholders(text);
+  const placeholders2 = templatePlaceholders(text2);
   return placeholders2 !== void 0 && [...placeholders2].every((name) => given.has(name));
 }
 function isTemplateValue(value) {
@@ -25154,15 +25208,15 @@ function isFact(fact) {
 }
 function cutValue(value) {
   if (typeof value === "string") return cut2(value, MAX_VALUE_LENGTH);
-  const { text, values } = value;
-  if (values === void 0) return { text };
+  const { text: text2, values } = value;
+  if (values === void 0) return { text: text2 };
   const cutValues = Object.entries(values).map(
     ([name, entry2]) => [name, typeof entry2 === "string" ? cut2(entry2, MAX_VALUE_LENGTH) : entry2]
   );
-  return { text, values: Object.fromEntries(cutValues) };
+  return { text: text2, values: Object.fromEntries(cutValues) };
 }
-function isText2(text) {
-  return isRecord2(text) && typeof text.label === "string" && text.label.trim() !== "" && typeof text.body === "string";
+function isText2(text2) {
+  return isRecord2(text2) && typeof text2.label === "string" && text2.label.trim() !== "" && typeof text2.body === "string";
 }
 function pinsOf(pins) {
   if (pins === void 0) return {};
@@ -25176,32 +25230,32 @@ function pinsOf(pins) {
 }
 function copyValue(value) {
   if (typeof value === "string") return value;
-  const { text, values } = value;
-  return values === void 0 ? { text } : { text, values: { ...values } };
+  const { text: text2, values } = value;
+  return values === void 0 ? { text: text2 } : { text: text2, values: { ...values } };
 }
 function headlineOf(headline) {
   if (!isRecord2(headline) || typeof headline.text !== "string") return void 0;
-  const { text, values } = headline;
+  const { text: text2, values } = headline;
   const entries = valueEntries(values);
-  if (entries === void 0 || !isTemplate(text, MAX_HEADLINE_LENGTH, entries)) return void 0;
+  if (entries === void 0 || !isTemplate(text2, MAX_HEADLINE_LENGTH, entries)) return void 0;
   if (!entries.every((entry2) => typeof entry2[1] === "string")) return void 0;
-  return values === void 0 ? { text } : { text, values: Object.fromEntries(entries) };
+  return values === void 0 ? { text: text2 } : { text: text2, values: Object.fromEntries(entries) };
 }
-function cutHeadline({ text, values }) {
-  if (values === void 0) return { text };
+function cutHeadline({ text: text2, values }) {
+  if (values === void 0) return { text: text2 };
   const cutValues = Object.entries(values).map(
     ([name, value]) => [name, cut2(value, MAX_HEADLINE_VALUE_LENGTH)]
   );
-  return { text, values: Object.fromEntries(cutValues) };
+  return { text: text2, values: Object.fromEntries(cutValues) };
 }
-function cutDescription({ headline, facts, text, pins }) {
+function cutDescription({ headline, facts, text: text2, pins }) {
   return {
     ...headline && { headline: cutHeadline(headline) },
     facts: facts.slice(0, MAX_FACTS).map(({ label, value }) => ({
       label: cut2(label, MAX_LABEL_LENGTH),
       value: cutValue(value)
     })),
-    ...text && { text: { label: cut2(text.label, MAX_TEXT_LABEL_LENGTH), body: cut2(text.body, MAX_TEXT_LENGTH) } },
+    ...text2 && { text: { label: cut2(text2.label, MAX_TEXT_LABEL_LENGTH), body: cut2(text2.body, MAX_TEXT_LENGTH) } },
     ...pins && { pins }
   };
 }
@@ -25225,47 +25279,54 @@ async function wholeCallDescription(spec, args, ctx) {
   if (kept === void 0) return void 0;
   const facts = entries.map(({ label, value }) => ({ label, value: copyValue(value) }));
   const headline = answer.headline === void 0 ? void 0 : headlineOf(answer.headline);
-  const text = answer.text === void 0 || answer.text.body === "" ? void 0 : { label: answer.text.label, body: answer.text.body };
-  if (headline === void 0 && facts.length === 0 && text === void 0) return void 0;
-  return { ...headline && { headline }, facts, ...text && { text }, ...kept };
+  const text2 = answer.text === void 0 || answer.text.body === "" ? void 0 : { label: answer.text.label, body: answer.text.body };
+  if (headline === void 0 && facts.length === 0 && text2 === void 0) return void 0;
+  return { ...headline && { headline }, facts, ...text2 && { text: text2 }, ...kept };
 }
 
 // src/core/message/action-describe.ts
 var EDIT_HEADLINES = {
   named: "About to edit message {id} in {chat}",
-  saved: "About to edit message {id} in Saved Messages"
+  saved: "About to edit message {id} in Saved Messages",
+  bare: "About to edit message {id}"
 };
 var DELETE_HEADLINES = {
-  named: "About to delete message {id} from {chat}",
-  saved: "About to delete message {id} from Saved Messages"
+  named: "About to delete message {id} from {chat} for everyone",
+  saved: "About to delete message {id} from Saved Messages",
+  bare: "About to delete message {id} for everyone"
 };
 var REACT_HEADLINES = {
   named: "About to react {emoji} to message {id} in {chat}",
-  saved: "About to react {emoji} to message {id} in Saved Messages"
+  saved: "About to react {emoji} to message {id} in Saved Messages",
+  bare: "About to react {emoji} to message {id}"
 };
 var UNREACT_HEADLINES = {
   named: "About to remove your reaction from message {id} in {chat}",
-  saved: "About to remove your reaction from message {id} in Saved Messages"
+  saved: "About to remove your reaction from message {id} in Saved Messages",
+  bare: "About to remove your reaction from message {id}"
 };
 var PIN_HEADLINES = {
   named: "About to pin message {id} in {chat}",
-  saved: "About to pin message {id} in Saved Messages"
+  saved: "About to pin message {id} in Saved Messages",
+  bare: "About to pin message {id}"
 };
 var UNPIN_HEADLINES = {
   named: "About to unpin message {id} in {chat}",
-  saved: "About to unpin message {id} in Saved Messages"
+  saved: "About to unpin message {id} in Saved Messages",
+  bare: "About to unpin message {id}"
 };
 var MARK_READ_HEADLINES = {
   named: "About to mark {chat} read up to message {id}",
-  saved: "About to mark Saved Messages read up to message {id}"
+  saved: "About to mark Saved Messages read up to message {id}",
+  bare: "About to mark messages read up to message {id}"
 };
 function actionHeadline(headlines, { kind, name }, id, values) {
   if (kind === "self") return { text: headlines.saved, values: { id: String(id), ...values } };
-  return name === null ? void 0 : { text: headlines.named, values: { id: String(id), chat: name, ...values } };
+  return name === null ? { text: headlines.bare, values: { id: String(id), ...values } } : { text: headlines.named, values: { id: String(id), chat: name, ...values } };
 }
 function currentFacts({ body, media }) {
-  const shown = body || media?.type;
-  return shown ? [{ label: "Current", value: cut2(shown, MAX_VALUE_LENGTH) }] : [];
+  if (body) return [{ label: "Current", value: cut2(body, MAX_VALUE_LENGTH) }];
+  return media ? [{ label: "Media", value: mediaKindValue(media.type) }] : [];
 }
 function describeAction(headlines, chat, id, message, extras = {}) {
   const headline = actionHeadline(headlines, chat, id, extras.values ?? {});
@@ -25501,7 +25562,7 @@ var telegramMessageDelete = defineTool({
     "A result means Telegram deleted the message for everyone. `already` means it was gone before this call.",
     "A failure `uncertain` means the delete may have gone through: check the chat in Telegram and never ask for it again without the user checking."
   ].join(" "),
-  intent: "About to delete a message",
+  intent: "About to delete a message for everyone",
   toolset: "actions",
   class: "administrative",
   input: deleteInput,
@@ -25533,10 +25594,10 @@ var telegramMessageDelete = defineTool({
 });
 
 // src/core/message/edit-prepare.ts
-function prepareEdit(mirror, chatId, id, text) {
+function prepareEdit(mirror, chatId, id, text2) {
   const { chat, message } = findOwnMessage(mirror, chatId, id, "edit");
   if (!message) throw deletedMessage();
-  checkEditable({ ...message, captioned: message.media !== null && takesCaption(message.media.type) }, text);
+  checkEditable({ ...message, captioned: message.media !== null && takesCaption(message.media.type) }, text2);
   return { chat, message };
 }
 
@@ -25559,22 +25620,22 @@ var telegramMessageEdit = defineTool({
   input: editInput,
   output: editOutput,
   async describe(args, ctx) {
-    const text = checkedText(args.text);
+    const text2 = checkedText(args.text);
     const chat = requireChatId(args.chat, MESSAGE_EDIT_TOOL_ID);
     const paths = await pickPaths(ctx, args.account);
-    const target = readMirror(paths, (mirror) => prepareEdit(mirror, chat, args.id, text));
+    const target = readMirror(paths, (mirror) => prepareEdit(mirror, chat, args.id, text2));
     return {
       ...describeAction(EDIT_HEADLINES, target.chat, args.id, target.message),
-      text: { label: "New text", body: text }
+      text: { label: "New text", body: text2 }
     };
   },
   targets: (args, ctx) => actionTargets(MESSAGE_EDIT_TOOL_ID, args, ctx),
   async execute(args, ctx) {
     const chat = requireChatId(args.chat, MESSAGE_EDIT_TOOL_ID);
-    const text = checkedText(args.text);
+    const text2 = checkedText(args.text);
     const paths = await pickPaths(ctx, args.account);
-    readMirror(paths, (mirror) => prepareEdit(mirror, chat, args.id, text));
-    const params = { chat, id: args.id, text };
+    readMirror(paths, (mirror) => prepareEdit(mirror, chat, args.id, text2));
+    const params = { chat, id: args.id, text: text2 };
     const edited = await callService(paths.socket, SERVICE_REQUESTS.edit, params, {
       effect: "write",
       signal: ctx.signal,
@@ -25770,7 +25831,7 @@ var telegramMessageSend = defineTool({
   input: input5,
   output: output5,
   async describe(args, ctx) {
-    const text = checkedText(args.text);
+    const text2 = checkedText(args.text);
     const chat = requireChatId(args.chat, MESSAGE_SEND_TOOL_ID);
     const paths = await pickPaths(ctx, args.account);
     const { row, title } = readMirror(paths, (mirror) => {
@@ -25782,17 +25843,17 @@ var telegramMessageSend = defineTool({
         headline: { text: "About to send a message to {chat}", values: { chat: row.name } }
       },
       facts: [chatFact(row.kind), ...topicFacts(args.topic, title), ...replyFacts(args.reply_to)],
-      text: { label: "Message text", body: text }
+      text: { label: "Message text", body: text2 }
     };
   },
   targets: (args, ctx) => chatTargets(MESSAGE_SEND_TOOL_ID, args, ctx),
   async execute(args, ctx) {
     const chat = requireChatId(args.chat, MESSAGE_SEND_TOOL_ID);
-    const text = checkedText(args.text);
+    const text2 = checkedText(args.text);
     const paths = await pickPaths(ctx, args.account);
     const params = {
       chat,
-      text,
+      text: text2,
       ...args.topic !== void 0 && { topic: args.topic },
       ...args.reply_to !== void 0 && { reply_to: args.reply_to }
     };
@@ -25805,7 +25866,7 @@ var telegramMessageSend = defineTool({
       });
       return sendResult(chat, sent);
     } catch (error62) {
-      throw isToolError(error62) && error62.code === "uncertain" ? withSentLike(error62, paths, chat, text, startedAt) : error62;
+      throw isToolError(error62) && error62.code === "uncertain" ? withSentLike(error62, paths, chat, text2, startedAt) : error62;
     }
   }
 });
@@ -26106,12 +26167,6 @@ var FILE_TRANSLATIONS = {
     "About to save a file from {chat}": "{chat} \u306E\u30D5\u30A1\u30A4\u30EB\u3092\u4FDD\u5B58\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to save {file}": "{file} \u3092\u4FDD\u5B58\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     File: "\u30D5\u30A1\u30A4\u30EB",
-    Photo: "\u5199\u771F",
-    Document: "\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8",
-    Audio: "\u97F3\u58F0",
-    "Voice message": "\u30DC\u30A4\u30B9\u30E1\u30C3\u30BB\u30FC\u30B8",
-    Video: "\u52D5\u753B",
-    Sticker: "\u30B9\u30BF\u30F3\u30D7",
     Unpack: "\u5C55\u958B",
     Yes: "\u3059\u308B"
   }
@@ -26126,24 +26181,31 @@ var ACTION_TRANSLATIONS = {
     "Pin or unpin a message": "\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u30D4\u30F3\u7559\u3081\u3059\u308B\u30FB\u89E3\u9664\u3059\u308B",
     "Mark a chat read": "\u30C1\u30E3\u30C3\u30C8\u3092\u65E2\u8AAD\u306B\u3059\u308B",
     "About to edit a message": "\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u7DE8\u96C6\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
-    "About to delete a message": "\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u524A\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to delete a message for everyone": "\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u5168\u54E1\u5206\u524A\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to change a reaction": "\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u5909\u66F4\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to pin or unpin a message": "\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u30D4\u30F3\u7559\u3081\u3092\u5909\u66F4\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to mark messages read": "\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u65E2\u8AAD\u306B\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to edit message {id} in {chat}": "{chat} \u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u7DE8\u96C6\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
-    "About to edit message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u7DE8\u96C6\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
-    "About to delete message {id} from {chat}": "{chat} \u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u524A\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
-    "About to delete message {id} from Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u524A\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to edit message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306B\u3042\u308B\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u7DE8\u96C6\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to edit message {id}": "\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u7DE8\u96C6\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to delete message {id} from {chat} for everyone": "{chat} \u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u5168\u54E1\u5206\u524A\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to delete message {id} from Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306B\u3042\u308B\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u524A\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to delete message {id} for everyone": "\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u5168\u54E1\u5206\u524A\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to react {emoji} to message {id} in {chat}": "{chat} \u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u306B {emoji} \u306E\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u4ED8\u3051\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
-    "About to react {emoji} to message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u306B {emoji} \u306E\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u4ED8\u3051\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to react {emoji} to message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306B\u3042\u308B\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u306B {emoji} \u306E\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u4ED8\u3051\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to react {emoji} to message {id}": "\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u306B {emoji} \u306E\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u4ED8\u3051\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to remove your reaction from message {id} in {chat}": "{chat} \u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u304B\u3089\u81EA\u5206\u306E\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u5916\u305D\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
-    "About to remove your reaction from message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u304B\u3089\u81EA\u5206\u306E\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u5916\u305D\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to remove your reaction from message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306B\u3042\u308B\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u304B\u3089\u81EA\u5206\u306E\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u5916\u305D\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to remove your reaction from message {id}": "\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u304B\u3089\u81EA\u5206\u306E\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u5916\u305D\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to pin message {id} in {chat}": "{chat} \u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u30D4\u30F3\u7559\u3081\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
-    "About to pin message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u30D4\u30F3\u7559\u3081\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to pin message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306B\u3042\u308B\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u30D4\u30F3\u7559\u3081\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to pin message {id}": "\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u3092\u30D4\u30F3\u7559\u3081\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to unpin message {id} in {chat}": "{chat} \u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u306E\u30D4\u30F3\u7559\u3081\u3092\u89E3\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
-    "About to unpin message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u306E\u30D4\u30F3\u7559\u3081\u3092\u89E3\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to unpin message {id} in Saved Messages": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u306B\u3042\u308B\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u306E\u30D4\u30F3\u7559\u3081\u3092\u89E3\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to unpin message {id}": "\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u306E\u30D4\u30F3\u7559\u3081\u3092\u89E3\u9664\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to mark {chat} read up to message {id}": "{chat} \u3092\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u307E\u3067\u65E2\u8AAD\u306B\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     "About to mark Saved Messages read up to message {id}": "\u4FDD\u5B58\u6E08\u307F\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u307E\u3067\u65E2\u8AAD\u306B\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
+    "About to mark messages read up to message {id}": "\u30E1\u30C3\u30BB\u30FC\u30B8 {id} \u307E\u3067\u65E2\u8AAD\u306B\u3057\u3088\u3046\u3068\u3057\u3066\u3044\u307E\u3059",
     Message: "\u30E1\u30C3\u30BB\u30FC\u30B8",
     Current: "\u73FE\u5728\u306E\u5185\u5BB9",
     Replaces: "\u7F6E\u304D\u63DB\u3048\u308B\u30EA\u30A2\u30AF\u30B7\u30E7\u30F3",
@@ -26187,6 +26249,7 @@ var SYNC_TRANSLATIONS = {
 var ALL_TRANSLATIONS = mergeTranslations(
   FACT_TRANSLATIONS,
   CHAT_FACT_TRANSLATIONS,
+  MEDIA_FACT_TRANSLATIONS,
   MESSAGE_TRANSLATIONS,
   ACTION_TRANSLATIONS,
   FILE_TRANSLATIONS,
@@ -26209,9 +26272,9 @@ function mark(character) {
   const hex3 = character.codePointAt(0).toString(16).toUpperCase();
   return `<U+${hex3.padStart(MARK_DIGITS, "0")}>`;
 }
-function visible(text, options = {}) {
-  if (options.keepNewlines) return text.replace(/\r\n/g, "\n").replace(HIDDEN_EXCEPT_NEWLINE, mark);
-  return text.replace(HIDDEN_ALL, mark);
+function visible(text2, options = {}) {
+  if (options.keepNewlines) return text2.replace(/\r\n/g, "\n").replace(HIDDEN_EXCEPT_NEWLINE, mark);
+  return text2.replace(HIDDEN_ALL, mark);
 }
 
 // src/entry/words.ts
@@ -26257,12 +26320,12 @@ var omittedOf = (count) => count > 0 ? { omitted: count } : {};
 function quoted(value) {
   return `"${visible(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
 }
-function filled(text, literal2, slot) {
-  return text.split(HEADLINE_PLACEHOLDER).map((part, index) => index % 2 === 0 ? literal2(part) : slot(part)).join("");
+function filled(text2, literal2, slot) {
+  return text2.split(HEADLINE_PLACEHOLDER).map((part, index) => index % 2 === 0 ? literal2(part) : slot(part)).join("");
 }
-function renderedHeadline({ text, values = {} }) {
+function renderedHeadline({ text: text2, values = {} }) {
   return filled(
-    text,
+    text2,
     (part) => visible(part),
     (name) => quoted(values[name] ?? "")
   );
@@ -26276,7 +26339,7 @@ function renderedValue(value, t) {
   return { value: visible(cut2(whole, MAX_VALUE_LENGTH)), ...omittedOf(omittedBy(whole, MAX_VALUE_LENGTH)) };
 }
 function shownDescription(description, t) {
-  const { headline, facts, text } = cutDescription(description);
+  const { headline, facts, text: text2 } = cutDescription(description);
   const wholeBody = description.text?.body ?? "";
   const dropped = description.facts.length - facts.length;
   return {
@@ -26286,9 +26349,9 @@ function shownDescription(description, t) {
       ...renderedValue(description.facts[index].value, t)
     })),
     ...dropped > 0 && { dropped },
-    ...text && {
+    ...text2 && {
       text: {
-        label: visible(t.word(text.label, MAX_TEXT_LABEL_LENGTH)),
+        label: visible(t.word(text2.label, MAX_TEXT_LABEL_LENGTH)),
         body: visible(cut2(wholeBody, MAX_TEXT_LENGTH), { keepNewlines: true }),
         ...omittedOf(omittedBy(wholeBody, MAX_TEXT_LENGTH))
       }
@@ -26302,9 +26365,9 @@ async function timedCallDescription(spec, args, ctx, timeoutMs = DESCRIBE_TIMEOU
   let timer;
   let onAbort;
   try {
-    const timedOut = new Promise((resolve8) => {
+    const timedOut = new Promise((resolve6) => {
       timer = setTimeout(() => {
-        resolve8(void 0);
+        resolve6(void 0);
         controller.abort();
       }, timeoutMs);
     });
@@ -26380,76 +26443,70 @@ ${JSON.stringify(error62.details)}` : ""}`;
 var PROJECT_PROFILE = {
   name: PROJECT.name,
   envPrefix: PROJECT.envPrefix,
-  toolsets: { names: PROJECT.toolsets, defaults: PROJECT.defaultToolsets }
+  toolsets: { names: PROJECT.toolsets, defaults: PROJECT.defaultToolsets },
+  options: PROJECT.options
 };
 
-// src/entry/download-dir.ts
-import { resolve as resolve5 } from "node:path";
+// src/entry/settings.ts
+import { homedir as homedir3 } from "node:os";
+import { isAbsolute as isAbsolute6, join as join10, resolve as resolvePath, sep as sep4 } from "node:path";
 
 // src/entry/directory.ts
 import { homedir as homedir2 } from "node:os";
-import { isAbsolute as isAbsolute5, join as join10, resolve as resolve4, sep as sep4 } from "node:path";
+import { isAbsolute as isAbsolute5, resolve as resolve4 } from "node:path";
+var DOWNLOADS_DIR = "Downloads";
+var DEFAULT_DOWNLOAD_MAX_MB = 100;
 function homeDir(env) {
   const envHome = env.HOME;
   if (envHome && isAbsolute5(envHome)) return envHome;
   return homedir2();
 }
-function resolveGivenDirectory(given, home) {
-  const text = given.text.trim();
-  const expanded = text === "~" ? home : text.startsWith("~/") || text.startsWith(`~${sep4}`) ? join10(home, text.slice(2)) : text;
-  if (!text || !isAbsolute5(expanded)) {
-    throw new ToolError("invalid_argument", `${given.source} must be an absolute path.`);
-  }
-  return resolve4(expanded);
-}
-
-// src/entry/download-dir.ts
-var DOWNLOADS_DIR = "Downloads";
-function resolveDownloadDir(given, env, profile) {
-  const home = homeDir(env);
-  return given !== void 0 ? resolveGivenDirectory(given, home) : resolve5(home, DOWNLOADS_DIR, profile.name);
+function defaultStateDir(name, env, home) {
+  const xdg = env.XDG_STATE_HOME;
+  return xdg && isAbsolute5(xdg) ? resolve4(xdg, name) : resolve4(home, ".local", "state", name);
 }
-
-// src/entry/send-dirs.ts
-function resolveSendDirs(given, env) {
-  const home = homeDir(env);
-  return given.map((directory) => resolveGivenDirectory(directory, home));
+function text(value) {
+  return typeof value === "string" ? value : void 0;
 }
-
-// src/entry/state-dir.ts
-import { isAbsolute as isAbsolute6, resolve as resolve6 } from "node:path";
-function resolveStateDir(given, env, profile) {
+function resolveDirectorySettings(options, env, profile) {
   const home = homeDir(env);
-  if (given !== void 0) return resolveGivenDirectory(given, home);
-  const xdg = env.XDG_STATE_HOME;
-  if (xdg && isAbsolute6(xdg)) {
-    return resolve6(xdg, profile.name);
-  }
-  return resolve6(home, ".local", "state", profile.name);
+  const maxMb = options.download_max_mb;
+  const sendDirs = options.send_dirs;
+  return {
+    state_dir: text(options.state_dir) ?? defaultStateDir(profile.name, env, home),
+    download_dir: text(options.download_dir) ?? resolve4(home, DOWNLOADS_DIR, profile.name),
+    download_max_mb: typeof maxMb === "number" ? maxMb : DEFAULT_DOWNLOAD_MAX_MB,
+    send_dirs: Array.isArray(sendDirs) ? [...sendDirs] : []
+  };
 }
 
 // src/entry/settings.ts
 var ALL_TOOLSETS = "all";
 var TRUE_VALUES = ["1", "true"];
 var FALSE_VALUES = ["0", "false"];
-var DEFAULT_DOWNLOAD_MAX_MB = 100;
-var MAX_DOWNLOAD_MB = 2e3;
 var OPTIONS = {
   toolsets: { flag: "--toolsets", envSuffix: "TOOLSETS" },
   read_only: { flag: "--read-only", envSuffix: "READ_ONLY", boolean: true },
   tools: { flag: "--tools", envSuffix: "TOOLS" },
   exclude_tools: { flag: "--exclude-tools", envSuffix: "EXCLUDE_TOOLS" },
-  confirm: { flag: "--confirm", envSuffix: "CONFIRM" },
-  state_dir: { flag: "--state-dir", envSuffix: "STATE_DIR" },
-  download_dir: { flag: "--download-dir", envSuffix: "DOWNLOAD_DIR" },
-  download_max_mb: { flag: "--download-max-mb", envSuffix: "DOWNLOAD_MAX_MB" },
-  send_dirs: { flag: "--send-dirs", envSuffix: "SEND_DIRS" },
-  keep_disappearing: { flag: "--keep-disappearing", envSuffix: "KEEP_DISAPPEARING", boolean: true },
-  channels: { flag: "--channels", envSuffix: "CHANNELS", boolean: true }
+  confirm: { flag: "--confirm", envSuffix: "CONFIRM" }
 };
-var SERVICE_OPTION_NAMES = ["keep_disappearing", "channels"];
+function profileOptions(profile) {
+  return profile.options ?? {};
+}
+function settingOptions(profile) {
+  const toolOptions = Object.entries(profileOptions(profile)).map(([name, spec]) => [
+    name,
+    {
+      flag: `--${name.replace(/_/g, "-")}`,
+      envSuffix: name.toUpperCase(),
+      ...optionType(spec) === "boolean" && { boolean: true }
+    }
+  ]);
+  return { ...OPTIONS, ...Object.fromEntries(toolOptions) };
+}
 function envName(name, profile) {
-  return `${profile.envPrefix}_${OPTIONS[name].envSuffix}`;
+  return `${profile.envPrefix}_${settingOptions(profile)[name].envSuffix}`;
 }
 function splitList(value) {
   return value.split(",").map((item) => item.trim()).filter((item) => item !== "");
@@ -26464,43 +26521,87 @@ function checkToolsets(names, source, toolsets) {
   return names.length ? names : void 0;
 }
 function parseBoolean(value, source) {
-  const text = value.trim().toLowerCase();
-  if (TRUE_VALUES.includes(text)) return true;
-  if (FALSE_VALUES.includes(text)) return false;
+  const text2 = value.trim().toLowerCase();
+  if (TRUE_VALUES.includes(text2)) return true;
+  if (FALSE_VALUES.includes(text2)) return false;
   throw new ToolError(
     "invalid_argument",
     `Unknown value "${value}" in ${source}; use one of ${[...TRUE_VALUES, ...FALSE_VALUES].join(", ")}.`
   );
 }
-function listedDirectories(given) {
-  return given === void 0 ? [] : splitList(given.text).map((text) => ({ text, source: given.source }));
-}
-function downloadMaxMb(value, source) {
-  if (typeof value !== "number" || !Number.isInteger(value) || value < 1 || value > MAX_DOWNLOAD_MB) {
-    throw new ToolError("invalid_argument", `${source} must be an integer from 1 to ${MAX_DOWNLOAD_MB}.`);
+function parseNumber2(value, source) {
+  const trimmed = value.trim();
+  const parsed = trimmed === "" ? Number.NaN : Number(trimmed);
+  if (!Number.isFinite(parsed)) {
+    throw new ToolError("invalid_argument", `Unknown number "${value}" in ${source}; use a finite number.`);
   }
-  return value;
+  return parsed;
 }
-function downloadMaxMbText({ text, source }) {
-  const trimmed = text.trim();
-  return downloadMaxMb(/^\d+$/.test(trimmed) ? Number(trimmed) : Number.NaN, source);
+function absolutePath(text2, source, env) {
+  const home = env.HOME !== void 0 && isAbsolute6(env.HOME) ? env.HOME : homedir3();
+  const expanded = text2 === "~" || text2.startsWith("~/") || text2.startsWith(`~${sep4}`) ? join10(home, text2.slice(1)) : text2;
+  if (!isAbsolute6(expanded)) throw new ToolError("invalid_argument", `${source} must be an absolute path.`);
+  return resolvePath(expanded);
+}
+function absolutePaths(items, source, env) {
+  return items.length > 0 ? items.map((item) => absolutePath(item, source, env)) : void 0;
 }
 function envText(name, env, profile) {
   const variable = envName(name, profile);
-  const text = env[variable];
-  return text === void 0 || text.trim() === "" ? void 0 : { text, source: variable };
-}
-var TOOL_OPTION_NAMES = [
-  "toolsets",
-  "read_only",
-  "tools",
-  "exclude_tools",
-  "state_dir",
-  "download_dir",
-  "download_max_mb",
-  "send_dirs",
-  ...SERVICE_OPTION_NAMES
-];
+  const text2 = env[variable];
+  return text2 === void 0 || text2.trim() === "" ? void 0 : { text: text2, source: variable };
+}
+function optionType(spec) {
+  return typeof spec === "string" ? spec : spec.type;
+}
+function itemCount(count) {
+  return count === 1 ? "1 item" : `${count} items`;
+}
+function numberBoundsError({ integer: integer2, min, max }, source) {
+  const range = min !== void 0 && max !== void 0 ? ` from ${min} to ${max}` : min !== void 0 ? ` of at least ${min}` : max !== void 0 ? ` of at most ${max}` : "";
+  return new ToolError("invalid_argument", `${source} must be ${integer2 ? "a whole number" : "a number"}${range}.`);
+}
+function countBoundsError({ min, max }, source) {
+  const range = min !== void 0 && max !== void 0 ? `from ${min} to ${max} items` : min !== void 0 ? `at least ${itemCount(min)}` : `at most ${itemCount(max)}`;
+  return new ToolError("invalid_argument", `${source} must list ${range}.`);
+}
+function withinBounds(spec, value, source) {
+  if (value === void 0 || typeof spec === "string") return value;
+  const bounds = spec;
+  const { integer: integer2, min, max } = bounds;
+  if (typeof value === "number") {
+    if (integer2 && !Number.isInteger(value) || min !== void 0 && value < min || max !== void 0 && value > max) {
+      throw numberBoundsError(bounds, source);
+    }
+  } else if (typeof value === "object" && (min !== void 0 && value.length < min || max !== void 0 && value.length > max)) {
+    throw countBoundsError(bounds, source);
+  }
+  return value;
+}
+function parseOptionText(spec, given, env) {
+  return withinBounds(spec, parseTypedText(optionType(spec), given, env), given.source);
+}
+function parseTypedText(kind, given, env) {
+  switch (kind) {
+    case "text":
+      return nonBlank(given.text);
+    case "boolean":
+      return parseBoolean(given.text, given.source);
+    case "number":
+      return parseNumber2(given.text, given.source);
+    case "list": {
+      const items = splitList(given.text);
+      return items.length > 0 ? items : void 0;
+    }
+    case "path": {
+      const text2 = nonBlank(given.text);
+      return text2 === void 0 ? void 0 : absolutePath(text2, given.source, env);
+    }
+    case "paths":
+      return absolutePaths(splitList(given.text), given.source, env);
+  }
+}
+var TOOL_OPTION_NAMES = ["toolsets", "read_only", "tools", "exclude_tools"];
 function stringList(value) {
   return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : void 0;
 }
@@ -26508,15 +26609,6 @@ var optionSource = (name) => `Option "${name}"`;
 function optionError(name, expected) {
   return new ToolError("invalid_argument", `${optionSource(name)} must be ${expected}.`);
 }
-function directoryOption(name, value) {
-  if (typeof value !== "string") throw optionError(name, "an absolute path");
-  return value;
-}
-function sendDirsOption(value) {
-  const list2 = stringList(value);
-  if (!list2) throw optionError("send_dirs", "a list of absolute paths");
-  return list2.map((text) => ({ text, source: optionSource("send_dirs") }));
-}
 function toolsetsOption(value, toolsets) {
   if (value === ALL_TOOLSETS) return ALL_TOOLSETS;
   const names = stringList(value);
@@ -26537,12 +26629,14 @@ function listOption(name) {
   };
 }
 var LANGUAGE_OPTION = "language";
-var PLUGIN_OPTION_NAMES = [...TOOL_OPTION_NAMES, LANGUAGE_OPTION];
+function pluginOptionNames(profile) {
+  return [...TOOL_OPTION_NAMES, LANGUAGE_OPTION, ...Object.keys(profileOptions(profile))];
+}
 function languageVariable(profile = PROJECT_PROFILE) {
   return `${profile.envPrefix}_LANGUAGE`;
 }
-function nonBlank(text) {
-  const trimmed = text?.trim();
+function nonBlank(text2) {
+  const trimmed = text2?.trim();
   return trimmed === "" ? void 0 : trimmed;
 }
 function promptLanguage(flag, env, harness, profile = PROJECT_PROFILE) {
@@ -26552,42 +26646,80 @@ function languageOption(value) {
   if (typeof value !== "string") throw optionError(LANGUAGE_OPTION, 'a language tag such as "ja"');
   return nonBlank(value);
 }
+function toolOption(name, spec, value, env) {
+  return withinBounds(spec, toolOptionOfType(name, optionType(spec), value, env), `Option "${name}"`);
+}
+function toolOptionOfType(name, kind, value, env) {
+  switch (kind) {
+    case "text":
+      if (typeof value !== "string") throw optionError(name, "text");
+      return nonBlank(value);
+    case "boolean":
+      if (typeof value !== "boolean") throw optionError(name, "true or false");
+      return value;
+    case "number":
+      if (typeof value !== "number" || !Number.isFinite(value)) throw optionError(name, "a finite number");
+      return value;
+    case "list": {
+      const list2 = stringList(value);
+      if (!list2) throw optionError(name, "a list of strings");
+      const items = list2.map((item) => item.trim()).filter((item) => item !== "");
+      return items.length > 0 ? items : void 0;
+    }
+    case "path": {
+      if (typeof value !== "string") throw optionError(name, "an absolute path");
+      const text2 = nonBlank(value);
+      return text2 === void 0 ? void 0 : absolutePath(text2, `Option "${name}"`, env);
+    }
+    case "paths": {
+      const list2 = stringList(value);
+      if (!list2) throw optionError(name, "a list of absolute paths");
+      return absolutePaths(
+        list2.flatMap((item) => nonBlank(item) ?? []),
+        `Option "${name}"`,
+        env
+      );
+    }
+  }
+}
 function settingsFromOptions(options, env, profile = PROJECT_PROFILE) {
   const given = options ?? {};
-  const unknown2 = Object.keys(given).find((name) => !PLUGIN_OPTION_NAMES.includes(name));
+  const names = pluginOptionNames(profile);
+  const unknown2 = Object.keys(given).find((name) => !names.includes(name));
   if (unknown2 !== void 0) {
-    throw new ToolError(
-      "invalid_argument",
-      `Unknown option "${unknown2}"; use one of ${PLUGIN_OPTION_NAMES.join(", ")}.`
-    );
+    throw new ToolError("invalid_argument", `Unknown option "${unknown2}"; use one of ${names.join(", ")}.`);
   }
-  const resolve8 = (name, fromOption, fromText) => {
+  const resolve6 = (name, fromOption, fromText) => {
     if (given[name] !== void 0) return fromOption(given[name]);
-    const text = envText(name, env, profile);
-    return text !== void 0 ? fromText(text) : void 0;
-  };
-  const directoryText = (name) => given[name] !== void 0 ? { text: directoryOption(name, given[name]), source: optionSource(name) } : envText(name, env, profile);
+    const text2 = envText(name, env, profile);
+    return text2 !== void 0 ? fromText(text2) : void 0;
+  };
+  const parsedOptions = {};
+  for (const [name, spec] of Object.entries(profileOptions(profile))) {
+    let parsed;
+    if (given[name] !== void 0) {
+      parsed = toolOption(name, spec, given[name], env);
+    } else {
+      const fromEnv = envText(name, env, profile);
+      if (fromEnv !== void 0) parsed = parseOptionText(spec, fromEnv, env);
+    }
+    if (parsed !== void 0) parsedOptions[name] = parsed;
+  }
   const settings = {
-    state_dir: resolveStateDir(directoryText("state_dir"), env, profile),
-    send_dirs: resolveSendDirs(resolve8("send_dirs", sendDirsOption, listedDirectories) ?? [], env),
-    download_dir: resolveDownloadDir(directoryText("download_dir"), env, profile),
-    download_max_mb: resolve8("download_max_mb", (value) => downloadMaxMb(value, optionSource("download_max_mb")), downloadMaxMbText) ?? DEFAULT_DOWNLOAD_MAX_MB
+    options: parsedOptions,
+    ...resolveDirectorySettings(parsedOptions, env, profile)
   };
-  const toolsets = resolve8(
+  const toolsets = resolve6(
     "toolsets",
     (value) => toolsetsOption(value, profile.toolsets),
-    ({ text, source }) => checkToolsets(splitList(text), source, profile.toolsets)
+    ({ text: text2, source }) => checkToolsets(splitList(text2), source, profile.toolsets)
   );
   if (toolsets !== void 0) settings.toolsets = toolsets;
-  const readOnly = resolve8("read_only", booleanOption("read_only"), ({ text, source }) => parseBoolean(text, source));
+  const readOnly = resolve6("read_only", booleanOption("read_only"), ({ text: text2, source }) => parseBoolean(text2, source));
   if (readOnly !== void 0) settings.read_only = readOnly;
-  for (const name of SERVICE_OPTION_NAMES) {
-    const given2 = resolve8(name, booleanOption(name), ({ text, source }) => parseBoolean(text, source));
-    if (given2 !== void 0) settings[name] = given2;
-  }
-  const tools = resolve8("tools", listOption("tools"), ({ text }) => splitList(text));
+  const tools = resolve6("tools", listOption("tools"), ({ text: text2 }) => splitList(text2));
   if (tools !== void 0) settings.tools = tools;
-  const excluded = resolve8("exclude_tools", listOption("exclude_tools"), ({ text }) => splitList(text));
+  const excluded = resolve6("exclude_tools", listOption("exclude_tools"), ({ text: text2 }) => splitList(text2));
   if (excluded !== void 0) settings.exclude_tools = excluded;
   const language = given[LANGUAGE_OPTION] !== void 0 ? languageOption(given[LANGUAGE_OPTION]) : promptLanguage(void 0, env, void 0, profile);
   if (language !== void 0) settings.language = language;
@@ -26618,7 +26750,8 @@ function selectedTools(specs, options, deps) {
     downloadMaxMb: settings.download_max_mb,
     sendDirs: settings.send_dirs,
     programName: PROJECT.name,
-    translator: promptTranslator(deps.translations ?? {}, settings.language)
+    translator: promptTranslator(deps.translations ?? {}, settings.language),
+    options: settings.options
   };
 }
 async function runTool(spec, args, ctx, pin) {
@@ -26641,8 +26774,8 @@ function describeArguments(spec) {
   const { properties = {}, required: required2 = [] } = inputJsonSchema(spec);
   const lines = Object.entries(properties).map(([name, property]) => {
     const kind = required2.includes(name) ? typeName(property) : `${typeName(property)}, optional`;
-    const text = property.description?.replace(/\s+/g, " ").trim();
-    return `- ${name} (${kind})${text ? `: ${text}` : ""}`;
+    const text2 = property.description?.replace(/\s+/g, " ").trim();
+    return `- ${name} (${kind})${text2 ? `: ${text2}` : ""}`;
   });
   return lines.length > 0 ? `
 
@@ -26686,7 +26819,7 @@ function createV1Server(specs, deps = {}) {
 
 // src/opencode/skills.ts
 import { readFile, readdir as readdir3 } from "node:fs/promises";
-import { join as join11, resolve as resolve7 } from "node:path";
+import { join as join11, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var SKILL_FILE = "SKILL.md";
 var FRONTMATTER = /^---[ \t]*\r?\n([\s\S]*?\r?\n)?---[ \t]*(?:\r?\n|$)/;
@@ -26713,8 +26846,8 @@ function unquote(value) {
 function scalar(raw) {
   if (raw === "" || UNSUPPORTED_VALUE_START.test(raw)) return void 0;
   if (raw.startsWith('"') || raw.startsWith("'")) return unquote(raw);
-  const text = raw.replace(TRAILING_COMMENT, "").trim();
-  return text === "" ? void 0 : text;
+  const text2 = raw.replace(TRAILING_COMMENT, "").trim();
+  return text2 === "" ? void 0 : text2;
 }
 function readToolset(line, indent) {
   if (!line.startsWith(indent)) return void 0;
@@ -26749,8 +26882,8 @@ function readFrontmatter(block) {
   }
   return found;
 }
-function parseSkill(directory, text, path) {
-  const match = FRONTMATTER.exec(text);
+function parseSkill(directory, text2, path) {
+  const match = FRONTMATTER.exec(text2);
   const { name, description, toolset } = match ? readFrontmatter(match[1] ?? "") : {};
   const id = name ?? directory;
   return {
@@ -26759,7 +26892,7 @@ function parseSkill(directory, text, path) {
       name: id,
       ...description !== void 0 && { description },
       path,
-      content: match ? text.slice(match[0].length) : text
+      content: match ? text2.slice(match[0].length) : text2
     },
     ...toolset !== void 0 && { toolset }
   };
@@ -26777,7 +26910,7 @@ async function readSkillFile(path) {
   }
 }
 async function readSkills(dir) {
-  const root = resolve7(typeof dir === "string" ? dir : fileURLToPath2(dir));
+  const root = resolve5(typeof dir === "string" ? dir : fileURLToPath2(dir));
   let entries;
   try {
     entries = (await readdir3(root, { withFileTypes: true })).filter((entry2) => !entry2.isFile()).map((entry2) => entry2.name);
@@ -26788,9 +26921,9 @@ async function readSkills(dir) {
   const skills = /* @__PURE__ */ new Map();
   for (const directory of entries.sort()) {
     const path = join11(root, directory, SKILL_FILE);
-    const text = await readSkillFile(path);
-    if (text === void 0) continue;
-    const found = parseSkill(directory, text, path);
+    const text2 = await readSkillFile(path);
+    if (text2 === void 0) continue;
+    const found = parseSkill(directory, text2, path);
     if (!skills.has(found.skill.id)) skills.set(found.skill.id, found);
   }
   return [...skills.values()];