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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueloop/schema",
-  "version": "0.1.0-alpha.102",
+  "version": "0.1.0-alpha.104",
   "description": "The Thread primitive: types, markdown block model, quote-primary anchors, feedback serialization",
   "homepage": "https://github.com/mmurakaru/cueloop#readme",
   "bugs": {

package/src/agent-comment.ts

@@ -7,9 +7,11 @@ export function agentCommentRoot(state: ThreadAgentState, id: string): AgentComm
   const comment = state.comments.find((entry) => entry.id === id);
 
   if (comment) return comment;
+
   const submission = state.submissions?.find((entry) => entry.id === id && entry.commentId === id);
 
   if (!submission) return undefined;
+
   const blocks = parseBlocks(submission.prompt);
   const anchor = makeAnchor(blocks, 0, 0, Math.min(blocks[0]?.text.length ?? 0, 32768));
 

package/src/agent-harness.ts

@@ -1,5 +1,23 @@
 import type { AgentPermission, AgentTool, AgentConfigOption } from "./thread-agent";
 
+/** Reasoning effort choices shared by Thread defaults and their settings controls. */
+export const AGENT_REASONING_EFFORTS = ["low", "medium", "high", "xhigh"] as const;
+
+/** Reasoning effort stored in the new-conversation defaults. */
+export type AgentReasoningEffort = (typeof AGENT_REASONING_EFFORTS)[number];
+
+/** Model identity and effort supplied by the owner for new Thread conversations. */
+export interface ThreadModelDefaults {
+  model: string;
+  effort: AgentReasoningEffort;
+}
+
+/** Provider-qualified model defaults apply only when a Thread creates a conversation. */
+export const THREAD_MODEL_DEFAULTS: Record<"pi" | "fx", ThreadModelDefaults> = {
+  pi: { model: "openai-codex/gpt-6.1-sol", effort: "medium" },
+  fx: { model: "grok/grok-4.7", effort: "medium" },
+};
+
 /** Harness events carry transcript data without exposing a provider's wire protocol. */
 export type AgentHarnessEvent =
   | { kind: "message"; id?: string; text: string; replace?: boolean }
@@ -44,6 +62,7 @@ export interface AgentHarnessOptions {
 export interface AgentHarnessAdapter {
   id: string;
   label: string;
+  recovery?: "durable";
   connect(options: AgentHarnessOptions): AgentHarnessConnection;
   remove?(sessionId: string): void | Promise<void>;
 }

package/src/anchor.ts

@@ -94,8 +94,11 @@ function contextScore(
   let score = 0;
 
   if (prefix === anchor.prefix) score += 2;
+
   if (suffix === anchor.suffix) score += 2;
+
   if (anchor.blockIndex === blockIndex) score += 1;
+
   if (anchor.blockIndex === blockIndex && anchor.start === start) score += 1;
 
   return score;
@@ -138,11 +141,13 @@ const FUZZY_CONTEXT_TIE_BREAK = 0.01;
 /** Block indices to scan, spiralling out from the anchor's hinted block: hint, hint+1, hint-1, ... */
 function blockScanOrder(hint: number | undefined, count: number): number[] {
   if (count <= 0) return [];
+
   const first = Number.isInteger(hint) ? Math.min(Math.max(hint!, 0), count - 1) : 0;
   const order = [first];
 
   for (const step of Array.from({ length: count - 1 }, (_unused, index) => index + 1)) {
     if (first + step < count) order.push(first + step);
+
     if (first - step >= 0) order.push(first - step);
   }
 
@@ -175,6 +180,7 @@ function findFuzzyCandidates(
 
       candidates.push({ blockIndex, start: match.start, end: match.end, score });
     }
+
     if (budget.remaining <= 0) break;
   }
 
@@ -184,6 +190,7 @@ function findFuzzyCandidates(
 /** Highest-scoring candidate, or null when there are none. */
 function pickBest(candidates: Candidate[]): Candidate | null {
   if (candidates.length === 0) return null;
+
   candidates.sort((left, right) => right.score - left.score);
 
   return candidates[0]!;
@@ -214,6 +221,7 @@ function joinBlocks(blocks: Block[]): JoinedDocument {
 
   blocks.forEach((block, blockIndex) => {
     if (blockIndex > 0) text += BLOCK_SEPARATOR;
+
     starts.push(text.length);
     text += block.text;
   });
@@ -241,11 +249,13 @@ function locateInBlocks(
   let blockIndex = starts.findLastIndex((start) => start <= offset);
 
   if (blockIndex < 0) blockIndex = 0;
+
   const blockEnd = starts[blockIndex]! + blocks[blockIndex]!.text.length;
 
   if (edge === "start" && offset >= blockEnd && blockIndex < blocks.length - 1) {
     return { blockIndex: blockIndex + 1, offset: 0 };
   }
+
   if (edge === "end" && offset === starts[blockIndex] && blockIndex > 0) {
     return {
       blockIndex: blockIndex - 1,
@@ -272,7 +282,9 @@ function documentScore(
   let score = 0;
 
   if (prefix === anchor.prefix) score += 2;
+
   if (suffix === anchor.suffix) score += 2;
+
   if (anchor.blockIndex === startBlockIndex) score += 1;
 
   return score;
@@ -369,6 +381,7 @@ function resolveSpanningAnchor(anchor: Anchor, blocks: Block[]): ResolvedAnchor
 /** Resolve an anchor against the current blocks, or null when orphaned. */
 export function resolveAnchor(anchor: Anchor, blocks: Block[]): ResolvedAnchor | null {
   if (anchor.quote === "") return null;
+
   if (anchor.quote.includes(BLOCK_SEPARATOR)) return resolveSpanningAnchor(anchor, blocks);
 
   const exact = pickBest(findExactCandidates(anchor, blocks, anchor.quote));

package/src/diff.test.ts

@@ -54,6 +54,7 @@ describe("unifiedDiff", () => {
 
     for (const line of diffLines) {
       if (line.kind === "hunk") continue;
+
       if (line.kind === "ctx" || line.kind === "add") rebuilt.push(line.text.slice(1));
     }
     expect(rebuilt.join("\n")).toBe(newText);

package/src/diff.ts

@@ -70,6 +70,7 @@ export function unifiedDiff(oldText: string, newText: string, context = 3): Unif
   const ops = lcsDiff(oldText.split("\n"), newText.split("\n"));
 
   if (!ops.some((op) => op.kind !== "ctx")) return null;
+
   let oldLineNumber = 1;
   let newLineNumber = 1;
   const rows = ops.map((op) => {
@@ -81,6 +82,7 @@ export function unifiedDiff(oldText: string, newText: string, context = 3): Unif
     };
 
     if (op.kind !== "add") oldLineNumber++;
+
     if (op.kind !== "del") newLineNumber++;
 
     return row;
@@ -107,10 +109,12 @@ export function unifiedDiff(oldText: string, newText: string, context = 3): Unif
 
       return;
     }
+
     if (!openHunk) {
       openHunk = { rows: [] };
       hunks.push(openHunk);
     }
+
     openHunk.rows.push(row);
   });
   const lines: UnifiedLine[] = [];

package/src/feedback.ts

@@ -75,6 +75,7 @@ export function renderFeedback(input: FeedbackInput): string {
 
   lines.push("# Review: " + input.outcome.replaceAll("_", " "));
   lines.push("");
+
   if (input.summary.trim()) {
     lines.push(input.summary.trim());
     lines.push("");
@@ -88,6 +89,7 @@ export function renderFeedback(input: FeedbackInput): string {
     hasEdits = true;
     lines.push("## Curated changes");
     lines.push("");
+
     if (input.workingCopy.trim()) {
       lines.push("The reviewer accepted a subset of your proposed changes. Apply this");
       lines.push("exact unified diff; it replaces what you submitted.");
@@ -98,6 +100,7 @@ export function renderFeedback(input: FeedbackInput): string {
     } else {
       lines.push("The reviewer rejected all of your proposed changes.");
     }
+
     lines.push("");
   } else {
     const diff =
@@ -132,6 +135,7 @@ export function renderFeedback(input: FeedbackInput): string {
         input.actionBodies,
       ),
     );
+
     if (input.sessionId) {
       lines.push("## Reporting what you addressed");
       lines.push("");
@@ -178,6 +182,7 @@ function annotationSectionLines(
     const target = annotationTarget(annotation);
 
     if (target.kind !== "file") continue;
+
     const group = fileGroups.get(target.path) ?? [];
 
     group.push(annotation);
@@ -200,6 +205,7 @@ function annotationSectionLines(
         lines.push(`- ${expandActionRefs(reply.body, actionBodies).replace(/\n/g, "\n  ")}`);
       lines.push("");
     }
+
     lines.push(`annotation id: \`${annotation.id}\``);
     lines.push("");
   };
@@ -227,6 +233,7 @@ function annotationSectionLines(
       pushNote(annotation, index, location, orphan);
     });
   }
+
   for (const [filePath, notes] of fileGroups) {
     lines.push(`## ${filePath} (${notes.length})`);
     lines.push("");

package/src/fuzzy.ts

@@ -20,7 +20,9 @@ export interface FuzzyMatch {
  */
 export function levenshteinDistance(left: string, right: string): number {
   if (left === right) return 0;
+
   if (left.length === 0) return right.length;
+
   if (right.length === 0) return left.length;
 
   let previousRow: number[] = Array.from({ length: right.length + 1 }, (_unused, column) => column);
@@ -114,11 +116,14 @@ export function fuzzyFindBestMatch(
     ) {
       // each window costs a needle x window edit-distance pass; spend that from the shared budget
       budget.remaining -= needle.length * windowLength;
+
       if (budget.remaining <= 0) return bestMatch;
+
       const window = haystack.slice(start, start + windowLength);
       const similarity = similarityRatio(needle, window);
 
       if (similarity < minimumSimilarity) continue;
+
       if (bestMatch === null || similarity > bestMatch.similarity) {
         bestMatch = { start, end: start + windowLength, similarity };
       }

package/src/herdr.ts

@@ -22,9 +22,11 @@ export type HerdrEnv = Record<string, string | undefined>;
  */
 export function detectHerdr(env: HerdrEnv = process.env): HerdrContext | null {
   if (env.HERDR_ENV !== "1") return null;
+
   const paneId = env.HERDR_PANE_ID;
 
   if (!paneId) return null;
+
   // herdr 0.8.0 exposes no HERDR_BIN_PATH; the CLI is `herdr` on PATH and finds
   // the app over HERDR_SOCKET_PATH from the inherited env. Tests still override
   // HERDR_BIN_PATH to point the spawn at a stub script.
@@ -48,6 +50,7 @@ export function returnPaneFor(
   env: HerdrEnv = process.env,
 ): string | undefined {
   if (!insideHerdr(env)) return undefined;
+
   const pane = env.CUELOOP_RETURN_PANE ?? sessionHerdrPane;
 
   return pane && pane !== env.HERDR_PANE_ID ? pane : undefined;

package/src/history.ts

@@ -105,6 +105,7 @@ export function pathOf(history: SessionHistory, fromId: string = tipOf(history))
   ) {
     if (seen.has(entry.id))
       throw new HistoryError("cycle", `entry "${entry.id}" is its own ancestor`);
+
     seen.add(entry.id);
     path.unshift(entry);
   }
@@ -123,6 +124,7 @@ export function validateHistory(history: SessionHistory): string | null {
 
   for (const entry of history.entries) {
     if (ids.has(entry.id)) return `duplicate entry id "${entry.id}"`;
+
     ids.add(entry.id);
   }
   for (const entry of history.entries) {
@@ -130,11 +132,15 @@ export function validateHistory(history: SessionHistory): string | null {
       return `entry "${entry.id}" points at missing parent "${entry.parentId}"`;
     }
   }
+
   if (history.tips[MAIN_BRANCH] === undefined) return `no "${MAIN_BRANCH}" branch`;
+
   if (history.tips[history.branch] === undefined)
     return `current branch "${history.branch}" has no tip`;
+
   for (const [branch, tip] of Object.entries(history.tips)) {
     if (!ids.has(tip)) return `branch "${branch}" points at missing entry "${tip}"`;
+
     try {
       if (!pathOf(history, tip).some((entry) => entry.type === "revision")) {
         return `branch "${branch}" has no revision on its path`;
@@ -170,14 +176,18 @@ export function derivePath(history: SessionHistory, fromId?: string): DerivedPat
   const head = revisions.at(-1);
 
   if (!head) throw new HistoryError("not-a-revision", "a path without a revision has no head");
+
   const open = new Set<string>();
   const messages: Message[] = [];
   const summaries: Array<SessionEntry & { type: "branch-summary" }> = [];
 
   for (const entry of path) {
     if (entry.type === "comment") open.add(entry.annotationId);
+
     if (entry.type === "comment-removed") open.delete(entry.annotationId);
+
     if (entry.type === "message") messages.push(entry.message);
+
     if (entry.type === "branch-summary") summaries.push(entry);
   }
 
@@ -265,9 +275,11 @@ export function navigateTo(
   if (!entryOf(history, targetId)) {
     throw new HistoryError("unknown-entry", `no entry "${targetId}"`);
   }
+
   const tip = tipOf(history);
 
   if (targetId === tip) throw new HistoryError("already-there", "already at that entry");
+
   const path = pathOf(history);
   const index = path.findIndex((entry) => entry.id === targetId);
 
@@ -277,6 +289,7 @@ export function navigateTo(
       `"${targetId}" is not on branch "${history.branch}" - switch branch first`,
     );
   }
+
   const abandoned = path.slice(index + 1).map((entry) => entry.id);
   const moved: SessionHistory = {
     ...history,
@@ -306,6 +319,7 @@ export function forkHistory(history: SessionHistory): SessionHistory {
   for (const entry of pathOf(history)) {
     if (entry.type === "message" || (entry.type === "revision" && entry.by === "reviewer"))
       continue;
+
     kept.push({ ...entry, parentId: kept.at(-1)?.id ?? null });
     const label = history.labels[entry.id];
 
@@ -397,6 +411,7 @@ export function historyFromLinear(
       nextComment++;
     }
   });
+
   if (session.message) {
     push({
       id: `${session.id}_message`,
@@ -405,6 +420,7 @@ export function historyFromLinear(
       createdAt: session.message.sentAt,
     });
   }
+
   const tip = entries.at(-1);
 
   if (!tip) throw new HistoryError("not-a-revision", `session ${session.id} has no revision`);

package/src/inline.ts

@@ -143,11 +143,14 @@ function matchLink(
   end: number;
 } | null {
   if (text[index] !== "[") return null;
+
   const labelStart = index + 1;
   const labelEnd = text.indexOf("]", labelStart);
 
   if (labelEnd < 0 || labelEnd === labelStart) return null;
+
   if (text[labelEnd + 1] !== "(") return null;
+
   const hrefStart = labelEnd + 2;
   // the destination may carry balanced parentheses (wiki URLs); the span ends
   // at the first unmatched closer
@@ -162,6 +165,7 @@ function matchLink(
         depth--;
         continue;
       }
+
       if (scan === hrefStart) return null;
 
       return { labelStart, labelEnd, hrefStart, hrefEnd: scan, end: scan + 1 };
@@ -177,6 +181,7 @@ function matchCode(
   index: number,
 ): { contentStart: number; contentEnd: number; end: number } | null {
   if (text[index] !== "`") return null;
+
   let fence = 0;
 
   while (text[index + fence] === "`") fence++;
@@ -194,7 +199,9 @@ function matchEmphasis(text: string, index: number): Span | null {
   const two = text.slice(index, index + 2);
 
   if (two === "**") return closingSpan(text, index, 2, "strong");
+
   if (two === "~~") return closingSpan(text, index, 2, "strike");
+
   if (text[index] === "*") return closingSpan(text, index, 1, "em");
 
   return null;
@@ -224,9 +231,11 @@ function findLoneStar(text: string, from: number): number {
   while (index < text.length) {
     if (text[index] === "*") {
       if (text[index + 1] !== "*") return index;
+
       while (text[index] === "*") index++; // skip the whole `**` run
       continue;
     }
+
     index++;
   }
 

package/src/markdown.ts

@@ -47,6 +47,7 @@ export function stripLeadingBlockMarker(line: string): string {
 /** A GFM table delimiter row: one or more dash cells split by pipes, each optionally `:`-aligned. */
 function isTableDelimiterRow(line: string): boolean {
   if (!line.includes("|")) return false;
+
   const cells = line
     .trim()
     .replace(/^\||\|$/g, "")
@@ -81,9 +82,11 @@ function isMarkerLine(line: string): boolean {
  */
 function frontmatterBlock(lines: string[]): Block | null {
   if (lines[0]?.trim() !== "---") return null;
+
   let close = 1;
 
   while (close < lines.length && lines[close]!.trim() !== "---") close++;
+
   if (close >= lines.length) return null;
 
   return {
@@ -110,12 +113,17 @@ function singleLineBlock(line: string, lineIndex: number): Block | null {
   });
 
   if (line.startsWith("### ")) return marked("h3");
+
   if (line.startsWith("## ")) return marked("h2");
+
   if (line.startsWith("# ")) return marked("h1");
+
   if (/^(---|\*\*\*|___)\s*$/.test(line)) {
     return { kind: "hr", text: "", lineStart: lineIndex, lineEnd: lineIndex };
   }
+
   if (line.startsWith("- ")) return marked("li");
+
   if (/^\d+\. /.test(line)) return marked("oli");
 
   return null;
@@ -203,10 +211,13 @@ function nextBlock(lines: string[], lineIndex: number): BlockScan {
   const line = lines[lineIndex]!;
 
   if (line.startsWith("```")) return codeBlock(lines, lineIndex);
+
   const single = singleLineBlock(line, lineIndex);
 
   if (single) return { block: single, next: lineIndex + 1 };
+
   if (line.startsWith("> ")) return quoteBlock(lines, lineIndex);
+
   if (isTableStart(lines, lineIndex)) return tableBlock(lines, lineIndex);
 
   return paragraphBlock(lines, lineIndex);
@@ -243,11 +254,13 @@ function blockSourceSegments(
   } else {
     contentLines = rawLines.map((_, rawLine) => ({ rawLine, prefix: 0 }));
   }
+
   const content = contentLines
     .map(({ rawLine, prefix }) => rawLines[rawLine]!.slice(prefix))
     .join("\n");
 
   if (content !== block.text) return undefined;
+
   const rawLineStarts: number[] = [];
   let rawOffset = 0;
 
@@ -317,11 +330,13 @@ export function parseBlocks(markdown: string): Block[] {
     blocks.push(frontmatter);
     lineIndex = frontmatter.lineEnd + 1;
   }
+
   while (lineIndex < lines.length) {
     if (lines[lineIndex]!.trim() === "") {
       lineIndex++;
       continue;
     }
+
     const scan = nextBlock(lines, lineIndex);
 
     blocks.push(scan.block);

package/src/participants.ts

@@ -35,11 +35,13 @@ export function registerParticipant(
   const trimmed = name?.trim();
 
   if (existing && !trimmed && !source) return session;
+
   const resolvedName = trimmed ?? existing?.name;
   const resolvedHandle = source?.handle ?? existing?.handle;
   const next: Identity = { id: author, provider: source?.provider ?? existing?.provider ?? "ssh" };
 
   if (resolvedName) next.name = resolvedName;
+
   if (resolvedHandle) next.handle = resolvedHandle;
 
   return {

package/src/path-view.ts

@@ -52,10 +52,13 @@ export function viewOfPath(history: SessionHistory, known: Annotation[]): PathVi
 export function applyPathView(session: Thread, view: PathView): void {
   session.artifact = { ...session.artifact, content: view.content };
   session.annotations = view.annotations;
+
   if (view.textCuts?.length) session.textCuts = view.textCuts;
   else delete session.textCuts;
+
   if (view.workingCopy === undefined) delete session.workingCopy;
   else session.workingCopy = view.workingCopy;
+
   if (view.shelvedAnnotations.length === 0) delete session.shelvedAnnotations;
   else session.shelvedAnnotations = view.shelvedAnnotations;
 }
@@ -74,6 +77,7 @@ export function viewFollowing(session: Thread, branch?: string): Thread {
   const shared: Thread = { ...session };
 
   if (!session.history) return shared;
+
   const history = followBranch(session.history, followed);
   const known = [...session.annotations, ...(session.shelvedAnnotations ?? [])];
 

package/src/share-access.ts

@@ -7,7 +7,9 @@ export function isShareViewerAllowed(
   githubLogin: string | undefined,
 ): boolean {
   if (!policy.requireAuth) return true;
+
   if (githubLogin === undefined) return false;
+
   const login = githubLogin.toLowerCase();
 
   return policy.allowlist.some((allowed) => allowed.toLowerCase() === login);

package/src/thread-agent.ts

@@ -60,6 +60,14 @@ export interface ThreadAgentState {
     outcome?: "completed" | "failed" | "cancelled";
   })[];
   configOptions?: AgentConfigOption[];
+  handoff?: {
+    target: string;
+    requestedTarget?: string;
+    operationId: string;
+    prompt?: string;
+    source?: { id: string; label: string; sessionId?: string };
+  } & ({ status: "queued" } | { status: "summarizing" } | { status: "prepared"; text: string });
+  continuation?: string;
 }
 
 /** A submission freezes its input; retry keeps the same mirror and discussion origin. */
@@ -69,6 +77,7 @@ export interface AgentSubmission {
   messageId?: string;
   prompt: string;
   harnessPrompt?: string;
+  attemptId?: string;
   quote?: string;
   context?: string;
   status: "queued" | "running" | "completed" | "failed";

package/src/types.ts

@@ -4,6 +4,7 @@
  * dependencies beyond the history shapes.
  */
 
+import type { ThreadAgentState } from "./thread-agent";
 import type { SessionHistory } from "./history";
 
 export const SCHEMA_VERSION = "1";
@@ -320,6 +321,7 @@ export interface Thread {
   parentSessionId?: string;
   shares?: ShareLink[];
   participants?: Identity[];
+  agentSnapshot?: ThreadAgentState;
 }
 
 /** Whether a Message releases a harness gate. */

package/src/working-copy.ts

@@ -17,6 +17,7 @@ export function mergeTextCut(
     // SAFETY: a no-op returns the caller's array unchanged; callers never mutate the result.
     return cuts as TextCut[];
   }
+
   const ranges = [
     ...cuts.map((cut) => ({ start: cut.start, end: cut.end })),
     { start: boundedStart, end: boundedEnd },
@@ -52,12 +53,14 @@ export function restoreTextCut(
   const cutIndex = cuts.findIndex((cut) => cut.start <= start && end <= cut.end);
 
   if (cutIndex === -1 || end <= start) return null;
+
   const cut = cuts[cutIndex]!;
   const replacements: TextCut[] = [];
 
   if (cut.start < start) {
     replacements.push({ start: cut.start, end: start, quote: source.slice(cut.start, start) });
   }
+
   if (end < cut.end) {
     replacements.push({ start: end, end: cut.end, quote: source.slice(end, cut.end) });
   }
@@ -68,6 +71,7 @@ export function restoreTextCut(
 /** Apply valid source ranges in source order, ignoring stale or overlapping records. */
 export function applyTextCuts(source: string, cuts: readonly TextCut[]): string {
   if (cuts.length === 0) return source;
+
   let cursor = 0;
   const pieces: string[] = [];
 
@@ -76,6 +80,7 @@ export function applyTextCuts(source: string, cuts: readonly TextCut[]): string
   )) {
     if (cut.start < cursor || cut.start < 0 || cut.end > source.length || cut.end <= cut.start)
       continue;
+
     if (source.slice(cut.start, cut.end) !== cut.quote) continue;
 
     pieces.push(source.slice(cursor, cut.start));
@@ -190,7 +195,9 @@ export function restoreBlock(
   const insertedLines = sourceChunk(base, block).split("\n");
 
   if (before.length && before[before.length - 1]!.trim() !== "") insertedLines.unshift("");
+
   if (after.length && after[0]!.trim() !== "") insertedLines.push("");
+
   const restored = [...before, ...insertedLines, ...after].join("\n");
 
   return signature(restored) === signature(base) ? undefined : restored;