refactor: share queue helpers

Co-authored-by: adam91holt <adam91holt@users.noreply.github.com>

src/utils/queue-helpers.ts

@@ -0,0 +1,94 @@
+export type QueueSummaryState = {
+  dropPolicy: "summarize" | "old" | "new";
+  droppedCount: number;
+  summaryLines: string[];
+};
+
+export function elideQueueText(text: string, limit = 140): string {
+  if (text.length <= limit) return text;
+  return `${text.slice(0, Math.max(0, limit - 1)).trimEnd()}…`;
+}
+
+export function buildQueueSummaryLine(text: string, limit = 160): string {
+  const cleaned = text.replace(/\s+/g, " ").trim();
+  return elideQueueText(cleaned, limit);
+}
+
+export function waitForQueueDebounce(queue: {
+  debounceMs: number;
+  lastEnqueuedAt: number;
+}): Promise<void> {
+  const debounceMs = Math.max(0, queue.debounceMs);
+  if (debounceMs <= 0) return Promise.resolve();
+  return new Promise<void>((resolve) => {
+    const check = () => {
+      const since = Date.now() - queue.lastEnqueuedAt;
+      if (since >= debounceMs) {
+        resolve();
+        return;
+      }
+      setTimeout(check, debounceMs - since);
+    };
+    check();
+  });
+}
+
+export function buildQueueSummaryPrompt(params: {
+  state: QueueSummaryState;
+  noun: string;
+  title?: string;
+}): string | undefined {
+  if (params.state.dropPolicy !== "summarize" || params.state.droppedCount <= 0) {
+    return undefined;
+  }
+  const noun = params.noun;
+  const title =
+    params.title ??
+    `[Queue overflow] Dropped ${params.state.droppedCount} ${noun}${params.state.droppedCount === 1 ? "" : "s"} due to cap.`;
+  const lines = [title];
+  if (params.state.summaryLines.length > 0) {
+    lines.push("Summary:");
+    for (const line of params.state.summaryLines) {
+      lines.push(`- ${line}`);
+    }
+  }
+  params.state.droppedCount = 0;
+  params.state.summaryLines = [];
+  return lines.join("\n");
+}
+
+export function buildCollectPrompt<T>(params: {
+  title: string;
+  items: T[];
+  summary?: string;
+  renderItem: (item: T, index: number) => string;
+}): string {
+  const blocks: string[] = [params.title];
+  if (params.summary) blocks.push(params.summary);
+  params.items.forEach((item, idx) => {
+    blocks.push(params.renderItem(item, idx));
+  });
+  return blocks.join("\n\n");
+}
+
+export function hasCrossChannelItems<T>(
+  items: T[],
+  resolveKey: (item: T) => { key?: string; cross?: boolean },
+): boolean {
+  const keys = new Set<string>();
+  let hasUnkeyed = false;
+
+  for (const item of items) {
+    const resolved = resolveKey(item);
+    if (resolved.cross) return true;
+    if (!resolved.key) {
+      hasUnkeyed = true;
+      continue;
+    }
+    keys.add(resolved.key);
+  }
+
+  if (keys.size === 0) return false;
+  if (hasUnkeyed) return true;
+  return keys.size > 1;
+}