@vibedeckx/linux-x64 0.2.6 → 0.2.8

package/dist/bin.js

@@ -186146,7 +186146,11 @@ var asRun = (row) => row;
 var createWorkflowRunRepos = (kdb) => ({
   workflowRuns: {
     create: async (opts) => {
-      await kdb.insertInto("workflow_runs").values({ ...opts, status: "waiting_reviewer" }).execute();
+      await kdb.insertInto("workflow_runs").values({
+        ...opts,
+        reviewer_session_id: opts.reviewer_session_id ?? null,
+        status: "waiting_reviewer"
+      }).execute();
       const row = await kdb.selectFrom("workflow_runs").selectAll().where("id", "=", opts.id).executeTakeFirstOrThrow();
       return asRun(row);
     },
@@ -186169,6 +186173,10 @@ var createWorkflowRunRepos = (kdb) => ({
       ])).executeTakeFirst();
       return row ? asRun(row) : void 0;
     },
+    getLatestCompletedBySource: async (sourceSessionId) => {
+      const row = await kdb.selectFrom("workflow_runs").selectAll().where("source_session_id", "=", sourceSessionId).where("status", "=", "completed").where("reviewer_session_id", "is not", null).orderBy("created_at", "desc").orderBy(sql`rowid`, "desc").executeTakeFirst();
+      return row ? asRun(row) : void 0;
+    },
     update: async (id, patch) => {
       if (Object.keys(patch).length > 0) {
         await kdb.updateTable("workflow_runs").set({ ...patch, updated_at: sql`datetime('now')` }).where("id", "=", id).execute();
@@ -223734,17 +223742,13 @@ async function generateSessionTitleWithModel(model, userMessage, options = {}) {
     }
   } : void 0;
   try {
-    const result = await Promise.race([
-      generateText({
-        model,
-        system: SYSTEM_PROMPT,
-        prompt: buildPrompt(userMessage),
-        experimental_telemetry: telemetry
-      }),
-      new Promise(
-        (_3, reject) => setTimeout(() => reject(new Error("title generation timed out")), AI_TIMEOUT_MS)
-      )
-    ]);
+    const result = await generateText({
+      model,
+      system: SYSTEM_PROMPT,
+      prompt: buildPrompt(userMessage),
+      timeout: AI_TIMEOUT_MS,
+      experimental_telemetry: telemetry
+    });
     const text2 = result.text ?? "";
     const sanitized = sanitizeTitle(text2);
     return sanitized.length > 0 ? sanitized : null;
@@ -226027,6 +226031,13 @@ function mapRemoteRun(run2, remoteServerId, projectId) {
     reviewer_session_id: run2.reviewer_session_id ? `${prefix}${run2.reviewer_session_id}` : null
   };
 }
+function mapRemoteReviewerCandidate(candidate, remoteServerId, projectId) {
+  if (!candidate?.sessionId) return candidate;
+  return {
+    ...candidate,
+    sessionId: `remote-${remoteServerId}-${projectId}-${candidate.sessionId}`
+  };
+}
 function runUpdatedEventFromRemoteFrame(parsed, sessionId, remoteInfo) {
   if (!("workflowRunUpdated" in parsed)) return null;
   const bare = parsed.workflowRunUpdated;
@@ -228707,15 +228718,28 @@ var WorkflowError = class extends Error {
   }
   code;
 };
+var MAX_CONTEXT_CHARS = 2e3;
+var MAX_SELF_REPORT_CHARS = 4e3;
+var SELF_REPORT_MIN_CHARS = 80;
+function cap(text2, max) {
+  return text2.length > max ? text2.slice(0, max) + "\u2026" : text2;
+}
+function userTextOf(e) {
+  if (e.type !== "user") return null;
+  if (typeof e.content === "string") return e.content;
+  const text2 = e.content.filter((p2) => p2.type === "text").map((p2) => p2.text).join("\n");
+  return text2 || null;
+}
 function extractLatestTurnEndIndex(entries) {
   for (let i = entries.length - 1; i >= 0; i--) {
     if (entries[i]?.type === "turn_end") return i;
   }
   return null;
 }
-function extractLastAssistantBefore(entries, beforeIndex) {
+function extractLastAssistantInTurn(entries, beforeIndex) {
   for (let i = beforeIndex - 1; i >= 0; i--) {
     const e = entries[i];
+    if (e?.type === "user") return null;
     if (e?.type === "assistant" && typeof e.content === "string" && e.content.trim()) return e.content;
   }
   return null;
@@ -228729,23 +228753,89 @@ function extractTaskContextBefore(entries, turnEndIndex) {
   }
   return null;
 }
+function extractFirstUserMessage(entries) {
+  for (let i = 0; i < entries.length; i++) {
+    const e = entries[i];
+    if (e?.type !== "user" || e.event) continue;
+    const text2 = userTextOf(e)?.trim();
+    if (text2) return cap(text2, MAX_CONTEXT_CHARS);
+  }
+  return null;
+}
+function extractAuthorSelfReport(entries, beforeIndex, opts) {
+  let fallback = null;
+  for (let i = beforeIndex - 1; i >= 0; i--) {
+    const e = entries[i];
+    if (e?.type === "user" && opts?.withinTurn) break;
+    if (e?.type !== "assistant" || typeof e.content !== "string") continue;
+    const text2 = e.content.trim();
+    if (!text2) continue;
+    if (text2.length >= SELF_REPORT_MIN_CHARS) return cap(text2, MAX_SELF_REPORT_CHARS);
+    if (fallback === null) fallback = text2;
+  }
+  return fallback;
+}
+function selfReportSection(report) {
+  if (!report) return null;
+  return [
+    "\n## Author's self-report (unverified)",
+    "The implementing agent described its own work as follows. Treat every claim as unverified \u2014 check each one against the actual code, and look for problems the self-report does not mention.",
+    "<author-self-report>",
+    report,
+    "</author-self-report>"
+  ].join("\n");
+}
 function buildReviewerPrompt(opts) {
+  const intent = opts.originalIntent !== opts.taskContext ? opts.originalIntent : null;
+  const brief = opts.intentBrief || null;
+  const hasExcerpt = Boolean(intent || opts.taskContext || opts.authorSelfReport);
   return [
     "You are a code reviewer agent. Another agent just completed work in this workspace; review it critically and independently.",
+    brief ? `
+## Intent brief (distilled from the source conversation)
+${brief}` : null,
+    !brief && intent ? `
+## Original request (the user's first message in this session, verbatim)
+${intent}` : null,
     opts.taskContext ? `
 ## Original task
 ${opts.taskContext}` : null,
+    brief ? null : selfReportSection(opts.authorSelfReport),
     opts.reviewFocus ? `
 ## Review focus (from the user)
 ${opts.reviewFocus}` : null,
     "\n## How to review",
     "- Do NOT modify any files \u2014 you are in read-only review mode.",
     "- Inspect the actual workspace state yourself: read the relevant files, run `git diff`, `git status` and `git log`.",
-    opts.target.baseHead ? `- The work was captured at commit ${opts.target.baseHead}${opts.target.diffStat ? ` with uncommitted changes (${opts.target.diffStat})` : " with no uncommitted changes"}.` : null,
+    reviewTargetPromptLine(opts.target),
     "- Judge correctness, completeness against the task, and code quality. Be specific: reference files and lines.",
-    "\nEnd your final message with a clear, actionable list of feedback items \u2014 or state explicitly that the work looks good."
+    "\nEnd your final message with a clear, actionable list of feedback items \u2014 or state explicitly that the work looks good.",
+    brief ? "\n(review context: distilled intent brief + live workspace)" : hasExcerpt ? "\n(review context: deterministic excerpt of the source conversation + live workspace)" : "\n(review context: live workspace only \u2014 the source conversation was unavailable)"
   ].filter((l) => l !== null).join("\n");
 }
+function reviewTargetPromptLine(target) {
+  return target.baseHead ? `- The work was captured at commit ${target.baseHead}${target.diffStat ? ` with uncommitted changes (${target.diffStat})` : " with no uncommitted changes"}.` : null;
+}
+function buildRereviewerPrompt(opts) {
+  return [
+    "The source agent has addressed feedback from your previous review.",
+    "Review the latest workspace state again.",
+    opts.taskContext ? `
+## Latest source turn
+${opts.taskContext}` : null,
+    selfReportSection(opts.authorSelfReport),
+    opts.reviewFocus ? `
+## Review focus
+${opts.reviewFocus}` : null,
+    "\n## How to review",
+    "- Verify whether your previous feedback was addressed correctly.",
+    "- Treat the changed areas as new code: look for bugs the fix itself may have introduced, not only whether your old items were closed.",
+    "- Check for regressions and remaining correctness or test gaps.",
+    "- Do NOT modify files \u2014 remain in read-only review mode.",
+    reviewTargetPromptLine(opts.target),
+    "- End with actionable feedback, or explicitly state that it looks good."
+  ].filter((line) => line !== null).join("\n");
+}
 function buildFeedbackMessage(feedback) {
   return [
     "[Review Feedback]",
@@ -228754,6 +228844,7 @@ function buildFeedbackMessage(feedback) {
     feedback
   ].join("\n");
 }
+var REVIEWER_AGENT_TYPES = /* @__PURE__ */ new Set(["claude-code", "codex"]);
 var WorkflowEngine = class {
   constructor(storage, agentOps) {
     this.storage = storage;
@@ -228803,6 +228894,15 @@ var WorkflowEngine = class {
       if (p2.runId === run2.id) this.participants.delete(sid);
     }
   }
+  releaseReservations(runId) {
+    for (const [sid, participant] of this.participants) {
+      if (participant.runId === runId) this.participants.delete(sid);
+    }
+  }
+  async failRun(run2, error48) {
+    const failed = await this.storage.workflowRuns.update(run2.id, { status: "failed", error: error48 });
+    if (failed) this.untrackRun(failed);
+  }
   /** Sync check used by ChatSessionManager before waking the commander model. */
   shouldSuppressAgentEvent(sessionId) {
     return this.participants.get(sessionId)?.role === "reviewer";
@@ -228810,14 +228910,62 @@ var WorkflowEngine = class {
   isSessionInActiveRun(sessionId) {
     return this.participants.has(sessionId);
   }
+  async getReviewerCandidate(sourceSessionId) {
+    const previous = await this.storage.workflowRuns.getLatestCompletedBySource(sourceSessionId);
+    if (!previous?.reviewer_session_id) return null;
+    const unavailable = (reason) => ({
+      available: false,
+      sessionId: null,
+      title: null,
+      agentType: null,
+      reason
+    });
+    const source = await this.storage.agentSessions.getById(sourceSessionId);
+    const reviewer = await this.storage.agentSessions.getById(previous.reviewer_session_id);
+    if (!reviewer) return unavailable("deleted");
+    if (!source || reviewer.project_id !== source.project_id || reviewer.project_id !== previous.project_id) {
+      return unavailable("project-mismatch");
+    }
+    if ((reviewer.branch || null) !== (source.branch || null) || (reviewer.branch || null) !== previous.branch) {
+      return unavailable("branch-mismatch");
+    }
+    if (!REVIEWER_AGENT_TYPES.has(reviewer.agent_type)) {
+      return unavailable("unsupported-agent");
+    }
+    if (reviewer.status === "running") return unavailable("running");
+    if (reviewer.status !== "stopped") return unavailable("unavailable");
+    if (this.participants.has(reviewer.id) || await this.storage.workflowRuns.getActiveBySession(reviewer.id)) {
+      return unavailable("busy");
+    }
+    return {
+      available: true,
+      sessionId: reviewer.id,
+      title: reviewer.title ?? null,
+      agentType: reviewer.agent_type,
+      reason: null
+    };
+  }
   async startAdhocReview(opts) {
-    if (this.participants.has(opts.sourceSessionId)) {
-      throw new WorkflowError("session-busy", "\u8BE5 session \u5DF2\u5728\u4E00\u4E2A\u8FDB\u884C\u4E2D\u7684 review \u91CC");
+    if (opts.reviewerSessionId === opts.sourceSessionId) {
+      throw new WorkflowError("reviewer-unavailable", "reviewer session \u4E0D\u80FD\u4E0E source session \u76F8\u540C");
+    }
+    const runId = randomUUID5();
+    const participantIds = [opts.sourceSessionId, opts.reviewerSessionId].filter((id) => Boolean(id));
+    for (const sessionId of participantIds) {
+      if (this.participants.has(sessionId)) {
+        throw new WorkflowError("session-busy", "\u8BE5 session \u5DF2\u5728\u4E00\u4E2A\u8FDB\u884C\u4E2D\u7684 review \u91CC");
+      }
+    }
+    this.participants.set(opts.sourceSessionId, { runId, role: "source" });
+    if (opts.reviewerSessionId) {
+      this.participants.set(opts.reviewerSessionId, { runId, role: "reviewer" });
     }
-    this.participants.set(opts.sourceSessionId, { runId: "pending", role: "source" });
     try {
-      const busy = await this.storage.workflowRuns.getActiveBySession(opts.sourceSessionId);
-      if (busy) throw new WorkflowError("session-busy", "\u8BE5 session \u5DF2\u5728\u4E00\u4E2A\u8FDB\u884C\u4E2D\u7684 review \u91CC");
+      for (const sessionId of participantIds) {
+        if (await this.storage.workflowRuns.getActiveBySession(sessionId)) {
+          throw new WorkflowError("session-busy", "\u8BE5 session \u5DF2\u5728\u4E00\u4E2A\u8FDB\u884C\u4E2D\u7684 review \u91CC");
+        }
+      }
       const sourceSession = await this.storage.agentSessions.getById(opts.sourceSessionId);
       if (sourceSession?.status === "running") {
         throw new WorkflowError("source-running", "source session \u6B63\u5728\u8FD0\u884C\uFF0C\u8BF7\u7B49\u5F85\u5F53\u524D turn \u5B8C\u6210\u540E\u518D\u53D1\u8D77 review");
@@ -228829,16 +228977,64 @@ var WorkflowEngine = class {
       }
       const worktreePath = resolveWorktreePath(opts.project.path, opts.branch);
       const target = captureReviewTarget(worktreePath);
+      let reviewerSession = null;
+      if (opts.reviewerSessionId) {
+        reviewerSession = await this.storage.agentSessions.getById(opts.reviewerSessionId);
+        if (!reviewerSession) {
+          throw new WorkflowError("reviewer-unavailable", "\u4E0A\u6B21 reviewer session \u5DF2\u4E0D\u5B58\u5728");
+        }
+        if (reviewerSession.project_id !== opts.project.id) {
+          throw new WorkflowError("reviewer-unavailable", "reviewer session \u4E0D\u5C5E\u4E8E\u5F53\u524D\u9879\u76EE");
+        }
+        if ((reviewerSession.branch || null) !== opts.branch) {
+          throw new WorkflowError("reviewer-unavailable", "reviewer session \u4E0D\u5C5E\u4E8E\u5F53\u524D branch");
+        }
+        if (!REVIEWER_AGENT_TYPES.has(reviewerSession.agent_type)) {
+          throw new WorkflowError("reviewer-unavailable", "reviewer agent \u7C7B\u578B\u4E0D\u53EF\u7528");
+        }
+        if (reviewerSession.status !== "stopped") {
+          throw new WorkflowError("reviewer-unavailable", "reviewer session \u6B63\u5728\u8FD0\u884C\u6216\u4E0D\u53EF\u7528");
+        }
+      }
       const run2 = await this.storage.workflowRuns.create({
-        id: randomUUID5(),
+        id: runId,
         project_id: opts.project.id,
         branch: opts.branch,
         source_session_id: opts.sourceSessionId,
         source_turn_end_index: turnEndIndex,
         review_focus: opts.reviewFocus ?? null,
-        review_target: JSON.stringify(target)
+        review_target: JSON.stringify(target),
+        reviewer_session_id: opts.reviewerSessionId ?? null
       });
       this.trackParticipants(run2);
+      if (opts.reviewerSessionId && reviewerSession) {
+        if (reviewerSession.permission_mode !== "plan") {
+          let switched = false;
+          try {
+            switched = await this.agentOps.switchMode(opts.reviewerSessionId, opts.project.path, "plan");
+          } catch {
+          }
+          if (!switched) {
+            await this.failRun(run2, "\u65E0\u6CD5\u5C06 reviewer \u6062\u590D\u4E3A\u53EA\u8BFB plan \u6A21\u5F0F");
+            throw new WorkflowError("reviewer-unavailable", "\u65E0\u6CD5\u5C06 reviewer \u6062\u590D\u4E3A\u53EA\u8BFB plan \u6A21\u5F0F");
+          }
+        }
+        const prompt = buildRereviewerPrompt({
+          taskContext: extractTaskContextBefore(entries, turnEndIndex),
+          // Scoped to the fix turn: an older turn's summary would describe the
+          // pre-review state and mislead the acceptance pass.
+          authorSelfReport: extractAuthorSelfReport(entries, turnEndIndex, { withinTurn: true }),
+          reviewFocus: opts.reviewFocus ?? null,
+          target
+        });
+        const sent = await this.agentOps.sendUserMessage(opts.reviewerSessionId, prompt, opts.project.path).catch(() => false);
+        if (!sent) {
+          await this.failRun(run2, "\u5411\u4E0A\u6B21 reviewer \u6295\u9012\u590D\u5BA1\u4EFB\u52A1\u5931\u8D25");
+          throw new WorkflowError("send-failed", "\u5411\u4E0A\u6B21 reviewer \u6295\u9012\u590D\u5BA1\u4EFB\u52A1\u5931\u8D25");
+        }
+        this.emitRunUpdated(run2);
+        return run2;
+      }
       try {
         const reviewerId = await this.agentOps.createNewSession(
           opts.project.id,
@@ -228856,6 +229052,9 @@ var WorkflowEngine = class {
         ).catch((err) => console.warn(`[WorkflowEngine] failed to set reviewer title for ${reviewerId}:`, err));
         const prompt = buildReviewerPrompt({
           taskContext,
+          originalIntent: extractFirstUserMessage(entries),
+          authorSelfReport: extractAuthorSelfReport(entries, turnEndIndex),
+          intentBrief: opts.intentBrief ?? null,
           reviewFocus: opts.reviewFocus ?? null,
           target
         });
@@ -228882,9 +229081,7 @@ var WorkflowEngine = class {
         throw new WorkflowError("spawn-failed", "\u521B\u5EFA reviewer session \u5931\u8D25");
       }
     } catch (err) {
-      if (this.participants.get(opts.sourceSessionId)?.runId === "pending") {
-        this.participants.delete(opts.sourceSessionId);
-      }
+      this.releaseReservations(runId);
       throw err;
     }
   }
@@ -228895,7 +229092,7 @@ var WorkflowEngine = class {
     if (!run2 || run2.status !== "waiting_reviewer") return;
     const entries = this.agentOps.getRawMessages(event.sessionId);
     const boundary = event.turnEndEntryIndex ?? extractLatestTurnEndIndex(entries) ?? entries.length;
-    const feedback = extractLastAssistantBefore(entries, boundary) ?? "(reviewer \u6CA1\u6709\u8F93\u51FA\u53EF\u7528\u7684\u53CD\u9988\u6587\u672C)";
+    const feedback = extractLastAssistantInTurn(entries, boundary) ?? "(reviewer \u6CA1\u6709\u8F93\u51FA\u53EF\u7528\u7684\u53CD\u9988\u6587\u672C)";
     let driftNote = null;
     try {
       const target = run2.review_target ? JSON.parse(run2.review_target) : null;
@@ -234932,6 +235129,9 @@ var routes11 = async (fastify2) => {
         );
         return reply.code(proxyStatus(result)).send(result.data);
       }
+      if (fastify2.workflowEngine.isSessionInActiveRun(req.params.sessionId)) {
+        return reply.code(409).send({ error: "Session is participating in an active review" });
+      }
       const session = fastify2.agentSessionManager.getSession(req.params.sessionId);
       if (!session) {
         return reply.code(404).send({ error: "Session not found" });
@@ -234971,6 +235171,9 @@ var routes11 = async (fastify2) => {
         );
         return reply.code(proxyStatus(result)).send(result.data);
       }
+      if (fastify2.workflowEngine.isSessionInActiveRun(req.params.sessionId)) {
+        return reply.code(409).send({ error: "Session is participating in an active review" });
+      }
       const session = fastify2.agentSessionManager.getSession(req.params.sessionId);
       if (!session) {
         return reply.code(404).send({ error: "Session not found" });
@@ -235909,7 +236112,87 @@ var command_routes_default = (0, import_fastify_plugin18.default)(routes17, { na
 
 // src/routes/workflow-run-routes.ts
 var import_fastify_plugin19 = __toESM(require_plugin2(), 1);
-var REVIEWER_AGENT_TYPES = /* @__PURE__ */ new Set(["claude-code", "codex"]);
+
+// src/utils/review-brief.ts
+var AI_TIMEOUT_MS2 = 15e3;
+var PER_MESSAGE_MAX_CHARS = 1500;
+var TOTAL_INPUT_MAX_CHARS = 24e3;
+var HEAD_CHARS = 8e3;
+var TAIL_CHARS = 15e3;
+var BRIEF_MAX_CHARS = 4e3;
+var SYSTEM_PROMPT2 = [
+  "You distill a coding-agent conversation into an intent brief for an independent code reviewer.",
+  "The reviewer will NOT see the conversation \u2014 only your brief plus the actual code, so capture what the code alone cannot show:",
+  "1. The original request and its goal.",
+  "2. Constraints and explicit user decisions, including approaches the user rejected.",
+  "3. The intended scope of the changes.",
+  "4. Trade-offs or limitations that were acknowledged and accepted.",
+  "Do NOT include the agent's reasoning, self-assessment, or claims that the work is correct or complete \u2014 the reviewer must judge that independently.",
+  "Write concise markdown bullets under those numbered headings, under 400 words total, in the same language as the conversation. Reply with the brief only."
+].join("\n");
+function capText(text2, max) {
+  return text2.length > max ? text2.slice(0, max) + "\u2026" : text2;
+}
+function serializeConversationForBrief(messages) {
+  const lines = [];
+  for (const msg of messages) {
+    if (!msg) continue;
+    if (msg.type === "user" && !msg.event) {
+      const text2 = extractUserText(msg.content).trim();
+      if (text2) lines.push(`User: ${capText(text2, PER_MESSAGE_MAX_CHARS)}`);
+    } else if (msg.type === "assistant" && typeof msg.content === "string") {
+      const text2 = msg.content.trim();
+      if (text2) lines.push(`Agent: ${capText(text2, PER_MESSAGE_MAX_CHARS)}`);
+    }
+  }
+  const full = lines.join("\n\n");
+  if (full.length <= TOTAL_INPUT_MAX_CHARS) return full;
+  return `${full.slice(0, HEAD_CHARS)}
+
+[\u2026 middle of the conversation omitted \u2026]
+
+${full.slice(-TAIL_CHARS)}`;
+}
+async function generateIntentBriefWithModel(model, conversation, options = {}) {
+  if (conversation.trim().length === 0) return null;
+  const telemetry = options.userId ? {
+    isEnabled: true,
+    functionId: "review-intent-brief",
+    metadata: {
+      userId: options.userId,
+      tags: ["vibedeckx", "review-intent-brief"]
+    }
+  } : void 0;
+  try {
+    const result = await generateText({
+      model,
+      system: SYSTEM_PROMPT2,
+      prompt: `Distill this conversation into an intent brief:
+
+${conversation}`,
+      timeout: AI_TIMEOUT_MS2,
+      experimental_telemetry: telemetry
+    });
+    const text2 = (result.text ?? "").trim();
+    return text2.length > 0 ? capText(text2, BRIEF_MAX_CHARS) : null;
+  } catch (error48) {
+    console.warn("[ReviewBrief] AI generation failed:", error48.message);
+    return null;
+  }
+}
+async function generateIntentBrief(storage, userId, messages) {
+  try {
+    if (!await isChatModelConfigured(storage, userId)) return null;
+    const conversation = serializeConversationForBrief(messages);
+    if (!conversation) return null;
+    return await generateIntentBriefWithModel(await resolveFastChatModel(storage, userId), conversation, { userId });
+  } catch (error48) {
+    console.warn("[ReviewBrief] generation failed:", error48.message);
+    return null;
+  }
+}
+
+// src/routes/workflow-run-routes.ts
 function parseReviewerAgentType(raw) {
   if (raw === void 0) return void 0;
   return typeof raw === "string" && REVIEWER_AGENT_TYPES.has(raw) ? raw : null;
@@ -235921,6 +236204,8 @@ function errStatus(err) {
       return 409;
     case "source-running":
       return 409;
+    case "reviewer-unavailable":
+      return 409;
     case "bad-state":
       return 409;
     case "no-completed-turn":
@@ -235960,6 +236245,14 @@ async function routes18(fastify2) {
     if (!projectId || !sourceSessionId) return reply.code(400).send({ error: "projectId and sourceSessionId are required" });
     const reviewerAgentType = parseReviewerAgentType(req.body?.reviewerAgentType);
     if (reviewerAgentType === null) return reply.code(400).send({ error: "reviewerAgentType must be one of: claude-code, codex" });
+    const reviewerSessionIdRaw = req.body?.reviewerSessionId;
+    if (reviewerSessionIdRaw !== void 0 && (typeof reviewerSessionIdRaw !== "string" || reviewerSessionIdRaw.trim() === "")) {
+      return reply.code(400).send({ error: "reviewerSessionId must be a non-empty string" });
+    }
+    if (reviewerSessionIdRaw !== void 0 && reviewerAgentType !== void 0) {
+      return reply.code(400).send({ error: "reviewerSessionId and reviewerAgentType are mutually exclusive" });
+    }
+    const reviewerSessionId = reviewerSessionIdRaw?.trim();
     if (sourceSessionId.startsWith("remote-")) {
       const remoteInfo = fastify2.remoteSessionMap.get(sourceSessionId);
       if (!remoteInfo) return reply.code(404).send({ error: "Session not found" });
@@ -235967,11 +236260,37 @@ async function routes18(fastify2) {
       if (derivedProjectId !== projectId) return reply.code(404).send({ error: "Session not found" });
       const remoteProject = await fastify2.storage.projects.getById(projectId, userId);
       if (!remoteProject) return reply.code(404).send({ error: "Project not found" });
+      let bareReviewerSessionId;
+      if (reviewerSessionId) {
+        const reviewerInfo = fastify2.remoteSessionMap.get(reviewerSessionId);
+        if (!reviewerInfo || reviewerInfo.remoteServerId !== remoteInfo.remoteServerId || projectIdFromRemoteSessionId(reviewerSessionId, reviewerInfo) !== projectId) {
+          return reply.code(404).send({ error: "Reviewer session not found" });
+        }
+        bareReviewerSessionId = reviewerInfo.remoteSessionId;
+      }
+      let intentBrief2;
+      if (!bareReviewerSessionId) {
+        try {
+          const historyResult = await proxyAuto(
+            remoteInfo,
+            "GET",
+            `/api/agent-sessions/${remoteInfo.remoteSessionId}`
+          );
+          if (historyResult.ok) {
+            const messages = historyResult.data.messages ?? [];
+            intentBrief2 = await generateIntentBrief(fastify2.storage, resolveUserId(userId), messages) ?? void 0;
+          }
+        } catch (err) {
+          console.warn("[WorkflowRuns] intent brief generation failed (remote source):", err);
+        }
+      }
       const result = await proxyAuto(remoteInfo, "POST", "/api/path/workflow-runs", {
         sourceSessionId: remoteInfo.remoteSessionId,
         reviewFocus,
         sourceTurnEndIndex,
-        reviewerAgentType
+        reviewerAgentType,
+        reviewerSessionId: bareReviewerSessionId,
+        intentBrief: intentBrief2
       });
       if (!result.ok) return sendProxyFailure(reply, result);
       const bareRun = result.data.run;
@@ -236037,6 +236356,18 @@ async function routes18(fastify2) {
     if (branch !== void 0 && (branch || null) !== runBranch) {
       return reply.code(400).send({ error: "branch does not match source session" });
     }
+    let intentBrief;
+    if (!reviewerSessionId) {
+      try {
+        intentBrief = await generateIntentBrief(
+          fastify2.storage,
+          resolveUserId(userId),
+          fastify2.agentSessionManager.getMessages(sourceSessionId)
+        ) ?? void 0;
+      } catch (err) {
+        console.warn("[WorkflowRuns] intent brief generation failed (local source):", err);
+      }
+    }
     try {
       const run2 = await fastify2.workflowEngine.startAdhocReview({
         project: { id: project.id, path: project.path },
@@ -236044,7 +236375,9 @@ async function routes18(fastify2) {
         sourceSessionId,
         reviewFocus,
         sourceTurnEndIndex,
-        reviewerAgentType
+        reviewerAgentType,
+        reviewerSessionId,
+        intentBrief
       });
       return reply.code(201).send({ run: run2 });
     } catch (err) {
@@ -236053,6 +236386,55 @@ async function routes18(fastify2) {
       throw err;
     }
   });
+  fastify2.get("/api/workflow-runs/reviewer-candidate", async (req, reply) => {
+    const userId = requireAuth(req, reply);
+    if (userId === null) return;
+    const { projectId, sourceSessionId } = req.query;
+    if (!projectId || !sourceSessionId) {
+      return reply.code(400).send({ error: "projectId and sourceSessionId are required" });
+    }
+    const project = await fastify2.storage.projects.getById(projectId, userId);
+    if (!project) return reply.code(404).send({ error: "Project not found" });
+    if (sourceSessionId.startsWith("remote-")) {
+      const remoteInfo = fastify2.remoteSessionMap.get(sourceSessionId);
+      if (!remoteInfo || projectIdFromRemoteSessionId(sourceSessionId, remoteInfo) !== projectId) {
+        return reply.code(404).send({ error: "Session not found" });
+      }
+      const params = new URLSearchParams({ sourceSessionId: remoteInfo.remoteSessionId });
+      const result = await proxyAuto(
+        remoteInfo,
+        "GET",
+        `/api/path/workflow-runs/reviewer-candidate?${params}`
+      );
+      if (!result.ok) return sendProxyFailure(reply, result);
+      const bareCandidate = result.data.candidate;
+      const candidate2 = mapRemoteReviewerCandidate(bareCandidate, remoteInfo.remoteServerId, projectId);
+      if (bareCandidate?.sessionId && candidate2?.sessionId) {
+        const reviewerInfo = {
+          remoteServerId: remoteInfo.remoteServerId,
+          remoteUrl: remoteInfo.remoteUrl,
+          remoteApiKey: remoteInfo.remoteApiKey,
+          remoteSessionId: bareCandidate.sessionId,
+          branch: remoteInfo.branch
+        };
+        fastify2.remoteSessionMap.set(candidate2.sessionId, reviewerInfo);
+        await fastify2.storage.remoteSessionMappings.upsert(
+          candidate2.sessionId,
+          projectId,
+          remoteInfo.remoteServerId,
+          bareCandidate.sessionId,
+          remoteInfo.branch ?? null
+        );
+      }
+      return reply.send({ candidate: candidate2 });
+    }
+    const sourceSession = await fastify2.storage.agentSessions.getById(sourceSessionId);
+    if (!sourceSession || sourceSession.project_id !== projectId) {
+      return reply.code(404).send({ error: "Session not found" });
+    }
+    const candidate = await fastify2.workflowEngine.getReviewerCandidate(sourceSessionId);
+    return reply.send({ candidate });
+  });
   fastify2.get(
     "/api/workflow-runs",
     async (req, reply) => {
@@ -236173,8 +236555,21 @@ async function routes18(fastify2) {
     if (userId === null) return;
     const { sourceSessionId, reviewFocus, sourceTurnEndIndex } = req.body ?? {};
     if (!sourceSessionId) return reply.code(400).send({ error: "sourceSessionId is required" });
+    const intentBriefRaw = req.body?.intentBrief;
+    if (intentBriefRaw !== void 0 && typeof intentBriefRaw !== "string") {
+      return reply.code(400).send({ error: "intentBrief must be a string" });
+    }
+    const intentBrief = intentBriefRaw?.trim() ? intentBriefRaw.length > 8e3 ? intentBriefRaw.slice(0, 8e3) + "\u2026" : intentBriefRaw : void 0;
     const reviewerAgentType = parseReviewerAgentType(req.body?.reviewerAgentType);
     if (reviewerAgentType === null) return reply.code(400).send({ error: "reviewerAgentType must be one of: claude-code, codex" });
+    const reviewerSessionIdRaw = req.body?.reviewerSessionId;
+    if (reviewerSessionIdRaw !== void 0 && (typeof reviewerSessionIdRaw !== "string" || reviewerSessionIdRaw.trim() === "")) {
+      return reply.code(400).send({ error: "reviewerSessionId must be a non-empty string" });
+    }
+    if (reviewerSessionIdRaw !== void 0 && reviewerAgentType !== void 0) {
+      return reply.code(400).send({ error: "reviewerSessionId and reviewerAgentType are mutually exclusive" });
+    }
+    const reviewerSessionId = reviewerSessionIdRaw?.trim();
     const sourceSession = await fastify2.storage.agentSessions.getById(sourceSessionId);
     if (!sourceSession) return reply.code(404).send({ error: "Session not found" });
     const project = await fastify2.storage.projects.getById(sourceSession.project_id);
@@ -236187,7 +236582,9 @@ async function routes18(fastify2) {
         sourceSessionId,
         reviewFocus,
         sourceTurnEndIndex,
-        reviewerAgentType
+        reviewerAgentType,
+        reviewerSessionId,
+        intentBrief
       });
       return reply.code(201).send({ run: run2 });
     } catch (err) {
@@ -236196,6 +236593,16 @@ async function routes18(fastify2) {
       throw err;
     }
   });
+  fastify2.get("/api/path/workflow-runs/reviewer-candidate", async (req, reply) => {
+    const userId = requireAuth(req, reply);
+    if (userId === null) return;
+    const { sourceSessionId } = req.query;
+    if (!sourceSessionId) return reply.code(400).send({ error: "sourceSessionId is required" });
+    const sourceSession = await fastify2.storage.agentSessions.getById(sourceSessionId);
+    if (!sourceSession) return reply.code(404).send({ error: "Session not found" });
+    const candidate = await fastify2.workflowEngine.getReviewerCandidate(sourceSessionId);
+    return reply.send({ candidate });
+  });
   fastify2.get("/api/path/workflow-runs", async (req, reply) => {
     const userId = requireAuth(req, reply);
     if (userId === null) return;
@@ -238506,10 +238913,10 @@ var routes27 = async (fastify2) => {
         if (offset >= stat2.size) {
           return reply.send({ content: "", truncated: false, size: stat2.size });
         }
-        const cap = Math.min(limit, MAX_OUTPUT_BYTES);
+        const cap2 = Math.min(limit, MAX_OUTPUT_BYTES);
         handle = await fs3.open(filePath, "r");
-        const buffer = Buffer.alloc(cap);
-        const { bytesRead } = await handle.read(buffer, 0, cap, offset);
+        const buffer = Buffer.alloc(cap2);
+        const { bytesRead } = await handle.read(buffer, 0, cap2, offset);
         return reply.send({
           content: buffer.subarray(0, bytesRead).toString("utf8"),
           truncated: offset + bytesRead < stat2.size,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibedeckx/linux-x64",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Vibedeckx platform binaries for Linux x64",
   "os": [
     "linux"