@cueloop/client 0.1.0-alpha.102 → 0.1.0-alpha.104

package/src/diff/split-diff.ts

@@ -84,6 +84,7 @@ export function splitDiffRows(rows: DiffRow[]): SplitRow[] {
 
   const flushChangeBlock = (): void => {
     if (pendingDeletions.length === 0 && pendingAdditions.length === 0) return;
+
     split.push(...zipChangeBlock(pendingDeletions, pendingAdditions, blockFile));
     pendingDeletions = [];
     pendingAdditions = [];
@@ -96,14 +97,17 @@ export function splitDiffRows(rows: DiffRow[]): SplitRow[] {
 
       return;
     }
+
     if (row.kind === "del") {
       blockFile = row.file;
       pendingDeletions.push({ row, index });
 
       return;
     }
+
     // any non-change row closes the current change block before it renders
     flushChangeBlock();
+
     if (row.kind === "file" || row.kind === "hunk") {
       split.push({ kind: row.kind, file: row.file, text: row.text, rowIndex: index });
     } else
@@ -135,7 +139,9 @@ export function splitRowOffsets(splitRows: SplitRow[]): Map<number, number> {
       contentY += 1;
     } else {
       if (row.left) offsets.set(row.left.rowIndex, contentY);
+
       if (row.right) offsets.set(row.right.rowIndex, contentY);
+
       contentY += 1;
     }
   }

package/src/diff/view-diff.ts

@@ -92,10 +92,12 @@ export function fileChangeCounts(
 
   for (const row of rows) {
     if (row.kind !== "add" && row.kind !== "del") continue;
+
     const entry = counts.get(row.file) ?? { additions: 0, deletions: 0 };
 
     if (row.kind === "add") entry.additions += 1;
     else entry.deletions += 1;
+
     counts.set(row.file, entry);
   }
 
@@ -143,9 +145,11 @@ export function marksByRows(
   for (const annotation of annotations) {
     // an addressed annotation keeps its record but paints no highlight
     if (isAddressed(annotation)) continue;
+
     const resolved = resolveAnchor(annotation.anchor, blocks);
 
     if (!resolved) continue;
+
     const span: TextSpan = {
       start: { blockIndex: resolved.blockIndex, char: resolved.start },
       end: { blockIndex: resolved.endBlockIndex, char: resolved.end },
@@ -156,6 +160,7 @@ export function marksByRows(
       const range = spanRangeInBlock(span, rowIndex, blocks[rowIndex]!.text.length);
 
       if (!range) continue;
+
       const marks = marksByIndex.get(rowIndex) ?? [];
 
       marks.push({
@@ -205,6 +210,7 @@ function addResolvedMark(
       blocks[rowIndex]!.text.length === 0;
 
     if (!range && !marksEmptyLine) continue;
+
     const marks = marksByIndex.get(rowIndex) ?? [];
 
     marks.push({
@@ -228,12 +234,14 @@ function addReviewFindingMark(
   const finding = annotation.reviewComment;
 
   if (!finding || isAddressed(annotation)) return false;
+
   const end = resolveReviewAnchorRow(rows, annotation.anchor, finding.path, finding.side);
   const start = finding.startAnchor
     ? resolveReviewAnchorRow(rows, finding.startAnchor, finding.path, finding.side)
     : end;
 
   if (!start || !end || start.rowIndex > end.rowIndex) return false;
+
   addResolvedMark(marksByIndex, annotation, blocks, start.rowIndex, end.rowIndex, focusedId);
 
   return true;
@@ -261,6 +269,7 @@ export function fileRowRange(rows: DiffRow[], path: string): { start: number; en
   const start = rows.findIndex((row) => row.file === path);
 
   if (start === -1) return null;
+
   let end = start;
 
   while (end < rows.length && rows[end]!.file === path) end++;
@@ -284,6 +293,7 @@ export function fileTargetMarks(
     const target = annotationTarget(annotation);
 
     if (target.kind !== "file") continue;
+
     const forPath = byFile.get(target.path) ?? [];
 
     forPath.push(annotation);
@@ -295,6 +305,7 @@ export function fileTargetMarks(
     const range = fileRowRange(rows, path);
 
     if (!range) continue;
+
     const base = range.start;
     const fileRows = rows.slice(range.start, range.end);
     const reviewRootIds = new Set(
@@ -319,10 +330,12 @@ export function fileTargetMarks(
       const finding = annotation.reviewComment;
 
       if (!finding || isAddressed(annotation)) continue;
+
       if (addReviewFindingMark(fileMarks, annotation, fileRows, blocks, focusedId)) {
         resolvedIds.add(annotation.id);
         continue;
       }
+
       const relativeRow = fileRows.findIndex(
         (row) =>
           (finding.side === "RIGHT" ? row.newLine : row.oldLine) === finding.line &&
@@ -349,11 +362,13 @@ export function fileTargetMarks(
     for (const annotation of fileAnnotations) {
       if (!annotation.replyTo || resolvedIds.has(annotation.id) || isAddressed(annotation))
         continue;
+
       const parent = [...fileMarks.entries()].find(([, marks]) =>
         marks.some((mark) => mark.annotationId === annotation.replyTo),
       );
 
       if (!parent) continue;
+
       const [fallbackRow, parentMarks] = parent;
       const parentMark = parentMarks.find((mark) => mark.annotationId === annotation.replyTo)!;
       const replyMark: Mark = {
@@ -448,6 +463,7 @@ export function commentCountsByFile(session: Thread, rows: DiffRow[]): Map<strin
     const file = rows[discussion.blockIndex]?.file;
 
     if (file === undefined) continue;
+
     counts.set(file, (counts.get(file) ?? 0) + discussion.annotations.length);
   }
 
@@ -496,6 +512,7 @@ export function resolveReviewAnchorRow(
       (side === "RIGHT" ? row.newLine === undefined : row.oldLine === undefined)
     )
       return [];
+
     const context = diffRowAnchorContext(rows, rowIndex);
 
     return [
@@ -508,6 +525,7 @@ export function resolveReviewAnchorRow(
   });
 
   if (candidates.length === 0) return undefined;
+
   const bestScore = Math.max(...candidates.map((candidate) => candidate.score));
   const best = candidates.filter((candidate) => candidate.score === bestScore);
 

package/src/diff/walk.ts

@@ -32,9 +32,12 @@ export function walkFiles(rows: DiffRow[]): WalkFile[] {
       byPath.set(row.file, file);
       files.push(file);
     }
+
     if (row.kind !== "add" && row.kind !== "del") continue;
+
     if (row.kind === "add") file.added += 1;
     else file.removed += 1;
+
     if (file.preview.length < WALK_PREVIEW_ROWS) {
       file.preview.push({
         sign: row.kind === "add" ? "+" : "-",

package/src/index.ts

@@ -23,6 +23,7 @@ export {
   collaboratorAnnotations,
   mergeFromShare,
   publishShare,
+  snapshotThreadConversation,
   pullShare,
   pushShare,
   shareIdFromLine,

package/src/integrations/attribution.ts

@@ -33,9 +33,11 @@ export function resolveDisplayName(
   const override = overrides[authorId];
 
   if (override) return override;
+
   const identity = participants?.find((participant) => participant.id === authorId);
 
   if (identity?.name) return identity.name;
+
   if (identity) return ANONYMOUS_LABEL;
 
   return shortHandle(authorId);

package/src/integrations/client-extension-registry.ts

@@ -65,12 +65,15 @@ export class ClientExtensionRegistry {
   ): ExtensionUIDisposable {
     if (!/^[a-z][a-z0-9-]*$/.test(contribution.id))
       throw new Error(`Client extension invalid contribution ID: ${contribution.id}`);
+
     if (contribution.zone !== zone)
       throw new Error(`Client extension ${owner}:${contribution.id} must use zone ${zone}`);
+
     const key = `${owner}:${contribution.id}`;
 
     if (this.sections.has(key) || this.actions.has(key) || this.views.has(key))
       throw new Error(`Client extension duplicate contribution: ${key}`);
+
     map.set(key, contribution);
     this.changed();
 
@@ -149,6 +152,7 @@ export async function loadInstalledClientExtensions(
       const parsed = v.safeParse(v.object({ default: v.function() }), module);
 
       if (!parsed.success) throw new Error("client entry point must export a default factory");
+
       await registry.load(extension.name, async (api) => {
         await parsed.output.default(api);
       });

package/src/integrations/clipboard.ts

@@ -8,6 +8,7 @@
 /** The clipboard-write commands to try, most-preferred first, for this platform. */
 export function clipboardCommands(platform: NodeJS.Platform = process.platform): string[][] {
   if (platform === "darwin") return [["pbcopy"]];
+
   if (platform === "win32") return [["clip.exe"]];
 
   return [["wl-copy"], ["xclip", "-selection", "clipboard"], ["xsel", "--clipboard", "--input"]];

package/src/integrations/components/ShareDialog.agent.test.tsx

@@ -36,10 +36,12 @@ for (const enabled of [false, true])
       expect(setup.captureCharFrame().includes("Allow agent messages")).toBe(enabled);
       await press(setup, "down");
       await press(setup, "down");
+
       if (enabled) {
         await press(setup, " ");
         await press(setup, "down");
       }
+
       await press(setup, "enter");
       expect(created).toHaveLength(1);
       expect(created[0]?.agentEnabled).toBe(enabled ? true : undefined);

package/src/integrations/components/ShareDialog.tsx

@@ -293,7 +293,9 @@ function Wizard({
 
   useEffect(() => {
     if (focus !== "name") return;
+
     nameRef.current?.focus();
+
     if (nameRef.current) nameRef.current.cursorOffset = draft.name.length;
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [focus]);
@@ -418,6 +420,7 @@ export function ShareDialog({
 
   const saveWizard = (): void => {
     if (!wizard || saveDisabled) return;
+
     const input: NewShareLink = {
       name: wizard.name.trim() || undefined,
       requireAuth: wizard.requireAuth,
@@ -425,13 +428,16 @@ export function ShareDialog({
     };
 
     if (agentAvailable) input.agentEnabled = wizard.agentEnabled ?? false;
+
     if (wizard.editingId) onUpdateLink(wizard.editingId, input);
     else onCreateLink(input);
+
     backToList();
   };
 
   const activateListRow = (): void => {
     if (listCursor >= links.length) return openWizardWith(newWizardDraft(threadName));
+
     const link = links[listCursor];
 
     if (link) onCopyLink(link.id);
@@ -440,30 +446,41 @@ export function ShareDialog({
   // turning auth on drops the cursor straight into the handles field; turning it off resets them
   const toggleAuth = (): void => {
     if (!wizard) return;
+
     const next = !wizard.requireAuth;
 
     shareDialogStore.getState().setRequireAuth(next);
+
     if (!next) shareDialogStore.getState().setAllowlist([]);
+
     setWizardFocus(next ? "allowlist" : "auth");
   };
 
   // grammar keys only bite outside a focused text field, where they cannot be typed
   const handleWizardKey = (name: string): void => {
     if (!wizard) return;
+
     if (name === "escape") return backToList();
+
     if (name === "down") return moveWizardFocus(1);
+
     if (name === "up") return moveWizardFocus(-1);
+
     const activated = name === "return" || name === "enter";
 
     if (wizardFocus === "auth" && (activated || name === "space")) return toggleAuth();
+
     if (wizardFocus === "agent" && (activated || name === "space"))
       return shareDialogStore.getState().setAgentEnabled(!wizard.agentEnabled);
+
     if (wizardFocus === "actions" && activated) saveWizard();
   };
 
   const handleNavKey = (name: string): void => {
     if (name === "j" || name === "down") return shareDialogStore.getState().setCategory("export");
+
     if (name === "k" || name === "up") return shareDialogStore.getState().setCategory("external");
+
     const enter =
       name === "l" || name === "right" || name === "return" || name === "enter" || name === "tab";
 
@@ -478,21 +495,32 @@ export function ShareDialog({
 
   const handleBodyKey = (name: string): void => {
     if (name === "h" || name === "left") return setActiveZone("nav");
+
     if (name === "j" || name === "down")
       return setListCursor((cursor) => Math.min(cursor + 1, rowCount - 1));
+
     if (name === "k" || name === "up") return setListCursor((cursor) => Math.max(cursor - 1, 0));
+
     if (name === "return" || name === "enter") return activateListRow();
+
     if (listCursor >= links.length) return;
+
     if (name === "e") return editLinkAtCursor();
+
     if (name === "d") onDeleteLink(links[listCursor]!.id);
   };
 
   useKeyboard((key) => {
     if (!isOpen) return;
+
     if (wizard) return handleWizardKey(key.name);
+
     if (menuOpenId !== null) return void (key.name === "escape" && setMenuOpenId(null));
+
     if (key.name === "escape") return onClose();
+
     if (activeZone === "nav") return handleNavKey(key.name);
+
     handleBodyKey(key.name);
   });
 

package/src/integrations/editor.ts

@@ -85,6 +85,7 @@ export function resolveEditorCommand(rawEditor: string): ResolvedEditor {
   const base = editorBaseName(parts[0] ?? "");
 
   if (TERMINAL_EDITORS.has(base)) return { argv: parts, waits: true };
+
   const waitFlags = GUI_WAIT_FLAGS[base];
 
   if (waitFlags) {
@@ -103,6 +104,7 @@ const NO_WAIT_THRESHOLD_MS = 1000;
 
 function suspectsNoWait(resolved: ResolvedEditor, elapsedMs: number, unchanged: boolean): boolean {
   if (resolved.waits) return false; // holds the terminal or has a wait flag - trust the exit
+
   if (!unchanged) return false; // edits landed, so it waited after all
 
   return elapsedMs < NO_WAIT_THRESHOLD_MS;
@@ -145,6 +147,7 @@ export function editInEditor(
     });
 
     if (editorProcess.exitCode !== 0) throw new Error(`editor exited ${editorProcess.exitCode}`);
+
     let next = readFileSync(path, "utf8");
 
     if (suspectsNoWait(resolved, now() - startedAt, next === content)) {

package/src/integrations/github-identity.test.ts

@@ -10,6 +10,7 @@ const tempDirectories: string[] = [];
 afterEach(() => {
   if (originalBinary === undefined) delete process.env.CUELOOP_GH;
   else process.env.CUELOOP_GH = originalBinary;
+
   for (const directory of tempDirectories.splice(0)) {
     rmSync(directory, { recursive: true, force: true });
   }

package/src/integrations/github-identity.ts

@@ -30,6 +30,7 @@ export async function resolveGithubIdentity(): Promise<GithubIdentity | null> {
     ]);
 
     if (exitCode !== 0) return null;
+
     const parsed = v.safeParse(GithubUserSchema, JSON.parse(output));
 
     if (!parsed.success) return null;

package/src/integrations/herdr.ts

@@ -21,9 +21,11 @@ export function focusHerdrPane(binPath: string, paneId: string): boolean {
     });
 
     if (got.exitCode !== 0) return false;
+
     const parsed = v.safeParse(HerdrPaneSchema, JSON.parse(got.stdout.toString()));
 
     if (!parsed.success) return false;
+
     const tab = parsed.output.result?.pane?.tab_id;
 
     if (!tab) return false;

package/src/integrations/pasted-image.ts

@@ -37,6 +37,7 @@ function isControlCodePoint(codePoint: number): boolean {
 /** True when a paste is an image or other non-text binary payload and should collapse to a placeholder. */
 export function looksLikeBinaryPaste(bytes: Uint8Array): boolean {
   if (bytes.length === 0) return false;
+
   if (hasImageMagic(bytes)) return true;
 
   const decoded = PASTE_DECODER.decode(bytes);
@@ -48,6 +49,7 @@ export function looksLikeBinaryPaste(bytes: Uint8Array): boolean {
     const codePoint = character.codePointAt(0) ?? 0;
 
     if (codePoint === 0 || codePoint === 0xfffd) return true;
+
     if (isControlCodePoint(codePoint)) controlCount += 1;
   }
 

package/src/integrations/share.ts

@@ -19,9 +19,10 @@ import {
   type SharePolicy,
   type ShareLink,
   type Thread,
+  type ThreadAgentState,
 } from "@cueloop/schema";
 import { ThreadRecordSchema } from "@cueloop/daemon/validate";
-import type { SharedMerge } from "@cueloop/daemon/client";
+import type { ThreadClient, SharedMerge } from "@cueloop/daemon/client";
 import * as v from "valibot";
 import { copyToClipboard } from "./clipboard";
 
@@ -62,9 +63,11 @@ export async function publishShare(
 
   if (code !== 0)
     throw new Error(`gateway upload failed: ${stderr.trim() || `ssh exited ${code}`}`);
+
   const line = stdout.trim();
 
   if (!line.startsWith("ssh ")) throw new Error(`unexpected gateway reply: ${line || "(empty)"}`);
+
   const copied = await copyToClipboard(line);
 
   return { line, copied };
@@ -98,6 +101,7 @@ export function mergeFromShare(remote: Thread): SharedMerge {
   if (remote.shares?.length === 1) merge.shareId = remote.shares[0]!.id;
 
   if (remote.participants) merge.participants = remote.participants;
+
   if (remote.history) {
     merge.removals = removalEntries(remote.history).map((entry) => ({
       id: entry.id,
@@ -193,6 +197,7 @@ async function readLines(
     pending = lines.pop() ?? "";
     for (const line of lines) {
       if (line.trim() === "") continue;
+
       try {
         onLine(line);
       } catch {
@@ -236,3 +241,43 @@ async function runShareSsh(
 
   return { stdout, stderr, code };
 }
+
+/** Freeze the visible conversation without owner session IDs, execution data or delivery receipts. */
+export async function snapshotThreadConversation(
+  thread: Thread,
+  client: Pick<ThreadClient, "agentGet">,
+): Promise<Thread> {
+  if (!client.agentGet) return thread;
+
+  let state: ThreadAgentState;
+
+  try {
+    state = await client.agentGet(thread.id);
+  } catch (error) {
+    if (error instanceof Error && error.message.startsWith("Thread agent is disabled;"))
+      return thread;
+
+    throw error;
+  }
+
+  if (!state.messages.length && !state.submissions?.length) return thread;
+
+  return {
+    ...thread,
+    agentSnapshot: {
+      threadId: thread.id,
+      harness: state.harness ? { id: state.harness.id, label: state.harness.label } : undefined,
+      phase: { kind: "idle" },
+      messages: state.messages,
+      comments: state.comments,
+      tools: [],
+      submissions: state.submissions?.map(({ id, commentId, prompt, quote, status }) => ({
+        id,
+        commentId,
+        prompt,
+        quote,
+        status,
+      })),
+    },
+  };
+}

package/src/keyboard/components/HandleChipsInput.tsx

@@ -77,6 +77,7 @@ export function HandleChipsInput({
     const input = inputRef.current;
 
     if (!input || !focused) return;
+
     input.focus();
     input.cursorOffset = seed.length; // land the caret at the end of the seeded text
     // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -91,12 +92,15 @@ export function HandleChipsInput({
     const handle = (inputRef.current?.plainText ?? "").trim().replace(/^@/, "").toLowerCase();
 
     if (handle && !logins.includes(handle)) onChange([...logins, handle]);
+
     reseed("");
   };
 
   useKeyboard((key) => {
     if (!focused) return;
+
     if (key.name !== "backspace" || (inputRef.current?.plainText ?? "").length > 0) return;
+
     // backspace on an empty field pulls the last chip back in to edit; with none left, collapse
     if (logins.length > 0) {
       const last = logins[logins.length - 1]!;

package/src/keyboard/components/SlashComposer.tsx

@@ -46,10 +46,13 @@ export function SlashComposer({
 
   useKeyboard((key) => {
     if (!slashActive) return;
+
     const selected = Math.min(slashIndex, items.length - 1);
 
     if (key.name === "up") return setSlashIndex(Math.max(0, selected - 1));
+
     if (key.name === "down") return setSlashIndex(Math.min(items.length - 1, selected + 1));
+
     if (key.name === "tab" || (key.name === "return" && !key.meta && !key.ctrl && !key.super)) {
       const inserted = insertSlashItem(text, caret, items[selected]!.name);
 

package/src/keyboard/key-bindings.ts

@@ -405,11 +405,13 @@ export class KeyBindings {
         fragments.push(entry.text);
         continue;
       }
+
       const displays = entry.commands
         .map((command) => this.keyDisplayFor(command))
         .filter((display): display is string => display !== null);
 
       if (!displays.length) continue;
+
       const keyPart = displays.join("/");
 
       if (!entry.label) fragments.push(keyPart);
@@ -435,6 +437,7 @@ export class KeyBindings {
 
       for (const entry of HINT_TEMPLATES[mode]) {
         if ("text" in entry || !entry.label) continue;
+
         const keys = entry.commands
           .map((command) => this.keyDisplayFor(command))
           .filter((display): display is string => display !== null)