repoburg 1.3.253 → 1.3.255

package/agent-pane/backend/dist/index.js

@@ -43557,12 +43557,25 @@ function examplesRoot() {
   }
   return null;
 }
+function isInAppFolder(cwd) {
+  if (!cwd) return false;
+  const rel = path3.relative(path3.resolve(appsRoot()), path3.resolve(cwd));
+  return rel !== "" && !path3.isAbsolute(rel) && rel.split(path3.sep)[0] !== "..";
+}
+function appsConventions() {
+  return APPS_MD_SKELETON;
+}
 function ensureAppsRoot() {
   const root = appsRoot();
   fs.mkdirSync(root, { recursive: true });
   for (const name of ["CLAUDE.md", "AGENTS.md"]) {
     const file = path3.join(root, name);
-    if (!fs.existsSync(file)) fs.writeFileSync(file, APPS_MD_SKELETON);
+    try {
+      if (fs.existsSync(file) && fs.readFileSync(file, "utf-8") === APPS_MD_FILE) continue;
+      fs.writeFileSync(file, APPS_MD_FILE);
+    } catch (err) {
+      console.warn(`[apps] could not update ${file}: ${err.message}`);
+    }
   }
 }
 var APPS_MD_SKELETON = `# Mini Apps
@@ -43624,6 +43637,11 @@ open in AgentPane for a tool call to succeed in that case.
 To give the app a structured result, put this requirement in the job prompt:
 "End your answer with a single JSON code block matching this schema: ..."
 `;
+var APPS_MD_FILE = `<!-- Generated by AgentPane: overwritten whenever it differs from the built-in
+conventions, so edits here are lost. Put app-specific notes in the app
+folder's own CLAUDE.md / AGENTS.md. -->
+
+${APPS_MD_SKELETON}`;
 function readManifestIn(dir) {
   try {
     const raw = fs.readFileSync(path3.join(dir, "manifest.json"), "utf-8");
@@ -44234,6 +44252,7 @@ function render(): void {
 async function registerAppRoutes(fastify, opts) {
   setAppsRootOverride(opts?.appsRoot ?? null);
   setExamplesRootOverride(opts?.examplesRoot ?? null);
+  ensureAppsRoot();
   startAppsWatch((appId) => {
     invalidateHeadlessRuntime(appId);
     broadcast("app:source:updated", { appId });
@@ -44763,6 +44782,9 @@ function appServerClientOptions(_session, cwd) {
   const launchArgs = codexMiniAppLaunchArgs(cwd);
   return launchArgs ? { cwd, launchArgs } : { cwd, launchArgs: [] };
 }
+function threadInstructionParams(cwd) {
+  return isInAppFolder(cwd) ? { developerInstructions: appsConventions() } : {};
+}
 function autoApproveToolUserInput(client) {
   client.onRequest("item/tool/requestUserInput", async (params) => {
     const questions = params.questions ?? [];
@@ -44787,6 +44809,7 @@ async function getOrCreateThread(session) {
   }
   const config = parseRuntimeConfig(session);
   const sandbox = sandboxType(config);
+  const instructions = threadInstructionParams(cwd);
   let threadId;
   if (session.external_thread_id) {
     const result = await client.request("thread/resume", {
@@ -44794,7 +44817,8 @@ async function getOrCreateThread(session) {
       cwd,
       approvalPolicy: "never",
       sandbox,
-      model: session.model ?? void 0
+      model: session.model ?? void 0,
+      ...instructions
     });
     threadId = result.thread.id;
   } else {
@@ -44802,7 +44826,8 @@ async function getOrCreateThread(session) {
       cwd,
       approvalPolicy: "never",
       sandbox,
-      model: session.model ?? void 0
+      model: session.model ?? void 0,
+      ...instructions
     });
     threadId = result.thread.id;
     const db2 = getDb();
@@ -47716,6 +47741,16 @@ function turnImageDataUrls(turn) {
   if (!attachments) return [];
   return attachments.filter((a) => a?.media_type?.startsWith("image/") && a.data).map((a) => `data:${a.media_type};base64,${a.data}`);
 }
+function runtimePrompt(session, prompt, firstInput) {
+  if (!firstInput || !isInAppFolder(session.cwd)) return prompt;
+  const conventions = `<mini_app_conventions>
+${appsConventions()}</mini_app_conventions>`;
+  return prompt.startsWith("/") ? `${prompt}
+
+${conventions}` : `${conventions}
+
+${prompt}`;
+}
 async function startTurn3(session, turn) {
   const db2 = getDb();
   let client;
@@ -47736,6 +47771,7 @@ async function startTurn3(session, turn) {
     );
   }
   void registerMiniAppMcp(baseUrl, session.cwd ?? "");
+  const firstInput = !turn.thread_id && !sessionMap3.has(session.id) && !session.external_thread_id;
   let entry;
   try {
     entry = turn.thread_id ? await ensureThreadSession(session, turn, client, baseUrl) : await ensureSession(session, client, baseUrl);
@@ -47781,7 +47817,7 @@ async function startTurn3(session, turn) {
   try {
     const images = turnImageDataUrls(turn);
     await entry.client.createInput(entry.repoburgSessionId, {
-      user_prompt: turn.user_prompt,
+      user_prompt: runtimePrompt(session, turn.user_prompt, firstInput),
       execution_strategy: "auto_apply",
       ...images.length > 0 ? { images } : {}
     });

package/agent-pane/backend/dist/server.js

@@ -43544,12 +43544,25 @@ function examplesRoot() {
   }
   return null;
 }
+function isInAppFolder(cwd) {
+  if (!cwd) return false;
+  const rel = path3.relative(path3.resolve(appsRoot()), path3.resolve(cwd));
+  return rel !== "" && !path3.isAbsolute(rel) && rel.split(path3.sep)[0] !== "..";
+}
+function appsConventions() {
+  return APPS_MD_SKELETON;
+}
 function ensureAppsRoot() {
   const root = appsRoot();
   fs.mkdirSync(root, { recursive: true });
   for (const name of ["CLAUDE.md", "AGENTS.md"]) {
     const file = path3.join(root, name);
-    if (!fs.existsSync(file)) fs.writeFileSync(file, APPS_MD_SKELETON);
+    try {
+      if (fs.existsSync(file) && fs.readFileSync(file, "utf-8") === APPS_MD_FILE) continue;
+      fs.writeFileSync(file, APPS_MD_FILE);
+    } catch (err) {
+      console.warn(`[apps] could not update ${file}: ${err.message}`);
+    }
   }
 }
 var APPS_MD_SKELETON = `# Mini Apps
@@ -43611,6 +43624,11 @@ open in AgentPane for a tool call to succeed in that case.
 To give the app a structured result, put this requirement in the job prompt:
 "End your answer with a single JSON code block matching this schema: ..."
 `;
+var APPS_MD_FILE = `<!-- Generated by AgentPane: overwritten whenever it differs from the built-in
+conventions, so edits here are lost. Put app-specific notes in the app
+folder's own CLAUDE.md / AGENTS.md. -->
+
+${APPS_MD_SKELETON}`;
 function readManifestIn(dir) {
   try {
     const raw = fs.readFileSync(path3.join(dir, "manifest.json"), "utf-8");
@@ -44221,6 +44239,7 @@ function render(): void {
 async function registerAppRoutes(fastify, opts) {
   setAppsRootOverride(opts?.appsRoot ?? null);
   setExamplesRootOverride(opts?.examplesRoot ?? null);
+  ensureAppsRoot();
   startAppsWatch((appId) => {
     invalidateHeadlessRuntime(appId);
     broadcast("app:source:updated", { appId });
@@ -44750,6 +44769,9 @@ function appServerClientOptions(_session, cwd) {
   const launchArgs = codexMiniAppLaunchArgs(cwd);
   return launchArgs ? { cwd, launchArgs } : { cwd, launchArgs: [] };
 }
+function threadInstructionParams(cwd) {
+  return isInAppFolder(cwd) ? { developerInstructions: appsConventions() } : {};
+}
 function autoApproveToolUserInput(client) {
   client.onRequest("item/tool/requestUserInput", async (params) => {
     const questions = params.questions ?? [];
@@ -44774,6 +44796,7 @@ async function getOrCreateThread(session) {
   }
   const config = parseRuntimeConfig(session);
   const sandbox = sandboxType(config);
+  const instructions = threadInstructionParams(cwd);
   let threadId;
   if (session.external_thread_id) {
     const result = await client.request("thread/resume", {
@@ -44781,7 +44804,8 @@ async function getOrCreateThread(session) {
       cwd,
       approvalPolicy: "never",
       sandbox,
-      model: session.model ?? void 0
+      model: session.model ?? void 0,
+      ...instructions
     });
     threadId = result.thread.id;
   } else {
@@ -44789,7 +44813,8 @@ async function getOrCreateThread(session) {
       cwd,
       approvalPolicy: "never",
       sandbox,
-      model: session.model ?? void 0
+      model: session.model ?? void 0,
+      ...instructions
     });
     threadId = result.thread.id;
     const db2 = getDb();
@@ -47703,6 +47728,16 @@ function turnImageDataUrls(turn) {
   if (!attachments) return [];
   return attachments.filter((a) => a?.media_type?.startsWith("image/") && a.data).map((a) => `data:${a.media_type};base64,${a.data}`);
 }
+function runtimePrompt(session, prompt, firstInput) {
+  if (!firstInput || !isInAppFolder(session.cwd)) return prompt;
+  const conventions = `<mini_app_conventions>
+${appsConventions()}</mini_app_conventions>`;
+  return prompt.startsWith("/") ? `${prompt}
+
+${conventions}` : `${conventions}
+
+${prompt}`;
+}
 async function startTurn3(session, turn) {
   const db2 = getDb();
   let client;
@@ -47723,6 +47758,7 @@ async function startTurn3(session, turn) {
     );
   }
   void registerMiniAppMcp(baseUrl, session.cwd ?? "");
+  const firstInput = !turn.thread_id && !sessionMap3.has(session.id) && !session.external_thread_id;
   let entry;
   try {
     entry = turn.thread_id ? await ensureThreadSession(session, turn, client, baseUrl) : await ensureSession(session, client, baseUrl);
@@ -47768,7 +47804,7 @@ async function startTurn3(session, turn) {
   try {
     const images = turnImageDataUrls(turn);
     await entry.client.createInput(entry.repoburgSessionId, {
-      user_prompt: turn.user_prompt,
+      user_prompt: runtimePrompt(session, turn.user_prompt, firstInput),
       execution_strategy: "auto_apply",
       ...images.length > 0 ? { images } : {}
     });

package/agent-pane/examples/pr-review/app.ts

@@ -0,0 +1,184 @@
+/**
+ * Sample mini app — PR Review (multi-file TypeScript).
+ *
+ * Entry file: owns the UI state and wires window.AgentPane (turn events,
+ * the submit_review tool call, persistent state). Domain helpers (review
+ * prompt, verdict parsing) live in review.ts; shared types in types.ts.
+ *
+ * The pane bundles this file together with every module it imports into
+ * ONE compiled script — edit freely, the imports just work.
+ */
+import type { AppUi, ReviewVerdict } from './types';
+import { isReviewStatus } from './types';
+import { REVIEW_PROMPT, parseToolVerdict, parseTurnVerdict } from './review';
+
+const ui: AppUi = {
+  status: 'idle',
+  blockers: 0,
+  summary: '',
+  repo: '',
+  runtime: 'repoburg',
+  sessionId: null,
+  sessionRepo: null,
+  sessionRuntime: null,
+  running: false,
+};
+
+/** Typed DOM lookup (markup lives in index.html). */
+function byId<T extends HTMLElement>(id: string): T | null {
+  return document.getElementById(id) as T | null;
+}
+
+/** Persist the UI state — survives pane reloads (app_instances row). */
+function save(): Promise<unknown> {
+  return AgentPane.setState({ ...ui });
+}
+
+function render(): void {
+  const verdict = byId('verdict');
+  if (verdict) verdict.className = 'verdict ' + ui.status;
+  const count = byId('count');
+  if (count) count.textContent = ui.status === 'green' ? '\u2714' : String(ui.blockers);
+  const text = byId('verdict-text');
+  if (text) {
+    text.textContent =
+      ui.status === 'green' ? 'Review passed' :
+      ui.status === 'red' ? 'Review failed \u2014 ' + ui.blockers + ' blocker(s)' :
+      ui.status === 'running' ? 'Review running\u2026' :
+      ui.status === 'error' ? 'Review errored' : 'No review yet';
+  }
+  const summary = byId('summary');
+  if (summary) summary.textContent = ui.summary;
+  const repo = byId<HTMLInputElement>('repo');
+  if (repo) repo.value = ui.repo;
+  const runtime = byId<HTMLSelectElement>('runtime');
+  if (runtime) runtime.value = ui.runtime;
+  const run = byId<HTMLButtonElement>('run');
+  if (run) {
+    run.disabled = ui.running;
+    run.textContent = ui.running ? 'Running\u2026' : 'Run review';
+  }
+  if (!ui.running) {
+    const progress = byId('progress');
+    if (progress) progress.textContent = '';
+  }
+}
+
+function applyVerdict(verdict: ReviewVerdict): void {
+  ui.status = verdict.status;
+  ui.blockers = verdict.blockers;
+  ui.summary = verdict.summary;
+  ui.running = false;
+  render();
+}
+
+// Agent → app tool call (MCP gateway). Registered SYNCHRONOUSLY at startup
+// so the headless runtime can serve it without an open tab. The verdict
+// arrives structured — no JSON parsing of the agent answer is needed.
+AgentPane.onToolCall(async (payload) => {
+  if (payload.tool !== 'submit_review') {
+    await AgentPane.resolveToolCall(payload.callId, { error: 'unknown tool: ' + payload.tool });
+    return;
+  }
+  const verdict = parseToolVerdict(payload.args ?? {});
+  if (!verdict) {
+    await AgentPane.resolveToolCall(payload.callId, { error: 'invalid submit_review arguments' });
+    return;
+  }
+  applyVerdict(verdict);
+  await save();
+  await AgentPane.resolveToolCall(payload.callId, { recorded: true, status: ui.status });
+});
+
+async function init(): Promise<void> {
+  const state = await AgentPane.getState();
+  const d = state?.data ?? {};
+  ui.repo = typeof d.repo === 'string' ? d.repo : '';
+  ui.runtime = typeof d.runtime === 'string' && d.runtime ? d.runtime : 'repoburg';
+  ui.status = isReviewStatus(d.status) ? d.status : 'idle';
+  ui.blockers = typeof d.blockers === 'number' ? d.blockers : 0;
+  ui.summary = typeof d.summary === 'string' ? d.summary : '';
+  ui.sessionId = typeof d.sessionId === 'string' ? d.sessionId : null;
+  ui.sessionRepo = typeof d.sessionRepo === 'string' ? d.sessionRepo : null;
+  ui.sessionRuntime = typeof d.sessionRuntime === 'string' ? d.sessionRuntime : null;
+  ui.running = d.running === true;
+  render();
+
+  // Turn lifecycle pushed by the pane (host → app relay). Only turns of a
+  // review job started here (Run review) are parsed — a verdict submitted
+  // via the submit_review tool already set the state and must not be
+  // clobbered by the same turn's plain-text completion.
+  AgentPane.onTurnCompleted((event, payload) => {
+    if (!ui.running) return;
+    ui.running = false;
+    if (event === 'turn:failed') {
+      ui.status = 'error';
+      ui.summary = payload?.error ? String(payload.error) : 'turn failed';
+    } else {
+      const verdict = parseTurnVerdict(payload?.response ?? '');
+      if (verdict) {
+        applyVerdict(verdict);
+      } else {
+        ui.status = 'error';
+        ui.summary = 'The agent answer did not end with a JSON block.';
+      }
+    }
+    save();
+    render();
+  });
+
+  // Live streaming: show the agent's latest delta text while the review runs.
+  AgentPane.onTurnDelta((payload) => {
+    if (!ui.running) return;
+    const el = byId('progress');
+    if (el) el.textContent = String(payload.delta ?? '');
+  });
+}
+
+const runBtn = byId<HTMLButtonElement>('run');
+if (runBtn) {
+  runBtn.addEventListener('click', async () => {
+    const repoInput = byId<HTMLInputElement>('repo');
+    const runtimeInput = byId<HTMLSelectElement>('runtime');
+    if (!repoInput || !runtimeInput) return;
+    ui.repo = repoInput.value.trim();
+    ui.runtime = runtimeInput.value;
+    if (!ui.repo) return;
+    ui.running = true;
+    ui.status = 'running';
+    render();
+    try {
+      // Reuse the session only when it was created for THIS repo + runtime;
+      // a changed repo/runtime needs a fresh session (cwd is fixed per session).
+      let sessionId: string;
+      if (ui.sessionId === null || ui.sessionRepo !== ui.repo || ui.sessionRuntime !== ui.runtime) {
+        const session = await AgentPane.createSession({
+          title: 'PR Review job',
+          runtime_type: ui.runtime,
+          cwd: ui.repo,
+        });
+        sessionId = session.id;
+        ui.sessionRepo = ui.repo;
+        ui.sessionRuntime = ui.runtime;
+      } else {
+        sessionId = ui.sessionId;
+      }
+      ui.sessionId = sessionId;
+      await save();
+      await AgentPane.submitTurn(sessionId, REVIEW_PROMPT);
+    } catch (err) {
+      ui.running = false;
+      ui.status = 'error';
+      ui.summary = err instanceof Error ? err.message : String(err);
+      // A cached session id can go stale (session deleted, other pane DB) —
+      // drop it so the next run creates a fresh session instead of 404 loops.
+      ui.sessionId = null;
+      ui.sessionRepo = null;
+      ui.sessionRuntime = null;
+      save();
+      render();
+    }
+  });
+}
+
+init();

package/agent-pane/examples/pr-review/index.html

@@ -0,0 +1,43 @@
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="UTF-8">
+<style>
+  body { font-family: Inter, system-ui, sans-serif; margin: 24px; color: #3c3c3c; background: #fff; }
+  h1 { font-size: 16px; margin: 0 0 16px; }
+  .row { display: flex; gap: 8px; margin-bottom: 16px; }
+  input { flex: 1; padding: 8px 10px; font-size: 13px; border: 1px solid #e2e0db; border-radius: 6px; }
+  select { padding: 8px; font-size: 13px; border: 1px solid #e2e0db; border-radius: 6px; background: #fff; }
+  button { padding: 8px 16px; font-size: 13px; background: #d97706; color: #fff; border: none; border-radius: 6px; cursor: pointer; }
+  button:disabled { opacity: 0.5; cursor: default; }
+  .verdict { display: none; align-items: center; gap: 8px; padding: 16px; border-radius: 8px; font-size: 14px; font-weight: 600; margin-bottom: 16px; }
+  .verdict.idle, .verdict.running, .verdict.error { display: flex; background: #f5f3ef; color: #8a857c; }
+  .verdict.green { display: flex; background: rgba(34,197,94,0.1); color: #15803d; }
+  .verdict.red { display: flex; background: rgba(239,68,68,0.1); color: #b91c1c; }
+  .count { font-size: 22px; }
+  .summary { font-size: 13px; color: #8a857c; margin-bottom: 8px; }
+  .progress { font-size: 11px; color: #b0aaa0; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 100%; margin-bottom: 8px; min-height: 14px; }
+  .note { font-size: 12px; color: #8a857c; }
+</style>
+</head>
+<body>
+  <h1>PR Review</h1>
+  <!-- Markup only — the pane injects the shim (window.AgentPane) into the
+       head and the compiled app logic (app.ts + its imported modules,
+       bundled) before the closing body tag. Do NOT reference the logic
+       files from here (a relative src cannot resolve in a srcdoc iframe). -->
+  <div id="verdict" class="verdict"><span id="count" class="count"></span><span id="verdict-text"></span></div>
+  <div class="row">
+    <input id="repo" placeholder="Repository path (cwd for the review session)" />
+    <select id="runtime" title="Agent runtime for the review session">
+      <option value="repoburg">Repoburg</option>
+      <option value="claude">Claude</option>
+      <option value="codex">Codex</option>
+    </select>
+    <button id="run">Run review</button>
+  </div>
+  <div id="summary" class="summary"></div>
+  <div id="progress" class="progress"></div>
+  <p class="note">This is a sample mini app. It opens an agent session on the repository, runs a review job, and stores the verdict in its persistent state.</p>
+</body>
+</html>

package/agent-pane/examples/pr-review/manifest.json

@@ -0,0 +1,30 @@
+{
+  "title": "PR Review",
+  "description": "Sample mini app: run a repository review and show a green/red verdict with the blocker count.",
+  "icon": "🔍",
+  "tools": [
+    {
+      "name": "submit_review",
+      "description": "Submit the final verdict of the repository review. Call this exactly once, at the end of the review.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": ["green", "red"],
+            "description": "green = review passed, red = blocking issues found"
+          },
+          "blockers": {
+            "type": "number",
+            "description": "Number of blocking issues found (0 for green)."
+          },
+          "summary": {
+            "type": "string",
+            "description": "One-line verdict shown in the app."
+          }
+        },
+        "required": ["status", "blockers", "summary"]
+      }
+    }
+  ]
+}

package/agent-pane/examples/pr-review/review.ts

@@ -0,0 +1,47 @@
+/**
+ * PR Review domain logic — the review job prompt and verdict parsing
+ * (both the fallback JSON-block contract and the submit_review tool args).
+ */
+import type { ReviewVerdict } from './types';
+
+/** Review job sent to the agent: JSON result contract + tool call. */
+export const REVIEW_PROMPT =
+  'Review the current repository as a senior engineer. Look at the recent ' +
+  'changes (git status / recent commits) and report blocking issues only. ' +
+  'When the review is done, call the MCP tool `pr-review__submit_review` ' +
+  'exactly once with the verdict: status ("green" or "red"), blockers ' +
+  '(number), and a one-line summary.';
+
+/** Parse the LAST ```json fenced block from the agent's answer. */
+export function parseJsonBlock(text: string): unknown {
+  const blocks = text.match(/```json\n([\s\S]*?)\n```/g) ?? [];
+  if (blocks.length === 0) return null;
+  try {
+    return JSON.parse(blocks[blocks.length - 1].replace(/```json\n|\n```/g, ''));
+  } catch {
+    return null;
+  }
+}
+
+/** Fallback verdict from the turn's plain-text answer (JSON block). */
+export function parseTurnVerdict(text: string): ReviewVerdict | null {
+  const raw = parseJsonBlock(text);
+  if (!raw || typeof raw !== 'object') return null;
+  const obj = raw as Record<string, unknown>;
+  return normalizeVerdict(obj);
+}
+
+/** Structured verdict from the submit_review tool call arguments. */
+export function parseToolVerdict(args: Record<string, unknown>): ReviewVerdict | null {
+  return normalizeVerdict(args);
+}
+
+/** Map one verdict-shaped object to ReviewVerdict; null when invalid. */
+function normalizeVerdict(obj: Record<string, unknown>): ReviewVerdict | null {
+  if (obj.status !== 'green' && obj.status !== 'red') return null;
+  return {
+    status: obj.status,
+    blockers: typeof obj.blockers === 'number' ? obj.blockers : 0,
+    summary: typeof obj.summary === 'string' ? obj.summary : '',
+  };
+}

package/agent-pane/examples/pr-review/types.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared types for the PR Review mini app.
+ */
+
+/** Verdict/UI status machine of the app. */
+export type ReviewStatus = 'idle' | 'running' | 'green' | 'red' | 'error';
+
+/** A review outcome — from the submit_review tool or a JSON result block. */
+export interface ReviewVerdict {
+  status: 'green' | 'red';
+  blockers: number;
+  summary: string;
+}
+
+/** Persistent UI state — survives pane reloads (app_instances row). */
+export interface AppUi {
+  status: ReviewStatus;
+  blockers: number;
+  summary: string;
+  repo: string;
+  runtime: string;
+  sessionId: string | null;
+  sessionRepo: string | null;
+  sessionRuntime: string | null;
+  running: boolean;
+}
+
+/** Narrow an unknown persisted field back to ReviewStatus. */
+export function isReviewStatus(value: unknown): value is ReviewStatus {
+  return (
+    value === 'idle' ||
+    value === 'running' ||
+    value === 'green' ||
+    value === 'red' ||
+    value === 'error'
+  );
+}