@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/services/thread-context.js

@@ -0,0 +1,227 @@
+import { CliError } from "@wirecat/cli-base";
+import { isCliFailure } from "../cli/failures.js";
+import { RULES_VERSION } from "../conversations/link.js";
+import { formatLocator } from "../domain/locator.js";
+export const THREAD_BOUNDS = { maxHops: 8, maxMessages: 50, maxBytes: 65_536, withinMs: 86_400_000 };
+const bytes = (items, links) => Buffer.byteLength(JSON.stringify({ items, links }), "utf8");
+export const threadBounds = (options = {}) => {
+    const bounds = {
+        maxHops: options.maxHops ?? THREAD_BOUNDS.maxHops,
+        maxMessages: options.maxMessages ?? THREAD_BOUNDS.maxMessages,
+        maxBytes: options.maxBytes ?? THREAD_BOUNDS.maxBytes,
+        withinMs: options.withinMs ?? THREAD_BOUNDS.withinMs,
+    };
+    for (const [name, value, maximum] of [
+        ["maxHops", bounds.maxHops, 50],
+        ["maxMessages", bounds.maxMessages, 500],
+        ["maxBytes", bounds.maxBytes, 1_048_576],
+        ["withinMs", bounds.withinMs, 2_592_000_000],
+        ["before", options.before ?? 5, 100],
+        ["after", options.after ?? 5, 100],
+    ]) {
+        if (!Number.isSafeInteger(value) ||
+            value < (name === "maxHops" || name === "before" || name === "after" ? 0 : 1) ||
+            value > maximum)
+            throw new CliError("validation_error", `${name} is outside the thread context bounds (maximum ${maximum})`);
+    }
+    return bounds;
+};
+export const readThreadContext = async (store, account, chat, message, options = {}) => {
+    const bounds = threadBounds(options);
+    const result = {
+        locator: formatLocator({ ...account, chat, message }),
+        chat,
+        message,
+        mode: "thread",
+        items: [],
+        links: [],
+        chain: [],
+        stale: false,
+        builtAt: null,
+        stopped: [],
+        bounds,
+    };
+    const stopped = (reason) => {
+        if (!result.stopped.includes(reason))
+            result.stopped.push(reason);
+    };
+    if (options.signal?.aborted) {
+        stopped("aborted");
+        return result;
+    }
+    const around = (id, before = 0, after = 0) => store.around(account, chat, id, { before, after }).catch((error) => {
+        if (isCliFailure(error) && error.code === "not_found")
+            return [];
+        throw error;
+    });
+    const [anchor] = await around(message);
+    const state = await store.conversationState(account, chat);
+    result.builtAt = state?.builtAt ?? null;
+    const linked = anchor && state?.builtAt ? (await store.conversationOf(account, chat, message)) !== undefined : false;
+    const repliesTo = store.replies?.bind(store);
+    if (!anchor || !state?.builtAt || !repliesTo || !linked) {
+        result.mode = "time";
+        result.fallback = !anchor
+            ? "not_stored"
+            : !state?.builtAt
+                ? "not_built"
+                : !repliesTo
+                    ? "unsupported_store"
+                    : "not_linked";
+        result.stale = state?.builtAt !== undefined && state?.builtAt !== null && !linked;
+        const wantedBefore = options.before ?? 5;
+        const wantedAfter = options.after ?? 5;
+        const available = bounds.maxMessages - 1;
+        let before = Math.min(wantedBefore, Math.ceil(available / 2));
+        const after = Math.min(wantedAfter, available - before);
+        before = Math.min(wantedBefore, available - after);
+        if (anchor && before + after < wantedBefore + wantedAfter)
+            stopped("messages");
+        const neighbours = anchor ? await around(message, before, after) : [];
+        // Keep the hit when the byte/message cap cannot fit its neighbours.
+        const nearest = neighbours.sort((a, b) => Number(a.id !== message) - Number(b.id !== message) ||
+            Math.abs(Date.parse(a.timestamp) - Date.parse(anchor?.timestamp ?? "")) -
+                Math.abs(Date.parse(b.timestamp) - Date.parse(anchor?.timestamp ?? "")));
+        for (const item of nearest) {
+            if (item.threadId !== anchor?.threadId) {
+                stopped("thread");
+                continue;
+            }
+            if (result.items.length >= bounds.maxMessages) {
+                stopped("messages");
+                break;
+            }
+            if (Math.abs(Date.parse(item.timestamp) - Date.parse(anchor?.timestamp ?? "")) > bounds.withinMs) {
+                stopped("time");
+                continue;
+            }
+            if (bytes([...result.items, item], []) > bounds.maxBytes) {
+                stopped("bytes");
+                break;
+            }
+            result.items.push(item);
+        }
+        result.items.sort((a, b) => a.timestamp.localeCompare(b.timestamp) || a.id.localeCompare(b.id));
+        return result;
+    }
+    result.stale = state.algorithmVersion !== RULES_VERSION;
+    const at = Date.parse(anchor.timestamp);
+    const cache = new Map();
+    const linksOf = async (id) => {
+        if (!cache.has(id)) {
+            const rows = await store.links(account, chat, id, { limit: bounds.maxMessages + 1 });
+            if (rows.length > bounds.maxMessages)
+                stopped("links");
+            cache.set(id, rows.slice(0, bounds.maxMessages).map((link) => ({
+                ...link,
+                stale: link.stale || (link.source !== "agent" && state.algorithmVersion !== RULES_VERSION),
+            })));
+        }
+        return cache.get(id);
+    };
+    const chosen = (links) => links.find((link) => !link.stale);
+    const queue = [{ id: message, hops: 0 }];
+    const queued = new Set([message]);
+    const parents = new Map();
+    for (let index = 0; index < queue.length; index++) {
+        if (options.signal?.aborted) {
+            stopped("aborted");
+            break;
+        }
+        const node = queue[index];
+        const [item] = node.id === message ? [anchor] : await around(node.id);
+        if (!item) {
+            result.stale = true;
+            continue;
+        }
+        if (Math.abs(Date.parse(item.timestamp) - at) > bounds.withinMs) {
+            stopped("time");
+            continue;
+        }
+        if (item.threadId !== anchor.threadId) {
+            stopped("thread");
+            continue;
+        }
+        if (result.items.length >= bounds.maxMessages) {
+            stopped("messages");
+            break;
+        }
+        const { anchor: _anchor, ...body } = item;
+        const displayed = node.id === message ? { ...body, anchor: true } : body;
+        const own = await linksOf(node.id);
+        const parent = chosen(own);
+        const evidence = own
+            .filter((link) => link === parent || link.stale)
+            .map((link) => ({ ...link, messageId: node.id, chosen: link === parent }))
+            .filter((link) => !result.links.some((old) => old.messageId === link.messageId &&
+            old.parentId === link.parentId &&
+            old.source === link.source &&
+            old.kind === link.kind &&
+            old.method === link.method));
+        result.stale ||= evidence.some((link) => link.stale);
+        if (bytes([...result.items, displayed], [...result.links, ...evidence]) > bounds.maxBytes) {
+            stopped("bytes");
+            break;
+        }
+        result.items.push(displayed);
+        result.links.push(...evidence);
+        if (parent?.parentId)
+            parents.set(node.id, parent.parentId);
+        const add = (id) => {
+            if (queued.has(id))
+                return;
+            if (node.hops >= bounds.maxHops) {
+                stopped("hops");
+                return;
+            }
+            if (queued.size >= bounds.maxMessages) {
+                stopped("messages");
+                return;
+            }
+            queued.add(id);
+            queue.push({ id, hops: node.hops + 1, previous: node.id });
+        };
+        if (parent?.parentId && parent.parentId !== node.previous)
+            add(parent.parentId);
+        const replies = await repliesTo(account, chat, node.id, Math.max(1, bounds.maxMessages - cache.size));
+        if (replies.hasMore)
+            stopped("messages");
+        for (const child of replies.items) {
+            if (cache.size >= bounds.maxMessages && !cache.has(child.messageId)) {
+                stopped("links");
+                break;
+            }
+            const childLinks = await linksOf(child.messageId);
+            if (chosen(childLinks)?.parentId === node.id)
+                add(child.messageId);
+            else if (childLinks.some((link) => link.stale && link.parentId === node.id)) {
+                result.stale = true;
+                const stale = childLinks
+                    .filter((link) => link.stale && link.parentId === node.id)
+                    .map((link) => ({ ...link, messageId: child.messageId, chosen: false }))
+                    .filter((link) => !result.links.some((old) => old.messageId === link.messageId &&
+                    old.parentId === link.parentId &&
+                    old.source === link.source &&
+                    old.kind === link.kind &&
+                    old.method === link.method));
+                if (bytes(result.items, [...result.links, ...stale]) <= bounds.maxBytes)
+                    result.links.push(...stale);
+                else
+                    stopped("bytes");
+            }
+        }
+    }
+    const held = new Set(result.items.map(({ id }) => id));
+    const seen = new Set([message]);
+    for (let parent = parents.get(message); parent !== undefined && held.has(parent); parent = parents.get(parent)) {
+        if (seen.has(parent)) {
+            stopped("cycle");
+            break;
+        }
+        seen.add(parent);
+        result.chain.push(parent);
+    }
+    result.items.sort((a, b) => a.timestamp.localeCompare(b.timestamp) || a.id.localeCompare(b.id));
+    return result;
+};
+//# sourceMappingURL=thread-context.js.map

package/dist/services/thread-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-context.js","sourceRoot":"","sources":["../../src/services/thread-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIpD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;AAwBpG,MAAM,KAAK,GAAG,CAAC,KAA6B,EAAE,KAA6B,EAAE,EAAE,CAC7E,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;AAE7D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,GAAkB,EAAE,EAAwB,EAAE;IAChF,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO;QACjD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,aAAa,CAAC,WAAW;QAC7D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ;QACpD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ;KACrD,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI;QACnC,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC;QACxC,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;QACxC,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;QAC5C,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,GAAG,CAAC;QACpC,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,GAAG,CAAC;KAC1B,EAAE,CAAC;QACX,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;YAC5B,KAAK,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7E,KAAK,GAAG,OAAO;YAEf,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,IAAI,kDAAkD,OAAO,GAAG,CAAC,CAAA;IAC/G,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,KAAmB,EACnB,OAAmB,EACnB,IAAQ,EACR,OAAW,EACX,OAAO,GAAkB,EAAE,EACH,EAAE;IAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,MAAM,GAAkB;QAC5B,OAAO,EAAE,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACrD,IAAI;QACJ,OAAO;QACP,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,EAAE;QACX,MAAM;KACP,CAAA;IACD,MAAM,OAAO,GAAG,CAAC,MAAwC,EAAE,EAAE;QAC3D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACnE,CAAC,CAAA;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,CAAC,SAAS,CAAC,CAAA;QAClB,OAAO,MAAM,CAAA;IACf,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,EAAM,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CAC/C,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC1E,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,EAAE,CAAA;QAChE,MAAM,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;IACJ,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAC1D,MAAM,CAAC,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,IAAI,CAAA;IACvC,MAAM,MAAM,GAAG,MAAM,IAAI,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;IACpH,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5C,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,GAAG,MAAM,CAAA;QACpB,MAAM,CAAC,QAAQ,GAAG,CAAC,MAAM;YACvB,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO;gBACf,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,CAAC,SAAS;oBACV,CAAC,CAAC,mBAAmB;oBACrB,CAAC,CAAC,YAAY,CAAA;QACpB,MAAM,CAAC,KAAK,GAAG,KAAK,EAAE,OAAO,KAAK,SAAS,IAAI,KAAK,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,MAAM,CAAA;QACjF,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;QACxC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAA;QACtC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,CAAA;QACxC,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAA;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,CAAA;QACvD,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,CAAC,CAAA;QAClD,IAAI,MAAM,IAAI,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,WAAW;YAAE,OAAO,CAAC,UAAU,CAAC,CAAA;QAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACrE,oEAAoE;QACpE,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC;YACnD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;gBACrE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAC5E,CAAA;QACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACvC,OAAO,CAAC,QAAQ,CAAC,CAAA;gBACjB,SAAQ;YACV,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC9C,OAAO,CAAC,UAAU,CAAC,CAAA;gBACnB,MAAK;YACP,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACjG,OAAO,CAAC,MAAM,CAAC,CAAA;gBACf,SAAQ;YACV,CAAC;YACD,IAAI,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACzD,OAAO,CAAC,OAAO,CAAC,CAAA;gBAChB,MAAK;YACP,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC/F,OAAO,MAAM,CAAA;IACf,CAAC;IACD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,gBAAgB,KAAK,aAAa,CAAA;IACvD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACvC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IACzC,MAAM,OAAO,GAAG,KAAK,EAAE,EAAM,EAAE,EAAE;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC,CAAA;YACpF,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW;gBAAE,OAAO,CAAC,OAAO,CAAC,CAAA;YACtD,KAAK,CAAC,GAAG,CACP,EAAE,EACF,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC/C,GAAG,IAAI;gBACP,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,gBAAgB,KAAK,aAAa,CAAC;aAC3F,CAAC,CAAC,CACJ,CAAA;QACH,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAiB,CAAA;IACtC,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,CAAC,KAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzE,MAAM,KAAK,GAA8C,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;IACnF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,SAAS,CAAC,CAAA;YAClB,MAAK;QACP,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAA2B,CAAA;QACnD,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACrE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,GAAG,IAAI,CAAA;YACnB,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChE,OAAO,CAAC,MAAM,CAAC,CAAA;YACf,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACjB,SAAQ;QACV,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,CAAC,UAAU,CAAC,CAAA;YACnB,MAAK;QACP,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;QACzC,MAAM,SAAS,GAAoB,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;QACzF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QAC1B,MAAM,QAAQ,GAAG,GAAG;aACjB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC;aAC/C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;aACzE,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAChB,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;YAChC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAC9B,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAC1B,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;YACtB,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAC7B,CACJ,CAAA;QACH,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACpD,IAAI,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1F,OAAO,CAAC,OAAO,CAAC,CAAA;YAChB,MAAK;QACP,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC5B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA;QAC9B,IAAI,MAAM,EAAE,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC3D,MAAM,GAAG,GAAG,CAAC,EAAM,EAAE,EAAE;YACrB,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAM;YAC1B,IAAI,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAChC,OAAO,CAAC,MAAM,CAAC,CAAA;gBACf,OAAM;YACR,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACtC,OAAO,CAAC,UAAU,CAAC,CAAA;gBACnB,OAAM;YACR,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACd,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QAC5D,CAAC,CAAA;QACD,IAAI,MAAM,EAAE,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC/E,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QACrG,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,CAAC,UAAU,CAAC,CAAA;QACxC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpE,OAAO,CAAC,OAAO,CAAC,CAAA;gBAChB,MAAK;YACP,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YACjD,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC,EAAE;gBAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;iBAC7D,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5E,MAAM,CAAC,KAAK,GAAG,IAAI,CAAA;gBACnB,MAAM,KAAK,GAAG,UAAU;qBACrB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,EAAE,CAAC;qBACzD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;qBACvE,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAChB,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;oBAChC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;oBAC9B,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;oBAC1B,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;oBACtB,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAC7B,CACJ,CAAA;gBACH,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ;oBAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;;oBAC/F,OAAO,CAAC,OAAO,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IACnC,KAAK,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/G,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,OAAO,CAAC,CAAA;YAChB,MAAK;QACP,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAChB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/F,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/services/topics.d.ts

@@ -0,0 +1,36 @@
+import type { Chat, Topic, TopicChange } from "../domain/models.js";
+import { type Operated } from "../sends/guarded.js";
+import type { ServiceDeps } from "./deps.js";
+export interface TopicsService {
+    show(chat: string, topic: string): Promise<Topic>;
+    enable(chat: string, options: {
+        upgrade: boolean;
+    }): Promise<Operated<{
+        previousChatId: string;
+        chat: Chat;
+        upgraded: boolean;
+        forum: true;
+    }>>;
+    create(chat: string, title: string, options: {
+        sendId?: string;
+    }): Promise<Operated<{
+        chatId: string;
+        topic: Topic;
+        sendId: string;
+    }>>;
+    edit(chat: string, topic: string, change: TopicChange): Promise<Operated<{
+        chatId: string;
+        topic: Topic;
+    }>>;
+    order(chat: string, topics: string[]): Promise<Operated<{
+        chatId: string;
+        order: string[];
+    }>>;
+    /** Every message in it goes too, for everyone; asks first by default (`topics.delete` is `ask`). */
+    delete(chat: string, topic: string): Promise<Operated<{
+        chatId: string;
+        topicId: string;
+    }>>;
+}
+export declare const topicsService: (deps: ServiceDeps) => TopicsService;
+//# sourceMappingURL=topics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../../src/services/topics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,QAAQ,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC,CAAA;IAC5F,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IACtE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC,CAAA;IAC3G,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC,CAAA;IAC7F,oGAAoG;IACpG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;CAC5F;AAeD,eAAO,MAAM,aAAa,SAAU,WAAW,KAAG,aA6MjD,CAAA"}

package/dist/services/topics.js

@@ -0,0 +1,189 @@
+import { CliError, isCliError } from "@wirecat/cli-base";
+import { capability } from "../cli/messenger/port.js";
+import { guardedWrite } from "../sends/guarded.js";
+import { newOperationId, newSendId } from "../sends/send-id.js";
+const actionOf = ({ title, closed, pinned, hidden }) => {
+    const set = [closed, pinned, hidden].filter((one) => one !== undefined).length;
+    if (title !== undefined || set !== 1)
+        return "topic-edit";
+    if (closed !== undefined)
+        return closed ? "topic-close" : "topic-reopen";
+    if (pinned !== undefined)
+        return pinned ? "topic-pin" : "topic-unpin";
+    return hidden ? "topic-hide" : "topic-unhide";
+};
+const validTitle = (title) => {
+    if (title.trim() === "" || new TextEncoder().encode(title).byteLength > 128)
+        throw new CliError("validation_error", "a topic title needs 1–128 UTF-8 bytes");
+};
+export const topicsService = (deps) => {
+    const online = async () => {
+        if (deps.offline)
+            throw new CliError("validation_error", "changing topics requires the messenger; not with --offline");
+        return deps.connection();
+    };
+    return {
+        show: async (chat, topic) => {
+            if (deps.offline)
+                throw new CliError("validation_error", "`topics show` asks the messenger; not with --offline");
+            const id = topic.trim();
+            if (id === "")
+                throw new CliError("validation_error", "which topic? give its id, from `topics list`");
+            return capability(await deps.connection(), "topic", "show a forum topic")(chat, id);
+        },
+        enable: async (chat, { upgrade }) => {
+            const connection = await online();
+            const probe = capability(connection, "forumState", "configure forum topics");
+            const enable = capability(connection, "enableForum", "enable forum topics");
+            const previousChatId = (await connection.resolve(chat)).id;
+            const operationId = newOperationId();
+            let prepared;
+            const attempt = {
+                operationId: `${operationId}:configure`,
+                parentOperationId: operationId,
+                chatId: previousChatId,
+                kind: "chat",
+                action: "forum-enable",
+                key: "topics.enable",
+            };
+            const validate = async (chatId) => {
+                const state = await probe(chatId);
+                if (!state.owner)
+                    throw new CliError("permission_error", "only the group owner can enable forum topics");
+                if (state.linkedDiscussion)
+                    throw new CliError("validation_error", "a linked discussion group cannot enable forum topics");
+                if (state.needsUpgrade && !upgrade)
+                    throw new CliError("validation_error", "this basic group needs --upgrade to become a supergroup; its chat id will change");
+                return state;
+            };
+            const first = await guardedWrite(deps.guard, attempt, async () => {
+                if (!prepared)
+                    throw new CliError("invalid_response", "the forum preflight did not finish");
+                if (prepared.needsUpgrade)
+                    return capability(connection, "upgradeForum", "upgrade a basic group")(prepared.chat.id);
+                return prepared.forum ? prepared : enable(prepared.chat.id);
+            }, (done) => ({ resultChatId: done.chat.id }), async () => {
+                prepared = await validate(previousChatId);
+                if (prepared.chat.id !== previousChatId)
+                    deps.guard.check({ ...attempt, chatId: prepared.chat.id }, { reserve: false });
+                attempt.chatId = prepared.chat.id;
+                attempt.action = prepared.needsUpgrade ? "forum-upgrade" : "forum-enable";
+            });
+            let current = first;
+            if (!current.forum && prepared?.needsUpgrade) {
+                try {
+                    current = await guardedWrite(deps.guard, {
+                        operationId: `${operationId}:enable`,
+                        parentOperationId: operationId,
+                        chatId: current.chat.id,
+                        kind: "chat",
+                        action: "forum-enable",
+                        key: "topics.enable",
+                    }, () => enable(first.chat.id), (done) => ({ resultChatId: done.chat.id }), async () => {
+                        await validate(first.chat.id);
+                    });
+                }
+                catch (error) {
+                    throw new CliError(isCliError(error) ? error.code : "provider_error", "the group was upgraded but enabling topics did not finish; check the new chat before repeating", {
+                        ...(isCliError(error) ? error.details : {}),
+                        operation_id: operationId,
+                        previous_chat_id: previousChatId,
+                        chat_id: first.chat.id,
+                        upgraded: first.chat.id !== previousChatId,
+                        forum: null,
+                        stage: "enable",
+                    });
+                }
+            }
+            if (!current.forum)
+                throw new CliError("invalid_response", "Telegram did not confirm that topics were enabled", {
+                    operation_id: operationId,
+                    chat_id: current.chat.id,
+                });
+            return {
+                operationId,
+                previousChatId,
+                chat: current.chat,
+                upgraded: current.chat.id !== previousChatId,
+                forum: true,
+            };
+        },
+        create: async (chat, title, { sendId }) => {
+            validTitle(title);
+            const connection = await online();
+            const create = capability(connection, "createTopic", "create forum topics");
+            const probe = capability(connection, "forumState", "read forum settings");
+            const chatId = (await connection.resolve(chat)).id;
+            const id = sendId ?? connection.newSendId?.() ?? newSendId();
+            let target = chatId;
+            const topic = await guardedWrite(deps.guard, {
+                operationId: id,
+                sendId: id,
+                chatId,
+                kind: "chat",
+                action: "topic-create",
+                key: "topics.create",
+                length: title.length,
+            }, () => create(target, title, { sendId: id }), (done) => ({ threadId: done.id, resultChatId: target }), async () => {
+                const state = await probe(chatId);
+                if (!state.forum)
+                    throw new CliError("validation_error", "enable topics first with `topics enable`; creating a topic never upgrades a group");
+                if (!state.canCreate)
+                    throw new CliError("permission_error", "creating a topic requires manage-topics permission");
+                target = state.chat.id;
+                if (target !== chatId)
+                    deps.guard.check({ chatId: target, kind: "chat", key: "topics.create" }, { reserve: false });
+            });
+            return { operationId: id, sendId: id, chatId: target, topic };
+        },
+        edit: async (chat, typedTopic, change) => {
+            const { title, closed, pinned, hidden } = change;
+            if (title === undefined && closed === undefined && pinned === undefined && hidden === undefined)
+                throw new CliError("validation_error", "nothing to change — rename, close, reopen, pin, unpin or hide it");
+            if (title !== undefined)
+                validTitle(title);
+            const topicId = typedTopic.trim();
+            if (topicId === "")
+                throw new CliError("validation_error", "which topic? give its id from `topics list`");
+            const connection = await online();
+            const editTopic = capability(connection, "editTopic", "edit forum topics");
+            const chatId = (await connection.resolve(chat)).id;
+            const operationId = newOperationId();
+            const action = actionOf(change);
+            const topic = await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action, key: "topics.edit", threadId: topicId }, () => editTopic(chatId, topicId, {
+                ...(title === undefined ? {} : { title }),
+                ...(closed === undefined ? {} : { closed }),
+                ...(pinned === undefined ? {} : { pinned }),
+                ...(hidden === undefined ? {} : { hidden }),
+            }));
+            return { operationId, chatId, topic };
+        },
+        delete: async (chat, typedTopic) => {
+            const topicId = typedTopic.trim();
+            if (topicId === "")
+                throw new CliError("validation_error", "which topic? give its id from `topics list`");
+            if (topicId === "1")
+                throw new CliError("validation_error", "the General topic cannot be deleted; `topics edit --hidden on` hides it");
+            const connection = await online();
+            const remove = capability(connection, "deleteTopic", "delete forum topics");
+            const chatId = (await connection.resolve(chat)).id;
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "topic-delete", key: "topics.delete", threadId: topicId }, () => remove(chatId, topicId));
+            return { operationId, chatId, topicId };
+        },
+        order: async (chat, typed) => {
+            const order = typed.map((one) => one.trim());
+            if (order.length === 0 || order.includes(""))
+                throw new CliError("validation_error", "which topics? give the pinned topics' ids in the order wanted");
+            if (new Set(order).size !== order.length)
+                throw new CliError("validation_error", "a topic is named twice; give each one once");
+            const connection = await online();
+            const reorder = capability(connection, "orderPinnedTopics", "order pinned forum topics");
+            const chatId = (await connection.resolve(chat)).id;
+            const operationId = newOperationId();
+            await guardedWrite(deps.guard, { operationId, chatId, kind: "chat", action: "topic-order", key: "topics.edit" }, () => reorder(chatId, order));
+            return { operationId, chatId, order };
+        },
+    };
+};
+//# sourceMappingURL=topics.js.map

package/dist/services/topics.js.map

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

package/dist/skills/validate.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+export interface SkillValidation {
+    folder?: string;
+    file?: string;
+    version?: string;
+    program?: Command;
+}
+export declare const validateSkill: (content: string, options?: SkillValidation) => string[];
+//# sourceMappingURL=validate.d.ts.map

package/dist/skills/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/skills/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,eAAO,MAAM,aAAa,YAAa,MAAM,YAAW,eAAe,KAAQ,MAAM,EA+EpF,CAAA"}

package/dist/skills/validate.js

@@ -0,0 +1,86 @@
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { parseDocument } from "yaml";
+export const validateSkill = (content, options = {}) => {
+    const problems = [];
+    const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(content);
+    if (!match)
+        return ["SKILL.md needs YAML frontmatter"];
+    const yaml = parseDocument(match[1] ?? "", { uniqueKeys: true });
+    if (yaml.errors.length)
+        return ["SKILL.md frontmatter is not valid YAML"];
+    let data;
+    try {
+        data = yaml.toJS({ maxAliasCount: 0 });
+    }
+    catch {
+        return ["SKILL.md frontmatter cannot be read"];
+    }
+    if (!data || typeof data !== "object" || Array.isArray(data))
+        return ["SKILL.md frontmatter must be an object"];
+    const fields = data;
+    if (typeof fields.name !== "string" || fields.name.length > 64 || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(fields.name))
+        problems.push("skill name must be 1–64 lowercase letters, digits and single hyphens");
+    if (options.folder && fields.name !== options.folder)
+        problems.push("skill name must match its folder");
+    if (typeof fields.description !== "string" || !fields.description.trim() || fields.description.length > 1024)
+        problems.push("skill description must be 1–1024 characters");
+    if (fields.compatibility !== undefined &&
+        (typeof fields.compatibility !== "string" || fields.compatibility.length > 500))
+        problems.push("skill compatibility must be a string of at most 500 characters");
+    for (const key of ["license", "allowed-tools"])
+        if (fields[key] !== undefined && typeof fields[key] !== "string")
+            problems.push(`skill ${key} must be a string`);
+    const known = new Set(["name", "description", "license", "compatibility", "allowed-tools", "metadata"]);
+    for (const key of Object.keys(fields))
+        if (!known.has(key))
+            problems.push(`unsupported frontmatter field: ${key}`);
+    if (fields.metadata !== undefined &&
+        (!fields.metadata ||
+            typeof fields.metadata !== "object" ||
+            Array.isArray(fields.metadata) ||
+            Object.values(fields.metadata).some((value) => typeof value !== "string")))
+        problems.push("skill metadata must contain string values");
+    if (options.version && fields.metadata?.version !== options.version)
+        problems.push("emitted skill version must match the binary");
+    const body = content.slice(match[0].length);
+    if (options.file) {
+        for (const link of body.matchAll(/\[[^\]]*\]\(([^\s)]+)\)/g)) {
+            const target = (link[1] ?? "").split("#")[0] ?? "";
+            if (!target || /^(?:[a-z]+:|\/)/i.test(target))
+                continue;
+            if (!existsSync(resolve(dirname(options.file), target)))
+                problems.push(`missing skill reference: ${target}`);
+        }
+    }
+    if (options.program) {
+        const root = options.program;
+        const spans = [...body.matchAll(/```[^\n]*\n([\s\S]*?)```|`([^`\n]*(?:\n[^`\n]*)?)`/g)];
+        for (const span of spans) {
+            const text = span[1] ?? span[2] ?? "";
+            const escaped = root.name().replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            for (const call of text.matchAll(new RegExp(`(?:^|[\\s;])(?:${escaped}|\\{\\{command\\}\\})\\s+([^\\n;]+)`, "g"))) {
+                const tokens = (call[1] ?? "").trim().split(/\s+/);
+                let at = root;
+                let start = 0;
+                if (!root.commands.some((child) => child.name() === tokens[0]) &&
+                    root.commands.some((child) => child.name() === tokens[1]))
+                    start = 1;
+                for (const word of tokens.slice(start)) {
+                    if (!/^[a-z][a-z-]*$/.test(word))
+                        break;
+                    const child = at.commands.find((one) => one.name() === word || one.aliases().includes(word));
+                    if (child) {
+                        at = child;
+                        continue;
+                    }
+                    if ((at.registeredArguments.length === 0 && at.commands.length > 0) || at === root)
+                        problems.push(`unknown skill command path: ${[root.name(), ...tokens.slice(start)].join(" ")}`);
+                    break;
+                }
+            }
+        }
+    }
+    return [...new Set(problems)];
+};
+//# sourceMappingURL=validate.js.map

package/dist/skills/validate.js.map

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