copilot-operator 0.1.0

package/dist/src/transport/chatSession.js

@@ -0,0 +1,73 @@
+/**
+ * Identifying the bot's chat across sessions.
+ *
+ * The bot must be able to find its own conversation again after the session expires and the
+ * user signs in a second time. Two handles are kept, because they fail differently:
+ *
+ *   conversation id   `/chat/conversation/<uuid>`. Exact, survives renames, and lets the
+ *                     bot navigate straight back. This is the primary handle.
+ *   chat name         Set by the bot right after the first message. Used when the id is
+ *                     missing or no longer opens, and it is what makes the run findable by
+ *                     a human scrolling the sidebar.
+ *
+ * The id alone is not enough: a person looking at a list of chats called "You are Operator,
+ * a Windows systems engineer worki" cannot tell which run is which. The name alone is not
+ * enough either, because names are not unique and the sidebar truncates.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+/** The UI rejects anything longer. Verified live: "Your Copilot chat name can't be longer than 50 characters". */
+export const MAX_CHAT_NAME = 50;
+export const CHAT_URL_RE = /\/chat\/conversation\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i;
+/**
+ * Builds the chat name. Shape:
+ *
+ *   op/<runId>/<label>
+ *
+ * The `op/` prefix makes every bot chat greppable in the sidebar and separates them from
+ * the user's own chats. The run id ties the chat to the transcript on disk. The label is
+ * whatever the run config calls the task.
+ *
+ * The whole thing is squeezed into 50 characters: the prefix and run id are kept intact
+ * because they are what makes the chat findable, and the label absorbs the truncation.
+ */
+export function buildChatName(runId, label) {
+    const prefix = `op/${runId}/`;
+    if (prefix.length >= MAX_CHAT_NAME) {
+        // Pathological run id. Keep the tail, which is the part that varies.
+        return `op/${runId}`.slice(0, MAX_CHAT_NAME);
+    }
+    const room = MAX_CHAT_NAME - prefix.length;
+    // Unicode-aware on purpose: `\w` is ASCII-only in JavaScript, so a Cyrillic label would
+    // be stripped down to a row of dashes.
+    const clean = label
+        .replace(/\s+/g, '-')
+        .replace(/[^\p{L}\p{N}._-]/gu, '')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, room);
+    return (prefix + clean).replace(/\/$/, '').slice(0, MAX_CHAT_NAME);
+}
+/** Compact run id, e.g. `20260917-1912`. Stable, sortable, short enough to fit the name. */
+export function makeRunId(now = new Date()) {
+    const p = (n) => String(n).padStart(2, '0');
+    return (`${now.getFullYear()}${p(now.getMonth() + 1)}${p(now.getDate())}` +
+        `-${p(now.getHours())}${p(now.getMinutes())}`);
+}
+export function parseChatId(url) {
+    return CHAT_URL_RE.exec(url)?.[1] ?? null;
+}
+export async function savePointer(path, pointer) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(pointer, null, 2), 'utf8');
+}
+export async function loadPointer(path) {
+    try {
+        const raw = await readFile(path, 'utf8');
+        const p = JSON.parse(raw);
+        return p.chatId && p.url ? p : null;
+    }
+    catch {
+        return null;
+    }
+}